查看升级情况

更新时间:

批量升级提交后,物联网平台根据您的设置向设备推送升级通知,您可在控制台查看目标设备的升级状态、升级包信息等。

前提条件

已向设备提交升级任务。具体操作,请参见发起升级批次任务

操作步骤

  1. 在左侧导航栏,选择监控运维 > OTA升级。

  2. 在升级包列表中,单击目标升级包对应的查看,单击以下页签:

  3. 批次管理

    • 查看升级批次类型:验证升级包、批量升级。

    • 单击升级批次对应的查看,在批次详情页的设备列表页签下,查看该升级批次下不同升级状态的设备列表。

    • 单次升级批次对应的取消:

      • 默认取消批次以及批次下的所有升级任务(包括待确认、待推送、已推送、升级中4种状态的任务)。

        当设备升级任务状态是待确认、待推送或已推送时,支持批量取消对应状态的全部升级任务。

  4. 设备列表

    查看升级包的目标设备列表,包括设备的升级状态,以及升级成功、失败和取消的统计。

    单击目标设备操作栏的查看,在批次详情页面,可单个或批量取消该设备的升级任务。

  5. 升级包信息

    • 查看升级包的基本信息,例如升级包的ID、名称、签名、签名算法、版本号、状态、模块等。

    • 复制升级包地址,可前往下载升级包文件。

状态

说明

待确认

还未在手机App确认,设备可进行OTA升级。

创建批次任务时,App确认升级选择是,升级任务才会进入该状态。

待推送

还未向设备推送OTA升级通知。

已推送

已向设备推送OTA升级通知,设备尚未上报进度。

升级中

设备已收到升级通知,并已上传升级进度。

升级成功

设备上报升级成功后的正确版本号。

说明

设备升级成功后,建议第一时间上报升级成功后的正确版本号,否则,可能会因为超时,导致升级失败。

升级失败

以下原因可能造成设备升级失败。

  • 设备未结束上一次升级任务,又发起新的批量升级,且选择不覆盖之前的升级任务,则后发起的升级任务会升级失败。

您可以:

  • 等设备完成上一次升级后,再对设备发起新的升级。

  • 在发起升级时,选择覆盖设备之前的升级任务。

说明

设备处于升级中状态的升级任务不会被覆盖。

  • 设备通过升级进度的Topic,向物联网平台上报数值-1、-2、-3或-4,则认为升级失败。数值含义如下:

    • -1:升级失败。

    • -2:下载失败。

    • -3:校验失败。

    • -4:烧写失败。

  • 设备升级时,从设备第一次上报升级进度开始计算升级时间,在设置的超时时间截止前,设备没有上报升级后的目标版本来完成升级,则认为升级失败。

  • 设备在升级中状态下,上报了源版本和目标版本以外的版本信息,则认为升级失败。

  • 自动重试时,设备在物联网平台的升级状态显示不变,即在已推送状态下重试时,状态仍然显示为已推送;在升级中状态下重试时,状态仍然显示为升级中

说明

物联网平台不会触发自动重试逻辑的情况:

  • 因升级超时(失败原因:timeout)而导致的升级失败。

  • 您主动取消的升级。

相关API

API

描述

ListOTAJobByFirmware

获取升级包下的升级批次列表。

ListOTAJobByDevice

获取设备所在的升级包升级批次列表。

ListOTATaskByJob

查询指定升级批次下的设备升级作业列表。

QueryOTAJob

查询指定升级批次的详情。

OTA相关API的更多信息,请参见OTA升级API