DHT11 温湿度传感器

STM32F103C8T6 · HAL库开发 · 单总线数字协议 · 72MHz主频

3.3-5.5V
工作电压
-20~60℃
测温范围
5-95%
测湿范围 RH
±2℃
温度精度
±5%
湿度精度
500ms
采样间隔
1传感器原理与功能

DHT11数字温湿度传感器是一款含有已校准数字信号输出的温湿度复合传感器

1.1 工作原理
DHT11内部包含一个电容式感湿元件和一个NTC测温元件,并与一个高性能8位单片机连接。传感器内部MCU将感湿元件和热敏电阻的模拟信号经过ADC采样、校准后,以数字信号的形式通过单总线(One-Wire)输出。

通信采用单总线协议:主机(STM32)首先拉低数据线至少18ms发送起始信号,然后释放总线;DHT11检测到起始信号后,拉低总线83μs作为响应,随后拉高87μs准备发送数据。数据帧共40位(5字节),依次为:湿度整数、湿度小数、温度整数、温度小数、校验和。
1.2 核心功能
🌡️
温度测量
内置NTC热敏电阻,测量范围-20~60℃,精度±2℃,分辨率0.1℃,通过数字信号输出温度值
💧
湿度测量
采用电容式湿度传感器,测量范围5%~95%RH,精度±5%RH,可实时监测环境湿度变化
📡
单总线通信
仅需一根数据线即可完成双向通信,通过精确的时序控制实现数据传输,硬件接口简单
✅
数据校验
每次传输40位数据含8位校验和,确保数据完整性。校验和 = 前4字节之和的低8位
1.3 引脚定义
引脚名称功能STM32连接
1VCC电源正极(3.3V~5.5V)3.3V
2DATA单总线数据引脚PA0
3NC空脚(不连接)—
4GND电源地GND
2模块外观展示

DHT11传感器模块实物外观与尺寸参数

外观1
模块正面外观
外观2
模块背面外观
尺寸
模块尺寸图
3原理图与PCB封装

DHT11模块电路原理图与PCB封装设计

原理图
PCB封装
4程序分析

基于STM32 HAL库的DHT11驱动程序完整分析,MCU型号STM32F103C8T6,主频72MHz

4.1 系统时钟配置
系统时钟采用HSE外部高速晶振(8MHz)作为PLL源,通过PLL9倍频获得72MHz系统时钟。APB1总线分频为36MHz,APB2总线为72MHz。这是实现微秒级延时函数delay_us()的基础。
main.c — SystemClock_Config()
void SystemClock_Config(void) { RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_ClkInitTypeDef RCC_ClkInitStruct = {0}; // HSE外部晶振 8MHz,PLL 9倍频 → 72MHz RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; // 8MHz × 9 = 72MHz HAL_RCC_OscConfig(&RCC_OscInitStruct); // SYSCLK = PLLCLK = 72MHz, AHB = 72MHz RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK; RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; // HCLK = 72MHz RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; // PCLK1 = 36MHz RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; // PCLK2 = 72MHz HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2); }
4.2 DHT11 GPIO初始化
DHT11数据引脚配置在PA0。由于单总线协议需要在输入/输出模式间频繁切换,初始化时先配置为推挽输出模式,随后发送复位信号并检测DHT11响应。引脚宏定义在dht11.h中:DHT11_DAT_PORT = GPIOA,DHT11_DAT_PIN = GPIO_PIN_0。
dht11.h — 引脚宏定义
#define DHT11_DAT_GPIO_CLK_ENABLE() __HAL_RCC_GPIOA_CLK_ENABLE() #define DHT11_DAT_PORT GPIOA #define DHT11_DAT_PIN GPIO_PIN_0
dht11.c — DHT11_GPIO_Init()
uint8_t DHT11_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; DHT11_DAT_GPIO_CLK_ENABLE(); // 使能GPIOA时钟 GPIO_InitStruct.Pin = DHT11_DAT_PIN; // PA0 GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; // 推挽输出 GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; // 高速 HAL_GPIO_Init(DHT11_DAT_PORT, &GPIO_InitStruct); DHT11_Rst(); // 发送开始信号 return DHT11_Check(); // 检测DHT11响应 }
4.3 复位信号与响应检测
主机复位信号(DHT11_Rst):将数据线配置为输出模式,先拉低至少18ms(代码中20ms),再拉高10~20μs(代码中30μs),唤醒DHT11传感器。

DHT11响应检测(DHT11_Check):将数据线切换为上拉输入模式,等待DHT11拉低83μs后拉高87μs。若超时未响应则返回0,正常响应返回1。
dht11.c — DHT11_Rst() & DHT11_Check()
// 主机发送开始信号 static void DHT11_Rst(void) { GPIO_SETOUT(); // 配置为输出模式 dht11_dat(0); // 拉低数据线 HAL_Delay(20); // 拉低至少18ms dht11_dat(1); // 拉高数据线 delay_us(30); // 主机释放总线(T_go 10~20us) } // 检测DHT11响应信号 static uint8_t DHT11_Check(void) { uint8_t retry = 0; GPIO_SETIN(); // 设置为上拉输入模式 while (!dht11_dat_read() && retry < 100) // DHT11响应低电平(T_rel 83us) { retry++; delay_us(1); } if (retry >= 100) return 0; // 超时未响应 retry = 0; while (dht11_dat_read() && retry < 100) // DHT11响应高电平(T_reh 87us) { retry++; delay_us(1); } if (retry >= 100) return 0; // 超时,工作出错 return 1; // 设备正常响应 }
4.4 单总线数据读取
位读取(DHT11_Read_Bit):每个数据位以54μs低电平开始,随后高电平持续时间决定数据值——"0"信号高电平持续23~27μs,"1"信号高电平持续68~74μs。代码中等待40μs后读取引脚电平:高则为1,低则为0。

字节读取(DHT11_Read_Byte):连续读取8个位,高位在前,拼装为一个字节。
dht11.c — DHT11_Read_Bit() & DHT11_Read_Byte()
static uint8_t DHT11_Read_Bit(void) { uint8_t retry = 0; // 等待低电平结束(T_LOW 54us) while (dht11_dat_read() && retry < 100) { retry++; delay_us(1); } retry = 0; // 等待高电平到来(数据位高电平开始) while (!dht11_dat_read() && retry < 100) { retry++; delay_us(1); } delay_us(40); // 等待40us后判断 // 0信号高电平23~27us → 此时已变低;1信号高电平68~74us → 仍为高 if (dht11_dat_read()) return 1; else return 0; } static uint8_t DHT11_Read_Byte(void) { uint8_t i, dat = 0; for (i = 0; i < 8; i++) { dat <<= 1; // 高位在前 dat |= DHT11_Read_Bit(); // 读取一位 } return dat; }
4.5 温湿度数据解析与校验
DHT11一次完整传输共40位(5字节)数据。读取5字节后进行校验:校验和 = (buf[0]+buf[1]+buf[2]+buf[3]) & 0xFF,与buf[4]比较。校验通过后计算最终值:
字节含义范围示例值
buf[0]湿度整数部分0~10065
buf[1]湿度小数部分恒为00
buf[2]温度整数部分0~6025
buf[3]温度小数部分0~93
buf[4]校验和—93
计算公式:
湿度 = (buf[0] × 10 + buf[1]) / 10 → 65.0% RH
温度 = buf[2] × 10 + buf[3] → 253(即25.3℃,显示时除以10.0)
校验:(65 + 0 + 25 + 3) & 0xFF = 93 = buf[4] ✓

特殊说明:湿度小数部分(buf[1])始终为0;当温度低于0℃时,buf[3]的最高位(Bit7)置1表示负温度,例如-10.1℃表示为 buf[2]=10, buf[3]=0x81。官方数据手册建议采样间隔≥2秒,本程序采用500ms更新频率。
dht11.c — DHT11_Read_TempAndHumidity()
uint8_t DHT11_Read_TempAndHumidity(DHT11_Data_TypeDef *DHT11_Data) { uint8_t buf[5], i; DHT11_Rst(); // 发送开始信号 if (DHT11_Check() == 1) // 设备响应正常 { for (i = 0; i < 5; i++) // 读取40位数据 buf[i] = DHT11_Read_Byte(); // 校验和验证 if (((buf[0] + buf[1] + buf[2] + buf[3]) & 0xFF) == buf[4]) { DHT11_Data->humidity = (buf[0] * 10 + buf[1]) / 10; DHT11_Data->temperature = buf[2] * 10 + buf[3]; } } else return 0; // 设备未响应 return 1; // 读取成功 }
4.6 主程序循环逻辑
主循环通过HAL_GetTick()获取系统毫秒时间戳,每500ms执行一次DHT11数据读取。读取后清空OLED屏幕,在居中位置显示温度(16行)和湿度(40行),然后调用OLED_Update()刷新显存。

OLED通过软件I2C驱动,SCL接PB15,SDA接PB14。温度显示格式:%.1f℃(除以10.0保留一位小数),湿度显示格式:%d%%。
main.c — main() 主循环
uint32_t Time_Now; // 系统时间戳 int main(void) { HAL_Init(); // 初始化HAL库 SystemClock_Config(); // 配置72MHz时钟 MX_GPIO_Init(); // 初始化GPIO OLED_Init(); // 初始化OLED显示屏 DHT11_GPIO_Init(); // 初始化DHT11 while (1) { if (HAL_GetTick() - Time_Now >= 500) // 500ms更新一次 { DHT11_Read_TempAndHumidity(&DHT11_Data); // 读取温湿度 OLED_Clear(); // 清屏 OLED_CenterPrintf(16, "%.1f℃", DHT11_Data.temperature / 10.0); OLED_CenterPrintf(40, "%d%%", DHT11_Data.humidity); OLED_Update(); // 更新显示 Time_Now = HAL_GetTick(); // 更新时间戳 } } }
5程序流程图

STM32主程序完整执行流程,包含系统初始化与while(1)主循环

开始 HAL_Init() 初始化HAL库 SystemClock_Config() 72MHz MX_GPIO_Init() 初始化GPIO OLED_Init() 初始化OLED DHT11_GPIO_Init() 初始化DHT11 while(1) 主循环 HAL_GetTick() - Time_Now ≥ 500ms? 否 是 DHT11_Read_TempAndHumidity() OLED_Clear() 清屏 OLED_CenterPrintf() 显示温度/湿度 OLED_Update() 刷新显存
6交互式动画演示

模拟DHT11传感器实时采集温湿度数据,通过单总线传输至STM32并在OLED显示屏上展示

📡 DHT11 传感器模拟

DHT11 传感器模块
V
D
-
N
PA0 单总线数据传输
→ STM32F103C8T6
🌡️ 环境温度 --.- ℃
💧 环境湿度 -- %
组件说明:
• 蓝色网格 — DHT11传感器格栅(感湿/感温元件)
• 脉冲线 — PA0单总线数据传输
• 温度条 — 实时温度值(-20~60℃范围映射)
• 水滴 — 湿度等级指示(5~95%RH范围)

🖥️ OLED 显示与数据仪表

--.-℃
--%
DHT11 Display
OLED 0.96" I2C (SCL=PB15, SDA=PB14)
--
温度 (℃)
--
湿度 (%RH)
数据流: DHT11采集 → PA0单总线 → STM32解析校验 → OLED显示
采样周期: 500ms(与实际程序一致)
温度精度: 0.1℃(temperature/10.0)
湿度精度: 1%RH(整数)