PHP-Modul zur Einbindung eines RCT-Power Inverter/Wechselrichter in IPSymcon.
Nutzung auf eigene Gefahr ohne Gewähr. Das Modul kann jederzeit überarbeitet werden, so daß Anpassungen für eine weitere Nutzung notwendig sein können. Bei der Weiterentwicklung wird möglichst auf Kompatibilität geachtet.
Bei der Installation einer neuen Version sollte man in die Versionshistorie schauen, ob man evtl. manuell tätig werden muss!
Das Modul ist ein Hobby. Wer sich mit einer kleinen Spende für dessen Entwicklung (ohne Recht auf irgendwelche Ansprüche) bedanken möchte, kann dies gerne via Paypal-Spende machen:
Inhaltsverzeichnis
Das Modul ist dazu gedacht einen RCT-Power Inverter/Wechselrichter einer Photovoltaikanlage in IP-Symcon einzubinden.
Es sollen Zustandsdaten (gelieferte Energie, Momentanverbrauch, Ladezustand des Akkus, etc.) zur Auswertung und weiterverwendung in IP-Symcon zur Verfügung gestellt werden. Programmierung oder Steuerung des Inverters/Wechselrichters sind nicht Bestandteil des Moduls.
- IP-Symcon ab Version 4.x
Vor der Installation des Moduls in IPSymcon muss der RCT-Power Inverter/Wechselrichter vollständig eingerichtet sein. Da dieses Modul lokal auf den Inverter/Wechselrichter zugreift, muss dieser im lokalen WLAN (nicht dem WLAN des Inverters/Wechselrichters!) oder lokalen LAN mit einer statischen IP erreichbar sein.
Der Zugriff auf den RCT Power Inverter erfolgt über eine ClientServer TCP Instanz auf die IP des Wechselrichters mit Port 8899.
Dem RCT Power Inverter Modul muss diese als übergeordnete Instanz zugewiesen werden
Weitere Einstellungen:
PV Paneldaten - Eingang A
Hier kann die Anzahl der Panel sowie deren jeweilige (je Panel) Nennleistung für den Eingang A eingestellt werden. Diese Werte dienen der Berechnung der %-Ausnutzung der Panel am Eingang A.
PV Paneldaten - Eingang B
Hier kann die Anzahl der Panel sowie deren jeweilige (je Panel) Nennleistung für den Eingang B eingestellt werden. Diese Werte dienen der Berechnung der %-Ausnutzung der Panel am Eingang A.
RCT Wechselrichter Einstellungen
Hier kann die untere Entladeschwelle einer angeschlossenen Batterie (RCT Power Storage) eingestellt werden. Die verfügbare Restkapazität der Batterie bezieht sich auf die verfügbare Batterie-Kapazität zwischen der im Wechselrichter eingestellten unteren sowie der oberen Ladeschwelle (die obere Schwelle sowie die Brutto-Kapazität wird automatisch ermittelt).
Automatische Updates
Für das regelmäßige aktualisieren der Daten müssen die automatischen Updates aktiv und ein Update-Inverval eingestellt sein. Die Untergrenze des Update-Intervalls liegt bei 15 Sekunden (früher 10). Anmerkung: Der Werte wurde mit Version 1.0 erhöht, da bei mehreren Wechselrichtern mehr Zeit notwendig ist, damit alle ihre Daten nacheinander abholen können.
Sollen die Updates nicht automatisch erfolgen, können die Daten mittels des Befehls RCTPowerInverter_UpdateData() über ein Skript angefordert werden. Auch hier sollte man darauf achten, das man nicht zu schnell hintereinander Daten anfordert!
Tools
Die Verwendung der Tools sollte eigentlich nur im Problemfall notwendig und deshalb alle Tools im Normalfall deaktiviert sein.
- Debuginformationen ausgeben. Über diesen Schalter können Debug-Meldungen im Modul aktiviert werden. So kann man grob mitverfolgen, was das Modul aktuell gerade macht.
- Fehlerhafte Antwort-Sequence ignorieren. Das Modul arbeitet nach dem Prinzip "Frage X Adressen an und werde die Antworten aus". Dabei erwartet es die Anworten in genau der Sequenz, in der sie angefragt wurden. Sollte es hier zu Probleme kommen (siehe Debug-Meldungen im Modul), kann man versuchen, diese Sequenz-Überprüfung zu deaktivieren. Die Sequenz-Überprüfung ist zudem nur wirklich relevant, wenn mehrere, miteinander kommunizierende, Wechselrichter angeschlossen sind. Bei einem einzelnen Wechselrichter kann das setzen dieses Schalters sogar die Häufigkeit der Datenauswertung verbessern!
- Auf fremde Abfragen reagieren. Im Normalfall ignoriert das Modul Antworten auf der Schnittstelle, die von anderen Anbindungen wie z.B. der RCT Android/iOS App angefordert wurden. Durch diesen Schalter kann man versuchen, auch diese Antworten auswerten zu lassen (experimentell).
- CRC Fehler ignorieren. Im Normalfall werden die empfangenen Pakete einer Checksummenprüfung (CRC) unterzogen. Fehlerhafte Pakete werden dabei ignoriert, welches wiederum die Antwort-Sequenz stören kann! Mit diesem Schalter kann die CRC Prüfung abgeschaltet werden.
Derzeit bietet das GIT nur das Modul "RCT_POWER_INVERTER" für die direkte Anbindung eines einzelnen RCT-Power Inverter/Wechselrichter.
Das Modul "RCT_POWER_INVERTER" dient als Schnittstelle zu einem lokal installierten RCT-Power Inverter/Wechselrichter. Es liefert die Daten des Inverter/Wechselrichter als Statusvariablen. Der RCT-Power Inverter/Wechselrichter muss dabei lokal über eine IP-Adresse erreichbar (siehe Installation) und das Update Interval entsprechend eingestellt sein.
RCTPowerInverter_UpdateData() Mit dem Befehl wird die Aktualisierung der Sub-Variablen der Instanz angefordert. Dieser Befehl muss eigentlich nur verwendet werden, wenn man keine automatische Aktualisierung verwendet.
Das Modul reagiert auf Nachrichten vom Wechselrichter über die geöffnete TCP Schnittstelle. Das Update Interval dient faktisch nur der regelmäßigen Anforderung der Daten. Wenn die TCP-Schnittstelle geöffnet ist reagiert das Modul auch auf Nachrichten, die ggf. parallel über die RCT Android/iOS App vom Wechselrichter angefordert wurden oder zwischen mehreren installierten Wechselrichtern hin- und hergeschickt werden.
Während die Quer-Kommunikation der Wechselrichter untereinander möglichst ignoriert wird, kann ein paralleles Pollen über die Android oder IOS App ggf. die Kommunikation und den Datenempfang dieses Moduls stören. Aus diesem Grund sollte man möglichst auf einen parallele Nutzung der RCT Android/iOS App verzichten!
Übernahme von Korrekturen zur Vermeidung von Div/0 sowie falscher Tageswertberechnungen.
Anpassung der Paketverarbeitung sowie Checksummenprüfung, da es hier zu Problemen in Version 1.0 kam. Zudem musste das interne Poll-Intervall angepasst werden, um Fehler beim Datenaustausch mit dem RCT zu minimieren.
Überarbeitete Version mit folgenden Anpassungen:
- komplett überarbeitete Kommunikation mit dem RCT Wechselrichter.
Es zeigten sich Probleme bei Installationen mit mehreren Wechselrichtern. Die WR kommunizieren untereinander, so dass es zu Fehl-Zuordnungen der Daten kam. Man konnte nicht Unterscheiden, welche Daten zu welchem Wechselrichter gehörten. Die Kommunikation wurde mittels Semaphoren sequenziert. Zudem wird nicht jede Antwort auf der Schnittstelle sofort ausgewertet, sondern die Antworten werden gesammelt um dann mit den angeforderten Daten verglichen und anschließend ausgewertet zu werden.
- Batteriekapazität muss nicht mehr konfiguriert werden
In Version 0.1 gab es eine Verwechslung der Panel-Kapazität mit der Batterie-Kapazität des RCT-Systems. Sowas passiert halt, wenn die Batteriegröße zufällig der Größe der Installierten kWp entspricht ;) In Version 1.0 liest das Modul die Seriennummern der am RCT installierten Batteriepacks aus und ermittelt hieraus automatisch die Größe der installierten Batterie.
- optimiertes Layout und Anpassungen der Konfigurationsparameter in der Instanzkonfiguration
Das Layout ist jetzt an der Web-Konsole orientiert. In der "veralteten" Windows-Konsole kann es ggf. nicht perfekt aussehen ;)
Notwendige Manuelle Anpassungen
Der neu eingeführte Schalter "automatische Updates aktiv" ist standardmäßig auf "An" gestellt um sicherzustellen, das nach einem Update des Moduls weiterhin Daten aktualisiert werden. Sollten die Updates durch ein vorheriges Update-Intervall von "0" deaktiviert worden sein, werden auch weiterhin keine Daten aktualisiert! Der Schalter ist also "An", aber trotzdem erfolgt keine Aktualiserung.
Ggf. muss das Update-Intervall angepasst werden. In Version 0.1 waren 10 Sekunden als Minimum erlaubt. Dieser Wert wurde mit Version 1.0 auf 15 Sekunden angehoben, um bei mehreren Wechselrichtern mehr Zeit für die Kommunikation zu haben. Nach dem Update kann hier also ein Fehler angezeigt werden.
Erste Version des Moduls. Funktioniert stabil mit einem Wechselrichter und liesst die Daten über die TCP/IP Schnittstelle aus
