简介这份资源面向使用STM32L4xx系列MCU进行底层开发的嵌入式工程师聚焦内部FLASH的读写与擦除操作采用LL库并直接操作寄存器实现已在STM32L452RET6芯片上调试通过由于核心是寄存器配置改用HAL库时只需调整相关定义即可复用适合希望理解FLASH编程底层机制、摆脱库函数黑盒的开发者参考。压缩包共2个文件包含1个c源文件与1个h头文件分别承载FLASH读写擦除的具体实现与接口声明整体仅2KB代码精简、便于直接嵌入工程。资源已有1935人学习下载具备一定的实践验证基础。作者还补充了在STM32L471VETx上的调试经验因FLASH页码不连号导致擦页失败需修改擦页函数中的页码号并提示该代码不适用于STM32L4x1系列需自行调整擦页逻辑这一排错思路对跨型号移植尤具参考价值。1. 拿到 STM32L4xx 内部 FLASH 读写包先别急着烧板子做低功耗项目的人迟早会撞上一个需求设备断电重启后几个标定参数、运行计数、故障码还得在。外挂 EEPROM 要加料加钱铁电贵得离谱最后往往回到 MCU 自己的内部 FLASH 上。STM32L4xx 这颗片子内部 FLASH 结构比 F1 那代复杂不少双 bank、页粒度 2KB、带 ECC、擦除按页走、写入还分双字对齐稍不注意就是 HardFault 或者读出来全是 0xFF。这个压缩包给的就是一套能直接落地的读写实现走的是 LL 库加寄存器操作的路子不依赖 HAL 那套厚重封装适合对代码体积和时序敏感的场景。它解决的核心问题很具体在 L4 上安全地擦一页、写一段、读回来校验并且把解锁、等待 BSY、清标志这些容易翻车的动作收进函数里。适合谁手上有 L4 板子、要存少量非易失参数、又不想被 HAL_FLASH 的抽象层绕晕的嵌入式开发者。下面按「结构怎么理解 → 代码怎么跑 → 坑在哪」的顺序拆。2. STM32L4xx FLASH 结构双 bank、页粒度与 ECC 的约束2.1 为什么 L4 的 FLASH 不能照搬 F1 的写法F1 时代大家习惯按「半字写、扇区擦」地址算一算就下手。L4 换了一套规则FLASH 被切成两个 bank每个 bank 又按 2KB 一页划分擦除最小单位就是页没有更细的选项。更关键的是 L4 带 ECC 校验写入必须以双字64 位为单位对齐你写一个字节它也会把整个双字所在区域当成一次编程操作如果这个双字之前已经被写过而没擦ECC 就会报错读出来直接触发总线错误。这就是很多人第一次在 L4 上写 FLASH 就进 HardFault 的根因。所以选型上这份资源用 LL 库而不是 HAL不是为了炫技是因为 LL 的LL_FLASH_Unlock、LL_FLASH_ErasePage、LL_FLASH_Program这些函数直接对应寄存器动作等待 BSY 的时机你能自己控出问题也好定位。HAL 的HAL_FLASH_Program内部封装了错误回调反而把「到底哪一步失败」藏起来了。2.2 页地址怎么算、哪些页能碰L4 的 FLASH 起始地址是0x08000000页大小 2KB所以第 n 页的起始地址就是0x08000000 n * 0x800。双 bank 的划分取决于具体型号和选项字节配置常见做法是把参数区放在最后一个 bank 的末尾几页避开代码区。这里有个血泪经验别把参数页紧挨着代码段末尾放因为编译器一优化、代码一膨胀链接器可能就把你的参数页覆盖了。稳妥的做法是在链接脚本里显式留出一段区域或者在代码里用固定地址加编译期断言把边界卡死。下面这段是地址计算和边界检查的常见写法/* FLASH 页大小 2KB参数区放在最后 4 页 */ #define FLASH_BASE_ADDR 0x08000000UL #define FLASH_PAGE_SIZE 0x800UL #define PARAM_PAGE_INDEX (FLASH_PAGE_SIZE * 0) /* 按实际型号改 */ /* 根据页号算绝对地址并做编译期边界断言 */ static uint32_t param_addr_from_page(uint32_t page) { return FLASH_BASE_ADDR page * FLASH_PAGE_SIZE; } /* 编译期检查参数区不能越过 FLASH 末尾 */ _Static_assert((PARAM_PAGE_INDEX 4) * FLASH_PAGE_SIZE (512UL * 1024UL), param area exceeds flash size);逻辑说明param_addr_from_page把页号线性映射到地址避免手写魔法数_Static_assert在编译阶段就把越界挡掉比运行时才发现强得多。参数上要注意FLASH_PAGE_SIZE必须和你芯片实际页大小一致L4 系列大部分是 2KB但个别小容量型号是 1KB查参考手册的 memory map 确认别想当然。PARAM_PAGE_INDEX这里写成 0 只是占位实际要按你的代码占用情况改改完重新编译断言不过就说明放错位置了。2.3 解锁、擦除、写入的寄存器时序L4 的 FLASH 控制器有几个关键寄存器FLASH_ACR管等待周期和预取FLASH_KEYR收解锁序列FLASH_SR报状态FLASH_CR控擦写。解锁必须连续写两个魔数0x45670123和0xCDEF89AB到FLASH_KEYR顺序错了或者中间被打断就锁死得复位。擦除时先置PER位、写页地址、置STRT然后轮询BSY直到清零最后清PER。写入双字时置PG位往目标地址写两个 32 位字同样等BSY。这套流程 LL 库已经包好了大半但等待和清标志还是得自己盯。下面是一个擦一页再写一个双字的完整片段#include stm32l4xx_ll_flash.h /* 擦除指定页返回 0 成功负值失败 */ int flash_erase_page(uint32_t page_addr) { if (LL_FLASH_Unlock() ! 0) return -1; /* 解锁失败直接退出 */ LL_FLASH_ClearFlag(FLASH, LL_FLASH_FLAG_ALL); /* 清掉历史错误标志 */ LL_FLASH_EnablePageErase(FLASH); /* 置 PER */ LL_FLASH_SetPageAddress(FLASH, page_addr); /* 写页地址 */ LL_FLASH_StartErase(FLASH); /* 置 STRT 启动 */ uint32_t tick 0; while (LL_FLASH_IsActiveFlag_BSY(FLASH)) { /* 等擦除完成 */ if (tick 1000000) { LL_FLASH_Lock(); return -2; } } LL_FLASH_DisablePageErase(FLASH); LL_FLASH_Lock(); return 0; } /* 写一个 64 位双字addr 必须 8 字节对齐 */ int flash_write_dword(uint32_t addr, uint64_t data) { if (addr 0x7) return -1; /* 对齐检查 */ if (LL_FLASH_Unlock() ! 0) return -2; LL_FLASH_ClearFlag(FLASH, LL_FLASH_FLAG_ALL); LL_FLASH_EnableProgram(FLASH); /* 置 PG */ *(volatile uint32_t *)addr (uint32_t)(data 0xFFFFFFFF); *(volatile uint32_t *)(addr 4) (uint32_t)(data 32); uint32_t tick 0; while (LL_FLASH_IsActiveFlag_BSY(FLASH)) { if (tick 1000000) { LL_FLASH_Lock(); return -3; } } LL_FLASH_DisableProgram(FLASH); LL_FLASH_Lock(); return 0; }逻辑说明擦除函数先解锁再清标志是因为上一次操作残留的错误标志会让新的擦除直接失败tick超时是后悔药防止 BSY 卡死时死循环。写入函数强制 8 字节对齐这是 ECC 的硬要求不对齐写进去的数据读出来会错位。参数上LL_FLASH_FLAG_ALL会清掉包括 ECC 错误在内的所有标志如果你只想清特定标志可以换成LL_FLASH_FLAG_ECCRD之类但调试阶段全清更省心。注意LL_FLASH_Unlock的返回值在不同 LL 版本里可能没有如果你的头文件里它是 void就把判断去掉改成解锁后读FLASH_CR的LOCK位确认。3. 把读写封装成可复用的参数存储模块3.1 读操作的坑直接指针访问与 ECC 错误读 FLASH 看起来最简单*(uint32_t*)addr就完事。但 L4 上如果目标区域 ECC 校验失败这次读会触发总线错误程序直接跑飞。所以读之前最好先确认这块区域是「擦干净后写过」的状态而不是被写坏过的。常见做法是读之前先查FLASH_SR的ECCRD标志如果置位说明上次读出过错得先清标志再重试。更稳的做法是给参数区加一个头部魔数加 CRC读出来先验魔数和 CRC不对就当空处理走默认值。下面是一个带校验的读取函数#define PARAM_MAGIC 0x50415241UL /* PARA */ typedef struct { uint32_t magic; uint32_t crc; uint32_t value[4]; } param_block_t; /* 从 FLASH 读参数块校验失败返回 -1 */ int param_read(param_block_t *out) { const param_block_t *p (const param_block_t *)param_addr_from_page(PARAM_PAGE_INDEX); if (p-magic ! PARAM_MAGIC) return -1; /* 未初始化 */ uint32_t crc crc32_calc((const uint8_t *)p-value, sizeof(p-value)); if (crc ! p-crc) return -2; /* 数据损坏 */ *out *p; return 0; }逻辑说明魔数判断区分「从没写过」和「写过但坏了」两种情况前者走默认值后者可以触发告警。CRC 只算value字段不算魔数和 crc 自身避免自引用。参数上crc32_calc用常见的多项式 0x04C11DB7 即可实现不在这个包里自己补一个查表版就行。注意结构体直接映射到 FLASH 时要注意对齐和填充param_block_t的大小最好是 8 的倍数否则写入时跨双字会出问题可以在结构体末尾加uint32_t pad;凑齐。3.2 写操作的顺序先擦后写、按双字推进写参数块的流程是算好目标页 → 擦整页 → 按双字逐个写 → 回读校验。这里有个容易忽略的点擦除是整页 2KB如果你只想改一个参数也得把整页其他数据先读出来、改完再整体写回否则一擦全没了。所以参数模块通常设计成「整块读写」把一页当一个存储单元用。下面是把结构体写进 FLASH 的循环int param_write(const param_block_t *in) { param_block_t tmp *in; tmp.magic PARAM_MAGIC; tmp.crc crc32_calc((const uint8_t *)tmp.value, sizeof(tmp.value)); uint32_t page param_addr_from_page(PARAM_PAGE_INDEX); if (flash_erase_page(page) ! 0) return -1; const uint64_t *src (const uint64_t *)tmp; uint32_t n (sizeof(tmp) 7) / 8; /* 按双字个数推进 */ for (uint32_t i 0; i n; i) { if (flash_write_dword(page i * 8, src[i]) ! 0) return -2; } return 0; }逻辑说明先把魔数和 CRC 填好再写保证写进去的就是自洽的数据。n用向上取整算双字个数结构体大小不是 8 的倍数时最后一个双字会带填充读的时候按结构体大小截断即可。参数上page i * 8每次前进 8 字节严格对齐。注意擦除后到写入完成之间如果掉电这页就是半写状态下次上电 CRC 会失败所以关键参数建议双页轮换写一页坏了还有备份这个进阶做法在最后一章展开。3.3 用 LL 库还是寄存器直写边界在哪这份资源主打 LL 库加寄存器操作实际用下来 LL 覆盖了 90% 的场景剩下 10% 需要直写寄存器的地方主要是清特定错误标志、读FLASH_SR的 ECC 相关位、以及在极低功耗模式下操作前手动调整FLASH_ACR的等待周期。比如从 Stop 模式唤醒后立刻写 FLASH时钟还没稳得先把等待周期调大再操作否则写进去的数据不可靠。这类细节 LL 没有现成函数得自己写/* 唤醒后临时提高等待周期写完恢复 */ void flash_safe_write_after_wakeup(uint32_t addr, uint64_t data) { uint32_t old_latency LL_FLASH_GetLatency(FLASH); LL_FLASH_SetLatency(FLASH, LL_FLASH_LATENCY_4); /* 先降频等待 */ flash_write_dword(addr, data); LL_FLASH_SetLatency(FLASH, old_latency); /* 恢复原值 */ }逻辑说明LL_FLASH_SetLatency改的是FLASH_ACR的LATENCY位唤醒初期系统时钟可能还在切换给足等待周期能避免读写出错。参数上LL_FLASH_LATENCY_4对应较高主频具体值查你芯片的数据手册里「wait states vs frequency」那张表。注意这个函数只适合偶发调用频繁改等待周期会影响性能正常运行时保持固定值即可。4. 避坑与排查五个真实翻车现场4.1 现象写完读出来全是 0xFFCRC 永远不过原因擦除后没等BSY清零就急着写或者写入时PG位没置上数据根本没进 FLASH。L4 的BSY在擦除启动后有一小段延迟才置位如果你在STRT之后立刻查BSY可能查到的是 0误以为擦完了。解决擦除后先延时几个周期再进轮询或者直接轮询到BSY先置位再清零写入前用LL_FLASH_IsActiveFlag_BSY确认空闲写完再读FLASH_SR的EOP标志确认编程结束。4.2 现象写第二个双字时进 HardFault原因目标双字之前已经被写过且没擦ECC 校验冲突。L4 不允许对同一个双字重复编程哪怕你写的是相同数据。解决写之前确认这页是刚擦过的如果要做「追加写」必须换到下一个空双字不能原地覆盖。参数模块里整页擦除再整体写就是为了绕开这个限制。4.3 现象参数区偶尔被代码覆盖上电读到乱码原因参数页地址和代码段重叠链接器把常量或函数放到了那块区域。解决在链接脚本里用MEMORY或SECTIONS显式保留参数区或者在代码里加_Static_assert卡边界同时编译后看 map 文件确认__etext没越过参数页起始地址。这一步别省map 文件是黑匣子出问题全靠它。4.4 现象低功耗唤醒后第一次写 FLASH 失败原因唤醒后系统时钟还在切换FLASH 等待周期不够写入时序错乱。解决按 3.3 的做法写之前临时提高LATENCY写完恢复或者在唤醒流程里加一段时钟稳定延时再操作 FLASH。4.5 现象擦除一页耗时忽长忽短偶尔超时原因擦除时间和芯片温度、电压、磨损程度有关L4 的页擦除典型值几毫秒但边界条件下可能到几十毫秒。你的超时阈值设太紧就会误判失败。解决超时阈值按最坏情况留余量比如按 100ms 对应的循环次数设同时检查供电电压是否在擦写允许范围内低压下擦除会变慢甚至失败。5. 进阶双页轮换与掉电安全的那点事单页存储最大的软肋是擦写到一半掉电整页数据报废。工程上常见的补救是双页轮换准备两页 A 和 B每页头部带一个递增的序号写入时总是写到序号较旧的那页写完校验通过再把序号更新读的时候取序号较新的有效页。这样任意时刻至少有一页是完整的。实现上在param_block_t里加一个uint32_t seq;写之前先读两页的 seq选小的那页擦写写完回读比对。下面是一个简化的选择逻辑/* 返回应该写入的页地址选 seq 较小的那页 */ uint32_t pick_write_page(void) { const param_block_t *a (const param_block_t *)PAGE_A_ADDR; const param_block_t *b (const param_block_t *)PAGE_B_ADDR; uint32_t sa (a-magic PARAM_MAGIC) ? a-seq : 0; uint32_t sb (b-magic PARAM_MAGIC) ? b-seq : 0; return (sa sb) ? PAGE_A_ADDR : PAGE_B_ADDR; }逻辑说明魔数不对的页视为 seq 为 0优先被覆盖这样首次上电两页都空时从 A 开始写。参数上PAGE_A_ADDR和PAGE_B_ADDR要落在不同页且都经过边界断言检查。注意 seq 是 32 位理论上会回绕实际产品里写到几十万次早就该换片子了不用过度设计。验证方法我一般这么走写完参数后立刻断电再上电读出来比对再用调试器手动改 FLASH 里一个字节模拟损坏确认 CRC 能拦住并走默认值最后把电压拉到擦写下限附近跑一轮看超时阈值够不够。这套流程走下来参数存储这块基本就稳了。从那以后我每次碰内部 FLASH都强制先看 map 文件确认参数区没被占再跑一遍掉电测试才敢交付。希望帮到你。本文还有配套的精品资源点击获取
简介这份资源面向使用STM32L4xx系列MCU进行底层开发的嵌入式工程师聚焦内部FLASH的读写与擦除操作采用LL库并直接操作寄存器实现已在STM32L452RET6芯片上调试通过由于核心是寄存器配置改用HAL库时只需调整相关定义即可复用适合希望理解FLASH编程底层机制、摆脱库函数黑盒的开发者参考。压缩包共2个文件包含1个c源文件与1个h头文件分别承载FLASH读写擦除的具体实现与接口声明整体仅2KB代码精简、便于直接嵌入工程。资源已有1935人学习下载具备一定的实践验证基础。作者还补充了在STM32L471VETx上的调试经验因FLASH页码不连号导致擦页失败需修改擦页函数中的页码号并提示该代码不适用于STM32L4x1系列需自行调整擦页逻辑这一排错思路对跨型号移植尤具参考价值。1. 拿到 STM32L4xx 内部 FLASH 读写包先别急着烧板子做低功耗项目的人迟早会撞上一个需求设备断电重启后几个标定参数、运行计数、故障码还得在。外挂 EEPROM 要加料加钱铁电贵得离谱最后往往回到 MCU 自己的内部 FLASH 上。STM32L4xx 这颗片子内部 FLASH 结构比 F1 那代复杂不少双 bank、页粒度 2KB、带 ECC、擦除按页走、写入还分双字对齐稍不注意就是 HardFault 或者读出来全是 0xFF。这个压缩包给的就是一套能直接落地的读写实现走的是 LL 库加寄存器操作的路子不依赖 HAL 那套厚重封装适合对代码体积和时序敏感的场景。它解决的核心问题很具体在 L4 上安全地擦一页、写一段、读回来校验并且把解锁、等待 BSY、清标志这些容易翻车的动作收进函数里。适合谁手上有 L4 板子、要存少量非易失参数、又不想被 HAL_FLASH 的抽象层绕晕的嵌入式开发者。下面按「结构怎么理解 → 代码怎么跑 → 坑在哪」的顺序拆。2. STM32L4xx FLASH 结构双 bank、页粒度与 ECC 的约束2.1 为什么 L4 的 FLASH 不能照搬 F1 的写法F1 时代大家习惯按「半字写、扇区擦」地址算一算就下手。L4 换了一套规则FLASH 被切成两个 bank每个 bank 又按 2KB 一页划分擦除最小单位就是页没有更细的选项。更关键的是 L4 带 ECC 校验写入必须以双字64 位为单位对齐你写一个字节它也会把整个双字所在区域当成一次编程操作如果这个双字之前已经被写过而没擦ECC 就会报错读出来直接触发总线错误。这就是很多人第一次在 L4 上写 FLASH 就进 HardFault 的根因。所以选型上这份资源用 LL 库而不是 HAL不是为了炫技是因为 LL 的LL_FLASH_Unlock、LL_FLASH_ErasePage、LL_FLASH_Program这些函数直接对应寄存器动作等待 BSY 的时机你能自己控出问题也好定位。HAL 的HAL_FLASH_Program内部封装了错误回调反而把「到底哪一步失败」藏起来了。2.2 页地址怎么算、哪些页能碰L4 的 FLASH 起始地址是0x08000000页大小 2KB所以第 n 页的起始地址就是0x08000000 n * 0x800。双 bank 的划分取决于具体型号和选项字节配置常见做法是把参数区放在最后一个 bank 的末尾几页避开代码区。这里有个血泪经验别把参数页紧挨着代码段末尾放因为编译器一优化、代码一膨胀链接器可能就把你的参数页覆盖了。稳妥的做法是在链接脚本里显式留出一段区域或者在代码里用固定地址加编译期断言把边界卡死。下面这段是地址计算和边界检查的常见写法/* FLASH 页大小 2KB参数区放在最后 4 页 */ #define FLASH_BASE_ADDR 0x08000000UL #define FLASH_PAGE_SIZE 0x800UL #define PARAM_PAGE_INDEX (FLASH_PAGE_SIZE * 0) /* 按实际型号改 */ /* 根据页号算绝对地址并做编译期边界断言 */ static uint32_t param_addr_from_page(uint32_t page) { return FLASH_BASE_ADDR page * FLASH_PAGE_SIZE; } /* 编译期检查参数区不能越过 FLASH 末尾 */ _Static_assert((PARAM_PAGE_INDEX 4) * FLASH_PAGE_SIZE (512UL * 1024UL), param area exceeds flash size);逻辑说明param_addr_from_page把页号线性映射到地址避免手写魔法数_Static_assert在编译阶段就把越界挡掉比运行时才发现强得多。参数上要注意FLASH_PAGE_SIZE必须和你芯片实际页大小一致L4 系列大部分是 2KB但个别小容量型号是 1KB查参考手册的 memory map 确认别想当然。PARAM_PAGE_INDEX这里写成 0 只是占位实际要按你的代码占用情况改改完重新编译断言不过就说明放错位置了。2.3 解锁、擦除、写入的寄存器时序L4 的 FLASH 控制器有几个关键寄存器FLASH_ACR管等待周期和预取FLASH_KEYR收解锁序列FLASH_SR报状态FLASH_CR控擦写。解锁必须连续写两个魔数0x45670123和0xCDEF89AB到FLASH_KEYR顺序错了或者中间被打断就锁死得复位。擦除时先置PER位、写页地址、置STRT然后轮询BSY直到清零最后清PER。写入双字时置PG位往目标地址写两个 32 位字同样等BSY。这套流程 LL 库已经包好了大半但等待和清标志还是得自己盯。下面是一个擦一页再写一个双字的完整片段#include stm32l4xx_ll_flash.h /* 擦除指定页返回 0 成功负值失败 */ int flash_erase_page(uint32_t page_addr) { if (LL_FLASH_Unlock() ! 0) return -1; /* 解锁失败直接退出 */ LL_FLASH_ClearFlag(FLASH, LL_FLASH_FLAG_ALL); /* 清掉历史错误标志 */ LL_FLASH_EnablePageErase(FLASH); /* 置 PER */ LL_FLASH_SetPageAddress(FLASH, page_addr); /* 写页地址 */ LL_FLASH_StartErase(FLASH); /* 置 STRT 启动 */ uint32_t tick 0; while (LL_FLASH_IsActiveFlag_BSY(FLASH)) { /* 等擦除完成 */ if (tick 1000000) { LL_FLASH_Lock(); return -2; } } LL_FLASH_DisablePageErase(FLASH); LL_FLASH_Lock(); return 0; } /* 写一个 64 位双字addr 必须 8 字节对齐 */ int flash_write_dword(uint32_t addr, uint64_t data) { if (addr 0x7) return -1; /* 对齐检查 */ if (LL_FLASH_Unlock() ! 0) return -2; LL_FLASH_ClearFlag(FLASH, LL_FLASH_FLAG_ALL); LL_FLASH_EnableProgram(FLASH); /* 置 PG */ *(volatile uint32_t *)addr (uint32_t)(data 0xFFFFFFFF); *(volatile uint32_t *)(addr 4) (uint32_t)(data 32); uint32_t tick 0; while (LL_FLASH_IsActiveFlag_BSY(FLASH)) { if (tick 1000000) { LL_FLASH_Lock(); return -3; } } LL_FLASH_DisableProgram(FLASH); LL_FLASH_Lock(); return 0; }逻辑说明擦除函数先解锁再清标志是因为上一次操作残留的错误标志会让新的擦除直接失败tick超时是后悔药防止 BSY 卡死时死循环。写入函数强制 8 字节对齐这是 ECC 的硬要求不对齐写进去的数据读出来会错位。参数上LL_FLASH_FLAG_ALL会清掉包括 ECC 错误在内的所有标志如果你只想清特定标志可以换成LL_FLASH_FLAG_ECCRD之类但调试阶段全清更省心。注意LL_FLASH_Unlock的返回值在不同 LL 版本里可能没有如果你的头文件里它是 void就把判断去掉改成解锁后读FLASH_CR的LOCK位确认。3. 把读写封装成可复用的参数存储模块3.1 读操作的坑直接指针访问与 ECC 错误读 FLASH 看起来最简单*(uint32_t*)addr就完事。但 L4 上如果目标区域 ECC 校验失败这次读会触发总线错误程序直接跑飞。所以读之前最好先确认这块区域是「擦干净后写过」的状态而不是被写坏过的。常见做法是读之前先查FLASH_SR的ECCRD标志如果置位说明上次读出过错得先清标志再重试。更稳的做法是给参数区加一个头部魔数加 CRC读出来先验魔数和 CRC不对就当空处理走默认值。下面是一个带校验的读取函数#define PARAM_MAGIC 0x50415241UL /* PARA */ typedef struct { uint32_t magic; uint32_t crc; uint32_t value[4]; } param_block_t; /* 从 FLASH 读参数块校验失败返回 -1 */ int param_read(param_block_t *out) { const param_block_t *p (const param_block_t *)param_addr_from_page(PARAM_PAGE_INDEX); if (p-magic ! PARAM_MAGIC) return -1; /* 未初始化 */ uint32_t crc crc32_calc((const uint8_t *)p-value, sizeof(p-value)); if (crc ! p-crc) return -2; /* 数据损坏 */ *out *p; return 0; }逻辑说明魔数判断区分「从没写过」和「写过但坏了」两种情况前者走默认值后者可以触发告警。CRC 只算value字段不算魔数和 crc 自身避免自引用。参数上crc32_calc用常见的多项式 0x04C11DB7 即可实现不在这个包里自己补一个查表版就行。注意结构体直接映射到 FLASH 时要注意对齐和填充param_block_t的大小最好是 8 的倍数否则写入时跨双字会出问题可以在结构体末尾加uint32_t pad;凑齐。3.2 写操作的顺序先擦后写、按双字推进写参数块的流程是算好目标页 → 擦整页 → 按双字逐个写 → 回读校验。这里有个容易忽略的点擦除是整页 2KB如果你只想改一个参数也得把整页其他数据先读出来、改完再整体写回否则一擦全没了。所以参数模块通常设计成「整块读写」把一页当一个存储单元用。下面是把结构体写进 FLASH 的循环int param_write(const param_block_t *in) { param_block_t tmp *in; tmp.magic PARAM_MAGIC; tmp.crc crc32_calc((const uint8_t *)tmp.value, sizeof(tmp.value)); uint32_t page param_addr_from_page(PARAM_PAGE_INDEX); if (flash_erase_page(page) ! 0) return -1; const uint64_t *src (const uint64_t *)tmp; uint32_t n (sizeof(tmp) 7) / 8; /* 按双字个数推进 */ for (uint32_t i 0; i n; i) { if (flash_write_dword(page i * 8, src[i]) ! 0) return -2; } return 0; }逻辑说明先把魔数和 CRC 填好再写保证写进去的就是自洽的数据。n用向上取整算双字个数结构体大小不是 8 的倍数时最后一个双字会带填充读的时候按结构体大小截断即可。参数上page i * 8每次前进 8 字节严格对齐。注意擦除后到写入完成之间如果掉电这页就是半写状态下次上电 CRC 会失败所以关键参数建议双页轮换写一页坏了还有备份这个进阶做法在最后一章展开。3.3 用 LL 库还是寄存器直写边界在哪这份资源主打 LL 库加寄存器操作实际用下来 LL 覆盖了 90% 的场景剩下 10% 需要直写寄存器的地方主要是清特定错误标志、读FLASH_SR的 ECC 相关位、以及在极低功耗模式下操作前手动调整FLASH_ACR的等待周期。比如从 Stop 模式唤醒后立刻写 FLASH时钟还没稳得先把等待周期调大再操作否则写进去的数据不可靠。这类细节 LL 没有现成函数得自己写/* 唤醒后临时提高等待周期写完恢复 */ void flash_safe_write_after_wakeup(uint32_t addr, uint64_t data) { uint32_t old_latency LL_FLASH_GetLatency(FLASH); LL_FLASH_SetLatency(FLASH, LL_FLASH_LATENCY_4); /* 先降频等待 */ flash_write_dword(addr, data); LL_FLASH_SetLatency(FLASH, old_latency); /* 恢复原值 */ }逻辑说明LL_FLASH_SetLatency改的是FLASH_ACR的LATENCY位唤醒初期系统时钟可能还在切换给足等待周期能避免读写出错。参数上LL_FLASH_LATENCY_4对应较高主频具体值查你芯片的数据手册里「wait states vs frequency」那张表。注意这个函数只适合偶发调用频繁改等待周期会影响性能正常运行时保持固定值即可。4. 避坑与排查五个真实翻车现场4.1 现象写完读出来全是 0xFFCRC 永远不过原因擦除后没等BSY清零就急着写或者写入时PG位没置上数据根本没进 FLASH。L4 的BSY在擦除启动后有一小段延迟才置位如果你在STRT之后立刻查BSY可能查到的是 0误以为擦完了。解决擦除后先延时几个周期再进轮询或者直接轮询到BSY先置位再清零写入前用LL_FLASH_IsActiveFlag_BSY确认空闲写完再读FLASH_SR的EOP标志确认编程结束。4.2 现象写第二个双字时进 HardFault原因目标双字之前已经被写过且没擦ECC 校验冲突。L4 不允许对同一个双字重复编程哪怕你写的是相同数据。解决写之前确认这页是刚擦过的如果要做「追加写」必须换到下一个空双字不能原地覆盖。参数模块里整页擦除再整体写就是为了绕开这个限制。4.3 现象参数区偶尔被代码覆盖上电读到乱码原因参数页地址和代码段重叠链接器把常量或函数放到了那块区域。解决在链接脚本里用MEMORY或SECTIONS显式保留参数区或者在代码里加_Static_assert卡边界同时编译后看 map 文件确认__etext没越过参数页起始地址。这一步别省map 文件是黑匣子出问题全靠它。4.4 现象低功耗唤醒后第一次写 FLASH 失败原因唤醒后系统时钟还在切换FLASH 等待周期不够写入时序错乱。解决按 3.3 的做法写之前临时提高LATENCY写完恢复或者在唤醒流程里加一段时钟稳定延时再操作 FLASH。4.5 现象擦除一页耗时忽长忽短偶尔超时原因擦除时间和芯片温度、电压、磨损程度有关L4 的页擦除典型值几毫秒但边界条件下可能到几十毫秒。你的超时阈值设太紧就会误判失败。解决超时阈值按最坏情况留余量比如按 100ms 对应的循环次数设同时检查供电电压是否在擦写允许范围内低压下擦除会变慢甚至失败。5. 进阶双页轮换与掉电安全的那点事单页存储最大的软肋是擦写到一半掉电整页数据报废。工程上常见的补救是双页轮换准备两页 A 和 B每页头部带一个递增的序号写入时总是写到序号较旧的那页写完校验通过再把序号更新读的时候取序号较新的有效页。这样任意时刻至少有一页是完整的。实现上在param_block_t里加一个uint32_t seq;写之前先读两页的 seq选小的那页擦写写完回读比对。下面是一个简化的选择逻辑/* 返回应该写入的页地址选 seq 较小的那页 */ uint32_t pick_write_page(void) { const param_block_t *a (const param_block_t *)PAGE_A_ADDR; const param_block_t *b (const param_block_t *)PAGE_B_ADDR; uint32_t sa (a-magic PARAM_MAGIC) ? a-seq : 0; uint32_t sb (b-magic PARAM_MAGIC) ? b-seq : 0; return (sa sb) ? PAGE_A_ADDR : PAGE_B_ADDR; }逻辑说明魔数不对的页视为 seq 为 0优先被覆盖这样首次上电两页都空时从 A 开始写。参数上PAGE_A_ADDR和PAGE_B_ADDR要落在不同页且都经过边界断言检查。注意 seq 是 32 位理论上会回绕实际产品里写到几十万次早就该换片子了不用过度设计。验证方法我一般这么走写完参数后立刻断电再上电读出来比对再用调试器手动改 FLASH 里一个字节模拟损坏确认 CRC 能拦住并走默认值最后把电压拉到擦写下限附近跑一轮看超时阈值够不够。这套流程走下来参数存储这块基本就稳了。从那以后我每次碰内部 FLASH都强制先看 map 文件确认参数区没被占再跑一遍掉电测试才敢交付。希望帮到你。本文还有配套的精品资源点击获取
知识建站
内容驱动
阅读友好版式
SEO 精细化
线索转化