1. 项目概述为什么我们需要一个便携的“空气侦探”最近几年空气质量成了大家日常聊天里绕不开的话题。无论是新家装修后的甲醛焦虑还是办公室里的“闷罐感”又或者是户外运动时对PM2.5的担忧我们越来越需要一个客观、即时的数据来告诉我们我呼吸的空气到底怎么样市面上的专业检测仪要么价格昂贵、功能单一要么体积庞大不便携。作为一个喜欢折腾硬件的爱好者我一直在想能不能自己动手做一个既小巧、功能又全还能把数据玩出花样的空气质量检测仪于是这个基于FireBeetle ESP32的便携式空气质量检测仪项目就诞生了。它的核心目标很简单把看不见的空气质量变成看得见、摸得着、还能联网分析的数据。我选择了DFRobot的FireBeetle ESP32作为主控一方面看中了它极低的功耗和紧凑的尺寸非常适合做成便携设备另一方面它内置的Wi-Fi和蓝牙功能为数据的无线传输和远程查看提供了无限可能。再搭配上几款常见的传感器这个小盒子就能变身成为你口袋里的“空气侦探”随时随地为你监测PM2.5、甲醛TVOC、温湿度甚至二氧化碳浓度。无论你是想监测卧室的睡眠环境、检测新车内的异味还是出差时快速评估酒店房间的空气质量这个自制的小工具都能派上用场。它不仅仅是一个检测仪更是一个可深度定化的数据终端。你可以把数据同步到手机App、上传到私有服务器甚至接入智能家居平台当空气质量变差时自动打开空气净化器。接下来我就把这个项目的完整设计思路、硬件选型、软件编写和那些踩过坑才总结出的实操经验毫无保留地分享给你。2. 核心硬件选型与电路设计解析自制设备硬件是骨架。选对核心部件项目就成功了一半。我的设计原则是高集成、低功耗、易扩展。下面来详细拆解每一部分的选择逻辑和电路连接要点。2.1 主控板为什么是FireBeetle ESP32在众多ESP32开发板中我最终锁定了DFRobot的FireBeetle ESP32系列具体型号是ESP32-E主控芯片为ESP32-D0WDQ6。这个选择经过了多重考量极致低功耗与电源管理这是便携设备的生命线。FireBeetle ESP32板载了高效的AXP192电源管理芯片。这意味着你可以通过软件深度控制核心板、传感器和外设的供电轻松实现休眠、定时唤醒等高级节能策略。实测下来在深度睡眠模式下整机电流可以控制在100微安以下仅用一块1000mAh的锂电池就能实现数周的待机监测这是其他很多ESP32开发板难以做到的。紧凑且友好的设计板子尺寸极小约58.0mm x 25.5mm几乎就是一个USB接口的大小。它采用了邮票孔和Gravity接口的双重设计。邮票孔方便直接焊接集成到最终产品PCB上追求极致体积而Gravity接口则让前期原型搭建和传感器连接变得像搭积木一样简单杜邦线都省了大大降低了制作门槛。丰富的接口与无线能力除了ESP32本身的双核处理器、Wi-Fi和蓝牙这块板子引出了几乎所有常用IO口并保留了UART、I2C、SPI等接口扩展能力很强。内置的4MB Flash也足够存放复杂的程序和数据。注意市面上也有更便宜的NodeMCU ESP32开发板但它们通常缺少专业的电源管理且体积较大。对于追求“便携”和“长续航”的项目FireBeetle多出来的成本是值得的投资。2.2 传感器阵列如何精准捕捉“空气”空气成分复杂我们需要不同的传感器来捕捉关键指标。我选择了以下三个传感器构建了一个覆盖颗粒物、有害气体和环境舒适度的检测阵列PM2.5传感器攀藤PMS5003T选型理由PM2.5是空气质量的核心指标。攀藤的激光散射式传感器在消费级市场中口碑很好。PMS5003T这款除了输出PM1.0、PM2.5、PM10的浓度μg/m³还集成了温湿度传感器一举两得。它采用UART串口通信协议简单稳定数据可靠。关键参数测量范围0.3~1.0μm、1.0~2.5μm、2.5~10μm颗粒物精度在±10%以内100~500μg/m³。自带的风扇确保空气持续流动测量更准确。甲醛与TVOC传感器炜盛科技ZE08-CH2O 或 盛思锐SGP30选型理由针对装修污染和室内有机挥发物。这里有两个主流方案ZE08-CH2O电化学原理专门针对甲醛抗干扰能力强数据直接单位mg/m³或ppm适合对甲醛有精准监测需求的场景。也是UART通信。SGP30金属氧化物半导体MOS原理集成在芯片内。它输出的是TVOC总挥发性有机物和eCO2等效二氧化碳的原始信号值需要通过芯片内置的算法和校准来换算。优点是体积小、功耗低使用I2C通信能同时反映多种有害气体的综合水平。我的选择本项目为了功能全面选择了SGP30。因为它能同时提供TVOC和eCO2两个非常有参考价值的指标且易于集成。但需要注意MOS传感器对酒精、香水等非常敏感初期也需要一段时间的“预热”和“磨合”才能稳定。二氧化碳传感器SenseAir S8选型理由CO2浓度直接反映空间通风情况和人员密集度是判断“闷”不“闷”的科学依据。SenseAir S8是NDIR非分散红外原理这是目前测量CO2最准确、最稳定的方法之一。它同样采用UART通信输出稳定可靠的ppm值。成本考量S8属于工业级传感器价格较高。如果预算有限可以暂时省略或用SGP30输出的eCO2值作为粗略参考但eCO2是基于TVoc估算的与真实CO2有差异。2.3 外围电路与供电设计一个可靠的产品离不开稳定的“后勤系统”。电源方案采用一块3.7V、1000mAh的锂电池供电通过FireBeetle板载的充放电管理电路进行充电和升压。关键在于要利用好ESP32的深度睡眠功能。在软件中我们将设置检测仪每5分钟唤醒一次采集所有传感器数据并上传然后立即重新进入深度睡眠。这样传感器和主控大部分时间都不耗电续航得以极大延长。显示单元为了便携和低功耗我选择了一块0.96英寸的OLED显示屏SSD1306驱动I2C接口。它功耗极低显示信息直观可以轮流显示PM2.5、TVOC、CO2、温湿度等关键数据。在睡眠时屏幕可以完全关闭。电路连接总图UART总线ESP32的UART2引脚16-RX2, 17-TX2连接PMS5003TPM2.5。UART1引脚9-RX1, 10-TX1连接S8CO2。注意串口传感器的TX接ESP32的RXRX接TXVCC和GND接好。I2C总线ESP32的默认I2C引脚21-SDA, 22-SCL上挂载了OLED显示屏和SGP30传感器。I2C总线可以并联多个设备每个设备有独立地址OLED通常0x3CSGP30是0x58。电源所有传感器的VCC都连接到FireBeetle的3.3V输出引脚。务必确保总电流在板载LDO的承载范围内通常500mA-1A本项目传感器均为低功耗型完全没问题。3. 软件框架与核心代码实现硬件连接好后大脑软件才是灵魂。我们的程序需要高效地管理多个传感器、处理数据、驱动显示并实现低功耗循环。我采用Arduino框架进行开发因为它库丰富社区支持好。3.1 开发环境搭建与库管理首先在Arduino IDE或VS Code的PlatformIO插件中安装ESP32开发板支持。然后需要通过库管理器或Git安装以下关键库Adafruit SSD1306和Adafruit GFX用于驱动OLED显示屏。Adafruit SGP30用于驱动SGP30传感器。PMS Library用于解析攀藤PMS5003T传感器的串口数据。WiFi和HTTPClientESP32内置用于网络连接和数据上传。实操心得在PlatformIO中管理这些库非常方便直接在platformio.ini文件中以lib_deps声明即可它会自动处理依赖和版本比Arduino IDE的手动安装更可靠尤其适合多文件项目。3.2 主程序逻辑与低功耗循环设计整个程序的骨架是一个“睡眠-唤醒-工作-睡眠”的循环。以下是精简后的核心逻辑伪代码和关键点解释#include Wire.h #include Adafruit_SGP30.h #include PMS.h #include WiFi.h #include HTTPClient.h // 定义传感器对象 PMS pms(Serial2); // 使用UART2 PMS::DATA data; Adafruit_SGP30 sgp; HardwareSerial SerialS8(1); // 使用UART1 // 全局变量存储数据 int pm25, tvoc, eco2, co2; float temp, humi; void setup() { Serial.begin(115200); Wire.begin(); // 初始化显示屏 display.begin(...); // 初始化SGP30 if (!sgp.begin()) { Serial.println(SGP30 not found!); while (1); } // 初始化串口传感器 Serial2.begin(9600, SERIAL_8N1, 16, 17); // PMS5003T SerialS8.begin(9600, SERIAL_8N1, 9, 10); // S8 pms.passiveMode(); // 设置攀藤传感器为被动模式由MCU请求数据 // 连接Wi-Fi仅在首次或需要时 connectToWiFi(); // 首次读取SGP30基线值用于长期校准 uint16_t TVOC_base, eCO2_base; if (sgp.getIAQBaseline(eCO2_base, TVOC_base)) { sgp.setIAQBaseline(eCO2_base, TVOC_base); } } void loop() { // 1. 唤醒所有传感器给其上电/预热 wakeUpSensors(); // 2. 读取所有传感器数据 readPMSData(); // 读取PM2.5和温湿度 readSGP30Data(); // 读取TVOC和eCO2 readS8Data(); // 读取CO2 // 3. 在OLED上显示数据 updateDisplay(); // 4. 将数据打包上传到服务器如ThingsBoard、自建API if (WiFi.status() WL_CONNECTED) { uploadData(); } // 5. 关闭显示屏设置传感器进入低功耗状态 sleepSensors(); // 6. ESP32进入深度睡眠定时器唤醒设置为5分钟300秒 esp_sleep_enable_timer_wakeup(300 * 1000000ULL); // 微秒单位 Serial.println(Entering deep sleep...); esp_deep_sleep_start(); // 程序在此停止直到被唤醒后从setup()重新开始 }关键解析被动模式将PMS5003T设置为被动模式是为了节能。我们只在需要读数时才通过串口发送唤醒指令让它内部风扇转动测量读完即休眠。默认的主动模式会持续测量功耗高。SGP30基线SGP30的算法依赖于一个“基线”值来保证长期稳定性。首次运行或每隔一段时间如24小时应在空气良好的环境下如室外调用getIAQBaseline获取并保存这个值可以存入EEPROM下次启动时用setIAQBaseline设置回去。否则传感器读数可能会随时间漂移。深度睡眠esp_deep_sleep_start()是功耗控制的核心。调用后CPU、RAM大部分外设都会断电仅由RTC实时时钟模块维持计时。5分钟后RTC定时器会触发复位让整个系统从头开始执行setup()。因此所有需要保持的状态如Wi-Fi连接、传感器基线都需要在睡眠前保存到RTC内存或EEPROM中并在setup()里判断是否是“从睡眠唤醒”来恢复。3.3 传感器数据读取与处理细节每个传感器的读取都有其门道处理不好数据就会跳变或不准。1. 读取PMS5003T数据void readPMSData() { pms.wakeUp(); // 发送唤醒指令 delay(30000); // 等待风扇启动并稳定采样30秒这是准确测量的关键 pms.requestRead(); // 请求读取 if (pms.readUntil(data)) { // 等待并解析数据包 pm25 data.PM_AE_UG_2_5; temp data.AMB_TMP; // 注意单位可能是0.1摄氏度 humi data.AMB_HUM; } pms.sleep(); // 读取完毕立即让传感器休眠 }踩坑记录delay(30000)这30秒等待至关重要激光传感器需要时间让风扇将空气吸入检测腔并稳定。一开始我只等几秒数据波动非常大。此外攀藤传感器的数据包有严格的帧头、长度、校验和务必使用成熟的PMS库来解析避免自己处理串口字节的麻烦和错误。2. 读取SGP30数据void readSGP30Data() { // SGP30需要至少1秒的测量间隔 if (!sgp.IAQmeasure()) { Serial.println(SGP30 measurement failed); return; } tvoc sgp.TVOC; eco2 sgp.eCO2; // 可选同时读取原始信号用于高级诊断 // sgp.IAQmeasureRaw(); }3. 读取S8 CO2数据S8的协议是MODBUS-RTU我们需要通过串口发送特定的查询指令帧并解析返回的帧。这里需要计算CRC校验码。以下是核心函数void readS8Data() { // MODBUS查询帧设备地址(0x01) 功能码(0x04) 寄存器地址(0x0003) 寄存器数量(0x0001) CRC byte query[8] {0x01, 0x04, 0x00, 0x03, 0x00, 0x01, 0xXX, 0xXX}; // XX需计算CRC calculateCRC(query, 6); // 计算最后两个字节的CRC SerialS8.write(query, 8); delay(100); // 等待传感器响应 if (SerialS8.available() 7) { byte response[7]; SerialS8.readBytes(response, 7); // 验证地址、功能码和CRC if (response[0]0x01 response[1]0x04 checkCRC(response, 5)) { co2 (response[3] 8) | response[4]; // 数据在高字节和低字节 } } }注意事项MODBUS通信对时序和校验要求严格。务必确保发送指令和接收解析的字节序、CRC计算正确。网上有现成的CRC16计算函数可供使用。如果读取失败检查接线RX/TX是否反了和波特率通常是9600。3.4 数据上传与可视化方案数据不能只躺在设备里上传到云端才能发挥最大价值。这里提供两种最实用的方案方案一上传到ThingsBoard开源物联网平台推荐给初学者ThingsBoard提供了免费的开源社区版可以快速创建仪表盘。ESP32使用HTTP或MQTT协议上传数据。在ThingsBoard上创建设备获取设备访问令牌。ESP32代码中使用HTTPClient库以JSON格式打包传感器数据POST到类似http://你的服务器地址/api/v1/$ACCESS_TOKEN/telemetry的地址。在ThingsBoard的仪表盘编辑器里拖拽各种图表控件如数字指示器、折线图绑定设备的数据键如pm25tvoc即可实时可视化。方案二上传到自建服务器API适合有开发能力的用户你可以用PythonFlask/Django、Node.js等任何后端语言编写一个简单的API接口。服务器端创建一个接收POST请求的端点解析JSON数据然后存入数据库如SQLite、MySQL、InfluxDB时序数据库。ESP32端同样使用HTTPClient将数据发送到你的服务器API URL。前端可以用Grafana连接数据库做酷炫的可视化大屏或者自己写一个网页来显示数据。实操心得在loop()循环中上传数据时一定要做好错误处理和超时设置。因为Wi-Fi网络可能不稳定。我的做法是HTTPClient http; http.begin(“http://your-api.com/data”); http.addHeader(“Content-Type”, “application/json”); http.setTimeout(5000); // 设置5秒超时 int httpCode http.POST(jsonDataString); if (httpCode 0) { // 成功 } else { Serial.println(“Upload failed.”); // 可以选择将数据暂存到SPIFFS文件系统中下次有网时重试 } http.end();对于便携设备网络时有时无是常态。增加一个本地缓存如SPIFFS机制能保证数据不丢失。4. 外壳设计与组装工艺好的产品需要一个好的“家”。外壳不仅关乎美观更影响传感器的进气、散热和防护。4.1 3D建模与打印要点我使用Fusion 360进行建模设计了一个尺寸约为80x50x25mm的立式外壳。设计时考虑了以下几点风道设计这是最关键的PM2.5传感器PMS5003T自带风扇需要形成有效的“进气-检测-排气”路径。我在外壳底部和侧面开了密集的进气格栅在顶部对应传感器风扇的位置开了出风口确保空气能自然对流通过激光检测腔。传感器隔离SGP30TVOC传感器对气流敏感但不需要强风。我把它放在一个相对独立、有细小通气孔的内舱避免被PMS5003T的风扇气流直吹导致读数不稳。屏幕与接口前面板为OLED屏幕开了一个紧贴的窗口减少灰尘进入。侧面预留了Type-C充电口和一个小孔用于硬件复位按钮。固定结构内部设计了多个立柱和卡槽用于固定FireBeetle主板、电池和各个传感器模块防止运输时晃动。打印参数使用PLA材料层高0.2mm填充率20%。为了保证进气格栅的强度格栅的宽度不能小于喷嘴直径通常0.4mm我设计为1mm。4.2 组装步骤与电气安全组装顺序很重要原则是先内后外先固定后连接。预处理将3D打印好的外壳部件主体、前面板、后面板用砂纸打磨毛边特别是接口处确保平整。内部安装首先用M2螺丝将FireBeetle主板固定在外壳底部的立柱上。然后将电池用双面胶或扎带固定在预留位置。接着安装传感器。PMS5003T的出风口一定要对准外壳上方的排气孔。SGP30和S8模块可以用热熔胶或螺丝固定在其位。最后焊接这是保证可靠性的关键步骤。不要依赖杜邦线插接。使用AWG24-26的细导线将传感器的VCC、GND、信号线TX/RX, SDA/SCL直接焊接到FireBeetle对应的邮票孔或Gravity接口焊盘上。焊接后用万用表通断档检查是否有短路或虚焊。电气检查上电前务必再次确认电池极性是否正确所有传感器的VCC是否都接到了3.3V切勿接到5V串口传感器的TX/RX线是否交叉连接传感器的TX接主控的RX闭合与测试将OLED屏幕连接好合上前面板拧紧螺丝。首次上电通过串口监视器观察启动日志检查各个传感器是否初始化成功数据是否正常输出。避坑指南在封闭外壳内长时间运行ESP32和传感器会产生少量热量可能导致内部温湿度读数略高于环境。如果对温湿度精度要求极高可以考虑将SHT30这类温湿度传感器的探头通过延长线引到外壳外部。另外所有开孔处最好贴上防尘网防止大颗粒灰尘进入影响激光传感器寿命。5. 校准、调试与性能优化设备组装好能跑起来只是第一步让它测得准、跑得稳才是真正的挑战。5.1 传感器校准与数据验证自制仪器最怕数据不准。我们需要一些方法来验证和提升数据的可信度。交叉验证法PM2.5在空气稳定的室内同时开启你的设备和一台可靠的商用检测仪如小米、空气堡。记录多组数据对比趋势和绝对值。如果存在固定偏差可以在代码中增加一个修正系数。例如final_pm25 measured_pm25 * 0.9 5系数需根据对比实验得出。CO2S8传感器精度较高一般无需校准。但可以在通风良好的室外背景CO2约400-420ppm进行零点验证。如果读数持续偏高有些型号支持零点校准指令需查阅手册谨慎操作。TVOCSGP30这是最难校准的。因为它是对多种气体的综合响应。最好的“校准”方法是正确使用基线功能。确保设备在空气新鲜的环境中连续通电运行12小时以上让算法建立稳定的基线。之后每次启动时如果从EEPROM读取了之前保存的基线值读数就会相对稳定和可比。环境干扰排除SGP30对酒精极度敏感手上擦了酒精凝胶去摸设备或者附近有人使用香水TVOC读数都会爆表。这是物理特性无法避免。在解读数据时要考虑这个因素。气流影响确保设备放置位置空气流通但不要放在空调出风口、风扇直吹或阳光直射的地方剧烈气流和温度骤变会导致所有传感器读数异常波动。5.2 低功耗深度优化技巧我们的目标是让1000mAh电池撑得更久。除了5分钟唤醒一次的大策略还有这些细节可以抠关闭无用外设与功能在进入深度睡眠前除了调用sensor.sleep()还要在代码中显式关闭Wi-Fi和蓝牙。WiFi.disconnect(true); // 断开Wi-Fi并清除配置 WiFi.mode(WIFI_OFF); // 关闭Wi-Fi模式 btStop(); // 关闭蓝牙降低CPU频率在setup()中如果不是对计算速度有极高要求可以降低CPU主频来省电。setCpuFrequencyMhz(80); // 将CPU频率设为80MHz默认240MHz测量实际功耗这是优化效果的最终裁判。你需要一个万用表电流档串联在电池和主板之间。工作电流在设备唤醒、屏幕亮起、传感器全开、Wi-Fi上传数据的瞬间电流可能达到150-250mA。睡眠电流进入深度睡眠后电流应降至100微安0.1mA以下。如果睡眠电流还有几个mA说明有外设漏电。检查是否所有传感器都进入了休眠模式是否有LED灯没被关闭计算理论续航假设每次唤醒工作时间为30秒传感器预热 5秒读数上传 35秒工作电流平均200mA。睡眠时间为5分钟 - 35秒 265秒睡眠电流0.1mA。一个周期总耗电量 ≈ (200mA * 35s 0.1mA * 265s) / 3600s ≈ 1.94 mAh。1000mAh电池理论循环次数 ≈ 1000 / 1.94 ≈ 515次。515次 * 5分钟/次 ≈ 2575分钟 ≈42.9小时。这看起来不长但注意这是持续每5分钟测量一次的强度。如果调整为每10分钟测量一次续航立刻翻倍到85小时以上。根据实际监测需求调整间隔是平衡数据密度和续航的最有效手段。5.3 常见故障排查速查表制作和调试过程中你肯定会遇到各种问题。下表汇总了典型症状和排查思路故障现象可能原因排查步骤设备完全不上电1. 电池没电或损坏2. 电源开关未开或损坏3. 主板短路1. 用万用表测电池电压应3.7V2. 检查开关通断3. 断开所有外设只给主板上电检查3.3V输出OLED屏幕不显示1. I2C地址错误2. 接线松动3. 屏幕本身损坏1. 用I2C扫描程序确认设备地址通常是0x3C或0x3D2. 重新压紧或焊接SDA、SCL线3. 单独给屏幕供电检查是否亮起PM2.5读数始终为0或异常1. 串口接线错误TX/RX反2. 传感器未唤醒3. 风道堵塞无气流1. 交换TX/RX接线2. 确认代码中执行了pms.wakeUp()并等待足够时间3. 检查外壳进气/出气孔是否畅通听传感器内部风扇有无声音SGP30读数不稳定或为01. I2C通信失败2. 传感器未预热3. 基线未设置1. I2C扫描确认0x58地址存在2. SGP30需要通电预热一段时间几分钟读数才稳定3. 检查基线获取和设置代码逻辑Wi-Fi无法连接1. SSID/密码错误2. 信号太弱3. 路由器设置了MAC过滤1. 检查代码中的凭证2. 将设备靠近路由器测试3. 在串口监视器查看Wi-Fi连接状态码深度睡眠后无法唤醒1. 唤醒源配置错误2. 电路中有元件在睡眠时漏电导致复位异常1. 检查esp_sleep_enable_timer_wakeup()参数是否正确单位是微秒2. 测量深度睡眠时的电流若过大则逐一断开外设排查6. 项目扩展与进阶玩法基础功能实现后这个开放的平台还能玩出更多花样。扩展一增加GPS模块如果你想知道不同地点的空气质量可以添加一个GPS模块如NEO-6M。在每次测量时同时记录经纬度坐标并一起上传到服务器。这样你就能在地图上绘制出你的“空气质量轨迹图”非常适合户外骑行或徒步时使用。扩展二本地报警与联动增加一个蜂鸣器或一个小型震动马达。在代码中设置阈值如PM2.5 75 TVOC 1000当检测值超标时本地发出声光震动报警。更进一步可以利用ESP32的蓝牙功能当手机靠近时自动将数据推送到手机通知栏。扩展三接入Home Assistant如果你家里运行着Home Assistant智能家居系统可以将此设备接入实现自动化联动。例如通过ESPHome或MQTT自动发现协议将传感器数据暴露给Home Assistant。然后创建自动化当“客厅空气质量检测仪”的TVOC值超过设定阈值时自动打开“新风系统”或“空气净化器”。扩展四太阳能充电对于长期户外部署可以搭配一块小型的5V太阳能电池板和一个TP4056充电模块与原有的锂电池并联。这样就能实现白天太阳能充电夜间持续监测真正做到能源自给自足。这个项目从构思到实现最深的体会是硬件项目的乐趣在于你永远可以在“够用”和“更好”之间找到新的平衡点。每一次调试、每一次优化甚至每一次失败都让你对“空气”和“电子”这两样看不见摸不着的东西有了更真切的理解。它不再只是一个工具而是你感知环境的一种延伸。最后一个小建议在焊接和组装时多一点耐心做好万用表检查在编写代码时多考虑一些异常情况处理。这些细节决定了你的作品是“玩具”还是“工具”。
基于ESP32与多传感器构建便携式空气质量检测仪：从硬件选型到低功耗实践
1. 项目概述为什么我们需要一个便携的“空气侦探”最近几年空气质量成了大家日常聊天里绕不开的话题。无论是新家装修后的甲醛焦虑还是办公室里的“闷罐感”又或者是户外运动时对PM2.5的担忧我们越来越需要一个客观、即时的数据来告诉我们我呼吸的空气到底怎么样市面上的专业检测仪要么价格昂贵、功能单一要么体积庞大不便携。作为一个喜欢折腾硬件的爱好者我一直在想能不能自己动手做一个既小巧、功能又全还能把数据玩出花样的空气质量检测仪于是这个基于FireBeetle ESP32的便携式空气质量检测仪项目就诞生了。它的核心目标很简单把看不见的空气质量变成看得见、摸得着、还能联网分析的数据。我选择了DFRobot的FireBeetle ESP32作为主控一方面看中了它极低的功耗和紧凑的尺寸非常适合做成便携设备另一方面它内置的Wi-Fi和蓝牙功能为数据的无线传输和远程查看提供了无限可能。再搭配上几款常见的传感器这个小盒子就能变身成为你口袋里的“空气侦探”随时随地为你监测PM2.5、甲醛TVOC、温湿度甚至二氧化碳浓度。无论你是想监测卧室的睡眠环境、检测新车内的异味还是出差时快速评估酒店房间的空气质量这个自制的小工具都能派上用场。它不仅仅是一个检测仪更是一个可深度定化的数据终端。你可以把数据同步到手机App、上传到私有服务器甚至接入智能家居平台当空气质量变差时自动打开空气净化器。接下来我就把这个项目的完整设计思路、硬件选型、软件编写和那些踩过坑才总结出的实操经验毫无保留地分享给你。2. 核心硬件选型与电路设计解析自制设备硬件是骨架。选对核心部件项目就成功了一半。我的设计原则是高集成、低功耗、易扩展。下面来详细拆解每一部分的选择逻辑和电路连接要点。2.1 主控板为什么是FireBeetle ESP32在众多ESP32开发板中我最终锁定了DFRobot的FireBeetle ESP32系列具体型号是ESP32-E主控芯片为ESP32-D0WDQ6。这个选择经过了多重考量极致低功耗与电源管理这是便携设备的生命线。FireBeetle ESP32板载了高效的AXP192电源管理芯片。这意味着你可以通过软件深度控制核心板、传感器和外设的供电轻松实现休眠、定时唤醒等高级节能策略。实测下来在深度睡眠模式下整机电流可以控制在100微安以下仅用一块1000mAh的锂电池就能实现数周的待机监测这是其他很多ESP32开发板难以做到的。紧凑且友好的设计板子尺寸极小约58.0mm x 25.5mm几乎就是一个USB接口的大小。它采用了邮票孔和Gravity接口的双重设计。邮票孔方便直接焊接集成到最终产品PCB上追求极致体积而Gravity接口则让前期原型搭建和传感器连接变得像搭积木一样简单杜邦线都省了大大降低了制作门槛。丰富的接口与无线能力除了ESP32本身的双核处理器、Wi-Fi和蓝牙这块板子引出了几乎所有常用IO口并保留了UART、I2C、SPI等接口扩展能力很强。内置的4MB Flash也足够存放复杂的程序和数据。注意市面上也有更便宜的NodeMCU ESP32开发板但它们通常缺少专业的电源管理且体积较大。对于追求“便携”和“长续航”的项目FireBeetle多出来的成本是值得的投资。2.2 传感器阵列如何精准捕捉“空气”空气成分复杂我们需要不同的传感器来捕捉关键指标。我选择了以下三个传感器构建了一个覆盖颗粒物、有害气体和环境舒适度的检测阵列PM2.5传感器攀藤PMS5003T选型理由PM2.5是空气质量的核心指标。攀藤的激光散射式传感器在消费级市场中口碑很好。PMS5003T这款除了输出PM1.0、PM2.5、PM10的浓度μg/m³还集成了温湿度传感器一举两得。它采用UART串口通信协议简单稳定数据可靠。关键参数测量范围0.3~1.0μm、1.0~2.5μm、2.5~10μm颗粒物精度在±10%以内100~500μg/m³。自带的风扇确保空气持续流动测量更准确。甲醛与TVOC传感器炜盛科技ZE08-CH2O 或 盛思锐SGP30选型理由针对装修污染和室内有机挥发物。这里有两个主流方案ZE08-CH2O电化学原理专门针对甲醛抗干扰能力强数据直接单位mg/m³或ppm适合对甲醛有精准监测需求的场景。也是UART通信。SGP30金属氧化物半导体MOS原理集成在芯片内。它输出的是TVOC总挥发性有机物和eCO2等效二氧化碳的原始信号值需要通过芯片内置的算法和校准来换算。优点是体积小、功耗低使用I2C通信能同时反映多种有害气体的综合水平。我的选择本项目为了功能全面选择了SGP30。因为它能同时提供TVOC和eCO2两个非常有参考价值的指标且易于集成。但需要注意MOS传感器对酒精、香水等非常敏感初期也需要一段时间的“预热”和“磨合”才能稳定。二氧化碳传感器SenseAir S8选型理由CO2浓度直接反映空间通风情况和人员密集度是判断“闷”不“闷”的科学依据。SenseAir S8是NDIR非分散红外原理这是目前测量CO2最准确、最稳定的方法之一。它同样采用UART通信输出稳定可靠的ppm值。成本考量S8属于工业级传感器价格较高。如果预算有限可以暂时省略或用SGP30输出的eCO2值作为粗略参考但eCO2是基于TVoc估算的与真实CO2有差异。2.3 外围电路与供电设计一个可靠的产品离不开稳定的“后勤系统”。电源方案采用一块3.7V、1000mAh的锂电池供电通过FireBeetle板载的充放电管理电路进行充电和升压。关键在于要利用好ESP32的深度睡眠功能。在软件中我们将设置检测仪每5分钟唤醒一次采集所有传感器数据并上传然后立即重新进入深度睡眠。这样传感器和主控大部分时间都不耗电续航得以极大延长。显示单元为了便携和低功耗我选择了一块0.96英寸的OLED显示屏SSD1306驱动I2C接口。它功耗极低显示信息直观可以轮流显示PM2.5、TVOC、CO2、温湿度等关键数据。在睡眠时屏幕可以完全关闭。电路连接总图UART总线ESP32的UART2引脚16-RX2, 17-TX2连接PMS5003TPM2.5。UART1引脚9-RX1, 10-TX1连接S8CO2。注意串口传感器的TX接ESP32的RXRX接TXVCC和GND接好。I2C总线ESP32的默认I2C引脚21-SDA, 22-SCL上挂载了OLED显示屏和SGP30传感器。I2C总线可以并联多个设备每个设备有独立地址OLED通常0x3CSGP30是0x58。电源所有传感器的VCC都连接到FireBeetle的3.3V输出引脚。务必确保总电流在板载LDO的承载范围内通常500mA-1A本项目传感器均为低功耗型完全没问题。3. 软件框架与核心代码实现硬件连接好后大脑软件才是灵魂。我们的程序需要高效地管理多个传感器、处理数据、驱动显示并实现低功耗循环。我采用Arduino框架进行开发因为它库丰富社区支持好。3.1 开发环境搭建与库管理首先在Arduino IDE或VS Code的PlatformIO插件中安装ESP32开发板支持。然后需要通过库管理器或Git安装以下关键库Adafruit SSD1306和Adafruit GFX用于驱动OLED显示屏。Adafruit SGP30用于驱动SGP30传感器。PMS Library用于解析攀藤PMS5003T传感器的串口数据。WiFi和HTTPClientESP32内置用于网络连接和数据上传。实操心得在PlatformIO中管理这些库非常方便直接在platformio.ini文件中以lib_deps声明即可它会自动处理依赖和版本比Arduino IDE的手动安装更可靠尤其适合多文件项目。3.2 主程序逻辑与低功耗循环设计整个程序的骨架是一个“睡眠-唤醒-工作-睡眠”的循环。以下是精简后的核心逻辑伪代码和关键点解释#include Wire.h #include Adafruit_SGP30.h #include PMS.h #include WiFi.h #include HTTPClient.h // 定义传感器对象 PMS pms(Serial2); // 使用UART2 PMS::DATA data; Adafruit_SGP30 sgp; HardwareSerial SerialS8(1); // 使用UART1 // 全局变量存储数据 int pm25, tvoc, eco2, co2; float temp, humi; void setup() { Serial.begin(115200); Wire.begin(); // 初始化显示屏 display.begin(...); // 初始化SGP30 if (!sgp.begin()) { Serial.println(SGP30 not found!); while (1); } // 初始化串口传感器 Serial2.begin(9600, SERIAL_8N1, 16, 17); // PMS5003T SerialS8.begin(9600, SERIAL_8N1, 9, 10); // S8 pms.passiveMode(); // 设置攀藤传感器为被动模式由MCU请求数据 // 连接Wi-Fi仅在首次或需要时 connectToWiFi(); // 首次读取SGP30基线值用于长期校准 uint16_t TVOC_base, eCO2_base; if (sgp.getIAQBaseline(eCO2_base, TVOC_base)) { sgp.setIAQBaseline(eCO2_base, TVOC_base); } } void loop() { // 1. 唤醒所有传感器给其上电/预热 wakeUpSensors(); // 2. 读取所有传感器数据 readPMSData(); // 读取PM2.5和温湿度 readSGP30Data(); // 读取TVOC和eCO2 readS8Data(); // 读取CO2 // 3. 在OLED上显示数据 updateDisplay(); // 4. 将数据打包上传到服务器如ThingsBoard、自建API if (WiFi.status() WL_CONNECTED) { uploadData(); } // 5. 关闭显示屏设置传感器进入低功耗状态 sleepSensors(); // 6. ESP32进入深度睡眠定时器唤醒设置为5分钟300秒 esp_sleep_enable_timer_wakeup(300 * 1000000ULL); // 微秒单位 Serial.println(Entering deep sleep...); esp_deep_sleep_start(); // 程序在此停止直到被唤醒后从setup()重新开始 }关键解析被动模式将PMS5003T设置为被动模式是为了节能。我们只在需要读数时才通过串口发送唤醒指令让它内部风扇转动测量读完即休眠。默认的主动模式会持续测量功耗高。SGP30基线SGP30的算法依赖于一个“基线”值来保证长期稳定性。首次运行或每隔一段时间如24小时应在空气良好的环境下如室外调用getIAQBaseline获取并保存这个值可以存入EEPROM下次启动时用setIAQBaseline设置回去。否则传感器读数可能会随时间漂移。深度睡眠esp_deep_sleep_start()是功耗控制的核心。调用后CPU、RAM大部分外设都会断电仅由RTC实时时钟模块维持计时。5分钟后RTC定时器会触发复位让整个系统从头开始执行setup()。因此所有需要保持的状态如Wi-Fi连接、传感器基线都需要在睡眠前保存到RTC内存或EEPROM中并在setup()里判断是否是“从睡眠唤醒”来恢复。3.3 传感器数据读取与处理细节每个传感器的读取都有其门道处理不好数据就会跳变或不准。1. 读取PMS5003T数据void readPMSData() { pms.wakeUp(); // 发送唤醒指令 delay(30000); // 等待风扇启动并稳定采样30秒这是准确测量的关键 pms.requestRead(); // 请求读取 if (pms.readUntil(data)) { // 等待并解析数据包 pm25 data.PM_AE_UG_2_5; temp data.AMB_TMP; // 注意单位可能是0.1摄氏度 humi data.AMB_HUM; } pms.sleep(); // 读取完毕立即让传感器休眠 }踩坑记录delay(30000)这30秒等待至关重要激光传感器需要时间让风扇将空气吸入检测腔并稳定。一开始我只等几秒数据波动非常大。此外攀藤传感器的数据包有严格的帧头、长度、校验和务必使用成熟的PMS库来解析避免自己处理串口字节的麻烦和错误。2. 读取SGP30数据void readSGP30Data() { // SGP30需要至少1秒的测量间隔 if (!sgp.IAQmeasure()) { Serial.println(SGP30 measurement failed); return; } tvoc sgp.TVOC; eco2 sgp.eCO2; // 可选同时读取原始信号用于高级诊断 // sgp.IAQmeasureRaw(); }3. 读取S8 CO2数据S8的协议是MODBUS-RTU我们需要通过串口发送特定的查询指令帧并解析返回的帧。这里需要计算CRC校验码。以下是核心函数void readS8Data() { // MODBUS查询帧设备地址(0x01) 功能码(0x04) 寄存器地址(0x0003) 寄存器数量(0x0001) CRC byte query[8] {0x01, 0x04, 0x00, 0x03, 0x00, 0x01, 0xXX, 0xXX}; // XX需计算CRC calculateCRC(query, 6); // 计算最后两个字节的CRC SerialS8.write(query, 8); delay(100); // 等待传感器响应 if (SerialS8.available() 7) { byte response[7]; SerialS8.readBytes(response, 7); // 验证地址、功能码和CRC if (response[0]0x01 response[1]0x04 checkCRC(response, 5)) { co2 (response[3] 8) | response[4]; // 数据在高字节和低字节 } } }注意事项MODBUS通信对时序和校验要求严格。务必确保发送指令和接收解析的字节序、CRC计算正确。网上有现成的CRC16计算函数可供使用。如果读取失败检查接线RX/TX是否反了和波特率通常是9600。3.4 数据上传与可视化方案数据不能只躺在设备里上传到云端才能发挥最大价值。这里提供两种最实用的方案方案一上传到ThingsBoard开源物联网平台推荐给初学者ThingsBoard提供了免费的开源社区版可以快速创建仪表盘。ESP32使用HTTP或MQTT协议上传数据。在ThingsBoard上创建设备获取设备访问令牌。ESP32代码中使用HTTPClient库以JSON格式打包传感器数据POST到类似http://你的服务器地址/api/v1/$ACCESS_TOKEN/telemetry的地址。在ThingsBoard的仪表盘编辑器里拖拽各种图表控件如数字指示器、折线图绑定设备的数据键如pm25tvoc即可实时可视化。方案二上传到自建服务器API适合有开发能力的用户你可以用PythonFlask/Django、Node.js等任何后端语言编写一个简单的API接口。服务器端创建一个接收POST请求的端点解析JSON数据然后存入数据库如SQLite、MySQL、InfluxDB时序数据库。ESP32端同样使用HTTPClient将数据发送到你的服务器API URL。前端可以用Grafana连接数据库做酷炫的可视化大屏或者自己写一个网页来显示数据。实操心得在loop()循环中上传数据时一定要做好错误处理和超时设置。因为Wi-Fi网络可能不稳定。我的做法是HTTPClient http; http.begin(“http://your-api.com/data”); http.addHeader(“Content-Type”, “application/json”); http.setTimeout(5000); // 设置5秒超时 int httpCode http.POST(jsonDataString); if (httpCode 0) { // 成功 } else { Serial.println(“Upload failed.”); // 可以选择将数据暂存到SPIFFS文件系统中下次有网时重试 } http.end();对于便携设备网络时有时无是常态。增加一个本地缓存如SPIFFS机制能保证数据不丢失。4. 外壳设计与组装工艺好的产品需要一个好的“家”。外壳不仅关乎美观更影响传感器的进气、散热和防护。4.1 3D建模与打印要点我使用Fusion 360进行建模设计了一个尺寸约为80x50x25mm的立式外壳。设计时考虑了以下几点风道设计这是最关键的PM2.5传感器PMS5003T自带风扇需要形成有效的“进气-检测-排气”路径。我在外壳底部和侧面开了密集的进气格栅在顶部对应传感器风扇的位置开了出风口确保空气能自然对流通过激光检测腔。传感器隔离SGP30TVOC传感器对气流敏感但不需要强风。我把它放在一个相对独立、有细小通气孔的内舱避免被PMS5003T的风扇气流直吹导致读数不稳。屏幕与接口前面板为OLED屏幕开了一个紧贴的窗口减少灰尘进入。侧面预留了Type-C充电口和一个小孔用于硬件复位按钮。固定结构内部设计了多个立柱和卡槽用于固定FireBeetle主板、电池和各个传感器模块防止运输时晃动。打印参数使用PLA材料层高0.2mm填充率20%。为了保证进气格栅的强度格栅的宽度不能小于喷嘴直径通常0.4mm我设计为1mm。4.2 组装步骤与电气安全组装顺序很重要原则是先内后外先固定后连接。预处理将3D打印好的外壳部件主体、前面板、后面板用砂纸打磨毛边特别是接口处确保平整。内部安装首先用M2螺丝将FireBeetle主板固定在外壳底部的立柱上。然后将电池用双面胶或扎带固定在预留位置。接着安装传感器。PMS5003T的出风口一定要对准外壳上方的排气孔。SGP30和S8模块可以用热熔胶或螺丝固定在其位。最后焊接这是保证可靠性的关键步骤。不要依赖杜邦线插接。使用AWG24-26的细导线将传感器的VCC、GND、信号线TX/RX, SDA/SCL直接焊接到FireBeetle对应的邮票孔或Gravity接口焊盘上。焊接后用万用表通断档检查是否有短路或虚焊。电气检查上电前务必再次确认电池极性是否正确所有传感器的VCC是否都接到了3.3V切勿接到5V串口传感器的TX/RX线是否交叉连接传感器的TX接主控的RX闭合与测试将OLED屏幕连接好合上前面板拧紧螺丝。首次上电通过串口监视器观察启动日志检查各个传感器是否初始化成功数据是否正常输出。避坑指南在封闭外壳内长时间运行ESP32和传感器会产生少量热量可能导致内部温湿度读数略高于环境。如果对温湿度精度要求极高可以考虑将SHT30这类温湿度传感器的探头通过延长线引到外壳外部。另外所有开孔处最好贴上防尘网防止大颗粒灰尘进入影响激光传感器寿命。5. 校准、调试与性能优化设备组装好能跑起来只是第一步让它测得准、跑得稳才是真正的挑战。5.1 传感器校准与数据验证自制仪器最怕数据不准。我们需要一些方法来验证和提升数据的可信度。交叉验证法PM2.5在空气稳定的室内同时开启你的设备和一台可靠的商用检测仪如小米、空气堡。记录多组数据对比趋势和绝对值。如果存在固定偏差可以在代码中增加一个修正系数。例如final_pm25 measured_pm25 * 0.9 5系数需根据对比实验得出。CO2S8传感器精度较高一般无需校准。但可以在通风良好的室外背景CO2约400-420ppm进行零点验证。如果读数持续偏高有些型号支持零点校准指令需查阅手册谨慎操作。TVOCSGP30这是最难校准的。因为它是对多种气体的综合响应。最好的“校准”方法是正确使用基线功能。确保设备在空气新鲜的环境中连续通电运行12小时以上让算法建立稳定的基线。之后每次启动时如果从EEPROM读取了之前保存的基线值读数就会相对稳定和可比。环境干扰排除SGP30对酒精极度敏感手上擦了酒精凝胶去摸设备或者附近有人使用香水TVOC读数都会爆表。这是物理特性无法避免。在解读数据时要考虑这个因素。气流影响确保设备放置位置空气流通但不要放在空调出风口、风扇直吹或阳光直射的地方剧烈气流和温度骤变会导致所有传感器读数异常波动。5.2 低功耗深度优化技巧我们的目标是让1000mAh电池撑得更久。除了5分钟唤醒一次的大策略还有这些细节可以抠关闭无用外设与功能在进入深度睡眠前除了调用sensor.sleep()还要在代码中显式关闭Wi-Fi和蓝牙。WiFi.disconnect(true); // 断开Wi-Fi并清除配置 WiFi.mode(WIFI_OFF); // 关闭Wi-Fi模式 btStop(); // 关闭蓝牙降低CPU频率在setup()中如果不是对计算速度有极高要求可以降低CPU主频来省电。setCpuFrequencyMhz(80); // 将CPU频率设为80MHz默认240MHz测量实际功耗这是优化效果的最终裁判。你需要一个万用表电流档串联在电池和主板之间。工作电流在设备唤醒、屏幕亮起、传感器全开、Wi-Fi上传数据的瞬间电流可能达到150-250mA。睡眠电流进入深度睡眠后电流应降至100微安0.1mA以下。如果睡眠电流还有几个mA说明有外设漏电。检查是否所有传感器都进入了休眠模式是否有LED灯没被关闭计算理论续航假设每次唤醒工作时间为30秒传感器预热 5秒读数上传 35秒工作电流平均200mA。睡眠时间为5分钟 - 35秒 265秒睡眠电流0.1mA。一个周期总耗电量 ≈ (200mA * 35s 0.1mA * 265s) / 3600s ≈ 1.94 mAh。1000mAh电池理论循环次数 ≈ 1000 / 1.94 ≈ 515次。515次 * 5分钟/次 ≈ 2575分钟 ≈42.9小时。这看起来不长但注意这是持续每5分钟测量一次的强度。如果调整为每10分钟测量一次续航立刻翻倍到85小时以上。根据实际监测需求调整间隔是平衡数据密度和续航的最有效手段。5.3 常见故障排查速查表制作和调试过程中你肯定会遇到各种问题。下表汇总了典型症状和排查思路故障现象可能原因排查步骤设备完全不上电1. 电池没电或损坏2. 电源开关未开或损坏3. 主板短路1. 用万用表测电池电压应3.7V2. 检查开关通断3. 断开所有外设只给主板上电检查3.3V输出OLED屏幕不显示1. I2C地址错误2. 接线松动3. 屏幕本身损坏1. 用I2C扫描程序确认设备地址通常是0x3C或0x3D2. 重新压紧或焊接SDA、SCL线3. 单独给屏幕供电检查是否亮起PM2.5读数始终为0或异常1. 串口接线错误TX/RX反2. 传感器未唤醒3. 风道堵塞无气流1. 交换TX/RX接线2. 确认代码中执行了pms.wakeUp()并等待足够时间3. 检查外壳进气/出气孔是否畅通听传感器内部风扇有无声音SGP30读数不稳定或为01. I2C通信失败2. 传感器未预热3. 基线未设置1. I2C扫描确认0x58地址存在2. SGP30需要通电预热一段时间几分钟读数才稳定3. 检查基线获取和设置代码逻辑Wi-Fi无法连接1. SSID/密码错误2. 信号太弱3. 路由器设置了MAC过滤1. 检查代码中的凭证2. 将设备靠近路由器测试3. 在串口监视器查看Wi-Fi连接状态码深度睡眠后无法唤醒1. 唤醒源配置错误2. 电路中有元件在睡眠时漏电导致复位异常1. 检查esp_sleep_enable_timer_wakeup()参数是否正确单位是微秒2. 测量深度睡眠时的电流若过大则逐一断开外设排查6. 项目扩展与进阶玩法基础功能实现后这个开放的平台还能玩出更多花样。扩展一增加GPS模块如果你想知道不同地点的空气质量可以添加一个GPS模块如NEO-6M。在每次测量时同时记录经纬度坐标并一起上传到服务器。这样你就能在地图上绘制出你的“空气质量轨迹图”非常适合户外骑行或徒步时使用。扩展二本地报警与联动增加一个蜂鸣器或一个小型震动马达。在代码中设置阈值如PM2.5 75 TVOC 1000当检测值超标时本地发出声光震动报警。更进一步可以利用ESP32的蓝牙功能当手机靠近时自动将数据推送到手机通知栏。扩展三接入Home Assistant如果你家里运行着Home Assistant智能家居系统可以将此设备接入实现自动化联动。例如通过ESPHome或MQTT自动发现协议将传感器数据暴露给Home Assistant。然后创建自动化当“客厅空气质量检测仪”的TVOC值超过设定阈值时自动打开“新风系统”或“空气净化器”。扩展四太阳能充电对于长期户外部署可以搭配一块小型的5V太阳能电池板和一个TP4056充电模块与原有的锂电池并联。这样就能实现白天太阳能充电夜间持续监测真正做到能源自给自足。这个项目从构思到实现最深的体会是硬件项目的乐趣在于你永远可以在“够用”和“更好”之间找到新的平衡点。每一次调试、每一次优化甚至每一次失败都让你对“空气”和“电子”这两样看不见摸不着的东西有了更真切的理解。它不再只是一个工具而是你感知环境的一种延伸。最后一个小建议在焊接和组装时多一点耐心做好万用表检查在编写代码时多考虑一些异常情况处理。这些细节决定了你的作品是“玩具”还是“工具”。
