Arduino Library – BME280 (Temperatuur, Luchtvochtigheid, Barometer)

library icon

Installatie van Arduino IDE libraries: Arduino info
arduino logo rond

Hardware


Informatie (ENG)

Summary

Reads temperature, humidity, and pressure. Calculates altitude, equivalent sea level pressure and dew point. Provides functions for english and metric. Also reads pressure in Pa, hPa, inHg, atm, bar, torr, N/m^2 and psi.

Installation

To use this library download the zip file, decompress it to a folder named BME280. Move the folder to {Arduino Path}/libraries.

Usage

Include the library at the top of your Arduino script. #include <BME280> Create a global or local variable. BME280 bme In your start up call bme.begin(). Read the temperature, humidity, pressure, altitude and/or dew point.

float pres, temp, hum bme.read(pres, temp, hum)

or

temp = bme.temp() hum = bme.hum() pres = bme.pres()

Enumerations

TempUnit Enum

  • TempUnit_Celsius
  • TempUnit_Fahrenheit

PresUnit Enum

  • PresUnit_Pa
  • PresUnit_hPa
  • PresUnit_inHg
  • PresUnit_atm
  • PresUnit_bar
  • PresUnit_torr
  • PresUnit_psi

OSR Enum

  • OSR_Off
  • OSR_X1
  • OSR_X2
  • OSR_X4
  • OSR_X8
  • OSR_X16

Mode Enum

  • Mode_Sleep
  • Mode_Forced
  • Mode_Normal

StandbyTime Enum

  • StandbyTime_500us
  • StandbyTime_62500us
  • StandbyTime_125ms
  • StandbyTime_250ms
  • StandbyTime_50ms
  • StandbyTime_1000ms
  • StandbyTime_10ms
  • StandbyTime_20ms

Filter Enum

  • Filter_Off
  • Filter_1
  • Filter_2
  • Filter_4
  • Filter_8
  • Filter_16

ChipModel Enum

  • ChipModel_Unknown
  • ChipModel_BME280
  • ChipModel_BMP280

Settings

BME280::Settings Struct

BME280I2C::Settings Struct

  • Includes all fields in BME280 settings.

BME280Spi::Settings Struct

  • Includes all fields in BME280 settings.

BME280Spi::Settings Struct

  • Includes all fields in BME280 settings.

Methods

BME280I2C(const BME280I2C::Settings& settings)

Constructor used to create the I2C Bme class. All parameters have default values.

BME280Spi(const BME280Spi::Settings& settings)

Constructor used to create the Spi Bme class. All parameters have default values except chip select.

BME280SpiSw(const BME280SpiSw::Settings& settings)

Constructor used to create the software Spi Bme class. All parameters have default values except chip select, mosi, miso and sck.

bool begin()

Method used at start up to initialize the class. Starts the I2C or SPI interface. Can be called again to re-initialize the mode settings.

void setSettings(const Settings& settings)

Method to set the sensor settings.

const Settings& getSettings() const

Method to get the sensor settings.

float temp(TempUnit unit)

Read the temperature from the BME280 and return a float.

float pres(PresUnit unit)

Read the pressure from the BME280 and return a float with the specified unit.

float hum()

Read the humidity from the BME280 and return a percentage as a float.

void read(float& pressure, float& temp, float& humidity, TempUnit tempUnit, PresUnit presUnit)

Read the data from the BME280 with the specified units.

ChipModel chipModel()

Environment Calculations

float Altitude(float pressure, AltitudeUnit = AltitudeUnit_Meters, float seaLevelPressure = 1013.25, outsideTemp = 15.0, TempUnit = TempUnit_Celsius)

Calculate the altitude based on the pressure with the specified units.

float EquivalentSeaLevelPressure(float altitude, float temp, float pres, AltitudeUnit altUnit, TempUnit tempUnit )

Convert current pressure to equivalent sea-level pressure.

float DewPoint(float temp, float hum, TempUnit = TempUnit_Celsius)

Calculate the dew point based on the temperature and humidity with the specified units.

float AbsoluteHumidity(float temperature, float humidity, TempUnit = TempUnit_Celsius)

Calculate the absolute humidity based on the temperature and humidity with the specified units.

int HeatIndex(float temperature, float humidity, TempUnit tempUnit = TempUnit_Celsius)

Calculate the heat index based on the temperature and humidity with the specified units. The heat index is only calculated if the temperature is above 26.7°C or 80°F and humidity above 40%. The precision is +/- 0.7°C / 1.3°F.

History

  • Jan 1, 2016 – Version 1.0.0 released
  • Sep 19, 2016 – Version 2.0.0 released (Restructure for I2C and SPI)
  • Nov 21, 2016 – Version 2.0.1 released (Set mode support)
  • Dec 19, 2016 – Version 2.1.0 released (Support for SPI)
  • Dec 21, 2016 – Version 2.1.1 released (Bugs)
  • Feb 17, 2017 – Version 2.1.2 released (Docs)
  • Sept 9, 2017 – Version 2.1.3 released (Formatting, reorg)
  • Sept 13, 2017 – Version 2.1.4 released (Examples update, bug fixes)
  • Oct 7, 2017 – Version 2.2.0 released (Enums, begin restructure)
  • Oct 10, 2017 – Version 2.2.1 released (Bug fixes)

 


Download bibliotheek @ finitespace * Github

Top