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.

Over I²C
Section titled “Over I²C”The bmp3xx_i2c component allows you to use the device over I²C interface.
# Example configuration entry for I2C connectionsensor: - platform: bmp3xx_i2c temperature: name: "Outside Temperature" oversampling: 16x pressure: name: "Outside Pressure" address: 0x77 update_interval: 60sConfiguration variables
Section titled “Configuration variables”-
address (Optional, int): Manually specify the I²C address of the sensor. Defaults to
0x77. Another address can be0x76. -
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 toOFF. -
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.
Over SPI
Section titled “Over SPI”The bmp3xx_spi component allows you to use the device over SPI interface.
# Example configuration entry for SPI connectionsensor: - platform: bmp3xx_spi temperature: name: "Outside Temperature" oversampling: 16x pressure: name: "Outside Pressure" cs_pin: 13 update_interval: 60sConfiguration variables
Section titled “Configuration variables”-
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 toOFF. -
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 be0x76. -
update_interval (Optional, Time): The interval to check the sensor. Defaults to
60s.
Continuous Measurement
Section titled “Continuous Measurement”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: 1sPossible 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.
Oversampling Options
Section titled “Oversampling Options”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)2x4x8x16x(default)32x