GD32F405RG IAP升级实战：手把手教你用USART+DMA实现Bootloader（附完整源码）

GD32F405RG IAP升级全流程解析：从USART配置到安全跳转的工程实践

在嵌入式系统开发中，固件升级是不可或缺的功能。想象一下这样的场景：你的设备已经部署在野外或高空中，突然发现需要修复一个关键bug或增加新功能。这时候，IAP(In-Application Programming)技术就成为了救命稻草。不同于传统的通过JTAG/SWD接口烧录方式，IAP允许设备在运行状态下通过通信接口（如USART、USB、CAN等）接收新固件并完成自我更新。

今天，我们将以GD32F405RG这款高性能Cortex-M4 MCU为例，深入剖析如何构建一个稳定可靠的USART+DMA IAP解决方案。不同于市面上泛泛而谈的教程，本文会带你走过每一个关键节点，包括：

• Flash存储的精细分区策略
• DMA环形缓冲与空闲中断的完美配合
• 固件校验的安全机制
• 应用跳转前的环境检查

1. 存储规划与工程配置

1.1 Flash空间布局设计

GD32F405RG拥有1MB的Flash空间，划分为12个扇区，每个扇区大小不尽相同。合理的空间划分是IAP系统稳定性的基石。以下是我们推荐的分配方案：

在Keil MDK中，我们需要为Bootloader和Application分别创建独立的工程，并配置对应的加载地址：

Bootloader工程的分散加载文件示例：

LR_IROM1 0x08000000 0x00004000 { ; 加载区域定义 ER_IROM1 0x08000000 0x00004000 { ; 执行区域 *.o (RESET, +First) *(InRoot$$Sections) .ANY (+RO) } RW_IRAM1 0x20000000 0x00020000 { ; RAM区域 .ANY (+RW +ZI) } }

1.2 关键宏定义与头文件

为方便代码维护，我们将所有地址定义集中在iap_config.h中：

#define FLASH_BASE_ADDR 0x08000000U #define BOOTLOADER_SIZE (16 * 1024) #define APP_ADDRESS (FLASH_BASE_ADDR + BOOTLOADER_SIZE) #define BUFFER_ADDRESS 0x08080000U #define FLAG_ADDRESS 0x080FF000U // 升级标志定义 typedef enum { UPGRADE_NONE = 0, UPGRADE_REQUEST, UPGRADE_COMPLETE, UPGRADE_VERIFY_FAIL } UpgradeFlag_TypeDef;

2. 通信协议与数据接收

2.1 USART与DMA协同配置

高效的固件传输需要USART和DMA的紧密配合。我们采用DMA循环缓冲模式配合串口空闲中断，实现高可靠性的数据接收：

void USART_DMA_Config(void) { dma_parameter_struct dma_init_struct; // USART RX DMA配置 dma_deinit(DMA0, DMA_CH4); dma_init_struct.direction = DMA_PERIPHERAL_TO_MEMORY; dma_init_struct.memory_addr = (uint32_t)uart_rx_buffer; dma_init_struct.memory_inc = DMA_MEMORY_INCREASE_ENABLE; dma_init_struct.memory_width = DMA_MEMORY_WIDTH_8BIT; dma_init_struct.number = UART_RX_BUFFER_SIZE; dma_init_struct.periph_addr = (uint32_t)&USART0_DATA; dma_init_struct.periph_inc = DMA_PERIPH_INCREASE_DISABLE; dma_init_struct.periph_width = DMA_PERIPHERAL_WIDTH_8BIT; dma_init_struct.priority = DMA_PRIORITY_HIGH; dma_init_struct.circular_mode = DMA_CIRCULAR_MODE_ENABLE; // 循环模式 dma_init(DMA0, DMA_CH4, &dma_init_struct); // 使能DMA dma_channel_enable(DMA0, DMA_CH4); usart_dma_receive_config(USART0, USART_DENR_ENABLE); // 配置空闲中断 usart_interrupt_enable(USART0, USART_INT_IDLE); }

2.2 自定义简单通信协议

为保证传输可靠性，我们设计了一个简单的帧协议：

当检测到空闲中断时，我们处理接收到的数据：

void USART0_IRQHandler(void) { if(usart_interrupt_flag_get(USART0, USART_INT_FLAG_IDLE)) { usart_interrupt_flag_clear(USART0, USART_INT_FLAG_IDLE); // 获取当前DMA指针位置 uint16_t remain_cnt = dma_transfer_number_get(DMA0, DMA_CH4); uint16_t received_len = UART_RX_BUFFER_SIZE - remain_cnt; // 计算本次接收的数据长度 uint16_t new_data_len = (received_len - uart_rx_index) % UART_RX_BUFFER_SIZE; // 处理新数据 if(new_data_len > 0) { process_received_data(new_data_len); uart_rx_index = received_len; } } }

3. Flash操作与固件写入

3.1 安全的Flash擦除与写入

Flash操作需要严格遵守时序要求，特别是擦除和写入操作：

void flash_erase_buffer_sectors(void) { fmc_unlock(); // 擦除扇区8-11 for(uint8_t i = 8; i <= 11; i++) { fmc_sector_erase(FLASH_BASE_ADDR + (i * 0x10000)); while(fmc_flag_get(FMC_FLAG_BUSY)); } fmc_lock(); } uint8_t flash_write_data(uint32_t addr, uint8_t *data, uint32_t len) { if(addr < BUFFER_ADDRESS || (addr + len) > (BUFFER_ADDRESS + 512*1024)) { return 0; // 地址越界 } fmc_unlock(); uint32_t *p_data = (uint32_t*)data; len = (len + 3) / 4; // 转换为字数量 for(uint32_t i = 0; i < len; i++) { fmc_word_program(addr + i*4, p_data[i]); while(fmc_flag_get(FMC_FLAG_BUSY)); // 验证写入 if(*(uint32_t*)(addr + i*4) != p_data[i]) { fmc_lock(); return 0; } } fmc_lock(); return 1; }

3.2 固件校验机制

为确保固件完整性，我们实现双校验机制：

1. 传输校验：每帧数据包含CRC16校验
2. 整体校验：固件接收完成后计算整个镜像的CRC32

uint32_t calculate_crc32(uint32_t start_addr, uint32_t size) { uint32_t crc = 0xFFFFFFFF; uint32_t *p = (uint32_t*)start_addr; rcu_periph_clock_enable(RCU_CRC); CRC_CTL = CRC_CTL_RST; for(uint32_t i = 0; i < (size / 4); i++) { CRC_DATA = p[i]; } crc = CRC_DATA; rcu_periph_clock_disable(RCU_CRC); return crc; }

4. 应用跳转与系统启动

4.1 安全的应用程序跳转

跳转到应用程序前需要进行多项检查：

void jump_to_application(void) { typedef void (*pFunction)(void); pFunction JumpToApp; uint32_t app_stack = *(volatile uint32_t*)APP_ADDRESS; uint32_t app_reset = *(volatile uint32_t*)(APP_ADDRESS + 4); // 检查栈指针是否合法 if((app_stack & 0x2FFE0000) != 0x20000000) { return; } // 检查复位向量是否在Flash范围内 if((app_reset & 0xFF000000) != 0x08000000) { return; } // 关闭所有中断 __disable_irq(); // 设置向量表偏移 SCB->VTOR = APP_ADDRESS; // 设置栈指针 __set_MSP(app_stack); // 跳转到应用程序 JumpToApp = (pFunction)app_reset; JumpToApp(); }

4.2 Bootloader主流程

完整的Bootloader工作流程如下：

1. 初始化硬件(时钟、GPIO、USART等)
2. 检查升级标志
   • 如果有升级请求：验证固件并执行复制
   • 如果无升级请求：直接跳转应用程序
3. 进入命令接收模式
4. 根据命令执行相应操作

int main(void) { system_clock_config(); peripheral_init(); // 检查升级标志 UpgradeFlag_TypeDef flag = (UpgradeFlag_TypeDef)flash_read_byte(FLAG_ADDRESS); if(flag == UPGRADE_COMPLETE) { // 执行固件复制 if(copy_firmware() == SUCCESS) { // 清除标志 flash_write_byte(FLAG_ADDRESS, UPGRADE_NONE); } } else if(flag == UPGRADE_REQUEST) { // 等待升级 wait_for_firmware(); } // 尝试跳转到应用程序 if(check_application() == SUCCESS) { jump_to_application(); } // 进入命令模式 while(1) { handle_commands(); } }

5. 上位机协同设计与调试技巧

5.1 简易上位机设计要点

一个实用的上位机应该包含以下功能：

• 固件文件选择：支持拖放或文件对话框
• 传输进度显示：实时显示传输百分比
• 日志窗口：显示通信状态和错误信息
• 多波特率支持：自动检测或手动选择

Python示例代码片段：

import serial import crcmod class FirmwareUpdater: def __init__(self, port, baudrate=115200): self.ser = serial.Serial(port, baudrate, timeout=1) self.crc16 = crcmod.mkCrcFun(0x18005, rev=True, initCrc=0xFFFF) def send_frame(self, frame_type, seq, data): frame = bytearray() frame.append(0xAA) # 帧头 frame.extend(frame_type.to_bytes(2, 'little')) frame.extend(seq.to_bytes(2, 'little')) frame.extend(len(data).to_bytes(2, 'little')) frame.extend(data) # 计算CRC crc = self.crc16(frame) frame.extend(crc.to_bytes(2, 'little')) self.ser.write(frame) def upload_firmware(self, file_path): with open(file_path, 'rb') as f: data = f.read() total_size = len(data) chunk_size = 1024 seq = 0 # 发送开始命令 self.send_frame(CMD_START, 0, total_size.to_bytes(4, 'little')) # 分片发送 for i in range(0, total_size, chunk_size): chunk = data[i:i+chunk_size] self.send_frame(DATA_FRAME, seq, chunk) seq += 1 # 发送结束命令 self.send_frame(CMD_END, 0, b'')

5.2 常见问题排查指南

在实际开发中，你可能会遇到以下问题及解决方案：

6. 进阶优化与安全考量

6.1 性能优化技巧

• 双缓冲机制：在内存中开辟两个缓冲区，当一个缓冲区正在处理时，另一个可以继续接收数据
• 压缩传输：在上位机端对固件进行压缩，Bootloader端解压
• 差分升级：只传输有变化的部分，减少传输数据量

// 双缓冲实现示例 typedef struct { uint8_t buffer[2][1024]; volatile uint8_t active_buf; volatile uint8_t processing; } DoubleBuffer_TypeDef; void handle_double_buffer(DoubleBuffer_TypeDef *db, uint16_t len) { if(db->processing) return; db->processing = 1; uint8_t buf_idx = db->active_buf ^ 1; // 处理非活跃缓冲区数据 process_data(db->buffer[buf_idx], len); // 切换缓冲区 db->active_buf = buf_idx; db->processing = 0; }

6.2 安全增强措施

1. 固件签名验证：使用ECDSA或RSA算法验证固件来源
2. 加密传输：对固件进行AES加密后再传输
3. 防回滚机制：确保固件版本只能升级不能降级
4. 看门狗保护：防止升级过程中系统死机

// 简单的版本检查实现 typedef struct { uint32_t magic; uint32_t version; uint32_t length; uint8_t signature[64]; } FirmwareHeader_TypeDef; uint8_t verify_firmware(uint32_t addr) { FirmwareHeader_TypeDef *header = (FirmwareHeader_TypeDef*)addr; // 检查魔数 if(header->magic != 0x55AA55AA) { return 0; } // 检查版本 uint32_t current_ver = get_current_version(); if(header->version <= current_ver) { return 0; } // TODO: 验证签名 return 1; }

在完成整个IAP系统的开发后，建议进行全面的测试：

1. 功能测试：正常升级流程、断电恢复测试
2. 压力测试：大文件传输、高波特率测试
3. 异常测试：传输中断、错误固件测试
4. 长期稳定性测试：多次循环升级验证

实际项目中，我们发现DMA接收的边界条件处理最容易出现问题，特别是在缓冲区回绕时。一个实用的调试技巧是在关键节点添加调试输出，通过串口打印内部状态，这比单纯使用调试器更有利于发现时序相关的问题。