TOP Contributors

  1. MIKROE (2762 codes)
  2. Alcides Ramos (374 codes)
  3. Shawon Shahryiar (307 codes)
  4. jm_palomino (118 codes)
  5. Bugz Bensce (90 codes)
  6. S P (73 codes)
  7. dany (71 codes)
  8. MikroBUS.NET Team (35 codes)
  9. NART SCHINACKOW (34 codes)
  10. Armstrong Subero (27 codes)

Most Downloaded

  1. Timer Calculator (139250 times)
  2. FAT32 Library (71746 times)
  3. Network Ethernet Library (57120 times)
  4. USB Device Library (47429 times)
  5. Network WiFi Library (43082 times)
  6. FT800 Library (42403 times)
  7. GSM click (29835 times)
  8. mikroSDK (28074 times)
  9. PID Library (26885 times)
  10. microSD click (26198 times)
Libstock prefers package manager

Package Manager

We strongly encourage users to use Package manager for sharing their code on Libstock website, because it boosts your efficiency and leaves the end user with no room for error. [more info]

< Back
mikroSDK Library

Air quality 9 Click

Rating:

0

Author: MIKROE

Last Updated: 2024-10-31

Package Version: 2.1.0.11

mikroSDK Library: 2.0.0.0

Category: Gas

Downloaded: 167 times

Not followed.

License: MIT license  

Air quality 9 Click is a compact add-on board containing a best-in-class air-quality sensing solution. This board features the ENS160, a digital multi-gas sensor solution based on metal oxide (MOX) technology with four MOx sensor elements from ScioSense. Each sensor element has independent hotplate control to detect a wide range of gases. The ENS160 series features TrueVOCâ„¢ air quality detection and supports intelligent algorithms, which calculate CO2 equivalents, TVOC, air quality index (AQI), and perform humidity and temperature compensation. This Click boardâ„¢ is interface-configurable and characterized by outstanding long-term stability and lifetime.

No Abuse Reported

Do you want to subscribe in order to receive notifications regarding "Air quality 9 Click" changes.

Do you want to unsubscribe in order to stop receiving notifications regarding "Air quality 9 Click" changes.

Do you want to report abuse regarding "Air quality 9 Click".

  • Information
  • Comments (0)

mikroSDK Library Blog


Air Quality 9 Click

Air quality 9 Click is a compact add-on board containing a best-in-class air-quality sensing solution. This board features the ENS160, a digital multi-gas sensor solution based on metal oxide (MOX) technology with four MOx sensor elements from ScioSense. Each sensor element has independent hotplate control to detect a wide range of gases. The ENS160 series features TrueVOC™ air quality detection and supports intelligent algorithms, which calculate CO2 equivalents, TVOC, air quality index (AQI), and perform humidity and temperature compensation. This Click board™ is interface-configurable and characterized by outstanding long-term stability and lifetime.

airquality9_click.png

Click Product page


Click library

  • Author : Stefan Filipovic
  • Date : Mar 2022.
  • Type : I2C/SPI type

Software Support

We provide a library for the Air Quality 9 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for Air Quality 9 Click driver.

Standard key functions :

  • airquality9_cfg_setup Config Object Initialization function.

    void airquality9_cfg_setup ( airquality9_cfg_t *cfg );
  • airquality9_init Initialization function.

    err_t airquality9_init ( airquality9_t *ctx, airquality9_cfg_t *cfg );
  • airquality9_default_cfg Click Default Configuration function.

    err_t airquality9_default_cfg ( airquality9_t *ctx );

Example key functions :

  • airquality9_read_aqi_uba This function reads the Air Quality Index per UBA (AQI-UBA).

    err_t airquality9_read_aqi_uba ( airquality9_t *ctx, uint8_t *aqi_uba );
  • airquality9_read_tvoc This function reads the calculated Total Volatile Organic Compounds (TVOC) concentration per ppb.

    err_t airquality9_read_tvoc ( airquality9_t *ctx, uint16_t *tvoc );
  • airquality9_read_eco2 This function reads the calculated Equivalent CO2 (eCO2) concentration per ppm.

    err_t airquality9_read_eco2 ( airquality9_t *ctx, uint16_t *eco2 );

Example Description

This example demonstrates the use of Air Quality 9 Click board by reading and displaying outputs such as eCO2, TVOC and AQI in compliance with worldwide IAQ standards.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger and performs the Click default configuration.


void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    airquality9_cfg_t airquality9_cfg;  /**< Click config object. */

    /** 
     * Logger initialization.
     * Default baud rate: 115200
     * Default log level: LOG_LEVEL_DEBUG
     * @note If USB_UART_RX and USB_UART_TX 
     * are defined as HAL_PIN_NC, you will 
     * need to define them manually for log to work. 
     * See @b LOG_MAP_USB_UART macro definition for detailed explanation.
     */
    LOG_MAP_USB_UART( log_cfg );
    log_init( &logger, &log_cfg );
    log_info( &logger, " Application Init " );

    // Click initialization.
    airquality9_cfg_setup( &airquality9_cfg );
    AIRQUALITY9_MAP_MIKROBUS( airquality9_cfg, MIKROBUS_1 );
    err_t init_flag  = airquality9_init( &airquality9, &airquality9_cfg );
    if ( ( I2C_MASTER_ERROR == init_flag ) || ( SPI_MASTER_ERROR == init_flag ) )
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }

    if ( AIRQUALITY9_ERROR == airquality9_default_cfg ( &airquality9 ) )
    {
        log_error( &logger, " Default configuration." );
        for ( ; ; );
    }

    log_info( &logger, " Application Task " );
}

Application Task

Waits for the new data interrupt which triggers once per second, and then reads the validity status, TVOC, eCO2, and AQI-UBA values. All values are being displayed on the USB UART where you can track their changes.

void application_task ( void )
{
    if ( airquality9_get_int_pin ( &airquality9 ) )
    {
        uint8_t status, aqi_uba;
        uint16_t tvoc, eco2;
        if ( AIRQUALITY9_OK == airquality9_read_status ( &airquality9, &status ) )
        {
            airquality9_display_status_validity ( status );
        }
        if ( AIRQUALITY9_OK == airquality9_read_tvoc ( &airquality9, &tvoc ) )
        {
            log_printf ( &logger, " TVOC: %u ppb\r\n", tvoc );
        }
        if ( AIRQUALITY9_OK == airquality9_read_eco2 ( &airquality9, &eco2 ) )
        {
            log_printf ( &logger, " ECO2: %u ppm\r\n", eco2 );
        }
        if ( AIRQUALITY9_OK == airquality9_read_aqi_uba ( &airquality9, &aqi_uba ) )
        {
            airquality9_display_aqi_uba ( aqi_uba );
        }
    }
}

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.AirQuality9

Additional notes and informations

Depending on the development board you are using, you may need USB UART Click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. UART terminal is available in all MikroElektronika compilers.


ALSO FROM THIS AUTHOR

Datalogger for Temperature and Humidity

8

We’ll show you how easily you can create a fantastic Temperature and Humidity Datalogger device which draws graph on TFT display and stores the acquisition data on the microSD card. We have added an extra autonomous battery power supply feature, so you can carry around your datalogger where ever you go.

[Learn More]

DIGI IO Click

0

DIGI I/O Click is a compact add-on board for flexible industrial digital input and output control. This board features the MAX14906, a quad-channel industrial digital input/output IC from Analog Devices, compliant with IEC 61131-2 standard. Each channel can be individually configured as a high-side switch, push-pull driver, or digital input, supporting various operating modes with current limiting up to 1.2A and fast signal transmission. The board supports 24V operation by default, with options for individual channel power configuration, and includes built-in diagnostics like overvoltage and undervoltage detection, thermal overload, and wire-break detection. DIGI I/O Click is ideal for industrial automation, motor control systems, PLCs, and Distributed Control Systems (DCS).

[Learn More]

BI HALL Click

0

Bi Hall Click is a simple solution for adding a bipolar Hall switch to your design. It carries the Melexis US2882 bipolar Hall-effect switch and a 74LVC1T45 single bit, dual supply transceiver.

[Learn More]