1. 项目概述为什么需要直接操作Flash寄存器做STM32开发尤其是涉及到固件升级、参数存储或者OTA功能时免不了要和片内Flash打交道。虽然HAL库和标准外设库提供了现成的函数比如HAL_FLASH_Program但很多朋友在用的时候还是会遇到各种问题擦除失败、写入的数据读出来不对、或者干脆程序跑飞。这时候如果你只会调用库函数排查问题就像在黑暗中摸索因为你根本不知道底层发生了什么。直接操作寄存器版本的意义就在这里。它不是什么“炫技”而是让你真正掌握Flash操作的底层逻辑。当你自己动手去设置每一个控制位去等待每一个状态标志你就能清晰地理解一次成功的Flash编程需要满足哪些硬件时序条件、有哪些关键状态位需要检查、以及操作不当会引发什么后果。这对于开发高可靠性的嵌入式产品尤其是对存储安全、数据完整性有严格要求的场合是至关重要的基本功。通过寄存器操作你不仅能解决问题更能预见和避免问题。2. Flash操作的核心原理与硬件机制2.1 STM32片内Flash的物理结构STM32的片内Flash可以理解为一个巨大的“电子表格”但这个表格的写入规则非常特殊。它通常按扇区Sector或页Page进行组织不同型号的STM32组织方式不同。例如STM32F1系列通常按1K或2K字节分页而STM32F4/F7系列则按扇区划分每个扇区大小从16KB到128KB不等甚至更大。最关键的一点是Flash存储器在物理特性上只能将位从“1”写成“0”而不能直接将“0”写成“1”。要想把某个存储单元从“0”变回“1”或者写入新的数据唯一的办法就是先执行一次“擦除”操作。擦除操作会将整个扇区或页的所有位一次性全部置为“1”变成0xFF。在此之后你才能对这个区域进行编程写操作将需要的位从“1”改成“0”。所以Flash操作的核心流程永远是解锁 - 擦除目标区域变为全0xFF- 编程写入数据1变0- 上锁。这个顺序绝对不能乱。2.2 关键寄存器详解要手动驱动Flash我们必须认识几个核心的寄存器。这里以STM32F1系列Cortex-M3内核的Flash接口FLASH为例其他系列原理相通寄存器名称和位定义可能略有差异。FLASH_KEYRFlash键寄存器作用用于解锁Flash控制寄存器FLASH_CR。Flash默认是上锁状态以防止误操作导致程序代码被修改。必须向该寄存器依次写入两个特定的密钥值才能解锁。关键值KEY1 0x45670123KEY2 0xCDEF89AB操作必须连续、无间隔地向FLASH_KEYR写入这两个值。如果顺序错误或中间插入了其他访问解锁都会失败。FLASH_CRFlash控制寄存器这是整个操作的大脑。所有的操作命令擦除、编程和参数页地址、并行位宽都通过设置这个寄存器的相应位来发起。关键位域PG (Bit 0): 编程使能位。置1后每次对Flash地址的写操作都会被解释为编程命令而不是普通的RAM写操作。PER (Bit 1): 页擦除使能位。置1表示准备执行页擦除操作。MER (Bit 2): 整片擦除使能位。慎用STRT (Bit 6): 开始位。在设置好PG或PER以及目标地址后将此位置1硬件才会真正开始执行编程或擦除操作。LOCK (Bit 7): 锁定位。写1可以重新锁住Flash控制寄存器。解锁后该位为0。OPTPG/OPTER: 选项字节编程/擦除位用于配置读写保护、看门狗等操作需格外小心。FLASH_SRFlash状态寄存器这是操作的眼睛。任何Flash操作进行中或完成后都必须通过查询这个寄存器来了解状态。关键状态位BSY (Bit 0): 忙标志。任何Flash操作进行时该位都为1。在操作期间必须持续查询此位直到其变为0才能进行下一步。EOP (Bit 5): 操作结束标志。当编程或擦除操作成功完成时硬件将此位置1。软件必须通过向该位写1来清除它。WRPRTERR (Bit 4) / PGERR (Bit 2): 写保护错误和编程错误标志。如果操作违反了写保护规则或编程时序这些位会被置1。出现错误后必须先清除错误标志才能进行后续操作。注意对Flash的擦写操作会暂停CPU对Flash的取指因此执行这些操作的代码必须位于RAM中或在执行期间通过其他方式确保指令流不中断。对于简单的寄存器版本代码我们通常将其放在RAM中执行或者确保操作期间没有中断访问Flash关闭全局中断。3. 寄存器版本操作全流程拆解下面我们以一个具体的例子来拆解整个过程将STM32F103C8T664KB Flash每页1KB的第50页起始地址0x0800C800擦除并写入一个32位的数据0x12345678。3.1 第一步Flash解锁序列这是所有操作的前提。如果Flash_CR的LOCK位为1任何编程或擦除操作都会被硬件忽略。// 假设 FLASH_BASE 定义为 0x40022000 #define FLASH_KEYR (*(volatile uint32_t *)(FLASH_BASE 0x04)) #define FLASH_CR (*(volatile uint32_t *)(FLASH_BASE 0x10)) #define FLASH_SR (*(volatile uint32_t *)(FLASH_BASE 0x0C)) void FLASH_Unlock(void) { // 检查是否已经解锁 if((FLASH_CR (1 7)) ! 0) { // LOCK位为1表示已上锁 FLASH_KEYR 0x45670123; // 写入密钥1 FLASH_KEYR 0xCDEF89AB; // 写入密钥2 } // 解锁后FLASH_CR的LOCK位会被硬件自动清0 }实操心得在实际项目中我习惯在系统初始化早期就执行一次解锁并在整个操作周期内保持解锁状态最后再统一上锁。频繁解锁/上锁虽然安全但会增加不必要的操作和风险。确保你的操作流程是原子的、受保护的比如关闭中断。3.2 第二步执行页擦除操作擦除是针对特定页或扇区的。FLASH_Status FLASH_ErasePage(uint32_t Page_Address) { FLASH_Status status FLASH_COMPLETE; // 1. 等待Flash不忙 while((FLASH_SR (1 0)) ! 0) { // 等待BSY位为0 // 可以加入超时机制防止死等 } // 2. 使能页擦除操作 FLASH_CR | (1 1); // 将PER位置1 // 3. 写入要擦除的页地址必须是页的起始地址 // 对于STM32F1向任意Flash地址写数据会触发擦除但规范做法是写入FLASH_AR寄存器 // 这里为简化我们直接操作。更严谨的做法是使用FLASH_AR寄存器。 // 我们通过写目标地址来触发这是一种常见做法但需查阅具体参考手册确认 // 假设我们直接操作控制逻辑更标准的做法是 // FLASH_AR Page_Address; // 设置地址寄存器 // FLASH_CR | (1 6); // 设置STRT位开始擦除 // 4. 开始擦除 FLASH_CR | (1 6); // 将STRT位置1 // 5. 等待操作完成 while((FLASH_SR (1 0)) ! 0) { // 等待BSY位为0 // 超时处理 } // 6. 检查是否成功完成 if((FLASH_SR (1 5)) ! 0) { // EOP位被置位 FLASH_SR (1 5); // 写1清除EOP标志位 status FLASH_COMPLETE; } else { // 检查错误标志 if((FLASH_SR (1 4)) ! 0) status FLASH_WRPRTERR; if((FLASH_SR (1 2)) ! 0) status FLASH_PGERR; // 清除错误标志通过写1清除 FLASH_SR | ((1 4) | (1 2)); } // 7. 关闭页擦除使能 FLASH_CR ~(1 1); // 将PER位清0 return status; }关键点解析等待BSY任何操作前和启动操作后都必须等待BSY位为0。这是Flash硬件的强制要求。STRT位这是一个“触发”位。仅仅设置PER或PG位硬件不会动作。必须在你配置好所有参数如地址后再设置STRT位操作才会真正开始。清除标志位EOP、WRPRTERR、PGERR这些标志位在置位后必须由软件写1来清除否则会影响后续的状态判断。3.3 第三步执行字编程操作擦除成功后目标页变为全0xFF现在可以写入数据了。STM32F1支持半字16位编程。FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) { FLASH_Status status FLASH_COMPLETE; // 1. 等待Flash不忙 while((FLASH_SR (1 0)) ! 0); // 2. 使能编程操作 FLASH_CR | (1 0); // 将PG位置1 // 3. 执行编程直接向目标Flash地址写入半字数据 // 这个写操作会被硬件识别为编程命令而不是普通的存储访问 *(volatile uint16_t*)Address Data; // 4. 等待操作完成 while((FLASH_SR (1 0)) ! 0); // 5. 检查是否成功完成 if((FLASH_SR (1 5)) ! 0) { FLASH_SR (1 5); // 清除EOP status FLASH_COMPLETE; } else { if((FLASH_SR (1 2)) ! 0) status FLASH_PGERR; FLASH_SR | (1 2); // 清除PGERR } // 6. 关闭编程使能 FLASH_CR ~(1 0); // 将PG位清0 return status; }为什么是半字16位这是由STM32F1的Flash内存接口宽度决定的。对于32位数据我们需要分两次写入。FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) { FLASH_Status status; status FLASH_ProgramHalfWord(Address, (uint16_t)(Data 0xFFFF)); if(status FLASH_COMPLETE) { status FLASH_ProgramHalfWord(Address 2, (uint16_t)(Data 16)); } return status; }3.4 第四步重新上锁Flash所有操作完成后为了系统安全应该重新锁住Flash。void FLASH_Lock(void) { FLASH_CR | (1 7); // 将LOCK位置1 }4. 完整代码示例与整合将上述步骤整合成一个完整的、可复用的函数集并添加超时机制增强鲁棒性。// flash_reg.h #ifndef __FLASH_REG_H #define __FLASH_REG_H #include stm32f10x.h // 包含寄存器定义 typedef enum { FLASH_BUSY 1, FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE, FLASH_TIMEOUT } FLASH_Status; void FLASH_Unlock(void); void FLASH_Lock(void); FLASH_Status FLASH_ErasePage(uint32_t Page_Address); FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data); FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data); #endif// flash_reg.c #include flash_reg.h // 超时时间可根据主频调整 #define FLASH_TIMEOUT_VALUE ((uint32_t)0x000FFFFF) /** * brief 解锁Flash */ void FLASH_Unlock(void) { if((FLASH-CR FLASH_CR_LOCK) ! RESET) { FLASH-KEYR FLASH_KEY1; FLASH-KEYR FLASH_KEY2; } } /** * brief 上锁Flash */ void FLASH_Lock(void) { FLASH-CR | FLASH_CR_LOCK; } /** * brief 等待Flash操作完成或超时 * param Timeout: 超时值 * retval FLASH_Status: 状态 */ static FLASH_Status FLASH_WaitForLastOperation(uint32_t Timeout) { FLASH_Status status FLASH_COMPLETE; uint32_t tickstart GetTick(); // 需要实现一个获取系统tick的函数 while((FLASH-SR FLASH_SR_BSY) ! RESET) { if(Timeout ! 0xFFFFFFFF) { if((GetTick() - tickstart) Timeout) { status FLASH_TIMEOUT; break; } } } if(status FLASH_COMPLETE) { if((FLASH-SR FLASH_SR_EOP) ! RESET) { FLASH-SR FLASH_SR_EOP; // 清除EOP标志 } else { if((FLASH-SR FLASH_SR_WRPRTERR) ! RESET) { status FLASH_ERROR_WRP; FLASH-SR | FLASH_SR_WRPRTERR; // 清除错误标志 } if((FLASH-SR FLASH_SR_PGERR) ! RESET) { status FLASH_ERROR_PG; FLASH-SR | FLASH_SR_PGERR; // 清除错误标志 } } } return status; } /** * brief 擦除指定页 * param Page_Address: 页起始地址必须是页对齐的 * retval FLASH_Status */ FLASH_Status FLASH_ErasePage(uint32_t Page_Address) { FLASH_Status status FLASH_COMPLETE; status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if(status FLASH_COMPLETE) { FLASH-CR | FLASH_CR_PER; // 使能页擦除 FLASH-AR Page_Address; // 设置页地址 FLASH-CR | FLASH_CR_STRT; // 开始擦除 status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); FLASH-CR ~FLASH_CR_PER; // 关闭页擦除使能 } return status; } /** * brief 写入半字数据 * param Address: 目标地址必须是半字对齐的 * param Data: 要写入的数据 * retval FLASH_Status */ FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) { FLASH_Status status FLASH_COMPLETE; status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if(status FLASH_COMPLETE) { FLASH-CR | FLASH_CR_PG; // 使能编程 *(__IO uint16_t*)Address Data; // 触发编程操作 status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); FLASH-CR ~FLASH_CR_PG; // 关闭编程使能 } return status; } /** * brief 写入字数据 * param Address: 目标地址必须是字对齐的 * param Data: 要写入的数据 * retval FLASH_Status */ FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) { FLASH_Status status; status FLASH_ProgramHalfWord(Address, (uint16_t)Data); if(status FLASH_COMPLETE) { status FLASH_ProgramHalfWord(Address 2, (uint16_t)(Data 16)); } return status; }主函数调用示例#include flash_reg.h int main(void) { // 系统初始化... uint32_t write_addr 0x0800C800; // 第50页起始地址 uint32_t test_data 0x12345678; uint32_t read_back_data; FLASH_Unlock(); // 解锁Flash if(FLASH_ErasePage(write_addr) FLASH_COMPLETE) { // 擦除成功 if(FLASH_ProgramWord(write_addr, test_data) FLASH_COMPLETE) { // 编程成功验证数据 read_back_data *(volatile uint32_t*)write_addr; if(read_back_data test_data) { // 数据验证成功 } } } FLASH_Lock(); // 操作完成重新上锁 while(1); }5. 实战中必知的注意事项与避坑指南通过寄存器操作Flash控制力强的同时责任也更大。下面是我在实际项目中踩过坑后总结出的几条铁律。5.1 中断与代码位置最大的隐形杀手问题在Flash擦写期间CPU无法从Flash取指令。如果你的擦写代码本身位于Flash中并且执行过程中发生了中断而中断服务程序ISR也位于Flash中系统就会死锁。解决方案关闭全局中断在执行关键的擦写序列从FLASH_CR设置到等待BSY结束前使用__disable_irq()关闭所有中断操作完成后再用__enable_irq()开启。将关键代码搬运到RAM中执行这是更可靠的方法。通过链接脚本将包含FLASH_ErasePage和FLASH_ProgramHalfWord等函数的代码段分配到RAM中并确保其在该函数执行前已被加载到RAM。对于STM32可以使用__attribute__((section(.RamFunc)))修饰符。__attribute__((section(.RamFunc))) FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) { // ... 函数体 }同时需要在链接脚本.ld文件中定义.RamFunc段并将其VMA运行时地址和LMA加载地址都设置为RAM地址。5.2 地址对齐与边界检查问题Flash编程对地址有严格的对齐要求。例如半字编程要求地址是2字节对齐字编程要求4字节对齐。向非对齐地址写入会导致硬件错误HardFault。解决方案在编程函数入口处增加断言检查。assert((Address 0x01) 0); // 半字编程检查最低位是否为0 // 或 assert((Address 0x03) 0); // 字编程检查低两位是否为0同样擦除的地址必须是页或扇区的起始地址。提供一个根据地址计算页起始地址的辅助函数。5.3 写保护与选项字节问题如果你要操作的Flash区域被写保护通过选项字节配置任何擦写操作都会触发WRPRTERR错误。排查步骤检查FLASH_SR寄存器中的WRPRTERR标志是否被置位。如果置位需要先修改选项字节来解除保护。注意修改选项字节会触发整个Flash的擦除操作前务必做好代码备份。操作选项字节的流程更为复杂需要严格按照参考手册的序列进行通常涉及FLASH_OPTKEYR解锁、设置FLASH_CR的OPTPG或OPTER位等。5.4 电源与时钟稳定性问题Flash操作对电源电压和时钟稳定性非常敏感。在系统电压偏低或时钟HCLK不稳定如刚切换时钟源时进行操作极易失败。建议在系统初始化完成主时钟稳定运行后再进行Flash操作。对于电池供电设备在检测到电压低于某个阈值如2.7V时应禁止Flash擦写操作。5.5 常见错误代码速查表错误现象可能原因排查方向FLASH_ERROR_PG(编程错误)1. 在非空非0xFF的地址进行编程。2. 编程时序不符合要求时钟不稳定。3. 电压不稳。1. 确保目标区域已正确擦除全为0xFF。2. 检查系统时钟配置确保在额定频率下操作。3. 测量电源电压。FLASH_ERROR_WRP(写保护错误)1. 目标扇区被选项字节写保护。2. 尝试擦写受保护的引导加载程序区域。1. 读取选项字节检查对应扇区的保护状态。2. 确认操作地址是否在用户可用区域通常0x08000000之后偏移一定地址。FLASH_TIMEOUT(操作超时)1. Flash硬件故障。2.BSY位因异常未清除罕见。3. 系统死机。1. 检查硬件连接、电源。2. 尝试系统复位后重试。3. 增加调试输出确认程序流正常。数据验证失败1. 编程未成功但未检测到错误标志罕见。2. 读取时代码优化导致。3. 缓存影响。1. 使用volatile关键字强制从内存读取数据进行验证。2. 在验证前关闭数据缓存如果MCU有。3. 单步调试查看内存窗口。6. 进阶多字节数据写入与效率优化实际项目中我们很少只写一个32位数更多的是写入一个结构体或一段数组。这里就涉及到连续写入的优化。低效做法循环调用FLASH_ProgramWord每次调用都包含完整的使能、等待、关闭流程。// 不推荐效率低下 for(i0; ilen; i4) { FLASH_ProgramWord(addri, *(uint32_t*)(data_ptri)); }高效做法在一次编程使能周期内连续写入多个半字或字。但要注意对于STM32F1在PG位置1后每次写操作必须在前一次操作完成BSY变低后进行但不需要重复开关PG位。FLASH_Status FLASH_ProgramBuffer(uint32_t Address, uint8_t *pData, uint32_t Len) { FLASH_Status status FLASH_COMPLETE; uint32_t idx 0; uint16_t halfword; status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if(status FLASH_COMPLETE) { FLASH-CR | FLASH_CR_PG; // 使能编程只做一次 while((idx Len) (status FLASH_COMPLETE)) { // 组装半字注意小端模式 halfword (uint16_t)(pData[idx1] 8) | pData[idx]; *(__IO uint16_t*)(Address idx) halfword; idx 2; // 等待本次编程完成 status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); } FLASH-CR ~FLASH_CR_PG; // 所有数据写完后关闭编程使能 } return status; }这种方式减少了大量重复的使能/关闭寄存器操作在写入大量数据时能显著提升速度。7. 不同STM32系列的差异点虽然原理相通但不同系列的STM32在Flash寄存器细节上仍有差异直接移植代码可能会出错。STM32F0/F3 (Cortex-M0/M0): 寄存器名称和位定义可能与F1类似但解锁密钥可能不同且Flash结构可能是按页组织。务必查阅对应型号的《参考手册》。STM32F4/F7/H7 (Cortex-M4/M7): Flash控制器更复杂。引入了“扇区”Sector概念大小不一16KB, 64KB, 128KB等。控制寄存器FLASH_CR中的位域更多例如有SNB扇区编号位域来选择扇区。状态寄存器FLASH_SR的错误标志也更丰富。H7系列还有独立的指令缓存和数据缓存I-Cache/D-Cache在擦写Flash后需要手动或自动维护缓存一致性否则可能读不到最新数据。双Bank架构一些大容量型号如STM32F4xx、F7xx的Flash分为两个Bank可以同时进行读和擦写操作Bank间交替以实现读写零等待。这涉及到FLASH_CR中的BANK位选择。移植建议找到目标芯片的《参考手册》找到“Flash program and erase controller”章节。重点核对解锁密钥、控制寄存器(FLASH_CR)的位定义特别是操作使能位、开始位、锁定位、状态寄存器(FLASH_SR)的标志位、以及地址寄存器是FLASH_AR还是通过写地址触发。根据Flash的物理组织页大小/扇区大小修改擦除函数。手动操作寄存器来驱动STM32的Flash就像亲手驾驭一辆高性能跑车你能感知到每一个细节但也需要对每一个操作负责。它带来的不仅仅是功能的实现更是对硬件底层深刻的理解和掌控力。当你下次再遇到Flash下载失败、IAP升级异常或者参数存储错乱的问题时希望这份详细的寄存器级指南能帮你直击要害快速定位到那个需要被正确置1或清0的控制位。
1. 项目概述为什么需要直接操作Flash寄存器做STM32开发尤其是涉及到固件升级、参数存储或者OTA功能时免不了要和片内Flash打交道。虽然HAL库和标准外设库提供了现成的函数比如HAL_FLASH_Program但很多朋友在用的时候还是会遇到各种问题擦除失败、写入的数据读出来不对、或者干脆程序跑飞。这时候如果你只会调用库函数排查问题就像在黑暗中摸索因为你根本不知道底层发生了什么。直接操作寄存器版本的意义就在这里。它不是什么“炫技”而是让你真正掌握Flash操作的底层逻辑。当你自己动手去设置每一个控制位去等待每一个状态标志你就能清晰地理解一次成功的Flash编程需要满足哪些硬件时序条件、有哪些关键状态位需要检查、以及操作不当会引发什么后果。这对于开发高可靠性的嵌入式产品尤其是对存储安全、数据完整性有严格要求的场合是至关重要的基本功。通过寄存器操作你不仅能解决问题更能预见和避免问题。2. Flash操作的核心原理与硬件机制2.1 STM32片内Flash的物理结构STM32的片内Flash可以理解为一个巨大的“电子表格”但这个表格的写入规则非常特殊。它通常按扇区Sector或页Page进行组织不同型号的STM32组织方式不同。例如STM32F1系列通常按1K或2K字节分页而STM32F4/F7系列则按扇区划分每个扇区大小从16KB到128KB不等甚至更大。最关键的一点是Flash存储器在物理特性上只能将位从“1”写成“0”而不能直接将“0”写成“1”。要想把某个存储单元从“0”变回“1”或者写入新的数据唯一的办法就是先执行一次“擦除”操作。擦除操作会将整个扇区或页的所有位一次性全部置为“1”变成0xFF。在此之后你才能对这个区域进行编程写操作将需要的位从“1”改成“0”。所以Flash操作的核心流程永远是解锁 - 擦除目标区域变为全0xFF- 编程写入数据1变0- 上锁。这个顺序绝对不能乱。2.2 关键寄存器详解要手动驱动Flash我们必须认识几个核心的寄存器。这里以STM32F1系列Cortex-M3内核的Flash接口FLASH为例其他系列原理相通寄存器名称和位定义可能略有差异。FLASH_KEYRFlash键寄存器作用用于解锁Flash控制寄存器FLASH_CR。Flash默认是上锁状态以防止误操作导致程序代码被修改。必须向该寄存器依次写入两个特定的密钥值才能解锁。关键值KEY1 0x45670123KEY2 0xCDEF89AB操作必须连续、无间隔地向FLASH_KEYR写入这两个值。如果顺序错误或中间插入了其他访问解锁都会失败。FLASH_CRFlash控制寄存器这是整个操作的大脑。所有的操作命令擦除、编程和参数页地址、并行位宽都通过设置这个寄存器的相应位来发起。关键位域PG (Bit 0): 编程使能位。置1后每次对Flash地址的写操作都会被解释为编程命令而不是普通的RAM写操作。PER (Bit 1): 页擦除使能位。置1表示准备执行页擦除操作。MER (Bit 2): 整片擦除使能位。慎用STRT (Bit 6): 开始位。在设置好PG或PER以及目标地址后将此位置1硬件才会真正开始执行编程或擦除操作。LOCK (Bit 7): 锁定位。写1可以重新锁住Flash控制寄存器。解锁后该位为0。OPTPG/OPTER: 选项字节编程/擦除位用于配置读写保护、看门狗等操作需格外小心。FLASH_SRFlash状态寄存器这是操作的眼睛。任何Flash操作进行中或完成后都必须通过查询这个寄存器来了解状态。关键状态位BSY (Bit 0): 忙标志。任何Flash操作进行时该位都为1。在操作期间必须持续查询此位直到其变为0才能进行下一步。EOP (Bit 5): 操作结束标志。当编程或擦除操作成功完成时硬件将此位置1。软件必须通过向该位写1来清除它。WRPRTERR (Bit 4) / PGERR (Bit 2): 写保护错误和编程错误标志。如果操作违反了写保护规则或编程时序这些位会被置1。出现错误后必须先清除错误标志才能进行后续操作。注意对Flash的擦写操作会暂停CPU对Flash的取指因此执行这些操作的代码必须位于RAM中或在执行期间通过其他方式确保指令流不中断。对于简单的寄存器版本代码我们通常将其放在RAM中执行或者确保操作期间没有中断访问Flash关闭全局中断。3. 寄存器版本操作全流程拆解下面我们以一个具体的例子来拆解整个过程将STM32F103C8T664KB Flash每页1KB的第50页起始地址0x0800C800擦除并写入一个32位的数据0x12345678。3.1 第一步Flash解锁序列这是所有操作的前提。如果Flash_CR的LOCK位为1任何编程或擦除操作都会被硬件忽略。// 假设 FLASH_BASE 定义为 0x40022000 #define FLASH_KEYR (*(volatile uint32_t *)(FLASH_BASE 0x04)) #define FLASH_CR (*(volatile uint32_t *)(FLASH_BASE 0x10)) #define FLASH_SR (*(volatile uint32_t *)(FLASH_BASE 0x0C)) void FLASH_Unlock(void) { // 检查是否已经解锁 if((FLASH_CR (1 7)) ! 0) { // LOCK位为1表示已上锁 FLASH_KEYR 0x45670123; // 写入密钥1 FLASH_KEYR 0xCDEF89AB; // 写入密钥2 } // 解锁后FLASH_CR的LOCK位会被硬件自动清0 }实操心得在实际项目中我习惯在系统初始化早期就执行一次解锁并在整个操作周期内保持解锁状态最后再统一上锁。频繁解锁/上锁虽然安全但会增加不必要的操作和风险。确保你的操作流程是原子的、受保护的比如关闭中断。3.2 第二步执行页擦除操作擦除是针对特定页或扇区的。FLASH_Status FLASH_ErasePage(uint32_t Page_Address) { FLASH_Status status FLASH_COMPLETE; // 1. 等待Flash不忙 while((FLASH_SR (1 0)) ! 0) { // 等待BSY位为0 // 可以加入超时机制防止死等 } // 2. 使能页擦除操作 FLASH_CR | (1 1); // 将PER位置1 // 3. 写入要擦除的页地址必须是页的起始地址 // 对于STM32F1向任意Flash地址写数据会触发擦除但规范做法是写入FLASH_AR寄存器 // 这里为简化我们直接操作。更严谨的做法是使用FLASH_AR寄存器。 // 我们通过写目标地址来触发这是一种常见做法但需查阅具体参考手册确认 // 假设我们直接操作控制逻辑更标准的做法是 // FLASH_AR Page_Address; // 设置地址寄存器 // FLASH_CR | (1 6); // 设置STRT位开始擦除 // 4. 开始擦除 FLASH_CR | (1 6); // 将STRT位置1 // 5. 等待操作完成 while((FLASH_SR (1 0)) ! 0) { // 等待BSY位为0 // 超时处理 } // 6. 检查是否成功完成 if((FLASH_SR (1 5)) ! 0) { // EOP位被置位 FLASH_SR (1 5); // 写1清除EOP标志位 status FLASH_COMPLETE; } else { // 检查错误标志 if((FLASH_SR (1 4)) ! 0) status FLASH_WRPRTERR; if((FLASH_SR (1 2)) ! 0) status FLASH_PGERR; // 清除错误标志通过写1清除 FLASH_SR | ((1 4) | (1 2)); } // 7. 关闭页擦除使能 FLASH_CR ~(1 1); // 将PER位清0 return status; }关键点解析等待BSY任何操作前和启动操作后都必须等待BSY位为0。这是Flash硬件的强制要求。STRT位这是一个“触发”位。仅仅设置PER或PG位硬件不会动作。必须在你配置好所有参数如地址后再设置STRT位操作才会真正开始。清除标志位EOP、WRPRTERR、PGERR这些标志位在置位后必须由软件写1来清除否则会影响后续的状态判断。3.3 第三步执行字编程操作擦除成功后目标页变为全0xFF现在可以写入数据了。STM32F1支持半字16位编程。FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) { FLASH_Status status FLASH_COMPLETE; // 1. 等待Flash不忙 while((FLASH_SR (1 0)) ! 0); // 2. 使能编程操作 FLASH_CR | (1 0); // 将PG位置1 // 3. 执行编程直接向目标Flash地址写入半字数据 // 这个写操作会被硬件识别为编程命令而不是普通的存储访问 *(volatile uint16_t*)Address Data; // 4. 等待操作完成 while((FLASH_SR (1 0)) ! 0); // 5. 检查是否成功完成 if((FLASH_SR (1 5)) ! 0) { FLASH_SR (1 5); // 清除EOP status FLASH_COMPLETE; } else { if((FLASH_SR (1 2)) ! 0) status FLASH_PGERR; FLASH_SR | (1 2); // 清除PGERR } // 6. 关闭编程使能 FLASH_CR ~(1 0); // 将PG位清0 return status; }为什么是半字16位这是由STM32F1的Flash内存接口宽度决定的。对于32位数据我们需要分两次写入。FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) { FLASH_Status status; status FLASH_ProgramHalfWord(Address, (uint16_t)(Data 0xFFFF)); if(status FLASH_COMPLETE) { status FLASH_ProgramHalfWord(Address 2, (uint16_t)(Data 16)); } return status; }3.4 第四步重新上锁Flash所有操作完成后为了系统安全应该重新锁住Flash。void FLASH_Lock(void) { FLASH_CR | (1 7); // 将LOCK位置1 }4. 完整代码示例与整合将上述步骤整合成一个完整的、可复用的函数集并添加超时机制增强鲁棒性。// flash_reg.h #ifndef __FLASH_REG_H #define __FLASH_REG_H #include stm32f10x.h // 包含寄存器定义 typedef enum { FLASH_BUSY 1, FLASH_ERROR_PG, FLASH_ERROR_WRP, FLASH_COMPLETE, FLASH_TIMEOUT } FLASH_Status; void FLASH_Unlock(void); void FLASH_Lock(void); FLASH_Status FLASH_ErasePage(uint32_t Page_Address); FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data); FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data); #endif// flash_reg.c #include flash_reg.h // 超时时间可根据主频调整 #define FLASH_TIMEOUT_VALUE ((uint32_t)0x000FFFFF) /** * brief 解锁Flash */ void FLASH_Unlock(void) { if((FLASH-CR FLASH_CR_LOCK) ! RESET) { FLASH-KEYR FLASH_KEY1; FLASH-KEYR FLASH_KEY2; } } /** * brief 上锁Flash */ void FLASH_Lock(void) { FLASH-CR | FLASH_CR_LOCK; } /** * brief 等待Flash操作完成或超时 * param Timeout: 超时值 * retval FLASH_Status: 状态 */ static FLASH_Status FLASH_WaitForLastOperation(uint32_t Timeout) { FLASH_Status status FLASH_COMPLETE; uint32_t tickstart GetTick(); // 需要实现一个获取系统tick的函数 while((FLASH-SR FLASH_SR_BSY) ! RESET) { if(Timeout ! 0xFFFFFFFF) { if((GetTick() - tickstart) Timeout) { status FLASH_TIMEOUT; break; } } } if(status FLASH_COMPLETE) { if((FLASH-SR FLASH_SR_EOP) ! RESET) { FLASH-SR FLASH_SR_EOP; // 清除EOP标志 } else { if((FLASH-SR FLASH_SR_WRPRTERR) ! RESET) { status FLASH_ERROR_WRP; FLASH-SR | FLASH_SR_WRPRTERR; // 清除错误标志 } if((FLASH-SR FLASH_SR_PGERR) ! RESET) { status FLASH_ERROR_PG; FLASH-SR | FLASH_SR_PGERR; // 清除错误标志 } } } return status; } /** * brief 擦除指定页 * param Page_Address: 页起始地址必须是页对齐的 * retval FLASH_Status */ FLASH_Status FLASH_ErasePage(uint32_t Page_Address) { FLASH_Status status FLASH_COMPLETE; status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if(status FLASH_COMPLETE) { FLASH-CR | FLASH_CR_PER; // 使能页擦除 FLASH-AR Page_Address; // 设置页地址 FLASH-CR | FLASH_CR_STRT; // 开始擦除 status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); FLASH-CR ~FLASH_CR_PER; // 关闭页擦除使能 } return status; } /** * brief 写入半字数据 * param Address: 目标地址必须是半字对齐的 * param Data: 要写入的数据 * retval FLASH_Status */ FLASH_Status FLASH_ProgramHalfWord(uint32_t Address, uint16_t Data) { FLASH_Status status FLASH_COMPLETE; status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if(status FLASH_COMPLETE) { FLASH-CR | FLASH_CR_PG; // 使能编程 *(__IO uint16_t*)Address Data; // 触发编程操作 status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); FLASH-CR ~FLASH_CR_PG; // 关闭编程使能 } return status; } /** * brief 写入字数据 * param Address: 目标地址必须是字对齐的 * param Data: 要写入的数据 * retval FLASH_Status */ FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) { FLASH_Status status; status FLASH_ProgramHalfWord(Address, (uint16_t)Data); if(status FLASH_COMPLETE) { status FLASH_ProgramHalfWord(Address 2, (uint16_t)(Data 16)); } return status; }主函数调用示例#include flash_reg.h int main(void) { // 系统初始化... uint32_t write_addr 0x0800C800; // 第50页起始地址 uint32_t test_data 0x12345678; uint32_t read_back_data; FLASH_Unlock(); // 解锁Flash if(FLASH_ErasePage(write_addr) FLASH_COMPLETE) { // 擦除成功 if(FLASH_ProgramWord(write_addr, test_data) FLASH_COMPLETE) { // 编程成功验证数据 read_back_data *(volatile uint32_t*)write_addr; if(read_back_data test_data) { // 数据验证成功 } } } FLASH_Lock(); // 操作完成重新上锁 while(1); }5. 实战中必知的注意事项与避坑指南通过寄存器操作Flash控制力强的同时责任也更大。下面是我在实际项目中踩过坑后总结出的几条铁律。5.1 中断与代码位置最大的隐形杀手问题在Flash擦写期间CPU无法从Flash取指令。如果你的擦写代码本身位于Flash中并且执行过程中发生了中断而中断服务程序ISR也位于Flash中系统就会死锁。解决方案关闭全局中断在执行关键的擦写序列从FLASH_CR设置到等待BSY结束前使用__disable_irq()关闭所有中断操作完成后再用__enable_irq()开启。将关键代码搬运到RAM中执行这是更可靠的方法。通过链接脚本将包含FLASH_ErasePage和FLASH_ProgramHalfWord等函数的代码段分配到RAM中并确保其在该函数执行前已被加载到RAM。对于STM32可以使用__attribute__((section(.RamFunc)))修饰符。__attribute__((section(.RamFunc))) FLASH_Status FLASH_ProgramWord(uint32_t Address, uint32_t Data) { // ... 函数体 }同时需要在链接脚本.ld文件中定义.RamFunc段并将其VMA运行时地址和LMA加载地址都设置为RAM地址。5.2 地址对齐与边界检查问题Flash编程对地址有严格的对齐要求。例如半字编程要求地址是2字节对齐字编程要求4字节对齐。向非对齐地址写入会导致硬件错误HardFault。解决方案在编程函数入口处增加断言检查。assert((Address 0x01) 0); // 半字编程检查最低位是否为0 // 或 assert((Address 0x03) 0); // 字编程检查低两位是否为0同样擦除的地址必须是页或扇区的起始地址。提供一个根据地址计算页起始地址的辅助函数。5.3 写保护与选项字节问题如果你要操作的Flash区域被写保护通过选项字节配置任何擦写操作都会触发WRPRTERR错误。排查步骤检查FLASH_SR寄存器中的WRPRTERR标志是否被置位。如果置位需要先修改选项字节来解除保护。注意修改选项字节会触发整个Flash的擦除操作前务必做好代码备份。操作选项字节的流程更为复杂需要严格按照参考手册的序列进行通常涉及FLASH_OPTKEYR解锁、设置FLASH_CR的OPTPG或OPTER位等。5.4 电源与时钟稳定性问题Flash操作对电源电压和时钟稳定性非常敏感。在系统电压偏低或时钟HCLK不稳定如刚切换时钟源时进行操作极易失败。建议在系统初始化完成主时钟稳定运行后再进行Flash操作。对于电池供电设备在检测到电压低于某个阈值如2.7V时应禁止Flash擦写操作。5.5 常见错误代码速查表错误现象可能原因排查方向FLASH_ERROR_PG(编程错误)1. 在非空非0xFF的地址进行编程。2. 编程时序不符合要求时钟不稳定。3. 电压不稳。1. 确保目标区域已正确擦除全为0xFF。2. 检查系统时钟配置确保在额定频率下操作。3. 测量电源电压。FLASH_ERROR_WRP(写保护错误)1. 目标扇区被选项字节写保护。2. 尝试擦写受保护的引导加载程序区域。1. 读取选项字节检查对应扇区的保护状态。2. 确认操作地址是否在用户可用区域通常0x08000000之后偏移一定地址。FLASH_TIMEOUT(操作超时)1. Flash硬件故障。2.BSY位因异常未清除罕见。3. 系统死机。1. 检查硬件连接、电源。2. 尝试系统复位后重试。3. 增加调试输出确认程序流正常。数据验证失败1. 编程未成功但未检测到错误标志罕见。2. 读取时代码优化导致。3. 缓存影响。1. 使用volatile关键字强制从内存读取数据进行验证。2. 在验证前关闭数据缓存如果MCU有。3. 单步调试查看内存窗口。6. 进阶多字节数据写入与效率优化实际项目中我们很少只写一个32位数更多的是写入一个结构体或一段数组。这里就涉及到连续写入的优化。低效做法循环调用FLASH_ProgramWord每次调用都包含完整的使能、等待、关闭流程。// 不推荐效率低下 for(i0; ilen; i4) { FLASH_ProgramWord(addri, *(uint32_t*)(data_ptri)); }高效做法在一次编程使能周期内连续写入多个半字或字。但要注意对于STM32F1在PG位置1后每次写操作必须在前一次操作完成BSY变低后进行但不需要重复开关PG位。FLASH_Status FLASH_ProgramBuffer(uint32_t Address, uint8_t *pData, uint32_t Len) { FLASH_Status status FLASH_COMPLETE; uint32_t idx 0; uint16_t halfword; status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); if(status FLASH_COMPLETE) { FLASH-CR | FLASH_CR_PG; // 使能编程只做一次 while((idx Len) (status FLASH_COMPLETE)) { // 组装半字注意小端模式 halfword (uint16_t)(pData[idx1] 8) | pData[idx]; *(__IO uint16_t*)(Address idx) halfword; idx 2; // 等待本次编程完成 status FLASH_WaitForLastOperation(FLASH_TIMEOUT_VALUE); } FLASH-CR ~FLASH_CR_PG; // 所有数据写完后关闭编程使能 } return status; }这种方式减少了大量重复的使能/关闭寄存器操作在写入大量数据时能显著提升速度。7. 不同STM32系列的差异点虽然原理相通但不同系列的STM32在Flash寄存器细节上仍有差异直接移植代码可能会出错。STM32F0/F3 (Cortex-M0/M0): 寄存器名称和位定义可能与F1类似但解锁密钥可能不同且Flash结构可能是按页组织。务必查阅对应型号的《参考手册》。STM32F4/F7/H7 (Cortex-M4/M7): Flash控制器更复杂。引入了“扇区”Sector概念大小不一16KB, 64KB, 128KB等。控制寄存器FLASH_CR中的位域更多例如有SNB扇区编号位域来选择扇区。状态寄存器FLASH_SR的错误标志也更丰富。H7系列还有独立的指令缓存和数据缓存I-Cache/D-Cache在擦写Flash后需要手动或自动维护缓存一致性否则可能读不到最新数据。双Bank架构一些大容量型号如STM32F4xx、F7xx的Flash分为两个Bank可以同时进行读和擦写操作Bank间交替以实现读写零等待。这涉及到FLASH_CR中的BANK位选择。移植建议找到目标芯片的《参考手册》找到“Flash program and erase controller”章节。重点核对解锁密钥、控制寄存器(FLASH_CR)的位定义特别是操作使能位、开始位、锁定位、状态寄存器(FLASH_SR)的标志位、以及地址寄存器是FLASH_AR还是通过写地址触发。根据Flash的物理组织页大小/扇区大小修改擦除函数。手动操作寄存器来驱动STM32的Flash就像亲手驾驭一辆高性能跑车你能感知到每一个细节但也需要对每一个操作负责。它带来的不仅仅是功能的实现更是对硬件底层深刻的理解和掌控力。当你下次再遇到Flash下载失败、IAP升级异常或者参数存储错乱的问题时希望这份详细的寄存器级指南能帮你直击要害快速定位到那个需要被正确置1或清0的控制位。
)
