A BME280 sensor on a small four-pin breakout board that runs from 3.3V or 5V. One chip reads air temperature, relative humidity and air pressure, which makes it a good pick for an Arduino Uno or Nano weather station, a room climate sensor in Home Assistant, or a logger that tracks pressure trends.
The board has a regulator and level shifting on the I2C lines, so it connects straight to a 5V Arduino Uno or Nano with no converter. Power VIN from your board's own logic voltage: 5V on an Uno or Nano, 3V3 on an ESP32, Pico or Raspberry Pi. It's I2C only, and the address is fixed on the board at 0x76 or 0x77, so the test sketch checks both. The 4-pin header comes loose for you to solder. Need SPI, or a bare 3.3V board? See our BME280 3.3V module. If you only need pressure and temperature, our GY-BMP280 module costs less.
Specifications
Datasheets
Wiring & getting started
- Solder the header
Solder the 4-pin header to the pads. Keep flux and cleaner away from the tiny hole in the top of the sensor, because that's where the air gets in.
- Wire it up
On an Uno or Nano: VIN to 5V, GND to GND, SDA to A4 and SCL to A5. On an ESP32: VIN to 3V3 (not 5V), GND to GND, SDA to GPIO21 and SCL to GPIO22. On a Pico: VIN to 3V3(OUT), SDA to GP4 and SCL to GP5. The signal lines sit at whatever voltage VIN has, so a 3.3V board needs VIN on 3.3V.
- Load the test code
In the Arduino IDE, install the Adafruit BME280 library from the Library Manager. Upload this sketch and open the Serial Monitor at 115200 baud.
Example Arduino codeArduino C++
// BME280 5V module test. Works on a 3.3V or 5V board. // VIN to 3.3V or 5V, GND to GND, SDA and SCL to the I2C pins. #include <Wire.h> #include <Adafruit_BME280.h> Adafruit_BME280 bme; void setup() { Serial.begin(115200); uint8_t addr = 0x76; bool ok = bme.begin(addr); if (!ok) { addr = 0x77; // the board has one fixed address, so try the other one ok = bme.begin(addr); } if (!ok) { Serial.println("No BME280 found at 0x76 or 0x77. Check the wiring."); while (true) delay(10); } Serial.print("Found at 0x"); Serial.print(addr, HEX); Serial.print(", chip ID 0x"); Serial.println(bme.sensorID(), HEX); // 60 = BME280 } void loop() { Serial.print(bme.readTemperature(), 1); Serial.print(" C "); Serial.print(bme.readHumidity(), 0); Serial.print(" %RH "); Serial.print(bme.readPressure() / 100.0, 1); Serial.println(" hPa"); delay(2000); } - Check it works
You should see the address it found (0x76 or 0x77) and Chip ID 0x60, then a line every 2 seconds such as 21.4 C 55 %RH 1013.2 hPa. If it says no BME280 was found, check that SDA and SCL aren't swapped and that VIN has power.
- Use it in ESPHome (optional)
ESPHome looks for the sensor at 0x77 unless you tell it otherwise, so set address to the one the sketch printed.
ESPHome configESPHome YAML
i2c: sda: GPIO21 scl: GPIO22 sensor: - platform: bme280_i2c address: 0x76 # use the address the test sketch printed temperature: name: "Temperature" humidity: name: "Humidity" pressure: name: "Pressure"

