an openFrameworks addon for interfacing with ICubeX digitizers
C++ Makefile Objective-C++ Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
exampleICubeX
exampleICubeX_iOS
exampleSimpleICubeX
libs/ICubeXInterface
ofICubeXLaserHarp
ofSenseplayDemoDesktop
ofSenseplayDemoRPi
ofSenseplayDemoRPi_mcp3008
ofSenseplayDemo_iOS
ofSenseplayRPiTest
simpleICubeXParser_iOS
src
.gitignore
README.md

README.md

ofxICubeX

Addon to interface with ICubeX digitizers. Currently tested with the USB-microDig, WI-microdig and the MIDI Digitizer (first 8 ports). Supports both sensor input and actuator output.

On portable platforms, the supported features are limited, as shown in the following table:

Compatibility

OS USB-microDig Wi-microDig MIDI Digitizer
Windows Yes Yes Yes*
OSX Yes Yes Yes*
Linux Yes Yes Yes*
iOS Limited No Yes*
Android Limited Yes Yes*

*Requires class compliant USB MIDI adapter

Limited: can only be used in stand alone mode to receive MIDI messages from the digitizer, and requires an existing stand alone configuration on Desktop system using the ICubeX Editor. In this case, the oF app cannot change the settings/operation mode of the digitizer, but once set up (via the desktop Editor), the digitizer can be used as a standard MIDI out device, and messages can be parsed using the inputExample from ofxMidi (TBD: tutorial for this).

Other (non-default) Addons required:

Setup Requirements:

Windows:

  • USB-microDig: follow setup instructions here until BlueMIDI is set up. (No need to proceed further):
  • Wi-microDig: follow setup instructions here: (...)

OSX:

Linux:

  • USB-microDig:
  • - Tested with Ubuntu 10.04LTS, and Raspbian (For Raspberry Pi)
  • - UBB Driver built into most modern releases
  • - Serial->midi bridge, such as this modified version of ttymidi which passes SysEx data to/from the USB serial device.
  • Wi-microDig: to be tested/documented.

iOS:

  • No special setup is required, other than making sure the required addons are in the path.
  • We have tested with the iRig Midi 2 as well as iConnect MIDI adapters; Any generic, class-compliant USB-MIDI cable should work fine.

Android:

The Android version is experimental, and requires the following additional components:

  • AndroidMidi library
  • Our slightly modified version of ofxMidi, and ofxAndroid addons. (link link) Make sure you are familiar with the Android/oF toolchain and comfortable compiling generic oF applications for Android before attempting to do this!

Other Notes:

  • If you create a blank project with the oF project generator, make sure to manually add the CoreMIDI framework (Build Phases->Link Binary With Libraries) for MAC/iOS, or winmm.lib in Windows.

There are three example applications. Once the driver is loaded and Connect is running, the following apps should work out of the box:

  • - exampleICubeX: a more featured GUI application that visually shows sensor data, and allows control of a number of parameters of the digitizer
  • - exampleSimpleICubeX: a bare bones app showing the basic commands for talking to the digitizer. if you want to hook up to sensors directly, this is a good place to start as the relevant features are not interlarded with GUI setup code. The setup() function in ofApp.cpp contains comments walking through the process of connecting to, setting up and getting data from the ICubeX digitizers.

Created by Johnty Wang (johnty@infusionsystems.com) Oct 2014

Latest revision 13 Jan 2015