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

前提条件

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

操作步骤

  1. 登录物联网平台控制台
  2. 在左侧导航栏,选择监控运维 > OTA升级
    说明 为提供更好的服务,物联网平台改版了原OTA升级,新增了升级包版本统计功能。首次进入改版后的OTA升级页面时,您需要手动将之前上传的升级包与产品进行关联。升级包与产品一一对应,一个升级包只能关联一个产品。详情请参见控制台指引。
  3. 在升级包列表中,单击目标升级包对应的查看,单击以下页签:
    • 批次管理
      • 查看升级批次类型:验证升级包、批量升级。
      • 查看升级批次的状态。

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

        状态 说明
        待推送 还未向设备推送OTA升级通知。

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

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

          您可以:

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

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

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

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

        说明

        云端不会触发自动重试逻辑的情况:

        • 因升级超时(失败原因:timeout)而导致的升级失败。
        • 您主动取消的升级。
        已取消 已取消该设备的升级。
      • 取消批次下的所有升级任务。

        单击升级批次对应的取消按钮。

        • 对于静态升级批次,默认仅取消定时升级任务,可根据需要选择是否取消所有正在进行中的升级任务(包括待推送、已推送、升级中3种状态的任务)。
        • 对于动态升级批次,默认仅取消动态升级策略,可根据需要选择是否取消所有正在进行中的升级任务(包括待推送、已推送、升级中3种状态的任务)。
    • 设备列表

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

      单击目标设备操作栏的查看,可查看该设备的批次详情,单击对应的取消升级,可取消该设备的升级任务。

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

后续操作

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

相关API

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

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