EMS-ESP is an open-source firmware for the Espressif ESP8266 and ESP32 microcontroller that communicates with EMS (Energy Management System) based equipment from manufacturers like Bosch, Buderus, Nefit, Junkers, Worcester and Sieger.
If you like EMS-ESP, please give it a star, or fork it and contribute!
Note, EMS-ESP requires a small hardware circuit that can convert the EMS bus data to be read by the microcontroller. These can be ordered at https://bbqkees-electronics.nl.
- Support for both ESP8266 and ESP32 modules
- A multi-user secure Web interface (based on React/TypeScript and Material-UI)
- A Console, accessible via Serial and Telnet
- Native support for Home Assistant MQTT Discovery (in development)
- Can be run standalone as an independent Access Point or join an existing WiFi network
- Easy first-time configuration via a web Captive Portal
- Supporting over 70 EMS devices (boilers, thermostats, solar modules, mixing modules, heat pumps, gateways)
 |
 |
 |
 |
Refer to the Wiki articles to install the firmware.
If you're looking for support on EMS-ESP there are some options available:
- Documentation Site: For information on how to build and upload the firmware
- FAQ and Troubleshooting: For information on common problems and solutions. See also BBQKees's site
- EMS-ESP Support Chat: For support, troubleshooting and general questions. You have better chances to get fast answers from members of the community
- Search in Issues: You might find an answer to your question by searching current or closed issues
- Bug Report: For reporting Bugs
- Feature Request: For requesting features/functions
- Troubleshooting: As a last resort, you can open new Troubleshooting & Question issue on GitHub if the solution could not be found using the other channels. Just remember: the more info you provide the more chances you'll have to get an accurate answer
You can contribute to EMS-ESP by
- providing Pull Requests (Features, Fixes, suggestions)
- testing new released features and report issues on your EMS equipment
- contributing to missing documentation
A shout out to the people helping EMS-ESP get to where it is today
- @MichaelDvP for all his amazing contributions and patience. The core UART code is his.
- @BBQKees for his endless testing and building the awesome circuits
- @susisstrolch for writing a first working version of the EMS bridge circuit which I used to design EMS-ESP version 0.1
- Plus many more providing suggestions, PRs and Donations. Thanks!
This program is licensed under GPL-3.0