Bauteile · 8 Min. Lesezeit

CCS811 Arduino: Luftqualitätssensor für eCO2 und TVOC erklärt

CCS811 am Arduino: eCO2 und TVOC messen, I2C und WAK-Pin, 20 Minuten Aufwärmen und 48 Stunden Einbrennen, Baseline speichern, BME280-Kompensation, ESP32.

Der CCS811 ist ein kleiner digitaler Gassensor mit I2C-Schnittstelle, mit dem du in Arduino-Projekten die Raumluftqualität misst. Er erkennt flüchtige organische Verbindungen (VOC) im Raum und liefert zwei Werte: TVOC (Summe flüchtiger organischer Verbindungen) in ppb und eCO2 (CO2-Äquivalent) in ppm. Der kleine Prozessor im Inneren steuert die Heizung, verarbeitet die Rohmessung mit einem eigenen Algorithmus und gibt dir fertige Zahlen. Anders als bei den analogen MQ-Sensoren bekommst du so mit wenigen Codezeilen sinnvolle Werte, ohne dich mit Kalibrierformeln herumzuschlagen.

In dieser Anleitung erklären wir, wie der CCS811 arbeitet, warum eCO2 kein echtes CO2 ist, und den häufigsten Stolperstein: den WAK-Pin. Wir machen die erste Messung mit einem Arduino Uno und sehen uns das 20-minütige Aufwärmen, das 48-stündige Einbrennen, das Speichern der Baseline und die Temperatur- und Feuchtekompensation mit einem BME280 an. Danach bauen wir mit einem ESP32 eine Raumluftanzeige mit OLED und LEDs, schreiben bibliotheksfreien MicroPython-Code für den Raspberry Pi Pico und vergleichen den CCS811 mit dem MQ-135.

CJMCU-811 Luftqualitätssensor-Modul mit CCS811
Das CJMCU-811-Modul: CCS811-Sensor mit den Pins VCC, GND, SCL, SDA, WAK, INT, RST und ADD.

Was ist der CCS811 und wie funktioniert er?

Der CCS811 ist ein Gassensor auf Metalloxidbasis (MOX). In ihm steckt eine winzige Heizung mit einer gasempfindlichen Schicht darauf. Nehmen Alkohol, Aceton, Formaldehyd, Parfüm, Putzmittel oder die organischen Verbindungen im menschlichen Atem in der Luft zu, ändert sich der Widerstand dieser Schicht. Der Mikrocontroller im Sensor misst diesen Widerstand, korrigiert ihn mit Temperatur- und Feuchtedaten und berechnet daraus den TVOC-Wert. eCO2 dagegen wird nicht gemessen, sondern geschätzt: In einem geschlossenen Raum erzeugen Menschen sowohl CO2 als auch VOC, und der Algorithmus schätzt aus dem VOC-Anstieg, wie stark das CO2 wohl gestiegen ist. Die Messbereiche sind 400–8192 ppm für eCO2 und 0–1187 ppb für TVOC; der kleinste angezeigte Wert ist 400 ppm, weil das dem durchschnittlichen CO2-Gehalt der Außenluft entspricht.

EigenschaftWert
SensortypMetalloxid (MOX) mit eingebautem Mikrocontroller
AusgängeeCO2 (400–8192 ppm), TVOC (0–1187 ppb), Rohwiderstandsdaten
SchnittstelleI2C, Adresse 0x5A (ADD an GND) oder 0x5B (ADD an VCC)
Versorgung1,8–3,6 V (CJMCU-811-Modul mit 3,3 V versorgen)
StromIm 1-Sekunden-Modus wegen der Heizung etwa 30 mA, im 60-Sekunden-Modus im Mittel deutlich weniger
MessmodiModus 1: 1 s, Modus 2: 10 s, Modus 3: 60 s, Modus 4: 250 ms (nur Rohdaten)
Aufwärmen20 Minuten bei jedem Einschalten
Einbrennen (Burn-in)48 Stunden bei einem neuen Sensor
eCO2 ist kein echtes CO2. Gibt es im Raum keine VOC-Quelle (zum Beispiel wenn sich in einem leeren Raum CO2 ansammelt), kann eCO2 niedrig bleiben; sprühst du Parfüm oder benutzt Alkohol, schießt eCO2 auf Tausende ppm, selbst wenn niemand im Raum ist. Lüftungsentscheidungen oder CO2-Überwachung etwa im Klassenzimmer triffst du besser mit NDIR-Sensoren, die echtes CO2 messen (wie MH-Z19, SCD30 oder SCD40). Der CCS811 eignet sich gut, um VOC-Änderungen und den allgemeinen Trend der Luftqualität zu verfolgen.

CCS811 Pinbelegung und Anschluss

Das am häufigsten erhältliche CCS811-Board ist das CJMCU-811-Modul. Es hat acht Pins, und vier davon, VCC, GND, SDA und SCL, schließt du wie bei jedem I2C-Sensor an. Den Unterschied macht der Pin WAK (nWAKE). Solange er auf LOW liegt, hört der Sensor auf den I2C-Bus; ist er HIGH oder offen, schläft der Sensor und antwortet dir nicht. Auf dem CJMCU-811-Modul ist WAK nicht mit GND verbunden, du musst ihn also selbst an GND legen. Der Pin ADD wählt die Adresse: an GND 0x5A, an VCC 0x5B. INT meldet per Interrupt neue Daten, RST ist ein Hardware-Reset; beide kannst du beim ersten Test offen lassen.

CCS811-PinArduino UnoESP32Raspberry Pi Pico
VCC3.3V3V33V3 (OUT)
GNDGNDGNDGND
SDAA4GPIO 21GP4
SCLA5GPIO 22GP5
WAKGNDGNDGND
ADDGND (0x5A)GND (0x5A)GND (0x5A)
INTOffen (optional D2)OffenOffen
RSTOffenOffenOffen
Der CCS811-Chip verträgt höchstens 3,6 V, und die meisten CJMCU-811-Module haben keinen Spannungsregler; schließ VCC nicht an den 5V-Pin des Arduino an. Die I2C-Leitungen des Uno liegen auf 5-V-Pegel, daher ist in einem festen Projekt ein Pegelwandler dazwischen der sicherste Weg. ESP32 und Pico arbeiten ohnehin mit 3,3 V und werden direkt verbunden. Die allgemeinen Regeln des I2C-Busses erklären wir im Artikel Was ist I2C.

Erste Messung mit dem Arduino Uno

  1. Öffne in der Arduino IDE den Bibliotheksverwalter, suche nach Adafruit CCS811 und installiere sie mit allen Abhängigkeiten.
  2. Schließ das Modul nach der Tabelle oben an; vergiss nicht, WAK und ADD mit GND zu verbinden.
  3. Lade den Sketch unten hoch und öffne den Seriellen Monitor mit 9600 Baud.
  4. In den ersten Minuten stehen eCO2 oft bei 400 und TVOC bei 0; mit dem Aufwärmen pendeln sich die Werte ein.
  5. Teste mit einem Filzstift, Handdesinfektion oder deinem Atem in der Nähe; TVOC und eCO2 steigen innerhalb weniger Sekunden.
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}
FunktionAufgabe
ccs.begin(0x5A)Setzt den Sensor zurück, prüft seine Kennung (0x81) und startet die Anwendung; gibt bei Fehler false zurück
setDriveMode()Wählt die Messrate: 1SEC, 10SEC, 60SEC, 250MS oder IDLE
available()Gibt true zurück, wenn eine neue Messung bereitliegt
readData()Liest das Ergebnis; Rückgabewert 0 bedeutet Erfolg
geteCO2() / getTVOC()Die zuletzt gelesenen Werte für eCO2 (ppm) und TVOC (ppb)
Gibt ccs.begin() false zurück, prüfe zuerst, ob WAK an GND liegt. Kontrolliere dann die Adresse mit einem I2C-Scanner-Sketch: Taucht das Gerät bei 0x5B auf, liegt ADD an VCC und du brauchst begin(0x5B). Bei manchen Boards wie dem ESP8266 macht das I2C-Clock-Stretching des CCS811 Probleme; mit ESP32, Uno und Pico klappt es meist problemlos.

20 Minuten Aufwärmen und 48 Stunden Einbrennen

Ein MOX-Sensor misst erst richtig, wenn seine Schicht eine bestimmte Temperatur erreicht hat und stabil ist. Beim CCS811 gibt es zwei verschiedene Zeiten, die oft verwechselt werden. Das Aufwärmen (Run-in) ist die etwa 20-minütige Phase nach jedem Einschalten; Werte aus dieser Zeit sind nicht realistisch, und die Anzeige sollte "wärmt auf" zeigen. Das Einbrennen (Burn-in) ist die etwa 48-stündige Phase, die ein neuer Sensor einmal in seinem Leben durchläuft; dabei stabilisiert sich die Schicht chemisch. Lässt du einen neu gekauften Sensor 48 Stunden ohne Unterbrechung laufen, bevor du ihn einbaust, werden spätere Messungen spürbar stabiler.

ZeitraumWann?Was tun?
Erste 48 Stunden (Burn-in)Einmal im Leben des SensorsSensor durchgehend betreiben, Werten nicht trauen, keine Baseline speichern
20 Minuten bei jedem Einschalten (Run-in)Bei jedem EinschaltenAnzeige wärmt auf zeigen, gespeicherte Baseline am Ende dieser Zeit zurückschreiben
Nach einem ModuswechselBeim Wechsel in einen langsameren ModusDie ersten Messungen im neuen Modus abwarten

Was ist die Baseline und warum speichern?

Der CCS811 führt einen Referenzwert für saubere Luft, die sogenannte Baseline. Der Algorithmus passt diese Referenz mit der Zeit selbst an der saubersten Luft an, die er gesehen hat. Das Problem: Bei jedem Stromausfall wird die Baseline zurückgesetzt, und die Werte können driften, bis der Algorithmus sie neu gelernt hat. Die Lösung: Lies die Baseline mit getBaseline() aus, nachdem der Sensor lange sauber gelaufen ist, speichere sie dauerhaft und schreib sie beim nächsten Start nach den 20 Minuten Aufwärmen mit setBaseline() zurück. Die Baseline ist eine Zwei-Byte-Zahl ohne für Menschen lesbare Bedeutung; du speicherst sie nur und gibst sie zurück. Der Hersteller empfiehlt, sie nach dem Einbrennen in der ersten Woche täglich und danach alle paar Wochen zu speichern. Am Arduino schreibst du sie ins EEPROM, am ESP32 mit Preferences in den Flash. Wichtig ist, dass der Sensor vor dem Speichern saubere Luft gesehen hat; ein paar Minuten Lüften genügen.

Temperatur- und Feuchtekompensation mit dem BME280

Der Algorithmus des CCS811 geht standardmäßig von 25 °C und 50 Prozent Luftfeuchte aus. Weichen die echten Werte davon ab, werden TVOC und eCO2 ungenauer. Teilst du dem Sensor mit setEnvironmentalData(feuchte, temperatur) die echten Werte mit, berücksichtigt der Algorithmus sie. Achte auf die Reihenfolge: In der Adafruit-Bibliothek steht zuerst die Feuchte, dann die Temperatur. Der Sensor speichert die Feuchte in Schritten von 1/512 %rF und die Temperatur in Schritten von 1/512 °C mit einem Versatz von -25 °C; die Bibliothek rechnet das für dich um. Am besten eignet sich dafür ein BME280 am selben I2C-Bus. Wenn du den BME280 noch nie benutzt hast, wirf einen Blick in den Artikel BME280- und BMP280-Sensor.

BME280 Temperatur-, Feuchte- und Drucksensor
Der BME280 hängt am selben I2C-Bus wie der CCS811 und liefert die Daten für die Temperatur- und Feuchtekompensation.
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}
Die Heizung des CCS811 erwärmt das Modul um einige Grad. Auf Kombimodulen, bei denen CCS811 und BME280 auf einer Platine sitzen (etwa CJMCU-8128), kann der BME280 2–5 °C über der echten Raumtemperatur messen. Nutzt du getrennte Module, setz den BME280 einige Zentimeter vom CCS811 entfernt. Ein BME280-Modul kann die Adresse 0x76 oder 0x77 haben; schlägt begin() fehl, probiere die andere.

Raumluftanzeige mit dem ESP32

Jetzt setzen wir alles zusammen: Der ESP32 liest alle zwei Sekunden eCO2 und TVOC, kompensiert mit dem BME280, zeigt die Ergebnisse auf einem 0,96-Zoll-OLED und gibt den Luftzustand über drei LEDs farbig aus. Während des Aufwärmens zeigt das Display "Isiniyor" (wärmt auf), nach 20 Minuten schreibt der Code die gespeicherte Baseline zurück, und wenn das Board 48 Stunden gelaufen ist, speichert er die Baseline einmal täglich im Flash. Die vier I2C-Geräte teilen sich dieselben zwei Leitungen; da ihre Adressen verschieden sind, gibt es keine Konflikte.

TeilESP32-PinHinweis
SDA von CCS811, BME280 und OLEDGPIO 21Alle drei Module an derselben Leitung
SCL von CCS811, BME280 und OLEDGPIO 22Alle drei Module an derselben Leitung
CCS811 WAK und ADDGNDAdresse 0x5A
Grüne LEDGPIO 25Mit 220-Ω-Widerstand, eCO2 unter 800 ppm
Gelbe LEDGPIO 26Mit 220-Ω-Widerstand, 800–1199 ppm
Rote LEDGPIO 27Mit 220-Ω-Widerstand, ab 1200 ppm
VCC aller Module3V3Gemeinsame Masse
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}

Im Code messen wir die Laufzeit mit esp_timer_get_time() statt mit millis(); die Funktion liefert Mikrosekunden als 64-Bit-Zahl, sodass es bei einer monatelang laufenden Anzeige keinen Überlauf gibt. Die Baseline wird mit der Preferences-Bibliothek im Bereich "ccs811" gespeichert und übersteht das Aus- und Einschalten. Als Bibliotheken installierst du Adafruit CCS811, Adafruit BME280 und Adafruit SSD1306 mit ihren Abhängigkeiten. Details zum OLED findest du im Artikel OLED-Display SSD1306.

eCO2 (ppm)TVOC (ppb)BewertungWas tun?
400–7990–219GutNichts zu tun
800–999220–659MittelBei Gelegenheit lüften
1000–1499660–2199SchlechtFenster öffnen, VOC-Quelle suchen
Ab 1500Ab 2200Sehr schlechtSofort lüften, nicht lange bleiben

Die Grenzen in der Tabelle sind Richtwerte, wie sie in Raumluftanzeigen häufig verwendet werden; sie sind keine gesetzlichen Grenzwerte, sondern eine Orientierungsskala. Wenn du zu Hause ein paar Tage mitschreibst und beobachtest, wie sich die Werte morgens, beim Kochen und nach dem Putzen ändern, kannst du die Schwellen am besten an deine Umgebung anpassen.

CCS811 mit dem Raspberry Pi Pico (MicroPython)

Am Pico kannst du den CCS811 mit MicroPython ganz ohne Bibliothek nutzen, indem du direkt in seine Register schreibst. Der Ablauf entspricht dem der Adafruit-Bibliothek: Zuerst wird aus dem ID-Register (0x20) der Wert 0x81 gelesen, dann folgen ein Software-Reset, der Start der Anwendung (0xF4) und die Wahl des Messmodus (0x01). Danach werden, sobald das Bit DATA_READY im Statusregister 1 ist, vier Bytes aus dem Ergebnisregister (0x02) gelesen. Außerdem enthält der Code eine kleine Funktion, die Feuchte und Temperatur ins Umgebungsregister (0x05) schreibt. Wenn du neu bei MicroPython bist, lies zuerst den Artikel MicroPython-Grundlagen.

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 vs. MQ-135

Beide Sensoren werden als "Luftqualitätssensor" verkauft, arbeiten aber ganz unterschiedlich. Der MQ-135 ist analog: Seine mit 5 V betriebene Heizung zieht etwa 150 mA, sein Ausgang ist eine Spannung, und für ppm-Werte musst du selbst kalibrieren. Der CCS811 ist digital, braucht wenig Strom und liefert fertige eCO2- und TVOC-Werte. Die genauen Kalibrierschritte findest du im Artikel MQ135-Luftqualitätssensor.

MQ-135 Luftqualitätssensor
Der MQ-135 liefert einen analogen Ausgang, und seine 5-V-Heizung zieht viel mehr Strom als der CCS811.
EigenschaftCCS811MQ-135
AusgangDigital I2C: eCO2 und TVOCAnaloge Spannung (und ein Digitalpin für eine Schwelle)
Versorgung3,3 V5 V
StromEtwa 30 mA (1-s-Modus), in langsamen Modi viel wenigerEtwa 150 mA
KalibrierungEingebauter Algorithmus und BaselineManuell, R0 in sauberer Luft messen
Aufwärmen20 min, beim ersten Einsatz 48 StundenEinige Minuten, beim ersten Einsatz 24–48 Stunden
BatteriebetriebGeeignet (60-s-Modus)Ungeeignet
PreisTeurerGünstiger

Häufige Fehler und Lösungen

SymptomMögliche UrsacheLösung
begin() gibt false zurückWAK-Pin offen oder falsche AdresseWAK an GND legen, mit I2C-Scanner 0x5A oder 0x5B prüfen
eCO2 immer 400, TVOC immer 0Noch in der Aufwärmphase oder die Luft ist wirklich sauber20 Minuten warten, den Sensor anhauchen
Werte driften langsamBaseline wird bei jedem Start zurückgesetztBaseline speichern und nach 20 Minuten zurückschreiben
eCO2 im Tausenderbereich, obwohl niemand da istVOC-Quelle wie Parfüm, Alkohol oder FarbeDenk daran, dass eCO2 aus VOC geschätzt wird, Quelle entfernen
readData() meldet einen FehlerLockerer Draht, lange I2C-Leitung oder zu niedrige VersorgungLeitungen kürzen, 3,3 V messen, Fehlercode mit checkError() prüfen
Temperatur höher als realBME280 neben der HeizungBME280 vom CCS811 wegsetzen oder auf dem Kombimodul eine feste Temperaturkorrektur anwenden
Der Hersteller empfiehlt inzwischen statt des CCS811 den neueren ENS160. Planst du ein neues Projekt, kannst du dir auch den ENS160 ansehen; dein vorhandener CCS811 leistet mit den Schritten aus dieser Anleitung aber noch jahrelang gute Dienste.

Projektideen

  • Lüftungsampel für Klassenzimmer oder Büro: rote LED und ein kurzer Buzzer-Ton, sobald eCO2 1000 ppm überschreitet.
  • VOC-Wächter für die Küche: den TVOC-Anstieg beim Kochen verfolgen und die Dunstabzugshaube automatisch über ein Relais einschalten.
  • Cloud-Protokoll: die Messwerte mit dem ESP32 in Google Sheets schreiben und Tages- und Wochendiagramme erstellen.
  • Smart-Home-Anbindung: die Werte per MQTT an Home Assistant schicken und eine Fenster-offen-Warnung oder eine Lüftungsautomatik einrichten.
  • Batteriebetriebenes Messgerät: ein tragbares Gerät mit 60-Sekunden-Messmodus und kleinem OLED, das du von Raum zu Raum trägst.

Richtig angeschlossen und mit eingehaltenen Regeln für Aufwärmen und Baseline ist der CCS811 ein praktischer Sensor, der Veränderungen der Raumluft zuverlässig zeigt. In der BlueGrays-App findest du Projekte wie einen Gassensor, einen Flammen- und Gasalarm, Temperatur- und Feuchtemessung mit DHT11 und DHT22 sowie eine ESP32-Wetteranzeige mit OLED, jeweils mit Schaltplan und Code Schritt für Schritt; baue die CCS811-Anzeige aus dieser Anleitung darauf auf.

Häufige Fragen

Was misst der CCS811-Sensor?

Der CCS811 ist ein Metalloxidsensor, der flüchtige organische Verbindungen (VOC) in der Luft misst. Er gibt TVOC in ppb und eCO2 in ppm aus. eCO2 ist ein aus dem VOC-Wert geschätztes CO2-Äquivalent.

Misst der CCS811 echtes CO2?

Nein. Das eCO2 des CCS811 wird aus dem VOC-Anstieg geschätzt und misst echtes CO2 nicht direkt. Für echtes CO2 brauchst du einen NDIR-Sensor wie MH-Z19, SCD30 oder SCD40.

Wo wird der WAK-Pin des CCS811 angeschlossen?

Der WAK-Pin (nWAKE) muss an GND. Solange er LOW ist, antwortet der Sensor über I2C; bleibt er offen oder HIGH, schläft der Sensor und der Arduino findet ihn nicht. Bei CJMCU-811-Modulen musst du diese Verbindung selbst herstellen.

Wie lange muss sich der CCS811 aufwärmen?

Der CCS811 braucht bei jedem Einschalten etwa 20 Minuten zum Aufwärmen. Ein neuer Sensor sollte außerdem einmal in seinem Leben etwa 48 Stunden eingebrannt werden. Werte aus diesen Phasen sind nicht zuverlässig.

Was ist die Baseline des CCS811?

Die Baseline ist der Referenzwert des Sensors für saubere Luft. Sie geht bei Stromausfall verloren, deshalb liest du sie nach längerem Betrieb mit getBaseline() aus, speicherst sie und schreibst sie beim nächsten Start nach 20 Minuten Aufwärmen mit setBaseline() zurück.

Funktioniert der CCS811 am Arduino mit 5V?

Der CCS811-Chip verträgt höchstens 3,6 V, und die meisten CJMCU-811-Module haben keinen Regler. Versorge das Modul über den 3.3V-Pin des Arduino. Für den Dauerbetrieb an den 5-V-I2C-Leitungen des Uno wird ein Pegelwandler empfohlen.

Alle Projekte ansehen
Temperatur und Luftfeuchtigkeit mit DHT11
AR-55Mittel

Temperatur und Luftfeuchtigkeit mit DHT11

Wie warm ist dein Zimmer, und ist die Luft feucht oder trocken? Der DHT11-Sensor misst Temperatur und Luftfeuchtigkeit, und der Arduino schreibt die Werte auf ein zweizeiliges LCD und aktualisiert…

4.7(47)
83
Verwendung von Gassensoren
AR-51Anfänger
Premium

Verwendung von Gassensoren

Ein kleiner Wächter, der ein Gasleck in der Küche bemerkt, bevor du es tust. Der Gassensor schnuppert ständig an der Luft; solange alles in Ordnung ist, leuchtet die grüne LED, übersteigt das Gas in…

4.6(37)
50
Flammen- und Gassensor-Alarm
AR-52Fortgeschritten
Premium

Flammen- und Gassensor-Alarm

Ein kleiner Wächter, der dich sofort warnt, wenn Gas austritt oder irgendwo eine Flamme auftaucht.

4.8(52)
67
ESP32 DHT22 Temperatur und Luftfeuchtigkeit (mit LCD-Display)
ES-15Mittel

ESP32 DHT22 Temperatur und Luftfeuchtigkeit (mit LCD-Display)

Bei diesem Projekt werden die Umgebungstemperatur und die Luftfeuchtigkeit mit einem DHT22-Sensor gemessen und in Echtzeit auf einem 16x2 I2C-LCD angezeigt. Mithilfe der Adafruit-DHT-Bibliothek werden die Daten über das One-Wire-Protokoll vom Sensor ausgelesen. Dieses Projekt bildet die Grundlage für IoT-Wetterstationen, Smart-Home-Automatisierung oder Umgebungsüberwachungssysteme in Gewächshäusern. Die Kommunikation mit dem DHT22 erfolgt über den GPIO-4-Pin des ESP32.

4.8(38)
57
ESP32 MQ-2 Gas-/Rauchmelder-Alarm
ES-20Mittel

ESP32 MQ-2 Gas-/Rauchmelder-Alarm

In diesem Projekt wird die Erkennung brennbarer Gase (LPG, Methan, Propan) und Rauch mit einem MQ-2-Gassensormodul durchgeführt; bei Erkennung ertönt über einen passiven Summer ein sirenenähnlicher Alarmton. Der digitale Schwellenausgang (DO) des Sensors wird an GPIO 4 des ESP32 angeschlossen; überschreiten Gas oder Rauch den Schwellenwert, geht DO auf LOW und der Alarm wird ausgelöst. Die Empfindlichkeit wird über das Potentiometer eingestellt. Der passive Summer wird mit tone() angesteuert.

4.7(29)
44
ESP32 HTTPClient + Wetter-API (mit SSD1306-OLED-Display)
ES-32Fortgeschritten
Premium

ESP32 HTTPClient + Wetter-API (mit SSD1306-OLED-Display)

Der ESP32 ruft über das Internet mit HTTPClient.h eine Wetter-API (wttr.in) per REST auf. Anders als die I2C-LCD-Version nutzt dieses Projekt ein SSD1306-OLED (128×64) mit großer Schrift und Vektor-Icons für eine reichere Darstellung. Sieben Wetter-Icons (sonnig, Regen, Schnee und mehr) werden ohne Bitmap-Dateien direkt gezeichnet.

4.3(10)
22
ESP32 Temperatur-Datenlogger (DHT22 + DS1307 RTC + microSD + OLED)
ES-40Fortgeschritten
Premium

ESP32 Temperatur-Datenlogger (DHT22 + DS1307 RTC + microSD + OLED)

Bau mit dem ESP32 einen zeitgesteuerten Temperatur- und Feuchtigkeitslogger! Ein DHT22 misst einmal pro Minute Temperatur und Luftfeuchtigkeit; jeder Wert landet mit einem Zeitstempel des RTC-Moduls DS1307 im CSV-Format auf einer microSD-Karte. Das OLED zeigt live und in großer Schrift die letzte Temperatur, die Luftfeuchtigkeit, den Zeitstempel und die Zahl der Einträge.

4.7(7)
12
ESP32 I2C-LCD-Display (16×2)
ES-17Mittel
Premium

ESP32 I2C-LCD-Display (16×2)

In diesem Projekt schließen wir ein 16x2-Zeichen-LCD über I2C an den ESP32 an und zeigen Text an. Dank I2C reichen 2 Datenpins (SDA und SCL) statt der 6+ Pins einer klassischen Parallelverbindung. Der Code schreibt eine feste Nachricht in die erste Zeile und einen sekündlich steigenden Zähler in die zweite. Beim Start gibt ein I2C-Scanner die Adresse des Displays im Serial Monitor aus (meist 0x27 oder 0x3F).

4.9(23)
40