How wiedehopf/readsb works
Readsb is an ADS-B/Mode-S receiver and tracking backend. Its principal workflow takes radio or network input, demodulates and decodes aircraft messages, updates tracked aircraft state, then exposes data through network feeds, JSON/API output, and optional globe history. The README documents feed modes and globe-history features; source excerpts and the index establish module ownership but do not show every runtime call, so uncertain links are dashed.
Main entry points: net_io.c Message Handling · readsb.c Readsb Runtime · mode_s.c Mode S Decoder · track.c Position Tracking
Components 22
Signal Ingestion
- Readsb Runtime
readsb.c - Receiver Control
receiver.c - SDR Drivers
sdr.c - SDR Backends
sdr_rtlsdr.c - Sample Conversion
convert.c - Network Input
net_io.c
Message Decoding
- Signal Demodulation
demod_2400.c - Mode S Decoder
mode_s.c - Mode A/C Decoder
mode_ac.c - UAT Decoder
uat2esnt/uat_decode.c - Comm-B Decode
comm_b.c - Message Handling
net_io.c
Aircraft Tracking
- Aircraft Records
aircraft.c - Position Tracking
track.c - Receiver Statistics
stats.c
Data Outputs
- JSON Output
json_out.c - Readsb API
api.c - Globe Index
globe_index.c - Network Feeds
net_io.c - Trace History
track.c
Other components
- Operator / Receiver
- Feed Consumers
Connections 22
- Operator / Receiver → Readsb Runtime: configures
- Readsb Runtime → Receiver Control: configures
- Receiver Control → SDR Drivers: selects input
- SDR Drivers → SDR Backends: dispatches to
- SDR Backends → Sample Conversion: supplies samples
- Sample Conversion → Signal Demodulation: converts samples
- Network Input → Message Handling: passes messages
net_io.c - Signal Demodulation → Mode S Decoder: decodes messages
- Mode S Decoder → Comm-B Decode: decodes fields
- Mode S Decoder → Message Handling: submits messages
- Mode A/C Decoder → Message Handling: submits messages
- UAT Decoder → Message Handling: submits messages
- Message Handling → Aircraft Records: gets or creates
net_io.c - Aircraft Records → Position Tracking: updates state
- Readsb Runtime → Receiver Statistics: updates statistics
- Position Tracking → JSON Output: writes aircraft data
- JSON Output → Readsb API: serves data
- JSON Output → Globe Index: builds index
- Position Tracking → Trace History: records history
track.c - Message Handling → Network Feeds: forwards messages
net_io.c - Network Feeds → Feed Consumers: sends feeds
- Readsb API → Feed Consumers: serves aircraft data