跳到主要内容

OTA 任务

说明

学会如何上传新版本固件后，用户就可以通过远程 OTA 对现有设备进行升级。此外，当设备出现故障时，用户也可以尝试通过 OTA 来修复设备。下面将介绍如何创建新的 OTA 任务以及管理已发布的 OTA 任务。

创建新的 OTA 任务​

请按照以下步骤创建新的 OTA 任务：

  1. 在 Firmware Image 列表中选择要用于 OTA 升级的镜像。
  2. 进入 Firmware Image > 选择固件 > Actions > Start OTA。
  3. 填写任务名称 > 选择 OTA 目标（设备组或单个节点）>
    选择更新类型（Force Push 或 User Approval）> 设置 OTA 时间（可选）> Start OTA。
创建新的 OTA 任务
dashboard ota 1
测试建议

为了便于测试，建议选择 Force Push 选项，这样 OTA 任务信息会立即发送到节点。否则，节点将根据自动获取配置中定义的 OTA 升级策略来获取 OTA URL。

高级选项​

创建 OTA 任务时还可以配置高级选项，如下所示：

高级选项
dashboard ota 5
  • User Approval：任务发送到节点前，需要终端用户先行批准。
    • Notify User：向用户发送推送通知，告知 OTA 升级可用，用户可选择批准或拒绝。
  • Apply at specific Device Time：仅在特定时间段内触发任务（例如凌晨 2:00-4:30）。
  • OTA Job Valid for：仅允许在指定日期范围内执行任务。
  • Host MCU：使用 OTA 镜像升级主机 MCU，而非 ESP Wi-Fi MCU。

除 User Approval（用户审批）外，其他信息都会作为元数据发送到节点，由固件逻辑进行处理。
有关此元数据的更多信息，请参考高级选项。

动态 OTA (Dynamic OTA)​

启动 OTA 任务时，用户可以选择将其设置为动态 OTA (Dynamic OTA)。动态 OTA 任务采用基于规则的方式，根据节点的类型、型号或固件版本来进行定向升级。动态 OTA 选项位于启动 OTA 任务页面的 Advanced 高级设置部分。

动态 OTA
dashboard ota 3
提示

动态 OTA 的详细信息也会在 OTA 任务详情页面中显示，如下图所示。

动态 OTA 状态
dashboard ota 4

管理已发布的 OTA 任务​

用户可以在 OTA 任务界面中查看已发布的 OTA 任务。该界面会显示创建任务时在固件镜像中填写的相关信息。状态列包含四种状态，具体说明如下表所示。

管理已发布的 OTA 任务
dashboard ota 2
状态说明
FailedOTA 升级失败
RejectOTA 项目未通过验证
ActiveOTA 项目上传完成，可进行升级
FinishedOTA 任务已完成
备注

用户可以在执行过程中取消 OTA 任务，但已经获取到升级 URL 的节点仍会继续升级。

关于 OTA 任务在后端的运行机制，请参考此处。

On this page