wokoeck_ch aaea7a84fb test		3 rokov pred
..
examples	aaea7a84fb test	3 rokov pred
.editorconfig	aaea7a84fb test	3 rokov pred
.gitignore	aaea7a84fb test	3 rokov pred
.piopm	aaea7a84fb test	3 rokov pred
BMP280_DEV.cpp	aaea7a84fb test	3 rokov pred
BMP280_DEV.h	aaea7a84fb test	3 rokov pred
Device.cpp	aaea7a84fb test	3 rokov pred
Device.h	aaea7a84fb test	3 rokov pred
LICENSE	aaea7a84fb test	3 rokov pred
README.md	aaea7a84fb test	3 rokov pred
keywords.txt	aaea7a84fb test	3 rokov pred
library.properties	aaea7a84fb test	3 rokov pred

BMP280_DEV

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

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

Version
Arduino Compatiblility
Installation
Usage
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

README.md