Компоненты · 8 мин чтения

CCS811 и Arduino: датчик качества воздуха eCO2 и TVOC

Руководство по CCS811 и Arduino: показания eCO2 и TVOC, I2C и пин WAK, 20-минутный прогрев и 48-часовой прожиг, сохранение baseline, коррекция по BME280, ESP32.

В проектах CCS811 Arduino этот небольшой цифровой газовый датчик с интерфейсом I2C используют для измерения качества воздуха в помещении. Он обнаруживает летучие органические соединения (ЛОС, VOC) в комнате и выдаёт два значения: TVOC (общее содержание летучих органических соединений) в ppb и eCO2 (эквивалентный углекислый газ) в ppm. Небольшой процессор внутри управляет нагревателем, обрабатывает сырое измерение собственным алгоритмом и отдаёт тебе готовые числа. Поэтому, в отличие от аналоговых датчиков серии MQ, осмысленные значения можно читать парой строк кода, не возясь с формулами калибровки.

В этом руководстве разберём, как работает CCS811, почему eCO2 не является настоящим CO2, и самое частое место, где всё застревает: пин WAK. Сделаем первое чтение с Arduino Uno, посмотрим на 20-минутный прогрев и 48-часовой первичный прожиг, сохранение baseline и коррекцию по температуре и влажности с BME280. Затем соберём на ESP32 индикатор качества воздуха в помещении с OLED-дисплеем и светодиодами, напишем код на MicroPython без библиотек для Raspberry Pi Pico и сравним CCS811 с MQ-135.

Модуль датчика качества воздуха CJMCU-811 на CCS811
Модуль CJMCU-811: датчик CCS811 с пинами VCC, GND, SCL, SDA, WAK, INT, RST и ADD.

Что такое CCS811 и как он работает?

CCS811 — газовый датчик на основе оксида металла (MOX). Внутри у него крошечный нагреватель, а поверх него газочувствительный слой. Когда в воздухе становится больше спирта, ацетона, формальдегида, духов, чистящих средств или органических соединений из человеческого дыхания, сопротивление этого слоя меняется. Микроконтроллер внутри датчика измеряет это сопротивление, корректирует его по данным о температуре и влажности и рассчитывает результат как TVOC. А вот eCO2 не измеряется, а оценивается: в закрытой комнате люди выделяют и CO2, и ЛОС, и алгоритм по росту ЛОС прикидывает, насколько, вероятно, вырос CO2. Диапазоны: 400–8192 ppm для eCO2 и 0–1187 ppb для TVOC; минимальное значение, которое показывает датчик, — 400 ppm, потому что это средний уровень CO2 в наружном воздухе.

ХарактеристикаЗначение
Тип датчикаОксид металла (MOX) со встроенным микроконтроллером
Выходные данныеeCO2 (400–8192 ppm), TVOC (0–1187 ppb), сырые данные сопротивления
ИнтерфейсI2C, адрес 0x5A (ADD на GND) или 0x5B (ADD на VCC)
Питание1,8–3,6 V (модуль CJMCU-811 питай от 3,3 V)
ТокОколо 30 mA в 1-секундном режиме из-за нагревателя, в 60-секундном режиме в среднем гораздо меньше
Режимы измеренияРежим 1: 1 с, Режим 2: 10 с, Режим 3: 60 с, Режим 4: 250 мс (только сырые данные)
Прогрев20 минут при каждом включении
Первичный прожиг48 часов для нового датчика
eCO2 — это не настоящий CO2. Когда в комнате нет источника ЛОС (например, CO2 накапливается в пустой комнате), eCO2 может оставаться низким; а стоит брызнуть духами или воспользоваться спиртом, eCO2 взлетает до тысяч ppm, даже если в комнате никого нет. Решения о проветривании и контроль CO2 в таких местах, как школьные классы, принимай по NDIR-датчикам, которые измеряют настоящий CO2 (например, MH-Z19, SCD30 или SCD40). CCS811 хорош для отслеживания изменений ЛОС и общей тенденции качества воздуха.

Распиновка и подключение CCS811

Самая распространённая плата с CCS811 — модуль CJMCU-811. У него восемь пинов, и четыре из них, VCC, GND, SDA и SCL, подключаются как у любого I2C-датчика. Всё решает пин WAK (nWAKE). Пока на этом пине низкий уровень, датчик слушает шину I2C; при высоком уровне или если пин «висит в воздухе», датчик остаётся во сне и не отвечает. На модуле CJMCU-811 пин WAK не подключён к GND на плате, поэтому его обязательно нужно подключить к GND вручную. Пин ADD выбирает адрес: 0x5A при подключении к GND, 0x5B при подключении к VCC. INT выдаёт прерывание, когда готовы новые данные, а RST — аппаратный сброс; для первого теста оба можно оставить неподключёнными.

Пин CCS811Arduino UnoESP32Raspberry Pi Pico
VCC3.3V3V33V3 (OUT)
GNDGNDGNDGND
SDAA4GPIO 21GP4
SCLA5GPIO 22GP5
WAKGNDGNDGND
ADDGND (0x5A)GND (0x5A)GND (0x5A)
INTНе подключён (по желанию D2)Не подключёнНе подключён
RSTНе подключёнНе подключёнНе подключён
Микросхема CCS811 работает максимум от 3,6 V, а на большинстве модулей CJMCU-811 нет стабилизатора; не подключай VCC к пину 5V на Arduino. Линии I2C у Uno работают с уровнем 5 V, поэтому в постоянном проекте надёжнее всего поставить между ними преобразователь уровней. ESP32 и Pico и так работают от 3,3 V и подключаются напрямую. Общие правила шины I2C мы разобрали в статье что такое I2C.

Первое чтение с Arduino Uno

  1. Открой в Arduino IDE «Менеджер библиотек» (Library Manager), найди Adafruit CCS811 и установи её вместе с зависимостями.
  2. Подключи модуль по таблице выше; не забудь подключить пины WAK и ADD к GND.
  3. Загрузи скетч ниже и открой «Монитор порта» (Serial Monitor) на скорости 9600 бод.
  4. Первые несколько минут eCO2 может держаться около 400, а TVOC около 0; по мере прогрева датчика значения устанавливаются.
  5. Проверь датчик рядом с маркером, антисептиком для рук или своим дыханием; TVOC и eCO2 вырастут за несколько секунд.
C++ (Arduino IDE)
1// CCS811 ile eCO2 ve TVOC okuma (Arduino Uno) / reading eCO2 and TVOC with CCS811
2// Bağlantı: VCC-3.3V, GND-GND, SDA-A4, SCL-A5, WAK-GND, ADD-GND (0x5A)
3#include <Wire.h>
4#include <Adafruit_CCS811.h>
5
6Adafruit_CCS811 ccs;
7
8void setup() {
9  Serial.begin(9600);
10  if (!ccs.begin(0x5A)) {                    // ADD GND'de ise 0x5A / 0x5A when ADD is low
11    Serial.println(F("CCS811 bulunamadi, WAK ve kablolari kontrol et"));
12    while (true) {}
13  }
14  ccs.setDriveMode(CCS811_DRIVE_MODE_1SEC);  // saniyede bir ölçüm / one reading per second
15  while (!ccs.available()) {}                // ilk veriyi bekle / wait for the first data
16}
17
18void loop() {
19  if (ccs.available()) {
20    if (ccs.readData() == 0) {               // 0 = başarılı / 0 = success
21      Serial.print(F("eCO2: "));
22      Serial.print(ccs.geteCO2());
23      Serial.print(F(" ppm  TVOC: "));
24      Serial.print(ccs.getTVOC());
25      Serial.println(F(" ppb"));
26    } else {
27      Serial.println(F("Okuma hatasi / read error"));
28    }
29  }
30  delay(1000);
31}
ФункцияНазначение
ccs.begin(0x5A) (запуск)Сбрасывает датчик, проверяет его ID (0x81) и запускает приложение; при ошибке возвращает false
setDriveMode() (режим измерений)Выбирает частоту измерений: 1SEC, 10SEC, 60SEC, 250MS или IDLE
available() (есть данные?)Возвращает true, когда готово новое измерение
readData() (чтение)Читает результат; возвращаемое значение 0 означает успех
geteCO2() / getTVOC() (значения)Последние прочитанные значения eCO2 (ppm) и TVOC (ppb)
Если ccs.begin() возвращает false, сначала убедись, что пин WAK подключён к GND. Затем проверь адрес скетчем I2C-сканера: если устройство видно на 0x5B, пин ADD подключён к VCC и нужен begin(0x5B). На некоторых платах, например ESP8266, растяжение тактового сигнала I2C (clock stretching) у CCS811 может вызывать проблемы; с ESP32, Uno и Pico обычно всё в порядке.

20 минут прогрева и 48 часов прожига

MOX-датчик не измеряет правильно, пока его слой не нагреется до определённой температуры и не стабилизируется. У CCS811 есть два разных периода, которые часто путают. Прогрев (run-in) — это примерно 20-минутный период, нужный при каждом включении; значения, прочитанные в это время, нереалистичны, так что правильно выводить на дисплей «прогрев». Первичный прожиг (burn-in) — это примерно 48-часовой период, который новый датчик проходит один раз за всю жизнь; за это время слой химически стабилизируется. Если новый датчик перед установкой в проект поработает 48 часов без перерыва, стабильность последующих показаний заметно улучшится.

ПериодКогда?Что делать
Первые 48 часов (burn-in)Один раз за жизнь датчикаДержи датчик включённым непрерывно, не доверяй значениям, не сохраняй baseline
20 минут при каждом включении (run-in)При каждой подаче питанияВыводи на дисплей «прогрев», в конце этого периода восстанови сохранённый baseline
После смены режимаПри переходе на более редкий режимДождись первых измерений после запуска нового режима

Что такое baseline и зачем его сохранять?

CCS811 хранит опорное значение для чистого воздуха, которое называется baseline (базовая линия). Алгоритм со временем сам подстраивает это опорное значение, ориентируясь на самый чистый воздух, который видел. Проблема в том, что при каждой потере питания baseline сбрасывается, и, пока алгоритм не выучит его заново, значения могут уплывать. Решение: после долгой нормальной работы датчика прочитать baseline функцией getBaseline(), записать в энергонезависимую память, а при следующем включении после 20-минутного прогрева восстановить его функцией setBaseline(). Baseline — это двухбайтовое число без понятного человеку смысла; его нужно просто сохранить и вернуть. Производитель рекомендует сохранять его каждый день в течение первой недели после прожига, а дальше раз в несколько недель. На Arduino его можно записать в EEPROM, на ESP32 — во флеш-память через Preferences. Важно, чтобы перед сохранением датчик «увидел» чистый воздух; хватит нескольких минут проветривания.

Коррекция по температуре и влажности с BME280

По умолчанию алгоритм CCS811 считает, что в помещении 25 °C и 50% влажности. Чем дальше реальные значения от этих, тем сильнее уплывают расчёты TVOC и eCO2. Если сообщить датчику реальные значения функцией setEnvironmentalData(влажность, температура), алгоритм их учтёт. Следи за порядком: в библиотеке Adafruit сначала влажность, потом температура. Датчик хранит влажность с шагом 1/512 %RH, а температуру с шагом 1/512 °C и смещением −25 °C; это преобразование библиотека делает за тебя. Лучший датчик для этой задачи — BME280 на той же шине I2C. Если с BME280 ещё не доводилось работать, загляни в статью датчик BME280 и BMP280.

Датчик температуры, влажности и давления BME280
BME280 подключается к той же шине I2C, что и CCS811, и даёт данные для коррекции по температуре и влажности.
C++ (Arduino IDE)
1// CCS811 + BME280: sıcaklık ve nem düzeltmesi / temperature and humidity compensation
2// İkisi de aynı I2C hattında: CCS811 0x5A, BME280 0x76 / both on the same I2C bus
3#include <Wire.h>
4#include <Adafruit_CCS811.h>
5#include <Adafruit_BME280.h>
6
7Adafruit_CCS811 ccs;
8Adafruit_BME280 bme;
9unsigned long sonBaseline = 0;
10
11void setup() {
12  Serial.begin(9600);
13  if (!ccs.begin(0x5A)) { Serial.println(F("CCS811 yok")); while (true) {} }
14  if (!bme.begin(0x76)) { Serial.println(F("BME280 yok (0x77 dene)")); while (true) {} }
15  ccs.setDriveMode(CCS811_DRIVE_MODE_1SEC);
16}
17
18void loop() {
19  float sicaklik = bme.readTemperature();    // °C
20  float nem = bme.readHumidity();            // %RH
21  ccs.setEnvironmentalData(nem, sicaklik);   // önce nem, sonra sıcaklık / humidity first
22
23  if (ccs.available() && ccs.readData() == 0) {
24    Serial.print(sicaklik, 1); Serial.print(F(" C  "));
25    Serial.print(nem, 0);      Serial.print(F(" %  eCO2: "));
26    Serial.print(ccs.geteCO2()); Serial.print(F(" ppm  TVOC: "));
27    Serial.print(ccs.getTVOC()); Serial.println(F(" ppb"));
28  }
29
30  if (millis() - sonBaseline > 60000UL) {    // dakikada bir baseline'ı göster / show baseline every minute
31    sonBaseline = millis();
32    Serial.print(F("Baseline: 0x"));
33    Serial.println(ccs.getBaseline(), HEX);
34  }
35  delay(2000);
36}
Нагреватель CCS811 греет модуль на несколько градусов. На комбинированных модулях, где CCS811 и BME280 стоят на одной плате (например, CJMCU-8128), BME280 может показывать на 2–5 °C больше реальной температуры в комнате. Если модули отдельные, размести BME280 в нескольких сантиметрах от CCS811. Адрес модуля BME280 может быть 0x76 или 0x77; если begin() не срабатывает, попробуй другой.

Индикатор качества воздуха в помещении на ESP32

Теперь собираем всё вместе: ESP32 будет каждые две секунды читать eCO2 и TVOC, корректировать их по BME280, показывать результат на OLED-дисплее 0,96 дюйма и тремя светодиодами показывать состояние воздуха цветом. Во время прогрева на дисплее будет надпись «Isiniyor» (прогрев); через 20 минут восстановится сохранённый baseline, а после 48 часов работы платы baseline раз в сутки сохраняется во флеш-память. Четыре I2C-устройства делят одни и те же два провода; адреса у них разные, поэтому конфликтов нет.

ДетальПин ESP32Примечание
SDA у CCS811, BME280 и OLEDGPIO 21Все три модуля на одной линии
SCL у CCS811, BME280 и OLEDGPIO 22Все три модуля на одной линии
WAK и ADD у CCS811GNDАдрес 0x5A
Зелёный светодиодGPIO 25С резистором 220 Ω, eCO2 ниже 800 ppm
Жёлтый светодиодGPIO 26С резистором 220 Ω, 800–1199 ppm
Красный светодиодGPIO 27С резистором 220 Ω, 1200 ppm и выше
VCC всех модулей3V3Общая земля
C++ (Arduino IDE)
1// ESP32 iç mekân hava kalitesi göstergesi / ESP32 indoor air quality indicator
2// CCS811 + BME280 + SSD1306 OLED (I2C: SDA 21, SCL 22) + 3 LED (25, 26, 27)
3#include <Wire.h>
4#include <Preferences.h>
5#include <Adafruit_CCS811.h>
6#include <Adafruit_BME280.h>
7#include <Adafruit_GFX.h>
8#include <Adafruit_SSD1306.h>
9
10Adafruit_CCS811 ccs;
11Adafruit_BME280 bme;
12Adafruit_SSD1306 ekran(128, 64, &Wire, -1);
13Preferences ayarlar;                          // baseline kalıcı bellekte / baseline in flash
14
15const int YESIL = 25, SARI = 26, KIRMIZI = 27;
16const uint64_t ISINMA_SN = 20 * 60;           // 20 dakika ısınma / 20-minute warm-up
17const uint64_t ILK_KAYIT_SN = 48 * 3600;      // ilk kayıt 48 saat sonra / first save after 48 h
18const uint64_t KAYIT_ARALIK_SN = 24 * 3600;   // sonra günde bir / then once a day
19bool baselineYuklendi = false;
20uint64_t sonKayitSn = 0;
21
22uint64_t calismaSn() {
23  return esp_timer_get_time() / 1000000ULL;   // taşmayan çalışma süresi / non-overflowing uptime
24}
25
26void setup() {
27  Serial.begin(115200);
28  Wire.begin(21, 22);
29  pinMode(YESIL, OUTPUT);
30  pinMode(SARI, OUTPUT);
31  pinMode(KIRMIZI, OUTPUT);
32
33  if (!ccs.begin(0x5A)) { Serial.println("CCS811 yok"); while (true) delay(1000); }
34  if (!bme.begin(0x76)) { Serial.println("BME280 yok"); while (true) delay(1000); }
35  if (!ekran.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println("OLED yok"); }
36  ccs.setDriveMode(CCS811_DRIVE_MODE_1SEC);
37  ayarlar.begin("ccs811", false);
38}
39
40void loop() {
41  static unsigned long sonOkuma = 0;
42  if (millis() - sonOkuma < 2000) return;     // 2 saniyede bir / every 2 seconds
43  sonOkuma = millis();
44
45  float sicaklik = bme.readTemperature();
46  float nem = bme.readHumidity();
47  ccs.setEnvironmentalData(nem, sicaklik);
48  if (!ccs.available() || ccs.readData() != 0) return;
49
50  uint16_t eco2 = ccs.geteCO2();
51  uint16_t tvoc = ccs.getTVOC();
52  uint64_t sn = calismaSn();
53
54  // 20 dakika sonra kayıtlı baseline'ı geri yükle / restore the saved baseline after 20 min
55  if (!baselineYuklendi && sn > ISINMA_SN) {
56    uint16_t kayitli = ayarlar.getUShort("baseline", 0);
57    if (kayitli != 0) ccs.setBaseline(kayitli);
58    baselineYuklendi = true;
59  }
60  // 48 saatten sonra günde bir baseline'ı kaydet / save the baseline daily after 48 h
61  if (sn > ILK_KAYIT_SN && sn - sonKayitSn > KAYIT_ARALIK_SN) {
62    ayarlar.putUShort("baseline", ccs.getBaseline());
63    sonKayitSn = sn;
64  }
65
66  // LED: yeşil < 800, sarı 800-1199, kırmızı >= 1200 ppm / LED thresholds
67  digitalWrite(YESIL, eco2 < 800);
68  digitalWrite(SARI, eco2 >= 800 && eco2 < 1200);
69  digitalWrite(KIRMIZI, eco2 >= 1200);
70
71  ekran.clearDisplay();
72  ekran.setTextColor(SSD1306_WHITE);
73  ekran.setTextSize(1);
74  ekran.setCursor(0, 0);
75  ekran.print(sn < ISINMA_SN ? "Isiniyor..." : "Hava kalitesi");
76  ekran.setTextSize(2);
77  ekran.setCursor(0, 14);
78  ekran.print(eco2);
79  ekran.setTextSize(1);
80  ekran.print(" ppm eCO2");
81  ekran.setCursor(0, 36);
82  ekran.printf("TVOC: %u ppb", tvoc);
83  ekran.setCursor(0, 50);
84  ekran.printf("%.1f C  %.0f %%", sicaklik, nem);
85  ekran.display();
86
87  Serial.printf("eCO2 %u ppm  TVOC %u ppb  %.1f C  %.0f %%\n", eco2, tvoc, sicaklik, nem);
88}

В коде время работы измеряется через esp_timer_get_time() вместо millis(); функция возвращает микросекунды 64-битным числом, так что в индикаторе, работающем месяцами, переполнения не будет. Baseline записывается библиотекой Preferences в пространство имён «ccs811» и не стирается при выключении и включении питания. Из библиотек достаточно установить Adafruit CCS811, Adafruit BME280 и Adafruit SSD1306 вместе с зависимостями. Подробности про OLED смотри в статье OLED-дисплей SSD1306.

eCO2 (ppm)TVOC (ppb)ОценкаЧто делать
400–7990–219ХорошоНичего делать не нужно
800–999220–659УмеренноПроветривай при возможности
1000–1499660–2199ПлохоОткрой окно, найди источник ЛОС
1500 и выше2200 и вышеОчень плохоСрочно проветри, не задерживайся в помещении

Границы в таблице — ориентировочные значения, которые часто используют в индикаторах качества воздуха в помещении; это не законодательные нормы, а шкала, которая подсказывает направление. Лучший способ подстроить пороги под свою обстановку — несколько дней записывать данные дома и смотреть, как меняются значения утром, во время готовки и после уборки.

CCS811 с Raspberry Pi Pico (MicroPython)

На Pico CCS811 можно использовать в MicroPython без установки библиотек, записывая данные прямо в его регистры. Порядок действий тот же, что и в библиотеке Adafruit: сначала из регистра ID (0x20) читается значение 0x81, выполняется программный сброс, запускается приложение (0xF4) и выбирается режим измерения (0x01). Затем каждый раз, когда бит DATA_READY в регистре состояния равен 1, из регистра результата (0x02) читаются четыре байта. В коде есть и небольшая функция, которая записывает влажность и температуру в регистр окружающей среды (0x05). Если MicroPython для тебя в новинку, сначала загляни в статью основы MicroPython.

MicroPython
1# Raspberry Pi Pico MicroPython: kütüphanesiz CCS811 / CCS811 without a library
2# Bağlantı: SDA GP4, SCL GP5, VCC 3V3, WAK GND, ADD GND (0x5A)
3from machine import I2C, Pin
4import time
5
6i2c = I2C(0, scl=Pin(5), sda=Pin(4), freq=100000)
7ADR = 0x5A
8
9def oku(reg, n):
10    return i2c.readfrom_mem(ADR, reg, n)
11
12if oku(0x20, 1)[0] != 0x81:                              # HW_ID 0x81 olmalı / must be 0x81
13    raise OSError("CCS811 bulunamadi")
14i2c.writeto(ADR, bytes([0xFF, 0x11, 0xE5, 0x72, 0x8A]))  # yazılım reseti / software reset
15time.sleep_ms(100)
16if not oku(0x00, 1)[0] & 0x10:                           # APP_VALID biti / APP_VALID bit
17    raise OSError("Uygulama gecersiz")
18i2c.writeto(ADR, bytes([0xF4]))                          # APP_START
19time.sleep_ms(100)
20i2c.writeto_mem(ADR, 0x01, bytes([0x10]))                # MEAS_MODE: mod 1, saniyede bir
21
22def ortam(nem, sicaklik):
23    # Nem 1/512 %RH, sıcaklık 1/512 °C ve -25 °C kaydırmalı / ENV_DATA format
24    h = int(nem * 512 + 0.5)
25    t = int((sicaklik + 25) * 512 + 0.5)
26    i2c.writeto_mem(ADR, 0x05, bytes([h >> 8, h & 0xFF, t >> 8, t & 0xFF]))
27
28ortam(45.0, 23.5)   # BME280 varsa gerçek değerlerle güncelle / use real BME280 values if you have one
29
30while True:
31    durum = oku(0x00, 1)[0]
32    if durum & 0x01:                                     # ERROR biti / ERROR bit
33        print("hata kodu:", oku(0xE0, 1)[0])
34    elif durum & 0x08:                                   # DATA_READY biti / DATA_READY bit
35        d = oku(0x02, 4)
36        eco2 = (d[0] << 8) | d[1]
37        tvoc = (d[2] << 8) | d[3]
38        print("eCO2:", eco2, "ppm  TVOC:", tvoc, "ppb")
39    time.sleep(1)

CCS811 или MQ-135

Оба датчика продаются как «датчики качества воздуха», но работают очень по-разному. MQ-135 — аналоговый датчик: его нагреватель с питанием 5 V потребляет около 150 mA, на выходе напряжение, а для расчёта ppm нужно проводить собственную калибровку. CCS811 цифровой, потребляет мало и выдаёт готовые значения eCO2 и TVOC. Подробные шаги калибровки ты найдёшь в статье датчик качества воздуха MQ135.

Датчик качества воздуха MQ-135
MQ-135 даёт аналоговый выход, а его нагреватель на 5 V потребляет намного больше тока, чем CCS811.
ХарактеристикаCCS811MQ-135
ВыходЦифровой I2C: eCO2 и TVOCАналоговое напряжение (и цифровой пин для порога)
Питание3,3 V5 V
ТокОколо 30 mA (режим 1 с), в редких режимах гораздо меньшеОколо 150 mA
КалибровкаВстроенный алгоритм и baselineВручную, измерение R0 в чистом воздухе
Прогрев20 мин, при первом использовании 48 чНесколько минут, при первом использовании 24–48 ч
Работа от батареиПодходит (режим 60 с)Не подходит
ЦенаДорожеДешевле

Частые ошибки и их решение

СимптомВероятная причинаРешение
begin() возвращает falseПин WAK «висит в воздухе» или неверный адресПодключи WAK к GND, проверь 0x5A или 0x5B I2C-сканером
eCO2 всегда 400, TVOC всегда 0Прогрев ещё идёт или воздух действительно чистыйПодожди 20 минут, проверь, подышав на датчик
Значения медленно уплываютBaseline сбрасывается при каждом включенииСохрани baseline и восстанавливай его через 20 минут
eCO2 в тысячах ppm, хотя никого нетИсточник ЛОС: духи, спирт или краскаПомни, что eCO2 оценивается по ЛОС, убери источник
readData() возвращает ошибкуПлохой контакт провода, длинная линия I2C или низкое питаниеУкороти провода, измерь питание 3,3 V, прочитай код ошибки через checkError()
Температура выше реальнойBME280 рядом с нагревателемОтодвинь BME280 от CCS811 или на комбинированном модуле вводи постоянную поправку температуры
Сейчас производитель вместо CCS811 рекомендует более новый датчик ENS160. Если проектируешь что-то новое, присмотрись и к ENS160; но имеющийся у тебя CCS811 с шагами из этого руководства прослужит годами.

Идеи проектов

  • Напоминалка о проветривании класса или офиса: красный светодиод и короткий сигнал зуммера, когда eCO2 превышает 1000 ppm.
  • Монитор ЛОС на кухне: отслеживать рост TVOC во время готовки и автоматически включать вытяжку через реле.
  • Запись в облако: отправлять показания с ESP32 в Google Таблицы и строить графики по дням и неделям.
  • Интеграция с умным домом: отправлять значения в Home Assistant по MQTT и настроить оповещение об открытом окне или автоматизацию проветривания.
  • Портативный измеритель на батарее: устройство, которое можно носить из комнаты в комнату, с 60-секундным режимом измерения и маленьким OLED-дисплеем.

При правильном подключении и соблюдении правил прогрева и baseline CCS811 — практичный датчик, который надёжно показывает изменения воздуха в помещении. В приложении BlueGrays есть проекты вроде датчика газа, сигнализации пламени и газа, измерения температуры и влажности с DHT11 и DHT22 и метеостанции на ESP32 с OLED-дисплеем, каждый с пошаговой схемой подключения и кодом; индикатор на CCS811 из этого руководства можно собрать на их основе.

Частые вопросы

Что измеряет датчик CCS811?

CCS811 — датчик на основе оксида металла, который измеряет летучие органические соединения (ЛОС) в воздухе. Он выдаёт TVOC в ppb и eCO2 в ppm. eCO2 — это эквивалент углекислого газа, оценённый по показаниям ЛОС.

Измеряет ли CCS811 настоящий CO2?

Нет. eCO2 от CCS811 оценивается по росту ЛОС и не измеряет настоящий CO2 напрямую. Для настоящего CO2 нужен NDIR-датчик, например MH-Z19, SCD30 или SCD40.

Куда подключать пин WAK у CCS811?

Пин WAK (nWAKE) нужно подключить к GND. Пока на нём низкий уровень, датчик отвечает по I2C; если пин «висит в воздухе» или на нём высокий уровень, датчик остаётся во сне и Arduino не может его найти. На модулях CJMCU-811 это соединение нужно сделать вручную.

Сколько прогревается CCS811?

CCS811 нужно около 20 минут прогрева при каждом включении. Кроме того, новый датчик один раз за жизнь должен пройти первичный прожиг примерно 48 часов. Значения, прочитанные в эти периоды, ненадёжны.

Что такое baseline у CCS811?

Baseline — это опорное значение, которое датчик хранит для чистого воздуха. Оно сбрасывается при потере питания, поэтому после долгой работы его нужно прочитать через getBaseline() и сохранить, а при следующем включении после 20-минутного прогрева восстановить через setBaseline().

Работает ли CCS811 с Arduino на 5V?

Микросхема CCS811 работает максимум от 3,6 V, а на большинстве модулей CJMCU-811 нет стабилизатора. Питай модуль от пина 3.3V на Arduino. Для постоянного использования с линиями I2C на 5 V у Uno рекомендуется преобразователь уровней.

Все проекты
Температура и влажность с DHT11
AR-55Средний

Температура и влажность с DHT11

Насколько тепло в твоей комнате и влажный ли воздух или сухой? Датчик DHT11 измеряет температуру и влажность, а Arduino выводит значения на двухстрочный LCD-экран и обновляет их каждые пару секунд.

4.7(47)
83
Работа с датчиком газа
AR-51Новичок
Premium

Работа с датчиком газа

Маленький страж, который замечает утечку газа на кухне раньше тебя. Датчик газа всё время «принюхивается» к воздуху; пока всё в порядке, горит зелёный светодиод, а когда газа в воздухе становится…

4.6(37)
50
Сигнализация пламени и газа
AR-52Продвинутый
Premium

Сигнализация пламени и газа

Маленький страж, который сразу предупреждает, когда где-то утекает газ или появляется пламя.

4.8(52)
67
Температура и влажность с DHT22 на ESP32 (с LCD-дисплеем)
ES-15Средний

Температура и влажность с DHT22 на ESP32 (с LCD-дисплеем)

Этот проект измеряет температуру и влажность воздуха датчиком DHT22 и в реальном времени показывает данные на I2C LCD 16x2. Данные читаются с датчика по однопроводному протоколу через библиотеку Adafruit DHT. Проект служит основой для IoT-метеостанций, умного дома или систем мониторинга среды в теплицах. Связь с DHT22 идёт через пин GPIO 4 у ESP32.

4.8(38)
57
Сигнализация газа и дыма MQ-2 на ESP32
ES-20Средний

Сигнализация газа и дыма MQ-2 на ESP32

В этом проекте модуль датчика газа MQ-2 обнаруживает горючие газы (сжиженный газ, метан, пропан) и дым, а при обнаружении пассивный зуммер играет тревогу, похожую на сирену. Цифровой пороговый выход датчика (DO) подключён к GPIO 4 у ESP32; когда газ или дым превышают порог, DO переходит в LOW, и срабатывает тревога. Чувствительность настраивается потенциометром модуля. Пассивный зуммер управляется через tone() и даёт сирену на двух частотах.

4.7(29)
44
ESP32 HTTPClient + API погоды (с OLED-дисплеем SSD1306)
ES-32Продвинутый
Premium

ESP32 HTTPClient + API погоды (с OLED-дисплеем SSD1306)

В этом проекте ESP32 через HTTPClient.h делает вызов REST API к сервису погоды (wttr.in). В отличие от прошлой версии с I2C LCD, здесь используется OLED SSD1306 (128×64), который позволяет крупные шрифты, векторные значки и богатую картинку на одном экране. Семь векторных значков погоды (солнечно, переменная облачность, облачно, дождь, снег, гроза, туман) рисуются во время работы (растровые файлы не нужны). Температура выводится крупными цифрами.

4.3(10)
22
Регистратор температуры на ESP32 (DHT22 + DS1307 RTC + microSD + OLED)
ES-40Продвинутый
Premium

Регистратор температуры на ESP32 (DHT22 + DS1307 RTC + microSD + OLED)

Собери на ESP32 регистратор температуры с отметками времени! Каждую минуту читай температуру и влажность с DHT22, бери реальное время из DS1307 RTC и записывай всё на карту microSD в формате CSV. OLED показывает текущую температуру (крупным шрифтом), влажность в процентах, время и счётчик записей. Файл /temp_log.csv на SD-карте открывается в Excel, Google Sheets или Python pandas — идеально для теплиц, комнат, лабораторий и хранения продуктов.

4.7(7)
12
I2C LCD-дисплей (16x2) на ESP32
ES-17Средний
Premium

I2C LCD-дисплей (16x2) на ESP32

В этом проекте символьный LCD-экран 16x2 подключается к ESP32 по протоколу I2C и выводит текст. Благодаря I2C экраном можно управлять всего двумя пинами данных (SDA и SCL), не тратя 6+ пинов, как при классическом параллельном подключении. Код печатает постоянное сообщение в первой строке и счётчик, растущий каждую секунду, во второй. Кроме того, при запуске работает сканер I2C, который выводит адрес дисплея в монитор порта.

4.9(23)
40