Komponen · 8 mnt baca

Panduan CCS811 Arduino: Tutorial Sensor Kualitas Udara eCO2 dan TVOC

Panduan CCS811 Arduino: pembacaan eCO2 dan TVOC, I2C dan pin WAK, pemanasan 20 menit dan burn-in 48 jam, menyimpan baseline, kompensasi BME280, serta ESP32.

Dalam proyek CCS811 Arduino, sensor gas digital kecil dengan antarmuka I2C ini dipakai untuk mengukur kualitas udara dalam ruangan. Sensor ini mendeteksi senyawa organik volatil (VOC) di ruangan dan memberikan dua nilai: TVOC (total senyawa organik volatil) dalam ppb dan eCO2 (karbon dioksida ekuivalen) dalam ppm. Prosesor kecil di dalamnya mengatur pemanas, mengolah pengukuran mentah dengan algoritmanya sendiri, lalu memberimu angka yang sudah jadi. Jadi, berbeda dengan sensor analog seri MQ, kamu bisa membaca nilai yang bermakna dengan beberapa baris kode tanpa repot dengan rumus kalibrasi.

Di panduan ini kita akan membahas cara kerja CCS811, kenapa eCO2 bukan CO2 sungguhan, dan hal yang paling sering bikin mentok: pin WAK. Kita akan melakukan pembacaan pertama dengan Arduino Uno, membahas pemanasan 20 menit dan burn-in awal 48 jam, menyimpan baseline, serta kompensasi suhu dan kelembapan dengan BME280. Setelah itu kita akan membuat tampilan kualitas udara dalam ruangan dengan OLED dan LED di ESP32, menulis kode MicroPython tanpa library untuk Raspberry Pi Pico, dan membandingkan CCS811 dengan MQ-135.

Modul sensor kualitas udara CJMCU-811 CCS811
Modul CJMCU-811: sensor CCS811 dengan pin VCC, GND, SCL, SDA, WAK, INT, RST, dan ADD.

Apa itu CCS811 dan bagaimana cara kerjanya?

CCS811 adalah sensor gas metal oksida (MOX). Di dalamnya ada pemanas mungil dengan lapisan yang peka gas di atasnya. Ketika alkohol, aseton, formaldehida, parfum, produk pembersih, atau senyawa organik dalam napas manusia bertambah di udara, hambatan lapisan itu berubah. Mikrokontroler di dalam sensor mengukur hambatan ini, mengoreksinya dengan informasi suhu dan kelembapan, lalu menghitung hasilnya sebagai TVOC. Sementara itu, eCO2 tidak diukur, melainkan diperkirakan: di ruangan tertutup, manusia menghasilkan CO2 sekaligus VOC, dan algoritma memperkirakan seberapa banyak CO2 kemungkinan naik berdasarkan kenaikan VOC. Rentangnya 400–8192 ppm untuk eCO2 dan 0–1187 ppb untuk TVOC; nilai terendah yang ditampilkan sensor adalah 400 ppm, karena itulah kadar CO2 rata-rata udara luar.

FiturNilai
Jenis sensorMetal oksida (MOX) dengan mikrokontroler bawaan
OutputeCO2 (400–8192 ppm), TVOC (0–1187 ppb), data hambatan mentah
AntarmukaI2C, alamat 0x5A (ADD ke GND) atau 0x5B (ADD ke VCC)
Catu daya1,8–3,6 V (beri daya modul CJMCU-811 dari 3,3 V)
ArusSekitar 30 mA di mode 1 detik karena pemanas, rata-rata jauh lebih kecil di mode 60 detik
Mode pengukuranMode 1: 1 dtk, Mode 2: 10 dtk, Mode 3: 60 dtk, Mode 4: 250 ms (hanya data mentah)
Pemanasan20 menit setiap kali dinyalakan
Burn-in awal48 jam untuk sensor baru
eCO2 bukan CO2 sungguhan. Ketika tidak ada sumber VOC di ruangan (misalnya CO2 menumpuk di ruangan kosong), eCO2 bisa tetap rendah; begitu kamu menyemprotkan parfum atau memakai alkohol, eCO2 melonjak sampai ribuan ppm meskipun tidak ada orang di ruangan. Untuk keputusan ventilasi atau pemantauan CO2 di tempat seperti ruang kelas, pakai sensor NDIR yang mengukur CO2 sungguhan (seperti MH-Z19, SCD30, atau SCD40). CCS811 bagus untuk memantau perubahan VOC dan tren umum kualitas udara.

Pinout dan pengkabelan CCS811

Board CCS811 yang paling umum adalah modul CJMCU-811. Modul ini punya delapan pin, dan empat di antaranya, yaitu VCC, GND, SDA, dan SCL, disambung seperti sensor I2C lainnya. Pin yang membuat perbedaan adalah WAK (nWAKE). Selama pin ini LOW, sensor mendengarkan I2C; ketika HIGH atau mengambang, sensor tetap tidur dan tidak akan menjawabmu. Di modul CJMCU-811, WAK tidak terhubung ke GND di board, jadi kamu wajib menyambungkannya sendiri ke GND. Pin ADD memilih alamat: 0x5A kalau disambung ke GND, 0x5B kalau disambung ke VCC. INT memberi interrupt ketika data baru siap, dan RST adalah reset hardware; keduanya boleh dibiarkan tidak tersambung untuk uji coba pertamamu.

Pin CCS811Arduino UnoESP32Raspberry Pi Pico
VCC3.3V3V33V3 (OUT)
GNDGNDGNDGND
SDAA4GPIO 21GP4
SCLA5GPIO 22GP5
WAKGNDGNDGND
ADDGND (0x5A)GND (0x5A)GND (0x5A)
INTTidak tersambung (opsional D2)Tidak tersambungTidak tersambung
RSTTidak tersambungTidak tersambungTidak tersambung
Chip CCS811 bekerja dengan tegangan maksimal 3,6 V dan sebagian besar modul CJMCU-811 tidak punya regulator; jangan sambungkan VCC ke pin 5V Arduino. Jalur I2C Uno berada di level 5 V, jadi untuk proyek permanen, cara paling aman adalah menambahkan konverter level logika. ESP32 dan Pico sudah bekerja di 3,3 V dan bisa disambung langsung. Aturan umum bus I2C sudah kita bahas di artikel Apa Itu I2C?.

Pembacaan pertama dengan Arduino Uno

  1. Buka Library Manager di Arduino IDE, cari Adafruit CCS811, lalu instal beserta dependensinya.
  2. Sambungkan modul sesuai tabel di atas; jangan lupa menyambungkan pin WAK dan ADD ke GND.
  3. Upload sketch di bawah dan buka Serial Monitor di 9600 baud.
  4. Selama beberapa menit pertama, eCO2 mungkin tertahan di sekitar 400 dan TVOC di sekitar 0; nilainya stabil seiring sensor memanas.
  5. Uji di dekat spidol, hand sanitizer, atau napasmu; kamu akan melihat TVOC dan eCO2 naik dalam beberapa detik.
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}
FungsiTugas
ccs.begin(0x5A)Me-reset sensor, mengecek ID-nya (0x81), dan menjalankan aplikasi; mengembalikan false jika gagal
setDriveMode()Memilih laju pengukuran: 1SEC, 10SEC, 60SEC, 250MS, atau IDLE
available()Mengembalikan true jika pengukuran baru sudah siap
readData()Membaca hasil; nilai kembalian 0 berarti berhasil
geteCO2() / getTVOC()Nilai eCO2 (ppm) dan TVOC (ppb) terakhir yang dibaca
Kalau ccs.begin() mengembalikan false, pastikan dulu pin WAK tersambung ke GND. Lalu cek alamatnya dengan sketch scanner I2C: kalau perangkat muncul di 0x5B, berarti pin ADD tersambung ke VCC dan kamu perlu begin(0x5B). Di beberapa board seperti ESP8266, fitur clock stretching I2C pada CCS811 bisa menimbulkan masalah; ESP32, Uno, dan Pico biasanya aman.

Pemanasan 20 menit dan burn-in 48 jam

Sensor MOX belum mengukur dengan benar sampai lapisannya mencapai suhu tertentu dan menjadi stabil. CCS811 punya dua periode terpisah yang sering tertukar. Pemanasan (run-in) adalah periode sekitar 20 menit yang dibutuhkan setiap kali dinyalakan; nilai yang dibaca selama periode ini tidak realistis, jadi sebaiknya tampilkan “sedang memanas” di layar. Burn-in awal adalah periode sekitar 48 jam yang dilalui sensor baru sekali seumur hidupnya; selama periode ini lapisannya stabil secara kimia. Menyalakan sensor yang baru dibeli selama 48 jam tanpa henti sebelum dipasang di proyekmu akan jelas meningkatkan kestabilan pembacaan berikutnya.

PeriodeKapan?Apa yang dilakukan
48 jam pertama (burn-in)Sekali seumur hidup sensorNyalakan sensor terus-menerus, jangan percaya nilainya, jangan simpan baseline
20 menit setiap kali dinyalakan (run-in)Setiap kali daya diberikanTampilkan “sedang memanas” di layar, pulihkan baseline yang tersimpan di akhir periode ini
Setelah ganti modeKetika pindah ke mode yang lebih lambatTunggu pembacaan pertama setelah mode baru berjalan

Apa itu baseline dan kenapa perlu disimpan?

CCS811 menyimpan nilai referensi untuk udara bersih yang disebut baseline. Algoritma menyesuaikan referensi ini sendiri seiring waktu, berdasarkan udara paling bersih yang pernah ditemuinya. Masalahnya: setiap kali sensor kehilangan daya, baseline ter-reset dan nilai bisa bergeser sampai algoritma mempelajarinya lagi. Solusinya, baca baseline dengan getBaseline() setelah sensor berjalan dengan baik dalam waktu lama, tulis ke memori permanen, lalu pulihkan dengan setBaseline() setelah pemanasan 20 menit ketika dinyalakan berikutnya. Baseline adalah angka dua byte yang tidak punya arti yang bisa dibaca manusia; kamu cukup menyimpannya dan mengembalikannya. Produsen menyarankan menyimpannya setiap hari selama minggu pertama setelah burn-in, lalu setiap beberapa minggu sesudahnya. Di Arduino kamu bisa menulisnya ke EEPROM, di ESP32 ke flash dengan Preferences. Penting agar sensor sudah “melihat” udara bersih sebelum kamu menyimpan; ventilasi beberapa menit sudah cukup.

Kompensasi suhu dan kelembapan dengan BME280

Secara default, algoritma CCS811 menganggap ruangan bersuhu 25 °C dengan kelembapan 50%. Makin jauh nilai sebenarnya dari angka itu, makin melenceng perhitungan TVOC dan eCO2. Kalau kamu memberi tahu sensor nilai sebenarnya dengan setEnvironmentalData(humidity, temperature), algoritma akan memperhitungkannya. Perhatikan urutannya: di library Adafruit, kelembapan ditulis dulu, baru suhu. Sensor menyimpan kelembapan dalam langkah 1/512 %RH dan suhu dalam langkah 1/512 °C dengan offset -25 °C; library melakukan konversi ini untukmu. Sensor paling cocok untuk tugas ini adalah BME280 di bus I2C yang sama. Kalau kamu belum pernah memakai BME280, lihat artikel sensor BME280 dan BMP280.

Sensor suhu, kelembapan, dan tekanan BME280
BME280 berbagi bus I2C dengan CCS811 dan menyediakan data yang dibutuhkan untuk kompensasi suhu dan kelembapan.
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}
Pemanas CCS811 menghangatkan modul beberapa derajat. Pada modul gabungan yang menaruh CCS811 dan BME280 di satu board (seperti CJMCU-8128), BME280 bisa membaca 2–5 °C di atas suhu ruangan sebenarnya. Kalau kamu memakai modul terpisah, letakkan BME280 beberapa sentimeter dari CCS811. Alamat modul BME280 bisa 0x76 atau 0x77; kalau begin() gagal, coba alamat yang lain.

Tampilan kualitas udara dalam ruangan dengan ESP32

Sekarang kita gabungkan semuanya: ESP32 akan membaca eCO2 dan TVOC setiap dua detik, melakukan kompensasi dengan BME280, menampilkan hasilnya di OLED 0,96 inci, dan memakai tiga LED untuk menunjukkan kondisi udara lewat warna. Selama pemanasan, layar menampilkan “Isiniyor” (bahasa Turki untuk “sedang memanas”); setelah 20 menit, baseline yang tersimpan dipulihkan, dan begitu board sudah berjalan 48 jam, baseline disimpan ke flash sekali sehari. Keempat perangkat I2C berbagi dua kabel yang sama; alamatnya berbeda, jadi tidak ada konflik.

KomponenPin ESP32Catatan
SDA CCS811, BME280, dan OLEDGPIO 21Ketiga modul di jalur yang sama
SCL CCS811, BME280, dan OLEDGPIO 22Ketiga modul di jalur yang sama
WAK dan ADD CCS811GNDAlamat 0x5A
LED hijauGPIO 25Dengan resistor 220 Ω, eCO2 di bawah 800 ppm
LED kuningGPIO 26Dengan resistor 220 Ω, 800–1199 ppm
LED merahGPIO 27Dengan resistor 220 Ω, 1200 ppm ke atas
VCC semua modul3V3Ground bersama
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}

Di kode ini kita mengukur waktu berjalan dengan esp_timer_get_time(), bukan millis(); fungsi ini mengembalikan mikrodetik sebagai angka 64-bit, jadi tidak ada overflow pada tampilan yang berjalan berbulan-bulan. Baseline ditulis dengan library Preferences ke namespace bernama "ccs811" dan tetap tersimpan meskipun board dimatikan lalu dinyalakan lagi. Untuk library, cukup instal Adafruit CCS811, Adafruit BME280, dan Adafruit SSD1306 beserta dependensinya. Untuk detail OLED, lihat artikel layar OLED SSD1306.

eCO2 (ppm)TVOC (ppb)PenilaianApa yang dilakukan
400–7990–219BaikTidak perlu melakukan apa-apa
800–999220–659SedangBuka ventilasi kalau sempat
1000–1499660–2199BurukBuka jendela, cari sumber VOC
1500 ke atas2200 ke atasSangat burukSegera buka ventilasi, jangan berlama-lama di ruangan

Batas di tabel adalah nilai panduan yang umum dipakai pada tampilan kualitas udara dalam ruangan; ini bukan batas resmi, hanya skala penunjuk arah. Mencatat data selama beberapa hari di rumah dan mengamati bagaimana nilainya berubah di pagi hari, ketika memasak, dan setelah bersih-bersih adalah cara terbaik untuk menyesuaikan ambang dengan lingkunganmu sendiri.

CCS811 dengan Raspberry Pi Pico (MicroPython)

Di Pico kamu bisa memakai CCS811 dengan MicroPython tanpa menginstal library apa pun, dengan menulis langsung ke register-nya. Alurnya sama seperti yang dilakukan library Adafruit: pertama baca 0x81 dari register ID (0x20), lakukan reset software, jalankan aplikasi (0xF4), dan pilih mode pengukuran (0x01). Lalu, setiap kali bit DATA_READY di register status bernilai 1, baca empat byte dari register hasil (0x02). Kodenya juga berisi fungsi kecil yang menulis kelembapan dan suhu ke register lingkungan (0x05). Kalau kamu baru mengenal MicroPython, lihat dulu artikel dasar-dasar 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 vs MQ-135

Kedua sensor ini dijual sebagai “sensor kualitas udara”, tapi cara kerjanya sangat berbeda. MQ-135 adalah sensor analog: pemanasnya, yang diberi daya 5 V, menarik sekitar 150 mA, output-nya berupa tegangan, dan kamu harus melakukan kalibrasi sendiri untuk menghitung ppm. CCS811 digital, hemat daya, dan memberikan nilai eCO2 dan TVOC yang sudah jadi. Langkah kalibrasi lengkap ada di artikel sensor kualitas udara MQ135.

Sensor kualitas udara MQ-135
MQ-135 memberikan output analog dan pemanas 5 V-nya menarik arus jauh lebih besar daripada CCS811.
FiturCCS811MQ-135
OutputDigital I2C: eCO2 dan TVOCTegangan analog (dan pin digital untuk ambang)
Catu daya3,3 V5 V
ArusSekitar 30 mA (mode 1 dtk), jauh lebih kecil di mode lambatSekitar 150 mA
KalibrasiAlgoritma bawaan dan baselineManual, R0 diukur di udara bersih
Pemanasan20 mnt, 48 jam pada pemakaian pertamaBeberapa menit, 24–48 jam pada pemakaian pertama
Pemakaian dengan bateraiCocok (mode 60 dtk)Tidak cocok
HargaLebih mahalLebih murah

Kesalahan umum dan solusinya

GejalaKemungkinan penyebabSolusi
begin() mengembalikan falsePin WAK mengambang atau alamat salahSambungkan WAK ke GND, cek 0x5A atau 0x5B dengan scanner I2C
eCO2 selalu 400, TVOC selalu 0Masih pemanasan, atau udaranya memang bersihTunggu 20 menit, uji dengan meniupkan napas ke sensor
Nilai bergeser perlahanBaseline ter-reset setiap kali dinyalakanSimpan baseline dan pulihkan setelah 20 menit
eCO2 ribuan ppm padahal tidak ada orangAda sumber VOC seperti parfum, alkohol, atau catIngat bahwa eCO2 diperkirakan dari VOC, jauhkan sumbernya
readData() mengembalikan errorKabel longgar, jalur I2C panjang, atau catu daya rendahPerpendek kabel, ukur catu daya 3,3 V, baca kode error dengan checkError()
Suhu lebih tinggi dari sebenarnyaBME280 di dekat pemanasJauhkan BME280 dari CCS811, atau terapkan koreksi suhu tetap pada modul gabungan
Produsen sekarang merekomendasikan sensor ENS160 yang lebih baru sebagai pengganti CCS811. Kalau kamu merancang proyek baru, ENS160 juga layak dilirik; tapi CCS811 yang kamu punya akan tetap berguna bertahun-tahun dengan langkah-langkah di panduan ini.

Ide proyek

  • Pengingat ventilasi kelas atau kantor: LED merah dan bunyi buzzer singkat ketika eCO2 melewati 1000 ppm.
  • Pemantau VOC dapur: pantau kenaikan TVOC ketika memasak dan nyalakan cooker hood otomatis dengan relay.
  • Pencatatan cloud: tulis hasil pengukuran ke Google Sheets dengan ESP32 dan buat grafik harian serta mingguan.
  • Integrasi rumah pintar: kirim nilainya ke Home Assistant lewat MQTT dan buat peringatan jendela terbuka atau otomasi ventilasi.
  • Alat ukur portabel bertenaga baterai: perangkat yang kamu bawa dari ruangan ke ruangan, dengan mode pengukuran 60 detik dan layar OLED kecil.

Kalau disambung dengan benar serta aturan pemanasan dan baseline diikuti, CCS811 adalah sensor praktis yang andal menunjukkan perubahan udara dalam ruangan. Di aplikasi BlueGrays kamu akan menemukan proyek seperti Menggunakan Sensor Gas, Alarm Sensor Api dan Gas, suhu dan kelembapan dengan DHT11 dan DHT22, serta tampilan cuaca ESP32 dengan OLED, masing-masing dengan skema rangkaian dan kode langkah demi langkah; bangun tampilan CCS811 dari panduan ini di atasnya.

Pertanyaan umum

Apa yang diukur sensor CCS811?

CCS811 adalah sensor metal oksida yang mengukur senyawa organik volatil (VOC) di udara. Hasilnya dilaporkan sebagai TVOC dalam ppb dan eCO2 dalam ppm. eCO2 adalah nilai karbon dioksida ekuivalen yang diperkirakan dari pembacaan VOC.

Apakah CCS811 mengukur CO2 sungguhan?

Tidak. eCO2 dari CCS811 diperkirakan dari kenaikan VOC dan tidak mengukur CO2 sungguhan secara langsung. Untuk CO2 sungguhan, kamu butuh sensor NDIR seperti MH-Z19, SCD30, atau SCD40.

Ke mana pin WAK CCS811 disambung?

Pin WAK (nWAKE) harus disambung ke GND. Selama pin ini LOW, sensor menjawab lewat I2C; kalau dibiarkan mengambang atau HIGH, sensor tetap tidur dan Arduino tidak bisa menemukannya. Di modul CJMCU-811, sambungan ini harus kamu buat sendiri.

Berapa lama CCS811 butuh pemanasan?

CCS811 butuh pemanasan sekitar 20 menit setiap kali dinyalakan. Sensor baru juga sebaiknya melalui burn-in awal sekitar 48 jam sekali seumur hidupnya. Nilai yang dibaca selama periode ini tidak bisa diandalkan.

Apa itu baseline CCS811?

Baseline adalah nilai referensi yang disimpan sensor untuk udara bersih. Nilai ini ter-reset ketika daya hilang, jadi setelah berjalan lama, baseline sebaiknya dibaca dengan getBaseline() lalu disimpan, kemudian dipulihkan dengan setBaseline() setelah pemanasan 20 menit ketika dinyalakan berikutnya.

Apakah CCS811 bisa dipakai dengan Arduino 5V?

Chip CCS811 bekerja dengan tegangan maksimal 3,6 V dan sebagian besar modul CJMCU-811 tidak punya regulator. Beri daya modul dari pin 3.3V Arduino. Untuk pemakaian permanen dengan jalur I2C 5 V pada Uno, disarankan memakai konverter level logika.

Lihat semua proyek
Suhu dan Kelembapan dengan DHT11
AR-55Menengah

Suhu dan Kelembapan dengan DHT11

Seberapa hangat kamarmu, dan apakah udaranya lembap atau kering? Sensor DHT11 mengukur suhu dan kelembapan, dan Arduino menulis nilainya di layar LCD dua baris, diperbarui setiap beberapa detik.

4.7(47)
83
Menggunakan Sensor Gas
AR-51Pemula
Premium

Menggunakan Sensor Gas

Penjaga kecil yang menyadari kebocoran gas di dapur lebih dulu darimu. Sensor gas terus mengendus udara; selama semuanya aman LED hijau tetap menyala, dan ketika gas di udara melewati tingkat…

4.6(37)
50
Alarm Sensor Api dan Gas
AR-52Mahir
Premium

Alarm Sensor Api dan Gas

Penjaga kecil yang langsung memperingatkanmu ketika ada gas bocor atau nyala api di suatu tempat.

4.8(52)
67
Suhu dan Kelembapan DHT22 ESP32 (dengan Layar LCD)
ES-15Menengah

Suhu dan Kelembapan DHT22 ESP32 (dengan Layar LCD)

Proyek ini mengukur suhu dan kelembapan sekitar dengan sensor DHT22 dan menampilkan datanya secara real-time di LCD I2C 16x2. Data dibaca dari sensor dengan protokol satu kabel lewat library Adafruit DHT. Proyek ini menjadi dasar untuk stasiun cuaca IoT, otomasi rumah pintar, atau sistem pemantauan lingkungan di rumah kaca. Komunikasi dengan DHT22 dilakukan lewat pin GPIO 4 ESP32.

4.8(38)
57
Alarm Detektor Gas/Asap MQ-2 ESP32
ES-20Menengah

Alarm Detektor Gas/Asap MQ-2 ESP32

Di proyek ini, gas mudah terbakar (LPG, metana, propana) dan asap dideteksi memakai modul sensor gas MQ-2, dan alarm mirip sirene diputar lewat buzzer pasif ketika terdeteksi. Output ambang digital (DO) sensor disambung ke GPIO 4 ESP32; ketika gas atau asap melewati ambang, DO menjadi LOW dan alarm terpicu. Kepekaan diatur lewat potensiometer modul. Buzzer pasif digerakkan dengan tone() untuk menghasilkan efek sirene dua frekuensi.

4.7(29)
44
HTTPClient + API Cuaca ESP32 (dengan Layar OLED SSD1306)
ES-32Mahir
Premium

HTTPClient + API Cuaca ESP32 (dengan Layar OLED SSD1306)

Di proyek ini, kita memakai ESP32 untuk melakukan panggilan REST API ke API cuaca (wttr.in) lewat internet dengan HTTPClient.h. Berbeda dengan versi LCD I2C sebelumnya, di sini kita memakai layar OLED SSD1306 (128×64), yang memungkinkan font besar, ikon vektor, dan tampilan visual yang kaya di satu layar. Tujuh ikon vektor untuk kondisi cuaca (cerah, berawan sebagian, berawan, hujan, salju, badai, berkabut) digambar ketika program berjalan (tanpa file bitmap).

4.3(10)
22
Pencatat Data Suhu ESP32 (DHT22 + RTC DS1307 + microSD + OLED)
ES-40Mahir
Premium

Pencatat Data Suhu ESP32 (DHT22 + RTC DS1307 + microSD + OLED)

Buat pencatat suhu bercap waktu dengan ESP32! Baca suhu/kelembapan DHT22 setiap menit, ambil waktu sebenarnya dari RTC DS1307, dan catat ke kartu microSD sebagai CSV. OLED menampilkan suhu langsung (font besar), kelembapan, cap waktu, dan penghitung catatan. File /temp_log.csv bisa dibuka di Excel, Google Sheets, atau Python pandas; cocok untuk rumah kaca, suhu kamar, data laboratorium, penyimpanan makanan, atau sarang lebah.

4.7(7)
12
Layar LCD I2C ESP32 (16x2)
ES-17Menengah
Premium

Layar LCD I2C ESP32 (16x2)

Di proyek ini, kita menampilkan teks dengan menyambungkan layar LCD karakter 16x2 ke ESP32 lewat protokol I2C. Berkat I2C, kita bisa mengendalikan layar hanya dengan dua pin data (SDA dan SCL), sehingga tidak perlu memboroskan 6+ pin seperti pada sambungan paralel klasik. Kode mencetak pesan tetap di baris pertama dan penghitung yang naik setiap detik di baris kedua. Selain itu, kita menjalankan pemindai I2C di awal untuk mencetak alamat layar ke Serial Monitor (biasanya 0x27).

4.9(23)
40