Home

User Guide? Coming soon...

Development

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 app-update.syx 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 1.8.x and Teensyduino (adds Teensy boards). Open src/src.ino, set Tools → Board → Teensy++ 2.0 and CPU speed 16 MHz, then compile or upload. The sketch uses main.cpp in the same folder. For a SysEx file matching PlatformIO output, use pio run -e app and deploy app-update.syx.

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

Forks

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