OTA 升级管理

OTA 用于远程升级设备固件。整体流程：创建模块 → 上传升级包 → 创建升级批次 → 设备按协议升级 → 批次与设备状态更新。

菜单：物联网 > 产品升级（OTA）（路由 /iot/ops/product-update，页面含「升级包列表」与「模块列表」两个页签）

设备侧的报文协议（版本上报、进度上报、升级指令格式）见OTA 升级。

1. 升级包模块

固件按「产品 + 模块」归属。模块列表中可新增模块（名称、别名、描述，关联产品）。内置模块 default 不可删除。设备固件由多个可独立升级的部分（如 MCU、通信模组）时，建议分别建模块。

2. 上传升级包

升级包列表 → 上传固件：

字段	说明
包类型	整包 / 差分包；差分包必须填写待升级版本（srcVersion）
固件名称 / 所属产品 / 包模块	模块选项随产品联动
升级文件	支持多文件上传（最多 200 个，单文件 ≤ 1000MB），格式：.bin .tar .gz .tar.xz .zip .gzip .apk .dav .pack
目标版本（destVersion）	升级后的版本号，设备上报该版本时判定升级成功
签名方式	默认 MD5；文件 MD5 由服务端上传时自动计算，无需手动填写
平台验证	开启后需先创建「验证批次」验证通过，才能对设备批量升级
升级包描述 / 自定义信息（packageUdi）	packageUdi 会随升级指令下发给设备（如升级公告 JSON）

注意

固件上传后不支持修改（仅可查看与删除），请确认版本号与文件无误后再上传。固件文件签名信息（fileMd5 / fileUrl 等）可在详情页「签名列表」中查看与下载。

3. 创建升级批次

在固件详情（或升级包列表行操作 批量升级）中创建批次：

配置	说明
升级类型	动态（新设备符合条件自动纳入）/ 静态
升级策略	全部设备 / 指定设备 / 按分组 / 按区域 / 灰度（按百分比）
待升级版本	仅该版本的设备会被纳入（多选）
升级时间	立即升级 / 定时升级（填写开始时间与截止时间）
推送速率	限速推送：每分钟 10 ~ 10000 台
失败重试	重试间隔与重试次数
设备升级超时	5 ~ 1440 分钟，不填则不超时
覆盖策略	是否覆盖设备之前的升级任务
其他	推送模式、App 确认、下载协议、自定义标签

批次状态：待升级 → 升级中 → 完成 / 取消。批次支持查看与编辑（仅待升级、升级中状态可编辑），可 取消 批次。

提示

开启「平台验证」的固件，须先创建验证批次（类型：验证升级包）指定少量验证设备，验证通过后才允许批量升级。

4. 批次设备与进度

在批次设备列表中查看每台设备的升级明细：

列	说明
升级百分比	设备通过 /ota/device/progress 上报的进度
状态	已排队 / 升级中 / 成功 / 失败 / 待确认 / 已通知 / 已取消
状态描述	失败原因（设备上报失败进度时携带的 desc，如下载失败、校验失败）

操作：对排队中 / 升级中 / 待确认 / 已通知状态的设备可 取消升级。

提示

设备「升级成功」的判定依据是设备通过 /ota/device/inform 上报的新版本与批次目标版本一致；progress step=100 只表示进度。设备长时间无进度时检查：设备是否订阅 /ota/device/upgrade/{pk}/{dn}、固件模块名是否与批次模块一致。排查详见故障排查。