1. STM32CubeMX与I2C基础概述
第一次接触STM32的硬件I2C时，我被各种时序问题折磨得够呛。直到发现STM32CubeMX这个神器，才真正体会到什么叫"图形化配置解放生产力"。I2C作为嵌入式领域最常用的串行通信协议之一，其双线制（SDA数据线和SCL时钟线）设计虽然简洁，但实际应用中却暗藏玄机——从设备地址、通信速率到时序要求，每个细节都可能成为项目路上的绊脚石。
STM32CubeMX作为ST官方推出的可视化配置工具，能自动生成初始化代码，极大降低了I2C外设的使用门槛。它最实用的功能是自动计算I2C时序参数，这对刚接触STM32的开发者简直是救命稻草。记得我第一次手动计算I2C时序寄存器值时，花了整整一个下午对照参考手册，最后还是没能让AT24C02 EEPROM正常响应。而用CubeMX配置后，只需点几下鼠标就能生成完美匹配的时序参数。
2. 工程创建与I2C外设配置
2.1 新建工程与MCU选择
启动STM32CubeMX后，点击"New Project"进入MCU选择器。以常见的STM32F103C8T6为例，在搜索框输入"STM32F103C8"后选择对应型号。这里有个实用技巧：如果使用的是第三方开发板，可以直接在"Board Selector"选项卡中选择，这样引脚配置会自动适配板载外设。
关键提示：不同STM32系列的I2C外设存在差异，例如F1系列的是I2Cv1，而F4系列升级为I2Cv2。虽然CubeMX会处理这些差异，但了解这些区别对后期调试有帮助。
2.2 I2C引脚配置
在Pinout & Configuration界面，展开Connectivity部分找到I2C1（根据实际硬件选择）：
- 将Mode设置为"I2C"
- 将I2C Configuration中的参数配置为：
- I2C Speed Mode：Standard Mode (100kHz)
- Addressing Mode：7-bit
- 其他保持默认
此时CubeMX会自动分配SDA和SCL引脚（通常是PB7/PB6）。务必确认引脚没有被其他功能占用（显示为黄色警告）。如果硬件设计使用了特定引脚，可以手动调整引脚映射。
2.3 时序参数配置
这是I2C配置中最关键也最容易出问题的部分。在Configuration标签页下：
- 点击"I2C"进入详细配置
- 在Timing Parameters部分：
- 选择"I2C Speed Mode"为Standard Mode (100kHz)
- 点击"Calculate"按钮自动生成时序值
- 检查生成的参数是否符合从设备要求
实测发现，对于AT24C02这类常见EEPROM，CubeMX自动计算的参数通常可以直接使用。但如果遇到通信失败，可能需要手动调整"Timing"寄存器值。这时可以参考STM32参考手册中I2C时序计算公式，或者使用逻辑分析仪抓取波形进行调试。
3. 代码生成与基础通信实现
3.1 生成工程代码
在Project Manager标签页中：
- 设置项目名称和存储路径
- 选择熟悉的IDE（Keil、IAR或STM32CubeIDE）
- 在Code Generator中勾选"Generate peripheral initialization as a pair of .c/.h files"
- 点击"Generate Code"创建工程
生成的代码中，i2c.c文件包含了I2C初始化函数MX_I2C1_Init()，这个函数已经根据我们的配置设置好了所有参数，无需手动修改。
3.2 基础通信函数
HAL库提供了多种I2C通信方式，最基础的是阻塞式传输：
c复制// 主设备发送数据
HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c,
uint16_t DevAddress,
uint8_t *pData,
uint16_t Size,
uint32_t Timeout);
// 主设备接收数据
HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c,
uint16_t DevAddress,
uint8_t *pData,
uint16_t Size,
uint32_t Timeout);
使用时需要注意：
- DevAddress是7位设备地址左移1位（例如AT24C02地址0x50，实际传入0xA0）
- Timeout建议设置为100-1000ms，避免死等
3.3 EEPROM读写示例
以AT24C02为例，实现多字节读写：
c复制#define EEPROM_ADDR 0xA0 // 7位地址0x50左移1位
#define PAGE_SIZE 8 // AT24C02页大小为8字节
// 写数据到EEPROM
HAL_StatusTypeDef EEPROM_Write(uint16_t memAddr, uint8_t *data, uint16_t size) {
HAL_StatusTypeDef status;
uint16_t remaining = size;
uint16_t offset = 0;
while(remaining > 0) {
uint16_t chunk = (remaining > PAGE_SIZE) ? PAGE_SIZE : remaining;
status = HAL_I2C_Mem_Write(&hi2c1, EEPROM_ADDR, memAddr+offset,
I2C_MEMADD_SIZE_8BIT, data+offset, chunk, 100);
if(status != HAL_OK) return status;
HAL_Delay(5); // AT24C02写入需要5ms
remaining -= chunk;
offset += chunk;
}
return HAL_OK;
}
// 从EEPROM读取数据
HAL_StatusTypeDef EEPROM_Read(uint16_t memAddr, uint8_t *data, uint16_t size) {
return HAL_I2C_Mem_Read(&hi2c1, EEPROM_ADDR, memAddr,
I2C_MEMADD_SIZE_8BIT, data, size, 100);
}
4. 常见问题与调试技巧
4.1 通信失败排查步骤
当I2C通信不成功时，建议按以下步骤排查：
-
硬件检查：
- 确认SDA和SCL线已正确连接
- 检查是否接上拉电阻（通常4.7kΩ）
- 测量电源电压是否稳定
-
软件检查：
- 确认设备地址正确（7位地址需要左移1位）
- 检查CubeMX生成的时序参数
- 增加Timeout值测试
-
工具辅助：
- 用逻辑分析仪抓取波形，检查：
- START条件
- 地址字节和ACK/NACK
- 数据波形
- 使用STM32CubeMonitor实时监控I2C总线
- 用逻辑分析仪抓取波形，检查：
4.2 典型错误处理
-
HAL_BUSY错误：
通常是因为前一次传输未完成就发起新请求。解决方法：c复制while(HAL_I2C_GetState(&hi2c1) != HAL_I2C_STATE_READY); -
ACK失败：
- 检查从设备地址是否正确
- 确认从设备电源正常
- 检查总线是否有短路/断路
-
时序问题：
如果自动计算的时序不工作，可以尝试：- 降低通信速率
- 参考STM32参考手册手动计算时序值
- 使用CubeMX提供的时序计算器工具
5. 进阶应用与优化
5.1 中断和DMA方式
对于需要高效传输的场景，可以使用中断或DMA方式：
c复制// 中断方式发送
HAL_I2C_Master_Transmit_IT(&hi2c1, DevAddress, pData, Size);
// DMA方式接收
HAL_I2C_Master_Receive_DMA(&hi2c1, DevAddress, pData, Size);
使用这些非阻塞方式时，需要实现相应的回调函数：
c复制void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c) {
// 传输完成处理
}
void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c) {
// 错误处理
}
5.2 多设备管理
当一条I2C总线挂载多个设备时：
- 确保每个设备有唯一地址
- 在切换设备时增加适当延时
- 使用如下结构管理设备：
c复制typedef struct {
uint8_t addr;
I2C_HandleTypeDef *hi2c;
} I2C_Device;
I2C_Device eeprom = {0xA0, &hi2c1};
I2C_Device sensor = {0xB8, &hi2c1};
HAL_I2C_Master_Transmit(eeprom.hi2c, eeprom.addr, data, size, timeout);
5.3 低功耗优化
对于电池供电设备：
- 在CubeMX中配置I2C的"Clock No Stretch Mode"
- 通信间隔期间将I2C置于睡眠模式
- 合理设置超时时间，避免长时间阻塞
c复制// 进入低功耗前
HAL_I2C_DeInit(&hi2c1);
// 唤醒后重新初始化
MX_I2C1_Init();
6. 实战案例：AT24C02完整驱动
结合前面内容，实现一个功能完整的EEPROM驱动：
c复制// at24c02.h
#ifndef AT24C02_H
#define AT24C02_H
#include "stm32f1xx_hal.h"
#define AT24C02_ADDR 0xA0
#define AT24C02_SIZE 256
#define AT24C02_PAGE_SIZE 8
HAL_StatusTypeDef AT24C02_Write(I2C_HandleTypeDef *hi2c, uint16_t memAddr, uint8_t *data, uint16_t size);
HAL_StatusTypeDef AT24C02_Read(I2C_HandleTypeDef *hi2c, uint16_t memAddr, uint8_t *data, uint16_t size);
HAL_StatusTypeDef AT24C02_Clear(I2C_HandleTypeDef *hi2c, uint8_t pattern);
#endif
c复制// at24c02.c
#include "at24c02.h"
#include <string.h>
HAL_StatusTypeDef AT24C02_Write(I2C_HandleTypeDef *hi2c, uint16_t memAddr, uint8_t *data, uint16_t size) {
if(memAddr + size > AT24C02_SIZE) return HAL_ERROR;
HAL_StatusTypeDef status;
uint16_t remaining = size;
uint16_t offset = 0;
while(remaining > 0) {
uint16_t chunk = (remaining > AT24C02_PAGE_SIZE) ? AT24C02_PAGE_SIZE : remaining;
uint16_t pageBoundary = (memAddr + offset + AT24C02_PAGE_SIZE) & ~(AT24C02_PAGE_SIZE-1);
uint16_t currentChunk = pageBoundary - (memAddr + offset);
if(currentChunk == 0) currentChunk = AT24C02_PAGE_SIZE;
chunk = (chunk > currentChunk) ? currentChunk : chunk;
status = HAL_I2C_Mem_Write(hi2c, AT24C02_ADDR, memAddr+offset,
I2C_MEMADD_SIZE_8BIT, data+offset, chunk, 100);
if(status != HAL_OK) return status;
HAL_Delay(5);
remaining -= chunk;
offset += chunk;
}
return HAL_OK;
}
HAL_StatusTypeDef AT24C02_Read(I2C_HandleTypeDef *hi2c, uint16_t memAddr, uint8_t *data, uint16_t size) {
if(memAddr + size > AT24C02_SIZE) return HAL_ERROR;
return HAL_I2C_Mem_Read(hi2c, AT24C02_ADDR, memAddr,
I2C_MEMADD_SIZE_8BIT, data, size, 100);
}
HAL_StatusTypeDef AT24C02_Clear(I2C_HandleTypeDef *hi2c, uint8_t pattern) {
uint8_t buffer[AT24C02_PAGE_SIZE];
memset(buffer, pattern, AT24C02_PAGE_SIZE);
for(uint16_t i=0; i<AT24C02_SIZE; i+=AT24C02_PAGE_SIZE) {
HAL_StatusTypeDef status = AT24C02_Write(hi2c, i, buffer,
(i+AT24C02_PAGE_SIZE > AT24C02_SIZE) ? (AT24C02_SIZE-i) : AT24C02_PAGE_SIZE);
if(status != HAL_OK) return status;
}
return HAL_OK;
}
这个驱动考虑了页写限制，实现了安全的内存访问，并提供了整片擦除功能。在实际项目中，可以在此基础上添加写保护、校验和等高级功能。