别再只会用串口了！用STM32 HAL库的I2C驱动AT24C02，实现数据断电保存（附完整代码）-开发者社区

STM32 HAL库实战：用I2C驱动AT24C02实现智能数据存储

在嵌入式开发中，数据持久化是一个常见但关键的需求。想象一下，你的智能家居设备每次断电后都要重新配置，或者工业传感器丢失了历史记录——这显然不可接受。本文将带你突破串口通信的舒适区，掌握I2C总线与EEPROM的实战应用。

1. I2C与AT24C02基础认知

1.1 为什么选择I2C+EEPROM方案

串口通信适合设备间数据传输，但断电即失的特性使其无法满足数据存储需求。相比之下，I2C总线配合AT24C02 EEPROM提供了以下优势：

双线制设计：仅需SCL（时钟）和SDA（数据）两根线
非易失性存储：数据可保存100年
页写入机制：支持8字节批量写入
百万次擦写：满足频繁更新需求

AT24C02的2Kbit（256字节）容量看似不大，但足以存储：

设备配置参数
运行时间统计
用户偏好设置
故障日志索引

1.2 硬件连接要点

典型接线方案（以STM32F103C8T6为例）：

STM32引脚	AT24C02引脚	备注
PB6	SCL	需接4.7K上拉电阻
PB7	SDA	需接4.7K上拉电阻
3.3V	VCC	工作电压范围1.8-5.5V
GND	GND	共地

注意：I2C总线必须加上拉电阻，典型值4.7KΩ，否则通信可能失败

2. CubeMX工程配置

2.1 时钟树配置

先确保系统时钟正确配置（以72MHz为例）：

选择HSE作为时钟源
配置PLL倍频
设置APB1分频（I2C时钟不超过36MHz）

2.2 I2C参数设置

在Connectivity选项卡中配置I2C1：

Mode：I2C
Speed：Standard Mode（100kHz）
其他参数保持默认

关键代码生成检查点：

/* I2C1 init function */ void MX_I2C1_Init(void) { 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; if (HAL_I2C_Init(&hi2c1) != HAL_OK) { Error_Handler(); } }

3. HAL库I2C驱动实现

3.1 设备地址定义

AT24C02的7位设备地址为0x50（二进制1010000），但HAL库需要左移一位：

#define EEPROM_ADDR 0xA0 // 写模式：0x50 << 1 #define EEPROM_SIZE 256 // AT24C02容量

3.2 关键API解析

HAL库提供了两个核心函数：

HAL_I2C_Mem_Write：带地址的写入
HAL_I2C_Mem_Read：带地址的读取

函数原型：

HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);

参数说明：

DevAddress：设备地址（0xA0）
MemAddress：EEPROM内部地址（0-255）
MemAddSize：地址字节数（I2C_MEMADD_SIZE_8BIT）
pData：数据缓冲区指针
Size：数据长度
Timeout：超时时间（ms）

3.3 页写入技巧

AT24C02支持8字节页写入，超过时需要分页处理：

void EEPROM_WritePage(uint16_t addr, uint8_t *data, uint16_t size) { while(size > 0) { uint16_t chunk = (addr % 8) ? (8 - (addr % 8)) : 8; chunk = (chunk > size) ? size : chunk; HAL_I2C_Mem_Write(&hi2c1, EEPROM_ADDR, addr, I2C_MEMADD_SIZE_8BIT, data, chunk, 100); HAL_Delay(5); // 必须的写入周期等待 addr += chunk; data += chunk; size -= chunk; } }

4. 实战：系统参数存储方案

4.1 数据结构设计

建议使用如下结构体存储系统参数：

typedef struct { uint32_t boot_count; uint16_t config_version; uint8_t brightness; float calibration_factor; char device_name[16]; } SystemParams;

4.2 完整读写流程

存储实现代码：

#define PARAMS_ADDR 0x00 // 参数存储起始地址 void SaveSystemParams(SystemParams *params) { uint8_t buffer[sizeof(SystemParams)]; memcpy(buffer, params, sizeof(SystemParams)); EEPROM_WritePage(PARAMS_ADDR, buffer, sizeof(SystemParams)); } void LoadSystemParams(SystemParams *params) { uint8_t buffer[sizeof(SystemParams)]; HAL_I2C_Mem_Read(&hi2c1, EEPROM_ADDR|1, PARAMS_ADDR, I2C_MEMADD_SIZE_8BIT, buffer, sizeof(SystemParams), 100); memcpy(params, buffer, sizeof(SystemParams)); }

4.3 使用示例

SystemParams myParams; void SystemInit() { LoadSystemParams(&myParams); myParams.boot_count++; SaveSystemParams(&myParams); printf("Device: %s\n", myParams.device_name); printf("Boot count: %lu\n", myParams.boot_count); }

5. 高级技巧与故障排查

5.1 数据校验机制

为防止数据损坏，建议添加CRC校验：

uint8_t CalculateCRC(uint8_t *data, uint16_t size) { uint8_t crc = 0xFF; for(uint16_t i=0; i<size; i++) { crc ^= data[i]; for(uint8_t bit=0; bit<8; bit++) { if(crc & 0x80) crc = (crc << 1) ^ 0x31; else crc <<= 1; } } return crc; }

存储时在数据末尾附加CRC值，读取时验证。

5.2 常见问题解决

问题1：写入后读取数据不正确

检查上拉电阻是否连接
确认I2C时钟不超过100kHz
确保每次写入后有5ms延时

问题2：HAL_I2C_Mem_Write返回HAL_ERROR

用逻辑分析仪抓取I2C波形
检查设备地址是否正确（示波器观察起始信号）
确认EEPROM写保护引脚未启用

问题3：跨页写入数据丢失

确保单次写入不超过8字节
页边界处手动分多次写入

6. 性能优化策略

6.1 写延迟优化

虽然AT24C02要求5ms写周期，但可以通过以下方式优化：

批量写入：积累多次修改后统一写入
脏页标记：只写入修改过的数据
环形缓冲区：轮流使用不同存储区域

示例实现：

#define PAGE_SIZE 8 #define NUM_PAGES (EEPROM_SIZE/PAGE_SIZE) uint8_t write_index = 0; void OptimizedWrite(uint16_t addr, uint8_t *data, uint16_t size) { static uint8_t buffer[EEPROM_SIZE]; static uint8_t dirty[NUM_PAGES] = {0}; // 更新内存缓存 memcpy(&buffer[addr], data, size); // 标记脏页 uint16_t start_page = addr / PAGE_SIZE; uint16_t end_page = (addr + size - 1) / PAGE_SIZE; for(uint16_t p=start_page; p<=end_page; p++) { dirty[p] = 1; } // 定时写入脏页（例如每秒） if(++write_index >= NUM_PAGES) write_index = 0; if(dirty[write_index]) { uint16_t page_addr = write_index * PAGE_SIZE; HAL_I2C_Mem_Write(&hi2c1, EEPROM_ADDR, page_addr, I2C_MEMADD_SIZE_8BIT, &buffer[page_addr], PAGE_SIZE, 100); HAL_Delay(5); dirty[write_index] = 0; } }

6.2 磨损均衡技术

为延长EEPROM寿命（100万次擦写），可采用：

地址偏移：轮流使用不同地址存储相同数据
日志式存储：追加新记录而非覆盖旧数据
坏块管理：记录已损坏的存储区域

实现示例：

#define WEAR_LEVELING_SIZE 64 // 磨损均衡区域大小 uint16_t current_offset = 0; void WearLevelingWrite(uint16_t base_addr, uint8_t *data, uint16_t size) { uint16_t addr = base_addr + current_offset; EEPROM_WritePage(addr % WEAR_LEVELING_SIZE, data, size); current_offset = (current_offset + size) % WEAR_LEVELING_SIZE; }