MCU开发中一种简易Bootloader IAP升级
借助Xmodem-1K 协议通过串口传输固件.bin,本质上为有限状态机,无包序号,一个数据包校验一次CRC再写入flash。升级失败或者固件无效,打开救砖模式可重新烧录。
- C
- Bootloader
- IAP

STM32H7 串口 IAP Bootloader
基于 STM32H7 HAL 库的串口 Bootloader(IAP),配套 Python 上位机(图形界面 / 命令行),
通过串口 + Xmodem-1K 协议把 bin 固件写入 Flash 的应用区并跳转执行。
功能特性
- 串口 Xmodem-1K 协议收发,逐包
ACK/NAK应答。 - 每包 8 位累加和校验(CRC16 分支已实现,当前上位机未使用)。
- 收到握手命令后一次性擦除应用区,再流式写入,写入过程无需二次擦除。
- 上电超时等待握手,超时后校验应用区并自动跳转 APP(支持正常运行不经 Bootloader)。
- 写入完成后校验栈指针、复位向量与 Flash 非空,通过后才跳转。
- 跳转前关闭中断、复位外设与 RCC,重新设置
MSP与SCB->VTOR。 - 上位机支持普通模式与「救砖模式」(自动重新枚举串口后重连烧录)。
- 烧录完成后可继续监听 MCU 串口日志。
目录结构
| 路径 | 说明 |
|---|---|
boot.c / boot.h | 主流程:握手、Xmodem 接收、应用校验与跳转、外设反初始化 |
stmflash.c / stmflash.h | STM32H7 Flash 扇区擦除、按 32 字节 FLASHWORD 写入、读取 |
Uart.c / Uart.h | DMA + IDLE 空闲中断的分块环形接收缓冲、阻塞式 UART_Printf |
py/GUI/1.py | PyQt6 图形上位机源码(DW-MCU固件更新 V2.0.exe 为其打包版本) |
py/shell/Updata.py | 命令行上位机,协议与 GUI 一致 |
Flash 布局
| 区域 | 地址范围 | 大小 | 说明 |
|---|---|---|---|
| Bootloader | 0x08000000 – 0x0801FFFF | 128 KiB(Bank1 Sector0) | 本工程 |
| 应用固件 | 0x08020000 – 0x080FFFFF | 896 KiB(Sector1–Sector7) | 上位机写入的目标 |
应用区起始地址由 boot.h 中的 APP_ADDRESS 决定;升级时擦除长度为 7 × 128 KiB,
即 0x08020000 – 0x08100000。若实际固件更大或 Flash 划分不同,需同步修改
APP_ADDRESS、擦除长度以及应用工程的链接脚本(代码中的日志串 Erasing 812K...
仅为历史提示文本)。
通信协议
串口参数:115200 8N1(可提高,见「上位机使用」),无硬件流控。
1. 握手
- MCU 上电后进入
Boot_Update(),打印Wait_Connect.,并在约Update_Timeout × 50 ms(默认 500 ms)内轮询接收缓冲。 - 上位机每隔约 100 ms 发送一次 10 字节 ASCII 命令
BootUpdate,直到收到就绪应答。 - MCU 收到长度正好为 10 且内容为
BootUpdate的数据帧后,擦除应用区并打印Erase done, waiting host,随后发送单字节C(0x43)表示可以开始传输。 MCU 同时把收到的数据帧整包丢弃,不写入 Flash。 - 如果超时未收到握手命令:校验应用区(见下)有效则直接跳转 APP,
否则打印
App invalid, update mode并进入升级流程。
2. 数据帧(Xmodem-1K)
| 字段 | 长度 | 内容 |
|---|---|---|
| 起始字节 | 1 | STX = 0x02(1024 字节数据包) |
| 包序号 | 1 | 上位机递增(1 起,回绕到 1,跳过 0) |
| 包序号取反 | 1 | 0xFF - 序号 |
| 数据 | 1024 | 固件内容;最后一包不足 1024 时用 0x1A 填充 |
| 校验 | 1 | 数据部分 8 位累加和 |
MCU 校验通过后调用 Flash_WriteData() 写入 APP_ADDRESS + 已写入长度,成功回 ACK
(0x06),失败或校验不通过回 NAK (0x15)。接收缓冲按 IDLE 空闲中断分块,
因此每帧一定落在独立的 Data_Block 中,帧边界不会串扰。
3. 结束
固件发送完毕后上位机发送单字节 EOT(0x04);MCU 回 ACK,打印
Transfer done, verifying,校验应用区后跳转 APP;校验失败则打印 invalid! retry
并返回。
应用区有效性校验
Bootloader_CheckAppValid() 依次检查:
- 栈顶指针位于
0x20000000–0x24080000(DTCM + AXI SRAM 范围)内; - 复位向量高字节为
0x08(即位于 Flash 地址空间); - 前 8 个字不全为
0xFFFFFFFF(Flash 未被擦空)。
上位机使用
两者协议完全一致,可按环境选择。依赖:python -m pip install pyserial(GUI 另需 PyQt6)。
命令行
python py/shell/Updata.py --list-ports
python py/shell/Updata.py -p COM3 -f Debug/H7_LTC.bin
python py/shell/Updata.py -p COM3 -f app.bin -b 921600 --monitor
python py/shell/Updata.py -p COM3 -f app.bin --rescue
常用参数:
| 参数 | 说明 |
|---|---|
-p / --port | 串口名,如 COM3、/dev/ttyUSB0 |
-f / --file | 固件 bin 路径(也可作为位置参数传入) |
-b / --baudrate | 波特率,默认 115200 |
--mode / --rescue | normal(默认)或 rescue(救砖模式) |
--reconnect-timeout | 救砖模式等待串口重连超时,默认 30 s |
--ack-timeout | 等待单包 ACK / NAK 超时,默认 10 s |
--monitor | 烧录成功后保持串口打开并持续输出 MCU 日志 |
--list-ports | 列出可用串口后退出 |
图形界面
运行 python py/GUI/1.py,或直接使用打包好的 py/GUI/DW-MCU固件更新 V2.0.exe:
选择 bin 固件与串口,可选波特率 115200 / 921600 / 1500000,点击「开始烧录」。
界面同时显示上位机日志与 MCU 日志,并展示进度。
模式说明
- 普通模式:按当前串口直接打开并握手,适用于设备已在运行、可直接串口连接的场景。
- 救砖模式:先记录串口属性(设备名、序列号、VID/PID、位置),随后提示对设备重新上电, 检测到串口重新枚举后自动打开并开始烧录。适用于 APP 损坏仍能进入 Bootloader 的场景。
固件格式
必须是纯二进制 bin(Keil fromelf --bin 或
arm-none-eabi-objcopy -O binary),且链接时起始地址为 0x08020000,
同时应用工程需把中断向量表偏移设置到 0x08020000(或在启动时设置 SCB->VTOR)。
集成到工程
- 把
boot.c/h、stmflash.c/h、Uart.c/h加入工程(依赖 STM32H7 HAL 与main.h)。 main.h中需存在huart4与hdma_uart4_rx;Uart.h通过Debug_UART/Debug_UART_RXDMA宏绑定所使用的串口与 DMA 通道。- CubeMX 配置:UART4
115200 8N1,开启 UART 全局中断与 IDLE 中断, 为 RX 添加 DMA 通道。 - 中断接法:在 UART4 中断服务函数中先调用
HAL_UART_IRQHandler(&huart4), 再判断 IDLE 标志位并调用UART_IDLECallback(&huart4, &hdma_uart4_rx, &Debug_RxControlBlock);(该回调会停止 DMA、按CNDTR计算本次接收长度、提交数据块,并重启 DMA 接收)。 - 初始化完成后依次调用
UART_Int();与Boot_Update();。
关键实现细节
- 接收环形缓冲:
Rx_Block_Num(10)×Rx_Max(1050)字节;RxData_In/RxData_Out为生产者 / 消费者指针,RXControlBK_TB()由应用侧消费后推进RxData_Out, 回绕到缓冲区头部时清空整块缓冲。 - Flash 写入以 32 字节
FLASH_TYPEPROGRAM_FLASHWORD为单位,使用FLASH_VOLTAGE_RANGE_3。 - 编程缓冲区
flash_prog_buf必须是 32 字节对齐且位于 AXI SRAM:STM32H7 的 Flash 编程控制器无法访问 DTCM,因此不能使用栈上缓冲(代码中有明确注释)。 - 擦除按扇区进行,
GetSector()同时处理 Bank1 与 Bank2 的地址到扇区映射,Banks字段依据地址是否 ≥0x08100000选择。 - 跳转前执行
__disable_irq()、HAL_SuspendTick()、关闭 GPIO/DMA/USART 时钟、 清空NVIC->ICER/ICPR、HAL_RCC_DeInit(),再设置VTOR/MSP并跳转。 UART_Printf()为阻塞式发送,MCU 日志为明文;上位机在解析日志时会剔除ACK/NAK字节,并兼容可选的(log)行前缀。
已知限制与注意事项
- 握手应答
C只发送一次:若上位机在擦除期间丢失该字节,需复位设备重新握手。 - Xmodem 接收循环没有超时保护:链路中断后 Bootloader 会一直停留在升级流程, 需要复位 / 重新上电恢复。
- MCU 不校验包序号,也不做重复包与重传处理;上位机在收到
NAK或等待ACK超时后即终止本次烧录,不自动重传。 - 当前上位机使用 8 位累加和校验(
STX+ 1 字节校验),Bootloader 中的 CRC16 分支未被启用;若要启用需同时修改上位机。 - 代码未对 DMA 接收缓冲区做 D-Cache 失效处理(
SCB_InvalidateDCache_by_Addr已被注释)。若开启 D-Cache,建议把接收缓冲区放在不可缓存区域(MPU 配置为 Non-cacheable)或关闭 D-Cache,否则可能读到过期数据。 - 应用区按整片擦除后再流式写入,中途掉电会得到不完整固件,需重新烧录。

