平台通知网关子设备新增
功能介绍
平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系,请查看网关与子设备。
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 } }] }