Tree @main (Download .tar.gz)
See the documentation for information on how to use the firmware. The rest of this documentation contains information for firmware development.
- Make sure your board is in
- Copy all files from this repository to the CircuitPython drive
- Install the dependencies:
- using circup:
$ circup [--path /path/to/drive] install -r requirements.txt
- manually download the needed libraries from the Adafruit CircuitPython Library Bundle
and place them in the
- Set hardware settings in
Import the module from
hex33board.boardscorresponding to the hardware revision you have.
The simulator can be run directly in the repo and using CPython.
- (optionally) create and enter a venv
$ python -m venv --system-site-packages venv
$ source venv/bin/activate
--system-site-packagesoption allows you to use your distribution's Pillow packages.
- install the dependencies:
$ pip install -r requirements.sim.txt
- run the simulator:
$ python simulator.py
- open the web interface (http://localhost:8000)
After a reset,
boot.py is executed. Depending on the
dev_mode value in
whether the menu button (very top left of the board) is pressed, the board boots in different modes:
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.
dev_mode = True in
config.py, 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
git clone https://git.s-ol.nu/hw/0x33.board/firmware.git
- USB MIDI note highlighting s-ol 4 months ago
- simulator: make rtmidi optional s-ol 4 months ago
- simulator: remove context menu, outlines, etc in multitouch chrome s-ol 4 months ago
- fix(requirements.sim.txt): add websockets Arthur Lutz 4 months ago
- simulator: SVG snapshots, reconnecting s-ol 4 months ago
- simulator: web-based, interactive UI s-ol 4 months ago
- update all board definitions s-ol 4 months ago
- add adafruit_ticks dependency s-ol 4 months ago
- simulator: PyQt5 SVG keyboard view s-ol 5 months ago
- simulator: sync matrix state via SysEx messages s-ol 5 months ago