更新时间:2024-09-24 GMT+08:00

平台通知网关子设备新增

功能介绍

平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系,请查看网关与子设备

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
		}
	}]
}