1. 项目概述最近在捣鼓一个挺有意思的小玩意儿一个能“看见”空气质量的桌面摆件。核心想法很简单我们每天呼吸的室内空气里面看不见的挥发性有机化合物TVOC其实挺影响舒适度和健康的但普通传感器只会给你一个冷冰冰的数字。我就想能不能做个设备不仅能量化这些数据还能用一种更直观、甚至带点艺术感的方式把它呈现出来让你一眼就能感知到环境的变化。于是这个基于 Raspberry Pi Pico W 和 SGP40 传感器的室内空气质量监测系统就诞生了。它本质上是一个物联网环境监测节点核心工作是实时测量空气中的 TVOC 指数。但它的特别之处在于输出方式一方面通过两块拼接起来的 64x32 RGB LED 矩阵屏运行着经典的“康威生命游戏”细胞自动机模拟而模拟中“生命细胞”的颜色会根据空气质量实时变化——空气好时是生机勃勃的绿色变差时渐变为警示性的黄色甚至红色。另一方面借助 Pico W 的内置 Wi-Fi它还能托管一个简单的网页服务器让你在手机或电脑上随时查看当前的精确 VOC 指数和空气质量等级。这个项目融合了硬件搭建、嵌入式编程、传感器应用和简单的网络服务算是一个比较综合的微控制器实践。无论你是想深入了解 SGP40 这类数字气体传感器的使用学习如何驱动大型 RGB LED 矩阵还是尝试在资源有限的 Pico W 上实现 Web 服务与复杂图形渲染的共存它都能提供一套完整的参考方案。接下来我会拆解从设计思路、硬件选型、电路焊接、代码编写到最终调试的完整过程并分享其中踩过的坑和总结的经验。2. 核心硬件选型与设计思路解析做一个项目硬件是骨架。选对部件设计合理的连接方式后面写代码和调试才能事半功倍。这个项目的硬件核心就三块大脑主控、鼻子传感器、眼睛显示屏再配上供电和结构件。2.1 主控单元为什么是 Raspberry Pi Pico W主控我用的是Raspberry Pi Pico W。在众多微控制器中选中它主要基于以下几点考量性能与资源的平衡RP2040 双核 Cortex-M0 处理器主频 133MHz对于驱动 RGB 矩阵涉及大量像素数据搬运和时序控制和运行一个简单的 Web 服务器来说性能绰绰有余。264KB 的 SRAM 是关键因为双缓冲的帧缓冲区128x32x2 字节颜色深度按 16位色算需要约 8KB和 Web 服务器相关的缓冲区会占用不少内存Pico W 的内存规模刚好能扛住。内置 Wi-Fi这是选择“W”型号的决定性因素。需要实现远程数据访问Wi-Fi 是最方便、通用的方案。省去了外接 ESP-01s 等模块的麻烦电路更简洁编程接口也统一使用 Arduino 框架下的WiFi库。丰富的 GPIO 与硬件接口驱动 HUB75 接口的 RGB 矩阵需要占用大量 GPIO至少 13 个Pico W 的 26 个多功能 GPIO 口完全能满足需求并且还有专用的硬件 I2C、SPI、PWM 等外设方便连接传感器。成熟的生态与低成本Arduino 框架和 MicroPython 的广泛支持意味着有丰富的库和社区资源。价格也相对亲民是性价比很高的选择。注意驱动高分辨率或高刷新率的 RGB 矩阵对 GPIO 翻转速度有要求。RP2040 的 PIO可编程输入输出是其秘密武器但在这个项目中我们使用了Adafruit_Protomatter库它内部可能优化了 GPIO 操作实测在 128x32 分辨率下动画流畅。2.2 传感核心SGP40 VOC 传感器探针测量 TVOC我选择了Sensirion 的 SGP40。这是一款专为室内空气质量评估设计的金属氧化物MOX气体传感器。它测的是什么SGP40 输出的是一个VOC 指数这是一个无量纲的指标范围通常是 0-500 或更高。它并不是直接测量某种特定气体如甲醛、苯的浓度ppm而是通过传感器对混合 VOC 气体的综合响应经过内部算法和温湿度补偿需要额外传感器数据后生成的一个反映空气污染程度的相对值。数值越低代表空气质量越好。为什么选它相比传统的模拟输出传感器如 MQ 系列SGP40 是数字 I2C 接口输出稳定无需复杂的模拟电路设计和校准。它内置了初步的算法补偿出厂已校准上手简单。而且它的功耗相对较低适合长期监测。重要限制SGP40 的设计目标是室内环境。温度、湿度的剧烈变化或者直接暴露在高浓度污染源如对着传感器喷酒精或粉尘中都会影响其准确性和寿命。所以把它封装在一个带 PG7 电缆接头的探针里既能采样空气又能提供一定的物理保护是个很实用的做法。2.3 显示方案双 RGB LED 矩阵拼接显示部分用了两块64x32 像素的 P3 RGB LED 矩阵屏通过 HUB75 接口并联拼接成一个128x32的长条形屏幕。为什么用 RGB 矩阵目的是为了“可视化”而不是显示文字图表。康威生命游戏需要每个像素点独立控制亮灭和颜色RGB 矩阵屏天生就是为这种点阵图形设计的亮度高色彩鲜艳视觉冲击力强。HUB75 接口解析这是这类矩阵屏的通用接口。它本质上是一个并行接口通过时分复用的方式扫描行来显示图像。主要引脚包括R1, G1, B1, R2, G2, B2RGB 数据线通常控制上半区和下半区的颜色数据。A, B, C, D (有时还有 E)行地址选择线用于选中当前要刷新的行32行需要 5 根地址线但 32高的屏可能只用 A-D。CLK (时钟)数据时钟信号每个上升沿锁存一个像素数据。LAT (锁存)当一行数据发送完毕后一个 LAT 脉冲将数据锁存到输出寄存器。OE (输出使能)低电平时允许 LED 点亮高电平时关闭。通过 PWM 控制 OE 可以有效调节全局亮度。拼接原理两块 64x32 的屏数据接口R1G1B1...ABCD是并联的意味着它们显示的内容在水平方向上是镜像的不这里的关键是时钟信号 CLK 和锁存信号 LAT 是共享的。当控制器发送 128 个像素的数据对应一行后一个 LAT 信号同时更新两块屏的锁存器。这样它们就逻辑上组合成了一个更宽的屏幕。电源5V 和 GND也需要并联供电。2.4 供电设计IP5306 电源管理系统需要稳定的 5V 电源来驱动 Pico W、RGB 矩阵和传感器。RGB 矩阵在全白高亮时电流不小两块屏可能超过 2A。我选择了IP5306这款集成电源管理芯片。IP5306 的优势同步升压将单节锂电池的 3.7V范围 3.0V-4.2V高效升压至稳定的 5.2V输出电流能力高达 2.4A足以带动整个系统。充电管理集成锂电池充电功能支持 1A 充电电流可以通过 Type-C 口直接充电非常方便。电量指示芯片驱动 4 个 LED 来指示电池电量25% 50% 75% 100%对于没有屏幕显示电量的设备很实用。低功耗保护具有电池低电压自动关断功能防止电池过放。电路设计要点围绕 IP5306 的数据手册设计关键外围元件包括功率电感通常 4.7μH-10μH、输入输出电容建议低 ESR 的陶瓷电容如 10μF100nF、以及设置充电电流和升压参数的反馈电阻。电池直接接在BAT和BAT-引脚。2.5 结构设计3D 打印与组装为了让设备整洁可靠我设计了 3D 打印的外壳和支架。主体框架两个长条形的框架用于夹住并固定拼接后的两块 RGB 矩阵屏形成一个坚固的显示单元。驱动板支架位于显示单元背面用于固定集成了 Pico W、IP5306 电路和 HUB75 接口的驱动 PCB。电池板支架同样在背面用于固定装有 18650 电池座的副板。传感器安装位在底部框架上设计了一个圆孔用于安装带 PG7 接头的 SGP40 探针这样传感器可以伸出设备主体更好地采样周围空气也方便走线。这种模块化设计使得组装、维修和升级都很方便。3. 电路设计与 PCB 制作详解有了设计思路下一步就是把原理图变成实实在在的电路板。这部分工作决定了设备的稳定性和可制造性。3.1 驱动板原理图设计驱动板是核心集成了主控、电源、显示接口和传感器接口。电源部分以 IP5306 为核心根据其数据手册搭建标准升压和充电电路。USB输入通过 Type-C 端口接入连接至 IP5306 的VIN和GND用于充电和 5V 直通供电有 USB 时优先用 USB。BAT和BAT-连接一个 JST 插座用于外接电池板。5VOUT输出端除了接大容量的滤波电容如 10μF 陶瓷电容还将其作为系统的主 5V 电源网络5V_SYS。5V_SYS网络需要连接到RGB 矩阵的电源引脚、Pico W 的VSYS引脚这是 Pico W 的宽电压输入引脚范围 1.8V-5.5V、以及 SGP40 传感器的VCC引脚SGP40 工作电压为 1.8V-3.6V注意不能直接接 5V这里需要一个 3.3V LDO 降压。在我的设计中Pico W 的 3.3V 输出引脚被用来给 SGP40 供电。主控与显示接口Raspberry Pi Pico W 通过两个 20pin 的排母焊接在板上。其VBUS接5V_SYSVSYS也接5V_SYS3V3_EN接 3.3VGND接公共地。GPIO 映射这是关键。需要将 Pico W 的特定 GPIO 连接到 HUB75 接口的对应引脚。映射关系基于Adafruit_Protomatter库的示例和 Pico 的引脚能力。我使用的映射如下可根据库要求调整HUB75 引脚Pico W GPIO功能说明R1GPIO2上半区红色数据G1GPIO3上半区绿色数据B1GPIO4上半区蓝色数据R2GPIO5下半区红色数据G2GPIO8下半区绿色数据B2GPIO9下半区蓝色数据AGPIO10行地址线 ABGPIO16行地址线 BCGPIO18行地址线 CDGPIO20行地址线 DCLKGPIO11时钟LATGPIO12锁存OEGPIO13输出使能低电平有效将这些 GPIO 通过排针或焊盘引至一个 2x8 的排针座作为 HUB75 接口。传感器接口SGP40 使用 I2C 通信。Pico W 有多个 I2C 通道我选择了Wire1第二组 I2C其默认引脚是 GPIO26 (SDA) 和 GPIO27 (SCL)。在驱动板上放置一个 4pin 的排针VCC, GND, SDA, SCL其中 VCC 连接到 Pico W 的3V3(OUT)引脚为传感器提供 3.3VSDA 和 SCL 连接到 GPIO26 和 GPIO27并分别接上拉电阻通常 4.7kΩ 或 10kΩ到 3.3V。3.2 电池板原理图设计电池板就简单多了主要是一个 18650 电池座带保护板的话更好其正负极通过导线连接到一个 JST 插头这个插头与驱动板上的电池 JST 插座配对。可以在板上留出安装孔位。3.3 PCB 布局与打样原理图设计完成后进入 PCB 布局阶段。布局原则电源路径优先IP5306 周围的功率电感、输入输出电容要尽量靠近芯片引脚走线要宽而短以减少寄生电感和电阻提高效率减少噪声。数字信号分区将 Pico W、HUB75 接口、I2C 接口相对集中。高速信号线如 HUB75 的 CLK走线尽量短直避免锐角。散热考虑IP5306 在升压大电流时会发热可以在芯片底部铺设大面积接地铜皮并通过过孔连接到背面铜皮帮助散热。安装孔对齐PCB 的安装孔位置必须与 3D 模型中的支架柱位置完全一致。打样与焊接将设计好的 Gerber 文件发给 PCB 制板厂如文中提到的 PCBWay。我选择了白色阻焊层配黑色丝印看起来比较简洁。焊接顺序先贴片SMD后直插THT。贴片焊接对于小批量可以用焊锡膏和热风枪或加热板Reflow Hotplate。用点胶瓶或钢网将焊锡膏涂在焊盘上用镊子仔细放置 IP5306、电容、电阻等贴片元件然后用加热板均匀加热至焊锡熔化回流。冷却后检查是否有虚焊或桥接。直插焊接安装 Type-C 端口、按键、HUB75 排针座、JST 插座和 Pico W 的排母。焊接时注意温度和时长避免损坏插座塑料部分。实操心得焊接 HUB75 这种多引脚排针时可以先将其插入配套的排母中固定再将排母放在焊盘上这样能保证排针垂直于板子。焊接完一边后再检查垂直度没问题再焊另一边。给 Pico W 的排母上锡时锡量要适中避免堵塞孔位导致 Pico 插不进去。4. 软件实现与代码深度剖析硬件组装好后就到了赋予它灵魂的软件部分。代码主要分为三个模块LED 矩阵驱动、SGP40 传感器数据读取、以及 Web 服务器。4.1 开发环境与库准备我使用的是Arduino IDE进行开发需要提前配置好 Raspberry Pi Pico 的开发板支持。安装开发板支持在 Arduino IDE 的“首选项”-“附加开发板管理器网址”中添加https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json。然后在“工具”-“开发板”-“开发板管理器”中搜索“Raspberry Pi Pico”安装 “Raspberry Pi Pico/RP2040 by Earle F. Philhower” 这个包。安装必要的库Adafruit Protomatter用于驱动 HUB75 接口的 RGB 矩阵屏。在库管理中搜索并安装。Adafruit SGP40用于与 SGP40 传感器通信。同样在库管理中安装。WiFi和WebServer这些通常包含在 Pico W 的开发板包中用于网络功能。4.2 主程序框架与初始化主程序 (room_air_quality_monitor.ino) 的骨架如下#include Adafruit_Protomatter.h #include Adafruit_SGP40.h #include Wire.h #include WiFi.h #include WebServer.h // 1. 网络配置 const char* ssid 你的Wi-Fi名称; const char* password 你的Wi-Fi密码; WebServer server(80); // 在80端口创建服务器对象 // 2. 显示硬件引脚定义与矩阵对象初始化 #define PANEL_WIDTH 64 #define PANEL_HEIGHT 32 #define NUM_PANELS 2 #define WIDTH (PANEL_WIDTH * NUM_PANELS) #define HEIGHT PANEL_HEIGHT uint8_t rgbPins[] {2, 3, 4, 5, 8, 9}; // R1,G1,B1,R2,G2,B2 uint8_t addrPins[] {10, 16, 18, 20}; // A,B,C,D uint8_t clockPin 11; uint8_t latchPin 12; uint8_t oePin 13; Adafruit_Protomatter matrix( WIDTH, HEIGHT, 1, // 宽度高度1个位平面颜色深度可增加 rgbPins, sizeof(rgbPins)/sizeof(rgbPins[0]), addrPins, sizeof(addrPins)/sizeof(addrPins[0]), clockPin, latchPin, oePin, true // 使用双缓冲根据性能需求定 ); // 3. 传感器对象初始化 (使用 Wire1) Adafruit_SGP40 sgp; #define SDA_PIN 26 #define SCL_PIN 27 // 4. 康威生命游戏网格 bool grid[WIDTH][HEIGHT]; bool newGrid[WIDTH][HEIGHT]; uint16_t vocIndex 0; uint32_t lastUpdateTime 0; const uint32_t SENSOR_READ_INTERVAL 1000; // 传感器读取间隔1秒 void setup() { Serial.begin(115200); // 初始化 I2C1 (Wire1) 用于传感器 Wire1.setSDA(SDA_PIN); Wire1.setSCL(SCL_PIN); Wire1.begin(); // 初始化矩阵 if (!matrix.begin()) { Serial.println(Matrix init failed!); while (1); } matrix.fillScreen(0); // 清屏 matrix.show(); // 初始化传感器 if (!sgp.begin(Wire1)) { Serial.println(SGP40 init failed!); // 可以在这里让矩阵显示错误提示 } // 连接 Wi-Fi WiFi.begin(ssid, password); matrix.setCursor(5, 12); matrix.print(Connecting...); matrix.show(); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(\nConnected! IP: WiFi.localIP().toString()); matrix.fillScreen(0); matrix.setCursor(5, 12); matrix.print(IP:); matrix.print(WiFi.localIP().toString()); matrix.show(); delay(2000); matrix.fillScreen(0); // 初始化生命游戏网格随机种子 randomSeed(analogRead(0)); // 使用未连接的模拟引脚获取噪声 resetGrid(); // 设置 Web 服务器路由 server.on(/, handleRoot); // 根路径返回网页 server.on(/voc, handleVOC); // API 路径返回纯 VOC 数值 server.begin(); Serial.println(HTTP server started); } void loop() { // 1. 定时读取传感器 if (millis() - lastUpdateTime SENSOR_READ_INTERVAL) { readVOCSensor(); lastUpdateTime millis(); } // 2. 更新并显示生命游戏 updateGameOfLife(); // 3. 处理网络客户端请求 server.handleClient(); // 4. 控制游戏更新速度 delay(100); // 每帧延迟控制模拟速度 }4.3 核心功能模块解析4.3.1 SGP40 数据读取与处理void readVOCSensor() { // SGP40 的 measureVocIndex 函数需要当前的温度和湿度进行补偿 // 为了简化这里假设环境为 25°C 和 50% RH。对于精确测量应连接温湿度传感器如 SHT31。 float temperature 25.0; // 摄氏度 float humidity 50.0; // 相对湿度百分比 vocIndex sgp.measureVocIndex(temperature, humidity); // 可选原始信号值用于调试 // uint16_t rawSignal sgp.measureRaw(temperature, humidity); Serial.print(VOC Index: ); Serial.println(vocIndex); // 根据 VOC 指数决定显示颜色 // 阈值可根据 SGP40 数据手册和实际环境调整 if (vocIndex 100) { currentColor matrix.color565(0, 255, 0); // 绿色 - 优 } else if (vocIndex 200) { currentColor matrix.color565(255, 255, 0); // 黄色 - 良 } else if (vocIndex 400) { currentColor matrix.color565(255, 165, 0); // 橙色 - 中 } else { currentColor matrix.color565(255, 0, 0); // 红色 - 差/劣 } }重要提示measureVocIndex函数需要温度和湿度参数进行补偿以获得更准确的 VOC 指数。在室内环境相对稳定的情况下使用固定值如 25°C, 50% RH是一个可行的简化方案但会引入一定误差。对于追求更高精度的应用强烈建议增加一个 I2C 温湿度传感器如 SHT30、SHT40并实时读取数据传入该函数。4.3.2 康威生命游戏实现康威生命游戏是一个经典的细胞自动机规则简单但能产生复杂模式。我们用它来动态可视化空气质量。void updateGameOfLife() { // 清空下一帧的网格 memset(newGrid, 0, sizeof(newGrid)); // 遍历当前网格的每个细胞 for (int x 0; x WIDTH; x) { for (int y 0; y HEIGHT; y) { int aliveNeighbors countAliveNeighbors(x, y); bool currentState grid[x][y]; // 应用生命游戏规则 if (currentState true) { // 活细胞邻居数小于2孤独或大于3拥挤则死亡 newGrid[x][y] (aliveNeighbors 2 || aliveNeighbors 3); } else { // 死细胞恰好有3个邻居则复活 newGrid[x][y] (aliveNeighbors 3); } // 如果新状态是活的就用当前颜色绘制像素 if (newGrid[x][y]) { matrix.drawPixel(x, y, currentColor); } } } // 将新网格复制到当前网格用于下一次迭代 memcpy(grid, newGrid, sizeof(grid)); matrix.show(); // 更新显示 // 检查网格是否全部死亡如果是则重新随机初始化 if (isGridEmpty()) { resetGrid(); } } int countAliveNeighbors(int x, int y) { int count 0; for (int dx -1; dx 1; dx) { for (int dy -1; dy 1; dy) { if (dx 0 dy 0) continue; // 跳过自身 int nx x dx; int ny y dy; // 处理边界采用环绕边界即视屏幕对边相连 if (nx 0) nx WIDTH - 1; if (nx WIDTH) nx 0; if (ny 0) ny HEIGHT - 1; if (ny HEIGHT) ny 0; if (grid[nx][ny]) { count; } } } return count; } bool isGridEmpty() { for (int x 0; x WIDTH; x) { for (int y 0; y HEIGHT; y) { if (grid[x][y]) return false; } } return true; } void resetGrid() { for (int x 0; x WIDTH; x) { for (int y 0; y HEIGHT; y) { // 以约 25% 的概率初始化活细胞 grid[x][y] (random(100) 25); } } }可视化逻辑空气质量vocIndex不直接影响生命游戏的规则邻居数量而是通过currentColor影响活细胞的显示颜色。这样模拟的动态复杂性保持不变但视觉氛围随空气质量改变。4.3.3 Web 服务器与远程访问Pico W 的 Web 服务器让数据可以远程查看非常实用。void handleRoot() { // 生成一个简单的 HTML 页面 String html Rrawliteral( !DOCTYPE html html head titleRoom Air Quality Monitor/title meta nameviewport contentwidthdevice-width, initial-scale1 style body { font-family: Arial; text-align: center; padding: 20px; background: linear-gradient(to bottom, #f0f9ff, #e1f5fe); } .container { max-width: 500px; margin: auto; background: white; padding: 30px; border-radius: 15px; box-shadow: 0 4px 15px rgba(0,0,0,0.1); } h1 { color: #333; } .voc-value { font-size: 4em; font-weight: bold; margin: 20px 0; color: )rawliteral; // 根据 VOC 值动态改变数字颜色 if (vocIndex 100) html #4CAF50; // 绿 else if (vocIndex 200) html #FFC107; // 黄 else if (vocIndex 400) html #FF9800; // 橙 else html #F44336; // 红 html Rrawliteral(; } .status { font-size: 1.5em; margin-bottom: 30px; } .footer { margin-top: 30px; color: #777; font-size: 0.9em; } /style script function refreshData() { fetch(/voc) .then(response response.text()) .then(voc { document.getElementById(vocIndex).innerText voc; // 根据新值更新颜色和状态 let color #4CAF50; let status Excellent; let v parseInt(voc); if (v 100 v 200) { color#FFC107; statusGood; } else if (v 200 v 400) { color#FF9800; statusModerate; } else if (v 400) { color#F44336; statusPoor/Unhealthy; } document.getElementById(vocIndex).style.color color; document.getElementById(airStatus).innerText Air Quality: status; document.getElementById(airStatus).style.color color; }) .catch(err console.error(Error fetching VOC:, err)); } // 页面加载后立即刷新然后每2秒刷新一次 window.onload function() { refreshData(); setInterval(refreshData, 2000); }; /script /head body div classcontainer h1 Room Air Quality/h1 div classvoc-value idvocIndex0/div div classstatus idairStatusAir Quality: Excellent/div pVOC Index (lower is better). Updates every 2 seconds./p div classfooterPowered by Raspberry Pi Pico W SGP40/div /div /body /html )rawliteral; server.send(200, text/html, html); } void handleVOC() { // 返回纯文本的 VOC 数值供前端 JavaScript 获取 server.send(200, text/plain, String(vocIndex)); }这个 Web 页面简洁美观能自动刷新并在手机和电脑上都有良好的显示效果。通过访问 Pico W 获取的 IP 地址就能在浏览器中查看实时数据。5. 系统组装、调试与实测当所有代码编写并上传后就可以进行最后的组装和测试了。5.1 整机组装步骤屏幕拼接将两块 RGB 矩阵屏的 HUB75 接口并排用设计好的 3D 打印框架和螺丝固定形成一个长条形的显示单元。确保连接牢固排针没有弯曲。驱动板安装将焊接好的驱动板用 M2.5 螺丝固定在背面的支架上。电气连接将拼接好的屏幕的 HUB75 排线连接到驱动板上的 HUB75 接口。注意方向通常排线有红色边对应引脚1。将屏幕的 5V 和 GND 电源线可能有两组连接到驱动板上的 5V 和 GND 焊盘或排针。将 SGP40 探针的线缆穿过底部框架的孔焊接或连接到驱动板上的传感器接口VCC-3.3V, GND-GND, SDA-GPIO26, SCL-GPIO27。将电池板的 JST 插头连接到驱动板的电池 JST 插座。主控与电池将 Raspberry Pi Pico W 插入驱动板的排母。将 18650 电池放入电池座的电池板中。上电测试短按驱动板上的电源按键如果接了的话或者通过 Type-C 口供电。观察 IP5306 的电量指示灯和系统启动情况。5.2 功能调试与问题排查屏幕无显示或花屏检查电源首先用万用表测量驱动板给屏幕的 5V 电压是否稳定。RGB 矩阵功耗大电压跌落可能导致异常。检查接线确认 HUB75 排线连接牢固没有虚接。检查 GPIO 引脚定义是否与代码中完全一致。检查代码确认matrix.begin()成功初始化。尝试运行一个最简单的测试程序如全屏单色排除复杂逻辑的影响。调整 OE 引脚有些矩阵屏的 OE 是低电平有效有些是高电平。尝试在代码初始化矩阵对象时将oePin的极性反转如果库支持或者物理上换一个引脚试试。SGP40 读取失败检查接线确认 VCC 是 3.3V不是 5VSDA 和 SCL 是否接反上拉电阻是否已接通常 4.7kΩ-10kΩ。检查 I2C 地址使用一个简单的 I2C 扫描程序检查地址0x59是否能被发现。检查库和初始化确保使用了正确的Adafruit_SGP40库并且begin()函数传入了正确的Wire对象这里是Wire1。Wi-Fi 连接失败检查凭证确认代码中的ssid和password正确且网络是 2.4GHzPico W 不支持 5GHz。查看串口输出通过串口监视器查看连接过程是否有 IP 地址分配成功。信号强度确保设备离路由器不太远。Web 页面无法访问确认 IP在串口监视器中查看打印出的 IP 地址。网络隔离有些路由器会开启“客户端隔离”功能阻止设备间互访。需要关闭此功能或确保手机/电脑与 Pico W 在同一个子网段。防火墙检查电脑或手机的防火墙是否阻止了对该端口的访问。5.3 实际测试与效果组装调试完毕后我将设备挂在墙上进行了实际测试。正常环境在通风良好的房间内VOC 指数通常稳定在 50-120 之间绿色生命游戏模拟流畅运行细胞呈现绿色充满生机。污染测试点燃一支线香放在设备下方。可以观察到 VOC 指数在几分钟内迅速上升超过 200黄色进而超过 400红色。与此同时屏幕上的生命游戏模拟颜色也从绿色逐渐变为黄色、红色。这种视觉变化非常直观比单纯看数字更有冲击力。通风后恢复打开窗户通风VOC 指数会逐渐下降屏幕颜色也随之恢复绿色。这个过程清晰地展示了空气净化措施的效果。Web 访问在同一局域网下的手机或电脑浏览器输入 Pico W 的 IP 地址能立刻看到美观的仪表盘显示当前 VOC 指数和空气质量等级并且每 2 秒自动更新。6. 项目优化与扩展思路这个基础版本已经实现了核心功能但还有很多可以优化和扩展的地方增加温湿度传感器如前所述为 SGP40 配备一个如 SHT40 的温湿度传感器提供实时补偿数据使 VOC 测量更准确。同时温湿度数据本身也是重要的环境参数可以一并显示在 Web 页面上。数据记录与上传Pico W 的存储空间有限但可以通过 Wi-Fi 定期将 VOC、温湿度数据上传到物联网平台如 ThingSpeak, Blynk, 自建的 MQTT 服务器实现历史数据记录和趋势分析。低功耗优化目前设备一直全速运行。可以修改代码让屏幕和游戏模拟在无人观看时进入低亮度或休眠模式仅定期唤醒读取传感器和更新 Web 数据从而大幅延长电池续航。显示模式多样化除了生命游戏可以增加其他可视化模式如实时波形图、频谱图、或者直接显示数字和等级。通过一个按钮可以切换显示模式。声光报警增加一个蜂鸣器或更响亮的 LED当 VOC 指数超过某个危险阈值时触发声光报警提醒开窗通风。外壳美化设计一个更精致、带有扩散板的外壳让 LED 光线更柔和整体看起来更像一个家居装饰品而非开发板集合。这个项目从构思到实现是一次完整的硬件、软件、结构融合的实践。它不仅仅是一个空气质量检测仪更是一个将数据艺术化表达的尝试。希望这个详细的拆解能为你提供有价值的参考。在实际制作中遇到问题多查数据手册、多利用串口调试大部分难题都能迎刃而解。
基于Raspberry Pi Pico W与SGP40的室内空气质量可视化监测系统
发布时间：2026/5/30 23:46:15
1. 项目概述最近在捣鼓一个挺有意思的小玩意儿一个能“看见”空气质量的桌面摆件。核心想法很简单我们每天呼吸的室内空气里面看不见的挥发性有机化合物TVOC其实挺影响舒适度和健康的但普通传感器只会给你一个冷冰冰的数字。我就想能不能做个设备不仅能量化这些数据还能用一种更直观、甚至带点艺术感的方式把它呈现出来让你一眼就能感知到环境的变化。于是这个基于 Raspberry Pi Pico W 和 SGP40 传感器的室内空气质量监测系统就诞生了。它本质上是一个物联网环境监测节点核心工作是实时测量空气中的 TVOC 指数。但它的特别之处在于输出方式一方面通过两块拼接起来的 64x32 RGB LED 矩阵屏运行着经典的“康威生命游戏”细胞自动机模拟而模拟中“生命细胞”的颜色会根据空气质量实时变化——空气好时是生机勃勃的绿色变差时渐变为警示性的黄色甚至红色。另一方面借助 Pico W 的内置 Wi-Fi它还能托管一个简单的网页服务器让你在手机或电脑上随时查看当前的精确 VOC 指数和空气质量等级。这个项目融合了硬件搭建、嵌入式编程、传感器应用和简单的网络服务算是一个比较综合的微控制器实践。无论你是想深入了解 SGP40 这类数字气体传感器的使用学习如何驱动大型 RGB LED 矩阵还是尝试在资源有限的 Pico W 上实现 Web 服务与复杂图形渲染的共存它都能提供一套完整的参考方案。接下来我会拆解从设计思路、硬件选型、电路焊接、代码编写到最终调试的完整过程并分享其中踩过的坑和总结的经验。2. 核心硬件选型与设计思路解析做一个项目硬件是骨架。选对部件设计合理的连接方式后面写代码和调试才能事半功倍。这个项目的硬件核心就三块大脑主控、鼻子传感器、眼睛显示屏再配上供电和结构件。2.1 主控单元为什么是 Raspberry Pi Pico W主控我用的是Raspberry Pi Pico W。在众多微控制器中选中它主要基于以下几点考量性能与资源的平衡RP2040 双核 Cortex-M0 处理器主频 133MHz对于驱动 RGB 矩阵涉及大量像素数据搬运和时序控制和运行一个简单的 Web 服务器来说性能绰绰有余。264KB 的 SRAM 是关键因为双缓冲的帧缓冲区128x32x2 字节颜色深度按 16位色算需要约 8KB和 Web 服务器相关的缓冲区会占用不少内存Pico W 的内存规模刚好能扛住。内置 Wi-Fi这是选择“W”型号的决定性因素。需要实现远程数据访问Wi-Fi 是最方便、通用的方案。省去了外接 ESP-01s 等模块的麻烦电路更简洁编程接口也统一使用 Arduino 框架下的WiFi库。丰富的 GPIO 与硬件接口驱动 HUB75 接口的 RGB 矩阵需要占用大量 GPIO至少 13 个Pico W 的 26 个多功能 GPIO 口完全能满足需求并且还有专用的硬件 I2C、SPI、PWM 等外设方便连接传感器。成熟的生态与低成本Arduino 框架和 MicroPython 的广泛支持意味着有丰富的库和社区资源。价格也相对亲民是性价比很高的选择。注意驱动高分辨率或高刷新率的 RGB 矩阵对 GPIO 翻转速度有要求。RP2040 的 PIO可编程输入输出是其秘密武器但在这个项目中我们使用了Adafruit_Protomatter库它内部可能优化了 GPIO 操作实测在 128x32 分辨率下动画流畅。2.2 传感核心SGP40 VOC 传感器探针测量 TVOC我选择了Sensirion 的 SGP40。这是一款专为室内空气质量评估设计的金属氧化物MOX气体传感器。它测的是什么SGP40 输出的是一个VOC 指数这是一个无量纲的指标范围通常是 0-500 或更高。它并不是直接测量某种特定气体如甲醛、苯的浓度ppm而是通过传感器对混合 VOC 气体的综合响应经过内部算法和温湿度补偿需要额外传感器数据后生成的一个反映空气污染程度的相对值。数值越低代表空气质量越好。为什么选它相比传统的模拟输出传感器如 MQ 系列SGP40 是数字 I2C 接口输出稳定无需复杂的模拟电路设计和校准。它内置了初步的算法补偿出厂已校准上手简单。而且它的功耗相对较低适合长期监测。重要限制SGP40 的设计目标是室内环境。温度、湿度的剧烈变化或者直接暴露在高浓度污染源如对着传感器喷酒精或粉尘中都会影响其准确性和寿命。所以把它封装在一个带 PG7 电缆接头的探针里既能采样空气又能提供一定的物理保护是个很实用的做法。2.3 显示方案双 RGB LED 矩阵拼接显示部分用了两块64x32 像素的 P3 RGB LED 矩阵屏通过 HUB75 接口并联拼接成一个128x32的长条形屏幕。为什么用 RGB 矩阵目的是为了“可视化”而不是显示文字图表。康威生命游戏需要每个像素点独立控制亮灭和颜色RGB 矩阵屏天生就是为这种点阵图形设计的亮度高色彩鲜艳视觉冲击力强。HUB75 接口解析这是这类矩阵屏的通用接口。它本质上是一个并行接口通过时分复用的方式扫描行来显示图像。主要引脚包括R1, G1, B1, R2, G2, B2RGB 数据线通常控制上半区和下半区的颜色数据。A, B, C, D (有时还有 E)行地址选择线用于选中当前要刷新的行32行需要 5 根地址线但 32高的屏可能只用 A-D。CLK (时钟)数据时钟信号每个上升沿锁存一个像素数据。LAT (锁存)当一行数据发送完毕后一个 LAT 脉冲将数据锁存到输出寄存器。OE (输出使能)低电平时允许 LED 点亮高电平时关闭。通过 PWM 控制 OE 可以有效调节全局亮度。拼接原理两块 64x32 的屏数据接口R1G1B1...ABCD是并联的意味着它们显示的内容在水平方向上是镜像的不这里的关键是时钟信号 CLK 和锁存信号 LAT 是共享的。当控制器发送 128 个像素的数据对应一行后一个 LAT 信号同时更新两块屏的锁存器。这样它们就逻辑上组合成了一个更宽的屏幕。电源5V 和 GND也需要并联供电。2.4 供电设计IP5306 电源管理系统需要稳定的 5V 电源来驱动 Pico W、RGB 矩阵和传感器。RGB 矩阵在全白高亮时电流不小两块屏可能超过 2A。我选择了IP5306这款集成电源管理芯片。IP5306 的优势同步升压将单节锂电池的 3.7V范围 3.0V-4.2V高效升压至稳定的 5.2V输出电流能力高达 2.4A足以带动整个系统。充电管理集成锂电池充电功能支持 1A 充电电流可以通过 Type-C 口直接充电非常方便。电量指示芯片驱动 4 个 LED 来指示电池电量25% 50% 75% 100%对于没有屏幕显示电量的设备很实用。低功耗保护具有电池低电压自动关断功能防止电池过放。电路设计要点围绕 IP5306 的数据手册设计关键外围元件包括功率电感通常 4.7μH-10μH、输入输出电容建议低 ESR 的陶瓷电容如 10μF100nF、以及设置充电电流和升压参数的反馈电阻。电池直接接在BAT和BAT-引脚。2.5 结构设计3D 打印与组装为了让设备整洁可靠我设计了 3D 打印的外壳和支架。主体框架两个长条形的框架用于夹住并固定拼接后的两块 RGB 矩阵屏形成一个坚固的显示单元。驱动板支架位于显示单元背面用于固定集成了 Pico W、IP5306 电路和 HUB75 接口的驱动 PCB。电池板支架同样在背面用于固定装有 18650 电池座的副板。传感器安装位在底部框架上设计了一个圆孔用于安装带 PG7 接头的 SGP40 探针这样传感器可以伸出设备主体更好地采样周围空气也方便走线。这种模块化设计使得组装、维修和升级都很方便。3. 电路设计与 PCB 制作详解有了设计思路下一步就是把原理图变成实实在在的电路板。这部分工作决定了设备的稳定性和可制造性。3.1 驱动板原理图设计驱动板是核心集成了主控、电源、显示接口和传感器接口。电源部分以 IP5306 为核心根据其数据手册搭建标准升压和充电电路。USB输入通过 Type-C 端口接入连接至 IP5306 的VIN和GND用于充电和 5V 直通供电有 USB 时优先用 USB。BAT和BAT-连接一个 JST 插座用于外接电池板。5VOUT输出端除了接大容量的滤波电容如 10μF 陶瓷电容还将其作为系统的主 5V 电源网络5V_SYS。5V_SYS网络需要连接到RGB 矩阵的电源引脚、Pico W 的VSYS引脚这是 Pico W 的宽电压输入引脚范围 1.8V-5.5V、以及 SGP40 传感器的VCC引脚SGP40 工作电压为 1.8V-3.6V注意不能直接接 5V这里需要一个 3.3V LDO 降压。在我的设计中Pico W 的 3.3V 输出引脚被用来给 SGP40 供电。主控与显示接口Raspberry Pi Pico W 通过两个 20pin 的排母焊接在板上。其VBUS接5V_SYSVSYS也接5V_SYS3V3_EN接 3.3VGND接公共地。GPIO 映射这是关键。需要将 Pico W 的特定 GPIO 连接到 HUB75 接口的对应引脚。映射关系基于Adafruit_Protomatter库的示例和 Pico 的引脚能力。我使用的映射如下可根据库要求调整HUB75 引脚Pico W GPIO功能说明R1GPIO2上半区红色数据G1GPIO3上半区绿色数据B1GPIO4上半区蓝色数据R2GPIO5下半区红色数据G2GPIO8下半区绿色数据B2GPIO9下半区蓝色数据AGPIO10行地址线 ABGPIO16行地址线 BCGPIO18行地址线 CDGPIO20行地址线 DCLKGPIO11时钟LATGPIO12锁存OEGPIO13输出使能低电平有效将这些 GPIO 通过排针或焊盘引至一个 2x8 的排针座作为 HUB75 接口。传感器接口SGP40 使用 I2C 通信。Pico W 有多个 I2C 通道我选择了Wire1第二组 I2C其默认引脚是 GPIO26 (SDA) 和 GPIO27 (SCL)。在驱动板上放置一个 4pin 的排针VCC, GND, SDA, SCL其中 VCC 连接到 Pico W 的3V3(OUT)引脚为传感器提供 3.3VSDA 和 SCL 连接到 GPIO26 和 GPIO27并分别接上拉电阻通常 4.7kΩ 或 10kΩ到 3.3V。3.2 电池板原理图设计电池板就简单多了主要是一个 18650 电池座带保护板的话更好其正负极通过导线连接到一个 JST 插头这个插头与驱动板上的电池 JST 插座配对。可以在板上留出安装孔位。3.3 PCB 布局与打样原理图设计完成后进入 PCB 布局阶段。布局原则电源路径优先IP5306 周围的功率电感、输入输出电容要尽量靠近芯片引脚走线要宽而短以减少寄生电感和电阻提高效率减少噪声。数字信号分区将 Pico W、HUB75 接口、I2C 接口相对集中。高速信号线如 HUB75 的 CLK走线尽量短直避免锐角。散热考虑IP5306 在升压大电流时会发热可以在芯片底部铺设大面积接地铜皮并通过过孔连接到背面铜皮帮助散热。安装孔对齐PCB 的安装孔位置必须与 3D 模型中的支架柱位置完全一致。打样与焊接将设计好的 Gerber 文件发给 PCB 制板厂如文中提到的 PCBWay。我选择了白色阻焊层配黑色丝印看起来比较简洁。焊接顺序先贴片SMD后直插THT。贴片焊接对于小批量可以用焊锡膏和热风枪或加热板Reflow Hotplate。用点胶瓶或钢网将焊锡膏涂在焊盘上用镊子仔细放置 IP5306、电容、电阻等贴片元件然后用加热板均匀加热至焊锡熔化回流。冷却后检查是否有虚焊或桥接。直插焊接安装 Type-C 端口、按键、HUB75 排针座、JST 插座和 Pico W 的排母。焊接时注意温度和时长避免损坏插座塑料部分。实操心得焊接 HUB75 这种多引脚排针时可以先将其插入配套的排母中固定再将排母放在焊盘上这样能保证排针垂直于板子。焊接完一边后再检查垂直度没问题再焊另一边。给 Pico W 的排母上锡时锡量要适中避免堵塞孔位导致 Pico 插不进去。4. 软件实现与代码深度剖析硬件组装好后就到了赋予它灵魂的软件部分。代码主要分为三个模块LED 矩阵驱动、SGP40 传感器数据读取、以及 Web 服务器。4.1 开发环境与库准备我使用的是Arduino IDE进行开发需要提前配置好 Raspberry Pi Pico 的开发板支持。安装开发板支持在 Arduino IDE 的“首选项”-“附加开发板管理器网址”中添加https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json。然后在“工具”-“开发板”-“开发板管理器”中搜索“Raspberry Pi Pico”安装 “Raspberry Pi Pico/RP2040 by Earle F. Philhower” 这个包。安装必要的库Adafruit Protomatter用于驱动 HUB75 接口的 RGB 矩阵屏。在库管理中搜索并安装。Adafruit SGP40用于与 SGP40 传感器通信。同样在库管理中安装。WiFi和WebServer这些通常包含在 Pico W 的开发板包中用于网络功能。4.2 主程序框架与初始化主程序 (room_air_quality_monitor.ino) 的骨架如下#include Adafruit_Protomatter.h #include Adafruit_SGP40.h #include Wire.h #include WiFi.h #include WebServer.h // 1. 网络配置 const char* ssid 你的Wi-Fi名称; const char* password 你的Wi-Fi密码; WebServer server(80); // 在80端口创建服务器对象 // 2. 显示硬件引脚定义与矩阵对象初始化 #define PANEL_WIDTH 64 #define PANEL_HEIGHT 32 #define NUM_PANELS 2 #define WIDTH (PANEL_WIDTH * NUM_PANELS) #define HEIGHT PANEL_HEIGHT uint8_t rgbPins[] {2, 3, 4, 5, 8, 9}; // R1,G1,B1,R2,G2,B2 uint8_t addrPins[] {10, 16, 18, 20}; // A,B,C,D uint8_t clockPin 11; uint8_t latchPin 12; uint8_t oePin 13; Adafruit_Protomatter matrix( WIDTH, HEIGHT, 1, // 宽度高度1个位平面颜色深度可增加 rgbPins, sizeof(rgbPins)/sizeof(rgbPins[0]), addrPins, sizeof(addrPins)/sizeof(addrPins[0]), clockPin, latchPin, oePin, true // 使用双缓冲根据性能需求定 ); // 3. 传感器对象初始化 (使用 Wire1) Adafruit_SGP40 sgp; #define SDA_PIN 26 #define SCL_PIN 27 // 4. 康威生命游戏网格 bool grid[WIDTH][HEIGHT]; bool newGrid[WIDTH][HEIGHT]; uint16_t vocIndex 0; uint32_t lastUpdateTime 0; const uint32_t SENSOR_READ_INTERVAL 1000; // 传感器读取间隔1秒 void setup() { Serial.begin(115200); // 初始化 I2C1 (Wire1) 用于传感器 Wire1.setSDA(SDA_PIN); Wire1.setSCL(SCL_PIN); Wire1.begin(); // 初始化矩阵 if (!matrix.begin()) { Serial.println(Matrix init failed!); while (1); } matrix.fillScreen(0); // 清屏 matrix.show(); // 初始化传感器 if (!sgp.begin(Wire1)) { Serial.println(SGP40 init failed!); // 可以在这里让矩阵显示错误提示 } // 连接 Wi-Fi WiFi.begin(ssid, password); matrix.setCursor(5, 12); matrix.print(Connecting...); matrix.show(); while (WiFi.status() ! WL_CONNECTED) { delay(500); Serial.print(.); } Serial.println(\nConnected! IP: WiFi.localIP().toString()); matrix.fillScreen(0); matrix.setCursor(5, 12); matrix.print(IP:); matrix.print(WiFi.localIP().toString()); matrix.show(); delay(2000); matrix.fillScreen(0); // 初始化生命游戏网格随机种子 randomSeed(analogRead(0)); // 使用未连接的模拟引脚获取噪声 resetGrid(); // 设置 Web 服务器路由 server.on(/, handleRoot); // 根路径返回网页 server.on(/voc, handleVOC); // API 路径返回纯 VOC 数值 server.begin(); Serial.println(HTTP server started); } void loop() { // 1. 定时读取传感器 if (millis() - lastUpdateTime SENSOR_READ_INTERVAL) { readVOCSensor(); lastUpdateTime millis(); } // 2. 更新并显示生命游戏 updateGameOfLife(); // 3. 处理网络客户端请求 server.handleClient(); // 4. 控制游戏更新速度 delay(100); // 每帧延迟控制模拟速度 }4.3 核心功能模块解析4.3.1 SGP40 数据读取与处理void readVOCSensor() { // SGP40 的 measureVocIndex 函数需要当前的温度和湿度进行补偿 // 为了简化这里假设环境为 25°C 和 50% RH。对于精确测量应连接温湿度传感器如 SHT31。 float temperature 25.0; // 摄氏度 float humidity 50.0; // 相对湿度百分比 vocIndex sgp.measureVocIndex(temperature, humidity); // 可选原始信号值用于调试 // uint16_t rawSignal sgp.measureRaw(temperature, humidity); Serial.print(VOC Index: ); Serial.println(vocIndex); // 根据 VOC 指数决定显示颜色 // 阈值可根据 SGP40 数据手册和实际环境调整 if (vocIndex 100) { currentColor matrix.color565(0, 255, 0); // 绿色 - 优 } else if (vocIndex 200) { currentColor matrix.color565(255, 255, 0); // 黄色 - 良 } else if (vocIndex 400) { currentColor matrix.color565(255, 165, 0); // 橙色 - 中 } else { currentColor matrix.color565(255, 0, 0); // 红色 - 差/劣 } }重要提示measureVocIndex函数需要温度和湿度参数进行补偿以获得更准确的 VOC 指数。在室内环境相对稳定的情况下使用固定值如 25°C, 50% RH是一个可行的简化方案但会引入一定误差。对于追求更高精度的应用强烈建议增加一个 I2C 温湿度传感器如 SHT30、SHT40并实时读取数据传入该函数。4.3.2 康威生命游戏实现康威生命游戏是一个经典的细胞自动机规则简单但能产生复杂模式。我们用它来动态可视化空气质量。void updateGameOfLife() { // 清空下一帧的网格 memset(newGrid, 0, sizeof(newGrid)); // 遍历当前网格的每个细胞 for (int x 0; x WIDTH; x) { for (int y 0; y HEIGHT; y) { int aliveNeighbors countAliveNeighbors(x, y); bool currentState grid[x][y]; // 应用生命游戏规则 if (currentState true) { // 活细胞邻居数小于2孤独或大于3拥挤则死亡 newGrid[x][y] (aliveNeighbors 2 || aliveNeighbors 3); } else { // 死细胞恰好有3个邻居则复活 newGrid[x][y] (aliveNeighbors 3); } // 如果新状态是活的就用当前颜色绘制像素 if (newGrid[x][y]) { matrix.drawPixel(x, y, currentColor); } } } // 将新网格复制到当前网格用于下一次迭代 memcpy(grid, newGrid, sizeof(grid)); matrix.show(); // 更新显示 // 检查网格是否全部死亡如果是则重新随机初始化 if (isGridEmpty()) { resetGrid(); } } int countAliveNeighbors(int x, int y) { int count 0; for (int dx -1; dx 1; dx) { for (int dy -1; dy 1; dy) { if (dx 0 dy 0) continue; // 跳过自身 int nx x dx; int ny y dy; // 处理边界采用环绕边界即视屏幕对边相连 if (nx 0) nx WIDTH - 1; if (nx WIDTH) nx 0; if (ny 0) ny HEIGHT - 1; if (ny HEIGHT) ny 0; if (grid[nx][ny]) { count; } } } return count; } bool isGridEmpty() { for (int x 0; x WIDTH; x) { for (int y 0; y HEIGHT; y) { if (grid[x][y]) return false; } } return true; } void resetGrid() { for (int x 0; x WIDTH; x) { for (int y 0; y HEIGHT; y) { // 以约 25% 的概率初始化活细胞 grid[x][y] (random(100) 25); } } }可视化逻辑空气质量vocIndex不直接影响生命游戏的规则邻居数量而是通过currentColor影响活细胞的显示颜色。这样模拟的动态复杂性保持不变但视觉氛围随空气质量改变。4.3.3 Web 服务器与远程访问Pico W 的 Web 服务器让数据可以远程查看非常实用。void handleRoot() { // 生成一个简单的 HTML 页面 String html Rrawliteral( !DOCTYPE html html head titleRoom Air Quality Monitor/title meta nameviewport contentwidthdevice-width, initial-scale1 style body { font-family: Arial; text-align: center; padding: 20px; background: linear-gradient(to bottom, #f0f9ff, #e1f5fe); } .container { max-width: 500px; margin: auto; background: white; padding: 30px; border-radius: 15px; box-shadow: 0 4px 15px rgba(0,0,0,0.1); } h1 { color: #333; } .voc-value { font-size: 4em; font-weight: bold; margin: 20px 0; color: )rawliteral; // 根据 VOC 值动态改变数字颜色 if (vocIndex 100) html #4CAF50; // 绿 else if (vocIndex 200) html #FFC107; // 黄 else if (vocIndex 400) html #FF9800; // 橙 else html #F44336; // 红 html Rrawliteral(; } .status { font-size: 1.5em; margin-bottom: 30px; } .footer { margin-top: 30px; color: #777; font-size: 0.9em; } /style script function refreshData() { fetch(/voc) .then(response response.text()) .then(voc { document.getElementById(vocIndex).innerText voc; // 根据新值更新颜色和状态 let color #4CAF50; let status Excellent; let v parseInt(voc); if (v 100 v 200) { color#FFC107; statusGood; } else if (v 200 v 400) { color#FF9800; statusModerate; } else if (v 400) { color#F44336; statusPoor/Unhealthy; } document.getElementById(vocIndex).style.color color; document.getElementById(airStatus).innerText Air Quality: status; document.getElementById(airStatus).style.color color; }) .catch(err console.error(Error fetching VOC:, err)); } // 页面加载后立即刷新然后每2秒刷新一次 window.onload function() { refreshData(); setInterval(refreshData, 2000); }; /script /head body div classcontainer h1 Room Air Quality/h1 div classvoc-value idvocIndex0/div div classstatus idairStatusAir Quality: Excellent/div pVOC Index (lower is better). Updates every 2 seconds./p div classfooterPowered by Raspberry Pi Pico W SGP40/div /div /body /html )rawliteral; server.send(200, text/html, html); } void handleVOC() { // 返回纯文本的 VOC 数值供前端 JavaScript 获取 server.send(200, text/plain, String(vocIndex)); }这个 Web 页面简洁美观能自动刷新并在手机和电脑上都有良好的显示效果。通过访问 Pico W 获取的 IP 地址就能在浏览器中查看实时数据。5. 系统组装、调试与实测当所有代码编写并上传后就可以进行最后的组装和测试了。5.1 整机组装步骤屏幕拼接将两块 RGB 矩阵屏的 HUB75 接口并排用设计好的 3D 打印框架和螺丝固定形成一个长条形的显示单元。确保连接牢固排针没有弯曲。驱动板安装将焊接好的驱动板用 M2.5 螺丝固定在背面的支架上。电气连接将拼接好的屏幕的 HUB75 排线连接到驱动板上的 HUB75 接口。注意方向通常排线有红色边对应引脚1。将屏幕的 5V 和 GND 电源线可能有两组连接到驱动板上的 5V 和 GND 焊盘或排针。将 SGP40 探针的线缆穿过底部框架的孔焊接或连接到驱动板上的传感器接口VCC-3.3V, GND-GND, SDA-GPIO26, SCL-GPIO27。将电池板的 JST 插头连接到驱动板的电池 JST 插座。主控与电池将 Raspberry Pi Pico W 插入驱动板的排母。将 18650 电池放入电池座的电池板中。上电测试短按驱动板上的电源按键如果接了的话或者通过 Type-C 口供电。观察 IP5306 的电量指示灯和系统启动情况。5.2 功能调试与问题排查屏幕无显示或花屏检查电源首先用万用表测量驱动板给屏幕的 5V 电压是否稳定。RGB 矩阵功耗大电压跌落可能导致异常。检查接线确认 HUB75 排线连接牢固没有虚接。检查 GPIO 引脚定义是否与代码中完全一致。检查代码确认matrix.begin()成功初始化。尝试运行一个最简单的测试程序如全屏单色排除复杂逻辑的影响。调整 OE 引脚有些矩阵屏的 OE 是低电平有效有些是高电平。尝试在代码初始化矩阵对象时将oePin的极性反转如果库支持或者物理上换一个引脚试试。SGP40 读取失败检查接线确认 VCC 是 3.3V不是 5VSDA 和 SCL 是否接反上拉电阻是否已接通常 4.7kΩ-10kΩ。检查 I2C 地址使用一个简单的 I2C 扫描程序检查地址0x59是否能被发现。检查库和初始化确保使用了正确的Adafruit_SGP40库并且begin()函数传入了正确的Wire对象这里是Wire1。Wi-Fi 连接失败检查凭证确认代码中的ssid和password正确且网络是 2.4GHzPico W 不支持 5GHz。查看串口输出通过串口监视器查看连接过程是否有 IP 地址分配成功。信号强度确保设备离路由器不太远。Web 页面无法访问确认 IP在串口监视器中查看打印出的 IP 地址。网络隔离有些路由器会开启“客户端隔离”功能阻止设备间互访。需要关闭此功能或确保手机/电脑与 Pico W 在同一个子网段。防火墙检查电脑或手机的防火墙是否阻止了对该端口的访问。5.3 实际测试与效果组装调试完毕后我将设备挂在墙上进行了实际测试。正常环境在通风良好的房间内VOC 指数通常稳定在 50-120 之间绿色生命游戏模拟流畅运行细胞呈现绿色充满生机。污染测试点燃一支线香放在设备下方。可以观察到 VOC 指数在几分钟内迅速上升超过 200黄色进而超过 400红色。与此同时屏幕上的生命游戏模拟颜色也从绿色逐渐变为黄色、红色。这种视觉变化非常直观比单纯看数字更有冲击力。通风后恢复打开窗户通风VOC 指数会逐渐下降屏幕颜色也随之恢复绿色。这个过程清晰地展示了空气净化措施的效果。Web 访问在同一局域网下的手机或电脑浏览器输入 Pico W 的 IP 地址能立刻看到美观的仪表盘显示当前 VOC 指数和空气质量等级并且每 2 秒自动更新。6. 项目优化与扩展思路这个基础版本已经实现了核心功能但还有很多可以优化和扩展的地方增加温湿度传感器如前所述为 SGP40 配备一个如 SHT40 的温湿度传感器提供实时补偿数据使 VOC 测量更准确。同时温湿度数据本身也是重要的环境参数可以一并显示在 Web 页面上。数据记录与上传Pico W 的存储空间有限但可以通过 Wi-Fi 定期将 VOC、温湿度数据上传到物联网平台如 ThingSpeak, Blynk, 自建的 MQTT 服务器实现历史数据记录和趋势分析。低功耗优化目前设备一直全速运行。可以修改代码让屏幕和游戏模拟在无人观看时进入低亮度或休眠模式仅定期唤醒读取传感器和更新 Web 数据从而大幅延长电池续航。显示模式多样化除了生命游戏可以增加其他可视化模式如实时波形图、频谱图、或者直接显示数字和等级。通过一个按钮可以切换显示模式。声光报警增加一个蜂鸣器或更响亮的 LED当 VOC 指数超过某个危险阈值时触发声光报警提醒开窗通风。外壳美化设计一个更精致、带有扩散板的外壳让 LED 光线更柔和整体看起来更像一个家居装饰品而非开发板集合。这个项目从构思到实现是一次完整的硬件、软件、结构融合的实践。它不仅仅是一个空气质量检测仪更是一个将数据艺术化表达的尝试。希望这个详细的拆解能为你提供有价值的参考。在实际制作中遇到问题多查数据手册、多利用串口调试大部分难题都能迎刃而解。
