设备快速接入（联通用户专用）

前提条件

• 已经注册华为云官方帐号，可点击注册页面完成注册。
• 已经在华为云上完成实名制认证，可点击实名认证完成认证。
• 已开通设备管理服务，可访问设备管理服务，点击“立即使用”后开通服务。

获取设备接入信息

在设备接入服务控制台获取应用接入所需的信息。

1. 登录华为云官方网站，访问设备接入服务。
2. 进入管理控制台后，查看设备接入信息，记录域名和端口。针对不支持用域名接入的设备，通过在cmd命令框中执行“ping 域名”获取IP地址，用IP地址接入平台。由于IP地址不固定，用户需要将IP地址做成可配置项。

   注：设备管理服务基于设备接入服务，因此设备管理服务的接入地址与设备接入服务相同。

   

新增产品模型和注册设备

1. 点击控制台左侧导航的“设备管理”切换到设备管理页面，再点击界面右上角的“进入设备管理服务”。
2. 在设备接入管理单击页面左下角的切换左侧菜单，打开“产品模型”页面，点击页面右上角的“新增产品模型 > 手动创建”。如果已有MQTT设备产品模型，可跳过此步骤。
3. 填写产品基本信息，点击“确定”。创建一个MQTT协议的产品。

   

4. 选择“设备 > 设备注册”。单击右上角“创建”，按照如下表格填写参数后，单击“确定”

   参数名称	配置原则
   选择产品	选择要注册的产品名称，产品选择MQTT产品模型。
   设备标识码	设备唯一物理标识，如IMEI、MAC地址等，用于设备在接入物联网平台时携带该标识信息完成接入鉴权。
   预置密钥	用于设备接入物联网平台的密钥校验。
   确认密钥	再次填写预置密钥。

   注：也可以记录下产品模型的产品ID，通过调用平台开放的应用侧接口注册设备。

5. 保存设备ID和密钥，后续将用于设备接入。

   

连接鉴权

参考连接鉴权接口文档，使用MQTT.fx工具接入物联网平台。

1. 访问MQTT.fx下载页面，下载并安装MQTT.fx。
2. 下载连接信息生成工具，运行“MqttClientIdGenerator.jar”，填写设备ID和密钥，生成连接信息。

   

   参数	必选/可选	类型	参数描述
   clientId	必选	String(256)	一机一密的设备clientId由4个部分组成：设备ID、设备身份标识类型、密码签名类型、时间戳。通过下划线“_”分隔，设备身份标识类型固定值为0。 密码签名类型：长度1字节，当前支持2种类型： “0”代表HMACSHA256不校验时间戳。 “1”代表HMACSHA256校验时间戳。 时间戳：为设备连接平台时的UTC时间，格式为YYYYMMDDHH，如UTC 时间2018/7/24 17:56:20 则应表示为2018072417。
   Username	必选	String(256)	设备ID。
   Password	必选	String(256)	Password的值为使用“HMACSHA256”算法以时间戳为密钥，对secret进行加密后的值。 secret为注册设备时平台返回的secret。

   设备通过MQTT协议的connect消息进行鉴权，对于构造clientId的各个部分信息都必须包括进去，平台收到connect消息时，会判断设备的鉴权类型和密码摘要算法。

   • 当采用“HMACSHA256”校验时间戳方式时，会先校验消息时间戳与平台时间是否一致，再判断密码是否正确。
   • 当采用“HMACSHA256”不校验时间戳方式时，鉴权消息也必须带时间戳，但不检验时间是否准确，仅判断密码是否正确。

   connect消息鉴权失败时，平台会返回错误，并自动断开MQTT链路。

3. 打开MQTT.fx软件，单击设置图标。

   

4. 填写物联网平台MQTT设备接入地址，并配置鉴权参数。

   

   参数名称	说明
   Broker Address	填写从设备接入服务管理控制台获取的设备对接地址，此地址为域名信息。不能通过域名接入的设备，此处填写从2中获取的IP地址。
   Broker Port	设置为8883。

5. 下载并配置证书（解压后在“certificate -> Agent Lite -> Java”目录下）。

   

6. 点击“Connect”，设备鉴权成功后，在物联网平台可以看到设备处于在线状态。

   

上报数据

参考设备上报数据接口文档，使用MQTT.fx工具向物联网平台上报数据。

设备若通过MQTT通道上报数据，需要发给指定的topic，上报消息的topic格式为：“$oc/devices/{device_id}/sys/properties/report”，其中“deviceId”的值，对一机一密设备，使用deviceId接入时填写为设备注册成功后返回的“deviceId”值。

1. 填写接口地址，此处以“$oc/devices/{device_id}/sys/properties/report”为例。

   

2. 填写上报的数据。

   请求参数

   字段名	必选/可选	类型	参数描述
   services	必选	List<ServiceProperty>	设备服务数据列表（具体结构参考下表ServiceData定义表）

   ServiceProperty定义表：

   字段名	必选/可选	类型	参数描述
   service_id	必选	String	设备服务的ID。
   properties	必选	Object	设备服务的属性列表，具体字段在设备关联的产品模型中定义。
   eventTime	可选	String	设备采集数据UTC时间（格式：yyyyMMddTHHmmssZ），如：20161219T114920Z。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。

   请求示例

   {
       "services": [{
               "service_id": "Temperature",
               "properties": {
                   "value": 57
               },
               "event_time": "20151212T121212Z"
           },
           {
               "service_id": "Battery",
               "properties": {
                   "level": 80
               },
               "event_time": "20151212T121212Z"
           }
       ]
   }

   

3. 点击“Publish”，可以在物联网平台上查看设备是否成功上报数据。

   

进阶体验

按照本页面的指导，使用MQTT.fx模拟MQTT设备接入物联网平台后，您应该已经基本了解MQTT设备如何通过MQTTS协议调用物联网平台开放的接口与平台交互。

若您想要进一步体验设备管理服务，可参考开发指南开发真实应用和真实设备，并接入物联网平台，体验更多功能。