Overview

This chapter will guide you through some key Precious Blocks firmware-development steps.
It is meant for people who want to contribute new features to the blocks or adapt them to their use case.

The device firmware can be found in the firmware repository on Codeberg and is licensed under GPL-3.0-or-later.
More detailed license information is tracked using the REUSE spec in the REUSE.toml, and other nested REUSE.toml files.

Notes on custom firmware

This chapter only focuses on the official Precious Blocks firmware.
If you want, you can simply flash your own custom firmware onto the internal microcontroller over USB, like you would with other ESP-based projects. Simply select a binary firmware built for the ESP32-S3 (make sure to match the flash and psram configuration) and flash it using esptool.py or espflash.
The internal PCB also exposes the boot and reset buttons, which you can use to control the boot mode behaviour.