How daniestevez/gr-satellites works
gr-satellites is a GNU Radio toolkit for decoding amateur-satellite telemetry. A groundstation selects a satellite and supplies samples to a configured flowgraph, which demodulates and deframes signals, applies protocol and error-correction processing, then routes decoded packets to display, file, telemetry, or transport outputs. Satellite-specific telemetry decoding and file reassembly are important downstream capabilities. The graph reflects the README and sampled flowgraph/parser code; detailed wiring within unsampled protocol blocks is not shown.
Main entry points: gr_satellites_flowgraph.py Decoder flowgraph · datasinks Data sinks · pdu_add_meta.h PDU tagger · transports Transports
Components 18
Flowgraph setup
- Satellite config
python/satyaml/satyaml.py - Decoder flowgraph
python/core/gr_satellites_flowgraph.py
Signal decoding
- Demodulators
python/components/demodulators - Sync and framing
python/hier - Satellite deframers
python/components/deframers - FEC and modem blocks
lib
Packet interpretation
- CCSDS blocks
python/ccsds - Packet protocols
python - Telemetry parsers
python/telemetry
Results and delivery
- PDU tagger
include/satellites/pdu_add_meta.h - Data sinks
python/components/datasinks - Transports
python/components/transports - File reassembly
python/filereceiver/filereceiver.py
Other components
- Groundstation
- Radio samples
- Received files
- Telemetry services
- Packet output
Connections 22
- Groundstation → Decoder flowgraph: configures
- Groundstation → Radio samples: provides
- Satellite config → Decoder flowgraph: configures
- Radio samples → Decoder flowgraph: sample input
- Decoder flowgraph → Demodulators: dispatches
- Decoder flowgraph → Sync and framing: dispatches
- Decoder flowgraph → Satellite deframers: dispatches
- Decoder flowgraph → FEC and modem blocks: dispatches
- Decoder flowgraph → CCSDS blocks: dispatches
- Decoder flowgraph → Packet protocols: dispatches
- Decoder flowgraph → Telemetry parsers: dispatches
- Decoder flowgraph → PDU tagger: connects
- Decoder flowgraph → Data sinks: connects
- Decoder flowgraph → Transports: connects
- Satellite deframers → PDU tagger: emits PDUs
- PDU tagger → Data sinks: routes PDUs
- PDU tagger → Transports: routes PDUs
- Data sinks → File reassembly: provides chunks
- File reassembly → Received files: reassembles
- Data sinks → Telemetry services: submits telemetry
- Data sinks → Packet output: displays or saves
- Transports → Packet output: delivers packets