STM32 的 I2C 模块（Inter-Integrated Circuit）是一种常用的串行通信接口，支持多主从设备通信，广泛应用于传感器、EEPROM、显示屏等外设的连接。以下是关于 STM32 I2C 模块的关键知识点和配置指南：

一、I2C 模块基础

1. 工作原理

   • 通过 SCL（时钟线） 和 SDA（数据线） 两根线实现全双工通信。
   • 支持标准模式（100 kHz）、快速模式（400 kHz）和高速模式（最高 1 MHz 或 3.4 MHz，取决于型号）。

2. 主要特性

   • 支持 主模式（Master） 和 从模式（Slave）。
   • 可配置时钟频率、7/10 位设备地址。
   • 支持 DMA、中断和轮询模式。

二、硬件配置步骤

1. GPIO 初始化

   • 将 SCL 和 SDA 引脚配置为 复用开漏模式（Alternate Function Open-Drain），并启用内部或外部上拉电阻。

2. I2C 参数设置

   • 使用 STM32CubeMX 或手动配置以下参数：
     • 时钟频率（I2C_CLOCK_SPEED）
     • 设备地址（从模式时需设置）
     • 上升时间（I2C_TRISE，根据时钟频率计算）

3. 代码示例（HAL 库）

   // 初始化 I2C
   I2C_HandleTypeDef hi2c1;
   hi2c1.Instance = I2C1;
   hi2c1.Init.ClockSpeed = 100000;       // 100 kHz
   hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
   hi2c1.Init.OwnAddress1 = 0;          // 主模式无需地址
   hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
   HAL_I2C_Init(&hi2c1);

三、常见操作

1. 主模式发送数据

   uint8_t data[] = {0x01, 0x02, 0x03};
   HAL_I2C_Master_Transmit(&hi2c1, 0x50<<1, data, 3, 100); // 0x50 为从机地址（左移1位）

2. 主模式接收数据

   uint8_t rx_data[3];
   HAL_I2C_Master_Receive(&hi2c1, 0x50<<1, rx_data, 3, 100);

3. 从模式配置

   • 设置自身地址并启用中断：

     hi2c1.Init.OwnAddress1 = 0x30;     // 从机地址
     HAL_I2C_EnableListen_IT(&hi2c1);   // 启用监听中断

四、常见问题排查

1. 通信失败

   • 检查 SCL/SDA 上拉电阻（通常 4.7 kΩ）。
   • 确认 时钟配置（使用 HAL_RCC_GetPCLK1Freq() 验证时钟源）。
   • 检查从设备地址是否左移 1 位（HAL 库要求地址左移）。

2. 总线锁死

   • 重启 I2C 模块或发送时钟脉冲恢复：

     __HAL_I2C_DISABLE(&hi2c1);
     __HAL_I2C_ENABLE(&hi2c1);

3. 使用逻辑分析仪

   • 通过工具（如 Saleae）抓取 SCL/SDA 波形，确认时序和信号完整性。

五、进阶功能

• DMA 传输：减少 CPU 占用，适合高速通信。
• 多主设备仲裁：通过总线冲突检测实现多主机通信。
• SMBus 协议：部分 STM32 支持 SMBus 扩展功能。

六、参考资源

1. 官方文档：STM32 参考手册（RM）中对应的 I2C 章节。
2. 代码库：STM32CubeMX 生成的 HAL 库代码。
3. 工具：STM32CubeMonitor 用于实时调试。

如需具体型号（如 STM32F103、STM32H7 等）的详细配置，请提供更多信息！