Firmware-75 Function-080
REACHID (80, 50h)
The ReachID function enables output of the ReachID 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:
ReachID v1.0
| FP | Data output in host mode | Data output in stand-alone mode |
|---|---|---|
| 0 | 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) | 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) |
| 1..126 | 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) | 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 |
| 127 | No output; The stored Unique ID and its associated method number (FP) are set to zero | 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 |
Example:
In order to enable the ReachID function in standalone mode to output the Unique ID sum of an RFID card that's placed on a HotSpot2D sensor with I2C device address 36 (default ReachID 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 {ReachID function}, 64 {Unique ID sum method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 24h, 50h, 40h, 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 ReachID function in host mode to output the Unique ID of an RFID card that's placed on a HotSpot2D sensor with I2C device address 36 (default ReachID 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 {ReachID function}, 0 {Unique ID method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 24h, 50h, 00h, F7h)
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 ReachID v1.0 webpage.
