Componentes

Sensor de qualidade do ar CCS811

O ams CCS811 na placa CJMCU-811 informa CO2 equivalente (eCO2) e TVOC por I2C no endereço 0x5A.

This part has a page of its own, with a note on using it and a circuit to try: the part page.

Apelidos: CJMCU-811, placa CCS811, Adafruit CCS811, SparkFun CCS811, sensor de eCO2, sensor de TVOC. Um pequeno sensor de gás de óxido metálico com seu próprio microcontrolador dentro. Ele aquece uma camada sensora, observa sua resistência mudar conforme compostos orgânicos voláteis (VOCs) passam, e calcula dois números: TVOC, o total de VOCs em partes por bilhão, e eCO2, o nível de dióxido de carbono em partes por milhão que pessoas respirando produziriam junto com eles. Ele não mede o CO2 em si: para isso você precisa de um sensor NDIR, como o SCD40.

Pins

Pin O que faz
VCC Alimentação de 3,3 V. O chip funciona de 1,8 a 3,6 V e esta placa não tem regulador.
GND Alimentação.
SCL, SDA I2C. A placa já traz os pull-ups.
WAK nWAKE, ativo em nível baixo. O chip só escuta enquanto ele está em nível baixo: ligue ao GND, ou a um pino que você mantenha em nível baixo enquanto conversa com ele. Se ficar desconectado, nada responde.
INT nINT, uma saída de dreno aberto que vai a nível baixo quando uma amostra está pronta (ou cruza um limiar), se o sketch pedir.
RST nRESET, ativo em nível baixo; com pull-up interno no chip, então pode ficar desconectado.
ADD O endereço: nível baixo (o pull-down da placa) é 0x5A, nível alto é 0x5B.

Propriedades

eco2 (ppm, 400 a 8192) e tvoc (ppb, 0 a 1187) são o ar, a faixa de saída do chip. Os dois controles deslizantes mudam esses valores com o circuito rodando, e a próxima amostra os informa.

Lendo no Arduino

Com a biblioteca da Adafruit, que o Mokxi inclui 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() retorna 0 quando funciona. O exemplo CCS811 air quality da galeria imprime os dois a cada segundo.

Como ele se comunica

  • Depois de ligar, o chip responde em 20 ms, em modo boot: STATUS (0x00) lê 0x10 (há um aplicativo válido carregado) e HW_ID (0x20) lê 0x81.
  • Escrever o endereço de registrador 0xF4 (APP_START) e nada mais inicia o aplicativo: STATUS ganha FW_MODE e lê 0x90.
  • MEAS_MODE (0x01) escolhe o modo de operação: 0 ocioso, 1 uma amostra por segundo, 2 a cada 10 s, 3 a cada 60 s, 4 dados brutos a cada 250 ms. O bit 3 pede nINT a cada amostra, e o bit 2 só quando o eCO2 muda para outra faixa definida em THRESHOLDS (0x10).
  • A cada amostra, DATA_READY (bit 3 de STATUS) é ativado. ALG_RESULT_DATA (0x02) tem oito bytes: eCO2 e TVOC, byte mais significativo primeiro, depois STATUS, ERROR_ID e os dados brutos. Ler isso limpa DATA_READY e libera o nINT.
  • Os registradores são caixas de correio: o endereço não avança, então uma leitura em sequência recebe os bytes de um registrador em ordem.
  • ENV_DATA (0x05) recebe a umidade e a temperatura para compensação, BASELINE (0x11) salva e restaura a linha de base, e SW_RESET (0xFF com 11 E5 72 8A) volta ao modo boot.
  • Um registrador inválido, ou um modo de operação acima de 4, ativa ERROR em STATUS e um bit em ERROR_ID (0xE0).

O que não é modelado

A química dos gases. As leituras são os controles deslizantes, amostra por amostra; as 48 horas de burn-in, os 20 minutos de run-in, a correção automática da linha de base e a compensação de temperatura e umidade não são simulados (ENV_DATA e BASELINE guardam o que for escrito). RAW_DATA é um valor fixo de exemplo, NTC lê zero, e as falhas do aquecedor, o download de firmware e os dez minutos de ociosidade que o datasheet pede antes de um modo mais lento não são verificados. Tensão demais em VCC não causa dano aqui.

Common mistakes

Deixar WAK desconectado: o chip ignora o barramento até nWAKE ficar em nível baixo. Alimentá-lo com 5 V: o CJMCU-811 não tem regulador, e o limite do chip é 3,6 V. Ler tão rápido quanto o loop roda: há uma amostra nova a cada segundo no modo 1, então espere available(). Confiar nas primeiras leituras num sensor real: ele precisa de 20 minutos para estabilizar, e 48 horas quando é novo.