STM32 I2C 通信 HAL 库踩坑记录

问题

HAL 库的 I2C 用起来感觉比 SPI 麻烦——有时候卡死在HAL_I2C_Master_Transmit，有时候第一次通信正常第二次就超时。

下面是最常见的几个坑和对应的解决办法。

坑一：总线锁死（SCL 被拉低）

I2C 通信中断时（比如刚发完地址突然复位），从机可能把 SCL 或 SDA锁死在低电平，后续所有 I2C 操作都超时。

现象：第一次调用HAL_I2C_Master_Transmit就超时返回。

解决——复位 I2C 总线：

void I2C_ResetBus(I2C_HandleTypeDef *hi2c) { GPIO_InitTypeDef gpio = {0}; ​ // 将 SCL 和 SDA 临时设成普通 GPIO 输出 gpio.Mode = GPIO_MODE_OUTPUT_OD; gpio.Pull = GPIO_PULLUP; gpio.Speed = GPIO_SPEED_FREQ_MEDIUM; ​ // SCL 引脚（查你的原理图，这里是 PB6） gpio.Pin = GPIO_PIN_6; HAL_GPIO_Init(GPIOB, &gpio); ​ // SDA 引脚（PB7） gpio.Pin = GPIO_PIN_7; HAL_GPIO_Init(GPIOB, &gpio); ​ // 产生 9 个时钟脉冲，让从机释放总线 for (int i = 0; i < 9; i++) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET); // SCL Low HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); // SCL High HAL_Delay(1); } ​ // 产生 STOP 条件：SDA 在 SCL 高时上升沿 HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET); // SDA Low HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET); // SDA High → STOP ​ // 重新初始化 I2C 外设 HAL_I2C_DeInit(hi2c); HAL_I2C_Init(hi2c); }

坑二：未使用超时参数

// ❌ 超时设太大，卡死在这里 10 秒 HAL_I2C_Master_Transmit(&hi2c1, addr, data, len, 10000); ​ // ✅ 设一个合理的超时，超时就返回错误 if (HAL_I2C_Master_Transmit(&hi2c1, addr, data, len, 100) != HAL_OK) { printf("I2C Error!\r\n"); I2C_ResetBus(&hi2c1); // 自动恢复 }

坑三：地址左移

I2C 的 7 位地址和 HAL 库传的地址关系：

// 假设器件地址是 0x3C（7 位） // HAL 库的 addr 参数要左移 1 位，即 0x78 // 但 CubeMX 生成的 MX_I2C1_Init 用的是 HAL_I2C_Init 结构体中的 AddressingMode // 大部分示例直接传 0x78 而不是 0x3C ​ // 推荐：直接传左移后的地址 #define DEV_ADDR (0x3C << 1) // = 0x78 HAL_I2C_Master_Transmit(&hi2c1, DEV_ADDR, data, len, 100);

坑四：I2C 时序配置不对

I2C 时钟 = APB1 时钟（42MHz）/ 分频系数。

重要：F407 使用的是旧版 I2C 外设，寄存器叫 CCR 和 TRISE（不是 Timing，Timing 是 F0/F3/F7/L0/L4 等新版 I2C 外设的寄存器名）。最可靠的方式是让 HAL 库的I2C_Init()自动计算，而不是手动改寄存器。

I2C_InitTypeDef I2C_InitStruct; I2C_InitStruct.ClockSpeed = 400000; // 快速模式 400kHz I2C_InitStruct.DutyCycle = I2C_DUTYCYCLE_2; // DUTY=0 或 DUTY=1 // ... 其他参数 ... HAL_I2C_Init(&hi2c1); // HAL 自动计算 CCR/TRISE

手动计算公式（仅供理解）：

• CCR（快速模式 DUTY=0）：CCR = 42MHz / (3 × 400kHz) ≈ 35

• CCR（快速模式 DUTY=1）：CCR = 42MHz / (25 × 400kHz) ≈ 4

• TRISE：TRISE = (最大上升时间 / T_PCLK1) + 1，100kHz 模式 TRISE≈43，400kHz 模式 TRISE≈13

CubeMX 中选择 Standard Mode / Fast Mode 它会自动算。

坑五：没有上拉电阻

I2C 的 SCL 和 SDA 是开漏输出，必须外部接上拉电阻（4.7kΩ 典型）。

如果你的模块是单独买的，通常自带。但如果用杜邦线直连芯片引脚，就可能忘记加上拉。

现象：有时能通信有时不能，波形上升沿很缓。

测：用示波器看 SCL/SDA 的上升沿——如果 > 1μs，说明上拉电阻太大或没有。

// 紧急补救：STM32 内部有上拉电阻（约 40kΩ） // 在 CubeMX GPIO 设置中把 SCL/SDA 的 Pull 改成 Pull-up // 但 40kΩ 只适合低速短距离，标准还是用外部 4.7kΩ

总结