[Beitragsvorschlag] Native Unterstützung für enecess Modbus-TCP-Energiezähler

[enecess]

Hintergrund

Wir sind das Engineering-Team hinter enecess. Mehrere Kunden haben uns gebeten, unsere Energiezähler als native Geräte in openWB verfügbar zu machen. Daher möchten wir die Integration selbst beitragen und langfristig pflegen.

Gerät und Protokoll

• Gerätetyp: Energiezähler
• Kommunikation: Modbus TCP
• Protokollzugriff: vollständige interne Dokumentation für unser Engineering-Team verfügbar
• Tests: Die Implementierung kann vor der Einreichung an realer Serienhardware validiert werden
• Pflege: enecess übernimmt die Verantwortung für zukünftige Protokollanpassungen und Fehlerbehebungen

Produktreferenzen

• Amazon.de-Produktseite
• Hersteller-Website

Geplanter Beitrag

Wir möchten den Treiber bzw. das Modul selbst implementieren, an physischen Geräten testen, die erforderliche Dokumentation und Tests ergänzen und das Ergebnis anschließend als Pull Request einreichen. Wir erwarten nicht, dass die openWB-Maintainer die Integration für uns entwickeln oder später pflegen.

Fragen vor Beginn der Implementierung

1. Liegt die native Unterstützung eines solchen Modbus-TCP-Zählers eines Drittanbieters im aktuellen Projektumfang, und wäre ein entsprechender Beitrag willkommen?
2. Welche bestehende Zähler-Integration eignet sich am besten als architektonische Referenz?
3. Welche verbindlichen Schnittstellen, Verzeichnisstrukturen, Coding-Konventionen, Test-Fixtures, Konfigurationsschemata oder Dokumentationsanforderungen sollten wir beachten?
4. Sollten wir vor Beginn des Pull Requests einen Designvorschlag oder eine Zusammenfassung der Protokoll- bzw. Registerbelegung bereitstellen?
5. Welcher Prüfungszeitraum ist für eine neue Hardware-Integration typischerweise zu erwarten, sobald der Pull Request bereitsteht?

Verbindlichkeit

Wenn der vorgeschlagene Ansatz für das Projekt passt, werden wir mit Implementierung und Validierung beginnen und die Integration auch nach einem Merge weiterhin pflegen. Gerne passen wir das Design frühzeitig anhand des Feedbacks der Maintainer an.
Vielen Dank für die Pflege von openWB und die Prüfung dieses Beitragsvorschlags.

[kevinwieland]

1. Sehr gerne einen PR stellen.
2. Das kommt auf den Umfang an. Vermutlich bietet sich unser flex kit als Referenz an ( https://github.com/openWB/core/tree/master/packages/modules/devices/openwb/openwb_flex ) wenn ihr euren Zähler als EVU / PV nutzen können möchtet.
3. Das kann nicht schaden
4. Module werden üblicherweise kurzfristig gemerged

[danielrudolf]

Hallo,

ich wurde von meiner Anfrage bezüglich einer Integration des Enecess ecoMain auf diese Diskussion verwiesen.

Ich nutze den ecoMain inzwischen produktiv und würde mich sehr über eine Integration in openWB freuen.

Daher wollte ich nachfragen: Was kann ich als Anwender beitragen, um eine Integration zu unterstützen oder zu beschleunigen?

Ich kann gerne:

Tests mit einer produktiven Anlage durchführen,
Logdateien oder Debug-Ausgaben bereitstellen,
verschiedene Szenarien (PV, Batteriespeicher, Netzbezug, Überschussladen usw.) testen,
neue Versionen oder Implementierungen zeitnah ausprobieren und Rückmeldung geben.

Falls es etwas gibt, womit ich helfen kann, sagt einfach Bescheid. Ich unterstütze das Projekt gerne.

Vielen Dank!

[enecess]

1. Sehr gerne einen PR stellen.
2. Das kommt auf den Umfang an. Vermutlich bietet sich unser flex kit als Referenz an ( https://github.com/openWB/core/tree/master/packages/modules/devices/openwb/openwb_flex ) wenn ihr euren Zähler als EVU / PV nutzen können möchtet.
3. Das kann nicht schaden
4. Module werden üblicherweise kurzfristig gemerged

Hallo,

vielen Dank für eure positive Rückmeldung, die schnelle Antwort und die hilfreichen Hinweise zur Umsetzung. Besonders der Verweis auf das openWB Flex Kit hilft uns dabei, die Integration von Anfang an passend zur bestehenden Architektur aufzubauen.

Wir werden nun möglichst zügig mit der Entwicklung und den Tests beginnen. Wenn alles planmäßig verläuft, möchten wir den Pull Request noch in dieser Woche einreichen.

Sobald der Pull Request bereitsteht, würden wir uns freuen, wenn ihr ihn bei Gelegenheit möglichst zeitnah prüfen könntet. Gemeinsam können wir so dazu beitragen, dass unsere Kunden den enecess ecoMain bald in ihren jeweiligen Anwendungsszenarien mit openWB einsetzen und dabei die starke Kompatibilität sowie die kontinuierliche Weiterentwicklung von openWB erleben können.

Vielen Dank nochmals für eure Unterstützung. Wir halten euch über den Fortschritt auf dem Laufenden.

[enecess]

Hallo,

ich wurde von meiner Anfrage bezüglich einer Integration des Enecess ecoMain auf diese Diskussion verwiesen.

Ich nutze den ecoMain inzwischen produktiv und würde mich sehr über eine Integration in openWB freuen.

Daher wollte ich nachfragen: Was kann ich als Anwender beitragen, um eine Integration zu unterstützen oder zu beschleunigen?

Ich kann gerne:

Tests mit einer produktiven Anlage durchführen, Logdateien oder Debug-Ausgaben bereitstellen, verschiedene Szenarien (PV, Batteriespeicher, Netzbezug, Überschussladen usw.) testen, neue Versionen oder Implementierungen zeitnah ausprobieren und Rückmeldung geben.

Falls es etwas gibt, womit ich helfen kann, sagt einfach Bescheid. Ich unterstütze das Projekt gerne.

Vielen Dank!

Hallo,

vielen Dank, dass du den enecess ecoMain bereits produktiv einsetzt, und vielen Dank auch für dein Interesse an einer Integration in openWB. Wir freuen uns sehr über dein positives Feedback und dein Angebot, die Entwicklung aktiv zu unterstützen.

Wir bereiten die Integration derzeit vor und möchten die Entwicklung sowie die Tests möglichst zügig abschließen. Deine Unterstützung mit einer realen Anlage ist für uns sehr wertvoll, insbesondere weil sich damit unterschiedliche Betriebszustände und Anwendungsszenarien unter Praxisbedingungen überprüfen lassen.

Sobald eine erste testfähige Version verfügbar ist, kommen wir gerne auf dein Angebot zurück. Besonders hilfreich wären dann beispielsweise Tests mit Netzbezug, PV-Erzeugung, Batteriespeicher und Überschussladen sowie Rückmeldungen zu Messwerten, Stabilität und möglichen Auffälligkeiten. Falls erforderlich, können auch Logdateien oder Debug-Ausgaben bei der Analyse helfen.

Vielen Dank nochmals für dein Vertrauen in unsere Produkte und deine Bereitschaft, die Integration zu unterstützen. Mit deiner praktischen Erfahrung können wir dazu beitragen, dass die Lösung von Anfang an zuverlässig und alltagstauglich funktioniert.

[danielrudolf]

Hallo, sehr gerne! Ihr habt mit dem ecoMain wirklich ein tolles Produkt entwickelt. Ich bin von den Möglichkeiten und der Umsetzung sehr begeistert. Zu eurem Zeitplan: Die openWB, an der der ecoMain installiert ist, steht in meiner Ordination. Dort bin ich normalerweise Montag bis Donnerstag vor Ort. Nächste Woche bin ich noch da, danach bin ich von *27.07. bis 09.08.* auf Urlaub und kann in dieser Zeit leider kein Feedback geben. Den *ecoSub* habe ich heute früh installiert – damit funktioniert das Gesamtsystem sogar noch besser. Eine Frage hätte ich noch: Plant ihr künftig auch eine *bidirektionale Kommunikation mit openWB*, sodass beispielsweise die Daten oder Ladeinformationen der Wallbox auch in eurer App dargestellt werden können? Ich vermute, dass dafür dann der *ecoHub* notwendig wäre – liege ich damit richtig? Sobald ihr eine erste Testversion habt oder es etwas gibt, das ich für euch testen soll, meldet euch einfach. Ich unterstütze euch gerne mit Tests bei der OpenWB unter realen Bedingungen und gebe zeitnah Rückmeldung. Viele Grüße Dr. Daniel Rudolf Am Di., 14. Juli 2026 um 10:41 Uhr schrieb enecess ***@***.***

…

: *enecess* left a comment (openWB/core#3657) <#3657 (comment)> Hallo, ich wurde von meiner Anfrage bezüglich einer Integration des Enecess ecoMain auf diese Diskussion verwiesen. Ich nutze den ecoMain inzwischen produktiv und würde mich sehr über eine Integration in openWB freuen. Daher wollte ich nachfragen: Was kann ich als Anwender beitragen, um eine Integration zu unterstützen oder zu beschleunigen? Ich kann gerne: Tests mit einer produktiven Anlage durchführen, Logdateien oder Debug-Ausgaben bereitstellen, verschiedene Szenarien (PV, Batteriespeicher, Netzbezug, Überschussladen usw.) testen, neue Versionen oder Implementierungen zeitnah ausprobieren und Rückmeldung geben. Falls es etwas gibt, womit ich helfen kann, sagt einfach Bescheid. Ich unterstütze das Projekt gerne. Vielen Dank! Hallo, vielen Dank, dass du den enecess ecoMain bereits produktiv einsetzt, und vielen Dank auch für dein Interesse an einer Integration in openWB. Wir freuen uns sehr über dein positives Feedback und dein Angebot, die Entwicklung aktiv zu unterstützen. Wir bereiten die Integration derzeit vor und möchten die Entwicklung sowie die Tests möglichst zügig abschließen. Deine Unterstützung mit einer realen Anlage ist für uns sehr wertvoll, insbesondere weil sich damit unterschiedliche Betriebszustände und Anwendungsszenarien unter Praxisbedingungen überprüfen lassen. Sobald eine erste testfähige Version verfügbar ist, kommen wir gerne auf dein Angebot zurück. Besonders hilfreich wären dann beispielsweise Tests mit Netzbezug, PV-Erzeugung, Batteriespeicher und Überschussladen sowie Rückmeldungen zu Messwerten, Stabilität und möglichen Auffälligkeiten. Falls erforderlich, können auch Logdateien oder Debug-Ausgaben bei der Analyse helfen. Vielen Dank nochmals für dein Vertrauen in unsere Produkte und deine Bereitschaft, die Integration zu unterstützen. Mit deiner praktischen Erfahrung können wir dazu beitragen, dass die Lösung von Anfang an zuverlässig und alltagstauglich funktioniert. — Reply to this email directly, view it on GitHub <#3657?email_source=notifications&email_token=AWDVHTSUWSZ4JAXP7E3JOIT5EXW25A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOJWG4YDGNZTGA3KM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJLDGN5XXIZLSL5RWY2LDNM#issuecomment-4967037306>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AWDVHTVRMNGBJIYCI7A2J4D5EXW25AVCNFSNUABFKJSXA33TNF2G64TZHMZTGNJVGQ2DMNBTHNEXG43VMU5TIOBYGA2DCNBQHA4KC5QC> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/AWDVHTSJUGHK6YSROH7SOHD5EXW25A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOJWG4YDGNZTGA3KM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJKTGN5XXIZLSL5UW64Y> and Android <https://github.com/notifications/mobile/android/AWDVHTR44NCEH7V4HSLGH4D5EXW25A5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOJWG4YDGNZTGA3KM4TFMFZW63VHMNXW23LFNZ2KKZLWMVXHJLTGN5XXIZLSL5QW4ZDSN5UWI>. Download it today! You are receiving this because you commented.Message ID: ***@***.***>

[enecess]

Hallo zusammen,

die EcoMain-Integration ist jetzt in zwei Draft Pull Requests verfügbar:

• Core: enecess EcoMain als EVU-Zähler und PV-Wechselrichter integrieren #3681
• Einstellungen: Konfiguration für enecess EcoMain in den Geräteeinstellungen ergänzen openwb-ui-settings#1018

Vielen Dank für die Prüfung und Rückmeldung.

[danielrudolf]

Ich würde die EcoMain-Integration sehr gerne testen und habe mich deshalb bereits damit beschäftigt, wie ich die beiden Draft Pull Requests auf meiner openWB Series2 installieren kann.

Ich habe versucht, per SSH auf die openWB zuzugreifen, um die PRs manuell einzuspielen. Leider wird der Login jedoch mit „Permission denied (publickey)“ abgelehnt. Daraufhin habe ich auf meinem Windows-PC einen SSH-Schlüssel erstellt. Allerdings kann ich meinen Public Key ohne bestehenden SSH-Zugriff nicht auf der openWB hinterlegen, sodass ich an dieser Stelle nicht weiterkomme.

Da ich eine originale openWB Series2 verwende und normalerweise nur über die Weboberfläche arbeite, ist mir leider nicht bekannt, wie ich die beiden Draft Pull Requests in diesem Fall installieren kann.

Gibt es hierfür einen empfohlenen Weg? Wäre es eventuell möglich, die Änderungen vorübergehend als experimentellen Branch bereitzustellen, sodass sie direkt über die Weboberfläche installiert und getestet werden können?

Alternativ würde ich mich auch sehr über eine kurze Anleitung freuen, wie ich die beiden Draft Pull Requests auf einer originalen openWB Series2 installieren kann. Dann teste ich die Integration selbstverständlich gerne auf diesem Weg.

Ich würde die Integration sehr gerne mit meinem produktiv eingesetzten EcoMain unter realen Bedingungen testen und euch anschließend ausführliches Feedback geben. Falls es einen anderen empfohlenen Installationsweg gibt, setze ich diesen natürlich ebenfalls gerne um.

Vielen Dank für eure Unterstützung und die bisherige Arbeit an der Integration!

Lg Daniel Rudolf

[seaspotter]

Immer entspannt bleiben 😁, so schnell kann und muss das ja nun auch nicht passieren. Wenn man nicht weiß was man tut würde ich keinen SSH Zugang empfehlen, ganz davon ab dass dann eh der Support/Garantie eingeschränkt ist.

Erstmal sollte der ganz normale Reviews Prozess durchs openWB Team erfolgen. Ich sehe da schon einiges was vermutlich angepasst werden muss. U.A. ist die ganze legacy Smarthome Integration obsolet da hier nichts mehr weiter entwickelt wird und eine neue Verbrauchersteuerung am entstehen ist. Und auch am anderen Code sehe ich Bedarf ob das so korrekt ist, warum ist eine Seriennummer nötig, eine lokale Modbus Verbindung sollte das nicht benötigen und rein per IP ist eindeutig wohin es geht.
Aber das sollte im Review entsprechend kommentiert werden.
Und danach kann man das sicher in ein Feature Branche kippen zum Testen, aber immer mit der Ruhe :)

[enecess]

Hallo zusammen,

vielen Dank für die Einordnung. Wir warten selbstverständlich den regulären Review-Prozess des openWB-Teams ab und empfehlen keine manuelle Installation per SSH auf einem produktiven System.

Zu den beiden angesprochenen Punkten möchten wir kurz den Hintergrund erläutern:

• Legacy SmartHome: Die Änderungen wurden bewusst getrennt. Sowohl der Core-PR enecess EcoMain als EVU-Zähler und PV-Wechselrichter integrieren #3681 als auch der UI-PR Konfiguration für enecess EcoMain in den Geräteeinstellungen ergänzen openwb-ui-settings#1018 bestehen jeweils aus einem Commit für die native Geräteintegration und einem separaten Commit für Legacy SmartHome. Falls die Legacy-Integration nicht mehr aufgenommen werden soll, können die betreffenden zweiten Commits vor dem Merge entfernt werden. Wir passen die PRs gerne entsprechend der Entscheidung des openWB-Teams an.
• Seriennummer: Sie ist nicht für die Modbus-TCP-Verbindung selbst erforderlich, sondern dient als zusätzliche Identitätsprüfung. Bei einer dynamisch vergebenen IP-Adresse könnte die konfigurierte Adresse später auf ein anderes Gerät zeigen. Außerdem könnte ein anderes Modbus-Gerät teilweise überlappende Register besitzen und dabei einen plausiblen Wert im Versionsregister liefern. Durch den Vergleich mit der im EcoMain gespeicherten Seriennummer stellen wir vor der Verwendung der Messwerte sicher, dass tatsächlich das konfigurierte EcoMain-Gerät angesprochen wird.

Die Seriennummernprüfung war daher als zusätzliche Robustheitsmaßnahme gedacht. Wir verstehen den Einwand zur einfacheren Konfiguration und warten gerne die weitere Bewertung und Diskussion im Review ab. Danach passen wir die Umsetzung entsprechend an.

[danielrudolf]

Vielen Dank für die ausführliche Erklärung und die Aufklärung. Das klingt für mich absolut nachvollziehbar.

Dann warte ich gerne den regulären Review-Prozess des openWB-Teams ab.

Wahrscheinlich war ich mit meinem Tatendrang wieder etwas zu motiviert. 😄 Ich wollte die Integration einfach möglichst schnell testen und euch dabei unterstützen.

Sobald die Integration im master, Beta oder einem experimentellen Branch verfügbar ist, teste ich sie sehr gerne mit meinem produktiv eingesetzten EcoMain und gebe euch anschließend ausführliches Feedback aus dem Praxisbetrieb.

Ich freue mich schon darauf und bin gespannt auf das Ergebnis. Vielen Dank nochmals für eure Arbeit und euer Engagement!