STM32外部Flash编程与Keil MDK算法开发指南
1. STM32外部Flash编程基础解析
在嵌入式系统开发中，外部Flash存储器扩展已成为应对大容量存储需求的常见解决方案。当STM32微控制器的内部Flash容量不足以容纳应用程序代码或数据资源时，外部Flash器件通过SPI、Quad-SPI或Octo-SPI等接口为系统提供额外的非易失性存储空间。
1.1 为什么需要外部Flash编程
现代嵌入式应用对存储空间的需求日益增长，特别是在以下场景：
- 图形界面应用需要存储大量图片、字体资源
- 音频处理系统需要保存音效样本和语音提示
- 物联网设备需要OTA升级固件和存储历史数据
- 工业设备需要保存参数配置和日志记录
以STM32F769 Discovery开发板为例，其板载MX25L51245G NOR Flash容量达64MB，远超芯片内部2MB的Flash容量。通过Quad-SPI接口连接后，该外部Flash可被映射到MCU的地址空间（0x90000000开始），实现类似内部存储器的访问体验。
1.2 外部Flash编程的特殊挑战
与内部Flash编程相比，外部Flash操作存在几个关键差异点：
- 接口初始化：需要正确配置SPI/QSPI接口的时钟、引脚和通信参数
- 命令协议：不同厂商的Flash芯片有各自的操作命令集
- 时序要求：擦除和编程操作有严格的超时限制
- 内存映射：需要特殊配置才能实现XIP（就地执行）功能
提示：NOR Flash与NAND Flash在编程方式上有本质区别。NOR Flash支持按字节编程和随机访问，而NAND Flash需要按页操作。本文以NOR Flash为例说明。
2. Keil MDK中的Flash编程机制
2.1 FLM文件工作原理
Keil MDK通过Flash编程算法（FLM文件）实现对存储器的编程操作。其工作流程可分为三个阶段：
算法加载阶段：
- MDK将FLM文件内容加载到目标MCU的RAM中
- 初始化算法所需的栈空间和全局变量
- 建立与调试器的通信通道
操作执行阶段：
// 典型算法接口函数 int Init(unsigned long adr, unsigned long clk, unsigned long fnc); int EraseSector(unsigned long adr); int ProgramPage(unsigned long adr, unsigned long sz, unsigned char *buf);结果验证阶段：
- 校验写入数据的正确性
- 恢复目标系统状态
- 返回操作状态给MDK界面
2.2 标准Flash算法模板分析
CMSIS-Pack提供的算法模板包含以下关键文件：
FlashDev.c：定义Flash器件参数（名称、容量、页大小等）FlashPrg.c：实现算法接口函数（Init/UnInit/Erase/Program等）Target.lin：链接脚本控制代码和数据在RAM中的布局
以MX25L51245G为例的FlashDev.c配置：
struct FlashDevice const FlashDevice = { FLASH_DRV_VERS, // 驱动版本 "MX25L51245G", // 器件名称 EXTSPI, // 接口类型 0x90000000, // 映射地址 0x04000000, // 容量(64MB) 0x00001000, // 编程页大小(4KB) 0x00, // 保留 0xFF, // 擦除后值 10000, // 页编程超时(ms) 10000, // 扇区擦除超时(ms) 0x1000, 0x000000, // 扇区大小4KB SECTOR_END };3. Quad-SPI接口配置实战
3.1 STM32CubeMX配置要点
使用STM32CubeMX配置Quad-SPI接口时需特别注意以下参数：
时钟配置：
- 确保QSPI时钟不超过Flash器件支持的最大频率
- 在Clock Configuration中检查APB2时钟分频设置
引脚映射：
- CLK：时钟信号（必须正确分配到指定引脚）
- BK1_IO0：数据线0（MOSI）
- BK1_IO1：数据线1（MISO）
- BK1_IO2：数据线2（双向）
- BK1_IO3：数据线3（双向）
- NCS：片选信号（低电平有效）
参数设置：
- Flash Size：地址线宽度（24位对应16MB）
- Chip Select High Time：保持时间
- Clock Mode：模式0或模式3
- Sample Shifting：半周期采样偏移
注意：错误的时钟极性(CPOL)和相位(CPHA)设置会导致通信失败。建议先使用SPI模式验证基本读写功能，再切换到QSPI模式。
3.2 QSPI驱动代码移植
ST官方提供的QSPI驱动需要做以下关键修改：
- 内存映射模式使能函数：
void CSP_QSPI_EnableMemoryMappedMode(void) { QSPI_CommandTypeDef s_command; s_command.InstructionMode = QSPI_INSTRUCTION_1_LINE; s_command.Instruction = 0xEB; // Fast Read Quad I/O s_command.AddressMode = QSPI_ADDRESS_4_LINES; s_command.AddressSize = QSPI_ADDRESS_24_BITS; s_command.AlternateByteMode = QSPI_ALTERNATE_BYTES_NONE; s_command.DataMode = QSPI_DATA_4_LINES; s_command.DummyCycles = 6; s_command.DdrMode = QSPI_DDR_MODE_DISABLE; s_command.DdrHoldHalfCycle = QSPI_DDR_HHC_ANALOG_DELAY; s_command.SIOOMode = QSPI_SIOO_INST_EVERY_CMD; if (HAL_QSPI_MemoryMapped(&hqspi, &s_command) != HAL_OK) { Error_Handler(); } }- 中断处理优化：
void HAL_QSPI_IRQHandler(QSPI_HandleTypeDef *hqspi) { /* 防止中断嵌套导致死锁 */ if(__get_PRIMASK() != 1) { __disable_irq(); HAL_NVIC_DisableIRQ(QUADSPI_IRQn); } /* 标准中断处理流程 */ // ... /* 恢复中断状态 */ if(__get_PRIMASK() != 1) { HAL_NVIC_EnableIRQ(QUADSPI_IRQn); __enable_irq(); } }4. Flash编程算法开发详解
4.1 关键函数实现要点
初始化函数(Init)：
- 配置QSPI外设时钟
- 初始化GPIO和QSPI接口
- 验证Flash器件ID
- 使能写操作（发送WREN命令）
擦除函数(EraseSector)：
- 发送扇区擦除命令（通常为0x20或0xD8）
- 等待擦除完成（轮询WIP位）
- 处理超时情况
典型擦除实现：
int EraseSector(unsigned long adr) { QSPI_CommandTypeDef s_command; uint32_t timeout = FlashDevice.EraseTimeout; /* 计算物理扇区地址 */ adr -= FlashDevice.DevAdr; /* 发送写使能 */ if(WriteEnable() != 0) return 1; /* 配置擦除命令 */ s_command.Instruction = SECTOR_ERASE_CMD; s_command.Address = adr; // ...其他参数配置 if(HAL_QSPI_Command(&hqspi, &s_command, timeout) != HAL_OK) return 1; /* 等待擦除完成 */ return WaitForWriteComplete(timeout); }- 页编程函数(ProgramPage)：
- 限制编程大小不超过页边界
- 使用Quad Page Program命令(通常为0x32或0x38)
- 实现双缓冲提高编程效率
4.2 调试技巧与问题排查
开发过程中常见问题及解决方法：
算法加载失败：
- 检查RAM大小是否足够（至少保留64KB）
- 验证链接脚本中的栈和堆设置
- 确保没有使用需要初始化的全局变量
通信超时：
# 使用逻辑分析仪检查的信号线： - CLK是否有时钟输出 - NCS是否正常拉低 - IO线在指令阶段是否有数据变化数据校验错误：
- 检查Flash供电电压是否稳定
- 降低QSPI时钟频率测试
- 验证Dummy Cycle数量是否符合器件要求
调试时可添加诊断输出：
#define DEBUG_MSG(fmt, ...) \ do { \ if(dbg_uart != NULL) \ HAL_UART_Transmit(dbg_uart, (uint8_t *)fmt, strlen(fmt), 100); \ } while(0) extern UART_HandleTypeDef *dbg_uart; int Init(unsigned long adr, unsigned long clk, unsigned long fnc) { DEBUG_MSG("Initializing QSPI at address 0x%08lX\r\n", adr); // ... }5. 工程集成与优化实践
5.1 内存映射配置策略
在Keil MDK中有两种方式管理外部Flash内存区域：
Target选项配置法：
- 在Options for Target → Target页面
- 添加ROM区域指定起始地址和大小
- 设置默认执行区域和启动区域
分散加载文件(Scatter File)：
LR_IROM1 0x08000000 0x00200000 { ; 内部Flash ER_IROM1 0x08000000 0x00200000 { *.o (RESET, +First) *(InRoot$$Sections) startup_stm32f769xx.o (+RO) } RW_IRAM1 0x20000000 0x00080000 { ; SRAM .ANY (+RW +ZI) } } LR_ROM2 0x90000000 0x04000000 { ; 外部Flash ER_ROM2 0x90000000 0x04000000 { graphic_resources.o (+RO) font_library.o (+RO) } }
5.2 性能优化技巧
QSPI时钟优化：
- 逐步提高时钟频率直到出现通信错误
- 在高温和低温环境下验证稳定性
- 考虑使用DDR模式提升吞吐量
双Bank交替编程：
// 利用Flash的Bank架构实现并行操作 void DualBankProgram(uint32_t addr1, uint8_t *data1, uint32_t addr2, uint8_t *data2, uint32_t size) { WriteEnable(); StartProgram(addr1, data1, size/2, BANK1); StartProgram(addr2, data2, size/2, BANK2); WaitForBothComplete(); }缓存预取优化：
- 在SystemInit()中启用ART Accelerator
- 配置SCB->CPACR启用FPU
- 使用__attribute__((section(".ccmram")))将关键代码放入CCM RAM
6. 高级应用：XIP与代码执行
6.1 就地执行(XIP)实现
要使外部Flash中的代码能够直接执行，需要：
在启动文件中初始化QSPI内存映射模式：
Reset_Handler: /* 初始化QSPI接口 */ bl SystemInit /* 启用内存映射模式 */ bl MX_QUADSPI_Init bl CSP_QSPI_EnableMemoryMappedMode /* 跳转到main函数 */ bl main修改向量表偏移寄存器：
SCB->VTOR = VECT_TABLE_BASE_ADDRESS | VECT_TABLE_OFFSET;确保关键中断服务程序保留在内部Flash：
ER_IROM1 0x08000000 { startup_stm32f7xx.o (+RO) stm32f7xx_it.o (+RO) system_stm32f7xx.o (+RO) }
6.2 混合存储策略
合理的代码/数据分布方案：
| 存储区域 | 内容类型 | 优点 |
|---|---|---|
| 内部Flash | 中断向量表、启动代码 | 确保系统可靠启动 |
| 实时性要求高的ISR | 低延迟执行 | |
| QSPI驱动初始化代码 | 内存映射前可用 | |
| 外部Flash | 图形资源、字体库 | 大容量存储 |
| 非关键业务逻辑 | 释放内部空间 | |
| 历史数据记录 | 扩展存储能力 | |
| CCM RAM | 实时控制算法 | 零等待周期访问 |
| SRAM | 动态内存分配区 | 高速读写 |
7. 生产编程考虑
7.1 批量烧录方案
使用J-Flash工具：
- 创建包含内部和外部Flash的合并映像
- 通过J-Link Commander脚本实现自动化
// 示例J-Link脚本 device STM32F769NI speed 4000 loadfile internal.bin 0x08000000 loadfile external.bin 0x90000000 verifybin internal.bin 0x08000000 verifybin external.bin 0x90000000 exitSTM32CubeProgrammer集成：
- 配置外部Loader到
Programmers/ExternalLoader目录 - 使用CLI模式实现产线自动化
STM32_Programmer_CLI -c port=SWD -d combined.hex -v- 配置外部Loader到
7.2 固件安全措施
写保护配置：
void ConfigureWriteProtection(void) { QSPI_CommandTypeDef s_command; uint8_t reg[2]; /* 读取状态寄存器 */ s_command.Instruction = READ_STATUS_REG_CMD; // ...其他参数 HAL_QSPI_Command(&hqspi, &s_command, HAL_QPSI_TIMEOUT_DEFAULT_VALUE); HAL_QSPI_Receive(&hqspi, reg, HAL_QPSI_TIMEOUT_DEFAULT_VALUE); /* 设置块保护位 */ reg[1] |= 0x3C; // 保护部分区域 WriteStatusRegister(reg); }加密存储方案：
- 使用STM32的硬件加密引擎(AES)
- 在编程前对固件进行加密
- 运行时动态解密到RAM执行
8. 常见问题速查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 算法加载失败 | RAM空间不足 | 增加算法的RAM分配大小 |
| 栈溢出 | 调整启动文件中的栈大小 | |
| 擦除超时 | 写使能未成功 | 检查WREN命令执行情况 |
| 块保护位使能 | 发送WRDI命令解除保护 | |
| 编程验证错误 | 电压不稳定 | 检查电源滤波电容 |
| 时序不满足 | 降低时钟频率或增加dummy | |
| 内存映射后读取错误 | 缓存一致性问题 | 清理数据缓存 |
| 未正确配置MPU | 设置MPU保护属性 | |
| 代码在外部Flash执行失败 | 未启用预取指 | 配置ART加速器 |
| 中断响应延迟 | 关键ISR移到内部Flash |
在实际项目中验证，外部Flash编程算法的稳定性与硬件设计密切相关。特别是QSPI信号线的走线质量会直接影响最高可用时钟频率。建议在PCB设计阶段就保持信号线等长，并预留终端匹配电阻位置。