属性上报使用说明

使用说明

1. 创建产品与设备、设定物模型：创建产品流程、创建设备流程、设定产品模型。
2. 设备鉴权：平台验证设备是否具有接入权限。
3. 设备属性上报：设备通过MQTT/HTTP/LwM2M等协议上报属性数据。

   按照不同的设备协议，调用的接口不一样，下面分别介绍MQTT、HTTPS、LwM2M/CoAP这三种协议中属性上报的样例：

   • MQTT：通过属性上报接口MQTT协议属性上报、使用MQTT.fx调测上报数据到物联网平台，MQTT属性上报样例如下：

     Topic：$oc/devices/{device_id}/sys/properties/report
     数据格式样例：   
     {
         "services": [
             {
                 "service_id": "Temperature",
                 "properties": {
                     "value": 57,
                     "value2": 60
                 }
             }
         ]
     }

   • HTTPS：通过属性上报接口HTTP协议属性上报上报数据到物联网平台，其中access_token参考：HTTPS设备鉴权。HTTPS属性上报样例如下：

     POST https://{endpoint}/v5/devices/{device_id}/sys/properties/report 
     Content-Type: application/json 
     access_token: d144a524-1997-4b99-94bf-f27128da8a34  
     {
         "services": [
             {
                 "service_id": "serviceId",
                 "properties": {
                     "Height": 124,
                     "Speed": 23.24
                 }
             }
         ]
     }

   • LwM2M/CoAP：通过属性上报接口LwM2M/CoAP属性上报上报数据到物联网平台。LwM2M/CoAP属性上报样例如下：

     //假设设备上报的数据内容(value)为c4 0d 5a 6e 96 0b c3 0e 2b 30 37
      NON-2.05   MID=48590, Token=2cb6a673cba24c04, OptionSet={"Observe":22, "Content-Format":"application/octet-stream"}, c4 0d 5a 6e 96 0b c3 0e 2b 30 37

   

   • 设备属性上报内容需要与产品模型中定义的属性相匹配。
   • 协议详情请参考：MQTT协议属性上报、HTTP协议属性上报、LwM2M/CoAP属性上报。

4. 平台存储最近一次数据快照：当上报的数据符合产品模型定义时，在设备接入控制台，选择“设备 > 所有设备”，单击具体设备，在“设备信息”中可以看到最新的数据快照。如下图：
   图2 平台接收到并成功解析设备属性上报
   

5. 数据转发：通过数据流转功能可以转发到应用侧，也可以转发到华为云其他云服务上进行存储和处理。