Skip to content

FlatSat Firmware v1.0.3

Latest

Choose a tag to compare

@r0r0x-xx r0r0x-xx released this 08 Aug 16:02
· 5 commits to main since this release

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_NAV telemetry 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 the RPI-RP2 volume that appears.

Build it yourself

git clone https://github.com/Pwnsat/FlatSat
cd FlatSat/Firmware
pio run

See Firmware/README.md for required libraries and board config.