在 STM32CubeMX 中配置和使用 I2C 的步骤如下：

1. 新建工程并选择 MCU

• 打开 STM32CubeMX，创建新工程，选择目标 MCU 型号。

2. 配置 I2C 引脚

1. 启用 I2C 外设
   在 Pinout & Configuration 标签页中，找到 I2C 模块（如 I2C1），选择 I2C 模式（主模式 I2C 或从模式，通常选主模式）。

2. 自动分配引脚
   STM32CubeMX 会自动分配 SDA（数据线）和 SCL（时钟线）的 GPIO 引脚（如 PB7/PB6 对应 I2C1）。确保引脚未被其他功能占用。

3. 配置 I2C 参数

在 Configuration 标签页中，进入 I2C 的配置界面：

• Timing Settings（关键配置）：
  • 选择 I2C Speed Mode（标准模式 Standard Mode 100kHz 或快速模式 Fast Mode 400kHz）。
  • 点击 Calculate 自动生成 Timing 值（或手动输入寄存器的时序参数）。
• Addressing Mode：选择 7-bit 或 10-bit 设备地址模式（常用 7 位）。
• 其他选项：根据需要启用中断或 DMA（提高效率）。

4. 生成代码

1. 设置工程属性
   在 Project Manager 标签页中：

   • 选择 IDE（如 Keil、STM32CubeIDE）。
   • 配置代码存储路径。
   • 在 Code Generator 中勾选 Generate peripheral initialization as a pair of .c/.h files（方便维护）。

2. 生成代码
   点击 Generate Code，生成工程文件。

5. 编写应用程序

在生成的代码中，使用 HAL 库函数进行 I2C 通信：

示例：主设备发送数据

uint8_t buffer[] = {0x01, 0x02};  // 待发送数据
uint8_t devAddr = 0x50 << 1;       // 设备地址（7位需左移1位）

// 阻塞模式发送
HAL_I2C_Master_Transmit(&hi2c1, devAddr, buffer, 2, HAL_MAX_DELAY);

示例：主设备接收数据

uint8_t rxBuffer[2];
HAL_I2C_Master_Receive(&hi2c1, devAddr, rxBuffer, 2, HAL_MAX_DELAY);

其他常用函数

• 带寄存器的读写（如传感器）：

  HAL_I2C_Mem_Write(&hi2c1, devAddr, regAddr, I2C_MEMADD_SIZE_8BIT, data, size, timeout);
  HAL_I2C_Mem_Read(&hi2c1, devAddr, regAddr, I2C_MEMADD_SIZE_8BIT, data, size, timeout);

• 非阻塞模式：使用 IT（中断）或 DMA 后缀的函数（如 HAL_I2C_Master_Transmit_IT）。

常见问题

1. 地址错误

   • 7 位地址需左移 1 位（如设备地址 0x50，实际传入 0x50 << 1）。
   • 确保设备地址与从机一致。

2. 通信失败

   • 检查硬件连接（SDA/SCL 是否接上拉电阻，通常 4.7kΩ）。
   • 确认时序配置（Timing 值）与设备兼容。
   • 使用逻辑分析仪或示波器抓取波形。

3. 超时处理

   • 适当增加 timeout 参数，或在阻塞模式中检查返回值：

     if (HAL_I2C_Master_Transmit(/* ... */) != HAL_OK) {
     // 错误处理
     }

补充建议

• 调试工具：STM32CubeMX 内置的 I2C 时序计算器可帮助生成正确的 Timing 值。
• 低功耗场景：考虑使用 I2C_WakeUP 和睡眠模式。
• 多设备通信：同一 I2C 总线可挂载多个从设备，地址需唯一。

通过以上步骤，即可快速实现 STM32 的 I2C 通信功能。