1. 项目准备认识你的硬件伙伴大家好我是老陈一个玩了十多年树莓派和各种传感器的老玩家。今天咱们来聊一个特别经典也特别实用的项目用树莓派4B连接DHT11或DHT22温湿度传感器并把数据实时画成图表。这听起来是不是有点像智能家居或者环境监测系统的雏形没错这正是很多物联网项目的起点。无论你是想监控家里的温湿度还是想为你的植物搭建一个智能养护系统这个项目都能给你打下坚实的基础。相比于网上很多教程强调的串口通信我们今天要用的方法更直接、更常用那就是通过树莓派自带的GPIO通用输入输出接口来连接这种方式响应快接线简单特别适合新手入门。在开始动手之前我们先来认识一下今天的主角们。首先是树莓派4B这是目前非常主流的一款单板计算机性能足够强接口也丰富。我们的核心操作都将通过它那40针的GPIO排针来完成。然后是传感器DHT11和DHT22是两款非常流行的数字温湿度传感器。它们俩长得像孪生兄弟但性格和能力有点不同。DHT11比较经济实惠但精度一般温度测量范围在0-50°C误差±2°C湿度范围20-80%RH误差±5%RH。而DHT22也叫AM2302则是个“高精度选手”温度测量范围可以到-40到80°C误差±0.5°C湿度范围0-100%RH误差±2%RH。如果你的项目对数据精度要求比较高或者环境比较极端比如想监测冰箱冷冻室或者户外那我强烈建议你选择DHT22。当然如果只是室内粗略看看DHT11也完全够用还能省点预算。除了主角我们还需要一些“配角”三根母对母的杜邦线用来连接树莓派和传感器。另外确保你的树莓派已经安装好了操作系统比如官方的Raspberry Pi OS并且能正常开机、联网。这个项目我们全程使用Python来编程因为Python在树莓派生态里有着无与伦比的友好性库丰富代码易懂。我自己的树莓派4B 4G内存版跑这个项目非常流畅你手头的版本肯定也没问题。好了硬件和软件的基本情况就介绍到这里接下来我们就进入实战环节第一步就是把必要的软件库给安装上。2. 软件环境搭建安装核心库与依赖万事开头难但咱们这个开头其实一点也不难。要让树莓派能听懂DHT11/22传感器“说的话”我们需要一个翻译官这个翻译官就是Adafruit_DHT库。这是Adafruit公司一个非常著名的开源硬件厂商为他们的传感器编写的Python库因为它太好用了所以成了行业里读取DHT系列传感器的标准方法之一。下面我就带你一步步把它安装好这里我会分享两种方法以及我踩过的一些坑帮你一次成功。首先打开你的树莓派终端。我习惯直接用树莓派桌面环境里的命令行或者如果你是通过SSH远程连接的也一样操作。第一步是更新一下系统的软件包列表这是一个好习惯能确保我们安装的是最新版本的依赖。在终端里输入sudo apt update更新完成后我们还需要安装一些编译工具和Python的开发包因为待会儿安装Adafruit_DHT库时需要编译一些C语言写的扩展模块以提高读取速度。安装命令如下sudo apt install -y python3-dev python3-pip build-essential接下来就是安装核心库了。我最早的时候是用从GitHub克隆源码再安装的方式就像很多老教程里写的那样。具体命令是sudo git clone https://github.com/adafruit/Adafruit_Python_DHT.git cd Adafruit_Python_DHT sudo python3 setup.py install这个方法在过去是主流但实话实说现在有点过时了。因为这个Adafruit_Python_DHT仓库已经很久没有维护了在树莓派较新的操作系统上你可能会遇到一些编译错误需要手动去修改源码里的platform_detect.py文件来正确识别树莓派4B的型号这对新手来说是个不小的挑战。所以我强烈推荐你现在使用第二种更简单、更稳定的方法直接使用pip来安装一个社区维护的、兼容性更好的分支版本。这个分支修复了原版的一些问题对树莓派4B的支持更好。安装命令非常简洁sudo pip3 install adafruit-circuitpython-dht同时我们还需要安装一个用于操作GPIO的底层库sudo apt install -y libgpiod2这个libgpiod是现代Linux系统管理GPIO推荐的方式比过去的老方法更稳定。只用这两条命令库就安装好了省去了编译的麻烦。你可以通过运行一个简单的Python语句来测试是否安装成功python3 -c import adafruit_dht; print(库导入成功)如果没有报错那就恭喜你软件环境已经准备就绪了。这里有个小提示因为读取GPIO需要比较高的权限所以之后我们运行自己写的Python脚本时通常需要在命令前加上sudo或者将你的用户加入到gpio用户组中。为了最简单起见我们演示时先用sudo。3. 硬件连接GPIO接线图解与注意事项库装好了接下来就要动手接线了。这是整个项目里唯一需要触碰硬件的部分但别担心非常简单就像拼乐高一样。请先找到你的树莓派4B让它的USB接口朝下以太网口朝左这时正面朝上的那两排共40个金属针脚就是GPIO排针。我们需要正确识别出其中的3个针脚3.3V电源3V3、接地GND和一个通用的GPIO数据针脚。我以最常用的连接方式为例使用GPIO4这是BCM编码的编号也是我们编程时使用的编号。你可能会问什么是BCM编码树莓派的GPIO针脚有三种编号方式物理位置编号1到40、BCM编号Broadcom芯片的通道号和WiringPi编号。我们这里用的库默认使用的是BCM编号所以记住GPIO4很重要。它的物理位置是排针从上往下数第7个针脚从左往右数第4列从上往下第4行具体可以参考树莓派官方的GPIO引脚图。现在拿出你的DHT11或DHT22传感器它通常有三个引脚有些模块是四个引脚但有一个是空脚。这三个引脚分别是VCC正极、DATA或OUT数据线、GND负极。接线步骤如下VCC传感器 - 3.3V树莓派用一根杜邦线将传感器的正极连接到树莓派GPIO排针上任何一个标有“3V3”的针脚例如物理引脚1或17。切记一定要接3.3V不要接5V否则可能会损坏传感器。DATA传感器 - GPIO4树莓派用第二根杜邦线将传感器的数据线连接到树莓派的GPIO4BCM编码对应的物理引脚上也就是物理引脚7。GND传感器 - GND树莓派用第三根杜邦线将传感器的负极连接到树莓派GPIO排针上任何一个标有“GND”的针脚例如物理引脚6、9、14、20等。接好线后最好检查两遍确保没有接错或者虚接。然后就可以给树莓派上电了。这里分享一个我踩过的坑如果你使用的是带PCB板、上面有电阻和LED的DHT模块通常可以直接使用。但如果你用的是最原始的、只有三个引脚的传感器探头我建议你在数据线DATA和电源线VCC之间连接一个4.7kΩ到10kΩ的上拉电阻。这个电阻的作用是把数据线的电压在空闲时稳定地拉到高电平确保通信稳定。很多现成的模块已经集成了这个电阻但原始探头没有如果发现数据读取不稳定或总是失败加一个上拉电阻往往能解决问题。4. 编写数据读取脚本从单次读取到循环监控硬件软件都齐备是时候让代码跑起来了。我们将编写一个Python脚本和传感器进行对话获取温湿度数据。我会从最简单的单次读取开始逐步完善到一个稳定的、循环监控的脚本。首先创建一个新的Python文件比如叫dht_reader.py。用你喜欢的文本编辑器如nano、Thonny或VS Code打开它。我们先写一个最基础的读取示例import adafruit_dht import board import time # 初始化传感器指定型号和使用的GPIO引脚BCM编码 # 对于DHT11使用 adafruit_dht.DHT11 # 对于DHT22使用 adafruit_dht.DHT22 sensor adafruit_dht.DHT22(board.D4) # 这里使用DHT22GPIO4对应board.D4 try: # 尝试读取数据 temperature sensor.temperature humidity sensor.humidity # 检查读取是否有效 if temperature is not None and humidity is not None: print(f温度: {temperature:.1f}°C) print(f湿度: {humidity:.1f}%) else: print(读取失败未获取到有效数据。) except RuntimeError as error: # 这是DHT传感器最常见的错误通常是时序问题 print(f读取时发生错误: {error.args[0]}) # 通常等待一下重试就好 time.sleep(2.0) except Exception as error: # 其他异常比如传感器没接好 sensor.exit() raise error finally: # 清理资源这是一个好习惯 sensor.exit()把这段代码保存后在终端里用sudo运行它sudo python3 dht_reader.py你应该能看到屏幕上打印出了当前的温度和湿度。第一次运行可能会失败或者数据是None这很正常因为传感器和库需要一点时间初始化和同步。多运行一两次就好了。单次读取成功了但我们想要的是持续监控。这就需要加入循环和异常处理机制。DHT传感器通信协议对时序要求很苛刻在树莓派这种多任务系统上偶尔读取失败是家常便饭。所以一个健壮的脚本必须能处理这些错误。下面是我在实际项目中打磨后的一个循环监控版本import adafruit_dht import board import time # 初始化 sensor adafruit_dht.DHT22(board.D4) # 设置重试间隔和最大失败次数 read_interval 5 # 读取间隔单位秒 max_failures 5 failure_count 0 print(开始监控温湿度按 CtrlC 终止...) try: while True: try: temperature sensor.temperature humidity sensor.humidity # 验证读取到的数据是否在合理范围内可选但推荐 if humidity is not None and temperature is not None: if 0 humidity 100 and -40 temperature 80: print(f[{time.strftime(%Y-%m-%d %H:%M:%S)}] 温度: {temperature:.1f}°C, 湿度: {humidity:.1f}%) failure_count 0 # 成功则重置失败计数 else: print(读取数据超出合理范围视为无效。) else: print(传感器返回了空值正在重试...) failure_count 1 except RuntimeError as e: # 最常见的运行时错误通常是校验和错误或超时 print(f读取错误: {e}. 等待后重试...) failure_count 1 time.sleep(2.0) # 发生错误时多等一会儿 continue # 跳过本次循环的后续等待直接重试 except Exception as e: # 其他严重错误 print(f发生未知错误: {e}) break # 如果连续失败太多次可能传感器有问题或接线松动 if failure_count max_failures: print(连续多次读取失败请检查传感器连接。) break # 正常等待间隔 time.sleep(read_interval) except KeyboardInterrupt: print(\n程序被用户中断。) finally: # 无论怎样最后都要清理传感器资源 sensor.exit() print(传感器资源已清理程序退出。)这个脚本就实用多了。它包含了数据有效性校验、异常捕获、连续失败报警并且用try...finally结构确保了程序即使被意外中断也会正确清理GPIO资源避免引脚处于奇怪的状态。你现在可以运行这个脚本它就会每隔5秒在终端打印一次时间和温湿度数据形成一个简单的实时监控台。5. 数据可视化用Matplotlib绘制实时图表光在终端看数字不够直观我们最终的目标是把数据变成图表。Python里画图最常用的库就是Matplotlib它功能强大能画出各种漂亮的静态或动态图表。我们将把上面循环读取的数据实时地绘制成折线图这样温度湿度的变化趋势就一目了然了。首先我们需要安装Matplotlib库。在终端执行sudo pip3 install matplotlib安装完成后我们来创建一个新的脚本比如叫dht_plot.py。这个脚本的思路是我们准备两个列表分别用来存储最近一段时间内的温度和时间点。然后在每次读取到新数据时更新列表并重新绘制图表。为了不让图表窗口卡住我们的读取循环我们会使用Matplotlib的动画功能。下面是完整的代码我已经加上了详细的注释import adafruit_dht import board import time import matplotlib.pyplot as plt import matplotlib.animation as animation from collections import deque from datetime import datetime # 初始化传感器 sensor adafruit_dht.DHT22(board.D4) # 设置图表数据存储 max_data_points 60 # 图表上最多显示60个数据点比如最近5分钟的数据5秒一个点 time_history deque(maxlenmax_data_points) temp_history deque(maxlenmax_data_points) hum_history deque(maxlenmax_data_points) # 创建图表和坐标轴 fig, (ax1, ax2) plt.subplots(2, 1, figsize(10, 8)) # 两个子图上下排列 fig.suptitle(树莓派4B DHT22 温湿度实时监控, fontsize14) fig.patch.set_facecolor(#f0f0f0) # 设置背景色 # 初始化温度折线 temp_line, ax1.plot([], [], r-, label温度 (°C), linewidth2) ax1.set_ylabel(温度 (°C), fontsize12) ax1.set_ylim(10, 35) # 根据你的环境调整Y轴范围 ax1.grid(True, linestyle--, alpha0.7) ax1.legend(locupper left) ax1.set_title(温度变化曲线) # 初始化湿度折线 hum_line, ax2.plot([], [], b-, label湿度 (%), linewidth2) ax2.set_xlabel(时间, fontsize12) ax2.set_ylabel(湿度 (%), fontsize12) ax2.set_ylim(20, 80) # 根据你的环境调整Y轴范围 ax2.grid(True, linestyle--, alpha0.7) ax2.legend(locupper left) ax2.set_title(湿度变化曲线) # 调整子图间距 plt.tight_layout(rect[0, 0.03, 1, 0.95]) def read_sensor(): 尝试从传感器读取一次数据 try: temperature sensor.temperature humidity sensor.humidity if temperature is not None and humidity is not None: # 简单合理性检查 if -40 temperature 80 and 0 humidity 100: return temperature, humidity else: print(f数据异常: 温度{temperature}, 湿度{humidity}) return None, None else: return None, None except RuntimeError as e: # 偶尔的读取错误打印信息但不中断 print(f传感器读取错误可忽略: {e}) return None, None except Exception as e: print(f严重错误: {e}) return None, None def update_chart(frame): 动画更新函数每次被调用时读取数据并更新图表 current_time datetime.now() temp, hum read_sensor() if temp is not None and hum is not None: # 将数据添加到历史记录 time_history.append(current_time) temp_history.append(temp) hum_history.append(hum) # 更新温度图表数据 temp_line.set_data(time_history, temp_history) ax1.relim() # 重新计算坐标轴范围 ax1.autoscale_view() # 自动缩放视图 # 在图表上显示最新数值 ax1.set_title(f温度变化曲线 (当前: {temp:.1f}°C)) # 更新湿度图表数据 hum_line.set_data(time_history, hum_history) ax2.relim() ax2.autoscale_view() ax2.set_title(f湿度变化曲线 (当前: {hum:.1f}%)) # 格式化X轴时间显示 for ax in [ax1, ax2]: ax.xaxis.set_major_formatter(plt.matplotlib.dates.DateFormatter(%H:%M:%S)) plt.setp(ax.xaxis.get_majorticklabels(), rotation45, haright) # 返回需要更新的图形元素列表 return temp_line, hum_line, # 创建动画每5000毫秒5秒调用一次update_chart函数 ani animation.FuncAnimation(fig, update_chart, interval5000, blitFalse, cache_frame_dataFalse) print(开始采集数据并绘制图表关闭图表窗口即可退出程序...) try: plt.show() # 这会阻塞直到图表窗口被关闭 except KeyboardInterrupt: print(\n程序被中断。) finally: # 程序结束时务必清理传感器资源 sensor.exit() print(传感器资源已清理。)保存这个脚本然后在终端用sudo运行它sudo python3 dht_plot.py稍等片刻一个图形窗口就会弹出来。你会看到两个动态更新的折线图一个显示温度一个显示湿度X轴是时间。图表会每5秒自动更新一次新的数据点从右侧进入旧的数据点从左侧移出形成一个实时滚动的效果。你可以最小化终端把这个图表窗口放在桌面上它就是一个非常直观的环境监测仪表盘了。这是我个人非常喜欢的一种展示方式比看纯数字舒服多了。6. 项目优化与扩展思路走到这一步一个完整的从硬件连接到数据可视化的项目就已经完成了。但作为玩了这么多年的老手我总觉得还可以做得更好。这里分享几个优化和扩展的思路你可以根据自己的兴趣和需求来选择尝试。首先关于读取稳定性。DHT11/22传感器在树莓派上偶尔读取失败几乎是必然的。除了我们代码里已经做的异常捕获和重试还有一些硬件和系统层面的技巧。比如给树莓派的GPIO引脚加上一个小的电容0.1uF到地可以滤除一些电源噪声。再比如可以尝试降低读取频率从5秒一次改为10秒或30秒一次给传感器更充分的准备时间。另外确保你的树莓派电源是足额、稳定的推荐5V3A电源不稳会导致GPIO电压波动直接影响传感器通信。其次数据持久化。我们现在只是实时显示数据关掉程序就没了。你可以很容易地将数据保存下来。最简单的方法是写入CSV文件。在update_chart函数里成功读取数据后添加几行代码with open(dht_data.csv, a) as f: f.write(f{current_time.isoformat()},{temp},{hum}\n)这样每次读取都会在dht_data.csv文件末尾追加一行数据包含时间戳、温度和湿度。有了这个CSV文件你以后就可以用Excel、Python的Pandas库进行更深入的分析比如计算日均值、绘制长时间跨度的趋势图等等。更进一步做成Web服务。如果你想让手机或电脑在同一个网络下都能查看温湿度可以搭建一个简单的Web服务器。Python的Flask框架非常适合做这个。你可以写一个Flask应用它后台运行我们上面的数据读取循环并提供一个网页。网页上通过JavaScript定时请求最新的数据并用ECharts这样的图表库画出更精美的动态图表。这样你只需要在浏览器输入树莓派的IP地址就能看到监控面板了。这其实就是很多商业智能家居设备的雏形。最后触发动作。单纯的监控意义有限如果能根据数据自动做一些事情项目就更有趣了。比如你可以设定一个规则当温度超过30度时通过GPIO控制一个继电器打开风扇当湿度低于40%时控制一个继电器打开加湿器。这就需要你连接更多的硬件并编写一些条件判断逻辑。树莓派的GPIO能力很强驱动继电器模块非常简单这就能把你的环境监测系统升级成一个简单的自动控制系统。我自己在书房就部署了这样一个系统用DHT22监测温湿度数据不仅实时显示在角落的一个小屏幕上还保存到数据库。当下午太阳晒进来温度升高时它能自动给我发一条手机通知提醒我开空调。这些扩展功能听起来复杂但其实都是在今天这个基础项目上像搭积木一样一层层加上去的。希望这个项目能成为你玩转树莓派和物联网的一个起点当你看到自己亲手搭建的系统稳定运行、图表上的曲线随着真实环境变化时那种成就感是非常棒的。如果在实践过程中遇到任何问题比如库安装报错、接线没反应、图表显示异常别着急回头检查一下每一步尤其是接线和权限sudo大部分问题都能迎刃而解。