Skip to content

emsesp/EMS-ESP32

Repository files navigation

logo

version release-date license Quality Gate Status Codacy Badge downloads chat

GitHub stars GitHub forks donate

EMS-ESP is an open-source firmware for the Espressif ESP32 microcontroller that communicates with EMS (Energy Management System) based equipment from manufacturers like Bosch, Buderus, Nefit, Junkers, Worcester and Sieger. It requires a small gateway circuit to interface with the EMS bus which can be purchased from https://bbqkees-electronics.nl or custom built.

Features

  • A multi-user, multi-language secure web interface to change settings and monitor incoming data
  • A console, accessible via Serial and Telnet for more advanced monitoring
  • Native support for Home Assistant, Domoticz and openHAB via MQTT Discovery
  • Can run standalone as an independent WiFi Access Point or join an existing WiFi network
  • Easy first-time configuration via a web Captive Portal
  • Support for more than 110+ EMS devices (boilers, thermostats, solar modules, mixer modules, heat pumps, gateways, switches, heat sources)

Documentation

For the complete documentation on how to install, configure and get support visit the EMS-ESP Wiki.

Support

To chat with the community reach out on our Discord Server.

If you like EMS-ESP, please give it a star, or fork it and contribute or offer a small donation!

Demo

For a live demo of the Web UI click here and log in with any username/password.

Contributors ✨

EMS-ESP is a project owned and maintained by proddy and MichaelDvP.

Libraries used

  • esp8266-react by @rjwats for the framework that provides the core of the Web UI
  • uuid-* from @nomis. The console, syslog, telnet and logging are based off these open source libraries
  • ArduinoJson for all the JSON
  • espMqttClient for the MQTT client, with custom modifications from @MichaelDvP and @proddy
  • ESPAsyncWebServer and AsyncTCP for the Web server and TCP backends, with custom modifications for performance

License

This program is licensed under GPL-3.0

Screenshots

Web Interface

Telnet Console

In Home Assistant