批量升级固件


OTA 流程验证无误后，你可以创建批量升级任务，指定升级策略和升级方式，并开始向设备推送升级消息。

EnOS 支持以下升级策略：

  • 云端推送升级：云端根据升级策略维护待升级设备列表，按序列推送升级请求至设备。设备在线时接受请求并开始升级；若不在线，待设备重连后接受请求。

  • 设备请求升级：云端维护待升级设备列表，设备主动请求升级后，云端判断其是否在升级范围内。若是，则推送可用固件版本，设备确认后开始升级。


EnOS 提供以下两种升级方式，你可以根据业务需要选择合适的升级方式：

  • 指定设备升级：适合小范围或特定设备的升级操作。

  • 新建 OTA 任务：适合批量升级或需要灵活配置升级范围和策略的场景。

前提条件


  • 已经完成了 验证固件升级流程。

  • 已知设备的固件版本和 deviceKey。

  • 当前账号已有 开发者 角色，以访问应用门户的开发者控制台，如果没有需联系 OU 管理员添加。

指定设备升级


  1. 选择 运行监控 > 固件管理。

  2. 选择一个状态为 已验证 或 无需验证 的固件，点击 查看 view 按钮进入固件详情页面。

  3. 点击右上角 验证 > 指定设备升级。

  4. 在页面中填入相关信息：

点击查看 OTA 升级任务配置信息

“基本信息”页面：

  • 任务名称: 输入 OTA 升级任务的名称。
  • 固件名称: 需要升级的固件名称。
  • 产品: 自动填充固件已关联的产品，若无关联，则为空。
  • 类型：系统根据固件状态自动判断为 升级 或 验证。当固件状态为 已验证 或 无需验证 时，将默认为 升级。
  • 升级方式：
    • 快照式升级: 以当前符合条件的设备列表为封闭集合，仅升级此集合中的设备，后续新增设备不纳入。
    • 增量式升级: 以当前符合条件的设备列表为开放集合，后续新增符合条件的设备也会纳入升级范围。

“升级范围”页面，你可以指定需要升级的设备范围：

  • 全部设备: 升级所选版本的所有设备。
  • 定向设备: 选择特定的设备。
  • 指定设备属性值: 升级属性名和属性值为输入范围内的特定版本的设备。
  • 指定设备标签值: 升级设备标签为输入范围内的特定版本的设备。
  • 指定资产树: 点击 添加资产树，根据 OU 内的根节点及父节点选择设备（根节点或父节点若为设备，也纳入升级范围）。底层子节点设备需通过 DeviceKey 指定，最多可选择 5 个资产树。

“升级策略”页面：

  • 最大任务并发量: 设置同时运行的最大任务数量。仅统计状态为 待推送 和 已推送 的设备，不包括 升级中 的设备。
  • 设备升级超时时间: 设置验证任务的超时时间。若设备在此时间内未返回验证结果（成功或失败），任务将失败；否则，设备将进入 待推送 列表。
  • 失败重试: 选择是否自动重试失败的任务。
    • 重试间隔: 可选 0 分钟（立即）、10 分钟、30 分钟、1 小时或 24 小时。
    • 重试次数上限: 可选 1、2 或 5 次。
  • 时间窗口: 设置升级的开始和结束日期时间。EnOS 仅在窗口内推送升级请求。若开始时间早于当前时间，升级立即执行。
    • 每日重复: 默认关闭，仅在开始和结束日期为同一天时可启用。启用后，每天在指定时间段内重复下发 OTA 任务。例如，设置时间窗口为 2025-03-21 09:00 至 2025-03-21 17:00，启用每日重复后，每天 09:00-17:00 都会执行任务。
  • 允许设备请求升级: 启用后，若当前并发任务数小于最大任务并发量，OTA 任务将立即启动。
  • 创建后立即启动升级（验证）: 启用后，点击 确认 时任务立即开始。

5. 点击 确认 完成任务创建。

新建 OTA 任务


  1. 选择任意一种方式进入功能入口：

    • 在 EnOS 应用门户的开发者控制台中，选择 运行监控 > OTA 升级，选择 新建任务。

    • 在 EnOS 应用门户的开发者控制台中，选择 运行监控 > 固件管理。在固件列表中选择一项 已验证 或 无需验证 的固件，选择 查看 view 按钮，在右上角选择 验证 > 新建 OTA 任务。

  2. 在页面中填入相关信息：

点击查看 OTA 升级任务配置信息

“基本信息”页面：

  • 任务名称: 输入 OTA 升级任务的名称。
  • 固件名称: 需要升级的固件名称。
  • 产品: 自动填充固件已关联的产品，若无关联，则为空。
  • 类型：系统根据固件状态自动判断为 升级 或 验证。当固件状态为 已验证 或 无需验证 时，将默认为 升级。
  • 升级方式：
    • 快照式升级: 以当前符合条件的设备列表为封闭集合，仅升级此集合中的设备，后续新增设备不纳入。
    • 增量式升级: 以当前符合条件的设备列表为开放集合，后续新增符合条件的设备也会纳入升级范围。

“升级范围”页面，你可以指定需要升级的设备范围：

  • 全部设备: 升级所选版本的所有设备。
  • 定向设备: 选择特定的设备。
  • 指定设备属性值: 升级属性名和属性值为输入范围内的特定版本的设备。
  • 指定设备标签值: 升级设备标签为输入范围内的特定版本的设备。
  • 指定资产树: 点击 添加资产树，根据 OU 内的根节点及父节点选择设备（根节点或父节点若为设备，也纳入升级范围）。底层子节点设备需通过 DeviceKey 指定，最多可选择 5 个资产树。

“升级策略”页面：

  • 最大任务并发量: 设置同时运行的最大任务数量。仅统计状态为 待推送 和 已推送 的设备，不包括 升级中 的设备。
  • 设备升级超时时间: 设置验证任务的超时时间。若设备在此时间内未返回验证结果（成功或失败），任务将失败；否则，设备将进入 待推送 列表。
  • 失败重试: 选择是否自动重试失败的任务。
    • 重试间隔: 可选 0 分钟（立即）、10 分钟、30 分钟、1 小时或 24 小时。
    • 重试次数上限: 可选 1、2 或 5 次。
  • 时间窗口: 设置升级的开始和结束日期时间。EnOS 仅在窗口内推送升级请求。若开始时间早于当前时间，升级立即执行。
    • 每日重复: 默认关闭，仅在开始和结束日期为同一天时可启用。启用后，每天在指定时间段内重复下发 OTA 任务。例如，设置时间窗口为 2025-03-21 09:00 至 2025-03-21 17:00，启用每日重复后，每天 09:00-17:00 都会执行任务。
  • 允许设备请求升级: 启用后，若当前并发任务数小于最大任务并发量，OTA 任务将立即启动。
  • 创建后立即启动升级（验证）: 启用后，点击 确认 时任务立即开始。

3. 点击 确认 完成任务创建。

结果


  • 成功创建后，在运行监控 > 固件管理 的固件详情页面中，可以从 设备 或者 任务 两个不同视角查看升级情况。

    • 设备列表 将展示所有设备验证和升级到该固件的记录。

    • 任务列表 与 运行监控 > OTA 升级 页面相同。

  • 如果你在创建任务时启用 创建后立即启动升级，任务将立即启动。或者，你可以转到 运行监控 > OTA 升级 页手动启动任务。

  • 在 运行监控 > OTA 升级 中，点击 详情 查看任务进度。


备注

设备固件升级后，功能是否正常需开发者自行验证。

后续操作