Simple tinySA to Workbench converter
Go to file
Dandaedre 075d0461d7
Rust CI tiny-wb passed CI.
Gitea/tiny-wb/pipeline/head This commit looks good Details
docs: guide new users through a first scan with screenshots
2026-10-20 16:38:08 +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: add interactive CSV plot navigation 2026-10-07 16:15:26 +02:00
docs docs: guide new users through a first scan with screenshots 2026-10-20 16:38:08 +02:00
examples feat: support tinySA Ultra+ ZS406 2026-10-07 10:03:05 +02:00
release fix: configure Cross release dependencies 2026-10-05 12:16:22 +02:00
scripts ci: remove superseded standalone macOS build 2026-10-20 16:34:40 +02:00
src feat: add live plot navigation and peak overlay 2026-10-08 12:51:59 +02:00
tests fix: validate CSV before logger startup 2026-10-07 16:48:26 +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 release: bump 0.1.4 2026-10-08 12:52:10 +02:00
Cargo.toml release: bump 0.1.4 2026-10-08 12:52:10 +02:00
Jenkinsfile ci: verify core library builds and mock server integration 2026-10-04 23:00:58 +02:00
LICENSE
…
README.md docs: guide new users through a first scan with screenshots 2026-10-20 16:38:08 +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 fix: configure Cross release dependencies 2026-10-05 12:16:22 +02:00
rust-release.toml ci: add macOS targets to automated releases 2026-10-20 16:33:25 +02:00
rustfmt.toml Cleaned up the TODOs and cleared up the codebase 2024-09-26 09:00:45 -05:00
task.md feat: add live scan mode 2026-10-08 09:39:05 +02:00

README.md

tiny-wb

tiny-wb version Test status Line coverage

Scan a frequency range with your tinySA, see the spectrum in your terminal, and save the measurements as CSV. Start with one scan; no configuration-file editing is needed.

Get running

You need a powered tinySA Basic, Ultra or supported Ultra+, a data-capable USB cable, and access to its serial port. Close other software using the tinySA. For a first communications check, leave external RF sources disconnected. Before connecting a signal, read the safe-operation guide.

To build from source, install Rust 1.88 or newer, then run:

git clone https://proxy.dandaedre.com/gitea/idle-org/tiny-wb.git
cd tiny-wb
cargo run --locked --release

Already have the checkout? Run just the last command from its root. On Linux, building also requires the libudev development package and pkg-config; this checkout's linker configuration uses lld.

Your first scan

  1. Connect by USB and choose the port. On the connection screen, select your tinySA's port with the arrow keys. Linux commonly uses /dev/ttyACM0; Windows uses a COM port. On macOS, select the enumerated USB serial device. Leave the baud rate at 115200 for the first attempt and press Enter.
  2. Choose a small range. Try Start 280, Stop 320 (MHz), Points 1001, and Repeat 1. This range uses the Basic's low input and is also within the supported Ultra normal range. For a connected RF signal, use the appropriate instrument input and safe signal level.
  3. Enter the values. Left/Right selects a field. Type digits for a frequency or point count, then press Enter to apply that value. Use Up/Down to adjust a value, including Repeat. Once all fields are set, press Enter again to start the scan.
  4. Read the plot. Wait for the scan to finish. Frequency runs left to right in MHz; level is in dBm. A higher point means a stronger signal. The app automatically saves a scan_*.csv in your current directory.

Scan setup with Start 280 MHz, Stop 320 MHz, 1001 points and Repeat 1

Scan settings in the real application. Screenshots use the mock device; no physical instrument or RF source is needed to reproduce this demonstration.

Completed simulated scan with a peak near 300 MHz and the visible-peak readout enabled

Example result from simulated data, with m pressed to show the peak. Your real trace will depend on the signals and measurement setup.

Explore and save

Key on the result screen Action
m Show or hide the strongest visible sample's frequency and level
+ / - Zoom in / out
Left / Right Pan across the frequency range
0 Return to the full range
r Repeat the same scan and save a new CSV
n Edit the settings for a new scan
q Quit

CSV columns are frequency in MHz, level in dBm; by default there is no header. Each successful scan gets a new filename. To reopen a saved scan without connecting a device, replace scan.csv with your file:

cargo run --locked --release -- --view scan.csv

Want repeated sweeps? Start with cargo run --locked --release -- --live, then choose the connection and range as above. In live mode, s saves the visible trace and q stops after the current sweep and saves it. See live controls for averaging and hold modes.

If something does not work

  • No port, or access denied? Check the USB cable, close other serial software, and follow the serial-permission guide.
  • Timeout or no instrument detected? Check the selected port and power, then consult troubleshooting.
  • No tinySA yet? Follow the mock-device walkthrough to try the same screens and CSV workflow with simulated data.

Settings are saved automatically in config.toml. See the configuration guide for output directories, keyboard bindings and the TINY_WB_CONFIG override.

Supported instruments and more

Basic low/high acquisition is supported through 960 MHz, subject to input-path limits. Ultra-family normal-mode support covers 0.1–800 MHz; detected Ultra+ ZS406 devices also support 0.1–900 MHz and opt-in Ultra mode through 5.4 GHz. ZS407 extended mode and harmonic reception are not supported. Check the compatibility matrix and Ultra support scope before choosing a wider range. Hardware communications checks do not establish RF accuracy.

Report bugs in the issue tracker with the reproduction details.

Licensed under the MIT License.