Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zheng-bote/esp32_bme680_webserver_mqtt-client

ESP32 BME680 temperature, humidity, pressure, gas WIFi Webserver & MQTT client
https://github.com/zheng-bote/esp32_bme680_webserver_mqtt-client

arduino bme680 esp32 mqtt-client webserver

Last synced: 22 days ago
JSON representation

ESP32 BME680 temperature, humidity, pressure, gas WIFi Webserver & MQTT client

Awesome Lists containing this project

README

        





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



  2. Getting Started


  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
```sh
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 ...
4. 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
```

## Roadmap

- [x] optional automatic firmware update
- [x] 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](https://github.com/Zheng-Bote/ESP32_BME680_Webserver_MQTT-Client)

(back to top)