STM32F103C8T6与AHT20温湿度传感器开发全流程指南1. 项目概述与硬件准备在物联网和智能硬件开发领域环境监测是最基础也最常用的功能之一。STM32F103C8T6作为一款性价比极高的ARM Cortex-M3内核微控制器搭配AHT20这款高精度数字温湿度传感器可以构建一个稳定可靠的环境监测系统。这套组合特别适合智能家居、农业监测、仓储管理等应用场景。硬件清单STM32F103C8T6最小系统板Blue Pill开发板AHT20温湿度传感器模块I2C接口USB转TTL串口模块如CH340G杜邦线若干面包板可选硬件连接示意图STM32引脚AHT20引脚说明3.3VVCC电源正极GNDGND电源地PB6SCLI2C时钟线PB7SDAI2C数据线注意AHT20工作电压为1.8V-3.6V务必确保供电电压不超过3.6V否则可能损坏传感器。2. STM32CubeMX工程配置2.1 创建新工程打开STM32CubeMX点击New Project在MCU选择器中输入STM32F103C8选择STM32F103C8Tx型号确认封装为LQFP48这是Blue Pill开发板使用的封装2.2 时钟配置在Clock Configuration选项卡中选择HSE外部高速时钟为Crystal/Ceramic Resonator设置系统时钟源为PLLCLK配置PLL倍频为9使系统时钟达到72MHzAPB1预分频器设置为236MHzAPB2预分频器保持为172MHz2.3 外设配置I2C1配置在Pinout Configuration选项卡中找到I2C1设置模式为I2C参数保持默认时钟速度100kHz上升时间1000ns下降时间300nsUSART1配置找到USART1设置模式为Asynchronous参数配置Baud Rate115200Word Length8 bitsParityNoneStop Bits1GPIO配置确保I2C1的SCL(PB6)和SDA(PB7)引脚已自动配置检查USART1的TX(PA9)和RX(PA10)引脚配置2.4 生成代码在Project Manager选项卡中设置项目名称和存储路径选择Toolchain/IDEMDK-ARM/IAR/STM32CubeIDE等勾选Generate peripheral initialization as a pair of .c/.h files点击Generate Code生成工程3. 驱动程序开发3.1 AHT20驱动头文件创建aht20.h文件添加以下内容#ifndef __AHT20_H #define __AHT20_H #include stm32f1xx_hal.h #define AHT20_I2C_ADDRESS 0x38 // 7位地址HAL库会自动处理R/W位 // 初始化命令 #define AHT20_INIT_CMD 0xBE #define AHT20_MEASURE_CMD 0xAC #define AHT20_STATUS_CMD 0x71 // 状态位掩码 #define AHT20_STATUS_BUSY 0x80 #define AHT20_STATUS_CAL_ENABLED 0x08 void AHT20_Init(I2C_HandleTypeDef *hi2c); HAL_StatusTypeDef AHT20_StartMeasurement(I2C_HandleTypeDef *hi2c); HAL_StatusTypeDef AHT20_ReadData(I2C_HandleTypeDef *hi2c, float *temperature, float *humidity); #endif3.2 AHT20驱动实现创建aht20.c文件实现传感器驱动#include aht20.h #include math.h void AHT20_Init(I2C_HandleTypeDef *hi2c) { uint8_t status; uint8_t init_cmd[3] {AHT20_INIT_CMD, 0x08, 0x00}; // 上电后等待40ms HAL_Delay(40); // 读取状态字 HAL_I2C_Master_Receive(hi2c, AHT20_I2C_ADDRESS 1, status, 1, HAL_MAX_DELAY); // 检查校准使能位 if (!(status AHT20_STATUS_CAL_ENABLED)) { // 发送初始化命令 HAL_I2C_Master_Transmit(hi2c, AHT20_I2C_ADDRESS 1, init_cmd, 3, HAL_MAX_DELAY); HAL_Delay(10); // 等待初始化完成 } } HAL_StatusTypeDef AHT20_StartMeasurement(I2C_HandleTypeDef *hi2c) { uint8_t measure_cmd[3] {AHT20_MEASURE_CMD, 0x33, 0x00}; return HAL_I2C_Master_Transmit(hi2c, AHT20_I2C_ADDRESS 1, measure_cmd, 3, HAL_MAX_DELAY); } HAL_StatusTypeDef AHT20_ReadData(I2C_HandleTypeDef *hi2c, float *temperature, float *humidity) { uint8_t data[6]; uint8_t status; HAL_StatusTypeDef ret; // 读取状态字 ret HAL_I2C_Master_Receive(hi2c, AHT20_I2C_ADDRESS 1, status, 1, HAL_MAX_DELAY); if (ret ! HAL_OK || (status AHT20_STATUS_BUSY)) { return HAL_ERROR; } // 读取6字节数据 ret HAL_I2C_Master_Receive(hi2c, AHT20_I2C_ADDRESS 1, data, 6, HAL_MAX_DELAY); if (ret ! HAL_OK) { return ret; } // 计算湿度值 uint32_t hum_raw ((uint32_t)data[1] 12) | ((uint32_t)data[2] 4) | (data[3] 4); *humidity (float)hum_raw * 100.0f / (1 20); // 计算温度值 uint32_t temp_raw ((uint32_t)(data[3] 0x0F) 16) | ((uint32_t)data[4] 8) | data[5]; *temperature (float)temp_raw * 200.0f / (1 20) - 50.0f; return HAL_OK; }4. 主程序实现与调试4.1 主程序实现修改main.c文件添加以下代码#include main.h #include aht20.h #include stdio.h I2C_HandleTypeDef hi2c1; UART_HandleTypeDef huart1; void SystemClock_Config(void); static void MX_GPIO_Init(void); static void MX_I2C1_Init(void); static void MX_USART1_UART_Init(void); int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_USART1_UART_Init(); AHT20_Init(hi2c1); float temperature, humidity; char msg[64]; while (1) { if (AHT20_StartMeasurement(hi2c1) HAL_OK) { HAL_Delay(80); // 等待测量完成 if (AHT20_ReadData(hi2c1, temperature, humidity) HAL_OK) { int len snprintf(msg, sizeof(msg), Temperature: %.1f°C, Humidity: %.1f%%\r\n, temperature, humidity); HAL_UART_Transmit(huart1, (uint8_t*)msg, len, HAL_MAX_DELAY); } } HAL_Delay(2000); // 每2秒测量一次 } }4.2 串口调试技巧使用串口调试助手如Putty、Tera Term等查看输出配置串口参数115200-8-N-1常见问题排查无输出检查TX/RX接线是否正确串口配置是否匹配乱码检查时钟配置是否正确特别是HSE_VALUE定义I2C通信失败使用逻辑分析仪检查I2C波形调试提示在I2C通信失败时可以在代码中添加超时检测和错误处理通过串口输出调试信息。5. 进阶优化与扩展5.1 提高测量精度AHT20在长时间工作后可能出现微小漂移可以通过以下方法提高精度定期校准每24小时执行一次初始化命令数据滤波采用滑动平均或卡尔曼滤波算法温度补偿根据环境温度调整湿度读数示例滑动平均实现#define SAMPLE_SIZE 5 typedef struct { float buffer[SAMPLE_SIZE]; uint8_t index; float sum; } MovingAverage; void MovingAverage_Init(MovingAverage *ma) { memset(ma-buffer, 0, sizeof(ma-buffer)); ma-index 0; ma-sum 0.0f; } float MovingAverage_Add(MovingAverage *ma, float value) { ma-sum - ma-buffer[ma-index]; ma-buffer[ma-index] value; ma-sum value; ma-index (ma-index 1) % SAMPLE_SIZE; return ma-sum / SAMPLE_SIZE; }5.2 低功耗优化对于电池供电的应用可以优化功耗间歇工作模式每10分钟唤醒一次进行测量其余时间进入STOP模式降低I2C时钟速度测量时使用100kHz空闲时降低到10kHz电源管理通过MOSFET控制传感器电源5.3 扩展应用基于此基础项目可以扩展更多功能无线传输添加ESP8266模块实现WiFi上传本地显示连接OLED屏幕实时显示数据报警功能设置温湿度阈值触发蜂鸣器数据记录添加SPI Flash存储历史数据// 简单的阈值检测示例 void CheckThresholds(float temp, float hum) { if (temp 30.0f) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, GPIO_PIN_SET); // 打开风扇 } else { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_1, GPIO_PIN_RESET); } if (hum 70.0f) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_SET); // 打开除湿器 } else { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_0, GPIO_PIN_RESET); } }在实际项目中我发现AHT20的响应速度比传统的DHT系列传感器快很多特别是在频繁测量的场景下表现更稳定。对于需要高精度环境监测的应用这款传感器是一个性价比很高的选择。