System Repository Map
This index serves as the central directory for our software architecture. Select a repository below to access its specific hardware requirements, pinout configurations, and build instructions.
Vehicle Firmware
These repositories contain the C/C++ firmware running directly on our custom STM32 boards.
- CAN-Gateway Sensors I/O Filters and routes messages between the CAN nodes on the vehicle. Sensor aggregation board.
- ECU Vehicle Control The main control unit. Manages the primary state machine, torque requests, and safety circuit monitoring.
- Galvanic-Isolator Ensures electrical separation and safe signal transfer between high-voltage inverters and low-voltage logic.
- LVSOC-26 Monitoring State of Charge (SoC) calculations and health monitoring for the Low Voltage battery system via I2C.
- Telemetry Wireless Aggregates vehicle state data and handles UDP transmission to a cloud server (see backend)
- Charger Interfacing and control logic for the accumulator charger.
Backend & Analysis
Off-car software used for data analysis, visualization, and logging.
- Backend Infrastructure Handles the ingestion of data over UDP. Uses several databases and live viewing tools. Also hosts other team applications, such as lap tracking, the VitePress docs and much more.
- Partners Database A Java Spring Boot application designed to manage, track, and visualize sponsorship data and team partner relations.
Shared Infrastructure
Code that is reused across multiple microcontroller nodes or team members.
- Common Libraries Submodule Shared firmware libraries. Contains our standardized CAN DBC definitions, FSM wrappers, and math utilities. Included as a Git submodule in all STM32 firmware repos.
- Utilities Assorted scripts and tooling for CAN database generation, serial logging, and automated local testing setups.
⚙️ Map Maintenance Protocol
This index mirrors our active GitHub repositories for the current season. As we extract verified details and establish new nodes on the network, they will be documented here. If you create a new repository, you are responsible for adding its link to this map before merging your final PR.