保姆级教程：用STM32CubeMX+Keil5快速搞定AHT21B温湿度数据采集（含串口打印和避坑点）
STM32CubeMX与Keil5实战：AHT21B温湿度采集全流程解析
在物联网和智能硬件开发中，环境数据采集是基础且关键的一环。AHT21B作为新一代高精度温湿度传感器，凭借其I2C接口和小尺寸封装，成为嵌入式开发者的热门选择。本文将带你从零开始，使用STM32CubeMX图形化工具配置硬件，结合Keil5开发环境，实现稳定可靠的温湿度数据采集与串口输出。
1. 开发环境搭建与硬件连接
1.1 工具链准备
开发AHT21B温湿度采集系统需要以下核心工具：
- STM32CubeMX：图形化配置工具（最新版本建议6.3.0+）
- Keil MDK-ARM：集成开发环境（需安装STM32F1xx Device Family Pack）
- 串口调试助手：如Tera Term或Putty
安装完成后，建议检查以下关键点：
# 验证STM32CubeMX是否包含STM32F1系列支持包 STM32CubeMX → Help → Manage embedded software packages → STM32F11.2 硬件连接规范
AHT21B与STM32F103C8T6最小系统板的连接方式如下表所示：
| AHT21B引脚 | STM32引脚 | 备注 |
|---|---|---|
| VCC | 3.3V | 严禁接5V电源 |
| GND | GND | 共地连接 |
| SDA | PB7 | 开漏输出需上拉4.7KΩ |
| SCL | PB6 | 开漏输出需上拉4.7KΩ |
注意：实际项目中建议在PCB设计时直接在传感器端放置上拉电阻，避免飞线引入干扰。
2. STM32CubeMX关键配置
2.1 时钟树配置
- 选择HSE（外部高速时钟）作为时钟源
- 配置系统时钟为72MHz（STM32F103C8T6最高主频）
- 确保APB1总线时钟不超过36MHz（I2C时钟源）
时钟配置常见问题排查：
- 若I2C通信失败，首先检查APB1时钟是否超频
- 使用示波器测量SCL信号频率是否与配置一致
2.2 I2C接口配置
在STM32CubeMX中按以下参数配置I2C1：
I2C Mode: I2C Speed Mode: Standard Mode (100kHz) Duty Cycle: 2 Own Address: 0x00 Primary Address Length: 7-bit关键寄存器设置对比：
| 参数 | 标准模式(100kHz) | 快速模式(400kHz) |
|---|---|---|
| CCR | 0x0036 | 0x0018 |
| TRISE | 0x0009 | 0x0003 |
| 最大上升时间(ns) | 1000 | 300 |
2.3 串口调试输出配置
USART1基础参数：
- 波特率：115200
- 数据位：8bit
- 停止位：1bit
- 无校验位
启用串口中断（可选）：
NVIC → USART1 global interrupt → Enabled Priority: 13. Keil工程开发实战
3.1 AHT21B驱动移植
在生成的MDK-ARM工程中创建aht21b.c/h文件，实现以下核心函数：
// 初始化函数 HAL_StatusTypeDef AHT21B_Init(I2C_HandleTypeDef *hi2c) { uint8_t cmd[3] = {0xE1, 0x08, 0x00}; return HAL_I2C_Master_Transmit(hi2c, AHT21B_ADDR, cmd, 3, HAL_MAX_DELAY); } // 数据读取函数 HAL_StatusTypeDef AHT21B_Read_Data(I2C_HandleTypeDef *hi2c, float *temp, float *humi) { uint8_t tx_cmd = 0xAC; uint8_t rx_data[6]; // 发送触发测量命令 HAL_I2C_Master_Transmit(hi2c, AHT21B_ADDR, &tx_cmd, 1, HAL_MAX_DELAY); // 等待测量完成（典型时间75ms） HAL_Delay(80); // 读取6字节数据 HAL_I2C_Master_Receive(hi2c, AHT21B_ADDR, rx_data, 6, HAL_MAX_DELAY); // 数据转换处理 uint32_t humi_raw = ((rx_data[1] << 16) | (rx_data[2] << 8) | rx_data[3]) >> 4; uint32_t temp_raw = ((rx_data[3] & 0x0F) << 16) | (rx_data[4] << 8) | rx_data[5]; *humi = (float)humi_raw * 100 / 1048576; *temp = (float)temp_raw * 200 / 1048576 - 50; return HAL_OK; }3.2 主程序逻辑实现
在main.c中添加数据采集与串口输出逻辑：
int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_USART1_UART_Init(); float temperature, humidity; char uart_buf[64]; // 传感器初始化 while(AHT21B_Init(&hi2c1) != HAL_OK) { HAL_Delay(100); } while (1) { if(AHT21B_Read_Data(&hi2c1, &temperature, &humidity) == HAL_OK) { sprintf(uart_buf, "Temp:%.1fC Humi:%.1f%%\r\n", temperature, humidity); HAL_UART_Transmit(&huart1, (uint8_t*)uart_buf, strlen(uart_buf), HAL_MAX_DELAY); } HAL_Delay(2000); // 2秒采集间隔 } }4. 常见问题与性能优化
4.1 I2C通信故障排查
当遇到通信失败时，建议按以下步骤排查：
电源检查
- 测量VCC电压是否稳定在3.3V±5%
- 检查GND连接是否可靠
信号质量检测
- 用示波器观察SCL/SDA波形
- 检查上升时间是否符合标准（标准模式≤1μs）
软件调试技巧
- 在I2C初始化后添加复位序列：
__HAL_I2C_DISABLE(&hi2c1); HAL_Delay(1); __HAL_I2C_ENABLE(&hi2c1);
4.2 精度提升方案
为提高测量精度，可采取以下措施：
- 电源去耦：在传感器VCC引脚就近放置0.1μF陶瓷电容
- 温度补偿：根据实际环境校准偏移值
- 软件滤波：采用滑动平均算法处理数据
滤波算法示例实现：
#define FILTER_SIZE 5 typedef struct { float buffer[FILTER_SIZE]; uint8_t index; } Filter_t; float filter_AddValue(Filter_t *f, float value) { f->buffer[f->index++] = value; if(f->index >= FILTER_SIZE) f->index = 0; float sum = 0; for(int i=0; i<FILTER_SIZE; i++) { sum += f->buffer[i]; } return sum / FILTER_SIZE; }4.3 低功耗优化
对于电池供电设备，可实施以下优化：
间歇工作模式：
- 将采集间隔延长至30秒或更长
- 在休眠期间关闭传感器电源
硬件优化：
- 选择低功耗LDO（如HT7333）
- 使用MOS管控制传感器电源
代码优化：
// 进入停止模式 HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); // 唤醒后需要重新初始化外设 SystemClock_Config(); MX_I2C1_Init();
在实际项目中，我们曾遇到传感器在高温环境下数据异常的情况，后来发现是PCB走线过长导致信号衰减。通过缩短走线距离并增加上拉电阻值（从4.7KΩ改为2.2KΩ），问题得到完美解决。这提醒我们，硬件设计细节往往比软件算法更能决定系统的可靠性。