# 平台通知网关子设备新增
#### 功能介绍
平台将该网关新增的子设备列表信息通知给网关设备。网关与子设备关系，请查看[网关和子设备](https://support.huaweicloud.com/usermanual-iothub/iot_01_0052.html)。
#### 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
}
}]
}
```