验证固件升级流程¶
新增固件后,在批量升级设备固件前,应先选择部分设备验证固件 OTA 升级流程,以降低因固件错误导致设备阻塞的风险。
EnOS 提供两种验证 OTA 流程的方式,你可以根据业务场景选择合适的方式:
指定设备验证:适合小规模测试固件的场景。如果你是开发者,且刚开发了一个新固件,建议先通过 指定设备验证 选择少量设备(1-5 台)进行测试,确认固件无误。验证通过后,可以通过 新建 OTA 任务 进行更大范围的验证或直接批量升级。
新建 OTA 任务:适合需要批量验证或升级的场景。如果你已经对固件有一定信心,或者需要对多个设备进行验证/升级,直接使用 新建 OTA 任务 更高效。
备注
EnOS 仅提供验证 OTA 升级流程的消息通道,开发者需自行验证固件是否能正常推送至设备,以及设备更新固件后是否能正常运行。
前提条件¶
指定设备验证¶
在 EnOS 应用门户的开发者控制台中,选择 运行监控 > 固件管理。
在列表中选择一个状态为 未验证 的固件,选择其对应的 查看
按钮,进入固件详情页面。
选择右上角 验证 > 指定设备验证。
在页面中填入相关信息。
点击查看 OTA 验证任务配置信息
“基本信息”页面:
- 任务名称: 输入 OTA 验证任务的名称。
- 固件名称: 需要验证的固件名称。
- 产品: 自动填充固件已关联的产品,若无关联产品,则为空。
- 类型:系统根据固件状态自动判断为 升级 或 验证。仅当固件状态为 未验证 时,可选择 验证 类型。
“升级范围”页面,你可以指定需要升级的设备范围:
- 全部设备: 升级所选版本的所有设备。
- 定向设备: 选择特定的设备。
- 指定设备属性值: 升级属性名和属性值为输入范围内的特定版本的设备。
- 指定设备标签值: 升级设备标签在指定范围内的特定版本的设备。
- 指定资产树: 点击 添加资产树,根据 OU 内的根节点及父节点选择设备(根节点或父节点若为设备,也纳入升级范围)。底层子节点设备需通过 DeviceKey 指定,最多可选择 5 个资产树。
“升级策略”页面:
- 设备升级超时时间: 设置验证任务的超时时间。若设备在此时间内未返回验证结果(成功或失败),任务将失败;否则,设备将进入 待推送 列表。
- 创建后立即验证: 启用后,点击 确认 时任务立即开始。
5. 点击 确认 完成任务创建。
新建 OTA 任务¶
选择任意一种方式进入功能入口:
在 EnOS 应用门户的开发者控制台中,选择 运行监控 > OTA 升级,选择 新建任务。
在 EnOS 应用门户的开发者控制台中,选择 运行监控 > 固件管理。在固件列表中选择一项 未验证 的固件,选择 查看
按钮,在右上角选择 验证 > 新建 OTA 任务。
在页面中填入相关信息。
点击查看 OTA 验证任务配置信息
“基本信息”页面:
- 任务名称: 输入 OTA 验证任务的名称。
- 固件名称: 需要验证的固件名称。
- 产品: 自动填充固件已关联的产品,若无关联产品,则为空。
- 类型:系统根据固件状态自动判断为 升级 或 验证。仅当固件状态为 未验证 时,可选择 验证 类型。
“升级范围”页面,你可以指定需要升级的设备范围:
- 全部设备: 升级所选版本的所有设备。
- 定向设备: 选择特定的设备。
- 指定设备属性值: 升级属性名和属性值为输入范围内的特定版本的设备。
- 指定设备标签值: 升级设备标签在指定范围内的特定版本的设备。
- 指定资产树: 点击 添加资产树,根据 OU 内的根节点及父节点选择设备(根节点或父节点若为设备,也纳入升级范围)。底层子节点设备需通过 DeviceKey 指定,最多可选择 5 个资产树。
“升级策略”页面:
- 设备升级超时时间: 设置验证任务的超时时间。若设备在此时间内未返回验证结果(成功或失败),任务将失败;否则,设备将进入 待推送 列表。
- 创建后立即验证: 启用后,点击 确认 时任务立即开始。
3. 点击 确认 完成任务创建。
结果¶
成功创建后,在运行监控 > 固件管理 的固件详情页面中,可以从 设备 或者 任务 两个不同视角查看验证情况。
设备列表 将展示所有设备验证和升级到该固件的记录。
任务列表 与 运行监控 > OTA 升级 页面相同。
如果你在创建任务时启用 创建后立即验证,任务将立即启动。或者,你可以转到 运行监控 > OTA 升级 页手动启动任务。
在 OTA 升级 中,点击 详情 进入任务详细信息页面,可以在其中查看任务进度。更多信息,参见 查看升级详情 。
备注
设备固件升级之后,其功能是否可用,需由开发者根据设备情况自行验证。