How smallsatgasteam/cubeworks works
CubeWorks is GASPACS flight software for a Raspberry Pi Zero W. Its main workflow is mission-mode control: collect and persist telemetry, apply deployment and safe-mode logic, and service scheduled transmissions and ground commands. Hardware access is abstracted through interchangeable real and dummy drivers; transmission includes preparation, queuing, command processing, and a C radio service. The graph uses documented capabilities and indexed references; several mission-mode and controller implementations were not sampled, so those connections are omitted or marked unverified.
Main entry points: packetProcessing.py Packet processing · missionModes Mission modes · getDriverData.py Telemetry collection · transmitting.py TX scheduling
Components 19
Flight control
- Flight controller
flightLogic/mainFlightLogic.py - Mission modes
flightLogic/missionModes - Boom deployment
flightLogic/missionModes/boomDeploy.py - Safe mode
flightLogic/missionModes/preBoomDeploy.py
Telemetry and devices
- Telemetry collection
flightLogic/getDriverData.py - Hardware drivers
Drivers - Dummy drivers
DummyDrivers - Telemetry files
flightLogic/saveTofiles.py - Camera and images
Drivers/camera/Camera.py
Communications
- UART interrupt
TXISR/pythonInterrupt.py - Packet processing
TXISR/packetProcessing.py - TX window queue
TXISR/transmitionQueue.py - TX scheduling
flightLogic/missionModes/transmitting.py - File preparation
TXISR/prepareFiles.py - Radio service
TXISR/TXServiceCode/TXServiceCode.c
Data protection
- File protection
protectionProticol/fileProtection.py
Other components
- Mission operator
- Ground station
- Satellite hardware
Connections 25
- Mission operator → Flight controller: starts flight
- Flight controller → Mission modes: selects modes
- Mission modes → Telemetry collection: collects telemetry
- Mission modes → Boom deployment: runs deployment
- Mission modes → Safe mode: runs safeguards
- Telemetry collection → Hardware drivers: reads devices
flightLogic/getDriverData.py - Telemetry collection → Telemetry files: writes records
flightLogic/getDriverData.py - Hardware drivers → Satellite hardware: reads and actuates
- Dummy drivers → Satellite hardware: simulates devices
- Telemetry collection → Dummy drivers: supports simulation
- Camera and images → Satellite hardware: captures images
- Ground station → UART interrupt: sends commands
- UART interrupt → Packet processing: dispatches packets
TXISR/pythonInterrupt.py - Packet processing → TX window queue: enqueues windows
TXISR/packetProcessing.py - Packet processing → Camera and images: uses camera
TXISR/packetProcessing.py - Packet processing → File protection: checks files
TXISR/packetProcessing.py - Packet processing → TX scheduling: checks TX state
TXISR/packetProcessing.py - Packet processing → Hardware drivers: commands deployer
TXISR/packetProcessing.py - TX scheduling → TX window queue: reads windows
flightLogic/missionModes/transmitting.py - TX scheduling → File preparation: prepares data
flightLogic/missionModes/transmitting.py - TX scheduling → Radio service: starts radio service
- File preparation → Camera and images: packages images
TXISR/prepareFiles.py - File preparation → File protection: checks files
TXISR/prepareFiles.py - TX window queue → File protection: validates windows
TXISR/transmitionQueue.py - Radio service → Ground station: transmits data