用Arduino和SGP30传感器打造智能空气质量监测系统在居家办公和健康生活日益受到重视的今天室内空气质量直接影响着我们的工作效率和身体健康。CO2浓度过高会导致注意力不集中、头晕乏力而TVOC总挥发性有机物则可能引发过敏反应甚至长期健康问题。传统空气质量检测设备动辄上千元的价格让普通家庭望而却步而借助Arduino开源平台和SGP30传感器我们可以用不到200元的成本搭建一个功能完备的空气质量监测系统。这个项目特别适合电子爱好者和Arduino初学者不需要复杂的电路知识通过简单的接线和现成的代码库就能快速实现。我们将使用常见的Arduino Uno/Nano开发板搭配Sensirion的SGP30气体传感器这个指甲盖大小的芯片能够同时检测CO2和TVOC浓度精度足以满足日常监测需求。整个系统可以方便地放置在书桌、卧室或客厅通过LCD屏幕或手机APP实时查看数据变化。1. 硬件准备与接线指南1.1 所需材料清单构建这个空气质量监测系统需要以下核心组件主控板Arduino Uno R3或Nano推荐使用正版或质量可靠的兼容板气体传感器SGP30模块建议选择带电平转换的成品模块显示设备可选0.96寸OLED显示屏I2C接口1602 LCD屏需额外配I2C转接板连接线杜邦线若干建议使用优质线材避免接触不良电源5V USB电源或9V电池长期使用建议接移动电源提示购买SGP30模块时注意检查是否包含4.7kΩ上拉电阻部分廉价模块可能省略导致通信不稳定。1.2 硬件接线详解SGP30采用标准的I2C通信协议接线非常简单只需连接4根线Arduino引脚SGP30引脚功能说明5VVCC电源正极3.3V-5V兼容GNDGND电源地A4/SDASDAI2C数据线A5/SCLSCLI2C时钟线如果添加OLED显示屏可以共享I2C总线Arduino Uno ────┬──── SGP30 ├──── OLED (SCL接A5SDA接A4) └──── 注意所有设备共地实际接线时建议使用不同颜色的杜邦线区分功能红色接VCC黑色接GND黄色和绿色分别接SDA和SCL。这种颜色编码规范可以大幅降低接错线的概率特别是在使用多个I2C设备时。2. 软件环境配置与库安装2.1 Arduino IDE基础设置在开始编程前需要确保开发环境正确配置下载安装最新版Arduino IDE当前推荐1.8.19在工具→开发板中选择对应的Arduino型号Uno或Nano对于Nano用户还需在工具→处理器中选择正确版本通常为ATmega328P注意如果使用克隆板可能需要安装CH340G驱动Windows用户可从官网获取驱动。2.2 必备库的安装与管理SGP30传感器需要Adafruit提供的专用库支持打开Arduino IDE点击工具→管理库...搜索Adafruit SGP30并安装最新版本当前推荐2.1.0同时安装依赖库Adafruit BusIO和Adafruit Sensor如果计划使用OLED显示还需安装Adafruit SSD1306用于OLED驱动Adafruit GFX图形显示基础库安装完成后可以通过以下代码测试库是否正常工作#include Wire.h #include Adafruit_SGP30.h Adafruit_SGP30 sgp; void setup() { Serial.begin(9600); if (!sgp.begin()) { Serial.println(Sensor not found :(); while (1); } Serial.println(SGP30 ready!); }3. 核心代码实现与解析3.1 基础数据读取框架SGP30传感器需要约15秒的初始化时间在此期间读取的值CO2400ppmTVOC0ppb无效。以下是稳定读取数据的核心代码结构#include Adafruit_SGP30.h Adafruit_SGP30 sgp; uint32_t lastMeasurement 0; void setup() { Serial.begin(115200); while (!Serial) delay(10); // Wait for serial monitor if (!sgp.begin()) { Serial.println(Sensor initialization failed); while (1); } Serial.println(SGP30 initialized); } void loop() { if (millis() - lastMeasurement 1000) { // 每秒读取一次 if (!sgp.IAQmeasure()) { Serial.println(Measurement failed); return; } Serial.print(CO2: ); Serial.print(sgp.eCO2); Serial.print( ppm\t); Serial.print(TVOC: ); Serial.print(sgp.TVOC); Serial.print( ppb\n); lastMeasurement millis(); } }3.2 数据校准与基线设置SGP30的独特之处在于其算法会随着使用时间自动优化读数准确性。为了获得最佳性能建议在每次启动时恢复之前的基线值uint16_t TVOC_base, eCO2_base; void saveBaseline() { sgp.getIAQBaseline(eCO2_base, TVOC_base); // 这里应该将基线值保存到EEPROM或文件系统 } void loadBaseline() { // 从存储介质读取基线值 if (eCO2_base ! 0 TVOC_base ! 0) { sgp.setIAQBaseline(eCO2_base, TVOC_base); } }在setup()中添加loadBaseline()调用并在适当时间如每12小时调用saveBaseline()。这种处理可以使传感器在断电重启后快速恢复到之前的校准状态避免重新适应环境的过程。4. 系统功能扩展与优化4.1 添加OLED实时显示将数据输出到0.96寸OLED屏可以摆脱对电脑的依赖制作真正的独立设备。以下是扩展显示功能的代码示例#include Adafruit_SSD1306.h #include Adafruit_GFX.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire); void setupDisplay() { if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(OLED allocation failed); for(;;); } display.display(); delay(2000); display.clearDisplay(); } void updateDisplay(int co2, int tvoc) { display.clearDisplay(); display.setTextSize(2); display.setTextColor(WHITE); display.setCursor(0,0); display.print(CO2: ); display.print(co2); display.println( ppm); display.setCursor(0,30); display.print(TVOC: ); display.print(tvoc); display.println( ppb); // 添加空气质量评价 display.setTextSize(1); display.setCursor(0,55); if(co2 800) display.print(Air Quality: Excellent); else if(co2 1200) display.print(Air Quality: Good); else display.print(Air Quality: Poor); display.display(); }4.2 数据记录与可视化通过串口将数据输出到电脑可以利用Arduino IDE的串口绘图工具或第三方软件进行可视化void sendToSerial(int co2, int tvoc) { Serial.print(DATA,); Serial.print(millis()/1000); Serial.print(,); Serial.print(co2); Serial.print(,); Serial.println(tvoc); }在串口监视器中设置换行符和115200波特率数据将以CSV格式输出可直接导入Excel或Python进行进一步分析。对于长期监测可以考虑添加SD卡模块实现离线数据记录。4.3 报警功能实现当空气质量达到警戒值时可以通过蜂鸣器或LED发出警示#define BUZZER_PIN 8 #define LED_PIN 13 void checkAlarm(int co2, int tvoc) { static bool alarmOn false; if(co2 1500 || tvoc 500) { if(!alarmOn) { tone(BUZZER_PIN, 1000, 500); digitalWrite(LED_PIN, HIGH); alarmOn true; } } else { noTone(BUZZER_PIN); digitalWrite(LED_PIN, LOW); alarmOn false; } }更高级的实现可以添加继电器控制在空气质量不佳时自动开启空气净化器或通风设备。5. 项目进阶与实用技巧5.1 外壳设计与电源优化一个完整的项目离不开精心设计的外壳和稳定的电源方案3D打印外壳可在Thingiverse等平台找到现成设计或使用Fusion 360自定义电源管理移动电源供电适合短期使用18650锂电池充电模块平衡体积与续航5V电源适配器长期固定位置使用对于需要超低功耗的应用可以考虑改用Arduino Pro Mini3.3V版本并优化代码#include avr/sleep.h void enterSleep() { set_sleep_mode(SLEEP_MODE_PWR_DOWN); sleep_enable(); sleep_mode(); sleep_disable(); } void loop() { takeMeasurement(); delay(100); // 确保数据发送完成 enterSleep(); // 休眠60秒 delay(60000 - 100); }5.2 多传感器数据融合将SGP30与其他环境传感器结合可以获得更全面的环境监测温湿度传感器DHT22或BME280后者已包含气压测量PM2.5传感器PMS5003或SDS011光线传感器BH1750多传感器集成时建议采用模块化编程方式为每个传感器创建单独的类或库避免主程序过于复杂。同时注意I2C地址冲突问题必要时使用I2C多路复用器如TCA9548A。5.3 物联网扩展通过ESP8266或ESP32模块可以将数据上传到云端实现远程监控#include ESP8266WiFi.h #include WiFiClient.h #include BlynkSimpleEsp8266.h char auth[] YourAuthToken; char ssid[] YourNetwork; char pass[] YourPassword; void setup() { Blynk.begin(auth, ssid, pass); } void loop() { Blynk.run(); if(sgp.IAQmeasure()) { Blynk.virtualWrite(V1, sgp.eCO2); Blynk.virtualWrite(V2, sgp.TVOC); } delay(60000); // 每分钟上传一次 }这种方案可以通过手机APP实时查看家中空气质量并在异常时接收推送通知。对于更复杂的应用可以考虑使用MQTT协议接入Home Assistant或Node-RED等物联网平台。
用Arduino和SGP30传感器DIY一个空气质量监测仪（附完整代码和接线图）
发布时间：2026/5/21 14:14:05
用Arduino和SGP30传感器打造智能空气质量监测系统在居家办公和健康生活日益受到重视的今天室内空气质量直接影响着我们的工作效率和身体健康。CO2浓度过高会导致注意力不集中、头晕乏力而TVOC总挥发性有机物则可能引发过敏反应甚至长期健康问题。传统空气质量检测设备动辄上千元的价格让普通家庭望而却步而借助Arduino开源平台和SGP30传感器我们可以用不到200元的成本搭建一个功能完备的空气质量监测系统。这个项目特别适合电子爱好者和Arduino初学者不需要复杂的电路知识通过简单的接线和现成的代码库就能快速实现。我们将使用常见的Arduino Uno/Nano开发板搭配Sensirion的SGP30气体传感器这个指甲盖大小的芯片能够同时检测CO2和TVOC浓度精度足以满足日常监测需求。整个系统可以方便地放置在书桌、卧室或客厅通过LCD屏幕或手机APP实时查看数据变化。1. 硬件准备与接线指南1.1 所需材料清单构建这个空气质量监测系统需要以下核心组件主控板Arduino Uno R3或Nano推荐使用正版或质量可靠的兼容板气体传感器SGP30模块建议选择带电平转换的成品模块显示设备可选0.96寸OLED显示屏I2C接口1602 LCD屏需额外配I2C转接板连接线杜邦线若干建议使用优质线材避免接触不良电源5V USB电源或9V电池长期使用建议接移动电源提示购买SGP30模块时注意检查是否包含4.7kΩ上拉电阻部分廉价模块可能省略导致通信不稳定。1.2 硬件接线详解SGP30采用标准的I2C通信协议接线非常简单只需连接4根线Arduino引脚SGP30引脚功能说明5VVCC电源正极3.3V-5V兼容GNDGND电源地A4/SDASDAI2C数据线A5/SCLSCLI2C时钟线如果添加OLED显示屏可以共享I2C总线Arduino Uno ────┬──── SGP30 ├──── OLED (SCL接A5SDA接A4) └──── 注意所有设备共地实际接线时建议使用不同颜色的杜邦线区分功能红色接VCC黑色接GND黄色和绿色分别接SDA和SCL。这种颜色编码规范可以大幅降低接错线的概率特别是在使用多个I2C设备时。2. 软件环境配置与库安装2.1 Arduino IDE基础设置在开始编程前需要确保开发环境正确配置下载安装最新版Arduino IDE当前推荐1.8.19在工具→开发板中选择对应的Arduino型号Uno或Nano对于Nano用户还需在工具→处理器中选择正确版本通常为ATmega328P注意如果使用克隆板可能需要安装CH340G驱动Windows用户可从官网获取驱动。2.2 必备库的安装与管理SGP30传感器需要Adafruit提供的专用库支持打开Arduino IDE点击工具→管理库...搜索Adafruit SGP30并安装最新版本当前推荐2.1.0同时安装依赖库Adafruit BusIO和Adafruit Sensor如果计划使用OLED显示还需安装Adafruit SSD1306用于OLED驱动Adafruit GFX图形显示基础库安装完成后可以通过以下代码测试库是否正常工作#include Wire.h #include Adafruit_SGP30.h Adafruit_SGP30 sgp; void setup() { Serial.begin(9600); if (!sgp.begin()) { Serial.println(Sensor not found :(); while (1); } Serial.println(SGP30 ready!); }3. 核心代码实现与解析3.1 基础数据读取框架SGP30传感器需要约15秒的初始化时间在此期间读取的值CO2400ppmTVOC0ppb无效。以下是稳定读取数据的核心代码结构#include Adafruit_SGP30.h Adafruit_SGP30 sgp; uint32_t lastMeasurement 0; void setup() { Serial.begin(115200); while (!Serial) delay(10); // Wait for serial monitor if (!sgp.begin()) { Serial.println(Sensor initialization failed); while (1); } Serial.println(SGP30 initialized); } void loop() { if (millis() - lastMeasurement 1000) { // 每秒读取一次 if (!sgp.IAQmeasure()) { Serial.println(Measurement failed); return; } Serial.print(CO2: ); Serial.print(sgp.eCO2); Serial.print( ppm\t); Serial.print(TVOC: ); Serial.print(sgp.TVOC); Serial.print( ppb\n); lastMeasurement millis(); } }3.2 数据校准与基线设置SGP30的独特之处在于其算法会随着使用时间自动优化读数准确性。为了获得最佳性能建议在每次启动时恢复之前的基线值uint16_t TVOC_base, eCO2_base; void saveBaseline() { sgp.getIAQBaseline(eCO2_base, TVOC_base); // 这里应该将基线值保存到EEPROM或文件系统 } void loadBaseline() { // 从存储介质读取基线值 if (eCO2_base ! 0 TVOC_base ! 0) { sgp.setIAQBaseline(eCO2_base, TVOC_base); } }在setup()中添加loadBaseline()调用并在适当时间如每12小时调用saveBaseline()。这种处理可以使传感器在断电重启后快速恢复到之前的校准状态避免重新适应环境的过程。4. 系统功能扩展与优化4.1 添加OLED实时显示将数据输出到0.96寸OLED屏可以摆脱对电脑的依赖制作真正的独立设备。以下是扩展显示功能的代码示例#include Adafruit_SSD1306.h #include Adafruit_GFX.h #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, Wire); void setupDisplay() { if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(OLED allocation failed); for(;;); } display.display(); delay(2000); display.clearDisplay(); } void updateDisplay(int co2, int tvoc) { display.clearDisplay(); display.setTextSize(2); display.setTextColor(WHITE); display.setCursor(0,0); display.print(CO2: ); display.print(co2); display.println( ppm); display.setCursor(0,30); display.print(TVOC: ); display.print(tvoc); display.println( ppb); // 添加空气质量评价 display.setTextSize(1); display.setCursor(0,55); if(co2 800) display.print(Air Quality: Excellent); else if(co2 1200) display.print(Air Quality: Good); else display.print(Air Quality: Poor); display.display(); }4.2 数据记录与可视化通过串口将数据输出到电脑可以利用Arduino IDE的串口绘图工具或第三方软件进行可视化void sendToSerial(int co2, int tvoc) { Serial.print(DATA,); Serial.print(millis()/1000); Serial.print(,); Serial.print(co2); Serial.print(,); Serial.println(tvoc); }在串口监视器中设置换行符和115200波特率数据将以CSV格式输出可直接导入Excel或Python进行进一步分析。对于长期监测可以考虑添加SD卡模块实现离线数据记录。4.3 报警功能实现当空气质量达到警戒值时可以通过蜂鸣器或LED发出警示#define BUZZER_PIN 8 #define LED_PIN 13 void checkAlarm(int co2, int tvoc) { static bool alarmOn false; if(co2 1500 || tvoc 500) { if(!alarmOn) { tone(BUZZER_PIN, 1000, 500); digitalWrite(LED_PIN, HIGH); alarmOn true; } } else { noTone(BUZZER_PIN); digitalWrite(LED_PIN, LOW); alarmOn false; } }更高级的实现可以添加继电器控制在空气质量不佳时自动开启空气净化器或通风设备。5. 项目进阶与实用技巧5.1 外壳设计与电源优化一个完整的项目离不开精心设计的外壳和稳定的电源方案3D打印外壳可在Thingiverse等平台找到现成设计或使用Fusion 360自定义电源管理移动电源供电适合短期使用18650锂电池充电模块平衡体积与续航5V电源适配器长期固定位置使用对于需要超低功耗的应用可以考虑改用Arduino Pro Mini3.3V版本并优化代码#include avr/sleep.h void enterSleep() { set_sleep_mode(SLEEP_MODE_PWR_DOWN); sleep_enable(); sleep_mode(); sleep_disable(); } void loop() { takeMeasurement(); delay(100); // 确保数据发送完成 enterSleep(); // 休眠60秒 delay(60000 - 100); }5.2 多传感器数据融合将SGP30与其他环境传感器结合可以获得更全面的环境监测温湿度传感器DHT22或BME280后者已包含气压测量PM2.5传感器PMS5003或SDS011光线传感器BH1750多传感器集成时建议采用模块化编程方式为每个传感器创建单独的类或库避免主程序过于复杂。同时注意I2C地址冲突问题必要时使用I2C多路复用器如TCA9548A。5.3 物联网扩展通过ESP8266或ESP32模块可以将数据上传到云端实现远程监控#include ESP8266WiFi.h #include WiFiClient.h #include BlynkSimpleEsp8266.h char auth[] YourAuthToken; char ssid[] YourNetwork; char pass[] YourPassword; void setup() { Blynk.begin(auth, ssid, pass); } void loop() { Blynk.run(); if(sgp.IAQmeasure()) { Blynk.virtualWrite(V1, sgp.eCO2); Blynk.virtualWrite(V2, sgp.TVOC); } delay(60000); // 每分钟上传一次 }这种方案可以通过手机APP实时查看家中空气质量并在异常时接收推送通知。对于更复杂的应用可以考虑使用MQTT协议接入Home Assistant或Node-RED等物联网平台。
