基于ColorEasyDuino与SGP30的室内空气质量监测系统实战含完整Arduino代码最近在捣鼓智能家居的小项目想监测一下家里的空气质量特别是甲醛和二氧化碳浓度。正好手头有块ColorEasyDuino开发板就搭配SGP30气体传感器搞了个简易的监测系统。整个过程下来发现SGP30用起来挺方便的今天就把从硬件连接到代码调试的完整过程手把手分享给大家就算你是刚接触嵌入式的新手跟着做也能搞定。1. 认识我们的“核心队员”SGP30传感器在动手接线写代码之前咱们先花几分钟了解一下SGP30到底是个啥它能干什么。SGP30是一款挺厉害的数字气体传感器。说它“厉害”是因为它把好几个气体传感元件都集成到了一小块芯片上。它内部集成了4个金属氧化物气体传感元件出厂前就已经完成了校准。这意味着你拿到手接上线它就能直接输出经过处理的、可用的空气质量数据不用我们再去做复杂的校准对初学者非常友好。它最主要的用途是检测甲醛HCHO但同时也能综合监测多种挥发性有机化合物TVOC和等效二氧化碳eCO2浓度。所以它非常适合用在咱们这个室内空气质量监测的项目里无论是新装修的房子想看看甲醛有没有超标还是日常想了解房间的通风情况它都能派上用场。它的通信方式也很简单用的是I2C接口。I2C你可以理解为一种“聊天协议”只需要两根线SDA和SCL就能让开发板和传感器之间传递数据接线非常清爽。这里有一份SGP30模块的关键参数咱们接线和编程时心里得有数参数项规格说明工作电压3.3V(非常重要接5V可能会损坏)工作电流约40mA通信接口I2C引脚数量4个 (VCC, GND, SDA, SCL)检测气体TVOC总挥发性有机物、eCO2等效二氧化碳注意工作电压是3.3V这是硬性规定。ColorEasyDuino开发板上有专门的3.3V输出引脚千万别接到5V上否则传感器可能当场“罢工”。2. 硬件连接给ColorEasyDuino和SGP30“牵线搭桥”硬件连接是第一步也是最关键的一步接错了后面全白搭。咱们的原则是电源要对信号要通。你需要准备ColorEasyDuino开发板一块SGP30传感器模块一个杜邦线母对母4根接线方法非常简单对照下面的表格和说明一分钟就能接好SGP30传感器引脚连接到 ColorEasyDuino 开发板引脚作用说明VCC3.3V电源正极务必接3.3VGNDGND电源地线构成回路SDAA4(或标有SDA的引脚)I2C数据线用于传输数据SCLA5(或标有SCL的引脚)I2C时钟线用于同步时序实际操作步骤先给开发板断电拔掉USB线安全第一。拿起一根杜邦线将SGP30模块的VCC引脚连接到ColorEasyDuino板上标有“3.3V”的引脚。用第二根线连接两个设备的GND引脚。用第三根线连接SGP30的SDA到开发板的A4引脚。在Arduino Uno兼容板上A4就是默认的I2C数据引脚。用最后一根线连接SGP30的SCL到开发板的A5引脚。接好之后检查一遍确保没有松动或接错。整个连接图就像下面这样SGP30模块 ColorEasyDuino开发板 VCC ------------ 3.3V GND ------------ GND SDA ------------ A4 (SDA) SCL ------------ A5 (SCL)3. 软件准备安装驱动库与编写代码硬件通路打通了现在来搞定软件。我们需要在Arduino IDE里安装传感器库并写入让它们“对话”的程序。3.1 安装 Adafruit SGP30 库Arduino生态的强大之处就在于有丰富的库支持我们不用从零开始写复杂的I2C通信代码。对于SGP30Adafruit公司提供了非常好用的库。打开你的Arduino IDE。点击顶部菜单栏的“工具”-“管理库…”。会弹出一个库管理器窗口。在右上角的搜索框中输入“Adafruit SGP30”。在搜索结果中找到“Adafruit SGP30”by Adafruit点击它然后选择“安装”。提示安装时IDE可能会提示你安装一些相关的依赖库比如Adafruit BusIO一定要选择“全部安装”这是库能正常工作的基础。库安装成功后我们就可以在代码里调用它了。3.2 编写并理解监测代码接下来是核心部分——写代码。别担心代码我已经写好并测试过了你直接复制过去就能用。更重要的是我会逐段解释这些代码在干什么这样你以后自己修改或者排查问题就心里有底了。/****************************************************************************** * 测试硬件ColorEasyDuino开发板 * 版 本 号: V1.0 * 修改作者: www.lckfb.com * 修改日期: 2024年04月10日 * 功能介绍读取SGP30传感器数据并通过串口打印TVOC和eCO2值 ****************************************************************************** * 开发板软硬件资料与相关项目软硬件资料官网全部开源 * 开发板官网www.lckfb.com * 技术支持常驻论坛任何技术问题欢迎随时交流学习 * 立创论坛club.szlcsc.com * 关注bilibili账号【立创开发板】掌握我们的最新动态 * 不靠卖板赚钱以培养中国工程师为己任 ******************************************************************************/ // 1. 引入头文件 #include Adafruit_SGP30.h // 2. 创建传感器对象 Adafruit_SGP30 sgp; void setup() { // 初始化串口通信设置波特率为9600用于向电脑发送数据 Serial.begin(9600); // 等待串口监视器打开仅对部分板子需要加上更稳妥 while (!Serial) { delay(10); } Serial.println(SGP30 传感器测试开始...); // 3. 初始化SGP30传感器 if (!sgp.begin()) { // 尝试与传感器建立通信 Serial.println(未找到SGP30传感器请检查接线); while (1); // 如果初始化失败就停在这里 } Serial.println(SGP30传感器初始化成功); // 4. 打印传感器的唯一序列号可选用于验证传感器是否正常响应 Serial.print(传感器序列号: 0x); Serial.print(sgp.serialnumber[0], HEX); Serial.print(sgp.serialnumber[1], HEX); Serial.println(sgp.serialnumber[2], HEX); } void loop() { // 5. 尝试进行一次空气质量测量 if (! sgp.IAQmeasure()) { Serial.println(测量失败); delay(500); // 失败后稍等片刻再试 return; } // 6. 读取并打印测量结果 Serial.print(TVOC: ); Serial.print(sgp.TVOC); // TVOC浓度单位是ppb十亿分之一 Serial.print( ppb\t); // \t是制表符让输出对齐好看 Serial.print(eCO2: ); Serial.print(sgp.eCO2); // 等效CO2浓度单位是ppm百万分之一 Serial.println( ppm); // println带换行 // 7. 每秒测量一次 delay(1000); }代码关键点解析#include Adafruit_SGP30.h这行代码告诉编译器我们要使用Adafruit_SGP30库里的功能。Adafruit_SGP30 sgp;创建一个名为sgp的传感器对象后续所有操作都通过这个对象进行。sgp.begin()这是最关键的函数之一。它在setup()里被调用负责启动I2C通信并检查传感器是否存在且能正常响应。如果返回false多半是接线问题。sgp.IAQmeasure()这个函数命令传感器执行一次完整的空气质量测量。如果测量成功返回true测量数据会自动存入sensor对象的TVOC和eCO2变量中。sgp.TVOC和sgp.eCO2这就是我们最终要读取的数据。TVOC反映的是挥发性有机物的总量eCO2是综合推算出的等效二氧化碳浓度两者都能有效反映室内空气的“污浊”程度。4. 上传代码与数据验证代码写好了也理解了现在让它跑起来看看效果。选择开发板与端口在Arduino IDE中点击“工具”-“开发板”选择“Arduino Uno”因为ColorEasyDuino兼容Uno。然后再点击“工具”-“端口”选择你的ColorEasyDuino所对应的串口通常是COMx或/dev/ttyUSBx。上传代码点击左上角的**“→”上传按钮**。IDE会先编译代码然后上传到开发板。看到底部状态栏显示“上传成功”即可。打开串口监视器上传成功后点击右上角的放大镜图标串口监视器。确保右下角的波特率设置为9600与代码中Serial.begin(9600)一致。如果一切顺利你会在串口监视器里看到类似这样的信息SGP30 传感器测试开始... SGP30传感器初始化成功 传感器序列号: 0x123456 TVOC: 12 ppb eCO2: 412 ppm TVOC: 15 ppb eCO2: 415 ppm ...重要提示传感器需要预热和稳定刚上电时传感器读数可能不稳定或偏高这是正常现象。SGP30内部需要一点时间通常是几十秒到几分钟来预热和稳定。你可以把它放在通风良好的地方观察几分钟读数会逐渐趋于稳定。稳定的读数才具有参考价值。5. 常见问题与调试心得最后分享几个我在调试过程中踩过的坑帮你快速排雷“未找到传感器”或“测量失败”99%是接线问题首先反复检查VCC是否接在了3.3V上而不是5V。然后检查SDA和SCL是否接反了以及杜邦线是否接触不良。最好用万用表通断档测一下。检查库是否安装完整确保Adafruit SGP30库及其所有依赖库都已成功安装。读数一直是0或者异常值如65535传感器未稳定刚上电的读数不可信请耐心等待几分钟。I2C地址冲突虽然SGP30的I2C地址是固定的0x58但如果你同时接了其他I2C设备可能存在地址冲突。可以尝试只接SGP30一个设备测试。串口监视器没有任何输出端口选错重新拔插USB线在IDE中确认选择了正确的端口。波特率不匹配确保串口监视器的波特率设置为9600。开发板型号选错确认开发板选择的是Arduino Uno。这个基于ColorEasyDuino和SGP30的空气质量监测系统硬件简单代码清晰作为入门物联网传感项目非常合适。拿到稳定数据后你可以进一步发挥比如加上OLED屏幕实时显示或者通过Wi-Fi模块将数据上传到手机App打造一个真正的智能环境监测终端。
基于ColorEasyDuino与SGP30的室内空气质量监测系统实战（含完整Arduino代码）
发布时间：2026/7/8 10:04:24
基于ColorEasyDuino与SGP30的室内空气质量监测系统实战含完整Arduino代码最近在捣鼓智能家居的小项目想监测一下家里的空气质量特别是甲醛和二氧化碳浓度。正好手头有块ColorEasyDuino开发板就搭配SGP30气体传感器搞了个简易的监测系统。整个过程下来发现SGP30用起来挺方便的今天就把从硬件连接到代码调试的完整过程手把手分享给大家就算你是刚接触嵌入式的新手跟着做也能搞定。1. 认识我们的“核心队员”SGP30传感器在动手接线写代码之前咱们先花几分钟了解一下SGP30到底是个啥它能干什么。SGP30是一款挺厉害的数字气体传感器。说它“厉害”是因为它把好几个气体传感元件都集成到了一小块芯片上。它内部集成了4个金属氧化物气体传感元件出厂前就已经完成了校准。这意味着你拿到手接上线它就能直接输出经过处理的、可用的空气质量数据不用我们再去做复杂的校准对初学者非常友好。它最主要的用途是检测甲醛HCHO但同时也能综合监测多种挥发性有机化合物TVOC和等效二氧化碳eCO2浓度。所以它非常适合用在咱们这个室内空气质量监测的项目里无论是新装修的房子想看看甲醛有没有超标还是日常想了解房间的通风情况它都能派上用场。它的通信方式也很简单用的是I2C接口。I2C你可以理解为一种“聊天协议”只需要两根线SDA和SCL就能让开发板和传感器之间传递数据接线非常清爽。这里有一份SGP30模块的关键参数咱们接线和编程时心里得有数参数项规格说明工作电压3.3V(非常重要接5V可能会损坏)工作电流约40mA通信接口I2C引脚数量4个 (VCC, GND, SDA, SCL)检测气体TVOC总挥发性有机物、eCO2等效二氧化碳注意工作电压是3.3V这是硬性规定。ColorEasyDuino开发板上有专门的3.3V输出引脚千万别接到5V上否则传感器可能当场“罢工”。2. 硬件连接给ColorEasyDuino和SGP30“牵线搭桥”硬件连接是第一步也是最关键的一步接错了后面全白搭。咱们的原则是电源要对信号要通。你需要准备ColorEasyDuino开发板一块SGP30传感器模块一个杜邦线母对母4根接线方法非常简单对照下面的表格和说明一分钟就能接好SGP30传感器引脚连接到 ColorEasyDuino 开发板引脚作用说明VCC3.3V电源正极务必接3.3VGNDGND电源地线构成回路SDAA4(或标有SDA的引脚)I2C数据线用于传输数据SCLA5(或标有SCL的引脚)I2C时钟线用于同步时序实际操作步骤先给开发板断电拔掉USB线安全第一。拿起一根杜邦线将SGP30模块的VCC引脚连接到ColorEasyDuino板上标有“3.3V”的引脚。用第二根线连接两个设备的GND引脚。用第三根线连接SGP30的SDA到开发板的A4引脚。在Arduino Uno兼容板上A4就是默认的I2C数据引脚。用最后一根线连接SGP30的SCL到开发板的A5引脚。接好之后检查一遍确保没有松动或接错。整个连接图就像下面这样SGP30模块 ColorEasyDuino开发板 VCC ------------ 3.3V GND ------------ GND SDA ------------ A4 (SDA) SCL ------------ A5 (SCL)3. 软件准备安装驱动库与编写代码硬件通路打通了现在来搞定软件。我们需要在Arduino IDE里安装传感器库并写入让它们“对话”的程序。3.1 安装 Adafruit SGP30 库Arduino生态的强大之处就在于有丰富的库支持我们不用从零开始写复杂的I2C通信代码。对于SGP30Adafruit公司提供了非常好用的库。打开你的Arduino IDE。点击顶部菜单栏的“工具”-“管理库…”。会弹出一个库管理器窗口。在右上角的搜索框中输入“Adafruit SGP30”。在搜索结果中找到“Adafruit SGP30”by Adafruit点击它然后选择“安装”。提示安装时IDE可能会提示你安装一些相关的依赖库比如Adafruit BusIO一定要选择“全部安装”这是库能正常工作的基础。库安装成功后我们就可以在代码里调用它了。3.2 编写并理解监测代码接下来是核心部分——写代码。别担心代码我已经写好并测试过了你直接复制过去就能用。更重要的是我会逐段解释这些代码在干什么这样你以后自己修改或者排查问题就心里有底了。/****************************************************************************** * 测试硬件ColorEasyDuino开发板 * 版 本 号: V1.0 * 修改作者: www.lckfb.com * 修改日期: 2024年04月10日 * 功能介绍读取SGP30传感器数据并通过串口打印TVOC和eCO2值 ****************************************************************************** * 开发板软硬件资料与相关项目软硬件资料官网全部开源 * 开发板官网www.lckfb.com * 技术支持常驻论坛任何技术问题欢迎随时交流学习 * 立创论坛club.szlcsc.com * 关注bilibili账号【立创开发板】掌握我们的最新动态 * 不靠卖板赚钱以培养中国工程师为己任 ******************************************************************************/ // 1. 引入头文件 #include Adafruit_SGP30.h // 2. 创建传感器对象 Adafruit_SGP30 sgp; void setup() { // 初始化串口通信设置波特率为9600用于向电脑发送数据 Serial.begin(9600); // 等待串口监视器打开仅对部分板子需要加上更稳妥 while (!Serial) { delay(10); } Serial.println(SGP30 传感器测试开始...); // 3. 初始化SGP30传感器 if (!sgp.begin()) { // 尝试与传感器建立通信 Serial.println(未找到SGP30传感器请检查接线); while (1); // 如果初始化失败就停在这里 } Serial.println(SGP30传感器初始化成功); // 4. 打印传感器的唯一序列号可选用于验证传感器是否正常响应 Serial.print(传感器序列号: 0x); Serial.print(sgp.serialnumber[0], HEX); Serial.print(sgp.serialnumber[1], HEX); Serial.println(sgp.serialnumber[2], HEX); } void loop() { // 5. 尝试进行一次空气质量测量 if (! sgp.IAQmeasure()) { Serial.println(测量失败); delay(500); // 失败后稍等片刻再试 return; } // 6. 读取并打印测量结果 Serial.print(TVOC: ); Serial.print(sgp.TVOC); // TVOC浓度单位是ppb十亿分之一 Serial.print( ppb\t); // \t是制表符让输出对齐好看 Serial.print(eCO2: ); Serial.print(sgp.eCO2); // 等效CO2浓度单位是ppm百万分之一 Serial.println( ppm); // println带换行 // 7. 每秒测量一次 delay(1000); }代码关键点解析#include Adafruit_SGP30.h这行代码告诉编译器我们要使用Adafruit_SGP30库里的功能。Adafruit_SGP30 sgp;创建一个名为sgp的传感器对象后续所有操作都通过这个对象进行。sgp.begin()这是最关键的函数之一。它在setup()里被调用负责启动I2C通信并检查传感器是否存在且能正常响应。如果返回false多半是接线问题。sgp.IAQmeasure()这个函数命令传感器执行一次完整的空气质量测量。如果测量成功返回true测量数据会自动存入sensor对象的TVOC和eCO2变量中。sgp.TVOC和sgp.eCO2这就是我们最终要读取的数据。TVOC反映的是挥发性有机物的总量eCO2是综合推算出的等效二氧化碳浓度两者都能有效反映室内空气的“污浊”程度。4. 上传代码与数据验证代码写好了也理解了现在让它跑起来看看效果。选择开发板与端口在Arduino IDE中点击“工具”-“开发板”选择“Arduino Uno”因为ColorEasyDuino兼容Uno。然后再点击“工具”-“端口”选择你的ColorEasyDuino所对应的串口通常是COMx或/dev/ttyUSBx。上传代码点击左上角的**“→”上传按钮**。IDE会先编译代码然后上传到开发板。看到底部状态栏显示“上传成功”即可。打开串口监视器上传成功后点击右上角的放大镜图标串口监视器。确保右下角的波特率设置为9600与代码中Serial.begin(9600)一致。如果一切顺利你会在串口监视器里看到类似这样的信息SGP30 传感器测试开始... SGP30传感器初始化成功 传感器序列号: 0x123456 TVOC: 12 ppb eCO2: 412 ppm TVOC: 15 ppb eCO2: 415 ppm ...重要提示传感器需要预热和稳定刚上电时传感器读数可能不稳定或偏高这是正常现象。SGP30内部需要一点时间通常是几十秒到几分钟来预热和稳定。你可以把它放在通风良好的地方观察几分钟读数会逐渐趋于稳定。稳定的读数才具有参考价值。5. 常见问题与调试心得最后分享几个我在调试过程中踩过的坑帮你快速排雷“未找到传感器”或“测量失败”99%是接线问题首先反复检查VCC是否接在了3.3V上而不是5V。然后检查SDA和SCL是否接反了以及杜邦线是否接触不良。最好用万用表通断档测一下。检查库是否安装完整确保Adafruit SGP30库及其所有依赖库都已成功安装。读数一直是0或者异常值如65535传感器未稳定刚上电的读数不可信请耐心等待几分钟。I2C地址冲突虽然SGP30的I2C地址是固定的0x58但如果你同时接了其他I2C设备可能存在地址冲突。可以尝试只接SGP30一个设备测试。串口监视器没有任何输出端口选错重新拔插USB线在IDE中确认选择了正确的端口。波特率不匹配确保串口监视器的波特率设置为9600。开发板型号选错确认开发板选择的是Arduino Uno。这个基于ColorEasyDuino和SGP30的空气质量监测系统硬件简单代码清晰作为入门物联网传感项目非常合适。拿到稳定数据后你可以进一步发挥比如加上OLED屏幕实时显示或者通过Wi-Fi模块将数据上传到手机App打造一个真正的智能环境监测终端。
)
