1. 项目概述与核心价值最近几年空气质量成了大家日常闲聊里绕不开的话题。特别是对于我这种经常需要跑工地、或者喜欢周末去郊区露营的人来说光看手机上的城市整体PM2.5数据总觉得心里没底。市面上的专业检测仪要么太贵要么体积庞大不便携而几十块钱的“玩具级”产品数据准不准又是个大问题。于是我就琢磨着自己动手做一个核心要求是准、小、省、能联网。准是底线小是为了能揣兜里省是为了续航能联网则是为了把数据存下来或者远程查看。经过一番选型和折腾我最终用DFRobot的FireBeetle ESP32开发板作为核心搭配攀藤的PMS5003激光粉尘传感器和Sensirion的SGP30气体传感器成功攒出了一个巴掌大小、续航超过24小时、数据相对可靠的便携式空气质量检测仪。它不仅能实时显示PM2.5、PM10、CO2等效浓度和TVOC总挥发性有机物数据还能通过Wi-Fi把数据上传到我自己的服务器生成历史曲线。整个项目的硬件成本可以控制在200元以内软件部分完全开源。如果你对物联网DIY感兴趣或者单纯想拥有一个属于自己的、数据透明的空气检测工具那这个项目会非常适合你。接下来我就把从硬件选型、电路连接、代码编写到外壳设计的完整过程以及我踩过的那些坑毫无保留地分享出来。2. 硬件选型与设计思路拆解做一个检测仪硬件是骨架选型决定了项目的上限和下限。我的核心思路是主控要足够强大且低功耗传感器要成熟稳定供电要灵活整体要便于集成。2.1 核心主控为什么是FireBeetle ESP32主控芯片的选择我纠结了很久。常见的方案有Arduino Uno Wi-Fi模块、NodeMCU ESP8266和ESP32。最终选择DFRobot的FireBeetle ESP32开发板是基于以下几个硬核考量性能与功耗的黄金平衡ESP32是双核处理器主频高达240MHz远超ESP8266。这意味着在处理多个传感器数据、运行复杂的算法比如校准、以及维持Wi-Fi连接的同时仍有充足算力。更重要的是FireBeetle系列针对低功耗做了深度优化在深度睡眠模式下电流可以降到10μA级别这对于依赖电池供电的便携设备是决定性优势。丰富的接口与集成度ESP32本身集成了Wi-Fi和蓝牙FireBeetle板子将其引出并配备了锂电池充电管理芯片TP4056和3.3V稳压电路。这意味着我只需要接上一块常见的3.7V锂电池就能解决供电和充电问题无需额外的充电模块极大简化了电路设计。小巧的体型FireBeetle ESP32板子的尺寸非常迷你比一张名片还小为打造紧凑的最终产品奠定了基础。良好的生态与稳定性DFRobot的产品文档和社区支持比较完善ESP32在Arduino和MicroPython生态中的支持也极其成熟遇到问题容易找到解决方案。注意市面上ESP32开发板型号繁多有些便宜的板子电源设计有缺陷在连接某些传感器时可能导致电压不稳重启。选择FireBeetle这类品牌板多花一点钱换来的是开发过程的省心和最终产品的稳定。2.2 传感器组合精准与全面的博弈空气质量参数很多我选择了两个传感器来覆盖最关键、最受关注的指标。攀藤 PMS5003悬浮颗粒物的“金标准”之一这是项目的核心传感器用于检测PM1.0、PM2.5、PM10。它采用激光散射原理内部有风扇主动吸气数据准确性在消费级传感器中口碑很好。选择它而不是更便宜的GP2Y1014AU0F灰尘传感器的原因很简单PMS5003输出的是经过内部算法处理后的直接质量浓度值μg/m³而后者输出的是电压值需要自己建立复杂的、且受环境湿度影响极大的粉尘模型来换算精度无法保证。PMS5003通过串口UART通信使用简单数据可靠。Sensirion SGP30气体污染的综合指标这个传感器用于检测CO2等效浓度eCO2和总挥发性有机物TVOC。它并不是直接测量CO2而是通过检测多种VOC气体利用算法计算出等效的CO2浓度这对于判断室内空气新鲜度、人员密集程度非常有参考价值。TVOC指标则直接反映了有机污染物的总体水平。SGP30采用I2C接口体积小巧功耗低且内置了温湿度补偿算法虽然它本身不测温湿度但算法需要温湿度输入我们需要额外提供。为什么不直接上真正的CO2传感器如MH-Z19B原因有三成本真CO2传感器贵数倍、功耗通常更高、体积更大。对于便携式设备SGP30提供的eCO2趋势监测已经足够满足“空气憋闷感”的预警需求。必要的辅助传感器SHT30为了给SGP30提供准确的温湿度数据进行补偿同时也能监测环境温湿度我增加了一个Sensirion SHT30温湿度传感器。它同样是I2C接口精度高响应快与SGP30是“官配搭档”。2.3 供电与显示方案供电采用一块常见的3.7V、1000mAh的锂电池通过FireBeetle板载的Micro USB口充电。板载的稳压电路能提供稳定的3.3V给整个系统。显示为了便携和实时查看我选择了一块0.96英寸的OLED显示屏SSD1306驱动I2C接口。它功耗极低显示对比度高即使在户外也能看清。交互考虑到便携设备按键不宜过多我只保留了一个按键用于切换显示页面和开关屏幕背光省电。2.4 整体系统框图整个系统的数据流和电力流可以这样理解锂电池供电给FireBeetle ESP32ESP32作为大脑通过UART读取PMS5003的颗粒物数据通过I2C总线读取SGP30和SHT30的数据处理后将结果实时显示在OLED屏幕上并定期通过Wi-Fi上传到网络服务器。3. 电路连接与焊接实操要点硬件连接是“从图纸到实物”的关键一步接线错误轻则数据不准重则烧毁元件。以下是详细的连接表和实操心得。3.1 各模块与FireBeetle ESP32引脚连接表模块引脚/接口连接至 FireBeetle ESP32备注PMS5003VCC3.3V绝对禁止接5V会烧毁传感器。GNDGNDRXIO16 (U2RX)接ESP32的TXTXIO17 (U2TX)接ESP32的RXSGP30VCC3.3VGNDGNDSCLIO22 (I2C SCL)SDAIO21 (I2C SDA)SHT30VCC3.3V可与SGP30共用电源线GNDGNDSCLIO22 (I2C SCL)与SGP30并联SDAIO21 (I2C SDA)与SGP30并联OLED (SSD1306)VCC3.3VGNDGNDSCLIO22 (I2C SCL)与SGP30、SHT30并联SDAIO21 (I2C SDA)与SGP30、SHT30并联按键一端IO15内部上拉默认高电平另一端GND按下时接地变为低电平锂电池BATFireBeetle板载接口-BAT-3.2 焊接与组装避坑指南先测试后焊接强烈建议先用杜邦线把所有模块连接起来上传基础测试代码确保每个传感器都能正常读数、显示正常后再进行焊接。这能避免因接线错误导致的反复拆焊损伤焊盘。I2C地址冲突SGP30、SHT30和OLED默认的I2C地址各不相同SGP30: 0x58, SHT30: 0x44, SSD1306: 0x3C所以它们可以安全地并联在同一条I2C总线上无需担心地址冲突。这是最简洁的连接方式。电源去耦在PMS5003的VCC和GND之间尽量靠近传感器引脚的地方焊接一个10μF的电解电容和一个0.1μF的陶瓷电容。这是因为PMS5003内部风扇启动瞬间电流较大可能引起电源电压的微小跌落导致ESP32重启。加上去耦电容可以平滑电压极大提高系统稳定性。这是我踩过的一个大坑不加电容时系统会随机重启。线序与接口PMS5003的串口线序一定要核对清楚。它的接口是PH2.0-8P的通常配套线缆的颜色顺序可能不标准。务必用万用表测量或对照说明书确认VCC、GND、TX、RX。接反VCC和GND会瞬间烧毁传感器。静电防护SGP30和SHT30这类金属封装的传感器对静电比较敏感。焊接时确保电烙铁接地良好操作前可以触摸一下接地的金属物体释放静电。4. 软件代码编写与核心逻辑解析硬件搭好了接下来就是赋予它灵魂的软件部分。我使用Arduino IDE进行开发因为其生态丰富库管理方便。4.1 库文件准备首先在Arduino IDE的库管理中安装以下必需的库Adafruit_GFXAdafruit_SSD1306用于驱动OLED显示屏。SparkFun_SGP30_Arduino_Library用于驱动SGP30传感器。Adafruit_SHT31用于驱动SHT30传感器。PMSLibrary用于解析PMS5003的串口数据。这里推荐#include PMS.h这个库它封装得很好。WiFiHTTPClientESP32内置用于网络连接和数据上传。ArduinoJson用于构建要上传的JSON格式数据包。4.2 主程序框架与关键函数程序的核心逻辑是一个状态机循环主要包括初始化、数据读取、数据处理、显示和上传。#include Wire.h #include Adafruit_GFX.h #include Adafruit_SSD1306.h #include PMS.h #include SparkFun_SGP30_Arduino_Library.h #include Adafruit_SHT31.h #include WiFi.h #include HTTPClient.h #include ArduinoJson.h // 定义引脚和对象 #define PMS_RX 16 #define PMS_TX 17 #define BUTTON_PIN 15 #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 PMS pms(Serial2); // 使用ESP32的第二个硬件串口 PMS::DATA data; SGP30 sgp; Adafruit_SHT31 sht31 Adafruit_SHT31(); Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire, -1); // Wi-Fi和服务器配置 const char* ssid Your_SSID; const char* password Your_PASSWORD; const char* serverUrl http://your-server.com/api/air-data; // 全局变量 int displayPage 0; // 显示页面索引 bool screenOn true; unsigned long lastReadTime 0; const long readInterval 2000; // 读取传感器间隔2秒 unsigned long lastUploadTime 0; const long uploadInterval 60000; // 上传数据间隔60秒 void setup() { Serial.begin(115200); Serial2.begin(9600, SERIAL_8N1, PMS_RX, PMS_TX); // 初始化PMS5003串口 Wire.begin(); // 初始化OLED if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F(SSD1306 allocation failed)); for(;;); } display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); // 初始化SGP30 if (sgp.begin() false) { Serial.println(SGP30 not found.); while (1); } sgp.initAirQuality(); // 初始化SHT31 if (!sht31.begin(0x44)) { Serial.println(SHT31 not found.); while (1); } // 连接Wi-Fi WiFi.begin(ssid, password); display.setCursor(0,0); display.print(Connecting WiFi); display.display(); while (WiFi.status() ! WL_CONNECTED) { delay(500); display.print(.); display.display(); } display.clearDisplay(); display.setCursor(0,0); display.println(WiFi Connected!); display.display(); delay(1000); pinMode(BUTTON_PIN, INPUT_PULLUP); // 按键上拉输入 } void loop() { unsigned long currentMillis millis(); // 按键处理防抖和页面切换 if(digitalRead(BUTTON_PIN) LOW) { delay(50); // 简单防抖 if(digitalRead(BUTTON_PIN) LOW) { displayPage (displayPage 1) % 3; // 假设有3个显示页面 while(digitalRead(BUTTON_PIN) LOW); // 等待按键释放 } } // 定时读取传感器 if (currentMillis - lastReadTime readInterval) { lastReadTime currentMillis; readSensors(); updateDisplay(); } // 定时上传数据 if (currentMillis - lastUploadTime uploadInterval) { lastUploadTime currentMillis; uploadData(); } }4.3 传感器数据读取函数详解readSensors()函数是数据准确性的核心。void readSensors() { // 1. 读取PMS5003数据 if (pms.read(data)) { // data.PM_AE_UG_1_0, data.PM_AE_UG_2_5, data.PM_AE_UG_10_0 即为所需值 // 这里可以添加简单的滑动平均滤波减少显示数值的跳动 } // 2. 读取SHT30获取温湿度用于补偿 float temperature sht31.readTemperature(); float humidity sht31.readHumidity(); if (!isnan(temperature) !isnan(humidity)) { // 3. 设置补偿并读取SGP30 sgp.setHumidity(getAbsoluteHumidity(temperature, humidity)); // 需要计算绝对湿度 if (sgp.measureAirQuality()) { // sgp.CO2 和 sgp.TVOC 即为所需值 } } } // 根据温度和相对湿度计算绝对湿度g/m³供SGP30补偿使用 uint32_t getAbsoluteHumidity(float temperature, float humidity) { // 近似计算公式Sensirion官方推荐 const float absoluteHumidity 216.7f * ((humidity / 100.0f) * 6.112f * exp((17.62f * temperature) / (243.12f temperature)) / (273.15f temperature)); return (uint32_t)(absoluteHumidity * 1000.0f); // 转换为毫克每立方米 }关键点SGP30的补偿必须使用绝对湿度而不是相对湿度。上述getAbsoluteHumidity函数实现了这个转换。补偿后的eCO2和TVOC读数会准确得多尤其是在温湿度变化大的环境下。4.4 数据显示与上传逻辑updateDisplay()函数根据displayPage变量切换显示内容例如第0页显示PM2.5和PM10第1页显示eCO2和TVOC第2页显示温度和湿度。使用Adafruit_GFX库的绘图和文本函数可以灵活地设计界面。uploadData()函数负责将数据打包成JSON并POST到服务器。void uploadData() { if (WiFi.status() ! WL_CONNECTED) { return; // Wi-Fi断开时不尝试上传 } HTTPClient http; http.begin(serverUrl); http.addHeader(Content-Type, application/json); // 构建JSON文档 StaticJsonDocument200 doc; doc[pm25] data.PM_AE_UG_2_5; doc[pm10] data.PM_AE_UG_10_0; doc[eco2] sgp.CO2; doc[tvoc] sgp.TVOC; doc[temp] temperature; doc[humi] humidity; String jsonString; serializeJson(doc, jsonString); int httpResponseCode http.POST(jsonString); if (httpResponseCode 0) { Serial.printf(Upload success, code: %d\n, httpResponseCode); } else { Serial.printf(Upload failed, error: %s\n, http.errorToString(httpResponseCode).c_str()); } http.end(); }5. 外壳设计与3D打印为了让这个检测仪真正“便携”且耐用一个定制的外壳必不可少。我使用Fusion 360进行建模然后3D打印。设计要点紧凑布局内部根据PCB和传感器尺寸精确开槽确保各部件卡紧避免晃动。PMS5003的进气口和出气口要在外壳上留出风道确保空气流通这是测量准确的前提。屏幕开窗与按键孔为OLED屏幕设计透明亚克力盖板槽用卡扣或胶水固定。为按键预留孔位可以设计一个稍大的孔然后粘贴一个硅胶按键帽手感更好。传感器保护PMS5003的激光镜头部分要避免直射强光外壳上进气口可以设计成迷宫状既能防尘也能避免杂光干扰。电池仓设计一个可滑动打开的电池仓方便更换电池。打印建议使用PLA材料即可层高0.2mm填充率15%-20%。外壳最好分成上盖和下盖用螺丝固定。可以在螺丝柱位置设计沉孔让螺丝头不凸出。6. 校准、测试与常见问题排查硬件软件都齐备了但要让数据可信校准和测试是关键的最后一步。6.1 传感器预热与基线校准SGP30的基线校准SGP30需要一段时间的“预热”和“学习”才能输出稳定的eCO2基线值。官方建议在设备首次使用或长时间断电后在空气流通良好的室外环境下连续运行12小时。程序可以记录下最后稳定的eCO2基线值通常在400-450 ppm和TVOC基线值并保存到ESP32的EEPROM或Preferences中。下次上电时直接调用可以缩短稳定时间。我的代码里添加了这部分逻辑如果检测到是首次运行会进入一个12小时的校准模式期间屏幕提示“校准中”数据不上传。PMS5003的零点确认在洁净的空气环境中比如开启空气净化器一段时间后的室内PMS5003的PM2.5和PM10读数应该接近0。如果出现个位数的正负值如-3, 5这是正常的传感器噪声。可以在代码中设置一个阈值例如读数小于5μg/m³时视为0避免显示无意义的微小负值或正值。6.2 常见问题与解决方案速查表问题现象可能原因排查步骤与解决方案上电后OLED不亮1. 电源未接通或电压不足2. I2C地址错误或接线错误3. 屏幕本身损坏1. 检查3.3V和GND连接用万用表测量电压。2. 运行I2C扫描程序确认屏幕上显示的地址是否为0x3C。3. 更换屏幕测试。PMS5003数据全为01. 串口引脚接反RX/TX2. 波特率设置错误3. 传感器未启动风扇不转1. 交换RX和TX连接线。2. 确认代码中Serial2.begin(9600)与传感器匹配。3. 听是否有风扇声摸传感器是否微热。无则检查VCC供电。SGP30读数异常如eCO2始终为4001. I2C通信失败2. 未进行initAirQuality()3. 未提供温湿度补偿1. I2C扫描确认0x58地址存在。2. 确保在setup()中调用了sgp.initAirQuality()。3. 确保在每次测量前都正确设置了绝对湿度补偿。Wi-Fi连接不稳定频繁断开1. 信号弱2. ESP32深度睡眠唤醒后Wi-Fi重连问题3. 电源干扰1. 检查路由器距离代码中可增加Wi-Fi重连机制。2. 如果不是必须避免使用深度睡眠改用轻度休眠。3. 在ESP32的3.3V引脚附近增加一个100μF的电解电容。设备运行一段时间后自动重启1. 电源问题PMS5003风扇启动电流冲击2. 看门狗超时程序卡死3. 内存泄漏1.这是最常见原因务必在PMS5003电源引脚附近添加前述的去耦电容。2. 检查循环中是否有阻塞过久的操作如长延时改用非阻塞式时间判断。3. 检查动态内存分配尽量使用静态变量。上传服务器失败1. 网络未连接2. 服务器地址或端口错误3. JSON格式错误1. 检查WiFi.status()。2. 用电脑浏览器或Postman测试服务器接口是否正常。3. 打印出要上传的jsonString检查格式是否正确。6.3 数据对比与验证为了验证自制设备的准确性我将其与一台经过计量校准的商业检测仪价格数千元在室内多个点位进行了对比测试。结果显示在PM2.5浓度范围0-150μg/m³内自制设备的读数与商业仪器的偏差基本在±10%以内eCO2的趋势也基本一致。对于DIY项目来说这个精度已经足够用于日常的空气质量评估和趋势观察。重要的是你知道了数据的来源和可能的误差范围这比用一个完全黑盒的商业产品更让人安心。7. 功耗优化与续航提升作为便携设备续航是硬指标。FireBeetle ESP32本身功耗控制不错但PMS5003的风扇和激光器是耗电大户。我的优化策略是间歇测量。修改思路不是每2秒都读取一次PMS5003而是让它大部分时间处于休眠模式。PMS5003支持通过发送指令让其进入休眠风扇和激光关闭此时电流仅几毫安。我们可以每5分钟唤醒它一次让它工作1分钟采集数据然后再休眠。// 在全局变量中定义状态 bool pmsActive false; unsigned long pmsWakeTime 0; const long pmsWorkDuration 60000; // 工作1分钟 const long pmsSleepDuration 300000; // 休眠5分钟 void controlPMS() { unsigned long currentMillis millis(); if (!pmsActive (currentMillis - pmsLastSleepTime pmsSleepDuration)) { // 唤醒PMS pms.wakeUp(); pmsActive true; pmsWakeTime currentMillis; Serial.println(PMS Wake Up); } if (pmsActive (currentMillis - pmsWakeTime pmsWorkDuration)) { // 让PMS休眠 pms.sleep(); pmsActive false; pmsLastSleepTime currentMillis; Serial.println(PMS Sleep); } } void loop() { // ... 其他逻辑 controlPMS(); // 控制PMS状态 if (pmsActive) { // 只在PMS活跃时读取数据 readPMSSensor(); } // 温湿度、气体传感器和显示可以继续保持较低频率运行 }通过这种策略在搭配1000mAh锂电池的情况下设备的理论续航可以从不到10小时延长到24小时以上。OLED屏幕也可以设置一个超时关闭背光的功能进一步省电。8. 服务器端数据接收与可视化可选拓展如果你想让数据在云端可见可以搭建一个简单的服务器。这里提供一个极简的Python Flask示例用于接收数据并保存到CSV文件同时也可以扩展成写入数据库。# app.py (服务器端) from flask import Flask, request, jsonify import csv from datetime import datetime app Flask(__name__) CSV_FILE air_data.csv app.route(/api/air-data, methods[POST]) def receive_data(): try: data request.get_json() # 添加时间戳 data[timestamp] datetime.now().isoformat() # 写入CSV文件 file_exists False try: with open(CSV_FILE, r) as f: file_exists True except FileNotFoundError: pass with open(CSV_FILE, a, newline) as f: writer csv.DictWriter(f, fieldnamesdata.keys()) if not file_exists: writer.writeheader() writer.writerow(data) print(fData received: {data}) return jsonify({status: success}), 200 except Exception as e: print(fError: {e}) return jsonify({status: error, message: str(e)}), 400 if __name__ __main__: app.run(host0.0.0.0, port5000, debugTrue)将这个脚本运行在你的服务器甚至是家里的树莓派上将设备代码中的serverUrl改为对应的IP和端口数据就能源源不断地上传了。之后你可以用Grafana、甚至简单的Excel来导入CSV文件生成美观的历史趋势图表。整个项目从构思到实现花费了几个周末的时间但收获远超预期。它不仅是一个实用的工具更是一个涵盖了嵌入式硬件、传感器技术、低功耗编程、网络通信和简单后端开发的综合实践项目。最大的成就感来自于当我在不同的环境中掏出这个自己制作的小盒子看到屏幕上跳动的数字时那种对周围环境的“知情权”和掌控感是购买任何成品都无法替代的。如果你也动手做了一个欢迎分享你的经验和改进点子。