Firmware-830 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. The following methods can be selected 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 match: 8 bytes (at most 8 Unique ID bytes followed by zeros), sent as nibbles in 16 bytes (MSB .. LSB), if an RFID tag is detected; if matched with the stored RFID tag data, associated method number (1 byte) or else zero, sent as nibbles in 2 bytes, if an RFID tag is detected | Unique ID match [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 | Unique ID, 8 bytes, sent as nibbles in 16 bytes (MSB .. LSB), if an RFID tag is present, of the detected RFID tag or else of the stored RFID tag; current method number (FP), if an RFID tag is present, or else the stored method number associated with the stored RFID tag, sent as nibbles in 2 bytes | 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 | No output; The stored Unique ID and its associated method number (FP) are set to zero |
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 ReachID 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 {port}, 36 {device address}, 80 {REACHID function}, 64 {Unique ID sum method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 24h, 50h, 40h, F7h)
In order to then match this RFID card each time it is detected by the sensor, the following message is sent:
- 240, 125, 0 {DEV}, 8 {FUNCTION}, 6 {port}, 36 {device address}, 80 {REACHID function}, 0 {Unique ID match 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.
Then, whenever an RFID card is detected the configured MIDI message will be output with value 64 if it matches the stored RFID card data, else value 0.
In order to enable the REACHID function in host mode to output the Unique ID of an RFID card that's placed on a ReachID 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 {port}, 36 {device address}, 80 {REACHID function}, 1 {Unique ID method}, 247 (F0h, 7Dh, 00h, 08h, 06h, 24h, 50h, 00h, F7h)
In order to then know if an RFID card detected by the sensor matches the stored RFID card data, the following message is sent:
- 240, 125, 0 {DEV}, 8 {FUNCTION}, 6 {port}, 36 {device address}, 80 {REACHID function}, 0 {Unique ID match 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.
Then, whenever an RFID card is detected the RFID card's Unique ID bytes will be output followed by value 1 if it matches the stored RFID card data, else value 0.
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 webpage.
