Same-day dispatch before 2 PM · Free delivery over ₹999 · GST invoices Get the appPrices incl. GST
Geekobot
Snap & SendNEWGeeko AIWhere's myOrder
Log in
Products
  • Projects
    • Component guidesHow parts work, with code you can run
    • Learning pathsFrom your first LED to your first robot
    • Workshops & eventsOnline sessions for makers and classes
    • ElectrolarkFree guided builds, simulator and certificates
    • Students & teachersStudent discount and classroom help
    • CommunityShare builds and ask other makers
    • CalculatorsOhm's law, LED resistor, 555 and 100+ more
    • Circuit builderWire parts and run the circuit, powered by Electrolark
    • Geeko AIAsk what to buy or how to wire it
    • Snap & SendPhotograph a part or list, we find it
    • Part finderAnswer a few questions, get the right part
    • Compatibility checkWill these two parts work together?
    • Compare partsSpecs side by side
    • Business & bulk ordersGST invoices, credit and volume prices
    • Request a quotationSend your list, get a quote
    • Classroom kitsPer-student kits and lab bundles
    • Gift cardsFor students, teams and events
  • Atal Tinkering Lab
BOM to cart
Geekobot

Components, kits and know-how for makers, students, engineers, labs and businesses across India.

Ask Geeko AIOrders, parts and projects, any timeEmail supportReply within 1 working dayGet the Geekobot appAdd it to your home screen, free

Follow us

Shop

  • Boards & SBCs
  • Sensors & Modules
  • IoT & Wireless
  • Drone & FPV
  • 3D Printing
  • Filaments & Resins
  • Motors & Drivers
  • Power & Batteries
  • Semiconductors
  • Passive
  • Displays & LEDs
  • Switches & Relays
  • Wires & Cables
  • Prototyping
  • Tools & Test
  • Robotics
  • STEM Kits
  • Atal Tinkering Lab
  • Mechanical Parts
  • Audio

Orders

  • Track your order
  • Help & support
  • Shipping and delivery
  • Refunds and cancellation
  • Contact us

Learn

  • Projects
  • Geeko AI project assistant
  • Learning paths
  • Guides
  • Calculators
  • Electrolark: free guided builds

Part tools

  • Part finder
  • Compare parts
  • Will it work with my board?

Institutions

  • Classroom kits
  • Atal Tinkering Lab
  • Students & teachers
  • Workshops & Events

Business

  • Business & education
  • Request a quotation
  • BOM bulk upload
  • Quick order by SKU

Company

  • About Geekobot
  • Community
  • Gift cards
  • Terms & conditions
  • Privacy policy
  • Product directory
  • Sitemap

© 2026 Geekobot, a trade name of OLatus Systems Private Limited. All rights reserved.

20, 1st Floor, Neeladri Complex, 10th Cross, Sampige Rd, 2nd Main, Malleshwaram, Bengaluru, Karnataka 560003 · GSTIN 29AACCO0462F1ZM

+91 91810 15607 · connect@geekobot.in · Monday to Saturday, 10 AM to 2 PM IST

UPI · CARDS · NETBANKING · GST INVOICES

ShopProjectsGeeko AIGuides
Compare 0 parts →
Log in

Shop by category

Shop all components
  • Boards & SBCs1,910 products
    • Alternative Single Board Computers
    • Arduino Ecosystem
    • FPGA & Logic Boards
    • Microcontroller & Wireless Boards
    View all
  • Sensors & Modules4,701 products
    • Biomedical & Heart Rate
    • Current, Voltage & Power
    • Force, Weight & Pressure
    • Gas, Weather & Environmental
    View all
  • IoT & Wireless2,314 products
    • RF Modules
    • RFID & NFC
    • Antennas & RF Accessories
    • Cameras & Smart Vision
    View all
  • Drone & FPV3,558 products
    • Flight Control & Navigation
    • FPV Video & Optics
    • Frames & Structural Parts
    • Motors & Propulsion
    View all
  • 3D Printing2,204 products
    • 3D Printers
    • 3D Scanners & Digitizers
    • Laser Engravers & Cutters
    • Material Management & Upgrades
    View all
  • Filaments & Resins1,472 products
    • Filaments
    • Photopolymer Resins
    View all
  • Motors & Drivers463 products
    • BLDC Motor Drivers
    • DC & Geared Motors
    • DC Motor Drivers
    • Linear Actuators & Solenoids
    View all
  • Power & Batteries557 products
    • Battery Holders & Connectors
    • Breadboard Power
    • Chargers & BMS
    • DC-DC Converters
    View all
  • Semiconductors295 products
    • Diodes & Rectifiers
    • Interface & RF Encoder ICs
    • Logic ICs (74xx)
    • Logic ICs (CD4000)
    View all
  • Passive67 products
    • Capacitors
    • Circuit Protection
    • Crystals & Oscillators
    • Inductors
    View all
  • Displays & LEDs572 products
    • 7-Segment & Dot Matrix
    • Addressable LEDs
    • Character LCDs
    • Graphic LCDs
    View all
  • Switches & Relays184 products
    • Keypads & Touch
    • Push Buttons & Tactile
    • Relay Modules
    • Relays
    View all
  • Wires & Cables233 products
    • Board-to-Wire Connectors
    • Crimp & Splice
    • Headers & Dupont
    • Heat Shrink & Sleeving
    View all
  • Prototyping101 products
    • Breadboards
    • Interface Modules
    • PCBs & Perfboards
    View all
  • Tools & Test717 products
    • Bench Power Supplies
    • Hand Tools
    • Measuring Tools
    • Meters & Testers
    View all
  • Robotics180 products
    • Humanoid & Legged Robots
    • Robot Chassis & Platforms
    • Robotic Arms & Grippers
    • Wheels & Casters
    View all
  • STEM Kits268 products
    • Arduino Learning Kits
    • Coding & IoT Kits
    • Early Coding (Ages 3-8)
    • Invention Kits
    View all
  • Atal Tinkering Lab196 products
    • Package 1: Electronics, Robotics, IoT and Sensors
    • Package 2: Rapid Prototyping Tools
    • Package 3: Mechanical, Electrical and Measurement Tools
    • Package 4: Power Supply, Accessories and Safety Equipment
    View all
  • Mechanical Parts212 products
    • Bearings
    • Brackets & Mounts
    • Couplers
    • Fasteners & Standoffs
    View all
  • Audio109 products
    • Amplifier Modules
    • Buzzers & Sirens
    • Speakers
    View all
  1. Home
  2. ›Guides
  3. ›Sensors
  4. ›CCS811 Air Quality Sensor

Component guide · Intermediate · 3 min read

CCS811 Air Quality Sensor

Pinout, Wiring and Code

By Geekobot Learning Team · Updated 29 Oct 2026

I'm using
Wiring, code and the Run it panels follow your board.
On this page
Short answerWhat the CCS811 isCCS811 pinoutWiring the CCS811Example codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Short answer

The CCS811 is a metal-oxide gas sensor with its own microcontroller that reports total VOC (TVOC, in ppb) and an estimated CO2 equivalent (eCO2, in ppm). It talks I2C at address 0x5A (or 0x5B) and is a 3.3 V part. Pull the WAK pin low, give it 48 hours of burn-in and 20 minutes of warm-up, and use it for indoor air quality indicators.

Key specs at a glance

Outputs
TVOC 0 to 1,187 ppb, eCO2 400 to 8,192 ppm
Method
Metal-oxide (MOX) sensor with on-chip processing
Interface
I2C, address 0x5A (ADDR low) or 0x5B
Supply
1.8 to 3.6 V (3.3 V)
Modes
Readings every 1 s, 10 s or 60 s
Control pins
WAK must be low to talk to it
01

What the CCS811 is

The CCS811 measures VOCs (gases from paints, cleaners, cooking and people) and estimates eCO2 from them, because in occupied rooms CO2 and VOCs rise together. It is not a true CO2 sensor.

The chip keeps a baseline that it updates over time; saving and restoring that baseline makes readings stable after a restart. The CCS811 is no longer made, and the ENS160 is a current alternative.

02

CCS811 pinout

The pins on the CCS811 and what each one does.

PinFunction
VCC3.3 V supply
GNDGround
SCL / SDAI2C clock and data
WAKWake: tie to GND (or drive low) to communicate
INTInterrupt output when data is ready
RSTReset, active low
ADDAddress: low 0x5A, high 0x5B
PinFunction
VCC
3.3 V supply
GND
Ground
SCL / SDA
I2C clock and data
WAK
Wake: tie to GND (or drive low) to communicate
INT
Interrupt output when data is ready
RST
Reset, active low
ADD
Address: low 0x5A, high 0x5B
03

Wiring the CCS811

The CCS811 uses I2C clock stretching, which the ESP8266 and Raspberry Pi handle poorly; ESP32 and AVR Arduinos work. Its 3.3 V I2C lines work with an Uno in most cases, but a level shifter is safer.

CCS811 pinArduino UnoESP32
VCC3.3V3V3
GNDGNDGND
SDAA4GPIO 21
SCLA5GPIO 22
WAKGNDGND
VCC
Arduino Uno:
3.3V
ESP32:
3V3
GND
Arduino Uno:
GND
ESP32:
GND
SDA
Arduino Uno:
A4
ESP32:
GPIO 21
SCL
Arduino Uno:
A5
ESP32:
GPIO 22
WAK
Arduino Uno:
GND
ESP32:
GND
04

Example code

Install "Adafruit CCS811 Library". Feed temperature and humidity from another sensor with setEnvironmentalData() for better accuracy.

Read eCO2 and TVOC (Adafruit CCS811 library) · Arduino C++Verify & upload in Electrolark
#include "Adafruit_CCS811.h"

Adafruit_CCS811 ccs;

void setup() {
  Serial.begin(115200);
  if (!ccs.begin()) { Serial.println("No CCS811 found (is WAK low?)"); while (1); }
  while (!ccs.available());
}

void loop() {
  if (ccs.available() && !ccs.readData()) {
    Serial.print("eCO2 "); Serial.print(ccs.geteCO2());
    Serial.print(" ppm  TVOC "); Serial.print(ccs.getTVOC()); Serial.println(" ppb");
  }
  delay(1000);
}
05

Setup and tuning

Burn-in

run a new sensor for 48 hours before trusting readings.

Warm-up

20 minutes after every power-up.

Baseline

read the baseline after a day of running in clean air, store it, and write it back after restarts.

Compensation

combine it with a BME280 or SHT3x for temperature and humidity input.

06

What you need

Shop this list5 of 5 found in our store · ₹2,185

  • CCS811 eCO2 TVOC air quality module: the sensor this guide coversCCS811 CO2 eCO2 TVOC Air Quality Detection Sensor Module – I2C Interface₹1,149Closest match, check the specs
  • ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
  • Bosch BME280 sensor: temperature and humidity for compensationBosch BME280 Combined Temperature, Humidity & Pressure Sensor – I²C/SPI Digital Output₹459
  • 0.96 inch OLED display 128x64: to show readings without a computer0.96" OLED Display 128x64₹139Closest match, check the specs
  • Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
07

Alternatives and when to choose them

  • ✓ENS160: current-production VOC sensor with an air quality index.
  • ✓SGP30: Sensirion VOC and eCO2 sensor.
  • ✓SCD40 and SCD41: real CO2 measurement.
08

Try it: I2c pullup calculator

Change the values and the diagram and results update as you type.

09

Common mistakes to avoid

  • !Leaving WAK floating, so the chip never answers.
  • !Treating eCO2 as a real CO2 reading.
  • !Trusting readings without burn-in and warm-up.
  • !Using it on an ESP8266 without handling clock stretching.
10

Frequently asked questions

What is the CCS811's I2C address?

0x5A with ADD low, 0x5B with ADD high.

Does the CCS811 measure CO2?

It estimates eCO2 from VOCs; it is not an NDIR CO2 sensor.

Why does it not respond?

The WAK pin is probably not low.

Is the CCS811 still made?

No, it has been discontinued; the ENS160 is an alternative.

Does it need 5 V?

No, it is a 3.3 V device.

Parts for this guide

  • CCS811 CO2 eCO2 TVOC Air Quality Detection Sensor Module – I2C Interface
    ₹1,149View
  • ESP32-WROOM-32 38-Pin Development Board
    ₹389View
  • Bosch BME280 Combined Temperature, Humidity & Pressure Sensor – I²C/SPI Digital Output
    ₹459View
  • 0.96" OLED Display 128x64
    ₹139View
  • Dupont Jumper Wires (40 pcs)
    ₹49View
Shop Gas, Air Quality & CO2 Sensors

Calculators

I2c pullup calculator

Terms in this guide

I2CInter-Integrated Circuit: a two-wire bus (SDA and SCL) that connects many devices by address.

Keep learning

ComparisonIntermediateVOC and Indoor Air Quality SensorsVOC sensors detect a mix of organic gases from cleaners, paints and cooking and report a relative index rather than a precise gas amount.3 min read · SensorsComparisonIntermediateCO2 SensorsCO2 sensors tell you when a room needs fresh air: outdoors is about 420 ppm, under 1000 ppm indoors is good and above 1500 ppm calls for ventilation.3 min read · SensorsConcept explainerIntermediateI2C ExplainedI2C is a two-wire bus that lets one microcontroller talk to many sensors and displays using a data line (SDA) and a clock line (SCL).4 min read · Electronics FundamentalsBuying guideIntermediateAir Quality SensorsCompare particle, CO2 and VOC sensors for an air monitor: PMS5003 and SDS011, NDIR CO2 vs eCO2, wiring, warm-up, power and placement for honest readings.3 min read · Sensors

Sources

  • CCS811 ultra-low power digital gas sensor datasheet (ams)
  • Adafruit CCS811 library

Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.

On this page
Short answerWhat the CCS811 isCCS811 pinoutWiring the CCS811Example codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Need a hand?Ask Geeko AI which part fits your project, or talk to the Geekobot team.Ask Geeko AIHelp & support

Parts for this guide (Arduino Uno)3 items · ₹1,812

CCS811 CO2 eCO2 TVOC Air Quality Detection Sensor Module – I2C Interface · Bosch BME280 Combined Temperature, Humidity & Pressure Sensor – I²C/SPI Digital Output · Uno R3 CH340G ATmega328p Compatible Development Board

Run itChange the inputs and watch the output

eCO2 starts at 400 ppm. The CCS811 needs 20 minutes to settle and 48 hours burn-in when new.

Serial monitor115200 baud
eCO2 937 ppm  TVOC 82 ppb

A simulation of the sketch above, so you know what to expect. Real readings vary with your parts and wiring.

Ask the Community

Ask a question