Simple tinySA to Workbench converter
Go to file
Dandaedre 1bc67400f6 docs: streamline project readme 2026-10-05 10:04:24 +02:00
.cargo ci: exclude dependency sources and summarize coverage output 2026-10-05 01:02:50 +02:00
assets Adds some Icons, an .ignore file and wrap for paragraphs 2024-09-27 08:30:40 -05:00
config feat: detect tinySA Ultra and apply model-aware scan decoding 2026-10-05 09:45:56 +02:00
docs docs: streamline project readme 2026-10-05 10:04:24 +02:00
examples feat: detect tinySA Ultra and apply model-aware scan decoding 2026-10-05 09:45:56 +02:00
scripts feat: detect tinySA Ultra and apply model-aware scan decoding 2026-10-05 09:45:56 +02:00
src feat: detect tinySA Ultra and apply model-aware scan decoding 2026-10-05 09:45:56 +02:00
tests feat: detect tinySA Ultra and apply model-aware scan decoding 2026-10-05 09:45:56 +02:00
.gitignore test: add guided hardware validation 2026-10-05 01:53:10 +02:00
.ignore Adds some Icons, an .ignore file and wrap for paragraphs 2024-09-27 08:30:40 -05:00
AGENTS.md docs: define code structure documentation and verification standards 2026-10-04 22:10:14 +02:00
Cargo.lock refactor: wire configured acquisition into separated terminal UI 2026-10-04 22:31:05 +02:00
Cargo.toml test: add guided hardware validation 2026-10-05 01:53:10 +02:00
Jenkinsfile ci: verify core library builds and mock server integration 2026-10-04 23:00:58 +02:00
LICENSE Initial commit 2024-09-17 05:07:38 -05:00
README.md docs: streamline project readme 2026-10-05 10:04:24 +02:00
build.rs feat: expose portable library connections and mock tinySA devices 2026-10-04 23:00:25 +02:00
deny.toml ci: document project and harden Rust checks 2026-10-04 17:17:56 +02:00
release.sh feat: add project-local rust_realease wrapper and release policy 2026-10-04 22:40:49 +02:00
rust-release.toml feat: add project-local rust_realease wrapper and release policy 2026-10-04 22:40:49 +02:00
rustfmt.toml Cleaned up the TODOs and cleared up the codebase 2024-09-26 09:00:45 -05:00
task.md feat: detect tinySA Ultra and apply model-aware scan decoding 2026-10-05 09:45:56 +02:00

README.md

tiny-wb

tiny-wb version Test status Line coverage

tiny-wb is an interactive terminal application for acquiring a frequency sweep from a tinySA over its USB serial console, plotting the result, and exporting it as CSV. It is intended for tinySA users who want a repeatable scan workflow and for Rust applications that need its reusable acquisition library.

Support status

  • tinySA Basic low and high inputs are supported through 960 MHz, subject to the instrument's path limits.
  • tinySA Ultra and Ultra+ detection and acquisition are implemented for the shared 0.1–800 MHz normal range, but still await physical hardware qualification.

See the compatibility matrix and Ultra support scope before relying on a particular model, range, or mode.

Requirements

  • Rust 1.88.0 or newer
  • A powered tinySA Basic, Ultra, or Ultra+ and a data-capable USB cable
  • Permission to open the instrument's serial port

Do not connect an unknown RF source directly to a tinySA. Use suitable external attenuation for transmitters and a DC block where a DC component may be present. Read the safe-operation guidance before connecting a signal.

Build and run

From the repository root:

cargo run --release

On Linux the serial device is commonly /dev/ttyACM0; on Windows it appears as a COM port. If the port cannot be opened, follow the serial-permission guidance.

Use Left/Right or h/l to select a field, Up/Down or k/j to change it, Enter to advance, and q or Escape to quit. A successful scan displays a trace and writes a collision-safe scan_*.csv file in the current directory. CSV frequencies are in MHz and levels are in dBm.

Configuration and documentation

The selected settings are saved to config.toml, or to the path in TINY_WB_CONFIG. Start with the commented default configuration and consult the configuration guide for validation, units, output, and logging settings.

Development

The core protocol, transport, acquisition, and CSV code can be tested without a terminal or physical instrument:

cargo fmt --all -- --check
cargo test --locked --all-targets --all-features
cargo clippy --locked --all-targets --all-features -- -D warnings

Run the complete local CI sequence in Security, dependency policy, and MSRV. See the architecture guide, testing guide, and contributor instructions before changing behavior.

Support

Report bugs in the project issue tracker. Include the details from the reproducible bug-report checklist.

License

tiny-wb is available under the MIT License.