Home

Users

The User Guide is here!

Developers

Building the firmware primarily uses the PlatformIO toolchain.

• Run pio run from the repo root to build both default targets: app & bootloader.
  • The app build runs tools/makesyx.py and writes a *.syx file for the MIDI bootloader.
  • You'll also get a combined app+bootloader HEX file for upload with an ISP tool.
• You might have to run pip install intelhex once locally, possibly using ~/.platformio/penv/Scripts/pip.
• You might need to use pio run -t clean after making code changes, to ensure freshness.

Arduino IDE (optional)

Install Arduino IDE and Teensyduino (adds Teensy boards). Open src/src.ino, set Tools → Board → Teensy++ 2.0 and CPU speed 4 MHz, then compile. Use the script tools/hex2sysex.py to convert the compiled firmware.hex file to SysEx data for the MIDI bootloader.

Forks

If you fork the repo and enable GitHub Actions workflows on your fork, the server will build it for you when code changes are pushed. Anyone logged in to GH can download the artifact files.

Keep an eye on the SuperOS-303 project - it lives up to the name!