feat(mcu): Add micropython firmware and build instructions

This commit is contained in:
viernullvier 2026-04-07 23:35:49 +02:00
commit b15eeca2b2
9 changed files with 107 additions and 0 deletions

25
firmware/README.md Normal file
View file

@ -0,0 +1,25 @@
# firmware
Custom micropython build for the Olimex RP2350B-XL. Comes with some features enabled and modules bundled that are not part of an eventual upstream build.
## build instructions
0. Make sure to have a compiler toolchain supporting the RP2 architecture installed (Mac: `brew install gcc-arm-embedded`)
1. Clone the `micropython` repo
2. From within the `micropython` repo root, run `make -C mpy-cross`
3. Copy the `OLIMEX_PICO2_XL` folder to `micropython/ports/rp2/boards` if it doesn't exist; overwrite it if it does
4. Change to the `boards/rp2` folder
5. Run `make BOARD=OLIMEX_PICO2_XL submodules` to install dependencies
6. Run `make BOARD=OLIMEX_PICO2_XL clean` to remove previous build artefacts (if any)
7. Run `make BOARD=OLIMEX_PICO2_XL` to build the firmware
## flashing
0. The build output can be found in `micropython/ports/rp2/build-OLIMEX_PICO2_XL` (or in this folder for convenience)
1. Connect the MCU board to your computer using a data-capable USB cable
2. On the MCU board, hold `boot` while pressing `rst`
3. A new removable disk drive should appear. Copy `firmware.uf2` onto this disk drive - this will flash the MCU board with the custom micropython build.
## using
Once micropython is flashed, copy `boot.py`, `main.py` and any auxiliary files for the specific hardware type onto the MCU flash. Refer to the micropython docs for further info.