Developer docs

Build, test and release

Building the firmware, running the tests, flashing a device, and what happens between a commit and a release.

The firmware is built, tested and released in Docker, so that a clean machine, your machine and the CI runner all get the same result. These pages say how. For the Debug Console, which is how you work on a device once it is flashed, see Debug Builds and the Debug Console.

Build01

Build, test and release

Docker is the only tool you need. How the firmware is built, how the host tests run, and what CI does on a pull request and on a tag.

Flash02

Flash and update

Put the firmware on a Cardputer over USB, then update it over Wi-Fi or from the SD card, and from the project's releases.

Updates03

How an update works

The signed Update File, the four ways to get one onto a device, Probation and Rollback, and the check that sits in front of all of them.