Configure device using Web Interface

To connect the reader to Azure IoT Hub, follow the steps below:

Import Certificates

The Azure device certificates created need to be imported into reader.

Using SCP

  • Copy mydevkitkey.pem, mydevkitcertificate.pem `` and ``ca.pem created in Azure IoT Hub Setup into reader. (copy to desired folder inside /apps/).

Using Web UI

  • Create PFX file from certificate generated in Azure IoT Hub Setup.

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

Add Azure IoT Hub 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.

    ZIOTC Configuration

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

    ZIOTC Add Endpoint

  3. Select Azure IoT Hub for Endpoint Type.

  4. Configure Endpoint Name and Endpoint Description fields.

  5. Configure Connection details with device details added to Azure.

    ../../_images/AZURE_connection.png

  6. Configure Topics to be used for all interfaces.

    ../../_images/AZURE_topics.png

Note

tagEvents

  • Reader uses this topic to send tag read events.

managementEvents

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

command

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

response

  • Reader uses this topic to send responses to commands.

Important

For control, tagEvents, managementEvents, and management topics, current configuration used default Azure IoT hub topics. These can be changed.

After a device connects, it can send messages to IoT Hub using the topic format devices/{IoTDeviceID}/messages/events/.

To receive messages from IoT Hub, a device should subscribe using devices/{IoTDeviceID}/messages/devicebound/# as a Topic Filter. The device doesn’t receive any messages from IoT Hub until it has successfully subscribed to its device-specific endpoint

Failing to define topics in the mentioned format may lead to unexpected results.

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

    ../../_images/AZURE_certs.png

  2. Click on Add.

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

    ../../_images/AZURE_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 AWS #1 endpoint for Management Interface, Control Interface, Management Events Interface and Tag Data Interface.

    ../../_images/AZURE_ifc.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.

    ZIOTC Connection

  3. Click on Connect button.

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

    ../../_images/AZURE_cs.png