Getting started¶
For a first listening session, you need the Pi appliance and a
browser workstation on the same network. The Pi selects and wakes the
receiver, then streams its radio samples to your browser. The browser tunes
within that stream, plays audio and keeps samples for replay. Open the
appliance's HTTPS address to listen or visit /docs/ there for this manual.
For unattended reception, a continuous decoder job can run on the Pi while your browser is closed. An optional rfSentry Server can archive that job's records when you pair it and enable the stream.
A minimal deployment¶
flowchart TB
A[RTL-SDR] --> B[rtl_tcp backend]
B -->|IQ samples| D[sdr-demandd]
D -->|Local demand connection| E[rfsentry-api gateway]
E -->|IQ over secure WebSocket| F[Browser receiver lane]
You need:
- a Raspberry Pi-class Linux appliance with Ethernet or reliable Wi-Fi;
- one or more supported RTL-SDR receivers with unique serial numbers;
- an antenna and any declared RF-path accessories;
- a workstation-class Chromium browser for the full DSP and map workload;
- correct time through Chrony for slotted modes such as FT8 and FT4.
The synthetic example profile illustrates four roles: HF through a 125 MHz
upconverter, direct VHF, 978/1090 MHz aviation, and E4000-based SATCOM. Its Pi 5
topology and reserved network identity require operator customization. See
profile selection.
Recommended reading order¶
- Install and receiver configuration.
- Basic operation.
- Receiver lanes and tuning.
- Detection and decoder Auto Start.
- DVR, persistence, and replay.
For development, continue with the system architecture and build/test/deploy reference.