monome-teensy

allows teensy development boards to communicate with monome grids via monome serial protocol

• works with teensy 3.6, 4.0 and 4.1 (when usb host is configured)
• designed for varibright 128 grids
• experimental support for monobright, 64 and 256 grids
• experimental support for arc

monome-teensy is a library that allows teensy devices configured as usb hosts to communicate with monome devices via usb serial. it uses the USBHost_t36 library and works with teensy development boards 3.6, 4.0 and 4.1.

the library is designed to work with all monome grids but has only been tested on a varibright 128 grid. to date it hasn't been confirmed to work with other grids but there's no reason it shouldn't work. there is also experimental support for arc but it's untested since i'll probably never have an arc.

see monome-teensy.ino for examples

functionality: grid

grid functions available in the library are:

setOverallInt();  // set overall intensity of grid
setLed();         // set individual led on or off
setLedInt();      // set intensity of individual led
setAll();         // set all leds on or off
setAllInt();      // set intensity of all leds
setRow();         // set an 8x1 row on or off
setLevelRow();    // set intensity of an 8x1 row
setCol();         // set a 1x8 col on or off
setLevelCol();    // set intensity of 1x8 col
setMap();         // set individual leds in 8x8 grid on or off
setLevelMap();    // set level of individual leds in 8x8 grid

arrays to store the status of grid keys:

keyPressed[256];  // true if key is being held down

available callbacks

void (*keyDownCallback)(byte k);
void (*keyUpCallback)(byte k);

led-grid example

let's create a sketch that by sets the intensity of all leds in a grid to zero then gradually increases and decreases the intensity

first, create the Monome object

#include "Monome.h"

Monome m;

add the setup() function of your Monome object to your sketch's setup()

void setup()
{
  m.setup();
}

add the loop() function of your Monome object to your sketch's loop()

void loop()
{
  m.loop();
}

update your loop code to make all grid leds pulse

void loop()
{
  m.loop();

  m.setAllInt(0); 
  for (int i=0; i<16; i++) {
    m.setAllInt(i);
    delay(40);
  }
  for (int i=15; i>=0; i--) {
   m.setAllInt(i);
   delay(40);
  }
  delay(1000);
}

key-grid example

this example will light up a key when pressed and send serial messages on key up or down

#include "Monome.h"

Monome m;

void setup()
{
  m.setup();
  m.keyDownCallback = &kDown;
  m.keyUpCallback = &kUp;
}

void loop()
{
  m.loop();

  for (int i=0; i<256; i++) {
    byte x = m.keyToCoords(i).x;
    byte y = m.keyToCoords(i).y;
    
    if (m.keyPressed[i] == 1){
      m.setLedInt(x,y,15);
    } else {;
      m.setLedInt(x,y,0);
    }
  }
}

void kDown(byte k) {
  Serial.print("Key Down: ");
  Serial.println(k);
}

void kUp(byte k) {
  Serial.print("Key Up: ");
  Serial.println(k);
}

arc support

arc support is experimental since i don't have an arc to test this with

arc functions:

setRingLed();   // sets individual led
setRingAll();   // sets all leds
setRingMap();   // sets individual values for all leds
setRingRange(); // sets individual values for a range of leds

arrays to store the status of the encoders and their respective switches:

switchPressed[4]; // true if switch is being held down  
encCumulative[4]; // cumulative tally of encoder deltas since initialization

available callbacks

void (*encChangeCallback)(byte e, int d);
void (*switchDownCallback)(byte e);
void (*switchUpCallback)(byte e);

to do:

• use proper directory structure for a teensy lib
• sys commands
• support multiple devices at once
• tilt support