Appearance
获取设备多模块属性
平台可主动发送请求获取设备多模块属性的命令到设备,设备反馈平台需要获取的设备信息上报到平台。
请求topic定义
请求topic:tlink/${productKey}/${deviceName}/command/getProperty/exec
数据流向:平台发布消息,设备监听消息
请求数据体格式
javascript
{
"reqid": "0020fdf71f0d491da12ba3cd38b205be",
"v": "1",
"t": 1630054074378,
"method": "tlink.${productKey}.${deviceName}.command.getProperty.exec",
"data": [{
"module_id": "module_1",
"property": ["Status", "Data", "DeviceInfo"]
},
{
"module_id": "module_2",
"property": ["Status", "Data", "DeviceInfo"]
}
]
}请求参数说明
参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| reqid | String | 是 | 消息ID号。全局唯一,用于系统消息追踪 |
| v | String | 是 | 协议版本号,目前协议版本号唯一取值为1 |
| t | Long | 是 | 消息发送时间戳 |
| method | String | 否 | TCP连接时必传 |
| data | List | 是 | 需要获取多模块属性列表。 |
| module_id | String | 是 | 模块标识符 |
| property | List | 是 | 对应模块里的具体属性列表。 如以上示例代码中,需要获取两个模块的三个属性, "Status","Data","DeviceInfo"。 |
响应获取设备多模块属性
响应topic定义
设置属性响应的topic说明:tlink/${productKey}/${deviceName}/command/getProperty/exec_reply
数据流向:设备发布消息,平台监听消息
响应数据体格式
javascript
{
"reqid": "0020fdf71f0d491da12ba3cd38b205be",
"method": "tlink.${productKey}.${deviceName}.command.getProperty.exec_reply",
"code": 200,
"data": [{
"module_id": "module1",
"property": {
"Status":"1",
"Data":"设备告警",
"DeviceInfo":["鸿蒙","3568"]
}
}, {
"module_id": "module2",
"property": {
"Status":"1",
"Data":"设备告警",
"DeviceInfo":["鸿蒙","3568"]
}
}
]
}响应参数说明
参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| reqid | String | 是 | 消息ID号。和请求的对应 |
| method | String | 否 | TCP连接时必传 |
| code | Integer | 是 | 结果状态码。成功为200,其他为失败 |
| data | List | 是 | 请求成功时,返回的数据列表。 如以上示例代码中,返回两个模块的三个属性的数据。 |