保姆级教程：用树莓派4B+DHT22传感器，5分钟搞定OneNET物模型数据上云

树莓派4B+DHT22传感器极速上云指南：从硬件连接到OneNET物模型实战

在智能家居和物联网原型开发中，快速验证想法往往比完美实现更重要。本文将带你用树莓派4B和DHT22温湿度传感器，在5分钟内完成从物理连接到OneNET物联网平台数据可视化的全流程。不同于传统教程冗长的环境配置，我们采用最小必要步骤设计，即使没有任何Linux或Python基础的开发者也能立即看到传感器数据在云端跳动。

1. 硬件准备与连接

1.1 物料清单检查

确保手边有以下设备（型号必须完全匹配）：

• 树莓派4B（任何内存版本均可，建议安装Raspberry Pi OS Lite系统）
• DHT22传感器（AM2302型号，注意是3引脚封装版）
• 母对母杜邦线3条（颜色建议：红、黑、黄）
• 5V/3A USB-C电源（为树莓派供电）

注意：DHT22有裸板和三线封装两种版本，本文使用带塑料外壳的三线版（VCC/GND/DATA），若使用四针版本需要额外接电阻。

1.2 物理连接图解

按照以下引脚对应关系连接：

连接完成后，树莓派通电启动。可通过lsmod | grep dht命令检查内核是否自动加载了dht11驱动（虽然DHT22需要用户态驱动，但内核模块存在表示硬件正常）。

2. 软件环境一键配置

2.1 依赖安装

在树莓派终端执行以下命令（全部复制粘贴运行）：

#!/bin/bash # 一键安装脚本 sudo apt update && sudo apt install -y python3-pip git sudo pip3 install Adafruit_DHT git clone https://github.com/adafruit/Adafruit_Python_DHT.git cd Adafruit_Python_DHT && sudo python3 setup.py install

2.2 传感器测试代码

创建dht22_test.py文件：

import Adafruit_DHT import time sensor = Adafruit_DHT.DHT22 pin = 4 # GPIO4 while True: humidity, temperature = Adafruit_DHT.read_retry(sensor, pin) if humidity is not None and temperature is not None: print(f"Temp={temperature:.1f}°C Humidity={humidity:.1f}%") else: print("Failed to read data") time.sleep(2)

运行测试：python3 dht22_test.py，正常应每2秒输出一次温湿度数据。若持续报错，检查硬件连接是否松动。

3. OneNET物模型快速接入

3.1 控制台配置三步骤

1. 创建产品：登录OneNET控制台 → 物联网平台 → 创建产品 → 选择"物模型"接入方式 → 自定义品类（如"环境监测"）
2. 定义物模型：在产品详情页添加两个属性：
   • 温度（float类型，单位℃）
   • 湿度（float类型，单位%RH）
3. 添加设备：记录自动生成的设备ID和API Key

3.2 Python上传脚本

创建onenet_upload.py：

import requests import json import Adafruit_DHT from time import sleep DEVICE_ID = "你的设备ID" API_KEY = "你的API_Key" sensor = Adafruit_DHT.DHT22 pin = 4 def upload_to_onenet(temp, humi): url = f"http://api.heclouds.com/devices/{DEVICE_ID}/datapoints" headers = {"api-key": API_KEY} payload = {"datastreams": [ {"id": "temperature", "datapoints": [{"value": temp}]}, {"id": "humidity", "datapoints": [{"value": humi}]} ]} r = requests.post(url, headers=headers, data=json.dumps(payload)) return r.status_code == 200 while True: humidity, temperature = Adafruit_DHT.read_retry(sensor, pin) if None not in (humidity, temperature): if upload_to_onenet(temperature, humidity): print(f"Uploaded: {temperature}°C, {humidity}%") sleep(30) # 每30秒上传一次

后台运行：nohup python3 onenet_upload.py &，此时OneNET控制台应能看到实时数据曲线。

4. 微信小程序实时展示（可选）

对于需要移动端查看的场景，可通过微信小程序调用OneNET API。在小程序的app.js中添加：

const fetchSensorData = () => { wx.request({ url: 'https://api.heclouds.com/devices/设备ID/datapoints', header: {'api-key': '你的API_Key'}, success(res) { console.log('最新数据:', res.data.data) } }) }

页面布局建议使用<canvas>绘制温湿度曲线，或简单显示数值：

<view class="container"> <text>当前温度：{{temp}}℃</text> <text>当前湿度：{{humi}}%RH</text> </view>

常见问题速查表

硬件方面，若在潮湿环境使用，建议给DHT22加装防水透气膜；软件层面，生产环境应考虑添加本地数据缓存，防止网络中断导致数据丢失。