Configure device using Web Interface

To connect the reader to MQTT Broker, follow the steps below:

Import Certificates

For TCP/TLS and Websocket/TLS connections the Root CA certificate of the broker need to be imported into the reader. For mutual TLS setups device public certificate and private key generated need to be imported.

Using SCP

  • Copy generated certificates and CA certificate into reader. (copy to desired folder inside /apps/).

Using Web UI

  • Create PFX file from certificate generated.

  • Follow reader’s Integration guide to import certificates into reader.

  • You may also set up mTLS authentication. Refer to Appendix: Set up mTLS

Add MQTT Endpoint

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

  1. Click Communication > Zebra IoT Connector > Configuration.

    ../../_images/configuration_page2.png

  2. Click on Add Endpoint button to add new endpoint.

    ZIOTC Add Endpoint

  3. Select MQTT for Endpoint Type.

  4. Configure Endpoint Name and Endpoint Description fields.

  5. Configure Connection details with device details of MQTT Broker.

    ../../_images/MQTT_connection1.png

Note

server

  • URL for MQTT Broker.

port

  • MQTT Broker port.

protocol
  • protocol used for connection.

    • TCP for unsecure connection over TCP.

    • TLS for secure connection over TCP.

    • Web Socket for unsecure connection over Websocket.

    • Secure Web Socket for secure connection over Websocket.

Client Id

  • client id to be used.

  1. Configure Topics to be used for all interfaces.

    ../../_images/MQTT_topics1.png

Note

/FX7500FCCD18_ssl/tevents

  • Reader uses this topic to send tag read events.

/FX7500FCCD18_ssl/mevents

  • Reader uses this topic to send asynchronous events like heartbeats, GPI, userapp, errors and warnings.

/FX7500FCCD18_ssl/cmds

  • Reader will subscribe to this topic and listening for commands from cloud.

/FX7500FCCD18_ssl/rsp

  • Reader uses this topic to send responses to commands.

  1. Configure Certificates section with the location of certs inside reader. The certificate path, private key path and passphrase need to be provided.

    ../../_images/MQTT_certs.png

  2. Click on Add.

  3. Once added the endpoint will be seen under Endpoint Configurations.

    ../../_images/MQTT_app.png

Interface Configuration

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

  2. Click Communication > Zebra IoT Connector > Configuration.

  3. Select emqx_ssl endpoint for Management Interface, Control Interface, Management Events Interface and Tag Data Interface.

    ../../_images/MQTT_app.png

  4. Click on Update button to update interface configuration.

Start ZIoTC Service

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

  2. Click Communication > Zebra IoT Connector > Connection.

    ../../_images/MQTT_connection_page2.png

  3. Click on Connect button.

  4. Once connected the current connection status of the interfaces will be displayed under Connection Status section.

    ../../_images/MQTT_cs.png