# Firmware

Kaptan flight-controller firmware workspace.

```text
firmware/
├── boards/     board hardware declarations and entry points
├── libs/       reusable no_std firmware crates
├── platforms/  hardware composition, configuration and linker layouts
├── tools/      local configuration and telemetry tools
└── scripts/    packaging, analysis, and coverage helpers
```

This workspace owns its Makefile. From this directory, list its commands with:

```sh
make help
```

From the repository root, the firmware path is a direct Cargo proxy. For
example, `make firmware -- test --workspace --locked --offline` runs the host
test suite. Build and package every supported board with
`make firmware/boards`, or select one board by its directory path.
Run `make firmware clippy` for Rust lints and `make firmware docs` for API
documentation with warnings denied.
The board images do not yet run the flight runtime or implement motor drivers.
Motor pins are inhibited at startup. Physical flight has not been qualified.