/embedded-ccs811-rs

Platform agnostic Rust driver for the CCS811 ultra-low power digital gas sensor for monitoring indoor air quality

Primary LanguageRustApache License 2.0Apache-2.0

Rust CCS811 Driver: Ultra-low Power Digital Gas Sensor for Monitoring Indoor Air Quality

crates.io Docs Build Status Coverage Status

This is a platform agnostic Rust driver for the CCS811 ultra-low power digital VOC sensor for monitoring indoor air quality (IAQ) using the embedded-hal traits.

This driver allows you to:

  • In application mode:
    • Set the measurement mode. See: set_mode().
    • Check if there is new data ready. See: has_data_ready().
    • Get the algoritm and raw result data. See: data().
    • Get the raw data. See: raw_data().
    • Get the current baseline. See: baseline().
    • Set the baseline. See: set_baseline().
    • Set the environment temperature and relative humidity. See: set_environment().
    • Set the interrupt mode. See: set_interrupt_mode().
    • Set the eCO2 thresholds for interrupts. See: set_eco2_thresholds().
  • In boot mode:
    • Start application. See: start_application().
    • Reset, erase, download and verify new application. See: update_application().
    • Erase application. See: erase_application().
    • Verify application. See: verify_application().
    • Download application. See: download_application().
  • In either mode:
    • Get the firmware mode. See: firmware_mode().
    • Check whether a valid application is loaded. See: has_valid_app().
    • Get the hardware ID. See: hardware_id().
    • Get the hardware version. See: hardware_version().
    • Get the firmware bootloader version. See: firmware_bootloader_version().
    • Get the firmware application version. See: firmware_application_version().
    • Do a software reset. See: software_reset().

Introductory blog post

The device

The CCS811 is an ultra-low power digital gas sensor solution which integrates a metal oxide (MOX) gas sensor to detect a wide range of Volatile Organic Compounds (VOCs) for indoor air quality monitoring with a microcontroller unit (MCU), which includes an Analog-to-Digital converter (ADC), and an I²C interface.

CCS811 is based on ams unique micro-hotplate technology which enables a highly reliable solution for gas sensors, very fast cycle times and a significant reduction in average power consumption.

The integrated MCU manages the sensor driver modes and measurements. The I²C digital interface significantly simplifies the hardware and software design, enabling a faster time to market.

CCS811 supports intelligent algorithms to process raw sensor measurements to output equivalent total VOC (eTVOC) and equivalent CO2 (eCO2) values, where the main cause of VOCs is from humans.

CCS811 supports multiple measurement modes that have been optimized for low-power consumption during an active sensor measurement and idle mode extending battery life in portable applications.

Documentation:

Usage

To use this driver, import this crate and an embedded_hal implementation, then instantiate the device.

Please find additional examples using hardware in this repository: driver-examples

extern crate linux_embedded_hal as hal;
use embedded_ccs811::{prelude::*, Ccs811, MeasurementMode, SlaveAddr};
use nb::block;

fn main() {
    let dev = hal::I2cdev::new("/dev/i2c-1").unwrap();
    let nwake = hal::Pin::new(17);
    let delay = hal::Delay {};
    let address = SlaveAddr::default();
    let sensor = Ccs811::new(dev, address, nwake, delay);
    let mut sensor = sensor.start_application().ok().unwrap();
    sensor.set_mode(MeasurementMode::ConstantPower1s).unwrap();
    loop {
        let data = block!(sensor.data()).unwrap();
        println!("eCO2: {}, eTVOC: {}", data.eco2, data.etvoc);
    }
}

Support

For questions, issues, feature requests, and other changes, please file an issue in the github project.

License

Licensed under either of

at your option.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.