KostalPiko: Unterschied zwischen den Versionen

KOSTALPIKO
Zweck / Funktion
	KostalPiko erfasst Informationen vom gleichnamigen Wechselrichter der Fa. Kostal; unabhängig davon kann das Modul auch dazu verwendet werden, die Globalstrahlung am Standort für den aktuellen oder nächsten Tag zu ermitteln.
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Codeschnipsel
Modulname	23_KOSTALPIKO.pm
Ersteller	John (Forum / Wiki)
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Aktuelle Version vom 26. Mai 2024, 10:32 Uhr

Anbindung des Wechselrichters Piko der Fa. Kostal Solar Electric

Geräte Beschreibung

Der Solar-Wechselrichter Piko der Fa. Kostal liefert über die Geräte-Webseite wichtige technische Informationen wie

aktuelle Leistung
Tages-Energie
Gesamt-Energie
Strom und Spannung der drei Input-Strings
Spannung und Leistung der drei Ausgangsphasen

Das Gerät verfügt über eine Ethernet-Schnittstelle, über welche die Webseite des Gerätes erreichbar ist.

Aber ohne Wechselrichter kann das Modul hilfreich sein: es erfasst von der Seite

http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Heute.html

bzw.

http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Morgen.html

Wetterdaten für den heutigen bzw. für den nächsten Tag (siehe unter Readings, diejenigen, die mit "proplanta" gekennzeichnet sind).

FHEM-Modul

Das Modul 23_KOSTALPIKO.pm übernimmt folgende Aufgaben:

Erfassen der Daten aus der Webseite von Piko
Erfassen der Erwartungswerte für Gobalstrahlung, UV-Index und Sonnenscheindauer von folgender Webseite [1]
über UserReadings kann der zu erwartenden Energieertrag ermittelt und mit der tatsächlich erzeugten Energiemenge verglichen werden.

Define

Definition des Geräts in der Konfiguration:

define <name> KOSTALPIKO <ip-adresse-kostal> <user> <password>

Beispiel:

define <name> KOSTALPIKO 192.168.178.99 pvserver pvwr

Parameter	Beschreibung
<name>	FHEM Name des Devices
<ip-adresse-kostal>	IP-Adresse von Kostal Piko
<user>	der User-Name für die Einwahl zur Kostal-Webseite
<password>	das Passwort für die Einwahl zur Kostal-Webseite

Attribute

Parameter	Wertebereich	Default	Beschreibung
GR.Interval	uint	3600	Intervall der Aktualisierung der Globalstrahlung in Sekunden
GR.Link	string		Link auf die regionalisierte Seite von http://www.proplanta.de/Wetter/<city>-Wetter-Heute.html
delay	uint	60	Intervall in Sekunden zu Erfassung der Daten von Kostalpiko
delayCounter	uint	0	Counter bei Nutzung von AC.Power.Fast
disable	[0,1]	0	Erfassung von Kostalpiko-Daten ist gesperrt, nicht jedoch der Globalstrahlung
verbose	[0..5]	0	Log-Ausgabe steuern: 0=keine Ausgaben,5=viele Informationen

Setter

captureGlobalRadiation

Funktion: manuell die sofortige Erfassung der Werte der Proplanta-Seite anstossen

captureKostalData

Funktion: manuell die sofortige Erfassung der Daten von KostalPiko anstossen

Readings

AC.Power, die aktuelle erzeugte Leistung
AC.Power.Fast, die aktuell erzeugte Leistung im Schnelltast-Modus
Daily.Energy, die bisher erzeugte Tagesenergie
Daily.Energy.Last, die erzeugte Energie des letzten Tages, wird um 23:00 Uhr ermittelt.
Global.Radiation, die Globalstrahlung am gewählten Standort, damit die erwartete Tagesenergie berechnet werden (proplanta)
Mode, der Status von KostalPiko
ModeNum, die nummerische Zuordnung zum Status (0=Aus 1=Leerlauf 2=Einspeisen MPP)
Total.Energy, die erzeugte Gesamtenergie
generator.1.current, Strom an String 1 [A]
generator.1.voltage, Spannung an String 1 [V]
generator.2.current, Strom an String 2 [A]
generator.2.voltage, Spannung an String 2 [V]
generator.3.current, Strom an String 3 [A]
generator.3.voltage, Spannung an String 3 [V]
output.1.voltage, Spannung an L1 [V]
output.1.power, Leistung an L1 [W]
output.2.voltage, Spannung an L2 [V]
output.2.power, Leistung an L2 [W]
output.3.voltage, Spannung an L3 [V]
output.3.power, Leistung an L3 [W]
sensor.1, Spannung an 1. analogem Eingang [V]
sensor.2, Spannung an 2. analogem Eingang [V]
sensor.3, Spannung an 3. analogem Eingang [V]
sensor.4, Spannung an 4. analogem Eingang [V]
UV.Index, UV-Index (proplanta)
sunshine.duration, rel. Sonnenscheindauer [%] (proplanta)

Inbetriebnahme

KOSTALPIKO samt Abfrage-Intervall definieren

define Kostal KOSTALPIKO 192.168.178.99 pvserver pvwr
attr Kostal delay 60

Abfrageintervall und WEB-Seite für die Globalstrahlung

attr Kostal GR.Interval 3600
attr Kostal GR.Link http://www.proplanta.de/Wetter/Straubing-Wetter-Heute.html

Die passende URL für die Web-Seite am Standort lässt sich wie folgt ermitteln. (hier am Beispiel der Stadt Straubing)
Diese Seite anwählen http://www.proplanta.de/Agrar-Wetter/Deutschland/
Postleitzahl eingeben: 94315
ggf. bei Auswahlbox rechts zusätzlich auswählen --> Button "Aufrufen"

Am untersten Ende der nun aufgerufenen Seite findet sich der Link zu "Wetterrückbick Straubing" --> Click

Auf der nun erscheinenden Seite findet sich ebenfalls am unteren Ende:"Wetteraussichten Heute" - Click
Nun merken wir uns die URL der aktuellen Seite und tragen diesen beim Attribut GR.Link ein.
(im Beispiel: http://www.proplanta.de/Wetter/Straubing-Wetter-Heute.html)

Auf dieser Seite wird das Modul nach dem Begriff "Globalstrahlung" suchen und den Wert extrahieren.

nun legen wir noch ein UserReading an um über die Globalstrahlung die erwartete Energie zu berechnen

wir verwenden die Formel

 Expected Energy = <PV-Fläche> * GlobalStrahlung * Systemnutzungsgrad

und somit (mit PV-Fläche=37qm und Systemnutzungsgrad = 10%)

attr Kostal userReadings EnergyExpected {return ReadingsVal ("Kostal","Global.Radiation",0)*37*0.10;;}

FileLog für die Aktualwerte

define Kostal.File FileLog ./log/Kostal-%Y.log Kostal:(AC.Power:|Daily.Energy:|Daily.Energy.Last:|Total.Energy:|ModeNum:|EnergyExpected:).*
attr Kostal.File logtype text

eine passende Grafik über den Plot-Editor erstellen; der Plot-Editor ist über das FileLog-Objekt erreichbar.

folgende beispielhafte Werte einstellen

ein FileLog für die erzeugte Tages-Energie

define Kostal.File_2 FileLog ./log/Kostal_2-%Y.log Kostal:(Daily.Energy.Last:).*
attr Kostal.File_2 logtype text

eine passende Grafik über den Plot-Editor erstellen (Attribut fixedrange auf month setzen)

Turbo-Modus für AC.Power.

AC.Power.Fast hat ja zunächst denselben Wert wie AC.Power.
Wer jedoch das schnelle Reading nutzen will setzt zunächst den Wert von Attribut delay runter z.B auf minütliche Abtastung.
Dann würde jedoch die LogDatei schnell anwachsen, was nicht jeder will.
Daher gibt es das Attribut delayCounter. Mit delayCounter=5 wird nur AC.Power.Fast minütlich abgetastet, alle anderen Readings werde mit 5 * 60 sec. =300 sec aktualisiert.

Fragen und Antworten

Erfassung der Globalstrahlung ohne KostalPiko

Ich habe keinen KostalPiko, kann ich das Modul zur Erfassung der Globalstrahlung verwenden?: Das ist möglich.
Hierzu alles wie im Kapitel Inbetriebnahme beschrieben parametrieren und zusätzlich das Attribut disable 1 setzen.
Damit wird KostalPiko nicht angesprochen, jedoch bei vorhandenen GR.* Attributen die Readings der Proplanta-Seite (u.a. eben auch die Globalstrahlung) dennoch erfasst.

Erfassung der Globalstrahlung für den nächsten Tag

Kann das Modul zur Erfassung der Globalstrahlung des nächsten Tages verwendet werden?

Das ist möglich. Dazu muss das Attribut GR.Link von

http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Heute.html

auf

http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Morgen.html

geändert werden.

Links

Webseite des Herstellers Kostal
Forenbeitrag zu diesem Thema

@@ Zeile 1: / Zeile 1: @@
+{{Infobox Modul
+|ModPurpose=KostalPiko erfasst Informationen vom gleichnamigen Wechselrichter der Fa. Kostal; unabhängig davon kann das Modul auch dazu verwendet werden, die Globalstrahlung am Standort für den aktuellen oder nächsten Tag zu ermitteln.
+|ModType=d
+|ModCmdRef=KOSTALPIKO
+|ModForumArea=Codeschnipsel
+|ModTechName=23_KOSTALPIKO.pm
+|ModOwner=John ([http://forum.fhem.de/index.php?action=profile;u=806 Forum] / [[Benutzer Diskussion:John|Wiki]])}}
 Anbindung des Wechselrichters Piko der Fa. Kostal Solar Electric
@@ Zeile 9: / Zeile 16: @@
 * Spannung und Leistung der drei Ausgangsphasen
-Das Gerät verfügt über eine Ethernet-Schnittstelle, über die die Webseite des Gerätes erreichbar ist.
+Das Gerät verfügt über eine Ethernet-Schnittstelle, über welche die Webseite des Gerätes erreichbar ist.
-<big>Aber ohne Wechselrichter kann das Modul hilfreich sein</big>.
+Aber ohne Wechselrichter kann das Modul hilfreich sein: es erfasst von der Seite
+:<code><nowiki>http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Heute.html</nowiki></code>
-Es erfasst von der Seite<br/>
+bzw.
-http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Heute.html <br/>
+:<code><nowiki>http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Morgen.html</nowiki></code>
-bzw.<br/>
+Wetterdaten für den heutigen bzw. für den nächsten Tag (siehe unter Readings, diejenigen, die mit "proplanta" gekennzeichnet sind).
-http://www.proplanta.de/Wetter/<meineStadt>-Wetter-Morgen.html<br/><br/>
-Wetterdaten für den heutigen bzw. für den nächsten Tag.
-(siehe unter Readings, diejeingen, die mit "proplanta" gekennzeichnet sind)
 == FHEM-Modul ==
@@ Zeile 25: / Zeile 28: @@
 * Erfassen der Daten aus der Webseite von Piko
-* Erfassen der erwarteten Gobalstrahlung von folgender Webseite [http://www.proplanta.de/Agrar-Wetter/Deutschland/]
+* Erfassen der Erwartungswerte für Gobalstrahlung, UV-Index und Sonnenscheindauer von folgender Webseite [http://www.proplanta.de/Agrar-Wetter/Deutschland/]
 * über UserReadings kann der zu erwartenden Energieertrag ermittelt und mit der tatsächlich erzeugten Energiemenge verglichen werden.
-=== Aktuelle Version ===
-Die aktuelle Version befindet sich stets im ersten Beitrag zum Thread zu [http://forum.fhem.de/index.php/topic,24409.0.html KostalPiko V 2.2].<br /><br />
-Der initiale Link zu Kostalpiko findet sich [http://forum.fhem.de/index.php/topic,13508.0.html hier].<br />
 === Define ===
-<code>
+Definition des Geräts in der [[Konfiguration]]:
-  define <name> KOSTALPIKO <ip-adresse-kostal> <user> <password>
+:<code>define <name> KOSTALPIKO <ip-adresse-kostal> <user> <password> </code>
-</code>
 '''Beispiel:'''
-<code>
+:<code>define <name> KOSTALPIKO 192.168.178.99 pvserver pvwr </code>
-  define <name> KOSTALPIKO 192.168.178.99 pvserver pvwr
-</code>
 {| class="wikitable sortable"
@@ Zeile 78: / Zeile 72: @@
 === Setter ===
 '''captureGlobalRadiation'''
-* Funktion: manuell die sofortige Erfassung der Globalstrahlung anstossen
+* Funktion: manuell die sofortige Erfassung der Werte der Proplanta-Seite anstossen
 '''captureKostalData'''
@@ Zeile 92: / Zeile 86: @@
 * ModeNum, die nummerische Zuordnung zum Status (0=Aus 1=Leerlauf 2=Einspeisen MPP)
 * Total.Energy, die erzeugte Gesamtenergie
-* generator.1.current, Strom an String 1
+* generator.1.current, Strom an String 1 [A]
-* generator.1.voltage, Spannung an String 1
+* generator.1.voltage, Spannung an String 1 [V]
-* generator.2.current, Strom an String 2
+* generator.2.current, Strom an String 2  [A]
-* generator.2.voltage, Spannung an String 2
+* generator.2.voltage, Spannung an String 2 [V]
-* generator.3.current, Strom an String 3
+* generator.3.current, Strom an String 3 [A]
-* generator.3.voltage, Spannung an String 3
+* generator.3.voltage, Spannung an String 3 [V]
-* output.1.voltage, Spannung an L1
+* output.1.voltage, Spannung an L1 [V]
-* output.1.power, Leistung an L1
+* output.1.power, Leistung an L1 [W]
-* output.2.voltage, Spannung an L2
+* output.2.voltage, Spannung an L2 [V]
-* output.2.power, Leistung an L2
+* output.2.power, Leistung an L2 [W]
-* output.3.voltage, Spannung an L3
+* output.3.voltage, Spannung an L3 [V]
-* output.3.power, Leistung an L3
+* output.3.power, Leistung an L3 [W]
-* sensor.1, Spannung an 1. analogem Eingang
+* sensor.1, Spannung an 1. analogem Eingang [V]
-* sensor.2, Spannung an 2. analogem Eingang
+* sensor.2, Spannung an 2. analogem Eingang [V]
-* sensor.3, Spannung an 3. analogem Eingang
+* sensor.3, Spannung an 3. analogem Eingang [V]
-* sensor.4, Spannung an 4. analogem Eingang
+* sensor.4, Spannung an 4. analogem Eingang [V]
 * UV.Index, UV-Index (proplanta)
-* sunshine.duration, rel. Sonnenscheindauer (proplanta)
+* sunshine.duration, rel. Sonnenscheindauer [%] (proplanta)
 == Inbetriebnahme ==
-*  aktuell freigegebene Version von 23_KOSTALPIKO.pm in das Verzeichnis /opt/fhem/FHEM kopieren.
 * KOSTALPIKO samt Abfrage-Intervall definieren
 <pre>
@@ Zeile 144: / Zeile 137: @@
 und somit (mit PV-Fläche=37qm und Systemnutzungsgrad = 10%)<br />
 <pre>
-attr Kostal userReadings EnergyExpected:Global.Radiation {return ReadingsVal ("Kostal","Global.Radiation",0)*37*0.10;;}
+attr Kostal userReadings EnergyExpected {return ReadingsVal ("Kostal","Global.Radiation",0)*37*0.10;;}
 </pre>
@@ Zeile 153: / Zeile 146: @@
 </pre>
-* eine passende Grafik dazu
+* eine passende Grafik über den Plot-Editor erstellen; der Plot-Editor ist über das FileLog-Objekt erreichbar.
-<pre>
+[[File:Kostal_filelog.png]]
-define wl_Kostal.File_1 SVG Kostal.File:wl_Kostal.File_1:CURRENT
-</pre>
+* folgende beispielhafte Werte einstellen
+[[File:Kostal_chartCreate.png]]
 * ein FileLog für die erzeugte Tages-Energie
@@ Zeile 164: / Zeile 158: @@
 </pre>
-* eine passende Grafik hierzu
+* eine passende Grafik über den Plot-Editor erstellen (Attribut fixedrange auf month setzen)
-<pre>
+[[File:Kostal_chartMCreate.png]]
-define wl_Kostal.File_2 SVG Kostal.File_2:wl_Kostal.File_2:CURRENT
-attr wl_Kostal.File_2 fixedrange month
-</pre>
 * Turbo-Modus für AC.Power.<br/>
@@ Zeile 176: / Zeile 167: @@
 Daher gibt es das Attribut delayCounter.
 Mit delayCounter=5 wird nur AC.Power.Fast minütlich abgetastet, alle anderen Readings werde mit 5 * 60 sec. =300 sec aktualisiert.
-== Beispielhafte Darstellung ==
-[[File:Kostal_Chart_01.png]]
 == Fragen und Antworten ==
-==== Erfassung der Globalstrahlung ohne KostalPiko ====
+=== Erfassung der Globalstrahlung ohne KostalPiko ===
-'''Frage:'''<br />
+;Ich habe keinen KostalPiko, kann ich das Modul zur Erfassung der Globalstrahlung verwenden?
-Ich habe keinen KostalPiko, kann ich das Modul zur Erfassung der Globalstrahlung verwenden ?<br /><br />
+:Das ist möglich.<br />Hierzu alles wie im Kapitel Inbetriebnahme beschrieben parametrieren und zusätzlich das Attribut <code>disable 1</code> setzen.<br /> Damit wird KostalPiko nicht angesprochen, jedoch bei vorhandenen GR.* Attributen die Readings der Proplanta-Seite (u.a. eben auch die Globalstrahlung) dennoch erfasst.
-'''Antwort:'''<br />
-Ab Version 2.0 ist das möglich.<br />
-Hierzu alles wie im Kapitel Inbetriebnahme beschrieben parametrieren und zusätzlich das Attribut Disable 1 setzen.<br />
-Damit wird KostalPiko nicht angesprochen, jedoch bei vorhandenen GR.* Attributen die Readings der Proplanta-Seite (u.a. eben auch die Globalstrahlung) dennoch erfasst.
-==== Erfassung der Globalstrahlung für den nächsten Tag ====
+=== Erfassung der Globalstrahlung für den nächsten Tag ===
-'''Frage:'''<br />
+;Kann das Modul zur Erfassung der Globalstrahlung des nächsten Tages verwendet werden?
-Kann ich das Modul zur Erfassung der Globalstrahlung de nächsten Tages verwenden ?<br /><br />
+:Das ist möglich. Dazu muss das Attribut GR.Link von
-'''Antwort:'''<br />
+::<code>http://www.proplanta.de/Wetter/<meineStadt>-Wetter-'''Heute'''.html </code>
-Das ist möglich.
+:auf
-Man muss nur das Attribut GR.Link von <br />
+::<code>http://www.proplanta.de/Wetter/<meineStadt>-Wetter-'''Morgen'''.html </code>
-http://www.proplanta.de/Wetter/<meineStadt>-Wetter-'''Heute'''.html <br />
+:geändert werden.
-auf<br />
-http://www.proplanta.de/Wetter/<meineStadt>-Wetter-'''Morgen'''.html <br />
-ändern.
 == Links ==
 * Webseite des Herstellers [http://www.kostal-solar-electric.com Kostal]
-* [http://forum.fhem.de/index.php?t=msg&th=13508&start=0&rid=806 Forenbeitrag] zu diesem Thema
+* Forenbeitrag zu diesem {{Link2Forum|Topic=24409}}
-[[Kategorie:Other Components]]
+[[Kategorie:Wechselrichter]]
 [[Kategorie:Energieerzeugungsmessung]]