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

前提条件

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

操作步骤

  1. 登录物联网平台控制台
  2. 实例概览页面,选择目标环境,找到对应的实例,单击实例ID或备注名称。
    重要 目前仅开通企业版实例服务的地域下,执行此步骤。其他地域,请跳过此步骤。地域及实例的支持说明,请参见实例概述
    实例概览
  3. 在左侧导航栏,选择监控运维 > OTA升级
    说明 为提供更好的服务,物联网平台改版了原OTA升级,新增了升级包版本统计功能。首次进入改版后的OTA升级页面时,您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应,一个升级包只能关联一个产品。详情请参见控制台指引。
  4. 在升级包列表中,单击目标升级包对应的查看,单击以下页签:
    • 批次管理
      • 查看升级批次类型:验证升级包、批量升级。
      • 单击升级批次对应的查看,在批次详情页的设备列表页签下,查看该升级批次下不同升级状态的设备列表。
        状态说明
        待确认还未在手机App确认,设备可进行OTA升级。

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

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

        待推送状态原因有三种:设备离线、定时推送或速率限制,状态分别显示为:

        • 待推送(设备离线)
        • 待推送(定时:2020/XX/XX XX:XX:XX)
        • 待推送
        已推送已向设备推送OTA升级通知,设备尚未上报进度。
        升级中设备已收到升级通知,并已上传升级进度。
        升级成功设备上报升级成功后的正确版本号。
        说明 设备升级成功后,建议第一时间上报升级成功后的正确版本号,否则,可能会因为超时,导致升级失败。
        升级失败以下原因可能造成设备升级失败。
        • 设备未结束上一次升级任务,又发起新的批量升级,且选择不覆盖之前的升级任务,则后发起的升级任务会升级失败。

          您可以:

          • 等设备完成上一次升级后,再对设备发起新的升级。
          • 在发起升级时,选择覆盖设备之前的升级任务。
            说明 设备处于升级中状态的升级任务不会被覆盖。
        • 设备通过升级进度的Topic,向物联网平台上报数值-1、-2、-3或-4,则认为升级失败。数值含义如下:
          • -1:升级失败。
          • -2:下载失败。
          • -3:校验失败。
          • -4:烧写失败。
        • 设备升级时,从设备第一次上报升级进度开始计算升级时间,在设置的超时时间截止前,设备没有上报升级后的目标版本来完成升级,则认为升级失败。
        • 设备在升级中状态下,上报了源版本和目标版本以外的版本信息,则认为升级失败。

        如果发起批量升级时,指定了待升级版本号,且选择了升级失败后重试,在以下情况下会进行自动重试升级。

        • 设备在升级中状态下,上报了源版本和目标版本以外的版本信息导致的升级失败。
        • 设备通过上报升级进度的Topic,主动上报-1-2-3-4导致的升级失败。

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

        说明

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

        • 因升级超时(失败原因:timeout)而导致的升级失败。
        • 您主动取消的升级。
        已取消已取消该设备的升级。

        如果升级批次状态为升级中,升级批次对应操作栏显示编辑按钮。您可单击编辑,修改升级策略配置中的升级包推送速率(已配置的恒定速率值或可变速率值),或修改、新增标签。配置说明,请参见发起升级批次任务

        您也可单击批次信息,查看该批次任务的基本信息。如下图所示,如果升级批次状态为升级中标签信息右侧显示编辑按钮。您可单击编辑,修改和新增标签。

        编辑标签
      • 单击升级批次对应的取消
        • 对于静态升级批次,默认取消批次以及批次下的所有升级任务(包括待确认、待推送、已推送、升级中4种状态的任务)。
        • 对于动态升级批次,默认仅取消动态升级策略,可根据需要选择是否取消所有正在进行中的升级任务(包括待推送、已推送、升级中3种状态的任务)。

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

    • 设备列表

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

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

    • 升级包信息
      • 查看升级包的基本信息,例如升级包的ID、名称、签名、签名算法、版本号、状态、模块等。
      • 单击升级包签名右侧的下载,可获取升级包文件。

后续操作

查看升级包版本和成功率:设备OTA升级任务完成后,可通过数据分析功能,查看升级包版本分布,及升级成功率统计,了解设备OTA升级更多情况。

相关API

API描述
ListOTAJobByFirmware获取升级包下的升级批次列表。
ListOTAJobByDevice获取设备所在的升级包升级批次列表。
ListOTATaskByJob查询指定升级批次下的设备升级作业列表。
QueryOTAJob查询指定升级批次的详情。

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