Beschreibung
Logikbaustein, der die Echtzeitdaten eines SolaX-Wechselrichters aus der SolaX Cloud liest. Grundlage ist die SolaX Cloud User API V2.0 (POST /api/v2/dataAccess/realtimeInfo/get).
- Gerät
- Gira X1
- Version
- 1.0.0
- Lizenz
- Ein Schlüssel je X1 (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
Einrichtung
- In der SolaX Cloud anmelden und unter Service > API die Token-ID kopieren. Dort steht auch die API-Adresse (z. B.
https://global.solaxcloud.com). - Die Registriernummer steht auf dem WLAN-/LAN-Stick des Wechselrichters bzw. in der SolaX Cloud unter Gerät > Wechselrichter in der Spalte „Registration No.“ (10 Zeichen).
- Den Eingang „Trigger“ zyklisch mit
1belegen, z. B. über einen Zeitgeber.
Intervall: Die SolaX Cloud aktualisiert die Daten etwa alle 5 Minuten. Häufiger abzufragen bringt keine neuen Werte. SolaX erlaubt höchstens 10 Abfragen pro Minute und 10.000 pro Tag. Empfohlen sind 1 bis 5 Minuten.
Parameter
| Parameter | Bedeutung |
|---|---|
| Token-ID | Aus der SolaX Cloud, Service > API |
| Registriernummer (WLAN-/LAN-Stick) | Registriernummer des Kommunikationsmoduls |
| API-Adresse (ausgeblendet) | Vorgabe https://global.solaxcloud.com. Nur ändern, wenn SolaX unter Service > API eine andere Adresse nennt. Ohne https:// wird es ergänzt |
| Lizenzschlüssel | Schlüssel für diesen X1, siehe „Lizenz“ |
Ausgänge
| Ausgang | Einheit | Feld der API |
|---|---|---|
| AC-Leistung (W) | W | acpower |
| Ertrag heute (kWh) | kWh | yieldtoday |
| Ertrag gesamt (kWh) | kWh | yieldtotal |
| Einspeiseleistung Netz (W) | W | feedinpower |
| Einspeisung gesamt (kWh) | kWh | feedinenergy |
| Netzbezug gesamt (kWh) | kWh | consumeenergy |
| Leistung Zähler 2 (W) | W | feedinpowerM2 |
| Wechselrichterstatus | Text | inverterStatus, z. B. „Normal“, „Standby“, „Behebbarer Fehler“ |
| Batterie-Ladezustand (%) | % | soc |
| Batterieleistung (W) | W | batPower |
| Abfrage erfolgreich | Bool | 1 nach einer erfolgreichen Abfrage, 0 bei einem Fehler |
| PV-Leistung gesamt (W) | W | Summe aus powerdc1 bis powerdc4 (ausgeblendet) |
| PV-Leistung String 1 (W) … String 4 (W) | W | powerdc1 bis powerdc4 (ausgeblendet) |
| Batteriestatus | Text | batStatus: Normal, Störung, Getrennt (ausgeblendet) |
| Wechselrichtertyp | Text | inverterType, z. B. „X3-Hybrid-G4“ (ausgeblendet) |
| Statuscode Wechselrichter | Zahl | inverterStatus als Zahl, z. B. 102 (ausgeblendet) |
| Temperatur Wechselrichter (°C) | °C | temperature (ausgeblendet) |
| Letzte Übertragung | Text | uploadTime, Zeitpunkt der letzten Daten des Wechselrichters in der Cloud (ausgeblendet) |
| Lizenzstatus, Debug | Text | Lizenzprüfung, Fehler der letzten Abfrage (leer bei Erfolg) |
Liefert SolaX einen Wert nicht (z. B. Batteriewerte bei Geräten ohne Speicher), bleibt der Ausgang unverändert.
Ausgeblendete Parameter und Ausgänge lassen sich im GPA (Gira Projekt Assistent) am Baustein einblenden.
Fehlerverhalten
Bei einem Fehler bleiben die Werte auf dem letzten Stand, „Abfrage erfolgreich“ geht auf 0 und „Debug“ nennt den Grund:
| Debug | Ursache |
|---|---|
| Token-ID fehlt / Registriernummer fehlt | Parameter leer, es wird nicht abgefragt |
| Keine Verbindung zur SolaX Cloud | Kein Internet, falsche API-Adresse oder Zeitüberschreitung (10 s) |
| SolaX Cloud antwortet mit HTTP … | Serverfehler oder falsche API-Adresse |
| Token-ID ungültig oder ohne Berechtigung (Code 1001) | Token-ID prüfen |
| Parameter ungültig, Registriernummer prüfen (Code 1002) | Registriernummer falsch geschrieben |
| Keine Berechtigung für diese Registriernummer (Code 1003) | Registriernummer gehört nicht zum Konto der Token-ID |
| Keine Daten gefunden, Registriernummer prüfen oder Gerät offline (Code 2002) | Registriernummer falsch oder Gerät offline |
| Abfrage fehlgeschlagen (Code …) | Sonstiger Fehler, mit Meldung von SolaX (z. B. zu viele Abfragen) |
Lizenz
Der Lizenzschlüssel wird im GPA im Parameter „Lizenzschlüssel“ eingetragen. Der Baustein prüft ihn beim Start auf dem X1, offline und gebunden an die MAC-Adresse des X1. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses X1. Ohne gültigen Schlüssel fragt der Baustein nichts ab. In der Simulation des GPA am PC läuft er ohne Lizenzprüfung, damit sich Logikblätter testen lassen.
Läuft eine Testlizenz ab, ignoriert der Baustein ab dem nächsten Trigger alle Abfragen, bis ein neuer Schlüssel eingetragen ist. Die Ausgänge bleiben auf dem letzten Stand. Den Schlüssel erhältst du beim Kauf über smolabs.de.
Verwendetes Icon: https://www.flaticon.com/de/kostenlose-icons/photovoltaik Photovoltaik Icons erstellt von Khoirul Huda – Flaticon
Changelog
Version 1.0.0
- Erste Version.
Rezensionen
Es gibt noch keine Rezensionen.