neogrid/firmware/README.md

1.3 KiB

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

  1. Make sure to have a compiler toolchain supporting the RP2 architecture installed (Mac: brew install gcc-arm-embedded)
  2. Clone the micropython repo
  3. From within the micropython repo root, run make -C mpy-cross
  4. Copy the OLIMEX_PICO2_XL folder to micropython/ports/rp2/boards if it doesn't exist; overwrite it if it does
  5. Change to the boards/rp2 folder
  6. Run make BOARD=OLIMEX_PICO2_XL submodules to install dependencies
  7. Run make BOARD=OLIMEX_PICO2_XL clean to remove previous build artefacts (if any)
  8. Run make BOARD=OLIMEX_PICO2_XL to build the firmware

flashing

  1. The build output can be found in micropython/ports/rp2/build-OLIMEX_PICO2_XL (or in this folder for convenience)
  2. Connect the MCU board to your computer using a data-capable USB cable
  3. On the MCU board, hold boot while pressing rst
  4. 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.