How ur8us/astra918sdr works
Astra918 is receive-only RP2350 firmware for a CMX918-based radio, with a Rust host library providing a simulator and CLI. The primary workflow is to accept control or CAT tuning, configure the receiver, capture I/Q, produce channelized audio and I/Q streams, and expose them over composite USB. Persistence and recovery support reliable operation. README statements establish the advertised interfaces and capabilities; source excerpts and the SOURCE INDEX establish several internal modules and calls, but some runtime wiring is unsampled, so those connections are left out.
Main entry points: main.rs Firmware runtime · chip.rs CMX918 control · astra.rs AST1 control · capture.rs I/Q capture
Components 22
Control and tuning
- Firmware runtime
firmware/src/main.rs - AST1 control
firmware/src/astra.rs - Control records
firmware/src/control_v2.rs - CAT commands
firmware/src/cat.rs - Receiver settings
firmware/src/controls.rs - Protocol helpers
firmware/src/protocol.rs
Receiver hardware
- CMX918 control
firmware/src/chip.rs - I²C bus
firmware/src/i2c_bus.rs - Bus recovery
firmware/src/recovery.rs - Saved settings
firmware/src/persistence.rs
Capture and streams
- I/Q capture
firmware/src/capture.rs - Channel DSP
firmware/src/dsp.rs - DSP coefficients
firmware/src/dsp_tables.rs - Wide FIR mode
firmware/src/wide_fir.rs - Wide FIR tables
firmware/src/wide_fir_tables.rs - Audio handling
firmware/src/audio.rs - USB audio
firmware/src/usb_audio.rs - USB vendor interface
firmware/src/usb_vendor.rs
Host tools
- Host library
host/src/lib.rs - Hardware simulator
host/src/simulator.rs - Controller CLI
host/src/cli.rs
Other components
- Operator / client
Connections 24
- Operator / client → Firmware runtime: connects USB
README.md - Operator / client → CAT commands: sends CAT
README.md - Operator / client → Hardware simulator: runs simulator
README.md - Operator / client → Controller CLI: runs controller
README.md - Firmware runtime → I/Q capture: starts capture
firmware/src/main.rs - Firmware runtime → USB audio: exposes audio
README.md - Firmware runtime → USB vendor interface: exposes vendor control
README.md - Firmware runtime → Saved settings: loads settings
firmware/src/main.rs - AST1 control → Control records: uses records
firmware/src/astra.rs - Firmware runtime → AST1 control: dispatches control
- Firmware runtime → CAT commands: dispatches CAT
- AST1 control → Receiver settings: updates settings
firmware/src/astra.rs - CMX918 control → Receiver settings: applies controls
firmware/src/chip.rs - CMX918 control → I²C bus: uses bus
firmware/src/chip.rs - CMX918 control → Bus recovery: recovers bus
firmware/src/chip.rs - I/Q capture → Channel DSP: processes I/Q
- Channel DSP → DSP coefficients: reads coefficients
firmware/src/dsp.rs - CMX918 control → Wide FIR mode: selects FIR
firmware/src/chip.rs - Wide FIR mode → Wide FIR tables: selects tables
firmware/src/wide_fir.rs - Channel DSP → Audio handling: produces audio
- Audio handling → USB audio: streams audio
- I/Q capture → USB vendor interface: streams I/Q
- Host library → Hardware simulator: provides simulator
- Host library → Controller CLI: provides CLI