元启芯控 YUANQI EMBEDDED ENGINEERING

首页/ 技术笔记/ OTA 升不上去,问题多半不在固件:一条升级链路上的五个断点

OTA 升级 · 2026-11-16

OTA 升不上去,问题多半不在固件:一条升级链路上的五个断点

建产品报错、首版永远不升级、两栏文件混搭、版本号自己变回去、设备没有可信身份——五个现象,一条链路,三个系统。

OTA 升级固件发布版本管理量产交付 约 10 分钟读完
OTA 升不上去,问题多半不在固件:一条升级链路上的五个断点

OTA 出问题,第一反应通常是”固件写错了”。但把最近几个项目里踩过的坑排一遍会发现:真正卡住升级的,几乎没有一次是代码错误,全都是三个系统之间的信息没对齐。

这三个系统是:

  • 设备:它自报的板型名、它内嵌的版本号
  • 平台:产品登记、固件版本、文件校验值
  • 服务端:设备身份、激活状态

任何一处不一致,对外表现都是同一句话——“升级没生效”。所以排查的第一步不是连调试器,是先把这三种”没生效”分开:

现象断点在哪该看哪张表
后台建产品直接报错设备 → 平台,型号对不上设备自报的板型名
建好了,设备就是不升版本比较语义版本登记表
升了,但装上去是旧版本文件与版本没对应hash 登记表
改了版本号,出包还是旧号改动没真正落盘编译产物
设备换了、修了、返厂了身份与激活状态设备台账

下面按这条链路的顺序,逐个说。

断点一:设备在平台上根本没有”身份”

现象:后台创建产品时直接拒绝——“没有找到开发板 ID 对应的 OTA 请求记录”。

这句话很绕,但它说的是一件很具体的事:平台在问”这个型号的设备,有没有真的联网请求过一次升级”。没有请求记录,就不承认这个型号存在。

根因:设备连上来时自报的是一个公版板型名(bread-compact-wifi)。原因是工程里只设了板型类型,构建时前者自动顶了后者——没有人显式把产品型号写进去。

修法只有一行,但两个概念要分清:

set(BOARD_NAME "yqx-029")   # 平台认的是这个名字

板型类型不动,产品型号必须显式指定。平台认的是”名字”,不是”类型”。

这条最容易被忽略的地方是顺序:

定板型名 → 改固件 → 烧设备 → 联网产生一次 OTA 请求 → 才能建产品

顺序反了,平台侧永远建不出这个型号,而你会一直以为是自己填错了参数。

断点二:首版永远不升级——这是”正确”的

现象:首版固件烧进去,平台上配好固件,设备开机就是不升。

判据:平台的发布版本号 ≤ 设备内嵌版本号。

升级判断的语义是”严格大于才升”。平台登记 1.0.0、设备内嵌也是 1.0.0,设备认为自己就是最新的——它不升级是对的,不是 bug。

很多人在这里查了半天推送、网络、重试,其实是被”没反应”误导了。先确认比较语义,再查实现,能省掉一整轮无效排查。

修法:首版固件的版本号,从第一版起就和平台登记的版本号保持一致(首版上架直接 1.0.0)。

避免复现:产品、固件、平台三方共用同一张版本表。每次出包记录三件事——后台填多少、固件内嵌多少、是否严格大于上一版。这三列只要有一列对不上,就不许上传。

断点三:两个文件、两种用途,混搭必出错

一次出包实际会产出两份产物:

产物用途谁在用
升级包(OTA 文件)平台推给设备做升级平台
合并镜像(merge-bin)整片烧录、产线首烧烧录工具

平台那一行会同时显示两个校验值:“OTA 文件 hash”和”镜像 hash”。它们对不上,就说明你把两个不同版本的文件,填进了同一次发布。

这个坑很隐蔽:两个文件都是合法的、都能烧、都能跑,只有版本号不一样。设备升级后表现为”功能还是旧的”,你会去查代码,而问题在文件名。

修法:同一次出包同时产出两份,上传时同一次把两栏填完,版本号与内嵌版本一致。

避免复现:

  1. 出包登记表把「升级包 sha / 镜像 sha / 版本号」三列并列,任一不符不许上传
  2. 上传完,按设备的方式请求一次 OTA 接口,核对返回的版本号与下载地址——用平台自己的回答来验收,而不是用你记得的内容

断点四:版本号会”自己变回去”

现象:明明改过版本号,出包后发现号还是旧的。

判据(这条判据很关键):git status 里构建脚本是干净的——内容和版本库完全一致,但号是旧的。

这说明不是有人手改回去了,而是:

  • 编辑器里还开着这个文件的旧缓冲区,保存时把新内容覆盖了;
  • 或者一次版本控制回滚,把工作区的修改一起带走了。

判据的价值在于它排除了一种可能:文件与版本库一致、却与你记忆不一致 → 你的改动从来没有真正落盘过。这跟”有人改错了”是完全相反的结论,处置方式也不同。

修法:改完立刻复核一次,提交前再看一次,出包后从编译产物里数版本字符串的命中。

最后这一步是重点:别信文件里写的字符串,信二进制里的事实。 代码可能没编进去、编译缓存可能命中旧的,只有产物不会说谎。

避免复现:把「改号 → 复核 → 编译 → 二进制校验 → 上传」固化成五步清单。不允许”改完就去编译”这一步跳过去。

断点五:设备没有可信身份,OTA 就推不到”对的那台”

OTA 的本质是”把正确的固件,推给正确的那一台设备”。设备身份不可信,后面全都不成立。

序列号的规则要写进工具里:16 个字符、只允许大写字母/数字/下划线、末位必须是下划线。

两条激活路线,按阶段选:

路线做法适用代价
A 服务端激活设备零改动,凭序列号向平台激活试产、小批不防克隆
B 一次性存储区烧写序列号 + 密钥写进不可改的存储区,做硬件绑定量产每台多一道工序

关键约束:同一份固件不能因为选了 A 还是 B 而返工。所以固件里读身份的逻辑要一次设计到位,靠”有没有烧写”来决定走哪条分支。

密钥链上三处必须是同一把钥匙:烧写工具写进去的 ←→ 固件读出来算 HMAC 的 ←→ 服务端校验用的。这三处任意一处不一致,现象都是”激活失败”,而且不会告诉你错在哪一环。

还有一条流程细节:重复激活会报错。返修机、二次入库的设备,必须先调解绑接口,再重新激活。

避免复现:

  1. 序列号生成器内置格式断言(长度、字符集、末位),不合格不许写
  2. 产测工具把「序列号 = 机身丝印 = 后台登记」三方对账列为必过项

产线上还有两处会卡住进度

这两条不属于 OTA 逻辑,但会实实在在卡住出包节奏。

进不了下载模式。 板上 IO0 没引到调试口、也没有复位按键,就无法自动进入下载模式,只能手动把 IO0 短接 GND。IO0 一直短着的话不必反复拔插 USB——烧录工具的经典复位流程会自己拉 EN。

这件事的正确做法不是在产线上用手按:工装做一个”IO0 短接 + EN 按钮”的夹具,下一版硬件把 IO0 引到测试点并加 10 K 上拉。

端口被占用。 报 Could not open COMx: PermissionError(13)——端口在、但打不开,说明被别的进程占着。最常见的是上一次串口监视没有正常退出:直接关掉终端窗口而没有停止进程,残留的 python 进程可能不止一个。

处置:先查进程、清干净,再开一次串口自检。烧录时只写应用分区比整包烧写快约 3 倍,产线上值得改。

交付前的一张清单

把上面所有断点压成一句话:

OTA 能不能成,取决于「设备是谁、版本是多少、文件是哪一份」这三个问题,在三个系统里的答案是否一致。

所以出包前的检查表,本质上只有三块:

检查项怎么查不过怎么办
设备身份序列号格式 + 三方对账 + 激活状态不烧、不许上产线
版本对齐后台填的 / 固件内嵌的 / 上一版,三者关系严格大于才允许发布
文件对应升级包 sha、镜像 sha、版本号三列并列任一不符禁止上传

我们判断故障的顺序

  1. 定性 —— 先分清是”没推”、“推了没收到”、“收到了没装”、还是”装了没生效”
  2. 三方对齐 —— 设备自报型号 / 平台产品 / 固件内嵌版本,逐个核对
  3. 比校验值 —— 两个产物各自的 hash 分别对应哪个版本
  4. 看产物 —— 不信文件里的字符串,信编译产物里的事实
  5. 固化清单 —— 出包登记表、产测对账表,把这次的判断变成下次的流程

最后一句:OTA 的故障绝大多数不是代码写错,而是三个系统之间的信息没有对齐。 所以排查的重心不在调试器里,而在版本表、登记表和对账表上——这也是为什么”产线问题”看起来像技术问题,实际上是流程问题。

工程先看,再谈报价

项目上有卡住的地方?

硬件、固件、算法,都可以直接聊。

联系