- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
-
用户指南
- 开始使用ROMA Connect
- 实例管理
- 集成应用管理
-
数据源管理
- ROMA Connect支持的数据源
- 接入API数据源
- 接入ActiveMQ数据源
- 接入ArtemisMQ数据源
- 接入DB2数据源
- 接入DIS数据源
- 接入DWS数据源
- 接入DM数据源
- 接入Gauss100数据源
- 接入FTP数据源
- 接入HL7数据源
- 接入HANA数据源
- 接入HIVE数据源
- 接入LDAP数据源
- 接入IBM MQ数据源
- 接入Kafka数据源
- 接入MySQL数据源
- 接入MongoDB数据源
- 接入MQS数据源
- 接入MRS Hive数据源
- 接入MRS HDFS数据源
- 接入MRS HBase数据源
- 接入MRS Kafka数据源
- 接入OBS数据源
- 接入Oracle数据源
- 接入PostgreSQL数据源
- 接入Redis数据源
- 接入RabbitMQ数据源
- 接入RocketMQ数据源
- 接入SAP数据源
- 接入SNMP数据源
- 接入SQL Server数据源
- 接入GaussDB(for MySQL)数据源
- 接入WebSocket数据源
- 接入自定义数据源
- 数据集成指导
- 服务集成指导
- 服务集成指导(旧版界面)
- 消息集成指导
- 设备集成指导
- 应用业务模型使用指导
- 扩大资源配额
- 查看审计日志
- 查看监控指标
- 权限管理
- 用户指南(新版)
- 最佳实践
-
开发指南
- 数据集成开发指导
-
服务集成开发指导
- 开发说明
- API调用认证开发(APP认证)
- API调用认证开发(IAM认证)
-
自定义后端开发(函数后端)
- 函数后端脚本开发说明
- AesUtils类说明
- APIConnectResponse类说明
- Base64Utils类说明
- CacheUtils类说明
- CipherUtils类说明
- ConnectionConfig类说明
- DataSourceClient类说明
- DataSourceConfig类说明
- ExchangeConfig类说明
- HttpClient类说明
- HttpConfig类说明
- JedisConfig类说明
- JSON2XMLHelper类说明
- JSONHelper类说明
- JsonUtils类说明
- JWTUtils类说明
- KafkaConsumer类说明
- KafkaProducer类说明
- KafkaConfig类说明
- MD5Encoder类说明
- Md5Utils类说明
- QueueConfig类说明
- RabbitMqConfig类说明
- RabbitMqProducer类说明
- RedisClient类说明
- RomaWebConfig类说明
- RSAUtils类说明
- SapRfcClient类说明
- SapRfcConfig类说明
- SoapClient类说明
- SoapConfig类说明
- StringUtils类说明
- TextUtils类说明
- XmlUtils类说明
- 自定义后端开发(数据后端)
- 后端服务签名校验开发
- 消息集成开发指导
- 设备集成开发指导
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 公共资源API
- 数据集成API
- 服务集成API
- 消息集成API
- 设备集成API
- 应用示例
- 权限和授权项
- 附录
- 历史API
- 修订记录
- SDK参考
-
常见问题
- 实例管理
-
数据集成
-
数据集成普通任务
- FDI各类数据库支持哪些数据类型?
- 跟踪号是什么,能跟踪到数据吗?
- FDI任务是否支持清空目标表?
- FDI任务只能采集单张表到单张表吗?
- 用户创建的FDI任务,同一账号的其他用户可见吗?
- FDI通过公网对接其他租户的MRS HIVE如何配置?
- 从OBS解析文件到RDS数据库,采集过一次后,后面采集会进行更新吗?
- OBS源端的CSV文件解析到关系型数据库时,列的值不对怎么办?
- MRS Hive目标字段和源端字段数据类型不匹配时,数据是否能集成到目标端?
- MRS Hive、MRS HBase和MongoDB的Mapping映射手动输入时,是否区分大小写?
- MRS Hive是否支持分区?
- 源端API类型数据源自定义周期如何设置?
- SAP是否支持分页读取视图?
- 数据集成组合任务
-
数据集成普通任务
- 服务集成
- 消息集成
- 设备集成
-
故障排除
-
数据集成任务
- MRS Hive目标端写入时出现数据乱码
- MRS Hive写入时数据全部写在第一个字段里
- 目标端任务报任务运行超时
- MySQL到MRS Hive时目标端报“could only be written to 0 of the 1 minReplication nodes. There are 2 datanode(s) running and 2 node(s) are excluded in this operation”错误
- Mysql到Mysql时源端报“Illegal mix of collations for operation 'UNION'”错误
- 源端Mysql增量采集每小时执行一次时部分数据丢失
- API到MySQL时源端报“401 unauthorized”错误
- Kafka集到Mysql目标端报“cannot find record mapping field”错误
- API到MySQL的定时任务时会出现源端报“connect timeout”错误
- Kafka到Mysql的实时任务时,MQS中的Topic下有数据,但是FDI任务没有采集到数据。
- Mysql到Mysql的定时任务,源端有类型为tinyint(1),值为2的字段,但是采集到目标端值就变成了1
- 目标端数据源为公网Kafka时,定时任务目标端报“The task executes failed.Writer data to kafka failed”错误
- 数据集成组合任务
- 数据源
- 服务集成
- 设备集成
-
数据集成任务
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
使用ROMA Connect集成设备
概述
ROMA Connect支持使用MQTT标准协议连接设备,快速、简单地实现设备在云端管理。
本章节通过完成一个模拟设备接入ROMA Connect的配置样例,帮助您快速熟悉使用ROMA Connect集成设备的过程。
使用ROMA Connect集成设备的步骤如下所示:
- ROMA Connect实例已绑定弹性IP,且本地PC所在网络与弹性IP的网络互通。
- 已在本地PC下载MQTTX客户端并安装。
- 在当前ROMA Connect实例上完成一个消息集成Topic的创建,具体请参考创建消息Topic。
步骤一:定义产品
产品即设备模型,通过定义产品来确定设备的功能属性集合。每个设备都有一个归属的产品。
- 创建集成应用。
- 登录ROMA Connect控制台,在“实例”页面单击实例上的“查看控制台”,进入实例控制台。
- 在左侧的导航栏选择“集成应用”,单击页面右上角的“创建集成应用”。
- 在创建集成应用弹窗中填写集成应用的“名称”,然后单击“确认”。
- 创建产品。
- 在左侧的导航栏选择“设备集成 LINK > 产品管理”,单击页面右上角的“创建产品”。
- 在创建产品弹窗中配置产品相关信息,完成后单击“确认”。
表1 产品配置 参数
配置说明
产品类型
本配置样例中的设备为直连设备,此处选择“普通产品”。
协议类型
本配置样例中选择MQTT协议类型。
集成应用
选择1中创建的集成应用。
产品模板
本配置样例中未使用产品模板,此处不设置。
产品名称
填写产品的名称,本配置样例中自定义即可。
厂商名称
填写实际使用设备的厂商名字,本配置样例中自定义即可。
厂商ID
填写实际使用设备的厂商ID,本配置样例中自定义即可。
产品型号
填写实际使用设备的产品型号,本配置样例中自定义即可。
设备类型
选择接入设备的类型,本配置样例中选择默认的“Default Type”。
模型版本
填写设备的模型版本,本配置样例中自定义即可。
描述
填写产品的描述信息。
- 为产品添加物模型服务。
- 在“产品管理”页面的“产品”页签下,单击2中创建的产品名称,进入产品详情页面。
- 在“物模型”页签下,单击“创建物模型服务”。
- 在“创建物模型服务”弹窗中配置物模型服务相关信息,完成后单击“确认”。
- 为物模型服务添加属性。
- 在“物模型”页签下的左侧选择3中添加的物模型服务。
- 在右侧物模型服务详情页的“属性”页签下,单击“创建属性”。
- 在新增属性弹窗中配置属性相关信息,完成后单击“确认”。
- 为物模型服务添加命令。
- 在右侧物模型服务详情页的“命令”页签下,单击“创建命令”。
- 在创建命令弹窗中配置命令相关信息,完成后单击“确认”。
- 在命令列表中找到刚创建的命令,单击命令名称左侧的“
”展开命令字段列表。
- 单击“创建下发命令字段”。
- 在新增下发命令字段弹窗中配置命令字段相关信息,完成后单击“确认”。
表5 命令字段信息配置 参数
配置说明
字段名称
填写命令字段的名称,此处填写为“status”。
数据类型
选择命令字段的数据类型,此处选择“String”。
是否必填
下发的命令中是否必须携带该字段,保持默认必填。
描述
填写字段的描述信息。
数据长度上限
命令字段值的最大长度,此处填写为“32”。
枚举值
命令字段的枚举值,此处填写为“on,off”,表示打开或关闭设备。
步骤二:注册设备
通过在ROMA Connect注册设备,为设备在ROMA Connect内分配唯一的ID和密钥,使设备可以接入到ROMA Connect。
- 在左侧的导航栏选择“设备集成 LINK > 设备管理”,单击页面右上角的“创建设备”。
- 在创建设备弹窗中填写设备相关配置信息,完成后单击“确认”。
- 在“设备管理”界面,单击已创建的设备设备名称,进入设备详情页,可在“Topic列表”页签查看设备的Topic信息。
步骤三:配置数据转发
ROMA Connect不会直接存储设备上报的数据,您需要配置数据转发规则,把设备数据转发到其他服务进行存储。此处以数据转发到ROMA Connect的消息集成MQS为例进行说明。
- 在左侧的导航栏选择“设备集成 LINK > 规则引擎”,单击页面右上角的“创建规则”。
- 在创建规则弹窗中填写规则相关配置信息,完成后单击“确认”。
图1 创建规则
表7 规则配置 参数
配置说明
规则名称
填写规则的名称,本配置样例中自定义即可。
集成应用
选择1中创建的集成应用。
规则描述
填写规则的描述信息。
状态
是否启用该规则,保持默认开启。
- 在规则列表中单击2中创建的规则名称,进入规则详情页面。
- 在“数据源端”下单击“创建数据源端”,设置数据源端相关配置,然后单击“保存”。
图2 数据源端配置
- 在“数据目的端”下单击“创建数据目的端”,设置数据目的端相关配置,然后单击“保存”,完成数据转发规则的配置。
图3 数据目的端配置
表9 数据目的端配置 参数
配置说明
数据目的端
本配置样例中把数据转发到ROMA Connect的消息集成MQS,此处选择“ROMA MQS”。
连接地址
选择当前ROMA Connect实例的消息集成 MQS内网连接地址,您可以在ROMA Connect实例控制台的“实例信息”页面中查看得到。
Topic名称
选择准备工作中所创建的ROMA Connect消息集成Topic。
用户名
仅当ROMA Connect实例的“MQS SASL_SSL”已开启时需要配置。
填写“Topic名称”中Topic所属集成应用的Key。
密码
仅当ROMA Connect实例的“MQS SASL_SSL”已开启时需要配置。
填写“Topic名称”中Topic所属集成应用的Secret。
步骤四:调试设备
设备可以通过集成MQTTX客户端或SDK接入ROMA Connect。为简单起见,此处在本地PC使用MQTTX客户端模拟设备接入ROMA Connect,并向ROMA Connect发送消息。
- 获取设备的接入信息。
在“设备管理”页面的设备列表中,查看并记录步骤二:注册设备中已创建设备的“MQTT连接地址”、“客户端ID”、“用户名”和“密码”信息。
图4 设备接入信息 - 打开本地安装的MQTTX客户端,单击客户端上的新增连接图标。
图5 MQTTX客户端
- 在连接属性编辑页面中填写连接属性相关配置信息,完成后单击“Connect”。
图6 连接属性配置
- 单击“Connect”,接入ROMA Connect。
若接入成功,则MQTTX客户端左上角的连接状态显示为绿色。同时,在ROMA Connect实例控制台的“设备集成 LINK > 设备管理”页面中,可以看到设备的“状态”为“在线”。
图7 设备在线 - 设备上报数据到ROMA Connect。
- 在MQTTX客户端中单击步骤3已创建的连接,填写设备Topic和要发送的消息内容,完成后单击
,向ROMA Connect发送消息。
- 在“Topic”输入框中填写设备发送消息的Topic,格式为:{产品标识}/out/{设备标识}。您可以在ROMA Connect实例控制台的“设备集成 LINK > 设备管理”页面,单击设备名称进入详情页,在“Topic列表”中查看设备的Topic。
- 在下方的消息输入框中填写Json格式的消息内容。
图8 设备发送消息 - 在ROMA Connect实例控制台选择“消息集成MQS > 消息查询”,进入消息查询页面。
- 单击“高级搜索”展开高级搜索框。
- 输入搜索条件,然后单击“搜索”,查询客户端发送的消息记录。
- “Topic名称”选择步骤三:配置数据转发中创建的消息Topic。
- “查询方式”选择“按生产时间查询”,并选择设备向ROMA Connect发送消息的时间段。
- 单击消息记录后的“消息内容”,查看设备上报消息中的“data”字段的值,确认是否与MQTTX客户端发送的内容一致。
图9 查看消息内容
- 在MQTTX客户端中单击步骤3已创建的连接,填写设备Topic和要发送的消息内容,完成后单击
- 设备接收ROMA Connect下发的命令。
- 在MQTTX客户端单击步骤3已创建的连接,单击“New Subscription”,填写设备命令下发请求发送的Topic,格式为:/v1/devices/{设备标识}/command,然后单击“Confirm”,订阅设备命令下发的消息。
您可以在ROMA Connect实例控制台的“设备集成 LINK > 设备管理”页面,单击设备名称进入详情页,在“Topic列表”中查看设备的Topic。
图10 订阅设备消息 - 在ROMA Connect实例控制台选择“设备集成 LINK > 设备管理”,单击设备右侧的“更多 > 命令下发”。
- 在命令下发弹窗中设置要下发的命令,完成后单击“确认”,下发命令。
图11 命令下发
- 在MQTTX客户端的“Received”页签可以看到ROMA Connect向设备下发的命令消息,确认消息中的“cmd”和“paras”字段的值是否与ROMA Connect控制台下发的命令一致。
图12 设备接收消息
- 在MQTTX客户端单击步骤3已创建的连接,单击“New Subscription”,填写设备命令下发请求发送的Topic,格式为:/v1/devices/{设备标识}/command,然后单击“Confirm”,订阅设备命令下发的消息。