CCS811 - Adafruit CCS811 Air Quality Sensor Breakout - VOC and eCO2

This library supports the use of the CCS811 air quality sensor in CircuitPython.

Author(s): Dean Miller for Adafruit Industries

Notes:

#. Datasheet

class adafruit_ccs811.CCS811(i2c_bus, address=90)[source]

CCS811 gas sensor driver.

Parameters:
  • i2c (I2C) – The I2C bus.
  • addr (int) – The I2C address of the CCS811.
data_ready

True when new data has been read.

eco2

Equivalent Carbon Dioxide in parts per million. Clipped to 400 to 8192ppm.

error

True when an error has occured.

error_code

Error code

reset()[source]

Initiate a software reset.

set_environmental_data(humidity, temperature)[source]

Set the temperature and humidity used when computing eCO2 and TVOC values.

Parameters:
  • humidity (int) – The current relative humidity in percent.
  • temperature (float) – The current temperature in Celsius.
set_interrupt_thresholds(low_med, med_high, hysteresis)[source]

Set the thresholds used for triggering the interrupt based on eCO2. The interrupt is triggered when the value crossed a boundary value by the minimum hysteresis value.

Parameters:
  • low_med (int) – Boundary between low and medium ranges
  • med_high (int) – Boundary between medium and high ranges
  • hysteresis (int) – Minimum difference between reads
temp_offset = 0.0

Temperature offset.

temperature

Deprecated since version 1.1.5: Hardware support removed by vendor

Temperature based on optional thermistor in Celsius.

tvoc

Total Volatile Organic Compound in parts per billion.