BME680 Temperature+Pressure+Humidity+Gas Sensor

The bme680 sensor platform allows you to use your BME680 (datasheet, Adafruit) temperature, pressure and humidity sensors with esphomelib. The I²C is required to be set up in your configuration for this sensor to work.

../../../_images/bme680-full.jpg

BME680 Temperature, Pressure & Humidity Sensor.

# Example configuration entry
sensor:
  - platform: bme680
    temperature:
      name: "BME680 Temperature"
      oversampling: 16x
    pressure:
      name: "BME680 Pressure"
    humidity:
      name: "BME680 Humidity"
    gas_resistance:
      name: "BME680 Gas Resistance"
    address: 0x77
    update_interval: 15s

Configuration variables:

  • temperature (Required): The information for the temperature sensor.
    • name (Required, string): The name for the temperature sensor.
    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.
    • id (Optional, ID): Set the ID of this sensor for use in lambdas.
    • All other options from Sensor and MQTT Component.
  • pressure (Required): The information for the pressure sensor.
    • name (Required, string): The name for the pressure sensor.
    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.
    • id (Optional, ID): Set the ID of this sensor for use in lambdas.
    • All other options from Sensor and MQTT Component.
  • humidity (Required): The information for the pressure sensor.
    • name (Required, string): The name for the humidity sensor.
    • oversampling (Optional): The oversampling parameter for the temperature sensor. See Oversampling Options.
    • id (Optional, ID): Set the ID of this sensor for use in lambdas.
    • All other options from Sensor and MQTT Component.
  • gas_resistance (Required): The information for the gas sensor.
    • name (Required, string): The name for the gas resistance sensor.
    • id (Optional, ID): Set the ID of this sensor for use in lambdas.
    • All other options from Sensor and MQTT Component.
  • address (Optional, int): Manually specify the i^2c address of the sensor. Defaults to 0x77. Another address can be 0x76.
  • iir_filter (Optional): Set up an Infinite Impulse Response filter to increase accuracy. One of OFF, 2x, 4x, 16x. Defaults to OFF.
  • heater (Optional): The settings for the internal heater for the gas sensor. Set this to disable the internal heater.
    • temperature (Optional, int): The target temperature of the heater between 200 and 400 °C. Defaults to 320.
    • duration (Optional, Time): The duration the heater should be active. Maximum value is 4032ms. Defaults to 150ms.
  • update_interval (Optional, Time): The interval to check the sensor. Defaults to 15s. See update_interval gotchas.
../../../_images/bme680-ui.png

Oversampling Options

By default, the BME680 sensor measures each value 16 times when requesting a new value. You can, however, configure this amount. Possible oversampling values:

  • NONE
  • 1x
  • 2x
  • 4x
  • 8x
  • 16x (default)