平台通知网关子设备新增
功能介绍
平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看网关与子设备。
Topic
下行: $oc/devices/{device_id}/sys/events/down
参数说明
字段名 | 必选/可选 | 类型 | 参数描述 |
|---|---|---|---|
object_device_id | 可选 | String | 参数解释： 该参数与Topic中的device_id一致。 |
services | 可选 | List<ServiceEvent> | 参数解释： 事件服务列表。 |
ServiceEvent定义表
字段名 | 必选/可选 | 类型 | 参数描述 |
|---|---|---|---|
service_id | 必选 | String | 参数解释： 系统字段。 取值范围： 固定为："$sub_device_manager"。 |
event_type | 必选 | String | 参数解释： 系统字段。 取值范围： 固定为："add_sub_device_notify"。 |
event_time | 可选 | String | 参数解释： 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 |
paras | 必选 | Object | 参数解释： 事件参数JSON对象。 |
paras参数列表
字段名 | 必选/可选 | 类型 | 参数描述 |
|---|---|---|---|
devices | 必选 | List<DeviceInfo> | 参数解释： 设备列表。 |
version | 必选 | Long | 参数解释： 子设备信息版本。网关设备可以保存此信息用于同步子设备列表时携带此参数。 |
DeviceInfo定义表
字段名 | 必选/可选 | 类型 | 参数描述 |
|---|---|---|---|
parent_device_id | 必选 | String | 参数解释： 父节点设备ID。 |
node_id | 必选 | String | 参数解释： 设备标识码。 |
device_id | 必选 | String | 参数解释： 设备ID。 |
name | 可选 | String | 参数解释： 设备名称。 |
description | 可选 | String | 参数解释： 设备描述。 |
manufacturer_id | 可选 | String | 参数解释： 厂商ID。 |
model | 可选 | String | 参数解释： 设备型号。 |
product_id | 可选 | String | 参数解释： 产品ID。 |
fw_version | 可选 | String | 参数解释： 固件版本。 |
sw_version | 可选 | String | 参数解释： 软件版本。 |
status | 可选 | String | 参数解释： 设备在线状态。 取值范围： ONLINE：设备在线。 OFFLINE：设备离线。 INACTIVE：设备未激活。 |
extension_info | 可选 | Object | 参数解释： 设备扩展信息。用户自定义的的扩展信息。 |
示例
Topic: $oc/devices/{device_id}/sys/events/down
数据格式：
{
"object_device_id": "{object_device_id}",
"services": [{
"service_id": "$sub_device_manager",
"event_type": "add_sub_device_notify",
"event_time": "20151212T121212Z",
"paras": {
"devices": [{
"parent_device_id": "c6b39067b0325db34663d3ef421a42f6_12345678",
"node_id": "subdevice11",
"device_id": "2bb4ddba-fb56-4566-8577-063ad2f5a6cc",
"name": "subDevice11",
"description": null,
"manufacturer_id": "ofo",
"model": "twx2",
"product_id": "c6b39067b0325db34663d3ef421a42f6",
"fw_version": null,
"sw_version": null,
"status": "ONLINE"
}],
"version": 1
}
}]
}
