This document will walk you through the procedure of adding the wi-microDig to your Bluetooth devices list and connecting to the wi-microDig using Max/MSP.
For this walkthrough, you will need:
- A wi-microDig
- Turn sensor (or any other sensor)
- A machine with built-in bluetooth (any recent Mac)
- A working installation of Max/MSP (v4.x or v5)
- iCube external in your Cycling '74/externals folder
- icubex.digitizer placed in the Max5/patches folder
Adding the Wi-microDig as a Bluetooth device
Max/MSP uses the serial object to communicate with the Wi-microDig. To
create a serial port for the Wi-microDig, it must be added to OS X as a
Open the System Preferences. In Bluetooth preferences, click on the + button to start the
Bluetooth Setup Assistant.
Click on "Any Device" and Continue. You should see the Wi-
microDig in the list of devices.
In Passkey Options, choose "Use a specific passkey".
Click Continue. A popup will ask to enter a passkey. Click on "Don't Pair", and then click continue again.
When the main dialog asks for the passkey, enter the number 1 and
The dialog should say "A computer serial port was created". Click
Quit. Your Wi-microDig is now ready to use with Max/MSP.
Installing the iCube external
The iCube object talks to the wi-microDig.
You can download it here
Place the icube.mxo file (found in the objects folder within the zip file linked above) in
the folder Cycling '74/externals (Cycling '74/max-externals in Max5).
Using the icubex.digitizer object
Once the icubex.digitizer.maxpat file is placed in the Max5/patches folder, it can be integrated into your own patches. Alternately, if you choose not to put icubex.digitizer into the patches folder, you'll need to place it in the same folder as any patch that includes it.
The icubex.digitizer can be included in your patch, just like any object. Double-clicking on it brings up the patch itself, which has controls for connecting to the I-CubeX digitizer of your choice, and for turning sensor inputs on and off and changing the resolution of the sensor data. If you're using the wi-microDig, you can also control the digital outputs from this patch.
Connecting to the wi-microDig
Once you've added icubex.digitizer to your patch, double click on it to see the controls. In the Connection section at the top, choose wi-microDig from the pulldown menu, and then your wi-microDig indicated by its serial number.
If you don't see the wi-microDig listed, make sure
you've added it as a Bluetooth device following the instructions above..
Upon connecting, the port menu will turn green and the blue LED on the wi-microDig will illuminate.
If the patch doesn't connect to the Wi-microDig, check that your
Bluetooth is turned on. Max/MSP will not warn you if it is turned off, it
will just not connect.
At this point, you can start receiving sensor data. To turn on any of the 8 analog sensor inputs, click on 1 of the 8 toggle
boxes. Next to each of the toggle boxes is a switch to choose between
low-resolution (7-bit) and high-resolution (10-bit). Note that on the left
hand side there is a toggle to turn all 8 inputs on or off, as well as a
resolution selector for all 8. The control for sampling interval control is immediately below the all-
input control. The minimum setting, corresponding to the maximum sampling rate, is 1 millisecond.
The sensor data is routed to the 8 outlets of icubex.digitizer, where it can be used by the rest of your patch.