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]
Rating:
Author: MIKROE
Last Updated: 2024-10-31
Package Version: 2.1.0.11
mikroSDK Library: 2.0.0.0
Category: Gas
Downloaded: 165 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.
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".
DOWNLOAD LINK | RELATED COMPILER | CONTAINS |
---|---|---|
4931_air_quality_9_cl.zip [447.89KB] | mikroC AI for ARM GCC for ARM Clang for ARM mikroC AI for PIC mikroC AI for PIC32 XC32 GCC for RISC-V Clang for RISC-V mikroC AI for AVR mikroC AI for dsPIC XC16 |
|
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.
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.
This library contains API for Air Quality 9 Click driver.
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 );
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 );
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 :
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 " );
}
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:
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.