当前位置：首页 > news >正文

用STM32CubeMX和HAL库5分钟搞定DHT11温湿度读取（附完整代码）

news 2026/4/18 7:43:07

STM32CubeMX与HAL库快速集成DHT11温湿度传感器的实战指南

在嵌入式开发领域，温湿度监测是物联网设备的基础功能之一。传统开发方式需要手动配置寄存器、编写底层驱动代码，耗费大量时间在硬件抽象层。而现代开发工具链如STM32CubeMX配合HAL库，让开发者能专注于业务逻辑而非硬件细节。本文将展示如何用图形化工具5分钟内完成DHT11传感器集成，并提供可直接用于生产环境的完整解决方案。

1. 开发环境搭建与硬件连接

1.1 硬件准备清单

在开始前需要准备以下硬件组件：

STM32开发板（如NUCLEO-F103RB）
DHT11温湿度传感器模块
杜邦线若干
5.1kΩ上拉电阻（部分模块已集成）

典型接线方式：

传感器引脚	开发板接口
VCC	3.3V/5V
DATA	任意GPIO
GND	GND

提示：若传输距离超过20米，需根据实际情况调整上拉电阻阻值。大多数开发场景中，模块板载电阻已足够。

1.2 软件工具安装

确保已安装最新版开发工具：

STM32CubeMX（v6.7.0+）
STM32CubeIDE或Keil MDK
STM32CubeProgrammer（可选）

安装HAL库时，建议通过CubeMX的在线更新功能获取最新版本，避免兼容性问题。我在实际项目中遇到过旧版库的时序问题，更新后即可解决。

2. CubeMX工程配置

2.1 时钟树初始化

新建工程选择对应芯片型号
在Clock Configuration选项卡中：
- 设置HSE为外部晶振频率
- 配置SYSCLK为最大允许值（如72MHz）
- 确保APB1/APB2分频系数正确

// 生成的时钟初始化代码片段 void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; // HSE配置 RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; // ...其他时钟配置 }

2.2 GPIO参数设置

选择连接DHT11的GPIO引脚（如PA6），配置为：

模式：GPIO_Output（初始状态）
输出类型：Push-Pull
上拉/下拉：No pull
速度：High

在NVIC Settings中启用SysTick中断，这是HAL延时函数的基础。曾经有开发者忽略这一点导致时序完全错乱，值得特别注意。

3. HAL库驱动实现

3.1 时序控制核心代码

DHT11采用单总线协议，对时序要求严格。HAL库的微秒级延时函数完美适配这种需求：

#define DHT11_PORT GPIOA #define DHT11_PIN GPIO_PIN_6 void DHT11_Start(void) { HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_RESET); HAL_Delay(18); // 保持低电平18ms HAL_GPIO_WritePin(DHT11_PORT, DHT11_PIN, GPIO_PIN_SET); delay_us(30); // 主机拉高30us } uint8_t DHT11_Check_Response(void) { uint8_t response = 0; delay_us(40); if(!HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)) { delay_us(80); if(HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)) response = 1; } while(HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)); // 等待响应结束 return response; }

3.2 数据读取优化实现

采用状态机方式读取数据，提高代码可靠性：

uint8_t DHT11_Read_Byte(void) { uint8_t data = 0; for(int i=0; i<8; i++) { while(!HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)); // 等待50us低电平结束 delay_us(40); // 关键延时判断0/1 if(HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)) { data |= (1 << (7-i)); // 高位在前 while(HAL_GPIO_ReadPin(DHT11_PORT, DHT11_PIN)); // 等待高电平结束 } } return data; }

4. 完整应用集成

4.1 数据校验与处理

DHT11传输的40位数据包含校验和，必须验证数据有效性：

typedef struct { uint8_t humidity_int; uint8_t humidity_deci; uint8_t temp_int; uint8_t temp_deci; uint8_t checksum; } DHT11_Data; HAL_StatusTypeDef DHT11_Read(DHT11_Data *data) { uint8_t buffer[5] = {0}; DHT11_Start(); if(!DHT11_Check_Response()) return HAL_ERROR; for(int i=0; i<5; i++) buffer[i] = DHT11_Read_Byte(); if(buffer[0] + buffer[1] + buffer[2] + buffer[3] != buffer[4]) return HAL_ERROR; >int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); DHT11_Data sensor_data; while(1) { if(DHT11_Read(&sensor_data) == HAL_OK) { printf("Temperature: %d℃, Humidity: %d%%\r\n", sensor_data.temp_int, sensor_data.humidity_int); } else { printf("Sensor read error!\r\n"); } HAL_Delay(2000); // DHT11最小采样间隔2秒 } }