Repository navigation
FlatSat Firmware v1.0.3
An update over the public v1.0.0 baseline (previously published at
Pwnsat/FlatSat_Firmware, now archived as the
legacy v1.0.0 release
on this repo) — adds a full layer of simulated real-satellite-mission
subsystems on top of the original two-radio LoRa/CCSDS firmware, with
intentional vulnerabilities backing the
8 validated attack scripts
and the wiki's Attack Walkthroughs.
New subsystems
- Ground-station authentication — GS modes, challenge/response access control, live status telemetry.
- Mission modes —
SAFE/NOMINAL/PAYLOAD/SCIENCE/CONTINGENCY, with subsystem-health status flags. - Downlink encryption — AES-128, active by default, toggleable over the air.
- GPS navigation — full NMEA parsing, a dedicated UART, and a
GET_NAVtelemetry APID. - Simulated SpaceCAN bus console — a 3-node (SENSOR/MOTOR/BATTERY) serial console with frame injection and node reset.
- "Secured" SPP packet format — an opt-in secondary header, parallel to the existing plain format.
- 4 new APIDs:
FLASH_READ,GET_STATUS,GET_PAYLOAD_STATUS,DEBUG_CONFIG. - Commands are now handled separately by origin (radio vs. USB), so USB-only debug commands can't be reached over RF.
Bug fixes vs. v1.0.0
- Fixed LoRa radios failing to initialize (
-707/RADIOLIB_ERR_SPI_CMD_FAILED) — root cause was an implicit TCXO expectation in RadioLib's default config; this module uses a plain XTAL. - Fixed a blocking-transmit race in the downlink radio.
- Fixed payload corruption in the debug-mode receive path.
- Fixed 32 misaligned serial log lines (
\n→\r\n).
Intentional vulnerabilities (by design)
This firmware is vulnerable on purpose — see the
Attack Vectors
and Attack Walkthroughs
wiki pages for the full list, plus Firmware/README.md
for the file-by-file diff.
Assets
flatsat-firmware.uf2— pre-built binary, RP2040/Pico. Flash by holding BOOTSEL while plugging in over USB, then copying the file onto theRPI-RP2volume that appears.
Build it yourself
git clone https://github.com/Pwnsat/FlatSat
cd FlatSat/Firmware
pio runSee Firmware/README.md for required libraries and board config.