README.md

esp32-room-sensor

Uses the BME680 sensor to read temperature, pressure, humidity and IAQ and provides the data via MQTT and Web.

What this code does

1. Connects to WiFi
2. Connects to MQTT broker
3. Reads the sensor data of the BME680
4. Runs a webserver which provides two routes:
   1. "/" -> provides a way to view current sensor data
   2. "/log" -> allows to watch everything printed even if the ESP32 isn't connected to Serial
5. Runs websockets to push everything logged to the "/log" webpage
6. The "/log" webpage additonally sends a ping request via JavaScript websocket and the ESP32 responds with a pong message to identify connection issues on client side.

Hardware

Main parts

• ESP32 Dev Kit C V4 NodeMCU
• BME680 Environmental sensor

Additional/Optional parts

Soldering

• Mat
• Bolt
• Solder

Connecting stuff

• Breadboard
• Jump wires

Software

• platformio - for uploading sketches (VSCode recommended)
• MQTT broker like Mosquitto or hmq
• MQTT explorer - for debugging

HowTo

1. Solder BME680 pin headers
2. Connect ESP32 to BME680
3. Flash ESP32
4. Integrating into Homebridge

Acknowledgments

Special thankts to:

• BSEC Arduino Library by Bosch Sensortec
• pubsubclient by knolleary
• WebSocket Server and Client by Links2004