树莓派Pico连接DHT22温湿度传感器：从硬件连接到MicroPython代码实战

1. 项目概述与核心价值

如果你手头有一块树莓派Pico，想用它来做个能感知环境温湿度的小玩意儿，比如温室监控、智能加湿器或者简单的气象站，那么DHT22传感器几乎是你的不二之选。这玩意儿价格便宜、精度够用，最关键的是接线简单，就三根线，对新手极其友好。我这些年折腾过不少传感器，DHT22属于那种“闭着眼睛都能接对”的经典款，特别适合用来入门嵌入式开发和物联网数据采集。

这个教程的核心，就是帮你把DHT22和树莓派Pico/W给“撮合”到一起，让你能用MicroPython写几行代码就读出温湿度数据。别看过程简单，里面涉及到硬件引脚选择、库文件管理、代码异常处理这些细节，任何一个环节卡住，新手可能就得折腾半天。我会把每一步为什么这么做、可能会遇到什么坑，都掰开揉碎了讲清楚。你跟着做下来，不仅能点亮这个小项目，更能掌握一套连接传感器、编写嵌入式代码的通用方法，以后换别的传感器也能举一反三。

2. 硬件选型与连接原理深度解析

2.1 为什么是DHT22和树莓派Pico？

在开始接线之前，我们得先搞清楚为什么选这两样东西。市面上温湿度传感器很多，像DHT11、SHT30、BME280等等。DHT22的优势在于它是一个数字传感器，内部集成了模数转换电路，直接通过单总线（1-Wire）协议输出数字信号。这意味着树莓派Pico不需要复杂的模拟电路（比如ADC参考电压校准），只需要一根数据线就能通信，极大地简化了硬件设计。它的测量范围（温度-40~80°C，湿度0~100% RH）和精度（温度±0.5°C，湿度±2% RH）对于绝大多数业余项目和原型开发来说完全够用，关键是单价通常不到20块钱，性价比超高。

树莓派Pico（尤其是Pico W带Wi-Fi版本）则是微控制器中的“瑞士军刀”。它基于RP2040芯片，双核ARM Cortex-M0+，性能对于读取传感器数据绰绰有余。更重要的是，它原生支持MicroPython，这是一种为嵌入式设备优化的Python方言。用MicroPython开发，你就不用去啃晦涩的C语言和寄存器手册了，像操作普通Python一样就能控制硬件，开发效率提升不止一个量级。Pico W还内置了Wi-Fi，这意味着你做完本地数据采集后，可以非常方便地将数据上传到网络服务器或物联网平台，项目扩展性很强。

2.2 物理连接：三根线背后的门道

DHT22一般有四个引脚（有的模块是三个引脚，将VCC和信号引脚之间集成了一个上拉电阻）。对于标准四引脚版本，我们需要连接三根线：

1. VCC (电源正极)：连接到Pico的3V3(OUT)引脚。这里是个关键点：绝对不要接到VSYS（输入电压）或5V引脚上。DHT22的工作电压是3.3V-5.5V，虽然接5V也能工作，但Pico的GPIO引脚耐受电压是3.3V。如果传感器输出5V电平的信号，可能会损坏Pico的GPIO引脚。为了安全起见，统一使用3.3V供电是最稳妥的方案。
2. GND (电源地)：连接到Pico的任意一个GND引脚。
3. DATA (数据线)：连接到Pico的任意一个GPIO引脚（例如GP2）。这条线负责双向通信。
4. NC (空脚)：不需要连接。

注意：DHT22的数据线需要一个上拉电阻（通常4.7KΩ - 10KΩ），将数据线通过电阻拉到VCC（3.3V），以保证总线在空闲时处于高电平状态。很多市面上售卖的DHT22模块（包括教程中提到的ShillehTek版本）已经把这个电阻集成在电路板上了。如果你买的是最基础的传感器探头，就需要自己在VCC和DATA线之间焊接一个4.7KΩ的电阻。这是通信稳定的关键，没有它，数据读取很可能失败。

接线示意图（假设使用GP2）：

• Pico3V3(OUT)→ DHT22VCC
• PicoGND→ DHT22GND
• PicoGP2→ DHT22DATA(如果模块无内置上拉电阻，则需在GP2和3V3之间接4.7KΩ电阻)

2.3 通信协议：单总线（1-Wire）是如何工作的

DHT22使用的单总线协议，可以理解成一种“一问一答”的节俭对话方式。所有通信都通过那一根数据线完成，既发送命令也接收数据。一次完整的读取过程大约需要4毫秒，包含以下阶段：

1. 主机（Pico）发起启动信号：Pico把数据线拉低至少1毫秒，然后拉高20-40微秒，这是在“唤醒”DHT22，告诉它：“我要读数了”。
2. 从机（DHT22）响应：DHT22收到信号后，会先把数据线拉低80微秒，再拉高80微秒，作为回应：“我准备好了”。
3. 数据传输：随后，DHT22开始发送40位（5字节）的数据。每一位数据都用低电平的时间长短来表示“0”或“1”。通常，50微秒的低电平后，如果高电平持续26-28微秒，表示“0”；如果高电平持续70微秒，则表示“1”。
4. 校验和：40位数据的最后8位是前32位数据的校验和。MicroPython的dht库会帮我们完成校验。如果校验失败，库会抛出异常，这也是我们代码里需要try-except的原因。

整个过程非常快，而且由库函数dht_sensor.measure()在底层封装好了，我们无需关心这些时序细节。但了解原理有助于排查问题：如果读取总是失败，除了检查接线和上拉电阻，还要考虑是否在两次读取之间留足了间隔（DHT22两次测量之间至少需要2秒的休息时间）。

3. 软件环境搭建与核心代码剖析

3.1 Thonny IDE与MicroPython固件部署

工欲善其事，必先利其器。我们选择Thonny作为开发环境，因为它对MicroPython和树莓派Pico的支持是“开箱即用”级的。首先，确保你的Pico已经烧录了MicroPython固件。如果还没做，步骤很简单：按住Pico板上的BOOTSEL按钮不放，用USB线连接到电脑，电脑会识别出一个名为RPI-RP2的U盘。然后把从树莓派官网下载的.uf2格式的MicroPython固件文件拖进去，Pico会自动重启，固件就烧录完成了。

打开Thonny，在右下角选择解释器。点击“运行”菜单下的“选择解释器”，在弹窗里选择“MicroPython (Raspberry Pi Pico)”，端口会自动识别。连接成功后，Thonny下方的Shell（壳）窗口会出现>>>的MicroPython提示符。到这里，软件基础环境就准备好了。

3.2 库管理：安装dht库的两种途径

MicroPython的强大之处在于其丰富的库生态。对于DHT传感器，我们有现成的库可用。教程中提到通过Thonny的“管理包”安装，这是最省事的方法（Tools > Manage Packages，搜索dht安装）。但我更推荐你了解另一种方法：手动下载库文件。因为在实际项目开发中，尤其是离线环境或需要固定库版本时，手动管理更可靠。

你可以从MicroPython的官方GitHub库或像micropython-lib这样的社区仓库找到dht.py文件。下载后，在Thonny左侧的文件浏览器中，右键点击你的Pico设备（通常显示为MicroPython设备），选择“上传到/”，把这个dht.py文件传上去。这样，库文件就永久存储在Pico的闪存里了，无论你用什么IDE，都可以直接import dht。

实操心得：我习惯为每个项目在Pico上创建一个单独的文件夹，比如/projects/weather_station/，然后把项目相关的自定义库和主程序都放进去，这样文件结构清晰，便于管理。你可以通过Thonny在Pico上直接新建文件夹。

3.3 代码逐行解读与优化

让我们深入分析教程提供的代码，并在此基础上进行优化和加固。

import machine import dht import time # 1. 引脚定义 dht_pin = machine.Pin(2) # 2. 传感器对象初始化 dht_sensor = dht.DHT22(dht_pin) while True: try: # 3. 发起测量 dht_sensor.measure() # 4. 读取数据 temperature_celsius = dht_sensor.temperature() humidity_percent = dht_sensor.humidity() # 5. 格式化输出 print("Temperature: {:.2f} °C".format(temperature_celsius)) print("Humidity: {:.2f} %".format(humidity_percent)) except Exception as e: # 6. 异常处理 print("Error reading DHT22:", str(e)) # 7. 延时 time.sleep(0.1)

关键点解析与优化建议：

1. 引脚定义 (machine.Pin(2))：这里的2对应的是Pico的GP2物理引脚。你可以换成任何其他数字GPIO，如0,1,3...28。但要避开系统使用的引脚，比如GP23、GP24、GP25通常连接着板载LED。建议：使用一个有标识的变量，如SENSOR_PIN = 2，提高代码可读性。
2. 初始化：dht.DHT22(dht_pin)创建了一个传感器驱动对象。如果你用的是DHT11，需要改为dht.DHT11(dht_pin)。库会自动处理通信协议。
3. measure()方法：这是最关键的指令，它执行了前面提到的“启动信号-响应-数据读取”全过程。调用它之后，温湿度数据已经缓存在传感器对象内部。
4. temperature()和humidity()：这两个方法用于从缓存中取出最新的测量值。temperature()返回摄氏度（°C）。注意：DHT22有时会返回一个微小的浮点数误差，比如22.0可能显示为22.000001，这是正常的。
5. 格式化输出：{:.2f}表示将浮点数格式化为两位小数。对于环境监测，一位小数通常精度就足够了，可以改为{:.1f}。
6. 异常处理 (try-except)：这是保证程序长期稳定运行的核心！DHT22通信容易受到导线过长、电源不稳、电磁干扰的影响，导致单次读取失败。如果没有异常捕获，一次读取失败就会导致整个程序崩溃。捕获异常并打印错误，能让程序继续尝试下一次读取。
7. 延时 (time.sleep(0.1))：教程中设为0.1秒（100毫秒），这太频繁了。DHT22的硬件特性要求两次measure()调用之间至少有2秒的间隔，否则传感器可能无法响应或返回旧数据。必须将这里的延时改为至少2秒，即time.sleep(2)。过快的读取不仅无效，还可能增加功耗和通信错误率。

优化后的代码示例：

import machine import dht import time # 配置参数 SENSOR_PIN_NUM = 2 # 数据线连接的GPIO编号 READ_INTERVAL = 2 # 读取间隔，单位秒，必须大于等于2 # 初始化 dht_pin = machine.Pin(SENSOR_PIN_NUM) sensor = dht.DHT22(dht_pin) print("DHT22 Sensor Monitor Started") print("----------------------------") while True: try: sensor.measure() # 发起一次测量 temp = sensor.temperature() humi = sensor.humidity() # 检查是否读取到有效值（DHT22在极端条件下可能返回None） if temp is not None and humi is not None: print(f"Time: {time.ticks_ms()//1000}s, Temp: {temp:.1f}C, Humi: {humi:.1f}%") else: print("Warning: Sensor returned None values.") except OSError as e: # 更精确地捕获通信错误 print(f"OSError: Failed to read sensor. Check wiring. [{e}]") except Exception as e: print(f"Unexpected error: {e}") # 等待足够的时间让传感器准备下一次测量 time.sleep(READ_INTERVAL)

这个优化版本增加了配置变量、更精确的异常类型捕获、返回值有效性检查，并修正了关键的读取间隔。这才是能在实际项目中稳定运行的代码。

4. 高级应用与项目拓展思路

4.1 数据记录与本地存储

仅仅在Shell里打印数据还不够，我们需要把数据存下来。Pico虽然有有限的RAM，但其闪存可以用来存储文件。我们可以将数据写入到CSV格式的文本文件中。

import uos # ... 初始化传感器代码同上 ... # 尝试打开文件追加数据，如果不存在则创建 try: with open('/dht22_log.csv', 'a') as f: # 如果是第一次运行，写入表头 if uos.stat('/dht22_log.csv')[6] == 0: # 检查文件大小是否为0 f.write('Timestamp(ms),Temperature(C),Humidity(%)\n') # 读取传感器 sensor.measure() temp = sensor.temperature() humi = sensor.humidity() if temp is not None and humi is not None: timestamp = time.ticks_ms() line = f'{timestamp},{temp:.2f},{humi:.2f}\n' f.write(line) print(f"Data logged: {line.strip()}") except OSError as e: print(f"File write error: {e}")

注意事项：频繁写入闪存会损耗其寿命。对于长时间、高频次的数据记录，建议先将数据缓存在内存中（比如一个列表里），每积累100条或每隔10分钟再一次性写入文件。或者，可以考虑给Pico外接一个microSD卡扩展板，将数据存到SD卡上。

4.2 连接Wi-Fi与数据上报（Pico W专属）

这是Pico W的“杀手级”应用。我们可以把采集到的数据发送到物联网平台（如ThingsBoard、Blynk）、自己的服务器，或者简单的Webhook。

import network import urequests import json # Wi-Fi配置 WIFI_SSID = '你的Wi-Fi名称' WIFI_PASSWORD = '你的Wi-Fi密码' def connect_wifi(): wlan = network.WLAN(network.STA_IF) wlan.active(True) if not wlan.isconnected(): print('Connecting to Wi-Fi...') wlan.connect(WIFI_SSID, WIFI_PASSWORD) # 等待连接，最多10秒 for _ in range(10): if wlan.isconnected(): break time.sleep(1) if wlan.isconnected(): print('Wi-Fi Connected! IP:', wlan.ifconfig()[0]) return True else: print('Wi-Fi Connection Failed!') return False # 在主循环中 if connect_wifi(): sensor_data = {'temperature': temp, 'humidity': humi} try: # 示例：发送到Webhook服务（如IFTTT） response = urequests.post('https://maker.ifttt.com/trigger/your_event/with/key/your_key', json=sensor_data, headers={'Content-Type': 'application/json'}) print('Data sent, status:', response.status_code) response.close() except Exception as e: print('HTTP request failed:', e)

4.3 驱动多个传感器与低功耗优化

有时一个项目需要监测多个点的温湿度。DHT22的单总线协议允许多个设备挂在同一根数据线上吗？理论上可以，但非常不推荐。因为DHT系列传感器没有可寻址的ID，主机无法区分它们。正确做法是为每个DHT22分配独立的GPIO引脚。

sensor1 = dht.DHT22(machine.Pin(2)) sensor2 = dht.DHT22(machine.Pin(3)) # 分别读取 sensor1.measure() temp1 = sensor1.temperature() sensor2.measure() temp2 = sensor2.temperature()

对于电池供电的项目，功耗是关键。Pico在深度睡眠（machine.deepsleep()）下功耗极低，但DHT22是物理传感器，无法通过软件关闭。一个实用的技巧是使用一个GPIO引脚控制一个MOSFET或三极管，作为传感器的电源开关。需要读数时，先打开电源，等待几百毫秒让传感器稳定，然后读取数据，读完立即关闭电源。这样可以大幅降低整体系统的平均功耗。

5. 故障排查与常见问题实录

即使按照教程一步步来，你也可能会遇到传感器没反应、读数全是None或者偶尔报错的情况。下面是我在无数项目中踩坑后总结的排查清单，基本能覆盖99%的问题。

5.1 问题速查表

5.2 增强鲁棒性的代码技巧

对于不稳定的环境，一段健壮的代码至关重要。下面是一个带自动重试的读取函数：

def read_dht_with_retry(sensor, max_retries=5): """尝试读取DHT传感器，失败后重试""" for attempt in range(max_retries): try: sensor.measure() temp = sensor.temperature() humi = sensor.humidity() # 额外的合理性检查：DHT22在正常地球环境下不会返回极端值 if -40 <= temp <= 80 and 0 <= humi <= 100: return temp, humi # 读取成功，返回有效值 else: print(f"Attempt {attempt+1}: Invalid readings (Temp:{temp}, Humi:{humi}), retrying...") except OSError as e: print(f"Attempt {attempt+1}: Communication error, retrying...") time.sleep(0.5) # 重试前短暂等待 # 所有重试都失败 print("Error: Max retries reached. Check sensor hardware and connection.") return None, None # 在主循环中使用 while True: temp, humi = read_dht_with_retry(dht_sensor) if temp is not None: print(f"Success: Temp={temp:.1f}C, Humi={humi:.1f}%") time.sleep(2) # 正常间隔

这个函数会尝试最多5次读取，只有得到物理上合理的数值（温度-40到80度，湿度0-100%）才会返回，否则继续重试。这能有效过滤掉因瞬时干扰产生的错误数据。

5.3 硬件层面的终极排查

如果所有软件方法都试过了，问题依旧，那就需要回归硬件：

1. 万用表是你的好朋友：测量Pico3V3(OUT)和GND之间的电压，确保在3.2V-3.4V之间。在传感器工作时，测量DATA引脚电压，看是否在0V与3.3V之间变化。
2. 替换法：换个DHT22传感器试试。再换根杜邦线试试。这是判断硬件损坏最直接的方法。
3. 简化系统：拔掉所有不必要的连接，只保留Pico、DHT22和USB线，排除其他外设的干扰。
4. 检查电源：如果使用外部电源（如电池），确保其能提供足够的电流（至少200mA）。USB线过长或质量差也可能导致供电不足。

从我个人的经验来看，DHT22连接Pico的问题，十有八九出在上拉电阻和读取间隔这两点上。确保你的模块有上拉电阻，或者自己焊上一个，然后把代码里的sleep时间改成2秒以上，大部分问题都能迎刃而解。这个组合的稳定性在做好这两点后，对于室内项目来说是完全可以信赖的。