Firmware Files

This directory is not used directly. The web flasher loads MicroPython firmware from the build output directory.

MicroPython Build Location

The firmware files are loaded from:

../disobey-badge-2025-game-firmware/micropython/ports/esp32/build-ESP32_GENERIC_S3-DEVKITW2/

Required Files

The web flasher uses these files from the MicroPython build:

  • bootloader/bootloader.bin - ESP32-S3 bootloader (offset 0x1000 / 4096)
  • partition_table/partition-table.bin - Partition table (offset 0x8000 / 32768)
  • micropython.bin - MicroPython firmware (offset 0x10000 / 65536)

Building MicroPython

To build the firmware, navigate to the MicroPython ports directory and run:

cd ../disobey-badge-2025-game-firmware/micropython/ports/esp32
make BOARD=ESP32_GENERIC_S3-DEVKITW2

The build artifacts will be placed in build-ESP32_GENERIC_S3-DEVKITW2/.

Testing

After building the firmware, test the web flasher at /web-flash in your browser.