API

Die Betriebsdaten werden per Get Request an den Server übertragen. Die aufzurufende Url ist nach folgendem Schema aufzubauen:

http://www.mypvlog.de/Log/{AddressType}?{QueryParameter}

Die verschiedenen Adresstypen sind im Folgenden aufgelistet.

Generische Adresse (Generic)

Die Generische Adresse kann beliebig nach den vorliegenden Daten zusammengestellt werden. Die zwingend benötigten Parameter sind der nachfolgenden Tabelle zu entnehmen.

Definition Query Parameter Datentyp Beispiel optional
Anlagen ID plant Integer 23 Nein
Anlagen Passwort pw String streng-geheim Nein
Betriebsmodus systemstatus integer 5 Ja
Einspeiseleistung feedinpower double 3045.3 Nein
Gehäusetemperatur temperature double 18 Ja
Generatorleistung generatorpower double 2124.6 Ja
Generatorspannung generatorvoltage double 230.6 Ja
Generatorstrom generatorcurrent double 3.89 Ja
Netzspannung gridvoltage double 230.6 Ja
Netzstrom gridcurrent double 5.6 Ja
Unix Timestamp timestamp long 1328432923 Ja
Wechselrichter ID inverter Integer 1 Nein

Beispiel:

Kaco1 Adresse (Kaco1)

Diese Adresse ist für bestimmte Wechselrichter der Firma Kaco ausgelegt, welche über die RS-232 Schnittstelle ausgelesen werden. Über die Schnittstelle werden etwa alle 10 Sekunden die aktuellen Betriebsdaten der Wechselrichter ausgegeben. Diese Messwerte können dann in eine Url integriert und an das Portal übertragen werden.

Definition Query Parameter Datentyp Beispiel optional
Anlagen ID plant Integer 23 Nein
Anlagen Passwort pw String streng-geheim Nein
Kaco 1 Betriebsdaten data String 26.12.2009;23:53:00;5;158.0;3.20;134;229.6;1.34;1000;20 Nein
Wechselrichter ID inverter Integer 1 Nein

Beispiel:

Kaco2 Adresse (Kaco2)

Diese Adresse ist für bestimmte Wechselrichter der Firma Kaco ausgelegt, welche über die RS-485 Schnittstelle ausgelesen werden. Im Gegensatz zur Kaco1 Adresse wird hier die Wechselrichteradresse im Datenstring mitübertragen

Definition Query Parameter Datentyp Beispiel optional
Anlagen ID plant Integer 23 Nein
Anlagen Passwort pw String streng-geheim Nein
Kaco 2 Betriebsdaten data String "*020;4;378.2;3.96;1498;228.9;6.55;1438;29;5000;..." Nein

Beispiel:

Parameter Informationen

Anlagen ID
ID der Anlage oder des Kraftwerks. Kann unter "Anlage" -> "Einstellungen" abgelesen werden.
Anlagen Passwort
Kennwort der Anlage für Logging Url. Das Kennwort kann auf der Seite "Anlage" -> "Einstellungen" abgerufen werden. Verwenden Sie nicht das Passwort des Benutzeraccounts in der Logging Url.
Betriebsmodus
Aktueller Betriebsmodus des Wechselrichters / Generators.
Einspeiseleistung
Aktuelle AC-Leistung in Watt mit der ins Netz eingespeist wird.
Gehäusetemperatur
Aktuelle Betriebstemperatur des Generators / Wechselrichters
Generatorleistung
Aktuelle DC-Leistung des Generators in Watt.
Generatorstrom
Aktueller Generatorstrom in Ampere.
Generatorspannung
Aktuelle Betriebsspannung des Wechselrichters in Volt.
Kaco 1 Betriebsdaten
Durch Semikolon verknüfte Betriebsdatenstring von Kaco Wechselrichtern RS-232 Schnittstelle ausgelesen. Nach folgendem Schema aufgebaut:
{Datum};{Uhrzeit};{Betriebsmodus};{Generatorspannung};{Generatorstrom};{Generatorleistung};{Netzspannung};{Netzstrom};{Einspeiseleistung};{Gerätetemperatur}
Da Datum und Uhrzeit des Wechselrichters meist ungenau sind, werden diese grundsätzlich verworfen und stattdessen die aktuelle Serverzeit verwendet.
Kaco 2 Betriebsdaten
Durch Semikolon verknüfte Betriebsdatenstring von Kaco Wechselrichtern per RS-485 Schnittstelle ausgelesen. Nach folgendem Schema aufgebaut:
{WechselrichterId};{Betriebsmodus};{Generatorspannung};{Generatorstrom};{Generatorleistung};{Netzspannung};{Netzstrom};{Einspeiseleistung};{Gerätetemperatur};{Tagesenergie};{Wechselrichtertyp};{Prüfsumme}
Da Datum und Uhrzeit des Wechselrichters meist ungenau sind, werden diese grundsätzlich verworfen und stattdessen die aktuelle Serverzeit verwendet.
Netzspannung
Aktuelle Netzspannung in Volt.
Netzstrom
Aktueller Netzstrom in Ampere.
Unix Timestamp
Zeitpunkt an dem die Betriebsdaten erhoben wurden in Sekunden seit dem 1. Januar 1970. Sollte kein Timestamp übermittelt werden, so wird die aktuelle Serverzeit zugrunde gelegt.
Wechselrichter ID
Öffentliche Wechselrichter ID. Sollte ab 1 aufsteigend selbst vergeben werden.

blog comments powered by Disqus