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.

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.
| Eigenschaft | Wert |
|---|---|
| Sensortyp | Metalloxid (MOX) mit eingebautem Mikrocontroller |
| Ausgänge | eCO2 (400–8192 ppm), TVOC (0–1187 ppb), Rohwiderstandsdaten |
| Schnittstelle | I2C, Adresse 0x5A (ADD an GND) oder 0x5B (ADD an VCC) |
| Versorgung | 1,8–3,6 V (CJMCU-811-Modul mit 3,3 V versorgen) |
| Strom | Im 1-Sekunden-Modus wegen der Heizung etwa 30 mA, im 60-Sekunden-Modus im Mittel deutlich weniger |
| Messmodi | Modus 1: 1 s, Modus 2: 10 s, Modus 3: 60 s, Modus 4: 250 ms (nur Rohdaten) |
| Aufwärmen | 20 Minuten bei jedem Einschalten |
| Einbrennen (Burn-in) | 48 Stunden bei einem neuen Sensor |
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-Pin | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VCC | 3.3V | 3V3 | 3V3 (OUT) |
| GND | GND | GND | GND |
| SDA | A4 | GPIO 21 | GP4 |
| SCL | A5 | GPIO 22 | GP5 |
| WAK | GND | GND | GND |
| ADD | GND (0x5A) | GND (0x5A) | GND (0x5A) |
| INT | Offen (optional D2) | Offen | Offen |
| RST | Offen | Offen | Offen |
Erste Messung mit dem Arduino Uno
- Öffne in der Arduino IDE den Bibliotheksverwalter, suche nach Adafruit CCS811 und installiere sie mit allen Abhängigkeiten.
- Schließ das Modul nach der Tabelle oben an; vergiss nicht, WAK und ADD mit GND zu verbinden.
- Lade den Sketch unten hoch und öffne den Seriellen Monitor mit 9600 Baud.
- In den ersten Minuten stehen eCO2 oft bei 400 und TVOC bei 0; mit dem Aufwärmen pendeln sich die Werte ein.
- Teste mit einem Filzstift, Handdesinfektion oder deinem Atem in der Nähe; TVOC und eCO2 steigen innerhalb weniger Sekunden.
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}| Funktion | Aufgabe |
|---|---|
| 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) |
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.
| Zeitraum | Wann? | Was tun? |
|---|---|---|
| Erste 48 Stunden (Burn-in) | Einmal im Leben des Sensors | Sensor durchgehend betreiben, Werten nicht trauen, keine Baseline speichern |
| 20 Minuten bei jedem Einschalten (Run-in) | Bei jedem Einschalten | Anzeige wärmt auf zeigen, gespeicherte Baseline am Ende dieser Zeit zurückschreiben |
| Nach einem Moduswechsel | Beim Wechsel in einen langsameren Modus | Die 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.

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}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.
| Teil | ESP32-Pin | Hinweis |
|---|---|---|
| SDA von CCS811, BME280 und OLED | GPIO 21 | Alle drei Module an derselben Leitung |
| SCL von CCS811, BME280 und OLED | GPIO 22 | Alle drei Module an derselben Leitung |
| CCS811 WAK und ADD | GND | Adresse 0x5A |
| Grüne LED | GPIO 25 | Mit 220-Ω-Widerstand, eCO2 unter 800 ppm |
| Gelbe LED | GPIO 26 | Mit 220-Ω-Widerstand, 800–1199 ppm |
| Rote LED | GPIO 27 | Mit 220-Ω-Widerstand, ab 1200 ppm |
| VCC aller Module | 3V3 | Gemeinsame Masse |
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) | Bewertung | Was tun? |
|---|---|---|---|
| 400–799 | 0–219 | Gut | Nichts zu tun |
| 800–999 | 220–659 | Mittel | Bei Gelegenheit lüften |
| 1000–1499 | 660–2199 | Schlecht | Fenster öffnen, VOC-Quelle suchen |
| Ab 1500 | Ab 2200 | Sehr schlecht | Sofort 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.
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.

| Eigenschaft | CCS811 | MQ-135 |
|---|---|---|
| Ausgang | Digital I2C: eCO2 und TVOC | Analoge Spannung (und ein Digitalpin für eine Schwelle) |
| Versorgung | 3,3 V | 5 V |
| Strom | Etwa 30 mA (1-s-Modus), in langsamen Modi viel weniger | Etwa 150 mA |
| Kalibrierung | Eingebauter Algorithmus und Baseline | Manuell, R0 in sauberer Luft messen |
| Aufwärmen | 20 min, beim ersten Einsatz 48 Stunden | Einige Minuten, beim ersten Einsatz 24–48 Stunden |
| Batteriebetrieb | Geeignet (60-s-Modus) | Ungeeignet |
| Preis | Teurer | Günstiger |
Häufige Fehler und Lösungen
| Symptom | Mögliche Ursache | Lösung |
|---|---|---|
| begin() gibt false zurück | WAK-Pin offen oder falsche Adresse | WAK an GND legen, mit I2C-Scanner 0x5A oder 0x5B prüfen |
| eCO2 immer 400, TVOC immer 0 | Noch in der Aufwärmphase oder die Luft ist wirklich sauber | 20 Minuten warten, den Sensor anhauchen |
| Werte driften langsam | Baseline wird bei jedem Start zurückgesetzt | Baseline speichern und nach 20 Minuten zurückschreiben |
| eCO2 im Tausenderbereich, obwohl niemand da ist | VOC-Quelle wie Parfüm, Alkohol oder Farbe | Denk daran, dass eCO2 aus VOC geschätzt wird, Quelle entfernen |
| readData() meldet einen Fehler | Lockerer Draht, lange I2C-Leitung oder zu niedrige Versorgung | Leitungen kürzen, 3,3 V messen, Fehlercode mit checkError() prüfen |
| Temperatur höher als real | BME280 neben der Heizung | BME280 vom CCS811 wegsetzen oder auf dem Kombimodul eine feste Temperaturkorrektur anwenden |
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.
Projekte, die du danach bauen kannst
Alle Projekte ansehen
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…

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…

Flammen- und Gassensor-Alarm
Ein kleiner Wächter, der dich sofort warnt, wenn Gas austritt oder irgendwo eine Flamme auftaucht.

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.

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.

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.

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.

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).
Weitere Artikel
BlueGrays-App
Diese Schaltung Schritt für Schritt auf dem Handy nachbauen
Schaltplan, Code und Teileliste auf einem Bildschirm. Über 500 Arduino-, ESP32- und Pico-Projekte zum Nachbauen.
Mit dem Handy scannen
Richte die Kamera auf den Code, dann öffnet sich der App-Store deines Handys.
oder im Store öffnen

