
# 注册LINK设备
#### 概述
通过在ROMA Connect注册设备，为设备在系统中分配唯一的ID和密码，设备通过ID和密码接入ROMA Connect。
设备可以直接接入ROMA Connect（普通设备），也可以作为子设备通过网关接入ROMA Connect（网关子设备）。
设备与产品的关系如下图所示。普通设备和网关子设备归属普通产品，网关设备归属网关产品，一个网关设备下可以接入多个网关子设备。
![](https://support.huaweicloud.com/usermanual-roma/zh-cn_image_0269084645.png)
#### 前提条件
- 每个设备都要归属到某个集成应用下，在注册设备前您需要有可用的集成应用，否则请提前[创建集成应用](https://support.huaweicloud.com/usermanual-roma/create-application.html)。
- 每个设备都要归属到某个产品下，在注册设备前您需要有可用的产品，否则请提前[创建产品](https://support.huaweicloud.com/usermanual-roma/define-product.html)。
 
 #### 创建设备
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。
2. 在左侧的导航栏选择"设备集成 LINK \> 设备管理"，单击页面右上角的"创建设备"。
3. 在创建设备弹窗中配置设备相关信息，完成后单击"确认"。
   表1设备信息配置 
   | 参数    | 配置说明                                                                                                                                                                                                           |
   |:---|:---|
   | 设备名称  | 填写设备的名称，根据规划自定义。建议您按照一定的命名规则填写设备名称，方便您快速识别和查找。 支持中文、中文标点符号（）。；，：""、？《》及英文大小写、数字、罗马数字 I 到 XI及英文符号 ()_,#.?'-@%\&!，不超过100个字符。                                                   |
   | 集成应用  | 选择设备所属的集成应用。                                                                                                                                                                                                   |
   | 所属产品  | 选择设备所属的产品，设备将继承该产品定义的物模型服务能力。 普通直连设备和网关子设备选择普通产品，网关设备选择网关产品。                                                                                                                  |
   | 设备标识  | 填写设备的唯一标识，如IMEI、MAC地址等。设备标识为普通直连设备和网关子设备的deviceId，为网关设备的gatewayId。 支持英文小写、数字、下划线和中划线，长度2-64个字符。                                                                               |
   | 客户端ID | 填写设备的客户端ID。 支持英文小写、数字、下划线和中划线，长度8-64个字符。                                                                                                                                     |
   | 设备密码  | 填写设备的接入密码，自定义，用于设备接入ROMA Connect。 至少1数字、1大写字母、1小写字母、1特殊字符（\~！@#$%\^\&\*()-_=+\|\[{}\];:\<\>/?），长度8-32个字符。                                                                    |
   | 确认密码  | 填写确认密码，与"设备密码"的值保持一致。                                                                                                                                                                                          |
   | 是否启用  | 选择是否启用设备，只有启用设备后，设备才可以接入ROMA Connect，默认为启用。                                                                                                                                                                    |
   | 设备标签  | 为设备设置标签信息，用于快速查找设备。 支持中文、英文大小写、数字、下划线和中划线，不超过64个字符。 说明： 编辑标签时如遇到实际没有重复，但提示重复的情况，可在编辑页面将标签全部删除后，重新添加，然后保存即可。 |
   | 设备描述  | 填写设备的描述信息。                                                                                                                                                                                                     |
      
   
4. 在设备列表查看到新创建的设备，表示设备创建成功。
 
 #### 为设备添加自定义Topic（可选）
如果设备的基础Topic无法满足您的使用需要，您可以为设备自定义Topic。
1. 在实例控制台的"设备集成 LINK \> 设备管理"页面，单击设备的名称，进入设备详情页面。
2. 在"Topic列表"页签下，选择"自定义Topic"，然后单击右侧的"创建"。
3. 在创建Topic弹窗中配置自定义Topic相关信息，完成后单击"确认"。
   表2自定义Topic信息配置 
   | 参数      | 配置说明                                                                                                                                                                                                                                                                                    |
   |:---|:---|
   | Topic名称 | 填写自定义Topic的名称。 支持英文大小写、数字、下划线和中划线，不超过64字符。                                                                                                                                                                                                          |
   | 权限      | 选择设备对该Topic的操作权限。 - 发布：设备可发布消息到该Topic。  - 订阅：设备可订阅该Topic，从Topic获取消息。   |
   | 描述      | 填写自定义Topic的描述信息。                                                                                                                                                                                                                                                                        |
      
   
 
#### 相关文档
如果您希望通过API创建LINK产品，请参考[创建设备](https://support.huaweicloud.com/api-roma/CreateDevice.html)。
