The host application can be either downloaded as a pre-compiled binary, or compiled by the user. The application is written using the Processing programming language, and can be easily compiled using the free Processing IDE. To compile the application, load the source code with the Processing IDE.
To compile and run the app, click the “Run” arrow in the upper left corner:
You should now have the application running, and it looks like this:
You can also export a compiled version of the application by clicking “Export Application…” under the “File” menu. This will provide you with a clickable stand-alone version of the app.
The Microcontroller Code
Next, you’ll need to compile and load the software onto the Teensy 2.0. The easiest way to do this is using the Arduino environment. Follow the instructions here to add Teensy 2.0 support to the Arduino IDE. If this is the first time you’re loading code onto your Teensy, you’ll need to bootstrap using the Teensy Loader application. Open that application before you compile.
Load and compile the code in the Arduino environment. It’s almost the same as in Processing:
Now, press the “reset” button on your Teensy. A progress bar should appear on the Teensy Loader app, and your code will be transferred.
The OSC Protocol
On opening the host application, select the OSC port number and the serial port for your Octomod board. This will probably be something like “usb-modem12345.” The application will not respond to OSC or MIDI in until a serial port has been selected.
Now, you’ll want to send some OSC to the host application. The app expects an OSC message formatted like this: “/dac 1 2 3 4 5 6 7 8” where the numbers 1 – 8 are replaced with the desired output value, 0 – 1023. An example message might be “/dac 345 200 100 175 756 800 800 354”.
You can also send MIDI control messages (0 – 127) to each of the 8 channels. MIDI control numbers 0 – 7 map to Octomod output channels 1 – 8.