http://wiki.monome.org more information at http://monome.org http://wiki.monome.org/attachment/logo.png http://wiki.monome.org http://wiki.monome.org/view/40hOscProtocol (mentions of serialio are interchangeable with monomeserial)<br /><br />h2. button, led, adc addressing<br /><br />all buttons, leds, and adcs are addressed starting at 0 rather than 1. rows will be mapped to the integers 0 – 7 rather than 1 – 8. Likewise, adcs will be mapped to the integers 0 – 3 rather than 1 – 4.<br /><br />h2. output (messages sent by 40h)<br /><br />h3. button press event <br /><br />serialio sends an osc packet containing this message to the broadcast address when a button is depressed or released.<br /><br /> address pattern: /box/press<br /> parameters: <br /> x – int, button x coordinate<br /> y – int, button y coordinate<br /> state – int [0 | 1] button state<br /><br />examples:<br /><br /> button down event - /box/press 3 4 1<br /> button up event - /box/press 3 4 0<br /><br />h3. adc value change event <br /><br />serialio sends an osc packet containing this message when the value read by an enabled adc differs from the previous value.<br /><br /> address pattern: /box/adc<br /> parameters: adc – int [0 - 3]<br /> value – float [0.0 – 1.0]<br /><br />examples: <br /><br /> current adc state - /box/adc 0 .54321<br /><br />h2. input (messages understood by serialio)<br /><br />h3. set single led state <br /><br />sending an osc packet containing this message to the port on which serialio is listening sets the state (on or off) of the led beneath the specified button.<br /><br /> address pattern: /box/led<br /> parameters: x – int, button x coordinate<br /> y – int, button y coordinate<br /> state – int [0 | 1], led state<br /><br />examples: <br /><br /> led on - /box/led 0 4 1<br /> led off - /box/led 0 4 0<br /><br />h3. set state of entire row of leds <br /><br />sending an osc packet containing this message to the port on which serialio is listening sets the state (on or off) of all leds in the specified row. the state is specified as an 8-bit map where a set bit represents an led which should be turned on and a cleared bit represents an led which should be turned off.<br /><br /> address pattern: /box/led_row<br /> parameters: row – int, row number<br /> state: int [0 – 255], state of leds as 8-bit bitmap<br /><br />examples: <br /><br /> turn on all leds in first row - /box/led_row 0 255<br /> turn off all leds in first row - /box/led_row 0 0<br /><br />h3. set state of entire column of leds <br /><br />sending an osc packet containing this message to the port on which serialio is listening sets the state (on or off) of all leds in the specified column. the state is specified as an 8-bit map where a set bit represents an led whichshould be turned on and a cleared bit represents an led which should beturned off.<br /><br /> address pattern: /box/led_col<br /> parameters: col – int, column number<br /><br />examples: <br /><br /> turn on all leds in second column - /box/led_col 1 255<br /> turn off all leds in second column - /box/led_col 1 0<br /><br />h3. set led intensity <br /><br />sending an osc packet containing this message to the port on which serialio is listening sets the brightness of the leds.<br /><br /> address pattern: /box/intensity<br /> parameters: intensity, float [0.0 – 1.0]<br /><br />examples: <br /><br /> set the intensity of the 40h to 50% - /box/intensity 0.5<br /><br />h3. test leds (turns on all leds) <br /><br />sending an osc packet containing this message to the port on which serialio is listening sets 40h in a test state where all leds are turned on or returns 40h to normal operation.<br /><br /> address pattern: /box/test<br /> parameters: state, int [0 | 1]<br /><br />examples: <br /><br /> turn led test on - /box/test 1<br /> turn led test off - /box/test 0<br /><br />h3. enable adc <br /><br />sending an osc packet containing this message to the port on which serialio is listening enables or disables the specified adc causing serialio to begin to stop reporting adc value change messages.<br /><br /> address pattern: /box/adc_enable<br /> parameters: adc, int [0 – 4]<br /> enabled, int [0 | 1]<br /><br />examples: <br /><br /> enable adc 0 - /box/adc_enable 0 1<br /> disable adc 0 - /box/adc_enable 0 0<br /><br />h3. set box in lower power mode <br /><br />sending an osc packet containing this message to the port on which serialio is listening sets 40h in a lowpower shutdown state or returns 40h to normal operation.<br /><br /> address pattern: /box/shutdown<br /> parameters: state [1 | 0], enable/disable lower power mode<br /><br />examples:<br /><br /> turn on lower power mode - /box/shutdown 1<br /> turn off lower power mode - /box/shutdown 0<br /><br /><br />h2. encoder messages<br /><br />send to serialio:<br /><br /> enable encoder 0 - /box/enc_enable 0 1<br /> disable encoder 0 - /box/enc_enable 0 0<br /><br />received from serialio:<br /><br /> encoder 0 position change: /box/enc 0 -20<br /><br />encoder positions are relative from frame to frame. counter-clockwise gives positive steps (positive degrees) while clockwise gives negative steps.<br /> <br />&#8230;<br /> tehn Tue, 26 Jun 2007 19:28:56 +0000 Search monome wiki's text regex http://wiki.monome.org/find/Searchpage