Connecting Devices to ROMA Connect

Overview

A device can access ROMA Connect by integrating with the MQTT.fx client.

After a device is connected to ROMA Connect, it can report data to ROMA Connect. You can also use ROMA Connect to deliver control commands to the device.

ROMA Connect does not directly store data reported by devices. You must configure data forwarding rules to forward device data to other services for storage.

Connecting to Devices

A device can access ROMA Connect by using the open-source Eclipse Paho MQTT Client. You can also use the MQTT.fx client to verify device access.

1. Obtain the MQTT client.

   Obtain the Eclipse Paho MQTT Client based on your programming language.

2. Obtain device access information.
   1. Log in to the ROMA Connect console. On the Instances page, click View Console next to a specific instance.
   2. In the navigation tree on the left, choose LINK > Device Management.
   3. Obtain device connection information.
      • MQTT/MQTTS connection address: Obtain the access address of the device from the upper part of the Device Management page and then download the SSL certificate. If MQTT is used for access, obtain the MQTT connection address. If MQTTS is used for access, obtain the MQTTS connection address.
      • Client ID/Username/Password: Locate the corresponding device on the Devices tab page and obtain the client ID, username, and password of the device.
   4. Obtain topic information of the device.

      Click the device name to go to the device details page. On the Topics tab page, obtain the topic information about the messages reported (published) and received (subscribed) by the device.

      After the device is created, the system automatically generates five basic topics. For details about the topics, see Table 1. For details about how to use a topic, see "MQTT Topic Specifications" in the ROMA Connect Developer Guide.

      Table 1 Basic topic description

      Topic Name	Topic Class	Description
      {Product ID}/out/{Device ID}	Publish	Used by devices to publish messages. Messages are processed based on the rule engine configuration.
      {Product ID}/in/{Device ID}	Subscribe	Used by devices to subscribe to messages. Messages are processed based on the rule engine configuration.
      /v1/devices/{Device ID}/datas	Publish	Used by devices to report messages complying with the MQTT-based communication protocol for IoT in power distribution. Messages are filtered based on the protocol and then processed based on the rule engine configuration. When the device shadow function is enabled, the data reported by this topic will be recorded in the shadow.
      /v1/devices/{Device ID}/command	Subscribe	Used by devices to subscribe to commands delivered by the IoT platform. Commands delivered by the IoT platform are published to this topic by default.
      /v1/devices/{Device ID}/commandResponse	Publish	Used by devices to publish responses. After a device receives a command from the IoT platform, it responds to the command through this topic.

3. Integrate the device with the MQTT client.

   Develop and integrate the device with Eclipse Paho MQTT Client, and write the device access information during the integration. For details, see Device Integration Development.

4. Connect the device to ROMA Connect.

   After the integration development is complete, power on the device to take it online and connect it to ROMA Connect.

Commissioning a Device

• Reporting data to ROMA Connect

  By default, ROMA Connect has subscribed to topics of the publish type. After a device sends a message to such a topic, the topic can report data to ROMA Connect.

• Receiving commands from ROMA Connect

  After ROMA Connect sends a control command to the command delivery topic, the topic delivers the command to the device for device control.