# 设备信息上报
#### 功能描述
设备向平台上报设备信息。
#### Topic
上行: $oc/devices/{device_id}/sys/events/up
#### 参数说明
| 字段名              | 必选/可选 | 类型                   | 参数描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| object_device_id | 可选    | String               | **参数解释：** - 网关设备上报时，子设备进行上报需填写该参数。object_device_id为Topic中设备的子设备Id，否则将请求失败。  - 直连设备上报时，object_device_id需与Topic中的device_id一致。  - 若为空则默认该参数与Topic中的device_id一致。   |
| services         | 可选    | List\<ServiceEvent\> | **参数解释：** 事件服务列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
ServiceEvent定义表
| 字段名        | 必选/可选 | 类型     | 参数描述                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| service_id | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："$sdk_info"。                |
| event_type | 必选    | String | **参数解释：** 系统字段。 **取值范围：** 固定为："sdk_info_report"。 |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。                                            |
| paras      | 可选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                                                           |
   
paras参数列表
| 字段名                | 必选/可选 | 类型     | 参数描述                                                                                                                                             |
|:---|:---|:---|:---|
| device_sdk_version | 可选    | String | **参数解释：** 设备sdk版本号，格式为：接入方式_版本号，例如C_v0.5.0, JAVA_v0.5.0，Tiny SDK_v1.0.0等。 |
| sw_version         | 可选    | String | **参数解释：** 软件版本。                                                           |
| fw_version         | 可选    | String | **参数解释：** 固件版本。                                                             |
| device_ip          | 可选    | String | **参数解释：** 设备IP。                                                            |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/up  
数据格式： 
{ 
    "object_device_id": "{object_device_id}", 
    "services": [{ 
        "service_id": "$sdk_info", 
        "event_type": "sdk_info_report", 
        "event_time": "20151212T121212Z",
         "paras": { 
             "device_sdk_version": "C_v0.5.0",
             "sw_version": "v1.0", 
             "fw_version": "v1.0",  
             "device_ip": "127.0.0.1"
         } 
    }] 
}
```