CCS811 Air Quality Sensor

R2026b

Measure equivalent CO₂ (eCO₂) and the equivalent total volatile organic compound concentration (eTVOC)

Since R2022b

• 

CCS811 Air Quality Sensor block

To add a block to a model, double-click the canvas and start typing the block name. Then, select the block from the list.

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

Description

The CCS811 Air Quality Sensor block measures the equivalent CO₂ (eCO₂) 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).

Note

To generate C/C++ code for this block, you must have an Embedded Coder^® license.

Ports

Output

eCO₂ — Equivalent CO₂

scalar

The eCO₂ port outputs the value for equivalent CO₂ of indoor air in parts per million (ppm).

Data Types: single | double

eTVOC — Total volatile organic compound concentration

scalar

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

Data Types: single | double

Status — Status of values read for eCO₂ and eTVOC

0 | 1

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

Data Types: uint8

Parameters

I2C Module — Specific module used for I2C communication

1 (default)

Specify the module on the board that you are using for I2C communication.

I2C address — I2C address of sensor

0x5A (default) | 0x5B

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 Name	Pin State	I2C Address
ADDR	Low	0x5A
	High	0x5B

Data acquisition interval (s) — Intervals for data acquisition

1 (default) | 0.25 | 10 | 60

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.

Specify environmental conditions — Environmental conditions

Mask dialog (default) | External sensor

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

Humidity (%) — Humidity input to CCS811 sensor

50 (default) | positive integer

Humidity in percentage provided as an input to CCS811 sensor connected to Raspberry Pi^® board.

Dependencies

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

Temperature (^oC) — Temperature input to CCS811 sensor

25 (default) | positive integer

Temperature (in ℃) provided as an input to CCS811 sensor connected to Raspberry Pi board.

Dependencies

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

Enable data ready interrupt — Enable interrupt when data is ready

off (default) | on

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.

Data type — Type of output data

single (default) | double

Select the data type for output.

Sample time — Time interval to read data

-1 (default) | positive integer

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.

"raspberrypienvironmentalsensorslib/CCS811 Air Quality Sensor"

"arduinosensorlib/CCS811 Air Quality Sensor"

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

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using Simulink® Coder™.

To generate C/C++ code for this block, you must have an Embedded Coder license. For more information on selecting the right product stack according to your development goals, see Product Stack for Raspberry Pi Blockset.

Version History

Introduced in R2022b