!Einzelnes Solarmodul auf einem Ziegeldach im Sonnenlicht
Im Juli 2025 eröffnete ein Nutzer im Repository von SolarEdge Modbus Multi das Issue #859 mit dem Titel „Integration will not connect“. Er schrieb, die Integration verbinde sich nicht mehr, obwohl er nichts verändert habe. Wenige Tage später berichtete ein zweiter: „my inverter went offline overnight“, kein Neustart von Home Assistant brachte ihn zurück. Sein Wechselrichter hatte nachts die Firmware von 4.22.44 auf 4.23.36 gewechselt. Im Log stand „Failed to connect“ am Port 1502.
Der Thread wuchs auf über 50 Kommentare und blieb bis zum 14. September 2026 offen. Die Ursache liegt laut Maintainer nicht in Home Assistant: SolarEdge schiebt Firmware automatisch auf die Geräte, und manche Versionen hängen danach den Modbus-Server ab. Wer SolarEdge lokal anbinden will, sollte das vorher wissen, denn der Weg dorthin ist kurz, aber er hat eine Eigenheit, die bei anderen Herstellern fehlt.
Warum überhaupt lokal?
Home Assistant bringt für SolarEdge eine eigene Integration mit, und sie ist bequem. Laut Dokumentation liefert sie zwei Dinge:
- Standort-Sensoren über die Cloud-API von SolarEdge. Dafür brauchen Sie die Anlagen-ID und einen API-Schlüssel aus dem Monitoring-Portal (Admin, Site Access, Access Control, API Access). Die Werte kommen alle 15 Minuten, damit das tägliche Limit von 300 Anfragen eingehalten wird. Mit SolarEdge-Speicher kommen Sensoren für Ladestand, Leistung und Tagesenergie dazu.
- Statistiken je Modul, String und Wechselrichter, dafür mit Benutzername und Passwort des Portals. Sie werden alle 12 Stunden für die letzten sieben Tage nachgeholt und landen laut Dokumentation absichtlich nicht als Sensoren, sondern nur in den Statistiken, weil die Daten oft ein paar Stunden Verzögerung haben.
Die lokale Alternative ist die Modbus-Schnittstelle, die in der SolarEdge-Wechselrichtern steckt. Ein Blogger beschrieb sie 2021 in einem Beitrag für einen SE3000H: Cloud-API und Modbus ließen sich gleichzeitig nutzen und störten sich nicht. Das ist ein Einzelbericht zu einem damaligen Gerät, aber er passt zur Technical Note, die Modbus als Zusatzschnittstelle beschreibt. Seine Einschränkung: Werte je Optimierer gibt es über Modbus nicht. Wer die einzelnen Module sehen will, bleibt (Stand seines Beitrags) bei der Cloud-Integration und ihren Modulstatistiken. Beides lässt sich nebeneinander einrichten.
Was SolarEdge selbst über Modbus sagt
Die SunSpec Implementation Technical Note von SolarEdge (Version 3.2, Juni 2025, hier als Kopie im Repository der Integration) ist trocken, aber sie enthält die Eckdaten:
- Modbus TCP ist ab Werk ausgeschaltet.
- Bei Wechselrichtern mit SetApp ist der Standard-Port 1502, bei Geräten mit LCD-Menü steht in derselben Note 502. Der Port lässt sich ändern.
- Die Geräte-ID des am Netzwerk hängenden Wechselrichters ist standardmäßig 1.
- Es wird genau eine Verbindung unterstützt. SolarEdge-Systeme kennen laut Note nur einen einzigen Modbus-Leader, entweder RTU oder TCP.
- Der TCP-Server hat eine Leerlaufzeit von zwei Minuten. Wer die Verbindung offen halten will, muss innerhalb von zwei Minuten eine Anfrage schicken.
- Die Antwortzeit für Lesen und Schreiben liegt laut Tabelle der Note unter 0,5 Sekunden.
Modbus TCP am Wechselrichter einschalten
Das Wiki von SolarEdge Modbus Multi beschreibt den Weg über SetApp so:
- Den roten Schalter am Wechselrichter für weniger als fünf Sekunden auf „P“ stellen. Das schaltet WLAN Direct ein.
- Mit dem Handy oder Laptop in das Netz des Wechselrichters gehen. Das Passwort steht seitlich am Gerät, auch als QR-Code.
- Im Browser
http://172.16.0.1öffnen und „Site Communication“ wählen. Dort lässt sich Modbus TCP aktivieren. Lädt die Adresse nicht, hilft der Blick auf das Standard-Gateway, das das Gerät mitteilt. - Bei mehreren Wechselrichtern nur am Leader, also dem Gerät mit Netzwerkanschluss, aktivieren.
Ältere HD-Wave-Geräte ohne SetApp haben das Menü am Gerät: Installer-Modus durch fünf Sekunden Drücken der OK-Taste, dann unter Communications, LAN Setup die Modbus-TCP-Option. Das Installer-Passwort steht im Wiki. Es ist nicht geheim, aber dass eine Anlage mit Netzanschluss ein bekanntes Standardpasswort trägt, ist ein weiterer Grund, die Menüs nur anzufassen, wenn man weiß, was dort steht.
Zwei Vorbereitungen noch, bevor Sie in Home Assistant weitermachen:
- Feste IP-Adresse: Der Blogger weist darauf hin, dass ein Zurücksetzen des Wechselrichters die Netzwerkeinstellung wieder auf DHCP stellen kann. Besser eine feste Zuweisung im Router, dann ist die Adresse in jedem Fall dieselbe.
- Firewall: Modbus TCP hat weder Anmeldung noch Verschlüsselung, alles läuft im Klartext, und wer den Port erreicht, kann lesen und, wenn Steuerung aktiv ist, auch Leistungsgrenzen setzen. Der Modbus-Port des Wechselrichters sollte nur vom Home-Assistant-Rechner erreichbar sein. Der Wechselrichter gehört also nicht ins Gäste-WLAN.
Die Integration: SolarEdge Modbus Multi
Home Assistant selbst kann SolarEdge nicht per Modbus lesen, hier hilft die Zusatzintegration SolarEdge Modbus Multi von WillCodeForCats. Stand 17. November 2026: Version 4.0.15 vom 16. November, 343 Sterne auf GitHub, verlangt Home Assistant 2025.11.0 oder neuer.
Die Installation hängt von Ihrer Home-Assistant-Version ab. Ab 2026.11 steht sie im neuen Marktplatz unter Einstellungen, Marktplatz („SolarEdge Modbus Multi“), davor über HACS. Wie der Umzug funktioniert, steht im Artikel zur HACS-Migration.
Die Integration kann laut README:
- 1 bis 32 Wechselrichter, je Wechselrichter bis zu drei Zähler und drei Speicher
- automatische Erkennung von Zählern, Speichern und Drei-Phasen-Wechselrichtern mit Synergy-Technik
- Abfragen lokal per Modbus TCP ohne Cloud
- Fehler- und Statussensoren
- Einrichtung, Optionen, Reparaturmeldungen und Neukonfiguration über die Oberfläche
Einrichten
Unter Geräte & Dienste die Integration „SolarEdge Modbus Multi“ hinzufügen. Zeroconf-Erkennung gibt es, aber meist tragen Sie die IP-Adresse selbst ein. Der voreingestellte Port ist 1502, die Geräte-ID 1.
Bei mehreren Wechselrichtern in einer Leader-Follower-Kette braucht jeder eine eigene ID, die Sie in der Geräte-ID-Liste eintragen: 1,2,3 oder 1-3, auch gemischt wie 1-3,5,10. Das Wiki warnt: Doppelte IDs stören das Monitoring bei SolarEdge nicht, aber Modbus funktioniert dann nicht. Die ID eines RS485-Zählers kollidiert dagegen nicht mit einer Wechselrichter-ID, wenn beide an verschiedenen RS485-Bussen hängen. Ab Werk hat ein SolarEdge-Zähler die ID 2.
Eine Verbindung heißt: Nichts anderes darf zugreifen
Das ist die häufigste Falle, und sie ist in der Technical Note begründet. Ein zweiter Zugriff, ob von einer weiteren Integration, einem Logger oder einem Grafana-Skript, bekommt „connection refused“. Das Wiki empfiehlt: Andere Integrationen, die eine Verbindung dauerhaft belegen, entfernen. Mehrere Instanzen von SolarEdge Modbus Multi gehen, wenn die Option „Close Connection After Polling“ aktiv ist, und wer ein Modbus-Proxy einsetzt, tut das auf eigene Verantwortung, denn getestet ist es nicht.
Optionen, die den Alltag bestimmen
Nach dem Anlegen erreichen Sie die Optionen über das Zahnrad am Hub. Wichtig sind:
- Abfrageintervall: Standard 300 Sekunden, einstellbar von 1 bis 86400. Wer schnell sein will, geht auf 10 oder 30 Sekunden. Zwischen 1 und 5 Minuten ist für das Energie-Dashboard in der Regel genug.
- Verbindung nach dem Abfragen schließen: Standardmäßig entscheidet die Bibliothek. Das Wiki warnt in den Known Issues, dass die Option „Keep Modbus Connection Open“ mit der Zeit zu Timeouts führen kann. Standard ist aus.
- Zähler automatisch erkennen: Standard an.
- Speicher automatisch erkennen: Standard aus, siehe unten.
- Anfrage-Timeout: im Wiki 3 Sekunden. Die Release-Notes zu Version 4.0.14 vom 14. November 2026 erhöhen den Standard auf 10 Sekunden.
Zähler und der Haken mit dem Funknetz
Wo ein Zähler hängt, entscheidet, was Sie berechnen können. Das Wiki nennt dazu zwei Einschränkungen:
- Zähler im Funknetz („SolarEdge Energy Net“ oder „Home Network“) tauchen über Modbus unter Umständen nicht auf. Verkabelt ist am zuverlässigsten, neuere Firmware kann es besser.
- Zähler mit doppelter Funktion in SetApp, etwa Produktion plus Export/Import, liefern über Modbus nur eine der beiden Funktionen. Das ist laut Wiki kein Fehler, sondern die Umsetzung von SolarEdge. Welche Funktion es ist, steht in den Geräteinformationen unter „Hardware“.
0x0 oder -0x8000. Das Wiki rät dann zum Neustart des Wechselrichters: Schalter P/1/0 auf 0, warten, bis die grüne LED blinkt, AC aus, LEDs prüfen, AC an, Schalter zurück auf 1.
Speicher: bei SolarEdge nicht selbstverständlich
Bei anderen Herstellern ist der Speicher einfach da, sobald er angeschlossen ist. Bei SolarEdge nicht.
Das Wiki schreibt in den Known Issues: Nicht alle Wechselrichter liefern Batteriedaten über Modbus, selbst wenn der Speicher in SetApp erkannt wird. Die Funktion kann von SolarEdge-Support ein- oder ausgeschaltet werden, und es gibt kein bekanntes Muster, welcher Wechselrichter sie hat. Das betrifft auch alle Steuerfunktionen, denn sie gehören zum selben Datensatz. Wer die Speichererkennung einschaltet und keine Batterie sieht, findet im Debug-Log IllegalAddress auf die Anfragen „Inverter X battery Y“. Das ist laut Wiki kein Fehler, sondern die gültige Antwort „kann ich nicht“.
Das Wiki verweist auf eine Diskussion (#63) und nennt zwei Ausgänge: Manche Nutzer konnten SolarEdge zum Freischalten bewegen, andere nicht. Der Ursprung ist das Issue #22 „Battery integration“ von April 2022 mit über 120 Kommentaren. Rechnen Sie also mit einer Supportanfrage, bevor Sie Zeit in Automationen stecken.
Zusätzlich gibt es den genormten Weg: Das SunSpec-Modell 713 (DER-Speicher) liefert auf den meisten Geräten den Ladestand, aber auch nur den. Mehrere Batterien erscheinen als ein einziger Wert, und ohne Batterie meldet das Modell immer 0 Prozent. Sinnvoll sind die proprietären Register nur mit Freischaltung.
Zähler, die zurückspringen
Die Known Issues nennen einen Fehler, der Statistiken zerstört: Bei Speichern von LG und BYD springen die Zähler für geladene und entladene Energie auf null, obwohl sie als lebenslange Zähler dokumentiert sind. SolarEdge Energy Bank meldet dagegen korrekt. Auch der SolarEdge Home Battery 48V ist als unzuverlässig bis zu einer Batterie-Firmware 3.3.9 genannt. Das Wiki sagt offen, dass es dafür keine Lösung in der Integration gibt, es sei ein Problem des Batteriecontrollers oder der Wechselrichter-Firmware. Optionen:
- „Allow Battery Energy to Reset“ erlaubt das Zurückspringen, Standard aus. Dann werden die betroffenen Entitäten „unavailable“, bis der Wert wieder den alten erreicht.
- „Update Cycles to Reset Battery Energy“ legt fest, nach wie vielen Abfragen ein Rücksprung akzeptiert wird.
- Nutzer berichten laut Wiki, die Batterieenergie mit einem Riemann-Summen-Helfer aus der Leistung zu errechnen.
Steuern: Speichermodi und Einspeisegrenze
Unter den Optionen gibt es die „Power Control Options“, getrennt für Speicher und für die Standortgrenze (Site Limit). Beide sind ab Werk aus. Das Wiki warnt in einer Deutlichkeit, die man selten liest: Die Funktionen können Verträge mit dem Netzbetreiber verletzen, die Abrechnung verändern, Zusatzgeräte wie Zähler voraussetzen und die Einstellungen von SolarEdge oder Installateur überschreiben. Die Autoren raten, vorher alle Originaleinstellungen zu notieren.
Speichersteuerung. Im Modus „Remote Control“ lassen sich Standardmodus und ein befristeter Befehlsmodus setzen, dazu Lade- und Entladegrenzen und die Reserve. Das Wiki führt auf:- Solar Power Only (Speicher aus)
- Charge from Clipped Solar Power (laden nur aus Überschuss über der Wechselrichtergrenze)
- Charge from Solar Power
- Charge from Solar Power and Grid
- Discharge to Maximize Export
- Discharge to Minimize Import (braucht Verbrauchszähler)
- Maximize Self Consumption (braucht Verbrauchszähler)
Schreibwerte bleiben übrigens im Gerät, auch wenn Sie die Integration entfernen. Das Wiki nennt das ausdrücklich unter „Removing the integration“.
Das Energie-Dashboard füllen
Das Energie-Dashboard braucht Energie in kWh, die Integration liefert zunächst vor allem Leistung. Das Wiki beschreibt auf der Seite „Template Sensors for Power and Energy“ den Umbau am Beispiel eines Wechselrichters mit Import/Export-Zähler:
- Solarproduktion: die DC-Leistung des Wechselrichters (
sensor.solaredge_i1_dc_power). - Verbrauch: AC-Leistung des Wechselrichters minus AC-Leistung des Zählers (
sensor.solaredge_i1_ac_powerminussensor.solaredge_m1_ac_power). - Netzbezug und Einspeisung als getrennte Template-Sensoren aus dem Vorzeichen der Zählerleistung.
- Daraus Energie per Integrationshelfer (Riemann-Summe, Methode „left“, Präfix k), den das Wiki im YAML für jeden Fluss vorgibt: Batterie laden und entladen, Netzbezug, Einspeisung, Solarerzeugung, Verbrauch.
Die Zuordnung der Sensoren im Dashboard selbst, also Netz, Solar, Batterie, steht im Artikel zum Energie-Dashboard. Wer zusätzlich einen Shelly-Zähler am Hausanschluss hat, schaut in den Artikel zum Shelly Pro 3EM.
Wenn plötzlich nichts mehr geht
Die Known Issues im Wiki sind die beste Fehlerliste. Die wichtigsten Muster:
| Symptom | Ursache laut Wiki | Gegenmittel |
|---|---|---|
| „Failed to connect“, Port 1502, nach Nacht ohne Änderung | Firmware-Update, Modbus-Server antwortet nicht mehr | Modbus in SetApp aus, speichern, wieder ein |
| Wie oben, ohne Zugriff auf SetApp | dasselbe | Hub in HA deaktivieren, Schalter auf Aus, Sicherung aus, 20 Sekunden warten, alles zurück |
| Verbindung hängt nach Erkennung | neuere Firmware hängt bei nicht unterstützten Registern statt „unsupported“ zu antworten | Option „Auto-Detect Additional Entities“ ausschalten |
| „connection refused“ | zweite Modbus-Verbindung | andere Integration oder Logger entfernen |
Speicher nicht gefunden, IllegalAddress | Batteriedaten im Wechselrichter nicht freigeschaltet | SolarEdge-Support fragen |
| Timeouts über die Zeit | Option „Keep Modbus Connection Open“ | ausschalten |
| Zähler zeigt Nullen | 0x0 oder -0x8000 vom Gerät | Wechselrichter neu starten |
Praktische Konsequenz: Das Firmware-Feld ist in der Integration eine Entität (sensor.solaredge_i1_version in einem der Berichte). Lassen Sie es sich im Dashboard anzeigen, dann sehen Sie beim nächsten Ausfall sofort, ob sich die Version geändert hat.
Vorsicht bei Updates der Integration
Die Release-Notes zu Version 4.0.12 vom 8. November 2026 enthalten einen seltenen Satz: Die Versionen 4.0.9, 4.0.10 und 4.0.11 wurden übersprungen, wegen zusammengesetzter Probleme aus Issue #1158. Dort berichtet ein Nutzer, 4.0.9 habe Batteriedaten, Zählerinformationen und Automationen zerstört. Er stellte aus einem Backup die Version 4.0.8 wieder her. Das Issue ist weiterhin offen.
Das Projekt veröffentlicht schnell, im November 2026 allein vier Versionen. Sichern Sie vor einem Update ein Backup, und wenn Ihre Heizungs- oder Speichersteuerung davon abhängt, warten Sie nach einer neuen Version ein paar Tage, bevor Sie nachziehen.
Die Alternative: binsentsu
Es gibt eine zweite, ältere Zusatzintegration, home-assistant-solaredge-modbus von binsentsu, 420 Sterne, letzte Version 2.3.0 vom 2. Juli 2026. Das Wiki von SolarEdge Modbus Multi weist darauf hin, dass sich Namen und Einstellungen bei einem Umstieg unterscheiden, weil sich die neuere Integration an den Bezeichnungen von SetApp orientiert. Beide gleichzeitig zu betreiben scheitert an der einen Verbindung. Wie viel Speichersteuerung die ältere Integration abdeckt, steht in deren Dokumentation.
Welcher Weg für welche Anlage
- Nur Ertrag sehen, ohne Eile: eingebaute Cloud-Integration mit API-Schlüssel. Einfach, aber im 15-Minuten-Takt und mit Tageslimit von 300 Anfragen.
- Einzelne Module beobachten: Cloud-Integration mit Benutzername und Passwort, Modulstatistiken. Modbus kennt keine Optimierer.
- Sekunden- bis Minutentakt, Überschussladen, Heizstab: SolarEdge Modbus Multi mit Modbus TCP. Fester Port 1502, feste IP, einzige Verbindung.
- Speicher ansteuern: SolarEdge Modbus Multi, aber zuerst prüfen, ob der Support die Batteriedaten freigeschaltet hat. Sonst bleibt nur der Ladestand aus Modell 713.
- Beides: Cloud-Integration und Modbus lassen sich zusammen betreiben, solange nur ein Modbus-Client existiert.
Einschätzung
Bei Fronius hat Home Assistant die Modbus-Anbindung in den Kern geholt, bei SolarEdge bleibt sie eine Zusatzintegration eines einzelnen Maintainers. Dafür ist das Projekt erstaunlich gut gepflegt: eine Version von dieser Woche, ein Wiki mit Fehlerliste, Bronze-Stufe der Home-Assistant-Qualitätsskala seit Version 4.0.13.
Das eigentliche Risiko liegt nicht in Home Assistant, sondern im Wechselrichter: Er aktualisiert sich über Nacht, und danach antwortet der Modbus-Server manchmal nicht mehr. Wer eine Speichersteuerung auf dieser Schnittstelle baut, sollte deshalb zwei Dinge mitbauen: eine Entität, die Alarm schlägt, wenn die Werte älter als ein paar Minuten sind, und einen Plan B, was die Anlage ohne Steuerung tut. Denn geschriebene Werte bleiben laut Wiki im Wechselrichter stehen, auch wenn Home Assistant längst nicht mehr antwortet.
Am unbequemsten ist etwas anderes: Ob Ihre Anlage überhaupt Batteriedaten und Steuerung über Modbus anbietet, entscheidet der SolarEdge-Support, nicht die Integration und nicht Sie. Wer mit dem Gedanken an eine Speichersteuerung einen SolarEdge kaufen will, sollte das vorher beim Installateur klären.