Firmware-811 Function-114
REACHOND (114, 72h)
The ReachOnD function enables output of the ReachOnD sensor data in both host and stand-alone mode. In host mode the sensor data is output in I2C DATA messages. In stand-alone mode the sensor data is output according to the stand-alone mode settings of the input number that equals the I2C port number. There are the following methods to select, using the FUNCTION command’s method/parameter FP:
ReachOnD v1.0
| FP | Data output in host mode | Data output in stand-alone mode |
|---|---|---|
| 0, 13..126 | Capacitance [0..1] of each input; 12 unsigned 8-bit values, each representing [high..low], sent as 12 bytes | Capacitance [0..127] or [0..16383] of each input; 12 unsigned 7-bit or 14-bit values, each representing [high..low], sent as 12 times one or two bytes (LSB, MSB) |
| 1..12 | Capacitance [0..1] of the input specified by FP; an unsigned 8-bit value, representing [high..low], sent as one byte | Capacitance [0..127] or [0..16383] of the input specified by FP; an unsigned 7-bit or 14-bit value, representing [high..low], sent as one or two bytes (LSB, MSB) |
| 127 | Capacitance [0..4095] of each input summed; a 16-bit value, with each of the bits 1 to 12 representing [high..low] of the 12 inputs, sent as nibbles in four bytes (MSB .. LSB) | Capacitance [0..127] or [0..16383] of each input summed; an unsigned 7-bit, with each of the bits representing [high..low] of the first 7 inputs, or an unsigned 14-bit value, with each of the bits 3 to 14 representing [high..low] of the 12 inputs, sent as one or two bytes (LSB, MSB) |
Example:
In order to enable the ReachOnD function in standalone mode to output the capacitance of each input of the ReachOnD sensor with I2C device address 90 (default ReachOnD I2C device address) connected to the 7th I2C port, the following message is sent:
- 240, 125, 0 {DEV}, 8 {FUNCTION}, 6 {yyy = 6}, 90 {device address}, 114 {ReachOnD function}, 0 {capacitance of each input method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 5Ah, 72h, 00h, F7h)
In stand-alone mode a suitable configuration has to be set using the EDIT CONFIG command before any MIDI messages will be output.
In order to enable the ReachOnD function in host mode to output the summed capacitance of all inputs of the ReachOnD sensor with I2C device address 90 (default ReachOnD I2C device address) connected to the 7th I2C port, the following message is sent:
- 240, 125, 0 {DEV}, 8 {FUNCTION}, 6 {yyy = 6}, 90 {device address}, 114 {ReachOnD function}, 127 {summed capacitance method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 5Ah, 72h, 7Fh, F7h)
In host mode raw sensor data will be output immediately in I2C DATA messages.
Other settings of the ReachOnD sensor can be effectuated by using I2C commands such as I2C WRITE and I2C READ. See also the datasheet linked from the ReachOnD webpage.
