Link

grid and arc basic setup

→ download serialosc

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

getting started

the max 7 monome package is a collection of applications and tools for Max 7 which can be used with the free runtime.

see the applications list for several more.

troubleshooting

macOS

if you have performed all the above steps and 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.

  1. on your Mac, open Activity Monitor and search serialosc. you should see entries for both serialosc-detector and serialoscd. if you do not, then serialosc is not installed.

  2. once you confirm serialosc is installed, please connect your grid/arc and open Terminal.
    • execute ls -lrt /dev/tty.usb*
    • if you get ls: /dev/tty.usb*: No such file or directory back, 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
  3. in Terminal, confirm that you do not have any conflicting FTDI drivers installed:
    • execute ls /System/Library/Extensions | grep FTDI
    • you should only get AppleUSBFTDI.kext back.
    • if you get FTDIKext.kext back, it needs to be uninstalled:
     cd /System/Library/Extensions
     rm -r FTDIUSBSerialDriver.kext
     cd /Library/Receipts
     rm -r FTDIUSBSerialDriver.kext
    
  4. 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 grid-test.maxpat or package:monome arc-test.maxpat. plug in your grid/arc and you should see your grid/arc connect automatically!

if you’ve reached this point and things still aren’t working, please contact help@monome.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.