!Elektriker arbeitet in einer Garage an einem Solar-Wechselrichter
Im März 2022 hatte ein Nutzer namens OlliK einen neuen Fronius Symo Gen24 Plus samt Smart Meter im Keller und wollte ihn in Home Assistant sehen. Er kam im Home-Assistant-Forum nicht über den ersten Schritt hinaus. Die Integration fragte nach der IP-Adresse, er trug sie ein, mit und ohne http://, auch den Hostnamen, und bekam jedes Mal „Failed to connect“. Im Browser öffnete sich die Weboberfläche des Wechselrichters unter derselben Adresse anstandslos.
Das Debug-Log zeigte, dass Home Assistant zwar etwas erreichte, aber weder Logger- noch Wechselrichter-Informationen abfragen konnte. Ein Helfer namens farmio, der die Fronius-Integration betreut, tippte auf eine abgeschaltete Schnittstelle. OlliK musste erst beim Installateur das Kundenpasswort erfragen. Wenig später schrieb er: „Rootcause was indeed a deactivated Solar API.“
Dieser Fall ist bei Fronius der häufigste, und er hat eine einfache Ursache, die in keiner Montageanleitung auf Seite eins steht. Der Rest ist inzwischen deutlich leichter als noch vor einem Jahr, denn seit Home Assistant 2026.9 kann die eingebaute Integration auch Modbus und damit den Speicher steuern.
Zwei Schnittstellen mit unterschiedlichen Aufgaben
Fronius-Wechselrichter sprechen lokal zwei Sprachen, und für Home Assistant sind beide wichtig.
- Solar API: eine JSON-Schnittstelle über HTTP, die Fronius seit Jahren in seine Datamanager und Gen24-Geräte einbaut. Sie liefert Leistungsfluss, Erträge, Zählerwerte und Speicherdaten. Laut Dokumentation der Home-Assistant-Integration ist sie ausschließlich lesend.
- Modbus TCP mit SunSpec: die Industrieschnittstelle auf Port 502, die laut derselben Dokumentation die meisten Fronius-Geräte zusätzlich anbieten. Sie liefert Werte je MPP-Tracker, die in der Solar API fehlen, und sie ist der einzige Weg, auf dem Home Assistant am Wechselrichter etwas einstellen kann.
Schritt eins: Solar API einschalten
Die Integrationsdokumentation sagt es in einem Satz: Bei Gen24-Geräten, die mit Firmware 1.14.1 oder neuer ausgeliefert wurden, muss die Solar API in der Weboberfläche aktiviert werden. Bei älteren Geräten ist sie in der Regel schon an. Im ioBroker-Forum wiesen Nutzer schon bei Erscheinen der 1.14er-Firmware darauf hin, dass die Schnittstelle laut Changelog ab Werk auf aus steht. Laut Rückmeldungen in den Foren schaltet ein Update eines bereits laufenden Geräts sie nicht ab, betroffen sind also vor allem neu installierte Anlagen.
Der Schalter liegt in der Weboberfläche unter Kommunikation, Solar API. OlliK fand ihn dort als „Communication via Solar API“. Zwei Dinge sollten Sie außerdem vorher erledigen:
- Feste IP-Adresse: Die Dokumentation verlangt eine statische IP oder eine feste DHCP-Zuweisung im Router. Wechselt die Adresse, verliert Home Assistant den Wechselrichter.
- Gegenprobe vom richtigen Gerät: farmio riet im selben Thread, die Schnittstelle direkt von dem Rechner abzufragen, auf dem Home Assistant läuft, nicht vom eigenen Laptop. Ein
curl http://zeigt sofort, ob eine Antwort kommt. Ein zweiter Nutzer im Thread, dessen Raspberry Pi in einem anderen VLAN hing als der Wechselrichter, fand auf diese Weise den Fehler: ein Tippfehler in seiner Firewall-Regel./solar_api/GetAPIVersion.cgi
Was die eingebaute Integration über die Solar API liefert
Die Integration gibt es seit Home Assistant 0.96. Sie unterstützt alle Wechselrichter mit eingebautem Datamanager oder externem „Datalogger Web“, die die Solar API in Version 0 oder 1 anbieten, darunter Gen24, Symo, Symo Hybrid, Primo, Galvo, Eco, Tauro und Verto. Angeschlossene Geräte kommen mit: der Fronius Smart Meter oder ein S0-Zähler, der Ohmpilot und der Speicher.
Die Dokumentation unterscheidet mehrere Gerätetypen mit eigenen Aktualisierungsintervallen:
- Leistungsfluss der Anlage, alle 10 Sekunden: PV-Leistung, Netzbezug oder Einspeisung (positiv heißt Einspeisung, negativ Bezug), Hauslast, Lade- und Entladeleistung des Speichers, Eigenverbrauchsquote und Autarkie. Bei Gen24-Geräten mit Notstrom zeigt ein Sensor zusätzlich an, ob die Anlage gerade im Notstrombetrieb läuft.
- Wechselrichter, jede Minute: Tages- und Gesamtertrag, Leistung, Strom, Spannung, Frequenz und Status. Den Jahresertrag liefert ein Gen24 nicht.
- Zähler, jede Minute: Leistung, Strom und Spannung je Phase.
- Speicher, jede Minute: Strom, Spannung, Zustand, Zyklenzahl, Kapazität.
Modbus in der eingebauten Integration seit 2026.9
Lange war Modbus bei Fronius ein Bastelprojekt. Im Januar 2021 veröffentlichte ein Nutzer namens Soly im Forum eine ausführliche Anleitung für den Symo Gen24 Plus über Modbus TCP. Er begründete den Umweg mit zwei Dingen: Er wollte das Laden der Batterie dynamisch steuern, was die Fronius-Integration damals nicht konnte, und er wollte Werte alle ein bis zwei Sekunden abfragen. Seine Konfiguration las den Hauptzähler unter Geräteadresse 200, den Wechselrichter unter Adresse 1, Register 40091 und 40097 als Gleitkommawerte, und bastelte daraus ein Dutzend Template-Sensoren. Er musste sie zweimal umschreiben, weil sich das Modbus-Format in Home Assistant mit Version 2021.7 und noch einmal mit 2022.4 änderte.
Dieser Aufwand ist für die meisten Anlagen vorbei. Der Changelog von Home Assistant 2026.9 enthält drei Einträge von farmio: Modbus TCP mit SunSpec für die Fronius-Integration (#179995), Sollwerte als Zahlen-Entitäten (#180241) und Schalter zur Steuerung (#180261). Der Artikel zum Release 2026.9 hat das kurz erwähnt. Die beiden Folgeversionen haben nachgelegt, dazu gleich mehr.
Modbus am Wechselrichter einschalten
Modbus ist optional. Ist es aus, legt die Integration einfach keine Modbus-Entitäten an, der Rest läuft weiter. Sie prüft laut Dokumentation jede Stunde erneut, Entitäten erscheinen also von selbst, sobald der Wechselrichter antwortet.
- Gen24, Tauro, Verto: In der Weboberfläche unter Kommunikation, Modbus den Modbus-TCP-Server einschalten.
- Geräte mit Datamanager (etwa ältere Symo): unter Einstellungen, Modbus die Datenausgabe auf TCP stellen. Ein Datamanager bedient alle Wechselrichter seines SolarNet-Rings.
Was Modbus zusätzlich liefert
Je MPP-Tracker gibt es Leistung und Energie, Strom und Spannung sind vorhanden, aber standardmäßig deaktiviert. Seit 2026.11 legt die Integration die Tracker als eigene Untergeräte an (#188230), seit 2026.10 auch bei Wechselrichtern mit mehr als vier Eingängen (#182305). Dazu kommen ein Gesamtzähler für die reine PV-Energie und bei Hybridgeräten wie dem Gen24 mit Batterie zwei Zähler für geladene und entladene Energie.
Die Dokumentation ist an einer Stelle bemerkenswert ehrlich. Der Energiezähler je Tracker verhält sich nicht bei allen Geräten gleich. Ein Gen24 liefert dort die Lebensenergie jedes Strangs auf der Gleichstromseite, die deshalb einige Prozent über dem Wechselstromzähler liegt. Ein älterer SnapINverter liefert denselben Wert wie den Gesamtertrag. Deshalb behauptet der Sensor seit einer Korrektur im September (#181016) im Namen nicht mehr, ein DC-Wert zu sein. Welche Variante Ihr Gerät liefert, sehen Sie durch einen Vergleich der beiden Entitäten.
Den Wechselrichter steuern
Schreiben muss am Gerät erst erlaubt werden. In der Dokumentation heißt der Schalter „Inverter control via Modbus“, er liegt im selben Modbus-Menü. Solange er aus ist, legt die Integration gar keine Steuer-Entitäten an, statt welche, die beim Benutzen scheitern. Nach dem Einschalten die Integration neu laden.
Dann erscheinen auf der Geräteseite unter Konfiguration:
- AC-Leistungsbegrenzung in Prozent der Nennleistung, mit eigenem Schalter
- Lade- und Entladeleistungsgrenze der Batterie in Prozent, je mit Schalter
- Minimale Batteriereserve, unter die nicht entladen wird
- Netzladen der Batterie als eigener Schalter
Batterie zwangsladen
Seit 2026.11 (#185435, eingereicht von elmars) dürfen die Batteriegrenzen negativ sein, von minus 100 bis plus 100 Prozent. Ein negativer Wert kehrt die Richtung um: Eine Entladegrenze von minus 100 Prozent lädt die Batterie mit voller Leistung, eine Ladegrenze von minus 50 Prozent entlädt sie mit mindestens halber Leistung. So dokumentiert es laut Home Assistant auch Fronius.
Für Nachtladen mit günstigem Tarif zeigt die Dokumentation eine Automation, die um 2 Uhr die Entladegrenze auf minus 100 setzt und Netzladen einschaltet, um 6 Uhr alles zurück. Zwei Bedingungen: Beide Grenzen zusammen dürfen nicht unter 0 liegen, sonst lehnt der Wechselrichter ab. Und das Laden aus dem Netz muss zusätzlich am Gen24 unter Gerätekonfiguration, Komponenten, Batterie erlaubt sein. Je nach Modell und Firmware braucht diese Einstellung den Techniker-Zugang, also wieder einen Anruf beim Installateur. Wie Sie den Börsenpreis als Auslöser in Home Assistant holen, steht im Artikel zum Strompreis-Sensor.
Das Energie-Dashboard richtig belegen
Die Integrationsdokumentation gibt eine klare Zuordnung für das Energie-Dashboard:
- Solarproduktion ohne Batterie: „Energy total“ jedes Wechselrichters.
- Solarproduktion mit Batterie: eine Riemann-Summe über die PV-Leistung der Anlage („SolarNet Power photovoltaics“), weil der Wechselrichterzähler beim Hybridgerät auch Batterieentladung enthält.
- Batterie: Riemann-Summen über Lade- und Entladeleistung. Die Modbus-Gesamtzähler der Batterie sind Gleichstromwerte und stimmen deshalb nicht exakt mit den Summen überein.
- Netz: Sitzt der Smart Meter am Einspeisepunkt, „Energy real consumed“ und „Energy real produced“ des Zählers. Sitzt er im Verbrauchszweig, Netzbezug und Einspeisung aus dem Leistungsfluss per Riemann-Summe in Energie umrechnen.
- Ohmpilot: „Energy consumed“ als Einzelgerät.
Wann sich fronius_modbus aus HACS noch lohnt
Vor der Core-Lösung hatte sich die Zusatzintegration fronius_modbus von redpomodoro verbreitet. Der Autor stellte sie im Dezember 2024 im Forum vor, ausdrücklich für den Gen24 mit Speicher und Smart Meter. farmio antwortete dort als Betreuer der Core-Integration und bot an, die Sache gemeinsam in den Kern zu bringen. redpomodoro wollte erst die Speichersteuerung stabil haben. Es kam am Ende so, dass farmio den Modbus-Teil 2026 selbst in Core baute.
Die Zusatzintegration bleibt eine Option, wenn Sie lieber in Watt statt in Prozent arbeiten. Sie bietet Steuermodi wie Laden aus dem Netz, Entladen ins Netz, Entladen sperren oder Laden sperren, jeweils mit Leistungsangaben in Watt. Das README nennt einige Bedingungen:
- Im Modbus-Menü des Wechselrichters Steuerung erlauben und als SunSpec-Modelltyp „int + SF“ wählen.
- Zeitgesteuertes Laden und Entladen in der Weboberfläche abschalten, sonst kommen sich beide Steuerungen in die Quere.
- Gen24-Firmware mindestens 1.34.6-1, sonst sei das Laden der Batterie unter Umständen begrenzt.
- Netzladen sei laut Autor hardwareseitig offenbar auf effektiv 50 Prozent begrenzt.
Wer SolarEdge, Huawei oder Sungrow über HACS-Modbus-Integrationen parallel betreibt, sollte das wissen. Seit 2026.11 läuft die Installation solcher Zusatzintegrationen über den neuen eingebauten Marktplatz, siehe den Artikel zur HACS-Migration.
Und der Wattpilot?
Die Wallbox ist ein eigenes Gerät mit eigener Schnittstelle und taucht in der Fronius-Integration nicht auf. Wie sie lokal angebunden wird, steht im Artikel zum Fronius Wattpilot in Home Assistant.
Welcher Weg für welche Anlage
- Symo, Primo oder Gen24 ohne Batterie, nur Anzeigen: eingebaute Integration über die Solar API. Modbus einschalten, wenn Sie Werte je Strang sehen wollen.
- Gen24 mit Batterie, Steuerung gewünscht: eingebaute Integration mit Modbus und erlaubter Steuerung, ab Home Assistant 2026.11 für Zwangsladen. Die Option zum Zurücknehmen der Grenzen einschalten.
- Steuerung lieber in Watt und mit fertigen Modi: fronius_modbus aus HACS, mit dem Wissen um pymodbus-Konflikte und mögliche Brüche bei Updates.
- Abfrage im Sekundentakt oder Register, die keine Integration kennt: eigene Modbus-YAML nach dem Muster von Soly, mit der aktuellen Registerdokumentation von Fronius. Soly warnte damals ausdrücklich davor, ältere Registerlisten zu verwenden.
Einschätzung
Fronius war in Home Assistant lange ein Hersteller mit zwei Gesichtern: eine Lese-Schnittstelle, die bequem und begrenzt war, und eine Modbus-Schnittstelle, für die man Registerlisten und Geduld brauchte. Seit 2026.9 liegen beide in derselben Integration, gebaut von demselben Menschen, der 2022 OlliK den Hinweis auf die abgeschaltete Solar API gab. Das ist bei Wechselrichtern ungewöhnlich, bei SMA oder Sungrow führt der Weg zu voller Kontrolle weiterhin über Zusatzsoftware.
Die Hürde liegt bei Fronius heute weniger in Home Assistant als im Wechselrichter selbst. Solar API, Modbus-Server, Steuerfreigabe und Netzladen sind vier getrennte Schalter, einige davon hinter dem Techniker-Zugang. Wer seinen Installateur ohnehin wegen des Kundenpassworts anrufen muss, sollte die ganze Liste auf einmal durchgehen. Das spart den zweiten Anruf, und den dritten.