PER Software ⚡️

A monorepo of all firmware projects, shared libraries, code generation, and off-car tooling for PER FSAE EV.

Directory Structure

• firmware/ - Embedded firmware, including its CAN library and shared C code
• daqapp/ - Desktop DAQ application
• docs/ - Shared documentation

Doxygen

Most recent doxygen deployment (master branch): https://purdueelectricracing.github.io/monorepo/

Getting Started

To compile software for the PER vehicle, make sure your system is set up by following the steps in setup.md if you haven’t already.

Note

setup.md is here!

Building

build_all.py is the repository-level build entry point. It runs the complete firmware, DAQ app, and host-test workflows in order.

From the repository root, build all projects and run tests with:

python3 build_all.py

Each component also has a fixed build command. To build and package all firmware boards:

python3 firmware/build_firmware.py

To run static analysis over all firmware boards:

python3 firmware/check_firmware.py

To build DaqApp:

cargo build --manifest-path daqapp/Cargo.toml

To run host tests and generate an HTML coverage report:

python3 tests/build_tests.py

Hardware Debugging

In VS Code, go to View → Run and Debug, select the appropriate MCU target from the dropdown, then press the green ▶️ arrow to flash and live-debug the firmware.

Once everything is set up, open the repository with code .. You can then build all projects by pressing:

Ctrl + Shift + B on Windows/Linux
Cmd + Shift + B on macOS

This triggers the default build task configured in .vscode/tasks.json, which runs the monorepo build process automatically.