保姆级教程：用树莓派4B和Python3.9搭建你的第一个智能家居传感器（附完整代码）
保姆级教程：用树莓派4B和Python3.9搭建你的第一个智能家居传感器（附完整代码）
1. 项目概述与硬件准备
树莓派作为一款性价比极高的微型计算机，在智能家居领域有着广泛的应用前景。不同于传统单片机开发板，树莓派4B搭载四核Cortex-A72处理器和4GB内存（可选8GB版本），能够轻松运行完整的Linux系统，这为复杂的数据处理和网络服务提供了硬件基础。
核心硬件清单：
| 组件名称 | 推荐型号 | 数量 | 备注说明 |
|---|---|---|---|
| 树莓派主板 | Raspberry Pi 4B 4GB版 | 1 | 建议选择带散热片的套装 |
| 温湿度传感器 | DHT22 (AM2302) | 1 | 精度±0.5℃，±2%RH |
| 人体红外传感器 | HC-SR501 | 1 | 可检测5米范围内人体移动 |
| 电阻 | 10KΩ 1/4W | 2 | 用于DHT22和HC-SR501的上拉电阻 |
| 面包板 | 840孔无焊板 | 1 | 方便快速搭建测试电路 |
| 杜邦线 | 母对母20cm套装 | 1包 | 建议选择多种颜色便于区分线路 |
提示：购买DHT22时注意区分模块版和裸传感器版，前者已内置电阻更易使用但价格稍高。
2. 系统环境配置
2.1 操作系统安装与优化
推荐使用Raspberry Pi OS Lite版本（基于Debian 11 Bullseye），该系统经过专门优化且资源占用低：
# 下载最新系统镜像 wget https://downloads.raspberrypi.org/raspios_lite_arm64/images/raspios_lite_arm64-2023-05-03/2023-05-03-raspios-bullseye-arm64-lite.img.xz # 刷写镜像到SD卡（假设SD卡设备为/dev/mmcblk0） sudo dd if=2023-05-03-raspios-bullseye-arm64-lite.img of=/dev/mmcblk0 bs=4M status=progress首次启动后建议进行以下优化配置：
- 扩展文件系统：
sudo raspi-config→ "Advanced Options" → "Expand Filesystem" - 启用SSH：同一菜单下选择"Interfacing Options" → "SSH" → "Yes"
- 设置静态IP（可选）：
sudo nano /etc/dhcpcd.conf # 添加以下内容（根据实际网络环境修改） interface eth0 static ip_address=192.168.1.100/24 static routers=192.168.1.1 static domain_name_servers=192.168.1.1 8.8.8.8
2.2 Python环境配置
树莓派默认已安装Python3，但我们需要确保版本符合要求并安装必要依赖：
# 检查Python版本 python3 --version # 应显示3.9.x # 安装开发工具和依赖库 sudo apt update && sudo apt install -y \ python3-dev \ python3-pip \ libgpiod2 \ libatlas-base-dev # 创建虚拟环境（推荐） python3 -m venv ~/sensor_env source ~/sensor_env/bin/activate3. 传感器连接与电路搭建
3.1 DHT22温湿度传感器接线
DHT22采用单总线协议，接线时需注意方向：
树莓派 GPIO引脚 DHT22引脚 ---------------- ---------- 3.3V (Pin 1) → VCC (Pin 1) GPIO4 (Pin 7) → DATA (Pin 2) GND (Pin 9) → GND (Pin 4)注意：DATA引脚与VCC之间需要连接10KΩ上拉电阻，模块版已内置可省略此步骤。
3.2 HC-SR501人体红外传感器接线
树莓派 GPIO引脚 HC-SR501引脚 ---------------- ------------ 5V (Pin 2) → VCC (红色线) GPIO17 (Pin 11) → OUT (黄色线) GND (Pin 14) → GND (黑色线)调节说明：传感器背面有两个旋钮，左侧调节检测距离（顺时针增大），右侧调节延时时间（触发后输出保持时间）。
4. Python数据采集程序开发
4.1 安装传感器驱动库
# 安装Adafruit_DHT库的改进版（原版已停止维护） pip3 install adafruit-circuitpython-dht pip3 install RPi.GPIO4.2 完整数据采集脚本
创建sensor_monitor.py文件：
#!/usr/bin/env python3 import time import board import adafruit_dht import RPi.GPIO as GPIO from datetime import datetime # 传感器配置 DHT_PIN = board.D4 # GPIO4对应BCM编号4 PIR_PIN = 17 # GPIO17对应BCM编号17 # 初始化传感器 dht22 = adafruit_dht.DHT22(DHT_PIN, use_pulseio=False) GPIO.setmode(GPIO.BCM) GPIO.setup(PIR_PIN, GPIO.IN) def read_dht22(retries=3): for _ in range(retries): try: temp = dht22.temperature humidity = dht22.humidity if temp is not None and humidity is not None: return temp, humidity except RuntimeError as e: print(f"DHT22读取失败: {e}") time.sleep(1) return None, None try: while True: # 读取温湿度 temp, humidity = read_dht22() timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") # 读取人体红外 motion = GPIO.input(PIR_PIN) # 输出结果 print(f"[{timestamp}] 温度: {temp:.1f}°C, 湿度: {humidity:.1f}%", end="") print(f", 人体检测: {'有' if motion else '无'}活动") time.sleep(2) # 2秒采样间隔 except KeyboardInterrupt: print("\n程序终止") finally: dht22.exit() GPIO.cleanup()4.3 常见问题排查
问题1：DHT22读数不稳定或返回None
- 检查接线是否牢固，特别是DATA引脚
- 确保上拉电阻正确连接
- 尝试降低采样频率（增加sleep时间）
问题2：GPIO权限不足
# 将当前用户加入gpio组 sudo usermod -a -G gpio $USER # 需要重新登录生效问题3：传感器读数明显偏差
- DHT22需要2-3分钟预热时间才能达到最佳精度
- 避免将传感器放置在发热元件附近
5. 数据可视化与远程访问
5.1 本地数据可视化
安装Matplotlib进行简单绘图：
pip3 install matplotlib创建plot_sensor_data.py：
import matplotlib.pyplot as plt import matplotlib.dates as mdates from datetime import datetime def plot_data(data_file): timestamps, temps, humids = [], [], [] with open(data_file) as f: for line in f: parts = line.strip().split(',') timestamps.append(datetime.strptime(parts[0], "%Y-%m-%d %H:%M:%S")) temps.append(float(parts[1])) humids.append(float(parts[2])) fig, (ax1, ax2) = plt.subplots(2, 1, figsize=(10, 6)) # 温度曲线 ax1.plot(timestamps, temps, 'r-', label='温度') ax1.set_ylabel('温度 (°C)') ax1.legend() # 湿度曲线 ax2.plot(timestamps, humids, 'b-', label='湿度') ax2.set_ylabel('湿度 (%)') ax2.legend() # 格式化x轴 for ax in [ax1, ax2]: ax.xaxis.set_major_formatter(mdates.DateFormatter('%H:%M')) ax.grid(True) plt.tight_layout() plt.savefig('sensor_data.png') print("图表已保存为sensor_data.png") if __name__ == "__main__": plot_data('sensor_log.csv')5.2 手机端数据查看方案
方案A：使用Telegram Bot推送警报
import requests def send_telegram_alert(message, bot_token, chat_id): url = f"https://api.telegram.org/bot{bot_token}/sendMessage" payload = { "chat_id": chat_id, "text": message, "parse_mode": "HTML" } response = requests.post(url, json=payload) return response.json() # 在采集循环中添加条件判断 if temp > 30: # 温度超过30度时发送警报 alert_msg = f"⚠️ 高温警报！当前温度: {temp:.1f}°C" send_telegram_alert(alert_msg, "YOUR_BOT_TOKEN", "YOUR_CHAT_ID")方案B：搭建简易Web界面
使用Flask创建Web服务：
pip3 install flask创建web_app.py：
from flask import Flask, render_template_string import sqlite3 from datetime import datetime, timedelta app = Flask(__name__) # 简易HTML模板 HTML_TEMPLATE = """ <!DOCTYPE html> <html> <head> <title>智能家居监控</title> <meta http-equiv="refresh" content="10"> <style> body { font-family: Arial, sans-serif; margin: 20px; } .sensor-box { border: 1px solid #ddd; padding: 15px; margin-bottom: 10px; border-radius: 5px; width: 300px; } .alert { color: red; font-weight: bold; } </style> </head> <body> <h1>环境监测面板</h1> <p>更新时间: {{ time }}</p> <div class="sensor-box"> <h2>温湿度传感器</h2> <p>温度: {{ temp }}°C</p> <p>湿度: {{ humid }}%</p> {% if temp > 30 %}<p class="alert">高温警告！</p>{% endif %} </div> <div class="sensor-box"> <h2>人体检测</h2> <p>状态: {{ motion }}</p> </div> </body> </html> """ def get_latest_data(): conn = sqlite3.connect('sensor_data.db') cursor = conn.cursor() cursor.execute("SELECT * FROM sensor_data ORDER BY timestamp DESC LIMIT 1") row = cursor.fetchone() conn.close() return row @app.route('/') def dashboard(): data = get_latest_data() if data: timestamp, temp, humid, motion = data motion_text = "检测到活动" if motion else "无活动" return render_template_string(HTML_TEMPLATE, time=timestamp, temp=temp, humid=humid, motion=motion_text) return "暂无数据" if __name__ == '__main__': app.run(host='0.0.0.0', port=8080)6. 项目扩展与进阶应用
6.1 自动化控制示例
通过继电器模块控制风扇（GPIO18控制）：
import RPi.GPIO as GPIO FAN_PIN = 18 TEMP_THRESHOLD = 28 # 温度阈值 GPIO.setmode(GPIO.BCM) GPIO.setup(FAN_PIN, GPIO.OUT) try: while True: temp, _ = read_dht22() if temp is not None: if temp > TEMP_THRESHOLD: GPIO.output(FAN_PIN, GPIO.HIGH) print("风扇已启动") else: GPIO.output(FAN_PIN, GPIO.LOW) print("风扇已停止") time.sleep(60) # 每分钟检查一次 except KeyboardInterrupt: GPIO.cleanup()6.2 数据持久化方案
使用SQLite存储历史数据：
import sqlite3 def init_db(): conn = sqlite3.connect('sensor_data.db') cursor = conn.cursor() cursor.execute('''CREATE TABLE IF NOT EXISTS sensor_data (timestamp TEXT PRIMARY KEY, temperature REAL, humidity REAL, motion INTEGER)''') conn.commit() conn.close() def save_data(temp, humid, motion): timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S") conn = sqlite3.connect('sensor_data.db') cursor = conn.cursor() cursor.execute("INSERT INTO sensor_data VALUES (?, ?, ?, ?)", (timestamp, temp, humid, 1 if motion else 0)) conn.commit() conn.close()6.3 多传感器网络扩展
当需要监控多个房间时，可以采用以下架构：
- 集中式方案：使用多个树莓派作为节点，通过MQTT协议将数据发送到中央服务器
- 分布式方案：每个房间部署独立系统，通过REST API进行数据汇总
示例MQTT发布代码：
import paho.mqtt.client as mqtt mqtt_broker = "192.168.1.10" client = mqtt.Client("bedroom_sensor") client.connect(mqtt_broker) def publish_sensor_data(temp, humid, motion): client.publish("home/bedroom/temperature", temp) client.publish("home/bedroom/humidity", humid) client.publish("home/bedroom/motion", "ON" if motion else "OFF")