Skip to content
Get started

BMP388 / BMP390 Temperature+Pressure Sensor

The bmp3xx sensor platform allows you to use your BMP388 or BMP390 (datasheet, BMP390 product page) temperature and pressure sensors with ESPHome. Either I²C bus or SPI bus is required to be set up in your configuration for this sensor to work.

BMP388/BMP390 Temperature and Pressure Sensor.

The bmp3xx_i2c component allows you to use the device over I²C interface.

# Example configuration entry for I2C connection
sensor:
- platform: bmp3xx_i2c
temperature:
name: "Outside Temperature"
oversampling: 16x
pressure:
name: "Outside Pressure"
address: 0x77
update_interval: 60s
  • address (Optional, int): Manually specify the I²C address of the sensor. Defaults to 0x77. Another address can be 0x76.

  • temperature (Optional): The information for the temperature sensor.

    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.

    • All other options from Sensor.

  • pressure (Optional): The information for the pressure sensor.

    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.

    • All other options from Sensor.

  • iir_filter (Optional): Set up an Infinite Impulse Response filter to increase accuracy. One of OFF, 2x, 4x, 16x, 32, 64x, 128x. Defaults to OFF.

  • data_rate (Optional): Measure continuously at this rate instead of once per update_interval. See Continuous Measurement. By default the sensor measures once per update.

  • update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s.

The bmp3xx_spi component allows you to use the device over SPI interface.

# Example configuration entry for SPI connection
sensor:
- platform: bmp3xx_spi
temperature:
name: "Outside Temperature"
oversampling: 16x
pressure:
name: "Outside Pressure"
cs_pin: 13
update_interval: 60s
  • cs_pin (Required, Pin Schema): The Chip Select (CS) pin.

  • temperature (Optional): The information for the temperature sensor.

    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.

    • All other options from Sensor.

  • pressure (Optional): The information for the pressure sensor.

    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.

    • All other options from Sensor.

  • iir_filter (Optional): Set up an Infinite Impulse Response filter to increase accuracy. One of OFF, 2x, 4x, 16x, 32, 64x, 128x. Defaults to OFF.

  • data_rate (Optional): Measure continuously at this rate instead of once per update_interval. See Continuous Measurement. By default the sensor measures once per update.

  • address (Optional, int): I2C only. Manually specify the I²C address of the sensor. Defaults to 0x77. Another address can be 0x76.

  • update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s.

By default the sensor takes one measurement each update_interval and sleeps in between. With data_rate set, it measures continuously at that rate and each update reads the latest result. Combined with iir_filter, the sensor’s own filter then runs on every measurement, which gives lower noise for the same update_interval. The sensor draws more current this way, so keep the default on battery-powered devices.

sensor:
- platform: bmp3xx_i2c
pressure:
name: "Pressure"
oversampling: 32x
temperature:
name: "Temperature"
oversampling: 2x
iir_filter: 16x
data_rate: 12.5Hz
update_interval: 1s

Possible values: 200Hz, 100Hz, 50Hz, 25Hz, 12.5Hz, 6.25Hz, 3.1Hz, 1.5Hz, 0.78Hz, 0.39Hz, 0.2Hz, 0.1Hz, 0.05Hz, 0.02Hz, 0.01Hz, 0.006Hz, 0.003Hz and 0.001Hz. The slow labels are rounded: the period is 5 ms at 200Hz and doubles with each slower value, so 0.02Hz is 41 s and 0.001Hz is 655 s.

One measurement must fit within one period of the data rate, so higher oversampling needs a slower rate. For example, pressure 32x with temperature 2x takes about 70 ms, which allows 12.5Hz (80 ms) or slower. update_interval must be at least one period of the data rate. Configurations that break either rule are rejected when validating the configuration.

By default, the BMP3xx sensor measures pressure 16 times and temperature 2 times when requesting a new value. You can, however, configure this amount. Possible oversampling values:

  • NONE (value is skipped)
  • 2x
  • 4x
  • 8x
  • 16x (default)
  • 32x