Environment Click Board
Environment Click Board
The Environment Click Board™ measures temperature, relative humidity, pressure and VOC (Volatile Organic compounds gases).
The Click Board™ is based on the Bosch BME680 environmental sensor from Bosch. The Environment Click Board™ is designed to run on a 3.3V power supply. It communicates with the target microcontroller over SPI or I2C interface.
You can use it to test your indoor air quality, to control HVAC (heating, ventilation, and air conditioning) systems, in a weather station, sports applications and more.
The Environment Click Board™ measures temperature, relative humidity, pressure and VOC (Volatile Organic compounds gases). The click carries the BME680 environmental sensor from Bosch. The Environment Click Board™ is designed to run on a 3.3V power supply. It communicates with the target microcontroller over SPI or I2C interface.
You can use it to test your indoor air quality, to control HVAC (heating, ventilation, and air conditioning) systems, in a weather station, sports applications and more.
BME680 Sensor Features
The BME680 is as combined digital gas, humidity, pressure, and temperature sensor based on proven sensing principles.
The humidity sensor provides an extremely fast response time for fast context awareness applications and high overall accuracy over a wide temperature range. The pressure sensor is an absolute barometric pressure sensor with extremely high accuracy and resolution.
The integrated temperature sensor has been optimized for lowest noise and highest resolution. Its output is used for temperature compensation of the pressure and humidity sensors and can also be used for estimation of the ambient temperature.
The gas sensor within the BME680 can detect a broad range of gases to measure indoor air quality for personal well being. Gases that can be detected by the BME680 include Volatile Organic Compounds (VOC) from paints (such as formaldehyde), lacquers, paint strippers, cleaning supplies, furnishings, office equipment, glues, adhesives, and alcohol.
SPECIFICATIONS
Type | Environmental |
Applications | Indoor air quality measurement, personalized weather station, home automation control, measuring ambient temperature, etc. |
On-board modules | BME680 integrated environmental sensor |
Key Features | A digital 4-in-1 sensor with gas, humidity, pressure and temperature measurement |
Interface | I2C,SPI |
Compatibility | mikroBUS |
Click board size | S (28.6 x 25.4 mm) |
Input Voltage | 3.3V |
PINOUT DIAGRAM
This table shows how the pinout on the Environment 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 | NC | ||
Chip select | CS | 3 | CS | TX | 14 | NC | |
SPI clock | SCK | 4 | SCK | RX | 13 | NC | |
Master in slave out | MISO | 5 | MISO | SCL | 12 | SCL | I2C clock |
Master out slave in | MOSI | 6 | MOSI | SDA | 11 | SDA | I2C data |
Power supply | +3.3V | 7 | 3.3V | 5V | 10 | NC | |
Ground | GND | 8 | GND | GND | 9 | GND | Ground |
JUMPERS AND SETTINGS
Designator | Name | Default Position | Default Option | Description |
---|---|---|---|---|
JP1 | COMM. SEL. | Right | I2C | Selecting communication with MCU between SPI and I2C |
JP2 | ADDR. SEL. | Right | 1 | I2C address selection |
JP3 | COMM. SEL. | Right | I2C | Selecting communication with MCU between SPI and I2C |
JP4 | COMM. SEL. | Right | I2C | Selecting communication with MCU between SPI and I2C |
JP5 | COMM. SEL. | Right | I2C | Selecting communication with MCU between SPI and I2C |
Software Support
The Libstock page for the Environment Click Board™ offers a library for temperature, humidity, and pressure readings. To get the library for air quality (VOC) measurements, visit the Bosch website or contact Mikroe support team.
The run-in phase for VOC measuring is approximately 5 minutes.
NOTE: Once you go to the Bosch website, you will need to read and agree with the terms of the software license agreement, before you can download the VOC library.
Library Description
The library covers all the necessary functions to control the Environment Click Board™. Library performs the communication with the device via I2C or SPI driver by writing to registers and by reading from registers. The library has generic write and read function, get ambient data function, get temperature, humidity, pressure and gas resistance data from the register, function for reading factory calibration, for sets default configuration, etc.
Key Functions
float environment_getAmbientData( uint8_t dataIn )
- Get ambient data function.void environment_defaultConfig()
- Set default configuration function.void environment_getCalibrationData()
- Get calibration parameters function.
Example Description
void applicationTask() { temperature = environment_getTemperature(); Delay_10ms(); mikrobus_logWrite( " Temperature : ", _LOG_TEXT ); FloatToStr( temperature, logText ); mikrobus_logWrite( logText, _LOG_TEXT ); mikrobus_logWrite( degCel, _LOG_LINE ); humidity = environment_getHumidity(); Delay_10ms(); mikrobus_logWrite( " Humidity : ", _LOG_TEXT ); FloatToStr( humidity, logText ); mikrobus_logWrite( logText, _LOG_TEXT ); mikrobus_logWrite( " %", _LOG_LINE ); pressure = environment_getPressure(); Delay_10ms(); mikrobus_logWrite( " Pressure : ", _LOG_TEXT ); FloatToStr( pressure, logText ); mikrobus_logWrite( logText, _LOG_TEXT ); mikrobus_logWrite( " mbar", _LOG_LINE ); gas = environment_getGasResistance(); Delay_10ms(); mikrobus_logWrite( " Gas Resistance : ", _LOG_TEXT ); LongWordToStr( gas, logText ); ltrim( logText ); mikrobus_logWrite( logText, _LOG_LINE ); mikrobus_logWrite( "--------------------------------", _LOG_LINE ); Delay_1sec(); Delay_1sec(); }
The full application code, and ready to use projects can be found on our LibStock page.
Other mikroE Libraries used in the example:
- SPI or I2C
- UART
- Conversion
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 Environment 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
The Libstock page for the Environment Click Board™ offers a library for temperature, humidity, and pressure readings. To get the library for air quality (VOC) measurements, visit the Bosch website or contact Mikroe support team.
The run-in phase for VOC measuring is approximately 5 minutes.
NOTE: Once you go to the Bosch website, you will need to read and agree with the terms of the software license agreement, before you can download the VOC library.
Library Description
The library covers all the necessary functions to control the Environment Click Board™. Library performs the communication with the device via I2C or SPI driver by writing to registers and by reading from registers. The library has generic write and read function, get ambient data function, get temperature, humidity, pressure and gas resistance data from the register, function for reading factory calibration, for sets default configuration, etc.
Key Functions
float environment_getAmbientData( uint8_t dataIn )
- Get ambient data function.void environment_defaultConfig()
- Set default configuration function.void environment_getCalibrationData()
- Get calibration parameters function.
Example Description
void applicationTask() { temperature = environment_getTemperature(); Delay_10ms(); mikrobus_logWrite( " Temperature : ", _LOG_TEXT ); FloatToStr( temperature, logText ); mikrobus_logWrite( logText, _LOG_TEXT ); mikrobus_logWrite( degCel, _LOG_LINE ); humidity = environment_getHumidity(); Delay_10ms(); mikrobus_logWrite( " Humidity : ", _LOG_TEXT ); FloatToStr( humidity, logText ); mikrobus_logWrite( logText, _LOG_TEXT ); mikrobus_logWrite( " %", _LOG_LINE ); pressure = environment_getPressure(); Delay_10ms(); mikrobus_logWrite( " Pressure : ", _LOG_TEXT ); FloatToStr( pressure, logText ); mikrobus_logWrite( logText, _LOG_TEXT ); mikrobus_logWrite( " mbar", _LOG_LINE ); gas = environment_getGasResistance(); Delay_10ms(); mikrobus_logWrite( " Gas Resistance : ", _LOG_TEXT ); LongWordToStr( gas, logText ); ltrim( logText ); mikrobus_logWrite( logText, _LOG_LINE ); mikrobus_logWrite( "--------------------------------", _LOG_LINE ); Delay_1sec(); Delay_1sec(); }
The full application code, and ready to use projects can be found on our LibStock page.
Other mikroE Libraries used in the example:
- SPI or I2C
- UART
- Conversion
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 Environment 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.
Environment Click Board
Frequently Asked Questions
Have a Question?
Be the first to ask a question about this.