Cloud Connect for RFID - Zebra Technologies

Cloud Connect for RFID

MN-004035-01EN Rev. A

Deployment Guide

2

ZEBRA and the stylized Zebra head are trademarks of Zebra Technologies Corporation, registered in many jurisdictions worldwide. All other trademarks are the property of their respective owners. © 2020 Zebra Technologies Corporation and/or its affiliates. All rights reserved.

Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement or nondisclosure agreement. The software may be used or copied only in accordance with the terms of those agreements.

For further information regarding legal and proprietary statements, please go to:

SOFTWARE: www.zebra.com/linkoslegalCOPYRIGHTS: www.zebra.com/copyrightWARRANTY: www.zebra.com/warrantyEND USER LICENSE AGREEMENT: www.zebra.com/eula

Terms of Use

Proprietary StatementThis manual contains proprietary information of Zebra Technologies Corporation and its subsidiaries (“Zebra Technologies”). It is intended solely for the information and use of parties operating and maintaining the equipment described herein. Such proprietary information may not be used, reproduced, or disclosed to any other parties for any other purpose without the express, written permission of Zebra Technologies.

Product ImprovementsContinuous improvement of products is a policy of Zebra Technologies. All specifications and designs are subject to change without notice.

Liability DisclaimerZebra Technologies takes steps to ensure that its published Engineering specifications and manuals are correct; however, errors do occur. Zebra Technologies reserves the right to correct any such errors and disclaims liability resulting therefrom.

Limitation of LiabilityIn no event shall Zebra Technologies or anyone else involved in the creation, production, or delivery of the accompanying product (including hardware and software) be liable for any damages whatsoever (including, without limitation, consequential damages including loss of business profits, business interruption, or loss of business information) arising out of the use of, the results of use of, or inability to use such product, even if Zebra Technologies has been advised of the possibility of such damages. Some jurisdictions do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you.

Publication DateSeptember 22, 2020

http://www.zebra.com/linkoslegal

http://www.zebra.com/copyright

http://www.zebra.com/warranty

http://www.zebra.com/eula

Contents

List of Figures..................................................................................................................................... 5

About This Document ........................................................................................................................ 6Introduction ...................................................................................................................... 6Supported Readers .......................................................................................................... 6Chapter Descriptions........................................................................................................ 6Notational Conventions .................................................................................................... 6Icon Conventions ............................................................................................................. 7Related Documents and Software ................................................................................... 7Service Information .......................................................................................................... 7

Overview.............................................................................................................................................. 9Introduction ...................................................................................................................... 9System Overview ............................................................................................................. 9

Cloud Service ......................................................................................................... 10Cloud Agent............................................................................................................ 10Reader Manager..................................................................................................... 10Radio Control.......................................................................................................... 10

Deployment Modes........................................................................................................................... 11Introduction .................................................................................................................... 11Pure Cloud Deployment ................................................................................................. 11Hybrid Deployment......................................................................................................... 12Local Deployment .......................................................................................................... 12

Operation Modes .............................................................................................................................. 14Introduction .................................................................................................................... 14Simple ............................................................................................................................ 14Inventory ........................................................................................................................ 14

3

Contents

Portal.............................................................................................................................. 15Conveyer........................................................................................................................ 15

Setting Up Cloud Connect for RFID................................................................................................ 16Introduction .................................................................................................................... 16Enrolling the Reader ...................................................................................................... 16Disenrolling the Reader.................................................................................................. 17Configuring Deployment Modes..................................................................................... 18Exporting/Importing Cloud Configuration ....................................................................... 18

Login....................................................................................................................... 18Exporting the Cloud Configuration.......................................................................... 19Importing Cloud Configuration................................................................................ 20

Cloud Connect for RFID Configuration .......................................................................... 21Control Section ....................................................................................................... 21

Local Access via REST.................................................................................... 22Zebra Data Services ........................................................................................ 22

Data Section ........................................................................................................... 23Zebra Data Services ........................................................................................ 24Local HTTP/HTTPS Post Server...................................................................... 25

Management Section.............................................................................................. 26Local REST...................................................................................................... 27Zebra Data Services ........................................................................................ 28

Appendix ........................................................................................................................................... 29Default Cloud Connect for RFID Configuration .............................................................. 29Sample Configuration for Local Deployment.................................................................. 32

4

List of Figures

Figure 1: Cloud Connect for RFID System Overview .................................................... 10Figure 2: Pure Cloud Deployment ................................................................................. 11Figure 3: Hybrid Deployment With On Premise Data Interface ..................................... 12Figure 4: Local Deployment With On Premise Data, Control

and Management Interfaces ........................................................................... 13Figure 5: Reader Pre-enrolled in Cloud Agent Service ................................................. 17Figure 6: Reader Enrolled in Cloud Agent Service ....................................................... 17Figure 7: JSON Schema for Control Interface Configuration ........................................ 21Figure 8: JSON Schema for Data Interface Configuration ............................................ 23Figure 9: JSON Schema for Management Interface Configuration ............................... 27

5

About This Document

IntroductionThis guide provides information about the Cloud Connect for RFID feature in the FX Series readers. It explains the system’s overall architecture, deployment modes, and configuration of different deployment modes.

IMPORTANT: If you have a problem with your equipment, contact Zebra Global Customer Support for your region. Contact information is available at: zebra.com/support.

Supported Readers• FX7500

• FX9600

Chapter DescriptionsTopics covered in this guide are as follows:

• Overview provides a summary on Cloud Connect™ for RFID, the cloud-based management, control, and RFID tag data collection for the FX Series RFID readers.

• Deployment Modes provides information on the three different modes of deployment.

• Operation Modes provides information on configuring the radio to different modes of operation.

• Setting Up Cloud Connect for RFID provides information on setting up Cloud Connect for RFID.

• Appendix provides the default Cloud Connect for RFID configuration.

Notational ConventionsThe following conventions are used in this document:

• Bold text is used to highlight the following:

• Dialog box, window and screen names

• Drop-down list and list box names

• Check box and radio button names

• Icons on a screen

6

zebra.com/support

About This Document

• Key names on a keypad

• Button names on a screen.

• Bullets (•) indicate:

• Action items

• Lists of alternatives

• Lists of required steps that are not necessarily sequential.

• Sequential lists (such as those that describe step-by-step procedures) appear as numbered lists.

Icon ConventionsThe documentation set is designed to give the reader more visual clues. The following graphic icons are used throughout the documentation set. These icons and their associated meanings are described below.

NOTE: The text here indicates information that is supplemental for the user to know and that is not required to complete a task.

IMPORTANT: The text here indicates information that is important for the user to know.

CAUTION: If the precaution is not heeded, the user could receive minor or moderate injury.

WARNING: If danger is not avoided, the user CAN be seriously injured or killed.

Related Documents and SoftwareThe following documents provide more information about the readers.

• FX7500 RFID Reader Quick Start Guide

• FX9600 RFID Reader Quick Reference Guide

• FX Series RFID Fixed Reader Integration Reference Guide

• To download firmware, go to https://www.zebra.com/apps/dlmanager?dlp=-227178c9720c025483893483886ea540bd07dd0f9873752cf891686eb495040ba85f97bf163f9fd12080ee1978f57c98463270ae549b1b5c65e6acbef65100a1978a205f64aae7c7ef1d957c10a43f885d113b42e079e0119302a877e3ec811eb70ea4125c716c46b3a332b59ddd9f8&c=us&l=en.

For the latest version of this guide and all guides, go to zebra.com/support.

Service InformationIf you have a problem with your equipment, contact Zebra Global Customer Support for your region. Contact information is available at: zebra.com/support.

When contacting support, please have the following information available:

• Serial number of the unit

• Model number or product name

7

https://www.zebra.com/apps/dlmanager?dlp=-227178c9720c025483893483886ea540bd07dd0f9873752cf891686eb495040ba85f97bf163f9fd12080ee1978f57c98463270ae549b1b5c65e6acbef65100a1978a205f64aae7c7ef1d957c10a43f885d113b42e079e0119302a877e3ec811eb70ea4125c716c46b3a332b59ddd9f8&c=us&l=en

https://www.zebra.com/apps/dlmanager?dlp=-227178c9720c025483893483886ea540bd07dd0f9873752cf891686eb495040ba85f97bf163f9fd12080ee1978f57c98463270ae549b1b5c65e6acbef65100a1978a205f64aae7c7ef1d957c10a43f885d113b42e079e0119302a877e3ec811eb70ea4125c716c46b3a332b59ddd9f8&c=us&l=en

zebra.com/support

zebra.com/support

About This Document

• Software/firmware type or version number

Zebra responds to calls by email, telephone or fax within the time limits set forth in support agreements.

If your problem cannot be solved by Zebra Customer Support, you may need to return your equipment for servicing and will be given specific directions. Zebra is not responsible for any damages incurred during shipment if the approved shipping container is not used. Shipping the units improperly can possibly void the warranty.

If you purchased your Zebra business product from a Zebra business partner, contact that business partner for support.

8

Overview

IntroductionCloud Connect for RFID provides cloud-based management, control, and RFID tag data collection for the FX Series RFID readers (FX7500, FX9600). The Cloud Connect for RFID feature enables connectivity to the cloud platform to provide loT capabilities to the reader. Once connected to the cloud, the readers can be managed and controlled using a REST API interface via the cloud. The reader tag data is also pushed to the cloud to be consumed by the cloud service.

The Cloud Connect for RFID feature provides the three interfaces as listed below.

• Management interface: Used to perform management actions on the reader (for example, firmware upgrade, getting reader configuration, and setting reader configuration).

• Control interface: Used to perform control actions on the reader (for example, configuring the radio mode, starting/stopping the tag reads).

• Data interface: Used to consume the RFID tag data from the reader.

These interfaces can be configured independently to allow for access via cloud or locally within the private network. Depending on how the Cloud Connect for RFID interfaces are configured, there are three possible deployment modes as described in the chapter Deployment Modes.

System OverviewAs illustrated in Figure 1, the Cloud Connect for RFID system has the following components.

• Cloud Service

• Cloud Agent

• Radio Control

9

Overview

Figure 1 Cloud Connect for RFID System Overview

NOTE: The solid lines represent the Management interfaces, the dotted black lines represent the Control interface and the dotted red lines represent the Data interface.

Cloud ServiceThe Cloud Connect for RFID feature enables the Cloud connectivity to a Cloud service and currently the only cloud service that is supported is Zebra Data Services (Savanna Cloud). Zebra Data Services is Zebra's proprietary cloud platform that empowers the user to build secure, scalable digital services with ease and speed. This solution aggregates and analyzes data from multiple edge devices and services, creating data-powered environments to provide real-time guidance and insights. For more information on Zebra Data Services go to: https://developer.zebra.com/community/tools/eaidata.

The Cloud Service exposes a REST API interface that can be used to manage, configure, and read tag data from RFID readers.

Cloud AgentThe Cloud Agent is the reader-resident component responsible for connecting to the cloud service and performing the actions that are requested by the REST APIs. The Cloud Agent also collects the tag data from the radio control and pushes them out on the Data interface.

Reader ManagerReader Manager is the process in the reader that is responsible for performing all reader configuration and management operations. The Radio Control talks to the reader manager via a socket interface using the RM XML commands.

Radio ControlRadio Control configures, controls, and maintains a connection to the RFID radio. Radio control receives the tag read events from the radio and sends them to the Cloud Agent which in turn passes it onto the Data interface.

10

https://developer.zebra.com/community/tools/eaidata

Deployment Modes

IntroductionCloud Connect for RFID can be setup in three different modes of deployment.

• Pure Cloud deployment

• Hybrid deployment

• Local deployment

All of these deployment modes require that the reader be enrolled with the Zebra Data Services. For more information on the enrollment go to https://developer.zebra.com/docs/enrolling-fx-reader.

Pure Cloud DeploymentIn a Pure Cloud deployment, the Management, Control, and Data interfaces of the Cloud Connect for RFID feature are all configured to connect to the cloud services platform. The APIs provided by the Zebra Data Services can be used to manage/control the reader and get the tag data. Figure 2 illustrates a Pure Cloud deployment and the flow of different interfaces.

NOTE: The solid lines in Figure 2 represent the Management interfaces, the dotted black lines represent the Control interface and the dotted red lines represent the Data interface.

Figure 2 Pure Cloud Deployment

11

https://developer.zebra.com/docs/enrolling-fx-reader

Deployment Modes

Hybrid DeploymentIn a Hybrid deployment, the Control, Management, and Data interfaces can be configured to connect to different endpoints. For example, the Control and Management interfaces can be connected to the cloud services platform and the Data interface can be configured to connect to a local HTTP/HTTPS server. This scenario is illustrated in Figure 3. When the Data interface is configured to connect to the local HTTP/HTTPS server, the reader will send tag data information to the HTTP/HTTPS server as POST requests.

NOTE: The solid lines in Figure 3 represent the Management interfaces, the dotted black lines represent the Control interface and the dotted red lines represent the Data interface. The Control and management functionalities can be exercised through the ZDS REST APIs.

Figure 3 Hybrid Deployment With On Premise Data Interface

Local DeploymentIn a local deployment, the reader is setup to have all the interfaces (Management, Control and Data) exposed locally so that once enrolled, the reader does not have to be connected to the Internet. When setup this way the Control and Management interfaces are exposed as REST APIs on the reader that can be directly accessed as shown in the figure below. The data is sent as HTTP/HTTPS POST request to the specified server. This is illustrated in Figure 4.

NOTE: The solid lines in Figure 4 represent the Management interfaces, the dotted black lines represent the Control interface and the dotted red lines represent the Data interface. The Control and Management functionalities can be exercised through the local REST APIs.

12

Deployment Modes

Figure 4 Local Deployment With On Premise Data, Control and Management Interfaces

13

Operation Modes

IntroductionCloud Connect for RFID provides the ability to configure the radio to different modes of operation that optimize the radio configuration based on intended use case. Once configured, the mode can be started using the START REST API and will continue to operate until the STOP REST API is called. The following modes are supported in Cloud Connect for RFID.

• Simple

• Inventory

• Portal

• Conveyer

SimpleSimple mode configures the radio to read and report all unique tags in the field of view of the radio.

By default:

• The radio attempts to read tags on all antennas. This can be adjusted using the Antennas object when setting the mode.

• The radio reports all unique tags. This can be adjusted using the Filter object when setting the mode.

InventoryInventory mode configures the radio to read tags and report all unique tags for each antenna on a periodic interval. Additional meta-data (i.e., peak RSSI and number of reads for each antenna during the interval) is reported.

By default:


• The radio reports all unique tags once. This can be adjusted using the Filter object when setting the mode.

• The radio reports tags every second. This can be adjusted using the Interval object when setting the mode.

14

Operation Modes

PortalPortal mode configures the radio to report all unique tags that pass by each antenna immediately following a GPI event. The GPI event signals the beginning of the read period. As soon as the GPI event triggers the radio, the radio continues to read tags until no new unique tags are read for a configurable stop interval. Once the radio stops reading tags, it waits for the next GPI event to start the process again.

By default:



• The radio waits for a LOW signal on GPI 1. This can be adjusted using the StartTrigger object when setting the mode.

• The radio continues to read until no new unique tags have been read for 3 seconds. This can be adjusted using the StopInterval object when setting the mode.

ConveyerConveyer mode configures the radio to read tags and report all unique tags for each antenna.

By default:



15

Setting Up Cloud Connect for RFID

IntroductionSetting up Cloud Connect for RFID is a two-step process.

1. Enroll the reader.

2. Configure the interfaces.

Enrolling the ReaderEnrollment is the first step whereby the reader is registered as an IoT device with the cloud service provider. After enrollment, the reader is connected to cloud application by an IoT agent service on the reader that enables control, management, and data channels for cloud app to communicate with the reader.

Currently the reader is configured out of the box to enroll with the Zebra Data Services. To enroll the reader to Zebra Data Services, follow the steps below.

1. Register and generate the Claim Code from the Zebra Data Services platform. Go to https://developer.zebra.com/docs/enroll-fx-reader for more information on how to generate the claim token.

2. Open a web browser to connect to the FX reader using the host name or IP address.

3. Click Communication > Cloud.

4. The following parameters are required to enroll the reader. Values for these parameters are obtained after creating and registering your Cloud application and need to be keyed into this page.

a. Claim Code - Secret code for enrolling the device (step 1).

b. Auto Connect - Automatically connect to service once reader is enrolled.

5. Enroll. Click enroll to Enroll the reader to Cloud with Claim Code entered.

After enrolling the reader, the Enrollment Status indicates the reader's current state of Cloud enrollment. The Connection status indicates the status of communication channel from Cloud IoT agent on the reader to cloud service.

Once enrolled, if reader's Cloud Agent service is disconnected, click Connect to establish a connection. An existing connection may be terminated by clicking Disconnect.

Note: Connection will be terminated if reader is not enrolled.

NOTE: The connection is terminated if the reader is not enrolled.

16

https://developer.zebra.com/docs/enroll-fx-reader


Figure 5 Reader Pre-enrolled in Cloud Agent Service

Figure 6 Reader Enrolled in Cloud Agent Service

Disenrolling the ReaderTo disenroll the reader from the Cloud:

1. From the Reader Communication Parameters screen, click Disenroll. The command is sent to the reader and the device is un-enrolled from the Cloud.

2. To delete the device from the Zebra Data Services, see developer.zebra.com/devices/reader.

3. Click Delete on the line next to your reader on the My Devices page.

17

developer.zebra.com/devices/reader


Configuring Deployment ModesAs described earlier, the Cloud Connect for RFID feature can be configured to one of the three deployment modes. The deployment mode can be configured by importing a JSON file that configures the management, control, and Data interfaces. Each of these interfaces can be configured to either connect to a cloud service or allow local access.

To configure the interfaces to any of the deployment modes, the steps below must be performed.

1. Export the Cloud Connect for RFID configuration file from the reader by sending an RM command to the reader.

2. Edit the Cloud Connect for RFID configuration file to configure the interfaces as required.

3. Import the Cloud Connect for RFID configuration file into the reader by sending an RM command that contains the contents of the JSON file.

Exporting/Importing Cloud ConfigurationThe Cloud Connect for RFID configuration can be exported or imported via an RM command. In order to either export or import the configuration, a login must be performed.

LoginTo login to the reader the following RM command can be used. Save the following XML command in a file called login.xml. Replace the username and password fields with the username and password of the reader.<?xml version="1.0" encoding="UTF-8"?>

<rm:command epcglobal:creationDate="2001-12-17T09:30:47.0Z"

epcglobal:schemaVersion="0.0"

xsi:schemaLocation="urn:epcglobal:rm:xsd:1 ../../../schemas/RmCommand.xsd"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:rm="urn:epcglobal:rm:xsd:1"

xmlns:epcglobal="urn:epcglobal:xsd:1"

xmlns:motorm="urn:motorfid:rm:xsd:1">

<rm:id>99</rm:id>

<rm:targetName>MyFX7500</rm:targetName>

<motorm:readerDevice>

<motorm:doLogin>

<motorm:username>admin</motorm:username>

<motorm:password>change</motorm:password>

<motorm:forceLogin>true</motorm:forceLogin>

</motorm:doLogin>

</motorm:readerDevice>

</rm:command>

To send the login command above to the reader, the following CURL command can be used.curl --location --request GET 'http://<readerip>/control'

--header 'Content-Type: application/xml'

--data-binary "@login.xml"

18


The response from the reader includes a session ID that must be used in further RM commands. The XML below is a sample response from the reader.<g1:reply xmlns:g1="urn:epcglobal:rm:xsd:1"

xmlns:g2="urn:epcglobal:xsd:1"

g2:creationDate="2010-02-10T10:10:10Z"

g2:schemaVersion="1">

<g1:id>99</g1:id>

<g1:resultCode>0</g1:resultCode>

<g3:readerDevice xmlns:g3="urn:motorfid:rm:xsd:1">

<g3:doLogin>

<g3:sessionID>sessionID </g3:sessionID>

</g3:doLogin>

</g3:readerDevice>

</g1:reply>

Exporting the Cloud ConfigurationThe cloud configuration can be exported using the following RM command. Replace the sessionID with the session ID obtained in the previous command and save the file as export.xml.<?xml version="1.0" encoding="UTF-8"?>








<rm:id>99</rm:id>



<motorm:sessionID>SessionID</motorm:sessionID>

<motorm:exportCloudConfigFromReader></motorm:exportCloudConfigFromReader>


</rm:command>

To send the command to the reader, run the following command.curl --location --request GET 'http://10.17.130.66/control' \

--header 'Content-Type: application/xml' \

--data-binary "@export.xml"

The response of the reader is an XML string with the JSON configuration data embedded in it as shown below. Save the JSON config data in the response to a file called cloud.json.

<g1:reply xmlns:g1="urn:epcglobal:rm:xsd:1"

xmlns:g2="urn:epcglobal:xsd:1"

g2:creationDate="2010-02-10T10:10:10Z"

g2:schemaVersion="1">

<g1:id>99</g1:id>



(continued on next page)

19


<g3:exportCloudConfigFromReader>

<g3:ConfigData>JSON CONFIG DATA</g3:ConfigData>

</g3:exportCloudConfigFromReader>

</g3:readerDevice>

</g1:reply>

Importing Cloud ConfigurationAfter editing the cloud configuration JSON file appropriately it can be imported into the reader using the following RM command. Replace the sessionID with the session ID obtained in the previous command and replace the JSON CONFIG DATA with the contents of the updated cloud.json file. Save the file as import.xml.<?xml version="1.0" encoding="utf-8"?>








<rm:id>99</rm:id>



<motorm:sessionID>sessionID</motorm:sessionID>

<motorm:importCloudConfigToReader>

<motorm:CloudConfigData>JSON CONFIG DATA</motorm:CloudConfigData>

</motorm:importCloudConfigToReader>


</rm:command>

Use the following command to import the config into the reader.curl --location --request GET 'http://10.17.130.66/control' \

--header 'Content-Type: application/xml' \

--data-binary "@import.xml"

The RM response on successful import is as given below.<g1:reply xmlns:g1="urn:epcglobal:rm:xsd:1" xmlns:g2="urn:epcglobal:xsd:1" g2:creationDate="2010-02-10T10:10:10Z" g2:schemaVersion="1">

<g1:id>99</g1:id>



<g3:importCloudConfigToReader></g3:importCloudConfigToReader>

</g3:readerDevice>

</g1:reply>

20


Cloud Connect for RFID ConfigurationThe section describes the JSON object that can be sent to configure the interfaces.

For ease of explanation and representation, the JSON configuration file is split into three sections, each representing the interface it configures.

• Control Section

• Data Section

• Management Section

NOTE: While importing the JSON configuration into the reader, it must be imported as a singe object.

Control SectionThe control section of the Cloud Connect for RFID JSON configuration holds the JSON object for configuring the Control interface. The JSON schema for the Control interface configuration is shown Figure 7.

Figure 7 JSON Schema for Control Interface Configuration

The Control interface can be configured to either connect to the cloud service (Zebra Data Services) or allow local access. The sample configuration for either case is shown below.

21


Local Access via RESTTo allow the Control interface to be accesses locally from the REST, enable enableLocalRest field in the configuration."control": {

"commandResponse": {

"enableLocalRest": true,

}

}

Zebra Data ServicesThe reader is by default configured to connect the Control interface to the Zebra Data Services. When configured to connect to the ZDS the JSON object for Control interface is as shown below."control": {


"enableLocalRest": false,

"connections": [

{

"type": "mqtt-GCP",

"options": {

"endpoint": {

"hostName": "mqtt.googleapis.com",

"port": 443

},

"enableSecurity": true,

"security": {

"keyFormat": "PEM",

"keyAlgorithm": "RS256",

"CACertificateFileLocation": "/readerconfig/ssl/certs/cloud-trusted-ca-certs.crt",

"publicKeyFileLocation": "/readerconfig/ssl/server.crt",

"privateKeyFileLocation": "/readerconfig/ssl/server.key"

},

"additional": {

"keepAlive": 60,

"cleanSession": true,

"debug": false,

"reconnectDelay": 1,

"reconnectDelayMax": 1,

"qos": 0,

"clientId": "projects/es-s2-emc-p/locations/us-central1/registries/RFIDREADER-es-s2-emc-p/devices/<deviceId>"

},

"publishTopic": ["/devices/<deviceId>/events/command-responses"],

"subscribeTopic": ["/devices/<deviceId>/commands/#"]

}

}

]

}

}

22


Data SectionThe data section of the Cloud Connect for RFID JSON configuration holds the JSON object for configuring the Data interface. The JSON schema for the Data interface configuration is shown in Figure 8.

Figure 8 JSON Schema for Data Interface Configuration

The Data interface can be configured to send data to either the Zebra Data Services or send it locally to a HTTP/HTTPS server as POST requests. The sample configurations for both are shown below.

23


Zebra Data ServicesThe reader is by default configured to send data to the Zebra Data Services. When configured to connect to the ZDS the JSON object for Data interface is shown below."data": {

"event": {

"connections": [

{

"type": "mqtt-GCP",

"options": {

"endpoint": {


"port": 443

},


"security": {

"keyFormat": "PEM",





},

"additional": {

"keepAlive": 60,


"debug": false,



"qos": 0,

"clientId": "projects/es-s2-emc-d/locations/us-central1/registries/RFIDREADER-es-s2-emc-d/devices/FX9600FCF36D"

},

"publishTopic": ["/devices/FX9600FCF36D/events/readEvents"],

"subscribeTopic": []

}

}

]

}

}

24


Local HTTP/HTTPS Post ServerIn a local or Hybrid deployment, the Data interface can be configured to send tag data to a HTTP/HTTPS server via HTTP POST requests. When configured in this mode the configuration object for Data interface is shown below.

HTTP Post Server with No Authentication"data": {

"event":{

"connections":[

{

"type":"httpPost",

"options":{

"URL":"http://10.104.246.243:8080",

"security":{

"verifyPeer":false,

"verifyHost":false,

"authenticationType":"NONE"

}

}

}

]

}

}

HTTPS Post Server with Basic Authentication"data": {

"event":{

"connections":[

{

"type":"httpPost",

"options":{

"URL":"http://10.17.130.220:8080",

"security":{

"verifyPeer":false,

"verifyHost":false,

"authenticationType":"BASIC",

"authenticationOptions":{

"username":"admin",

"password":"secret"

}

}

}

}

]

}

}

25


HTTPS Post Server with TLS-Client Authentication"data": {

"event":{

"connections":[

{

"type":"httpPost",

"options":{

"URL":"https://10.17.130.220:8080",

"security":{

"verifyPeer":false,

"verifyHost":false,

"authenticationType":"TLS-Client",

"authenticationOptions":{

"publicKeyFileLocation":"/apps/server.crt",

"privateKeyFileLocation":"/apps/server.key"

},

"CACertificateFileLocation":"/apps/ca-crt.pem"

}

}

}

]

}

}

Management SectionThe management section of the Cloud Connect for RFID JSON configuration holds the JSON object for configuring the Management interface. The JSON schema for the Management interface configuration is shown in Figure 9.

26


Figure 9 JSON Schema for Management Interface Configuration

The Management interface can be configured to connect to either the Zebra Data Services or to allow local access via the REST Interface. The sample configurations for both are shown below.

Local RESTIn hybrid and local deployments, the Management interface can be setup to allow access directly from the reader REST interface. To configure the Management interface to allow local access, enable enableLocalRest field in the configuration as shown below."management": {



}

}

27


Zebra Data ServicesThe reader is by default configured to allow management access from the Zebra Data Services. When configured to connect to the ZDS the JSON object for Management interface is as shown below."management": {



"connections": [

{

"type": "mqtt-GCP",

"options": {

"endpoint": {


"port": 443

},


"security": {

"keyFormat": "PEM",





},

"additional": {

"keepAlive": 60,


"debug": false,



"qos": 0,

"clientId": "projects/es-s2-emc-p/locations/us-central1/registries/RFIDREADER-es-s2-emc-p/devices/<deviceId>"

},

"publishTopic": ["/devices/<deviceId>/events/command-responses"],

"subscribeTopic": ["/devices/<deviceId>/commands/#"]

}

}

]

}

}

28

Appendix

Default Cloud Connect for RFID Configuration{

"control":{

"commandResponse":{

"enableLocalRest":false,

"connections":[

{

"type":"mqtt-GCP",

"options":{

"endpoint":{

"hostName":"mqtt.googleapis.com",

"port":443

},

"enableSecurity":true,

"security":{

"keyFormat":"PEM",

"keyAlgorithm":"RS256",

"CACertificateFileLocation":"/readerconfig/ssl/certs/cloud-trusted-ca-certs.crt",

"publicKeyFileLocation":"/readerconfig/ssl/server.crt",

"privateKeyFileLocation":"/readerconfig/ssl/server.key"

},

"additional":{

"keepAlive":60,

"cleanSession":true,

"debug":false,

"reconnectDelay":1,

"reconnectDelayMax":1,

"qos":0,

"clientId":"projects/es-s2-emc-p/locations/us-central1/registries/RFIDREADER-es-s2-emc-p/devices/FX9600FB6625"

},

"publishTopic":[

"/devices/FX9600FB6625/events/command-responses"


29

Appendix

],

"subscribeTopic":[

"/devices/FX9600FB6625/commands/#"

]

}

}

]

}

},

"data":{

"event":{

"connections":[

{

"type":"mqtt-GCP",

"options":{

"endpoint":{


"port":443

},


"security":{

"keyFormat":"PEM",





},

"additional":{

"keepAlive":60,


"debug":false,

"reconnectDelay":1,


"qos":0,


},

"publishTopic":[

"/devices/FX9600FB6625/events/readEvents"

],

"subscribeTopic":[

]

}

}

]


30

Appendix

}

},

"management":{

"commandResponse":{

"enableLocalRest":false,

"connections":[

{

"type":"mqtt-GCP",

"options":{

"endpoint":{


"port":443

},


"security":{

"keyFormat":"PEM",





},

"additional":{

"keepAlive":60,


"debug":false,

"reconnectDelay":1,


"qos":0,


},

"publishTopic":[

"/devices/FX9600FB6625/events/command-responses"

],

"subscribeTopic":[

"/devices/FX9600FB6625/commands/#"

]

}

}

]

}

}

}

31

Appendix

Sample Configuration for Local Deployment{

"control": {


"enableLocalRest": true,

}

},

"management": {



}

},

"data": {

"event":{

"connections":[

{

"type":"httpPost",

"options":{

"URL":"http://10.104.246.243:8080",

"security":{

"verifyPeer":false,

"verifyHost":false,

"authenticationType":"NONE"

}

}

}

]

}

}

}

32

www.zebra.com

Date post:	31-Dec-2021
Category:	Documents
Upload:	others
View:	4 times
Download:	0 times