Lokales Auslesen der Solarbank auf dem Gira HomeServer 4. Voraussetzung: Experte und HomeServer-Firmware 4.13. Der Baustein läuft vollständig auf dem HomeServer und benötigt keinen zusätzlichen Dienst.
Inbetriebnahme
- Experten-Projekt sichern. Die Datei 10888_BFSW_Anker_Solarbank4_v1.0.0.hslz über den Logikbaustein-Import im Experten importieren. Sie enthält Baustein und diese Hilfe. Die bisherige ID 10888 wird aktualisiert; alle Ein- und Ausgänge behalten ihre Nummern und Typen.
- In der Anker-App die Solarbank öffnen und in den Einstellungen für Drittanbieter die Funktion Modbus TCP aktivieren. IP-Adresse notieren. Der Baustein selbst ändert weder den Betriebsmodus noch Lade-/Entladevorgaben.
- Zum Ermitteln der MAC E1 zunächst auf 0 setzen und das Projekt übertragen. A34 im Logik Online-Test lesen und mit der HomeServer-Geräteangabe abgleichen.
- Eine passende Anker-Lizenz für diese HomeServer-MAC eintragen: MAC an E9, Lizenzschlüssel an E10.
- IP an E2 eintragen. Standardwerte: Port 502, Unit-ID 1, Intervall 5, Timeout 3, maximales Datenalter 60. E1 auf 1 setzen und das Projekt übertragen.
- A32 muss 1 anzeigen. A1/A2 sollten 1 anzeigen und A4 leer sein bzw. nur einen konkreten Hinweis enthalten. SOC, PV- und Batterieleistung mit der Anker-App 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 diesen Baustein und die tatsächliche HomeServer-MAC gebunden. Eine SolarEdge-Lizenz gilt hier nicht. Das bloße Eintragen einer fremden MAC reicht nicht aus. Der Baustein liest die MAC lokal und vergleicht sie mit der eingegebenen Adresse und der signierten Lizenz.
Wählbar sind eine 7-Tage-Testlizenz und eine Dauerlizenz. Die Testzeit beginnt bei der Ausstellung und setzt eine korrekte HomeServer-Systemzeit voraus. Nach Ablauf erfolgen keine weiteren Modbus-Abfragen. Mehrere Instanzen auf demselben HomeServer sind möglich. Bei HomeServer-Tausch ist eine neue Lizenz erforderlich. Es gibt keinen Online-Lizenzserver.
Bei E10 den vollständigen Schlüssel als festen Text eingeben. Neue MH2.-Schlüssel haben bis zu 540 Zeichen; vorhandene MH1.-Dauerlizenzen mit 516 Zeichen bleiben gültig. Leerzeichen im Inneren oder Zeilenumbrüche gehören nicht zum Schlüssel.
Eingänge
| Nr. | Bezeichnung | Standard | Beschreibung |
|---|---|---|---|
| E1 | Freigabe | 0 | 0 deaktiviert, 1 aktiviert die automatische Abfrage. Diagnose und MAC-Anzeige sind auch bei 0 verfügbar. |
| E2 | IPv4-Adresse | leer | IPv4-Adresse der Solarbank aus der Anker-App. Eine DHCP-Reservierung verhindert ungewollte Adressänderungen. |
| E3 | TCP-Port | 502 | Modbus-TCP-Port. Standard 502. |
| E4 | Modbus Unit-ID | 1 | Modbus Unit-ID. Standard 1. |
| E5 | Intervall nach Abfrage (s) | 5 | Wartezeit nach Abschluss einer Abfrage, 5–3600 Sekunden. |
| E6 | Socket-Timeout (s) | 3 | Timeout pro Socket-Zugriff, 1–10 Sekunden. Zusätzlich begrenzt ein Gesamtzeitlimit die Abfrage. |
| E7 | Maximales Datenalter (s) | 60 | Maximales Alter einer erfolgreich abgeschlossenen Abfrage. Muss mindestens Intervall + min(30, Timeout × 8) + 2 Sekunden betragen. |
| E8 | Jetzt abfragen | 0 | Ein neuer Wert 1 löst eine Abfrage aus, wenn Freigabe und Lizenz gültig sind und keine Abfrage läuft. Für erneuten Impuls auf 0 zurücksetzen. |
| E9 | Lizenzierte HomeServer-MAC | leer | Tatsächliche HomeServer-MAC aus A34. Formate AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF oder 12 Hexzeichen. |
| E10 | Lizenzschluessel | leer | 7-Tage-Testlizenz oder Dauerlizenz für diese MAC. Vollständigen MH2.-Schlüssel mit bis zu 540 Zeichen als festen Text eintragen; vorhandene MH1.-Dauerlizenzen bleiben gültig. |
Ausgänge
| Nr. | Bezeichnung | Standard | Beschreibung |
|---|---|---|---|
| A1 | Kernwerte gueltig | 0 | 1 = SOC, direkte PV-Leistung, Batterieleistung und Batteriestatus sind gültig, aktuell und lizenziert. Bestätigt nicht automatisch alle übrigen Messwerte. |
| A2 | Letzte Abfrage erfolgreich | 0 | 1 = letzte vollständige Abfrage erfolgreich und noch aktuell. Optionale fehlende Register können trotzdem einen Hinweis auslösen. |
| A3 | Abfrage laeuft | 0 | 1 = Abfrage läuft; parallele Abfragen derselben Instanz werden unterdrückt. |
| A4 | Fehler / Hinweis | leer | Verbindungs-/Konfigurationsfehler oder Hinweise zu nicht verfügbaren optionalen Registern. |
| A5 | Alter letzte Abfrage (s) | -1 | Sekunden seit dem letzten erfolgreich abgeschlossenen Abruf; -1 = noch keiner. |
| A6 | Letzte Abfrage UTC | leer | Zeitpunkt des letzten erfolgreichen Abrufs, ausdrücklich UTC. |
| A7 | Erfolgreiche Abfragen | 0 | Anzahl erfolgreicher Abfragen seit Initialisierung. |
| A8 | Geraetemodell | leer | Vom Gerät gelesene Modellkennung, erwartet AE103. |
| A9 | Seriennummer | leer | Seriennummer der Solarbank, sofern lesbar. |
| A10 | Geraetefirmware | leer | Firmwarezeichenfolge der Solarbank, sofern lesbar. |
| A11 | Ladezustand (%) | 0 | Batterieladezustand in Prozent. |
| A12 | PV-Leistung Solarbank (W) | 0 | Direkte PV-Leistung der Solarbank. Ohne die separat gemessene externe PV. |
| A13 | Externe PV-Leistung (W) | 0 | Von Anker bereitgestellte externe PV-Leistung. Abhängig von passender Zählerkonfiguration. |
| A14 | Batterie +Entladen / -Laden (W) | 0 | Positiv = Entladen, negativ = Laden. |
| A15 | Hausverbrauch (W) | 0 | Von Anker ermittelter Hausverbrauch. Zählerkonfiguration und Messpunkt beachten. |
| A16 | Netz +Bezug / -Einspeisung (W) | 0 | Positiv = Netzbezug, negativ = Einspeisung. |
| A17 | Batteriestatus Code | 0 | 0 Standby, 1 Laden, 2 Entladen, 3 Schlafmodus. |
| A18 | PV-Gesamtertrag (kWh) | 0 | PV-Gesamtertrag aus dem Herstellerregister, bereits in kWh umgerechnet. |
| A19 | AC-Netzausgangsleistung roh (W) | 0 | AC-Netzausgangsleistung nach Herstellerregister, unverändertes Vorzeichen. |
| A20 | Nennkapazitaet (kWh) | 0 | Gemeldete Nennkapazität, nicht die aktuell verbleibende Energie. |
| A21 | Geladene Energie gesamt (kWh) | 0 | Kumulierte geladene Energie in kWh. |
| A22 | Entladene Energie gesamt (kWh) | 0 | Kumulierte entladene Energie in kWh. |
| A23 | PV-Leistung gesamt inkl. extern (W) | 0 | Summe aus A12 und A13; nur gültig, wenn beide Einzelwerte gültig sind. |
| A24 | Batterie Ladeleistung (W) | 0 | Positiver Betrag der Batterieladeleistung; bei Entladung 0. |
| A25 | Batterie Entladeleistung (W) | 0 | Positiver Betrag der Batterieentladeleistung; bei Ladung 0. |
| A26 | Netzbezug (W) | 0 | Positiver Betrag des Netzbezugs; bei Einspeisung 0. |
| A27 | Netzeinspeisung (W) | 0 | Positiver Betrag der Einspeisung; bei Netzbezug 0. |
| A28 | Batteriestatus Text | leer | Lesbare Beschreibung zu A17. |
| A29 | Gueltigkeitsmaske Messwerte | 0 | Bits 0–16 gehören in Reihenfolge zu A11–A27. Ein gesetztes Bit bestätigt den jeweiligen Messwert. Bei Fehler, Lizenzsperre oder zu alten Daten 0. |
| A30 | Gueltige Messwerte | leer | Kommagetrennte interne Namen der gültigen Messwerte. |
| A31 | Diagnose JSON | leer | JSON mit Geräteidentifikation und gelesenen Registern zur Fehlersuche. Kann die Seriennummer enthalten. |
| A32 | Lizenz gueltig | 0 | 1 = Signatur, Produktkennung und lokale HomeServer-MAC passen. Bei fehlender oder falscher Lizenz 0. |
| A33 | Lizenzstatus | leer | Ergebnis der Lizenzprüfung, Lizenzart, Ablaufzeitpunkt der Testlizenz oder konkrete Fehlerursache. |
| A34 | Ermittelte HomeServer-MAC | leer | Lokal ermittelte Ethernet-MAC-Adressen des HomeServers. Bei mehreren Adressen die Geräte-MAC verwenden; diese Ausgabe ist keine Wechselrichteradresse. |
Fehlersuche und Datenqualität
| Beobachtung | Prüfung |
|---|---|
| A32 = 0 | A33 lesen. Anker-Lizenz, vollständigen Schlüssel und MAC prüfen. Eine Lizenz für SolarEdge wird absichtlich abgelehnt. |
| A34 leer | Die lokale MAC-Ermittlung ist fehlgeschlagen. A33 melden und Firmware prüfen. Es gibt keine Freischaltung durch manuelle Ersatzangaben. |
| Timeout / Verbindungsfehler | IP-Adresse, Port 502, Modbus-Freigabe in der App und Erreichbarkeit vom HomeServer prüfen. |
| Falsches Gerätemodell | Diese Version erwartet AE103. Den tatsächlich gemeldeten Modelltext mitteilen. |
| Optionales Register fehlt | Die betroffenen Werte sind ungültig. A29/A30 prüfen. Andere Kernwerte können weiter gültig sein. |
| Zahlen bleiben stehen | Alte Werte werden bei Fehlern nicht durch künstliche Nullen ersetzt. Gültigkeit A1 sowie A29/A30 auswerten. Für Steuerungen nur gültige, aktuelle Werte verwenden. |
| Haus-/Netz-/externe PV-Werte passen nicht | Smart-Meter-Konfiguration und Messpunkt in der Anker-Anlage prüfen. Ein Nullwert bestätigt nicht, dass ein passender Zähler vorhanden ist. |
A5/A6 messen das Alter des Abrufs am HomeServer. Sie sind kein verifizierter Geräte-Messzeitpunkt. Intern eingefrorene, weiterhin übertragene Zahlen können dadurch nicht sicher erkannt werden. Unveränderte Werte allein erzeugen keinen Fehler.
Funktionsumfang und Versionshinweise
Gelesen werden SOC, direkte und externe PV-Leistung, Batterie-/Haus-/Netzleistung, Status, Energiezähler, Nennkapazität und Geräteinformationen. Netzleistung ist positiv bei Bezug, Batterieleistung positiv bei Entladung. Getrennte Leistungsbeträge werden ebenfalls ausgegeben.
Nur Modbus-Funktion 04 wird verwendet. Keine Schreibbefehle, keine Betriebsmodusumschaltung. Einzelne MPPT-Leistungen und Temperaturen sind mangels belegter Register nicht enthalten. Abfragen laufen im Hintergrund, mit Timeout und ohne parallele Abfragen derselben Instanz.
Version 1.0.0 ergänzt 7-Tage-Test- und neue Dauerlizenzen im MH2-Format. Vorhandene MH1-Dauerlizenzen, Anschlüsse, Geräteabfrage und Registerauswertung bleiben kompatibel. Das Original-Logo ist direkt in die Hilfe eingebunden.
Die Lizenzsignatur schützt vor gefälschten Schlüsseln. Der ausgelieferte Baustein ist nicht HSLX-verschlüsselt; Manipulation der Python-Logik oder der Betriebssystem-MAC ist damit nicht ausgeschlossen. HSLZ ist das Installationspaket und keine Verschlüsselung.