osc protocol

default prefix is assumed.

from monomeserial

/40h/press [x] [y] [state]
state: 1 (down) or 0 (up)

example:

/40h/press 0 2 1

received button down at (0,2)

/40h/led [x] [y] [state]
state: 1 (on) or 0 (off)

example:

/40h/led 0 5 1

led on at (0,5)

/40h/led_col [col] [data]
col: which column to update
data: one byte of data (8 led positions)

example:

/40h/led_col 2 255

turn on all values in row 2. this is true because 255 (decimal) is 0b11111111 (binary).

/40h/led_col [col] [data0] [data1] [data2] ...

sets more than one byte of a column, referenced from the beginning of the column. variable byte count allowed, for spanning multiple units.

example: /40h/led_col 4 0 0 0 0

clear col 4, rows 0-31. note that this would require four devices to be physically reflected.

all messages similar for led_row.

/40h/frame [A B C D E F G H]

updates an entire 8×8 display in a single session. functionally identical to:

/40h/led_col 0 A
/40h/led_col 1 B
/40h/led_col 2 C
/40h/led_col 3 D
/40h/led_col 4 E
/40h/led_col 5 F
/40h/led_col 6 G
/40h/led_col 7 H

/40h/frame [A B C D E F G H] [x] [y]
update a display, offset by x and y.

/40h/clear [state]
state: 0 (off, default if unspecified) or 1 (on)

/sys/prefix [string]
change all prefixes to [string]

/sys/prefix 0 [string]
changes prefix for unit 0 to [string]

when prefix changes successfully (valid pattern), change is reported by sending out a report message:

/sys/prefix 0 [newprefix]
/sys/prefix 1 [newprefix]

/sys/cable [left|up|right|down]
changes cable setting for all units

/sys/cable 0 [...]
changes cable setting for unit 0

/sys/offset x y
changes offset value for all units

/sysoffset 0 x y
changes offset values for unit 0

/sys/intensity 0.
changes all units

/sys/intensity 0 0.
changes unit 0

/sys/test [0|1]
toggles test mode for all units (turn on/off all leds)

/sys/test 0 [0|1]
toggles test mode for unit 0

/sys/report
returns current configuration

this message requests information to be sent from monomeserial.

example of messages received after sending /sys/report:

/sys/prefix 0 40h
/sys/prefix 1 40h
/sys/cable 0 up
/sys/cable 1 up
/sys/offset 0 0 0
/sys/offset 1 8 0

individual reports available (?):

/sys/prefix
/sys/cable
/sys/offset