Lokales, ausschließlich lesendes Auslesen kompatibler SolarEdge-Wechselrichter und der am Wechselrichter eingebundenen SolarEdge-Zähler über Modbus TCP. Der Baustein läuft vollständig auf dem Gira HomeServer 4; erforderlich sind Experte und HomeServer-Firmware 4.13.
Inbetriebnahme
- Experten-Projekt sichern. Die Datei 10887_BFSW_SolarEdge_SunSpec_v1.0.0.hslz über den Logikbaustein-Import importieren. Sie enthält Baustein und diese Hilfe. Die vorhandene ID 10887 wird aktualisiert; E1–E12 und A1–A57 behalten ihre Nummern und Typen.
- Am SolarEdge-Wechselrichter Modbus TCP/SunSpec aktivieren. IP-Adresse, tatsächlich eingestellten TCP-Port und Unit-ID notieren. Häufig wird Port 1502 verwendet; maßgeblich ist die Gerätekonfiguration.
- E1 zunächst auf 0 setzen, Projekt übertragen und A57 im Logik Online-Test lesen. Die dort ermittelte Adresse mit der tatsächlichen Ethernet-MAC des HomeServers abgleichen.
- Eine SolarEdge-Lizenz für diese HomeServer-MAC erzeugen. Lizenzierte MAC an E11 und den vollständigen Lizenzschlüssel an E12 eintragen.
- E2 bis E7 einstellen. E9 auf 1 setzen, wenn der erste eingebundene SolarEdge-Zähler der Netzübergabezähler ist. E10 legt die Leistungsrichtung fest. Danach E1 auf 1 setzen und Projekt erneut übertragen.
- A55 muss 1 anzeigen. A1 bestätigt gültige Wechselrichter-Kernwerte, A41 die aktuelle Netzleistung. Leistung, Ertrag und Netzrichtung mit der SolarEdge-Anzeige vergleichen.
Geräteabfrage, Hilfeimport sowie 7-Tage-Test- und Dauerlizenz wurden auf Anwender-HomeServern erfolgreich geprüft. Version 1.0.0 ist für den produktiven Einsatz freigegeben.
Lizenzierung
Die Lizenz ist an SolarEdge SunSpec und die tatsächliche HomeServer-MAC gebunden. Das bloße Eintragen einer fremden MAC schaltet den Baustein nicht frei: Er ermittelt lokale Ethernet-MAC-Adressen und prüft zusätzlich die digitale Signatur. Eine Anker-Lizenz wird absichtlich abgelehnt.
Wählbar sind eine 7-Tage-Testlizenz und eine Dauerlizenz. Die Testzeit beginnt bei der Ausstellung und setzt eine korrekte HomeServer-Systemzeit voraus. Beide gelten für beliebig viele Instanzen auf demselben HomeServer. Ohne gültige Lizenz erfolgen keine Modbus-Abfragen; A56/A57 bleiben zur Diagnose verfügbar. Neue MH2.-Schlüssel haben bis zu 540 Zeichen; vorhandene MH1.-Dauerlizenzen bleiben gültig.
Gerätekompatibilität
Die belastbare Grenze ist das vom Gerät gemeldete SunSpec-Modell, nicht allein der Produktname. Der Baustein akzeptiert Wechselrichtermodelle 101, 102 und 103 mit der standardisierten Länge 50. Unbekannte Zwischenmodelle werden anhand ihrer gemeldeten Länge übersprungen. Eingebundene Zähler werden als Modelle 201–204 dynamisch gefunden; dadurch bleiben verschobene Zähleradressen, etwa bei Synergy, nutzbar.
| Gerät/Familie | Profil | Status | Hinweis |
|---|---|---|---|
| SolarEdge SE17K | 103 | Hardware bestätigt | AC-/DC-Werte, Gesamtertrag, Zählerwerte sowie 7-Tage-Test- und Dauerlizenz wurden am Anwendergerät erfolgreich geprüft. |
| Klassische dreiphasige SolarEdge-Wechselrichter, z. B. SE3K bis SE33.3K | 103 erwartet | Protokollseitig unterstützt | Freigabe gilt, wenn das Gerät tatsächlich Modell 103/Länge 50 über Modbus TCP liefert. Einzelne Artikelnummern und Firmwarestände sind nicht hardwaregetestet. |
| Einphasige SolarEdge-Wechselrichter einschließlich HD-Wave-Varianten | 101 erwartet | Protokollseitig unterstützt | Nicht vorhandene Phasenkanäle werden unterdrückt. Hardwaretest je Baureihe offen. |
| Split-Phase-Varianten für entsprechende Märkte | 102 erwartet | Protokollseitig unterstützt | Dritter Phasenkanal wird unterdrückt. Hardwaretest offen. |
| Dreiphasige Synergy-Wechselrichter | 103, zusätzlich 160 | Grundwerte/Zähler vorbereitet | Modell 160 wird derzeit nicht als eigene Einheit ausgewertet, aber korrekt übersprungen. Zähler werden deshalb trotz verschobener Adressen gesucht. Synergy-Einzelwerte fehlen. |
| Home Hub / StorEdge / Hybridgeräte | 101 oder 103 möglich | Bedingt | Nur allgemeine Wechselrichterwerte, sofern das Standardprofil geliefert wird. Batterie, Backup, Ladezustand und Speicherfluss werden nicht ausgelesen. |
| Mehrere Wechselrichter über Leader oder Commercial Gateway | je Unit-ID | Bedingt | Je erreichbarer Wechselrichter-Unit-ID eine eigene Bausteininstanz verwenden. Diese Topologie ist noch nicht am HomeServer geprüft. |
| SolarEdge Energy Meter am Wechselrichter | 201–204 | Unterstützt | Bis zu drei in der SunSpec-Kette sichtbare Zähler sind auswählbar. Das Gerät muss am gewünschten Messpunkt konfiguriert sein. |
| TerraMax und abweichende neue Plattformen | nicht bestätigt | Nicht freigegeben | Nicht allein wegen des Markennamens kompatibel. Erst nach Register- und Gerätetest freigeben. |
| Leistungsoptimierer, Batterien, EV Charger, Smart-Energy-Geräte | kein Profil 101–103 | Nicht unterstützt | Benötigen eigene Registerprofile bzw. separate Bausteine. |
Verkaufsangabe: Aktuell als „getestet mit SolarEdge SE17K“ anbieten. Weitere Geräte als „kompatibel bei SunSpec-Modell 101/102/103 über Modbus TCP“ kennzeichnen, nicht pauschal als getestete Einzelmodelle.
Eingänge
| Nr. | Bezeichnung | Standard | Beschreibung |
|---|---|---|---|
| E1 | Freigabe | 0 | 0 deaktiviert, 1 aktiviert die Abfrage. Lizenzdiagnose und MAC-Anzeige bleiben bei 0 verfügbar. |
| E2 | IPv4-Adresse | leer | IPv4-Adresse des Wechselrichters bzw. Leaders/Gateways. |
| E3 | TCP-Port | 1502 | Tatsächlich am SolarEdge-Gerät eingestellter Modbus-TCP-Port. |
| E4 | Modbus Unit-ID | 1 | Modbus-Adresse des auszulesenden Wechselrichters, 1–247. |
| E5 | Intervall nach Abfrage (s) | 15 | Wartezeit nach Abschluss einer Abfrage, 5–3600 Sekunden. |
| E6 | Socket-Timeout (s) | 3 | Timeout je Zugriff, 1–10 Sekunden; zusätzlich gilt ein Gesamtzeitlimit. |
| E7 | Maximales Datenalter (s) | 60 | Danach werden Gültigkeitsausgänge gelöscht. Muss ausreichend größer als Intervall und Abfragedauer sein. |
| E8 | Jetzt abfragen | 0 | Eine neue 1 löst eine Abfrage aus, sofern Freigabe und Lizenz gültig sind. |
| E9 | Netzzaehler Auswahl 0=aus 1..3 | 1 | 0 deaktiviert Zählerlesung; 1–3 wählt den Zähler nach Reihenfolge in der SunSpec-Kette, nicht nach externer Slave-ID. |
| E10 | Rohwert positiv: 1=Export -1=Bezug | 1 | Korrigiert ausschließlich die Richtung der aktuellen Leistung. Bei bekanntem Bezug/Einspeisung am realen Messpunkt prüfen. |
| E11 | Lizenzierte HomeServer-MAC | leer | Tatsächliche HomeServer-MAC aus A57; Doppelpunkt-, Bindestrich- oder 12-Hexzeichen-Format. |
| E12 | Lizenzschluessel | leer | 7-Tage-Testlizenz oder Dauerlizenz für diese MAC. Vollständiger MH2.-Schlüssel mit bis zu 540 Zeichen; vorhandene MH1.-Dauerlizenzen bleiben gültig. |
Ausgänge
Diagnose und Wechselrichter
| Nr. | Bezeichnung | Beschreibung |
|---|---|---|
| A1 | Kernwerte gueltig | 1 = definierte Wechselrichter-Kernwerte gültig, aktuell und lizenziert. |
| A2 | Letzte Abfrage erfolgreich | Ergebnis der letzten Wechselrichterabfrage. |
| A3 | Abfrage laeuft | 1 während einer laufenden Abfrage. |
| A4 | Fehler / Hinweis | Konfigurations-, Verbindungs- oder Datenfehler des Wechselrichters. |
| A5 | Alter letzte Abfrage (s) | Sekunden seit dem letzten Erfolg; -1 = noch keine erfolgreiche Abfrage. |
| A6 | Letzte Abfrage UTC | Empfangszeitpunkt am HomeServer in UTC. |
| A7 | Erfolgreiche Abfragen | Zähler seit Initialisierung. |
| A8–A11 | Hersteller, Modell, Firmware, Seriennummer | Identifikation aus SunSpec Common Model 1. |
| A12 | SunSpec Modell-ID | 101, 102 oder 103. |
| A13 | Modelladresse Basis 0 | Gefundene Protokolladresse des Wechselrichter-Modellkopfs. |
| A14 | AC Wirkleistung (W) | Aktuelle Wechselrichterleistung. |
| A15 | Gesamtertrag (kWh) | Kumulierte AC-Energie. |
| A16 | Netzfrequenz (Hz) | Gemessene Frequenz. |
| A17–A20 | AC Strom gesamt/L1/L2/L3 (A) | Phasenwerte abhängig vom Profil. |
| A21–A26 | Spannungen L-N / L-L (V) | Phasenspannungen abhängig vom Profil. |
| A27 | Scheinleistung (VA) | Aktuelle AC-Scheinleistung. |
| A28 | Blindleistung (var) | Vorzeichenbehaftete AC-Blindleistung. |
| A29 | Leistungsfaktor (%) | Vom Wechselrichter gemeldeter Wert. |
| A30–A32 | DC Strom, Spannung, Leistung | Gesamtwerte der DC-Seite. |
| A33 | Kuehlkoerpertemperatur (C) | Vom Wechselrichter gemeldete Temperatur. |
| A34–A37 | Statuscodes und Statustext | SunSpec-Status, ältere Herstellerkennung, Ereignis 4 und lesbarer Text. |
| A38 | Gueltigkeitsmaske Messwerte | Bits in Reihenfolge der internen Wechselrichterfelder. |
| A39 | Gueltige Messwerte | Kommagetrennte Namen gültiger Werte. |
| A40 | Diagnose JSON | Modellkette, Identifikation und Rohregister; kann die Seriennummer enthalten. |
Zähler, Netz und Lizenz
| Nr. | Bezeichnung | Beschreibung |
|---|---|---|
| A41 | Netzleistung gueltig | 1 = normierte aktuelle Netzleistung ist gültig und aktuell. |
| A42 | Zaehler Fehler / Hinweis | Separater Zählerstatus; Wechselrichterwerte können trotzdem gültig sein. |
| A43 | Zaehler SunSpec-ID | 201, 202, 203 oder 204. |
| A44 | Zaehler Modelladresse Basis 0 | Dynamisch gefundene Adresse. |
| A45–A47 | Zaehler Modell, Seriennummer, Optionen | Identifikation und Messpunktbeschreibung aus dem zugehörigen Common Model. |
| A48 | Zaehler Leistung roh (W) | Skalierter Wert mit ursprünglichem SolarEdge-Vorzeichen. |
| A49 | Netz +Bezug / -Einspeisung (W) | Normiert: positiv Bezug, negativ Einspeisung. |
| A50 | Netzbezug (W) | Positiver Betrag des Bezugs, sonst 0. |
| A51 | Netzeinspeisung (W) | Positiver Betrag der Einspeisung, sonst 0. |
| A52 | Energie Einspeisung gesamt (kWh) | Kumulierte Exportenergie aus dem benannten Zählerregister. |
| A53 | Energie Bezug gesamt (kWh) | Kumulierte Importenergie aus dem benannten Zählerregister. |
| A54 | Zaehler Gueltigkeitsmaske | Bit 0 Rohleistung, 1 Exportenergie, 2 Importenergie, 3 Netzleistung, 4 Bezug, 5 Einspeisung. |
| A55 | Lizenz gueltig | 1 = Signatur, Produktkennung, Eingabe-MAC und lokale HomeServer-MAC passen. |
| A56 | Lizenzstatus | Lizenzart, Ablaufzeitpunkt der Testlizenz oder konkrete Fehlerursache. |
| A57 | Ermittelte HomeServer-MAC | Lokal erkannte Ethernet-MAC-Adresse(n), nicht die Wechselrichter-MAC. |
Netzzähler und Vorzeichen
Der Baustein sucht die Modelle 201–204 in der vollständigen SunSpec-Modellkette; feste Adressen werden nicht vorausgesetzt. Ausgegeben werden die Zählerwirkleistung sowie Export- und Importenergie. E9 muss den Zähler am Netzanschlusspunkt auswählen. A45/A47 helfen bei der Zuordnung.
Bei bekanntem Netzbezug muss A50 positiv und A51 null sein. Bei bekannter Einspeisung muss A51 positiv und A50 null sein. Ist es umgekehrt, E10 von 1 auf -1 ändern. E10 vertauscht nicht die benannten Energiezähler A52/A53.
Fehlersuche und Datenqualität
| Beobachtung | Prüfung |
|---|---|
| A55 = 0 | A56 lesen; vollständigen SolarEdge-Schlüssel und die aus A57 übernommene MAC prüfen. |
| A57 leer | Lokale MAC-Ermittlung ist fehlgeschlagen. Firmwarestand und A56 prüfen; es gibt keine Freigabe nur durch manuelle MAC-Eingabe. |
| Timeout / keine Verbindung | IP, Port, Unit-ID, Modbus-TCP-Freigabe und Erreichbarkeit vom HomeServer prüfen. Nur ein Modbus-TCP-Client kann je nach Firmware gleichzeitig zulässig sein. |
| A1 = 1, A41 = 0 | Wechselrichter funktioniert, ausgewählter Zähler fehlt oder liefert keine gültige Leistung. E9 sowie A42–A47 prüfen. |
| Netzrichtung falsch | Messpunkt verifizieren und E10 umstellen. Nicht anhand eines zufälligen Nullwerts entscheiden. |
| Zahlen bleiben nach Fehler stehen | Alte Zahlen werden bewusst nicht durch künstliche Nullen ersetzt. Für Steuerungen immer A1/A41 und A38/A54 auswerten. |
| Kein unterstütztes Wechselrichterprofil | Das Gerät liefert nicht Modell 101/102/103 mit Länge 50 oder die SunSpec-Kette ist nicht erreichbar. A4/A40 für die Geräteprüfung sichern. |
A5/A6 beschreiben den Empfang am HomeServer, nicht einen authentifizierten Messzeitpunkt im SolarEdge-Gerät. Intern eingefrorene, aber weiterhin übertragene Werte werden dadurch nicht sicher erkannt. Es wird ausschließlich Modbus-Funktion 03 zum Lesen verwendet; der Baustein schreibt keine Einstellungen.
Die Lizenzsignatur verhindert das Erzeugen gültiger Schlüssel ohne privaten Signierschlüssel. Das HSLZ-Paket ist nicht HSLX-verschlüsselt; gezielte Änderungen am lesbaren Bausteincode oder an der Betriebssystem-MAC sind daher nicht vollständig ausgeschlossen.
Version 1.0.0 ergänzt 7-Tage-Test- und neue Dauerlizenzen im MH2-Format. Vorhandene MH1-Dauerlizenzen, Registerauswertung, Anschlussnummern und Produktkennung bleiben kompatibel. Das Original-Logo ist direkt in die Hilfe eingebunden.