4.1 KiB
tiny-wb
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-family detection and acquisition are implemented for the shared 0.1–800 MHz normal range. A detected Ultra+ ZS406 additionally supports its 0.1–900 MHz normal range and explicit opt-in Ultra mode through 5.4 GHz.
- ZS407 extended mode and harmonic-mode reception remain unsupported. Hardware validation proves communications and framing, not RF frequency/level accuracy.
See the compatibility matrix and Ultra support scope before relying on a particular model, range, or mode.
Requirements
- Rust 1.88.0 or newer
- For acquisition, a powered tinySA Basic, Ultra, or Ultra+ and a data-capable USB cable
- For acquisition, 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.
Open an existing tiny-wb CSV directly in the interactive renderer without enumerating or connecting to a device:
cargo run --release -- --view scan.csv
# The shorter `cargo run --release -- scan.csv` is equivalent.
On a plot, use +/= and - to zoom, Left/Right or h/l to pan, and
0 or Home to restore the full frequency range. Plot bindings are configurable
under [ui.bindings].
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.
- Compatibility, operation, and troubleshooting
- Hardware validation checklist
- USB console and
scanrawprotocol - Documentation index
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.