ESP32 with BME680 sensor (Temperature, Humidity, Pressure, Gas), Webserver and MQTT-Client

Arduino prog for BME680 sensor
with WiFi, dis-/enabled Webserver and dis-/enabled MQTT client

Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

ESP32 temperature/humidity/pressure/gas Wifi Webserver & MQTT client

Arduino prog for BME680 sensor with WiFi, dis-/enabled Webserver and dis-/enabled MQTT client

• optional: show Temperature and Humidity on Website (refresh every 15 seconds)
• optional: MQTT client intervall publishing (customizable)
• optional: MQTT publish data and do ESP32 deep sleep intervall (customizable)

Screenshots

Webserver / website with firmware update message

MQTT client (Terminal)

(back to top)

Getting Started

install the Arduino IDE or use the web online version

Prerequisites

• PC or Laptop with Windows, MacOS or Linux *_^
• ESP32 connected with sensor
• DHT11 or DHT22 (AM2302) or DHT21 (AM2301) sensor
• install the Arduino IDE https://www.arduino.cc/en/software
• or use Arduino IDE online https://create.arduino.cc/editor
• some included libraries needs additional Arduino libraries (e.g. PubSubClient. See header comments)
• MQTT PubSubClient
• Zanshin_BME680 (https://github.com/Zanduino/BME680)

Installation

1. Clone the repo

   git clone https://github.com/Zheng-Bote/ESP32_BME680_Webserver_MQTT-Client.git

2. fill in your credentials credentials.h
   • WiFi settings (SSID, password)
   • start MQTT yes|no, MQTT publish intervall ...
   • start Webserver yes|no
   • publish MQTT and do ESP32 deep sleep ...
3. load firmware on ESP32

(back to top)

configuration

1. customize the credentials.h to your environment

2. libraries

the recommended way to use the libraries would be to install the additional ESP32_libs

and replace

old:

#include "myESP32lib.h"

new:

#include <ESP32_libs/myESP32lib.h>

Roadmap

• optional automatic firmware update
• optional WifiManager
• enabling MQTT subscribing
• ???

Maybe a Kanban board will be established (soon)

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

ZHENG Robert Zhèng Bó Tè 郑 伯特

Project Link: https://github.com/Zheng-Bote/ESP32_BME680_Webserver_MQTT-Client

(back to top)