1. 代码开发工具怎么选:HAL 库写 AT24C64 到底省了什么
板子上要存一组掉电不丢的标定参数,选型最后落到 AT24C64 这颗 8KB 的 I2C EEPROM 上,紧接着的分歧是:用代码开发工具链里的 HAL 库 I2C 驱动,还是自己按手册一 Bit 一 Bit 翻 GPIO 时序。我选了前者。CubeMX 生成工程骨架,HAL 接管起始位、地址帧、ACK 应答和超时判定,我只需要在 erom.c 里把 EEPROM 特有的页边界和写周期管住。这条路适合手上已经有一套 HAL 工程、想把 EEPROM 读写收敛成一对可复用 .h/.c 文件的人;如果工程本来就是纯寄存器裸写,或者总线上挂着需要私有时序的从机,这套东西要动的地方就多了,往下看参数和踩坑时会明白为什么。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工程骨架:开发工具生成之后,erom.h 与 erom.c 各放什么
拿到一块新板子,我习惯先把外设驱动切出来单独成对文件,而不是全塞进 main.c。原因很现实:调试阶段你会在 main 里反复改业务逻辑,把 EEPROM 那几十行混进去,改一次编译一次,找问题全靠眼扫。拆成 erom.h / erom.c 之后,这部分就变成黑匣子,只要接口不变,里面怎么调都不影响外面。
这一章要解决的是「骨架怎么摆」。这里有个选择要做:I2C1 的初始化和 MspInit 是自己手写,还是交给 CubeMX 在 i2c.c 里生成。两种都可以,但不能同时存在,后面「排查」一章会专门讲这个坑。
2.1 头文件只开两个口子,别把 hi2c1 摊出去
c复制// erom.h
#ifndef __EROM_H
#define __EROM_H
#include "main.h"
#include <stdint.h>
void MX_I2C1_Init(void);
void AT24C64_Test(void);
#endif
头文件里只有两个声明:一个初始化、一个自检。I2C_HandleTypeDef hi2c1 这个变量本身定义在 erom.c 里,头文件里不出现。
这个安排不是洁癖。如果 hi2c1 定义在头文件里,任何两个 .c 同时包含这个头,链接阶段就是重复定义;如果改成 extern 声明放头文件里,别的模块就能直接抓 hi2c1 去发自己的 I2C 事务,而 EEPROM 的写周期还没走完,两边的时序会互相踩。对外只暴露「初始化」和「自检」,等于把总线使用权收在 erom.c 内部。
#include "main.h" 这一行不能省。I2C_HandleTypeDef、HAL_StatusTypeDef、I2C_MEMADD_SIZE_16BIT、GPIO_AF1_I2C1 这些符号全在 HAL 的头文件链里,而 main.h 通常在 CubeMX 生成时已经把这些带进来了。<stdint.h> 单独包含是为了 uint16_t / uint8_t 不依赖 main.h 的包含顺序。
如果业务层确实要读写参数,正确做法是在这个头文件里继续加 AT24C64_WriteString / AT24C64_ReadString 的声明,而不是把句柄漏出去让业务层自己拼 HAL 调用。
2.2 MX_I2C1_Init:100kHz、7 位地址、先复位再初始化
c复制// erom.c
#include "erom.h"
#include <string.h>
I2C_HandleTypeDef hi2c1;
#define AT24C64_DEV_ADDR 0xA0U
#define AT24C64_PAGE_SIZE 32U
#define AT24C64_TOTAL_SIZE 8192U
#define EEPROM_WRITE_DELAY 5U
void MX_I2C1_Init(void)
{
/* 先强制复位一次 I2C1 外设,清掉上一次调试遗留的总线状态 */
__HAL_RCC_I2C1_FORCE_RESET();
HAL_Delay(1);
__HAL_RCC_I2C1_RELEASE_RESET();
hi2c1.Instance = I2C1;
hi2c1.Init.ClockSpeed = 100000;
hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
hi2c1.Init.OwnAddress1 = 0;
hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
hi2c1.Init.OwnAddress2 = 0;
hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;
HAL_I2C_Init(&hi2c1);
}
ClockSpeed = 100000 是标准模式 100kHz。AT24C64 手册上支持到 400kHz,但 400k 对上升沿、走线长度和上拉阻值都更敏感,先用 100k 把链路打通,等读写稳定了再往上提,是我一贯的顺序。上拉不够、杜邦线太长的时候,400k 的波形用示波器看就是一团斜坡。
DutyCycle 只在快速模式(时钟高于 100k)下有意义,标准模式下填 I2C_DUTYCYCLE_2 只是个合法占位,不影响实际波形。
OwnAddress1 = 0 配合 AddressingMode = 7BIT:这颗 MCU 在总线上是主机,不需要自己的从机地址。DualAddressMode、GeneralCallMode、NoStretchMode 三个都关掉——双地址从机模式、广播呼叫、时钟延展在这条链路上一个都用不上,全开反而多几个不确定因素。
开头那三行 FORCE_RESET / HAL_Delay(1) / RELEASE_RESET 是兜底,不是仪式。调试时常见的情况是:MCU 因为烧录或按复位键重启了,但从机还挂在总线上,SDA 被它拉着不放,这时候直接 HAL_I2C_Init 会卡在 BUSY 状态,或者第一次传输直接超时。先强制复位 I2C1 外设再释放,等于把状态机清回初始,代价只有 1ms。
2.3 HAL_I2C_MspInit:PB8/PB9 必须开漏复用加上拉
c复制void HAL_I2C_MspInit(I2C_HandleTypeDef* hi2c)
{
GPIO_InitTypeDef GPIO_InitStruct = {0};
if (hi2c->Instance == I2C1)
{
__HAL_RCC_I2C1_CLK_ENABLE();
__HAL_RCC_GPIOB_CLK_ENABLE();
GPIO_InitStruct.Pin = GPIO_PIN_8 | GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_OD; /* 开漏复用,不能是推挽 */
GPIO_InitStruct.Pull = GPIO_PULLUP;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
GPIO_InitStruct.Alternate = GPIO_AF1_I2C1;
HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);
}
}
PB8 是 SCL、PB9 是 SDA,复用号 GPIO_AF1_I2C1。
最关键的是 GPIO_MODE_AF_OD。I2C 是线与总线,任何一方拉低,整条线就是低。配成推挽的话,主机输出高电平时如果从机正在拉低,两个输出级直接对顶,轻则波形畸变通信失败,重则把引脚烧掉。开漏配置下引脚只有「拉低」和「放开」两种状态,高电平靠上拉电阻提供,这才是 I2C 该有的电气行为。
Pull = GPIO_PULLUP 打开的是芯片内部弱上拉,量级几十 kΩ。100kHz、板内十几厘米的走线,内部上拉有时候能凑合跑起来,但非常看运气——温度一变、换一批板子就可能不稳。正经做法是板上焊外部上拉,典型 4.7kΩ,内部上拉只是保底。
Speed 设成 GPIO_SPEED_FREQ_HIGH 是为了让引脚翻转的边沿陡一点,配合外部上拉把上升时间压下来。
这个函数叫 HAL_I2C_MspInit,是 HAL 的弱函数回调,HAL_I2C_Init 内部会调它。名字固定,不能改。这就引出前面说的那个选择:CubeMX 勾了 I2C1 之后,它会在 i2c.c 里同样生成一份 MX_I2C1_Init 和 HAL_I2C_MspInit。要么用 CubeMX 的、把 erom.c 里这两段删掉,要么关了 CubeMX 的 I2C1 生成、保留手写版本。两份同时存在,链接器会直接报重复定义。
3. 读写原语:HAL_I2C_Mem_Write / Read 的参数逐个对齐
骨架搭好之后,真正落到 EEPROM 上的只有两类动作:往某个地址写若干字节,从某个地址读若干字节。HAL 把这两件事抽象成 HAL_I2C_Mem_Write 和 HAL_I2C_Mem_Read,参数一共七个,其中三个特别容易填错:设备地址、内存地址宽度、超时。
这一章把这几个参数拆开看,每个都说清楚为什么这么填、填错会怎样。
3.1 设备地址 0xA0 还是 0x50:HAL 要的是 8 位写法
AT24C64 的 7 位从机地址是 0x50(A2/A1/A0 三个引脚全接地时)。但 HAL 的 DevAddress 参数要的是左移一位之后的 8 位写法,也就是写操作 0xA0、读操作 0xA1。
c复制#define AT24C64_DEV_ADDR 0xA0U
HAL 内部会把这个值右移一位塞进地址寄存器,总线上出现的就是 0x50。如果直接把 0x50 填进去,HAL 再右移一位变成 0x28,从机根本不应答,HAL_I2C_IsDeviceReady 会一直返回 HAL_ERROR,而你会以为是接线问题,拿着万用表量半天。
HAL_I2C_Mem_Write 内部会把最低位清 0 做写、HAL_I2C_Mem_Read 会把最低位置 1 做读,所以外面统一填 0xA0,不用自己区分读写地址。
3.2 16 位内存地址:I2C_MEMADD_SIZE_16BIT 不能省
AT24C64 是 64Kbit = 8KB,地址范围 0x0000 到 0x1FFF,一共 13 位。所以每次读写之前,必须先发两个字节的内存地址(高字节在前、低字节在后),这是器件的硬性协议。
HAL 用 MemAddSize 这个参数控制发几个字节:
c复制I2C_MEMADD_SIZE_16BIT /* 发 2 字节内存地址,AT24C64 用这个 */
I2C_MEMADD_SIZE_8BIT /* 只发 1 字节,小容量 EEPROM 才用 */
传成 I2C_MEMADD_SIZE_8BIT 的后果很隐蔽:HAL 只发低 8 位地址,高 5 位直接丢掉。你想写 0x1100,实际发出去的是 0x00,数据写进了 0x0000。读的时候同样,读 0x1200 读回来的是 0x0000 的内容。整个过程不报错、状态全是 HAL_OK,只有对数据的时候才发现全错位了。
3.3 单字节读写与返回值检查
c复制/* 等待 EEPROM 内部写周期结束:轮询设备是否重新应答 */
static HAL_StatusTypeDef AT24C64_WaitReady(void)
{
uint32_t timeout = 100; /* 总超时 100ms */
uint32_t tickstart = HAL_GetTick();
while (HAL_I2C_IsDeviceReady(&hi2c1, AT24C64_DEV_ADDR, 1, 10) != HAL_OK)
{
if ((HAL_GetTick() - tickstart) > timeout) return HAL_TIMEOUT;
HAL_Delay(1);
}
return HAL_OK;
}
/* 单字节写:写完必须等 5ms 写周期 */
HAL_StatusTypeDef AT24C64_WriteByte(uint16_t addr, uint8_t data)
{
if (addr >= AT24C64_TOTAL_SIZE) return HAL_ERROR;
HAL_StatusTypeDef status = HAL_I2C_Mem_Write(&hi2c1, AT24C64_DEV_ADDR, addr,
I2C_MEMADD_SIZE_16BIT, &data, 1, 100);
if (status == HAL_OK) HAL_Delay(EEPROM_WRITE_DELAY);
return status;
}
/* 单字节读:读操作不触发写周期,不需要延时 */
HAL_StatusTypeDef AT24C64_ReadByte(uint16_t addr, uint8_t* data)
{
if (addr >= AT24C64_TOTAL_SIZE || data == NULL) return HAL_ERROR;
return HAL_I2C_Mem_Read(&hi2c1, AT24C64_DEV_ADDR, addr,
I2C_MEMADD_SIZE_16BIT, data, 1, 100);
}
三个参数的含义:
addr 用 uint16_t 而不是 uint8_t,因为 8192 已经超出 8 位范围。函数入口先判 addr >= AT24C64_TOTAL_SIZE,越界直接返回 HAL_ERROR,不让它发到总线上变成一个无意义的地址。
最后一个参数 100 是 HAL 单次传输的超时,单位毫秒。100ms 对 100kHz 下传几个字节来说非常宽裕,正常情况几十微秒就完成了。设这么大是为了防止从机被拉死时 HAL 卡在里面出不来——超时之后返回 HAL_TIMEOUT,至少你能拿到返回值去做处理。
写和读的差别就在那句 HAL_Delay(EEPROM_WRITE_DELAY)。读不改变器件内部状态,读完立刻可以读下一次;写不行,下面一章专门讲。
4. 页写边界与写周期:AT24C64 最容易翻车的两件事
前面那几个函数只能一次动一个字节。真要存一段结构体或者一串字符,逐字节写会非常慢——每个字节后面都得等 5ms,写 100 字节就是半秒。批量写要用页写,而页写有两个必须自己处理的约束:跨页会回卷,写完要等周期。
这两个约束都不是 HAL 帮你兜的,HAL_I2C_Mem_Write 只管把字节发出去,器件内部怎么组织它不管。
4.1 32 字节页回卷:为什么 WritePage 必须自己拆
AT24C64 的页大小是 32 字节。页写的协议是:你先发一个起始地址,然后连续发 N 个字节,器件内部地址计数器自动加一。问题在于,当计数器走到本页末尾(地址低 5 位从 31 回到 0)时,它不会进位到下一页,而是回卷到本页起始,继续覆盖前面刚写进去的数据。
举个具体的:从 0x1105 开始写 40 字节。0x1105 在页 0x1100~0x111F 内的偏移是 5,本页只剩 27 个字节的 space。第 28 个字节会写到 0x1100,把第 1 个字节覆盖掉;第 40 个字节写到 0x110C。最终结果是后 13 字节把前 13 字节冲了,读出来一团乱。
所以拆页这件事必须由驱动层做:
c复制HAL_StatusTypeDef AT24C64_WritePage(uint16_t addr, uint8_t* data, uint16_t size)
{
if (addr >= AT24C64_TOTAL_SIZE || data == NULL || size == 0) return HAL_ERROR;
/* 页首地址:把地址低 5 位清零 */
uint16_t page_start = addr & ~(AT24C64_PAGE_SIZE - 1);
uint16_t page_end = page_start + AT24C64_PAGE_SIZE;
/* 本次写入会跨页,拆成两段递归 */
if ((addr + size) > page_end)
{
uint16_t first_part = page_end - addr; /* 当前页还能写多少 */
uint16_t second_part = size - first_part; /* 剩下的留给下一页 */
HAL_StatusTypeDef status = AT24C64_WritePage(addr, data, first_part);
if (status != HAL_OK) return status;
HAL_Delay(EEPROM_WRITE_DELAY); /* 第一段写完要等周期 */
return AT24C64_WritePage(addr + first_part, data + first_part, second_part);
}
/* 不跨页,直接一次发完 */
HAL_StatusTypeDef status = HAL_I2C_Mem_Write(&hi2c1, AT24C64_DEV_ADDR, addr,
I2C_MEMADD_SIZE_16BIT, data, size, 100);
if (status == HAL_OK) HAL_Delay(EEPROM_WRITE_DELAY);
return status;
}
addr & ~(AT24C64_PAGE_SIZE - 1) 就是 addr & ~31,等价于 addr & 0xFFE0,把低 5 位清零,得到本页页首。page_end = page_start + 32 是下一页的起点。
判断条件 (addr + size) > page_end 表示这次写会越过页尾。此时 first_part = page_end - addr 正好是当前页剩余空间,先写这一段;剩下的 second_part 从 addr + first_part 开始,也就是下一页的页首,递归处理。
拿两个例子对一遍就清楚了:
| 起始地址 | 写入长度 | 页范围 | 第一段 | 第二段 |
|---|---|---|---|---|
0x1100 |
40 | 0x1100~0x111F |
32 字节 → 0x1100 |
8 字节 → 0x1120 |
0x1105 |
40 | 0x1100~0x111F |
27 字节 → 0x1105 |
13 字节 → 0x1120 |
第一行是页对齐的情况,第二行是页内偏移的情况,两行都能正确落到两个物理页上。
递归写法有个副作用要清楚:如果一次写 200 字节,会递归拆成 7 段,每段之间都 HAL_Delay(5),累计 35ms 左右。这是页写的物理限制,绕不过去。真要快,就让上层按页对齐来组织数据,每 32 字节一次调用,避免跨页拆分的额外延时。
还有一点:递归深度没做限制。8192 字节全写一次的话会递归 256 层,虽然每层栈开销不大,但这种用法本身就不合理,正常场景不会这么调。
4.2 5ms 写周期:WaitReady 轮询和固定延时怎么选
EEPROM 的写操作不是发完字节就结束。器件收到数据后要在内部做擦写,这段时间它不响应任何 I2C 命令,包括自己的设备地址——也就是说,你紧接着发下一笔,从机会直接 NAK,HAL 返回 HAL_ERROR。
AT24C64 的这个周期典型值是 5ms,最大值的具体数字要看手册,一般按 5ms 留余量。处理方式有两种:
固定延时,就是 AT24C64_WriteByte 和 AT24C64_WritePage 里的 HAL_Delay(EEPROM_WRITE_DELAY)。优点是简单、不占总线;缺点是慢,而且 5ms 是典型值,某些批次的芯片或者低温环境下可能更久,固定延时在边界情况下会失效。
ACK 轮询,就是 AT24C64_WaitReady 里的 HAL_I2C_IsDeviceReady。它发一个空地址帧,从机如果已经准备好就回 ACK,返回 HAL_OK;如果还在写,就 NAK,返回错误。轮询到 ACK 就说明可以继续了,实际等待时间通常比 5ms 短。
c复制while (HAL_I2C_IsDeviceReady(&hi2c1, AT24C64_DEV_ADDR, 1, 10) != HAL_OK)
这四个参数分别是:句柄、设备地址(同样是 8 位写法 0xA0)、试验次数 1、单次超时 10ms。试验次数填 1 是因为外层已经有 while 循环了,不需要 HAL 内部再重试。
外层循环里每失败一次 HAL_Delay(1),累计超过 100ms 就判 HAL_TIMEOUT。这个 100ms 是兜底:如果芯片虚焊、地址配错、或者总线被拉死,轮询会无限循环下去,整个系统就卡在这里。有了超时至少能返回错误码,让上层决定是重试还是报故障。
两种方式在工程里可以混用:单字节写用固定延时图省事,批量写和上电自检用 WaitReady 图可靠。我在 AT24C64_Test 里就是写完调一次 AT24C64_WaitReady(),再读回来比对。
4.3 字符串读写:长度里那个 +1 和 max_len 的边界
存字符串是最常见的需求,比如设备名、标定日期、序列号。这里有两个细节容易忽略。
c复制HAL_StatusTypeDef AT24C64_WriteString(uint16_t addr, const char* str)
{
uint16_t len = strlen(str) + 1; /* +1 把 '\0' 也写进去 */
if (addr + len > AT24C64_TOTAL_SIZE || str == NULL) return HAL_ERROR;
return AT24C64_WritePage(addr, (uint8_t*)str, len);
}
HAL_StatusTypeDef AT24C64_ReadString(uint16_t addr, char* str, uint16_t max_len)
{
if (addr + max_len > AT24C64_TOTAL_SIZE || str == NULL) return HAL_ERROR;
return AT24C64_ReadSequential(addr, (uint8_t*)str, max_len);
}
strlen(str) + 1 里的 +1 是把字符串结尾的 '\0' 一起写进去。少了这个 1,读回来的时候缓冲区里没有结束符,strcmp 会一直往后扫,扫到脏数据才停,表现就是「字符串比对莫名失败」或者「读出来的内容后面跟着乱码」。多写一个字节,换来读回来能直接当 C 字符串用。
AT24C64_ReadString 的越界检查用的是 max_len 而不是实际字符串长度——函数不知道里面存了多长,只能用缓冲区大小作为上界。这个检查偏保守:如果 addr 在 0x1FF0 附近,max_len 传 32,addr + 32 > 8192 会直接返回 HAL_ERROR,哪怕里面实际只存了 5 个字符。所以靠近器件末尾的区域不要拿来存字符串,规划地址时就把字符串区放在前面。
顺序读的底层:
c复制HAL_StatusTypeDef AT24C64_ReadSequential(uint16_t addr, uint8_t* data, uint16_t size)
