From e4782527d4882b83c1f7c261f4355b4b8f371def Mon Sep 17 00:00:00 2001 From: harrymayr <104222469+harrymayr@users.noreply.github.com> Date: Mon, 19 Dec 2022 00:25:03 +0100 Subject: [PATCH 1/3] Update README.md --- README.md | 128 +++--------------------------------------------------- 1 file changed, 5 insertions(+), 123 deletions(-) diff --git a/README.md b/README.md index 801fc53e..584fbfe4 100644 --- a/README.md +++ b/README.md @@ -1,129 +1,11 @@ # ![logo](media/EMS-ESP_logo_dark.png) -**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. +This fork is based on proddys and victor-mo work on EMS und iRT gateways. +Both are not longer maintaint for the ESP8266, so I decided to learn a little and merge both capabilitys to one project and also extend the cababilitys of the software. -This is the firmware for the ESP8266, known as version 2. We've since moved to the ESP32 platform with v3 which opens up many more possibilities for additional features. Make sure you check out and look at the [demo](https://ems-esp.derbyshire.nl). - -## **Important: This version will be restricted to maintenance releases only!** -
- -[![version](https://img.shields.io/github/release/emsesp/EMS-ESP.svg?label=Latest%20Release)](https://github.com/emsesp/EMS-ESP/blob/main/CHANGELOG.md) -[![release-date](https://img.shields.io/github/release-date/emsesp/EMS-ESP.svg?label=Released)](https://github.com/emsesp/EMS-ESP/commits/main) -[![license](https://img.shields.io/github/license/emsesp/EMS-ESP.svg)](LICENSE) -[![downloads](https://img.shields.io/github/downloads/emsesp/EMS-ESP/total.svg)](https://github.com/emsesp/EMS-ESP/releases) -[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/emsesp/EMS-ESP.svg)](http://isitmaintained.com/project/emsesp/EMS-ESP "Average time to resolve an issue") -[![Percentage of issues still open](http://isitmaintained.com/badge/open/emsesp/EMS-ESP.svg)](http://isitmaintained.com/project/emsesp/EMS-ESP "Percentage of issues still open") -
-[![chat](https://img.shields.io/discord/816637840644505620.svg?style=flat-square&color=blueviolet)](https://discord.gg/3J3GgnzpyT) - -If you like **EMS-ESP**, please give it a star, or fork it and contribute! - -[![GitHub stars](https://img.shields.io/github/stars/emsesp/EMS-ESP.svg?style=social&label=Star)](https://github.com/emsesp/EMS-ESP/stargazers) -[![GitHub forks](https://img.shields.io/github/forks/emsesp/EMS-ESP.svg?style=social&label=Fork)](https://github.com/emsesp/EMS-ES32P/network) -[![donate](https://img.shields.io/badge/donate-PayPal-blue.svg)](https://www.paypal.com/paypalme/prderbyshire/2) - -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 . - - - ---- - -## **Features** - -- Compatible with both ESP8266 and ESP32 -- A multi-user secure web interface to change settings and monitor the data -- A console, accessible via Serial and Telnet for more monitoring -- Native support for Home Assistant via [MQTT Discovery](https://www.home-assistant.io/docs/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 [70 EMS devices](https://emsesp.github.io/docs/#/Supported-EMS-Devices) (boilers, thermostats, solar modules, mixer modules, heat pumps, gateways) - -## **Screenshots** - -### Web Interface - -| | | -| --- | --- | -| | | -| | | - -### Telnet Console - - - -### In Home Assistant - - - -## **Installing** - -Refer to the [official documentation](https://emsesp.github.io/docs) to how to install the firmware and configure it. The documentation is being constantly updated as new features and settings are added. - -You can choose to use an pre-built firmware image or compile the code yourself: +Please chack out the project pages of proddy's page and the [ReadMe](https://github.com/emsesp/EMS-ESP#readme) and also Victor-Mo's page and [ReadMe](https://github.com/Victor-Mo/IRT-ESP#readme). -- [Uploading a pre-built firmware build](https://emsesp.github.io/docs/#/Uploading-firmware) -- [Building the firmware from source code and flashing manually](https://emsesp.github.io/docs/#/Building-firmware) +**EMS/iRT-ESP** is an open-source firmware for the Espressif ESP8266 and ESP32 microcontroller that communicates with **EMS** (Energy Management System) and iRT-bus based equipment from manufacturers like Bosch, Buderus, Nefit, Junkers, Worcester and Sieger. -## **Support Information** - -If you're looking for support on **EMS-ESP** there are some options available: - -### Documentation - -- [Official EMS-ESP Documentation](https://emsesp.github.io/docs): For information on how to build and upload the firmware -- [FAQ and Troubleshooting](https://emsesp.github.io/docs/#/Troubleshooting): For information on common problems and solutions. See also [BBQKees's wiki](https://bbqkees-electronics.nl/wiki/gateway/troubleshooting.html) - -### Support Community - -- [Discord Server](https://discord.gg/3J3GgnzpyT): For support, troubleshooting and general questions. You have better chances to get fast answers from members of the community -- [Search in Issues](https://github.com/emsesp/EMS-ESP/issues): You might find an answer to your question by searching current or closed issues - -### Developer's Community - -- [Bug Report](https://github.com/emsesp/EMS-ESP/issues/new?template=bug_report.md): For reporting Bugs -- [Feature Request](https://github.com/emsesp/EMS-ESP/issues/new?template=feature_request.md): For requesting features/functions -- [Troubleshooting](https://github.com/emsesp/EMS-ESP/issues/new?template=questions---troubleshooting.md): 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 - -# **Contributors ✨** - -EMS-ESP is a project originally created by [proddy](https://github.com/proddy) with the main contributors and owners: - - - - - - - - - - -
- -
proddy -
- v2 - v3 - 		-
MichaelDvP
v2 - v3 -
- - - -You can also 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](https://emsesp.github.io/docs) - -# **Libraries used** - -- [esp8266-react](https://github.com/rjwats/esp8266-react) by @rjwats for the framework that provides the Web UI -- [uuid-\*](https://github.com/nomis/mcu-uuid-console) from @nomis. The console, syslog, telnet and logging is based on these libraries -- [ArduinoJson](https://github.com/bblanchon/ArduinoJson) -- [AsyncMqttClient](https://github.com/marvinroger/async-mqtt-client) for MQTT, with modifications from @bertmelis -- ESPAsyncWebServer and ESPAsyncTCP for the Web and TCP backends, with custom modifications for performance - -# **License** +This is the firmware for the ESP8266, known as version 2. We've since moved to the ESP32 platform with v3 which opens up many more possibilities for additional features. Make sure you check out and look at the [demo](https://ems-esp.derbyshire.nl). -This program is licensed under GPL-3.0 From 5b0136a74ae04e00a5ca1314bdb81ff0fb542957 Mon Sep 17 00:00:00 2001 From: harrymayr <104222469+harrymayr@users.noreply.github.com> Date: Mon, 19 Dec 2022 00:25:48 +0100 Subject: [PATCH 2/3] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 584fbfe4..da3549ed 100644 --- a/README.md +++ b/README.md @@ -7,5 +7,5 @@ Please chack out the project pages of proddy's page and look at the [demo](https://ems-esp.derbyshire.nl). +This is the firmware for the ESP8266, known as version 2. Proddy has since moved to the ESP32 platform with v3 which opens up many more possibilities for additional features. Make sure you check out and look at the [demo](https://ems-esp.derbyshire.nl). From f2662022f8af93343c8ac3af864af9770ab34ef3 Mon Sep 17 00:00:00 2001 From: harrymayr <104222469+harrymayr@users.noreply.github.com> Date: Mon, 19 Dec 2022 00:26:49 +0100 Subject: [PATCH 3/3] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index da3549ed..83ca3caf 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ This fork is based on proddys and victor-mo work on EMS und iRT gateways. Both are not longer maintaint for the ESP8266, so I decided to learn a little and merge both capabilitys to one project and also extend the cababilitys of the software. -Please chack out the project pages of proddy's page and the [ReadMe](https://github.com/emsesp/EMS-ESP#readme) and also Victor-Mo's page and [ReadMe](https://github.com/Victor-Mo/IRT-ESP#readme). +Please check out the project pages of proddy and his [ReadMe](https://github.com/emsesp/EMS-ESP#readme) and also Victor-Mo's page and [ReadMe](https://github.com/Victor-Mo/IRT-ESP#readme). **EMS/iRT-ESP** is an open-source firmware for the Espressif ESP8266 and ESP32 microcontroller that communicates with **EMS** (Energy Management System) and iRT-bus based equipment from manufacturers like Bosch, Buderus, Nefit, Junkers, Worcester and Sieger.