GD32F103C8T6 I2C实战：用两块板子互发数据，手把手调试SBSEND、ADDSEND这些关键状态位

GD32F103C8T6 I2C双机通信实战：状态位调试全解析

两块GD32开发板通过I2C互传数据时，你是否遇到过代码看似正确却卡在while(!i2c_flag_get(I2C0, I2C_FLAG_SBSEND))这样的死循环？本文将带你深入I2C状态机的运作细节，通过逻辑分析仪实测波形与代码联调，彻底掌握GD32F103C8T6的I2C状态位操作精髓。

1. 硬件环境搭建与典型问题场景

在开始调试之前，正确的硬件连接是基础。GD32F103C8T6有两个I2C外设，建议使用I2C0作为主机，I2C1作为从机进行测试：

• 引脚配置：
  • I2C0_SCL: PB6
  • I2C0_SDA: PB7
  • I2C1_SCL: PB10
  • I2C1_SDA: PB11

必须将GPIO设置为复用开漏模式（GPIO_MODE_AF_OD），并外接4.7kΩ上拉电阻至3.3V。常见硬件问题包括：

• 未接上拉电阻导致信号无法拉高
• 误将引脚配置为推挽输出
• 板间共地不完整引发电平异常

// 正确的GPIO初始化示例 rcu_periph_clock_enable(RCU_GPIOB); gpio_init(GPIOB, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, GPIO_PIN_6 | GPIO_PIN_7 | GPIO_PIN_10 | GPIO_PIN_11);

提示：当I2C通信异常时，先用万用表测量SCL/SDA电压，正常时应为3.3V（空闲状态）。若电压低于2.8V，可能上拉电阻过大或存在短路。

2. 状态位机制深度剖析

GD32的I2C状态位是调试的核心关键，每个标志位都对应着特定的总线事件。我们以主机发送模式为例，解析典型状态序列：

1. SBSEND（起始位发送）
   当调用i2c_start_on_bus()后，硬件检测到START条件完成时置位。常见卡死原因：

   • 总线被其他设备占用（持续检测I2CBSY标志）
   • 时钟配置错误导致时序违规

2. ADDSEND（地址发送）
   在7位地址传输完成后置位。若未触发可能由于：

   • 从机地址不匹配
   • 总线受干扰导致地址传输错误
   • 从机未正确初始化

// 典型的状态位等待与清除流程 i2c_start_on_bus(I2C0); while(!i2c_flag_get(I2C0, I2C_FLAG_SBSEND)); // 等待起始位完成 i2c_master_addressing(I2C0, 0x72, I2C_TRANSMITTER); while(!i2c_flag_get(I2C0, I2C_FLAG_ADDSEND)); // 等待地址发送完成 i2c_flag_clear(I2C0, I2C_FLAG_ADDSEND); // 必须手动清除

3. 双机通信调试实战

3.1 主机发送从机接收模式

通过逻辑分析仪捕获的实际波形显示，完整的数据传输包含以下关键阶段：

典型问题解决方案：

• 当卡在TBE等待时，检查：
  • 从机是否已正确配置为接收模式
  • 时钟频率是否一致（主机从机应相同）
  • 是否有信号完整性问题（过长的飞线导致波形畸变）

// 主机发送数据段优化代码 for(uint8_t i = 0; i < 16; i++) { i2c_data_transmit(I2C0, data[i]); // 增加超时检测 uint32_t timeout = 100000; while(!i2c_flag_get(I2C0, I2C_FLAG_TBE) && timeout--); if(timeout == 0) { i2c_stop_on_bus(I2C0); printf("Transmission timeout!\n"); break; } }

3.2 主机接收从机发送模式

在接收最后一个字节时需要特殊处理：

1. 在倒数第二个字节接收后关闭ACK：

   i2c_ack_config(I2C0, I2C_ACK_DISABLE);

2. 发送STOP条件前检查AERR标志：

   while(!i2c_flag_get(I2C1, I2C_FLAG_AERR)); i2c_flag_clear(I2C1, I2C_FLAG_AERR);

注意：GD32的I2C从机在收到NACK时会置位AERR标志，必须手动清除才能继续下一次通信。

4. 高级调试技巧

4.1 逻辑分析仪诊断

使用Saleae逻辑分析仪捕获的异常波形分析：

• 案例1：SCL频率异常
  测得实际时钟为85kHz（配置应为100kHz），检查发现：

  i2c_clock_config(I2C0, 100000, I2C_DTCY_2);

  第二个参数实际应为时钟频率值而非分频系数

• 案例2：ACK信号缺失
  波形显示从机未返回ACK，可能原因：

  • 从机地址配置错误
  • 从机电源不稳定
  • 从机程序卡死在中断处理

4.2 软件模拟I2C对比

当硬件I2C难以调试时，可临时改用GPIO模拟作为参照：

// 模拟I2C起始条件 void I2C_Simulate_Start(void) { SDA_HIGH(); SCL_HIGH(); delay_us(5); SDA_LOW(); delay_us(5); SCL_LOW(); }

5. 常见问题速查表

以下是开发者最常遇到的10个问题及解决方案：

1. 卡在SBSEND等待

   • 检查I2CBSY状态，确保总线空闲
   • 测量SCL/SDA线路是否正常拉高

2. ADDSEND不置位

   • 确认从机地址匹配（包括左移1位问题）
   • 检查从机初始化代码是否调用了i2c_enable()

3. 数据传输出错

   • 降低时钟频率测试（如改为10kHz）
   • 添加信号缓冲器或缩短连接线缆

4. 随机通信失败

   • 在START条件前增加总线空闲等待
   • 启用I2C的PEC校验功能（如果支持）

5. 从机无响应

   • 验证从机VCC供电稳定
   • 检查从机复位电路是否正常

在实际项目中，我发现最容易被忽视的是GPIO速度配置。当使用50MHz高速模式时，必须确保PCB走线阻抗匹配，否则会产生信号振铃：

gpio_init(GPIOB, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, GPIO_PIN_6);