STM32CubeIDE实战：用I2C中断+DMA驱动AHT20温湿度传感器（附完整代码）
在嵌入式系统开发中，环境监测是一个常见需求。AHT20作为新一代数字温湿度传感器，以其高精度、低功耗和I2C接口的便利性，成为许多项目的首选。本文将带你从零开始，在STM32CubeIDE环境下构建一个完整的AHT20驱动方案，重点展示如何结合I2C中断和DMA技术实现高效数据采集。
1. 项目规划与硬件准备
选择AHT20传感器主要基于三个考量：首先，其±2%RH的湿度精度和±0.3℃的温度精度满足大多数应用场景；其次，1.5μA的超低待机电流特别适合电池供电设备；最后，标准I2C接口简化了硬件连接。
硬件连接只需四条线：
- VCC（3.3V）
- GND
- SCL（PB6）
- SDA（PB7）
关键硬件配置要点：
// CubeMX中的I2C配置 hi2c1.Instance = I2C1; hi2c1.Init.ClockSpeed = 100000; // 标准模式100kHz hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;注意：实际布线时，SCL和SDA线建议使用4.7kΩ上拉电阻，线长超过10cm时应考虑降低通信速率。
2. 三种通信模式对比分析
2.1 轮询模式基础实现
轮询模式是最直接的实现方式，适合简单应用场景。典型代码结构如下：
HAL_StatusTypeDef AHT20_ReadData(float *temp, float *humidity) { uint8_t cmd[3] = {0xAC, 0x33, 0x00}; uint8_t data[6]; HAL_I2C_Master_Transmit(&hi2c1, 0x70<<1, cmd, 3, 100); HAL_Delay(80); // 必须等待测量完成 HAL_I2C_Master_Receive(&hi2c1, 0x70<<1, data, 6, 100); // 数据解析... }轮询模式优缺点：
- 优点：实现简单，代码直观
- 缺点：阻塞式等待浪费CPU资源，实时性差
2.2 中断驱动方案优化
中断模式通过状态机实现非阻塞操作。关键改进点包括：
- 分解测量流程为独立步骤
- 使用全局状态变量跟踪进度
- 在回调函数中推进状态
typedef enum { AHT20_IDLE, AHT20_MEASURING, AHT20_WAITING, AHT20_READING, AHT20_DATA_READY } AHT20_State; void HAL_I2C_MasterTxCpltCallback(I2C_HandleTypeDef *hi2c) { if(hi2c == &hi2c1) { aht20_state = AHT20_WAITING; measurement_timer = HAL_GetTick(); // 记录开始等待时间 } }2.3 DMA模式性能突破
DMA模式将数据传输工作完全交给硬件，CPU只需处理最终数据。配置要点：
- 在CubeMX中启用I2C对应的DMA通道
- 设置DMA为循环模式（Circular）
- 配置合适的中断优先级
三种模式性能对比：
| 指标 | 轮询模式 | 中断模式 | DMA模式 |
|---|---|---|---|
| CPU占用率 | 高 | 中 | 极低 |
| 响应延迟 | 不可预测 | <100μs | <50μs |
| 代码复杂度 | 简单 | 中等 | 较复杂 |
| 适合场景 | 简单应用 | 通用场景 | 高频采集 |
3. 中断+DMA混合方案实现
结合两种技术的优势，我们设计分层架构：
3.1 硬件抽象层设计
// aht20_driver.h typedef struct { float temperature; float humidity; uint8_t status; } AHT20_Data; void AHT20_Init(I2C_HandleTypeDef *hi2c); void AHT20_StartMeasurement(void); uint8_t AHT20_GetData(AHT20_Data *output);3.2 状态机核心逻辑
// 测量状态定义 #define STATE_IDLE 0 #define STATE_CMD_SENT 1 #define STATE_DATA_READY 2 void AHT20_MeasurementCompleteCallback(void) { static uint8_t raw_data[6]; // 启动DMA接收 HAL_I2C_Master_Receive_DMA(&hi2c1, AHT20_ADDR, raw_data, 6); }3.3 错误处理机制
完善的错误恢复流程包括：
- 总线错误检测与复位
- 超时监控
- 数据校验
void HAL_I2C_ErrorCallback(I2C_HandleTypeDef *hi2c) { if(hi2c == &hi2c1) { uint32_t errors = HAL_I2C_GetError(hi2c); if(errors & HAL_I2C_ERROR_AF) { // 应答失败处理 } // 其他错误处理... HAL_I2C_Init(hi2c); // 重新初始化I2C } }4. 工程实践与优化技巧
4.1 电源噪声抑制
AHT20对电源噪声敏感，建议：
- 添加10μF+0.1μF去耦电容
- 独立LDO供电
- 避免与大电流负载共用电源
4.2 通信可靠性提升
实测中发现的问题及解决方案：
- 启动失败：上电后等待至少20ms再初始化
- 数据异常：添加CRC校验（AHT20手册附录B）
- 总线冲突：实现软件I2C超时机制
#define I2C_TIMEOUT 50 // ms HAL_StatusTypeDef Safe_I2C_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size) { uint32_t tickstart = HAL_GetTick(); while(HAL_I2C_GetState(hi2c) != HAL_I2C_STATE_READY) { if((HAL_GetTick() - tickstart) > I2C_TIMEOUT) { return HAL_TIMEOUT; } } return HAL_I2C_Master_Transmit(hi2c, DevAddress, pData, Size, I2C_TIMEOUT); }4.3 低功耗设计
对于电池供电设备：
- 将测量间隔延长至30秒
- 在休眠期间关闭I2C外设时钟
- 使用唤醒中断触发测量
void Enter_LowPowerMode(void) { HAL_I2C_DeInit(&hi2c1); __HAL_RCC_I2C1_CLK_DISABLE(); HAL_SuspendTick(); HAL_PWR_EnterSLEEPMode(PWR_MAINREGULATOR_ON, PWR_SLEEPENTRY_WFI); }5. 完整代码架构
项目采用模块化设计，主要文件包括：
├── Core/ │ ├── Src/ │ │ ├── main.c # 主循环和状态机 │ │ ├── i2c.c # HAL库回调函数 │ ├── Inc/ │ │ ├── aht20_driver.h # 传感器接口定义 ├── Drivers/ │ ├── AHT20/ │ │ ├── aht20.c # 传感器核心驱动关键代码片段：
// aht20.c void AHT20_Process(void) { static uint32_t last_measure = 0; if(HAL_GetTick() - last_measure > MEASURE_INTERVAL) { if(aht20_state == AHT20_IDLE) { uint8_t cmd[3] = {0xAC, 0x33, 0x00}; HAL_I2C_Master_Transmit_IT(&hi2c1, AHT20_ADDR, cmd, 3); aht20_state = AHT20_MEASURING; last_measure = HAL_GetTick(); } } }在实际部署中发现，当环境温度快速变化时，传感器需要更长的稳定时间。通过实验确定，在温度变化超过5℃/分钟时，应将测量间隔从标准的1秒延长到3秒，这样可以避免读取到过渡状态的不稳定数据。
