How alanbjohnston/cubesatsim works
CubeSatSim is a Raspberry Pi-based satellite emulator that samples onboard telemetry and transmits it over UHF; the README also describes multiple radio formats, camera/SSTV transmission, and sensor extensions. The main runtime entry point is main.c, with sensor acquisition and telemetry preparation feeding radio transmission. Separate groundstation scripts support reception and telemetry decoding. Some connections below are documented or visible in the excerpts; dashed, uncited links mark relationships that the available excerpts do not verify.
Main entry points: main.c Simulator loop · ax5043spi.c SPI interface · axradioinit.c Radio initialization · axradiotx.c Packet transmitter
Components 22
Simulator runtime
- Simulator loop
main.c - Sensor sampling
sensor_extension.c - Telemetry encoding
TelemEncoding.c - AO-40 codec
codecAO40.c - Alternate transmitter
transmit.py - Frequency utilities
frequency.py
Radio stack
- AX.25 framing
afsk/ax25.c - AFSK radio driver
afsk/ax5043.c - Radio initialization
ax5043/axradio/axradioinit.c - Radio modes
ax5043/axradio/axradiomode.c - Packet transmitter
ax5043/axradio/axradiotx.c - Packet receiver
ax5043/axradio/axradiorx.c - Chip support
ax5043/ax5043support - CRC and PN9
ax5043/crc/crc.c - SPI interface
ax5043/spi/ax5043spi.c
Groundstation tools
- Ground reception
groundstation/config_webrx.py - Telemetry decoder
groundstation/fc_block_decode.py - Receiver tuning
groundstation/auto-tune.py - APRS location tools
groundstation/loc-add-foxtelem.py
Sensor extensions
- STEM payloads
stempayload
Other components
- Operator
- AX5043 transceiver
Connections 26
- Operator → Simulator loop: starts
README.md - Simulator loop → Sensor sampling: reads sensors
main.c - Simulator loop → Telemetry encoding: prepares telemetry
- Simulator loop → AO-40 codec: encodes frames
- Simulator loop → AX.25 framing: frames packets
- Simulator loop → AFSK radio driver: transmits radio
- Simulator loop → Radio initialization: configures radio
- AX.25 framing → AFSK radio driver: submits frames
afsk/ax25.c - AFSK radio driver → SPI interface: accesses registers
afsk/ax5043.c - Radio initialization → Chip support: initializes chip
ax5043/axradio/axradioinit.c - Radio initialization → CRC and PN9: uses CRC
ax5043/axradio/axradioinit.c - Packet transmitter → Chip support: uses TX support
ax5043/axradio/axradiotx.c - Packet transmitter → CRC and PN9: appends CRC
ax5043/axradio/axradiotx.c - Packet transmitter → Radio modes: selects mode
ax5043/axradio/axradiotx.c - Radio initialization → SPI interface: configures registers
ax5043/axradio/axradioinit.c - Radio modes → SPI interface: sets mode
ax5043/axradio/axradiomode.c - Packet receiver → SPI interface: reads radio
- Chip support → SPI interface: uses interface
ax5043/ax5043support/ax5043init.c - SPI interface → AX5043 transceiver: reads and writes
- AX5043 transceiver → Ground reception: emits RF
- Ground reception → Telemetry decoder: provides signal
- Receiver tuning → Ground reception: tunes receiver
- APRS location tools → Telemetry decoder: supports telemetry
- STEM payloads → Sensor sampling: extends payload
- Alternate transmitter → AX5043 transceiver: transmits RF
- Frequency utilities → Alternate transmitter: supports tuning