以下是关于在 STM32F103C8T6 上使用 I2C（I²C）总线的中文详解指南，包含关键步骤和代码示例：

一、硬件准备

1. I2C引脚分配（以标准为例）：
   • I2C1：
     • SCL：PB6（时钟线）
     • SDA：PB7（数据线）
   • I2C2：
     • SCL：PB10
     • SDA：PB11
2. 外部上拉电阻：
   • 在SCL和SDA线上各接 4.7kΩ上拉电阻到3.3V（必须添加，否则通信可能失败）。

二、软件配置（以标准外设库为例）

步骤1：初始化I2C引脚

#include "stm32f10x.h"

void I2C_GPIO_Config(void) {
    GPIO_InitTypeDef GPIO_InitStruct;

    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // 使能GPIOB时钟
    RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE);  // 使能I2C1时钟

    // 配置PB6(SCL)和PB7(SDA)为开漏复用模式
    GPIO_InitStruct.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AF_OD;        // 开漏复用
    GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOB, &GPIO_InitStruct);
}

步骤2：配置I2C参数

void I2C_Mode_Config(void) {
    I2C_InitTypeDef I2C_InitStruct;

    I2C_InitStruct.I2C_Mode = I2C_Mode_I2C;
    I2C_InitStruct.I2C_DutyCycle = I2C_DutyCycle_2;      // 50%占空比
    I2C_InitStruct.I2C_OwnAddress1 = 0x00;               // STM32自身地址（主机模式下可忽略）
    I2C_InitStruct.I2C_Ack = I2C_Ack_Enable;             // 使能ACK响应
    I2C_InitStruct.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; // 7位地址
    I2C_InitStruct.I2C_ClockSpeed = 100000;              // 100kHz标准模式

    I2C_Init(I2C1, &I2C_InitStruct);
    I2C_Cmd(I2C1, ENABLE);                               // 使能I2C1
}

三、I2C通信函数（主机模式，轮询方式）

向从机发送数据

void I2C_WriteByte(uint8_t SlaveAddr, uint8_t RegAddr, uint8_t Data) {
    while(I2C_GetFlagStatus(I2C1, I2C_FLAG_BUSY));       // 等待总线空闲

    I2C_GenerateSTART(I2C1, ENABLE);                     // 发送起始条件
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT));

    I2C_Send7bitAddress(I2C1, SlaveAddr, I2C_Direction_Transmitter); // 发送从机地址（写）
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED));

    I2C_SendData(I2C1, RegAddr);                         // 发送寄存器地址
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED));

    I2C_SendData(I2C1, Data);                            // 发送数据
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED));

    I2C_GenerateSTOP(I2C1, ENABLE);                      // 发送停止条件
}

从从机读取数据

uint8_t I2C_ReadByte(uint8_t SlaveAddr, uint8_t RegAddr) {
    uint8_t data = 0;

    // 先写入寄存器地址（设置读取位置）
    I2C_GenerateSTART(I2C1, ENABLE);
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT));

    I2C_Send7bitAddress(I2C1, SlaveAddr, I2C_Direction_Transmitter);
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED));

    I2C_SendData(I2C1, RegAddr);
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED));

    // 重新发送起始条件（重启读操作）
    I2C_GenerateSTART(I2C1, ENABLE);
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT));

    I2C_Send7bitAddress(I2C1, SlaveAddr, I2C_Direction_Receiver); // 发送读命令
    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED));

    I2C_AcknowledgeConfig(I2C1, DISABLE);                // 读取前禁用ACK
    I2C_GenerateSTOP(I2C1, ENABLE);                      // 提前发送停止条件

    while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_RECEIVED));
    data = I2C_ReceiveData(I2C1);                        // 读取数据

    I2C_AcknowledgeConfig(I2C1, ENABLE);                 // 恢复ACK使能
    return data;
}

四、常见问题解决

1. 通信失败：

   • 检查上拉电阻（必须添加）。
   • 确认从机地址正确（7位地址需左移1位，最低位为R/W位）。
   • 用逻辑分析仪抓取SCL/SDA波形分析时序。

2. STM32F1 I2C硬件Bug：

   • 在连续通信时可能出现卡死，建议：
     • 超时复位I2C总线（置CR1的SWRST位）。
     • 使用软件模拟I2C（GPIO模拟时序）。

五、进阶建议

• 中断/DMA模式：大数据传输时使用，减轻CPU负担。

• HAL库开发：使用STM32CubeMX生成初始化代码（更便捷）：

  #include "stm32f1xx_hal.h"
  I2C_HandleTypeDef hi2c1;
  
  void HAL_I2C_MspInit(I2C_HandleTypeDef *hi2c) {
    // 自动生成的GPIO和时钟配置
  }
  
  HAL_I2C_Init(&hi2c1);  // 初始化I2C
  HAL_I2C_Master_Transmit(&hi2c1, SlaveAddr, &data, 1, 100); // 发送数据

提示：完整工程建议结合STM32CubeMX配置引脚和时钟树，再调用上述函数实现功能。调试时可通过printf输出状态信息辅助排查问题。

如果需要更具体的场景实现（如OLED驱动、EEPROM读写等），请提供详细需求！