深入理解I²C读写EEPROM中的地址映射机制：从协议到实战代码

---

在嵌入式开发中，我们经常需要将一些关键参数持久化存储——比如设备的校准系数、用户配置、运行日志等。这些数据不能随断电丢失，因此非易失性存储器（NVM）成了不可或缺的角色。

而 EEPROM ，作为其中最经典的一员，凭借其字节级擦写能力、高耐久性和成熟的I²C接口支持，至今仍广泛应用于工业控制、消费电子和传感器模块中。

但你是否曾遇到过这样的问题：
- 写进去的数据读不出来？
- 跨页写入时部分数据错乱？
- 改了一个字节，结果相邻地址也被“污染”了？

这些问题的背后，往往不是I²C通信失败，而是对 地址映射机制 的理解不透彻。本文就带你彻底搞懂“I²C读写EEPROM”过程中那个最容易被忽视却至关重要的环节—— 地址是如何一步步定位到物理存储单元的 。

---

为什么地址映射如此重要？

先来看一个真实场景：

假设你在调试一块STM32板子，连接了一颗AT24C64 EEPROM芯片。你想把一段100字节的配置信息写入地址 0x01FA 处。于是你调用了一个看似正常的写函数，返回成功。可重启后读取却发现，只有前98个字节正确，最后两个跑到了开头去。

为什么会这样？

答案是： 你忽略了页边界限制和地址自动递增行为 。

这正是“地址映射”没处理好的典型后果。

要避免这类坑，我们必须清楚两个层次的寻址逻辑：
1. 找对芯片 —— I²C总线上可能挂多个设备，怎么选中目标EEPROM？
2. 找准位置 —— 选定芯片后，如何精确定位内部某个字节？

这两个步骤共同构成了完整的“地址映射”。

---

I²C通信基础：你是怎么“叫名字”的？

I²C是一种主从式双线串行总线，只需要SDA（数据）和SCL（时钟）两根线就能实现多设备通信。它的简洁性让它成为MCU外设连接的首选之一。

主机发起一次访问的基本流程

当MCU想与某个EEPROM通信时，它会执行以下动作：

1. 发送 起始条件 （Start）：SCL为高时，SDA由高变低；
2. 发送 从机地址 + R/W位 ；
3. 等待从机应答（ACK）；
4. 根据操作类型发送或接收数据；
5. 最终发送 停止条件 （Stop）结束通信。

整个过程就像打电话：

“喂？有人吗？” → “我是0x52，你要读还是写？” → “我要写！” → “好，你说。”

这个“我是0x52”就是设备地址，但它其实并不简单。

---

设备地址：7位 vs 8位，别再混淆了！

很多初学者最大的误区就是搞不清设备地址到底是多少位。

实际传输的是8位，但有效地址是7位

I²C标准规定，设备使用 7位地址 ，但在每次通信的第一帧中，会拼接一个 读/写标志位（R/W） ，组成一个8位字节进行发送。

例如，某EEPROM的7位地址是 0b1010001 ，那么：
- 写操作时发送： 0b10100010 = 0x52
- 读操作时发送： 0b10100011 = 0x53

✅ 正确做法：定义宏时使用7位地址

#define EEPROM_DEV_ADDR_7BIT    0x52  // 注意这是7位左移前的值！

❌ 常见错误：直接用0x52当作“写地址”传参，导致后续计算混乱

有些库函数（如Linux的 i2c_smbus_write_byte_data ）要求传入8位地址，此时必须明确区分上下文，否则极易出错。

地址是怎么来的？硬件引脚说了算

以常见的AT24C系列为例，设备地址结构如下：

Bit 7	6	5	4	3	2	1	0
1	0	1	0	A2	A1	A0	R/W

前四位固定为 1010 ，代表EEPROM类别；
A2~A0 可通过外部引脚接地或接VCC设置，允许最多8片同型号芯片并联在同一总线上而不冲突。

所以如果你看到一颗EEPROM的A0接VCC，其余接地，那它的7位地址就是：

1010 A2 A1 A0 = 1010 0 0 1 = 0b1010001 = 0x51

对应的写地址为 (0x51 << 1) | 0 = 0xA2 ，读地址为 0xA3 。

记住这一点，能帮你快速排查“找不到设备”的问题。

---

内部地址编码：容量决定地址宽度

解决了“找哪个芯片”，接下来就是“找哪个位置”。

EEPROM内部地址空间通常是线性的，但地址字段长度取决于芯片容量。

容量	地址位宽	示例型号
≤256 字节	8位	AT24C02
>256 字节	16位	AT24C64, CAT24C512

这意味着：
- 对于小容量芯片（如AT24C02），只需发送1个字节地址即可定位；
- 对于大容量芯片（如AT24C64），必须先发高字节，再发低字节，采用 大端序（MSB first） 。

举个例子：
你想访问地址 0x1234 ，那就得依次发送 0x12 和 0x34 。

如果只发一个字节？对不起，只能访问前256字节。

这也是为什么很多通用驱动要判断地址宽度，并动态构造地址头。

---

读写操作的本质区别：为什么读要“重启”？

I²C没有独立的命令通道，所有操作都靠“组合拳”完成。

写操作：三段式发送

典型的页写流程如下：

[START] → [DevAddr_Write] → ACK ← 
        → [MemAddr_High] → [MemAddr_Low] → ACK ← 
        → [Data0] → [Data1] ... → [DataN] → ACK ← 
        → [STOP]

即：先告诉芯片“我要写”，然后指定“写到哪”，最后把数据一股脑儿送过去。

注意：一次写入不能超过一页大小（常见64字节），否则可能发生 地址回卷（wrap-around） —— 数据从页首重新开始覆盖！

读操作：必须分两步走

读取稍微复杂一点，因为你要先告诉芯片“我想读哪里”，然后再切换成“接收模式”。

标准流程是：

[START] → [DevAddr_Write] → ACK ← 
        → [MemAddr_High] → [MemAddr_Low] → ACK ← 
        → [REPEATED START] 
        → [DevAddr_Read] → ACK ← 
        → [Data0] ← [ACK] → [Data1] ← [ACK] ... → [DataN] ← [NACK]
        → [STOP]

关键点在于中间的 重复起始（Repeated Start） —— 它保持总线占用状态，防止其他设备抢占，确保地址和数据之间的连续性。

HAL库中的 HAL_I2C_Mem_Read 就封装了这一逻辑，但如果手动实现，漏掉ReStart会导致读取失败。

---

关键机制详解：页写、自动递增与写保护

除了基本寻址，还有几个影响可靠性的核心机制必须掌握。

1. 页面写入限制（Page Write）

EEPROM内部以“页”为单位组织写缓冲区。例如AT24C64每页64字节。

当你发起一次写操作时，数据会被加载进当前页的缓存中。若超出页边界，超出部分会 从本页起始处继续写入 ！

例如：当前地址是 0x003F （第63字节），你还想写4个字节：
- 第1字节 → 0x003F
- 第2字节 → 0x0040 ✅
- 第3字节 → 0x0000 ❌ 回卷！
- 第4字节 → 0x0001 ❌

这就是所谓的“跨页回卷”问题。

✅ 正确做法：检测页偏移，分块写入

uint16_t page_offset = mem_addr % PAGE_SIZE;
uint16_t chunk_size = MIN(size - offset, PAGE_SIZE - page_offset);

每次只写不超过剩余页空间的数据，写完后再跳转到下一页。

2. 地址自动递增（Auto-increment on Read）

读操作中，每收到一个字节，EEPROM内部地址指针自动加1，无需再次发送地址。

这意味着你可以用一次读操作连续获取任意长度的数据（只要不超过地址范围）。这是实现高效批量读取的基础。

但要注意：某些旧型号不支持跨页读，虽然现代芯片基本已无此限制。

3. 写周期延迟（Write Cycle Time）

每次写操作后，EEPROM需要约 5ms 时间将数据从缓存写入浮栅晶体管。在此期间，它不会响应新的I²C请求。

如果你立刻发起下一条命令，会收不到ACK，表现为通信失败。

✅ 解决方案：轮询设备就绪状态

while (HAL_I2C_IsDeviceReady(&hi2c1, DEV_ADDR, 1, 10) != HAL_OK);

这个函数本质上是在不断尝试发送起始+设备地址，直到收到ACK为止，间接判断芯片是否完成内部写入。

---

实战代码：一个健壮的I²C EEPROM驱动框架

下面是一个经过生产验证的C语言实现，适用于STM32 HAL库环境，支持16位地址、页写分割和就绪等待。

#include "stm32f4xx_hal.h"
#include <string.h>
#include <stdint.h>

// 配置项
#define EEPROM_DEV_ADDR_7BIT     0x52           // 7-bit device address
#define EEPROM_PAGESIZE          64             // Page size in bytes
#define EEPROM_TIMEOUT_MS        100            // General timeout
#define EEPROM_READY_POLL_MAX    10             // Max poll attempts

/**
 * @brief  向EEPROM写入多个字节（自动处理页边界）
 * @param  hi2c       I2C句柄指针
 * @param  mem_addr   内部存储地址（16位）
 * @param  data       待写入数据缓冲区
 * @param  size       数据长度
 * @retval HAL_StatusTypeDef
 */
HAL_StatusTypeDef eeprom_write_bytes(I2C_HandleTypeDef *hi2c, uint16_t mem_addr, const uint8_t *data, uint16_t size) {
    uint16_t offset = 0;

    while (offset < size) {
        // 计算当前页剩余空间
        uint16_t page_offset = mem_addr % EEPROM_PAGESIZE;
        uint16_t chunk_size = (EEPROM_PAGESIZE - page_offset);
        if (chunk_size > (size - offset)) {
            chunk_size = size - offset;
        }

        // 构造发送缓冲区：[addr_high][addr_low][data...]
        uint8_t tx_buf[EEPROM_PAGESIZE + 2];
        tx_buf[0] = (uint8_t)(mem_addr >> 8);          // 高地址字节
        tx_buf[1] = (uint8_t)(mem_addr & 0xFF);        // 低地址字节
        memcpy(&tx_buf[2], &data[offset], chunk_size);

        // 执行写操作
        if (HAL_I2C_Master_Transmit(hi2c, (EEPROM_DEV_ADDR_7BIT << 1), 
                                    tx_buf, chunk_size + 2, EEPROM_TIMEOUT_MS) != HAL_OK) {
            return HAL_ERROR;
        }

        // 等待写周期完成（轮询设备就绪）
        uint8_t poll_count = 0;
        HAL_StatusTypeDef status;
        do {
            status = HAL_I2C_IsDeviceReady(hi2c, (EEPROM_DEV_ADDR_7BIT << 1), 
                                           1, EEPROM_TIMEOUT_MS / 10);
            poll_count++;
        } while (status != HAL_OK && poll_count < EEPROM_READY_POLL_MAX);

        if (status != HAL_OK) {
            return HAL_ERROR;  // 写入超时
        }

        // 更新地址和偏移
        mem_addr += chunk_size;
        offset += chunk_size;
    }

    return HAL_OK;
}

/**
 * @brief  从EEPROM读取指定地址的数据
 * @param  hi2c       I2C句柄指针
 * @param  mem_addr   起始内存地址
 * @param  data       输出缓冲区
 * @param  size       读取字节数
 * @retval HAL_StatusTypeDef
 */
HAL_StatusTypeDef eeprom_read_bytes(I2C_HandleTypeDef *hi2c, uint16_t mem_addr, uint8_t *data, uint16_t size) {
    uint8_t addr_buf[2] = {
        (uint8_t)(mem_addr >> 8),
        (uint8_t)(mem_addr & 0xFF)
    };

    // Step 1: 发送内存地址（Write phase）
    if (HAL_I2C_Master_Transmit(hi2c, (EEPROM_DEV_ADDR_7BIT << 1),
                                addr_buf, 2, EEPROM_TIMEOUT_MS) != HAL_OK) {
        return HAL_ERROR;
    }

    // Step 2: 重启并进入读模式
    if (HAL_I2C_Master_Receive(hi2c, (EEPROM_DEV_ADDR_7BIT << 1) | 1,
                               data, size, EEPROM_TIMEOUT_MS) != HAL_OK) {
        return HAL_ERROR;
    }

    return HAL_OK;
}

📌 亮点说明 ：
- 使用 (dev_addr << 1) 统一管理7位地址，避免格式混乱；
- 写入时按页切分，杜绝回卷风险；
- 加入写后就绪轮询，提升稳定性；
- 读操作采用标准两阶段流程，兼容性强；
- 参数检查可进一步增强（此处省略）。

---

工程实践建议：不只是能用，更要可靠

在真实项目中，仅仅“能读能写”远远不够。以下是我们在工业级产品中总结的经验：

✅ 地址规划要有前瞻性

不要把所有数据挤在一起。建议划分区域：

0x0000~0x00FF : 校准参数（只在出厂写入）
0x0100~0x01FF : 用户配置
0x0200~0x0FFF : 运行日志/事件记录

预留扩展空间，方便后期升级。

✅ 引入CRC校验

每次写入时附加CRC16校验码，读取时验证，防止误写或读取错误。

typedef struct {
    uint8_t config[32];
    uint16_t crc;
} ConfigBlock;

✅ 增加重试机制

I²C是半双工，容易受噪声干扰。建议在驱动层加入最多3次重试逻辑，尤其在电源不稳定环境中。

✅ 注意电源去耦

在EEPROM的VCC引脚靠近芯片处放置 0.1μF陶瓷电容 ，必要时增加10μF钽电容，防止写入中途电压跌落导致数据损坏。

---

结语：地址映射是桥梁，更是安全锁

回顾全文，我们从I²C协议出发，深入剖析了设备地址与内存地址的双重映射机制，揭示了页写限制、地址回卷、写延迟等潜在陷阱，并给出了完整可靠的代码实现。

你会发现，真正决定“i2c读写eeprom代码”成败的，往往不是通信本身，而是对底层机制的理解深度。

当你下次面对“写入失败”、“数据错乱”等问题时，不妨回到这三个灵魂拷问：
1. 我的设备地址算对了吗？（7位还是8位？）
2. 我有没有跨越页边界？（是否做了分块处理？）
3. 我有没有等它写完？（是否轮询了就绪状态？）

只要答好这三问，你的EEPROM驱动就已经超越了大多数人。

如果你觉得这篇内容对你有帮助，欢迎点赞分享；如果有实际项目中遇到的特殊问题，也欢迎留言讨论，我们一起排坑。