Componentes

Sensor de calidad del aire CCS811

El CCS811 de ams en la placa CJMCU-811 reporta CO2 equivalente (eCO2) y TVOC por I2C en 0x5A.

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) lee 0x10 (hay una aplicaci贸n v谩lida cargada) y HW_ID (0x20) lee 0x81.
  • Escribir la direcci贸n de registro 0xF4 (APP_START) y nada m谩s inicia la aplicaci贸n: STATUS gana FW_MODE y lee 0x90.
  • 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 en THRESHOLDS (0x10).
  • En cada muestra se activa DATA_READY (bit 3 de STATUS). ALG_RESULT_DATA (0x02) son ocho bytes: eCO2 y TVOC, el byte alto primero, luego STATUS, ERROR_ID y los datos sin procesar. Leerlo limpia DATA_READY y 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, y SW_RESET (0xFF con 11 E5 72 8A) regresa al modo boot.
  • Un registro inv谩lido, o un modo de funcionamiento mayor que 4, activa ERROR en STATUS y un bit en ERROR_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.