1. 为什么我最终选了ESP-IDF来驱动DHT111.1 从一次翻车的温控项目说起前年接了个小项目给一个花房做温湿度监测节点。需求听起来简单得不行每两秒读一次DHT11数据超过阈值就点亮一个LED同时把数据通过串口打出来。我一开始用的是某款8位单片机裸机跑延时靠空转结果DHT11读出来的数据十次里有三次是校验失败的。后来换成STM32F1用HAL库写情况好了一些但时序还是偶尔飘。折腾了快一周我才意识到问题不在代码而在于我对DHT11的时序理解太粗糙加上裸机环境下中断一多微秒级的时序就被打断了。后来我把方案换成了ESP-IDF用ESP32来跑。原因很直接ESP32主频高FreeRTOS的任务调度可以把DHT11的读取单独放在一个低优先级任务里避免被其他中断干扰而且ESP-IDF的GPIO和定时器API封装得比较干净微秒级延时用esp_rom_delay_us就能搞定不用自己抠汇编。换完之后连续跑72小时校验失败率降到了千分之三以下。这个经历让我彻底改变了对DHT11的看法——它不是不能用而是你得给它一个稳定的运行环境。这篇文章就是把我这段时间踩过的坑、验证过的方案、以及ESP-IDF下驱动DHT11的完整思路整理出来。不管你是刚接触ESP32的新手还是从STM32转过来的老手只要你想用ESP-IDF把DHT11跑稳这里的内容应该都能直接抄作业。1.2 DHT11到底是个什么东西DHT11是一款含有已校准数字信号输出的温湿度复合传感器。它内部由一个电阻式感湿元件和一个NTC测温元件组成外加一个8位单片机做信号处理。出厂时每个传感器都在高精度湿度校验设备上校准过校准系数以程序形式存在OTP内存里所以用户不需要自己再校准。它的关键参数如下参数范围精度分辨率湿度测量范围20%~90%RH±5%RH1%RH温度测量范围0~50℃±2℃1℃供电电压3.3V~5.5V--采样周期≥1秒--输出信号单总线数字信号--这里有几个点需要特别注意。第一DHT11的采样周期不能低于1秒你如果每500毫秒读一次它内部还没完成转换读出来的就是上一次的旧数据甚至直接返回错误。第二它的湿度精度是±5%RH温度精度是±2℃这个精度做花房监测够用但你要是拿它做精密实验那肯定不够得换DHT22或者SHT30。第三它的单总线协议是自定义的不是标准的UART或I2C时序要求比较严格这也是很多人驱动失败的根本原因。1.3 单总线协议的时序本质DHT11用的单总线协议说白了就是一根线既传数据又传控制信号。主机先拉低总线至少18毫秒然后释放DHT11检测到这个起始信号后会拉低总线80微秒作为响应再拉高80微秒接着开始传输40位数据。每一位数据的表示方式是先拉低50微秒然后拉高。拉高26到28微秒表示逻辑0拉高70微秒表示逻辑1。这40位数据依次是湿度整数、湿度小数、温度整数、温度小数、校验和。校验和等于前四个字节相加取低8位。听起来不复杂但问题在于这些时间都是微秒级的。如果你用裸机跑一个中断进来时序就乱了。ESP-IDF下用FreeRTOS你可以把读取任务设成最高优先级并且在读取期间关中断这样就能保证时序的完整性。当然关中断的时间不能太长DHT11一次完整读取大概需要4到5毫秒这个时间在ESP32上是可以接受的。2. 硬件准备与接线方案2.1 元器件清单与选型理由我这次用的核心板是ESP32-DevKitC就是最常见的那款带USB转串口芯片插上就能用。DHT11我选的是三针模块版不是四针裸传感器。为什么选模块版因为模块版已经把上拉电阻和滤波电容焊好了裸传感器你得自己加一个4.7k到10k的上拉电阻否则总线释放后拉不高数据肯定读不出来。对于新手来说模块版能省掉至少一半的调试时间。除了ESP32和DHT11模块你还需要杜邦线若干建议用母对母的直接插在开发板和模块的排针上一个LED和限流电阻用来做阈值报警指示一块面包板方便接线如果你手头只有四针裸传感器也不是不能用。接线方式是VCC接3.3VGND接GNDDATA接GPIO然后在DATA和VCC之间并一个4.7kΩ的电阻。这个电阻叫上拉电阻作用是让总线在空闲时保持高电平。没有它总线就是浮空的DHT11和ESP32都拉不高通信直接失败。2.2 接线图与注意事项接线很简单但有几个坑我踩过这里直接说清楚DHT11模块引脚ESP32引脚说明VCC3.3V不要接5V虽然模块标称支持5V但ESP32的GPIO是3.3V电平接5V可能烧GPIOGNDGND共地必须接DATAGPIO4我习惯用GPIO4你也可以换其他输出能力的GPIO注意ESP32的GPIO6到GPIO11是接内部Flash的绝对不能用来接外设。GPIO34到GPIO39是只输入引脚没有输出能力也不能用来驱动DHT11的单总线。我推荐用GPIO4、GPIO5、GPIO18、GPIO19这些通用的双向GPIO。LED的接法是正极通过一个220Ω电阻接到GPIO2负极接GND。GPIO2是ESP32开发板上的板载LED引脚这样你连外接LED都省了直接看板子上的灯就行。2.3 电源与信号完整性DHT11对电源噪声比较敏感。如果你用USB供电一般没问题。但如果你用电池供电或者电源纹波比较大建议在DHT11的VCC和GND之间并一个100nF的陶瓷电容再并一个10μF的电解电容。这两个电容一个滤高频一个滤低频能把电源噪声压下去不少。信号线方面如果DHT11离ESP32比较远比如超过20厘米建议用屏蔽线或者在DATA线上串一个100Ω的电阻减少反射。我实测过线长在10厘米以内普通杜邦线完全没问题超过30厘米不加电阻的话误码率会明显上升。3. ESP-IDF环境搭建与工程配置3.1 安装ESP-IDF的两种方式ESP-IDF的安装方式主要有两种一种是离线安装包一种是命令行安装。我推荐用离线安装包也就是ESP-IDF Tools Installer。这个安装包会把编译器、调试器、Python环境、CMake、Ninja全部打包好一键安装省去了手动配环境的麻烦。尤其是Windows用户手动装环境很容易在Python版本和路径上翻车。安装的时候有几个选项要注意安装路径不要有中文和空格否则CMake会报错Python版本选3.8以上但不要选3.12我实测3.12和某些组件不兼容安装完成后一定要运行一次“ESP-IDF PowerShell”或“ESP-IDF Command Prompt”让环境变量生效如果你用Linux或者macOS可以用命令行安装mkdir -p ~/esp cd ~/esp git clone --recursive https://github.com/espressif/esp-idf.git cd esp-idf ./install.sh esp32 . ./export.sh安装完成后用idf.py --version检查一下能输出版本号就说明环境OK了。3.2 创建工程与目录结构创建工程用idf.py create-project dht11_demo然后进入目录。一个标准的ESP-IDF工程结构是这样的dht11_demo/ ├── CMakeLists.txt ├── main/ │ ├── CMakeLists.txt │ └── dht11_demo.c └── sdkconfig根目录的CMakeLists.txt定义项目名称和包含的组件main目录下的CMakeLists.txt定义源文件。你如果要用DHT11的驱动组件可以在main目录下新建一个dht11文件夹把驱动代码放进去然后在CMakeLists.txt里注册。我习惯把DHT11的驱动单独写成一个组件这样以后换项目可以直接复制。组件目录结构如下components/ └── dht11/ ├── CMakeLists.txt ├── include/ │ └── dht11.h └── dht11.c组件的CMakeLists.txt内容很简单idf_component_register(SRCS dht11.c INCLUDE_DIRS include)然后在main的CMakeLists.txt里加上REQUIRES dht11这样main就能调用dht11组件了。3.3 menuconfig关键配置在编译之前有几个menuconfig选项需要确认Component config → FreeRTOS → Tick rate默认是100Hz也就是10毫秒一个tick。这个不影响DHT11的微秒级时序因为微秒延时用的是ROM函数不依赖RTOS tick。Component config → ESP32-specific → CPU frequency默认是240MHz保持默认就行。Component config → Log output → Default log verbosity建议改成Info这样调试信息不会太多。还有一个重要的点如果你用的是ESP32-S3或者ESP32-C3GPIO的编号和ESP32不一样接线的时候要看清楚开发板的丝印。我有一次用ESP32-S3习惯性地接GPIO4结果那个引脚是用于USB-JTAG的冲突了读出来的数据全是0。后来换成GPIO5才正常。4. DHT11驱动代码的完整实现4.1 头文件设计与接口定义头文件里我定义了三个东西一个结构体用来存温湿度数据一个初始化函数一个读取函数。#ifndef DHT11_H #define DHT11_H #include esp_err.h typedef struct { float temperature; float humidity; } dht11_data_t; esp_err_t dht11_init(gpio_num_t pin); esp_err_t dht11_read(gpio_num_t pin, dht11_data_t *data); #endif这里我把GPIO引脚号作为参数传进去而不是写死在驱动里。这样做的好处是同一个驱动可以驱动多个DHT11只要它们接在不同的GPIO上。结构体里用float存温度和湿度虽然DHT11的分辨率是整数但用float方便以后换DHT22或者SHT30接口不用改。4.2 微秒级延时的实现ESP-IDF里做微秒级延时最靠谱的是esp_rom_delay_us。这个函数是ROM里的不依赖RTOS不会被任务调度打断。你可能会问为什么不直接用vTaskDelay因为vTaskDelay的最小单位是RTOS tick默认是10毫秒而DHT11需要的是几十微秒的延时根本不是一个量级。#include esp_rom_sys.h static void delay_us(uint32_t us) { esp_rom_delay_us(us); }这个函数在ESP32上实测精度不错误差在5%以内。如果你需要更高精度可以用硬件定时器但对于DHT11来说5%的误差完全够用。4.3 起始信号与响应检测起始信号的流程是主机拉低总线至少18毫秒然后拉高20到40微秒接着释放总线等待DHT11响应。static esp_err_t dht11_start(gpio_num_t pin) { gpio_set_direction(pin, GPIO_MODE_OUTPUT); gpio_set_level(pin, 0); delay_us(20000); // 拉低20ms gpio_set_level(pin, 1); delay_us(30); // 拉高30us gpio_set_direction(pin, GPIO_MODE_INPUT); // 等待DHT11拉低响应 uint32_t timeout 0; while (gpio_get_level(pin) 1) { if (timeout 100) return ESP_ERR_TIMEOUT; delay_us(1); } timeout 0; while (gpio_get_level(pin) 0) { if (timeout 100) return ESP_ERR_TIMEOUT; delay_us(1); } timeout 0; while (gpio_get_level(pin) 1) { if (timeout 100) return ESP_ERR_TIMEOUT; delay_us(1); } return ESP_OK; }这里我加了超时检测防止DHT11没接好或者坏了导致死循环。超时阈值设100微秒因为DHT11的响应信号是80微秒左右超过100微秒还没变化基本可以判定为失败。4.4 40位数据的读取与校验读取40位数据的逻辑是每一位先等50微秒的低电平结束然后测量高电平的持续时间。如果高电平持续26到28微秒就是0如果持续70微秒左右就是1。static esp_err_t dht11_read_bits(gpio_num_t pin, uint8_t *data) { uint8_t bytes[5] {0}; for (int i 0; i 40; i) { uint32_t timeout 0; while (gpio_get_level(pin) 0) { if (timeout 100) return ESP_ERR_TIMEOUT; delay_us(1); } delay_us(30); if (gpio_get_level(pin) 1) { bytes[i / 8] | (1 (7 - (i % 8))); timeout 0; while (gpio_get_level(pin) 1) { if (timeout 100) return ESP_ERR_TIMEOUT; delay_us(1); } } } uint8_t checksum bytes[0] bytes[1] bytes[2] bytes[3]; if (checksum ! bytes[4]) { return ESP_ERR_INVALID_CRC; } data[0] bytes[0]; data[1] bytes[1]; data[2] bytes[2]; data[3] bytes[3]; return ESP_OK; }这里的关键点是在等待低电平结束之后延时30微秒再采样。为什么是30微秒因为逻辑0的高电平是26到28微秒逻辑1的高电平是70微秒。延时30微秒后如果还是高电平说明这一位是1如果已经变成低电平说明这一位是0。这个30微秒是中间值能最大程度地区分0和1。4.5 数据转换与错误处理读出来的原始数据是整数湿度整数和小数、温度整数和小数。DHT11的小数部分通常是0但为了兼容DHT22我还是把小数部分加上了。esp_err_t dht11_read(gpio_num_t pin, dht11_data_t *data) { uint8_t raw[4]; esp_err_t ret dht11_start(pin); if (ret ! ESP_OK) return ret; ret dht11_read_bits(pin, raw); if (ret ! ESP_OK) return ret; >void dht11_task(void *pvParameters) { dht11_data_t data; while (1) { esp_err_t ret dht11_read(GPIO_NUM_4, data); if (ret ESP_OK) { ESP_LOGI(TAG, Temperature: %.1f C, Humidity: %.1f %%, data.temperature, data.humidity); } else { ESP_LOGW(TAG, DHT11 read failed: %s, esp_err_to_name(ret)); } vTaskDelay(pdMS_TO_TICKS(2000)); } }这里延时2000毫秒也就是2秒读一次。DHT11要求采样周期不低于1秒2秒是比较稳妥的选择。你如果设成1秒也能工作但偶尔会因为DHT11内部还没准备好而返回旧数据。5.2 阈值报警与LED控制LED控制任务根据温湿度数据决定是否点亮LED。我设的阈值是温度超过30℃或者湿度低于30%就报警。void led_task(void *pvParameters) { gpio_set_direction(GPIO_NUM_2, GPIO_MODE_OUTPUT); while (1) { if (g_temperature 30.0f || g_humidity 30.0f) { gpio_set_level(GPIO_NUM_2, 1); } else { gpio_set_level(GPIO_NUM_2, 0); } vTaskDelay(pdMS_TO_TICKS(500)); } }这里用全局变量在任务之间传递数据。更规范的做法是用队列或者事件组但对于这个小项目来说全局变量加volatile就够了。注意全局变量要加volatile防止编译器优化导致读到的值不是最新的。5.3 串口日志与调试输出ESP-IDF的日志系统很好用你可以用ESP_LOGI、ESP_LOGW、ESP_LOGE分别输出信息、警告和错误。日志级别可以在menuconfig里调也可以在代码里用esp_log_level_set动态调。我习惯在调试的时候把日志级别设成Debug看详细的时序信息发布的时候设成Info只输出温湿度数据。这样既能调试又不会在正式使用时刷屏。6. 常见问题与排查技巧实录6.1 读出来全是0或者255这是最常见的问题原因通常有三个接线错了、上拉电阻没接、GPIO选错了。排查步骤是先用万用表量一下DHT11的VCC和GND之间是不是3.3V然后量DATA线在空闲时是不是高电平。如果DATA线是低电平说明上拉电阻没起作用要么是模块坏了要么是裸传感器没接上拉电阻。还有一个可能GPIO选成了只输入引脚比如GPIO34。这种引脚没有内部上拉也没有输出能力驱动不了单总线。换成GPIO4或者GPIO5就好了。6.2 校验和经常失败校验和失败说明数据读到了但某几位错了。原因通常是时序被打断。解决办法是把DHT11读取任务设成最高优先级并且在读取期间关中断。portMUX_TYPE mux portMUX_INITIALIZER_UNLOCKED; taskENTER_CRITICAL(mux); // DHT11读取代码 taskEXIT_CRITICAL(mux);关中断的时间大概是5毫秒对ESP32来说可以接受。但要注意关中断期间不能调用任何可能阻塞的函数比如vTaskDelay。6.3 数据跳动很大如果温度或湿度数据跳动超过±5说明电源噪声大或者线太长。解决办法是在DHT11的VCC和GND之间并一个100nF电容缩短线长或者换屏蔽线。我实测过加电容之后数据跳动从±5降到了±1。6.4 常见问题速查表现象可能原因解决办法读出来全是0接线错误、上拉电阻缺失检查接线加4.7k上拉电阻读出来全是255GPIO选错、传感器损坏换GPIO换传感器校验和失败时序被打断、电源不稳提高任务优先级关中断加滤波电容数据跳动大电源噪声、线太长加电容缩短线长读取超时传感器没响应检查VCC是否3.3V换传感器7. 从DHT11到更高级传感器的扩展思路DHT11的精度和采样率有限如果你要做更精细的监测可以考虑DHT22或者SHT30。DHT22的湿度精度是±2%RH温度精度是±0.5℃采样周期也是2秒但价格比DHT11贵不少。SHT30是I2C接口精度更高采样率可以到10Hz但需要额外的I2C总线和驱动。从DHT11迁移到DHT22代码改动很小主要是把小数部分用上因为DHT22的温度和湿度都有小数。从DHT11迁移到SHT30改动就大了因为接口从单总线变成了I2C驱动要重写。但如果你用ESP-IDF的I2C驱动其实也不难半天就能搞定。我个人建议如果是学习或者做简单的监测DHT11完全够用。如果是做产品或者需要长期稳定运行直接上SHT30省心。DHT11最大的问题是长期稳定性一般用久了精度会漂而且响应速度慢。SHT30虽然贵但省下来的调试时间绝对值回差价。最后再分享一个小技巧如果你手头没有DHT11可以用一个10kΩ的电位器模拟单总线信号测试你的驱动代码能不能正确解析。具体做法是把电位器中间引脚接GPIO两端分别接3.3V和GND然后手动调节电位器模拟DHT11的响应信号。这个方法我用来验证时序逻辑比反复插拔传感器方便多了。