STM32F103指南者实战：软件I2C驱动AHT20温湿度传感器
1. 硬件I2C与软件I2C的本质区别
第一次接触I2C通信时，很多人都会被"硬件I2C"和"软件I2C"这两个概念搞糊涂。我刚开始用STM32的时候也踩过这个坑，后来在实际项目中才真正理解它们的区别。简单来说，硬件I2C是芯片内置的专用电路，就像你手机里的专业相机模块；而软件I2C则是用普通GPIO口模拟出来的，相当于用软件算法实现的"软相机"。
硬件I2C最大的优势是效率高。以STM32F103的硬件I2C为例，时钟频率最高能到400kHz（快速模式），而且通信过程完全由硬件自动处理，不占用CPU资源。我在做一个工业传感器项目时测试过，同样的数据量，硬件I2C比软件模拟的快了近3倍。但它的缺点也很明显——引脚固定，比如STM32F103的I2C1只能使用PB6(SCL)和PB7(SDA)。
软件I2C的灵活性是它的杀手锏。你可以用任意GPIO口来模拟，就像我在指南者开发板上做的这个实验，选择了PB6和PB7只是出于习惯，其实换成PA1、PC3之类的引脚也完全没问题。这种灵活性在PCB布线受限时特别有用。不过代价就是速度较慢，我的实测数据显示，用GPIO模拟的I2C在STM32F103上最高只能跑到约100kHz。
这里有个实际选择建议：如果需要高速传输或者要接多个I2C设备，优先考虑硬件I2C；如果引脚资源紧张或者要兼容不同硬件平台，软件I2C更适合。我在智能家居项目中就经常混用——主控用硬件I2C连接关键传感器，次要设备用软件I2C。
2. AHT20温湿度传感器深度解析
AHT20是近年来非常流行的一款温湿度传感器，相比经典的DHT11/DHT22，它的精度和稳定性都有明显提升。我拆解过多个型号的AHT20模块，发现虽然外观各异，但核心都是相同的ASIC芯片。这款传感器的温度测量范围是-40~85℃，精度±0.3℃；湿度范围0~100%RH，精度±2%RH。
在实际使用中，有几点需要特别注意：
- 上电后需要至少20ms的稳定时间，我建议像我的代码里那样延迟100ms更保险
- 测量间隔最好大于1秒，连续快速读取会导致数据不准
- 传感器对电源噪声敏感，建议在VCC引脚加个0.1μF的滤波电容
AHT20的I2C地址固定为0x38，这个地址在初始化时要注意。有一次我调试了半天才发现是把地址错写成0x70了（这是7位地址和8位地址写法的区别）。它的通信协议也比较特殊，测量启动后需要等待80ms才能读取数据，这个等待时间一定要给足。
传感器的数据处理也有讲究。原始数据是20位的，需要按照手册给的公式转换：
温度(℃) = (T1 * 200 / 1048576) - 50 湿度(%RH) = (H1 * 100 / 1048576)我在代码里做了优化，把除法和浮点运算都转换成了整数运算，这样在STM32上执行效率更高。
3. STM32指南者开发板硬件连接详解
拿到STM32指南者开发板的第一感觉就是接口丰富，这对初学者特别友好。我在实验室带了多年学生，发现硬件连接错误是最常见的坑。以AHT20为例，正确的连接方式应该是：
| AHT20引脚 | STM32连接点 | 注意事项 |
|---|---|---|
| VCC | 5V | 也可接3.3V，但精度会略有下降 |
| GND | 任意GND | 建议靠近传感器端加滤波电容 |
| SDA | PB7 | 需配置为开漏输出 |
| SCL | PB6 | 需配置为开漏输出 |
这里有个细节要注意：I2C总线需要上拉电阻！虽然有些AHT20模块已经内置了（通常是4.7kΩ），但如果用的是裸芯片，一定要在SDA和SCL线上各加一个上拉电阻。我在早期项目中就犯过这个错误，导致信号波形畸变，数据经常出错。
开发板的串口1（USART1）默认连接在PA9(TX)和PA10(RX)，接串口调试助手时注意交叉连接——开发板的TX接USB转串口模块的RX。波特率设置为115200就行，这个速率在显示温湿度数据时完全够用，我在代码里已经配置好了。
电源方面有个小技巧：如果发现数据波动较大，可以尝试在开发板的5V和GND之间加一个100μF的电解电容，能有效抑制电源噪声。特别是在使用开关电源供电时，这个措施很管用。
4. 软件I2C的时序精准控制
用GPIO模拟I2C最关键的就是要把握好时序。我刚开始做的时候用示波器抓波形，发现信号质量总是不理想，后来总结出几个要点：
- 起始条件：SCL高电平时SDA从高变低，这个下降沿要干脆。我的代码里用了4μs的延时：
void IIC_Start(void) { SDA_OUT(); IIC_SDA=1; IIC_SCL=1; delay_us(4); IIC_SDA=0; delay_us(4); IIC_SCL=0; // 钳住总线 }- 数据有效性：SDA的变化必须发生在SCL低电平期间，高电平时数据保持稳定。每个时钟脉冲我留了2μs的建立时间：
void IIC_Send_Byte(u8 txd) { u8 t; SDA_OUT(); IIC_SCL=0; for(t=0;t<8;t++) { IIC_SDA=(txd&0x80)>>7; txd<<=1; delay_us(2); // 数据建立时间 IIC_SCL=1; delay_us(2); // 高电平保持 IIC_SCL=0; delay_us(2); } }- 停止条件：SCL高电平时SDA从低变高，这个上升沿要干净利落：
void IIC_Stop(void) { SDA_OUT(); IIC_SCL=0; IIC_SDA=0; delay_us(4); IIC_SCL=1; IIC_SDA=1; delay_us(4); }在实际调试时，我建议用逻辑分析仪观察波形。如果没有专业设备，可以用两个LED分别接SCL和SDA，通过LED的闪烁情况判断通信是否正常。记得LED要加限流电阻，我一般用220Ω。
5. AHT20的完整驱动实现
AHT20的驱动流程比常规I2C设备复杂些，需要严格按照以下步骤操作：
- 复位传感器（可选但建议）：
void reset_AHT20(void) { I2C_Start(); I2C_WriteByte(0x70); // 写地址 Receive_ACK(); I2C_WriteByte(0xBA); // 复位命令 Receive_ACK(); I2C_Stop(); }- 初始化校准：
void init_AHT20(void) { I2C_Start(); I2C_WriteByte(0x70); Receive_ACK(); I2C_WriteByte(0xE1); // 初始化命令 Receive_ACK(); I2C_WriteByte(0x08); // 校准参数 Receive_ACK(); I2C_WriteByte(0x00); Receive_ACK(); I2C_Stop(); }- 启动测量：
void startMeasure_AHT20(void) { I2C_Start(); I2C_WriteByte(0x70); Receive_ACK(); I2C_WriteByte(0xAC); // 触发测量 Receive_ACK(); I2C_WriteByte(0x33); // 参数 Receive_ACK(); I2C_WriteByte(0x00); Receive_ACK(); I2C_Stop(); }- 读取数据（注意80ms等待）：
void read_AHT20(void) { uint8_t i; I2C_Start(); I2C_WriteByte(0x71); // 读地址 Receive_ACK(); for(i=0;i<6;i++) { if(i<5) readByte[i]=I2C_ReadByte(); else readByte[i]=I2C_ReadByte(); // 最后一个字节不发ACK Send_ACK(); } I2C_Stop(); // 数据处理... }在实际项目中，我通常会把读取逻辑封装成一个函数，像这样每隔2秒自动读取一次：
while(1) { printf("开始测量，请稍等..."); read_AHT20_once(); // 封装好的完整读取函数 delay_ms(2000); }6. 串口输出与数据格式优化
串口输出看似简单，但要做好也不容易。我在代码中使用了重定向的printf，这样可以直接用C标准库函数输出。关键点在于：
- 串口初始化要正确设置波特率（115200）、数据位（8）、停止位（1）、无校验：
void uart_init(u32 bound) { // GPIO端口设置 GPIO_InitTypeDef GPIO_InitStructure; USART_InitTypeDef USART_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1|RCC_APB2Periph_GPIOA, ENABLE); // USART1_TX PA.9 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_Init(GPIOA, &GPIO_InitStructure); // USART1_RX PA.10 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, &GPIO_InitStructure); // USART初始化 USART_InitStructure.USART_BaudRate = bound; USART_InitStructure.USART_WordLength = USART_WordLength_8b; USART_InitStructure.USART_StopBits = USART_StopBits_1; USART_InitStructure.USART_Parity = USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, &USART_InitStructure); USART_Cmd(USART1, ENABLE); }- 数据格式化要友好，我习惯把温湿度显示为"温度：25.6℃ 湿度：45.2%"这样的格式：
printf("温度:%d%d.%d℃",T1/100,(T1/10)%10,T1%10); printf("湿度:%d%d.%d%%",H1/100,(H1/10)%10,H1%10);- 输出稳定性方面，建议添加CRC校验或者数据帧头尾，方便上位机解析。我在工业项目中常用这样的格式：
[AHT20] T=25.6 H=45.2这样用串口助手就能直接观察，也方便写简单的数据记录脚本。
7. 常见问题排查与性能优化
调试I2C设备时，十有八九会遇到通信失败的情况。根据我的经验，最常见的问题和解决方法如下：
无响应：首先检查硬件连接，用万用表测量VCC和GND是否正常。然后确认上拉电阻是否接好（4.7kΩ最理想）。如果还是不行，尝试降低I2C时钟速度，有时候传感器响应较慢。
数据错误：用逻辑分析仪抓取波形，检查时序是否符合规范。特别注意起始/停止条件和ACK信号。我在代码中添加了很多调试信息，比如每个步骤都输出状态：
ack_status = Receive_ACK(); if(ack_status) printf("步骤1成功"); else printf("步骤1失败");- 数据漂移：可能是电源噪声导致，尝试在传感器VCC引脚加滤波电容（0.1μF陶瓷电容并联10μF电解电容）。也有可能是传感器过热，AHT20长时间工作会有轻微自发热。
性能优化方面，我有几个实用建议：
- 减少delay时间，在保证可靠性的前提下尽量缩短等待时间
- 将浮点运算转换为定点运算，STM32F103没有FPU，浮点计算很耗资源
- 如果不需要高精度，可以适当降低采样频率
- 使用DMA传输数据，不过软件I2C不太适用
最后提醒一点：AHT20的精度会随使用时间略微下降，工业应用中建议每年校准一次。校准方法很简单，在已知温湿度环境下读取数据，与标准值比较后调整计算公式中的参数即可。