升级设备固件
升级设备固件
本页目标
在服务端发起设备固件升级,并轮询升级状态与进度(HTTP 调用,建议放在后台)。
升级接口为 upgradeDevice:设备升级;进度为 upgradeProcessDevice:获取设备升级状态和进度。字段以两页 OpenAPI 说明为准。设备维护类接口索引见 设备管理 API。
进度查询见 upgradeProcessDevice API 页。
服务端用 HTTP 流程见下表;移动端可走 Android 示例工程 中的 OpenSDK 升级封装(本页 platforms: [H] 仅展开 HTTP 步骤)。
步骤
- 调用 upgradeDevice 发起升级(子账号需
Upgrade/dev:序列号)。 - 轮询 upgradeProcessDevice,建议间隔 3–5 秒,直到
status回到idle或percent达 100;若超过约 30 分钟仍停在downloading/upgrading,查在线状态后按下方失败处理重试。 - 关注返回中的
version、status(idle/downloading/upgrading)、percent;列表结构见接口页deviceVersionList样例。
升级失败或卡在 downloading/upgrading 时,查设备在线状态与 排障,必要时重试 upgradeDevice(以接口页约束为准)。
各端实现
服务端 HTTP
发起升级和查询进度都由服务端调用上述两个接口。参数以原接口页为准。