Beschreibung
Logikbaustein, der die Echtzeitdaten eines SolaX-Wechselrichters aus der SolaX Cloud liest. Er löst den freien Baustein „Solax“ ab. Grundlage ist die SolaX Cloud User API V2.0 (POST /api/v2/dataAccess/realtimeInfo/get).
- Gerät
- Gira HomeServer
- Version
- 0.1.0
- Lizenz
- Ein Schlüssel je HomeServer (MAC-Adresse), dauerhaft nutzbar
- Thema
- Energie
Hinweis zur Schnittstelle: Der Baustein nutzt die Schnittstelle der SolaX Cloud. Ändert der Anbieter sie oder stellt sie ein, kann der Baustein eingeschränkt oder gar nicht mehr funktionieren, bis er angepasst ist. Wir passen ihn nach Möglichkeit an, einen Anspruch darauf gibt es nicht.
Anleitung
Besonderheiten beim HomeServer
- „Abfrage erfolgreich“ ist
0/1. HTTPS läuft direkt über Python (urllib2), nicht über curl.
- Statt Parametern gibt es Eingänge mit Startwert. Auswahllisten des X1 sind Zahlen, Ja/Nein-Werte sind
0und1. - Der Lizenzschlüssel ist der letzte Text-Eingang. Ein neuer Wert an diesem Eingang wird sofort geprüft.
- Eine Prüfung des Schlüssels im Editor und eine Simulation gibt es nicht, der HomeServer prüft immer.
Funktionen und Anschlüsse
Logikbaustein von SMoLabs, der die Echtzeitdaten eines SolaX-Wechselrichters aus der SolaX Cloud liest (SolaX Cloud User API V2.0, POST /api/v2/dataAccess/realtimeInfo/get).
Einrichtung: In der SolaX Cloud anmelden und unter Service > API die Token-ID kopieren. Dort steht auch die API-Adresse. Die Registriernummer steht auf dem WLAN-/LAN-Stick des Wechselrichters. E1 zyklisch mit einem Wert ungleich 0 belegen, z. B. über einen Zeitgeber. SolaX erlaubt höchstens 10 Abfragen pro Minute und 10.000 pro Tag.
Liefert SolaX einen Wert nicht (z. B. Batteriewerte bei Geräten ohne Speicher), bleibt der Ausgang unverändert. Bei einem Fehler bleiben die Werte auf dem letzten Stand, „Abfrage erfolgreich“ geht auf 0 und „Debug“ nennt den Grund (Token-ID oder Registriernummer fehlt, keine Verbindung, HTTP-Fehler, Fehlercodes 1001 bis 2002 der SolaX Cloud).
Eingänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | E1 Trigger | 0 | Ungleich 0: startet die Abfrage. Die SolaX Cloud aktualisiert etwa alle 5 Minuten, empfohlen sind 1 bis 5 Minuten. |
| 2 | E2 Token-ID | „“ | Token-ID aus der SolaX Cloud unter Service > API. |
| 3 | E3 Registriernummer (WLAN-/LAN-Stick) | „“ | Registriernummer (10 Zeichen) des WLAN-/LAN-Sticks, auch in der SolaX Cloud unter Gerät > Wechselrichter in der Spalte „Registration No.“. |
| 4 | E4 API-Adresse | „https://global.solaxcloud.com“ | API-Adresse laut SolaX Cloud unter Service > API, Vorgabe https://global.solaxcloud.com. Ohne Schema wird https:// angenommen. |
| 5 | E5 Lizenzschlüssel | „“ | Lizenzschlüssel für diesen HomeServer (von smolabs.de). Ohne gültigen Schlüssel bleibt der Baustein untätig. |
Ausgänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | A1 AC-Leistung (W) | 0 | acpower, AC-Leistung in W. |
| 2 | A2 Ertrag heute (kWh) | 0 | yieldtoday, Ertrag heute in kWh. |
| 3 | A3 Ertrag gesamt (kWh) | 0 | yieldtotal, Ertrag gesamt in kWh. |
| 4 | A4 Einspeiseleistung Netz (W) | 0 | feedinpower, Einspeiseleistung ins Netz in W. |
| 5 | A5 Einspeisung gesamt (kWh) | 0 | feedinenergy, Einspeisung gesamt in kWh. |
| 6 | A6 Netzbezug gesamt (kWh) | 0 | consumeenergy, Netzbezug gesamt in kWh. |
| 7 | A7 Leistung Zähler 2 (W) | 0 | feedinpowerM2, Leistung Zähler 2 in W. |
| 8 | A8 Wechselrichterstatus | „“ | inverterStatus als Text, z. B. „Normal“, „Standby“, „Behebbarer Fehler“. |
| 9 | A9 Batterie-Ladezustand (%) | 0 | soc, Batterie-Ladezustand in %. |
| 10 | A10 Batterieleistung (W) | 0 | batPower in W. |
| 11 | A11 Abfrage erfolgreich | 0 | 1 nach einer erfolgreichen Abfrage, 0 bei einem Fehler. |
| 12 | A12 PV-Leistung gesamt (W) | 0 | Summe aus powerdc1 bis powerdc4 in W. |
| 13 | A13 PV-Leistung String 1 (W) | 0 | powerdc1 in W. |
| 14 | A14 PV-Leistung String 2 (W) | 0 | powerdc2 in W. |
| 15 | A15 PV-Leistung String 3 (W) | 0 | powerdc3 in W. |
| 16 | A16 PV-Leistung String 4 (W) | 0 | powerdc4 in W. |
| 17 | A17 Batteriestatus | „“ | batStatus: Normal, Störung, Getrennt. |
| 18 | A18 Wechselrichtertyp | „“ | inverterType, z. B. „X3-Hybrid-G4“. |
| 19 | A19 Statuscode Wechselrichter | 0 | inverterStatus als Zahl, z. B. 102. |
| 20 | A20 Temperatur Wechselrichter (°C) | 0 | temperature, Temperatur des Wechselrichters in °C. |
| 21 | A21 Letzte Übertragung | „“ | uploadTime, Zeitpunkt der letzten Daten des Wechselrichters in der Cloud. |
| 22 | A22 Lizenzstatus | „“ | Ergebnis der Lizenzprüfung, z. B. „Lizenz gültig (2026-000123)“. |
| 23 | A23 Debug | „“ | Fehler der letzten Abfrage, leer bei Erfolg. |
Lizenz
Der Lizenzschlüssel wird am letzten Text-Eingang des Bausteins eingetragen. Der Baustein prüft ihn auf dem HomeServer, offline und gebunden an die MAC-Adresse des HomeServers. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses HomeServers. Ohne gültigen Schlüssel bleibt der Baustein untätig. Den Schlüssel erhältst du beim Kauf über smolabs.de. Ein Schlüssel für den X1 schaltet keinen HomeServer-Baustein frei und umgekehrt.
Changelog
Version 0.1.0
- Erste Version für den HomeServer auf Basis der X1-Bausteine | SMoLabs.
Rezensionen
Es gibt noch keine Rezensionen.