OpenWrt驱动DHT11温湿度传感器：从硬件连接到数据可视化的完整实践

1. 项目概述与核心价值

最近在折腾一个智能家居网关的项目，需要实时监测几个关键位置的温湿度数据。市面上成品传感器模块不少，但考虑到成本、可定制性以及想把手头闲置的OpenWrt路由器利用起来，我决定自己动手，在OpenWrt系统上集成DHT11温湿度传感器。这听起来像是把简单传感器接到复杂系统上，有点“杀鸡用牛刀”的感觉，但实际做下来，你会发现这恰恰是OpenWrt作为一款高度可定制化嵌入式Linux系统的魅力所在——它能让你用一个几十块钱的路由器板子，轻松搭建起一个功能完整、可远程访问的数据采集节点。

DHT11是一款非常经典的数字温湿度复合传感器，采用单总线通信协议，价格低廉，在Arduino、树莓派等创客项目中应用极广。但在OpenWrt上驱动它，涉及到的就不仅仅是简单的引脚读写，而是要从内核模块、用户空间程序、到数据展示的完整链路。这个过程能让你深入理解OpenWrt的软件包管理、交叉编译、内核驱动模型以及如何将硬件数据融入网络服务。无论你是想打造一个极简的本地环境监控器，还是作为大型物联网系统的一个边缘节点，这个实践都具有很高的参考价值。接下来，我就把从硬件连接到软件实现，再到数据应用的完整流程和踩过的坑，详细拆解一遍。

2. 硬件准备与电路连接解析

2.1 DHT11传感器模块选型与原理

市面上常见的DHT11有两种形态：一种是只有三个引脚（VCC， GND， DATA）的元件，另一种是带了上拉电阻和滤波电容的模块板。对于OpenWrt开发，强烈建议选择模块板。原因很简单，OpenWrt设备（通常是路由器）的GPIO驱动能力、电气噪声环境与Arduino或树莓派不同，模块板集成的4.7K或10K上拉电阻和电源滤波电路，能极大提高通信稳定性，避免因信号质量问题导致数据读取失败。

DHT11采用单总线协议，这意味着数据发送和接收都通过一根DATA线完成，同时兼任时钟同步功能。其通信时序要求比较严格，主机（OpenWrt设备）发起通信后，DHT11会拉低总线响应，然后依次发送40位数据（16位湿度整数+16位湿度小数+16位温度整数+16位温度小数+8位校验和）。实际上，DHT11的湿度小数和温度小数部分始终为0，所以通常我们只读取整数部分。校验和是前四个字节（湿度和温度整数）相加的低8位，用于验证数据完整性。

注意：DHT11的测量范围是湿度20-90%RH，温度0-50℃，精度为湿度±5%RH，温度±2℃。对于要求不高的室内环境监测完全足够，如果需要更高精度或更宽范围，可以考虑DHT22（AM2302）或SHT系列传感器，但驱动逻辑类似。

2.2 OpenWrt设备GPIO接口确认与连接

这是最容易出错的一步。你的OpenWrt设备可能是一块开发板（如MT7621系列的路由器板），也可能是一台已刷好OpenWrt的普通家用路由器。首先，你需要确定设备上哪些GPIO引脚是可用的，以及它们在系统内的编号。

1. 查询可用GPIO：通过SSH登录到OpenWrt设备，安装必要的工具：

   opkg update opkg install gpioctl-sysfs

   然后，可以列出系统GPIO状态：

   cat /sys/kernel/debug/gpio

   或者使用gpioctl命令查看。你会看到类似gpiochip0的信息，其中包含了基址（base）和GPIO数量。

2. 计算系统GPIO编号：硬件引脚编号（如PCB上的PIN12）不等于系统GPIO编号。系统编号通常计算公式为：系统GPIO号 = GPIO组基址（base） + 组内偏移量。例如，/sys/kernel/debug/gpio显示gpiochip0: GPIOs 0-31，基址是0。如果硬件原理图告诉你某个引脚对应GPIO12，那么它的系统GPIO号就是0 + 12 = 12。务必查阅你的设备具体文档或源码中的DTS（设备树）文件来确认。

3. 物理连接：以系统GPIO12为例，连接方式如下：

   • DHT11 VCC-> OpenWrt设备的3.3V电源引脚（绝对不要接5V，会损坏设备！）。
   • DHT11 GND-> OpenWrt设备的GND引脚。
   • DHT11 DATA-> OpenWrt设备的GPIO12引脚。
   • 同时，在DATA线和3.3V之间，需要接一个4.7KΩ - 10KΩ的上拉电阻（模块板已集成，若使用元件则必须外接）。

实操心得：连接完成后，先用命令手动测试一下GPIO是否能正常操作，可以避免后续软件调试时硬件问题的干扰。例如，将GPIO12设置为输出并拉高拉低，用万用表测量电压变化：

echo 12 > /sys/class/gpio/export echo out > /sys/class/gpio/gpio12/direction echo 1 > /sys/class/gpio/gpio12/value # 拉高，应测到约3.3V echo 0 > /sys/class/gpio/gpio12/value # 拉低，应测到约0V

3. 软件驱动与数据读取实现

3.1 内核空间驱动 vs 用户空间驱动

在OpenWrt上驱动DHT11，主要有两种思路：编写内核模块（内核空间驱动）或编写直接操作GPIO的用户空间程序。两者各有优劣：

• 内核模块驱动：效率高，时序控制精准，可以做成标准的硬件监控（hwmon）设备，集成到/sys/class/hwmon/中，方便其他程序（如Luci、Prometheus node_exporter）读取。但开发难度稍大，需要了解Linux内核驱动模型，并且编译、安装需要重新配置内核或使用DKMS（动态内核模块支持），在OpenWrt上流程稍显复杂。
• 用户空间程序：实现简单，快速验证。通过sysfs接口（即/sys/class/gpio）或libgpiod库来操作GPIO，用程序逻辑模拟单总线时序。缺点是精度受系统调度影响，在系统负载高时可能读取失败，且需要自己处理数据持久化、暴露接口等问题。

对于大多数应用场景，尤其是刚开始接触，我推荐从用户空间程序入手。它足够简单直观，能让你快速看到结果，建立信心。后续如果需要更高可靠性或更好的系统集成，再考虑封装为内核驱动。

3.2 用户空间C语言程序实现详解

下面是一个基于sysfs接口的DHT11读取程序的核心代码解析。我们假设使用的GPIO系统编号为12。

// dht11_read.c #include <stdio.h> #include <stdlib.h> #include <string.h> #include <unistd.h> #include <fcntl.h> #include <sys/time.h> #include <errno.h> #define GPIO_PIN “12” // 系统GPIO编号 #define SYSFS_GPIO_DIR “/sys/class/gpio” #define MAX_RETRIES 5 #define DHT11_DATA_BITS 40 // 函数声明 int gpio_export(int pin); int gpio_set_dir(int pin, char *dir); int gpio_set_value(int pin, int value); int gpio_get_value(int pin, int *value); int read_dht11_data(int pin, int *humidity, int *temperature); int main() { int humidity = 0, temperature = 0; int retry = MAX_RETRIES; int success = 0; // 导出GPIO引脚 if (gpio_export(atoi(GPIO_PIN)) < 0) { fprintf(stderr, “Failed to export GPIO %s\n”, GPIO_PIN); return 1; } // 尝试读取，失败则重试 while (retry-- > 0 && !success) { if (read_dht11_data(atoi(GPIO_PIN), &humidity, &temperature) == 0) { success = 1; printf(“Humidity: %d%% Temperature: %d°C\n”, humidity, temperature); } else { usleep(200000); // 失败后等待200ms再试，DHT11两次读取需间隔至少1秒 } } if (!success) { fprintf(stderr, “Failed to read data from DHT11 after %d retries.\n”, MAX_RETRIES); return 1; } return 0; } // 核心读取函数 int read_dht11_data(int pin, int *humidity, int *temperature) { int bits[40] = {0}; unsigned short data_bytes[5] = {0}; struct timeval start, end; long micros; // 1. 主机发送开始信号：拉低至少18ms，然后拉高20-40us gpio_set_dir(pin, “out”); gpio_set_value(pin, 0); usleep(18000); // 拉低18ms gpio_set_value(pin, 1); usleep(30); // 拉高30us // 2. 切换为输入模式，等待DHT11响应 gpio_set_dir(pin, “in”); // 等待DHT11拉低响应（80us） gettimeofday(&start, NULL); while (gpio_get_value(pin, &value) == 0 && value == 1) { gettimeofday(&end, NULL); micros = (end.tv_sec - start.tv_sec) * 1000000 + (end.tv_usec - start.tv_usec); if (micros > 1000) return -1; // 超时1ms } // 等待DHT11拉高（80us） gettimeofday(&start, NULL); while (gpio_get_value(pin, &value) == 0 && value == 0) { gettimeofday(&end, NULL); micros = (end.tv_sec - start.tv_sec) * 1000000 + (end.tv_usec - start.tv_usec); if (micros > 1000) return -1; } // 3. 读取40位数据 for (int i = 0; i < 40; i++) { // 等待每个位开始前的50us低电平 gettimeofday(&start, NULL); while (gpio_get_value(pin, &value) == 0 && value == 1) { gettimeofday(&end, NULL); micros = (end.tv_sec - start.tv_sec) * 1000000 + (end.tv_usec - start.tv_usec); if (micros > 1000) return -1; } // 测量高电平持续时间以判断是0（26-28us）还是1（70us） gettimeofday(&start, NULL); while (gpio_get_value(pin, &value) == 0 && value == 0) { gettimeofday(&end, NULL); micros = (end.tv_sec - start.tv_sec) * 1000000 + (end.tv_usec - start.tv_usec); if (micros > 1000) return -1; } gettimeofday(&end, NULL); micros = (end.tv_sec - start.tv_sec) * 1000000 + (end.tv_usec - start.tv_usec); bits[i] = (micros > 40) ? 1 : 0; // 阈值设为40us，区分0和1 } // 4. 解析数据并校验 for (int i = 0; i < 5; i++) { for (int j = 0; j < 8; j++) { data_bytes[i] <<= 1; data_bytes[i] |= bits[i * 8 + j]; } } if (data_bytes[4] == ((data_bytes[0] + data_bytes[1] + data_bytes[2] + data_bytes[3]) & 0xFF)) { *humidity = data_bytes[0]; *temperature = data_bytes[2]; return 0; // 成功 } return -1; // 校验失败 } // gpio_export, gpio_set_dir, gpio_set_value, gpio_get_value 等辅助函数实现略...

注意事项：这段代码中的延时usleep()和超时判断是关键。usleep的精度有限，在用户空间无法做到微秒级精确，这是用户空间驱动的主要弱点。因此，代码中加入了重试机制。在实际部署时，你可能需要根据具体的主频和系统负载微调超时阈值（如判断0/1的40us阈值）。

3.3 交叉编译与OpenWrt软件包制作

我们不可能在资源受限的OpenWrt设备上直接编译C程序，需要在PC上进行交叉编译。

1. 搭建OpenWrt SDK环境：从OpenWrt官网下载与你设备固件版本完全一致的SDK。解压后，其目录结构包含staging_dir（工具链）和package目录。

2. 创建软件包目录：在SDK的package目录下新建一个目录，例如dht11-reader。在其中创建两个关键文件：

   • Makefile: 定义软件包的编译规则、依赖和安装路径。

   include $(TOPDIR)/rules.mk PKG_NAME:=dht11-reader PKG_VERSION:=1.0 PKG_RELEASE:=1 include $(INCLUDE_DIR)/package.mk define Package/dht11-reader SECTION:=utils CATEGORY:=Utilities TITLE:=DHT11 Temperature & Humidity Reader DEPENDS:=+libc endef define Package/dht11-reader/description A simple user-space program to read data from DHT11 sensor. endef define Build/Prepare mkdir -p $(PKG_BUILD_DIR) $(CP) ./src/* $(PKG_BUILD_DIR)/ endef define Build/Compile $(TARGET_CC) $(TARGET_CFLAGS) -o $(PKG_BUILD_DIR)/dht11-reader $(PKG_BUILD_DIR)/dht11_read.c endef define Package/dht11-reader/install $(INSTALL_DIR) $(1)/usr/bin $(INSTALL_BIN) $(PKG_BUILD_DIR)/dht11-reader $(1)/usr/bin/ endef $(eval $(call BuildPackage,dht11-reader))

   • src/dht11_read.c: 将上面的C程序源代码放在此目录下。

3. 编译软件包：在SDK根目录执行make menuconfig，在Utilities类别中找到并选中dht11-reader，保存退出。然后执行make package/dht11-reader/compile V=s。编译成功后，会在bin/packages/下生成一个dht11-reader_1.0-1_<arch>.ipk文件。

4. 安装与测试：将此ipk文件上传到OpenWrt设备，使用opkg install dht11-reader_1.0-1_<arch>.ipk命令安装。安装后，直接运行dht11-reader，应该就能看到输出的温湿度数据了。

4. 系统集成与数据应用

4.1 创建系统服务（init脚本）

让程序开机自启并定期运行，我们需要创建一个init脚本。在OpenWrt中，这是通过procd（进程管理守护进程）来管理的。

1. 创建脚本文件：在OpenWrt设备的/etc/init.d/目录下创建一个新文件，例如dht11d。

   #!/bin/sh /etc/rc.common # Copyright (C) 2024 Your Name START=99 STOP=10 USE_PROCD=1 PROG=/usr/bin/dht11-reader start_service() { procd_open_instance procd_set_param command “$PROG” procd_set_param stdout 1 # 重定向stdout到log procd_set_param stderr 1 # 重定向stderr到log procd_set_param respawn # 进程退出后自动重启 procd_set_param user nobody # 以低权限用户运行 procd_close_instance } stop_service() { # procd会自动处理停止 return 0 }

2. 设置权限并启用：

   chmod +x /etc/init.d/dht11d /etc/init.d/dht11d enable # 设置开机自启 /etc/init.d/dht11d start # 立即启动服务

   现在，DHT11读取程序就会作为守护进程在后台运行了。但上面的服务只是运行程序，程序输出到了日志。我们需要一个更实用的方案：定期读取并将数据保存或发送出去。

4.2 数据采集脚本与存储

更常见的做法是写一个Shell或Python脚本，定时（如每30秒）调用一次dht11-reader，解析其输出，然后存储到文件或数据库中。

1. 创建数据采集脚本/usr/bin/dht11-collector.sh：

   #!/bin/sh GPIO_PIN=12 # 根据实际修改 LOG_FILE=/var/log/dht11_data.log TIMESTAMP=$(date ‘+%Y-%m-%d %H:%M:%S’) # 调用读取程序，捕获输出 OUTPUT=$(/usr/bin/dht11-reader 2>&1) if [ $? -eq 0 ]; then # 解析输出，假设输出格式为 “Humidity: 45% Temperature: 23°C” HUM=$(echo “$OUTPUT” | grep -oP ‘Humidity: \K\d+’) TEMP=$(echo “$OUTPUT” | grep -oP ‘Temperature: \K\d+’) if [ -n “$HUM” ] && [ -n “$TEMP” ]; then echo “$TIMESTAMP, $HUM, $TEMP” >> “$LOG_FILE” # 也可以写入到临时文件，供Web界面读取 echo “{\”humidity\”: $HUM, \”temperature\”: $TEMP}” > /tmp/dht11_status.json fi else echo “$TIMESTAMP, ERROR: $OUTPUT” >> “$LOG_FILE” fi

2. 设置定时任务：使用OpenWrt的cron服务。编辑/etc/crontabs/root文件，添加一行：

   */2 * * * * /usr/bin/dht11-collector.sh # 每2分钟执行一次

   然后重启cron服务：/etc/init.d/cron restart。

4.3 数据可视化与远程访问

有了数据，如何查看？这里提供两种轻量级方案：

方案一：简易Web接口（使用uHTTPd + Shell CGI）OpenWrt默认使用uHTTPd作为Web服务器。我们可以创建一个CGI脚本，直接返回JSON数据。

1. 创建CGI脚本/www/cgi-bin/dht11：

   #!/bin/sh echo “Content-type: application/json” echo “” cat /tmp/dht11_status.json 2>/dev/null || echo ‘{“humidity”: null, “temperature”: null}’

2. 设置权限：chmod +x /www/cgi-bin/dht11。

3. 访问：在浏览器中打开http://<你的OpenWrt设备IP>/cgi-bin/dht11，就能看到最新的JSON格式温湿度数据。

方案二：集成到LuCI（OpenWrt原生Web管理界面）这需要编写LuCI的MVC（Model-View-Controller）模块，稍微复杂一些，但体验更原生。

1. 创建控制器/usr/lib/lua/luci/controller/dht11.lua：

   module(“luci.controller.dht11”, package.seeall) function index() entry({“admin”, “status”, “dht11”}, template(“dht11_status”), _(“DHT11 Sensor”), 60).dependent = false entry({“admin”, “status”, “dht11”, “data”}, call(“action_data”)).leaf = true end function action_data() local fs = require “nixio.fs” local data = fs.readfile(“/tmp/dht11_status.json”) or ‘{}’ luci.http.prepare_content(“application/json”) luci.http.write(data) end

2. 创建视图模板/usr/lib/lua/luci/view/dht11_status.htm：

   <%+header%> <h2><a id=“content” name=“content”>DHT11 Sensor Status</a></h2> <div id=“sensor_data”> <p>Loading...</p> </div> <script type=“text/javascript”> function fetchData() { fetch(‘<%=luci.dispatcher.build_url(“admin/status/dht11/data”)%>’) .then(response => response.json()) .then(data => { document.getElementById(‘sensor_data’).innerHTML = ` <p><strong>Humidity:</strong> ${data.humidity !== null ? data.humidity + ‘%’ : ‘N/A’}</p> <p><strong>Temperature:</strong> ${data.temperature !== null ? data.temperature + ‘°C’ : ‘N/A’}</p> `; }) .catch(err => console.error(‘Error:’, err)); } fetchData(); setInterval(fetchData, 10000); // 每10秒更新一次 </script> <%+footer%>

   这样，在LuCI的“状态”菜单下就会多出一个“DHT11 Sensor”页面，自动刷新显示数据。

方案三：接入更专业的监控系统对于需要历史图表、报警功能的场景，可以将数据上报到更专业的系统：

• Prometheus：在OpenWrt上运行node_exporter的textfile收集器，让采集脚本将数据写入/var/lib/node_exporter/textfile_collector/dht11.prom文件，格式如：

  # HELP dht11_humidity_percent Relative humidity in percent # TYPE dht11_humidity_percent gauge dht11_humidity_percent 45 # HELP dht11_temperature_celsius Temperature in celsius # TYPE dht11_temperature_celsius gauge dht11_temperature_celsius 23

• Home Assistant：通过OpenWrt的MQTT插件（如mosquitto-client-nossl），将数据以MQTT消息形式发布到Home Assistant的MQTT代理，实现自动发现和集成。

5. 调试技巧与常见问题排查

在实际操作中，你几乎一定会遇到读取失败、数据不准的问题。下面是我总结的排查清单。

5.1 硬件连接与电源问题

• 症状：完全读不到数据，程序一直返回超时或校验错误。
• 排查：
  1. 电压确认：万用表测量DHT11 VCC引脚电压是否为稳定的3.3V？OpenWrt设备某些GPIO的3.3V输出电流可能不足，尝试换一个电源引脚或外接3.3V稳压模块。
  2. 上拉电阻：确认DATA线是否有4.7K-10K的上拉电阻接到3.3V。没有上拉电阻，信号无法被正确拉高。
  3. 接触不良：杜邦线连接是否牢固？尝试按压连接点或更换线材。面包板接触不良是常见问题。
  4. GPIO引脚冲突：确认你使用的GPIO没有被系统其他功能占用（如LED、串口）。可以通过修改设备树（DTS）文件来复用引脚，但这属于高级操作。

5.2 软件时序与系统负载问题

• 症状：偶尔能成功，但失败率很高，尤其是在系统运行其他任务时。
• 排查：
  1. 时序精度：用户空间程序受系统调度影响。可以尝试：
     • 提高进程优先级：在C程序中使用nice()函数或在启动脚本前加nice -n -20。
     • 使用nanosleep替代usleep，或尝试更精确的延时方法（如忙等待），但这可能增加CPU占用。
     • 最有效的办法是增加重试次数，并在每次重试前等待足够长的时间（DHT11两次读取需间隔至少1秒）。
  2. 中断干扰：如果GPIO所在的中断被频繁触发，会影响时序。可以尝试更换一个不同Bank的GPIO引脚。
  3. 日志查看：在采集脚本中详细记录每次读取的原始耗时和结果，分析失败模式。

5.3 数据校验错误与物理环境问题

• 症状：能读到数据，但校验和经常错误，或湿度/温度值明显不合理（如湿度>100%）。
• 排查：
  1. 电气噪声：传感器远离电源模块、高频电路。在VCC和GND之间并联一个100nF的陶瓷电容，紧靠DHT11引脚，可以有效滤波。
  2. 物理环境：DHT11不应暴露在结露、阳光直射、强气流或热源旁。测量延迟，刚上电或环境剧烈变化后，需要一段时间（1-2秒）稳定。
  3. 传感器损坏：DHT11是静电敏感器件，焊接或操作不当可能损坏。有条件的话，换一个传感器交叉测试。

5.4 问题速查表

5.5 性能优化与进阶思路

当基本功能稳定后，可以考虑以下优化：

• 内核驱动化：将读取逻辑编写为内核模块，实现为hwmon设备。这样数据可以通过/sys/class/hwmon/hwmon0/temp1_input和humidity1_input标准接口访问，兼容性极佳。可以参考OpenWrt源码中package/kernel/other目录下的简单驱动示例。
• 多传感器支持：如果需要连接多个DHT11，每个传感器需使用独立的GPIO引脚。可以在用户空间程序中使用多线程或异步IO来同时读取，但要注意GPIO操作是阻塞的。更好的办法是为每个传感器编写独立的内核驱动实例。
• 降低功耗：对于电池供电的设备，可以间歇性供电。通过一个GPIO控制MOS管来给DHT11的VCC供电，仅在读取前通电，读完断电，可以大幅降低平均功耗。
• 数据平滑：DHT11数据可能有小幅跳动。在应用层（如采集脚本）加入简单的滑动平均滤波或中值滤波，可以显示更稳定的数值。例如，存储最近5次读数，取中位数作为输出。