Skip to content

ESP32 firmware to communicate with EMS heating appliances~

EMS-ESP Logo 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

license donate chat Quality Gate Status

Current Releases
Main - version 3.6.5
Development - version 3.x

New Features introduced in 3.6~

13 August 2023

As well as bug fixes, memory and performance optimizations and more responsive Web layout, these are the other noticeable new features and enhancements:

  • Added Italian and Turkish translations (please do reach out on Discord if you want to help translate to other languages)
  • Added support for ESP32 S2, C3 mini and S3
  • Added 20 new EMS devices
  • Added a Scheduler to allow setting of EMS parameters at specific times
  • Custom Entity feature to extend entities directly from the telegram data

See a live demo and the full list of features in the change log.

Breaking Changes since v3.6.x~

Warning

The sensors have been renamed. dallassensor is now temperaturesensor in the MQTT topic and named ts in the Customizations file. Likewise analogs is now analogsensor in MQTT and called as in the Customizations file. If you have previous customizations you will need to manually update by downloading, changing the JSON file and uploading. It's also recommended cleaning up any old MQTT topics from your broker using an application like MQTTExplorer.

When upgrading to v3.6 for the first time from v3.4 on a BBQKees Gateway board you will need to use the EMS-EPS Flasher to correctly re-partition the flash. Make sure you backup the settings and customizations from the WebUI (System->Upload/Download) and restore after the upgrade.

Join Our Community~

For feedback, questions, live troubleshooting or just general chat

Contribute~

Everybody is welcome and invited to contribute to the EMS-ESP Project by:

  • providing Pull Requests (Features, Proof of Concepts, Language files or Fixes)
  • testing new released features and report issues
  • donating to acquire hardware for testing and implementing or out of gratitude
  • contributing missing documentation for features and devices

Report bugs and suggest features~

Open a new topic on EMS-ESP discussions

Report a bug in EMS-ESP issues