Difference between revisions of "Firmware-811 Function-114"

From I-CubeX Wiki
Jump to: navigation, search
(Created page with "==REACHOND (80, 50h)== 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 Firmwar...")
 
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
==REACHOND (80, 50h)==
+
==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 [[Firmware-810_Message-010 |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:
+
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 [[Firmware-811_Message-010 |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:
  
 
<u>ReachOnD v1.0</u>
 
<u>ReachOnD v1.0</u>
Line 11: Line 11:
 
|-
 
|-
 
|0, 13..126
 
|0, 13..126
|Unique ID: at most 8 bytes (depending on the number of bytes of the Unique ID), sent as nibbles in at most 16 bytes (MSB .. LSB)
+
|Capacitance [0..1] of each input; 12 unsigned 8-bit values, each representing [high..low], sent as 12 bytes
|Stored Unique ID detected [0..127] or [0..16383]; an unsigned 7-bit or 14-bit value equal to the method number (FP) entered before the card was placed on the sensor (during which action its Unique ID was stored in the digitizer), sent as one or two bytes (LSB, MSB)
+
|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..126
+
|1..12
|Stored data: Unique ID, 8 bytes, sent as nibbles in 16 bytes (MSB .. LSB); method number (FP), sent as nibbles in 2 bytes (MSB, LSB)
+
|Capacitance [0..1] of the input specified by FP; an unsigned 8-bit value, representing [high..low], sent as one byte
|Unique ID sum [0..127] or [0..16383]; an unsigned 7-bit or 14-bit value calculated from the Unique ID as the bit-shifted sum of each of its bytes (ie. for i = 0..7: sum = sum + UID[i] << i) sent as one or two bytes (LSB, MSB); the method number (FP) is stored together with the Unique ID in the digitizer
+
|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
 
|127
|No output; The stored Unique ID and its associated method number (FP) are set to zero
+
|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)
|Unique ID sum [0..127] or [0..16383]; an unsigned 7-bit or 14-bit value calculated from the Unique ID as the bit-shifted sum of each of its bytes (ie. for i = 0..7: sum = sum + UID[i] << i) sent as one or two bytes (LSB, MSB); the method number (FP) is stored together with the Unique ID in the digitizer
+
|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:
 
Example:
  
In order to enable the ReachOnD function in standalone mode to output   ReachOnD sensor with I2C device address 36 (default ReachOnD I2C device address) connected to the 7th I2C port, the following message is sent:
+
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}, 36 {device address}, 80 {ReachOnD function}, 64 { method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 24h, 50h, 40h, F7h)
+
: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 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   ReachOnD sensor with I2C device address 36 (default ReachOnD I2C device address) connected to the 7th I2C port, the following message is sent:
+
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}, 36 {device address}, 80 {ReachOnD function}, 0 { method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 24h, 50h, 00h, F7h)
+
: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.
 
In host mode raw sensor data will be output immediately in I2C DATA messages.
  
Other settings of the ReachID sensor can be effectuated by using I2C commands such as I2C WRITE and I2C READ. See also the datasheet linked from the [[ReachOnD-10 | ReachOnD v1.0]] webpage.
+
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 [http://icubex.com/reachond ReachOnD] webpage.

Latest revision as of 13:00, 27 July 2020

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.