简介这份PDF资料聚焦STM32L系列单片机内部EEPROM的读写实现面向已具备STM32基础、需要为低功耗设备保存配置参数的嵌入式开发者。资源围绕EEPROM与FLASH统一编址这一特性展开讲清读写期间CPU挂起、总线访问暂停的机制并给出读操作按字节/半字/字/双字访问、偏移地址四字节对齐的注意事项。编程部分覆盖解锁、页擦除、写回、加锁的完整流程说明写入0x00自动触发擦除、非零值执行写入的区别以及写操作前后关闭与开启中断以保证原子性的做法。压缩包内为1个PDF文件约51KB篇幅紧凑适合快速查阅关键寄存器序列与代码片段。目前已有2939人学习下载可作为参数存储方案选型、代码移植与排错时的参考帮助读者理解对齐、操作顺序、状态检查与中断管理对数据安全的影响。1. 为什么STM32L的EEPROM写一次会让CPU停住很多人第一次在STM32L上写EEPROM参数时都会遇到一个反直觉的现象明明只是存一个校准系数主循环却像被按了暂停键几毫秒内什么响应都没有。原因在于STM32L的EEPROM并不是独立挂在总线上的外设它和FLASH统一编址共用同一套读写电路。一旦发起EEPROM编程内核对所有FLASH的取指和数据访问都会被硬件挂起只有EEPROM的高压擦写电路在工作CPU处于挂起状态直到这次操作结束才继续执行后面的代码。这个特性决定了它的定位适合存配置参数、设备序列号、标定值这类改动次数很少的数据而不是拿来当高频日志缓冲区。STM32L的EEPROM区容量一般在2KB到4KB之间擦写寿命标称10万次以上按参数存储的修改频率算用十年都绰绰有余。读操作则完全没有这个负担和读FLASH、读RAM一样直接走总线读周期不需要解锁、不需要等待也不占用额外时间。真正需要小心的是写路径解锁、擦除、写入、判忙、加锁每一步都有寄存器序列和对齐要求顺序错了轻则写不进去重则触发总线错误。下面按读、写、实战封装、排错四个层面拆开讲。2. STM32L内部EEPROM的编址方式与总线读时序2.1 EEPROM区在统一编址中的位置STM32L把EEPROM映射到FLASH地址空间之后的一段固定区域具体基址和大小由芯片型号决定常见做法是从数据手册的memory map表里查到EEPROM_BASE和EEPROM_END然后在代码里定义成宏。因为和FLASH统一编址访问它不需要任何外设时钟使能也不需要配置GPIO复用直接把它当成一段普通内存来读就行。/* 以某型号为例实际基址请对照对应型号的数据手册 memory map */ #define EEPROM_BASE 0x08080000UL #define EEPROM_SIZE 0x00000800UL /* 2KB */ #define EEPROM_END (EEPROM_BASE EEPROM_SIZE) /* 按字节读取直接解引用走总线读周期 */ uint8_t eeprom_read_byte(uint32_t offset) { return *(volatile uint8_t *)(EEPROM_BASE offset); } /* 按字读取一次读32位 */ uint32_t eeprom_read_word(uint32_t offset) { return *(volatile uint32_t *)(EEPROM_BASE offset); }这里的volatile不能省否则编译器可能把连续两次读优化成一次读到旧值。offset是相对EEPROM基址的偏移不是绝对地址。读函数没有任何解锁或等待逻辑因为读操作本身不触发高压电路。2.2 四字节对齐为什么必须遵守STM32L的总线对非对齐访问容忍度有限尤其是按字、双字读取时如果偏移地址不是4的倍数可能触发总线访问错误或者读回来的数据高低字节错位。原文里提到一种规避手法在一个字的存储空间里只用低16位高16位空着不用这样即使按半字访问也不会跨字边界。访问方式推荐偏移对齐单次占用空间适用场景字节任意1字节单个标志位、状态码半字2字节对齐2字节16位传感器标定值字4字节对齐4字节32位参数、浮点位模式双字8字节对齐8字节结构体批量存储我一般会在参数结构体外面套一层__attribute__((aligned(4)))让编译器帮忙保证起始地址对齐比手工算偏移可靠得多。typedef struct { uint32_t magic; /* 标识判断是否已初始化 */ uint16_t calib; /* 标定值 */ uint16_t reserved; /* 补齐到4字节 */ uint32_t serial; /* 序列号 */ } __attribute__((aligned(4))) dev_param_t;magic字段是常见做法上电先读它等于约定值才认为参数有效否则加载默认值。reserved不是浪费是为了让整个结构体长度是4的倍数避免数组形式存储时第二个元素错位。3. 解锁、页擦除与写入的寄存器操作流程3.1 解锁序列与命令码写EEPROM前必须先解锁方式是向特定寄存器连续写入两个约定的命令码顺序和数值都不能错错一个字节后续所有写操作都会被硬件拒绝。原文提到手册给出了解锁命令码实际工程里通常把它们定义成宏避免手写魔数。/* 命令码以对应型号参考手册为准此处为示例值 */ #define EEPROM_UNLOCK_KEY1 0x89ABCDEFUL #define EEPROM_UNLOCK_KEY2 0x02030405UL #define EEPROM_PEKEY1 0x45670123UL #define EEPROM_PEKEY2 0xCDEF89ABUL /* 解锁EEPROM控制寄存器允许编程 */ static void eeprom_unlock(void) { if (EEPROM-CR EEPROM_CR_LOCK) { EEPROM-KEYR EEPROM_UNLOCK_KEY1; EEPROM-KEYR EEPROM_UNLOCK_KEY2; } } /* 加锁保护数据不被意外改写 */ static void eeprom_lock(void) { EEPROM-CR | EEPROM_CR_LOCK; }解锁只影响控制寄存器的写权限不会改变存储内容。加锁则应该在每次写操作结束后立刻执行哪怕后面还有别的逻辑先把锁加上再去做减少误写窗口。3.2 页擦除先读回、再修改、后写回STM32L的擦除按字、双字或页进行页擦除最通用。原因是参数往往成组存在同一页里如果按字擦改一个参数要擦好几次每次擦除都让CPU挂起累积延迟很难看。页擦除的标准套路是先把整页参数读到RAM在RAM里改擦掉整页再把改好的数据写回去。#define EEPROM_PAGE_SIZE 256U /* 页大小以手册为准 */ /* 页擦除擦除包含offset的那一页 */ static int eeprom_erase_page(uint32_t offset) { uint32_t page_start (offset / EEPROM_PAGE_SIZE) * EEPROM_PAGE_SIZE; eeprom_unlock(); EEPROM-CR | EEPROM_CR_PER; /* 选择页擦除模式 */ EEPROM-AR EEPROM_BASE page_start; /* 地址寄存器指向页首 */ EEPROM-CR | EEPROM_CR_STRT; /* 启动擦除 */ /* 等待BSY清零超时则返回错误 */ uint32_t timeout 0xFFFFF; while ((EEPROM-SR EEPROM_SR_BSY) --timeout) { __NOP(); } EEPROM-CR ~EEPROM_CR_PER; eeprom_lock(); return (timeout 0) ? -1 : 0; }AR寄存器必须指向页起始地址不是任意偏移否则硬件行为未定义。BSY位是判忙的核心擦除期间它一直为1超时保护是为了防止硬件异常时死等。擦除完成后清掉PER位再上锁。3.3 写入与判忙为什么每次都要等BSY写入比擦除简单但同样要判忙。原文特别强调每写一字节、半字或双字都要判断是否写入完成因为内部高压擦写电路需要时间上一次没结束就发起下一次结果不可预期。还有一个细节写入0x00、0x0000、0x00000000时硬件自动执行一次擦除写入非零值才走真正的写入流程。这意味着你不能靠写0来清标志位它会触发擦除耗时更长。/* 按字写入offset需4字节对齐 */ static int eeprom_write_word(uint32_t offset, uint32_t data) { eeprom_unlock(); EEPROM-CR | EEPROM_CR_PG; /* 进入编程模式 */ *(volatile uint32_t *)(EEPROM_BASE offset) data; uint32_t timeout 0xFFFFF; while ((EEPROM-SR EEPROM_SR_BSY) --timeout) { __NOP(); } EEPROM-CR ~EEPROM_CR_PG; eeprom_lock(); return (timeout 0) ? -1 : 0; }写入是直接对目标地址赋值硬件接管后续时序。PG位在写入期间保持写完清掉。返回-1表示超时调用方应该重试或报错而不是继续往下写。4. 中断屏蔽、参数回写与MDK环境下的封装4.1 写操作期间为什么要关中断原文反复强调写入前关中断写完再开。原因是写操作期间CPU对FLASH的访问被挂起如果此时来了中断中断向量表的取指也要走FLASH硬件状态可能冲突轻则中断丢失重则CPU异常或锁死。常见做法是用__disable_irq()和__enable_irq()包住整个擦写序列。/* 完整的参数保存流程关中断 - 读回 - 改 - 擦 - 写 - 开中断 */ int param_save(dev_param_t *new_param) { dev_param_t buf; uint32_t primask __get_PRIMASK(); __disable_irq(); /* 进入临界区 */ /* 1. 读回整页到RAM */ for (uint32_t i 0; i sizeof(dev_param_t); i 4) { ((uint32_t *)buf)[i / 4] eeprom_read_word(i); } /* 2. 在RAM里更新 */ buf *new_param; /* 3. 页擦除 */ if (eeprom_erase_page(0) ! 0) { __set_PRIMASK(primask); return -1; } /* 4. 写回 */ for (uint32_t i 0; i sizeof(dev_param_t); i 4) { if (eeprom_write_word(i, ((uint32_t *)buf)[i / 4]) ! 0) { __set_PRIMASK(primask); return -1; } } __set_PRIMASK(primask); /* 恢复中断状态 */ return 0; }用__get_PRIMASK保存再恢复比直接__enable_irq()稳妥因为调用前中断可能本来就是关的直接开会破坏上层逻辑。整个临界区里不做任何打印、延时以外的耗时操作减少中断延迟。4.2 MDK下的宏定义与调试技巧在MDKKeil环境里__disable_irq和__enable_irq来自CMSIS包含core_cmX.h即可。原文提到两个可以这样定义实际工程里我一般再包一层方便在仿真时打桩。/* 便于单元测试时替换为空实现 */ #ifndef EEPROM_CRITICAL_ENTER #define EEPROM_CRITICAL_ENTER() __disable_irq() #endif #ifndef EEPROM_CRITICAL_EXIT #define EEPROM_CRITICAL_EXIT() __enable_irq() #endif调试时有个实用技巧在MDK的Watch窗口里直接输入*(uint32_t*)0x08080000可以实时看EEPROM首字的内容改完参数刷新一下就能确认写没写进去比反复复位读串口快得多。如果发现写进去的值和预期不符先查对齐再查是不是在写0触发了擦除。注意擦除和写入期间不要用调试器单步单步会让总线时序错乱看到的现象没有参考价值要全速跑完再断点看结果。5. 参数校验、寿命管理与常见写入失败排查5.1 用magic加CRC做双重校验参数存进去不代表下次读出来还对掉电时机不对、擦除中途复位都可能留下半新半旧的数据。稳妥做法是结构体里放magic和crc两个字段上电读取后先验magic再验CRC任一不过就加载默认值并重写一次。/* 简易CRC32实际可用硬件CRC外设 */ static uint32_t crc32(const uint8_t *data, uint32_t len) { uint32_t crc 0xFFFFFFFF; for (uint32_t i 0; i len; i) { crc ^ data[i]; for (int b 0; b 8; b) { crc (crc 1) ^ (0xEDB88320 -(crc 1)); } } return ~crc; } int param_load(dev_param_t *out) { for (uint32_t i 0; i sizeof(dev_param_t); i 4) { ((uint32_t *)out)[i / 4] eeprom_read_word(i); } if (out-magic ! DEV_PARAM_MAGIC) return -1; if (out-crc ! crc32((uint8_t *)out, sizeof(*out) - 4)) return -1; return 0; }crc字段放在结构体最后计算时长度减4避免把自己算进去。这样即使擦除到一半掉电读出来的CRC也对不上能安全回退。5.2 写入失败的排查顺序写不进去时按这个顺序查基本能覆盖九成问题现象可能原因排查动作写入后读回全FF没解锁或解锁序列错检查KEYR两次写入的值和顺序写入后读回旧值没擦除直接写确认擦除在写入之前执行偶发总线错误偏移未4字节对齐打印offset检查是否%40写0后耗时异常长写0触发擦除避免用写0清标志改用非零值中断后系统卡死写期间未关中断确认临界区包住了整个擦写序列寿命方面10万次是按页算的不是按字节。如果某个参数每秒改一次一年就是三千多万次远超寿命。这种场景应该换外部EEPROM或FRAM别硬扛内部EEPROM。判断标准很简单参数修改频率低于每天一次内部EEPROM完全够用高于每小时一次就该考虑外置方案了。5.3 一个减少擦写次数的技巧如果参数确实需要较频繁更新但又不想频繁擦页可以在页内做追加写每次更新写到页内下一个空闲字页写满了再整体擦一次。这样擦除次数降到原来的1/NN是一页能放多少个参数副本。代价是读取时要扫描找到最新那条逻辑稍复杂但对延长寿命很有效。/* 追加写找到页内第一个全FF的字写进去 */ static int eeprom_append(uint32_t page_offset, uint32_t value) { for (uint32_t off 0; off EEPROM_PAGE_SIZE; off 4) { if (eeprom_read_word(page_offset off) 0xFFFFFFFF) { return eeprom_write_word(page_offset off, value); } } return -2; /* 页满需要擦除 */ }读到0xFFFFFFFF说明这个位置是擦除后的初始态可以写。返回-2时调用方执行一次页擦除把最新值写到页首重新开始。这个模式在参数更新频繁但总量不大的场景里很实用把10万次寿命摊到整页上实际可用更新次数能翻几十倍。本文还有配套的精品资源点击获取