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

设备上报升级状态

功能介绍

设备上报升级状态。

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