About EMS-ESP
Open source firmware for ESP32-based devices
EMS-ESP is an open source firmware for Espressif ESP32 based chipsets originally developed by @Proddy back in 2018 and now owned and maintained exclusively by both Proddy and @MichaelDvP.
⚠️ Important Disclaimer
This code was developed based off information gathered on the internet and many hours of reverse engineering the communications between the EMS bus and real live devices. It is not based on any official documentation or supported libraries from Bosch/Buderus/Junkers/Nefit (and associated companies) and therefore there are no guarantees whatsoever regarding the safety of your devices and/or their settings, or the accuracy of the information provided.
📄 License
This program is licensed under GPL-3.0.
📚 Project History
A journey through the evolution of EMS-ESP from prototype to production
August 2017
PrototypeMy first prototype, read only and based on an ESP8266. Because the Serial UART was used I couldn't display the values to the screen so had to write a Telnet service which consumed about 75% of the time. The GitHub repo had 4 .cpp files and was called Boiler.
May 2018
v0.1.0The first public prototype. Built only for the ESP8266. This version only had a very simple telnet interface and MQTT.
September 2018
v1.0.0First official stable release on GitHub
March 2019
v1.5.0Added support for the ESP32. Only way to change settings was via Telnet.
September 2019
v1.9.0Major release with a new WebUI based on javascript
August 2020
v2.0.0Complete re-write of the Telnet Console and WebUI. Added HA support plus an additional 50 new EMS devices
March 2021
v3.0.0Exclusive to the ESP32. Ethernet support, improved MQTT
January 2022
v3.4.0New UI and more features
February 2023
v3.5.0Multi-Language, Heat pumps, Customizations, MQTT Discovery improvements.
August 2023
v3.6.0Sensors in its own tab and able to browse all entities from the list. Added Scheduler and Custom Entity editor, plus Italian and Turkish.
October 2024
v3.7.0More of everything. Web UI refreshed with a Dashboard. Added Modbus support. Added Scheduler conditions and functions.
November 2024
v3.7.1Bug fixes and stability improvements.
March 2025
v3.7.2Many improvements and fixes.