设备接入 IoTDA设备接入 IoTDA

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

平台查询设备属性

功能介绍

用于平台向设备查询属性信息。平台可调用此接口查询设备的属性数据。设备收到属性查询请求后,需要将设备的属性数据返回给平台,如果设备没回响应平台会认为属性查询请求执行超时。

低配置且资源受限或者对网络流量有要求的设备,不适合直接构造JSON数据与物联网平台通信时,可将原始二进制数据透传到物联网平台。通过开发编解码插件实现二进制数据到平台定义JSON格式的转换。

Topic

下行: $oc/devices/{device_id}/sys/properties/get/request_id={request_id}

上行: $oc/devices/{device_id}/sys/properties/get/response/request_id={request_id}

  • {request_id}用于唯一标识这次请求。设备侧收到下行请求的topic带该参数时,上行响应的topic需要将该参数值返回给平台。
  • 设备侧订阅带{request_id}结尾的topic时,可以使用#,设备侧订阅平台查询设备属性的topic为:$oc/devices/{device_id}/sys/properties/get/#

下行请求参数说明

字段名

必选/可选

类型

参数描述

object_device_id

可选

String

属性查询对应的目标设备ID。

service_id

可选

String

设备的服务ID。

上行响应参数说明

字段名

必选/可选

类型

参数描述

services

可选

List<ServiceProperty>

设备服务数据列表。

ServiceProperty结构定义:

字段名

必选/可选

类型

参数描述

service_id

必选

String

设备的服务ID。

properties

必选

Object

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

event_time

可选

String

设备采集数据UTC时间(格式:yyyyMMdd'T'HHmmss'Z'),如:20161219T114920Z。

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

下行请求示例

Topic: $oc/devices/{device_id}/sys/properties/get/request_id={request_id} 
数据格式:  
{
    "object_device_id": "{object_device_id}",
    "service_id": "Temperature"
}

上行响应示例

Topic:$oc/devices/{device_id}/sys/properties/get/response/request_id={request_id}
数据格式:  
{
    "services": [
        {
            "service_id": "Temperature",
            "properties": {
                "PhV_phsA": "1",
                "PhV_phsB": "2"
            },
            "event_time": "20190606T121212Z"
        }
    ]
}
分享:

    相关文档

    相关产品