hw/0x33.board/firmware / main

Tree @main (Download .tar.gz)

0x33.board firmware

See the documentation for information on how to use the firmware. The rest of this documentation contains information for firmware development.


  1. Make sure your board is in dev_mode (see below)
  2. Copy all files from this repository to the CircuitPython drive
  3. Install the dependencies:
  4. using circup: $ circup [--path /path/to/drive] install -r requirements.txt
  5. manually download the needed libraries from the Adafruit CircuitPython Library Bundle and place them in the lib folder
  6. Set hardware settings in
    Import the module from hex33board.boards corresponding to the hardware revision you have.


The simulator can be run directly in the repo and using CPython.

  1. (optionally) create and enter a venv
    $ python -m venv --system-site-packages venv
    $ source venv/bin/activate
    The --system-site-packages option allows you to use your distribution's Pillow packages.
  2. install the dependencies: $ pip install -r requirements.sim.txt
  3. run the simulator: $ python
  4. open the web interface (http://localhost:8000)

Boot modes

After a reset, is executed. Depending on the dev_mode value in and whether the menu button (very top left of the board) is pressed, the board boots in different modes:

With dev_mode = False and the button not pressed, the board starts in "normal mode". The board will show up as a read-only flash drive on the computer, and settings changed in the boards menu will be saved automatically.

When the button is pressed, the board starts in "dev mode". In this case the board shows up read-write on the computer and will autoreload as the firmware is changed. While "dev mode" is active, settings changed on the board aren't saved.

If dev_mode = True in, things work the other way around: the board goes into "dev mode" by default, but will start in "normal mode" when the menu key is held during reset.

Using the Simulator