This part has a page of its own, with a note on using it and a circuit to try: the part page.
Alias: CJMCU-811, m贸dulo CCS811, Adafruit CCS811, SparkFun CCS811, sensor de eCO2, sensor de TVOC. Un diminuto sensor de gases de 贸xido met谩lico con su propio microcontrolador dentro. Calienta una capa sensora, observa c贸mo cambia su resistencia al pasar compuestos org谩nicos vol谩tiles (COV), y calcula dos n煤meros: TVOC, el total de COV en partes por bill贸n, y eCO2, el nivel de di贸xido de carbono en partes por mill贸n que producir铆a la respiraci贸n de personas junto con ellos. No mide CO2 por s铆 mismo: para eso necesitas un sensor NDIR como el SCD40.
Pins
| Pin | Qu茅 hace |
|---|---|
VCC |
Alimentaci贸n, 3.3 V. El chip funciona de 1.8 a 3.6 V y esta placa no tiene regulador. |
GND |
Tierra. |
SCL, SDA |
I2C. La placa incluye las resistencias pull-up. |
WAK |
nWAKE, activo en bajo. El chip solo escucha mientras est茅 en bajo: con茅ctalo a GND, o a un pin que mantengas en bajo mientras le hablas. Si se deja sin conectar, nada responde. |
INT |
nINT, una salida de drenaje abierto que baja cuando hay una muestra lista (o cruza un umbral), si el sketch lo solicita. |
RST |
nRESET, activo en bajo; con pull-up dentro del chip, as铆 que puede quedar sin conectar. |
ADD |
La direcci贸n: bajo (la pull-down de la placa) es 0x5A, alto es 0x5B. |
Propiedades
eco2 (ppm, 400 a 8192) y tvoc (ppb, 0 a 1187) son el aire, el rango de salida del chip. Los dos controles deslizantes los cambian mientras el circuito se ejecuta, y la siguiente muestra los reporta.
Leerlo en un Arduino
Con la biblioteca de Adafruit, que Mokxi incluye como Adafruit_CCS811.h:
#include <Wire.h>
#include "Adafruit_CCS811.h"
Adafruit_CCS811 ccs;
void setup() {
Serial.begin(9600);
if (!ccs.begin()) { // 0x5A; begin(0x5B) with ADD high
Serial.println("No CCS811");
while (1) {}
}
while (!ccs.available()) {} // the first sample, a second later
}
void loop() {
if (ccs.available() && ccs.readData() == 0) {
Serial.print(ccs.geteCO2());
Serial.print(" ppm eCO2, ");
Serial.print(ccs.getTVOC());
Serial.println(" ppb TVOC");
}
delay(250);
}
readData() devuelve 0 cuando funcion贸. El ejemplo CCS811 air quality de la galer铆a imprime ambos cada segundo.
C贸mo se comunica
- Despu茅s de encender, el chip responde en 20 ms, en modo boot:
STATUS(0x00) lee0x10(hay una aplicaci贸n v谩lida cargada) yHW_ID(0x20) lee0x81. - Escribir la direcci贸n de registro
0xF4(APP_START) y nada m谩s inicia la aplicaci贸n:STATUSganaFW_MODEy lee0x90. MEAS_MODE(0x01) elige el modo de funcionamiento: 0 inactivo, 1 una muestra cada segundo, 2 cada 10 s, 3 cada 60 s, 4 datos sin procesar cada 250 ms. El bit 3 pide nINT en cada muestra, y el bit 2 solo cuando el eCO2 pasa a otro rango definido enTHRESHOLDS(0x10).- En cada muestra se activa
DATA_READY(bit 3 deSTATUS).ALG_RESULT_DATA(0x02) son ocho bytes: eCO2 y TVOC, el byte alto primero, luegoSTATUS,ERROR_IDy los datos sin procesar. Leerlo limpiaDATA_READYy permite que baje nINT. - Los registros son buzones: la direcci贸n no avanza sola, as铆 que una lectura en r谩faga obtiene los bytes de un solo registro en orden.
ENV_DATA(0x05) recibe la humedad y la temperatura para compensaci贸n,BASELINE(0x11) guarda y restaura la l铆nea base, ySW_RESET(0xFFcon11 E5 72 8A) regresa al modo boot.- Un registro inv谩lido, o un modo de funcionamiento mayor que 4, activa
ERRORenSTATUSy un bit enERROR_ID(0xE0).
Lo que no modela
La qu铆mica del gas. Las lecturas son las de los controles deslizantes, muestra por muestra; las 48 horas de rodaje, los 20 minutos de estabilizaci贸n, la correcci贸n autom谩tica de la l铆nea base y la compensaci贸n de temperatura y humedad no se simulan (ENV_DATA y BASELINE conservan lo que se escribe). RAW_DATA es un valor fijo de reemplazo, NTC lee cero, y no se verifican las fallas del calentador, la descarga del firmware ni los diez minutos de inactividad que pide la hoja de datos antes de un modo m谩s lento. Un voltaje demasiado alto en VCC no causa da帽o aqu铆.
Common mistakes
Dejar WAK sin conectar: el chip ignora el bus hasta que nWAKE est茅 en bajo. Alimentarlo con 5 V: la CJMCU-811 no tiene regulador, y el l铆mite del chip es 3.6 V. Leer tan r谩pido como corre el loop: hay una muestra nueva una vez por segundo en el modo 1, as铆 que espera a available(). Confiar en las primeras lecturas de un sensor real: necesita 20 minutos para estabilizarse, y 48 horas cuando es nuevo.