serialosc runs in the background and converts serial communication (over USB) into OSC. applications can query serialosc to connect to the grid and arc.
linux: see the linux setup guide
raspberry pi: see the raspbian setup guide
If your grid or arc is not being detected when you plug into your Mac (but it is showing the light burst indicating its receiving power over USB), here are a few things to try.
On your Mac, open Activity Monitor and search
serialosc. you should see entries for both
serialoscd. if you do not, then serialosc is not installed.
- Once you confirm serialosc is installed, please connect your grid/arc and open Terminal.
ls -lrt /dev/tty.usb*
- if you get
ls: /dev/tty.usb*: No such file or directoryback, then your grid/arc is not connecting and you should try a different USB cable.
- an example successful response:
crw-rw-rw- 1 root wheel 20, 6 Nov 8 08:08 /dev/tty.usbserial-m1100368
- In Terminal, confirm that you do not have any conflicting FTDI drivers installed:
ls /System/Library/Extensions | grep FTDI
- you should only get
- if you get
FTDIKext.kextback, it needs to be uninstalled:
cd /System/Library/Extensions rm -r FTDIUSBSerialDriver.kext cd /Library/Receipts rm -r FTDIUSBSerialDriver.kext
Now, reboot and try step 2 again. if things are still not working, open Terminal and execute:
launchctl unload /Library/LaunchAgents/org.monome.serialosc.plist launchctl load /Library/LaunchAgents/org.monome.serialosc.plist
In Max, open either grid-test.maxpat or arc-test.maxpat (depending on the monome device). if you can’t find the patchers, use CMD+B to open Max’s file browser and search either
package:monome arc-test.maxpat. plug in your grid/arc and you should see your grid/arc connect automatically!
Do you have TouchOSC Bridge or TouchOSC Editor installed? Try removing them and installing the latest versions. You should be able to run both TouchOSC and serialosc, but we’ve found that reinstalling the TouchOSC software is necessary in some situations.
Do you have any Wacom drivers installed? Please follow these removal steps, as we’ve found that these drivers can block serialosc.
If you’ve reached this point and things still aren’t working, please contact firstname.lastname@example.org with screenshots of what you see in steps 1-4, what you see in the Max console (CMD+B), and your Mac’s OS version.
If your grid or arc is not being detected when you plug into your Windows machine (but it is showing the light burst indicating its receiving power over USB), here are a few things to try.
- If you don’t have iTunes installed on your device, you might be missing Bonjour, which Max uses to communicate with OSC and networked devices. To remedy, please install Bonjour Print Services.
- The beta version of serialosc 1.4.1 might improve connectivity.
- Try starting serialosc manually from the Services program. If you see
Error 1075, you might need to tweak your registry.
- You may need to manually install the FTDI VCP driver, which you get get here.