BME680 with ESP32

Specifications

Power and logic levels

3.3 V: safe to connect directly

ESP32 pins, including those on a display board's connectors, work at 3.3 V and are not 5 V tolerant. Modules differ, so if in doubt, measure the signal before you connect it.

Wiring

Arduino code

#include <Wire.h>
#include <Adafruit_Sensor.h>
#include <Adafruit_BME680.h>

const int SDA_PIN = 8, SCL_PIN = 9;   // use your board's I2C pins
Adafruit_BME680 bme(&Wire);

void setup() {
  Serial.begin(115200);
  Wire.begin(SDA_PIN, SCL_PIN);
  if (!bme.begin(0x77) && !bme.begin(0x76)) {
    Serial.println("BME680 not found");
    while (true) delay(1000);
  }
  bme.setGasHeater(320, 150);         // 320 C for 150 ms
}

void loop() {
  if (bme.performReading()) {
    Serial.printf("%.1f C  %.0f %%  %.0f hPa  gas %.1f kOhm\n",
                  bme.temperature, bme.humidity, bme.pressure / 100.0, bme.gas_resistance / 1000.0);
  }
  delay(3000);
}

Needs the Adafruit BME680 library. Compiled for ESP32-S3 with arduino-esp32 3.x. Not yet tested by us on a physical sensor. Change the pins to match your board.

On a display

Read the value in your sketch and pass it to a label, or send it over MQTT and show it with an MQTT value in the editor.

Boards with a ready connector

Only boards whose connectors we have surveyed. Others may still work on free GPIOs.

Good to know

• The gas value is resistance, not ppm.
• Run a new sensor for 48 hours.
• Allow about 30 minutes to settle at each start.
• An air quality index needs Bosch BSEC.

What it is good for

• Air quality trend displays
• Workshop and kitchen monitors
• Ventilation reminders

FAQ

Sources

• https://learn.adafruit.com/adafruit-bme680-humidity-temperature-barometic-pressure-voc-gas?view=all

Related parts

• BME280
• SCD40