1. 项目概述与核心价值

最近在折腾我的“DIY海盗船”项目，这个系列已经更新到第八话了。之前我们搞定了温湿度监控、光照调节、水泵控制这些基础环境模块，让这个模拟的小生态舱运行得挺稳当。但玩久了总觉得还差点意思——舱内植物生长状态时好时坏，有时候明明温湿度都合适，但植物就是有点“蔫”。我琢磨了很久，后来才意识到，可能忽略了空气中一个非常关键的“隐形”因素：二氧化碳浓度。

没错，这第八话，我们就来给海盗船加上CO2检测功能。这可不是为了赶时髦或者单纯堆砌传感器，而是真正想解决一个实际问题：在密闭或半密闭的小型生态/水族环境中，生物呼吸、植物光合作用会动态改变局部CO2浓度。浓度过低，植物光合作用效率下降，长得慢；浓度过高，对舱内的小动物（比如我养的几只观赏虾）又可能造成不适甚至危险。手动开窗通风太粗糙，无法量化。所以，一个能实时监测、并能联动其他设备（如微型风扇）的CO2检测模块，就成了让整个系统从“自动化”迈向“智能化”的关键一步。

市面上成品CO2监测仪价格不菲，而且往往是个“信息孤岛”，很难集成到我们已有的Arduino或树莓派主控系统里。自己动手，用几十块钱的传感器和熟悉的开发板来实现，不仅成本可控，更重要的是数据完全掌握在自己手里，可以无缝融入现有的自动化逻辑。无论你是想优化家里的水草缸、打造一个更科学的植物生长箱，还是像我一样在玩一个综合性的生态船项目，这套DIY方案都能给你提供清晰的思路和可直接复现的代码。接下来，我就把从传感器选型、电路连接、代码编写到数据校准、系统集成的全过程，以及我踩过的几个坑，毫无保留地分享给你。

2. 核心传感器选型与原理剖析

给项目选传感器，就像给船选雷达，精度、稳定性、性价比和接口友好度都得权衡。CO2传感器主流有两大类：NDIR（非分散红外）原理和化学原理（如MG811）。对于我们这种DIY环境监测项目，答案非常明确：首选NDIR原理的传感器。

2.1 为什么是NDIR传感器？

化学传感器如MG811，虽然便宜，但它有个致命缺点：需要定期加热清洗（通常每24小时要加热到高温清洁一次），而且寿命相对较短，长期稳定性一般。它的读数也容易受到温湿度波动的交叉干扰。对于我们追求长期稳定运行、无人值守的“海盗船”来说，这显然不是个好选择。

NDIR传感器则靠谱得多。它的原理是利用CO2分子对特定波长红外光（约4.26μm）有强烈吸收的特性。传感器内部有一个红外光源、一个光路气室、以及一个红外探测器。光源发出的红外光穿过气室中的空气，CO2分子会吸收掉一部分光能，导致到达探测器的光强减弱。通过测量这个衰减程度，就能精确计算出CO2的浓度。这种原理决定了它有几个巨大优势：

1. 高选择性：只对CO2敏感，基本不受其他常见气体干扰。
2. 长期稳定性好：没有消耗性部件，寿命长达5-10年。
3. 无需频繁校准：出厂校准后，在正常使用环境下，漂移很小。
4. 响应速度快：通常几十秒就能得到一个稳定读数。

当然，NDIR传感器通常更贵。但好在随着技术普及，像MH-Z19B、Sensirion SCD30这类模块已经将价格打到了百元级，非常适合DIY玩家。

2.2 我的选择：MH-Z19B与SCD30的对比

我手头有两个模块：经典的MH-Z19B和集成度更高的SCD30。经过一番对比测试，我最终为“海盗船”选定了SCD30。

MH-Z19B是一款非常成熟、性价比极高的产品。它通过UART（串口）或PWM输出数据，使用简单，5V供电， Arduino兼容性好。但它只输出CO2浓度值（范围0-5000ppm）。它的优点是皮实、便宜（约70-90元），缺点是它自身不带温湿度补偿，你需要额外安装温湿度传感器来对读数进行修正，因为NDIR原理本身受温湿度影响。

Sensirion SCD30则是一个“全能选手”。它同样采用NDIR原理，但集成了高精度的温湿度传感器，用于对CO2测量进行实时、精准的温湿度补偿，这使得它的CO2数据更加可靠。它通过I2C接口通信，同样兼容3.3V/5V系统。除了CO2，它直接输出补偿后的温度和湿度值，一举三得。它的价格稍高（约150-200元），但考虑到它集成了三个高精度传感器，且补偿算法由原厂完成，这个投资是值得的。对于“海盗船”这种对数据一致性要求高的项目，SCD30的集成化方案减少了传感器数量，简化了布线，也降低了后期数据融合的复杂度。

注意：MH-Z19B有多个版本，注意区分MH-Z19B和MH-Z19C。19C增加了自动基线校准（ABC）功能，但ABC在室内长期稳定CO2浓度的环境下是优点，在浓度波动大的密闭生态舱里，反而可能导致校准错误，将高浓度误认为“新鲜空气”。因此，对于我们的应用场景，建议关闭ABC功能或选择不带此功能的版本，而采用手动校准。

最终，我选择SCD30。理由很简单：数据更可靠、系统更简洁、后期维护更省心。接下来的所有电路和代码，都将以SCD30为例。如果你用的是MH-Z19B，原理相通，只需调整接线和代码库即可。

3. 硬件连接与电路搭建详解

SCD30模块的硬件连接极其简单，这得益于I2C总线。I2C只需要两根数据线（SDA, SCL）和电源线，就能挂载多个设备，非常适合我们这种传感器越来越多的项目。

3.1 所需材料清单

• 主控板：Arduino Uno / Nano / Mega， 或 ESP32 / ESP8266（我用的ESP32，因为后续要考虑Wi-Fi数据传输）。本文以Arduino Uno为例，因其最通用。
• CO2传感器：Sensirion SCD30模块。
• 连接线：杜邦线若干（母对母或公对母，根据你的板子而定）。
• 可选：一个4.7kΩ - 10kΩ的电阻（用于I2C上拉，部分模块板载了就不需要）。

3.2 接线步骤与原理

SCD30模块通常有6个引脚：VIN, GND, SCL, SDA, SEL, RDY。我们只需要连接前4个。

1. VIN： 连接至Arduino的5V引脚。SCD30的工作电压范围是3.3V-5V，接5V确保稳定。
2. GND： 连接至Arduino的GND引脚。共地是必须的。
3. SCL： 连接至Arduino的A5引脚。在Arduino Uno上，A5是模拟引脚，但在此作为I2C的时钟线（SCL）使用。
4. SDA： 连接至Arduino的A4引脚。同样，A4作为I2C的数据线（SDA）。

如果你的模块I2C线路（SCL和SDA）上没有板载上拉电阻（通常很小的贴片电阻，靠近引脚），你需要外接。方法是在SCL和VCC（5V）之间、SDA和VCC之间，各接一个4.7kΩ的电阻。不过，大多数市面上售卖的SCD30模块都已经集成了上拉电阻，你可以先不接，如果通信失败再补上。

实操心得：接线务必在断电状态下进行。接好后，先不要急着上传代码，用万用表通断档快速检查一下VIN和GND之间没有短路，这是保护传感器的第一步。我曾经因为一根劣质杜邦线内部断裂导致接触不良，排查了半天，后来养成了上电前必检线的习惯。

3.3 电路图与布局建议

由于接线简单，这里用文字描述即可：想象你的Arduino在左，SCD30模块在右。5V和GND分别拉两条线过去。然后A4和A5分别接SDA和SCL。就这么四根线。

在“海盗船”的实际布局中，传感器模块的放置位置有讲究：

• 远离直接气流：不要正对着风扇或气泵的出风口，剧烈气流会导致读数剧烈波动。
• 避免局部死角：也不要放在完全密闭的角落，要能代表舱内空气的平均状态。
• 远离热源：离灯光、电机驱动板等发热元件远一些，减少温湿度测量误差对CO2补偿的影响。 我把它放在了舱体中部侧壁，用一个小的3D打印支架固定，既通风又不直吹。

4. 软件驱动与基础数据读取

硬件搭好，接下来就是让Arduino和SCD30对话。我们需要借助一个非常关键的桥梁：库（Library）。

4.1 安装传感器库

Sensirion为SCD30提供了官方的Arduino库，极大地简化了编程。打开Arduino IDE，依次点击工具 -> 管理库...，在库管理器中搜索“Sensirion SCD30”。你应该能找到由Sensirion AG发布的库，点击安装即可。

这个库封装了所有复杂的I2C通信指令，我们只需要调用简单的函数，就能获取数据。

4.2 基础读取代码解析

下面是一个最基础的示例代码，用于测试传感器是否工作正常，并读取CO2浓度、温度和湿度值。

#include <Wire.h> #include <SensirionI2CScd30.h> // 引入SCD30库 SensirionI2CScd30 scd30; // 创建传感器对象 void setup() { Serial.begin(115200); // 初始化串口，用于在电脑上查看数据 while (!Serial) { delay(100); // 等待串口连接（对于某些板子需要） } Wire.begin(); // 初始化I2C通信 // 初始化SCD30传感器 uint16_t error = scd30.begin(Wire); if (error) { Serial.print("Error trying to execute begin(): "); Serial.println(error); while (1); // 如果初始化失败，就停在这里 } // 可选：设置测量间隔。SCD30默认是2秒一次，这里我们设为5秒，更省电且对生态舱来说足够。 error = scd30.setMeasurementInterval(5); if (error) { Serial.print("Error setting measurement interval: "); Serial.println(error); } // 启动连续测量 error = scd30.startPeriodicMeasurement(); if (error) { Serial.print("Error starting periodic measurement: "); Serial.println(error); } Serial.println("SCD30 Setup complete. Waiting for first measurement..."); } void loop() { float co2_ppm, temperature_c, relative_humidity; bool isDataReady = false; // 检查数据是否就绪 uint16_t error = scd30.getDataReady(isDataReady); if (error) { Serial.print("Error checking data ready status: "); Serial.println(error); return; } if (!isDataReady) { // 数据还没准备好，等一会儿再查 delay(100); return; } // 数据就绪，读取它 error = scd30.readMeasurement(co2_ppm, temperature_c, relative_humidity); if (error) { Serial.print("Error reading measurement: "); Serial.println(error); } else { // 打印读取到的数据 Serial.print("CO2: "); Serial.print(co2_ppm); Serial.print(" ppm\t"); Serial.print("Temperature: "); Serial.print(temperature_c); Serial.print(" °C\t"); Serial.print("Humidity: "); Serial.print(relative_humidity); Serial.print(" %RH"); Serial.println(); // 换行 } delay(4000); // 等待大约一个测量周期（我们设的5秒） }

代码关键点解读：

1. scd30.begin(Wire)： 初始化传感器，并指定使用Wire这个I2C对象。如果返回错误码不为0，说明通信失败，要检查接线和电源。
2. setMeasurementInterval(5)： 设置测量间隔为5秒。范围是2-1800秒。间隔越长，传感器越省电，但数据更新越慢。对于生态舱监控，5-10秒的间隔是合理的。
3. startPeriodicMeasurement()： 这个命令非常关键！只有执行它，传感器才会开始真正进行周期性的测量。忘记调用这一步，传感器会一直待机。
4. getDataReady()和readMeasurement()： 这是读取数据的标准流程。先问传感器“数据好了吗？”，如果好了，再一次性读取CO2、温度、湿度三个值。这能保证你读到的是一组在相同时间点采样的、同步的数据。

将代码上传到Arduino，打开串口监视器（波特率设为115200），你应该能看到每隔5秒左右输出一行数据。如果看到“CO2: 420 ppm”左右的值（接近室外新鲜空气浓度），温度湿度也是合理范围，那么恭喜你，硬件和基础驱动成功了！

5. 数据校准与准确性保障

传感器能读出数字，但数字准不准，才是监测系统的灵魂。NDIR传感器虽然稳定，但也需要正确的校准才能保证长期可信度。这里有两个核心概念：自动基线校准（ABC）和手动强制校准（FRC）。

5.1 理解并禁用自动基线校准（ABC）

SCD30和MH-Z19C等传感器支持ABC功能。其逻辑是：传感器会持续记录最近一段时间（比如过去7天）的最低CO2读数，并假设这个最低值就是室外新鲜空气的浓度（约400-420 ppm），以此作为基准点来自动调整内部校准。

为什么在我们的“海盗船”项目中要关闭ABC？想象一下，我们的生态舱在夜间，植物呼吸作用占主导，CO2浓度可能持续数小时保持在800-1000 ppm。如果ABC功能开启，它可能会误将这个“高值”中的相对低点（比如800 ppm）当作新的“新鲜空气”基准。第二天白天，即使你通风了，实际浓度降到了500 ppm，传感器因为基准错了，可能只显示300 ppm（一个明显错误的低值）。这会导致整个系统误判。

因此，对于浓度会长期高于室外环境的应用（如温室、养殖舱、室内），必须关闭ABC。

关闭SCD30的ABC功能：在setup()函数中，初始化传感器后，添加以下代码：

// 关闭自动自校准（对于SCD30，是通过设置一个很长的校准周期来实现“关闭”） // 设置自动自校准间隔为0，即可关闭它。 uint16_t error = scd30.setAutoSelfCalibration(0); if (error) { Serial.print("Error disabling auto self-calibration: "); Serial.println(error); } else { Serial.println("Auto self-calibration disabled."); }

5.2 执行手动强制校准（FRC）

关闭了自动校准，我们就需要定期进行手动校准，为传感器提供一个绝对正确的参考点。校准需要在一个已知CO2浓度的环境中进行。最理想的环境是室外新鲜空气（约400-420 ppm），或者使用校准气瓶（如400ppm或0ppm的氮气）。

SCD30手动校准步骤：

1. 准备环境：将传感器置于室外通风良好处，或者通入已知浓度的校准气体，持续至少20分钟，确保传感器内外气体充分交换并稳定。
2. 执行校准命令：在setup()函数中，或通过一个单独的校准程序，发送校准命令。你需要知道当前环境的参考浓度值（例如，室外空气按410 ppm计算）。

// 假设当前环境CO2浓度为410 ppm float reference_co2_concentration = 410.0; uint16_t error = scd30.setForcedRecalibration(reference_co2_concentration); if (error) { Serial.print("Error performing forced recalibration: "); Serial.println(error); } else { Serial.println("Forced recalibration command sent successfully."); Serial.println("Keep the sensor in the reference environment for several minutes."); }

3. 等待与验证：发送命令后，让传感器在参考环境中继续运行15-20分钟，完成内部校准流程。之后读取数据，应该稳定在参考值附近。

重要注意事项：

• 手动校准是“一锤子买卖”，它会用你提供的参考值覆盖传感器内部的基准。务必确保校准时环境浓度是准确且稳定的。
• 校准频率无需过高。在正常室内环境下，每6-12个月校准一次即可。如果传感器经历极端环境（如高温高湿、长时间暴露于高浓度气体），则需要重新校准。
• 校准后，建议在代码中记录校准日期，或者做一个物理标记。

6. 集成到“海盗船”主控系统

单一的数据读取只是第一步，我们的目标是将CO2数据融入整个“海盗船”的自动化管理系统中。这意味着数据要能显示、能记录、并能触发控制动作。

6.1 数据融合与显示

假设你的“海盗船”主控是ESP32，并且已经有一个OLED屏幕用于显示温湿度、光照等信息。现在需要把CO2数据加进去。

首先，你需要一个能处理多任务或非阻塞延时的程序结构，避免因为等待传感器数据而卡住整个系统。我推荐使用millis()进行非阻塞定时。

// 示例片段：非阻塞方式读取SCD30并更新显示 unsigned long previousSCD30Read = 0; const long SCD30Interval = 5000; // 读取间隔5秒 float currentCO2 = 0; float currentTemp = 0; float currentHum = 0; void loop() { unsigned long currentMillis = millis(); // 每5秒读取一次SCD30 if (currentMillis - previousSCD30Read >= SCD30Interval) { previousSCD30Read = currentMillis; readSCD30Data(); // 将之前的读取逻辑封装成一个函数 } // 其他任务，如刷新屏幕、检测按钮等 updateDisplay(); // 更新显示，函数内部包含绘制CO2值的代码 // ... 其他循环任务 } void readSCD30Data() { bool dataReady = false; uint16_t error = scd30.getDataReady(dataReady); if (!error && dataReady) { error = scd30.readMeasurement(currentCO2, currentTemp, currentHum); if (error) { Serial.println("Read SCD30 failed!"); // 可以在这里设置一个错误状态，在屏幕上显示“传感器错误” } } } void updateDisplay() { // 清屏 display.clearDisplay(); display.setCursor(0,0); // 显示温度湿度 display.print("Temp: "); display.print(currentTemp); display.println(" C"); display.print("Hum: "); display.print(currentHum); display.println(" %"); // 显示CO2，并做简单分级提示 display.print("CO2: "); display.print(currentCO2); display.println(" ppm"); if (currentCO2 > 1000) { display.println("HIGH! Ventilate!"); } else if (currentCO2 < 450) { display.println("LOW"); } else { display.println("OK"); } display.display(); }

6.2 自动化控制逻辑实现

有了实时数据，就可以设计控制策略了。一个简单的逻辑是：当CO2浓度超过某个阈值（例如，对于水草缸或生态舱，设定为800-1000 ppm），自动启动一个小型风扇进行通风；当浓度降低到安全范围（如500 ppm）以下时，关闭风扇。

const int FAN_PIN = 9; // 假设风扇连接在数字引脚9，通过继电器或MOSFET控制 const int CO2_HIGH_THRESHOLD = 900; // 高阈值，单位ppm const int CO2_LOW_THRESHOLD = 500; // 低阈值，单位ppm bool fanState = false; void controlFanBasedOnCO2() { // 这个函数可以在每次成功读取CO2数据后调用 if (currentCO2 >= CO2_HIGH_THRESHOLD && !fanState) { // CO2过高，且风扇未开启，则开启风扇 digitalWrite(FAN_PIN, HIGH); fanState = true; Serial.println("Fan ON - CO2 too high."); } else if (currentCO2 <= CO2_LOW_THRESHOLD && fanState) { // CO2已降低，且风扇正在运行，则关闭风扇 digitalWrite(FAN_PIN, LOW); fanState = false; Serial.println("Fan OFF - CO2 back to normal."); } // 如果浓度在两个阈值之间，则保持风扇原有状态不变，防止频繁启停 }

将这个控制逻辑整合到readSCD30Data()函数中，在成功读取数据后调用controlFanBasedOnCO2()即可。

6.3 数据记录与远程查看

为了长期分析舱内环境变化，数据记录很重要。你可以选择：

• 本地SD卡存储：每次读取数据后，追加写入到SD卡的一个CSV文件中。
• 无线传输：利用ESP32的Wi-Fi，将数据发送到MQTT服务器（如Home Assistant）、或云平台（如ThingsBoard、Blynk），甚至直接推送到你自己的服务器。

这里以使用ESP32通过Wi-Fi发送数据到串口（模拟网络发送）为例，展示如何将数据打包：

#include <WiFi.h> #include <HTTPClient.h> const char* ssid = "你的WiFi名"; const char* password = "你的WiFi密码"; const char* serverURL = "http://你的服务器地址/api/data"; void setup() { // ... 其他初始化代码 WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); } Serial.println("WiFi connected."); } void sendDataToServer() { if (WiFi.status() == WL_CONNECTED) { HTTPClient http; http.begin(serverURL); http.addHeader("Content-Type", "application/json"); // 创建JSON格式的数据 String jsonPayload = "{"; jsonPayload += "\"co2_ppm\":" + String(currentCO2) + ","; jsonPayload += "\"temp_c\":" + String(currentTemp) + ","; jsonPayload += "\"humidity\":" + String(currentHum); jsonPayload += "}"; int httpResponseCode = http.POST(jsonPayload); if (httpResponseCode > 0) { Serial.print("HTTP Response code: "); Serial.println(httpResponseCode); } else { Serial.print("Error code: "); Serial.println(httpResponseCode); } http.end(); } else { Serial.println("WiFi Disconnected"); } }

你可以在每次读取传感器数据后，间隔一段时间（比如每5分钟）调用一次sendDataToServer()，避免过于频繁的网络请求。

7. 常见问题排查与优化心得

在实际搭建和调试过程中，我遇到了不少问题，这里总结一下，希望能帮你避开这些坑。

7.1 通信失败与I2C地址扫描

如果上传代码后，串口一直报初始化错误，首先检查硬件连接。如果连接无误，可能是I2C地址问题。虽然SCD30的默认地址是0x61，但最好扫描确认一下。

在setup()里加入以下代码，运行一次I2C扫描：

void scanI2C() { Serial.println("Scanning I2C bus..."); byte error, address; int nDevices = 0; for(address = 1; address < 127; address++ ) { Wire.beginTransmission(address); error = Wire.endTransmission(); if (error == 0) { Serial.print("I2C device found at address 0x"); if (address<16) Serial.print("0"); Serial.print(address,HEX); Serial.println(" !"); nDevices++; } else if (error==4) { Serial.print("Unknown error at address 0x"); if (address<16) Serial.print("0"); Serial.println(address,HEX); } } if (nDevices == 0) { Serial.println("No I2C devices found. Check wiring and power."); } else { Serial.println("Scan complete."); } }

在setup()中调用scanI2C()，看看能否找到设备。如果找不到，检查电源（用万用表量一下VIN引脚是不是5V），检查上拉电阻，或者换一组I2C引脚试试（ESP32可以自定义I2C引脚）。

7.2 读数不稳定或异常

• 读数剧烈跳动：检查传感器是否安装在气流剧烈或震动大的地方。确保其物理位置稳定。尝试增加软件上的滤波，比如连续读取5次，取中位数或平均值。
• 读数长期漂移：首先确认是否错误地开启了ABC功能。如果已关闭，考虑进行手动强制校准（FRC）。检查传感器气室入口是否有灰尘或纤维堵塞。
• 输出值为0或65535等固定值：通常是通信完全失败或传感器未启动周期性测量。检查startPeriodicMeasurement()是否被成功调用。

7.3 功耗与发热考虑

SCD30在连续测量模式下，工作电流约19mA，不算太高。但对于电池供电的项目，可以考虑增大测量间隔（比如设置为30秒或60秒），在loop()中大部分时间让MCU和传感器进入休眠模式，以大幅降低整体功耗。

传感器本身会有轻微发热，这是正常现象，是其内部红外光源工作导致的。确保它周围有少许空间散热即可，不要用隔热材料紧紧包裹。

7.4 与其他传感器的数据协同

“海盗船”里可能还有光照传感器、水位传感器等。当CO2浓度高时，如果同时光照充足，可以适当增强风扇功率；如果是在夜间，则可以降低通风频率，以保持一定的CO2浓度供植物呼吸。这就需要编写更复杂的逻辑，将多个传感器的数据融合判断，这也是DIY智能系统的乐趣所在。建议先实现各个传感器的独立稳定工作，然后再逐步增加联动逻辑，分步调试，避免问题复杂化。

最后，给传感器加上一个简单的防尘罩（比如用一小块海绵或防尘网），可以延长其使用寿命，避免气室被灰尘污染。经过这些步骤，你的“海盗船”就真正拥有了感知空气“呼吸”的能力，向着一个更加平衡、智能的微型生态系统又迈进了一大步。