NAME

Device::Chip::CCS811 - chip driver for CCS811

SYNOPSIS

            

              
              
use Device::Chip::CCS811;
use Future::AsyncAwait;
my $chip = Device::Chip::CCS811->new;
await $chip->mount( Device::Chip::Adapter::...->new );
await $chip->init;
await $chip->change_config( DRIVE_MODE => 1 );
sleep 60; # wait for chip to warm up
my ( $eCO2, $eTVOC ) = await $chip->read_alg_result_data;
printf "eCO2=%dppm\n", $eCO2;
printf "eTVOC=%dppb\n", $eTVOC;
            
          

DESCRIPTION

This Device::Chip subclass provides specific communication to a ScioSense CCS811 Digital Gas Sensor attached to a computer via an I²C adapter.

The reader is presumed to be familiar with the general operation of this chip; the documentation here will not attempt to explain or define chip-specific concepts or features, only the use of this module to access them.

METHODS

The following methods documented in an await expression return Future instances.

read_status

            

              
              
$status = await $chip->read_status;
            
          

Reads the STATUS register and returns a hash reference containing the following fields:

            

              
              
FWMODE     => "boot" | "app"
APP_ERASE  => 0 | 1
APP_VERIFY => 0 | 1
APP_VALID  => 0 | 1
DATA_READY => 0 | 1
ERROR      => 0 | 1
            
          

read_config

            

              
              
$config = await $chip->read_config;
            
          

Reads the MEAS_MODE configuration register and reeturns a hash reference containing the following fields:

            

              
              
DRIVE_MODE  => 0 | 1 | 2 | 3 | 4
INT_DATARDY => 0 | 1
INT_THRESH  => 0 | 1
            
          

change_config

            

              
              
await $chip->change_config( %changes );
            
          

Writes updates to the MEAS_MODE configuration register.

read_alg_result_data

            

              
              
$data = await $chip->read_alg_result_data;
            
          

Reads the ALG_RESULT_DATA register and returns a hash reference containing the following fields, in addition to the STATUS fields.

            

              
              
eCO2     => INT (in units of ppm)
eTVOC    => INT (in unts of ppb)
ERROR_ID => INT
            
          

read_id

            

              
              
$id = await $chip->read_id;
            
          

Reads the HW_ID register and returns an integer. This should be the value 0x81 for the CCS811 chip.

init

            

              
              
await $chip->init;
            
          

Performs the chip startup actions; namely, starting the application if the chip is still in bootloader mode.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>

cpanm Device::Chip::CCS811

perl -MCPAN -e shell
install Device::Chip::CCS811