OTA 升级逻辑（小白版）
上传固件 → 创建升级计划 → 平台下发 / 设备拉取 → 设备下载烧录 → 上报进度 · 一句话看懂整条链路
把 OTA 想成寄快递：先备好包裹（固件），再开运单（升级计划），最后看每台设备签收没（批次/日志）
1
2
3
4
5
主动推送
设备拉取
上传固件包
绑产品 · 目标版本
整包 / 差分 + 签名
MD5 / SHA256
创建升级计划
选设备范围 + 策略
静态 / 动态
全部 / 定向 · 立即 / 定时
平台怎么通知设备？
主动推送 ota.push
设备请求 ota.get
设备升级
HTTP 下载固件 URL
校验签名 → 烧录
上报 progress / report
看结果
批次统计 · 设备列表
成功 / 失败 / 超时
日志 TraceID 排障
升级计划两种方式（先选对这个）
静态升级
对「当前圈定的设备」开一次批次
可立即执行，也可定时开始/结束
适合：已知设备清单、一次性批量升级
动态升级
策略挂着：满足条件的设备陆续进来就升
可勾「仅对新设备生效」
适合：持续覆盖、新接入设备自动跟上版本
升级范围
全部设备：该产品下所有网关与直连设备
定向升级：勾选具体设备（常用于灰度/联调）
整包 vs 差分（边界）
整包：完整固件；定向时可对已是目标版本重推
差分：必须匹配「源版本」；版本不符则跳过不下发
核对时看哪里？
固件详情 → 升级批次 / 批次详情：总数、成功、失败、状态详情（如 rebooting）
设备「日志」与 TraceID：串联下发与设备上报；大批量注意推送速率与队列分片，避免打满链路
备好包裹
• 上传固件并绑定产品
• 填目标版本与签名
• 差分还要填源版本
开运单
• 静态 / 动态 + 全部 / 定向
• 立即或定时执行
• 主动推送或等设备拉取
控节奏
• 推送速率（台/分钟）
• 队列分片、重试、超时
• 是否覆盖已有任务
看签收
• 批次统计与设备列表
• 状态详情与设备日志
• TraceID 全链路排障