1. 参数一掉电就复位:我用代码开发工具把 I2C 存储链路补上
STM32CubeMX 这类代码开发工具,价值不在替你点出几个初始化函数,而在于把时钟树、外设句柄、中断优先级这些最容易配错的东西固化成一份能复查的工程骨架。手上这块小板子要记两个参数:亮度档位和蜂鸣器开关,掉电不能丢,存储用的是 I2C 接口的 AT24C02。真正花时间的不是写出读和写这两个函数,而是把工具生成的骨架、手写的驱动层和上电自检串成一条能反复验证的链路。下面按我实际走的顺序拆:先配工具,再补驱动,然后踩坑,最后把验证固定成流程。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 代码开发工具先出骨架:STM32CubeMX 里 I2C1 的配置与生成物
2.1 先认器件:地址、页大小和容量,决定 CubeMX 里怎么填
配外设之前先把要挂上去的器件读明白,否则 CubeMX 里那几个下拉框只能靠猜。AT24C02 的容量是 2Kb,换算成字节是 256 B,内部按 8 字节一页切成 32 页,字节地址范围 0~255。器件地址在头文件里给了两组写法:写地址 0xA0、读地址 0xA1,这是把 7 位器件地址左移一位再补上读写位得到的 8 位形式,把 0xA0 右移一位就是真正的 7 位地址 0x50。
这几个数字直接决定了 CubeMX 里三项配置。地址模式选 7 位,因为所有标准 I2C EEPROM 都是 7 位地址器件,10 位地址模式在这里只会让后面的传参变得别扭。存储器地址宽度在驱动层体现为 I2C_MEMADD_SIZE_8BIT,因为片内地址只有一个字节,超不过 255,用 16 位地址宽度发出去会多一个字节,器件直接不应答。速率不追求快,先用标准模式把读写跑通,长走线或者上拉偏弱的板子上尤其如此,等确认数据稳定再考虑提速。
| CubeMX 里的项 | 取值 | 依据 |
|---|---|---|
| I2C 模式 | I2C | 器件是标准两线接口 EEPROM |
| 地址位数 | 7 位 | 0xA0 右移一位即 0x50 |
| 外设速率 | 先标准模式 | 弱上拉、长走线时先求稳 |
| 中断 / DMA | 先不开 | 轮询足够,失败路径更少 |
| USART | 打开一路 | 用来打印读写结果,必须有 |
上表最后一行容易被忽略。很多人配完 I2C 就直接烧程序,结果驱动返回失败也看不见,只能靠点灯猜。工具链本身不产生任何可观测输出,得先把串口配出来,后面每一步才有反馈。
2.2 生成代码的边界:哪些写在 USER CODE 里,哪些每次生成都会没
CubeMX 生成的是骨架,不是成品。它会在 main.c 里按顺序调用 HAL_Init()、SystemClock_Config()、MX_GPIO_Init()、MX_I2C1_Init()、MX_USART2_UART_Init(),这个顺序不是随便排的:时钟没配好,I2C 的分频算不出来;I2C 没初始化,句柄 hi2c1 里的状态机和外设寄存器都是空的,第一次调用读写必然超时。
c复制/* main.c 中由工具生成、不要手工调整顺序的初始化段 */
HAL_Init(); /* 复位外设、初始化 SysTick */
SystemClock_Config(); /* 时钟树,必须在所有外设之前 */
MX_GPIO_Init(); /* GPIO,含 I2C 引脚复用 */
MX_I2C1_Init(); /* 生成 hi2c1 句柄与外设寄存器配置 */
MX_USART2_UART_Init(); /* 生成 huart2,供 printf 使用 */
这段代码的意思很直白:所有 MX_xxx_Init() 都是工具根据 .ioc 文件生成的,函数体里的分频系数、上升时间、地址模式都和你填的表一一对应。想改速率就回 .ioc 改完重新生成,别在 MX_I2C1_Init() 里手改寄存器,下一次生成会被原样覆盖,改了个寂寞。
真正该动手的是 USER CODE BEGIN 和 USER CODE END 之间的区域,工具重新生成时会保留这一段。驱动代码我一般不放 main.c,单独建 AT24C02.c 和 AT24C02.h,在工程里加入编译即可;CubeMX 不需要知道这两个文件的存在,它只负责外设初始化,业务代码归业务代码。这样重新生成十次,驱动也不会丢一行。
提示:新建的
.c文件记得确认已经加进编译列表,头文件所在目录也加进包含路径,否则报的是“找不到标识符”而不是“文件不存在”,排查方向容易跑偏。
2.3 让工具链先说话:串口 printf 与第一次空跑
工程骨架出来后,第一件事不是写驱动,是让串口能打印。工具生成的 huart2 只是把外设配好了,标准库的 printf 还不知道往哪送,需要补一个字符级重定向。常见做法是重写 fputc,把单个字符丢给 HAL_UART_Transmit 发出去。
c复制#include "stdio.h"
/* 把 printf 的字符重定向到 USART2,供调试输出使用 */
int fputc(int ch, FILE *f)
{
uint8_t c = (uint8_t)ch;
HAL_UART_Transmit(&huart2, &c, 1, 100); /* 阻塞发送,超时 100ms */
return ch;
}
参数含义:&huart2 是工具生成的串口句柄,注意别写成 &huart1;&c 是要发的这一个字节;长度固定为 1;最后一个参数是超时,给 100 ms 足够,串口堵死时也不会把主循环卡住太久。
写完先烧一次,只打印一行字符串。这一步看着没技术含量,却是后面所有排查的地基:读写函数返回什么、读回的字节是什么、失败在哪一块,全靠这行输出。如果串口一片空白,先确认重定向函数有没有被链接进去(有些工程会因为没用标准库而把 fputc 优化掉),再看工程有没有勾选精简 C 库,这两处是新手最常翻车的地方。
3. 代码开发工具生成的 HAL 不够用:把 AT24C02 驱动写成人能维护的样子
3.1 HAL_I2C_Mem_Read / Mem_Write 的五个参数逐个数
HAL 提供了存储器读写专用接口,省掉了自己拼“起始条件 + 器件地址 + 片内地址 + 数据”的时序,但参数一个都不能填错。HAL_I2C_Mem_Read 的原型里,句柄之后依次是器件地址、片内地址、片内地址长度、接收缓冲区、读取长度、超时。
c复制/* AT24C02.h:只保留必要的两个宏和一个结构体 */
#define AT24C02_WRITE_ADDRESS 0xA0 /* 8 位左对齐写法 */
#define AT24C02_READ_ADDRESS 0xA1
typedef struct EEPROM_ST
{
uint8_t init_flag; /* 是否已写过默认值 */
uint8_t led_setting_status; /* 亮度档位 */
uint8_t buzzer_setting_status; /* 蜂鸣器开关 */
} EEPROM_DATA;
extern EEPROM_DATA eerom_data;
int AT24C02_Read(uint16_t ReadAddr, uint8_t *pBuffer, uint16_t NumToRead);
int AT24C02_Write(uint16_t WriteAddr, uint8_t *pBuffer, uint16_t NumToWrite);
void Default_Setting(void);
头文件里这段注释值得留:0xA0 是写地址、0xA1 是读地址,但 HAL 的 DevAddress 参数要的是 8 位左对齐形式,方向位由 HAL 自己按读写方向补,所以传 0xA0 还是 0xA1 在 HAL 内部只有高 7 位有效。两个宏都定义着,是为了让代码读起来语义清楚,不是真的需要在调用时切换。
c复制/* AT24C02.c:读函数,参数含义见下方说明 */
int AT24C02_Read(uint16_t ReadAddr, uint8_t *pBuffer, uint16_t NumToRead)
{
HAL_StatusTypeDef ret = HAL_ERROR;
ret = HAL_I2C_Mem_Read(&hi2c1, /* 工具生成的 I2C 句柄 */
AT24C02_READ_ADDRESS, /* 器件地址,8 位左对齐 */
ReadAddr, /* 片内起始地址 0~255 */
I2C_MEMADD_SIZE_8BIT, /* 片内地址占 1 字节 */
pBuffer, /* 接收缓冲区 */
NumToRead, /* 要读的字节数 */
1000); /* 超时 1000ms */
if (HAL_ERROR == ret)
return -1;
return HAL_OK;
}
I2C_MEMADD_SIZE_8BIT 这个参数是整段代码里最容易写错的一个。填成 16 位,HAL 会多发一个地址字节,器件把第一个字节当高位地址、第二个字节当低位地址,看着只是地址算错,实际现象是“每次读到的都是同一片区域的数据”,非常像玄学。超时给 1000 ms 是保守值,轮询模式下失败一次就会等满,调试阶段留大一点便于观察,跑稳定后可以缩到几十毫秒。
3.2 8 字节一页:写函数里那个 temp 与 HAL_Delay(10)
写函数比读函数多一层逻辑,原因是 EEPROM 有页的概念。AT24C02 一页 8 字节,一次连续写超过 8 字节,器件内部地址指针在页内回卷,第 9 个字节会覆盖本页第 1 个字节。所以写长数据必须自己切块,块与块之间还要留出器件内部写周期的时间。
c复制/* AT24C02.c:按 8 字节一页切块写入 */
int AT24C02_Write(uint16_t WriteAddr, uint8_t *pBuffer, uint16_t NumToWrite)
{
uint16_t i = 0, temp = 0;
HAL_StatusTypeDef ret = HAL_ERROR;
temp = NumToWrite / (unsigned short)0x08; /* 完整页的块数 */
for (i = 0; i < temp; i++)
{
ret = HAL_I2C_Mem_Write(&hi2c1,
AT24C02_WRITE_ADDRESS,
WriteAddr + (i * 8), /* 每块地址前进 8 */
I2C_MEMADD_SIZE_8BIT,
pBuffer + (i * 8), /* 每块数据前进 8 */
8,
1000);
HAL_Delay(10); /* 等器件内部写周期结束 */
}
temp = NumToWrite % (unsigned short)0x08; /* 不足一页的尾块 */
if (temp)
{
HAL_Delay(10);
ret = HAL_I2C_Mem_Write(&hi2c1,
AT24C02_WRITE_ADDRESS,
WriteAddr + (i * 8),
I2C_MEMADD_SIZE_8BIT,
pBuffer + (i * 8),
temp,
1000);
}
if (HAL_ERROR == ret)
return -1;
return HAL_OK;
}
temp 在这里被复用两次:第一次是完整页的块数,第二次是余数字节数,这种写法在老代码里很常见,读的时候要盯住上下文。循环体里地址和数据指针同步前进 8 字节,长度固定 8,这是“按块切”而不是“按页对齐切”——两者的差别就在于起始地址,如果 WriteAddr 是 3,第一块会写 3~10,跨过了页边界,器件会在第 8 字节处回卷。所以这套实现隐含一个前提:写结构体这种场景,起始地址必须是 8 的倍数,本例从地址 0 开始写 3 个字节,恰好安全。
HAL_Delay(10) 不是凑数的。EEPROM 在收到一帧写命令后进入内部擦写,这段时间总线上的器件不应答,紧接着发下一帧会直接 NAK,HAL 返回错误。10 ms 对 AT24C02 是够用的保守值,后面如果想压时间,可以改成“写完之后用应答轮询确认器件就绪”,但那是优化,不是第一版该干的事。
3.3 结构体落盘:Default_Setting、init_flag 与读回校验
参数持久化最省事的做法是把结构体当成一块字节数组直接写进去。前提是结构体布局固定、成员都是定长类型,本例三个成员全是 uint8_t,sizeof 就是 3,没有对齐填充,写进去再原样读出来不会错位。
c复制/* 默认参数:init_flag 置 1 表示这片 EEPROM 已经初始化过 */
void Default_Setting(void)
{
eerom_data.init_flag = 1;
eerom_data.led_setting_status = 1;
eerom_data.buzzer_setting_status = 0;
}
c复制/* main.c:写入默认参数,再从 0 地址读回并校验 */
uint8_t Status = 0;
EEPROM_DATA eeprom_data_copy;
printf("这是一个EEPROM的实验...\n");
Default_Setting();
Status = AT24C02_Write(0, (uint8_t *)&eerom_data, sizeof(eerom_data));
if (HAL_OK != Status)
{
printf("数据写入EEPROM失败\n");
return -1;
}
printf("数据写入EEPROM成功\n");
Status = AT24C02_Read(0, (uint8_t *)&eeprom_data_copy, sizeof(eeprom_data_copy));
if (HAL_OK != Status)
{
printf("读取EEPROM失败\n");
return -1;
}
printf("读取EEPROM成功\n");
printf("init_flag:%d led_setting_status:%d buzzer_setting_status:%d\n",
eeprom_data_copy.init_flag,
eeprom_data_copy.led_setting_status,
eeprom_data_copy.buzzer_setting_status);
逻辑上有三处细节值得说。第一,写入和读取都从地址 0 开始,长度取 sizeof,只要结构体不变,读写两侧天然对齐。第二,(uint8_t *)&eerom_data 这个强转是把结构体首地址当成字节流起点,读的时候必须用另一个同类型变量接,不能直接读回原变量,否则写失败时你会看到“数据居然是对的”,因为内存里本来就是它。第三,init_flag 不是摆设,它是区分“这片 EEPROM 是全新的”还是“之前写过参数”的唯一依据,没有它,每次上电都会用默认值覆盖用户设置。上面这段代码无条件写默认值,只在第一次实验时成立,真实产品里必须先读 init_flag 再决定写不写。
4. 避坑:五个让 AT24C02 读写看起来像玄学的地方
4.1 写多字节被截断与“写入成功但读回不对”
现象:往地址 0 写 12 个字节,读回来只有最后 4 个字节是对的,前 8 个字节变成了别的值,串口打印却显示“数据写入EEPROM成功”。
原因:一次连续写超过 8 字节,器件内部地址指针在页内回卷,第 9 个字节覆盖了本页第 1 个字节。上面的写函数已经按 8 字节切块,但如果起始地址不是 8 的倍数,第一块本身就跨了页,回卷照样发生。
解决:起始地址按 8 对齐;确实要从非对齐地址写长数据时,先算出本页剩余字节数 8 - (WriteAddr % 8) 写掉补齐,再按整页往后推。别指望器件替你处理边界。
现象:某次上电读回的参数是旧值,但代码里每个 HAL_I2C_Mem_Write 附近都打印了成功。
原因:驱动里只判断了 HAL_ERROR,HAL_TIMEOUT 和 HAL_BUSY 这两个返回值不等于 HAL_ERROR,会走到 return HAL_OK,主程序看到 0 就认为成功。更隐蔽的是循环里 ret 每轮被覆盖,前面几块失败、最后一块成功,最终返回值依然是成功。
解决:改成只有 HAL_OK 才算成功,循环体内每次失败立即返回,不要等循环结束再看。写失败的地方加一次重试,两次都失败就把地址和返回值一起打印出来。
4.2 空白片、地址宏与跨平台移植的三个暗坑
现象:新焊的板子第一次上电,init_flag 打印出来是 255,亮度档位也是 255,直接拿去驱动 LED 就是全亮。
原因:全新的 EEPROM 出厂状态是全 0xFF,读出来就是 255。代码里如果没有“先判断 init_flag 是否等于约定值”这一步,就会把空白数据当合法参数用。上面实验代码之所以没暴露这个问题,是因为它无条件先写了默认值,属于运气好。
解决:约定一个魔数作为 init_flag,上电先读一个字节,不等于约定值才写默认参数;写完立刻读回比对,比对通过再把 init_flag 置位,顺序不能反,先置位再写数据,一旦写失败就永远进不了初始化分支。
现象:加了一个新参数进结构体,重新烧程序后,老设备上读出来的蜂鸣器开关变成了别的值。
原因:结构体直接落盘,布局就是协议。成员增删、类型从 uint8_t 改成 uint16_t,sizeof 和字段偏移全变,老数据按新布局解析必然错位,而且没有任何标记能告诉你“这是旧版本的数据”。
解决:结构体首字节固定为版本号,读取时先比对版本,不匹配就整片重写默认值;成员只用定长类型,不塞指针、不塞浮点;每次改动布局就升版本号。这套规矩看着啰嗦,能省掉现场返修。
现象:同一份参数区代码挪到另一个平台或另一个 I2C 接口上,读写全部失败,地址怎么改都不对。
原因:0xA0、0xA1 是含读写位的 8 位写法,HAL 只取高 7 位(即 0x50),方向位自己补;而很多接口要的是纯 7 位地址。把 0xA0 原样传给 7 位地址接口,实际访问的是 0x50 之外的器件,总线上没人应答。
解决:宏只保留一个 7 位基址(0x50),需要 8 位写法的地方在调用处左移,读方向再或上 1。这样换平台时只需要改一处移位,不会出现“读能通、写不通”这种一半对一半的怪现象。
注意:这五条里有三条不会报错,只会让数据悄悄变错。凡是“写成功但读回不对”的问题,先怀疑边界和返回值判断,再怀疑硬件。
5. 把自检做进上电流程:参数区地址表与一次可回归的读写验证
参数区只有 3 个字节,但地址分配最好现在就定下来,后面加参数不用重新规划。从 0x00 起连续排,预留一段给以后的功能,尾部留给校准数据,表里写清楚,比在代码里散着写魔法地址强得多。
| 地址 | 长度 | 用途 | 备注 |
|---|---|---|---|
| 0x00 | 1 B | init_flag / 版本号 | 约定值,用于判断是否已初始化 |
| 0x01 | 1 B | 亮度档位 | 0~N 的枚举值 |
| 0x02 | 1 B | 蜂鸣器开关 | 0 或 1 |
| 0x03~0x0F | 13 B | 预留 | 新增参数从这里取,不动前三个 |
| 0x10~0xFF | 240 B | 校准 / 日志 | 与参数区分开,避免误覆盖 |
有了这张表,上电自检就可以写成固定四步:先读地址 0x00 的一个字节,判断是否等于约定值;不等于就写默认参数并等够写周期;再把整块参数读回逐字节比对;最后把三个字段打印到串口。任何一步失败都停在原地并打印原因,不要带着错误参数往下跑。
c复制/* 上电自检:读标志 -> 按需写默认值 -> 读回比对 -> 打印 */
int EEPROM_SelfCheck(void)
{
uint8_t flag = 0;
EEPROM_DATA tmp;
if (AT24C02_Read(0x00, &flag, 1) != HAL_OK) /* 第一步:读标志字节 */
return -1;
if (flag != 1) /* 第二步:空白片或旧版本 */
{
Default_Setting();
if (AT24C02_Write(0x00, (uint8_t *)&eerom_data, sizeof(eerom_data)) != HAL_OK)
return -2;
}
if (AT24C02_Read(0x00, (uint8_t *)&tmp, sizeof(tmp)) != HAL_OK) /* 第三步:读回 */
return -3;
if (tmp.init_flag != 1) /* 第四步:比对关键字段 */
return -4;
printf("eeprom ok: led=%d buzzer=%d\r\n",
tmp.led_setting_status, tmp.buzzer_setting_status);
return 0;
}
这段代码里,返回值用不同负数区分失败阶段,串口一打印就知道卡在读标志、写默认值还是读回比对。真正让我省事的是“读回比对”这一步:它把前面所有的边界问题——页回卷、写周期没等够、返回值判断漏了——全部逼到台面上,而不是等到用户按了十次按键之后才发现亮度档位记错了。
从那以后我每次用代码开发工具生成新的外设骨架,第一件事都是把读回比对写进去,再让它跑一遍冷启动。图省掉这一步,后面就得花几倍时间去现场解释“为什么设置会自己变回去”。希望帮到你。
