SolaX Power Smart-Home-Integration, kostenlos und Open Source
SolaX-Wechselrichter über den lokalen WLAN-Dongle: Solarproduktion, Netz, Batterie, Zähler.
Veröffentlicht von guim31
- Geräte
- Version 1.0.2
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration liest deine SolaX-Wechselrichter (X1, X3, X-Hybrid, Boost, Mini, Smart, Hybrid G3/G4, Ultra, MIC PRO, Lite LV und den baugleichen Q.VOLT von Qcells) in deinem lokalen Netzwerk, über den WLAN- oder LAN-Dongle des Wechselrichters (Pocket WiFi). Jeder Wechselrichter wird ein Gladys-Gerät mit seiner Solarproduktion, seinen Energiezählern, dem Netzaustausch, der Batterie der Hybride und dem Zustand des Wechselrichters. SolaX Cloud ist eine Option für Dongles, die lokal nicht antworten.
Nur lesend: Die Integration schickt dem Wechselrichter nie etwas anderes als eine Anfrage nach seinen Echtzeitdaten.
Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Die Dekodierung folgt den echten Antworten, die mit der von Home Assistant genutzten Bibliothek
solaxveröffentlicht wurden, lief aber nie an einem echten Wechselrichter. Erzähl im Gladys-Forum oder in den GitHub-Issues, was du siehst.
Diese Integration ist nicht mit SolaX Power verbunden (not affiliated with SolaX Power).
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer (5.2 für die Energieverfolgung des Produktionszählers).
- Ein SolaX-Wechselrichter mit seinem Pocket WiFi (V2 oder V3) oder Pocket LAN, im selben Netzwerk wie Gladys. Gib dem Dongle in deinem Router eine feste IP-Adresse.
- Die Registriernummer des Dongles (10 Zeichen, auf dem Dongle aufgedruckt, auch in der SolaX-Cloud-App sichtbar): Neuere Firmwares nutzen sie als Passwort der lokalen Schnittstelle.
- Nur für SolaX Cloud: ein Konto auf solaxcloud.com und sein API-Token (Service → API auf der neuen Seite, Support → Third-party ecology auf der alten).
Konfiguration
Öffne Integrationen → SolaX Power → Konfiguration:
| Feld | Was du einträgst |
|---|---|
| IP-Adressen der Dongles | Eine Adresse pro Wechselrichter, durch Kommas getrennt (192.0.2.10, 192.0.2.11). Ein Port ist möglich (192.0.2.10:8080). |
| Passwörter der Dongles | Die Registriernummer jedes Dongles, in der Reihenfolge der Adressen. Ein einzelner Wert gilt für alle. Leer für alte Firmwares. |
| Wechselrichtermodell | Automatisch (empfohlen): Das Modell wird aus der Antwort des Dongles erkannt. Erzwinge es nur, wenn die Messwerte falsch wirken. |
| Lokale Aktualisierung | Alle 10, 15, 30 (Standard) oder 60 Sekunden. |
| SolaX-Cloud-API-Token | Nur für die Cloud-Option. |
| Registriernummern | Die Registriernummer jedes über SolaX Cloud zu lesenden Dongles, durch Kommas getrennt. |
| Cloud-Aktualisierung | Alle 5 (Standard), 10, 15 oder 30 Minuten. |
| Sprache der Texte | Namen der Funktionen (beim Hinzufügen des Geräts festgelegt), Wechselrichterzustand, Szenentexte. Standard: Französisch. |
Klicke dann auf Verbindung testen: Für jeden Wechselrichter zeigt es das gefundene Modell oder was schiefgeht. Die gefundenen Wechselrichter erscheinen im Tab Entdecken: Füge sie zu Gladys hinzu.
Kontingent von SolaX Cloud. SolaX erlaubt 10 Aufrufe pro Minute und 10.000 pro Tag pro Token, und der Dongle sendet seine Daten alle 5 Minuten. Die Integration liest deshalb jeden Cloud-Wechselrichter höchstens alle 5 Minuten, hält 6,5 Sekunden zwischen zwei Aufrufen ein (nie mehr als 10 pro Minute, egal wie viele Wechselrichter) und verlängert den Abstand, wenn die Wechselrichter 9.000 Aufrufe pro Tag überschreiten würden. Ein lokal und in der Cloud konfigurierter Wechselrichter wird nur lokal gelesen.
Was jedes Gerät zeigt
Ein Gerät pro Wechselrichter, benannt SolaX <Modell> <Ende der Seriennummer>. Die Funktionen
hängen davon ab, was das Modell meldet; eine einmal gezeigte Funktion verschwindet nie.
| Funktion | Gladys-Typ | Hinweise |
|---|---|---|
| PV-Leistung | Produktionsleistung (W) | Summe der Strings. |
| PV-Leistung String 1, 2, 3 | Produktionsleistung (W) | Wenn der Wechselrichter mehrere Strings hat. |
| Produktion heute | Tagesproduktion (kWh) | Vom Wechselrichter um Mitternacht zurückgesetzt. |
| Gesamtproduktion | Produktionszähler (kWh) | Der kumulierte Zähler der Energieverfolgung. Nie niedriger veröffentlicht. |
| AC-Ausgangsleistung | Leistung (W) | Negativ bei einem Hybrid, der seine Batterie aus dem Netz lädt. |
| Netz (Bezug +, Einspeisung −) | Netzleistung (W) | Braucht den SolaX-Zähler (Stromwandler). Positiv bei Bezug. |
| Netzbezugszähler, Netzeinspeisezähler | Netzzähler (kWh) | Die Zählerstände des SolaX-Zählers. |
| Batteriestand | Batteriestand (%) | Hybride. |
| Batterie-Ladeleistung, Entladeleistung | Batteriespeicher (W) | Eine der beiden ist jederzeit 0. |
| Batterietemperatur | Gerätetemperatur (°C) | Wenn gemeldet. |
| Batterie-Lade-Index, Entlade-Index | Batteriespeicher-Zähler (kWh) | Wenn gemeldet. |
| Wechselrichtertemperatur | Gerätetemperatur (°C) | Wenn gemeldet. |
| Wechselrichterzustand | Text | Normal, Wartet, Fehler, Notstrom (EPS), Standby... Wenn gemeldet. |
| Online | Binär | 0, wenn der Dongle nicht antwortet (bei den meisten Wechselrichtern nachts). |
Das Gerätesymbol zeigt lokal, Cloud oder nicht erreichbar. Werte gehen nur an Gladys, wenn sie sich ändern, und sonst mindestens alle 6 Stunden.
Widget
Solarübersicht (Dashboard → Widget hinzufügen → SolaX Power): PV-Leistung, Produktion heute, Netzaustausch und Batterie als Live-Kacheln, die 24-Stunden-Kurve von Produktion und Netz und eine kurze Liste: Einspeisung oder Bezug, Laden oder Entladen, Wechselrichterzustand, Uhrzeit der letzten Messung. Wähle den Wechselrichter in den Einstellungen des Widgets (unnötig, wenn es nur einen gibt).
Szenenauslöser
Wechselrichterzustand geändert: löst aus, wenn der Wechselrichter den Zustand wechselt (zum
Beispiel von Normal zu Fehler, oder bei einem Stromausfall zu Notstrom (EPS)). Filter: der
Wechselrichter und die neuen Zustände, die dich interessieren. Variablen: status (Code:
normal, fault, eps...), previous_status, status_label (der Zustand in der Sprache der
Konfiguration). Nur Modelle, die einen Zustand melden, können ihn auslösen (X3 Hybrid G4, X3
Ultra, X3 MIC PRO G2 und jeder über SolaX Cloud gelesene Wechselrichter).
Szenenaktion
Solarbilanz abrufen: gibt die letzte Messung eines Wechselrichters zurück, ohne den Dongle
erneut zu fragen: summary (ein Satz wie „Solar: gerade 3,1 kW, heute 12,4 kWh. Netz:
einspeisung 830 W. Batterie: 86 %.“), online, pv_power, yield_today, grid_power,
battery_level.
Szenenbeispiele
- Abendbilanz: jeden Tag um 21:00 → Solarbilanz abrufen → eine Nachricht mit
{{summary}}senden. - Wechselrichterfehler: Wechselrichterzustand geändert, neuer Zustand Fehler oder Dauerhafter Fehler → eine Benachrichtigung „Der Wechselrichter meldet einen Fehler: {{status_label}}“ senden.
- Überschuss nutzen: wenn Netz (Bezug +, Einspeisung −) unter −1500 W fällt → die Steckdose des Warmwasserspeichers einschalten; wieder ausschalten, wenn der Wert über 0 W steigt.
- Stromausfall: Wechselrichterzustand geändert, neuer Zustand Notstrom (EPS) → die nicht notwendigen Geräte ausschalten und den Haushalt warnen.
Unterstützte Modelle
Erkannt am type, den der Dongle meldet: X-Hybrid (erste Generation), X1/X3 G3 (Hybrid, Fit, MIC,
Air, Boost, Mini), X1-Boost/Mini (Typen 4, 18, 22), X1-Smart, X1-Hybrid G4, X3-Hybrid G3 mit
Firmware 2.034, X3-Hybrid G4 und Q.VOLT HYB-G3-3P, X3-MIC PRO G2, X3-Ultra, X1-Lite LV. Die
Ladestation X3-EVC ist kein Wechselrichter und wird abgelehnt.
Fehlerbehebung
- „Keine Antwort“: Prüfe die Adresse, ob Gladys und der Dongle im selben Netzwerk sind und ob der Dongle Strom hat: Die meisten Wechselrichter schalten den Dongle nachts ab, das Gerät zeigt dann bis zum Morgen Offline.
- „Abgelehnt: Prüfe das Passwort“: Gib die Registriernummer des Dongles ein (nicht die Seriennummer des Wechselrichters).
- „Modell nicht erkannt“: Eröffne ein Issue mit der Ausgabe von
node scripts/probe.mjs <Adresse> [Registriernummer](nur lesend; die Registriernummer wird in der Ausgabe maskiert). - Falsche Werte: Erzwinge das Modell in der Konfiguration und melde es.
- Firmware 2.034 und neuer: Manche Dongles verweigern das lokale Netzwerk. Die Integration sendet den Header, den diese Firmwares erwarten; klappt es trotzdem nicht, nutze SolaX Cloud.
- Mehr Details in den Protokollen: Setze
LOG_LEVEL=debugfür die Integration.
Grenzen
- Nur lesend: Keine Einstellung des Wechselrichters (Betriebsmodus, Laden, Einspeisebegrenzung) wird geändert, mit Absicht.
- Manche Dongles antworten lokal gar nicht: Nutze SolaX Cloud, bestenfalls alle 5 Minuten aktualisiert.
- Die Netzwerte brauchen den SolaX-Zähler; ohne ihn bleiben sie bei 0.
- Die Halbstundenproduktion des Gladys-Energie-Dashboards berechnet der Kern aus dem Produktionszähler; Gladys 5.2.1 verknüpft sie für externe Integrationen noch nicht automatisch.
- Die Bedeutung mancher Register stammt aus der Community, nicht von SolaX: Ein Modell, das in den Beispielen fehlt, kann einige Werte falsch lesen.
Konfigurationseinstellungen
Diese Einstellungen fragt SolaX Power in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Lokale Verbindung | section | Nein | Gladys liest den Wechselrichter über seinen SolaX-WLAN- oder LAN-Dongle (Pocket WiFi) im lokalen Netzwerk. Gib dem Dongle in deinem Router eine feste IP-Adresse. Nur lesend: Am Wechselrichter wird nie etwas geändert. |
| IP-Adressen der Dongles | string | Nein | Eine Adresse pro Wechselrichter, durch Kommas getrennt. |
| Passwörter der Dongles | secret | Nein | Die auf jedem Dongle aufgedruckte Registriernummer (10 Zeichen), in der Reihenfolge der Adressen. Für alte Firmwares leer lassen. |
| Wechselrichtermodell | select | Nein | Wird automatisch erkannt. Erzwinge es nur, wenn die Messwerte falsch wirken. |
| Lokale Aktualisierung | select | Nein | |
| SolaX Cloud (optional) | section | Nein | Nur für Dongles, die lokal nicht antworten. Das API-Token findest du unter Service, API auf solaxcloud.com. SolaX erlaubt 10 Aufrufe pro Minute und 10.000 pro Tag, und der Dongle sendet alle 5 Minuten: höchstens eine Messung alle 5 Minuten. |
| SolaX-Cloud-API-Token | secret | Nein | |
| Registriernummern | string | Nein | Die Registriernummer jedes über SolaX Cloud zu lesenden Dongles, durch Kommas getrennt. |
| Cloud-Aktualisierung | select | Nein | |
| Anzeige | section | Nein | |
| Sprache der Texte | select | Nein | Namen der Funktionen (beim Hinzufügen des Geräts festgelegt), Wechselrichterzustand und Szenentexte. |
So installierst du SolaX Power in Gladys
- Öffne in Gladys Integrationen: SolaX Power erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-solax:1.0.2) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-solax.
SolaX Power 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
SolaX Power 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 guim31 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