CCS811 Air Quality Sensor

R2026b

Measure equivalent CO2 (eCO2) and the equivalent total volatile organic compound concentration (eTVOC)

Since R2022a

expand all in page
  • CCS811 Sensor

Libraries:
Simulink Support Package for Arduino Hardware / Sensors
Raspberry Pi Blockset / Sensors / Environmental Sensors
STM32 Microcontroller Blockset / Sensors / Environmental Sensors

Description

Add-On Required: This feature requires the Simulink Support Package for Arduino Hardware add-on.

The CCS811 Air Quality Sensor block measures the equivalent CO2 (eCO2) and the equivalent total volatile organic compound concentration (eTVOC) for indoor air quality monitoring. This block also provides the option to provide temperature and humidity data to enable compensation (either by specifying the humidity and temperature values or by interfacing CCS811 with an external sensor).

Ports

Output

expand all

The eCO2 port outputs the value for equivalent CO2 of indoor air in parts per million (ppm).

Data Types: single | double

The eTVOC port outputs the equivalent total volatile organic compound concentration of indoor air in parts per billion (ppb).

Data Types: single | double

Status of the values 0 indicates that the data read for eCO2 and eTVOC is new and 1 indicates that the data read is not new.

Data Types: uint8

Parameters

expand all

Specify the I2C module on the Arduino® hardware to communicate with sensor peripherals. For more information on the Arduino pin mapping and modules that hardware boards support, see Pin Mapping for Arduino Timer-Independent Blocks.

The I2C address of the CCS811 sensor from which the block reads the values.

The I2C address of the CCS811 sensor from which the block reads the values. The CCS811 sensor can have two I2C addresses depending on the logic level on pin ADDR of the sensor.

Pin NamePin StateI2C Address
ADDRLow0x5A
High0x5B

Select the data acquisition interval in seconds for the sensor to read data. For example, if you select value 1, then the sensor reads values every 1 second.

Select the option to specify the source of environmental inputs for the sensor while reading data.

Humidity in percentage provided as an input to CCS811 sensor connected to Arduino hardware.

Dependencies

This parameter appears only if you select Mask dialog for Specify environmental conditions parameter.

Temperature (in ℃) provided as an input to CCS811 sensor connected to Arduino hardware.

Dependencies

This parameter appears only if you select Mask dialog for Specify environmental conditions parameter.

If this option is selected, an interrupt is generated on pin nINT of the sensor when data is ready, allowing you to trigger other subsystems to perform any action.

Select the data type for output.

Specify how often this block reads the data from the CCS811 sensor. When you set this parameter to -1, Simulink determines the best sample time for the block based on the block context within the model.

Programmatic Use: Add Block

To add the block programmatically, use the add_block function with one of these library block paths as the source.

"arduinosensorlib/CCS811 Air Quality Sensor"
"raspberrypienvironmentalsensorslib/CCS811 Air Quality Sensor"
"stm32Environmentalsensorslib/CCS811 Air Quality Sensor"

Example: add_block("arduinosensorlib/CCS811 Air Quality Sensor","myModel/myBlock",MakeNameUnique="on")

Version History

Introduced in R2022a

See Also

Topics