Reader Connection for Tag Read Data

Currently,

Resonate

only supports a single data output connection from the reader; this is a websocket server connection. The websocket is based off the

secure

setting of the reader; this determines if the websocket uses TLS. Consult your Zebra sales representative for the roadmap of other endpoint types (for example, webhooks and MQTT).

Resonate

provides its own data contract definitions, separate from Zebra IoT Connector (ZIoTC). This allows

Resonate

to offer data output formats that emulate ZIoTC, as well as new data formats optimized for other solutions. For the current version of

Resonate

, the WebSocket connection provides an emulation of the standard ZIoTC Tag Data Events format. For details and documentation, refer to https://zebradevs.github.io/rfid-ziotc-docs/schemas/tag_data_events/index.html.

Since

Resonate

does not use ZIoTC and instead is controlled by an on-reader Agent app, connecting to the reader's tag read data output stream requires the use of a different WebSocket endpoint address from the address in the ZIoTC documentation. To connect to the reader to get its output, your application should connect to

ws://<reader FQDN>/resonate

(if using a secure websocket, it should use

wss:

). Otherwise, the data that you receive will match the format and content defined in the ZIoTC documentation.

To test, use any standard WebSocket client application to connect to the reader via WebSocket and receive tag read data. One example is a simple extension to the Google Chrome browser¹: https://chromewebstore.google.com/detail/websocket-test-client/fgponpodhbmadfljofbimhhlengambbn. If you prefer to write your own Websocket client test application, a code example in Python is available in the ZIoTC documentation (https://zebradevs.github.io/rfid-ziotc-docs/other_cloud_support/Web%20Sockets/testing.html). To test, setup a reader in

Resonate

, configure it with a mode from Resonate, and connect to the reader with

ws://<reader FQDN>/resonate

(if using a secure websocket, use

wss:

).