!Mehrstöckiges Wohnhaus mit Balkonen und Solarmodulen auf dem Dach

Am 23. August 2026 eröffnet ein Nutzer im GitHub-Repository von OpenDTU-OnBattery ein Ticket mit der Nummer 2695. Er betreibt einen Hoymiles HMS-1600-4T an einem OpenDTU-Fusion-Board und hat etwas Merkwürdiges beobachtet: Stellt er das „nicht persistente“ Limit auf 50 Prozent, springt das „persistente“ Limit gleich mit auf 50. Auch per MQTT aus Home Assistant. Ein Mitdiskutant antwortet, das sei normal, der Wechselrichter kenne zwar zwei Befehle, melde aber nur ein einziges Limit zurück. Der Fragesteller nennt das „höchst unlogisch“, und so geht es eine Weile hin und her.

Der Streit ist ein guter Eingang, weil er zeigt, was passiert, wenn man einen Wechselrichter vom Hersteller abnabelt: Man bekommt Zugriff auf Dinge, die die Hoymiles-App nie angeboten hat, und man erbt auch deren Eigenheiten. Dieser Artikel zeigt, wie Sie ein Balkonkraftwerk mit Hoymiles-Wechselrichter lokal auslesen, ins Energie-Dashboard von Home Assistant bringen und dabei die Stolpersteine umgehen. Wie das Dashboard grundsätzlich eingerichtet wird, steht in Home Assistant Energy Dashboard einrichten. Stand der Versionen: Home Assistant 2026.10.4 vom 24. Oktober 2026, Abruf der Repositories und Dokumentationen am 3. November 2026.

Woher das Ganze kommt

OpenDTU begann nicht als Produkt, sondern als Forumsthread. Die README des Projekts verweist auf eine Diskussion bei Mikrocontroller.net: Ziel war, die originale Hoymiles-DTU samt Cloud-Zugang zu ersetzen. Dafür musste das Funkprotokoll der Wechselrichter per Reverse Engineering entschlüsselt werden. Dieselbe Quelle nennt auch AhoyDTU als Schwesterprojekt, das aus demselben Thread hervorging.

Das Prinzip ist simpel. Ein Hoymiles-Mikrowechselrichter spricht nicht per WLAN, sondern per Funk mit einer separaten Sendestation, der DTU. Die DTU hängt am Internet und schickt die Daten an die Hoymiles-Cloud. Wer diese Station durch einen ESP32 mit Funkmodul ersetzt, bekommt dieselben Daten, aber im eigenen Netz.

Die vier Wege im Vergleich

OpenDTU ist das Original: Firmware für ESP32, Weboberfläche, MQTT, Web-API. Die letzte Version trägt die Bezeichnung v26.9.28 und erschien am 28. September 2026. Davor lagen v26.3.30 und v26.3.28, im März. Das Repository bekam am 2. November 2026 noch einen Commit, es ist also nicht eingeschlafen, sondern veröffentlicht nur selten. AhoyDTU (lumapu/ahoy) macht dasselbe mit eigener Codebasis. Die README listet ESP32 für HM, HMS und HMT. Der ESP8266 ist für neue Aufbauten ausdrücklich nicht empfohlen und kann HMS/HMT gar nicht. Die letzte Release ist 0.8.156 vom 12. August 2025, die davor 0.8.155 vom März 2025. Ahoy ist also in einem anderen Takt unterwegs als OpenDTU; für einen Neueinsteiger spricht aktuell die jüngere Release-Historie für OpenDTU. Das ist eine Einschätzung, keine Aussage der Projekte. Brauchbar bleibt Ahoy trotzdem: Die Dokumentation unter docs.ahoydtu.de beschreibt MQTT mit Autodiscovery für Home Assistant ebenfalls. OpenDTU-OnBattery ist ein Fork von OpenDTU, den das Team hoylabs pflegt. Laut README fügt er Unterstützung für Batterielader, Batteriemanagementsysteme und Stromzähler auf einem einzelnen ESP32 hinzu. Das Herzstück ist der Dynamic Power Limiter, der die Leistung eines oder mehrerer Wechselrichter an den tatsächlichen Verbrauch anpasst, also Nulleinspeisung ohne zusätzliche Automation. Aktuell ist 2026.07.23 vom 23. Juli 2026. Wer nur auslesen will, braucht das nicht. Wer ohnehin eine Batterie mit Wechselrichter koppelt, schaut hier zuerst nach. Die Hoymiles-Cloud-Integrationen sind der Gegenentwurf. In der Integrationsliste von Home Assistant gibt es keinen Eintrag für Hoymiles (die Adresse home-assistant.io/integrations/hoymiles liefert beim Abruf einen 404). Was es gibt, sind Custom Components aus der Community. Eine davon, ha-hoymiles-s-cloud, holt die Daten laut ihrem Autor über die Cloud-API. Der Autor selbst schreibt dazu im Home-Assistant-Forum, beide seiner Lösungen verlangten eine aktive Internetverbindung der DTU, selbst für lokale Kommunikation, und das widerspreche der Home-Assistant-Philosophie. Er verweist dann auf OpenDTU: „It solves the local aspect.“

Eine vierte, lokale Option kommt im nächsten Abschnitt, und für viele ist sie die relevante.

Das W im Namen

Auf der Seite mit der Wechselrichter-Übersicht steht ein Absatz, den man vor dem Kauf lesen sollte. Alle Wechselrichter mit integriertem WLAN, erkennbar am „W“ im Namen, etwa HMS-800W-2T, werden von OpenDTU nicht unterstützt. Die Ahoy-README warnt in derselben Weise: HMS-XXXXW-2T haben ein „W“ im Namen und eine DTU-Seriennummer auf dem Aufkleber. Sie funken nicht auf der Frequenz, die die Projekte abhören, weil die DTU im Gerät steckt.

Für diese Geräte gibt es die HACS-Integration ha-hoymiles-wifi von suaveolent. Laut README spricht sie über das Heimnetz direkt mit den Geräten, ohne Cloud-Verbindung. Getestet ist sie unter anderem mit HMS-400W-1T, HMS-800W-2T, HMS-1000W-2T und HMS-2000DW-4T. Die letzte Release ist v0.5.1 vom 1. Dezember 2025, das Repository wurde zuletzt am 27. Oktober 2026 bearbeitet.

Wer dagegen ein Balkonkraftwerk mit HM-, HMS-xxx-xT oder HMT-Gerät hat, also ohne W, ist bei OpenDTU richtig.

Hardware: ESP32 plus das richtige Funkmodul

Die Dokumentation unter opendtu.solar ist hier eindeutig. Die HM-Serie braucht ein NRF24L01+-Modul, die HMS- und HMT-Serie ein CMT2300A. In der Übersichtstabelle steht für jedes Modell, welches Modul nötig ist, auch die Seriennummern-Präfixe, zum Beispiel 1124 für HMS-300 bis HMS-500-1T und 1143 sowie weitere für die 2T-Geräte.

Als Controller empfiehlt die Doku für den Einstieg ein „NodeMCU32 ESP32 DEVKIT DOIT“ oder ein ESP32-NodeMCU-Board mit ESP32-S3 oder ESP-WROOM-32. Es gehen auch Boards mit Ethernet-Buchse und Power-over-Ethernet, genannt werden Olimex ESP32-POE und LilyGo T-Internet-POE. Gespeist wird mit 5 V und 1 A. Die Doku merkt an, das USB-Kabel am PC sei vielleicht stark genug, vielleicht auch nicht, und dass die Kabelqualität eine Rolle spielt. Ein dünnes Ladekabel hat schon manchen ESP32 in den Wahnsinn getrieben.

Das Wichtige: Die Pins, mit denen das Funkmodul am ESP32 hängt, sind nicht festgelegt. OpenDTU braucht ein passendes Geräteprofil (Device Profile), das beschreibt, welcher Pin wohin geht. Die Firmware lässt sich über einen Web-Installer im Browser aufspielen (Seite opendtu.solar/firmware/webinstall). Wer nicht löten will, kann das Ready-to-use-Board OpenDTU Fusion kaufen, das die OnBattery-README ausdrücklich empfiehlt.

Reichweite ist ein Thema: Die Funkstrecke ist kurz, die Doku zeigt für Wechselrichter mit NRF24 nur zwei Empfangsstufen an, besser oder schlechter als minus 64 dBm. Der ESP32 gehört also in die Nähe der Wechselrichter, nicht in den Keller drei Stockwerke tiefer.

MQTT oder native Integration

OpenDTU hat keine native Home-Assistant-Integration. Der Weg führt über MQTT, und der ist gut ausgebaut. In den MQTT-Einstellungen der OpenDTU tragen Sie Hostname und Port Ihres Brokers ein (Standard 1883, mit TLS 8883), optional Benutzer und Passwort, und aktivieren „Home Assistant MQTT Auto Discovery“. Der Discovery-Präfix steht standardmäßig auf homeassistant/. Haben Sie in Home Assistant nichts daran geändert, bleibt es dabei. Als Broker bietet sich das Mosquitto-Add-on an; wie ein MQTT-Aufbau mit lokaler Datenquelle aussieht, zeigt Tibber Pulse lokal per MQTT in Home Assistant.

Danach erscheinen Gerät und Entitäten von selbst. Ein Blick in den Quellcode (MqttHandleHass.cpp) zeigt, was die OpenDTU meldet: Der Gesamtertrag „Yield Total“ kommt mit Geräteklasse Energie in kWh und dem State Class total_increasing. Genau das verlangt das Energie-Dashboard von einer Quelle. Dazu kommen Tagesertrag, Leistung, Temperatur, Schaltflächen zum Ein- und Ausschalten und Zahlenfelder für das Limit.

Ein Detail aus der Änderungsliste der README, das Sie kennen sollten: Am 7. November 2023 gab es einen Breaking Change bei der Home-Assistant-Autodiscovery, ein neues Namensschema. Wer alte Anleitungen aus dem Netz nachbaut, findet dort Entitätsnamen, die so nicht mehr existieren.

Im Energie-Dashboard tragen Sie unter „Solarmodule“ den Gesamtertrag ein. Die Doku von Home Assistant empfiehlt dort die Zählerquelle des Wechselrichters, was die Anleitung zum Dashboard ausführlicher begründet. Der Sensor ac/yieldtotal der OpenDTU bildet die Summe aller aktivierten Wechselrichter. Wenn Sie mehrere Geräte betreiben und nur eines davon im Dashboard sehen wollen, nehmen Sie den Ertrag des einzelnen Wechselrichters.

Für alle, die ohne MQTT auskommen wollen: Die Web-API liefert unter /api/livedata/status das gesamte JSON. Die Doku weist selbst darauf hin, dass diese API hauptsächlich für die Kommunikation zwischen Weboberfläche und ESP gedacht ist, sich ändern kann und auf eigenes Risiko genutzt wird. Die README listet mehrere Breaking Changes an diesen Endpunkten, zuletzt am 7. August 2025 bei /api/limit/config. MQTT ist damit die stabilere Wahl.

Das Limit: persistent, nicht persistent und warum es hakt

Zurück zu Ticket 2695. In der MQTT-Doku von OpenDTU steht der Unterschied schwarz auf weiß. Das persistente Limit überlebt die Nacht ohne Strom. Das nicht persistente Limit fällt nachts auf den letzten persistenten Wert zurück. Es muss außerdem ohne Retain-Flag gesendet werden, sonst wird es ignoriert. Und: Ein absolutes Limit wird im Wechselrichter sofort gesetzt, in der Weboberfläche und im Status-Topic taucht es laut Doku erst nach etwa vier Minuten auf. Das ist die Ursache vieler Verwirrung. Wer sein Limit setzt und 30 Sekunden später nichts sieht, hat nichts falsch gemacht.

Warum der Unterschied zählt: Wer per Automation dynamisch regelt, etwa auf Nulleinspeisung, darf das nicht über das persistente Limit tun. Das schreibt nach Angabe des Autors einer Home-Assistant-Blueprint für Nulleinspeisung jedes Mal in den Flash des Wechselrichters. Die README von ha-hoymiles-wifi formuliert dieselbe Warnung noch schärfer: Das persistente Limit nicht für häufige Anpassungen verwenden, weil die vielen Schreibvorgänge in den EEPROM den Wechselrichter beschädigen könnten. Zwei unabhängige Quellen, dieselbe Warnung. Sie ist ernst genug, um die persistenten Zahlenfelder aus jeder Automation herauszulassen.

Der Blueprint-Autor beschreibt übrigens auch, wie vorsichtig man regeln muss: Sein Regler kappt sofort, wenn mehr als 150 W ins Netz gehen, hebt das Limit aber nur langsam an, mit höchstens 400 W pro Schritt und 30 Sekunden Pause dazwischen, damit ein kurzer Wasserkocher-Peak den Wechselrichter nicht hochjagt. Wer eine eigene Automation baut, spart sich viel Frust, wenn er diese Trägheit einplant.

Im Ticket 2695 hält der Fragesteller dagegen, bei ihm wandere der persistente Wert nach einer Weile mit. Das Ticket ist inzwischen geschlossen. Ob das ein Anzeigeeffekt oder ein echtes Verhalten des Wechselrichters ist, haben die Beteiligten nicht abschließend geklärt. Für Sie heißt das: Wenn Sie ein dauerhaftes Maximum festlegen wollen, setzen Sie es einmal, mit Bedacht, und prüfen Sie es am nächsten Morgen, bevor Sie darauf bauen.

Dazu noch ein Hinweis zur Wechselrichter-Firmware, den die OnBattery-README gibt. Die Version 2.0.4 des Wechselrichters soll man meiden: Er meldet nach vier Minuten ohne Limit-Update 100 Prozent, was den Dynamic Power Limiter lahmlegt. Als beste Option nennt die Tabelle 1.1.12, 1.0.x sei gut, wenn man die Verteilungslogik für die Eingänge nicht braucht.

Rechtliches, kurz

Das Limit ist keine rechtliche Größe. Die Bundesnetzagentur stellt das auf ihrer Seite zu Balkon-Solaranlagen klar: Ein Steckersolargerät im Sinne des EEG darf höchstens 2.000 Watt Modulleistung haben und höchstens 800 VA Wechselrichterleistung. Diese Sonderregeln gelten für Geräte, die seit dem 16. Mai 2024 (Solarpaket) erstmals in Betrieb genommen wurden. Wenn sich die Leistung per Schalter oder Software unterschiedlich hoch einstellen lässt, zählt der höchste wählbare Wert. Das Beispiel der Behörde: Ein Gerät mit 900 VA maximal wählbarer Leistung fällt nicht unter die Sonderregeln, auch wenn es zunächst auf 600 VA eingestellt wurde.

Übertragen auf das Thema: Wer einen größeren Hoymiles-Wechselrichter kauft und ihn per OpenDTU auf 800 W drosselt, hat nach dieser Auslegung trotzdem keinen 800-VA-Wechselrichter im Sinne der Regeln. Das ist eine Übertragung des Beispiels, nicht ein Urteil über Ihren Einzelfall; im Zweifel klärt es der Netzbetreiber.

Die Registrierung läuft im Marktstammdatenregister der Bundesnetzagentur, die Registrierungsfrist beträgt laut MaStR-Webhilfe einen Monat. Wie das Ganze mit Speicher aussieht, steht in Balkonkraftwerk-Speicher anmelden.

Wann sich was lohnt

Wenn Ihr Wechselrichter ein W im Namen trägt: ha-hoymiles-wifi aus HACS. Ein Funkmodul bringt Ihnen da nichts.

Wenn Sie HM, HMS oder HMT ohne W haben und nur auslesen wollen: OpenDTU auf einem ESP32 mit passendem Funkmodul, per MQTT Autodiscovery ins Dashboard, ohne weitere Automation.

Wenn Sie später einen Speicher ergänzen und selbst regeln wollen: OpenDTU-OnBattery lohnt, weil der Dynamic Power Limiter schon eingebaut ist. Wie sich Speicher wirtschaftlich schlagen, behandelt Balkonkraftwerk-Speicher nachrüsten, die Einbindung gängiger Marken Balkonkraftwerk-Speicher in Home Assistant einbinden.

Wenn Sie über die Cloud gehen wollen: Es geht, aber Sie bekommen dann genau das, was die Entwickler dieser Lösungen selbst problematisch finden.

Quellen (Stand: 3. November 2026)

  • GitHub, tbnobody/OpenDTU: README, Release v26.9.28 vom 28.09.2026, Quellcode MqttHandleHass.cpp
  • OpenDTU-Dokumentation (opendtu.solar): Hardware, Inverter Overview (Stand 24.09.2026), MQTT Topics, MQTT Settings, Web API
  • GitHub, lumapu/ahoy: README, Release 0.8.156 vom 12.08.2025; AhoyDTU-Dokumentation (docs.ahoydtu.de), Kapitel MQTT
  • GitHub, hoylabs/OpenDTU-OnBattery: README, Release 2026.07.23; Issue #2695 vom 23.08.2026
  • GitHub, suaveolent/ha-hoymiles-wifi: README, Release v0.5.1
  • Home Assistant Community, „Hoymiles DTU-P Integrations“ (Forumsbeitrag) und „ZeroSpill: zero-export controller“ (Blueprint-Beschreibung)
  • home-assistant.io: Integrationsliste, Release 2026.10.4 (GitHub home-assistant/core)
  • Bundesnetzagentur, „Balkon-Solaranlagen“ (bundesnetzagentur.de, Abruf 3.11.2026)
  • Marktstammdatenregister, Webhilfe zu Registrierungsfristen (marktstammdatenregister.de)