Bosch BMP3xx topic

Introduction

The BMP390 is a digital sensor with pressure and temperature measurement based on proven sensing principles. The sensor module is housed in an extremely compact 10-pin metal-lid LGA package with a footprint of only 2.0 × 2.0 mm² and max 0.8 mm package height. Its small dimensions and its low power consumption of 3.2 μA @1Hz allow the implementation in battery driven devices such as mobile phones, GPS modules or watches.

The BMP390 replaces the BMP388 and is nearly identical in specs and communication.

Although this sensor has the option of either I2C or SPI communication, this library only supports I2C. The I2C address is either 0x77 or 0x76. To connect two of these sensors to your system, you must ensure they are soldered so as to have different I2C addresses. No more than two can be attached. These sensors should be attached to a 1.7-3.6V power source and the power supply to the sensor can be stopped between measurements.

MartinL1's BMP388 library is used internally for communication with the BMP3xx. MartinL1's library was selected over the Adafruit library because it allows non-blocking operation in both normal and forced modes. It also provides many enums to help ensure correct value inputs

Bosch Recommended Oversample and Filter Settings

Sensor Datasheet

Documentation for the BMP390 sensor can be found at: https://www.bosch-sensortec.com/products/environmental-sensors/pressure-sensors/bmp390/

• BMP390 Datasheet
• BMP388 Datasheet

Build flags

• -D SEALEVELPRESSURE_HPA
  • use to adjust the sea level pressure used to calculate altitude from measured barometric pressure
  • if not defined, 1013.25 is used
  • The same sea level pressure flag is used for both the BMP3xx and the BME280. Whatever you select will be used for both sensors.

Sensor Constructors

Example Code

The BMP3xx is used in the menu a la carte example.

Classes

class BoschBMP3xx

The Sensor sub-class for the Bosch BMP3xx.

class BoschBMP3xx_Temp

The Variable sub-class used for the temperature output from a Bosch BMP3xx.

class BoschBMP3xx_Pressure

The Variable sub-class used for the atmospheric pressure output from a Bosch BMP3xx.

class BoschBMP3xx_Altitude

The Variable sub-class used for the altitude calculated from the measurements made by a Bosch BMP3xx.

Sensor Variable Counts

The number of variables that can be returned by Bosch BMP3xx

#define BMP3XX_NUM_VARIABLES = 3

Sensor::_numReturnedValues; the BMP3xx can report 3 values.

#define BMP3XX_INC_CALC_VARIABLES = 1

Sensor::_incCalcValues; altitude is calculted within the Adafruit library.

Configuration Defines

Defines to set the calibration of the calculated base pressure used to calculate altitude by the BME3xx.

#define SEALEVELPRESSURE_HPA = (1013.25)

The atmospheric pressure at sea level.

Sensor Timing

The sensor timing for a Bosch BMP3xx

#define BMP3XX_WARM_UP_TIME_MS = 3

Sensor::_warmUpTime_ms; BMP3xx should be ready to communicate within 3ms.

#define BMP3XX_STABILIZATION_TIME_MS = 4000

Sensor::_stabilizationTime_ms; BMP3xx is stable after 4000ms.

#define BMP3XX_MEASUREMENT_TIME_MS = 80

Sensor::_measurementTime_ms; The number given in this define will be recalculated and over-written in the set-up.

Temperature

The temperature variable from a Bosch BMP388 or BMP390

• Range is -40°C to +85°C
  • Full accuracy between 0°C and +65°C
• Absolute accuracy is typ. ± 0.5°C at 25°C
  • ± 1.5°C over 0°C to +65°C range

#define BMP3XX_TEMP_RESOLUTION = 2

Decimals places in string representation; temperature should have 5 - resolution is 0.0.00015°C at the hightest oversampling. See table 7 in the sensor datasheet for resolution at all bandwidths.

#define BMP3XX_TEMP_VAR_NUM = 0

Sensor variable number; temperature is stored in sensorValues[0].

#define BMP3XX_TEMP_VAR_NAME = "temperature"

Variable name in ODM2 controlled vocabulary; "temperature".

#define BMP3XX_TEMP_UNIT_NAME = "degreeCelsius"

Variable unit name in ODM2 controlled vocabulary; "degreeCelsius" (°C)

#define BMP3XX_TEMP_DEFAULT_CODE = "BoschBMP3xxTemp"

Default variable short code; "BoschBMP3xxTemp".

Barometric Pressure

The barometric pressure variable from a Bosch BMP388 or BMP390

• Range for both the BMP388 and BMP390 is 300‒1250 hPa
• Absolute accuracy is typ. ± 50 Pa (±0.50 hPa)
• Relative accuracy is typ. ± 3 Pa (±0.03 hPa), equiv. to ± 0.25 m

#define BMP3XX_PRESSURE_RESOLUTION = 3

Decimals places in string representation; barometric pressure should have 3. Resolution of output data in highest resolution mode at lowest bandwidth is 0.016 Pa. See table 6 in the sensor datasheet for resolution at all bandwidths.

#define BMP3XX_PRESSURE_VAR_NUM = 1

Sensor variable number; pressure is stored in sensorValues[2].

#define BMP3XX_PRESSURE_VAR_NAME = "barometricPressure"

Variable name in ODM2 controlled vocabulary; "barometricPressure".

#define BMP3XX_PRESSURE_UNIT_NAME = "pascal"

Variable unit name in ODM2 controlled vocabulary; "pascal" (Pa)

#define BMP3XX_PRESSURE_DEFAULT_CODE = "BoschBMP3xxPressure"

Default variable short code; "BoschBMP3xxPressure".

Altitude

The altitude variable from a Bosch BMP388 or BMP390

#define BMP3XX_ALTITUDE_RESOLUTION = 0

Decimals places in string representation; altitude should have 0 - resolution is 1m.

#define BMP3XX_ALTITUDE_VAR_NUM = 2

Sensor variable number; altitude is stored in sensorValues[3].

#define BMP3XX_ALTITUDE_VAR_NAME = "heightAboveSeaFloor"

Variable name in ODM2 controlled vocabulary; "heightAboveSeaFloor".

#define BMP3XX_ALTITUDE_UNIT_NAME = "meter"

Variable unit name in ODM2 controlled vocabulary; "meter".

#define BMP3XX_ALTITUDE_DEFAULT_CODE = "BoschBMP3xxAltitude"

Default variable short code; "BoschBMP3xxAltitude".

Define documentation