设备上报升级状态
功能介绍
设备上报升级状态。
Topic
上行: $oc/devices/{device_id}/sys/events/up
参数说明
字段名 |
必选/可选 |
类型 |
参数描述 |
---|---|---|---|
object_device_id |
可选 |
String |
参数解释:
|
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 |
参数解释: 设备的升级状态。 取值范围: 结果码定义如下:
|
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" } }] }