返回项目列表
精选已发布更新于 2026-09-23

MCU开发中一种简易Bootloader IAP升级

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

  • C
  • Bootloader
  • IAP
MCU开发中一种简易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.hSTM32H7 Flash 扇区擦除、按 32 字节 FLASHWORD 写入、读取
Uart.c / Uart.hDMA + IDLE 空闲中断的分块环形接收缓冲、阻塞式 UART_Printf
py/GUI/1.pyPyQt6 图形上位机源码(DW-MCU固件更新 V2.0.exe 为其打包版本)
py/shell/Updata.py命令行上位机,协议与 GUI 一致

Flash 布局

区域地址范围大小说明
Bootloader0x08000000 – 0x0801FFFF128 KiB(Bank1 Sector0)本工程
应用固件0x08020000 – 0x080FFFFF896 KiB(Sector1–Sector7)上位机写入的目标

应用区起始地址由 boot.h 中的 APP_ADDRESS 决定;升级时擦除长度为 7 × 128 KiB, 即 0x08020000 – 0x08100000。若实际固件更大或 Flash 划分不同,需同步修改 APP_ADDRESS、擦除长度以及应用工程的链接脚本(代码中的日志串 Erasing 812K... 仅为历史提示文本)。

通信协议

串口参数:115200 8N1(可提高,见「上位机使用」),无硬件流控。

1. 握手

  1. MCU 上电后进入 Boot_Update(),打印 Wait_Connect.,并在约 Update_Timeout × 50 ms (默认 500 ms)内轮询接收缓冲。
  2. 上位机每隔约 100 ms 发送一次 10 字节 ASCII 命令 BootUpdate,直到收到就绪应答。
  3. MCU 收到长度正好为 10 且内容为 BootUpdate 的数据帧后,擦除应用区并打印 Erase done, waiting host,随后发送单字节 C(0x43)表示可以开始传输。 MCU 同时把收到的数据帧整包丢弃,不写入 Flash。
  4. 如果超时未收到握手命令:校验应用区(见下)有效则直接跳转 APP, 否则打印 App invalid, update mode 并进入升级流程。

2. 数据帧(Xmodem-1K)

字段长度内容
起始字节1STX = 0x02(1024 字节数据包)
包序号1上位机递增(1 起,回绕到 1,跳过 0)
包序号取反10xFF - 序号
数据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 / --rescuenormal(默认)或 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)。

集成到工程

  1. 把 boot.c/h、stmflash.c/h、Uart.c/h 加入工程(依赖 STM32H7 HAL 与 main.h)。
  2. main.h 中需存在 huart4 与 hdma_uart4_rx;Uart.h 通过 Debug_UART / Debug_UART_RXDMA 宏绑定所使用的串口与 DMA 通道。
  3. CubeMX 配置:UART4 115200 8N1,开启 UART 全局中断与 IDLE 中断, 为 RX 添加 DMA 通道。
  4. 中断接法:在 UART4 中断服务函数中先调用 HAL_UART_IRQHandler(&huart4), 再判断 IDLE 标志位并调用 UART_IDLECallback(&huart4, &hdma_uart4_rx, &Debug_RxControlBlock); (该回调会停止 DMA、按 CNDTR 计算本次接收长度、提交数据块,并重启 DMA 接收)。
  5. 初始化完成后依次调用 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,否则可能读到过期数据。
  • 应用区按整片擦除后再流式写入,中途掉电会得到不完整固件,需重新烧录。

其他项目