lern-tracking-system/.pio/libdeps/uno/BMP280_DEV

BMP280_DEV

An Arduino compatible, non-blocking, I2C/SPI library for the Bosch BMP280 barometer.

© Copyright, image courtesy of Adafruit Industries lisensed under the terms of the Create Commons Attribution-ShareAlike 3.0 Unported.

This BMP280_DEV library offers the following features:

• Returns temperature in degrees celsius (°C), pressure in hectoPascals/millibar (hPa) and altitude in metres (m)
• NORMAL or FORCED modes of operation
• I2C or hardware SPI communications with configurable clock rates
• Non-blocking operation
• In NORMAL mode barometer returns results at the specified standby time interval
• Highly configurable, allows for changes to pressure and temperature oversampling, IIR filter and standby time

---

Contents

1. Version
2. Arduino Compatiblility
3. Installation
4. Usage
   1. BMP280_DEV Library
   2. Device Initialisation
   3. Device Configuration
   4. Modes Of Operation
   5. Results Acquisition
   6. Code Implementation
5. Example Code

Version

• Version 1.0.18 -- Initialise "device" constructor member variables in the same order they are declared
• Version 1.0.17 -- Added getCurrentTemperature(), getCurrentPressure(), getCurrentTempPres() getCurrentAltitude() and getCurrentMeasurements() functions, to allow the BMP280 to be read directly without checking the status register
• Version 1.0.16 -- Modification to allow user-defined pins for I2C operation on the ESP32
• Version 1.0.14 -- Fix uninitialised structures, thanks to David Jade investigating and flagging up this issue
• Version 1.0.12 -- Allow sea level pressure calibration using setSeaLevelPressure() function
• Version 1.0.10 -- Modification to allow user-defined pins for I2C operation on the ESP8266
• Version 1.0.9 -- Moved writeMask to Device class and improved measurement detection code
• Version 1.0.8 -- Use default arguments for begin() member function and add example using multiple BMP280 devices with SPI comms in NORMAL mode
• Version 1.0.6 -- Merged multiple instances and initialisation pull requests by sensslen
• Version 1.0.5 -- Fixed bug in BMP280_DEV::getTemperature() function, thanks to Jon M.
• Version 1.0.3 -- Change library name in the library.properties file
• Version 1.0.2 -- Modification to allow external creation of a HSPI object on the ESP32
• Version 1.0.1 -- Added ESP32 HSPI support and changed library name for Arduino compatibility
• Version 1.0.0 -- Intial version

Arduino Compatibility

• All Arduino boards, but for 5V Arduino boards (such as the Uno, Nano, Mega, Leonardo, etc...), please check if the BMP280 breakout board requires a 5V to +3.3V voltage level shifter

Installation

The BMP280_DEV library can be installed using the Arduino IDE's Library Manager. To access the Library Manager, in the Arduino IDE's menu select Sketch->Include Library->Manage Libraries.... In the Library Manager's search bar type BMP280 then select the "Install" button in the BMP280_DEV entry.

Alternatively simply download BMP280_DEV from this Github repository, un-zip or extract the files and place the BMP280_DEV directory in your .../Arduino/libraries/... folder. The .../Arduino/... folder is the one where your Arduino IDE sketches are usually located.

Usage

BMP280_DEV Library

Simply include the BMP280_DEV.h file at the beginning of your sketch:

#include <BMP280_DEV.h>

For I2C communication the BMP280_DEV object is normally created (instantiated) without parameters:

BMP280_DEV bmp280;	// Set up I2C communications

By default the library uses the BMP280's I2C address 0x77. (To use the alternate I2C address: 0x76, see the begin() function below.

The ESP8266 and ESP32 also offer the option of selecting the I2C SDA and SDA pins as parameters:

BMP280_DEV bmp280(A6, A7);	// Set up I2C communications on ESP32 pins A6 (SDA) and A7 (SCL): bmp280(SDA, SCL);

If no parameters are selected, the ESP32 uses its default SDA and SCL pins.

For SPI communication the chip select (CS) Arduino digital output pin is specified as an argument, for example digital pin 10:

BMP280_dev bmp280(10);	// Set up SPI communications on digital pin D10

The library also supports the ESP32 HSPI operation on pins: SCK 14, MOSI 13, MISO 27 and user defined SS (CS):

SPIClass SPI1(HSPI);			// Create the SPI1 HSPI object
BMP280_DEV bmp(21, HSPI, SPI1);		// Set up HSPI port communications on the ESP32

By default the I2C runs in fast mode at 400kHz and SPI at 1MHz. However it is possible to change either the I2C or SPI clock speed using the set clock function:

bmp280.setClock(4000000);			// Set the SPI clock to 4MHz

---

Device Initialisation

To initialise the bmp280 it is necessary to call the begin() function with or without parameters. The parameters specify the starting mode, pressure/temperature oversampling, IIR filter and standby time options respectively:

bmp280.begin(SLEEP_MODE, OVERSAMPLING_X16, OVERSAMPLING_X2, IIR_FILTER_4, TIME_STANDBY_05MS);

Alternatively simply call the begin function without any paremeters, this sets up the default configuration: SLEEP_MODE, pressure oversampling X16, temperature oversampling X2, IIR filter OFF and a standby time of 0.5ms:

bmp280.begin();	// Initialise the BMP280 with default configuration

Another alternative is to pass the BMP280's mode as an argument:

bmp280.begin(NORMAL_MODE);	// Initialise the BMP280 in NORMAL_MODE with default configuration

Or, specifying mode and alternate I2C address:

bmp280.begin(FORCED_MODE, BMP280_I2C_ALT_ADDR);	// Initialise the BMP280 in FORCED_MODE with the alternate I2C address (0x76)

Or even just the alternate I2C address, (BMP280 initialised in SLEEP_MODE by default):

bmp280.begin(BMP280_I2C_ALT_ADDR);	// Initialise the BMP280 with the alternate I2C address (0x76)

Note that the begin functions return the value 1 upon successful initialisation, otherwise it returns 0 for failure.

---

Device Configuration

After initialisation it is possible to change the BMP280 configuration with the following functions:

bmp280.setPresOversamping(OVERSAMPING_X4);	// Options are OVERSAMPLING_SKIP, _X1, _X2, _X4, _X8, _X16

bmp280.setTempOversamping(OVERSAMPING_X4);	// Options are OVERSAMPLING_SKIP, _X1, _X2, _X4, _X8, _X16

bmp280.setIIRFilter(IIR_FILTER_16);	// Options are IIR_FILTER_OFF, _2, _4, _8, _16

bmp280.setTimeStandby(TIME_STANDBY_2000MS);	// Options are TIME_STANDBY_05MS, _62MS, _125MS, _250MS, _500MS, _1000MS, 2000MS, 4000MS

---

Modes Of Operation

The BMP280 has 3 modes of operation: SLEEP_MODE, NORMAL_MODE and FORCED_MODE:

• SLEEP_MODE: puts the device into an inactive standby state

• NORMAL_MODE: performs continuous conversions, separated by the standby time

• FORCED_MODE: performs a single conversion, returning to SLEEP_MODE upon completion

To kick-off conversions in NORMAL_MODE:

bmp280.startNormalConversion();	// Start continuous conversions, separated by the standby time

To perform a single oneshot conversion in FORCED_MODE:

bmp280.startForcedConversion();	// Start a single oneshot conversion

To stop the conversion at anytime and return to SLEEP_MODE:

bmp280.stopConversion();	// Stop conversion and return to SLEEP_MODE

---

Results Acquisition

The BMP280 barometer library acquires temperature in degrees celsius (°C), pressure in hectoPascals/millibar (hPa) and altitude in metres (m). The acquisition functions scan the BMP280's status register and return 1 if the barometer results are ready and have been successfully read, 0 if they are not; this allows for non-blocking code implementation. The temperature, pressure and altitude results themselves are float variables by passed reference to the function and are updated upon a successful read.

Here are the results acquisition functions:

bmp280.getMeasurements(temperature, pressure, altitude);	// Acquire temperature, pressue and altitude measurements

bmp280.getTempPres(temperature, pressure);	// Acquire both the temperature and pressure

bmp280.getTemperature(temperature);	// Acquire the temperature only

bmp280.getPressure(pressure);	// Acquire the pressure only, (also calculates temperature, but doesn't return it)

bmp280.getAltitude(altitude);	// Acquire the altitude only

However, these function only operate correctly and efficiently if your Arduino sketch's loop() time is fast enough (<35ms). If your loop() time is slow then these functions are unable to poll the BMP280's status register quickly enough. In this case, it is possible to simply read the barometer's latest results without checking the status register with the following functions:

bmp280.getCurrentMeasurements(temperature, pressure, altitude);	// Acquire the current temperature, pressue and altitude measurements

bmp280.getCurrentTempPres(temperature, pressure);	// Acquire both the current temperature and pressure

bmp280.getCurrentTemperature(temperature);	// Acquire the current temperature only

bmp280.getCurrentPressure(pressure);	// Acquire the currentpressure only, (also calculates temperature, but doesn't return it)

bmp280.getCurrentAltitude(altitude);	// Acquire the current altitude only

---

Code Implementation

Here is an example sketch of how to use the BMP280 library for non-blocking I2C operation, default configuration with continuous conversion in NORMAL_MODE, but with a standby sampling time of 1 second:

#include <BMP280_DEV.h>                           // Include the BMP280_DEV.h library

float temperature, pressure, altitude;            // Create the temperature, pressure and altitude variables
BMP280_DEV bmp280;                                // Instantiate (create) a BMP280_DEV object and set-up for I2C operation (address 0x77)

void setup() 
{
  Serial.begin(115200);                           // Initialise the serial port
  bmp280.begin();                                 // Default initialisation, place the BMP280 into SLEEP_MODE 
  bmp280.setTimeStandby(TIME_STANDBY_1000MS);     // Set the standby time to 1s
  bmp280.startNormalConversion();                 // Start NORMAL conversion mode
}

void loop() 
{
  if (bmp280.getMeasurements(temperature, pressure, altitude))    // Check if the measurement is complete
  {
    Serial.print(temperature);                    // Display the results    
    Serial.print(F("*C   "));
    Serial.print(pressure);    
    Serial.print(F("hPa   "));
    Serial.print(altitude);
    Serial.println(F(m"));
  }
}

A second sketch example for I2C operation, default configuration in FORCED conversion mode:

#include <BMP280_DEV.h>                           // Include the BMP280_DEV.h library

float temperature, pressure, altitude;            // Create the temperature, pressure and altitude variables
BMP280_DEV bmp280;                                // Instantiate (create) a BMP280_DEV object and set-up for I2C operation (address 0x77)

void setup() 
{
  Serial.begin(115200);                           // Initialise the serial port
  bmp280.begin();                                 // Default initialisation, place the BMP280 into SLEEP_MODE 
}

void loop() 
{
  bmp280.startForcedConversion();                 // Start a forced conversion (if in SLEEP_MODE)
  if (bmp280.getMeasurements(temperature, pressure, altitude))    // Check if the measurement is complete
  {
    Serial.print(temperature);                    // Display the results    
    Serial.print(F("*C   "));
    Serial.print(pressure);    
    Serial.print(F("hPa   "));
    Serial.print(altitude);
    Serial.println(F("m"));
  }
}

The sketches for SPI operation are identical except that the line:

BMP280_DEV bmp280;	// Instantiate (create) a BMP280_DEV object and set-up for I2C operation (address 0x77)

...should be replaced with the line:

BMP280_DEV bmp280(10);	// Instantiate (create) a BMP280_DEV object and set-up for SPI operation with chip select on D10

For more details see code examples provided in the .../examples/... directory.

---

Example Code

• BMP280_I2C_Normal.ino : I2C Interface, Normal Mode, Standard I2C Address (0x77)

• BMP280_I2C_Alt_Normal.ino : 2C Interface, Normal Mode, Alternative I2C Address (0x76)

• BMP280_I2C_Forced.ino : I2C Interface, Forced Mode, Standard I2C Address (0x77)

• BMP280_SPI_Normal.ino : SPI Interface, Normal Mode

• BMP280_SPI_Forced.ino : SPI Interface, Forced Mode

• BMP280_ESP32_HSPI_Normal.ino : ESP32 HSPI Interface, Normal Mode

• BMP280_SPI_Normal_Multiple.ino : SPI Interface, Normal Mode, Multiple BMP280 Devices

• BMP280_ESP8266_I2C_Normal_DefinedPins.ino : ESP8266 I2C Interface, Normal Mode, User-Defined Pins

• BMP280_ESP32_I2C_Normal_DefinedPins.ino : ESP32 I2C Interface, Normal Mode, User-Defined Pins