# 接入案例
下面举一个金鸽网关使用MQTT协议基于IoTDA的接入方式接入设备的点位案例。
#### 对接步骤如下：
1. 首次使用需要创建产品，协议类型选择"MQTT"，完成后如下图所示。产品承载着物模型，也就是实际需要上传的点位，下图创建的产品 "详细"中添加服务和点位。 
   ![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002463168814.png "点击放大")
   
   
2. 创建网关设备（网关设备可以直接命名为设备名称，如AM01），填写内容如下图所示，"所属产品"可在下拉列表中选择刚刚创建的产品。若项目第一次创建，则需要自行创建"所属空间"。路径："空间管理"-\>"空间管理"-\>"添加空间"。注册设备信息填完单击"确定"之后，系统会生成一个文件，文件名为"DEVICES-KEY"。该文件为网关与云平台MQTT通信的秘钥，需要妥善保存。 
   ![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002496367861.png "点击放大")
   
   
3. 所谓子设备，即是网关下挂载的设备实体。本次调测中，特指SL/AM两款modbus协议设备。需要单独注册，在"设备管理"-\>"设备"选择对应的网关设备，单击"详情"，单击"注册子设备"，按照下图完成子设备的创建，注册入口和方式如下图所示。 
   ![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002496207853.png "点击放大")
   
   
4. 在"设备管理"-\>"设备"选择对应的网关设备，单击"详情"，单击"注册子设备"，按照下图完成子设备的创建 
   ![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002496207833.png "点击放大")
   
   
5. 在金鸽网关的上位机软件上进行如下配置步骤： 
   ![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002463168778.png "点击放大")
   1. 双击"华为云 IoT"弹出华为云配置框。
   
   2. 单击"启用"按钮，启用华为云。默认：关闭。灰色表示：不启用，绿色表示：启用。
   
   3. 认证方式：选择是密钥连接还是证书连接，默认是密钥连接。
   
   4. IP/域名：登录设施云前端，"系统管理"-\>"实例信息"，对应设备接入的MQTT协议对应的接入地址。
   
   5. 端口：默认 1883，密钥连接填写 1883，证书连接填写 8883。
   
   6. 设备 ID：对应前面注册的网关设备的ID
   
   7. 设备密钥：对应注册网关设备成功时下载的文件里面的秘钥。![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002463168798.png "点击放大")
   
   8. CA 证书：启用证书连接时，要选择根证书文件上传。
   
   9. 客户端证书：启用证书连接时，要选择客户端证书文件上传。
   
   10. 客户端密钥：启用证书连接时，要选择客户端密钥文件上传。 以上三步在秘钥认证前提下不需要填写
       
   
   11. 服务 ID：由于金鸽网关只能挂载1个设备，所以只能设置一个服务ID。设置与华为云上的服务 ID 一致，创建产品时设置的服务 ID。可以设置一个服务 ID 或多个服务 ID。本次示例介绍多个服务 ID 应用，添加了"AM01"和"SL01"服务 ID。
   
   12. 上传周期：数据定时发布间隔时间，默认 30S。
   
   13. 数据补传：是否启用掉线数据补传，单击"启用"按钮。灰色表示：不启用，绿色表示：启用。
   
   14. 选择数据点上传：在配置框右边的方框内选择要上传的数据点，默认空白表示全部上传。本示例服务 ID"AM01"选择 AM01 设备的数据点上传，服务 ID 项选择"AM01"，在右边方框内鼠标右键，弹出数据点框，选择"AM01"的数据点，如：单击 AM01 的数据点 REG001，鼠标左键按住不放，鼠标下移到要上传的数据点，单击"确定"，方框内就显示你选择的数据点。
   
   15. 单击"确定"，确定华为云的配置。
   
   16. 单击"写入配置"，网关设备重启后，华为云才启用。重新打开配置软件登录设备，可以在基本信息页面可以看到"华为云上线状态"的提示灯是绿色，表示华为云已连接上。最右边显示从机设备在线的状态。
   
   
   配置完成后，配置界面如下图所示，华为IoT在线状态为绿灯。
   
   
6. 通过金鸽网关上位机使用"MQTT Client"方式进行上云配置。配置项如下图所示，其中"Client ID"、"用户名"、"密码"为该方式连接华为云必须的鉴权信息，可通过在线工具<https://iot-tool.obs-website.cn-north-4.myhuaweicloud.com/>生成，入参为 "DeviceId"和"DeviceSecret为子设备注册成功时下载的文件里面的秘钥。
   
   ![](https://support.huaweicloud.com/devg-ocsmartcampus/zh-cn_image_0000002496367829.png "点击放大")
   订阅主题选择参考<https://support.huaweicloud.com/api-iothub/iot_06_v5_3006.html>，订阅发布的Topic为$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report，其中{device_id}为网关的设备ID。