
# 设备接入ROMA Connect
#### 概述
停车场的车位感应设备通过集成开源MQTT客户端接入ROMA Connect，实现车位状态信息的上报。
#### 操作步骤
1. 获取MQTT客户端。 根据您所使用的编程语言获取3.1或3.1.1版本的[Eclipse paho MQTT Client](https://github.com/eclipse-paho/paho.mqtt.java)。
   
2. 获取设备的接入信息。
   1. 登录ROMA Connect控制台，在"实例"页面单击实例上的"查看控制台"，进入实例控制台。
   
   2. 在左侧的导航栏选择"设备集成 LINK \> 设备管理"，在页面中获取设备的连接信息。
      - MQTT/MQTTS连接地址：在设备管理页面上方获取设备的接入地址，如果使用MQTT接入，则获取"MQTT连接地址"；如果使用MQTTS接入，则获取"MQTTS连接地址"，并下载SSL证书。
      
      - 客户端ID/用户名/密码：在设备页签下找到对应的设备，并获取设备的"客户端ID"、"用户名"和"密码"。
      
      - 设备的Topic信息：单击设备的名称进入设备详情页面，在Topic列表页签下，获取设备上报（发布）消息的Topic信息，Topic名称格式为：{产品标识}/out/{设备标识}。
       
    
3. 设备集成MQTT客户端。 对车位感应设备进行开发并集成Eclipse paho MQTT Client，在集成开发过程中写入设备的接入信息，并设置当车位状态变化时，车位感应设备上报设备信息和车位状态信息。设备上报的数据为JSON格式，格式如下所示。
   deviceId为设备的物理标识信息，数据类型为String；status为车位状态信息，数据类型为String，值为0（未停车）或1（已停车）。
   ```
   {
     "deviceId": "xxxxxx",
     "status": "0/1"
   }
   ```
   具体开发过程请参考[设备集成开发](https://support.huaweicloud.com/devg-roma/link-devg-java.html)。
   
4. 设备接入ROMA Connect。 设备完成集成开发后，上电并联网，接入ROMA Connect。此时，在ROMA Connect实例控制台的"设备集成 LINK \> 设备管理"页面中，可以看到设备的"状态"为"在线"。
   
5. 设备上报车位状态数据。 当车位状态变化时，车位感应设备上报车位状态数据。
   - 在ROMA Connect实例控制台选择"消息集成MQS \> 消息查询"，选择[配置设备数据转发MQS](https://support.huaweicloud.com/bestpractice-roma/roma_05_0003.html)中所创建的Topic，可看到转发到MQS的设备数据记录。
   
   - 在ROMA Connect实例控制台选择"数据集成 FDI \> 任务管理"，单击[创建MQS到数据库的集成任务](https://support.huaweicloud.com/bestpractice-roma/roma_05_0004.html)中创建的任务名称，在任务信息的"日志 \> 运行日志"页签下，可看到任务执行成功的记录。
   
   - 在停车场管理系统的数据库中，可查看写入数据表的车位状态数据。
    
 
