1. 项目概述打造一个看得见的“空气管家”几年前为了搞清楚家里书房在长时间工作后空气质量到底有多糟糕我萌生了动手做一个监测设备的想法。市面上成品要么功能单一要么数据封闭无法满足我实时查看、历史回溯以及自定义告警的需求。于是一个结合了Arduino的稳定采集能力和Raspberry Pi强大处理与网络能力的方案应运而生。这个项目我称之为“空气管家”它能够持续监测你所在空间的温度、湿度、二氧化碳CO2浓度以及总挥发性有机物TVOC并将这些数据通过一个简洁的网页仪表盘实时展示出来历史数据也一目了然。无论你是想优化家居环境、验证新风系统效果还是作为一个有趣的物联网入门实践这个项目都能提供从硬件焊接、软件编程到系统部署的完整路径。整个系统的核心逻辑非常清晰Arduino作为前端的“感官神经”负责与各类传感器对话采集原始数据Raspberry Pi则作为后端的“大脑”负责接收、存储这些数据并通过一个轻量级的Web服务将其可视化。两者之间通过最可靠的USB串口进行通信确保了数据传输的稳定性。接下来我将拆解每一个环节不仅告诉你“怎么做”更会分享我在搭建过程中“为什么这么做”以及踩过的那些坑。2. 核心硬件选型与电路设计解析2.1 传感器阵容为何是这“三剑客”选择传感器是项目的基石需要平衡精度、稳定性、接口复杂度和成本。我最终选定的组合是DS18B20、DHT22和CCS811它们各自承担着不可替代的角色。DS18B20数字温度传感器你可能会问既然DHT22也能测温度为什么还要单独用它核心原因在于精度与稳定性。DS18B20采用单总线协议虽然需要额外的4.7KΩ上拉电阻但其测温精度可达±0.5°C且抗干扰能力更强。在同一个项目中用DS18B20校验DHT22的温度读数可以作为一个很好的数据交叉验证手段确保关键的温度数据可靠。它的封装形式多样我选择了防水探头型方便从设备外壳中伸出更准确地测量环境温度而非板载元件产生的热干扰。DHT22温湿度传感器这是获取湿度数据的主力。虽然其温度测量功能可以作为参考但我们更依赖它的湿度读数。DHT22采用单总线通信需要另一个4.7KΩ上拉电阻。它的响应速度较慢约2秒一次但对于室内环境监测来说完全足够。一个关键注意事项是DHT22对电源电压波动比较敏感务必确保其供电稳定在3.3V或5V需查看具体型号规格否则极易读取失败或数据异常。Adafruit CCS811气体传感器这是监测空气品质的核心用于测量等效二氧化碳eCO2单位ppm和总挥发性有机物TVOC单位ppb。CCS811内部集成了微控制器和基线校准算法通过I2C接口通信。它的工作原理是检测金属氧化物半导体材料在接触目标气体时电阻的变化。这里有一个至关重要的“坑”CCS811需要定期至少每24小时一次在清洁空气户外空气或经过活性炭过滤的空气中运行至少20分钟以进行基线校准。如果长期在污染环境中运行而不重置基线其读数会逐渐漂移失准。因此在软件设计中需要考虑加入提醒或自动校准机制。2.2 主控与执行单元Arduino与树莓派的分工Arduino UNO扮演数据采集器的角色。选择它是因为其模拟和数字IO接口丰富对传感器库的支持非常成熟编程简单并且通过USB串口与上位机通信稳定可靠。它的任务周期很简单每隔几秒向各个传感器请求数据打包成一个格式化的字符串例如“TEMP:23.5,HUM:45,CO2:850,TVOC:125”然后通过Serial.println()发送出去。Raspberry Pi以Pi 3B或4B为例扮演服务器和数据处理中心的角色。它运行完整的Linux操作系统Raspberry Pi OS能够轻松部署Python后端程序和Apache Web服务器。它的任务是通过USB串口持续读取Arduino发来的数据解析后存入数据库如轻量级的SQLite同时运行一个Web后端API为前端页面提供实时和历史的JSON数据。风扇与OLED屏5V桌面小风扇和I2C OLED屏128x64属于“增值”部件。风扇的作用并非散热而是促进设备内部空气与外部环境的交换避免传感器尤其是CCS811测量的是“死区”空气使读数更能反映真实环境。OLED屏则用于本地显示关键数据在不想打开网页时快速一瞥。驱动风扇需要一个2N2222三极管或MOSFET和1N4007续流二极管构成一个简单的开关电路由Arduino的一个数字引脚通过PWM控制转速。2.3 电路搭建从面包板到PCB的进化最初的验证阶段在面包板上进行是必须的它能让你快速排查接线错误。但当所有功能验证通过后为了系统的长期稳定和美观将电路移植到PCB印刷电路板上是质的飞跃。我设计了一块兼容Arduino UNO引脚排列的“传感器扩展板”Shield。这样做的好处是集成度高所有传感器、电阻、三极管都焊接在板上仅通过排针与Arduino插接彻底告别凌乱的杜邦线。可靠性强焊接连接远比插接牢固避免了因震动或移动导致的接触不良。便于安装可以将PCB直接固定在设备外壳的底板上结构整洁。电路连接要点与避坑指南DS18B20VCC接5VGND接GNDDQ数据线接数字引脚如D2同时DQ和VCC之间接一个4.7KΩ上拉电阻。DHT22VCC接3.3V或5V按型号GND接GNDDATA接数字引脚如D3同样DATA和VCC之间接4.7KΩ上拉电阻。CCS811VCC接3.3V特别注意多数CCS811模块是3.3V逻辑接5V会损坏GND接GNDSCL接A5SDA接A4Arduino UNO的I2C固定引脚。OLED同样是I2C设备VCC接3.3V或5V看模块支持GND接GNDSCL接A5SDA接A4。这里有个关键点多个I2C设备可以共享SCL和SDA线但每个设备必须有唯一的I2C地址。CCS811的默认地址是0x5A常见的OLED地址是0x3C它们互不冲突可以并联在同一组I2C总线上。风扇驱动电路这是一个经典的三极管开关电路。风扇正极接电源5V负极接三极管集电极C。三极管发射极E接GND。基极B通过一个220Ω的限流电阻连接到Arduino的一个PWM引脚如D9。1N4007二极管并联在风扇两端阴极接5V正极阳极接三极管集电极用于吸收风扇电机停止时产生的反向电动势保护三极管。注意焊接PCB时务必先焊接高度最低的元件如电阻再焊接较高的元件如传感器插座。为CCS811和DHT22使用排母插座而不是直接焊接这样方便日后更换或维修传感器。3. 软件架构与树莓派系统配置3.1 通信协议简单可靠的串口对话Arduino与树莓派之间采用USB虚拟串口通信这是最简单、最稳定的方式。你只需要一根普通的USB A to B方口线打印机线连接两者。在代码层面Arduino使用Serial对象树莓派上则可以通过Python的pyserial库来访问对应的串口设备通常是/dev/ttyACM0或/dev/ttyUSB0。我定义的通信协议是纯文本字符串以换行符\n结尾。例如T:23.41,H:45.20,C:812,V:112\n这种格式易于人类阅读和调试也便于Python后端用split()方法快速解析。为了确保数据完整性可以在每帧数据中加入简单的校验和或者约定固定的数据顺序。3.2 树莓派环境搭建从系统到服务首先使用Raspberry Pi Imager工具将Raspberry Pi OS推荐Lite版本以节省资源刷入Micro SD卡并完成基础系统设置网络、SSH、用户密码等。1. 必备软件安装sudo apt update sudo apt upgrade -y sudo apt install python3-pip apache2 sqlite3 -y2. 项目代码与Python依赖将项目代码包含前端HTML/CSS/JS、后端Python脚本克隆或上传到树莓派的用户目录下例如/home/pi/air_quality_monitor。 进入后端代码目录安装所需的Python包。requirements.txt文件可能包含pyserial flask flask-cors sqlite3安装命令pip3 install -r requirements.txt3. 配置Apache2托管前端默认情况下Apache的网页根目录是/var/www/html。我们可以修改配置让其指向我们的前端代码目录或者更简单的方式是创建一个软链接。# 备份原始页面 sudo mv /var/www/html/index.html /var/www/html/index.html.bak # 将我们的前端文件夹链接到Apache根目录 sudo ln -s /home/pi/air_quality_monitor/Frontend /var/www/html/airquality这样通过浏览器访问http://树莓派IP地址/airquality就能看到前端页面了。4. 创建系统服务关键步骤为了让后端数据采集程序和Web API服务在树莓派开机后自动运行并在崩溃后自动重启我们需要将其配置为systemd服务。创建后端服务文件sudo nano /etc/systemd/system/airquality-backend.service写入以下内容请根据实际路径修改[Unit] DescriptionAir Quality Monitor Backend Service Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/air_quality_monitor/Backend ExecStart/usr/bin/python3 /home/pi/air_quality_monitor/Backend/app.py Restarton-failure RestartSec5s StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target创建串口数据读取服务假设为serial_reader.pysudo nano /etc/systemd/system/airquality-serial.service内容类似只需修改Description和ExecStart的路径。启用并启动服务sudo systemctl daemon-reload sudo systemctl enable airquality-backend.service sudo systemctl enable airquality-serial.service sudo systemctl start airquality-backend.service sudo systemctl start airquality-serial.service使用sudo systemctl status airquality-backend.service检查服务状态看到“active (running)”即表示成功。实操心得使用systemd服务管理是生产级部署的关键。它比在rc.local或crontab里启动更专业提供了完善的日志通过journalctl -u 服务名查看、依赖管理和进程监控。务必注意WorkingDirectory的设置这能避免脚本因相对路径问题找不到文件。4. 核心代码逻辑剖析4.1 Arduino端稳定采集与数据发送Arduino的代码.ino文件结构清晰主要包含库引入、引脚定义、传感器初始化、主循环。#include Wire.h #include Adafruit_CCS811.h #include DHT.h #include OneWire.h #include DallasTemperature.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h // 引脚定义 #define DHTPIN 3 #define ONE_WIRE_BUS 2 #define FAN_PIN 9 #define OLED_RESET -1 // 传感器对象初始化 DHT dht(DHTPIN, DHT22); OneWire oneWire(ONE_WIRE_BUS); DallasTemperature ds18b20(oneWire); Adafruit_CCS811 ccs; Adafruit_SSD1306 display(128, 64, Wire, OLED_RESET); void setup() { Serial.begin(9600); // 初始化串口与树莓派通信 pinMode(FAN_PIN, OUTPUT); analogWrite(FAN_PIN, 128); // 风扇以50%转速启动 // 初始化传感器 dht.begin(); ds18b20.begin(); if(!ccs.begin()){ Serial.println(“CCS811 init failed!”); while(1); } while(!ccs.available()); // 等待CCS811校准完成 // 初始化OLED if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F(“SSD1306 allocation failed”)); for(;;); } display.clearDisplay(); } void loop() { // 读取DHT22湿度和温度 float h dht.readHumidity(); float t_dht dht.readTemperature(); // 读取DS18B20温度 ds18b20.requestTemperatures(); float t_ds ds18b20.getTempCByIndex(0); // 读取CCS811 if(ccs.available()){ if(!ccs.readData()){ // 如果读取成功 float co2 ccs.geteCO2(); float tvoc ccs.getTVOC(); // 打包数据字符串 String data “T1:” String(t_dht, 1) “,T2:” String(t_ds, 1) “,H:” String(h, 0) “,C:” String(co2, 0) “,V:” String(tvoc, 0); Serial.println(data); // 发送数据 // 更新OLED显示 display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); display.setCursor(0,0); display.print(“T:”); display.print(t_ds,1); display.println(“C”); display.print(“H:”); display.print(h,0); display.println(“%”); display.print(“CO2:”); display.print(co2,0); display.println(“ppm”); display.print(“TVOC:”); display.print(tvoc,0); display.println(“ppb”); display.display(); } } delay(5000); // 每5秒采集一次 }代码要点我为两个温度传感器赋予了不同的前缀T1, T2方便后端区分和对比。风扇使用PWM控制analogWrite(FAN_PIN, 128)对应约50%占空比可以在代码中根据CO2浓度动态调整风扇转速实现简单的联动控制。CCS811的readData()函数返回0表示成功非0表示错误或数据未就绪。串口波特率设置为9600这是一个在稳定性和速度间平衡的常用值。4.2 树莓派后端数据接收、存储与API提供树莓派上的Python后端主要包含两个部分串口读取进程/服务以及Flask Web API服务。这里可以将它们写在一个多线程程序里或者拆分成两个独立服务更推荐耦合度低。串口读取与数据库写入serial_reader.py:import serial import sqlite3 import time from datetime import datetime # 配置串口端口名可能需要根据实际情况调整 ser serial.Serial(‘/dev/ttyACM0’, 9600, timeout1) # 连接SQLite数据库 conn sqlite3.connect(‘/home/pi/air_quality_monitor/data.db’, check_same_threadFalse) cursor conn.cursor() # 创建数据表如果不存在 cursor.execute(‘‘‘CREATE TABLE IF NOT EXISTS sensor_data (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp DATETIME DEFAULT CURRENT_TIMESTAMP, temp_dht REAL, temp_ds REAL, humidity REAL, co2 INTEGER, tvoc INTEGER)’’’) conn.commit() def parse_data(line): 解析从Arduino接收到的数据字符串 data_dict {} try: # 示例行: “T1:23.5,T2:23.4,H:45,C:850,V:120” parts line.strip().split(‘,’) for part in parts: key, value part.split(‘:’) data_dict[key] float(value) if ‘.’ in value else int(value) return data_dict except Exception as e: print(f“解析数据出错: {e}, 原始数据: {line}”) return None while True: if ser.in_waiting 0: line ser.readline().decode(‘utf-8’).rstrip() if line: print(f“收到: {line}”) data parse_data(line) if data: # 插入数据库 cursor.execute(‘‘‘INSERT INTO sensor_data (temp_dht, temp_ds, humidity, co2, tvoc) VALUES (?, ?, ?, ?, ?)’’’, (data.get(‘T1’), data.get(‘T2’), data.get(‘H’), data.get(‘C’), data.get(‘V’))) conn.commit() time.sleep(0.1) # 短暂休眠降低CPU占用Flask Web API服务app.py:from flask import Flask, jsonify, request, send_from_directory from flask_cors import CORS import sqlite3 from datetime import datetime, timedelta app Flask(__name__) CORS(app) # 允许跨域请求方便前端调用 def get_db_connection(): conn sqlite3.connect(‘/home/pi/air_quality_monitor/data.db’, check_same_threadFalse) conn.row_factory sqlite3.Row # 以字典形式返回行 return conn app.route(‘/api/latest’) def get_latest_data(): conn get_db_connection() cursor conn.cursor() cursor.execute(‘SELECT * FROM sensor_data ORDER BY timestamp DESC LIMIT 1’) row cursor.fetchone() conn.close() if row: return jsonify(dict(row)) else: return jsonify({“error”: “No data found”}), 404 app.route(‘/api/history’) def get_history_data(): # 获取查询参数例如 ?hours24 hours request.args.get(‘hours’, default24, typeint) since_time datetime.now() - timedelta(hourshours) conn get_db_connection() cursor conn.cursor() cursor.execute(‘‘‘SELECT timestamp, temp_ds, humidity, co2, tvoc FROM sensor_data WHERE timestamp ? ORDER BY timestamp ASC’’’, (since_time,)) rows cursor.fetchall() conn.close() # 将数据组织成前端图表库如Chart.js易于处理的格式 labels [] temp_data [] hum_data [] co2_data [] tvoc_data [] for row in rows: labels.append(row[‘timestamp’]) temp_data.append(row[‘temp_ds’]) hum_data.append(row[‘humidity’]) co2_data.append(row[‘co2’]) tvoc_data.append(row[‘tvoc’]) return jsonify({ “labels”: labels, “datasets”: [ {“label”: “Temperature (°C)”, “data”: temp_data}, {“label”: “Humidity (%)”, “data”: hum_data}, {“label”: “CO2 (ppm)”, “data”: co2_data}, {“label”: “TVOC (ppb)”, “data”: tvoc_data} ] }) app.route(‘/’) def serve_frontend(): # 如果前端由Apache托管这个路由可能用不到或者重定向到Apache的地址 return send_from_directory(‘../Frontend’, ‘index.html’) if __name__ ‘__main__’: app.run(host‘0.0.0.0’, port5000, debugFalse) # 生产环境debugFalse4.3 前端可视化动态图表与实时更新前端使用HTML、CSS和JavaScript并引入Chart.js库来绘制曲线图。核心逻辑是通过JavaScript定时例如每10秒调用树莓派Flask后端提供的/api/latest和/api/history接口获取JSON数据并更新页面上的数字显示和图表。关键前端代码片段main.js:let tempChart, humChart, co2Chart; // Chart.js图表实例 async function fetchLatestData() { try { const response await fetch(‘http://你的树莓派IP:5000/api/latest’); const data await response.json(); document.getElementById(‘current-temp’).textContent data.temp_ds.toFixed(1); document.getElementById(‘current-hum’).textContent data.humidity.toFixed(0); document.getElementById(‘current-co2’).textContent data.co2; document.getElementById(‘current-tvoc’).textContent data.tvoc; // 根据CO2浓度改变颜色提示 const co2Elem document.getElementById(‘current-co2’); if(data.co2 1000) co2Elem.style.color ‘red’; else if(data.co2 800) co2Elem.style.color ‘orange’; else co2Elem.style.color ‘green’; } catch (error) { console.error(‘获取实时数据失败:’, error); } } async function updateCharts() { try { const response await fetch(‘http://你的树莓派IP:5000/api/history?hours24’); const chartData await response.json(); // 更新各个Chart.js图表的数据集 tempChart.data.labels chartData.labels; tempChart.data.datasets[0].data chartData.datasets[0].data; tempChart.update(); // … 同理更新湿度和CO2图表 } catch (error) { console.error(‘更新图表失败:’, error); } } // 页面加载完成后初始化图表并启动定时器 document.addEventListener(‘DOMContentLoaded’, function() { initCharts(); // 初始化Chart.js图表配置 fetchLatestData(); updateCharts(); setInterval(fetchLatestData, 10000); // 每10秒更新一次实时数据 setInterval(updateCharts, 60000); // 每1分钟更新一次图表 });5. 机械结构与外壳制作实践一个稳定的项目离不开坚固的“房子”。外壳不仅保护电子元件也影响着空气流通和美观。我的设计方案基于8mm MDF板激光切割主体结构设计一个无顶无底的长方体盒子。前面板开孔用于OLED屏幕顶板开孔用于安装风扇排风。后面板开孔用于电源线、USB线和DS18B20探头的引出。内部支架切割一块比底板内尺寸小一圈的副板。将Arduino UNO和树莓派用尼龙柱或螺丝固定在这块副板上。然后将副板通过更高的尼龙柱悬空固定在底板上。这样做的好处是便于布线传感器PCB“帽子”插在Arduino上其连线很短。从副板到顶板风扇和前面板OLED的线可以提前规划好长度。利于散热主板悬空空气可以在上下流通避免树莓派过热。方便维护拧下尼龙柱整个核心组件模块就可以整体取出。空气流通设计风扇作为排风扇安装将盒内空气抽出。在底板或侧板下方开设进气孔。这样外部空气从底部进入流经传感器确保CCS811能检测到新鲜空气然后被风扇从顶部排出形成被动风道。组装使用木工胶或螺丝组装MDF板。将OLED屏幕从内部用热熔胶或螺丝固定在前面板开孔处。风扇同样固定在顶板内侧。所有内部连线用扎带整理。实操心得如果没有激光切割机可以使用手锯和电钻或者选择现成的塑料防水盒进行改装。务必在焊接和测试完全结束后再进行最终组装。在副板上固定设备前先规划好所有走线并留出足够的余量。为DS18B20的探头线在壳体上设计一个带橡胶护套的穿孔避免线材被割伤。6. 系统调试与长期运维要点6.1 上电调试与问题排查按照以下顺序进行系统调试可以高效定位问题分模块测试单独给Arduino上电打开串口监视器波特率9600查看是否有格式正确的数据输出。如果没有检查传感器接线、库安装和代码。单独测试树莓派确保Python环境、Flask和SQLite工作正常。可以手动运行app.py和serial_reader.py看是否有错误输出。测试Web前端在树莓派本地浏览器打开http://localhost/airquality看页面能否加载图表是否初始化。集成联调用USB线连接Arduino和树莓派。在树莓派上使用ls /dev/tty*命令查看插入Arduino前后设备列表的变化确定串口设备名通常是/dev/ttyACM0。修改serial_reader.py中的串口设备名然后运行它观察是否能打印出解析后的数据并检查数据库文件是否在增大。启动Flask服务通过浏览器或curl命令测试/api/latest和/api/history接口是否能返回正确JSON。服务化部署按照前文创建systemd服务文件启用并启动服务。使用sudo journalctl -u airquality-serial.service -f实时查看服务日志这是排查服务问题最强大的工具。重启树莓派验证服务是否能自动启动。6.2 常见问题与解决方案速查表问题现象可能原因排查步骤与解决方案串口监视器无数据或乱码1. 波特率不匹配2. 接线错误或接触不良3. Arduino代码未上传或卡死1. 检查代码和监视器波特率是否均为9600。2. 重新插拔USB线检查Arduino指示灯是否正常。3. 重新上传一个最简单的串口打印“Hello”程序测试。树莓派Python脚本报错“权限被拒绝”访问/dev/ttyACM0当前用户如pi不在dialout组无权访问串口设备。将用户加入dialout组sudo usermod -a -G dialout pi然后注销并重新登录生效。CCS811读数长时间为0或异常高/低1. 未完成初始预热/校准。2. 基线漂移。3. I2C地址错误或接线问题。1. 确保传感器首次上电后在清洁空气中静置15-20分钟。2. 定期将设备置于通风良好处运行半天或查阅CCS811库手册进行手动基线保存/恢复。3. 使用i2cdetect -y 1命令扫描I2C总线确认地址0x5B或0x5A是否存在。网页能打开但无数据/图表不更新1. 后端API服务未运行。2. 前端JS中API地址IP和端口配置错误。3. 数据库无数据。1.sudo systemctl status检查后端服务状态。2. 浏览器按F12打开开发者工具查看“网络(Network)”标签页中API请求是否失败。3. 使用SQLite命令行工具检查sensor_data表中是否有记录。DHT22频繁读取失败1. 供电不稳特别是使用长导线时。2. 读取间隔太短。3. 传感器损坏。1. 在DHT22的VCC和GND之间并联一个100uF的电解电容。2. 确保两次读取间隔大于2秒。3. 更换传感器测试。风扇不转或无法调速1. 三极管引脚接错C, B, E。2. PWM引脚配置错误或损坏。3. 二极管方向接反。1. 确认2N2222引脚排列用万用表测量。2. 用analogWrite(pin, 255)测试风扇是否全速转动。3. 确认二极管阴极有标记的一端接电源正极。6.3 长期运行与数据维护数据管理SQLite数据库文件会随时间增长。可以编写一个简单的Python脚本定期例如每月将旧数据归档到另一个文件或者仅保留最近30天的数据在活跃数据库中。CCS811基线管理这是保证CO2测量长期准确的关键。可以设计一个功能当设备检测到被移动到户外通过GPS或手动按钮触发并稳定运行一段时间后自动将当前基线保存到EEPROM或文件中。电源管理为保证7x24小时运行建议使用树莓派官方电源或质量可靠的5V/3A电源适配器。可以考虑为整个系统配备一个小型UPS不间断电源以应对短暂停电。日志与监控利用systemd的日志功能监控服务运行状态。可以设置简单的邮件或消息通知当CO2浓度超过阈值如1200ppm时发出警报。这个项目从构思到完成最深的体会是“软硬结合”的魅力。每一个传感器数据的跳动都通过代码和电路最终转化为屏幕上直观的曲线这个过程充满了成就感。它不仅仅是一个监测工具更是一个完整的微型物联网系统的实践。你可以在此基础上无限扩展增加PM2.5传感器、连接智能插座自动打开空气净化器、将数据上传到云端进行多房间对比分析等等。希望这份详细的指南能帮你少走弯路成功打造出属于自己的“空气管家”。如果在制作过程中遇到任何问题回顾一下第六部分的排查表格大部分常见问题都能找到思路。
基于Arduino与树莓派的室内空气质量监测系统全栈开发指南
1. 项目概述打造一个看得见的“空气管家”几年前为了搞清楚家里书房在长时间工作后空气质量到底有多糟糕我萌生了动手做一个监测设备的想法。市面上成品要么功能单一要么数据封闭无法满足我实时查看、历史回溯以及自定义告警的需求。于是一个结合了Arduino的稳定采集能力和Raspberry Pi强大处理与网络能力的方案应运而生。这个项目我称之为“空气管家”它能够持续监测你所在空间的温度、湿度、二氧化碳CO2浓度以及总挥发性有机物TVOC并将这些数据通过一个简洁的网页仪表盘实时展示出来历史数据也一目了然。无论你是想优化家居环境、验证新风系统效果还是作为一个有趣的物联网入门实践这个项目都能提供从硬件焊接、软件编程到系统部署的完整路径。整个系统的核心逻辑非常清晰Arduino作为前端的“感官神经”负责与各类传感器对话采集原始数据Raspberry Pi则作为后端的“大脑”负责接收、存储这些数据并通过一个轻量级的Web服务将其可视化。两者之间通过最可靠的USB串口进行通信确保了数据传输的稳定性。接下来我将拆解每一个环节不仅告诉你“怎么做”更会分享我在搭建过程中“为什么这么做”以及踩过的那些坑。2. 核心硬件选型与电路设计解析2.1 传感器阵容为何是这“三剑客”选择传感器是项目的基石需要平衡精度、稳定性、接口复杂度和成本。我最终选定的组合是DS18B20、DHT22和CCS811它们各自承担着不可替代的角色。DS18B20数字温度传感器你可能会问既然DHT22也能测温度为什么还要单独用它核心原因在于精度与稳定性。DS18B20采用单总线协议虽然需要额外的4.7KΩ上拉电阻但其测温精度可达±0.5°C且抗干扰能力更强。在同一个项目中用DS18B20校验DHT22的温度读数可以作为一个很好的数据交叉验证手段确保关键的温度数据可靠。它的封装形式多样我选择了防水探头型方便从设备外壳中伸出更准确地测量环境温度而非板载元件产生的热干扰。DHT22温湿度传感器这是获取湿度数据的主力。虽然其温度测量功能可以作为参考但我们更依赖它的湿度读数。DHT22采用单总线通信需要另一个4.7KΩ上拉电阻。它的响应速度较慢约2秒一次但对于室内环境监测来说完全足够。一个关键注意事项是DHT22对电源电压波动比较敏感务必确保其供电稳定在3.3V或5V需查看具体型号规格否则极易读取失败或数据异常。Adafruit CCS811气体传感器这是监测空气品质的核心用于测量等效二氧化碳eCO2单位ppm和总挥发性有机物TVOC单位ppb。CCS811内部集成了微控制器和基线校准算法通过I2C接口通信。它的工作原理是检测金属氧化物半导体材料在接触目标气体时电阻的变化。这里有一个至关重要的“坑”CCS811需要定期至少每24小时一次在清洁空气户外空气或经过活性炭过滤的空气中运行至少20分钟以进行基线校准。如果长期在污染环境中运行而不重置基线其读数会逐渐漂移失准。因此在软件设计中需要考虑加入提醒或自动校准机制。2.2 主控与执行单元Arduino与树莓派的分工Arduino UNO扮演数据采集器的角色。选择它是因为其模拟和数字IO接口丰富对传感器库的支持非常成熟编程简单并且通过USB串口与上位机通信稳定可靠。它的任务周期很简单每隔几秒向各个传感器请求数据打包成一个格式化的字符串例如“TEMP:23.5,HUM:45,CO2:850,TVOC:125”然后通过Serial.println()发送出去。Raspberry Pi以Pi 3B或4B为例扮演服务器和数据处理中心的角色。它运行完整的Linux操作系统Raspberry Pi OS能够轻松部署Python后端程序和Apache Web服务器。它的任务是通过USB串口持续读取Arduino发来的数据解析后存入数据库如轻量级的SQLite同时运行一个Web后端API为前端页面提供实时和历史的JSON数据。风扇与OLED屏5V桌面小风扇和I2C OLED屏128x64属于“增值”部件。风扇的作用并非散热而是促进设备内部空气与外部环境的交换避免传感器尤其是CCS811测量的是“死区”空气使读数更能反映真实环境。OLED屏则用于本地显示关键数据在不想打开网页时快速一瞥。驱动风扇需要一个2N2222三极管或MOSFET和1N4007续流二极管构成一个简单的开关电路由Arduino的一个数字引脚通过PWM控制转速。2.3 电路搭建从面包板到PCB的进化最初的验证阶段在面包板上进行是必须的它能让你快速排查接线错误。但当所有功能验证通过后为了系统的长期稳定和美观将电路移植到PCB印刷电路板上是质的飞跃。我设计了一块兼容Arduino UNO引脚排列的“传感器扩展板”Shield。这样做的好处是集成度高所有传感器、电阻、三极管都焊接在板上仅通过排针与Arduino插接彻底告别凌乱的杜邦线。可靠性强焊接连接远比插接牢固避免了因震动或移动导致的接触不良。便于安装可以将PCB直接固定在设备外壳的底板上结构整洁。电路连接要点与避坑指南DS18B20VCC接5VGND接GNDDQ数据线接数字引脚如D2同时DQ和VCC之间接一个4.7KΩ上拉电阻。DHT22VCC接3.3V或5V按型号GND接GNDDATA接数字引脚如D3同样DATA和VCC之间接4.7KΩ上拉电阻。CCS811VCC接3.3V特别注意多数CCS811模块是3.3V逻辑接5V会损坏GND接GNDSCL接A5SDA接A4Arduino UNO的I2C固定引脚。OLED同样是I2C设备VCC接3.3V或5V看模块支持GND接GNDSCL接A5SDA接A4。这里有个关键点多个I2C设备可以共享SCL和SDA线但每个设备必须有唯一的I2C地址。CCS811的默认地址是0x5A常见的OLED地址是0x3C它们互不冲突可以并联在同一组I2C总线上。风扇驱动电路这是一个经典的三极管开关电路。风扇正极接电源5V负极接三极管集电极C。三极管发射极E接GND。基极B通过一个220Ω的限流电阻连接到Arduino的一个PWM引脚如D9。1N4007二极管并联在风扇两端阴极接5V正极阳极接三极管集电极用于吸收风扇电机停止时产生的反向电动势保护三极管。注意焊接PCB时务必先焊接高度最低的元件如电阻再焊接较高的元件如传感器插座。为CCS811和DHT22使用排母插座而不是直接焊接这样方便日后更换或维修传感器。3. 软件架构与树莓派系统配置3.1 通信协议简单可靠的串口对话Arduino与树莓派之间采用USB虚拟串口通信这是最简单、最稳定的方式。你只需要一根普通的USB A to B方口线打印机线连接两者。在代码层面Arduino使用Serial对象树莓派上则可以通过Python的pyserial库来访问对应的串口设备通常是/dev/ttyACM0或/dev/ttyUSB0。我定义的通信协议是纯文本字符串以换行符\n结尾。例如T:23.41,H:45.20,C:812,V:112\n这种格式易于人类阅读和调试也便于Python后端用split()方法快速解析。为了确保数据完整性可以在每帧数据中加入简单的校验和或者约定固定的数据顺序。3.2 树莓派环境搭建从系统到服务首先使用Raspberry Pi Imager工具将Raspberry Pi OS推荐Lite版本以节省资源刷入Micro SD卡并完成基础系统设置网络、SSH、用户密码等。1. 必备软件安装sudo apt update sudo apt upgrade -y sudo apt install python3-pip apache2 sqlite3 -y2. 项目代码与Python依赖将项目代码包含前端HTML/CSS/JS、后端Python脚本克隆或上传到树莓派的用户目录下例如/home/pi/air_quality_monitor。 进入后端代码目录安装所需的Python包。requirements.txt文件可能包含pyserial flask flask-cors sqlite3安装命令pip3 install -r requirements.txt3. 配置Apache2托管前端默认情况下Apache的网页根目录是/var/www/html。我们可以修改配置让其指向我们的前端代码目录或者更简单的方式是创建一个软链接。# 备份原始页面 sudo mv /var/www/html/index.html /var/www/html/index.html.bak # 将我们的前端文件夹链接到Apache根目录 sudo ln -s /home/pi/air_quality_monitor/Frontend /var/www/html/airquality这样通过浏览器访问http://树莓派IP地址/airquality就能看到前端页面了。4. 创建系统服务关键步骤为了让后端数据采集程序和Web API服务在树莓派开机后自动运行并在崩溃后自动重启我们需要将其配置为systemd服务。创建后端服务文件sudo nano /etc/systemd/system/airquality-backend.service写入以下内容请根据实际路径修改[Unit] DescriptionAir Quality Monitor Backend Service Afternetwork.target [Service] Typesimple Userpi WorkingDirectory/home/pi/air_quality_monitor/Backend ExecStart/usr/bin/python3 /home/pi/air_quality_monitor/Backend/app.py Restarton-failure RestartSec5s StandardOutputjournal StandardErrorjournal [Install] WantedBymulti-user.target创建串口数据读取服务假设为serial_reader.pysudo nano /etc/systemd/system/airquality-serial.service内容类似只需修改Description和ExecStart的路径。启用并启动服务sudo systemctl daemon-reload sudo systemctl enable airquality-backend.service sudo systemctl enable airquality-serial.service sudo systemctl start airquality-backend.service sudo systemctl start airquality-serial.service使用sudo systemctl status airquality-backend.service检查服务状态看到“active (running)”即表示成功。实操心得使用systemd服务管理是生产级部署的关键。它比在rc.local或crontab里启动更专业提供了完善的日志通过journalctl -u 服务名查看、依赖管理和进程监控。务必注意WorkingDirectory的设置这能避免脚本因相对路径问题找不到文件。4. 核心代码逻辑剖析4.1 Arduino端稳定采集与数据发送Arduino的代码.ino文件结构清晰主要包含库引入、引脚定义、传感器初始化、主循环。#include Wire.h #include Adafruit_CCS811.h #include DHT.h #include OneWire.h #include DallasTemperature.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h // 引脚定义 #define DHTPIN 3 #define ONE_WIRE_BUS 2 #define FAN_PIN 9 #define OLED_RESET -1 // 传感器对象初始化 DHT dht(DHTPIN, DHT22); OneWire oneWire(ONE_WIRE_BUS); DallasTemperature ds18b20(oneWire); Adafruit_CCS811 ccs; Adafruit_SSD1306 display(128, 64, Wire, OLED_RESET); void setup() { Serial.begin(9600); // 初始化串口与树莓派通信 pinMode(FAN_PIN, OUTPUT); analogWrite(FAN_PIN, 128); // 风扇以50%转速启动 // 初始化传感器 dht.begin(); ds18b20.begin(); if(!ccs.begin()){ Serial.println(“CCS811 init failed!”); while(1); } while(!ccs.available()); // 等待CCS811校准完成 // 初始化OLED if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F(“SSD1306 allocation failed”)); for(;;); } display.clearDisplay(); } void loop() { // 读取DHT22湿度和温度 float h dht.readHumidity(); float t_dht dht.readTemperature(); // 读取DS18B20温度 ds18b20.requestTemperatures(); float t_ds ds18b20.getTempCByIndex(0); // 读取CCS811 if(ccs.available()){ if(!ccs.readData()){ // 如果读取成功 float co2 ccs.geteCO2(); float tvoc ccs.getTVOC(); // 打包数据字符串 String data “T1:” String(t_dht, 1) “,T2:” String(t_ds, 1) “,H:” String(h, 0) “,C:” String(co2, 0) “,V:” String(tvoc, 0); Serial.println(data); // 发送数据 // 更新OLED显示 display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); display.setCursor(0,0); display.print(“T:”); display.print(t_ds,1); display.println(“C”); display.print(“H:”); display.print(h,0); display.println(“%”); display.print(“CO2:”); display.print(co2,0); display.println(“ppm”); display.print(“TVOC:”); display.print(tvoc,0); display.println(“ppb”); display.display(); } } delay(5000); // 每5秒采集一次 }代码要点我为两个温度传感器赋予了不同的前缀T1, T2方便后端区分和对比。风扇使用PWM控制analogWrite(FAN_PIN, 128)对应约50%占空比可以在代码中根据CO2浓度动态调整风扇转速实现简单的联动控制。CCS811的readData()函数返回0表示成功非0表示错误或数据未就绪。串口波特率设置为9600这是一个在稳定性和速度间平衡的常用值。4.2 树莓派后端数据接收、存储与API提供树莓派上的Python后端主要包含两个部分串口读取进程/服务以及Flask Web API服务。这里可以将它们写在一个多线程程序里或者拆分成两个独立服务更推荐耦合度低。串口读取与数据库写入serial_reader.py:import serial import sqlite3 import time from datetime import datetime # 配置串口端口名可能需要根据实际情况调整 ser serial.Serial(‘/dev/ttyACM0’, 9600, timeout1) # 连接SQLite数据库 conn sqlite3.connect(‘/home/pi/air_quality_monitor/data.db’, check_same_threadFalse) cursor conn.cursor() # 创建数据表如果不存在 cursor.execute(‘‘‘CREATE TABLE IF NOT EXISTS sensor_data (id INTEGER PRIMARY KEY AUTOINCREMENT, timestamp DATETIME DEFAULT CURRENT_TIMESTAMP, temp_dht REAL, temp_ds REAL, humidity REAL, co2 INTEGER, tvoc INTEGER)’’’) conn.commit() def parse_data(line): 解析从Arduino接收到的数据字符串 data_dict {} try: # 示例行: “T1:23.5,T2:23.4,H:45,C:850,V:120” parts line.strip().split(‘,’) for part in parts: key, value part.split(‘:’) data_dict[key] float(value) if ‘.’ in value else int(value) return data_dict except Exception as e: print(f“解析数据出错: {e}, 原始数据: {line}”) return None while True: if ser.in_waiting 0: line ser.readline().decode(‘utf-8’).rstrip() if line: print(f“收到: {line}”) data parse_data(line) if data: # 插入数据库 cursor.execute(‘‘‘INSERT INTO sensor_data (temp_dht, temp_ds, humidity, co2, tvoc) VALUES (?, ?, ?, ?, ?)’’’, (data.get(‘T1’), data.get(‘T2’), data.get(‘H’), data.get(‘C’), data.get(‘V’))) conn.commit() time.sleep(0.1) # 短暂休眠降低CPU占用Flask Web API服务app.py:from flask import Flask, jsonify, request, send_from_directory from flask_cors import CORS import sqlite3 from datetime import datetime, timedelta app Flask(__name__) CORS(app) # 允许跨域请求方便前端调用 def get_db_connection(): conn sqlite3.connect(‘/home/pi/air_quality_monitor/data.db’, check_same_threadFalse) conn.row_factory sqlite3.Row # 以字典形式返回行 return conn app.route(‘/api/latest’) def get_latest_data(): conn get_db_connection() cursor conn.cursor() cursor.execute(‘SELECT * FROM sensor_data ORDER BY timestamp DESC LIMIT 1’) row cursor.fetchone() conn.close() if row: return jsonify(dict(row)) else: return jsonify({“error”: “No data found”}), 404 app.route(‘/api/history’) def get_history_data(): # 获取查询参数例如 ?hours24 hours request.args.get(‘hours’, default24, typeint) since_time datetime.now() - timedelta(hourshours) conn get_db_connection() cursor conn.cursor() cursor.execute(‘‘‘SELECT timestamp, temp_ds, humidity, co2, tvoc FROM sensor_data WHERE timestamp ? ORDER BY timestamp ASC’’’, (since_time,)) rows cursor.fetchall() conn.close() # 将数据组织成前端图表库如Chart.js易于处理的格式 labels [] temp_data [] hum_data [] co2_data [] tvoc_data [] for row in rows: labels.append(row[‘timestamp’]) temp_data.append(row[‘temp_ds’]) hum_data.append(row[‘humidity’]) co2_data.append(row[‘co2’]) tvoc_data.append(row[‘tvoc’]) return jsonify({ “labels”: labels, “datasets”: [ {“label”: “Temperature (°C)”, “data”: temp_data}, {“label”: “Humidity (%)”, “data”: hum_data}, {“label”: “CO2 (ppm)”, “data”: co2_data}, {“label”: “TVOC (ppb)”, “data”: tvoc_data} ] }) app.route(‘/’) def serve_frontend(): # 如果前端由Apache托管这个路由可能用不到或者重定向到Apache的地址 return send_from_directory(‘../Frontend’, ‘index.html’) if __name__ ‘__main__’: app.run(host‘0.0.0.0’, port5000, debugFalse) # 生产环境debugFalse4.3 前端可视化动态图表与实时更新前端使用HTML、CSS和JavaScript并引入Chart.js库来绘制曲线图。核心逻辑是通过JavaScript定时例如每10秒调用树莓派Flask后端提供的/api/latest和/api/history接口获取JSON数据并更新页面上的数字显示和图表。关键前端代码片段main.js:let tempChart, humChart, co2Chart; // Chart.js图表实例 async function fetchLatestData() { try { const response await fetch(‘http://你的树莓派IP:5000/api/latest’); const data await response.json(); document.getElementById(‘current-temp’).textContent data.temp_ds.toFixed(1); document.getElementById(‘current-hum’).textContent data.humidity.toFixed(0); document.getElementById(‘current-co2’).textContent data.co2; document.getElementById(‘current-tvoc’).textContent data.tvoc; // 根据CO2浓度改变颜色提示 const co2Elem document.getElementById(‘current-co2’); if(data.co2 1000) co2Elem.style.color ‘red’; else if(data.co2 800) co2Elem.style.color ‘orange’; else co2Elem.style.color ‘green’; } catch (error) { console.error(‘获取实时数据失败:’, error); } } async function updateCharts() { try { const response await fetch(‘http://你的树莓派IP:5000/api/history?hours24’); const chartData await response.json(); // 更新各个Chart.js图表的数据集 tempChart.data.labels chartData.labels; tempChart.data.datasets[0].data chartData.datasets[0].data; tempChart.update(); // … 同理更新湿度和CO2图表 } catch (error) { console.error(‘更新图表失败:’, error); } } // 页面加载完成后初始化图表并启动定时器 document.addEventListener(‘DOMContentLoaded’, function() { initCharts(); // 初始化Chart.js图表配置 fetchLatestData(); updateCharts(); setInterval(fetchLatestData, 10000); // 每10秒更新一次实时数据 setInterval(updateCharts, 60000); // 每1分钟更新一次图表 });5. 机械结构与外壳制作实践一个稳定的项目离不开坚固的“房子”。外壳不仅保护电子元件也影响着空气流通和美观。我的设计方案基于8mm MDF板激光切割主体结构设计一个无顶无底的长方体盒子。前面板开孔用于OLED屏幕顶板开孔用于安装风扇排风。后面板开孔用于电源线、USB线和DS18B20探头的引出。内部支架切割一块比底板内尺寸小一圈的副板。将Arduino UNO和树莓派用尼龙柱或螺丝固定在这块副板上。然后将副板通过更高的尼龙柱悬空固定在底板上。这样做的好处是便于布线传感器PCB“帽子”插在Arduino上其连线很短。从副板到顶板风扇和前面板OLED的线可以提前规划好长度。利于散热主板悬空空气可以在上下流通避免树莓派过热。方便维护拧下尼龙柱整个核心组件模块就可以整体取出。空气流通设计风扇作为排风扇安装将盒内空气抽出。在底板或侧板下方开设进气孔。这样外部空气从底部进入流经传感器确保CCS811能检测到新鲜空气然后被风扇从顶部排出形成被动风道。组装使用木工胶或螺丝组装MDF板。将OLED屏幕从内部用热熔胶或螺丝固定在前面板开孔处。风扇同样固定在顶板内侧。所有内部连线用扎带整理。实操心得如果没有激光切割机可以使用手锯和电钻或者选择现成的塑料防水盒进行改装。务必在焊接和测试完全结束后再进行最终组装。在副板上固定设备前先规划好所有走线并留出足够的余量。为DS18B20的探头线在壳体上设计一个带橡胶护套的穿孔避免线材被割伤。6. 系统调试与长期运维要点6.1 上电调试与问题排查按照以下顺序进行系统调试可以高效定位问题分模块测试单独给Arduino上电打开串口监视器波特率9600查看是否有格式正确的数据输出。如果没有检查传感器接线、库安装和代码。单独测试树莓派确保Python环境、Flask和SQLite工作正常。可以手动运行app.py和serial_reader.py看是否有错误输出。测试Web前端在树莓派本地浏览器打开http://localhost/airquality看页面能否加载图表是否初始化。集成联调用USB线连接Arduino和树莓派。在树莓派上使用ls /dev/tty*命令查看插入Arduino前后设备列表的变化确定串口设备名通常是/dev/ttyACM0。修改serial_reader.py中的串口设备名然后运行它观察是否能打印出解析后的数据并检查数据库文件是否在增大。启动Flask服务通过浏览器或curl命令测试/api/latest和/api/history接口是否能返回正确JSON。服务化部署按照前文创建systemd服务文件启用并启动服务。使用sudo journalctl -u airquality-serial.service -f实时查看服务日志这是排查服务问题最强大的工具。重启树莓派验证服务是否能自动启动。6.2 常见问题与解决方案速查表问题现象可能原因排查步骤与解决方案串口监视器无数据或乱码1. 波特率不匹配2. 接线错误或接触不良3. Arduino代码未上传或卡死1. 检查代码和监视器波特率是否均为9600。2. 重新插拔USB线检查Arduino指示灯是否正常。3. 重新上传一个最简单的串口打印“Hello”程序测试。树莓派Python脚本报错“权限被拒绝”访问/dev/ttyACM0当前用户如pi不在dialout组无权访问串口设备。将用户加入dialout组sudo usermod -a -G dialout pi然后注销并重新登录生效。CCS811读数长时间为0或异常高/低1. 未完成初始预热/校准。2. 基线漂移。3. I2C地址错误或接线问题。1. 确保传感器首次上电后在清洁空气中静置15-20分钟。2. 定期将设备置于通风良好处运行半天或查阅CCS811库手册进行手动基线保存/恢复。3. 使用i2cdetect -y 1命令扫描I2C总线确认地址0x5B或0x5A是否存在。网页能打开但无数据/图表不更新1. 后端API服务未运行。2. 前端JS中API地址IP和端口配置错误。3. 数据库无数据。1.sudo systemctl status检查后端服务状态。2. 浏览器按F12打开开发者工具查看“网络(Network)”标签页中API请求是否失败。3. 使用SQLite命令行工具检查sensor_data表中是否有记录。DHT22频繁读取失败1. 供电不稳特别是使用长导线时。2. 读取间隔太短。3. 传感器损坏。1. 在DHT22的VCC和GND之间并联一个100uF的电解电容。2. 确保两次读取间隔大于2秒。3. 更换传感器测试。风扇不转或无法调速1. 三极管引脚接错C, B, E。2. PWM引脚配置错误或损坏。3. 二极管方向接反。1. 确认2N2222引脚排列用万用表测量。2. 用analogWrite(pin, 255)测试风扇是否全速转动。3. 确认二极管阴极有标记的一端接电源正极。6.3 长期运行与数据维护数据管理SQLite数据库文件会随时间增长。可以编写一个简单的Python脚本定期例如每月将旧数据归档到另一个文件或者仅保留最近30天的数据在活跃数据库中。CCS811基线管理这是保证CO2测量长期准确的关键。可以设计一个功能当设备检测到被移动到户外通过GPS或手动按钮触发并稳定运行一段时间后自动将当前基线保存到EEPROM或文件中。电源管理为保证7x24小时运行建议使用树莓派官方电源或质量可靠的5V/3A电源适配器。可以考虑为整个系统配备一个小型UPS不间断电源以应对短暂停电。日志与监控利用systemd的日志功能监控服务运行状态。可以设置简单的邮件或消息通知当CO2浓度超过阈值如1200ppm时发出警报。这个项目从构思到完成最深的体会是“软硬结合”的魅力。每一个传感器数据的跳动都通过代码和电路最终转化为屏幕上直观的曲线这个过程充满了成就感。它不仅仅是一个监测工具更是一个完整的微型物联网系统的实践。你可以在此基础上无限扩展增加PM2.5传感器、连接智能插座自动打开空气净化器、将数据上传到云端进行多房间对比分析等等。希望这份详细的指南能帮你少走弯路成功打造出属于自己的“空气管家”。如果在制作过程中遇到任何问题回顾一下第六部分的排查表格大部分常见问题都能找到思路。
