How pwnsat/flatsat works
FlatSat is a vulnerable-by-design satellite security training platform: users run RF or USB attack exercises against its RP2040 firmware and observe responses. The attack set covers reconnaissance, eavesdropping, fuzzing, command injection, GPS and ground-station spoofing, replay, and reset. The firmware simulates spacecraft communications, telemetry, sensors, and payload control. The README documents these capabilities and dual RF links; source-index references support the shown module dependencies, but unsampled firmware internals limit confidence about their runtime call paths.
Main entry points: worker.cpp Command and mission worker · pwnsat_packets.py Packet toolkit · pwnsat_lora_tx.py LoRa transmitter · 00_recon_apid_enum_rf.py APID reconnaissance
Components 25
Attack exercises
- APID reconnaissance
Attacks/00_recon_apid_enum/00_recon_apid_enum_rf.py - Eavesdropping
Attacks/01_eavesdropping/pwnsat_lora_rx.py - Crash fuzzing
Attacks/02_fuzzing_crash/02_fuzzing_crash_rf.py - Command injection
Attacks/03_command_injection/03_command_injection_rf.py - GPS spoofing
Attacks/04_gps_spoofing/04_gps_spoofing_rf.py - Ground auth spoofing
Attacks/05_gs_auth_spoofing/05_gs_auth_spoofing_rf.py - Packet replay
Attacks/06_replay/06_replay_rf.py - Reset attack
Attacks/07_resetc/07_resetc_rf.py
Attack tooling
- Packet toolkit
Attacks/lib/pwnsat_packets.py - USB transport
Attacks/lib/flatsat_usb.py - LoRa transmitter
Attacks/lib/pwnsat_lora_tx.py - RTL-SDR receiver
Attacks/lib/pwnsat_rtlsdr_rx.py - CatSniffer receiver
Attacks/lib/pwnsat_catsniffer_rx.py
Firmware communications
- Command and mission worker
Firmware/worker.cpp - Space packet protocol
Firmware/spp.cpp - Secure link
Firmware/secure_link.cpp - RF uplink
Firmware/ruplink.cpp - RF downlink
Firmware/rdownlink.cpp - USB CDC link
Firmware/usbCDC.cpp
Firmware services
- Sensor telemetry
Firmware/sensors.cpp - SpaceCAN payload
Firmware/spacecan.cpp - Thruster control
Firmware/thruster.cpp - Mission configuration
Firmware/mission.h - Status LEDs
Firmware/led.cpp
Other components
- Engineer / learner
Connections 40
- Engineer / learner → APID reconnaissance: runs
README.md - Engineer / learner → Eavesdropping: runs
README.md - Engineer / learner → Crash fuzzing: runs
README.md - Engineer / learner → Command injection: runs
README.md - Engineer / learner → GPS spoofing: runs
README.md - Engineer / learner → Ground auth spoofing: runs
README.md - Engineer / learner → Packet replay: runs
README.md - Engineer / learner → Reset attack: runs
README.md - APID reconnaissance → Packet toolkit: imports
Attacks/00_recon_apid_enum/00_recon_apid_enum_rf.py - APID reconnaissance → LoRa transmitter: imports
Attacks/00_recon_apid_enum/00_recon_apid_enum_rf.py - APID reconnaissance → CatSniffer receiver: imports
Attacks/00_recon_apid_enum/00_recon_apid_enum_rf.py - APID reconnaissance → RTL-SDR receiver: imports
Attacks/00_recon_apid_enum/00_recon_apid_enum_rf.py - Crash fuzzing → Packet toolkit: imports
Attacks/02_fuzzing_crash/02_fuzzing_crash_rf.py - Crash fuzzing → LoRa transmitter: imports
Attacks/02_fuzzing_crash/02_fuzzing_crash_rf.py - Command injection → Packet toolkit: imports
Attacks/03_command_injection/03_command_injection_rf.py - Command injection → LoRa transmitter: imports
Attacks/03_command_injection/03_command_injection_rf.py - GPS spoofing → Packet toolkit: imports
Attacks/04_gps_spoofing/04_gps_spoofing_rf.py - GPS spoofing → LoRa transmitter: imports
Attacks/04_gps_spoofing/04_gps_spoofing_rf.py - Ground auth spoofing → Packet toolkit: imports
Attacks/05_gs_auth_spoofing/05_gs_auth_spoofing_rf.py - Ground auth spoofing → LoRa transmitter: imports
Attacks/05_gs_auth_spoofing/05_gs_auth_spoofing_rf.py - Ground auth spoofing → CatSniffer receiver: imports
Attacks/05_gs_auth_spoofing/05_gs_auth_spoofing_rf.py - Ground auth spoofing → RTL-SDR receiver: imports
Attacks/05_gs_auth_spoofing/05_gs_auth_spoofing_rf.py - Packet replay → Packet toolkit: imports
Attacks/06_replay/06_replay_rf.py - Packet replay → LoRa transmitter: imports
Attacks/06_replay/06_replay_rf.py - Packet replay → CatSniffer receiver: imports
Attacks/06_replay/06_replay_rf.py - Packet replay → RTL-SDR receiver: imports
Attacks/06_replay/06_replay_rf.py - Reset attack → Packet toolkit: imports
Attacks/07_resetc/07_resetc_rf.py - Reset attack → LoRa transmitter: imports
Attacks/07_resetc/07_resetc_rf.py - RTL-SDR receiver → Eavesdropping: uses flowgraph
Attacks/lib/pwnsat_rtlsdr_rx.py - USB transport → Packet toolkit: imports
Attacks/lib/flatsat_usb.py - Command and mission worker → Space packet protocol: imports
Firmware/worker.cpp - Command and mission worker → Secure link: imports
Firmware/worker.cpp - Command and mission worker → RF uplink: imports
Firmware/worker.cpp - Command and mission worker → RF downlink: imports
Firmware/worker.cpp - Command and mission worker → USB CDC link: imports
Firmware/worker.cpp - Command and mission worker → Sensor telemetry: imports
Firmware/worker.cpp - Command and mission worker → SpaceCAN payload: imports
Firmware/worker.cpp - Command and mission worker → Thruster control: imports
Firmware/worker.cpp - Command and mission worker → Mission configuration: imports
Firmware/worker.cpp - Command and mission worker → Status LEDs: imports
Firmware/worker.cpp