# 设备上报升级状态
#### 功能介绍
设备上报升级状态。
#### 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 | **参数解释：** 系统字段，固定为："$ota"。                                                                                                                              |
| event_type | 必选    | String | **参数解释：** 系统字段，固定为："upgrade_progress_report"。                                                                                                         |
| event_time | 可选    | String | **参数解释：** 事件时间。UTC时间，格式：yyyyMMdd'T'HHmmss'Z'。 设备上报数据不带该参数或参数格式错误时，则数据上报时间以平台时间为准。 |
| paras      | 必选    | Object | **参数解释：** 事件参数JSON对象。                                                                                                                                |
   
paras参数列表
| 字段名         | 必选/可选 | 类型      | 参数描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| result_code | 必选    | Integer | **参数解释：** 设备的升级状态。 **取值范围：** 结果码定义如下： - 0：success（处理成功）  - 1：device in use（设备使用中）  - 2：poor signal（信号质量差）  - 3：already the latest version（已经是最新版本）  - 4：low battery（电量不足）  - 5：insufficient storage space（剩余空间不足）  - 6：download timeout（下载超时）  - 7：upgrade package verification failure（升级包校验失败）  - 8：unsupported upgrade package type（升级包类型不支持）  - 9：insufficient memory（内存不足）  - 10：upgrade package installation failure（安装升级包失败）  - 255：internal exception（内部异常）   |
| progress    | 可选    | Integer | **参数解释：** 设备的升级进度。 **取值范围：** 0到100。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| version     | 必选    | String  | **参数解释：** 设备当前版本号（升级完成时上报的版本号要与上传软固件包时在平台设置的版本号一致）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| description | 可选    | String  | **参数解释：** 升级状态描述信息，可以返回具体升级失败原因。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
#### 示例
```
Topic: $oc/devices/{device_id}/sys/events/up  
数据格式： 
{
    "object_device_id": "{object_device_id}",
    "services": [{
        "service_id": "$ota",
        "event_type": "upgrade_progress_report",
        "event_time": "20151212T121212Z",
        "paras": {
            "result_code": 0,
            "progress": 80,
            "version": "V2.0",
            "description": "upgrade processing"
        }
    }]
}
```