Luftqualität 7 Click Board
Luftqualität 7 Click Board
Overview
Der Luftqualität 7 Click Board™ ist eine kompakte Zusatzplatine, die modernste MOS-Sensortechnologie mit intelligenten Erkennungsalgorithmen kombiniert, um VOC- und CO2-Äquivalentschwankungen in beengten Räumen zu überwachen. Diese Platine verfügt über das MiCS-VZ-89TE, ein integriertes Sensormodul zur Überwachung der Raumluftqualität von Amphenol. Dieses Click Board™, eine I2C-konfigurierbare Umweltsensorplatine, verfügt über viele Funktionen wie niedrigen Stromverbrauch, großen VOC-Erkennungsbereich, hohe Empfindlichkeit und hohe Stoß- und Vibrationsfestigkeit, was es zu einer ausgezeichneten Wahl für die VOC- und CO2-Überwachung in beengten Räumen wie Konferenzräumen und Fahrzeugkabinen macht, wodurch Energie gespart und die Betriebskosten gesenkt werden.
Der Luftqualität 7 Click Board™ wird durch eine mikroSDK-kompatible Bibliothek unterstützt, die Funktionen enthält, die die Softwareentwicklung vereinfachen. Dieses Click Board™ wird als vollständig getestetes Produkt geliefert und ist bereit für den Einsatz auf einem System, das mit der mikroBUS™-Buchse ausgestattet ist.
How Does The Air Quality 7 Click Board™ Work?
The Air Quality 7 Click Board™ is based on the MiCS-VZ-89TE, an integrated sensor module for indoor air quality monitoring from Amphenol. The MiCS-VZ-89TE combines the most modern MOS sensor technology with intelligent detection algorithms to control VOCs and CO2 fluctuations in buildings. Among some other appealing features like 3.3V supply, I2C communication, and calibration-free high sensitivity this module has a characteristic a small size factor. The sensor must not be exposed to high concentrations of organic solvents, ammonia, silicone vapor, or cigarette-smoke to avoid poisoning the sensitive layer. It should be protected against water and dust projections, and its Vendor strongly recommends using ESD protection equipment to handle the sensor.
The Air Quality 7 Click Board™ is easy to program and read data because it does not require an overly demanding configuration. The first step is the initialization of all the necessary peripherals and pins. The additional delay time of a couple of seconds during system initialization is needed because this Click board™ needs some time to establish the measurements. The second initialization is the I2C driver and communication test by reading the revision information of the module. If the CRC check is OK it allows the program to go on, and if it's not OK, a user needs to restart the program. If every step is valid, the user can read the air quality status. This can also be seen in an example code that contains easy to use functions that may be used as a reference for further development.
The Air Quality 7 Click Board™ communicates with MCU using the standard I2C 2-Wire interface that supports Standard-Mode operation with a bit rates up to 100 kbit/s. The MiCS-VZ-89TE slave address contains seven fixed bits. The slave address byte is the first byte received following the START condition from the Master device. The first part of the address byte consists of a 4-bit device code which is set to 1110 for the IAQS followed by three address bits (A2, A1, A0) which are programmed at 0. The dual signal output routed on the OUT pin of the mikroBUS™ socket, which brings the results of the measurements, can be read through a multiplexed PWM output or an I2C bus.
The Air Quality 7 Click Board™ is designed to be operated only with a 3.3V logic voltage level. A proper logic voltage level conversion should be performed before the Air Quality 7 Click Board™ is used with MCUs with different logic voltage levels. More information about the MiCS-VZ-89TE can be found in the attached datasheet. However, the Click board™ comes equipped with a library that contains easy to use functions and a usage example that may be used as a reference for further development.
SPECIFICATIONS
Type | Gas |
Applications | Can be used for a VOC and CO2 monitoring in confined spaces such as meeting rooms and vehicle cabins, saving energy and reducing cost-of-ownership. |
On-board modules | The Air Quality 7 Click Board™ is based on the MiCS-VZ-89TE, an integrated sensor module for indoor air quality monitoring from Amphenol. |
Key Features | Low power consumption, wide VOC detection range, high sensitivity, high resistance to shocks and vibrations, and more. |
Interface | I2C |
Compatibility | mikroBUS |
Click board size | M (42.9 x 25.4 mm) |
Input Voltage | 3.3V or 5V |
PINOUT DIAGRAM
This table shows how the pinout on the Air Quality 7 Click Board™ corresponds to the pinout on the mikroBUS™ socket (the latter shown in the two middle columns).
Notes | Pin | Pin | Notes | ||||
---|---|---|---|---|---|---|---|
NC | 1 | AN | PWM | 16 | NC | ||
NC | 2 | RST | INT | 15 | OUT | PWM Output | |
NC | 3 | CS | RX | 14 | NC | ||
NC | 4 | SCK | TX | 13 | NC | ||
NC | 5 | MISO | SCL | 12 | SCL | I2C Clock | |
NC | 6 | MOSI | SDA | 11 | SDA | I2C Data | |
Power Supply | 3.3V | 7 | 3.3V | 5V | 10 | 5V | Power Supply |
Ground | GND | 8 | GND | GND | 9 | GND | Ground |
ONBOARD SETTINGS AND INDICATORS
Label | Name | Default | Description |
---|---|---|---|
LD1 | PWR | - | Power LED Indicator |
AIR QUALITY 7 CLICK ELECTRICAL SPECIFICATIONS
Description | Min | Typ | Max | Unit |
---|---|---|---|---|
Supply Voltage | - | 3.3 | - | V |
CO2 Monitoring Range | 400 | - | 2000 | ppm |
VOCs Monitoring Range | 0 | - | 1000 | ppB |
Operating Temperature Range | 0 | - | 50 | °C |
Software Support
We provide a library for the Air Quality 7 Click Board™ on our LibStock page, as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.
Library Description
This library allows users to check the CO2 (Carbon Dioxide) and tVOC (Total Volatile Organic Compounds) levels of the air quality. The recalibration of the device is also allowed by this library. For more details, please, check the full documentation.
Key Functions
void airquality7_set_ppmco2( uint8_t *ppmco2_value );
- This function is used to send the ppmCO2 value given by an external analyzer to the Air Quality 7 Click Board™ in order to recalibrate its outputs.airquality7_err_t airquality7_get_status( uint16_t *tvoc_ppb, uint16_t *co2_ppm, uint32_t *res_val_ohm, uint8_t *err_byte );
- This function is used to read the Air quality 7 click status coded on tVOC data byte [0 - 1000 ppb], CO2 data byte [400 - 2000 ppm], resistor value data 3 bytes [Ohm], error status byte and CRC byte.airquality7_err_t airquality7_get_r0_calib( uint16_t *r0_kohm );
- This function is used to read the R0 (calibration) value in [kOhms] coded on 2 data bytes and CRC byte.
Example Description
The application is composed of three sections :
- System Initialization - Initializes all necessary peripherals and pins. Performs a delay time of a couple of seconds because the Air quality 7 Click needs some time to establish the measurements.
- Application Initialization - Initializes the I2C driver and reads revision of the module. If CRC check is OK allows the program to go on, and if it's not OK, needs to restart the program.
- Application Task - Reads air quality status every 1500ms and shows the results on the serial terminal.
void application_task( ) { airquality7_err_code = airquality7_get_status( &airquality7_tvoc_ppb, &airquality7_co2_ppm, &airquality7_res_val_ohm, AIRQUALITY7_NULL ); if ( airquality7_err_code == AIRQUALITY7_ERR_OK ) { char log_txt[ 50 ]; uint8_t cnt; log_txt[ 0 ] = 13; log_txt[ 1 ] = 0; mikrobus_logWrite( log_txt, _LOG_TEXT ); for ( cnt = 0; cnt < 70; cnt++ ) { mikrobus_logWrite( " ", _LOG_TEXT ); Delay_ms( 5 ); } mikrobus_logWrite( log_txt, _LOG_TEXT ); WordToStr( airquality7_tvoc_ppb, log_txt ); Ltrim( log_txt ); mikrobus_logWrite( " tVOC [ppb] = ", _LOG_TEXT ); mikrobus_logWrite( log_txt, _LOG_TEXT ); mikrobus_logWrite( "; ", _LOG_TEXT ); WordToStr( airquality7_co2_ppm, log_txt ); Ltrim( log_txt ); mikrobus_logWrite( "CO2 [ppm] = ", _LOG_TEXT ); mikrobus_logWrite( log_txt, _LOG_TEXT ); mikrobus_logWrite( "; ", _LOG_TEXT ); LongWordToStr( airquality7_res_val_ohm, log_txt ); Ltrim( log_txt ); mikrobus_logWrite( "Resistor value [ohm] = ", _LOG_TEXT ); mikrobus_logWrite( log_txt, _LOG_TEXT ); } Delay_ms( 1500 ); }
The full application code, and ready to use projects can be found on our LibStock page.
Other mikroE Libraries used in the example:
- Conversions
- C_String
- I2C
- UART
Additional Notes and Information
Depending on the development board you are using, you may need a 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. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.
MIKROSDK
The Air Quality 7 Click Board™ is supported with mikroSDK - MikroElektronika Software Development Kit. To ensure proper operation of mikroSDK compliant Click board™ demo applications, mikroSDK should be downloaded from the LibStock and installed for the compiler you are using.
Software Support
We provide a library for the Air Quality 7 Click Board™ on our LibStock page, as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.
Library Description
This library allows users to check the CO2 (Carbon Dioxide) and tVOC (Total Volatile Organic Compounds) levels of the air quality. The recalibration of the device is also allowed by this library. For more details, please, check the full documentation.
Key Functions
void airquality7_set_ppmco2( uint8_t *ppmco2_value );
- This function is used to send the ppmCO2 value given by an external analyzer to the Air Quality 7 Click Board™ in order to recalibrate its outputs.airquality7_err_t airquality7_get_status( uint16_t *tvoc_ppb, uint16_t *co2_ppm, uint32_t *res_val_ohm, uint8_t *err_byte );
- This function is used to read the Air quality 7 click status coded on tVOC data byte [0 - 1000 ppb], CO2 data byte [400 - 2000 ppm], resistor value data 3 bytes [Ohm], error status byte and CRC byte.airquality7_err_t airquality7_get_r0_calib( uint16_t *r0_kohm );
- This function is used to read the R0 (calibration) value in [kOhms] coded on 2 data bytes and CRC byte.
Example Description
The application is composed of three sections :
- System Initialization - Initializes all necessary peripherals and pins. Performs a delay time of a couple of seconds because the Air quality 7 Click needs some time to establish the measurements.
- Application Initialization - Initializes the I2C driver and reads revision of the module. If CRC check is OK allows the program to go on, and if it's not OK, needs to restart the program.
- Application Task - Reads air quality status every 1500ms and shows the results on the serial terminal.
void application_task( ) { airquality7_err_code = airquality7_get_status( &airquality7_tvoc_ppb, &airquality7_co2_ppm, &airquality7_res_val_ohm, AIRQUALITY7_NULL ); if ( airquality7_err_code == AIRQUALITY7_ERR_OK ) { char log_txt[ 50 ]; uint8_t cnt; log_txt[ 0 ] = 13; log_txt[ 1 ] = 0; mikrobus_logWrite( log_txt, _LOG_TEXT ); for ( cnt = 0; cnt < 70; cnt++ ) { mikrobus_logWrite( " ", _LOG_TEXT ); Delay_ms( 5 ); } mikrobus_logWrite( log_txt, _LOG_TEXT ); WordToStr( airquality7_tvoc_ppb, log_txt ); Ltrim( log_txt ); mikrobus_logWrite( " tVOC [ppb] = ", _LOG_TEXT ); mikrobus_logWrite( log_txt, _LOG_TEXT ); mikrobus_logWrite( "; ", _LOG_TEXT ); WordToStr( airquality7_co2_ppm, log_txt ); Ltrim( log_txt ); mikrobus_logWrite( "CO2 [ppm] = ", _LOG_TEXT ); mikrobus_logWrite( log_txt, _LOG_TEXT ); mikrobus_logWrite( "; ", _LOG_TEXT ); LongWordToStr( airquality7_res_val_ohm, log_txt ); Ltrim( log_txt ); mikrobus_logWrite( "Resistor value [ohm] = ", _LOG_TEXT ); mikrobus_logWrite( log_txt, _LOG_TEXT ); } Delay_ms( 1500 ); }
The full application code, and ready to use projects can be found on our LibStock page.
Other mikroE Libraries used in the example:
- Conversions
- C_String
- I2C
- UART
Additional Notes and Information
Depending on the development board you are using, you may need a 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. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.
MIKROSDK
The Air Quality 7 Click Board™ is supported with mikroSDK - MikroElektronika Software Development Kit. To ensure proper operation of mikroSDK compliant Click board™ demo applications, mikroSDK should be downloaded from the LibStock and installed for the compiler you are using.
Frequently Asked Questions
Have a Question?
Be the first to ask a question about this.