Smart Reader Operation Protocol and API Events Tag
April 13, 2023 at 2:39 AMSmart Reader Tag Events
Context
One of these Events is sent when the Smart Reader has read a Tag, or has detected that the tag has been removed from its field (if the Reader is configured accordingly).
Event codes and data
| EVT | Description | Data |
|---|---|---|
B0 |
Tag read | TagInfo, TagId, TagData, TagDetails |
B1 |
Tag inserted | TagIndex, TagInfo, TagId, TagData, TagDetails |
B1 |
Tag removed | TagIndex |
Difference between Tag read and Tag inserted/removed
Whether the Tag read event is sent alone, or the Tag inserted/Tag removed events are sent in pair, depends on the configuration of the Smart Reader. See Smart Reader features.
If the device is configured to send the Tag read event
- The Tag read event (
B0) is fired when a new Tag is read, with the field New in the TagInfo value set to1(true). - No event is fired when the Tag is removed from the Reader.
- In case the Tag stays on the Reader, the Reader fires the Tag read event (
B0) again after a few seconds. In this case, the field New is cleared to0(false). The interval is specified in the Smart Reader timings.
If the device is configured to send the Tag inserted/removed events
- The Tag inserted event (
B1) is fired when a new Tag is read. The host application knows that this is a Tag inserted event because the TagInfo and TagId data are present. - No event is fired while the Tag stays on the Reader.
- When the Tag is removed from the Reader, the Reader fires the Tag removed event (
B1). The host application may use the TagIndex entry to know which of the previously inserted Tags has been removed.