设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

网关批量设备属性上报

功能介绍

用于批量设备上报属性数据给平台。网关设备可以用此接口同时上报多个子设备的属性数据。

属性上报和消息上报的区别,请查看消息通信说明

Topic

上行:$oc/devices/{device_id}/sys/gateway/sub_devices/properties/report

参数说明

字段名

必选/可选

类型

参数描述

devices

必选

List<DeviceProperty>

设备数据

DeviceService定义表

字段名

必选/可选

类型

参数描述

device_id

必选

String

设备ID

services

必选

List<ServiceProperty>

设备服务数据列表

ServiceProperty定义表:

字段名

必选/可选

类型

参数描述

service_id

必选

String

设备的服务ID。

properties

必选

Object

设备服务的属性列表,具体字段在产品模型里定义,可以设置多个字段。

event_time

可选

String

设备采集数据UTC时间(格式可选:秒级别:yyyyMMdd'T'HHmmss'Z',毫秒级别:yyyy-MM-dd'T'HH:mm:ss.SSS'Z'),如:20161219T114920Z或者2020-08-12T12:12:12.333Z。

设备上报数据不带该参数或参数格式错误时,则数据上报时间以平台时间为准。

示例

Topic:  $oc/devices/{device_id}/sys/gateway/sub_devices/properties/report
数据格式:  
{ 
    "devices":[ 
        { 
            "device_id":"bf40f0c4-4022-41c6-a201-c5133122054a", 
            "services":[ 
                { 
                    "service_id":"analog", 
                    "properties":{ 
                        "PhV_phsA":"1", 
                        "PhV_phsB":"2" 
                    }, 
                    "event_time":"20190606T121212Z" 
                }
            ] 
        }, 
        { 
            "device_id":"42aa08ea-84c1-4025-a7b2-c1f6efe547c2", 
            "services":[ 
                { 
                    "service_id":"analog", 
                    "properties":{ 
                        "PhV_phsA":"3", 
                        "PhV_phsB":"5" 
                    }, 
                    "event_time":"20190606T121212Z" 
                }, 
                { 
                    "service_id":"parameter", 
                    "properties":{ 
                        "Load":"6", 
                        "ImbA_strVal":"8" 
                    }, 
                    "event_time":"20190606T121212Z" 
                } 
            ] 
        } 
    ] 
} 
分享:

    相关文档

    相关产品