https://github.com/balassy/esp8266_bme280_sensor

Easily reusable code to read the BME280 temperature, pressure and humidity sensor by an ESP8266 microcontroller.
https://github.com/balassy/esp8266_bme280_sensor

arduino-iot arduino-sketch bme280 bme280pthsensor esp8266 iot vscode wemos-d1-mini

Last synced: 24 days ago
JSON representation

Easily reusable code to read the BME280 temperature, pressure and humidity sensor by an ESP8266 microcontroller.

• Host: GitHub
• URL: https://github.com/balassy/esp8266_bme280_sensor
• Owner: balassy
• License: mit
• Created: 2019-06-02T20:09:56.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-06-02T20:38:12.000Z (over 5 years ago)
• Last Synced: 2024-11-13T15:54:28.558Z (2 months ago)
• Topics: arduino-iot, arduino-sketch, bme280, bme280pthsensor, esp8266, iot, vscode, wemos-d1-mini
• Language: C++
• Homepage:
• Size: 256 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Using the BME280 Sensor with an ESP8266 Microcontroller

This repository contains easily reusable code to read the [BME280](https://lastminuteengineers.com/bme280-arduino-tutorial/) temperature, pressure and humidity sensor by an ESP8266 microcontroller.

## Wiring

This code was tested on Wemos D1 Mini with the following wiring:

![](./doc/wiring.png)

_(Photo from [esp8266learning.com](http://www.esp8266learning.com/esp8266-and-bme280-temperature-sensor-example.php).)_

## Usage

1. Add the `Adafruit BME280 Library` and `Adafruit Unified Sensor` library to your project.

2. Copy the `bme280.cpp` and `bme280.h` files to your project folder.

3. Include the `bme280.h` header file into your project:

```cpp

#include "bme280.h"

```

4. Create an instance of the sensor (uses the default `0x76` address):

```cpp

BME280 bme;

```

5. Initialize the sensor when your device boots up:

```cpp

void setup() {

  bme.init();

}

```

6. Read the sensor values:

```cpp

void loop() {

  BME280::Measurement measurement = bme.getMeasuredData();

}

```

7. Get the temperature, pressure, altitude and humidity values:

```cpp

Serial.printf("Temperature: %.1f *C\n", measurement.temperature);

Serial.printf("Pressure: %.1f hPa\n", measurement.pressure);

Serial.printf("Altitude: %.1f m\n", measurement.altitude);

Serial.printf("Humidity: %.1f %\n", measurement.humidity);

```

For a complete example check the `esp8266-bme280.ino` file.

Optional: you can use the `getTemperature()`, `getPressure()`, `getAltitude()` and `getHumidity()` functions of the `BME280` class individually as well.

## How it works

This `BME280` class acts as a wrapper around the [Adafruit BME280 Library](https://github.com/adafruit/Adafruit_BME280_Library) to provide easier setup, and encapsulate all logic, includes and constants related to this sensor.

Currently this class provides the most frequently used functionality of the sensor, but the sensor provides additional options to further customize its behavior. Check [this example](https://github.com/adafruit/Adafruit_BME280_Library/blob/master/examples/advancedsettings/advancedsettings.ino) to see various scenarios.

## About the author

This project is maintained by [György Balássy](https://linkedin.com/in/balassy).