Huawei Solar Smart-Home-Integration, kostenlos und Open Source

Huawei SUN2000 Wechselrichter, LUNA2000 Akkus und Zähler, lokal oder Cloud.

• Veröffentlicht von gboulvin
• Geräte
• Version 1.0.0
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Überwachen und steuern Sie Ihre Huawei-Solaranlage mit Gladys: SUN2000-Wechselrichter, LUNA2000-Akkus und den am Wechselrichter angeschlossenen Stromzähler DTSU666-H / DDSU666-H.

Zwei Verbindungen stehen zur Verfügung, einzeln oder gemeinsam:

Verbindung	Wie	Aktualisierung	Befehle
Lokal	Modbus TCP über den SDongle, einen EMMA oder das WLAN des WR	alle 30 s oder mehr	ja
Cloud	FusionSolar-Northbound-API	höchstens alle 5 min	nein

Mit beiden wählt der Schalter Lokale Verbindung bevorzugen die bevorzugte Verbindung; fällt sie aus, übernimmt die andere und das Geräte-Badge zeigt einen orangefarbenen Punkt.

Erfordert Gladys 5.1.0 oder neuer.

1. Lokale Verbindung (empfohlen)

1. Öffnen Sie in der FusionSolar-App die Inbetriebnahme Ihres Wechselrichters (Installateur-Login), dann Einstellungen > Kommunikationskonfiguration > Dongle-Parameter > Modbus TCP und wählen Sie Aktivieren (uneingeschränkt).
2. Vergeben Sie dem SDongle eine feste IP-Adresse im Router.
3. Tragen Sie in Gladys ein:
   • Adresse Wechselrichter / SDongle: die IP des SDongle, z. B. 192.168.1.50;
   • Modbus-Port: 502 (SDongle / EMMA), 6607 (WLAN des Wechselrichters);
   • Modbus-Unit-ID: meist 1 (SDongle), 0 (WLAN des Wechselrichters).
4. Klicken Sie auf Verbindung testen.

Gut zu wissen:

• der SDongle akzeptiert nur wenige gleichzeitige Modbus-Clients: liest ihn bereits ein anderes Smart-Home-System, behalten Sie ein Intervall von 60 s oder mehr bei;
• einige Befehle (Einspeisebegrenzung, Start / Abschaltung des Wechselrichters) können je nach Firmware Installateurrechte erfordern: die Szenen-Aktion antwortet dann mit success: false und der Meldung des Wechselrichters.

2. Cloud-Verbindung (FusionSolar)

Die Cloud nutzt die FusionSolar-Northbound-API, die ein eigenes API-Konto benötigt: Ihr normales App-Login funktioniert nicht.

1. Bitten Sie Ihren Installateur, in FusionSolar ein API-Konto anzulegen (System > Unternehmensverwaltung > Northbound-Verwaltung), mit Zugriff auf Ihre Anlage.
2. Tragen Sie in Gladys ein:
   • FusionSolar-Server: die Adresse, die Sie im Browser verwenden, z. B. https://eu5.fusionsolar.huawei.com;
   • API-Benutzername und API-Passwort (System-Code).
3. Klicken Sie auf Verbindung testen.

Huawei begrenzt die Anzahl der API-Aufrufe: die Cloud wird höchstens alle 5 Minuten gelesen, unabhängig vom Aktualisierungsintervall.

3. Geräte anlegen

Öffnen Sie den Reiter Erkennung der Integration und legen Sie die gefundenen Geräte an:

• Huawei SUN2000… (Wechselrichter): Solarerzeugung (W), Gesamterzeugung (kWh), heutige Erzeugung (kWh), PV-Eingangsleistung (W), Innentemperatur, Status;
• Huawei power meter (Zähler): Netzleistung (W, positiv bei Netzbezug, negativ bei Einspeisung), Bezugs- / Einspeiseleistung (W) und Zählerstände (kWh), Hausverbrauch (W), Spannung, Strom;
• Huawei LUNA2000 battery (Akku): Ladestand (%), Lade- / Entladeleistung (W), insgesamt geladen / entladen (kWh, lokal), Restenergie (kWh, lokal), Status, Betriebsmodus (mit der lokalen Verbindung in Gladys wählbar: Eigenverbrauch maximieren, Nutzungszeit, Volleinspeisung).

Die Erzeugungs- und Netzzählerstände speisen das Energie-Monitoring von Gladys.

4. Szenen

Auslöser (Kategorie Integrationen):

• Wechselrichterstatus geändert: die Erzeugung startet, stoppt, der Wechselrichter meldet eine Störung… Variablen: status, previous_status, production_power.
• Netzaustausch geändert: das Haus beginnt, Überschuss einzuspeisen, Strom aus dem Netz zu beziehen, oder ist ausgeglichen (Totband in der Konfiguration, standardmäßig 100 W). Ideal, um bei Überschuss einen Warmwasserbereiter oder eine Wallbox zu starten. Variablen: flow, previous_flow, grid_power.
• Akkustand überschritten: der Akku steigt über oder fällt unter eine Schwelle, in 10-%-Schritten. Variablen: direction, level, battery_level.

Aktionen (lokale Verbindung, außer der letzten):

• Akku-Ladung oder -Entladung erzwingen (Leistung, Dauer), Erzwingung beenden;
• Betriebsmodus des Akkus setzen;
• Netzeinspeisung begrenzen: unbegrenzt, Nulleinspeisung oder Grenze in Watt;
• Wechselrichter starten oder abschalten;
• Solaranlage auslesen: stellt production_power, daily_production, house_power, grid_power, battery_level, battery_power und inverter_status den nächsten Aktionen bereit.

Jeder Befehl liefert success und message: reagieren Sie mit einer Bedingung auf success auf einen Fehler.

5. Dashboard-Widgets

• Solarübersicht: Erzeugung, Haus, Netz und Akku live, Tageskurve, Wechselrichterstatus, heutige Erzeugung, Netzaustausch und Verbindung.
• Akkusteuerung: Akkustand, Lade- und Entladeleistung, Betriebsmodus und Schaltflächen, um Laden oder Entladen zu erzwingen, zu beenden oder den Modus zu ändern.

Fehlerbehebung

• Cannot connect to …:502: Modbus TCP ist am Dongle nicht aktiviert, die IP ist falsch oder der Dongle ist durch einen anderen Client belegt.
• illegal data address: das Register existiert bei Ihrem Modell nicht (z. B. kein Akku): die Integration ignoriert es beim Lesen.
• FusionSolar login refused: prüfen Sie Serveradresse, API-Benutzername und System-Code; ein normales Konto funktioniert nicht.
• rate limit reached: warten Sie einige Minuten und verwenden Sie dieses API-Konto nur in einer einzigen Integration.

Konfigurationseinstellungen

Diese Einstellungen fragt Huawei Solar in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Erste Schritte	section	Nein	Verbinden Sie Ihre Huawei-Anlage lokal (Modbus TCP über SDongle, EMMA oder das WLAN des Wechselrichters) und/oder über die FusionSolar-Cloud (Northbound-API-Konto). Mit beiden wählt der Schalter unten die bevorzugte Verbindung, die andere dient als Ersatz. Befehle (Akku, Einspeisebegrenzung) erfordern die lokale Verbindung.
Lokale Verbindung (Modbus TCP)	section	Nein	Aktivieren Sie Modbus TCP am SDongle in der FusionSolar-App (Inbetriebnahme > Einstellungen > Kommunikationskonfiguration > Dongle-Parameter > Modbus TCP: Aktivieren (uneingeschränkt)). Port 502 über den SDongle; Port 6607 und Unit-ID 0 über das WLAN des Wechselrichters.
Adresse Wechselrichter / SDongle	string	Nein	IP-Adresse oder Hostname im lokalen Netzwerk. Leer lassen, um nur die Cloud zu nutzen.
Modbus-Port	number	Nein
Modbus-Unit-ID	number	Nein	Meist 1 über den SDongle, 0 über das WLAN des Wechselrichters.
Cloud-Verbindung (FusionSolar)	section	Nein	Nutzt die FusionSolar-Northbound-API: Bitten Sie Ihren Installateur um ein API-Konto (System > Unternehmensverwaltung > Northbound-Verwaltung). Ihr normales App-Login funktioniert hier nicht. Die Daten werden höchstens alle 5 Minuten aktualisiert.
FusionSolar-Server	string	Nein	Die Adresse, mit der Sie sich im Browser bei FusionSolar anmelden, z. B. https://eu5.fusionsolar.huawei.com oder https://intl.fusionsolar.huawei.com.
API-Benutzername	string	Nein
API-Passwort (System-Code)	secret	Nein
Erweiterte Einstellungen	section	Nein	Ausleseintervall der Messwerte und Totband des Szenen-Auslösers „Netzaustausch geändert“.
Aktualisierungsintervall (s)	number	Nein	Wie oft die Anlage ausgelesen wird, in Sekunden (lokal mindestens 30 s, über die Cloud mindestens 300 s).
Netz-Totband (W)	number	Nein	Unterhalb dieser Leistung gilt der Netzaustausch als ausgeglichen: vermeidet ständiges Auslösen um null.

So installierst du Huawei Solar in Gladys

1. Öffne in Gladys Integrationen: Huawei Solar erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/gboulvin/gladys-huawei-solar:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-Huawei-Solar.

Huawei Solar benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Huawei Solar ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂