注册设备

概述

通过在ROMA Connect注册设备，为设备在系统中分配唯一的ID和密码，设备通过ID和密码接入ROMA Connect。

设备可以直接接入ROMA Connect（普通设备），也可以作为子设备通过网关接入ROMA Connect（网关子设备）。

设备与产品的关系如下图所示。普通设备和网关子设备归属普通产品，网关设备归属网关产品，一个网关设备下可以接入多个网关子设备。

前提条件

• 每个设备都要归属到某个集成应用下，在注册设备前您需要有可用的集成应用，否则请提前创建集成应用。
• 每个设备都要归属到某个产品下，在注册设备前您需要有可用的产品，否则请提前创建产品。

创建设备

1. 登录ROMA Connect控制台，在“实例”页面单击实例上的“查看控制台”，进入实例控制台。
2. 在左侧的导航栏选择“设备集成 LINK > 设备管理”，单击页面右上角的“创建设备”。
3. 在创建设备弹窗中配置设备相关信息，完成后单击“确认”。

   表1 设备信息配置

   参数	配置说明
   设备名称	填写设备的名称，根据规划自定义。建议您按照一定的命名规则填写设备名称，方便您快速识别和查找。
   集成应用	选择设备所属的集成应用。
   所属产品	选择设备所属的产品，设备将继承该产品定义的物模型服务能力。 普通直连设备和网关子设备选择普通产品，网关设备选择网关产品。
   设备标识	填写设备的唯一标识，如IMEI、MAC地址等。设备标识为普通直连设备和网关子设备的deviceId，为网关设备的gatewayId。
   设备密码	填写设备的接入密码，自定义，用于设备接入ROMA Connect。
   确认密码	填写确认密码，与“设备密码”的值保持一致。
   是否启用	选择是否启用设备，只有启用设备后，设备才可以接入ROMA Connect，默认为启用。
   设备标签	为设备设置标签信息，用于快速查找设备。 说明： 编辑标签时如遇到实际没有重复，但提示重复的情况，可在编辑页面将标签全部删除后，重新添加，然后保存即可。
   设备描述	填写设备的描述信息。

为设备添加自定义Topic（可选）

如果设备的基础Topic无法满足您的使用需要，您可以为设备自定义Topic。

1. 在实例控制台的“设备集成 LINK > 设备管理”页面，单击设备的名称，进入设备详情页面。
2. 在“Topic列表”页签下，选择“自定义Topic”，然后单击右侧的“创建”。
3. 在创建Topic弹窗中配置自定义Topic相关信息，完成后单击“确认”。

   表2 自定义Topic信息配置

   参数	配置说明
   Topic名称	填写自定义Topic的名称。
   Topic权限	选择设备对该Topic的操作权限。 发布：设备可发布消息到该Topic。 订阅：设备可订阅该Topic，从Topic获取消息。
   描述	填写自定义Topic的描述信息。