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

前提条件

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

操作步骤

  1. 登录物联网平台控制台。
  2. 在实例概览页面，找到对应的实例，单击实例进入实例详情页面。
    注意 目前华东2（上海）、华北2（北京）、华南1（深圳）地域开通了企业版实例服务。其他地域，请跳过此步骤。
    实例概览
  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。