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.
baseline

The propery reads and returns the current baseline value. The returned value is packed into an integer. Later the same integer can be used in order to set a new baseline.

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.