别再纠结硬件还是软件了！手把手教你用STM32的GPIO模拟I2C驱动AHT20温湿度传感器

从零实现STM32 GPIO模拟I2C驱动AHT20：避开硬件I2C的那些坑

第一次在STM32上尝试读取AHT20温湿度传感器时，我也曾陷入硬件I2C的配置泥潭。那些复杂的初始化参数、难以捉摸的时序问题，以及突然出现的通信失败，让本应简单的传感器读取变得异常艰难。直到改用GPIO模拟I2C后，才发现原来问题可以如此简单解决——不需要纠结于外设寄存器的配置，不需要担心引脚冲突，更不用忍受晦涩难懂的HAL库函数。本文将带你用最直接的方式，通过GPIO模拟实现AHT20的稳定读取。

1. 为什么GPIO模拟I2C更适合初学者

1.1 硬件I2C的三大痛点

在STM32生态中，硬件I2C一直是个让人又爱又恨的存在。理论上它应该简化开发，但实际上却经常带来意想不到的困扰：

• 引脚限制：每个STM32型号的硬件I2C外设都绑定在特定引脚上。比如STM32F103C8T6的I2C1只能使用PB6/PB7或PB8/PB9，当这些引脚已被其他功能占用时，要么重新设计电路，要么改用其他外设。

• 库函数复杂性：以STM32 HAL库为例，一个基础的I2C初始化需要配置至少6个参数结构体成员：

hi2c1.Instance = I2C1; hi2c1.Init.ClockSpeed = 100000; hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 = 0; hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;

• 调试困难：当通信失败时，硬件I2C提供的错误信息往往非常有限。常见的I2C总线锁死问题（Busy Flag置位）需要复杂的复位序列才能恢复。

1.2 软件模拟的四大优势

相比之下，GPIO模拟I2C（常被称为"软件I2C"或"Bit-Banging I2C"）展现出了明显的优势：

1. 引脚自由：可以任意选择两个GPIO作为SCL和SDA，完全避开硬件冲突
2. 代码透明：每个时序阶段都通过明确的GPIO操作实现，便于理解和调试
3. 时序可控：可以根据设备特性灵活调整时钟速度，特别适合AHT20这类对时序有特殊要求的传感器
4. 跨平台：相同的逻辑可以轻松移植到其他单片机，不依赖特定硬件外设

提示：虽然硬件I2C在高速通信（>400kHz）时更有优势，但AHT20的标准工作频率仅为100kHz，GPIO模拟完全能够胜任。

2. AHT20传感器关键特性解析

2.1 电气参数与通信要求

AHT20作为新一代温湿度传感器，相比经典的SHT系列有几个显著特点：

2.2 数据格式与校准机制

AHT20的温湿度数据采用20位原始值输出，需要通过特定公式转换：

• 湿度计算：

  humidity = (raw_value / 1048576.0) * 100.0; // 1048576 = 2^20

• 温度计算：

  temperature = (raw_value / 1048576.0) * 200.0 - 50.0;

传感器内部自带校准系数，每次上电后需要发送初始化命令（0xBE）加载这些参数。这也是许多初学者容易忽略的关键步骤——直接读取数据会导致返回全0xFF。

3. 手把手构建GPIO模拟I2C驱动

3.1 硬件连接方案

虽然GPIO模拟允许任意引脚组合，但为保持良好实践，建议遵循以下原则：

1. 选择同一GPIO组的引脚（如都使用GPIOB）以简化代码
2. 避免使用JTAG/SWD调试引脚（PA13/PA14/PA15/PB3）
3. 优先选择内部带上拉的引脚，减少外部元件

典型连接方式（以STM32F103C8T6为例）：

AHT20 | STM32 ---------|--------- VCC(2.7-5.5V) | 3.3V GND | GND SCL | PB6（可任意更改） SDA | PB7（可任意更改）

注意：AHT20的SDA线需要上拉电阻（通常4.7kΩ），但大多数开发板已包含，无需额外添加。

3.2 基础GPIO操作函数

首先实现最底层的GPIO控制函数，这是整个软件I2C的基石：

// 定义使用的GPIO引脚 #define I2C_SCL_PORT GPIOB #define I2C_SDA_PORT GPIOB #define I2C_SCL_PIN GPIO_PIN_6 #define I2C_SDA_PIN GPIO_PIN_7 // SCL线控制 void I2C_SCL_High(void) { HAL_GPIO_WritePin(I2C_SCL_PORT, I2C_SCL_PIN, GPIO_PIN_SET); delay_us(5); // 保持高电平时间 } void I2C_SCL_Low(void) { HAL_GPIO_WritePin(I2C_SCL_PORT, I2C_SCL_PIN, GPIO_PIN_RESET); delay_us(5); // 保持低电平时间 } // SDA线控制 void I2C_SDA_High(void) { HAL_GPIO_WritePin(I2C_SDA_PORT, I2C_SDA_PIN, GPIO_PIN_SET); delay_us(2); } void I2C_SDA_Low(void) { HAL_GPIO_WritePin(I2C_SDA_PORT, I2C_SDA_PIN, GPIO_PIN_RESET); delay_us(2); } // SDA线读取 uint8_t I2C_SDA_Read(void) { return HAL_GPIO_ReadPin(I2C_SDA_PORT, I2C_SDA_PIN); } // SDA线方向设置 void I2C_SDA_Input(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = I2C_SDA_PIN; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_NOPULL; HAL_GPIO_Init(I2C_SDA_PORT, &GPIO_InitStruct); } void I2C_SDA_Output(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = I2C_SDA_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; // 开漏输出 GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(I2C_SDA_PORT, &GPIO_InitStruct); }

3.3 I2C时序关键实现

基于上述基础函数，我们可以构建完整的I2C协议时序：

// 产生I2C起始信号 void I2C_Start(void) { I2C_SDA_Output(); I2C_SDA_High(); I2C_SCL_High(); delay_us(4); I2C_SDA_Low(); delay_us(4); I2C_SCL_Low(); } // 产生I2C停止信号 void I2C_Stop(void) { I2C_SDA_Output(); I2C_SDA_Low(); I2C_SCL_High(); delay_us(4); I2C_SDA_High(); delay_us(4); } // 等待ACK信号 uint8_t I2C_Wait_Ack(void) { uint8_t timeout = 255; I2C_SDA_Input(); I2C_SCL_High(); delay_us(2); while(I2C_SDA_Read() == GPIO_PIN_SET) { if(--timeout == 0) { I2C_Stop(); return 1; // 超时无ACK } delay_us(1); } I2C_SCL_Low(); return 0; // 正常收到ACK } // 发送一个字节 void I2C_Send_Byte(uint8_t byte) { I2C_SDA_Output(); for(uint8_t i=0; i<8; i++) { if(byte & 0x80) I2C_SDA_High(); else I2C_SDA_Low(); I2C_SCL_High(); delay_us(3); I2C_SCL_Low(); byte <<= 1; delay_us(3); } } // 读取一个字节 uint8_t I2C_Read_Byte(uint8_t ack) { uint8_t byte = 0; I2C_SDA_Input(); for(uint8_t i=0; i<8; i++) { byte <<= 1; I2C_SCL_High(); delay_us(2); if(I2C_SDA_Read()) byte |= 0x01; I2C_SCL_Low(); delay_us(2); } // 发送ACK/NACK I2C_SDA_Output(); if(ack) I2C_SDA_Low(); else I2C_SDA_High(); I2C_SCL_High(); delay_us(2); I2C_SCL_Low(); I2C_SDA_High(); // 释放SDA return byte; }

4. AHT20完整驱动实现

4.1 传感器初始化序列

AHT20上电后需要特定的初始化流程才能进入正常工作状态：

#define AHT20_ADDRESS 0x38 // 7位设备地址 void AHT20_Init(void) { uint8_t cmd[3] = {0}; // 软复位命令 cmd[0] = 0xBA; I2C_Start(); I2C_Send_Byte(AHT20_ADDRESS << 1); I2C_Wait_Ack(); I2C_Send_Byte(cmd[0]); I2C_Wait_Ack(); I2C_Stop(); HAL_Delay(20); // 等待复位完成 // 初始化命令 cmd[0] = 0xBE; cmd[1] = 0x08; cmd[2] = 0x00; I2C_Start(); I2C_Send_Byte(AHT20_ADDRESS << 1); I2C_Wait_Ack(); for(uint8_t i=0; i<3; i++) { I2C_Send_Byte(cmd[i]); I2C_Wait_Ack(); } I2C_Stop(); HAL_Delay(10); // 等待校准加载 }

4.2 温湿度数据读取与处理

完整的测量流程包括触发测量、等待转换和读取数据三个阶段：

void AHT20_Read(float *temperature, float *humidity) { uint8_t data[6] = {0}; uint8_t cmd[3] = {0xAC, 0x33, 0x00}; // 触发测量 I2C_Start(); I2C_Send_Byte(AHT20_ADDRESS << 1); I2C_Wait_Ack(); for(uint8_t i=0; i<3; i++) { I2C_Send_Byte(cmd[i]); I2C_Wait_Ack(); } I2C_Stop(); HAL_Delay(80); // 等待测量完成 // 读取数据 I2C_Start(); I2C_Send_Byte((AHT20_ADDRESS << 1) | 0x01); I2C_Wait_Ack(); for(uint8_t i=0; i<6; i++) { data[i] = I2C_Read_Byte(i==5 ? 0 : 1); // 最后一个字节发NACK } I2C_Stop(); // 检查状态位 if((data[0] & 0x68) != 0x08) { *temperature = -99.9; *humidity = -99.9; return; } // 数据转换 uint32_t raw_humidity = ((uint32_t)data[1] << 12) | ((uint32_t)data[2] << 4) | ((uint32_t)data[3] >> 4); uint32_t raw_temp = (((uint32_t)data[3] & 0x0F) << 16) | ((uint32_t)data[4] << 8) | data[5]; *humidity = (float)raw_humidity * 100.0 / 1048576.0; *temperature = (float)raw_temp * 200.0 / 1048576.0 - 50.0; }

4.3 实际应用示例

将上述驱动集成到主程序中：

int main(void) { HAL_Init(); SystemClock_Config(); // GPIO初始化 __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = I2C_SCL_PIN | I2C_SDA_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); // 初始化AHT20 AHT20_Init(); float temp, humi; while(1) { AHT20_Read(&temp, &humi); printf("Temperature: %.1f C, Humidity: %.1f%%\r\n", temp, humi); HAL_Delay(2000); // 每2秒读取一次 } }

5. 调试技巧与常见问题解决

5.1 逻辑分析仪抓取I2C波形

当通信出现问题时，逻辑分析仪是最直接的诊断工具。正常工作的AHT20读取波形应包含：

1. 起始信号（SDA下降沿时SCL为高）
2. 设备地址0x70（7位地址0x38左移一位，写模式）
3. 测量触发命令0xAC
4. 第二次起始信号
5. 设备地址0x71（读模式）
6. 6个数据字节+ACK/NACK

典型问题波形特征：

• 无ACK响应：检查设备地址是否正确、VCC供电是否正常、上拉电阻是否合适
• 数据全为0xFF：通常表示传感器未正确初始化，检查初始化序列
• SCL线持续低电平：I2C总线锁死，尝试重新初始化GPIO

5.2 软件模拟时的时序优化

GPIO模拟I2C的时序精度取决于delay_us()函数的准确性。如果发现通信不稳定：

1. 校准delay_us()函数，确保实际延时与参数一致
2. 适当增加关键位置的延时时间，特别是SCL高电平期间
3. 在I2C_SDA_Read()前后添加短暂延时，确保信号稳定

// 更精确的延时实现示例（基于SysTick） void delay_us(uint32_t us) { uint32_t start = HAL_GetTick(); while((HAL_GetTick() - start) < us) { __NOP(); } }

5.3 典型错误代码与解决方案