STM32H7硬件IIC驱动EEPROM：从模拟IIC到HAL库实战与优化

1. 项目背景与核心痛点

最近在做一个基于STM32H7系列MCU的数据采集项目，需要频繁地将一些校准参数、运行日志和配置信息存储到外部EEPROM中。一开始，我图省事，直接找了个网上流传的“模拟IIC”代码就往上怼。在低速、低频访问的场景下，这套方案勉强能用。但随着项目深入，我需要实现一个高速数据流的断点续传功能，这就要求MCU能以更高的频率、更可靠的时序去读写EEPROM。模拟IIC的弊端立刻暴露无遗：CPU占用率高得吓人，一个字节的读写过程就把CPU死死地“栓”在了GPIO翻转和延时上；更头疼的是时序稳定性，一旦开了中断或者有其他高优先级任务打断，通信十有八九会失败，调试起来简直是噩梦。

这时，硬件IIC的优势就凸显出来了。STM32H7内置的I2C外设，其通信过程完全由硬件逻辑电路控制，不占用CPU进行位级别的时序模拟。CPU只需要通过寄存器或HAL库API配置好参数、发起传输，就可以去处理其他任务，由DMA或中断来通知传输完成，效率极高，时序也由硬件保证，极其精准和稳定。但当我真正开始用HAL库配置STM32H7的硬件IIC去驱动EEPROM时，发现事情并没有想象中那么简单。网上的资料要么是基于F1/F4系列的，要么就是只给个CubeMX配置截图，对于H7系列特有的高性能模式、时序配置、以及HAL库那些“坑爹”的回调机制，很少有能讲透的。特别是如何结合EEPROM这种有“页写”限制和需要“伪地址”操作的器件，写出稳定高效的驱动，更是一头雾水。

所以，我决定把这次从零开始，基于STM32H7的HAL库，成功驱动AT24Cxx系列EEPROM的完整过程、源码和踩过的坑，系统地梳理出来。这份总结不仅是一份可即抄即用的源码，更会深入解释H7硬件IIC的配置要点、HAL库底层机制，以及如何规避常见问题。无论你是正在从模拟IIC转向硬件IIC，还是初次在H7平台上使用I2C外设，相信这篇内容都能让你少走很多弯路。

2. STM32H7硬件IIC外设与EEPROM器件特性解析

在动手写代码之前，我们必须先搞清楚两件事：我们手中的“武器”（STM32H7的I2C外设）有什么特殊能力，以及我们要驱动的“目标”（EEPROM）有什么样的脾气。知己知彼，才能配置出最优的通信参数。

2.1 STM32H7 I2C外设的“高性能模式”

STM32H7的I2C外设（I2C1, I2C2, I2C3, I2C4）相较于之前的系列，有一个非常重要的增强特性：支持**“快速模式 Plus (Fm+)”**，速率最高可达1 MHz。这对于需要与高速传感器或存储器通信的场景是巨大的利好。但实现1MHz通信是有条件的，它依赖于特定的引脚复用功能和正确的时序配置。

首先，不是所有I2C引脚都支持Fm+。在STM32H7的数据手册（Datasheet）中，会明确标注哪些引脚是“FM+” capable的。例如，I2C1的SDA/SCL在PB8/PB9上可能支持，但在其他复用引脚上可能只支持标准模式（100kHz）或快速模式（400kHz）。因此，在CubeMX中选型引脚时，如果对速度有要求，一定要查阅数据手册确认。

其次，要实现高速稳定通信，GPIO的速率配置和上下拉电阻至关重要。H7的GPIO可以配置为“Very High”速度，这对于I2C的快速翻转是必要的。更重要的是，虽然STM32的I2C外设内部有弱上拉，但在高速模式下，其驱动能力往往不足以保证信号边沿的陡峭，这会导致时序紊乱。因此，强烈建议在SDA和SCL线上外接4.7kΩ（对于400kHz）或更小（如2.2kΩ，对于1MHz）的上拉电阻到VCC。这是硬件上保证通信稳定的基石，软件配置再正确，硬件电路有问题也是白搭。

2.2 EEPROM的“页写”与“地址”机制

我们以最常用的AT24C02（256字节）到AT24C512（64K字节）系列为例。这类EEPROM有几个关键特性决定了我们的软件驱动逻辑：

1. 器件地址（Device Address）：EEPROM的7位I2C地址通常是固定的高4位（如1010），加上由硬件引脚（A2, A1, A0）电平决定的3位。例如，AT24C02的地址可能是0xA0（写）和0xA1（读）。这里有一个初学者极易混淆的点：HAL库的API要求传入的是7位地址左移一位后的8位值（即包含了读写位）。但在驱动封装时，我们通常按7位地址来思考，在调用前再进行移位操作。

2. 内存地址（Memory Address）：EEPROM内部就像一个数组，每个字节都有一个地址。对于容量小于256字节的（如24C02），内存地址是8位的，用一个字节表示。对于容量更大的（如24C04是512字节），内存地址需要9位，但I2C协议一次只能发送8位数据。怎么办？这时，器件会把多出来的那1位地址，放到器件地址的最后一位（即A0脚对应的位）去。对于24C16（2K字节）及以上，内存地址需要12位甚至更多（24C512需要16位），这时就需要连续发送两个字节的内存地址（先发高8位，再发低8位）。我们的驱动必须能根据不同的EEPROM容量，自动判断需要发送几个字节的内存地址。

3. 页写限制（Page Write）：EEPROM的写操作不是以字节为单位随意进行的。它内部有“页”的概念，例如AT24C02的一页是8字节。当你连续写入数据时，不能跨页写入。如果你从一页的中间开始写，当写到该页末尾时，地址指针会自动翻卷到该页的开头，覆盖之前写入的数据，而不是自动跳到下一页。这是导致数据写入错误的最常见原因之一。因此，我们的写函数必须包含自动分页逻辑，当检测到要跨页时，主动拆分写入操作。

4. 写入周期时间（Write Cycle Time）：向EEPROM写入一个字节或一页数据后，芯片内部需要时间（典型值5ms）来完成实际的擦写操作。在此期间，如果再次发起对其的I2C访问，EEPROM不会应答（NACK）。我们的驱动必须能处理这种情况，通常采用**查询应答（Polling）**的方式：写完数据后，不断发送一个起始条件+器件地址（写操作），直到收到ACK，表明内部写周期结束。这是硬件IIC驱动EEPROM稳定性的关键。

理解了这两方面，我们就能明白，一个健壮的EEPROM驱动，不仅仅是调用HAL_I2C_Mem_Write那么简单，它必须封装好地址计算、分页逻辑和写周期等待。

3. CubeMX工程配置与HAL库底层机制探秘

很多教程只教你怎么在CubeMX里点点点，却不告诉你为什么这么点。这里，我会结合HAL库的源码，解释几个关键配置背后的意义，让你知其然更知其所以然。

3.1 CubeMX图形化配置详解

打开CubeMX，为你的STM32H7芯片创建一个新工程。

1. 启用I2C外设：在Pinout & Configuration标签页下，找到Connectivity->I2Cx。选择你要使用的I2C接口（例如I2C1）。
2. 配置模式：将I2C Mode设置为I2C。注意，不要选成SMBus，那是另一种系统管理总线协议。
3. 配置参数：切换到Parameter Settings子标签。
   • Timing Settings: 这是核心！不要直接使用默认值。点击Timing旁边的Calculate按钮（那个小魔杖图标）。在弹出的窗口中：
     • I2C Speed Mode：选择Fast Mode（400kHz）或Fast Mode Plus（1MHz）。根据你的EEPROM型号和硬件上拉电阻能力选择。对于大多数应用，400kHz是稳定和性能的平衡点。
     • I2C Clock Frequency (MHz)：输入你配置的HCLK频率（比如如果系统时钟是400MHz，I2C时钟源APB总线可能是200MHz）。CubeMX会根据你输入的频率和选择的速率模式，自动计算并填充下面一大串十六进制Timing值。这个计算出来的值，就是保证I2C时序符合规范的关键寄存器配置。记下这个值（例如0x00C0EAFF），如果自动计算失败或不理想，也可以根据参考手册的公式手动计算，但通常自动计算的即可用。
   • Configuration Parameters:
     • No Stretch Mode：一般保持Disabled（即允许时钟拉伸）。当从设备（如EEPROM）处理数据较慢时，可以通过拉低SCL来让主机等待，这是I2C协议的标准功能。
     • Primary Address Length：保持7-bit。
     • Dual Address Mode：Disabled。EEPROM一般只有一个地址。
     • General Call Address：Disabled。广播呼叫，EEPROM不用。
     • Clock No Stretch Mode：Disabled。
4. 配置GPIO：回到Pinout视图，查看为你分配的SDA和SCL引脚。确保它们的模式被自动设置为I2Cx_SDA和I2Cx_SCL。建议在System Core->GPIO中，检查一下这两个引脚的配置，将Maximum output speed改为Very High，以支持高速信号。
5. 生成代码：配置好时钟树（确保给I2C的APB总线时钟正确）后，在Project Manager里设置好工程名、路径和IDE，然后生成代码。

3.2 深入HAL库：阻塞、中断与DMA模式的选择

生成的代码中，在i2c.c里已经完成了I2C的初始化（MX_I2C1_Init）。HAL库提供了三种操作模式：

1. 阻塞模式（Blocking）：例如HAL_I2C_Mem_Write。函数会一直等待本次传输完成（或超时）才返回。期间CPU被挂起。优点是代码简单，逻辑清晰。缺点是效率低，在等待慢速EEPROM（尤其是写周期等待的5ms）时，CPU什么也干不了。对于简单的、非实时性的初始化配置，可以用。

2. 中断模式（Interrupt）：例如HAL_I2C_Mem_Write_IT。函数配置好传输参数后立即返回，传输过程在后台由中断服务程序（ISR）完成。传输完成、出错等事件会触发回调函数（如HAL_I2C_MemTxCpltCallback）。优点是解放了CPU，在传输期间可以处理其他任务。缺点是编程模型复杂，需要处理各种回调，并且中断频繁进出对系统实时性有一定影响。对于频繁的小数据量读写，中断开销可能比阻塞模式等待的时间还大。

3. DMA模式（Direct Memory Access）：例如HAL_I2C_Mem_Write_DMA。这是效率最高的方式。DMA控制器在后台搬运数据，完全不需要CPU干预，甚至比中断模式更省CPU。优点是极致的高效，特别适合大数据量的连续读写。缺点是配置最复杂，需要额外配置DMA通道，并且要小心处理缓存一致性问题（Cache Coherency）——这是H7系列独有的“大坑”。

H7的Cache与DMA“坑”详解：STM32H7有独立的指令缓存（I-Cache）和数据缓存（D-Cache）。当你使用DMA从内存（如一个数组）搬运数据到外设（如I2C的DR寄存器）时，CPU写入数组的数据可能还停留在Cache里，并没有真正更新到物理内存（SRAM）中。此时DMA直接从物理内存读取，得到的就是旧数据或随机数据，导致传输错误。解决方法是在启动DMA传输前，调用SCB_CleanDCache_by_Addr函数，将指定内存区域的数据从Cache“清理”（写回）到物理内存。读取数据时则相反，DMA将数据写入物理内存后，需要调用SCB_InvalidateDCache_by_Addr函数“无效化”Cache中对应区域，迫使CPU下次读取时从物理内存重新加载。

我的选择建议：对于EEPROM读写这种通常数据量不大（一次几个到几十个字节）、但可能有长时间等待（写周期）的操作，混合使用阻塞和中断模式是一个务实的选择。对于普通的读操作和拆分后的页写操作，使用阻塞模式，代码简单可靠。对于“写周期等待”这个环节，可以巧妙地使用中断模式：发送一个虚拟的写地址探测包，如果收到NACK（EEPROM忙），就在NACK回调里稍作延时后重试，这样可以避免CPU死等。下文提供的源码将基于阻塞模式实现一个基础稳定版，并会指出如何将其改造成更高效的“中断等待”版本。

4. 从零构建EEPROM驱动层：源码逐行解析

理论铺垫完毕，现在开始动手写代码。我们将在生成的工程中，新建一个eeprom.c和eeprom.h文件，构建我们的驱动层。

4.1 头文件定义与接口设计 (eeprom.h)

#ifndef __EEPROM_H #define __EEPROM_H #ifdef __cplusplus extern "C" { #endif #include "main.h" // 包含HAL库和I2C句柄定义 #include "i2c.h" // 确保有I2C_HandleTypeDef hi2c1 的定义 /* EEPROM型号定义，根据实际使用的芯片选择 */ #define EEPROM_TYPE_AT24C02 256 // 2K bit = 256 Byte #define EEPROM_TYPE_AT24C04 512 #define EEPROM_TYPE_AT24C08 1024 #define EEPROM_TYPE_AT24C16 2048 #define EEPROM_TYPE_AT24C32 4096 #define EEPROM_TYPE_AT24C64 8192 #define EEPROM_TYPE_AT24C128 16384 #define EEPROM_TYPE_AT24C256 32768 #define EEPROM_TYPE_AT24C512 65536 /* 用户配置区：必须根据实际硬件修改！！！ */ #define EEPROM_DEVICE_TYPE EEPROM_TYPE_AT24C512 // 使用的EEPROM型号 #define EEPROM_I2C_HANDLE &hi2c1 // 使用的I2C句柄 #define EEPROM_HARDWARE_ADDR 0x00 // A2A1A0引脚接地，则7位地址为0xA0>>1 = 0x50? 这里先填引脚值。 #define EEPROM_PAGE_SIZE 128 // AT24C512的页大小是128字节 #define EEPROM_WRITE_DELAY 5 // 单次写入周期最大等待时间(ms) /* 根据型号和硬件地址，计算最终的7位器件地址和页大小 */ #if (EEPROM_DEVICE_TYPE <= EEPROM_TYPE_AT24C16) #define EEPROM_PAGE_SIZE_CALC 16 #elif (EEPROM_DEVICE_TYPE <= EEPROM_TYPE_AT24C256) #define EEPROM_PAGE_SIZE_CALC 64 #else #define EEPROM_PAGE_SIZE_CALC 128 // AT24C512 #endif /* 计算器件7位地址。 * 对于24C01/02/04/08/16: 固定高4位1010 + A2A1A0引脚值。 * 对于容量更大的，地址引脚可能部分用于内存地址高位，这里简化处理。 * 假设A2A1A0全部用于器件地址。 */ #define EEPROM_DEV_ADDR_7BIT (0xA0 | (EEPROM_HARDWARE_ADDR << 1)) >> 1 /* 函数声明 */ uint8_t EEPROM_Init(void); uint8_t EEPROM_ReadBytes(uint16_t mem_addr, uint8_t *pData, uint16_t size); uint8_t EEPROM_WriteBytes(uint16_t mem_addr, uint8_t *pData, uint16_t size); uint8_t EEPROM_IsReady(void); #ifdef __cplusplus } #endif #endif /* __EEPROM_H */

关键点解析：

• EEPROM_HARDWARE_ADDR：这里容易搞错。假设你的EEPROM芯片A2,A1,A0引脚都接地，那么它的7位地址是1010000（二进制）= 0x50。但HAL库的Mem系列函数期望的是左移一位后的8位地址（即0xA0）。为了清晰，我们在驱动内部统一使用7位地址思考，在调用HAL函数前再进行移位。所以这里EEPROM_HARDWARE_ADDR应填入引脚值（000=0，001=1...），然后在EEPROM_DEV_ADDR_7BIT宏中计算出7位地址（0x50）。
• 页大小EEPROM_PAGE_SIZE：必须根据你使用的具体型号填写。AT24C02是8，AT24C512是128。这个宏用于后面的分页逻辑。
• EEPROM_IsReady：这个函数将用于查询EEPROM是否忙（处于写周期）。是驱动稳定性的关键。

4.2 核心驱动函数实现 (eeprom.c)

#include "eeprom.h" #include <string.h> // 用于memcpy /* 私有函数声明 */ static uint8_t EEPROM_WaitForWriteComplete(void); static uint16_t EEPROM_GetMemAddrSize(void); /** * @brief 初始化EEPROM，实际上就是检查I2C总线通信是否正常 * @retval 0: 成功, 其他: 失败 (HAL错误码) */ uint8_t EEPROM_Init(void) { return EEPROM_IsReady(); } /** * @brief 检查EEPROM是否就绪（是否处于写周期） * @note 通过发送器件地址（写操作）并检测是否收到ACK来判断 * @retval 0: 就绪, 1: 忙或通信失败 */ uint8_t EEPROM_IsReady(void) { HAL_StatusTypeDef status; uint32_t tickstart = HAL_GetTick(); uint32_t timeout = EEPROM_WRITE_DELAY; // 初始用写周期时间作为超时 /* 循环尝试发送起始条件+器件地址(写)，直到收到ACK或超时 */ do { status = HAL_I2C_IsDeviceReady(EEPROM_I2C_HANDLE, (EEPROM_DEV_ADDR_7BIT << 1), 3, timeout); if (status == HAL_OK) { return 0; // 设备就绪 } HAL_Delay(1); // 等待1ms再试，避免总线拥塞 } while ((HAL_GetTick() - tickstart) < 100); // 总等待时间不超过100ms，防止死锁 return 1; // 超时或失败 } /** * @brief 内部使用的等待写完成函数 * @retval 0: 成功等到, 1: 等待超时 */ static uint8_t EEPROM_WaitForWriteComplete(void) { // 直接复用EEPROM_IsReady函数 return EEPROM_IsReady(); } /** * @brief 获取当前EEPROM型号所需的内存地址字节数 * @retval 1: 8位地址 (<= 256字节), 2: 16位地址 (>256字节) */ static uint16_t EEPROM_GetMemAddrSize(void) { #if (EEPROM_DEVICE_TYPE <= EEPROM_TYPE_AT24C16) // AT24C01/02/04/08/16 使用8位或9-12位地址，但通过器件地址位区分。 // 为简化，对于<=24C16的，我们统一发送两个字节地址（高字节为0）。 // 更精确的做法是根据容量动态计算，但大多数HAL库Mem函数处理两字节地址更通用。 return 2; #else // AT24C32及以上，使用16位（两字节）地址 return 2; #endif } /** * @brief 从EEPROM指定地址读取多个字节 * @param mem_addr: EEPROM内部起始地址 (0 - EEPROM_DEVICE_TYPE-1) * @param pData: 指向存储读取数据缓冲区的指针 * @param size: 要读取的字节数 * @retval 0: 成功, 1: 失败 */ uint8_t EEPROM_ReadBytes(uint16_t mem_addr, uint8_t *pData, uint16_t size) { HAL_StatusTypeDef status; uint16_t mem_addr_size = EEPROM_GetMemAddrSize(); uint32_t dev_addr = EEPROM_DEV_ADDR_7BIT << 1; // 转换为HAL库需要的8位地址格式 if (mem_addr + size > EEPROM_DEVICE_TYPE) { // 地址越界检查 return 1; } // 使用HAL库的存储器读取函数，它会自动发送：Start + 器件地址(写) + 内存地址 + Repeated Start + 器件地址(读) + 读取数据 status = HAL_I2C_Mem_Read(EEPROM_I2C_HANDLE, dev_addr, mem_addr, // 内存地址 mem_addr_size, // 地址字节数，I2C_MEMADD_SIZE_8BIT 或 I2C_MEMADD_SIZE_16BIT pData, size, 100); // 超时时间(ms) return (status == HAL_OK) ? 0 : 1; } /** * @brief 向EEPROM指定地址写入多个字节（自动处理页写边界） * @param mem_addr: EEPROM内部起始地址 * @param pData: 指向待写入数据缓冲区的指针 * @param size: 要写入的字节数 * @retval 0: 成功, 1: 失败 * @note 这是本驱动的核心，包含了分页逻辑和写周期等待 */ uint8_t EEPROM_WriteBytes(uint16_t mem_addr, uint8_t *pData, uint16_t size) { HAL_StatusTypeDef status; uint16_t mem_addr_size = EEPROM_GetMemAddrSize(); uint32_t dev_addr = EEPROM_DEV_ADDR_7BIT << 1; uint16_t bytes_to_write; uint16_t page_offset; uint16_t write_size; uint16_t data_index = 0; if (mem_addr + size > EEPROM_DEVICE_TYPE) { return 1; // 地址越界 } while (size > 0) { // 1. 计算当前页的剩余空间 page_offset = mem_addr % EEPROM_PAGE_SIZE_CALC; bytes_to_write = EEPROM_PAGE_SIZE_CALC - page_offset; // 2. 本次循环实际写入的字节数（取剩余空间和剩余数据的最小值） write_size = (size < bytes_to_write) ? size : bytes_to_write; // 3. 执行单次页写操作 status = HAL_I2C_Mem_Write(EEPROM_I2C_HANDLE, dev_addr, mem_addr, mem_addr_size, &pData[data_index], write_size, 100); // 写入超时 if (status != HAL_OK) { return 1; // 写入失败 } // 4. 等待本次页写完成（EEPROM内部编程周期） if (EEPROM_WaitForWriteComplete()) { return 1; // 等待超时 } // 5. 更新指针和计数器，准备下一次写入 mem_addr += write_size; data_index += write_size; size -= write_size; } return 0; // 全部写入成功 }

源码关键点与避坑指南：

1. EEPROM_IsReady函数的实现：这里没有使用简单的HAL_Delay(EEPROM_WRITE_DELAY)，而是通过HAL_I2C_IsDeviceReady主动轮询。这个函数会发送一个起始条件+器件地址（写），如果EEPROM忙（处于写周期），它会回NACK，函数返回HAL_BUSY或HAL_TIMEOUT。我们循环尝试，直到收到ACK。这样做的好处是，实际等待时间就是EEPROM真正的写周期时间，不会多等。HAL_I2C_IsDeviceReady的第三个参数Trials是尝试次数，这里设为3次；第四个参数Timeout是单次尝试的超时（单位ms），我们传入EEPROM_WRITE_DELAY。循环的总超时设为100ms，防止意外死锁。

2. 内存地址大小的判断：EEPROM_GetMemAddrSize函数。如前面原理所述，对于不同容量的EEPROM，需要发送的内存地址字节数不同。我们做了简化：对于24C16及以下，也发送两字节地址（高字节为0），因为HAL库的I2C_MEMADD_SIZE_16BIT模式兼容性更好。更精确的实现需要根据容量和器件地址引脚的使用情况动态计算，但上述简化在绝大多数情况下工作良好。

3. EEPROM_WriteBytes的分页逻辑：这是稳定写入的灵魂。while (size > 0)循环确保将所有数据写完。在每次循环中：

   • page_offset = mem_addr % EEPROM_PAGE_SIZE_CALC：计算当前写入地址在页内的偏移量。
   • bytes_to_write = EEPROM_PAGE_SIZE_CALC - page_offset：计算当前页还能写入多少字节。
   • write_size = min(size, bytes_to_write)：决定本次实际写入多少字节（不能超过页剩余空间，也不能超过剩余数据量）。
   • 调用HAL_I2C_Mem_Write写入这一页数据。
   • 立即调用EEPROM_WaitForWriteComplete：等待这一页数据被EEPROM真正消化。这是绝对不能省略的步骤！如果不等写完就发起下一次传输，必然失败。
   • 更新地址、数据指针和剩余字节数，进入下一循环。

4. HAL库超时设置：HAL_I2C_Mem_Read/Write的最后一个参数是超时时间（单位ms）。这个时间指的是单次I2C传输序列的超时，不是总时间。对于读操作，可以设短一点（如50ms）。对于写操作，特别是页写，要设得足够长，至少大于一页数据在指定速率下传输所需的时间。例如，在400kHz下写入128字节，理论时间约为(128*9 bits)/400k ≈ 2.9ms，加上起始、停止、地址等开销，设置100ms是安全且充裕的。如果这个超时触发，通常是I2C总线通信出了问题（如线路接触不良、上拉电阻过大、从设备无应答等）。

5. 实战测试、高级优化与深度排错

有了驱动函数，我们还需要编写测试代码来验证其正确性，并探讨如何优化以及遇到问题如何排查。

5.1 基础功能测试与验证

在main.c的while(1)循环之前，添加测试代码：

#include "eeprom.h" #include <stdio.h> // 如果使用printf // 定义一个测试缓冲区 uint8_t write_buffer[256]; uint8_t read_buffer[256]; // 测试函数 void EEPROM_Test(void) { uint16_t i; uint8_t status; // 1. 初始化（检查通信） if(EEPROM_Init() != 0) { printf("EEPROM Init/Connection Failed!\r\n"); return; } printf("EEPROM Init OK.\r\n"); // 2. 准备测试数据 (0x00, 0x01, ... 0xFF) for(i=0; i<256; i++) { write_buffer[i] = i; } // 3. 从地址0开始写入256字节（AT24C02刚好一页，AT24C512会跨页） status = EEPROM_WriteBytes(0, write_buffer, 256); if(status != 0) { printf("EEPROM Write Failed at step 1!\r\n"); return; } printf("EEPROM Write 256 bytes OK.\r\n"); // 4. 清除读缓冲区 memset(read_buffer, 0, sizeof(read_buffer)); // 5. 从地址0读取256字节 status = EEPROM_ReadBytes(0, read_buffer, 256); if(status != 0) { printf("EEPROM Read Failed!\r\n"); return; } printf("EEPROM Read 256 bytes OK.\r\n"); // 6. 比较数据 for(i=0; i<256; i++) { if(read_buffer[i] != write_buffer[i]) { printf("Data mismatch at address %d: Wrote 0x%02X, Read 0x%02X\r\n", i, write_buffer[i], read_buffer[i]); return; } } printf("EEPROM Read/Write Test PASSED!\r\n"); // 7. 测试跨页写入（例如在地址124写入10字节，对于页大小8的芯片会跨页） printf("Testing page boundary write...\r\n"); write_buffer[0] = 0xAA; write_buffer[1] = 0xBB; status = EEPROM_WriteBytes(124, write_buffer, 10); // 假设页大小8，从124写10字节到134，跨页 if(status == 0) { status = EEPROM_ReadBytes(124, read_buffer, 10); if(status == 0 && memcmp(write_buffer, read_buffer, 10) == 0) { printf("Page boundary write test PASSED!\r\n"); } else { printf("Page boundary write test FAILED!\r\n"); } } else { printf("Page boundary write FAILED at write stage!\r\n"); } }

在main函数中初始化所有外设后调用EEPROM_Test()。通过串口观察输出。这个测试覆盖了基本通信、连续读写、以及最重要的跨页写入。

5.2 性能优化：中断模式等待与DMA传输

优化一：用中断模式优化“写等待”阻塞模式的EEPROM_IsReady在等待期间CPU空转。我们可以用中断模式改写它：

volatile uint8_t eeprom_ready_flag = 0; void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c) { if(hi2c->Instance == EEPROM_I2C_HANDLE->Instance) { // 如果是探测地址的传输完成（且收到了ACK），说明设备就绪 // 但HAL_I2C_IsDeviceReady的IT模式没有直接的回调。 // 更优的方法是：在EEPROM_WriteBytes的页写完成后，不调用阻塞Wait，而是启动一个IT模式的Mem_Write，写入0字节数据。 // 在对应的TxCpltCallback里设置ready_flag。 } } void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c) { if(hi2c->Instance == EEPROM_I2C_HANDLE->Instance) { if(hi2c->ErrorCode & HAL_I2C_ERROR_AF) { // NACK错误，说明设备忙 // 可以在这里重启探测，或者设置一个重试机制 } } } // 一个非阻塞的等待函数 uint8_t EEPROM_WaitForWriteComplete_IT(void) { uint32_t tickstart = HAL_GetTick(); eeprom_ready_flag = 0; // 启动一个对设备地址的IT模式写探测（数据长度为0） HAL_I2C_Master_Transmit_IT(EEPROM_I2C_HANDLE, (EEPROM_DEV_ADDR_7BIT << 1), NULL, 0); while(!eeprom_ready_flag) { if((HAL_GetTick() - tickstart) > 100) { return 1; // 超时 } // 这里可以执行其他低优先级任务 // __WFI(); // 或者进入休眠，等待中断唤醒 } return 0; }

然后在HAL_I2C_MasterTxCpltCallback中置位eeprom_ready_flag。这样，在等待EEPROM内部写周期时，CPU可以处理其他任务或进入低功耗模式。

优化二：大数据量读取使用DMA对于连续读取大量数据（如读取整个EEPROM内容），使用DMA可以极大提升效率并降低CPU占用。

uint8_t EEPROM_ReadBytes_DMA(uint16_t mem_addr, uint8_t *pData, uint16_t size) { // 1. 确保DMA和I2C已配置好（CubeMX中配置I2C的DMA请求） // 2. 处理Cache一致性（H7核心步骤！） SCB_CleanInvalidateDCache(); // 最简单粗暴的方式，清理并无效化整个D-Cache。对于特定缓冲区，建议用_by_Addr函数精确操作。 // 3. 启动DMA读取 HAL_StatusTypeDef status = HAL_I2C_Mem_Read_DMA(EEPROM_I2C_HANDLE, (EEPROM_DEV_ADDR_7BIT << 1), mem_addr, EEPROM_GetMemAddrSize(), pData, size); // 4. 等待传输完成（可以用信号量、标志位等在回调函数中通知） // 5. 传输完成后，如果pData会被CPU读取，可能需要SCB_InvalidateDCache_by_Addr return (status == HAL_OK) ? 0 : 1; }

切记：H7上使用DMA必须处理Cache，否则会出现数据不一致的灵异问题。

5.3 常见问题排查清单（FAQ）

当你发现EEPROM读写不正常时，可以按照以下清单逐项排查：

1. 硬件连接：

   • SDA和SCL线是否接反？
   • 上拉电阻是否接了？阻值是否合适？（400kHz用4.7kΩ，1MHz用2.2kΩ）
   • VCC和GND是否稳定？EEPROM的写电压通常有要求（如1.8V-5.5V）。
   • A0,A1,A2地址引脚电平是否与代码中设置的EEPROM_HARDWARE_ADDR一致？

2. 软件配置：

   • I2C时序配置：CubeMX中Timing值是否正确？最稳妥的方法是使用CubeMX的自动计算功能，并输入正确的I2C Clock Frequency。也可以参考ST官方例程或数据手册中的典型值。
   • GPIO速度：是否设置为Very High？
   • 器件地址：代码中的7位地址计算是否正确？用逻辑分析仪或示波器抓取波形，看发出的地址字节是否符合预期。记住：HAL库的Mem_Write/Read函数需要传入(7位地址 << 1)，即8位地址。
   • 页大小：EEPROM_PAGE_SIZE_CALC宏定义是否正确对应你的芯片型号？写函数的分页逻辑依赖于此。

3. 通信过程分析（强烈推荐使用逻辑分析仪）：

   • 抓取I2C波形，检查：
     • **起始条件（S）和停止条件（P）**是否正常。
     • 发送的器件地址（含读写位）是否正确，从设备是否回复了ACK。
     • 发送的内存地址字节数（1个还是2个）和值是否正确。
     • 写数据时，每个数据字节后是否都有ACK。
     • 读数据时，主机在最后一个字节前是否发送了NACK，之后是否发送了停止条件。
   • 如果发现从设备回复NACK，依次检查：地址是否正确、设备是否正在写周期（忙）、电源是否正常、上拉电阻是否太小（导致电流过大）或太大（导致上升沿太慢）。

4. HAL库相关：

   • 超时错误：增大HAL_I2C_Mem_Write/Read的超时参数。
   • 总线错误：检查I2C引脚是否被其他程序复用或冲突。I2C初始化后，总线是否被意外锁死？可以尝试调用HAL_I2C_DeInit再HAL_I2C_Init来复位I2C外设。
   • DMA传输错误：首先检查Cache一致性操作是否做了。其次检查DMA通道配置是否正确，内存和外设的数据宽度是否匹配（通常都是Byte）。

5. EEPROM器件特性：

   • 写保护引脚（WP）：是否被拉高导致写保护使能？
   • 写入次数寿命：EEPROM有写入次数限制（通常100万次）。频繁写入同一地址会导致提前失效。
   • 数据保持时间：通常为10年，但在极端温度下可能缩短。

我个人在调试AT24C512时遇到最诡异的问题是，连续写入超过256字节的数据时，中间偶尔会丢几个字节。用逻辑分析仪抓波形发现，在跨页的瞬间，SCL线上出现了一个不该有的毛刺，导致一个bit数据出错。最终排查发现是SCL线的上拉电阻用了10kΩ，在400kHz速率下上升沿不够陡峭，受到板子上其他数字信号的干扰。换成2.2kΩ电阻后问题彻底消失。所以，硬件是软件稳定的基础，在调试通信协议时，一台逻辑分析仪的价值远超你的想象。