1. 从一次 APP 跑飞说起:Keil 和 ESP-IDF 的地址配置为什么总有人翻车
OTA 升级后 APP 一启动就死机,串口吐出一串乱码,这种场景我遇到过不止一次。查到最后,问题往往不在业务代码,而在代码开发工具的地址配置上:Keil 的 IROM1 起始地址没改、Linker 页的勾选项没开,或者 ESP-IDF 的分区表里 ota_0 和 ota_1 的地址算错了。Keil 和 ESP-IDF 是嵌入式里最常用的两套代码开发工具,它们处理 APP 地址偏移的思路完全不同——一个靠 Target 对话框和分散加载,一个靠分区表 CSV。这篇文章按实际配置顺序走一遍,把地址怎么划、参数怎么填、哪里容易翻车讲清楚。适合正在做 OTA 升级、或者第一次给 APP 划独立地址空间的嵌入式开发者。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Keil 工程配置:代码开发工具里的 IROM1、Linker 页与 VTOR
2.1 地址空间划分:Bootloader 和 APP 各占哪一段
STM32 的 Flash 默认从 0x08000000 开始映射。做 OTA 时,这个起始地址通常留给 Bootloader。假设 Bootloader 占用 32KB,也就是 0x8000 字节,那么 APP1 的起始地址可以设为 0x08008000,OTA 备用分区 APP2 可以设为 0x08040000。这里有两个约束:第一,地址必须是扇区大小的整数倍;第二,APP1 的结束地址不能碰到 APP2 的起始地址。
扇区大小因芯片型号而异,常见的有 16KB、64KB、128KB。比如某款芯片的扇区是 128KB(0x20000),那 APP1 的起始地址就必须能被 0x20000 整除。0x08008000 这个地址无法被 0x20000 整除,这时要么把 Bootloader 加大到对齐,要么换一个满足对齐条件的地址。我一般会先翻芯片的 Flash 手册,把扇区边界列出来,再定分区表,而不是拍脑袋写一个 0x08008000。
地址划分不是越小越好。Bootloader 留 32KB 还是 64KB,取决于你的 Bootloader 有没有带升级协议、有没有加校验、有没有留日志区。APP2 留多大,取决于 APP 的最大体积。把这三个数定下来,APP1 的 Size 也就确定了。
还有一点容易被忽略:APP2 不要紧贴着 APP1 放。OTA 升级时,新固件先写到 APP2,校验通过后再切换启动分区。如果 APP2 和 APP1 挨得太近,APP1 的 Size 就必须卡得很死,稍微加一点功能就溢出。留出间隔是为了给 APP1 留余量,也方便以后调整分区结构。比如 APP1 从 0x08008000 开始,APP2 从 0x08040000 开始,中间就留出了 224KB,足够大多数应用固件使用。
2.2 IROM1 起始地址与大小:Target 页怎么填
打开 Keil 工程的 Options for Target(魔法棒图标),切到 Target 页,找到 IROM1 这一行。Start 填 APP 的起始地址,比如 0x08008000;Size 填 APP 可用的最大空间。这个 Size 不是随便填的,它等于 APP2 起始地址减去 APP1 起始地址。按前面的例子,0x08040000 - 0x08008000 = 0x38000,也就是 224KB。
Size 填大了,链接器会把代码放到 APP2 的地盘上,OTA 写入时直接覆盖备用分区。Size 填小了,编译到最后会报 region 溢出。我一般会在这个上限基础上再留 5% 到 10% 的余量,防止后续加功能时突然不够用。如果不确定 APP2 的起始地址,可以先把 APP2 往后放,给 APP1 留足空间,等 APP 稳定后再收紧。
这里还有一个容易忽略的点:IROM1 的 Start 只影响链接地址,不改变程序的实际烧录地址。烧录时如果用的是调试器,调试器会按 IROM1 的配置把 bin 写到对应地址;如果用的是串口 Bootloader,Bootloader 自己会把数据写到 APP 分区。两边的地址必须一致,否则程序烧进去了也跑不起来。
IROM1 的 Size 和实际 bin 文件大小是两回事。Size 是链接器允许的最大范围,bin 文件是实际编译出来的大小。编译时如果提示 region 溢出,说明代码超过了 Size,要么优化代码,要么调整分区。反过来,如果 bin 文件只有 80KB,而 Size 填了 224KB,剩下的空间并不会浪费,只是暂时没用上。我习惯在项目文档里记下每个分区的 Size 和当前 bin 大小,方便后续评估还能加多少功能。
2.3 Linker 页的勾选项:Use Memory Layout from Target Dialog
Target 页改完 IROM1 之后,还要切到 Linker 页,勾上「Use Memory Layout from Target Dialog」。这个选项决定链接器是否使用 Target 页的 IROM1 配置来生成分散加载文件。不勾的话,IROM1 改了也白改,链接出来的程序还是从默认的 0x08000000 开始。
这个坑我自己踩过。当时 Target 页的 IROM1 已经改成 0x08008000,编译也通过了,但把 bin 文件反汇编一看,起始地址还是 0x08000000。查了半天才发现 Linker 页的勾没打上。从那以后,我改完 IROM1 都会顺手看一眼 Linker 页,确认那个勾是选中的。
勾上之后,Keil 会自动根据 Target 页的配置生成分散加载文件,不需要手动写 .sct 文件。如果你有更复杂的需求,比如把某些函数放到 RAM 里运行,可以取消勾选,手动指定 scatter file。但对大多数 OTA APP 来说,勾选这个选项就够了。
还有一个细节:如果你在 Target 页改了 IROM1,但编译时没有重新生成分散加载文件,链接器可能还是用旧的配置。保险的做法是改完配置后先 Clean 再 Build,确保分散加载文件重新生成。我一般会把这一步写进项目笔记,提醒自己别偷懒。
2.4 启动文件里重映射 VTOR:代码与掩码含义
APP 的链接地址改成 0x08008000 之后,中断向量表也要跟着搬过去。Cortex-M 内核有一个 VTOR 寄存器,用来告诉内核异常向量表在哪个地址。复位后 VTOR 默认是 0x00000000,如果 APP 不重映射,中断发生时内核还是会去 0x00000000 取向量,结果就是 HardFault 或者跑飞。
在启动文件(比如 startup_stm32f407xx.s)或者 APP 的初始化代码里,加一段重映射:
c复制#define RT_APP_PART_ADDR 0x08008000 // APP 起始地址
#define NVIC_VTOR_MASK 0x3FFFFF80
SCB->VTOR = RT_APP_PART_ADDR & NVIC_VTOR_MASK; // 重映射向量表
这段代码做两件事:先把 APP 起始地址和掩码做按位与,再写进 VTOR。掩码 0x3FFFFF80 的低 7 位是 0,因为向量表要求 128 字节对齐,低 7 位用来放对齐标志;高两位是 0,保留给地址空间。按位与之后,VTOR 里存的就是一个 128 字节对齐的 APP 起始地址。
这段代码要放在使能中断之前。如果放在 main 函数的最后,前面已经有中断触发,那中断还是会走旧向量表。我一般把它放在 SystemInit 之后、main 的第一行,或者直接改在启动文件的 Reset_Handler 里。放启动文件的好处是更早生效,坏处是换芯片时要改汇编;放 main 里更通用,但要确保之前没有中断被使能。
还有一点:VTOR 的赋值不能只写 SCB->VTOR = 0x08008000; 就完事。虽然 0x08008000 本身是 128 字节对齐的,但如果你从别的地方拷贝地址,比如从参数区读出来的地址,那就必须加掩码,否则低位的垃圾数据会让向量表错位。血泪经验是:只要 VTOR 的地址不是编译期常量,就老老实实加掩码。
3. ESP-IDF 分区表:代码开发工具的 partitions.csv 怎么写
3.1 partitions.csv 的字段结构
ESP32 用分区表管理 Flash,不像 STM32 那样在 IDE 里填 IROM1。分区表是一个 CSV 文件,放在项目根目录,编译时由 ESP-IDF 的工具解析。每一行是一个分区,字段依次是 Name、Type、SubType、Offset、Size。
Name 是分区名,随便起,但要有辨识度;Type 是分区类型,常见的有 app、data;SubType 是子类型,比如 factory、ota_0、ota_1、nvs、ota;Offset 是分区起始地址,留空时由工具自动计算;Size 是分区大小,可以写数字,也可以写 1M、0x100000 这种格式。
做 OTA 时,至少要有三个关键分区:otadata 存 OTA 状态,ota_0 和 ota_1 是两个 APP 分区。otadata 用来记录当前从哪个分区启动、哪个分区是新的,ota_0 和 ota_1 轮流存放固件。factory 分区是可选的,用来放出厂固件,有些项目不用。
分区表的注释行用 # 开头,ESP-IDF 解析时会跳过。字段之间的空格和缩进不影响解析,但建议对齐着写,方便肉眼检查。我一般会把每个分区的用途写在注释里,比如 # OTA 分区 1,后面排查问题时一眼就能看懂。
3.2 ota_0、ota_1 与 otadata 的地址规则
一个能跑 OTA 的分区表示例:
csv复制# Name, Type, SubType, Offset, Size
nvs, data, nvs, 0x9000, 0x4000
otadata, data, ota, 0xd000, 0x2000
factory, app, factory, 0x10000, 1M
ota_0, app, ota_0, , 1M
ota_1, app, ota_1, , 1M
nvs 从 0x9000 开始,大小 0x4000,到 0xd000 结束。otadata 紧接着从 0xd000 开始,大小 0x2000,到 0xf000 结束。factory 从 0x10000 开始,中间留了 0x1000 的空隙,这是为了对齐。factory 大小 1M,到 0x110000 结束。ota_0 的 Offset 留空,工具会自动从 0x110000 开始分配,大小 1M,到 0x210000 结束。ota_1 同样留空,从 0x210000 开始,大小 1M,到 0x310000 结束。
这里的关键是 Offset 留空时的自动计算规则:工具会从上一个分区的结束地址开始,按 4KB 对齐,分配给当前分区。所以分区的顺序很重要。如果把 ota_1 写在 ota_0 前面,地址就会反过来。另外,otadata 必须放在 ota_0 和 ota_1 之前,否则 OTA 状态没法正确记录。
otadata 分区的大小通常是 0x2000,因为它要存两份 OTA 状态记录,每份 4KB,两份互为备份。如果 otadata 太小,OTA 状态写入失败,设备会一直从旧分区启动,表现出来就是升级完成了但版本没变。我一般会在分区表里给 otadata 留足 0x2000,不做压缩。
3.3 自动计算与手动指定的取舍
Offset 留空是最省事的做法,工具帮你算,不容易重叠。但自动计算依赖分区顺序,一旦调整顺序,所有后续分区的地址都会变。如果你有外部工具需要按固定地址读写分区,或者要和 Bootloader 的约定对齐,就得手动指定 Offset。
手动指定时要自己保证不重叠。比如 ota_0 手动写 0x110000,ota_1 手动写 0x210000,那 factory 的结束地址必须小于等于 0x110000,ota_0 的结束地址必须小于等于 0x210000。任何一个越界,编译时就会报分区表错误。我一般会先用自动计算跑一遍,看编译输出里的地址分配,确认没问题后再决定要不要改成手动。
自动计算还有一个限制:它只保证当前分区不覆盖前一个分区,但不会检查最后一个分区是否超出 Flash 容量。如果 Flash 只有 4MB,而你的分区表算出来最后一个分区的结束地址是 0x410000,编译时能过,但烧录时会报错。所以不管用自动还是手动,最后都要看一眼总大小。
3.4 编译时怎么确认分区表生效
ESP-IDF 编译时会打印分区表的分配情况,包括每个分区的名称、类型、偏移和大小。如果地址重叠或者超出 Flash 范围,编译会直接报错,不会生成固件。这是比 Keil 更省心的地方——Keil 的 IROM1 配错了,编译可能照样通过,只有运行时才暴露。
除了看编译输出,还可以用 idf.py partition-table 命令单独查看分区表。这个命令会把 CSV 解析成表格,列出每个分区的实际地址。升级前跑一遍,确认 ota_0 和 ota_1 的地址没有交叉,Size 能装下编译出来的 bin 文件。
我一般会在项目根目录放一个 partitions.csv,同时在文档里记录一份地址分配表。每次调整分区后,把新旧两版对比一下,确认没有影响到其他分区。如果项目里有多块 Flash 容量的板子,最好准备多份分区表,编译时按板子型号切换,不要用一份分区表打天下。
4. 地址配置避坑:五个从现场带回来的排查记录
4.1 扇区没对齐,擦除时把 Bootloader 擦了
现象:OTA 升级完成后设备直接变砖,连 Bootloader 都进不去,调试器也连不上。用调试器连接时读不到芯片 ID,说明芯片里的程序已经被破坏。
原因:APP 的起始地址不是扇区大小的整数倍。Bootloader 擦除 APP 分区时,是按扇区擦的,如果 APP 起始地址落在 Bootloader 的最后一个扇区里,擦除 APP 就会把 Bootloader 的尾部一起擦掉。
解决:查芯片手册的扇区划分,把 APP 起始地址调整为扇区大小的整数倍。如果 Bootloader 的大小正好不是扇区整数倍,宁可把 Bootloader 补齐到扇区边界,也不要让 APP 从中间开始。这种问题在现场很难救,只能重新烧录,所以地址对齐一定要在设计阶段就确认。
4.2 VTOR 掩码写错,中断跳飞到非法地址
现象:APP 能启动,串口能打印,但一进中断就 HardFault,而且 Fault 地址看起来毫无规律。用调试器看调用栈,发现中断服务函数根本没进去。
原因:VTOR 赋值时掩码不对,或者 RT_APP_PART_ADDR 写成了别的地址。VTOR 的低 7 位是保留的,如果不做掩码直接赋值,低位的垃圾数据会让向量表基址错位,中断跳转到非法地址。
解决:用 0x3FFFFF80 掩码,确认 RT_APP_PART_ADDR 就是 APP 的实际链接起始地址。赋值后可以读一下 SCB->VTOR,通过串口打印出来,确认和预期一致。如果打印出来是 0x08008080 而不是 0x08008000,说明掩码没加对。
4.3 Linker 页没勾选,IROM1 改了等于没改
现象:Target 页的 IROM1 已经改成 0x08008000,编译也通过了,但反汇编 bin 文件发现起始地址还是 0x08000000。烧录后 APP 能跑,但 OTA 升级时新固件写到了错误的位置。
原因:Linker 页的「Use Memory Layout from Target Dialog」没勾选,链接器没有使用 Target 页的配置,而是用了默认的分散加载文件。
解决:勾上这个选项,Clean 之后重新编译。如果勾上后编译报错,检查 IROM1 的 Size 是否够用,或者有没有和 IRAM 配置冲突。改完配置后一定要反汇编确认,不要只看编译有没有报错。
4.4 ESP-IDF 分区表地址重叠,编译报错
现象:编译时报分区表错误,提示「partition table overlaps」或者「partition exceeds flash size」。有时候错误信息指向 CSV 的某一行,但不一定准确。
原因:手动指定 Offset 时,当前分区的起始地址小于前一个分区的结束地址;或者 Size 填得太大,最后一个分区的结束地址超过了 Flash 容量。
解决:检查 partitions.csv 里每个分区的 Offset 和 Size,确保后一个分区的 Offset 大于等于前一个分区的 Offset 加 Size。用自动计算时,检查分区顺序有没有写错。如果报错信息指向不明确,可以先把 Offset 全部留空,让工具自动算一遍,看看能不能通过,再逐步改成手动。
4.5 APP 大小超过分区,OTA 写入失败
现象:OTA 升级时写入到一半报错,或者升级完成后 APP 启动不了,串口没有任何输出。设备还能进 Bootloader,但 APP 分区里的数据不完整。
原因:编译出来的 APP bin 文件超过了分区表里 ota_0 或 ota_1 的 Size。OTA 写入时只写了前面一部分,后面的数据被截断,APP 自然跑不起来。
解决:编译后看 bin 文件的实际大小,和分区表的 Size 做对比,留出至少 10% 的余量。如果确实不够,调整分区表,把 ota_0 和 ota_1 的 Size 加大,同时确保总大小不超过 Flash 容量。有些 Bootloader 会在写入前校验文件大小,超过分区大小就直接拒绝;有些没做这个校验,写到一半才失败,这时候 APP 分区里的数据是残缺的,只能重新升级。
5. 验证地址配置:map 文件、VTOR 寄存器和分区表检查
地址配置改完之后,怎么确认它真的生效了?我一般分三步走。
第一步,看 Keil 编译生成的 map 文件。map 文件里会列出每个段的加载地址和运行地址。
