Ruby Monome Serial

A library for direct communication with a monome device via a serial connection.

Dependencies:

• Ruby 1.9.1
• activesupport
• fcntl

Quickstart

Install the gem:

gem install monome_serial

Check to see if ruby-termios is functioning correctly

At the time of publication, I didn’t find that the termios gem (arika-ruby-termios) compiled correctly. To see if it works for you try requiring termios and if it isn’t you’ll see something like this:

λ irb
irb(main):001:0> require 'termios'
LoadError: no such file to load -- termios.so

I ended up having to pull a zip of the project from Github and to install it manually (follow the Readme). When it’s working you should see:

λ irb
irb(main):001:0> require 'termios'
=> true

Make sure you have the ftdi drivers installed for your OS

Pop along to the FTDI Chip site then download and install the correct drivers for your OS.

Plug in your monome

Make sure you marvel of the beauty that is the LEDs flashing around the power source.

Try the example toggle app

Run: ruby examples/toggler.rb

Now make pretty shapes on your monome!

Notes

• This library has only been tested on OS X - any patches (with accompanying specs) for other OSs are welcome.
• The library is also currently hardcoded to run against Ruby 1.9.1. If this is an issue for you, and you are willing to submit specced patches for other interpreters then these are also welcome.