How uworbital/obc-firmware works
Project Type and Purpose
• This is a multi‐component CubeSat software stack developed by UW Orbital’s firmware team.
• It comprises:
a. On‐Board Computer (OBC) firmware (embedded C/C++ running on TI RM46 with FreeRTOS)
b. Hardware‐in‐the‐Loop (HIL) simulator (C++ examples and log‐sink)
c. Ground Station (GS) full‐stack app:
• Backend (Python FastAPI REST API + PostgreSQL)
• Frontend (TypeScript/React apps for ARO and MCC)
d. Shared interfaces and libraries (serial port, FEC, AES, GNC code, Reliance Edge FS, etc.)
e. Tests and CI scripts
File Structure Overview
• Top‐level build & CI: CMakeLists.txt, cmake/, scripts/, .github/workflows/
• ‘obc/’: firmware source split into bootloader (bl/), application (app/), shared HAL, tools, examples
• ‘interfaces/’: C libraries for OBC↔GS packet pack/unpack, CRC, FEC, telemetry
• ‘libs/’: third‐party & generated code (cserialport, libcorrect, tiny_aes, posix_freertos, GNC code)
• ‘hil/’: HIL C++ examples and log sink
• ‘gs/’:
• gs/backend/: FastAPI service, middleware, v1 API (aro & mcc endpoints), database ORM
• gs/frontend/: two Deno/Vite React apps (ARO and MCC) served on localhost
• ‘test/’ & ‘python_test/’: C/C++ unit tests, Python unit tests
• Configuration & docs: README.md, gs/POSTGRESQL_SETUP.md, scripts, compose-dev.yaml
README Insights
• Clarifies cross‐platform build setup (WSL2, Mac, Linux, Windows)
• Describes multi‐target CMake builds (OBC, GS, Test, Examples)
• Outlines technology stack: C/C++ with HALCoGen & Code Composer, Python FastAPI, React/TS, Deno, PostgreSQL