1. 项目概述打造你的智能桌面空气卫士在电子工作台前长时间焊接或是进行3D打印、激光雕刻等操作时产生的烟雾和挥发性有机物VOCs是每个创客和工程师都避不开的烦恼。传统的烟雾净化器要么笨重昂贵要么功能单一无法与我们的智能工作流相结合。今天我想分享一个我最近完成并觉得非常实用的DIY项目一个基于ESP32-S2与CircuitPython的智能烟雾净化器。它不仅仅是一个风扇更是一个集成了实时空气质量监测、自适应风速调节和云端数据可视化的物联网IoT设备。这个项目的核心在于利用Adafruit的FunHouse开发板内置ESP32-S2作为大脑通过CircuitPython这一对开发者极其友好的语言进行编程。系统通过SGP30传感器精准监测空气中的总挥发性有机物TVOC和等效二氧化碳eCO2浓度然后通过EMC2101风扇控制器动态调节一个140mm的PWM风扇转速。当检测到烟雾或污染物浓度升高时风扇自动加速快速净化空气浓度降低后风扇则恢复低速静音运行实现节能与降噪。所有数据还能通过Wi-Fi上传到Adafruit IO平台让你在手机或电脑上就能远程查看工作环境的空气质量历史曲线。对于嵌入式开发者和硬件爱好者而言这个项目是一个绝佳的练手机会。它涵盖了从硬件选型、3D打印结构设计、电路焊接、传感器驱动、PWM控制到物联网云服务集成的完整流程。更重要的是CircuitPython的交互式特性和丰富的库支持使得开发和调试过程变得异常简单即使你是嵌入式新手也能跟着一步步实现。下面我将从设计思路、硬件搭建、代码解析到实际调试中的坑点为你完整拆解这个智能烟雾净化器的制作过程。2. 核心硬件选型与设计思路解析2.1 主控板为什么选择Adafruit FunHouse在这个项目中主控板的选择至关重要它需要具备足够的计算能力、丰富的接口、易于编程的环境以及稳定的无线连接。我最终选择了Adafruit FunHouse原因有以下几点首先ESP32-S2芯片提供了完美的平衡。它拥有单核240MHz的Xtensa处理器性能足以流畅运行CircuitPython并处理传感器数据集成的Wi-Fi模块让我们无需额外模块就能连接网络其低功耗特性也适合设备长期插电运行。其次FunHouse的板载设计极大简化了外围电路。它自带一个240x240的彩色TFT显示屏和三个物理按键这为我们实现本地交互显示数据、选择模式省去了大量接线和驱动工作。板上的STEMMA QT连接器更是“神器”采用防反插的JST SH 4Pin接口让连接I2C传感器如SGP30、EMC2101变得像拼积木一样简单避免了焊接错误的风险。最后也是最重要的一点对CircuitPython的极致支持。Adafruit为FunHouse提供了深度优化的CircuitPython固件和库。这意味着我们可以直接通过USB线连接电脑在出现的CIRCUITPY磁盘中像编辑文本文件一样修改code.py代码保存后自动重启运行配合串行REPL交互式解释器实时调试开发体验远超传统的“编译-烧录-调试”循环。这种快速迭代的能力对于需要不断调整参数如风扇响应曲线、数据上传频率的项目来说效率提升是巨大的。2.2 传感器与执行器精准感知与高效响应的组合系统的感知核心是SGP30空气质量传感器。这是一款基于金属氧化物MOX技术的数字气体传感器专门用于检测TVOC和eCO2。我选择它而非更便宜的模拟传感器是因为其内置的校准算法和温度补偿能提供更稳定、可靠的读数并且它直接输出经过处理的数字值单位是ppb和ppm省去了我们进行复杂模拟信号处理和校准的麻烦。它的I2C接口也完美契合STEMMA QT生态系统。执行机构方面我采用了**“一大一小”双风扇方案**。主风扇是一个140mm的Noctua PWM风扇以其出色的风量、静音效果和耐用性著称。通过PWM信号控制其转速可以在10%到100%之间无级调速。小风扇则是一个普通的5V微型风扇它的作用很关键被安装在SGP30传感器正前方持续将周围的空气“推”向传感器气孔确保传感器读取到的是实时、流动的空气样本而不是设备内部停滞的空气从而大幅提升监测的响应速度和准确性。连接这两者的桥梁是EMC2101风扇控制器。这是一个通过I2C控制的PWM风扇驱动芯片。为什么不直接用ESP32-S2的PWM引脚驱动风扇原因有三一是驱动能力ESP32-S2的GPIO引脚驱动电流有限无法直接驱动大功率风扇二是精度EMC2101能提供更精细的PWM控制三是功能扩展EMC2101本身还带有一个温度传感器未来可以扩展为根据设备内部温度来辅助控制风扇增加一层保护逻辑。2.3 结构设计与物联网架构为了让所有部件整洁有序地工作我设计了3D打印的外壳。结构分为前盖、后盖、内部框架和多个安装支架。后盖固定140mm主风扇和进风滤网前盖嵌入活性炭过滤棉用于吸附烟雾中的颗粒和异味内部框架则承载FunHouse主板、EMC2101板和传感器支架。这种模块化设计使得组装、维修和升级都非常方便。整个系统的数据流和控制逻辑清晰明了形成了一个完整的物联网闭环感知层SGP30持续监测空气。决策层FunHouse上的CircuitPython程序读取传感器数据通过一个map_range函数将其映射为风扇目标转速百分比。执行层FunHouse通过I2C向EMC2101发送指令EMC2101输出对应的PWM信号驱动风扇。显示与交互层本地TFT屏幕实时显示浓度和转速三个按钮用于选择是否连接Wi-Fi及上传数据。云平台层数据通过Wi-Fi定期发送至Adafruit IO生成可视化图表实现远程监控。这个架构的优势在于本地闭环控制保证了实时性即使断网净化功能照常工作而云端连接则提供了数据记录和远程观察能力两者互补非常实用。3. 硬件组装与接线全攻略3.1 元器件清单与准备开始动手前请确保你备齐了所有零件。除了项目核心的几大件一些小配件同样关键主控与传感Adafruit FunHouse (ESP32-S2) x1Adafruit SGP30 空气质量传感器 x1Adafruit EMC2101 风扇控制器 x1执行机构Noctua NF-P14s redux-1200 PWM (140mm) 风扇 x15V 微型风扇 (30x30mm或类似) x1结构件3D打印外壳一套包括前盖、后盖、框架、风扇格栅、传感器支架等M3螺丝/螺母/尼龙柱套装M2.5螺丝/螺母套装活性炭过滤棉 (适配前盖尺寸)连接线材STEMMA QT / Qwiic 4芯电缆 (100mm) x1连接FunHouse与EMC2101。STEMMA QT / Qwiic 4芯电缆 (200mm) x1连接EMC2101与SGP30。4芯排线 (约100mm)用于延长Noctua风扇线。2芯排线 (约110mm)用于连接微型风扇。3Pin JST SH端子转杜邦线或直接使用带端子的线用于将风扇连接到FunHouse的端口。工具电烙铁、焊锡、热缩管、剥线钳、螺丝刀、剪线钳。注意在焊接任何线缆前务必先穿好热缩管这是一个看似简单却极易被遗忘而后悔莫及的步骤。我习惯在工作台贴个便签提醒自己“先穿管后焊接”。3.2 风扇线缆改造详解Noctua风扇和微型风扇的原装线缆通常不适合直接连接到我们的系统需要进行定制化改造。对于Noctua PWM风扇4线制 标准的4线分别是黑色(GND)、黄色(12V)、绿色(测速TACH)、蓝色(PWM控制)。我们的目标是将其接入EMC2101控制器和FunHouse的5V电源。裁剪与延长将风扇原线剪短至约5cm焊接上约10cm长的4芯排线。务必做好颜色对应或做好标签如黑-黑黄-红绿-绿蓝-蓝。制作接口延长线的另一端需要制作成可以连接到EMC2101和FunHouse A0端口的形式。你需要将**黑线(GND)和红线(经过改造的5V)合并接入一个3Pin JST端子对应FunHouse A0端口的GND和5V。而绿线(TACH)和蓝线(PWM)**则分别焊接至另一个接插件的对应引脚用于连接EMC2101的TACH和FAN引脚。电压匹配这是关键Noctua风扇标称12V但实际在5V下也能启动并低速运行这对于我们的吸烟场景通常足够且噪音更小。如果你需要最大风量可以考虑通过外部12V电源供电但需要修改电路设计。本项目采用5V驱动简化设计。对于5V微型风扇2线制 这个简单很多。通常红线为正极(5V)黑线为负极(GND)。用一段2芯排线延长后另一端焊接上一个2Pin或3Pin的JST端子用于连接FunHouse的A1端口5V和GND。实操心得焊接风扇线时由于线材较细且可能含有多股漆包线建议先给线头上锡。焊接完成后用万用表通断档仔细检查每一条线路确保没有虚焊、短路特别是电源正负极绝对不能接反否则可能损坏控制器或风扇。3.3 3D打印与机械组装所有结构件的STL文件可以从项目源地址下载。使用PLA材料打印即可无需支撑。打印参数建议层高0.2mm填充率10%-15%Gyroid填充模式在强度和耗材间取得良好平衡打印温度按你使用的PLA规格通常210-220°C热床60°C特别提示——风扇格栅这个部件利用了切片软件的“纯填充”技巧。在切片时将顶面/底面层数设置为0选择你喜欢的填充图案如线条、网格、Gyroid设置10%-20%的填充密度。这样打印出来的就是一个网状格栅既美观又能有效防止异物进入。组装顺序后盖与主风扇使用M4螺丝通常风扇自带或M3螺丝配合螺母将140mm风扇固定在后盖内部。注意风扇方向确保风向是向机箱内吹风将空气从后部吸入经过设备从前部排出。内部框架将PCB安装板用M3螺丝和尼龙柱固定在内部框架上。传感器模块将SGP30传感器用M2.5螺丝固定在传感器支架中心。然后将微型风扇用螺丝固定在支架上使其出风口正对传感器进气孔。最后将这个整体用M3螺丝安装到前盖内侧。电路集成将EMC2101板用M2.5螺丝固定在PCB安装板上。然后将FunHouse主板对齐安装孔用M3螺丝固定。线缆连接用100mm STEMMA线连接FunHouse的STEMMA端口与EMC2101的STEMMA端口。用200mm STEMMA线连接EMC2101的另一个STEMMA端口与SGP30传感器。将改造好的Noctua风扇线缆电源线红、黑插入FunHouse的A0端口注意引脚对应控制线蓝、绿插入EMC2101的对应FAN和TACH引脚。将微型风扇的JST端子插入FunHouse的A1端口。总装将活性炭过滤棉放入前盖的卡槽。先将内部框架组件与后盖组件扣合再将前盖组件扣合到框架上。通常设计为卡扣式无需螺丝方便日后更换滤棉。组装完成后检查所有连接是否牢固线缆是否整齐避免被风扇叶片刮到。4. CircuitPython环境配置与项目代码深度解析4.1 固件烧录与开发环境搭建FunHouse到手后第一步是刷入CircuitPython固件。获取固件访问CircuitPython官网找到Adafruit FunHouse的页面下载最新的.uf2或.bin文件。.uf2方式最简单。进入Bootloader模式用一根数据线确保不是充电线连接FunHouse和电脑。快速双击主板上的Reset按钮。此时电脑上会出现一个名为HOUSEBOOT的U盘。拖放烧录将下载好的.uf2文件直接拖入HOUSEBOOT盘符。完成后设备会自动重启出现一个名为CIRCUITPY的新盘符这表明CircuitPython系统已成功运行。安装库文件项目依赖于多个库。最简单的方法是下载项目的“项目包”Project Bundle它包含了所有必要的库和code.py。解压后将lib文件夹内的所有.mpy文件复制到CIRCUITPY盘符下的lib目录中如果没有就新建一个。同时将项目包中的code.py、.bmp位图文件和字体文件复制到CIRCUITPY盘的根目录。4.2 代码结构与核心逻辑剖析项目的核心代码在code.py中。我们分段来理解其精妙之处。初始化与硬件设置import time import board import simpleio import adafruit_sgp30 import displayio import adafruit_imageload from adafruit_emc2101 import EMC2101 from adafruit_funhouse import FunHouse i2c board.I2C() # 初始化I2C总线 sgp30 adafruit_sgp30.Adafruit_SGP30(i2c) # 初始化SGP30传感器 emc EMC2101(i2c) # 初始化EMC2101风扇控制器 funhouse FunHouse(default_bg0x0F0F00) # 初始化FunHouse对象设置默认背景色代码开头导入所有必需的库。board.I2C()会自动选择硬件I2C引脚。通过adafruit_funhouse库我们可以用非常高级的抽象来控制显示屏、按钮和网络极大简化了代码。状态机与用户界面 这是本项目代码设计的亮点。它没有使用复杂的多线程或异步而是用一个简单的状态机State Machine通过几个布尔变量run,connected,start_up和按钮事件来管理复杂的流程启动、连接网络、主循环。run False # 主程序是否运行 connected False # 是否已连接Wi-Fi并上传数据 start_up False # 是否处于启动连接过程 clock 0 # 用于定时发送数据的计时器程序启动后显示一个启动画面。用户按下中间按钮Select则尝试连接Wi-Fi显示“连接中”画面按下下按钮Down则跳过Wi-Fi连接直接进入主程序。这种设计给了用户灵活的选择权。核心控制算法——数据映射 智能调节的核心在于将传感器读数映射为风扇转速。这里使用了simpleio.map_range()函数。# 使用TVOC读数 (范围假设为10-1000 ppb) 映射到风扇转速百分比 (10-100%) fumes sgp30.TVOC mapped_val simpleio.map_range(fumes, 10, 1000, 10, 100) # 如果使用eCO2读数 (范围假设为400-2500 ppm) # fumes sgp30.eCO2 # mapped_val simpleio.map_range(fumes, 400, 2500, 10, 100) emc.manual_fan_speed int(mapped_val) # 设置风扇转速这里的映射范围10-1000, 400-2500是需要根据你的实际环境校准的关键参数在非常洁净的空气中SGP30的TVOC基线值可能在0-50 ppb而在焊接烟雾附近可能飙升到500 ppb以上。你需要观察REPL串口打印的数值调整映射的输入范围使得风扇在空气良好时低速安静运行在检测到烟雾时能迅速提升到一个有效的净化转速。网络连接与数据上传 连接Wi-Fi的功能被封装在funhouse.network.connect()中需要在settings.toml文件中预先配置好你的Wi-Fi SSID和密码。数据上传则通过两个函数实现def send_fume_data(solder_fumes): funhouse.network.push_to_io(fumes, solder_fumes) def send_fan_data(fan_rpm): funhouse.network.push_to_io(fan-speed, fan_rpm)在主循环中通过检查connected状态和clock计时器每15秒调用一次这些函数将数据推送到Adafruit IO上名为fumes和fan-speed的Feed中。4.3 Adafruit IO云端仪表盘配置硬件和代码就绪后我们需要在云端创建一个数据接收和展示的界面。创建Feeds数据流登录Adafruit IO在“Feeds”页面创建两个新的Feed名称必须与代码中的push_to_io函数调用一致即fumes和fan-speed。创建Dashboard仪表盘在“Dashboards”页面创建一个新的仪表盘例如命名为“Workspace Air Quality”。添加图表块进入刚创建的仪表盘点击“”号或设置图标创建新块Block。选择“Line Chart”折线图。在配置页面勾选上一步创建的fumes和fan-speedFeed可以创建两个独立的图表块也可以在一个图表中显示两条线。设置好图表标题、坐标轴标签等。获取密钥在Adafruit IO的“IO Key”页面你可以找到你的用户名Username和活跃密钥Active Key。这些信息需要填入FunHouse的settings.toml配置文件设备才能被授权上传数据。完成这些步骤后启动设备并连接网络你就能在Adafruit IO的仪表盘上看到实时更新的空气质量与风扇转速曲线了。这种可视化让你能清晰地了解设备的工作状态和历史趋势。5. 调试心得、常见问题与优化建议5.1 上电调试与问题排查组装并烧录程序后第一次上电可能会遇到一些问题。以下是一个系统的排查清单现象可能原因排查步骤与解决方案FunHouse无反应CIRCUITPY盘未出现1. USB线仅为充电线。2. 固件未正确烧录。3. 主板损坏。1. 更换为确认可传输数据的USB线。2. 重新进入Bootloader模式双击Reset检查HOUSEBOOT盘是否出现重新拖入.uf2文件。3. 尝试另一台电脑或USB端口。屏幕亮但无显示/花屏1. 显示库或图形文件缺失。2. 代码中图形初始化错误。1. 检查CIRCUITPY盘根目录下是否有scene1_fume.bmp等位图文件。2. 通过串口REPL如Mu编辑器、Thonny查看是否有Python错误输出。传感器读数始终为0或异常1. I2C接线错误或接触不良。2. 传感器损坏。3. 库文件版本不匹配。1. 检查STEMMA QT线缆是否插紧确认连接顺序为 FunHouse - EMC2101 - SGP30。2. 在REPL中手动输入import board; i2cboard.I2C(); i2c.scan()查看I2C地址是否被识别SGP30地址0x58EMC2101地址0x4C。3. 确保使用的adafruit_sgp30库是最新版。风扇不转1. 电源线接反或未接。2. PWM控制信号问题。3. 风扇最低启动电压不足。1. 用万用表测量连接器是否有5V输出。2. 检查代码中emc.manual_fan_speed是否被成功赋值在REPL中打印mapped_val。3. 尝试将映射的最小输出值从10%提高到20%或30%。某些风扇在极低占空比下无法启动。无法连接Wi-Fi1.settings.toml配置错误。2. 网络环境问题如2.4G/5G频段。3. 路由器屏蔽了新设备。1. 仔细检查CIRCUITPY盘下的settings.toml文件确保CIRCUITPY_WIFI_SSID和CIRCUITPY_WIFI_PASSWORD填写正确注意大小写和特殊字符。2. ESP32-S2通常只支持2.4GHz Wi-Fi请确保连接的是2.4GHz网络。3. 重启路由器或在路由器后台查看是否有新设备被拦截。数据无法上传到Adafruit IO1. Adafruit IO Feed名称不匹配。2. IO密钥错误或配额超限。3. 网络连接不稳定。1. 确认代码中push_to_io的第一个参数与IO上创建的Feed名称完全一致包括大小写。2. 检查settings.toml中的CIRCUITPY_AIO_USERNAME和CIRCUITPY_AIO_KEY。3. 在REPL中查看打印的“data sent”信息是否出现以及是否有连接错误提示。5.2 性能调优与功能扩展建议基础功能运行稳定后你可以考虑以下优化和扩展让这个项目更贴合你的个人需求动态基线校准SGP30传感器需要12小时以上的稳定运行才能建立准确的基线。代码中写死了一个基线值(0x8973, 0x8AAE)这是不准确的。你应该在空气洁净的环境中让设备通电运行至少12小时然后从REPL中读取sgp30.baseline_eCO2和sgp30.baseline_TVOC的值并更新到set_iaq_baseline函数中。更高级的做法是定期将基线值保存到FunHouse的存储中断电后重新加载。控制算法优化当前的线性映射map_range虽然简单但可能不是最优的。例如可以引入一个“死区”阈值当TVOC低于某个值如50ppb时风扇保持最低速或关闭当超过阈值后再按比例或阶梯式增加转速。这可以减少风扇在临界值附近的频繁启停。你还可以尝试加入简单的PID控制让风扇转速的变化更平滑。增加本地报警功能利用FunHouse板载的RGB LEDDotStar或蜂鸣器如果有。当检测到污染物浓度超过安全阈值时让LED闪烁红光或发出提示音提供更直接的本地反馈。集成更多传感器FunHouse还有多余的GPIO和ADC引脚。你可以考虑添加一个温湿度传感器如SHT40同时监测环境舒适度或者添加一个激光粉尘传感器如PMS5003监测PM2.5/PM10颗粒物。在代码中融合多传感器数据制定更复杂的净化策略。降低功耗与离线存储如果你希望它用电池供电需要深入优化。可以在监测到长时间无污染时让ESP32-S2进入深度睡眠模式定时唤醒检测。同时可以将传感器数据先保存到本地文件如CSV格式等连接Wi-Fi后再批量上传到云端避免数据丢失。这个项目就像一个乐高底座核心的物联网框架和硬件交互已经搭建完成。剩下的就看你如何发挥创意用它来解决你工作环境中遇到的实际问题了。从我的体验来看最大的成就感不仅在于它成功运转更在于它实实在在地改善了工作台边的空气并且整个过程充满了学习和探索的乐趣。希望这份详细的拆解能帮助你顺利复现并创造出属于你自己的智能空气净化方案。
