升级固件


你可以创建批量升级任务,指定升级策略,升级方式,并开始进行升级消息推送。本文介绍如何创建一个批量升级任务。

升级策略

  • 云端推送升级:云端根据升级策略维护待升级设备列表,按照升级序列推送升级请求至设备。若设备在线,接受升级请求后开始升级。若设备不在线,待设备重连之后接受本次升级请求。
  • 设备请求升级:云端维护待升级设备列表,待设备主动请求升级后,判断设备是否在可升级范围内。如是,则向设备推送一个可用固件版本。设备确认升级到该版本后即开始升级。

前提条件

  • 已经完成了 验证固件
  • 已知设备固件版本和 deviceKey
  • 需要有创建 OTA 任务的权限,如果没有需联系组织管理员添加。有关 EnOS 内的用户权限,参见 策略,角色,与权限
  • 确保已阅读固件的使用限制。参见 使用限制

步骤

根据情况选择相应方式进行升级。支持以下两个入口进行固件升级。

基于固件升级

  1. 选择 OTA升级 > 固件管理
  2. 点击 view 查看 进入固件详情页面。
  3. 点击右上角 升级,根据实际情况选择:
    • 新增 OTA 任务:新建 OTA 升级任务,系统自动填充所选固件信息。
    • 指定设备升级:选择特定设备并配置升级策略。
  4. 根据界面提示,参见 配置项信息 填入相关信息。
  5. 点击 确认 完成任务创建。

新建 OTA 任务

  1. 选择 OTA 升级 > OTA 任务
  2. 点击 新增任务,根据界面提示,参见 配置项信息 填入相关信息。
  3. 点击 确认 完成任务创建。

结果

  • 成功创建后,在对应固件详情中,可以从设备或者任务两个不同视角查看升级情况。设备视角将展示所有设备升级到该固件的记录。任务视角与 OTA 任务 页面中的任务列表中相同。 如果你在创建任务时启用 创建后立即验证,任务将立即启动。 或者,你可以转到 OTA 任务 页手动启动任务
  • OTA 任务 中,点击 **详情 **进入任务详细信息页面,可以在其中查看升级进度。更多信息,参见 查看 OTA 任务详情

后续操作

升级完成后,你可以删除不再需要的固件,参见 删除固件

配置项信息

OTA 任务的配置项信息包含基本信息、升级范围和升级策略。请根据实际情况填写相应配置项信息。

  • “基本信息”页面的配置项信息如下:
    • 任务名称: 输入 OTA 验证任务的名称。
    • 固件名称: 从名称列表中选择升级固件。
    • 产品: 会自动填充固件关联的产品,若无关联,则为空。
    • 类型:升级或验证。系统会根据固件验证状态自动判断任务类型。
    • 升级方式
      • 快照式升级: 将当前已上报固件版本且版本号落在升级范围的设备列表作为一个封闭集合,仅升级这个集合中的设备,新添加的设备即使符合升级条件也不会接收到升级推送。
      • 增量式升级: 将当前已上报固件版本且版本号落在升级范围的设备列表作为一个开放集合,对于后续新增加的符合条件的设备也会纳入升级范围,待升级设备列表始终处于动态维护的过程中。


  • “升级范围”页面的配置项信息如下:
    • 升级范围: 选择升级范围。
      • 全部设备: 升级所选版本的所有设备。
      • 定向设备: 选择特定的设备。
      • 指定设备组:升级所选设备组内的特定版本的设备。
      • 指定设备属性值: 升级属性名和属性值为输入范围内的特定版本的设备。
      • 指定设备标签值: 升级设备标签为输入范围内的特定版本的设备。
      • 指定资产树: 点击 添加资产树 可以根据 OU 内的根结点以及根结点下的父节点选择设备,根结点或父节点本身如果也是设备,也会纳入升级范围;如果要指定底层子节点的设备,应通过设备 DeviceKey 来进行。最多可以选择 5 个资产树。


  • “升级策略”页面的配置项信息如下:
    • 最大任务并发量: 输入可以同时运行的最大升级数量。升级状态处于 升级中 的设备不包括在此计数中,而处于 待推送已推送 状态的设备应需要考虑在并发设备总量中。
    • 设备升级超时时间: 输入验证任务的超时时间。如果以上选择的设备在此时间段内未返回验证结果(成功或失败),则任务将失败。否则,该设备将被添加到 待推送 列表中。
    • 失败重试: 选择是否自动重试失败的任务。
      • 重试间隔: 选择重试的间隔。可用选项为:0 分钟(立即)、10 分钟、30 分钟、1 小时和 24 小时。
      • 重试次数上限: 输入重试次数的上限。 可用选项为:1、2 和 5。
    • 时间窗口: 选择升级的开始和结束日期和时间。 EnOS 云端仅在时间窗口之内推送升级,并且不会将任何升级请求推送到时间窗口之外。如果开始日期/时间早于当前日期/时间,升级将立即执行。
      • 每日重复: 此选项默认处于关闭状态,则仅在 时间窗口 的开始日期和结束日期位于同一天时才能启用。 如果此开关开,则表示每天在所设置的时间段内重复下发 OTA 任务。
    • 允许设备请求升级: 如果启用此功能,并且系统中当前并发 OTA 升级任务的数量小于 最大任务并发量,则 OTA 任务将立即启动。
    • 创建后立即启动升级(验证): 如果启用,当点击 确认 时,任务将立即开始。