!Techniker montiert einen Wechselrichter an einer Außenwand
Im September 2021 fragte ein Nutzer namens Hoelli4C im Home-Assistant-Forum, wie man einen Sunny Home Manager 2.0 einbindet. Er hatte alles versucht, was die Oberfläche anbot. Home Assistant lief in Docker in einem anderen Subnetz, die Integration meldete „failed to connect“, auch nach einer Neuinstallation. Ein Raspberry Pi mit evcc im selben Netz wie der Home Manager las die Werte ohne Mühe. Hoelli4C vermutete, es liege am Multicast.
Was dann folgte, ist ein typischer Forumsverlauf. Über anderthalb Jahre fragten weitere Nutzer nach dem Stand, einer mit Synology-NAS meldete im Februar 2023 dasselbe „failed to connect“, egal welche Zugangsdaten er eintrug. Eine bestätigte Lösung steht in dem Thread bis heute nicht. Dabei lag Hoelli4C richtig, und die Zugangsdaten waren nie das Problem: Die eingebaute SMA-Integration von Home Assistant kann den Home Manager gar nicht abfragen. Das steht inzwischen ausdrücklich in der Dokumentation.
Bei SMA hängt fast alles davon ab, welches Gerät Sie haben und über welchen Weg es spricht. Davon gibt es vier, und wer den falschen wählt, sucht stundenlang nach einem Passwortfehler, der keiner ist.
Welches SMA-Gerät spricht welche Sprache
SMA hat über die Jahre mehrere Schnittstellen eingeführt, ohne die alten abzuschaffen. Für Home Assistant sind diese vier relevant:
- Webconnect: die Weboberfläche älterer und aktueller Sunny-Boy- und Sunny-Tripower-Wechselrichter, die man im Browser über die IP-Adresse aufruft. Darauf setzt die eingebaute Integration.
- ennexOS: das neuere Betriebssystem, unter anderem auf dem Sunny Tripower X und dem Data Manager M. Es hat eine eigene Oberfläche und eine eigene Programmierschnittstelle.
- Speedwire: das hauseigene Netzwerkprotokoll von SMA auf UDP-Port 9522, den SMA laut seiner Speedwire-Dokumentation bei der IANA registriert hat. Der Energy Meter und der Sunny Home Manager 2.0 senden ihre Messwerte darüber an eine Multicast-Adresse.
- Modbus TCP: die Industrieschnittstelle, die viele Wechselrichter haben, die aber oft erst eingeschaltet werden muss.
Die eingebaute Integration: gut für Webconnect, sonst nichts
Die Integration SMA Solar gibt es seit Home Assistant 0.36 und sie wird in der Oberfläche unter Geräte & Dienste eingerichtet. Sie fragt die Weboberfläche des Wechselrichters lokal ab, Cloud und Sunny Portal sind nicht beteiligt. Gefragt werden Host oder IP-Adresse, ob SSL verwendet und geprüft werden soll, die Benutzergruppe (user oder installer) und das Passwort.
Die Einschränkung steht in der Dokumentation in einem Satz: Geräte mit ennexOS, etwa die Tripower-X-Serie, werden nicht unterstützt, und ebenso wenig „alle Energy Meter“, ausdrücklich einschließlich SMA Energy Meter und Sunny Home Manager. Dazu kommt der Hinweis, dass nicht jeder Wert, den das Gerät kennt, in der zugrunde liegenden Bibliothek pysma abgebildet ist.
Für einen Sunny Boy oder Sunny Tripower mit Webconnect ist sie trotzdem der erste Versuch. Sie liefert Leistung, Spannung je String, Tagesertrag und Gesamtertrag, bei Hybridgeräten Ladestand und Leistung der Batterie.
Der Umweg, den viele übersehen: Zählerwerte über den Wechselrichter
In der Sensorliste der Dokumentation gibt es einen Block „Energy Meter via Inverter“. Ist ein SMA Energy Meter oder Home Manager mit dem Wechselrichter gekoppelt, reicht der Wechselrichter dessen Werte durch. Home Assistant bekommt sie dann als Sensoren mit dem Präfix metering_, darunter:
metering_power_absorbedundmetering_power_suppliedin Watt (Bezug und Einspeisung im Moment)metering_total_absorbedundmetering_total_yieldin kWh (die Zählerstände für Bezug und Einspeisung)- Strom, Spannung und Wirkleistung je Phase
metering_-Sensoren auf und zeigen sie plausible Zahlen, ist der Weg frei. Auch die Dokumentation der Zusatzintegration, um die es gleich geht, nennt das als Ausweg, wenn der Home Manager selbst nicht erreichbar ist.
Verbindung fehlgeschlagen: die drei üblichen Ursachen
Falscher Benutzer. Im Juni 2026 versuchte ein Nutzer namens Wwo82 im Forum der simon42-Community, seinen Tripower X einzubinden. Er postete Logs voller Fehler: Login bei/dyn/login.json fehlgeschlagen, keine Sitzungs-ID, Token-Anfrage mit Code 400, Modbus auf Port 502 nicht erreichbar. Vier Wochen später schrieb er die Auflösung: Der Installateur hatte für den Wechselrichter einen anderen Benutzernamen vergeben. „Mit dem richtigen Benutzer hat es dann auf Anhieb geklappt.“ Die Dokumentation der eingebauten Integration gibt denselben Rat in höflicherer Form: Wer nicht weiß, ob user oder installer, soll den Installateur fragen.
Zu viele Sitzungen. Die Weboberfläche eines SMA-Wechselrichters lässt nur eine begrenzte Zahl gleichzeitiger Anmeldungen zu. Eine offizielle Zahl dafür findet sich nicht. Der Autor des Node-RED-Moduls für Webconnect schreibt, bei seinem Gerät seien es vier gewesen. Im Januar 2021 beschrieb ein Nutzer im Home-Assistant-Forum, dass nach zu vielen Verbindungen weder Home Assistant noch der Browser auf den Wechselrichter kamen. Ein anderer Nutzer antwortete, er trenne in diesem Fall Netz und Module über den Drehschalter, warte etwa zwei Minuten und schalte alles wieder zu, danach öffne sich die Oberfläche wieder. Wer parallel evcc, Solaranzeige, ioBroker und Home Assistant auf denselben Wechselrichter loslässt, braucht sich über ausgesperrte Logins also nicht zu wundern. Ein Abfrageweg pro Gerät, der Rest holt sich die Daten aus Home Assistant, ist die ruhigere Lösung.
Das falsche Gerät. Siehe Hoelli4C. Steht in der IP-Adresse ein Home Manager, Energy Meter oder ein Gerät mit ennexOS, kann die eingebaute Integration nicht verbinden, egal mit welchem Passwort.
SMA Devices Plus: ein Weg für fast alles
Für alles, was die eingebaute Integration nicht kann, hat sich in den Foren die Zusatzintegration SMA Devices Plus von littleyoda durchgesetzt. Sie wird über HACS installiert und baut auf pysma-plus auf, einem Fork der Bibliothek, die auch die eingebaute Integration nutzt. Laut README spricht sie Webconnect, ennexOS (derzeit etwa Tripower X), Speedwire für ältere Geräte und das Energy-Meter-Protokoll, also Energy Meter 10 und 20 sowie den Sunny Home Manager 2.
Drei Hinweise aus der Projektdokumentation sparen Zeit:
- Für Wechselrichter zuerst Webconnect oder ennexOS wählen. Speedwire ist für ältere Geräte gedacht, die Variante Speedwire V2 nennt der Autor eine Notlösung, wenn alles andere scheitert.
- Nicht jede Entität wird automatisch aktiviert. Fehlt ein Wert, lohnt der Blick in die deaktivierten Entitäten des Geräts.
- Einen Sensor für den aktuellen Hausverbrauch gibt es nicht. Die FAQ schlägt einen Template-Sensor vor: ohne Batterie ist das Erzeugung plus Netzbezug minus Einspeisung.
Ein Detail für die Wartung: Im Log von Wwo82 stand eine Warnung von Home Assistant, dass die Integration das Gerätemodell als Zahl statt als Text übergibt, und dass dies „in Home Assistant 2026.12.0“ nicht mehr funktionieren wird. Ob das in der aktuellen Version der Integration behoben ist, prüfen Sie vor dem Dezember-Update im Log unter Einstellungen, System, Protokolle. Steht die Warnung noch da, lohnt ein Blick in die Issues des Projekts, bevor Sie Home Assistant aktualisieren.
Sunny Home Manager 2.0: das Multicast-Problem
Der Home Manager hat keine Weboberfläche, die man abfragen könnte. Er sendet seine Messwerte von sich aus, laut Community-Quellen einmal pro Sekunde, an die Multicast-Adresse 239.12.255.254 auf UDP-Port 9522. Wer zuhört, bekommt sie. Wer nicht im selben Netzsegment sitzt, bekommt nichts, und genau daran scheitern die meisten Einrichtungen. Hoelli4C mit seinem Docker-Container im anderen Subnetz ist der Musterfall.
Die Dokumentation von SMA Devices Plus hat dafür eine eigene Seite, SHM2 Multicast. Die dort genannten typischen Ursachen:
- Home Manager und Home Assistant liegen in verschiedenen Subnetzen oder VLANs.
- Home Assistant läuft in Docker, und die Multicast-Pakete werden nicht in den Container weitergereicht. UDP-Port 9522 muss durchkommen.
- Ein Managed Switch filtert die Pakete.
- Schlechte Verkabelung.
- Im Sunny Portal prüfen, ob der Home Manager auf Multicast steht. Die Unicast-Felder müssen leer sein. Steht dort eine Adresse, schickt der Home Manager seine Werte nur noch an die eingetragenen Empfänger.
- Netzwerkschnittstelle in Home Assistant prüfen. Bei mehreren Netzwerkkarten oder VLANs unter Einstellungen, System, Netzwerk die Schnittstelle zum SMA-Netz aktivieren, gegebenenfalls die automatische Konfiguration abschalten, danach neu starten.
- Gegenprobe mit einem zweiten Empfänger. Die Doku empfiehlt dafür das Add-on SMA Energy Meter von kellerza, das die Messwerte per MQTT an Home Assistant schickt. Es braucht Home Assistant OS und einen eingerichteten MQTT-Broker. Kommen auch dort keine Werte an, liegt das Problem im Netz und nicht in der Integration. Das Add-on bietet zusätzlich eine Legacy-Version an, ausdrücklich für den Fall, dass die anderen Versionen keine Multicast-Pakete empfangen.
- Switch umkonfigurieren oder tauschen. Managed Switches mit IGMP-Snooping können Multicast blockieren, ein unmanaged Switch zwischen Home Manager und Home Assistant schafft Klarheit.
- Auf Unicast umstellen. Dann trägt man im Sunny Portal die Adressen der Empfänger ein, also auch Home Assistant. Der Haken laut Doku: Das funktioniert nur, wenn alle Geräte, die die Werte brauchen, in die Liste passen. Wechselrichter, Wallbox, Home Assistant und evcc sind schon vier, und mehr als drei Einträge machen den Weg laut Autor unpraktikabel.
Bleibt alles ohne Erfolg, hilft der Umweg über den Wechselrichter aus dem vorigen Abschnitt. Die Zählerstände kommen dann als metering_-Sensoren vom Wechselrichter statt direkt vom Home Manager.
Modbus: für Bastler und für den Tripower X
Modbus TCP empfehlen viele Foren für ältere Wechselrichter. Es ist auch der Weg mit den meisten Umwegen. Der Modbus-Server ist oft nicht aktiv und muss in den Geräteeinstellungen eingeschaltet werden. Der Haken steht in einem Beitrag aus dem bereits zitierten Thread vom Januar 2021: Der Nutzer hätte gern Modbus verwendet, konnte es aber ohne Installateur-Zugang nicht aktivieren. Wer seinen Installateur ohnehin anrufen muss, um den Benutzernamen zu erfahren, kann ihn bei der Gelegenheit gleich nach dem Modbus-Server fragen.
Im langen Forums-Thread MODBUS data from SMA Inverter hat sich eine Grundkonfiguration eingespielt: Hub mit type: tcp, IP des Wechselrichters, Port 502, Geräteadresse 3, Register 30775 für die aktuelle Leistung als 32-Bit-Wert. Mehrere Nutzer berichten dort, dass sie den Datentyp je nach Firmware zwischen vorzeichenlos und vorzeichenbehaftet wechseln mussten. Die Registerlisten gibt SMA modellabhängig heraus, für ennexOS-Geräte in einem eigenen Dokument, der SMA Modbus Technischen Information für ennexOS.
Beim Tripower X greifen die alten Listen nicht. Ein Nutzer im Thread zum Tripower X schrieb, das Gerät unterstütze die alten Modbus-Register mit Ausnahme von 30775 nicht. Andere berichten, dass nach einem Firmware-Update SunSpec-Modbus funktionierte: Modbus-Server in der Weboberfläche einschalten, Port 502, Geräteadresse 126. Wer einen Tripower X hat, ist mit SMA Devices Plus über ennexOS meist schneller am Ziel, Modbus bleibt die Rückfallebene, falls die Integration einen Wert nicht kennt.
Welcher Weg für welche Anlage
- Sunny Boy oder Sunny Tripower mit Webconnect, ohne Home Manager: eingebaute Integration SMA Solar. Prüfen, ob
metering_-Sensoren erscheinen. - Webconnect-Wechselrichter plus Home Manager 2.0: Wechselrichter über die eingebaute Integration oder SMA Devices Plus, Home Manager über SMA Devices Plus. Bei der Einrichtung die Variante „SMA Energy Meter/Sunny Home Manager“ wählen, so der Rat des Autors im simon42-Thread. Vorher klären, ob Home Assistant im selben Netz hängt wie der Home Manager.
- Tripower X oder anderes ennexOS-Gerät: SMA Devices Plus mit ennexOS. Modbus/SunSpec nur ergänzend.
- Ältere Geräte ohne Webconnect: SMA Devices Plus mit Speedwire, mit den bekannten Aussetzern. Alternativ Modbus, wenn der Installateur ihn freischaltet.
- Home Assistant in Docker oder einem anderen VLAN: erst das Netz lösen (Host-Netzwerk für den Container oder Multicast-Weiterleitung), dann die Integration.
Einschätzung
Bei SMA scheitert die Einrichtung selten an Home Assistant, sondern an einer falschen Annahme über das Gerät. Der Home Manager sieht aus wie ein Gerät, das man per IP-Adresse abfragt, ist aber ein Sender, der ins Netz ruft und nicht antwortet. Der Tripower X sieht aus wie ein SMA-Wechselrichter, spricht aber eine andere Sprache als seine Vorgänger. Und der Benutzer, mit dem man sich anmelden will, hat oft der Installateur angelegt, nicht man selbst.
Wer diese drei Punkte vor dem ersten Klick klärt, braucht für eine typische Anlage mit Wechselrichter und Home Manager zwei Integrationen und keine einzige Zeile YAML. Wer sie überspringt, landet in einem Forumsthread, der seit 2021 auf eine Antwort wartet.