How to Use Adafruit CCS811: Examples, Pinouts, and Specs

The Adafruit CCS811 (Part ID: 3566) is a digital air quality sensor designed to measure indoor air quality. It detects the concentration of carbon dioxide (CO2) and total volatile organic compounds (TVOCs) in the air. The sensor uses advanced metal oxide (MOX) technology to provide accurate and reliable measurements. It communicates via the I2C protocol, making it easy to integrate into microcontroller-based systems.

• Smart home air quality monitoring
• HVAC systems
• IoT environmental sensing
• Indoor air quality research
• Health and wellness devices

The following table outlines the key technical details of the Adafruit CCS811 sensor:

The Adafruit CCS811 sensor has the following pinout:

1. Power the Sensor: Connect the VIN pin to a 3.3V or 5V power source and the GND pin to ground.
2. Connect I2C Lines: Connect the SDA and SCL pins to the corresponding I2C pins on your microcontroller.
3. Wake the Sensor: Pull the WAKE pin low to enable the sensor. If you want the sensor to remain active continuously, tie the WAKE pin to GND.
4. Optional Connections: Use the RST pin to reset the sensor if needed. The INT pin can be used for interrupt-driven applications.
5. Install Required Libraries: If using an Arduino, install the Adafruit CCS811 library from the Arduino Library Manager.

• Burn-in Period: The sensor requires a burn-in period of 48 hours for optimal accuracy during the first use.
• Warm-up Time: Allow the sensor to warm up for 20 minutes before taking measurements.
• I2C Address: The default I2C address is 0x5A. If the ADDR pin is pulled high, the address changes to 0x5B.
• Environmental Conditions: Avoid exposing the sensor to high humidity or condensation, as this may damage the sensor.

Below is an example code snippet to read CO2 and TVOC values from the Adafruit CCS811 sensor using an Arduino UNO:

#include <Wire.h>
#include "Adafruit_CCS811.h"

// Create an instance of the CCS811 sensor
Adafruit_CCS811 ccs;

void setup() {
  Serial.begin(9600); // Initialize serial communication
  Serial.println("CCS811 Air Quality Sensor Test");

  if (!ccs.begin()) {
    Serial.println("Failed to start CCS811 sensor! Check connections.");
    while (1);
  }

  // Wait for the sensor to be ready
  while (!ccs.available());
}

void loop() {
  if (ccs.available()) {
    if (!ccs.readData()) {
      // Read CO2 and TVOC values
      Serial.print("CO2: ");
      Serial.print(ccs.geteCO2());
      Serial.print(" ppm, TVOC: ");
      Serial.print(ccs.getTVOC());
      Serial.println(" ppb");
    } else {
      Serial.println("Error reading data from CCS811 sensor.");
    }
  }
  delay(1000); // Wait 1 second before the next reading
}

1. Sensor Not Detected on I2C Bus:

   • Ensure the SDA and SCL pins are correctly connected to the microcontroller.
   • Verify the I2C address (0x5A or 0x5B) matches the configuration in your code.
   • Check for loose or faulty wiring.

2. Incorrect or Unstable Readings:

   • Allow the sensor to complete its burn-in period (48 hours).
   • Ensure the sensor is operating within the specified temperature and humidity range.
   • Avoid placing the sensor near sources of contamination, such as adhesives or cleaning agents.

3. Sensor Fails to Initialize:

   • Verify that the WAKE pin is pulled low or tied to GND.
   • Check the power supply voltage (3.3V to 5V) and ensure it is stable.

Q: Can the CCS811 measure outdoor air quality?
A: The CCS811 is optimized for indoor air quality monitoring. Outdoor conditions, such as extreme temperatures and humidity, may affect its performance.

Q: How often should I calibrate the sensor?
A: The CCS811 performs automatic baseline correction. However, for best results, expose the sensor to fresh air periodically.

Q: Can I use the CCS811 with a 3.3V microcontroller?
A: Yes, the CCS811 is compatible with both 3.3V and 5V systems.

Q: What is the lifespan of the CCS811 sensor?
A: The sensor has an estimated operational lifespan of 5 years under normal usage conditions.