Part V · Writing firmware
This Part is about ProkBox’s own firmware: how to get the source, build it, test a change and contribute it. It assumes you are comfortable with C and a command line, but not that you know Rockbox or this player.
In this edition:
- FW-2 From clone to release: the whole process in one chapter, and a map of the repository.
- FW-3 Setting up the toolchain: macOS, Linux and containers.
- FW-4 Building: the simulator, the firmware, the bootloader, and putting a build on a player.
- FW-8 The CPU and the COP: what runs on which of the two cores, in 0.8.0 and in the target design.
- FW-18 Testing: the gate and the quicker loops.
- FW-20 Contributing: the process, and the legal and naming rules.
Chapters FW-1, FW-5 to FW-7, FW-9 to FW-17 and FW-19 come in later editions. Their numbers are reserved, so the numbers above will not change.
- FW-2 From clone to releaseThe whole process in one chapter, and a map of the repository.
- FW-3 Setting up the toolchainThe compilers and tools ProkBox needs, on macOS, on Linux and in a container.
- FW-4 BuildingBuilding the simulator, the firmware and the bootloader, and putting a build on a player.
- FW-8 The CPU and the COPWhat runs on which of the PP5022's two cores, in 0.8.0 and in the target design.
- FW-18 TestingHow to test a change to the ProkBox5g firmware: the gate, the quick loops, reading a failure, and the rules that keep the gate honest.
- FW-20 ContributingHow to send a change to ProkBox5g, and the licence, naming and evidence rules every contribution follows.