FHEMWiki - Benutzerbeiträge [de]

HourCounter

2026-04-03T12:35:03Z

Ph1959de: kleine Korrekturen und Formatierungsänderungen

{{Infobox Modul
|ModPurpose=HourCounter dient zum Zählen von Ereignissen und zur Erfassung von Betriebs-/Ruhe-Zeiten
|ModType=h
|ModForumArea=MAX
|ModTechName=98_HourCounter.pm
|ModOwner=John ([http://forum.fhem.de/index.php?action=profile;u=806 Forum] / [[Benutzer Diskussion:John|Wiki]])}}
[[HourCounter]] ist ein Perl-Modul, das die Anzahl von Ereignissen erfasst. Bei bipolaren Ereignissen wird zusätzlich die Puls- sowie die Pausendauer ermittelt. Im vorliegenden Beispiel wird ein Betriebsstundenzähler mit einem MAX-Fensterkontakt realisiert.

== Features ==
* Ermittlung von Betriebsstunden, Auslastung, Verbräuchen, Schalthäufigkeiten
* Ermittlung der Häufigkeit, Puls- Pausendauer pro Tag
* Ermittlung der Puls-/Pausendauer der letzten Schaltperiode
* Bereitstellung von Ereignissen zur Fortführung der Kumulation für Tages-, Wochen- und Monatswerte
* unterstützende Funktionen zur Ablage von Tages-, Wochen- und Monatswerten

== Zielsetzung des WIKI-Artikels ==
Erläuterung der Funktionalität zur weiterführenden Diskussion im {{Link2Forum|Topic=12216|Message=72596|LinkText=Forum}}.

== Aktuelle Version ==
Das Modul ist seit dem 24.10.2014 Bestandteil von FHEM.

== Definition ==
=== Abstrakt ===
<pre>define <name> HourCounter <regexp_for_ON> [<regexp_for_Off>]</pre>

<regexp_for_ON> ist ein regulärer Ausdruck der das Ereignis beschreibt.

Wenn auch [<regexp_for_Off>] definiert ist, so sprechen wir von einem bipolaren Ereignis, das einen
EIN- sowie einen AUS-Zustand aufweist.

<regexp_for_ON> beschreibt in diesem Fall die positive Flanke,[<regexp_for_Off>] die negative Flanke. Die Struktur des regexp-Ausdruckes ist analog zu jener beim Notify aufgebaut.

===Konkret===
<code>define CN.Test HourCounter SHUTTER.JOHN:onoff:.1 SHUTTER.JOHN:onoff:.0</code>
Hier wird der HourCounter CN.TEST definiert.
Ein MAX-Fensterkontakt mit Namen SHUTTER.JOHN wird als Ereignis-Geber verwendet.
Das Reading "onoff" wird als Trigger für unserem Zähler genutzt.
Bei den Fensterkontakten sehen diese Ereignisse wie folgt aus:
<pre>
2013-11-15 23:19:12 MAX SHUTTER.JOHN onoff: 1
....
2013-11-15 23:19:24 MAX SHUTTER.JOHN onoff: 0
</pre>

Soll ein Dummy als Ereignisgeber verwendet werden, lautet die Definition wie folgt:
:<code>define CN.Test HourCounter myDummy:1 myDummy:0</code>

Die neue Instanz weist folgende Struktur auf:

<syntaxhighlight lang="Text">
Internals:
CFGFN
DEF SHUTTER.JOHN:onoff:.1 SHUTTER.JOHN:onoff:.0
NAME CN.Test
NR 738
NTFY_ORDER 50-CN.Test
STATE 1
TYPE HourCounter
Readings:
2014-02-04 20:59:22 clearDate 2014-02-04 20:59:22
2014-02-04 20:59:57 countsOverall 1
2014-02-04 20:59:57 countsPerDay 1
2014-02-04 20:59:57 pauseTimeIncrement 35
2014-02-04 20:59:57 pauseTimeOverall 35
2014-02-04 20:59:57 pauseTimePerDay 35
2014-02-04 21:00:01 pulseTimeIncrement 4
2014-02-04 21:00:01 pulseTimeOverall 4
2014-02-04 21:00:01 pulseTimePerDay 4
2014-02-04 20:59:57 state 1
2014-02-04 21:00:00 tickHour 1
2014-02-04 21:00:01 value 0
Helper:
OFF_Regexp SHUTTER.JOHN:onoff:.0
ON_Regexp SHUTTER.JOHN:onoff:.1
calledByEvent
changedTimestamp 2014-02-04 21:00:01
forceClear
forceDayChange
forceHourChange
forceMonthChange
forceWeekChange
isFirstRun
sdRoundHourLast 1391544000
value 0
cmdQueue:
</syntaxhighlight>

Damit nicht zu viele Ereignisse in den Log-Dateien landen, kann man diese sinnvoll einschränken, so dass
nur Änderungen das Feuern von Events auslösen
:<code>attr CN.BRENNER event-on-change-reading .*</code>
Wenn sich nun jedoch über Stunden und Tage nichts ändert, sieht man in den Charts keine Daten mehr.
Mit dieser Anweisung wird erreicht, dass alle Readings nach Aktualisierung spätesten nach 1 Stunden einen Event feuern, auch wenn sich der Wert nicht ändert.
Eine Ausnahme hiervon sollen machen die tick*-Readings, deren Events sollen immer sofort gefeuert werden,
wenn sie aktualisiert werden.
<code>attr CN.BRENNER event-min-interval tick.*:0,.*:3600</code>

== Readings ==
{| class="wikitable sortable"
|-
! Reading !! class="unsortable" | Beschreibung
|-
| clearDate || Datum, zu dem alle kumulativen Readings über set .. clear gelöscht wurden
|-
| countsOverall || Absolutzähler für das Auftreten des ON-Ereignisses
|-
| countsPerDay || Tageszähler für das Auftreten des ON-Ereignisses
|-
| pauseTimeIncrement || Zeitdauer der Pausen-Phase in Sekunden ; wird zyklisch aktualisiert
|-
| pauseTimeEdge || Zeitdauer der letzten komplettierten Pausen-Phase
|-
| pauseTimeOverall || Zeitdauer in Sekunden über alle aufgetretenen Pause-Phasen
|-
| pauseTimePerDay || Zeitdauer in Sekunden über alle aufgetretenen Pause-Phasen des akt. Tages
|-
| pulseTimeIncrement || Zeitdauer der Puls-Phase in Sekunden ; wird zyklisch aktualisiert
|-
| pulseTimeEdge || Zeitdauer der letzten komplettierten Pulse-Phase
|-
| pulseTimeOverall || Zeitdauer in Sekunden über alle aufgetretenen Puls-Phasen
|-
| pulseTimePerDay || Zeitdauer in Sekunden über alle aufgetretenen Puls-Phasen des akt. Tages
|-
| value || Aktueller Schaltzustand gemäss ON/OFF Ereignis,<br />
mit 1=letztes Ereignis war ON-Ereignis <br />
und 0=letztes Ereignis war OFF-Ereignis
|-
| tickUpdated || Event wird gefeuert, wenn die operativen Readings beschrieben worden sind (nicht unbedingt gändert)
|-
| tickChanged || Event wird nach Änderung von value gefeuert
|-
| tickDay || Event wird nach Tageswechsel gefeuert bevor die Tageszähler resettiert werden
|-
| tickHour || Event wird nach Stundenwechsel gefeuert
|-
| tickWeek || Event wird nach Wochenwechsel gefeuert
|-
| tickMonth || Event wird nach Monatswechsel gefeuert
|-
| tickYear || Event wird nach Jahreswechsel gefeuert
|-
| forceHourChange || simuliert einen Stundenwechsel
|-
| forceDayChange || simuliert einen Tageswechsel
|-
| forceWeekChange || simuliert einen Wochenwechsel
|-
| forceMonthChange || simuliert einen Monatswechsel
|-
| forceYearChange || simuliert einen Jahreswechsel
|}

== Web-Oberfläche ==
[[Datei:13_11_15_HourCounter_Face.png|HourCounter]]

== Anwendung ==
Nachfolgende Darstellung zeigt das Einschaltverhalten eines Heizkessels zusammen mit den abgeleiteten Werten.

[[Datei:13_11_15_HourCounter_Chart.png]]
* die Kurve "Brenner EIN" zeigt die Trigger-Signale des ON/OFF Filters, also das Ein-/Ausschalten des Brenners
* die Kurve "Brenner-Starts" zeigt die über den Tag aufgelaufenen Starts, also chronologisch das Anwachsen von Reading countsPerDay
* die Kurve "Betriebsstunden" zeigt die aufgelaufene Zeit aus dem Reading pulseTimePerDay umgerechnet zu Stunden
* die Kurve "Dauer" zeigt die Dauer des letzten Pulses in Sekunden
* die Kurve Auslastung zeigt das Verhältnis des Readings pulseTimePerDay zur seit Tagesbeginn vergangenen Zeit.

=== Chart der Aktualwerte ===
Wir benötigen hierzu ein File-Archiv für die aufgelaufenen Daten.
:<code>define CN.Test.File FileLog ./log/CN.Test-%Y.log (CN\.Test:.*)</code>
Man erhält nach den ersten Ereignissen Einträge in folgender Form:
<syntaxhighlight lang="Text">
2013-11-16_12:45:40 CN.Test value: 1
2013-11-16_12:45:40 CN.Test 1
2013-11-16_12:46:21 CN.Test pulseTimeIncrement: 41
2013-11-16_12:46:21 CN.Test pulseTimePerDay: 41
2013-11-16_12:46:21 CN.Test pulseTimeOverall: 41
2013-11-16_12:46:21 CN.Test value: 0
2013-11-16_12:50:38 CN.Test countsPerDay: 2
2013-11-16_12:50:38 CN.Test countsOverall: 2
2013-11-16_12:50:38 CN.Test pauseTimeIncrement: 257
2013-11-16_12:50:38 CN.Test pauseTimePerDay: 756
2013-11-16_12:50:38 CN.Test pauseTimeOverall: 756
2013-11-16_12:50:38 CN.Test value: 1
2013-11-16_12:50:38 CN.Test 2
</syntaxhighlight>

Nun kann man den Chart definieren:
[[Datei:13_11_16_HourCounter_ChartBuild_01.png]]
Für die Kurve "Brenner EIN" verwenden wir CN.Test.value. Damit diese als unterste Kurve dargestellt wird transformieren wir den Wert 1 auf -2 und alle anderen (also die 0) auf -21 mit folgender Funktion:
:<code>$fld[3]=~"1"?-2:-19</code>
Die "Brenner Starts" können wir direkt von countsPerDay ableiten.

Für die "Betriebsstunden" verwenden wir pulseTimePerDay. Da diese in Sekunden vorliegen teilen wir den Wert durch 3600, um Stunden zu erhalten.
:<code>$fld[3]/=3600</code>
Als letzten versorgen wir noch die Kurve "Dauer" mit pulseTimeIncrement. Da wir diese in Minuten haben wollen, ist ebenfalls eine Umformung nötig.
:<code>$fld[3]/=60</code>

Somit sind die Basis-Kurven angelegt.

=== Erweiterungen ===
Es wurden im Forum viele Wünsche formuliert, weitere Funktionalitäten für den HourCounter einzuführen.

* Aggregation über bestimmte oder ganz freie Zeiträume
* komplexe Berechnungen, die zum Verbrauch führen
* Zuordnung von Verbräuchen zu unterschiedlichen Countern nach bestimmten Bedingungen

Vor allem die Aggregation erfasster Werte in Stunden-, Tages-, Wochen- und Monatswerten ist eine sinnvolle
Erweiterung bei der Verbrauchserfassung.

HourCounter bietet Schnittstellen an, die es ermöglichen, das Modul selbst mit neuen Eigenschaften zu erweitern.

Die Referenz-Implementierung in 99_UtilsHourCounter.pm zeigt, wie dies skript-technisch zu realisieren ist.

==== Installation ====
Die jeweils aktuelle Version von 99_UtilsHourCounter kann über diesen
[https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/99_UtilsHourCounter.pm Link] bezogen werden.

Die Datei ist in das Unterverzeichnis FHEM vom FHEM-Homverzeichnis zu kopieren.

z.B. bei Raspberry Pi: /opt/fhem/FHEM

Nach dem Kopieren und einem Neustart von FHEM kann man überprüfen, ob FHEM diese Datei findet.
Wenn man das Menü "Edit Files " anwählt, wird auch 99_UtilsHourCounter angezeigt.

==== Readings ====
99_UtilsHourCounter aus dem contrib-Verzeichnis der FHEM-Installation erweitert den HourCounter um folgende Funktionen:
{| class="wikitable sortable"
|-
! Reading !! class="unsortable" | Beschreibung
|-
| appCountsPerHour || Stundenzähler, wird bei Stundenwechsel aktualisiert
|-
| appCountsPerHourTemp || Arbeitszähler zu appCountsPerHour
|-
| appCountsPerDay || Tageszähler, wird bei Tageswechsel aktualisiert (Arbeitszähler ist countsPerDay)
|-
| appCountsPerWeek || Wochenzähler, wird bei Wochenwechsel aktualisiert
|-
| appCountsPerWeekTemp || Arbeitszähler zu appCountsPerWeek
|-
| appCountsPerMonth || Monatszähler, wird bei Monatswechsel aktualisiert
|-
| appCountsPerMonthTemp || Arbeitszähler zu appCountsPerMonth
|-
| appCountsPerYear || Jahreszähler, wird bei Jahreswechsel aktualisiert
|-
| appCountsPerYearTemp || Arbeitszähler zu appCountsPerYear
|-
| appOpHoursPerDay || Betriebsstunden des Tages
|-
| appOpHoursPerDayTemp || Arbeitszähler zu appOpHoursPerDay
|-
| appOpHoursPerWeek || Betriebsstunden der Woche
|-
| appOpHoursPerWeekTemp || Arbeitszähler zu appOpHoursPerWeek
|-
| appOpHoursPerMonth || Betriebsstunden des Monats
|-
| appOpHoursPerMonthTemp || Arbeitszähler appOpHoursPerMonth
|-
| appOpHoursPerYear || Betriebsstunden des Jahres
|-
| appOpHoursPerYearTemp || Arbeitszähler appOpHoursPerYear
|-
| appUtilization || Auslastung = pulseTimePerDay /(vergangene Sekunden seit Tagesbeginn) * 100
|-
| appUtilizationTemp || Arbeitsvariable zu appUtilization
|}
Beginn der Woche ist jeweils der Sonntag.

Mit folgender Anweisung aktivieren wir die Erweiterungen:
:<code>define CN.EVENT notify CN\..*:tick.* { appHCNotify("$NAME","$EVTPART0","$EVTPART1");;}</code>

Spätestens nach einer steigenden und einer fallenden Flanke sind die zuvor genannten app*-Readings zu sehen.
{{Randnotiz|RNTyp=Info|RNText=Die gezeigten define-Anweisungen müssen jeweils in einer Zeile stehen (keine Zeilenumbrüche!).}}

Die neuen Readings werden automatisch in den "Setter" der Web-Oberflächen aufgenommen. Dies gilt für alle Readings, die mit "app" beginnen.

Somit können die neuen Readings beliebig manipuliert werden.

===== Für Anfänger, die noch keine Erfahrungen mit Regular Expressions haben:=====
Benennt eure Hourcounter nach dem Muster CN.<euer Wunschname>. Dann wird der notify immer funktionieren.

Beispiel: statt "PelletsCounter" wählt den Namen "CN.PelletsCounter"

==== Archiv für Tages-/Wochen-/Monats-/Jahreswerte anlegen ====
Nun wollen wir die aggregierten Werte in eine eigene Datei speichern. Dies gelingt mit
:<code>define CN.Test.FileDay FileLog ./log/CN.Test-Day-%Y.log CN.Test:app\w*(Utilization|PerHour|PerDay|PerWeek|PerMonth|PerYear)(?!Temp).* </code>

Im Klartext:
* verwende alle Werte des Counters CN.Test, deren Reading mit "app" beginnt
* und die einen der Terme appUtilization|PerHour|PerDay|PerWeek|PerMonth|PerYear beinhalten
* und die danach nicht dem Term "Temp" beinhalten

== Fragen und Antworten ==
==== Betriebsstundenzähler über Leistungsmessung ableiten ====
'''Frage:'''
Ich würde gerne zählen, wenn ich mehr Strom als Standy verbrauche (also mehr als 2 Watt)
und keine Betriebsstunden zählen, wenn der Verbrauch unter 2 Watt ist. Ist das möglich?

<u>Beispiel für die Events</u>
<pre>
013-11-18_19:40:32 XXX power: 1.9
2013-11-18_19:40:32 XXX consumption: 2
2013-11-18_19:40:32 XXX consumptionTotal: 2
2013-11-18_19:40:36 XXX power: 27
2013-11-18_19:40:36 XXX consumption: 2
2013-11-18_19:40:36 XXX consumptionTotal: 2
2013-11-18_19:40:42 XXX power: 34.6
2013-11-18_19:40:42 XXX consumption: 2
</pre>

'''Antwort'''
Die hier vorgestellte Lösung überprüft, ob der Wert des Events power eine oder zwei Ziffern vor dem Komma hat.
Deshalb wir hier erst gezählt, wenn die Schwelle von 10Watt überschritten wird.
<pre>
define CN.Test HourCounter XXX:power:\s[0-9]{2,}(\.[0-9]{1,3})*$ XXX:power:\s[0-9]{1}(\.[0-9]{1,3})*$
</pre>
Erläuterung zu <code><regexp_for_ON> = XXX:power:\s[0-9]{2,}(\.[0-9]{1,3})*$</code>
* "XXX" bezeichnet das Device, der Term danach ist der regexp-Filte für das On-Ereignis
* "power:" das Ereignis muss mit diesem Term beginnen
* "\s" es muss ein Leerzeichen folgen
* "[0-9]{2,}" es müssen mindestens 2 Ziffern folgen
* "(\.[0-9]{1,3})*" wenn ein Punkt folgt, dann müssen auf diesen mindestens 1..3 Ziffern folgen
* "$" danach darf kein weiteres Zeichen mehr folgen

'''Antwort Möglichkeit 2'''
In dieser Lösung bekommt das entsprechende Device, das mit HourCounter überwacht werden soll, ein [[userReadings]] "onoff". Dieses Reading wird dann zum Schalten von Hour Counter verwendet:
<pre>
define GPIO4_DS18B20_Waermepumpe_Vorlauf GPIO4 28-000005956079
attr GPIO4_DS18B20_Waermepumpe_Vorlauf alias Wärmepumpe Vorlauf
attr GPIO4_DS18B20_Waermepumpe_Vorlauf model DS18B20
attr GPIO4_DS18B20_Waermepumpe_Vorlauf room GPIO4
attr GPIO4_DS18B20_Waermepumpe_Vorlauf userReadings onoff {(ReadingsVal("GPIO4_DS18B20_Waermepumpe_Vorlauf","temperature",0) >28)?1:0;;}

define Waermepumpe_HourCounter HourCounter GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.1 GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.0
attr Waermepumpe_HourCounter room 2_Fussbodenheizung
</pre>
Erläuterungen zu dem Code: <code>{(ReadingsVal("GPIO4_DS18B20_Waermepumpe_Vorlauf","temperature",0) >28)?1:0;;}</code>
* <code>(ReadingsVal("GPIO4_DS18B20_Waermepumpe_Vorlauf","temperature",0) >28)</code> Diese Bedingung für das userReadings onoff prüft bei jedem Event, ob der Wert von temperature größer als 28 ist.
* <code>?1:0</code> Ist dies der Fall wird das userReading onoff auf 1 gesetzt andernfalls auf 0.
Auf Basis deses UserReadings wird dann der HourCounter definiert:
* <code>GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.1</code> Einschaltbedingung für HourCounter
* <code>GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.0</code> Abschaltbedingung für Hour Counter

==== Welche Anwendungsfälle sind denkbar ? ====
{{Link2Forum|Topic=12216|Message=175163|LinkText=Aus dem Forum}}
* Betriebsstundenzähler für meine "Fliegenkiller-Steckdose"
* Nutzungsdauer beschränken für TV,Internet oder Spielkonsolen für entnervte Eltern
* Nutzungsdauer ermitteln zur Energieeinsparung (Klimageräte, Ventilatoren, Dunstabzugshauben etc.)
* Lüftungsverhalten ermitteln (wie lange Fenster pro Tag geöffnet)

{{Link2Forum|Topic=12216|Message=195358|LinkText=Brenner Starts/Verbrauch + akkumulierte Werte}}

{{Link2Forum|Topic=12216|Message=196358|LinkText=Ölverbrauch+Solar-Ladung}}

[http://voizchat.de/gaszaehler-verbrauch-erfassen-mit-fhem-und-raspberry-gpio/ Gaszähler mit HourCounter realisieren] (URL tot)

==== Seltene Schaltvorgänge ====
Die Schaltvorgänge sind über den Tag sehr wenige. Die Aktualisierung erfolgt immer erst bei der negativen Flanke. Wie kann man eine häufigere Aktualisierung erreichen ?

'''Antwort'''

Ab Version 1.0.0.6 ist wurde das Attribut "interval" eingeführt; es ist auf 60 Minuten voreingestellt und kann von 5..60 im 5 Minuten-Raster festgelegt werden.
Es bestimmt, nach welcher Zeit Puls-/Pausendauer aktualisiert werden sollen, unabhängig vom Auftreten einer Schaltflanke.

==== Korrekte Darstellung der akkumulierten Daten im Chart ====
'''Frage'''

"appCountsPerDay: 4" bezieht sich auf die Counts des Tages 2014-06-16, trägt aber selbst den Zeitstempel 2014-06-17 und wird demnach in einem Chart auch über den Tag " 2014-06-17" dargestellt.
Das Problem betrifft alle akkumulierten Daten des HourCounters.
Wie erreicht man im Chart die korrekte Darstellung ?

'''Antwort'''

Das Thema wurde {{Link2Forum|Topic=12216|Message=239929|LinkText=hier}} diskutiert.
Eine Lösung findet man mit [[LogProxy]]. Damit läßt sich ein negativer Offset für die X-Achse definieren, so dass die Daten wieder korrekt dargestellt werden.

[[Kategorie:MAX]]
[[Kategorie:HOWTOS]]
[[Kategorie:Heizungssteuerung]]

HourCounter

2026-03-31T16:47:18Z

Ph1959de: kleine Korrekturen

{{Infobox Modul
|ModPurpose=HourCounter dient zum Zählen von Ereignissen und zur Erfassung von Betriebs-/Ruhe-Zeiten
|ModType=h

|ModForumArea=MAX
|ModTechName=98_HourCounter.pm
|ModOwner=John ([http://forum.fhem.de/index.php?action=profile;u=806 Forum] / [[Benutzer Diskussion:John|Wiki]])}}

[[HourCounter]] ist ein Perl-Modul, das die Anzahl von Ereignissen erfasst. Bei bipolaren Ereignissen wird zusätzlich die Puls- sowie die Pausendauer ermittelt. Im vorliegenden Beispiel wird ein Betriebsstundenzähler mit einem MAX-Fensterkontakt realisiert.

== Features ==
* Ermittlung von Betriebsstunden, Auslastung, Verbräuchen, Schalthäufigkeiten
* Ermittlung der Häufigkeit, Puls- Pausendauer pro Tag
* Ermittlung der Puls-/Pausendauer der letzten Schaltperiode
* Bereitstellung von Ereignissen zur Fortführung der Kumulation für Tages-, Wochen- und Monatswerte
* unterstützende Funktionen zur Ablage von Tages-, Wochen- und Monatswerten

== Zielsetzung des WIKI-Artikels ==
Erläuterung der Funktionalität zur weiterführenden Diskussion im {{Link2Forum|Topic=12216|Message=72596|LinkText=Forum}}.

== Aktuelle Version ==
Das Modul ist seit dem 24.10.2014 Bestandteil von FHEM.

== Definition ==
=== Abstrakt ===
<pre>define <name> HourCounter <regexp_for_ON> [<regexp_for_Off>]</pre>

<regexp_for_ON> ist ein regulärer Ausdruck der das Ereignis beschreibt.

Wenn auch [<regexp_for_Off>] definiert ist, so sprechen wir von einem bipolarem Ereignis, das einen
EIN- sowie einen AUS-Zustand aufweist.

<regexp_for_ON> beschreibt in diesem Fall die positive Flanke,[<regexp_for_Off>] die negative Flanke. Die Struktur des regexp-Ausdruckes ist analog zu jener beim Notify aufgebaut.

===Konkret===
<pre>define CN.Test HourCounter SHUTTER.JOHN:onoff:.1 SHUTTER.JOHN:onoff:.0</pre>
Hier wird der HourCounter CN.TEST definiert.
Ein MAX-Fensterkontakt mit Namen SHUTTER.JOHN wird als Ereignis-Geber verwendet.
Das Reading "onoff" wird als Trigger für unserem Zähler genutzt.
Bei den Fensterkontakten sehen diese Ereignisse wie folgt aus:
<pre>
2013-11-15 23:19:12 MAX SHUTTER.JOHN onoff: 1
....
2013-11-15 23:19:24 MAX SHUTTER.JOHN onoff: 0
</pre>

Soll ein Dummy als Ereignisgeber verwendet werden, lautet die Definition wie folgt:
<pre> define CN.Test HourCounter myDummy:1 myDummy:0</pre>

Die neue Instanz weist folgende Struktur auf:

<pre>
Internals:
CFGFN
DEF SHUTTER.JOHN:onoff:.1 SHUTTER.JOHN:onoff:.0
NAME CN.Test
NR 738
NTFY_ORDER 50-CN.Test
STATE 1
TYPE HourCounter
Readings:
2014-02-04 20:59:22 clearDate 2014-02-04 20:59:22
2014-02-04 20:59:57 countsOverall 1
2014-02-04 20:59:57 countsPerDay 1
2014-02-04 20:59:57 pauseTimeIncrement 35
2014-02-04 20:59:57 pauseTimeOverall 35
2014-02-04 20:59:57 pauseTimePerDay 35
2014-02-04 21:00:01 pulseTimeIncrement 4
2014-02-04 21:00:01 pulseTimeOverall 4
2014-02-04 21:00:01 pulseTimePerDay 4
2014-02-04 20:59:57 state 1
2014-02-04 21:00:00 tickHour 1
2014-02-04 21:00:01 value 0
Helper:
OFF_Regexp SHUTTER.JOHN:onoff:.0
ON_Regexp SHUTTER.JOHN:onoff:.1
calledByEvent
changedTimestamp 2014-02-04 21:00:01
forceClear
forceDayChange
forceHourChange
forceMonthChange
forceWeekChange
isFirstRun
sdRoundHourLast 1391544000
value 0
cmdQueue:
</pre>

Damit nicht zu viele Ereignisse in den Log-Dateien landen, kann man diese sinnvoll einschränken, so daß
nur Änderungen das Feuern von Events auslösen
<pre>
attr CN.BRENNER event-on-change-reading .*
</pre>
Wenn sich nun jedoch über Stunden und Tage nichts ändert, sieht man in den Charts keine Daten mehr.
Mit dieser Anweisung wird erreicht, daß alle Readings nach Aktualisierung spätesten nach 1 Stunden einen Event feuern, auch wenn sich der Wert nicht ändert.
Eine Ausnahme hiervon sollen machen die tick*-Readings, deren Events sollen immer sofort gefeuert werden,
wenn sie aktualisiert werden.
<pre>
attr CN.BRENNER event-min-interval tick.*:0,.*:3600
</pre>

== Readings ==
{| class="wikitable sortable"
|-
! Reading !! class="unsortable" | Beschreibung
|-
| clearDate || Datum, zu dem alle kumulativen Readings über set .. clear gelöscht wurden
|-
| countsOverall || Absolutzähler für das Auftreten des ON-Ereignisses
|-
| countsPerDay || Tageszähler für das Auftreten des ON-Ereignisses
|-
| pauseTimeIncrement || Zeitdauer der Pausen-Phase in Sekunden ; wird zyklisch aktualisiert
|-
| pauseTimeEdge || Zeitdauer der letzten komplettierten Pausen-Phase
|-
| pauseTimeOverall || Zeitdauer in Sekunden über alle aufgetretenen Pause-Phasen
|-
| pauseTimePerDay || Zeitdauer in Sekunden über alle aufgetretenen Pause-Phasen des akt. Tages
|-
| pulseTimeIncrement || Zeitdauer der Puls-Phase in Sekunden ; wird zyklisch aktualisiert
|-
| pulseTimeEdge || Zeitdauer der letzten komplettierten Pulse-Phase
|-
| pulseTimeOverall || Zeitdauer in Sekunden über alle aufgetretenen Puls-Phasen
|-
| pulseTimePerDay || Zeitdauer in Sekunden über alle aufgetretenen Puls-Phasen des akt. Tages
|-
| value || Aktueller Schaltzustand gemäss ON/OFF Ereignis,<br />
mit 1=letztes Ereignis war ON-Ereignis <br />
und 0=letztes Ereignis war OFF-Ereignis
|-
| tickUpdated || Event wird gefeuert, wenn die operativen Readings beschrieben worden sind (nicht unbedingt gändert)
|-
| tickChanged || Event wird nach Änderung von value gefeuert
|-
| tickDay || Event wird nach Tageswechsel gefeuert bevor die Tageszähler resettiert werden
|-
| tickHour || Event wird nach Stundenwechsel gefeuert
|-
| tickWeek || Event wird nach Wochenwechsel gefeuert
|-
| tickMonth || Event wird nach Monatswechsel gefeuert
|-
| tickYear || Event wird nach Jahreswechsel gefeuert
|-
| forceHourChange || simuliert einen Stundenwechsel
|-
| forceDayChange || simuliert einen Tageswechsel
|-
| forceWeekChange || simuliert einen Wochenwechsel
|-
| forceMonthChange || simuliert einen Monatswechsel
|-
| forceYearChange || simuliert einen Jahreswechsel
|}

== Web-Oberfläche ==
[[Datei:13_11_15_HourCounter_Face.png|HourCounter]]

== Anwendung ==
Nachfolgende Darstellung zeigt das Einschaltverhalten eines Heizkessels zusammen mit den
abgeleiteten Werten.

[[Datei:13_11_15_HourCounter_Chart.png]]

* die Kurve "Brenner EIN" zeigt die Trigger-Signale des ON/OFF Filters, also das Ein-/Ausschalten des Brenners
* die Kurve "Brenner-Starts" zeigt die über den Tag aufgelaufenen Starts, also chronologisch das Anwachsen von Reading countsPerDay
* die Kurve "Betriebsstunden" zeigt die aufgelaufene Zeit aus dem Reading pulseTimePerDay umgerechnet zu Stunden
* die Kurve "Dauer" zeigt die Dauer des letzten Pulses in Sekunden
* die Kurve Auslastung zeigt das Verhältnis des Readings pulseTimePerDay zur seit Tagesbeginn vergangenen Zeit.

=== Chart der Aktualwerte ===
Wir benötigen hierzu ein File-Archiv für die aufgelaufenen Daten.
<pre>define CN.Test.File FileLog ./log/CN.Test-%Y.log (CN\.Test:.*)</pre>
Man erhält nach den ersten Ereignissen Einträge in folgender Form:
<pre>
2013-11-16_12:45:40 CN.Test value: 1
2013-11-16_12:45:40 CN.Test 1
2013-11-16_12:46:21 CN.Test pulseTimeIncrement: 41
2013-11-16_12:46:21 CN.Test pulseTimePerDay: 41
2013-11-16_12:46:21 CN.Test pulseTimeOverall: 41
2013-11-16_12:46:21 CN.Test value: 0
2013-11-16_12:50:38 CN.Test countsPerDay: 2
2013-11-16_12:50:38 CN.Test countsOverall: 2
2013-11-16_12:50:38 CN.Test pauseTimeIncrement: 257
2013-11-16_12:50:38 CN.Test pauseTimePerDay: 756
2013-11-16_12:50:38 CN.Test pauseTimeOverall: 756
2013-11-16_12:50:38 CN.Test value: 1
2013-11-16_12:50:38 CN.Test 2
</pre>

Nun kann man den Chart definieren:
[[Datei:13_11_16_HourCounter_ChartBuild_01.png]]

Für die Kurve "Brenner EIN" verwenden wir CN.Test.value. Damit diese als unterste Kurve dargestellt wird transformieren wir den Wert 1 auf -2 und alle anderen (also die 0) auf -21 mit folgender Funktion:
<pre>$fld[3]=~"1"?-2:-19</pre>
Die "Brenner Starts" können wir direkt von countsPerDay ableiten.<br /><br />
Für die "Betriebsstunden" verwenden wir pulseTimePerDay. Da diese in Sekunden vorliegen teilen wir den Wert durch 3600, um Stunden zu erhalten.
<pre>$fld[3]/=3600</pre>
Als letzten versorgen wir noch die Kurve "Dauer" mit pulseTimeIncrement. Da wir diese in Minuten haben wollen ist ebenfalls eine Umformung nötig.
<pre>$fld[3]/=60</pre>

Somit sind die Basis-Kurven angelegt.

=== Erweiterungen ===
Es wurden im Forum viele Wünsche formuliert, weitere Funktionalitäten für den HourCounter einzuführen.

* Aggregation über bestimmte oder ganz freie Zeiträume
* komplexe Berechnungen, die zum Verbrauch führen
* Zuordnung von Verbräuchen zu unterschiedlichen Countern nach bestimmten Bedingungen

Vor allem die Aggregation erfasster Werte in Stunden-, Tages-, Wochen- und Monatswerten ist eine sinnvolle
Erweiterung bei der Verbrauchserfassung.

HourCounter bietet Schnittstellen an, die es ermöglichen, das Modul selbst mit neuen Eigenschaften zu erweitern.

Die Referenz-Implementierung in 99_UtilsHourCounter.pm zeigt, wie dies skript-technisch zu realisieren ist.

==== Installation ====
Die jeweils aktuelle Version von 99_UtilsHourCounter kann über diesen
[https://svn.fhem.de/trac/export/HEAD/trunk/fhem/contrib/99_UtilsHourCounter.pm Link] bezogen werden.
<br /><br />
Die Datei ist in das Unterverzeichnis FHEM vom FHEM-Homverzeichnis zu kopieren.
<br />
z.B. bei Raspberry Pi: /opt/fhem/FHEM
<br /><br />
Nach dem Kopieren und einem Neustart von FHEM kann man überprüfen, ob FHEM diese Datei findet.
Wenn man das Menü "Edit Files " anwählt, wird auch 99_UtilsHourCounter angezeigt.

==== Readings ====
99_UtilsHourCounter aus dem contrib-Verzeichnis der FHEM-Installation erweitert den HourCounter um folgende Funktionen:
{| class="wikitable sortable"
|-
! Reading !! class="unsortable" | Beschreibung
|-
| appCountsPerHour || Stundenzähler, wird bei Stundenwechsel aktualisiert
|-
| appCountsPerHourTemp || Arbeitszähler zu appCountsPerHour
|-
| appCountsPerDay || Tageszähler, wird bei Tageswechsel aktualisiert (Arbeitszähler ist countsPerDay)
|-
| appCountsPerWeek || Wochenzähler, wird bei Wochenwechsel aktualisiert
|-
| appCountsPerWeekTemp || Arbeitszähler zu appCountsPerWeek
|-
| appCountsPerMonth || Monatszähler, wird bei Monatswechsel aktualisiert
|-
| appCountsPerMonthTemp || Arbeitszähler zu appCountsPerMonth
|-
| appCountsPerYear || Jahreszähler, wird bei Jahreswechsel aktualisiert
|-
| appCountsPerYearTemp || Arbeitszähler zu appCountsPerYear
|-
| appOpHoursPerDay || Betriebsstunden des Tages
|-
| appOpHoursPerDayTemp || Arbeitszähler zu appOpHoursPerDay
|-
| appOpHoursPerWeek || Betriebsstunden der Woche
|-
| appOpHoursPerWeekTemp || Arbeitszähler zu appOpHoursPerWeek
|-
| appOpHoursPerMonth || Betriebsstunden des Monats
|-
| appOpHoursPerMonthTemp || Arbeitszähler appOpHoursPerMonth
|-
| appOpHoursPerYear || Betriebsstunden des Jahres
|-
| appOpHoursPerYearTemp || Arbeitszähler appOpHoursPerYear
|-
| appUtilization || Auslastung = pulseTimePerDay /(vergangene Sekunden seit Tagesbeginn) * 100
|-
| appUtilizationTemp || Arbeitsvariable zu appUtilization
|}
Beginn der Woche ist jeweils der Sonntag.<br />

Mit folgender Anweisung aktivieren wir die Erweiterungen:
:<code>define CN.EVENT notify CN\..*:tick.* { appHCNotify("$NAME","$EVTPART0","$EVTPART1");;}</code>

Spätestens nach einer steigenden und einer fallenden Flanke sind die zuvor genannten app*-Readings zu sehen.
{{Randnotiz|RNTyp=Info|RNText=Die gezeigten define-Anweisungen müssen jeweils in einer Zeile stehen (keine Zeilenumbrüche!).}}

Die neuen Readings werden automatisch in den "Setter" der Web-Oberflächen aufgenommen. Dies gilt für alle Readings, die mit "app" beginnen.

Somit können die neuen Readings beliebig manipuliert werden.

===== Für Anfänger, die noch keine Erfahrungen mit Regular Expressions haben:=====
Benennt eure Hourcounter nach dem Muster CN.<euer Wunschname>. Dann wird der notify immer funktionieren.

Beispiel: statt "PelletsCounter" wählt den Namen "CN.PelletsCounter"

==== Archiv für Tages-/Wochen-/Monats-/Jahreswerte anlegen ====
Nun wollen wir die aggregierten Werte in eine eigene Datei speichern. Dies gelingt mit
:<code>define CN.Test.FileDay FileLog ./log/CN.Test-Day-%Y.log CN.Test:app\w*(Utilization|PerHour|PerDay|PerWeek|PerMonth|PerYear)(?!Temp).* </code>

Im Klartext:
* verwende alle Werte des Counters CN.Test, deren Reading mit "app" beginnt
* und die einen der Terme appUtilization|PerHour|PerDay|PerWeek|PerMonth|PerYear beinhalten
* und die danach nicht dem Term "Temp" beinhalten

== Fragen und Antworten ==
==== Betriebsstundenzähler über Leistungsmessung ableiten ====
'''Frage:'''
Ich würde gerne zählen, wenn ich mehr Strom als Standy verbrauche (also mehr als 2 Watt)
und keine Betriebsstunden zählen, wenn der Verbrauch unter 2 Watt ist. Ist das möglich?

<u>Beispiel für die Events</u>
<pre>
013-11-18_19:40:32 XXX power: 1.9
2013-11-18_19:40:32 XXX consumption: 2
2013-11-18_19:40:32 XXX consumptionTotal: 2
2013-11-18_19:40:36 XXX power: 27
2013-11-18_19:40:36 XXX consumption: 2
2013-11-18_19:40:36 XXX consumptionTotal: 2
2013-11-18_19:40:42 XXX power: 34.6
2013-11-18_19:40:42 XXX consumption: 2
</pre>

'''Antwort'''
Die hier vorgestellte Lösung überprüft, ob der Wert des Events power eine oder zwei Ziffern vor dem Komma hat.
Deshalb wir hier erst gezählt, wenn die Schwelle von 10Watt überschritten wird.
<pre>
define CN.Test HourCounter XXX:power:\s[0-9]{2,}(\.[0-9]{1,3})*$ XXX:power:\s[0-9]{1}(\.[0-9]{1,3})*$
</pre>
Erläuterung zu <regexp_for_ON> = XXX:power:\s[0-9]{2,}(\.[0-9]{1,3})*$
* "XXX" bezeichnet das Device, der Term danach ist der regexp-Filte für das On-Ereignis
* "power:" das Ereignis muss mit diesem Term beginnen
* "\s" es muss ein Leerzeichen folgen
* "[0-9]{2,}" es müssen mindestens 2 Ziffern folgen
* "(\.[0-9]{1,3})*" wenn ein Punkt folgt, dann müssen auf diesen mindestens 1..3 Ziffern folgen
* "$" danach darf kein weiteres Zeichen mehr folgen

'''Antwort Möglichkeit 2'''
In dieser Lösung bekommt das entsprechende Device, das mit HourCounter überwacht werden soll, ein [[userReadings]] "onoff". Dieses Reading wird dann zum Schalten von Hour Counter verwendet:
<pre>
define GPIO4_DS18B20_Waermepumpe_Vorlauf GPIO4 28-000005956079
attr GPIO4_DS18B20_Waermepumpe_Vorlauf alias Wärmepumpe Vorlauf
attr GPIO4_DS18B20_Waermepumpe_Vorlauf model DS18B20
attr GPIO4_DS18B20_Waermepumpe_Vorlauf room GPIO4
attr GPIO4_DS18B20_Waermepumpe_Vorlauf userReadings onoff {(ReadingsVal("GPIO4_DS18B20_Waermepumpe_Vorlauf","temperature",0) >28)?1:0;;}

define Waermepumpe_HourCounter HourCounter GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.1 GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.0
attr Waermepumpe_HourCounter room 2_Fussbodenheizung
</pre>
Erläuterungen zu dem Code: "{(ReadingsVal("GPIO4_DS18B20_Waermepumpe_Vorlauf","temperature",0) >28)?1:0;;}"
* "(ReadingsVal("GPIO4_DS18B20_Waermepumpe_Vorlauf","temperature",0) >28)" Diese Bedingung für das userReadings onoff prüft bei jedem Event, ob der Wert von temperature größer als 28 ist.
* "?1:0" Ist dies der Fall wird das userReading onoff auf 1 gesetzt andernfalls auf 0.
Auf Basis deses UserReadings wird dann der HourCounter definiert:
* "GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.1" Einschaltbedingung für HourCounter
* "GPIO4_DS18B20_Waermepumpe_Vorlauf:onoff:.0" Abschaltbedingung für Hour Counter

==== Welche Anwendungsfälle sind denkbar ? ====
{{Link2Forum|Topic=12216|Message=175163|LinkText=Aus dem Forum}}
* Betriebsstundenzähler für meine "Fliegenkiller-Steckdose"
* Nutzungsdauer beschränken für TV,Internet oder Spielkonsolen für entnervte Eltern
* Nutzungsdauer ermitteln zur Energieeinsparung (Klimageräte, Ventilatoren, Dunstabzugshauben etc.)
* Lüftungsverhalten ermitteln (wie lange Fenster pro Tag geöffnet)

{{Link2Forum|Topic=12216|Message=195358|LinkText=Brenner Starts/Verbrauch + akkumulierte Werte}}

{{Link2Forum|Topic=12216|Message=196358|LinkText=Ölverbrauch+Solar-Ladung}}

[http://voizchat.de/gaszaehler-verbrauch-erfassen-mit-fhem-und-raspberry-gpio/ Gaszähler mit HourCounter realisieren] (URL tot)

==== Seltene Schaltvorgänge ====
Die Schaltvorgänge sind über den Tag sehr wenige. Die Aktualisierung erfolgt immer erst bei der negativen Flanke. Wie kann man eine häufigere Aktualisierung erreichen ?

'''Antwort'''

Ab Version 1.0.0.6 ist wurde das Attribut "interval" eingeführt; es ist auf 60 Minuten voreingestellt und kann von 5..60 im 5 Minuten-Raster festgelegt werden.
Es bestimmt, nach welcher Zeit Puls-/Pausendauer aktualisiert werden sollen, unabhängig vom Auftreten einer Schaltflanke.

==== Korrekte Darstellung der akkumulierten Daten im Chart ====
'''Frage'''

"appCountsPerDay: 4" bezieht sich auf die Counts des Tages 2014-06-16, trägt aber selbst den Zeitstempel 2014-06-17 und wird demnach in einem Chart auch über den Tag " 2014-06-17" dargestellt.
Das Problem betrifft alle akkumulierten Daten des HourCounters.
Wie erreicht man im Chart die korrekte Darstellung ?

'''Antwort'''

Das Thema wurde {{Link2Forum|Topic=12216|Message=239929|LinkText=hier}} disktuiert.
Eine Lösung findet man mit [[LogProxy]]. Damit läßt sich ein negativer Offset für die X-Achse definieren, so dass die Daten wieder korrekt dargestellt werden.

[[Kategorie:MAX]]
[[Kategorie:HOWTOS]]
[[Kategorie:Heizungssteuerung]]

UserReadings

2026-03-31T16:39:33Z

Ph1959de: kleine Korrekturen

{{SEITENTITEL:userReadings}} 
Über das Attribut [[userReadings]] können bei einem Device benutzerdefinierte [[reading|readings]] einschließlich der Anweisungen zum Befüllen derselben festgelegt werden. Das können zum Einen Formatänderungen ("sprintf"), oder aber auch durch die ''Modifier''
* difference
* differential
* integral
* offset
* monotonic
gesteuerte Berechnungen sein.

== Syntax ==
{{Randnotiz|RNTyp=y|RNText='''Geändertes Verhalten - bitte beachten'''
Im April 2016 hat sich die Verarbeitung des ''Triggers'' dahingehend geändert, dass die Trigger-Spezifikation jetzt als [[Regulärer Ausdruck]] interpretiert wird, damit also z.B. ein <code>avgTemp:temperature</code> geändert werden muss in <code>avgTemp:temperature.*</code>.

Technische Details dazu wurden in {{Link2Forum|Topic=52165|LinkText=diesem Forenthread}} diskutiert.}}
Siehe {{Link2CmdRef|Anker=readingFnAttributes}}.

* Bei Eingabe im Editor-Feld müssen mehrere Befehle mit einem ";" getrennt werden, bei Änderung in der Eingabezeile sind zwei ";" notwendig.
* Die Variable, dessen Wert man im Reading haben möchte, kann man einfach ans Ende stellen[https://perldoc.perl.org/functions/return.html]
* mehrere UserReadings werden durch Komma getrennt.

:<code>myreading {my $v = ReadingsVal($name,"actuation","error")+62; fhem("set PID desired $v"); $v},</code>
:<code>myreading2 {my $v = ReadingsVal($name,"actuation","error")+62; fhem("set PID2 desired $v"); $v}</code>

== Beispiele ==
{{Randnotiz|RNTyp=g|RNText=Die nachfolgenden Beispiele sind ohne Trigger notiert. In der Regel sollte jedoch geprüft werden, ob nicht ein solcher Trigger gesetzt werden kann. Dies ist insbesondere in den Fällen sinnvoll, in denen in einem Gerät sehr viele Readings vorhanden sind, die ggf. zu unterschiedlichen Zeitpunkten aktualisiert werden. Das erste Beispiel wäre daher besser so zu schreiben:<br><code>attr ElbePegelSchoena userReadings Pegel:value.* { ReadingsVal("ElbePegelSchoena","value",0) }</code> }}
==== Ein Reading soll einen anderen Namen bekommen ====
Das vorhandene Reading "value" des Devices "ElbePegelSchoena" soll künftig in "Pegel" umbenannt werden. Das geht nicht. Man kann aber ein neues Reading "Pegel" mit genau gleichem Wert erzeugen:
:<code>attr ElbePegelSchoena userReadings Pegel { ReadingsVal("ElbePegelSchoena","value",0) }</code>

==== Ausgabe eines Homematic 3-State Fenstersensor als Zahl für Visualisierung mit Icons ====
:<code><nowiki>attr HM_XXXXXX userReadings Statenum {if(ReadingsVal("HM_XXXXXX","state","") eq "closed") {return 0} elsif (ReadingsVal("HM_XXXXXX","state","") eq "tilted") {return 1} elsif (ReadingsVal("HM_XXXXXX","state","") eq "open") {return 2} else {return -1}}</nowiki></code>

==== Ausgabe als Moving Average und Formatierung mit sprintf ====
:<code>attr HZ_EINSTRAHLUNG_RAW userReadings Einstr_Mean.av {sprintf("%.1f",movingAverage("HZ_EINSTRAHLUNG_RAW","reading",1200))}</code>

==== Umrechnung der Temperatur (durch 10 geteilt) und Einheit [°C] angehängt ====
:<code>attr HZ_EINSTRAHLUNG_T userReadings SolarTemp {ReadingsVal("HZ_EINSTRAHLUNG_T","reading",0)/10 ." °C"}</code>

==== Batterieüberwachung durch Erweiterung mit notify und userReading ====
... ist im Detail auf der Seite [[Batterieüberwachung]] beschrieben.

==== Integralfunktion - integral ====
Die Verwendung der Integralfunktion bei ''userReadings'' ist ausführlich im Forenbeitrag {{Link2Forum|Topic=26300|Message=193084|LinkText=Integralfunktion bei UserReadings}} erklärt.

==== Trigger ====
Die Trigger-Regex muss ein Event inklusive Wert matchen. Hier soll ''countTotalSum'' um den Wert im Reading ''count'' erhöht werden, natürlich nur, wenn ein Event für das Reading ''count'' eintrifft, damit der Wert nur einmal hinzu addiert wird. (Alle anderen Events werden ignoriert.) Hier ist auf das Wortende zu achten "'''\b'''" in der Regex, damit z.B. Events für ''count1'', ''count2'', ... keinen Trigger auslösen. (Hinweis: Beim Bilden der Summe kann die Benutzung von event-on-change-reading zu falschen Ergebnissen führen.)
:<code>attr GasPulseCounter userReadings countTotalSum:count\b.* {my $val=ReadingsVal($name,"countTotalSum",0)+ReadingsVal($name,"count",0);;$val}</code>

Hier wird die Anzahl der Events für ''count'' gezählt. Events für Readingnamen, welche lediglich mit ''count'' beginnen, werden ignoriert wegen "\b".
:<code>attr GasPulseCounter userReadings inc:count\b.* {my $val=ReadingsVal($name,"inc",0)+1;;$val}</code>

Zusätzlich kann der Trigger auf einen bestimmten Wert beschränkt werden. Hier wird jedes Auftreten des Wertes "5" gezählt.
:<code>attr GasPulseCounter userReadings inc:count:.5 {my $val=ReadingsVal($name,"inc",0)+1;;$val}</code>

== Links ==
* {{Link2CmdRef|Lang=de|Anker=userReadings}} - userReadings

[[Kategorie:Attribut (allgemeingültig)]]

Benutzer Diskussion:0bones

2026-03-21T09:02:33Z

Ph1959de: Willkommen

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo 0bones,''' willkommen im FHEM Wiki!</span></big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 10:02, 21. Mär. 2026 (CET)
|}

Mi vacuum

2026-02-26T14:41:58Z

Ph1959de: Sichtung der letzten Änderungen; kleinere Korrekturen

{{Todo|Aktualiserung / Text weniger flapsig formulieren / Einbindung Info-Box. Information, die generell für das Modul [[XiaomiDevice]] gilt, sollte auf die Modulseite "verschoben" werden.}}

=Mi Vacuum=
Wie der preiswerte Staubsaugerroboter auch auf FHEM hört...

==Für wen ist die Anleitung gedacht?==
Ich gehe davon aus, dass ihr ein funktionierendes FHEM auf einem Linux Rechner (Debian) betreibt.

Weiterhin denke ich, dass euer Hauptarbeitsrechner unter Windows läuft.

Als Smartphone OS Android (wer Apple hat, kann gerne die Token-Auslese-Geschichte hier beschreiben).

Um das Teil auch von Alexa aus ein und aus zu schalten, sollte auch die Installation von Alexa in FHEM fertig sein.

==Die Einrichtung des Moduls==
===Vorarbeiten (Linux)===
Zunächst fangen wir mal auf unserem FHEM Rechner an. Mit Putty verbinden wir uns per SSH mit dem FHEM Computer (Todo: Das ist hier ist für Windows-Nutzer...)

Folgende Befehle können benötigt werden (Debian):
* <code>sudo apt-get install libjson-perl</code>
* <code>sudo apt-get install libdigest-md5-perl</code>
* <code>sudo apt-get install libcrypt-cbc-perl</code>
* <code>sudo apt install libcryptx-perl</code>

* <code>sudo apt-get install libcrypt-ecb-perl</code> (nur nötig, wenn ihr einen verschlüsselten Token mit 96 Zeichen habt)
* <code>sudo cpan Crypt::Rijndael_PP</code> (nur nötig, wenn libcryptx-perl aus irgendwelchen Gründen nicht funktioniert)
* <code>sudo cpan Crypt::Cipher::AES</code> (nur nötig, wenn Crypt::Rijndael_PP aus irgendwelchen Gründen nicht funktioniert)

Wenn bei dem ein oder anderen Modul die Meldung kommt, dass es schon installiert ist, einfach mit dem nächsten Befehl weiter machen. Das CPAN Teil würde ich am Schluss machen, das braucht ziemlich lang zum installieren.

===Vorarbeiten am Smartphone (Token)===
Das Problem ist folgendes:

Wenn der Roboter mit dem WLAN verbunden wird, generiert er einen Token. Das ist ein Schlüssel, ohne den er sich nicht steuern lässt. Damit FHEM drauf zugreifen kann, benötigt man diesen Token.

Mit den neueren Versionen der MiHome App klappt das Auslesen der Tokens leider nicht mehr.

====Auslesen bei Android Endgeräten====

Ich gehe davon aus, dass der Staubsauger mit der original MiHome App eingebunden ist und funktioniert. (Ich habe bei der Einrichtung des Servers => "other" gewählt. Offenbar wollen neuere Staubsauger sich mit "China Mainland" nicht mehr verbinden. Tut hier an dieser Stelle zwar nichts zur Sache, aber vielleicht hilft es dem ein oder anderen. Wenn man die Region gewechselt hat, muss man auch den Staubsauger neu einbinden)

* MiHome löschen
* alte MiHome suchen (APKMirror z.B., Version 5.0.19 hat bei mir funktioniert, unsichere Quellen müssen erlaubt sein)
* runtergeladene MiHome App öffnen und anmelden (sollte ganz normal den Sauger finden)
* USB-Debugging am Handy einschalten (Entwickleroptionen...)
* Handy mit USB Kabel und PC verbinden
* [https://github.com/ultrara1n/MiToolkit/releases MiToolkit] 1.6 runterladen und öffnen
* [https://github.com/ultrara1n/MiToolkit/releases MiToolkit] erzeugt nun am Handy ein Backup
* anschließend zeigt es den Token direkt am PC an

====Wenn die Datenbank miio2.db kein Token enthält====
[https://github.com/merdok/homebridge-xiaomi-fan/blob/master/obtain_token.md github] homebridge-xiaomi-fan bietet eine Methode für root-freie Android SmartPhones über das Logfile.

Diese Methode funktioniert nur, wenn Sie die Mi Home App version v5.4.54 nutzen.

* installieren Sie Mi Home App Version 5.4.54
* loggen Sie sich mit Ihrem Xiaomi Account ein
* nutzen Sie den Dateiexplorer und gehen nach '''/sdcard/SmartHome/logs/Plug_Devicemanager/'''
* finden Sie dort eine aktuelle Datei im Format yyyy-mm-dd.txt und öffnen Sie sie
* ODER nutzen Sie adb pull /sdcard/SmartHome/logs/Plug_Devicemanager/, um alles auf den PC herunter zu laden
* Suchen Sie eine Zeichenkette ähnlich der folgenden mit dem Gerätenamen:

<syntaxhighlight lang="JSON">
{"did":"117383849","token":"90557f1373xxxxxxx8314a74d547b5","longitude":"x","latitude":"y","name":"Mi Robot Vacuum","pid":"0","localip":"192.168.88.68","mac":"40:31:3C:AA:BB:CC","ssid":"Your AP Name","bssid":"E4:8D:8C:EE:FF:GG","parent_id":"","parent_model":"","show_mode":1,"model":"rockrobo.vacuum.v1","adminFlag":1,"shareFlag":0,"permitLevel":16,"isOnline":true,"desc":"Zoned cleanup","extra":{"isSetPincode":0,"fw_version":"3.3.9_003460","needVerifyCode":0,"isPasswordEncrypt":0},"event":{"event.back_to_dock":"{\"timestamp\":1548817566,\"value\":[0]}
</syntaxhighlight>

* Dort finden Sie ''token''

====Auslesen bei iOS Endgeräten====
Zum Auslesen des Tokens mit iOS Endgeräten kann die Anleitung unter folgendem Link befolgt werden: [https://forum.smartapfel.de/forum/thread/370-xiaomi-token-auslesen/]

'''Auslesen mit fhem / fhempy'''

In fhem gibt es auch noch das [https://github.com/fhempy/fhempy/blob/master/README.md fhempy-System], dafür gibt es auch ein Modul zum Auslesen von Xiaomi-Token aus deren Cloud, u.a. auch das Token für unseren Mi-Vacuum.

===Installation des inoffiziellen Moduls===
Das Modul ist seit 28.02.2018 ein offizielles Modul. Eine separates Installation ist nicht (mehr) notwendig.

==Einrichten des Moduls [[XiaomiDevice]] ==
:<code>define Mi_Vacuum XiaomiDevice 192.168.222.77 55387753545937326a33396943557999</code>
:<code>attr Mi_Vacuum subType VacuumCleaner</code>

Und schon (=etwa nach 10 Sekunden) sollte euer Roboter in FHEM mit ganz vielen Readings auftauchen.

==Anwendung: Sprachsteuerung mit Alexa (einfach, ein und aus)==
Wie bindet man das jetzt schnell in Alexa ein?

Wir legen uns in FHEM einen Dummy an. Dieser wird ein Switch (on off). Dazu noch ein DOIF oder ein notify, welches diesen Switch überwacht. Je nach Status des Dummys schalten wir den Roboter.

Ein List meines Dummys:
<pre>
Internals:
CFGFN
NAME Mi_Vacuum_Staubsauger
NR 719473
STATE on
TYPE dummy
Readings:
2017-09-18 21:10:12 state on
Attributes:
alexaName Mi_Vacuum_Staubsauger
genericDeviceType switch
room alexa
setList on off
</pre>

Mein DOIF:
:<code>define di_Mi_Vacuum DOIF ([Mi_Vacuum_Staubsauger:"on"]) (set Mi_Vacuum start) DOELSE (set Mi_Vacuum charge)</code>

Das Attribut do always nicht vergessen!

Den Dummy setzen wir in den Raum, der unsere Alexa Geräte beinhaltet. Nun den Alexa FHEM Service neu starten. Anschließend sollte eine Suche nach neuen Geräten in Alexa unseren Dummy finden. Für diesen legen wir in Alexa einen neuen Raum an, z.B. Staubsauger.

Fertig.

Ein "Alexa schaltet den Staubsauger ein" lässt unseren Mi-Vacuum loslegen. "Alexa schalte den Staubsauger aus" schickt ihn wieder zurück zu seiner Station.

==Zonenreinigung==
Um nur Teilbereiche einer Wohnung zu reinigen, ist es möglich über das Modul Zonen zu definieren. Hierzu ist es notwendig, die Koordinaten der gewünschten Zone zu ermitteln. Hierzu eignet sich die [https://xiaomi.flole.de/ FloleVac App] die entweder auf einem Android Device oder auf einem Android Emulator (z.B. [https://www.bluestacks.com/download.html BlueStacks]) verwendet werden kann. In der App kann man in der Karte eine Zone für die Reinigung markieren und durch langes Gedrückthalten des "Reinigen-Buttons" in der FloleVac App die Koordinaten dieser Zone in die Zwischenablage kopieren.

Mit diesen Koordindaten im Format [16200,27250,31650,27650,1] kann man dann loslegen die Zonen in FHEM zu definieren:

Entweder direkt über die Werte:
:<code>set vacuum zone 16200,27250,31650,27650,1 23700,23050,25200,24200,2</code>

Oder über die passenden Attribute erst ein Alias anlegen:
:<code>attr vacuum zone_names home:[16200,27250,31650,27650,1],[23700,23050,25200,24200,2] livingroom:[16200,26250,23000,30150,1]</code>

Ein Alias kann dann wie folgt genutzt werden:
:<code>set vacuum zone home</code>

==Probleme und Lösungen==
===Crypt::Cipher::AES or Crypt::Rijndael_PP is required!===
Die Meldung im STATE des Devices bedeutet, dass noch einige Debian/Perl-Module installiert werden müssen. Siehe [[#Vorarbeiten (Linux)]].

Danach ist darauf zu achten, dass das Device wieder aktiviert wird.
attr <devicename> disable 0

==Quellen==
* {{Link2Forum|Topic=73052|LinkText=Forums-Thread}}
* {{Link2Forum|Topic=76940|LinkText=Diskussionsthread}}
* [http://miniweb.sourceforge.net/ MiniWeb], kleiner WebServer für Windows
* [https://xiaomi.flole.de/ Flole], alternative App für Android, die das Token nach GoogleDrive exportiert
* [http://www.roboter-forum.com/forumdisplay.php?130-Xiaomi Roboter-Forum] deutschsprachiges Forum, welches sich mit dem Mi Vacuum beschäftigt (auch vor dem Kauf des Roboters lohnt sich ein Besuch dort)

[[Kategorie:Other Components]]

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

2026-02-15T09:44:45Z

Ph1959de: Zahlen bis 12 üblicherweise als Worte (nur stellenweise geändert); bei Plural kein Apostroph (hier: APIs)

{{Baustelle}}
{{Hinweis|Die vorliegende Wiki-Seite befindet sich im Aufbau.}}
{{Infobox Modul
|ModPurpose=Solarprognose und Verbrauchersteuerung
|ModType=d
|ModCmdRef=76_SolarForecast
|ModFTopic=117864
|ModForumArea=Solaranlagen
|ModTechName=76_SolarForecast.pm
|ModOwner=DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])
}}
[[SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung|SolarForecast]] ist ein integratives Modul zur Gewinnung solarer Vorhersagedaten, deren Verarbeitung und grafischen Darstellung. Desweiteren bietet es die Möglichkeit, in FHEM definierte Verbraucher in einem SolarForecast-Device zu registrieren und eine PV Prognose basierte Steuerung der Verbraucher vom Modul übernehmen zu lassen.

Das Modul ist insbesondere durch folgende Eigenschaften gekennzeichnet:
[[Datei:sfc1.png|right|thumb|300px|grafische Ansicht SolarForecast]]

::* zur Gewinnung solarer Prognosewerte können die SolCast API, OpenMeteo API, Forecast.Solar API, Victron VRM Portal API oder alternativ DWD Stahlungswerte-Stationen verwendet werden

::* optionale KI Unterstützung der PV-Prognose bei Verwendung von geeigneten Solar-APIs

::* optionale KI Unterstützung der Prognose des Energieverbrauchs der kommenden Stunden

::* es wird sowohl die Erzeugungsprognose als auch eine Verbrauchsprognose sowie SoC Prognose (bei Batterie-Integration) erstellt

::* Wetterdaten werden über DWD Wetter-Stationen oder API integriert. Es können verschiedene APIs zur Gewinnung von Solar- und Wetterdaten kombiniert werden.

::* Sprachensupport EN / DE

::* die Prognosedaten, Wetterdaten, Verbraucherplanungen und die aktuellen Energieflüsse werden in umfangreich anpassbaren integrierten Grafiken dargestellt

::* es wird keine externe SQL-Datenbank benötigt, die Datenhaltung erfolgt in einer Memory basierten Cachedatenbank inkl. einer Filesystempersistenz zur Datensicherung und Wiederherstellung beim FHEM-Restart

::* die Integration von Geräten wie Wechselrichter, Energy Meter, Batterien, Wetterstationen oder Verbrauchern ist offen und universell gestaltet und bietet dem Anwender maximale Freiheiten bei der Einrichtung seines individuellen Solardatensystems.

::* eine Integration von bis zu 4 Inverter und Smartloader (DC-DC Batterieladegeräte) ist möglich

::* eine Integration von bis zu 3 nicht PV-Energieerzeugern wie BHKW, Windrädern oder Notstromaggregaten ist möglich

::* eine integrierte und umfangreich anpassbare Verbrauchersteuerung vereint die PV Prognose basierte Einplanung der Verbraucher mit der Möglichkeit die Verbraucher durch das Modul schalten zu lassen und dadurch auf PV Erzeugungsschwankungen automatisch dynamisch zu reagieren

::* Einbindung von bis zu 3 Batteriespeichersystemen

::* Bereitstellung von Leitwerten zur optimalen Einstellung/Steuerung von Batteriespeichersystemen

::* trotz der hohen Komplexität wird dem Anwender durch eine "Guided Procedure" bei der Gerätedefinition der Einstieg erleichtert und damit ein optimales Benutzererlebnis geboten

'''Abgrenzung:''' Das Modul 76_SolarForecast ist nicht zu verwechseln mit der SQL-basierten (DbLog) Prognose-Lösung mit Kostal Plenticore Wechselrichtern, die auf der eigenen Seite '''[[Kostal_Plenticore_10_Plus]]''' behandelt wird. Diese Lösung beschreibt kein monolithisches Modul, sondern basiert auf einer orchestrierbaren Zusammenstellung individueller Perl Programmbausteine.

Im vorliegenden Wiki-Beitrag wird ausschließlich das Modul 76_SolarForecast behandelt.

== Rahmenbedingungen und Voraussetzungen ==

Das Wiki gibt allgemeingültige und teilweise sehr spezifische bzw. tiefgehende Informationen und Handlungsempfehlungen zum SolarForecast Modul. Die dargestellten Informationen beziehen sich auf den zum Zeitpunkt der Wiki-Erstellung vorhandenen Entwicklungsstand des Moduls. Durch die stetige Weiterentwicklung können sich Abweichungen zum beschriebenen Inhalt ergeben oder zur Obsoleszenz dieser Inhalte führen.

Vergleiche deshalb die Informationen immer mit der aktuellen Befehls-Referenz zum Modul!

== Definition ==
Ein SolarForecast Device wird mit dem Befehl

define <Name> SolarForecast

angelegt. Nach der Definition wird der User durch einen Dialog geführt, der einige unerlässliche Einstellungen abfragt und in den entsprechenden Attributen und Readings persistiert. Alle Attribute und Readings die eine Einstellung der Anlage bewirken, sind mit dem Präfix "setup" versehen.

Die Verwendung von setup-Readings gestattet es die Anlagenparameter dynamisch im Betrieb zu verändern. So kann mit

set <Name> setupStringAzimuth bzw.
set <Name> setupStringDeclination

die Ausrichtung und der Neigungswinkel der PV-Module ständig angepasst werden, was zum Beispiel bei einer dem Sonnenstand nachgeführten Anlage von Bedeutung ist.

Die abgefragten Einstellungen während des Dialoges sind ausführlich in den entsprechenden Attributen bzw. Set-Kommandos erläutert. Die benötigten Informationen sind anhängig von der gewählten Prognose-API und können im Umfang variieren.

[[Datei:Screenshot 2024-09-21 213257.png|right|thumb|400px|Anlagenprüfung über Drucktaste in der Kopfgrafik]]

Sobald alle verlangten Einstellungen vorgenommen sind, sollte eine Anlagenprüfung mit

set <Name> plantConfiguration check

oder über die angebotene Drucktaste in der Grafik durchgeführt werden. Es wird eine Plausibilitätsprüfung vorgenommen und das Ergebnis sowie eventuelle Hinweise bzw. Fehler ausgegeben.
Die Prüfung kann beliebig wiederholt werden und sollte sich bei jeder Einstellungsänderung der Anlage durchgeführt werden. Dadurch wird die Wahrscheinlichkeit von fehlerhaften Einstellungen minimiert.

Neben den grundlegenden Einstellungen können im Device weitere sekundäre Anlagenkomponenten wie Batteriesystem(e) (Attribut setupBatteryDev1 - setupBatteryDev3), weitere Wetter-Devices (Attribut setupWeatherDev1 - setupWeatherDev3) oder sonstige Erzeuger (z.B. BHKW, Winderzeugung, Notstromaggregat) integriert werden (Attribut setupOtherProducer01 - setupOtherProducer03).

Die verlangten Parameter der Anlage werden in der Online-Hilfe umfassend beschrieben und deren Funktion erschließt sich zum größten Teil selbst. Dennoch soll nachfolgend auf einige Punkte im Zusammenhang der Einrichtung eingegangen werden.

<br>
=== Hinweise zur Struktur der Attribute ===

Durch die umfangreichen Funktionen des Moduls würde bei Nutzung der im FHEM herkömmlich vorhandenen Attributstruktur die Anzahl der benötigten Attribute extrem stark steigen und nicht sinnvoll genutzt werden können. Deshalb gibt es neben den ''gewöhnlichen'' Attributen mit einfachen Werteauswahlmöglichkeiten oder Eingaben (z.B. ctrlDebug, ctrlSpecialReadings) sogenannte ''zusammengesetzte'' Attribute, deren Inhalt durch '''Schlüssel=Wert Paare''' gebildet wird und dadurch deutlich mehr Funktionen und Informationen transportieren als ein gewöhnliches Attribut.

Für zusammengesetzte Attribute besteht die zusätzliche Möglichkeit, gewünschte Änderungen der Schlüssel=Wert Paare selektiv vornehmen zu können, ohne das gesamte Attribut aufrufen und ändern zu müssen. Die Vorgang, der vor allem für programmtechnische Manipulationen gedacht ist, kann durch eine Set-Funktion ausgeführt werden:

set <Name> attrKeyVal <Attribut> [<Gerät>] <Schlüssel=Wert>

Beispiele für zusammengesetzte Attribute sind:

* aiControl
* plantControl
* setup* Attribute

Die Funktionen der Attribute werden durch einen Präfix geclustert und so inhaltlich, aber vor allem auch in der Attribute Drop-Down Liste, strukturiert dargestellt.

Die Bedeutung der '''Präfixe''' sind:

* '''ai''' - Steuerungsfunktionen für KI (z.B. aiControl)
* '''consumer''' - Registrierung und Einstellungen für Verbraucher (z.B. consumer02, consumerControl)
* '''ctrl''' - Steuerungsfunktion allgemeiner Art (z.B. ctrlDebug, ctrlSpecialReadings, ctrlUserExitFn)
* '''flowGraphic''' - Einstellungen für die Energieflußgrafik (z.B. flowGraphicControl)
* '''graphic''' - Einstellung für die Grafik allgemein (z.B. graphicSelect, graphicControl)
* '''graphicBeam''' - Einstellungen bestimmte Balkeneigenschaften in der Balkengrafik (z.B. graphicBeamHeightLevel1)
* '''plant''' - übergreifende Einstellungen betreffend der gesamten PV-Anlage bzw. des SolarForecast-Devices (z.B. plantControl)
* '''setup''' - Registrierung von Geräten in der Gesamtanlage und Einstellung deren Eigenschaften (Inverter, Zähler, Batterien usw.)

<br>

=== Einrichtung der Wechselrichter mit setupInverterDevXX ===

Mit den Attributen setupInverterDev01 bis setupInverterDevXX werden die vorhandenen Wechselrichter der Anlage registriert.
Das Modul unterscheidet verschiedene Wechselrichter-Typen, die sich durch ihre Arbeitsweise innerhalb der Anlage unterscheiden. Die Schlüssel=Wert Paare in den Attributen können mehrzeilig organisiert werden. Das erleichtert die Übersicht wenn viele dieser Parameter eingegeben werden.

;PV-Wechselrichter: Es ist der Standard Wechselrichter in einer PV-Anlage. An ihn sind die Solarzellen bzw. Strings angeschlossen. Die zugeordneten Strings können mit dem Schlüssel '''strings''' zugeordnet werden. Ohne diese Angabe werden diesem Gerät alle definierten Strings (siehe Attribut ''setupInverterStrings'') zugeordnet. Der Wechselrichter liefert seine Energie in das Hausnetz. Alternativ kann mit der Angabe '''feed=grid''' die Funktion des Wechselrichters geändert werden. Diese Angabe sagt aus, dass dieser Wechselrichter ausschließlich in das öffentliche Netz einspeist.

Hier ein Beispiel-Setup eines PV-Wechselrichters (SMA STP):

STP_5000 pvIn=string_1_pdc:kW pvOut=total_pac:kW etotal=etotal:kWh capacity=5000 strings=Süddach asynchron=1 limit=100

;Solar-Ladegeräte: Solar-Ladegeräte sind DC-DC Wandler und liefern die Energie der angeschlossenen Solarzellen nicht in das Wechselstromnetz, sondern laden direkt eine Batterie bzw. versorgen einen Batteriewechselrichter auf der Gleichstromseite. Die Funktion als Solar-Ladegerät wird mit '''feed=bat''' aktiviert, die relevanten Strings können ebenfalls mit dem Schlüssel '''strings''' zugeordnet werden. Ein Beispiel eines Solar-Ladegerätes ist ein Victron SmartSolar MPPT.

Ein Beispiel für das Setup eines Solar-Ladegeräts (SmartSolar Charger MPPT):

MQTT2_cerboGX_c0619ab34e08_solarcharger_Common pv=Yield_Power_value:W etotal=Yield_System_value:kWh capacity=2080 strings=Schleppdach feed=bat synchron=0 limit=100

;Batterie-Wechselrichter: Dieses Gerät hat keine angeschlossenen Solarzellen und arbeitet als DC-AC bzw. AC-DC Wandler zwischen einer Batterie (=Gleichstromquelle) und dem Wechselstrom-Hausnetz. Die Funktion als Batterie-Wechselrichter wird mit der Angabe '''strings=none''' aktiviert. Die Schlüssel ''etotal'' und ''pv'' können bei einem Batterie-Wechselrichter ohne zugeordnete Solarzellen nicht gesetzt werden. Ein Beispiel eines Batterie-Wechselrichter ist der Victron MultiPlus II.

Ein Setup-Beispiel für einen Batterie-Wechselrichter (Victron MultiPlus II):

<pre>
dc2ac=DC_IN:W
ac2dc=DC_OUT:W
capacity=7200
strings=none
icon=inverter@darkorange:inverter@grey
asynchron=0
</pre>

Die Eigenschaften des Wechselrichters werden durch eine Reihe von <Schlüssel=Wert> Paaren festgelegt. Auf einige dieser Paramter soll hier eingegangen werden.

<br>
==== Ausgewählte Schlüssel=Wert Paare ====

<br>
* '''pvIn=<Readingname>:<Einheit>'''

Dem Schlüssel ''pvIn'' wird ein Reading und dessen Einheit (W,kW) des Wechselrichter-Device zugeordnet, welches die aktuell zugeführte PV-Leistung bereitstellt. Der Schlüssel ist optional und dient in erster Linie dazu den entsprechenden Input-Wert in der Flußgrafik anzuzeigen sofern man das Attribut flowGraphicControl->showGenerators=1 setzt. Dadurch ist auch der Eigenverbrauch des Inverters bzw. dessen Wandlungsverlust visuell abschätzbar.

* '''pvOut=<Readingname>:<Einheit>'''

Dem Schlüssel ''pvOut'' wird ein Reading und dessen Einheit (W,kW) des Wechselrichter-Device zugeordnet, welches die aktuell erzeugte Leistung als positiven Wert liefert. Für einen PV-Wechselrichter (DC->AC) oder Solar-Ladegerät (DC->DC) ist es die erzeugte PV-Leistung.

* '''ac2dc=<Readingname>:<Einheit>'''

Dieser Schlüssel ist nur für einen Batterie-Wechselrichter setzbar. Das Reading liefert die aktuelle Leistung, die der Wechselrichter vom Hausnetz in Richtung Batterie (AC->DC) wandelt.

* '''dc2ac=<Readingname>:<Einheit>'''

Dieser Schlüssel ist nur für einen Batterie-Wechselrichter setzbar. Das Reading liefert die aktuelle Leistung, die der Wechselrichter aus einer Gleichstromquelle, d.h. einer Batterie oder einem Solar-Ladegerät, in Richtung des Hausnetzes (AC) wandelt .

* '''capacity=<max. WR-Leistung>'''

In dem Schlüssel ''capacity'' wird die maximal mögliche Leistung in Watt (ohne Einheit) angegeben, die der Wechselrichter lt. seinem Datenblatt in der Lage ist zu leisten.

Die Angabe ''capacity'' hat in erster Linie die Aufgabe, die max. mögliche PV-Leistung für die Prognose zu begrenzen. Oft sind die installierten Peak-Leistungen der PV-Module höher als die angeschlossene Wechselrichter-Leistung bzw. kommt es vor, dass die KI / (korrigierte) API-Prognose über der maximal möglichen Wechselrichter-Leistung liegt. In diesen Fällen wird die Prognose auf die angegebene ''capacity'' begrenzt.

Der Wert in diesem Schlüssel kann, wie andere Schlüssel auch, dynamisch zur Laufzeit mit dem Set-Befehl "[[#Hinweise zur Struktur der Attribute|set <Name> attrKeyVal ...]]" geändert werden. Ein Beispiel zur Anwendung ergibt sich aus folgendem Szenario.

Gegeben sei eine Anlage die aus Solarzellen (1300 W Peak) mit einem Solar-Ladegerät mit max. 1800 W Leistung, einer Batterie und einem Batterie-Wechselrichter besteht. Die Anlage versorgt nur das Hausnetz. Eine Netzeinspeisung ist nicht vorgesehen oder nicht erlaubt.

Nehmen wir an, es ist ein Tag voller Sonnenschein prognostiziert und die Batterie ist zunächst entladen. Der Haushalt verbraucht 300 W. Dann würden die PV-Module Module ihre volle Leistung von 1300 W Peak leisten können, die sich auch in der Balken-Vorhersage niederschlägt. Die Leistung wird nicht begrenzt, weil:

* sie niedriger ist als die nominale und angegebene Wechselrichter Kapazität von ''capacity=1800''
* die erzeugte Energie anteilig für die Verorgung des Hauses und die Aufladung der Batterie verwendet wird

Anders verhält es sich wenn nach einer gewissen Zeit die Batterie voll ist und weiterhin volle PV Leistung zur Verfügung steht. In diesem Fall würde der Haushalt seine benötigte Leistung von 300 W abnehmen, aber das Solar-Ladegerät kann keine weitere Leistung mehr abgeben, da die Batterie bereits voll geladen ist, d.h. die Anlagensteuerung würde die PV-Anlage abregeln. In diesem Fall, wenn es einen längeren Zeitraum betrifft, muß auch die Prognose PV-Energie auf 300 Wh (bzw. den durchschnittlichen Energieverbrauch des Hauses pro Stunde) begrenzt werden, damit die PV-Prognose nach unten angepasst wird und so eine realitätsnahere Prognose ermöglicht wird.

* '''icon=<aktiv>[@<Farbe>][:<inaktiv>[@<Farbe>]]'''

Jeder Wechselrichter wird im Standard durch ein Icon getrennt nach Tag und Nacht, d.h. je nach Aktiv-Status und Inaktiv-Status, symbolisiert.

;Tag bzw. Aktivität: Für Wechselrichter mit angeschlossenen PV-Modulen wird ein entsprechend gefärbtes Sonnensymbol im Standard verwendet. Batterie-Wechselrichter verwenden ein gefärbtes Invertersymbol.

;Nacht bzw. Inaktivität: Für Wechselrichter mit angeschlossenen PV-Modulen wird ein entsprechend gefärbtes Symbol der aktuellen Mondphasen im Standard verwendet. Batterie-Wechselrichter verwenden ein ausgegrautes Invertersymbol.

Wie angegeben, kann man für Tag und Nacht jeweils ein Wunsch-Icon, wenn gewünscht mit einer alternativen Färbung, auswählen.

icon=inverter@darkorange:inverter@gray

Soll nur das Icon für die Nacht bzw. Inaktivät geändert werden, kann dies in dieser Form angegeben werden:

icon=:inverter@gray

(beachte den führenden ':')

<br>
==== Definition von Hybrid-Wechselrichtern ====

Zur Zeit der Erstellung dieses Abschnittes ist es in der SolarForecast Version 1.58.x nicht möglich, einen Hybridwechselrichter nativ zu definieren. Als Workaround wird eine passende Kombination aus PV-Wechselrichter und Batterie-Device oder einer Kombination aus PV-Wechselrichter + Batterie-Wechselrichter und Batterie-Device erstellt.

Bei allen benutzten Methoden ist es sehr wichtig!, dass die geforderten Inhalte der jeweilige Attributschlüssel beachtet und eingehalten werden. So ist zum Beispiel die Angabe von:

* '''pvOut''' - Ein Reading, welches die aktuelle Leistung aus PV-Erzeugung, die an das Hausnetz oder öffentliche Netz geliefert wird, bereitstellt. Es wird ein positiver numerischer Wert erwartet.

bei einem PV-Wechselrichter ein Reading welches ausschließlich die Leistung liefert, die von den Solarzellen-Generatoren erzeugt wird. Elemente von Batterieleistungen oder Gridbestandteile dürfen hier nicht enthalten sein. Sind in den Gerätemodulen diese Readings in dieser Form nicht enthalten, bietet es sich an, userReadings zur Erstellung von zusätzlichen Readings in den Quellendevices zu nutzen um den nötigen Input für SolarForecast bereitzustellen.

So wird zum Beispiel bei einem Batterie-Wechselrichter gefordert, dass die Readings '''ac2dc''' (AC->DC-Leistung Hausnetz zur Batterie) und '''dc2ac''' (DC->AC-Leistung (Batterie zum Hausnetz) '''jeweils als als positiver Wert''' anzugeben ist. Manche Batterie-Devices stellen allerdings nur ein Reading zur Verfügung, welches vorzeichenbehaftet die Leistungen in die Batterie bzw. aus der Batterie heraus liefert. Mit einem userReadings Attribut kann aus diesem Reading zwei neue Readings erzeugt werden:

<pre>
attr <Name> userReadings BatIn:DC_Power_value.* {
my $pwr = ReadingsVal ($name, 'DC_Power_value', 0);
$pwr = $pwr > 0 ? $pwr : 0;
$pwr
},
BatOut:DC_Power_value.* {
my $pwr = ReadingsVal ($name, 'DC_Power_value', 0);
$pwr = $pwr < 0 ? - $pwr : 0;
$pwr
},
</pre>

Ist das Quellenreading ''DC_Power_value'' positiv, stellt der Wert AC->DC-Leistung dar und wird als neues Reading BatIn bereitgestellt. Mit einem negativen Vorzeichen ist es eine DC->AC-Leistung und wird in dem neuen Reading BatOut '''ebenfalls als positiver Wert''' bereitgestellt. Auch hier gilt der Grundsatz, dass zum Beispiel BatOut nur die von der Batterie gelieferte Energie und keinen Mix aus Batterie- und PV-Energie enthalten darf.

===== Integration eines DEYE SUN-12K-SG04LP3-EU =====

[[Datei:Screenshot 2025-09-23 203955.png|right|thumb|400px|DEYE SUN-12K-SG04LP3-EU Grundlegende Systemarchitektur]]

Der DEYE vereint wie wohl alle bzw. die meisten Hybrid-Wechselrichter die Anschlüsse:

* Eingang Solar-Strings
* Anschluß Batteriespeicher
* AC-Anschluß öffnetliches Netz
* AC-Anschluß Ersatzlast (wird bei Netzausfall weiter versorgt)
* AC-Anschluß Notstromgenerator bzw. netzgekoppelter anderer Wechselrichter (hier ist ein Growatt Micro-Wechselrichter angeschlossen)

Für die Integration werden die setup-Attribute durch das FHEM Device ''Deye_Inverter'' besetzt:

* setupInverterStrings zur Definition der vorhandenen Solarstrings
* setupInverterDev01 zur Definition der Inverteranschlüsse und Eigenschaften
* setupBatteryDev01 integriert die Batterie
* setupMeterDev liefert die Daten für Netzbezug und Netzeinspeisung

Das nachfolgend verwendete Device ''Deye_Inverter'' ist ein MQTT-Device. Es bekommt Daten vom Deye-Hybridwechselrichter per MQTT und sendet Einstellungen zum Deye, bspw. maximaler Lade/Entladestrom des Akkus, Laden des Akkus aus dem Netz, Ein- und Ausschalten des Micro-Inverter-Ports.
Das Reading ''Deye_Growatt_power'' im Schlüssel ''pvOut'' ist eine Addition aus den Daten des Deye WR und des angeschlossenen Growatt Micro-Wechselrichters.

<pre>
attr <Name> setupInverterStrings Sueddach,Garagendach
attr <Name> setupInverterDev01 Deye_Inverter pvOut=Deye_Growatt_power:W capacity=15200 etotal=total_pv_production:kWh
attr <Name> setupBatteryDev01 Deye_Inverter pin=-pout pout=battery_output_power:W intotal=total_charge_of_the_battery:kWh outtotal=total_discharge_of_the_battery:kWh cap=15200 charge=SOC_jkbms
attr <Name> setupMeterDev Deye_Inverter gcon=total_grid_power:W contotal=total_energy_bought:kWh gfeedin=-gcon feedtotal=total_energy_sold:kWh
</pre>

''setupInverterStrings'' benennt alle vorhandenen Solarstrings. Werden mehrere Inverter definiert, kann mit dem hier nicht verwendeten Schlüssel ''strings'' eine Zuordnung der Strings zum angeschlossenen Inverter vorgenommen werden.

Im Attribut ''setupInverterDev01'' ist der allgemeine Schlüssel ''capacity'' zur Festlegung der Inverterleistung von 15200 Watt gesetzt. Die spezifischen Schlüssel ''pvOut'' und ''etotal'' teilen dem Modul die aktuell erzeugte PV-Leistung sowie die gesamte erzeugte PV-Energie mit. Letzteres dient unter anderem dazu die stündlich real erzeugte PV-Energie festzuhalten und mit der Prognose zu vergleichen. Die in den schlüsseln hinterlegten dürfen keine Battrie- oder Netzanteile enthalten.

Das Attr ''setupBatteryDev01'' implementiert alle relevanten Batteriewerte. Das Reading ''battery_output_power'' im Schlüssel ''pout'' liefert den Batterie-Output als positiven Wert. Als Besonderheit kann der Wert ''pin'', die Batterie-Ladeleistung, den Wert des Readings in ''pout'' übernehmen wenn dieser Wert ein negatives Vorzeichen hat. Die Schlüssel ''intotal'' und ''outtotal'' liefern die summierten Totalwerte für Batterie Ladung bzw. Entladung. Die Kapazität ''cap'' wird für verschiedene Aspekte der SoC- und Ladesteuerung verwendet.

Abschließend liefern die angebenen Readings in den Schlüsseln des Attributes ''setupMeterDev'' alle notwendigen Werte des Netzbezugs und der Netzeinspeisung.

Nachfolgende Links liefern '''weitere Infos''' wie man Daten aus dem Deye WR ausliest und Einstellungen des Deye WR verändert:

* https://github.com/klatremis/esphome-for-deye
* https://github.com/philipphenkel/esphome-config
* https://github.com/bagges/deye-esp32-bridge

Für eine weiterführende Automation soll der Akku netzdienlich in der Mittagszeit geladen werden. Dazu wurde durch den Anwender folgendes userReadings ''MaxBattCharge_Request'' im Device ''Deye_Inverter'' für den maximalen Ladestrom definiert (bei 90% SOC und bei 100% SOC):

<pre>
MaxBattCharge_Request:SOC_jkbms.* {
if ((ReadingsNum('mySolarForecast','RestOfDayPVforecast','')
- ReadingsNum('mySolarForecast','special_todayConForecastTillSunset','')
- (90-ReadingsNum('JK_BMS','capacity_remaining',''))/100*310*51.2) < 400
and ReadingsAge('JK_BMS','capacity_full_timestamp','') < 561600)
{100}
elsif ((ReadingsNum('mySolarForecast','RestOfDayPVforecast','')
- ReadingsNum('mySolarForecast','special_todayConForecastTillSunset','')
- (100-ReadingsNum('JK_BMS','capacity_remaining',''))/100*310*51.2) < 400
and ReadingsAge('JK_BMS','capacity_full_timestamp','') >= 561600)
{100}
elsif ((ReadingsNum('mySolarForecast','RestOfDayPVforecast','')
- ReadingsNum('mySolarForecast','special_todayConForecastTillSunset','')
- (90-ReadingsNum('JK_BMS','capacity_remaining',''))/100*310*51.2) >= 400
and ReadingsAge('JK_BMS','capacity_full_timestamp','') < 561600)
{ceil ((90-ReadingsNum('JK_BMS','capacity_remaining',''))/100*310/3.5)}
elsif ((ReadingsNum('mySolarForecast','RestOfDayPVforecast','')
- ReadingsNum('mySolarForecast','special_todayConForecastTillSunset','')
- (100-ReadingsNum('JK_BMS','capacity_remaining',''))/100*310*51.2) >= 400
and ReadingsAge('JK_BMS','capacity_full_timestamp','') >= 561600)
{ceil ((100-ReadingsNum('JK_BMS','capacity_remaining',''))/100*310/3.0)}
}
</pre>

Das userReading wird in einer Automation benutzt, um den maximalen Ladestrom einzustellen; Ladebeginn bei ausreichend Sonne ist ab 11:30 eingestellt.

<br>
===== Integration eines Fronius Symo GEN24 10.0 Plus mit (virtuellen) Batterie-Wechselrichter =====

[[Datei:Screenshot 2025-10-04 162422.png|right|thumb|400px|Flußgrafik mit eingebauten Hybrid-Wechselrichter]]

Die Integration des Wechselrichters Fronius Symo GEN24 10.0 Plus benötigt zunächst eine Anbindung in FHEM, was mit dem Modul 98_fronius.pm vorgenommen wurde.

Das Ziel der Kurzdokumentation ist neben der Darstellung eines Hybridwechselrichters aufzuzeigen, wie man den Wandlungsverlust eines PV-Wechselrichters (pvIn – pvOut) in Näherung visualisieren kann.
'''pvIn''' ist dabei die Summe der Produkte aus den DC Strom- und Spannungswerten der einzelnen Strings (hier 2109 W), '''pvOut''' (hier 2065 W) ist die an den Inverterknoten (hier 1105 W) plus die an die Batterie abgegebene Leistung (hier 960 W). Bei dieser Implementierung wird mit einem zusätzlichen (virtuellen) Batterie-Wechselrichter gearbeitet.

In Vorbereitung werden die beiden anzugebenden Readings ''<pvIn>'' und ''<pvOut>'' zum Beispiel als userReadings erstellt, wobei '<pvIn>'' und ''<pvOut>'' natürlich durch Readingnamen ersetzt werden müssen. Diese beiden Readings werden wie folgt berechnet / erstellt:

<pre>
<pvOut> = Inverter_Common_PAC_Value - PowerFlow_Site_P_Akku
<pvIn> = Inverter_Common_IDC_Value * Inverter_Common_UDC_Value + Inverter_Common_IDC_2_Value * Inverter_Common_UDC_2_Value
</pre>

Der '''PV-Wechselrichter''' wird mit dem Attribut setupInverterDev01 definiert, wobei die angelegten Readingnamen in den Schlüsseln ''pvIn'' bzw. ''pvOut'' verwendet werden:

<pre>
SymGen24 icon=inverter@#ff8c00:inverter@grey capacity=10000 strings=suedwest,nordost etotal=User_Produced_PV:kWh pvOut=<pvOut>:W pvIn=<pvIn>:W
</pre>

Dem PV-Wechselrichter sind die Strings ''suedwest'' und ''nordost'' zugewiesen.

Der zusätzliche '''Batterie-Wechselrichter''' wird mit dem Attribut setupInverterDev02 hinzugefügt:

<pre>
SymGen24 icon=inverter@#ff8c00:inverter@grey strings=none ac2dc=-PowerFlow_Site_P_Akku:W dc2ac=PowerFlow_Site_P_Akku:W capacity=7680
</pre>

'''Bemerkungen:''' <br>
- strings=none sowie die Schlüssel ac2cd und dc2ac sind typisch für einen Batterie-WR bzw. kennzeichnen einen WR als Batterie-Wechselrichter <br>
- die an die Batterie abgegebene Leistung ist negativ

===== Einbindung eines Fronius Symo GEN24 10.0 Plus mit BYD Batterie ohne (virtuellen) Batterie-Wechselrichter =====
Diee Implementierung ist komplett auf der Seite [[Solaranlage Komplettbeispiel Fronius BYD]] beschrieben.

Zur Integration des ''Fronius Symo'' in FHEM wird das Modul ''fronius.pm'' verwendet und in dem definierten Device ''Fronius_Symo_Gen24'' diverse userReadings erzeugt. Diese Readings werden in den korrespondierenden Schlüsseln des Attributes ''setupInverterDev01'' angegeben:

<pre>
setupInverterDev01 Fronius_Symo_Gen24 etotal=User_Produced_PV_Energie:kWh pvOut=PowerFlow_Site_P_PV:W capacity=6000 strings=Dach_Ost,Dach_West
</pre>

Am Wechselrichter Fronius Symo Gen24 ist eine BYD Batterie angeschlossen. Das Device ''PV-Batterie'' wird per [[ModbusAttr]] angelegt und gemanaged. Die entsprechenden Readings werden im Attribut ''SetupBatteryDev01'' hinterlegt:

<pre>
PV_Batterie
cap=10240
charge=BatteryChargePercent
icon=@dyn:@dyn:@dyn:@dyn
intotal=Summe_Ladung:Wh
outtotal=Summe_Entladung:Wh
pin=BatteryChargeWatt:W
pout=BatteryDischargeWatt:W
pinmax=10000
show=2
</pre>

===== Einbindung eines SMA - Hybrid Sunny Tripower Smart Energy =====
[[Datei:Screenshot 2025-10-05 083530.png|right|thumb|400px|SMAInverter.pm]]

Der genannte Wechselrichter wird über das Modul SMAInverter.pm in FHEM integriert. Die nebenstehende Abbildung zeigt und benennt die einzelnen Readings des Moduls welche in den entsprechenden Schlüsseln der SolarForecast Attribute ''setupInverterDevXX'' und ''setupBatteryDevXX'' zugeordnet werden.

Die Readings des SMAInverter Moduls können vor der Verwendung über geeignete Methoden (userReadings) in Readings mit sprechenden Namen überführt werden um sie mit diesen Namen in die genannten Attributschlüssel einzufügen. In der vorliegenden Lösung befinden sich die Anwendungen SolarForecast und und die Inverter-Steuerung jeweils auf unterschiedlicher Hardware. Als Verbindungslayer wird MQTT genutzt, wobei dadurch bereits die dargestellten Readingnamen entstehen.

== Der integrierte SolarForecast Grafikbereich ==
Das SolarForecast Modul beinhaltet eine Grafikdarstellung die sich in mehrere Bereiche gliedert. Diese Bereiche können über Attribute ein- bzw. ausgeblendet sowie die Inhalte festgelegt werden.

[[Datei:Screenshot 2024-09-21 223545.png|right|thumb|400px|Bereiche der integrierten Grafik]]

Der nebenstehende Screenshot gibt die Gliederung der Grafikbereiche wieder:

1 - der Kopfbereich (Graphic Header)
2 - durch den Nutzer selbst definierbarer Inhalt (Graphic Header Own Specification) als Teil des Kopfbereiches
3 - Bereich Verbraucherdarstellung (Consumer Legend)
4 - Bereich Balkengrafik (Beam Graphic)
5 - Energieflußgrafik (Flow Graphic)

Jeder dieser Bereiche hat spezifische Steuerungsattribute zur Anpassung des Verhaltens und ggf. des Inhalts.

=== 1 - Der Grafik Kopfbereich ===
Im Kopfbereich befinden sich fest verankerte Informationen zur verwendeten Vorhersage-API sowie deren Status, Informationen zum Sonnenaufgang und Sonnenuntergang, dem aktuellen Gesamtstatus des SolarForecast Devices, Abweichungskennzahlen der PV Vorhersage sowie weitere Kennzeichen zur Verfügung.
Über zwei Drucktasten kann eine Anlagenprüfung durchgeführt und in den Spportthread des Moduls im FHEM Forum abgesprungen werden.

Mit dem Attribut '''graphicHeaderShow''' kann der gesamte Kopfbereich 1 und 2 (nutzereigener Teilbereich) ausgeblendet werden. Wird der Kopbereich ausgeblendet, ist es hilfreich mit dem Attribut '''plantControl->showLink''' einen Link zur Detailgrafik einzufügen da der in der Kopfgrafik integrierte Link in diesem Fall nicht mehr zur Verfügung steht.

Das Attribut '''graphicHeaderDetail''' definiert welche Bereiche des Grafikkopfes angezeigt werden sollen. Es kann die Anzeige des Energieverbrauches, der PV-Erzeugung und der vom Nutzer selbst definierte Inhalt miteinander frei kombiniert werden.

=== 2 - Der Bereich mit selbst definierbarem Inhalt (Graphic Header Own Specification) ===
In diesem Bereich kann der User beliebige Readings, Set-Kommandos und Attribute des SolarForecast Devices oder anderer Devices, die sich im gleichen FHEM-System wie das SolarForecast Device befinden, anzeigen lassen.

Dieser Bereich ist als Tabelle mit einer beliebigen Anzahl von Zeilen organisiert. Jede Zeile beinhaltet ein Kommentarfeld und vier Nutzfelder zur Darstellung ausgewähler Werte + Label. Der Bereich bzw. der Inhalt des Bereiches wird mit dem Attribut '''graphicHeaderOwnspec''' definiert.

Das nachfolgende Beispiel zeigt ein real gesetztes graphicHeaderOwnspec Attribut. Die Leerzeilen sind nicht notwendig, erhöhen aber die Lesbarkeit der Struktur.

<pre>
#
Autarkierate:Current_AutarkyRate
PV übermorgen:special_dayAfterTomorrowPVforecast
Verbrauch bis<br>Sunset:special_todayConForecastTillSunset
Verbrauch bis<br>nächsten Sunrise:special_conForecastTillNextSunrise

#Batterie
BatteryLive Status:userFn_BatLive_State
SoC Limit:Settings_CGwacs_BatteryLife_MinimumSocLimit_value@MQTT2_cerboGX_c0619ab34e08_settings
SoC Ist:SOC_value@MQTT2_cerboGX_c0619ab34e08_battery
SOC Optimum:Battery_OptimumTargetSoC

#
aktuelle Ladung:userFn_Bat_EnergyState
Verfügbar:userFn_BatLive_UsableEnergy
benötigte Ladeenergie:userFn_Bat_EnergyRemain
Ladefreigabe:Battery_ChargeRecommended

#
akt. DC Strom:DC_Current_value@MQTT2_cerboGX_c0619ab34e08_battery
Restladezeit Ziel:userFn_Bat_HoursUntilChargeFinish
MPII Ladestrom<br>Limit Soll:userFn_Bat_MaxChargeCurrent_set
:

#Settings
Batterie Lademanagement:userFn_BatteryChargeManagement
SoC Management:userFn_BatterySoCManagement
MPII Ladestrom<br>Limit Ist:MaxChargeCurrent@MQTT2_cerboGX_c0619ab34e08_vebus
SmartSolar<br>Einspeisung:OvervoltageFeedIn@MQTT2_cerboGX_c0619ab34e08_settings

MPII Limit<br>Einspeisung (W):MaxFeedInPower@MQTT2_cerboGX_c0619ab34e08_settings
SOC Limit Soll:MinimumSocLimit@MQTT2_cerboGX_c0619ab34e08_settings
Verbr. Neuplanung:consumerNewPlanning
Wetteranzeige:graphicShowWeather

Anzeige Nachtstunden:graphicShowNight
hist. Stunden:graphicHistoryHour
Autokorrektur:pvCorrectionFactor_Auto
Victron BatteryLife<br>(1=an,10=aus):BatteryLife@MQTT2_cerboGX_c0619ab34e08_settings

Grid Setpoint:GridSetpoint@MQTT2_cerboGX_c0619ab34e08_settings
Debug:ctrlDebu
</pre>

Das Kommentarfeld am Beginn einer Zeile wird durch ein '''#''' gekennzeichnet. Folgt dem # ein String, wird dieser String als Kommentarangabe gewertet und in der Grafik ausgegeben. Ein leeres Kommentarfeld wird lediglich durch ein # gefolgt von einem Leerzeichen oder NL beschrieben:

#:<Text> (bzw nur # für einen 'leeren' Titel)

Ein Netzfeld bzw. ein Datensatz wird durch die Angabe von einem Label und dem darzustellenden Wert getrennt durch ':' definiert:

<Label>:<Reading, Attribut oder Set-Kommando>

Das System erkennt selbständig, ob es sich bei der Angabe um ein Reading, Attribut oder ein Set-Kommando handelt. Sollen Readings, Set-Kommandos und Attribute anderer Devices als dem SolarForecast-Device angezeigt werden, kann dies einfach durch Zusatz von

....@<Device-Name>

an den Parameter erreicht werden.

[[Datei:Screenshot 2024-12-05 203916.png|right|thumb|400px|Darstellung eigener Grafikbereich]]
Die Eingabe kann mehrzeilig erfolgen. Werte mit den Einheiten "Wh" bzw. "kWh" werden entsprechend der Einstellung des Attributs '''graphicEnergyUnit''' umgerechnet. Im Label sind Leerzeichen durch "&nbsp;" einzufügen, ein Zeilenumbruch durch "<br>". Ein leeres Feld in einer Zeile wird durch ":" ohne eine weitere Angabe erzeugt.

Die nebenstehende Abbildung zeigt die reale Darstellung der oben angegebenen Struktur im Attribut graphicHeaderOwnspec.

==== Formatierung der Inhalte im Bereich "Graphic Header Own Specification" ====

Die angezeigten Inhalte, wie z.B. Readingwerte, des User eigenen Bereiches (Attribut graphicHeaderOwnspec) können durch Spezifikationen im Attribut '''graphicHeaderOwnspecValForm''' manipuliert werden.

Die Online-Hilfe zum Attribut graphicHeaderOwnspecValForm erläutert die verfügbaren Möglichkeiten und Optionen.
Als Beispiel hier einige mögliche Notationen:

<pre>
{
'userFn_Bat_HoursUntilChargeFinish' => "($VALUE).' Stunden'",
'MQTT2_cerboGX_c0619ab34e08_battery.SOC_value' => "%.1f %%",
'Settings_CGwacs_BatteryLife_MinimumSocLimit_value' => "%.1f %%",
'Info_MaxChargeCurrent_value' => "($VALUE).' A'",
'DC_Current_value' => "%.0f A",
'MQTT2_cerboGX_c0619ab34e08_solarcharger_Common.Regulated' => "($VALUE eq '1' ? 'Ja' : 'Nein')"
}
</pre>

Eine Besonderheit besteht bei darzustellenden Werten die die Einheiten 'Wh' bzw. 'kWh' besitzen. Diese Werte und Einheiten werden automatisch entsprechend des gesetzten Attributes graphicEnergyUnit umgerechnet und angezeigt.

Soll in diesen Fällen eine automatische Formatierung umgangen werden, kann eine solche Notation verwendet werden:

<pre>
{
'Today_PVforecast' => "(sprintf '%.1f &nbsp;kWh', ($VALUE / 1000))",
}
</pre>

Die Angabe von &nbsp; vor 'kWh' verhindert die Erkennung der Einheit und so auch die automatische Umsetzung durch das Modul.

=== 3 - Bereich Verbraucherdarstellung (Consumer Legend) ===
Dieser Grafikbereich zeigt die im Modul registrierten Verbraucher sowie deren Status und weitere Informationen an. Sind die Voraussetzungen gegeben, d.h. entsprechende Schlüssel in der ConsumerXX-Attributen gesetzt, können die Verbraucher über das Paneel manuell geschaltet werden.

Zur Anpassung der Darstellung sind verschiedene Attribute verfügbar:

;consumerControl->showLegend: Definiert die Lage bzw. Darstellungsweise der Verbraucherlegende sofern Verbraucher im SolarForecast Device registriert sind.
;consumerControl->adviceIcon: Definiert die Art der Information über die geplanten Schaltzeiten eines Verbrauchers in der Verbraucherlegende.
;consumerControl->detailLink: Wenn gesetzt, ist der jeweilige Verbraucher klickbar um direkt zur Detailansicht des jeweiligen Geräts auf einer neuen Browserseite zu gelangen.

Im Standard wird das Verbraucherpaneel zwischen dem Kopfbereich und der ersten Balkengrafik Ebene dargestellt. Mit dem Attribut '''consumerControl->showLegend''' und Argument '''icon_bottom''' oder '''text_bottom''' kann das Verbraucherpaneel an das Ende des Grafikbereiches verschoben werden.
Die Verwendung von '''text_bottom''' oder '''text_top''' blendet die Icon-Spalte im Verbraucherpaneel aus.

<gallery>
File:Screenshot 2025-02-08 093239.png|Darstellung mit consumerControl showLegend=icon_top (default)
File:Screenshot 2025-02-08 093646.png|Darstellung mit consumerControl showLegend=icon_bottom
File:Screenshot 2025-02-08 152018.png|Darstellung mit consumerControl showLegend=text_top bzw. text_bottom
</gallery>

[[Datei:Screenshot 2025-02-08 213634.png|right|thumb|400px|]]
Ein Mouse-Over über das Uhrensymbol zeigt nähere Informationen zum Status, den Planungsdaten, Modus und weitere Daten des Verbrauchers. Der Schalter "Aus/Ein" visualisiert den Schaltzustand des Verbrauchers und können auch zum manuellen Schalten des Verbrauchers dienen. Voraussetzung ist, dass im consumer-Attribut die Schlüssel "on" und "off" mit den Set-Kommandos zum Schalten des Verbrauchers defininiert sind.

[[Datei:Screenshot 2025-02-08 222210.png|right|thumb|300px|]]
Der Auto-Schieberegler zeigt einerseits den Freigabestatus zum Schalten des Verbrauchers durch das SolarForecast Modul und kann andererseits manuell betätigt werden. Der Status des Reglers korrespondiert mit dem im zugehörigen Consumer Attribut vorhandenen Schlüssel '''auto''' angegebenen Reading-Wert.

Die Verbraucherbezeichnungen in dem Paneel können in der Standardkonfiguration angeklickt werden um direkt zur Detailansicht des Devices zu gelangen. Mit dem Attribut '''consumerControl->detailLink''' kann der Link zur Detailansicht deaktiviert werden.

Das Uhrensymbol kann mit dem Attribut '''consumerControl->adviceIcon''' geändert und/oder dessen Farbe angepasst, sowie einen Informationstext statt eines Icons angezeigt werden.

=== 4 - Bereich Balkengrafik (Beam Graphic) ===

Die Balkengrafik des Moduls ist ein wesentliches Visualisierungshilfsmittel. Im Auslieferungszustand existiert eine Balkengrafikebene, die '''Ebene 1'''.
Jede Ebene kann zwei Balkendiagramme mit auswählbaren Inhalten, Farben und einstellbarem LayoutTyp darstellen. In Ebene 1 kann die Wettervorhersage eingebettet oder, bei Vorhandensein von Batteriegeräten, die zukünftigen Zeiten mit empfohlener Ladefreigabe und SoC-Prognose eingeblendet werden.

Welche Daten in welchen Zeiträumen dargestellt werden sollen, die Bestimmung des Layouts, die Gestaltung der Balken und einiges mehr wird durch Attribute gesteuert. Ein Teil dieser Einstellungen wird über das zusammengesetzete Attribut '''graphicControl->'Schlüssel'='Wert'''' eingestellt:

::*'''grundsätzliche Layout Definitionen'''
[[Datei:Screenshot 2025-01-12 204342.png|right|thumb|400px|Standardanzeige mit Wetter-Icons, gesetzen Attributen graphicBeam1Color=D4C177, graphicHistoryHour=11]]

;graphicControl->beamPaddingTop:Legt den Platz in px im Balkendiagramm fest, der zwischen dem oberen Rand der jeweiligen Balkengrafik Ebene und der ersten Text- oder Iconreihe dieser Ebene eingefügt wird.
;graphicControl->beamPaddingBottom:Legt den Platz in px im Balkendiagramm fest, der zwischen der letzten Text- oder Iconreihe der jeweiligen Balkengrafik Ebene und dem unteren Rand dieser Ebene eingefügt wird.
;graphicControl->layoutType:Layout-Optionen zur grundlegenden Gestaltung der Balkengrafik
;graphicControl->hourStyle:Format der Zeitangabe in der Balkengrafik
;graphicControl->hourCount:Anzahl der darzustellenden Balken/Stunden in der Balkengrafk
[[Datei:Screenshot Screenshot 2025-05-21 153613.png|right|thumb|400px|Erweiterung des oberen und unteren Abstandes mit den Attributen graphicControl->beamPaddingTop und graphicControl->beamPaddingBottom]]
;graphicControl->energyUnit:definiert die Einheit zur Anzeige der elektrischen Leistung in der Grafik
;graphicHistoryHour:Anzahl der vorangegangenen Stunden die in der Balkengrafik dargestellt werden
;graphicControl->beamWidth:Vorgabe Breite der Balken der Balkengrafik in px (sonst automatische Bestimmung)
;graphicBeamHeightLevel1:Multiplikator zur Festlegung der maximalen Balkenhöhe der jeweiligen Ebene (hier Ebene 1)

::*'''Definition der Inhalte und Balkeneigenschaften'''

[[Datei:Screenshot 2025-01-12 204756.png|right|thumb|400px|Wie oben aber mit gesetzem Attribut graphicShowNight=1]]
;graphicBeam1Color:Farbauswahl des primären Balkens (Ebene 1)
;graphicBeam2Color:Farbauswahl des sekundären Balkens (Ebene 1)
;graphicBeam1Content:Legt den darzustellenden Inhalt des primären Balken fest (Ebene 1)
;graphicBeam2Content:Legt den darzustellenden Inhalt des sekundären Balken fest (Ebene 1)
;graphicBeam1FontColor:Auswahl der Schriftfarbe des primären Balkens (Ebene 1)
;graphicBeam2FontColor:Auswahl der Schriftfarbe des sekundären Balkens (Ebene 1)
[[Datei:Screenshot 2025-01-12 205024.png|right|thumb|400px|Balkengrafik mit aktivierter Ebene 2, gesetzem Attribut graphicShowNight=0 (ohne Zeitsynchronisation zwischen Ebene 1 und Ebene 2)]]

::*'''zusätzliche Optionen'''

;graphicShowNight:Anzeigen oder Verbergen der Nachtstunden in der Balkengrafik
;graphicShowWeather:Wettericons in der Balkengrafik anzeigen/verbergen (nur Ebene 1)
;graphicWeatherColor:Farbe der Wetter-Icons für die Tagesstunden
;graphicWeatherColorNight:Farbe der Wetter-Icons für die Nachtstunden
;graphicShowDiff:Zusätzliche Anzeige der Differenz "<primärer Balkeninhalt> - <sekundärer Balkeninhalt>" im Kopf- oder Fußbereich der Balkengrafik

Die genaue Beschreibung und deren Optionen sind der aktuellen Online-Hilfe zu entnehmen.

'''Für alle Ebenen gilt:''' Ein Attribut mit einer ungeraden Balkennummer (z.B. graphicBeam1Content) bezieht sich immer auf den primären Balken, ein Attribut mit einer geraden Balkennummer (z.B. graphicBeam2Content) bezieht sich immer auf den sekundären Balken.

Die Balken haben, wie die meisten Elemente in der Balkengrafik, eine Mouse-Over Eigenschaft welche relevante Informationen zu den dargestellten Werten anzeigt.

Sind die Nachtunden mit '''graphicShowNight''' ausgeblendet, werden keine Balken angezeigt sofern es keine Werte anzuzeigen gibt. Sollten dennoch Werte ungleich 0 anzuzeigen sein, werden diese Werte auch trotz ausgeblendeter Nachstunden angezeigt.

==== Aktivierung der Balkengrafik Ebene 2 ====
[[Datei:Screenshot 2025-01-12 211741.png|right|thumb|400px|Balkengrafik mit aktivierter Ebene 2, gesetzem Attribut graphicShowNight=01 (mit Zeitsynchronisation zwischen Ebene 1 und Ebene 2)]]

Um die '''Ebene 2''' der Balkengrafik zu aktivieren, setzt man das Attribut '''graphicBeam3Content''' und/oder '''graphicBeam4Content''' mit den gewünschten darzustellenden Inhalten. Die weiteren Darstellungsoptionen, wie graphicBeamCColor, können ebenfalls für den jeweiligen Balken selektiv definiert werden wenn ein Attribut mit der entsprechenden Nummer (z.B. 4 für Balken 4) vorhanden ist.

'''Hinweis:''' Die Wetter-Icons können nur in Ebene 1 integriert werden.

Werden in der Balkengrafik die Nachtstunden ausgeblendet ('''graphicShowNight=0''' bzw. default), findet zwischen der Ebene 1 und der Ebene 2 keine Synchronisation der Zeitebene statt. Falls es einen inhaltlichen Zusammenhang zwischen den Werten der Ebene 1 und Ebene 2 gibt, eine Zeitsynchronisation zwischen den Ebenen wünschenswert und sinnvoll. Durch Setzen des Attrbut '''graphicShowNight=01''' kann diese Synchronisation eingeschaltet werden.

Dabei ist die Ebene 1 die führende Ebene, d.h. diese Ebene vererbt die exkludierten bzw. eventuell inkludierten Nachtstunden (wenn Werte in den Balken der Ebene 1 angezeigt werden sollen) an die nachfolgende Ebene.

==== Aktivierung der Balkengrafik Ebene 3 ====

Um die '''Ebene 3''' der Balkengrafik zu aktivieren, setzt man das Attribut '''graphicBeam5Content''' und/oder '''graphicBeam6Content''' mit den gewünschten darzustellenden Inhalten. Die weiteren Darstellungsoptionen, wie graphicBeamCColor, können ebenfalls für den jeweiligen Balken selektiv definiert werden wenn ein Attribut mit der entsprechenden Nummer (z.B. 5 für Balken 5) vorhanden ist.

Werden in der Balkengrafik die Nachtstunden ausgeblendet ('''graphicShowNight=0''' bzw. default), findet zwischen der Ebene 1 und der Ebene 3 keine Synchronisation der Zeitebene statt. Falls es einen inhaltlichen Zusammenhang zwischen den Werten der Ebene 1 und Ebene 3 gibt, ist eine Zeitsynchronisation zwischen den Ebenen wünschenswert und sinnvoll. Durch Setzen des Attrbut '''graphicShowNight=01''' kann diese Synchronisation eingeschaltet werden.

Dabei ist die Ebene 1 die führende Ebene, d.h. diese Ebene vererbt die exkludierten bzw. eventuell inkludierten Nachtstunden (wenn Werte in den Balken der Ebene 1 angezeigt werden sollen) an die nachfolgenden Ebenen, d.h. auch auf die Ebene 3.

<br>

=== 5 - Die Energieflußgrafik (Flow Graphic) ===
[[Datei:Screenshot 2025-02-13 213424.png|right|thumb|400px|Energieflußgrafik mit Verbrauchern in der Nachtdarstellung (Mondphasen) nach Sonnenuntergang]]

Die Energieflußgrafik stellt die registrierten Erzeuger, Batterien, Netzzugänge und Verbraucher strukturiert in mehreren Ebenen dar:

;Ebene 1: In der oberen Ebene befinden sich die PV-Generatoren, Smart-Loader sowie sonstigen Erzeuger
;Ebene 2: Die mittlere Ebene organisiert den Zugang zum öffentlichen Netz, dem Hausknoten, dem Batterieknoten sowie einem Dummy-Verbraucher (Lampensymbol) für den Energieverbrauch des Hauses der keinem der registrierten Verbraucher zugeordnet werden kann.
;Ebene 3: In der unteren Ebene werden die registrierten Verbraucher dargestellt. Unterhalb der Verbrauchersymbole werden der aktuelle Verbrauch (bzw. der On/Off-Zustand) sowie darunter die Restlaufzeit (Minuten) des Verbrauchers, sofern er durch das Modul geplant und gestartet wurde.

Die Position und Gestaltung der Grafikelemente ist umfangreich über das Attribut '''flowGraphicControl''' und den darin verfügbaren Schlüsseln einstellbar.
Die Bedeutung der Schlüssel ist in der Online-Hilfe zum Attribut mit einem Beispiel beschrieben.

Darüber hinaus enthalten die Setup-Attribute '''setupInverterDevXX''', '''setupOtherProducerXX''' und '''consumerXX''' weitere Einstellungsmöglichkeiten um deren Icons und Färbungen in der Flußgrafik individuell einstellen zu können. So sind zum Beispiel die Icons der PV-Inverter und deren Färbung mit dem Schlüssel '''icon''' der setupInverterDevXX-Attribute in Abhängigkeit von Tag und Nacht separat definierbar.

In den Verbraucher-Attributen ist mit dem Schlüssel '''noshow''' die Sichtbarkeit in der Flußgrafik definierbar.

Generell steuert das Attribut '''graphicSelect''' die Ein- bzw. Ausblendung der gesamten Flußgrafik.

== Bestimmung von Sonnenaufgang und Sonnenuntergang ==

Im Modul werden die Zeiten für den Sonnenaufgang und Sonnenuntergang aus alternativen Quellen verwendet. Es gelten dabei die folgenden Prioritäten.

* sind die lokalen Koordinaten ''latitude, longitude, altitude'' im ''global'' Device gesetzt, erfolgt die Berechnung dieser Daten mit dem Parameter '''HORIZON=-0.833''' (vgl. CommandRef zu [https://fhem.de/commandref_DE.html#SUNRISE_EL SUNRISE_EL]).

* sollten die lokalen Koordinaten nicht gesetzt sein, werden die Angaben aus dem in Attribut ''setupWeatherDev1'' angegebenen Wetter-Device entnommen.

Der Wert ''−0.833°'' entspricht dem international üblichen Standard für die Berechnung von Sonnenauf‑ und untergangszeiten. Er berücksichtigt sowohl die atmosphärische Refraktion als auch den halben Sonnendurchmesser und beschreibt damit den Moment, in dem der obere Sonnenrand scheinbar den Horizont berührt. Viele astronomische Algorithmen und [https://metacpan.org/release/JFORGET/DateTime-Event-Sunrise-0.0505/view/lib/DateTime/Event/Sunrise.pm Bibliotheken] verwenden diesen Wert als Default, weshalb er auch in SolarForecast eingesetzt wird.

<br>

== Die Verbrauchsprognose ==
Im Gegensatz zu der PV Prognose gibt es keine API oder andere externen Datenquellen die für die Verbrauchsprognose herangezogen werden könnten.

Zum Zweck der Verbrauchsermittlung verwendet das Modul die Meterdaten aus dem Attribut ''setupMeterDev'' sowie den weiteren setup-Attributen ''setupInverterDevXX''.
Sind auch andere Erzeuger (BHKW, Windanlagen, etc.) bzw. eine Batterie vorhanden, sind ebenfalls die Attribute ''setupOtherProducerXX'' bzw. ''setupBatteryDev'' für die Berechnung des Hausverbrauchs relevant. In diesen Attributen gibt es die Schlüssel ''*total'' die teilweise optional sind. Für die Verbrauchsprognose bilden sie jedoch die Berechnungsgrundlage und sind deswegen für diese Funktionalität wichtig anzugeben.

Die Verbrauchswerte werden stundengenau erfasst und im Datenspeicher ''pvHistory'' für 31 Tage, sowie im Datenspeicher ''pvCircular'' 210 Tage gespeichert. Die beiden Datenspeicher übernehmen unterschiedliche Aufgaben im Rahmen der Prognoseerstellung. Auf Grundlage der gespeicherten und somit historischen Verbrauchswerte erstellt das Modul eine Prognose für die kommende Zeit.

Mit dem Kommando

"get ... pvHistory [Tag]"

wird der Inhalt aufgelistet. Die Schlüssel ''confc'', ''con'' und ''gcon'' zeigen die Verbrauchsprognose, den Verbrauch und den Netzbezug der jeweiligen Stunde des gewählten Tages.
Die Stunde "99" zeigt die Summen dieser Schlüsssel für den Tag:

99 => etotal: , pvfc: 782, pvrl: 0, rad1h: -
confc: 14540, con: 13873, gcon: 13873, gfeedin: 0
batintotal: , batin: 0, batouttotal: , batout: 0
batmaxsoc: -, batsetsoc: -
wid: , wcc: , wrp: , pvcorrf: , dayname: So
cyclescsm01: 0
cyclescsm02: 0
cyclescsm03: 0
cyclescsm04: 1, hourscsme04: 0.00
cyclescsm05: 0
cyclescsm06: 0
cyclescsm07: 1, hourscsme07: 0.00
cyclescsm08: 1, hourscsme08: 0.00
cyclescsm09: 1, hourscsme09: 0.03

In dem Beispiel wurden für den Tag 14540 Wh Verbrauch prognostiziert, 13873 Wh tatsächlich verbraucht und davon 13873 Wh aus dem Netz bezogen. Leider war an diesem Tag keinerlei PV Ertrag vorhanden, was man auch an dem Schlüssel ''pvrl'' erkennen kann.

Den Inhalt des pvCircular-Speichers kann mit dem Befehl

"get ... pvCircular [Tag]"

angezeigt werden. Das nachfolgende Beispiel zeigt die Ausgabe für die Tagesstunde 23:

23 => pvapifc: 0, pvaifc: -, pvfc: 0, aihit: 0, pvrl: 0
batin01: 0, batin02: -, batin03: -
batout01: 619, batout02: -, batout03: -
confc: 650, gcon: 23, gfeedin: 0, wcc: 40, rr1c: 0.00
temp: -6.00, wid: 100, wtxt: Bewölkungsentwicklung nicht beobachtet
pprl01: -, pprl02: -, pprl03: -
...
con_all => Sa @ 617 762
Di @ 693 645
Mo @ 620 679
So @ 669 666 636
Mi @ 701 626
Do @ 612 642
Fr @ 615 606

Der Schüssel ''con_all'' enthält einen Hash aus Arrays die für jeden Wochentag (Mo..So) bis zu 30 Verbrauchswerte (in Wh) für die angezeigte Stunde speichern. Wie hier erkennbar ist, wurden an den drei vergangenen Sonntagen jweils 669 Wh, 666 Wh bzw. 636 Wh in der Stunde 23 (22:00-22:59) verbraucht.
Der Median aus diesen Werten geht in die Verbrauchsprognose ein.

'''Hinweis:''' Die Wochentagsnamen Mo..So sind von den installierten Locales auf Betriebsystemebene abhängig. Ist keine deutsche locale installiert, werden die englischen Wochentagsnamen Mon..Sun verwendet.

'''Ausblick (ab V 2.0.0, aktuell in Entwicklung):''' <br>
Die Verbrauchsprognose kann zukünftig auf '''herkömmliche Weise (Legacy)''' erstellt oder '''durch eine KI''' erstellt werden. Es ist auch eine prozentual einstellbare Kombination aus beiden Ergebnissen möglich. Weiter unten werden beide Varianten beschrieben. Bitte beachten, dass beide Technologien ihre spezifischen Attribute zur Einstellung haben.

Die KI-gestützte Prognose verwendet Langzeitdaten, die sich in einem speziellen Datenspeicher befinden und mit

get <Name> valDecTree aiRawData

eingesehen werden können. Wie lange diese Daten aufbewahrt werden, ist mit dem Attribut

attr <Name> aiControl->aiStorageDuration

einstellbar. Eine Pflege dieser Daten ist mit dem Befehl

set <Name> reset aiData ...

möglich.

<br>

=== Wie wird der Verbrauch des Hauses ermittelt und gespeichert? ===

Die Verbrauchsdaten des Hauses werden auf Stundenbasis ermittelt und gespeichert. Das "Haus" steht als Synonym aller im Kontext des Solarforecast Devices zusammengeführten Inverter (setupInverterDevXX), sonstigen Erzeuger (setupOtherProducerXX), Netzanschlüsse (setupMeterDev), Verbraucher (consumerXX) und Batterien (setupBatteryDev).

Alle diese Daten werden durch das Modul mit jedem ausgeführten Zyklus (Attribut plantControl->cycleInterval) und, wenn ein Event eines als 'asynchron' definierten Devices auftritt, gesammelt und daraus permanent ein aktualisierter Verbrauch berechnet. Die Berechnung beschreibt folgende Formel:

PV-Erzeugung + sonstige Erzeugung - Netzeinspeisung + Netzbezug - Batterieladung + Batterieentladung - Verbrauch = 0

bzw.

Verbrauch (Wh) = PV-Erzeugung + sonstige Erzeugung - Netzeinspeisung + Netzbezug - Batterieladung + Batterieentladung
con = PV + PP - GridIn + GridCon - BatIn + BatOut

Die PV-Erzeugung beinhaltet die Summe aller durch die angegebnen Inverter (setupInverterDev01 .. setupInverterDevXX) erzeugten Energien. Die "sonstige Erzeugung" summiert sich aus den Werten aller angegebenen Producer (setupOtherProducer01 .. setupOtherProducerXX). Der Verbrauch wird durch die registrierten Geräte consumerXX teilweise direkt erfasst, ist aber grundsätzlich unvollständig da nicht alle Verbrauchswerte im "Haus" gemessen und durch das Modul erfasst werden können.

Das folgende Beispiel zeigt das Ergebnis bei 300 Wh PV-Erzeugung und gleichzeitige 500 Wh Netzbezug:

Verbrauch = 300 + 0 - 0 + 500 - 0 + 0 = 800 Wh

Bei 1300Wh PV-Erzeugung, 100 Wh Netzeinspeisung sowie 200 Wh Batterieladung ergibt sich der Verbrauch zu:

Verbrauch = 1300 + 0 - 100 + 0 - 200 + 0 = 1000 Wh

Ohne Erzeugung, aber mit der Energielieferung von 500 Wh aus der Batterie, 800 Wh Netzbezug (mit einem Anteil Batterienachladung aus dem Netz von 200 Wh) sieht die Verbrauchsrechnung wie folgt aus:

Verbrauch = 0 + 0 - 0 + 800 - 200 + 500 = 1100 Wh

Der so ermittelte Verbrauchsert wird mit jedem Zyklus in der pvHistory im Schlüssel "con" gespeichert. Man kann sich die gespeicherten Werte mit dem Befehl

get <name> pvHistory [<Tag>]

angezeigt werden. Nachfolgendes Beispiel zeigt einen Datensatz für die Stunde 8 eines Tages:

<pre>
08 => pvfc: 0, pvrl: 0, pvrlvd: 1, rad1h: -
etotali01: 62940734, etotali02: 2928860, etotali03: -
pvrl01: 0, pvrl02: 0, pvrl03: -
etotalp01: -, etotalp02: -, etotalp03: -
pprl01: -, pprl02: -, pprl03: -
confc: 630, con: 962, gcons: 962, conprice: 0.2958
gfeedin: 0, feedprice: 0.1269
DoN: 0, sunaz: 120, sunalt: -3
batintotal: 3713815.07742543, batouttotal: 3604468.26993988, batin: 0, batout: 0
wid: 161, wcc: 89, rr1c: 0.00, pvcorrf: 0.27/0.00 temp: 7.40,
csmt01: 110996.12, csme01: 32.1399999999994, minutescsm01: 30
minutescsm02: 0
csmt03: 2513.67, csme03: 0, minutescsm03: 0
csmt04: 1581293.6, csme04: 136.5, minutescsm04: 60
csmt05: 1662.17, csme05: 0, minutescsm05: 0
csmt06: 90.53, csme06: 0, minutescsm06: 0
csmt07: 39.75, csme07: 0, minutescsm07: 0
csmt08: 38050, csme08: 0, minutescsm08: 0
csmt09: 131627, csme09: 33.2000000000116, minutescsm09: 39
minutescsm10: 0
</pre>

Im Schlüssel "con" ist der gespeicherte Verbrauch von 962 Wh ersichtlich.

Zur Laufzeit bekommt man mit dem Attribut ''ctrlDebug=collectData'' einen Einblick in die Verbrauchsermittlung bei jedem Zyklus und kann so die Eingangswerte und das daraus resultierende Ergebnis im FHEM Log nachverfolgen:

<pre>
...
2024.11.28 11:38:20.080 1: SolCast DEBUG> EnergyConsumption input -> PV: 96, PP: 0, GridIn: 0, GridCon: 582, BatIn: 5, BatOut: 0
2024.11.28 11:38:20.081 1: SolCast DEBUG> EnergyConsumption result -> 673 Wh
...
</pre>

<br>

=== Die Legacy-Verbrauchsprognose einstellen ===
==== Wie wird die Legacy-Verbrauchsprognose erstellt? ====

Aus den gespeicherten con-Werten (Verbrauchsdaten) der pvCircular (Schlüssel con_all) sowie Einträgen der pvHistory wird der Median der historischen Tage ermittelt und für den kommenden Tag bzw. die kommen Stunden zur Prognose angewendet. Dabei geht per default jeder verfügbare historische Tag gleichberechtigt in die Prognose ein. Mit dem Attribut '''plantControl->consForecastIdentWeekdays=1''' kann festgelegt werden, dass nur gleiche Wochentage (Mo..So) für die Prognose verwendet werden. Hierbei spielt die Vermutung, dass das Verbrauchsverhalten eine gewisse Korrelation zum Wochentag hat, eine Rolle.

Verwendet man die Einstellung consForecastIdentWeekdays=1, hat es sich als vorteilhaft erwiesen, das Attribut '''plantControl->consForecastLastDays''' auf einen niedrigeren Wert als den Default zu setzen. Eine Einstellung auf '8' zum Beispiel verwendet den Median der gleichen Wochentage der vergangenenen 8 Wochen. Dadurch wird nicht zu weit in die Vergangenheit verzweigt und so eine langsame Veränderung des Verbrauchsmedian, zum Beispiel hervorgerufen durch den Übergang vom Winter in das Frühjahr hinein, abgebildet.

Weiteren Einfluß auf die Verbrauchsprognose kann mit dem Schlüssel '''exconfc''' im Consumerattribut genommen werden. Insbesondere bei der unregelmäßigen Nutzung von Verbrauchern mit hoher Leistung kann die Projektion der aufgezeichneten historischen Werte in die Prognose zu unverhältnismäßig hohen Verbrauchswerwartunden führen.

Möglicherweise führt in Fällen die Verwendung eine der nachfolgenden Optionen zu einem besseren Ergebnis:

* '''1 -''' die allgemeine Verbrauchsprognose wird um die gespeicherten Energieverbrauchsanteile reduziert.
* '''2 -''' wie bei '1', jedoch gehen die Planungsdaten des Verbrauchers bei der Prognose der kommenden Stunden wieder mit ein.

Wird '''exconfc''' in einem der Consumer verwendet, sollte

* '''plantControl->consForecastIdentWeekdays=1'''
* '''plantControl->consForecastLastDays=4'''

eingestellt werden. Hintergrund ist, dass die Verbrauchsanteile der jeweiligen Verbraucher nur maximal 31 Tage in der pvHistory verfügbar sind. Für längere Zeiträume stehen nur Gesamtsummen des Verbrauchs in der pvCircular zu Verfügung.

Mit '''exconfc=1''' werden die in der Historie aufgezeichneten Verbrauchsbestandteile aus einer Prognose herausgerechnet. Konkret werden die in der pvHistory aufgezeichneten Verbrauchsbestandteile für die relevante Stunde ermittelt und daraus ein Durchschnitt gebildet der vom Prognosewert subtrahiert wird. Mit dem Attributwert plantControl->consForecastIdentWeekdays=1 werden wiederum nur identische Wochentage (Mo .. So) zusammengefasst.

Mit '''exconfc=2''' erfolgt ebenso die Eliminierung des Verbrauchsanteils, es wird jedoch auf die Planungsdaten für diesen Verbraucher zugegriffen und die geplanten Energieanteile wiederum der Verbrauchsprognose für die kommenden Stunden hinzugerechnet.

In beiden Anwendungsfällen ist es notwendig, dass dem Modul durch die Angabe entsprechender Readings der Energieverbrauch im Setup des Consumers bekannt gemacht wird damit diese Energieanteile registriert werden können. Allgemein funktioniert die Verbrauchsprognose gut wenn Verbrauchsprozesse regelmäßig in einem wiederkehrenden Zeitraster ablaufen, der Verbrauch durch persönliche Rituale bestimmt ist. So zum Beispiel könnte am Dienstag und Samstag gewöhnlich die Waschmaschine laufen, das E-Auto täglich aufgeladen werden und gebügelt wird oft am Sonntag Nachmittag.

Unregelmäßige Nutzung, vor allem vom Großverbrauchern, lässt sich nur sehr schwer und ungenügend auf zukünftige Verbrauchsprognosen projizieren.

Das Ergebnis der Prognose wird im Kopf der Grafik in der Zeile ''Verbrauch'' sowie in diversen Readings wie

* '''RestOfDayConsumptionForecast''' (Verbrauchsprognose für den Rest des Tages)
* '''NextHours_Sum04_ConsumptionForecast''' (Verbrauchsprognose für die nächsten 4 Stunden)
* '''Tomorrow_ConsumptionForecast''' (Verbrauchsprognose für den kommenden Tag)

angezeigt.

Weitere Aggregationen kann man sich über das Attribut '''ctrlStatisticReadings''' bei Bedarf zuschalten:

* '''conForecastTillNextSunrise''' - Verbrauchsprognose von aktueller Stunde bis zum kommenden Sonnenaufgang
* '''todayConForecastTillSunset''' - Verbrauchsprognose von aktueller Stunde bis Stunde vor Sonnenuntergang
* '''todayConsumptionForecast''' - Verbrauchsprognose aufgesplittet pro Stunde des aktuellen Tages (01-24)

<br>
==== Debugging der Legacy-Verbrauchsprognose ====

Um sich einen Einblick über die Erstellung der Verbrauchsprognose zu verschaffen, bietet sich die Einschaltung von:

attr <Name> ctrlDebug consumption_long

an. Mit diesem gesetzten Attribut wird die Erstellung der Prognose im Log protokolliert:

<pre>
2025.02.27 19:52:00.063 1: SolCast DEBUG> ################### Start Consumption forecast ###################
2025.02.27 19:52:00.063 1: SolCast DEBUG> Basics - installed locale: de_DE.UTF-8, used scheme: DE
2025.02.27 19:52:00.064 1: SolCast DEBUG> process Today dayname: Do, Tomorrow dayname: Fr
2025.02.27 19:52:00.065 1: SolCast DEBUG> consumer '03' register for exclude day 13, hod: 01 - 74.43 Wh
2025.02.27 19:52:00.065 1: SolCast DEBUG> consumer '03' register for exclude day 13, hod: 10 - 290.77 Wh
2025.02.27 19:52:00.065 1: SolCast DEBUG> consumer '03' register for exclude day 13, hod: 24 - 660.70 Wh
2025.02.27 19:52:00.066 1: SolCast DEBUG> consumer '03' register for exclude day 20, hod: 07 - 459.93 Wh
2025.02.27 19:52:00.066 1: SolCast DEBUG> consumer '07' register for exclude day 20, hod: 02 - 0.33 Wh
2025.02.27 19:52:00.067 1: SolCast DEBUG> consumer '03' register for exclude day 30, hod: 08 - 264.78 Wh
2025.02.27 19:52:00.067 1: SolCast DEBUG> ################### Consumption forecast for the next Hours (new median) ###################
2025.02.27 19:52:00.067 1: SolCast DEBUG> excl. hist 74 Wh for Hour 01, Considered value numbers: 1
2025.02.27 19:52:00.067 1: SolCast DEBUG> estimated cons of Hour 01: 436 Wh, Considered value numbers: 4
2025.02.27 19:52:00.068 1: SolCast DEBUG> excl. hist 0 Wh for Hour 02, Considered value numbers: 1
2025.02.27 19:52:00.068 1: SolCast DEBUG> estimated cons of Hour 02: 428 Wh, Considered value numbers: 4
2025.02.27 19:52:00.068 1: SolCast DEBUG> estimated cons of Hour 03: 458 Wh, Considered value numbers: 4
2025.02.27 19:52:00.068 1: SolCast DEBUG> estimated cons of Hour 04: 503 Wh, Considered value numbers: 4
2025.02.27 19:52:00.069 1: SolCast DEBUG> estimated cons of Hour 05: 489 Wh, Considered value numbers: 4
2025.02.27 19:52:00.069 1: SolCast DEBUG> estimated cons of Hour 06: 482 Wh, Considered value numbers: 4
2025.02.27 19:52:00.069 1: SolCast DEBUG> excl. hist 460 Wh for Hour 07, Considered value numbers: 1
2025.02.27 19:52:00.069 1: SolCast DEBUG> estimated cons of Hour 07: 274 Wh, Considered value numbers: 4
2025.02.27 19:52:00.070 1: SolCast DEBUG> excl. hist 265 Wh for Hour 08, Considered value numbers: 1
2025.02.27 19:52:00.070 1: SolCast DEBUG> estimated cons of Hour 08: 441 Wh, Considered value numbers: 4
2025.02.27 19:52:00.070 1: SolCast DEBUG> estimated cons of Hour 09: 558 Wh, Considered value numbers: 4
2025.02.27 19:52:00.070 1: SolCast DEBUG> excl. hist 291 Wh for Hour 10, Considered value numbers: 1
2025.02.27 19:52:00.071 1: SolCast DEBUG> estimated cons of Hour 10: 443 Wh, Considered value numbers: 4
2025.02.27 19:52:00.071 1: SolCast DEBUG> estimated cons of Hour 11: 881 Wh, Considered value numbers: 4
2025.02.27 19:52:00.071 1: SolCast DEBUG> estimated cons of Hour 12: 794 Wh, Considered value numbers: 4
2025.02.27 19:52:00.072 1: SolCast DEBUG> estimated cons of Hour 13: 840 Wh, Considered value numbers: 4
2025.02.27 19:52:00.072 1: SolCast DEBUG> estimated cons of Hour 14: 660 Wh, Considered value numbers: 4
2025.02.27 19:52:00.072 1: SolCast DEBUG> estimated cons of Hour 15: 812 Wh, Considered value numbers: 4
2025.02.27 19:52:00.072 1: SolCast DEBUG> estimated cons of Hour 16: 752 Wh, Considered value numbers: 4
2025.02.27 19:52:00.073 1: SolCast DEBUG> estimated cons of Hour 17: 597 Wh, Considered value numbers: 4
2025.02.27 19:52:00.073 1: SolCast DEBUG> estimated cons of Hour 18: 652 Wh, Considered value numbers: 4
2025.02.27 19:52:00.073 1: SolCast DEBUG> estimated cons of Hour 19: 634 Wh, Considered value numbers: 4
2025.02.27 19:52:00.073 1: SolCast DEBUG> estimated cons of Hour 20: 628 Wh, Considered value numbers: 3
2025.02.27 19:52:00.074 1: SolCast DEBUG> estimated cons of Hour 21: 713 Wh, Considered value numbers: 3
2025.02.27 19:52:00.074 1: SolCast DEBUG> estimated cons of Hour 22: 596 Wh, Considered value numbers: 3
2025.02.27 19:52:00.074 1: SolCast DEBUG> estimated cons of Hour 23: 629 Wh, Considered value numbers: 3
2025.02.27 19:52:00.074 1: SolCast DEBUG> excl. hist 661 Wh for Hour 24, Considered value numbers: 1
2025.02.27 19:52:00.075 1: SolCast DEBUG> estimated cons of Hour 24: 660 Wh, Considered value numbers: 3
2025.02.27 19:52:00.075 1: SolCast DEBUG> ################### Consumption forecast for the next day (new median) ###################
2025.02.27 19:52:00.075 1: SolCast DEBUG> estimated cons Tomorrow: 16848 Wh, Individual hourly values considered: 72, exclude: 0 Wh (avg of 0 entities)
2025.02.27 19:52:00.075 1: SolCast DEBUG> ################### Store Consumption forecast values (new median) ###################
2025.02.27 19:52:00.076 1: SolCast DEBUG> store 'NextHour00' hod '20' confc: 628, confcEx: 628
2025.02.27 19:52:00.076 1: SolCast DEBUG> store circular/history hod '20' confc: 628
2025.02.27 19:52:00.076 1: SolCast DEBUG> store 'NextHour01' hod '21' confc: 713, confcEx: 713
2025.02.27 19:52:00.077 1: SolCast DEBUG> store circular/history hod '21' confc: 713
2025.02.27 19:52:00.077 1: SolCast DEBUG> store 'NextHour02' hod '22' confc: 596, confcEx: 596
2025.02.27 19:52:00.077 1: SolCast DEBUG> store circular/history hod '22' confc: 596
2025.02.27 19:52:00.077 1: SolCast DEBUG> store 'NextHour03' hod '23' confc: 629, confcEx: 629
2025.02.27 19:52:00.078 1: SolCast DEBUG> store circular/history hod '23' confc: 629
2025.02.27 19:52:00.078 1: SolCast DEBUG> store 'NextHour04' hod '24' confc: 660, confcEx: 660
2025.02.27 19:52:00.078 1: SolCast DEBUG> store circular/history hod '24' confc: 660
2025.02.27 19:52:00.079 1: SolCast DEBUG> store 'NextHour05' hod '01' confc: 436, confcEx: 436
2025.02.27 19:52:00.079 1: SolCast DEBUG> store 'NextHour06' hod '02' confc: 428, confcEx: 428
2025.02.27 19:52:00.079 1: SolCast DEBUG> store 'NextHour07' hod '03' confc: 458, confcEx: 458
2025.02.27 19:52:00.079 1: SolCast DEBUG> store 'NextHour08' hod '04' confc: 503, confcEx: 503
2025.02.27 19:52:00.080 1: SolCast DEBUG> store 'NextHour09' hod '05' confc: 489, confcEx: 489
2025.02.27 19:52:00.080 1: SolCast DEBUG> store 'NextHour10' hod '06' confc: 482, confcEx: 482
2025.02.27 19:52:00.080 1: SolCast DEBUG> store 'NextHour11' hod '07' confc: 274, confcEx: 274
2025.02.27 19:52:00.081 1: SolCast DEBUG> store 'NextHour12' hod '08' confc: 441, confcEx: 441
2025.02.27 19:52:00.081 1: SolCast DEBUG> store 'NextHour13' hod '09' confc: 558, confcEx: 558
2025.02.27 19:52:00.081 1: SolCast DEBUG> store 'NextHour14' hod '10' confc: 443, confcEx: 443
2025.02.27 19:52:00.081 1: SolCast DEBUG> store 'NextHour15' hod '11' confc: 881, confcEx: 881
2025.02.27 19:52:00.082 1: SolCast DEBUG> store 'NextHour16' hod '12' confc: 794, confcEx: 794
2025.02.27 19:52:00.082 1: SolCast DEBUG> store 'NextHour17' hod '13' confc: 840, confcEx: 840
2025.02.27 19:52:00.082 1: SolCast DEBUG> store 'NextHour18' hod '14' confc: 660, confcEx: 660
2025.02.27 19:52:00.083 1: SolCast DEBUG> store 'NextHour19' hod '15' confc: 812, confcEx: 812
2025.02.27 19:52:00.083 1: SolCast DEBUG> store 'NextHour20' hod '16' confc: 752, confcEx: 752
2025.02.27 19:52:00.083 1: SolCast DEBUG> store 'NextHour21' hod '17' confc: 597, confcEx: 597
2025.02.27 19:52:00.083 1: SolCast DEBUG> store 'NextHour22' hod '18' confc: 652, confcEx: 652
2025.02.27 19:52:00.084 1: SolCast DEBUG> store 'NextHour23' hod '19' confc: 634, confcEx: 634
2025.02.27 19:52:00.084 1: SolCast DEBUG> store 'NextHour24' hod '20' confc: 628, confcEx: 628
2025.02.27 19:52:00.084 1: SolCast DEBUG> store 'NextHour25' hod '21' confc: 713, confcEx: 713
2025.02.27 19:52:00.084 1: SolCast DEBUG> store 'NextHour26' hod '22' confc: 596, confcEx: 596
2025.02.27 19:52:00.085 1: SolCast DEBUG> store 'NextHour27' hod '23' confc: 629, confcEx: 629
2025.02.27 19:52:00.085 1: SolCast DEBUG> store 'NextHour28' hod '24' confc: 660, confcEx: 660
2025.02.27 19:52:00.086 1: SolCast DEBUG> consumption calculated - day: 27, hod: 20, con: 574 Wh
2025.02.27 19:52:00.086 1: SolCast DEBUG> write pvCircular consumption - hod: 99, todayConsumption: 11210 Wh
</pre>

Die Ausgabe startet mit ''"Start Consumption forecast''", es werden die zu exkludierenden historischen Daten für jeden Consumer bzgl. jedem Tag (day) und Stunde des Tages (hod) getrennt registriert. Diese Werte werden durch die gespeicherte Einträge in der pvHistory (max. 31 historische Tage) geliefert.

Im nächsten Abschnitt ''"Consumption forecast for the next Hours (new median)"'' werden die Prognosen für die nächsten Stunden kalkuliert und die zuvor registrierten Excludes angewendet. Die Prognose für den kommenden Tag ist im Abschnitt ''"Consumption forecast for the next day (new median)"'' protokolliert. Die Prognose für den kommenden Tag ist nicht einfach die Summe der Prognose der nächsten Stunden, denn in den kommenden Stunden werden auch die verfügbaren Planungen der Consumer einbezogen. Für den kommenden Tag können diese Werte unter Umständen nicht einbezogen werden da sie zum Zeitpunkt X noch nicht verfügbar sind.

Im Abschnitt ''"Store Consumption forecast values (new median)"'' erscheinen die effektiv gespeicherten Werte. Diese sind die Grandlage für die grafische Darstellung sowie weiteren Kalkulationen.

<br>

==== Wie kann eine fehlerhafte Legacy-Verbrauchsprognose korrigiert werden? ====
Wie im vorherigen Abschnitt beschrieben, wird die Prognose aus den gespeicherten "con"-Werten der vergangenen Tage (bzw. Stunden) abgeleitet.
Grundsätzlich muß zunächst sichergestellt werden, dass die auszulesenden Readings der angegebenen Energiezähler sowie deren Einheiten! korrekt eingestellt sind. Das gilt ebenfalls für die registrierten Verbraucher im Modul.

Für einen ersten Überblick bietet sich das Debug Attribut an zu setzen:

attr <Name> ctrlDebug consumption_long

Beispielausgabe des Debug:

<pre>
2024.09.21 13:28:27.041 1: SolCast DEBUG> ################### Consumption forecast for the next day ###################
2024.09.21 13:28:27.042 1: SolCast DEBUG> History Consumption day >01< considering possible exclusions: 14082
2024.09.21 13:28:27.042 1: SolCast DEBUG> History Consumption day >08< considering possible exclusions: 16446
2024.09.21 13:28:27.042 1: SolCast DEBUG> History Consumption day >15< considering possible exclusions: 14568
2024.09.21 13:28:27.043 1: SolCast DEBUG> History Consumption day >25< considering possible exclusions: 15522
2024.09.21 13:28:27.043 1: SolCast DEBUG> estimated Consumption for tomorrow: 15154, days for avg: 4
2024.09.21 13:28:27.043 1: SolCast DEBUG> ################### Consumption forecast for the next hours ###################
2024.09.21 13:28:27.044 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 14 -> 850 Wh
2024.09.21 13:28:27.044 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 14 -> 643 Wh
2024.09.21 13:28:27.044 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 14 -> 590 Wh
2024.09.21 13:28:27.045 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 14 -> 522 Wh
2024.09.21 13:28:27.045 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 13:00:00, confc: 651, days for avg: 4, hist. consumption registered consumers: 560.97
2024.09.21 13:28:27.046 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 15 -> 720 Wh
2024.09.21 13:28:27.046 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 15 -> 743 Wh
2024.09.21 13:28:27.046 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 15 -> 897 Wh
2024.09.21 13:28:27.047 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 15 -> 557 Wh
2024.09.21 13:28:27.047 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 14:00:00, confc: 729, days for avg: 4, hist. consumption registered consumers: 620.97
2024.09.21 13:28:27.047 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 16 -> 676 Wh
2024.09.21 13:28:27.048 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 16 -> 790 Wh
2024.09.21 13:28:27.048 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 16 -> 785 Wh
2024.09.21 13:28:27.048 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 16 -> 581 Wh
2024.09.21 13:28:27.049 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 15:00:00, confc: 708, days for avg: 4, hist. consumption registered consumers: 647.29
2024.09.21 13:28:27.049 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 17 -> 622 Wh
2024.09.21 13:28:27.050 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 17 -> 639 Wh
2024.09.21 13:28:27.050 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 17 -> 646 Wh
2024.09.21 13:28:27.050 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 17 -> 572 Wh
2024.09.21 13:28:27.051 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 16:00:00, confc: 619, days for avg: 4, hist. consumption registered consumers: 618.30
2024.09.21 13:28:27.051 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 18 -> 596 Wh
2024.09.21 13:28:27.051 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 18 -> 614 Wh
2024.09.21 13:28:27.052 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 18 -> 580 Wh
2024.09.21 13:28:27.052 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 18 -> 480 Wh
2024.09.21 13:28:27.052 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 17:00:00, confc: 567, days for avg: 4, hist. consumption registered consumers: 583.41
2024.09.21 13:28:27.053 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 19 -> 615 Wh
2024.09.21 13:28:27.053 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 19 -> 1659 Wh
2024.09.21 13:28:27.053 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 19 -> 597 Wh
2024.09.21 13:28:27.054 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 19 -> 618 Wh
2024.09.21 13:28:27.054 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 18:00:00, confc: 872, days for avg: 4, hist. consumption registered consumers: 636.97
2024.09.21 13:28:27.055 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 20 -> 611 Wh
2024.09.21 13:28:27.055 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 20 -> 1124 Wh
2024.09.21 13:28:27.055 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 20 -> 546 Wh
2024.09.21 13:28:27.056 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 20 -> 479 Wh
2024.09.21 13:28:27.056 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 19:00:00, confc: 690, days for avg: 4, hist. consumption registered consumers: 578.87
2024.09.21 13:28:27.056 1: SolCast DEBUG> historical Consumption added for Sa -> date: 07, hod: 21 -> 1474 Wh
2024.09.21 13:28:27.057 1: SolCast DEBUG> historical Consumption added for Sa -> date: 14, hod: 21 -> 596 Wh
2024.09.21 13:28:27.057 1: SolCast DEBUG> historical Consumption added for Sa -> date: 24, hod: 21 -> 619 Wh
2024.09.21 13:28:27.057 1: SolCast DEBUG> historical Consumption added for Sa -> date: 31, hod: 21 -> 433 Wh
2024.09.21 13:28:27.058 1: SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 20:00:00, confc: 780, days for avg: 4, hist. consumption registered consumers: 584.96
...
</pre>

Im ersten Teil wird die erwartete Consumption für den nächsten Tag unter Berücksichtigung möglicher Ausschlüsse von Verbrauchern ausgegeben. Ausschlüsse von Verbrauchern ergeben sich wenn in dem Verbraucherattribut der Schlüssel '''exconfc''' gesetzt ist. Er besagt, dass die Verbrauchswerte des Verbrauchers in eine zukünftige Prognose nicht eingehen sollen. Zum Beispiel wenn ein Verbraucher mit sehr hohen Verbrauchswerten nur sporadisch eingesetzt wird und dadurch die Prognose stark verfälschen würde. Es ist auch zu sehen, dass bedingt durch das Attribut '''affectConsForecastIdentWeekdays = 1''' nur die historischen Tage 01, 08, 15 und 25 berücksichtigt werden.

Im zweiten Teil wird die berechnete Erwartung für die nächsten Stunden ausgegeben.
Zur Beschreibung der Fehlersuche gehen wir davon aus, dass die Prognose von 780 Wh am 2024-09-21 20:00:00 zu hoch erscheint weil am Tag "07" ein Wert von 1474 Wh gespeichert ist:

SolCast DEBUG> estimated Consumption for Sa -> starttime: 2024-09-21 20:00:00, confc: 780, days for avg: 4, hist. consumption registered consumers: 584.96

Im nächsten Schritt geben wir die historischen Werte für den Tag 07 aus:

get <Name> pvHistory 07

In dem Datensatz interessiert die Stunde 21. Sie resultiert aus der obigen Angabe "starttime: xxxx-xx-xx 20:00:00":

<pre>
21 => etotal: 64354660, pvfc: 0, pvrl: 0, pvrlvd: 1, rad1h: -
etotalp01: -, etotalp02: -, etotalp03: -
pprl01: -, pprl02: -, pprl03: -
confc: 496, con: 1474, gcons: 23, conprice: 0.2958
gfeedin: 5, feedprice: 0.1269
DoN: 0, sunaz: 289, sunalt: -8
batintotal: 3064096.92456668, batouttotal: 2958021.37946804, batin: 0, batout: 1460
wid: 101, wcc: 20, rr1c: 0.00, pvcorrf: 1.00/-temp: 26.00,
csmt01: 64262.43, csme01: 28.8099999999977, minutescsm01: 25
minutescsm02: 0
csmt03: 0, csme03: 0, minutescsm03: 0
csmt04: 1389417.4, csme04: 94.5, minutescsm04: 60
csmt05: 0, csme05: 0, minutescsm05: 0
csmt06: 290.15, csme06: 6.66999999999996, minutescsm06: 54
csmt07: 0, csme07: 0, minutescsm07: 0
csmt08: 32800, csme08: 0, minutescsm08: 0
csmt09: 103987.8, csme09: 38, minutescsm09: 43
csmt10: 9151.24999999783, csme10: 3.99999999997999, minutescsm10: 60
</pre>

In dem Datensatz sind die Energieverbrauchsanteile der im Device registrierten Verbraucher mit dem Schlüssel "csmeXX" gespeichert. Dabei ist "XX" die Verbrauchernummer. In dem Beispiel existieren die Anteile csme01 und csme03 - csme10. Keiner dieser Verbraucher hat einen auffälligen Verbrauchswert gespeichert, d.h. die Messung der Verbraucher scheidet als Problemquelle aus. Wäre ein unverhältmismäßig hoher Verbrauch bei einem der Verbraucher feststellbar, müssten die Schlüssel '''pcurr''' und '''etotal''' im consumerXX-Attribut geprüft, sowie die Datenlieferung des Consumerdevices selbst geprüft werden.

Es wurde offensichtlich ein hoher Verbrauch von einem nicht registrierten Verbraucher verursacht oder durch die Übertragung eines Meßfehlers des Devices, angegeben im Attribut '''setupMeterDev''', in das SolarForecast Device übertragen. Eine weitere Analyse ist an dieser Stelle nicht möglich.

Zur Behebung des falschen Wertes kann ein Reset der gespeicherten Consumption der relevanten Stunde durchgeführt werden:

set <Name> reset consumptionHistory 07 21

<br>
=== Die KI‑Verbrauchsprognose mit AI::FANN aktivieren und einstellen ===

FANN steht für '''Fast Artificial Neural Network'''.
Es handelt sich um eine sehr schnelle, leichtgewichtige Open‑Source‑Bibliothek zur Erstellung und zum Training künstlicher neuronaler Netze. Ein Manual dieser Library ist [https://fann.sourceforge.net/reference/index.html hier] verfügbar.

* FANN ist die '''technische Grundlage''' der KI‑Verbrauchsprognose.
* ws berechnet aus historischen Verbrauchsdaten ein Modell, das zukünftige Werte vorhersagen kann.
* es ist '''robust, schnell und ressourcenschonend''', ideal für Systeme, die regelmäßig neu trainiert werden müssen.
* FANN arbeitet mit klassischen Feed‑Forward‑Netzen und Backpropagation‑Training – also bewährten, stabilen Methoden.

'''AI::FANN''' ist ein Perl‑Modul, das als Schnittstelle (Binding) zwischen SolarForecast und der FANN‑Bibliothek dient.

* AI::FANN ist die Brücke, über die unser Prognosesystem mit FANN kommuniziert.
* es ermöglicht dem System:
::* Trainingsdaten an FANN zu übergeben
::* ein neuronales Netz zu erzeugen
::* das Training zu steuern
::* das fertige Modell zu speichern und später für Prognosen zu nutzen

==== Voraussetzungen ====

===== Installation der FANN‑Library (Linux) =====

<pre>
sudo apt-get update && sudo apt-get upgrade
sudo apt-get install gcc
sudo apt-get install libfann-dev libfann2
</pre>

RPM‑basierte Systeme:

<pre>
sudo dnf install fann-devel
</pre>

RPM‑basierte Systeme sind Linux‑Distributionen, die das Paketformat RPM (Red Hat Package Manager) verwenden.

Typische RPM‑basierte Linux‑Distributionen:
* Red Hat Enterprise Linux (RHEL)
* CentOS / CentOS Stream
* Fedora
* openSUSE / SUSE Linux Enterprise
* Rocky Linux
* AlmaLinux
* Mageia

===== Installation der FANN‑Library (Windows) =====

* der Installations- bzw. Erstellungsprozess der dll ist [https://fann.sourceforge.net/reference/x26.html hier] beschrieben
* fann.dll in PATH oder FHEM‑Verzeichnis kopieren
* Perl‑Installation muss DLL laden können

<br>

===== Installation des Perl‑Moduls AI::FANN =====

<pre>
cpan install AI::FANN
</pre>

Auf Debian Linux Systemen kann das Modul auch mit

<pre>
sudo apt-get install libai-fann-perl
</pre>

installiert werden.

Alternativ kann natürlich auch cpanm oder der [https://wiki.fhem.de/wiki/Meta#Der_FHEM_Installer FHEM Installer] verwendet werden.

<br>

==== Bestandteile der Machine-Learning (ML)‑Pipeline ====

===== Datenaufbereitung =====

Die Datenaufbereitung ist der wichtigste Schritt jeder ML‑Pipeline, da sie die Qualität der Eingabedaten sicherstellt.
Schlechte oder unskalierte Daten führen fast immer zu schlechten Modellen.

* '''Normalisierung / Skalierung'''
:- ML‑Modelle benötigen Eingabewerte in vergleichbaren Größenordnungen.
:- Beispiel: PV‑Leistung (0–10 000 W) vs. Uhrzeit (0–23).
:- Ohne Normalisierung würden große Werte die kleinen dominieren.

* '''Feature‑Engineering'''
: Aus Rohdaten werden zusätzliche Merkmale erzeugt, die Muster besser sichtbar machen:
::- Lags: Verbrauch der letzten Minuten/Stunden
::- Deltas: Änderungen gegenüber vorherigen Zeitpunkten
::- Zeitmerkmale: Stunde, Wochentag, Feiertag
::- PV‑Prognosen: erwartete Erzeugung als Einflussfaktor
::- Saisonale Merkmale: Sommer/Winter, Temperatur
::- Semantik (Erstellung von Interaktionen)
::- Rolling‑Statistics

📊 ''Rolling‑Statistics'' <br>
„Rolling“ bedeutet, dass die Kennzahlen nicht einmalig über den gesamten Datensatz berechnet werden, sondern gleitend über ein Zeitfenster (z. B. 24 h, 7 Tage, 100 Samples). So werden Trends, Drift, Modellverschlechterung oder saisonale Muster besser erkannt.

* '''Integration zusätzlicher Verbraucher'''
: Wärmepumpen oder E‑Autos erzeugen starke, unregelmäßige Peaks.
: Diese können als zusätzliche Features einfließen.

'''Es wird umgesetzt:'''
* ✔ Normalisierung auf physikalische Grenzen (PV‑Maximalleistung, Hausverbrauchs‑Maxima)
* ✔ Feature‑Engineering wie Lags, Deltas, Rolling‑Statistics, Zeitmerkmale, PV/PV-Prognosen als Input und weitere Semantik
* ✔ Optionale Zusatzlasten (WP/EV)

===== Trainingsdaten‑Split =====

Der Split trennt Daten in Trainingsdaten (zum Lernen) und Validierungsdaten (zur Qualitätskontrolle).

* '''Training'''
: Das Modell lernt Muster aus historischen Daten.

* '''Validierung'''
: Das Modell wird auf Daten getestet, die es nicht gesehen hat.
: Dadurch erkennt man Overfitting.

* '''Shuffling'''
: Durchmischen der Daten, um Reihenfolgeeffekte zu vermeiden.
: Besonders wichtig bei Zeitreihen.

'''Es wird umgesetzt:'''
* ✔ Training/Validierung‑Split
* ✔ Shuffling je nach Einstellung von aiControl->aiConShuffleMode
* ✔ Shuffle‑Perioden während des Trainings

===== Netzarchitektur =====

Die Architektur bestimmt, wie das neuronale Netz aufgebaut ist.

* '''Inputs'''
: Anzahl der Merkmale (Features), die das Modell erhält.

* '''Hidden Layers'''
: Anzahl und Größe der verdeckten Schichten bestimmen, wie komplexe Muster erkannt werden können.

* '''Output Layer'''
: bei SolarForecast: 1 Wert = Verbrauchsprognose (Wh).

'''Es wird umgesetzt:'''
* ✔ Dynamische Input‑Anzahl je nach aktivierten Features
* ✔ Konfigurierbare Hidden Layers (z. B. 80‑40‑20)
* ✔ 1 Output‑Neuron
* ✔ Konfigurierbare Aktivierungsfunktionen

===== Training =====

Hier werden die Gewichte des Netzes angepasst, um Fehler zu minimieren.

* '''Trainingsalgorithmus'''
: RPROP: stabil, robust
: INCREMENTAL: schneller, aber empfindlicher

* '''Lernrate (Learning Rate)'''
: Wie stark Gewichte pro Schritt angepasst werden.

* '''Momentum'''
: Glättet die Lernbewegung, verhindert Zickzack‑Verhalten.

* '''Steepness'''
: Steuert die Empfindlichkeit der Aktivierungsfunktion.

* '''Shuffle‑Perioden'''
: Wie oft die Trainingsdaten neu gemischt werden.

* '''Early‑Stopping'''
: Training wird beendet, wenn Validierungsfehler nicht mehr sinkt.

'''Es wird umgesetzt:'''
* ✔ RPROP und INCREMENTAL
* ✔ Learning Rate, Momentum, Steepness konfigurierbar
* ✔ Shuffle‑Perioden
* ✔ Early‑Stopping über Validierungsfehler
* ✔ Mehrere Trainingsläufe (Runs) zur Modellselektion

===== Modellselektion und Fehlerevaluierung =====

Hier wird entschieden, welches Modell am Ende verwendet wird.
Die Ergebnisse des Trainings werden während des Traininglaufs fortlaufend überwacht und die Einhaltung von intern vorgegebenen Kennzahlen von einem Retrain-Guard überprüft.

'''Evaluation'''
* MAE, MAPE, RMSE, R²
* BitFail
* Bias/Slope
* P95/P99

📈 ''Fehlermaße: MAE, MAPE, RMSE, R²'' <br>
* '''MAE''' – Mean Absolute Error (durchschnittlicher absoluter Fehler)
::: MAE=1/𝑛∑∣𝑦−𝑦<sup>^</sup>∣
* '''MAPE''' – Mean Absolute Percentage Error (prozentualer Fehler)
::: MAPE=100/𝑛∑∣(𝑦−𝑦<sup>^</sup>)/𝑦∣
::* Achtung: '''problematisch bei kleinen oder Null‑Werten''' (klassisch bei Verbrauchsdaten nachts).
* '''RMSE''' – Root Mean Squared Error (Quadratischer Fehler, stärker empfindlich für Ausreißer)
::* gut, wenn große Fehler besonders kritisch sind
* '''R²''' – Bestimmtheitsmaß (Anteil der Varianz, den das Modell erklärt)
::: 𝑅<sup>2</sup>=1−(SSE/SST)
::* 1.0 = perfekt, 0 = nicht besser als Mittelwert, <0 = schlechter als Mittelwert
* '''P95 / P99''' (Quantile) - Quantile beschreiben, wie groß der Fehler in den schlechtesten X % der Fälle ist.
::* '''P95:''' 95 % der Fehler liegen darunter → die schlechtesten 5 % sind größer
::* '''P99:''' 99 % der Fehler liegen darunter → zeigt Extremfehler
* '''Bias / Slope''' (Regression‑Diagnostik) - Diese beiden Werte stammen aus einer linearen Regression zwischen '''Vorhersage''' und '''Ist‑Wert'''.
::* Diese beiden Werte sind extrem hilfreich, um Modell‑Drift oder fehlerhafte Normalisierung zu erkennen.
::* Slope - Ideal: 1.0
:::* < 1 → Modell unterschätzt hohe Werte
:::* >= 1 → Modell überschätzt hohe Werte
:::* zeigt systematische Skalierungsfehler
::* Bias - Ideal: 0
:::* positiv → Modell sagt im Schnitt zu wenig vorher
:::* negativ → Modell sagt im Schnitt zu viel vorher
:::* zeigt systematische Verschiebung
* '''BitFail'''
::* FANN verwendet „BitFail“ als Zählwert, wie viele Ausgaben eines Samples „falsch“ sind. Ein Output gilt als falsch, wenn der Fehler größer ist als ein definierter BitFail‑Schwellwert (z. B. 0.35).
::* Bei Regressionen ist BitFail weniger aussagekräftig, aber:
:::- es zeigt, wie viele Samples „deutlich daneben“ liegen.
:::- gut zur schnellen Qualitätskontrolle während des Trainings.

Wird die geforderte Güte nicht erreicht, initiiert der Guard eine Wiederholung des Trainings bis zu einer maximalen Anzahl von Durchläufen.

* '''Bestes Modell speichern'''
: Das Modell mit dem niedrigsten Validierungsfehler wird ausgewählt.

* '''Verwendung nur des besten Modells'''
: Schlechtere Modelle werden verworfen.

* '''Trainingsmodus ohne Prognose'''
: Nützlich, wenn man nur trainieren, aber noch nicht prognostizieren möchte.
: einschalten mit aiControl ->aiConActivate=2

'''Es wird umgesetzt:'''
* ✔ Monitoring mit Fehlerevaluierung
* ✔ bestes Modell wird automatisch gespeichert
* ✔ Prognosen basieren ausschließlich auf dem besten Modell
* ✔ Trainingsmodus only möglich (aiConActivate=2)
* ✔ Ausgabe detaillierter Trainingsmetriken

<br>

==== Einstellbare Parameter über 'attr <Name> aiControl' ====

Die Einstellung von '''aiConActivate''', '''aiConAlpha''' und '''aiConTrainStart''' wirken sofort, alle anderen Parameter werden erst beim nächsten Trainingslauf wirksam.

'''<u>aiConActivate</u>'''

{| class="wikitable"
! Wert !! Bedeutung
|-
| 0 || KI deaktiviert
|-
| 1 || KI aktiviert (Standard)
|-
| 2 || Trainingsmodus aktiv, die KI-Prognose ist deaktiviert. Es wird maximal eine Trainingswiederholung ausgeführt.
|}

'''Best‑Practice:''' <br>
* 1 ab 2000–3000 verfügbaren Datensätzen (siehe get <Name> valDecTree aiRawData), bei WP/EV > 5000
* Der Trainingsmodus dient dazu verschiedene Einstellungen testen zu können. Zur Zeitersparnis wird maximal eine Trainingswiederholung ausgeführt, unabhängig von der Güte des Trainingsergebisses

'''<u>aiConAlpha</u>'''

Mit diesem Parameter kann ein Hybridergebnis aus klassischen (Legacy‑)Prognosen und durch die KI ermittelten Prognosewerten erzeugt werden. Das Hybridergebnis wird durch eine prozentuale Mischung beider Resultate erstellt.

{| class="wikitable"
! Wert !! Bedeutung
|-
| 0 || die KI-Ergebnisse werden nicht verwendet, nur Legacy Werte gehen in das finale Ergebnis ein
|-
| 0.x || die KI-Ergebnisse gehen zu 0.x * 100%, die Legacy Werte zu (1-0.x) * 100% in die finale Prognose ein
|-
| 1 || es werden ausschließlich KI-Ergebnisse verwendet, Legacy Werte gehen nicht in das finale Ergebnis ein
|}

'''Best‑Practice:''' <br>
* 1 wenn die Genauigkeit der KI-Prognose überzeugend ist, ansonsten kann ein Mix aus KI und Legacy-Prognose hergestellt werden

'''<u>aiConTrainStart</u>'''

Legt fest, wann das Modul ein atomatisches Erst- bzw. Folgetraining durchführt. Im Standard erfolgt das Training alle 7 Tage.

Format: `<Tage>:<Stunde>`, z. B. `7:3`.

'''Best‑Practice:''' <br>
* 7–14 Tage für normale Haushalte
* 3–5 Tage bei WP/EV

'''<u>aiConActFunc</u>'''

{| class="wikitable"
! Funktion !! Eigenschaften
|-
| SIGMOID || + bewährt, stabil, gut für kontinuierliche, monotone Zusammenhänge
– kann bei großen Inputs saturieren, aber bei Verbrauchsprognose meistens gut
|-
| GAUSSIAN || + gut für glatte Muster
– schlecht für harte Peaks (EV, Trockner), kann „vergessen“ und saturieren
|-
| ELLIOT || + schnellere, numerisch robustere Approximation von Sigmoid/Tanh, weniger Rechenaufwand
+ oft etwas „härter“ in der Reaktion, kann Peaks besser durchreichen <br>
– immer noch S‑förmig, also keine Wunderwaffe gegen komplett unmodellierte EV‑Ereignisse
|}

'''Best‑Practice:''' <br>
* SIGMOID oder SIGMOID_SYMMETRIC als Standard
* bei allen weiteren Aktivierungsfunktionen kommt es auf den Versuch an

'''<u>aiConHiddenLayers</u>'''

{| class="wikitable"
! Typ !! Beispiel !! Eigenschaften
|-
| klein || 50‑25 || schnell, weniger genau
|-
| mittel || 64‑32 || guter Kompromiss
|-
| tief || 64‑32‑16 / 80‑40‑20 || erkennt komplexe Muster
|}

'''Best‑Practice:''' <br>
* < 3000 verfügbaren Datensätzen → `50-25`
* 3000–8000 verfügbaren Datensätzen → `64-32`
* > 8000 verfügbaren Datensätzen oder WP/EV → `80-40-20`

'''<u>aiConLearnRate</u>'''

{| class="wikitable"
! Wert !! Bedeutung
|-
| 0.001 || sehr stabil, langsam
|-
| 0.005 || guter Kompromiss
|-
| 0.01–0.05 || schnell, aber instabil
|}

'''Best‑Practice:''' <br>
* 0.005, bei WP/EV 0.001

'''<u>aiConBitFailLimit</u>'''

Das Bit‑Fail‑Limit bestimmt, '''ab welcher Abweichung zwischen Prognose und echtem Wert''' ein Trainingspunkt als „Fehler“ gezählt wird.
Ein kleinerer Wert macht das Training '''strenger''', ein größerer Wert macht es '''toleranter'''.

* '''kleineres Limit → Modell versucht Peaks stärker zu treffen''' → kann instabil werden, besonders mit INCREMENTAL
* '''größeres Limit → Modell glättet stärker''' → robuster, aber weniger peak‑sensitiv

{| class="wikitable"
! Wert !! Bedeutung
|-
| kleineres Limit (0.10–0.25) || Das Modell versucht Peaks und schnelle Änderungen genauer zu treffen, kann aber instabiler werden.
|-
| mittleres Limit (0.25–0.35) || Gute Balance zwischen Genauigkeit und Stabilität. Empfohlener Bereich.
|-
| größeres Limit (0.35–0.50) || Das Modell wird robuster gegen Ausreißer und Rauschen, reagiert aber weniger stark auf Spitzenlasten.
|}

🌪️ '''Was bedeutet „verrauschter Haushalt“?''' <br>
Ein Haushalt gilt als „verrauscht“, wenn der Stromverbrauch viele kleine, unregelmäßige Schwankungen hat, die nicht durch klare Muster (z. B. PV, Wärmepumpe, feste Tagesabläufe) erklärbar sind.
Dazu gehören spontane Gerätewechsel, impulsartige Lasten oder allgemein unruhige Verbrauchsprofile.

Für solche Haushalte ist ein höheres Bit‑Fail‑Limit sinnvoll, weil das Modell dadurch robuster wird und nicht versucht, jede kleine Zufallsschwankung exakt vorherzusagen.

'''Best‑Practice:''' <br>
* versuche deinen Haushalt gemäß der oben beschriebenen Rauscheigenschaft einzuordnen und entscheide dann, ob ein Training unterhalb oder oberhalb des Defaultwertes (0.35) bei dir sinnvoll sein könnte. Bleibe dann bei der Einstellung die bei dir die besten Ergebnisse liefert.

'''<u>aiConMomentum</u>'''

{| class="wikitable"
! Bereich !! Bedeutung
|-
| 0.2 || reagiert direkt, schwankt stärker
|-
| 0.5–0.8 || stabil, guter Kompromiss
|-
| 0.9 || sehr stark geglättet
|}

'''Best‑Practice:''' <br>
* 0.5, bei WP/EV 0.7–0.8

'''<u>aiConShuffleMode</u>'''

{| class="wikitable"
! Wert !! Bedeutung
|-
| 0 || chronologisch
|-
| 1 || chronologischer Split + Shuffle
|-
| 2 || vollständiges Shuffle
|}

'''Best‑Practice:''' <br>
* 2, bei saisonalen Mustern 1

'''<u>aiConShufflePeriod</u>'''

{| class="wikitable"
! Wert !! Bedeutung
|-
| 10 || viel Variation
|-
| 15–20 || stabiler Kompromiss
|-
| >20 || Gefahr von Overfitting
|}

'''Best‑Practice:''' <br>
* 10, bei großen Datensätzen 15–20

'''<u>aiConSteepness</u>'''

{| class="wikitable"
! Bereich !! Bedeutung
|-
| <0.4 || starke Glättung
|-
| 0.5 || Standard
|-
| >0.7 || schärfere Muster
|}

'''Best‑Practice:''' <br>
* 0.9, bei glattem Verbrauch 0.5

'''<u>aiConTrainAlgo</u>'''

{| class="wikitable"
! Algorithmus !! Eigenschaften
|-
| RPROP || stabil, wenig Parameter
|-
| INCREMENTAL || schneller, empfindlicher
|}

'''Best‑Practice:''' <br>
* RPROP bei WP/EV
* INCREMENTAL bei einfachen Profilen

'''<u>aiConProfile</u>'''

Die folgenden Profile bestimmen, welche Verbrauchslogiken und Semantiken im Modell aktiviert werden. Sie beeinflussen, wie stark das Modell auf typische Haushaltsaktivitäten, PV‑Erzeugung und Wärmepumpenverhalten reagiert.

Damit Nutzer das passende Profil wählen können, sind die Profile hier verständlich beschrieben.

{| class="wikitable"
! Profil !! Eigenschaften
|-
| v1_common || Dieses Profil bildet den typischen menschlichen Tagesrhythmus ab:
* Morgenaktivität (Aufstehen, Geräte an)
* Mittagsaktivität (Kochen, Haushalt)
* Abendaktivität (Kochen, Licht, Geräte)
* Später Abend (Geräte gehen aus)
* Wochenendverhalten
* Tagesmuster vom Vortag
* Grundlast nachts

Es nutzt Zeitstruktur, saisonale Muster, Wetter und Verbrauchsdynamik — aber '''keine PV‑ oder Wärmepumpenlogik'''. <br>
'''Empfohlen für:'''
Haushalte mit reinem Stromverbrauch ohne besondere Geräte und wenig PV Einfluß, z.B. mit kleiner Balkon PV-Anlage.

|-
| v1_common_active || Für '''Haushalte mit stark ausgeprägten Aktivitätsmustern''' <br>
Wie ''v1_common'', aber mit stärkerer Betonung auf:
* Verbrauchssprüngen
* Trendbrüchen
* Volatilität (z. B. Kochen, Gerätewechsel)
* Wiederkehrenden Peaks

Dieses Profil reagiert sensibler auf '''kurzfristige Verbrauchsdynamik'''. <br>
'''Empfohlen für:'''
Haushalte mit unregelmäßigen oder dynamischen Verbrauchsprofilen (z.B. viele Geräte, Homeoffice, Familien).

|-
| v1_common_pv || Für '''Haushalte mit dominanter PV‑Anlage''' <br>
Erweitert ''v1_common'' um PV‑Semantik:
* PV‑Erzeugung + Tageszeit
* PV‑Drop‑Erkennung (Wolke → Lastabfall)
* PV‑abhängige Verbrauchsverschiebung
* PV‑Mittagsspitzen‑Verstärker
* PV‑Temperatur‑Interaktionen (Heizung, Batterie, Geräteverhalten)

Das Modell versteht, dass Haushalte '''mittags anders verbrauchen''', wenn PV‑Strom verfügbar ist. <br>
'''Empfohlen für:'''
Haushalte mit größerer PV‑Anlage, aber ohne Wärmepumpe.

|-
| v1_common_active_pv || Für '''Haushalte mit PV und dynamischem Verbrauchsverhalten''' <br>
Kombiniert:
* Dynamik‑Semantik aus v1_common_active
* PV‑Semantik aus v1_common_pv

Dieses Profil erkennt:
* spontane Peaks bei PV‑Überschuss
* Verbrauchssprünge + PV‑Erzeugung
* Trendverstärker mittags
* PV‑Drop‑Reaktionen
* Volatilität + PV‑Interaktionen

'''Empfohlen für:'''
PV‑Haushalte mit aktiven Verbrauchern (z.B. Kochen, Waschmaschine, Trockner usw.).

|-
| v1_heatpump || Für '''Haushalte mit Wärmepumpe (ohne dominante PV)''' <br>
Aktiviert die komplette Wärmepumpen‑Semantik:
* Heizmodus, Kühlmodus
* Warmwasser (morgens/abends, Zyklen, Kaltstart)
* Frostschutz
* Temperaturtrends
* Effizienzindikatoren (COP‑Proxy)
* Heiz‑/Kühlbedarf
* Temperaturdeltas und -historie

Das Modell versteht typische WP‑Verbrauchsmuster:
* morgens und abends Heizen
* Warmwasserzyklen
* Frostschutz nachts
* Reaktion auf Temperaturstürze

'''Empfohlen für:'''
Haushalte mit Wärmepumpe, aber ohne dominante PV.

|-
| v1_heatpump_pv || Für '''Wärmepumpen‑Haushalte mit dominanter PV''' <br>
Kombiniert:
* Wärmepumpen‑Semantik
* PV‑Semantik
* PV‑Warmwasser‑Boost
* PV‑Mittagsverschiebung
* PV‑abhängige Heiz-/WW‑Strategien
* Das Modell erkennt:
* PV‑Überschuss → Warmwasser
* PV‑Erzeugung → Heiz-/Kühlverhalten
* PV‑Drop → Lastabfall
* PV + Kälte → Heizspitzen

'''Empfohlen für:'''
Haushalte mit Wärmepumpe und dominanter PV‑Anlage.

|-
| v1_heatpump_active_pv || Für '''Wärmepumpe + PV + dynamisches Verbrauchsverhalten''' <br>
Das umfassendste Profil. Es kombiniert:
* Wärmepumpen‑Semantik
* PV‑Semantik
* Dynamik‑Semantik (Trend, Volatilität, Peaks)
* Spezial‑Booster (z. B. heatpump_boost_special, pv_mittag_peak_boost_special)

Dieses Profil erkennt:
* spontane Verbrauchssprünge
* WP‑Zyklen + PV‑Überschuss
* Trendbrüche + Temperaturdeltas
* dynamische Mittagspeaks
* komplexe Interaktionen zwischen PV, WP und menschlichem Verhalten

'''Empfohlen für:'''
Haushalte mit Wärmepumpe, PV und sehr aktivem Verbrauchsverhalten.

|-
| ||
|}

'''Best‑Practice:''' <br>
Die oben angegebenen Profileigenschaften beschreiben die implementierten Verstärkungen bzw. auch Abschwächungen zur Unterstützung des Lernprozesses der künstlichen Intelligenz. Teste Trainings mit unterschiedlichen Profilen und wähle das Profil mit dem die besten Ergebnisse erzielt werden. Beginne mit dem Profil welches wahrscheinlich am Besten zu deinem Haushalt passen könnte.

<br>

==== Integration von Umwelt- und Kontextfaktoren in die Prognose ====

Die Verbrauchscharakteristik eines Haushalts wird nicht nur durch die eingesetzten elektrischen Geräte bestimmt, sondern auch durch verschiedene systemische Einflussfaktoren, darunter:

* Anwesenheit bzw. Abwesenheit der Bewohner
* Außentemperaturen
* Abweichungen vom üblichen Tagesmuster, z.B. durch Feiertage oder Urlaubszeiten

'''Einbindung von Sensoren und Kontextdaten'''

Außentemperatursensoren sowie Geräte zur Anwesenheits- oder Bewegungsdetektion werden im Attribut '''setupEnvironment''' hinterlegt. Die dafür erforderliche Syntax ist in der Online‑Hilfe des Moduls dokumentiert. SolarForecast nutzt diese Informationen, um Verbrauchsprognosen an reale Rahmenbedingungen anzupassen.

'''Feiertage und Urlaubszeiten'''

Für die Berücksichtigung von Feiertagen und Urlaub wird das in FHEM etablierte Verfahren über [https://fhem.de/commandref_DE.html#holiday holiday]-Devices verwendet.
Dazu werden die entsprechenden holiday‑Devices im globalen Attribut ''holiday2we'' registriert. SolarForecast liest die dort eingetragenen holiday‑Devices aus und übernimmt die darin definierten Daten (z.B. gesetzliche Feiertage, benutzerdefinierte freie Tage oder Urlaubszeiträume).

<br>
==== Das Training durchführen und produktiv setzen (Best Practice Ansatz) ====

Sind alle [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Voraussetzungen|Voraussetzungen]] erfüllt, kann das Verbauchsprognose-Modell trainiert und – sofern das Ergebnis überzeugt – für den Produktivbetrieb aktiviert werden.

1️⃣ '''Training‑Only‑Modus aktivieren'''

Für das initiale Training wird FANN im ''Training‑Only‑Modus'' aktiviert:

attr <Name> aiControl aiConActivate=2

In diesem Modus kann das Modell beliebig oft trainiert, bewertet und durch Anpassung der [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Einstellbare_Parameter_über_'attr_<Name>_aiControl|Steuerungsparameter]] optimiert werden – ohne dass die produktive Prognose beeinflusst wird. Es kann jederzeit ein neues Training gestartet werden.

Wer den Trainingsablauf und die internen Prüfungen live verfolgen möchte, aktiviert zusätzlich:

attr <Name> ctrlDebug aiProcess

2️⃣ '''Training starten'''

Mit der FANN-Aktivierung durch aiControl aiConActivate=2 (oder 1) werden automatisch sinnvolle '''Standardparameter''' für FANN gesetzt. Für den Einstieg empfiehlt es sich, zunächst mit diesen Defaults zu trainieren und Änderungen an Parametern schrittweise vorzunehmen, neu zu trainieren und die Veränderungen im Ergebnis zu bewerten. Als Hilfestellung gibt es dazu einen separaten [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Auswertung_der_Trainingskennwerte|Abschnitt]].

Das Training wird manuell gestartet mit:

set <Name> aiDecTree runConTrain

'''Hinweis:''' Ein bereits laufendes Training wird durch einen erneuten Start mit ''runConTrain'' automatisch abgebrochen.

Ein laufendes Training kann jederzeit manuell beendet werden:

set <Name> aiDecTree stopConTrain

3️⃣ '''Wie das Training intern abläuft'''

Der Trainingsprozess wird vollständig durch die interne Steuerungslogik des Moduls geführt:

* Ein Trainingsjob umfasst '''bis zu 6 Trainingswiederholungen''', jede mit '''maximal 15000''' Epochen.
* Ein '''Snapshot‑Guard''' überwacht kontinuierlich die Modellverbesserung und speichert bessere Modelle als Best Snapshot.
* Ein integrierter '''Early‑Stopping‑Mechanismus''' beendet Trainingsläufe, die sich nicht weiter verbessern.
* Ein interner '''Retrain‑Indikator''' bewertet den besten Snapshot. Ein '''Quality Gate''' entscheidet, ob ein weiterer Retrain durchgeführt wird.
* Die Anzahl der Retrains wird '''adaptiv''' anhand interner Kriterien bestimmt.
* Mit aktiviertem Debug‑Modus werden alle Entscheidungen im Log dokumentiert.

Der gesamte Prozess läuft in einem '''Nebenprozess''', um FHEM nicht zu blockieren.
Je nach Hardware, Datenmenge und Parametern kann das Training sehr lange dauern – im Extremfall mehrere Stunden. Ein CPU‑Kern kann dabei dauerhaft zu 100 % ausgelastet sein.

4️⃣ '''Ergebnis bewerten'''

Nach Abschluss des Trainings sollte das Ergebnis '''[[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Auswertung_der_Trainingskennwerte|manuell bewertet]]''' werden.

'''Wichtige Hinweise:''' <br>
* Auch bei '''nicht perfekten Kennzahlen''' lohnt sich eine visuelle Prüfung.
* Auch bei '''zu perfekten Kennzahlen''' ist Vorsicht geboten – dies kann auf Overfitting hindeuten.

5️⃣ '''Modell produktiv setzen'''

Zur visuellen Begutachtung und für den Produktivbetrieb wird das trainierte Modell aktiviert:

attr <Name> aiControl aiConActivate=1

Im nächsten Zyklus des Moduls (siehe 'attr ... plantControl cycleInterval') erscheinen die KI‑Prognosen in der Balkengrafik, sofern diese Ansicht aktiviert ist. Wenn die Prognose zufriedenstellend ist, bleibt das Modell aktiv. Falls nicht, kann jederzeit wieder in den ''Training‑Only''‑Modus gewechselt werden, um Parameter anzupassen und erneut zu trainieren.

6️⃣ '''Automatisches (Re)Training'''

Bei aktivem FANN‑Modus (aiConActivate=1 oder 2) wird automatisch alle '''7 Tage um 03:00 Uhr''' ein Retraining durchgeführt.
Der Zeitpunkt kann angepasst werden:

attr <Name> aiControl aiConTrainStart ...

7️⃣ '''Hybrid‑Modus'''

Das Modul unterstützt einen '''Hybrid‑Modus''', bei dem KI‑Prognosen mit den klassischen (Legacy‑)Prognosen gewichtet kombiniert werden.
Gesteuert wird dieser Modus über:

attr <Name> aiControl aiConAlpha <Wert>

Ein höherer Wert von [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Einstellbare_Parameter_über_'attr_<Name>_aiControl'|'''aiConAlpha''']] bedeutet stärkere Gewichtung der KI‑Prognose.

8️⃣ '''Debug‑Log'''

Für eine detaillierte Nachvollziehbarkeit des Trainingsprozesses kann der Debug‑Modus aktiviert werden.
Im Debug‑Log protokolliert das Modul sämtliche Schritte der Trainingslogik, darunter:

* Start und Ende einzelner Trainingsläufe
* Verbesserungen der Modellgüte
* Snapshot‑Updates
* Early‑Stopping‑Ereignisse
* Entscheidungen des Quality Gates
* Auslösung von Retrains
* Abschlussbewertung des besten Modells

Dies erleichtert sowohl die Diagnose ungewöhnlicher Trainingsverläufe als auch die Bewertung, ob Parameteranpassungen sinnvoll sind.

<div class="mw-collapsible mw-collapsed">
Ein '''auszugsweises Beispiel''' eines Trainingslogs -> <div class="mw-collapsible-content">
<pre>
2026.01.01 15:40:06.690 1: SolCast DEBUG> First attempt 0 with Seed=407496
2026.01.01 15:40:06.696 1: SolCast DEBUG> AI FANN Training started with Params:
num input datasets=7931,
training algo=FANN_TRAIN_INCREMENTAL,
output AF=LINEAR,
hidden AF=SIGMOID,
hidden Neurons=80,40,20,
hidden steepness=0.9,
Epoches=15000,
mse_error=0.001,
learning rate=0.00500,
learning momentum=0.5,
Data sharing=split after shuffle of training data and use AI internal shuffle (Train=6344, Test=1586),
Data shuffle=2 (period=10)
2026.01.01 15:40:06.818 1: SolCast DEBUG> Epoche 1: Train MSE=0.001532, Val MSE=0.002521, Val MAE=0.028206, Val MedAE=0.020769, Bit_Fail=5 -> Snap saved (bit improved)
2026.01.01 15:40:07.534 1: SolCast DEBUG> Epoche 8: Train MSE=0.001472, Val MSE=0.002520, Val MAE=0.028199, Val MedAE=0.020764, Bit_Fail=5 -> Snap saved (metric improved)
2026.01.01 15:40:13.541 1: SolCast DEBUG> Epoche 67: Train MSE=0.001477, Val MSE=0.002518, Val MAE=0.026941, Val MedAE=0.018749, Bit_Fail=5 -> Snap saved (metric improved)
2026.01.01 15:40:13.748 1: SolCast DEBUG> Epoche 69: Train MSE=0.001476, Val MSE=0.002517, Val MAE=0.026928, Val MedAE=0.018728, Bit_Fail=5 -> Snap saved (metric improved)
...
2026.01.01 15:40:21.048 1: SolCast DEBUG> Epoche 140: Train MSE=0.001181, Val MSE=0.002253, Val MAE=0.023585, Val MedAE=0.012176, Bit_Fail=5 -> Snap saved (metric improved)
2026.01.01 15:40:27.191 1: SolCast DEBUG> Epoche 200: Train MSE=0.001181, Val MSE=0.001860, Val MAE=0.022984, Val MedAE=0.012926, Bit_Fail=4
2026.01.01 15:40:27.704 1: SolCast DEBUG> Epoche 205: Train MSE=0.000982, Val MSE=0.001821, Val MAE=0.022794, Val MedAE=0.012760, Bit_Fail=4 -> Snap saved (bit improved)
2026.01.01 15:40:29.356 1: SolCast DEBUG> Epoche 221: Train MSE=0.000894, Val MSE=0.001654, Val MAE=0.021991, Val MedAE=0.012736, Bit_Fail=4 -> Snap saved (metric improved)
...
2026.01.01 15:40:30.508 1: SolCast DEBUG> Epoche 232: Train MSE=0.000806, Val MSE=0.001516, Val MAE=0.020531, Val MedAE=0.011495, Bit_Fail=4 -> Snap saved (metric improved)
2026.01.01 15:40:30.615 1: SolCast DEBUG> Epoche 233: Train MSE=0.000797, Val MSE=0.001498, Val MAE=0.020435, Val MedAE=0.011480, Bit_Fail=2 -> Snap saved (bit improved)
2026.01.01 15:40:30.722 1: SolCast DEBUG> Epoche 234: Train MSE=0.000787, Val MSE=0.001479, Val MAE=0.020336, Val MedAE=0.011380, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 15:40:30.829 1: SolCast DEBUG> Epoche 235: Train MSE=0.000777, Val MSE=0.001460, Val MAE=0.020232, Val MedAE=0.011321, Bit_Fail=2 -> Snap saved (metric improved)
...
2026.01.01 15:40:34.103 1: SolCast DEBUG> Epoche 266: Train MSE=0.000347, Val MSE=0.000621, Val MAE=0.015564, Val MedAE=0.010886, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 15:40:34.209 1: SolCast DEBUG> Epoche 267: Train MSE=0.000336, Val MSE=0.000598, Val MAE=0.015326, Val MedAE=0.010661, Bit_Fail=0 -> Snap saved (bit improved)
2026.01.01 15:40:34.322 1: SolCast DEBUG> Epoche 268: Train MSE=0.000325, Val MSE=0.000576, Val MAE=0.015095, Val MedAE=0.010564, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 15:40:34.431 1: SolCast DEBUG> Epoche 269: Train MSE=0.000314, Val MSE=0.000555, Val MAE=0.014870, Val MedAE=0.010315, Bit_Fail=0 -> Snap saved (metric improved)
...
2026.01.01 15:45:53.259 1: SolCast DEBUG> Epoche 3300: Train MSE=0.000188, Val MSE=0.000286, Val MAE=0.011095, Val MedAE=0.007725, Bit_Fail=0
2026.01.01 15:46:00.439 1: SolCast DEBUG> Early stopping bei Epoche 3368 (no improvement since 2000 epochs)
2026.01.01 15:46:00.439 1: === Snapshot-Statistik ===
2026.01.01 15:46:00.440 1: Metric-Improvement Snapshots: 67 (letzte Epoche: 1368)
2026.01.01 15:46:00.440 1: Bit-Improvement Snapshots: 5 (letzte Epoche: 267)
2026.01.01 15:46:00.441 1: Bit-Tradeoff Snapshots: 0 (letzte Epoche: 0)
2026.01.01 15:46:00.443 1: SolCast DEBUG> Best Snapshot reloaded from Epoche 1368: Train MSE=0.000188, Val MSE=0.000286, Val MAE=0.010789, Val MedAE=0.006938, Bit_Fail=0,
2026.01.01 15:46:00.444 1: SolCast DEBUG> Run Validation Test with 20% of Input data ...
2026.01.01 15:46:00.475 1: SolCast DEBUG> Validation finished - Best Training MSE=0.000188, Validation MSE=0.000286, Validation Bit_Fail=0
2026.01.01 15:46:00.476 1: SolCast DEBUG> Retrain check ->
-- In Normalization Space: --
Train MSE=0.000188
Val MSE=0.000286
Val Mean=0.0002908456
VAL/TRAIN MSE Ratio=1.525656 (limit=2.5)
Diff=0.000099 (limit=0.005)
ValStd=0.0000052738 (limit=7.27113936211133e-05)
-- At Original Scale: --
MAE=96.4264081498789
RMSE/MAE=1.5680 (limit=1.5)
Slope=0.846171 (limit=0.7 .. 1.3)
Bias=104.79 (limit=+-48.2132040749395)
R2=0.886437100872621
P95=283.1830 (limit=385.705632599516)
P99=538.2559 (limit=771.411265199031)
-- Robustness Indicators: --
RMSE relative=24 (limit=20)
BitFail=0 (limit=5)
BitFailRate=0.0000 (limit=0.1)
-> Retrain
</pre>
</div>
</div>

<div class="mw-collapsible mw-collapsed">
Ein '''komplettes Beispiel mit 3 Wiederholungen''' eines Trainingslogs -> <div class="mw-collapsible-content">
<pre>
2026.01.01 18:03:45.037 1: SolCast DEBUG> AI FANN Training for Consumption Forecast BlockingCall PID "813631" with Timeout 86400 s started
2026.01.01 18:03:46.046 1: SolCast DEBUG> AI FANN - There are 503 Records skipped due to incomplete or invalid data. Index:
2025013115, 2025020401, 2025020414, 2025020415, 2025020416, 2025021813, 2025021816, 2025021913, 2025021914, 2025021915, 2025022013, 2025022316, 2025030216, 2025030310, 2025030315, 2025030316, 2025030416, 2025030511, 2025030512, 2025030516, 2025030517, 2025030610, 2025030611, 2025030612, 2025030616, 2025030710, 2025030711, 2025030712, 2025030713, 2025030716, 2025030810, 2025030910, 2025030916, 2025030917, 2025031010, 2025031114, 2025031519, 2025031609, 2025031709, 2025031710, 2025031716, 2025031717, 2025031810, 2025031811, 2025031814, 2025031815, 2025031816, 2025031817, 2025031909, 2025031910, 2025031911, 2025031915, 2025031916, 2025031917, 2025032010, 2025032011, 2025032014, 2025032015, 2025032016, 2025032017, 2025032110, 2025032114, 2025032115, 2025032116, 2025032117, 2025032209, 2025032210, 2025032211, 2025032214, 2025032215, 2025032814, 2025032815, 2025032817, 2025033003, 2025040211, 2025040212, 2025040215, 2025040216, 2025040217, 2025040314, 2025040315, 2025040316, 2025040317, 2025040318, 2025040410, 2025040411, 2025040413, 2025040414, 2025040418, 2025040510, 2025040517, 2025040518, 2025040612, 2025040617, 2025040618, 2025040711, 2025040811, 2025040812, 2025040813, 2025041017, 2025041018, 2025041110, 2025041111, 2025041216, 2025041217, 2025041218, 2025041312, 2025041316, 2025041317, 2025041417, 2025041418, 2025041611, 2025041617, 2025041618, 2025042017, 2025042018, 2025042115, 2025042117, 2025042118, 2025042218, 2025042609, 2025042610, 2025042611, 2025042612, 2025042617, 2025042618, 2025042710, 2025042711, 2025042712, 2025042714, 2025042715, 2025042717, 2025042718, 2025042810, 2025042811, 2025042813, 2025042814, 2025042817, 2025042818, 2025042911, 2025042913, 2025042914, 2025042917, 2025042918, 2025050110, 2025050111, 2025050114, 2025050117, 2025050118, 2025050210, 2025050211, 2025050213, 2025050518, 2025050610, 2025050611, 2025050614, 2025050617, 2025050618, 2025050706, 2025050707, 2025050708, 2025050810, 2025050812, 2025050816, 2025050817, 2025050910, 2025050911, 2025050912, 2025050917, 2025050918, 2025051009, 2025051010, 2025051011, 2025051012, 2025051017, 2025051018, 2025051109, 2025051210, 2025051211, 2025051212, 2025051213, 2025051214, 2025051218, 2025051310, 2025051313, 2025051314, 2025051317, 2025051318, 2025051411, 2025051413, 2025051414, 2025051418, 2025051510, 2025051610, 2025051611, 2025051710, 2025051713, 2025051916, 2025052010, 2025052011, 2025052017, 2025052018, 2025052111, 2025052113, 2025052114, 2025052115, 2025052118, 2025052211, 2025052409, 2025052410, 2025052416, 2025052417, 2025052609, 2025052616, 2025052617, 2025052618, 2025052817, 2025052910, 2025052911, 2025052917, 2025053010, 2025053013, 2025053017, 2025053018, 2025053109, 2025053110, 2025053111, 2025053112, 2025053113, 2025053115, 2025053117, 2025060210, 2025060215, 2025060217, 2025060310, 2025060312, 2025060317, 2025060318, 2025060513, 2025060517, 2025060609, 2025060610, 2025060618, 2025060710, 2025060711, 2025060712, 2025060713, 2025060811, 2025060812, 2025060816, 2025060817, 2025060818, 2025060909, 2025060910, 2025060911, 2025060912, 2025060913, 2025060917, 2025060918, 2025061015, 2025061016, 2025061109, 2025061114, 2025061117, 2025061118, 2025061119, 2025061209, 2025061210, 2025061211, 2025061212, 2025061213, 2025061214, 2025061215, 2025061217, 2025061218, 2025061309, 2025061310, 2025061311, 2025061312, 2025061313, 2025061314, 2025061315, 2025061317, 2025061318, 2025061319, 2025061410, 2025061411, 2025061413, 2025061414, 2025061417, 2025061418, 2025061710, 2025061713, 2025061714, 2025061717, 2025061718, 2025061724, 2025062010, 2025062011, 2025062013, 2025062014, 2025062017, 2025062018, 2025062109, 2025062110, 2025062111, 2025062112, 2025062114, 2025062117, 2025062118, 2025062209, 2025062210, 2025062211, 2025062212, 2025062213, 2025062214, 2025062217, 2025062218, 2025062309, 2025062310, 2025062311, 2025062317, 2025062318, 2025062409, 2025062410, 2025062411, 2025062818, 2025062911, 2025062913, 2025062918, 2025063009, 2025063011, 2025063013, 2025063014, 2025063017, 2025063018, 2025070110, 2025070111, 2025070112, 2025070113, 2025070117, 2025070118, 2025070210, 2025070211, 2025070212, 2025070213, 2025070217, 2025070218, 2025070318, 2025070410, 2025070411, 2025070412, 2025070417, 2025070418, 2025070510, 2025070511, 2025070512, 2025070610, 2025070611, 2025070615, 2025070717, 2025070810, 2025071013, 2025071017, 2025071112, 2025071113, 2025071117, 2025071311, 2025071318, 2025071410, 2025071411, 2025071812, 2025071818, 2025071910, 2025071911, 2025071912, 2025071913, 2025071918, 2025072009, 2025072510, 2025072514, 2025073110, 2025073118, 2025080118, 2025080210, 2025080310, 2025080410, 2025080417, 2025080418, 2025080616, 2025080617, 2025080715, 2025080716, 2025080717, 2025080718, 2025080917, 2025080918, 2025081015, 2025081016, 2025081017, 2025081018, 2025081115, 2025081116, 2025081117, 2025081118, 2025081120, 2025081121, 2025081122, 2025081123, 2025081124, 2025081215, 2025081216, 2025081217, 2025081315, 2025081316, 2025081317, 2025081318, 2025081415, 2025081416, 2025081417, 2025081418, 2025081516, 2025081517, 2025081617, 2025081816, 2025081817, 2025081818, 2025081915, 2025081916, 2025081917, 2025082015, 2025082016, 2025082017, 2025082018, 2025082115, 2025082116, 2025082117, 2025082416, 2025082516, 2025082517, 2025082518, 2025082519, 2025082612, 2025082613, 2025082614, 2025082618, 2025082716, 2025082717, 2025083110, 2025083111, 2025083113, 2025083118, 2025090110, 2025090215, 2025090311, 2025090317, 2025090411, 2025090414, 2025090417, 2025090517, 2025090610, 2025090611, 2025090612, 2025090618, 2025090710, 2025090711, 2025090713, 2025090714, 2025090718, 2025090810, 2025090813, 2025090910, 2025090911, 2025091217, 2025091816, 2025091817, 2025091915, 2025091916, 2025091917, 2025092014, 2025092015, 2025092016, 2025092017, 2025092113, 2025092115, 2025092315, 2025092316, 2025092417, 2025092910, 2025092911, 2025092912, 2025092917, 2025093011, 2025093012, 2025093013, 2025093017, 2025100316, 2025100317, 2025110320, 2025122222, 2025122223, 2025122224, 2025122510
2026.01.01 18:03:46.940 1: SolCast - DBG F[7300]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.942 1: SolCast - DBG F[7301]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.944 1: SolCast - DBG F[7302]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.945 1: SolCast - DBG F[7303]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.947 1: SolCast - DBG F[7304]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.949 1: SolCast - DBG F[7305]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.951 1: SolCast - DBG F[7306]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.953 1: SolCast - DBG F[7307]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.954 1: SolCast - DBG F[7308]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.956 1: SolCast - DBG F[7309]: lag1=0.001 lag2=0.001 lag24=0.001 d1p=0.000 d1n=0.000 rollstd=0.000 up=0 down=0 upS=0.000 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.958 1: SolCast - DBG F[7310]: lag1=0.002 lag2=0.001 lag24=0.002 d1p=0.036 d1n=0.000 rollstd=0.000 up=1 down=0 upS=0.036 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.960 1: SolCast - DBG F[7311]: lag1=0.026 lag2=0.002 lag24=0.008 d1p=0.004 d1n=0.000 rollstd=0.033 up=0 down=0 upS=0.004 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.962 1: SolCast - DBG F[7312]: lag1=0.029 lag2=0.026 lag24=0.012 d1p=0.000 d1n=0.008 rollstd=0.044 up=0 down=1 upS=0.000 downS=0.008 vol=0 pvX=0 break=0
2026.01.01 18:03:46.963 1: SolCast - DBG F[7313]: lag1=0.023 lag2=0.029 lag24=0.016 d1p=0.011 d1n=0.000 rollstd=0.045 up=1 down=0 upS=0.011 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.965 1: SolCast - DBG F[7314]: lag1=0.031 lag2=0.023 lag24=0.018 d1p=0.000 d1n=0.003 rollstd=0.044 up=0 down=0 upS=0.000 downS=0.003 vol=0 pvX=0 break=0
2026.01.01 18:03:46.967 1: SolCast - DBG F[7315]: lag1=0.028 lag2=0.031 lag24=0.017 d1p=0.002 d1n=0.000 rollstd=0.036 up=0 down=0 upS=0.002 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.968 1: SolCast - DBG F[7316]: lag1=0.030 lag2=0.028 lag24=0.008 d1p=0.000 d1n=0.002 rollstd=0.009 up=0 down=0 upS=0.000 downS=0.002 vol=0 pvX=0 break=0
2026.01.01 18:03:46.970 1: SolCast - DBG F[7317]: lag1=0.028 lag2=0.030 lag24=0.002 d1p=0.000 d1n=0.005 rollstd=0.009 up=0 down=1 upS=0.000 downS=0.005 vol=0 pvX=0 break=0
2026.01.01 18:03:46.974 1: SolCast - DBG F[7318]: lag1=0.025 lag2=0.028 lag24=0.002 d1p=0.005 d1n=0.000 rollstd=0.010 up=1 down=0 upS=0.005 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:46.976 1: SolCast - DBG F[7319]: lag1=0.028 lag2=0.025 lag24=0.001 d1p=0.008 d1n=0.000 rollstd=0.007 up=1 down=0 upS=0.008 downS=0.000 vol=0 pvX=0 break=0
2026.01.01 18:03:47.013 1: SolCast DEBUG> First attempt 0 with Seed=439288
2026.01.01 18:03:47.024 1: SolCast DEBUG> AI FANN Training started with Params:
num input datasets=7314,
training algo=FANN_TRAIN_INCREMENTAL,
output AF=LINEAR,
hidden AF=SIGMOID,
hidden Neurons=80,40,20,
hidden steepness=0.9,
Epoches=15000,
mse_error=0.001,
learning rate=0.00500,
learning momentum=0.7,
Data sharing=split after shuffle of training data and use AI internal shuffle (Train=5851, Test=1462),
Data shuffle=2 (period=10)
2026.01.01 18:03:47.208 1: SolCast DEBUG> Epoche 1: Train MSE=0.002194, Val MSE=0.002834, Val MAE=0.031901, Val MedAE=0.027985, Bit_Fail=2 -> Snap saved (bit improved)
2026.01.01 18:03:47.528 1: SolCast DEBUG> Epoche 3: Train MSE=0.002192, Val MSE=0.002833, Val MAE=0.031892, Val MedAE=0.027975, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:03:54.175 1: SolCast DEBUG> Epoche 48: Train MSE=0.001736, Val MSE=0.002765, Val MAE=0.029706, Val MedAE=0.016374, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:04:02.843 1: SolCast DEBUG> Epoche 100: Train MSE=0.001736, Val MSE=0.001509, Val MAE=0.026824, Val MedAE=0.022443, Bit_Fail=1
2026.01.01 18:04:07.181 1: SolCast DEBUG> Epoche 127: Train MSE=0.000623, Val MSE=0.001033, Val MAE=0.022203, Val MedAE=0.017074, Bit_Fail=1 -> Snap saved (bit improved)
2026.01.01 18:04:07.341 1: SolCast DEBUG> Epoche 128: Train MSE=0.000611, Val MSE=0.001012, Val MAE=0.021994, Val MedAE=0.017013, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:07.519 1: SolCast DEBUG> Epoche 129: Train MSE=0.000599, Val MSE=0.000990, Val MAE=0.021783, Val MedAE=0.016793, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:07.994 1: SolCast DEBUG> Epoche 131: Train MSE=0.000577, Val MSE=0.000943, Val MAE=0.021456, Val MedAE=0.016655, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:08.185 1: SolCast DEBUG> Epoche 132: Train MSE=0.000566, Val MSE=0.000922, Val MAE=0.021240, Val MedAE=0.016463, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:08.344 1: SolCast DEBUG> Epoche 133: Train MSE=0.000554, Val MSE=0.000901, Val MAE=0.021025, Val MedAE=0.016355, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:08.508 1: SolCast DEBUG> Epoche 134: Train MSE=0.000543, Val MSE=0.000881, Val MAE=0.020809, Val MedAE=0.016328, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:08.684 1: SolCast DEBUG> Epoche 135: Train MSE=0.000532, Val MSE=0.000860, Val MAE=0.020593, Val MedAE=0.016227, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:08.840 1: SolCast DEBUG> Epoche 136: Train MSE=0.000521, Val MSE=0.000841, Val MAE=0.020381, Val MedAE=0.016031, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:08.989 1: SolCast DEBUG> Epoche 137: Train MSE=0.000511, Val MSE=0.000822, Val MAE=0.020175, Val MedAE=0.015652, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:09.144 1: SolCast DEBUG> Epoche 138: Train MSE=0.000501, Val MSE=0.000803, Val MAE=0.019972, Val MedAE=0.015495, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:09.297 1: SolCast DEBUG> Epoche 139: Train MSE=0.000492, Val MSE=0.000786, Val MAE=0.019773, Val MedAE=0.015409, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:09.458 1: SolCast DEBUG> Epoche 140: Train MSE=0.000481, Val MSE=0.000777, Val MAE=0.019495, Val MedAE=0.015158, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:09.615 1: SolCast DEBUG> Epoche 141: Train MSE=0.000473, Val MSE=0.000760, Val MAE=0.019325, Val MedAE=0.015145, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:09.767 1: SolCast DEBUG> Epoche 142: Train MSE=0.000465, Val MSE=0.000745, Val MAE=0.019163, Val MedAE=0.015044, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:09.919 1: SolCast DEBUG> Epoche 143: Train MSE=0.000457, Val MSE=0.000730, Val MAE=0.019008, Val MedAE=0.015017, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:10.080 1: SolCast DEBUG> Epoche 144: Train MSE=0.000449, Val MSE=0.000716, Val MAE=0.018857, Val MedAE=0.014983, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:10.245 1: SolCast DEBUG> Epoche 145: Train MSE=0.000442, Val MSE=0.000702, Val MAE=0.018714, Val MedAE=0.014883, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:10.400 1: SolCast DEBUG> Epoche 146: Train MSE=0.000436, Val MSE=0.000690, Val MAE=0.018579, Val MedAE=0.014777, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:10.705 1: SolCast DEBUG> Epoche 148: Train MSE=0.000424, Val MSE=0.000667, Val MAE=0.018328, Val MedAE=0.014732, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:10.858 1: SolCast DEBUG> Epoche 149: Train MSE=0.000418, Val MSE=0.000656, Val MAE=0.018213, Val MedAE=0.014659, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:04:11.447 1: SolCast DEBUG> Epoche 153: Train MSE=0.000398, Val MSE=0.000655, Val MAE=0.017918, Val MedAE=0.014430, Bit_Fail=0 -> Snap saved (bit improved)
2026.01.01 18:04:11.597 1: SolCast DEBUG> Epoche 154: Train MSE=0.000394, Val MSE=0.000648, Val MAE=0.017836, Val MedAE=0.014356, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:11.780 1: SolCast DEBUG> Epoche 155: Train MSE=0.000390, Val MSE=0.000641, Val MAE=0.017757, Val MedAE=0.014209, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:11.968 1: SolCast DEBUG> Epoche 156: Train MSE=0.000386, Val MSE=0.000635, Val MAE=0.017685, Val MedAE=0.014026, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:12.119 1: SolCast DEBUG> Epoche 157: Train MSE=0.000383, Val MSE=0.000629, Val MAE=0.017617, Val MedAE=0.013986, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:15.889 1: SolCast DEBUG> Epoche 180: Train MSE=0.000338, Val MSE=0.000530, Val MAE=0.017079, Val MedAE=0.013927, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:19.269 1: SolCast DEBUG> Epoche 200: Train MSE=0.000338, Val MSE=0.000535, Val MAE=0.016673, Val MedAE=0.013893, Bit_Fail=0
2026.01.01 18:04:35.878 1: SolCast DEBUG> Epoche 290: Train MSE=0.000288, Val MSE=0.000524, Val MAE=0.016388, Val MedAE=0.013535, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:36.582 1: SolCast DEBUG> Epoche 293: Train MSE=0.000287, Val MSE=0.000523, Val MAE=0.016367, Val MedAE=0.013507, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:37.370 1: SolCast DEBUG> Epoche 296: Train MSE=0.000287, Val MSE=0.000522, Val MAE=0.016353, Val MedAE=0.013413, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:04:38.343 1: SolCast DEBUG> Epoche 300: Train MSE=0.000287, Val MSE=0.000500, Val MAE=0.016520, Val MedAE=0.014059, Bit_Fail=0
2026.01.01 18:04:53.153 1: SolCast DEBUG> Epoche 360: Train MSE=0.000276, Val MSE=0.000498, Val MAE=0.016213, Val MedAE=0.013363, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:05:03.452 1: SolCast DEBUG> Epoche 400: Train MSE=0.000276, Val MSE=0.000492, Val MAE=0.016416, Val MedAE=0.013627, Bit_Fail=0
2026.01.01 18:05:29.137 1: SolCast DEBUG> Epoche 500: Train MSE=0.000276, Val MSE=0.000500, Val MAE=0.016208, Val MedAE=0.013216, Bit_Fail=0
2026.01.01 18:05:51.013 1: SolCast DEBUG> Epoche 600: Train MSE=0.000276, Val MSE=0.000500, Val MAE=0.016319, Val MedAE=0.012971, Bit_Fail=0
2026.01.01 18:06:14.772 1: SolCast DEBUG> Epoche 700: Train MSE=0.000276, Val MSE=0.000511, Val MAE=0.016383, Val MedAE=0.013241, Bit_Fail=0
2026.01.01 18:06:36.483 1: SolCast DEBUG> Epoche 800: Train MSE=0.000276, Val MSE=0.000509, Val MAE=0.016792, Val MedAE=0.013049, Bit_Fail=0
2026.01.01 18:06:52.867 1: SolCast DEBUG> Epoche 900: Train MSE=0.000276, Val MSE=0.000495, Val MAE=0.015972, Val MedAE=0.012938, Bit_Fail=0
2026.01.01 18:06:52.877 1: SolCast DEBUG> Epoche 900: Train MSE=0.000242, Val MSE=0.000495, Val MAE=0.015972, Val MedAE=0.012938, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:07:09.391 1: SolCast DEBUG> Epoche 1000: Train MSE=0.000242, Val MSE=0.000493, Val MAE=0.016187, Val MedAE=0.013015, Bit_Fail=0
2026.01.01 18:07:14.202 1: SolCast DEBUG> Epoche 1027: Train MSE=0.000237, Val MSE=0.000491, Val MAE=0.015971, Val MedAE=0.012928, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:07:18.001 1: SolCast DEBUG> Epoche 1050: Train MSE=0.000234, Val MSE=0.000486, Val MAE=0.015890, Val MedAE=0.012757, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:07:18.455 1: SolCast DEBUG> Epoche 1053: Train MSE=0.000234, Val MSE=0.000485, Val MAE=0.015881, Val MedAE=0.012678, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:07:25.760 1: SolCast DEBUG> Epoche 1100: Train MSE=0.000234, Val MSE=0.000480, Val MAE=0.015846, Val MedAE=0.012669, Bit_Fail=0
2026.01.01 18:07:25.766 1: SolCast DEBUG> Epoche 1100: Train MSE=0.000233, Val MSE=0.000480, Val MAE=0.015846, Val MedAE=0.012669, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:07:42.102 1: SolCast DEBUG> Epoche 1200: Train MSE=0.000233, Val MSE=0.000484, Val MAE=0.016233, Val MedAE=0.012505, Bit_Fail=0
2026.01.01 18:07:43.824 1: SolCast DEBUG> Epoche 1210: Train MSE=0.000227, Val MSE=0.000470, Val MAE=0.015552, Val MedAE=0.012390, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:07:57.828 1: SolCast DEBUG> Epoche 1300: Train MSE=0.000227, Val MSE=0.000520, Val MAE=0.017539, Val MedAE=0.013492, Bit_Fail=0
2026.01.01 18:08:14.430 1: SolCast DEBUG> Epoche 1400: Train MSE=0.000227, Val MSE=0.000460, Val MAE=0.016046, Val MedAE=0.012304, Bit_Fail=0
2026.01.01 18:08:16.132 1: SolCast DEBUG> Epoche 1410: Train MSE=0.000222, Val MSE=0.000452, Val MAE=0.015408, Val MedAE=0.011884, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:08:17.883 1: SolCast DEBUG> Epoche 1420: Train MSE=0.000220, Val MSE=0.000443, Val MAE=0.015258, Val MedAE=0.011811, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:08:29.901 1: SolCast DEBUG> Epoche 1490: Train MSE=0.000218, Val MSE=0.000439, Val MAE=0.014983, Val MedAE=0.011569, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:08:30.803 1: SolCast DEBUG> Epoche 1496: Train MSE=0.000218, Val MSE=0.000438, Val MAE=0.014960, Val MedAE=0.011509, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:08:31.440 1: SolCast DEBUG> Epoche 1500: Train MSE=0.000218, Val MSE=0.000439, Val MAE=0.015419, Val MedAE=0.011971, Bit_Fail=0
2026.01.01 18:08:47.448 1: SolCast DEBUG> Epoche 1600: Train MSE=0.000218, Val MSE=0.000454, Val MAE=0.016309, Val MedAE=0.012168, Bit_Fail=0
2026.01.01 18:08:50.500 1: SolCast DEBUG> Epoche 1620: Train MSE=0.000214, Val MSE=0.000431, Val MAE=0.014770, Val MedAE=0.011218, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:09:03.800 1: SolCast DEBUG> Epoche 1700: Train MSE=0.000214, Val MSE=0.000439, Val MAE=0.015947, Val MedAE=0.012095, Bit_Fail=0
2026.01.01 18:09:12.275 1: SolCast DEBUG> Epoche 1755: Train MSE=0.000210, Val MSE=0.000414, Val MAE=0.014646, Val MedAE=0.011210, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:09:19.335 1: SolCast DEBUG> Epoche 1800: Train MSE=0.000210, Val MSE=0.000427, Val MAE=0.015787, Val MedAE=0.011912, Bit_Fail=0
2026.01.01 18:09:36.229 1: SolCast DEBUG> Epoche 1900: Train MSE=0.000210, Val MSE=0.000417, Val MAE=0.015680, Val MedAE=0.011996, Bit_Fail=0
2026.01.01 18:09:45.972 1: SolCast DEBUG> Epoche 1960: Train MSE=0.000204, Val MSE=0.000388, Val MAE=0.014589, Val MedAE=0.011116, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:09:51.969 1: SolCast DEBUG> Epoche 2000: Train MSE=0.000204, Val MSE=0.000404, Val MAE=0.015606, Val MedAE=0.012356, Bit_Fail=0
2026.01.01 18:09:53.511 1: SolCast DEBUG> Epoche 2010: Train MSE=0.000202, Val MSE=0.000386, Val MAE=0.014313, Val MedAE=0.011006, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:09:55.063 1: SolCast DEBUG> Epoche 2020: Train MSE=0.000201, Val MSE=0.000383, Val MAE=0.014131, Val MedAE=0.010774, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:10:08.287 1: SolCast DEBUG> Epoche 2100: Train MSE=0.000201, Val MSE=0.000380, Val MAE=0.014528, Val MedAE=0.011353, Bit_Fail=0
2026.01.01 18:10:24.098 1: SolCast DEBUG> Epoche 2200: Train MSE=0.000201, Val MSE=0.000370, Val MAE=0.013946, Val MedAE=0.010416, Bit_Fail=0
2026.01.01 18:10:24.104 1: SolCast DEBUG> Epoche 2200: Train MSE=0.000197, Val MSE=0.000370, Val MAE=0.013946, Val MedAE=0.010416, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:10:39.646 1: SolCast DEBUG> Epoche 2300: Train MSE=0.000197, Val MSE=0.000374, Val MAE=0.014907, Val MedAE=0.011753, Bit_Fail=0
2026.01.01 18:10:56.682 1: SolCast DEBUG> Epoche 2400: Train MSE=0.000197, Val MSE=0.000356, Val MAE=0.013705, Val MedAE=0.010006, Bit_Fail=0
2026.01.01 18:10:56.693 1: SolCast DEBUG> Epoche 2400: Train MSE=0.000192, Val MSE=0.000356, Val MAE=0.013705, Val MedAE=0.010006, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:11:12.550 1: SolCast DEBUG> Epoche 2500: Train MSE=0.000192, Val MSE=0.000375, Val MAE=0.015257, Val MedAE=0.012743, Bit_Fail=0
2026.01.01 18:11:15.676 1: SolCast DEBUG> Epoche 2520: Train MSE=0.000191, Val MSE=0.000355, Val MAE=0.013591, Val MedAE=0.009674, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:11:17.824 1: SolCast DEBUG> Epoche 2531: Train MSE=0.000190, Val MSE=0.000346, Val MAE=0.013480, Val MedAE=0.009639, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:11:28.987 1: SolCast DEBUG> Epoche 2600: Train MSE=0.000190, Val MSE=0.000339, Val MAE=0.013649, Val MedAE=0.010530, Bit_Fail=0
2026.01.01 18:11:45.115 1: SolCast DEBUG> Epoche 2700: Train MSE=0.000190, Val MSE=0.000354, Val MAE=0.014651, Val MedAE=0.011877, Bit_Fail=0
2026.01.01 18:12:01.075 1: SolCast DEBUG> Epoche 2790: Train MSE=0.000186, Val MSE=0.000341, Val MAE=0.013362, Val MedAE=0.009487, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:12:02.671 1: SolCast DEBUG> Epoche 2800: Train MSE=0.000186, Val MSE=0.000333, Val MAE=0.013606, Val MedAE=0.010687, Bit_Fail=0
2026.01.01 18:12:18.422 1: SolCast DEBUG> Epoche 2900: Train MSE=0.000186, Val MSE=0.000335, Val MAE=0.013448, Val MedAE=0.010124, Bit_Fail=0
2026.01.01 18:12:35.464 1: SolCast DEBUG> Epoche 3000: Train MSE=0.000186, Val MSE=0.000327, Val MAE=0.013352, Val MedAE=0.010017, Bit_Fail=0
2026.01.01 18:12:56.411 1: SolCast DEBUG> Epoche 3100: Train MSE=0.000186, Val MSE=0.000333, Val MAE=0.013996, Val MedAE=0.011160, Bit_Fail=0
2026.01.01 18:13:10.994 1: SolCast DEBUG> Epoche 3162: Train MSE=0.000181, Val MSE=0.000328, Val MAE=0.013113, Val MedAE=0.009469, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:13:18.736 1: SolCast DEBUG> Epoche 3200: Train MSE=0.000181, Val MSE=0.000320, Val MAE=0.013393, Val MedAE=0.010591, Bit_Fail=0
2026.01.01 18:13:39.675 1: SolCast DEBUG> Epoche 3300: Train MSE=0.000181, Val MSE=0.000319, Val MAE=0.013325, Val MedAE=0.010389, Bit_Fail=0
2026.01.01 18:14:00.271 1: SolCast DEBUG> Epoche 3400: Train MSE=0.000181, Val MSE=0.000325, Val MAE=0.014006, Val MedAE=0.011521, Bit_Fail=0
2026.01.01 18:14:22.409 1: SolCast DEBUG> Epoche 3500: Train MSE=0.000181, Val MSE=0.000344, Val MAE=0.014666, Val MedAE=0.012138, Bit_Fail=0
2026.01.01 18:14:38.101 1: SolCast DEBUG> Epoche 3580: Train MSE=0.000177, Val MSE=0.000319, Val MAE=0.012991, Val MedAE=0.009430, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:14:42.467 1: SolCast DEBUG> Epoche 3600: Train MSE=0.000177, Val MSE=0.000314, Val MAE=0.013079, Val MedAE=0.010056, Bit_Fail=0
2026.01.01 18:15:03.838 1: SolCast DEBUG> Epoche 3700: Train MSE=0.000177, Val MSE=0.000333, Val MAE=0.014308, Val MedAE=0.011807, Bit_Fail=0
2026.01.01 18:15:16.053 2: HUEBridge: http request failed: read from http://192.168.2.7:80 timed out
2026.01.01 18:15:30.476 1: SolCast DEBUG> Epoche 3800: Train MSE=0.000177, Val MSE=0.000321, Val MAE=0.013020, Val MedAE=0.009413, Bit_Fail=0
2026.01.01 18:15:45.037 1: SolCast DEBUG> Epoche 3870: Train MSE=0.000174, Val MSE=0.000317, Val MAE=0.012911, Val MedAE=0.009292, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:15:52.131 1: SolCast DEBUG> Epoche 3900: Train MSE=0.000174, Val MSE=0.000312, Val MAE=0.013464, Val MedAE=0.010556, Bit_Fail=0
2026.01.01 18:16:12.390 1: SolCast DEBUG> Epoche 4000: Train MSE=0.000174, Val MSE=0.000320, Val MAE=0.013974, Val MedAE=0.011455, Bit_Fail=0
2026.01.01 18:16:29.091 1: SolCast DEBUG> Epoche 4100: Train MSE=0.000174, Val MSE=0.000312, Val MAE=0.013592, Val MedAE=0.010912, Bit_Fail=0
2026.01.01 18:16:52.505 1: SolCast DEBUG> Epoche 4200: Train MSE=0.000174, Val MSE=0.000302, Val MAE=0.012962, Val MedAE=0.010156, Bit_Fail=0
2026.01.01 18:17:16.099 1: SolCast DEBUG> Epoche 4300: Train MSE=0.000174, Val MSE=0.000303, Val MAE=0.013023, Val MedAE=0.010334, Bit_Fail=0
2026.01.01 18:17:31.066 1: openMeteo - Open-Meteo API server response: start_SSL https://api.open-meteo.com:443 timed out
2026.01.01 18:17:38.285 1: SolCast DEBUG> Epoche 4400: Train MSE=0.000174, Val MSE=0.000302, Val MAE=0.013197, Val MedAE=0.010550, Bit_Fail=0
2026.01.01 18:17:52.429 1: SolCast DEBUG> Epoche 4460: Train MSE=0.000170, Val MSE=0.000311, Val MAE=0.012837, Val MedAE=0.009137, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:17:58.628 1: SolCast DEBUG> Epoche 4490: Train MSE=0.000170, Val MSE=0.000305, Val MAE=0.012794, Val MedAE=0.009134, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:18:01.453 1: SolCast DEBUG> Epoche 4500: Train MSE=0.000170, Val MSE=0.000301, Val MAE=0.012898, Val MedAE=0.009802, Bit_Fail=0
2026.01.01 18:18:23.799 1: SolCast DEBUG> Epoche 4600: Train MSE=0.000170, Val MSE=0.000298, Val MAE=0.012957, Val MedAE=0.010201, Bit_Fail=0
2026.01.01 18:18:39.811 1: SolCast DEBUG> Epoche 4700: Train MSE=0.000170, Val MSE=0.000301, Val MAE=0.013527, Val MedAE=0.011413, Bit_Fail=0
2026.01.01 18:18:56.354 1: SolCast DEBUG> Epoche 4800: Train MSE=0.000170, Val MSE=0.000298, Val MAE=0.013255, Val MedAE=0.011018, Bit_Fail=0
2026.01.01 18:19:12.392 1: SolCast DEBUG> Epoche 4900: Train MSE=0.000170, Val MSE=0.000295, Val MAE=0.013216, Val MedAE=0.010940, Bit_Fail=0
2026.01.01 18:19:27.987 1: SolCast DEBUG> Epoche 5000: Train MSE=0.000170, Val MSE=0.000293, Val MAE=0.013073, Val MedAE=0.010728, Bit_Fail=0
2026.01.01 18:19:32.327 1: SolCast DEBUG> Epoche 5030: Train MSE=0.000167, Val MSE=0.000297, Val MAE=0.012698, Val MedAE=0.009102, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:19:43.670 1: SolCast DEBUG> Epoche 5100: Train MSE=0.000167, Val MSE=0.000298, Val MAE=0.013300, Val MedAE=0.010884, Bit_Fail=0
2026.01.01 18:19:59.190 1: SolCast DEBUG> Epoche 5200: Train MSE=0.000167, Val MSE=0.000294, Val MAE=0.013167, Val MedAE=0.010790, Bit_Fail=0
2026.01.01 18:20:10.606 1: SolCast DEBUG> Epoche 5262: Train MSE=0.000166, Val MSE=0.000295, Val MAE=0.012677, Val MedAE=0.009089, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:20:16.409 1: SolCast DEBUG> Epoche 5300: Train MSE=0.000166, Val MSE=0.000292, Val MAE=0.013247, Val MedAE=0.011177, Bit_Fail=0
2026.01.01 18:20:34.708 1: SolCast DEBUG> Epoche 5400: Train MSE=0.000166, Val MSE=0.000291, Val MAE=0.012964, Val MedAE=0.010392, Bit_Fail=0
2026.01.01 18:20:57.206 1: SolCast DEBUG> Epoche 5500: Train MSE=0.000166, Val MSE=0.000288, Val MAE=0.012996, Val MedAE=0.010552, Bit_Fail=0
2026.01.01 18:21:21.536 1: SolCast DEBUG> Epoche 5600: Train MSE=0.000166, Val MSE=0.000286, Val MAE=0.012927, Val MedAE=0.010610, Bit_Fail=0
2026.01.01 18:21:43.826 1: SolCast DEBUG> Epoche 5700: Train MSE=0.000166, Val MSE=0.000284, Val MAE=0.012811, Val MedAE=0.010111, Bit_Fail=0
2026.01.01 18:21:46.073 1: SolCast DEBUG> Epoche 5710: Train MSE=0.000164, Val MSE=0.000292, Val MAE=0.012617, Val MedAE=0.009052, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:22:05.636 1: SolCast DEBUG> Epoche 5800: Train MSE=0.000164, Val MSE=0.000311, Val MAE=0.013979, Val MedAE=0.012142, Bit_Fail=0
2026.01.01 18:22:28.019 1: SolCast DEBUG> Epoche 5900: Train MSE=0.000164, Val MSE=0.000284, Val MAE=0.012679, Val MedAE=0.009654, Bit_Fail=0
2026.01.01 18:22:44.531 1: SolCast DEBUG> Epoche 6000: Train MSE=0.000164, Val MSE=0.000333, Val MAE=0.014735, Val MedAE=0.013016, Bit_Fail=0
2026.01.01 18:23:00.239 1: SolCast DEBUG> Epoche 6100: Train MSE=0.000164, Val MSE=0.000286, Val MAE=0.012652, Val MedAE=0.009522, Bit_Fail=0
2026.01.01 18:23:16.145 1: SolCast DEBUG> Epoche 6200: Train MSE=0.000164, Val MSE=0.000283, Val MAE=0.012623, Val MedAE=0.009526, Bit_Fail=0
2026.01.01 18:23:31.970 1: SolCast DEBUG> Epoche 6300: Train MSE=0.000164, Val MSE=0.000294, Val MAE=0.013520, Val MedAE=0.011589, Bit_Fail=0
2026.01.01 18:23:48.995 1: SolCast DEBUG> Epoche 6400: Train MSE=0.000164, Val MSE=0.000290, Val MAE=0.013238, Val MedAE=0.011187, Bit_Fail=0
2026.01.01 18:24:04.958 1: SolCast DEBUG> Epoche 6500: Train MSE=0.000164, Val MSE=0.000283, Val MAE=0.013087, Val MedAE=0.011112, Bit_Fail=0
2026.01.01 18:24:20.473 1: SolCast DEBUG> Epoche 6600: Train MSE=0.000164, Val MSE=0.000291, Val MAE=0.012657, Val MedAE=0.009198, Bit_Fail=0
2026.01.01 18:24:35.890 1: SolCast DEBUG> Epoche 6700: Train MSE=0.000164, Val MSE=0.000290, Val MAE=0.013459, Val MedAE=0.011749, Bit_Fail=0
2026.01.01 18:24:52.891 1: SolCast DEBUG> Epoche 6800: Train MSE=0.000164, Val MSE=0.000289, Val MAE=0.013364, Val MedAE=0.011509, Bit_Fail=0
2026.01.01 18:25:08.802 1: SolCast DEBUG> Epoche 6900: Train MSE=0.000164, Val MSE=0.000283, Val MAE=0.013144, Val MedAE=0.011185, Bit_Fail=0
2026.01.01 18:25:24.371 1: SolCast DEBUG> Epoche 7000: Train MSE=0.000164, Val MSE=0.000278, Val MAE=0.012650, Val MedAE=0.009934, Bit_Fail=0
2026.01.01 18:25:39.968 1: SolCast DEBUG> Epoche 7100: Train MSE=0.000164, Val MSE=0.000320, Val MAE=0.014405, Val MedAE=0.012857, Bit_Fail=0
2026.01.01 18:25:56.650 1: SolCast DEBUG> Epoche 7200: Train MSE=0.000164, Val MSE=0.000281, Val MAE=0.013030, Val MedAE=0.011100, Bit_Fail=0
2026.01.01 18:26:12.530 1: SolCast DEBUG> Epoche 7300: Train MSE=0.000164, Val MSE=0.000277, Val MAE=0.012556, Val MedAE=0.009580, Bit_Fail=0
2026.01.01 18:26:28.387 1: SolCast DEBUG> Epoche 7400: Train MSE=0.000164, Val MSE=0.000275, Val MAE=0.012574, Val MedAE=0.009786, Bit_Fail=0
2026.01.01 18:26:44.426 1: SolCast DEBUG> Epoche 7500: Train MSE=0.000164, Val MSE=0.000282, Val MAE=0.013197, Val MedAE=0.011348, Bit_Fail=0
2026.01.01 18:27:00.108 1: SolCast DEBUG> Epoche 7600: Train MSE=0.000164, Val MSE=0.000279, Val MAE=0.012521, Val MedAE=0.009349, Bit_Fail=0
2026.01.01 18:27:17.631 1: SolCast DEBUG> Epoche 7700: Train MSE=0.000164, Val MSE=0.000334, Val MAE=0.014836, Val MedAE=0.013130, Bit_Fail=0
2026.01.01 18:27:19.201 1: SolCast DEBUG> Early stopping bei Epoche 7710 (no improvement since 2000 epochs)
2026.01.01 18:27:19.203 1: === Snapshot-Statistik ===
2026.01.01 18:27:19.206 1: Metric-Improvement Snapshots: 59 (letzte Epoche: 5710)
2026.01.01 18:27:19.208 1: Bit-Improvement Snapshots: 3 (letzte Epoche: 153)
2026.01.01 18:27:19.211 1: Bit-Tradeoff Snapshots: 0 (letzte Epoche: 0)
2026.01.01 18:27:19.222 1: SolCast DEBUG> Best Snapshot reloaded from Epoche 5710: Train MSE=0.000164, Val MSE=0.000292, Val MAE=0.012617, Val MedAE=0.009052, Bit_Fail=0,
2026.01.01 18:27:19.225 1: SolCast DEBUG> Run Validation Test with 20% of Input data ...
2026.01.01 18:27:19.269 1: SolCast DEBUG> Validation finished - Best Training MSE=0.000164, Validation MSE=0.000292, Validation Bit_Fail=0
2026.01.01 18:27:19.272 1: SolCast DEBUG> Retrain check ->
-- In Normalization Space: --
Train MSE=0.000164
Val MSE=0.000292
Val Mean=0.0003006352
VAL/TRAIN MSE Ratio=1.778317 (limit=2.5)
Diff=0.000128 (limit=0.005)
ValStd=0.0000223852 (limit=7.51588070934039e-05)
-- At Original Scale: --
MAE=207.818584965433
RMSE/MAE=1.3545 (limit=1.5)
Slope=0.930345 (limit=0.7 .. 1.3)
Bias=-1.81 (limit=+-103.909292482717)
R2=0.896675647742538
P95=565.7317 (limit=831.274339861732)
P99=813.5925 (limit=1662.54867972346)
-- Robustness Indicators: --
RMSE relative=60 (limit=20)
BitFail=0 (limit=5)
BitFailRate=0.0000 (limit=0.1)
-> Retrain
2026.01.01 18:27:19.280 1: SolCast DEBUG> Retry attempt 1 with Seed=16816002
2026.01.01 18:27:19.287 1: SolCast DEBUG> AI FANN Training started with Params:
num input datasets=7314,
training algo=FANN_TRAIN_INCREMENTAL,
output AF=LINEAR,
hidden AF=SIGMOID,
hidden Neurons=80,40,20,
hidden steepness=0.9,
Epoches=15000,
mse_error=0.001,
learning rate=0.00500,
learning momentum=0.7,
Data sharing=split after shuffle of training data and use AI internal shuffle (Train=5851, Test=1462),
Data shuffle=2 (period=10)
2026.01.01 18:27:19.448 1: SolCast DEBUG> Epoche 1: Train MSE=0.002204, Val MSE=0.002840, Val MAE=0.031967, Val MedAE=0.027950, Bit_Fail=2 -> Snap saved (bit improved)
2026.01.01 18:27:27.760 1: SolCast DEBUG> Epoche 55: Train MSE=0.001883, Val MSE=0.002825, Val MAE=0.030076, Val MedAE=0.017712, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:27:27.909 1: SolCast DEBUG> Epoche 56: Train MSE=0.001848, Val MSE=0.002787, Val MAE=0.029877, Val MedAE=0.017254, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:27:28.093 1: SolCast DEBUG> Epoche 57: Train MSE=0.001806, Val MSE=0.002742, Val MAE=0.029648, Val MedAE=0.016877, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:27:28.250 1: SolCast DEBUG> Epoche 58: Train MSE=0.001759, Val MSE=0.002690, Val MAE=0.029392, Val MedAE=0.016720, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:27:28.410 1: SolCast DEBUG> Epoche 59: Train MSE=0.001704, Val MSE=0.002632, Val MAE=0.029109, Val MedAE=0.016686, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:27:34.691 1: SolCast DEBUG> Epoche 100: Train MSE=0.001704, Val MSE=0.001681, Val MAE=0.026853, Val MedAE=0.019229, Bit_Fail=1
2026.01.01 18:27:39.980 1: SolCast DEBUG> Epoche 133: Train MSE=0.000733, Val MSE=0.001267, Val MAE=0.023793, Val MedAE=0.017436, Bit_Fail=1 -> Snap saved (bit improved)
2026.01.01 18:27:40.226 1: SolCast DEBUG> Epoche 134: Train MSE=0.000722, Val MSE=0.001247, Val MAE=0.023624, Val MedAE=0.017294, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:40.470 1: SolCast DEBUG> Epoche 135: Train MSE=0.000710, Val MSE=0.001225, Val MAE=0.023450, Val MedAE=0.017111, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:40.655 1: SolCast DEBUG> Epoche 136: Train MSE=0.000698, Val MSE=0.001204, Val MAE=0.023271, Val MedAE=0.017081, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:40.821 1: SolCast DEBUG> Epoche 137: Train MSE=0.000686, Val MSE=0.001182, Val MAE=0.023085, Val MedAE=0.017060, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:40.979 1: SolCast DEBUG> Epoche 138: Train MSE=0.000674, Val MSE=0.001160, Val MAE=0.022895, Val MedAE=0.016883, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:41.140 1: SolCast DEBUG> Epoche 139: Train MSE=0.000661, Val MSE=0.001138, Val MAE=0.022701, Val MedAE=0.016711, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:41.929 1: SolCast DEBUG> Epoche 144: Train MSE=0.000598, Val MSE=0.000999, Val MAE=0.021734, Val MedAE=0.016540, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:42.090 1: SolCast DEBUG> Epoche 145: Train MSE=0.000586, Val MSE=0.000978, Val MAE=0.021522, Val MedAE=0.016349, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:42.280 1: SolCast DEBUG> Epoche 146: Train MSE=0.000574, Val MSE=0.000958, Val MAE=0.021306, Val MedAE=0.016107, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:42.459 1: SolCast DEBUG> Epoche 147: Train MSE=0.000562, Val MSE=0.000937, Val MAE=0.021088, Val MedAE=0.015901, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:42.613 1: SolCast DEBUG> Epoche 148: Train MSE=0.000550, Val MSE=0.000918, Val MAE=0.020870, Val MedAE=0.015669, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:42.760 1: SolCast DEBUG> Epoche 149: Train MSE=0.000539, Val MSE=0.000898, Val MAE=0.020654, Val MedAE=0.015555, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:43.090 1: SolCast DEBUG> Epoche 151: Train MSE=0.000519, Val MSE=0.000853, Val MAE=0.020213, Val MedAE=0.015324, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:43.274 1: SolCast DEBUG> Epoche 152: Train MSE=0.000508, Val MSE=0.000834, Val MAE=0.019989, Val MedAE=0.015218, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:43.427 1: SolCast DEBUG> Epoche 153: Train MSE=0.000498, Val MSE=0.000815, Val MAE=0.019775, Val MedAE=0.015098, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:43.588 1: SolCast DEBUG> Epoche 154: Train MSE=0.000489, Val MSE=0.000798, Val MAE=0.019572, Val MedAE=0.015089, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:43.765 1: SolCast DEBUG> Epoche 155: Train MSE=0.000480, Val MSE=0.000781, Val MAE=0.019377, Val MedAE=0.014943, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:43.922 1: SolCast DEBUG> Epoche 156: Train MSE=0.000471, Val MSE=0.000765, Val MAE=0.019192, Val MedAE=0.014814, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:44.099 1: SolCast DEBUG> Epoche 157: Train MSE=0.000463, Val MSE=0.000750, Val MAE=0.019017, Val MedAE=0.014635, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:44.451 1: SolCast DEBUG> Epoche 159: Train MSE=0.000448, Val MSE=0.000722, Val MAE=0.018698, Val MedAE=0.014553, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:27:45.216 1: SolCast DEBUG> Epoche 164: Train MSE=0.000417, Val MSE=0.000649, Val MAE=0.018205, Val MedAE=0.014516, Bit_Fail=0 -> Snap saved (bit improved)
2026.01.01 18:27:45.399 1: SolCast DEBUG> Epoche 165: Train MSE=0.000412, Val MSE=0.000640, Val MAE=0.018099, Val MedAE=0.014421, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:45.558 1: SolCast DEBUG> Epoche 166: Train MSE=0.000407, Val MSE=0.000632, Val MAE=0.017999, Val MedAE=0.014286, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:45.726 1: SolCast DEBUG> Epoche 167: Train MSE=0.000402, Val MSE=0.000624, Val MAE=0.017906, Val MedAE=0.014177, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:45.885 1: SolCast DEBUG> Epoche 168: Train MSE=0.000398, Val MSE=0.000617, Val MAE=0.017820, Val MedAE=0.014094, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:46.051 1: SolCast DEBUG> Epoche 169: Train MSE=0.000394, Val MSE=0.000610, Val MAE=0.017740, Val MedAE=0.014051, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:50.636 1: SolCast DEBUG> Epoche 200: Train MSE=0.000394, Val MSE=0.000539, Val MAE=0.016987, Val MedAE=0.013961, Bit_Fail=0
2026.01.01 18:27:50.644 1: SolCast DEBUG> Epoche 200: Train MSE=0.000340, Val MSE=0.000539, Val MAE=0.016987, Val MedAE=0.013961, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:51.095 1: SolCast DEBUG> Epoche 203: Train MSE=0.000338, Val MSE=0.000538, Val MAE=0.016940, Val MedAE=0.013888, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:27:55.790 1: SolCast DEBUG> Epoche 233: Train MSE=0.000321, Val MSE=0.000535, Val MAE=0.016852, Val MedAE=0.013875, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:03.726 1: SolCast DEBUG> Epoche 281: Train MSE=0.000308, Val MSE=0.000524, Val MAE=0.016435, Val MedAE=0.013831, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:04.363 1: SolCast DEBUG> Epoche 285: Train MSE=0.000307, Val MSE=0.000523, Val MAE=0.016426, Val MedAE=0.013765, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:06.794 1: SolCast DEBUG> Epoche 300: Train MSE=0.000307, Val MSE=0.000550, Val MAE=0.017907, Val MedAE=0.015240, Bit_Fail=0
2026.01.01 18:28:08.309 1: SolCast DEBUG> Epoche 310: Train MSE=0.000306, Val MSE=0.000520, Val MAE=0.016274, Val MedAE=0.013632, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:08.614 1: SolCast DEBUG> Epoche 312: Train MSE=0.000305, Val MSE=0.000519, Val MAE=0.016257, Val MedAE=0.013585, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:09.360 1: SolCast DEBUG> Epoche 317: Train MSE=0.000304, Val MSE=0.000518, Val MAE=0.016235, Val MedAE=0.013539, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:18.741 1: SolCast DEBUG> Epoche 370: Train MSE=0.000293, Val MSE=0.000514, Val MAE=0.016166, Val MedAE=0.013205, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:23.398 1: SolCast DEBUG> Epoche 400: Train MSE=0.000293, Val MSE=0.000498, Val MAE=0.016166, Val MedAE=0.013530, Bit_Fail=0
2026.01.01 18:28:27.156 1: SolCast DEBUG> Epoche 420: Train MSE=0.000286, Val MSE=0.000497, Val MAE=0.015836, Val MedAE=0.012658, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:27.956 1: SolCast DEBUG> Epoche 424: Train MSE=0.000286, Val MSE=0.000496, Val MAE=0.015803, Val MedAE=0.012630, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:28.927 1: SolCast DEBUG> Epoche 429: Train MSE=0.000285, Val MSE=0.000495, Val MAE=0.015779, Val MedAE=0.012568, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:37.533 1: SolCast DEBUG> Epoche 470: Train MSE=0.000278, Val MSE=0.000490, Val MAE=0.015754, Val MedAE=0.012467, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:44.668 1: SolCast DEBUG> Epoche 500: Train MSE=0.000278, Val MSE=0.000512, Val MAE=0.015775, Val MedAE=0.011966, Bit_Fail=0
2026.01.01 18:28:49.391 1: SolCast DEBUG> Epoche 520: Train MSE=0.000270, Val MSE=0.000477, Val MAE=0.015651, Val MedAE=0.012339, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:28:53.585 1: SolCast DEBUG> Epoche 539: Train MSE=0.000270, Val MSE=0.000475, Val MAE=0.015648, Val MedAE=0.012191, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:29:05.842 1: SolCast DEBUG> Epoche 590: Train MSE=0.000265, Val MSE=0.000474, Val MAE=0.015526, Val MedAE=0.012056, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:29:08.065 1: SolCast DEBUG> Epoche 600: Train MSE=0.000265, Val MSE=0.000468, Val MAE=0.015894, Val MedAE=0.012751, Bit_Fail=0
2026.01.01 18:29:28.474 1: SolCast DEBUG> Epoche 690: Train MSE=0.000256, Val MSE=0.000470, Val MAE=0.015276, Val MedAE=0.011856, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:29:30.383 1: SolCast DEBUG> Epoche 699: Train MSE=0.000255, Val MSE=0.000467, Val MAE=0.015250, Val MedAE=0.011836, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:29:30.639 1: SolCast DEBUG> Epoche 700: Train MSE=0.000255, Val MSE=0.000478, Val MAE=0.016548, Val MedAE=0.013898, Bit_Fail=0
2026.01.01 18:29:52.830 1: SolCast DEBUG> Epoche 800: Train MSE=0.000255, Val MSE=0.000465, Val MAE=0.016306, Val MedAE=0.013391, Bit_Fail=0
2026.01.01 18:30:04.934 1: SolCast DEBUG> Epoche 850: Train MSE=0.000244, Val MSE=0.000461, Val MAE=0.015129, Val MedAE=0.011815, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:30:17.777 1: SolCast DEBUG> Epoche 900: Train MSE=0.000244, Val MSE=0.000448, Val MAE=0.015585, Val MedAE=0.012575, Bit_Fail=0
2026.01.01 18:30:40.850 1: SolCast DEBUG> Epoche 1000: Train MSE=0.000244, Val MSE=0.000450, Val MAE=0.015295, Val MedAE=0.012324, Bit_Fail=0
2026.01.01 18:30:56.457 1: SolCast DEBUG> Epoche 1100: Train MSE=0.000244, Val MSE=0.000443, Val MAE=0.015695, Val MedAE=0.012932, Bit_Fail=0
2026.01.01 18:31:07.100 1: SolCast DEBUG> Epoche 1160: Train MSE=0.000229, Val MSE=0.000432, Val MAE=0.014957, Val MedAE=0.011802, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:31:13.278 1: SolCast DEBUG> Epoche 1200: Train MSE=0.000229, Val MSE=0.000439, Val MAE=0.015822, Val MedAE=0.012868, Bit_Fail=0
2026.01.01 18:31:29.055 1: SolCast DEBUG> Epoche 1300: Train MSE=0.000229, Val MSE=0.000435, Val MAE=0.015613, Val MedAE=0.012747, Bit_Fail=0
2026.01.01 18:31:43.689 1: SolCast DEBUG> Epoche 1390: Train MSE=0.000219, Val MSE=0.000426, Val MAE=0.014936, Val MedAE=0.011470, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:31:45.625 1: SolCast DEBUG> Epoche 1400: Train MSE=0.000219, Val MSE=0.000414, Val MAE=0.014586, Val MedAE=0.011035, Bit_Fail=0
2026.01.01 18:31:45.635 1: SolCast DEBUG> Epoche 1400: Train MSE=0.000218, Val MSE=0.000414, Val MAE=0.014586, Val MedAE=0.011035, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:32:02.161 1: SolCast DEBUG> Epoche 1500: Train MSE=0.000218, Val MSE=0.000449, Val MAE=0.016432, Val MedAE=0.013464, Bit_Fail=0
2026.01.01 18:32:18.086 1: SolCast DEBUG> Epoche 1600: Train MSE=0.000218, Val MSE=0.000403, Val MAE=0.014934, Val MedAE=0.011695, Bit_Fail=0
2026.01.01 18:32:32.114 1: SolCast DEBUG> Epoche 1690: Train MSE=0.000209, Val MSE=0.000404, Val MAE=0.014320, Val MedAE=0.010320, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:32:33.832 1: SolCast DEBUG> Epoche 1700: Train MSE=0.000209, Val MSE=0.000428, Val MAE=0.016037, Val MedAE=0.012994, Bit_Fail=0
2026.01.01 18:32:49.865 1: SolCast DEBUG> Epoche 1800: Train MSE=0.000209, Val MSE=0.000410, Val MAE=0.015653, Val MedAE=0.012577, Bit_Fail=0
2026.01.01 18:33:02.182 1: SolCast DEBUG> Epoche 1870: Train MSE=0.000205, Val MSE=0.000383, Val MAE=0.014067, Val MedAE=0.010133, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:33:06.890 1: SolCast DEBUG> Epoche 1900: Train MSE=0.000205, Val MSE=0.000376, Val MAE=0.014446, Val MedAE=0.011115, Bit_Fail=0
2026.01.01 18:33:22.858 1: SolCast DEBUG> Epoche 2000: Train MSE=0.000205, Val MSE=0.000368, Val MAE=0.014258, Val MedAE=0.010752, Bit_Fail=0
2026.01.01 18:33:38.578 1: SolCast DEBUG> Epoche 2100: Train MSE=0.000205, Val MSE=0.000440, Val MAE=0.016680, Val MedAE=0.014515, Bit_Fail=0
2026.01.01 18:33:41.611 1: SolCast DEBUG> Epoche 2120: Train MSE=0.000198, Val MSE=0.000367, Val MAE=0.013801, Val MedAE=0.009661, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:33:54.354 1: SolCast DEBUG> Epoche 2200: Train MSE=0.000198, Val MSE=0.000417, Val MAE=0.016140, Val MedAE=0.013713, Bit_Fail=0
2026.01.01 18:34:11.686 1: SolCast DEBUG> Epoche 2300: Train MSE=0.000198, Val MSE=0.000362, Val MAE=0.014348, Val MedAE=0.010921, Bit_Fail=0
2026.01.01 18:34:18.148 1: SolCast DEBUG> Epoche 2340: Train MSE=0.000195, Val MSE=0.000356, Val MAE=0.013592, Val MedAE=0.009300, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:34:27.489 1: SolCast DEBUG> Epoche 2400: Train MSE=0.000195, Val MSE=0.000355, Val MAE=0.014051, Val MedAE=0.010411, Bit_Fail=0
2026.01.01 18:34:43.305 1: SolCast DEBUG> Epoche 2500: Train MSE=0.000195, Val MSE=0.000349, Val MAE=0.013577, Val MedAE=0.009666, Bit_Fail=0
2026.01.01 18:34:58.973 1: SolCast DEBUG> Epoche 2600: Train MSE=0.000195, Val MSE=0.000377, Val MAE=0.015170, Val MedAE=0.012456, Bit_Fail=0
2026.01.01 18:35:15.415 1: SolCast DEBUG> Epoche 2700: Train MSE=0.000195, Val MSE=0.000340, Val MAE=0.013970, Val MedAE=0.010876, Bit_Fail=0
2026.01.01 18:35:32.017 1: SolCast DEBUG> Epoche 2800: Train MSE=0.000195, Val MSE=0.000382, Val MAE=0.015341, Val MedAE=0.012854, Bit_Fail=0
2026.01.01 18:35:47.827 1: SolCast DEBUG> Epoche 2900: Train MSE=0.000195, Val MSE=0.000328, Val MAE=0.013411, Val MedAE=0.009790, Bit_Fail=0
2026.01.01 18:35:52.375 1: SolCast DEBUG> Epoche 2931: Train MSE=0.000186, Val MSE=0.000331, Val MAE=0.013276, Val MedAE=0.009297, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:36:04.885 1: SolCast DEBUG> Epoche 3000: Train MSE=0.000186, Val MSE=0.000333, Val MAE=0.013785, Val MedAE=0.010478, Bit_Fail=0
2026.01.01 18:36:20.725 1: SolCast DEBUG> Epoche 3100: Train MSE=0.000186, Val MSE=0.000329, Val MAE=0.013228, Val MedAE=0.009287, Bit_Fail=0
2026.01.01 18:36:20.735 1: SolCast DEBUG> Epoche 3100: Train MSE=0.000184, Val MSE=0.000329, Val MAE=0.013228, Val MedAE=0.009287, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:36:34.489 1: SolCast DEBUG> Epoche 3180: Train MSE=0.000182, Val MSE=0.000327, Val MAE=0.013125, Val MedAE=0.008939, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:36:38.029 1: SolCast DEBUG> Epoche 3200: Train MSE=0.000182, Val MSE=0.000320, Val MAE=0.013228, Val MedAE=0.009632, Bit_Fail=0
2026.01.01 18:36:45.842 1: SolCast DEBUG> Epoche 3250: Train MSE=0.000183, Val MSE=0.000323, Val MAE=0.013096, Val MedAE=0.008886, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:36:53.303 1: SolCast DEBUG> Epoche 3300: Train MSE=0.000183, Val MSE=0.000320, Val MAE=0.013318, Val MedAE=0.009760, Bit_Fail=0
2026.01.01 18:37:09.545 1: SolCast DEBUG> Epoche 3400: Train MSE=0.000183, Val MSE=0.000327, Val MAE=0.013922, Val MedAE=0.011272, Bit_Fail=0
2026.01.01 18:37:24.189 1: SolCast DEBUG> Epoche 3490: Train MSE=0.000180, Val MSE=0.000319, Val MAE=0.013041, Val MedAE=0.008820, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:37:25.723 1: SolCast DEBUG> Epoche 3500: Train MSE=0.000180, Val MSE=0.000323, Val MAE=0.013588, Val MedAE=0.010386, Bit_Fail=0
2026.01.01 18:37:47.590 1: SolCast DEBUG> Epoche 3600: Train MSE=0.000180, Val MSE=0.000323, Val MAE=0.013730, Val MedAE=0.010947, Bit_Fail=0
2026.01.01 18:37:53.258 1: SolCast DEBUG> Epoche 3630: Train MSE=0.000178, Val MSE=0.000318, Val MAE=0.012948, Val MedAE=0.008677, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:38:09.034 1: SolCast DEBUG> Epoche 3700: Train MSE=0.000178, Val MSE=0.000312, Val MAE=0.013378, Val MedAE=0.010497, Bit_Fail=0
2026.01.01 18:38:30.192 1: SolCast DEBUG> Epoche 3800: Train MSE=0.000178, Val MSE=0.000312, Val MAE=0.013379, Val MedAE=0.010674, Bit_Fail=0
2026.01.01 18:38:52.224 1: SolCast DEBUG> Epoche 3900: Train MSE=0.000178, Val MSE=0.000318, Val MAE=0.012933, Val MedAE=0.008471, Bit_Fail=0
2026.01.01 18:39:13.603 1: SolCast DEBUG> Epoche 4000: Train MSE=0.000178, Val MSE=0.000306, Val MAE=0.013228, Val MedAE=0.010395, Bit_Fail=0
2026.01.01 18:39:34.047 1: SolCast DEBUG> Epoche 4100: Train MSE=0.000178, Val MSE=0.000318, Val MAE=0.013793, Val MedAE=0.011333, Bit_Fail=0
2026.01.01 18:39:54.812 1: SolCast DEBUG> Epoche 4200: Train MSE=0.000178, Val MSE=0.000309, Val MAE=0.013388, Val MedAE=0.010831, Bit_Fail=0
2026.01.01 18:40:02.202 1: SolCast DEBUG> Epoche 4230: Train MSE=0.000175, Val MSE=0.000309, Val MAE=0.012845, Val MedAE=0.008584, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:40:16.021 1: SolCast DEBUG> Epoche 4300: Train MSE=0.000175, Val MSE=0.000303, Val MAE=0.013012, Val MedAE=0.009822, Bit_Fail=0
2026.01.01 18:40:34.355 1: SolCast DEBUG> Epoche 4400: Train MSE=0.000175, Val MSE=0.000310, Val MAE=0.012884, Val MedAE=0.008766, Bit_Fail=0
2026.01.01 18:40:57.218 1: SolCast DEBUG> Epoche 4500: Train MSE=0.000175, Val MSE=0.000302, Val MAE=0.013128, Val MedAE=0.010345, Bit_Fail=0
2026.01.01 18:41:22.220 1: SolCast DEBUG> Epoche 4600: Train MSE=0.000175, Val MSE=0.000302, Val MAE=0.013191, Val MedAE=0.010385, Bit_Fail=0
2026.01.01 18:41:43.986 1: SolCast DEBUG> Epoche 4700: Train MSE=0.000175, Val MSE=0.000301, Val MAE=0.013269, Val MedAE=0.010709, Bit_Fail=0
2026.01.01 18:42:05.591 1: SolCast DEBUG> Epoche 4800: Train MSE=0.000175, Val MSE=0.000327, Val MAE=0.012984, Val MedAE=0.008358, Bit_Fail=0
2026.01.01 18:42:28.817 1: SolCast DEBUG> Epoche 4900: Train MSE=0.000175, Val MSE=0.000300, Val MAE=0.013196, Val MedAE=0.010534, Bit_Fail=0
2026.01.01 18:42:51.092 1: SolCast DEBUG> Epoche 5000: Train MSE=0.000175, Val MSE=0.000298, Val MAE=0.013025, Val MedAE=0.010142, Bit_Fail=0
2026.01.01 18:43:13.597 1: SolCast DEBUG> Epoche 5100: Train MSE=0.000175, Val MSE=0.000296, Val MAE=0.012895, Val MedAE=0.009981, Bit_Fail=0
2026.01.01 18:43:36.900 1: SolCast DEBUG> Epoche 5200: Train MSE=0.000175, Val MSE=0.000298, Val MAE=0.012955, Val MedAE=0.009983, Bit_Fail=0
2026.01.01 18:43:58.243 1: SolCast DEBUG> Epoche 5300: Train MSE=0.000175, Val MSE=0.000305, Val MAE=0.013474, Val MedAE=0.010999, Bit_Fail=0
2026.01.01 18:44:20.399 1: SolCast DEBUG> Epoche 5400: Train MSE=0.000175, Val MSE=0.000296, Val MAE=0.012941, Val MedAE=0.009892, Bit_Fail=0
2026.01.01 18:44:37.326 1: SolCast DEBUG> Epoche 5500: Train MSE=0.000175, Val MSE=0.000301, Val MAE=0.013345, Val MedAE=0.010900, Bit_Fail=0
2026.01.01 18:44:53.049 1: SolCast DEBUG> Epoche 5600: Train MSE=0.000175, Val MSE=0.000297, Val MAE=0.012997, Val MedAE=0.010176, Bit_Fail=0
2026.01.01 18:45:10.274 1: SolCast DEBUG> Epoche 5700: Train MSE=0.000175, Val MSE=0.000303, Val MAE=0.013484, Val MedAE=0.011050, Bit_Fail=0
2026.01.01 18:45:27.329 1: SolCast DEBUG> Epoche 5800: Train MSE=0.000175, Val MSE=0.000300, Val MAE=0.013419, Val MedAE=0.011095, Bit_Fail=0
2026.01.01 18:45:42.673 1: SolCast DEBUG> Epoche 5900: Train MSE=0.000175, Val MSE=0.000295, Val MAE=0.013058, Val MedAE=0.010464, Bit_Fail=0
2026.01.01 18:45:59.007 1: SolCast DEBUG> Epoche 6000: Train MSE=0.000175, Val MSE=0.000299, Val MAE=0.012793, Val MedAE=0.009330, Bit_Fail=0
2026.01.01 18:46:14.775 1: SolCast DEBUG> Epoche 6100: Train MSE=0.000175, Val MSE=0.000294, Val MAE=0.013040, Val MedAE=0.010396, Bit_Fail=0
2026.01.01 18:46:29.912 1: SolCast DEBUG> Epoche 6200: Train MSE=0.000175, Val MSE=0.000305, Val MAE=0.013656, Val MedAE=0.011383, Bit_Fail=0
2026.01.01 18:46:34.543 1: SolCast DEBUG> Early stopping bei Epoche 6230 (no improvement since 2000 epochs)
2026.01.01 18:46:34.546 1: === Snapshot-Statistik ===
2026.01.01 18:46:34.547 1: Metric-Improvement Snapshots: 63 (letzte Epoche: 4230)
2026.01.01 18:46:34.549 1: Bit-Improvement Snapshots: 3 (letzte Epoche: 164)
2026.01.01 18:46:34.552 1: Bit-Tradeoff Snapshots: 0 (letzte Epoche: 0)
2026.01.01 18:46:34.559 1: SolCast DEBUG> Best Snapshot reloaded from Epoche 4230: Train MSE=0.000175, Val MSE=0.000309, Val MAE=0.012845, Val MedAE=0.008584, Bit_Fail=0,
2026.01.01 18:46:34.561 1: SolCast DEBUG> Run Validation Test with 20% of Input data ...
2026.01.01 18:46:34.602 1: SolCast DEBUG> Validation finished - Best Training MSE=0.000175, Validation MSE=0.000309, Validation Bit_Fail=0
2026.01.01 18:46:34.605 1: SolCast DEBUG> Retrain check ->
-- In Normalization Space: --
Train MSE=0.000175
Val MSE=0.000309
Val Mean=0.0003042089
VAL/TRAIN MSE Ratio=1.763249 (limit=2.5)
Diff=0.000134 (limit=0.005)
ValStd=0.0000076839 (limit=7.60522365479913e-05)
-- At Original Scale: --
MAE=211.576764064665
RMSE/MAE=1.3694 (limit=1.5)
Slope=0.935893 (limit=0.7 .. 1.3)
Bias=4.36 (limit=+-105.788382032332)
R2=0.890528595577006
P95=585.8856 (limit=846.307056258658)
P99=968.7970 (limit=1692.61411251732)
-- Robustness Indicators: --
RMSE relative=62 (limit=20)
BitFail=0 (limit=5)
BitFailRate=0.0000 (limit=0.1)
-> Retrain
2026.01.01 18:46:34.613 1: SolCast DEBUG> Retry attempt 2 with Seed=16325084
2026.01.01 18:46:34.619 1: SolCast DEBUG> AI FANN Training started with Params:
num input datasets=7314,
training algo=FANN_TRAIN_INCREMENTAL,
output AF=LINEAR,
hidden AF=SIGMOID,
hidden Neurons=80,40,20,
hidden steepness=0.9,
Epoches=15000,
mse_error=0.001,
learning rate=0.00500,
learning momentum=0.7,
Data sharing=split after shuffle of training data and use AI internal shuffle (Train=5851, Test=1462),
Data shuffle=2 (period=10)
2026.01.01 18:46:34.804 1: SolCast DEBUG> Epoche 1: Train MSE=0.002232, Val MSE=0.002836, Val MAE=0.031928, Val MedAE=0.027901, Bit_Fail=2 -> Snap saved (bit improved)
2026.01.01 18:46:35.250 1: SolCast DEBUG> Epoche 4: Train MSE=0.002191, Val MSE=0.002835, Val MAE=0.031923, Val MedAE=0.027895, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:35.703 1: SolCast DEBUG> Epoche 7: Train MSE=0.002187, Val MSE=0.002834, Val MAE=0.031919, Val MedAE=0.027892, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:42.846 1: SolCast DEBUG> Epoche 54: Train MSE=0.002012, Val MSE=0.002830, Val MAE=0.030056, Val MedAE=0.024398, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:42.997 1: SolCast DEBUG> Epoche 55: Train MSE=0.001999, Val MSE=0.002816, Val MAE=0.029980, Val MedAE=0.024096, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:43.151 1: SolCast DEBUG> Epoche 56: Train MSE=0.001984, Val MSE=0.002799, Val MAE=0.029892, Val MedAE=0.023790, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:43.302 1: SolCast DEBUG> Epoche 57: Train MSE=0.001966, Val MSE=0.002780, Val MAE=0.029791, Val MedAE=0.023427, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:43.459 1: SolCast DEBUG> Epoche 58: Train MSE=0.001945, Val MSE=0.002756, Val MAE=0.029676, Val MedAE=0.022958, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:43.623 1: SolCast DEBUG> Epoche 59: Train MSE=0.001920, Val MSE=0.002728, Val MAE=0.029540, Val MedAE=0.022374, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:44.667 1: SolCast DEBUG> Epoche 65: Train MSE=0.001639, Val MSE=0.002678, Val MAE=0.029156, Val MedAE=0.016122, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 18:46:50.165 1: SolCast DEBUG> Epoche 100: Train MSE=0.001639, Val MSE=0.001617, Val MAE=0.027389, Val MedAE=0.021329, Bit_Fail=1
2026.01.01 18:46:57.117 1: SolCast DEBUG> Epoche 140: Train MSE=0.000582, Val MSE=0.000982, Val MAE=0.021762, Val MedAE=0.016481, Bit_Fail=1 -> Snap saved (bit improved)
2026.01.01 18:46:57.374 1: SolCast DEBUG> Epoche 141: Train MSE=0.000571, Val MSE=0.000963, Val MAE=0.021553, Val MedAE=0.016314, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:57.625 1: SolCast DEBUG> Epoche 142: Train MSE=0.000559, Val MSE=0.000944, Val MAE=0.021340, Val MedAE=0.015998, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:57.814 1: SolCast DEBUG> Epoche 143: Train MSE=0.000548, Val MSE=0.000925, Val MAE=0.021128, Val MedAE=0.015847, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:58.048 1: SolCast DEBUG> Epoche 144: Train MSE=0.000537, Val MSE=0.000906, Val MAE=0.020921, Val MedAE=0.015525, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:58.217 1: SolCast DEBUG> Epoche 145: Train MSE=0.000526, Val MSE=0.000888, Val MAE=0.020716, Val MedAE=0.015427, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:58.387 1: SolCast DEBUG> Epoche 146: Train MSE=0.000516, Val MSE=0.000871, Val MAE=0.020515, Val MedAE=0.015357, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:58.797 1: SolCast DEBUG> Epoche 148: Train MSE=0.000497, Val MSE=0.000838, Val MAE=0.020132, Val MedAE=0.015318, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:58.986 1: SolCast DEBUG> Epoche 149: Train MSE=0.000488, Val MSE=0.000822, Val MAE=0.019953, Val MedAE=0.015200, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:59.141 1: SolCast DEBUG> Epoche 150: Train MSE=0.000482, Val MSE=0.000817, Val MAE=0.019792, Val MedAE=0.015107, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:59.316 1: SolCast DEBUG> Epoche 151: Train MSE=0.000474, Val MSE=0.000802, Val MAE=0.019630, Val MedAE=0.014972, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:59.471 1: SolCast DEBUG> Epoche 152: Train MSE=0.000466, Val MSE=0.000788, Val MAE=0.019477, Val MedAE=0.014905, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:59.637 1: SolCast DEBUG> Epoche 153: Train MSE=0.000459, Val MSE=0.000775, Val MAE=0.019332, Val MedAE=0.014836, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:59.795 1: SolCast DEBUG> Epoche 154: Train MSE=0.000452, Val MSE=0.000763, Val MAE=0.019196, Val MedAE=0.014833, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:46:59.953 1: SolCast DEBUG> Epoche 155: Train MSE=0.000446, Val MSE=0.000751, Val MAE=0.019068, Val MedAE=0.014766, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:47:00.128 1: SolCast DEBUG> Epoche 156: Train MSE=0.000440, Val MSE=0.000740, Val MAE=0.018949, Val MedAE=0.014751, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:47:00.423 1: SolCast DEBUG> Epoche 157: Train MSE=0.000434, Val MSE=0.000729, Val MAE=0.018837, Val MedAE=0.014571, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:47:00.580 1: SolCast DEBUG> Epoche 158: Train MSE=0.000429, Val MSE=0.000719, Val MAE=0.018732, Val MedAE=0.014399, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 18:47:00.738 1: SolCast DEBUG> Epoche 159: Train MSE=0.000423, Val MSE=0.000710, Val MAE=0.018632, Val MedAE=0.014296, Bit_Fail=0 -> Snap saved (bit improved)
2026.01.01 18:47:04.664 1: SolCast DEBUG> Epoche 185: Train MSE=0.000352, Val MSE=0.000570, Val MAE=0.017726, Val MedAE=0.014241, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:04.823 1: SolCast DEBUG> Epoche 186: Train MSE=0.000351, Val MSE=0.000568, Val MAE=0.017700, Val MedAE=0.014157, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:04.998 1: SolCast DEBUG> Epoche 187: Train MSE=0.000350, Val MSE=0.000567, Val MAE=0.017676, Val MedAE=0.014128, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:05.330 1: SolCast DEBUG> Epoche 189: Train MSE=0.000347, Val MSE=0.000565, Val MAE=0.017630, Val MedAE=0.014111, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:07.326 1: SolCast DEBUG> Epoche 200: Train MSE=0.000347, Val MSE=0.000560, Val MAE=0.017645, Val MedAE=0.014294, Bit_Fail=0
2026.01.01 18:47:08.430 1: SolCast DEBUG> Epoche 207: Train MSE=0.000336, Val MSE=0.000557, Val MAE=0.017581, Val MedAE=0.014098, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:08.925 1: SolCast DEBUG> Epoche 210: Train MSE=0.000332, Val MSE=0.000551, Val MAE=0.017149, Val MedAE=0.014015, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:09.251 1: SolCast DEBUG> Epoche 212: Train MSE=0.000331, Val MSE=0.000549, Val MAE=0.017106, Val MedAE=0.014013, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:09.543 1: SolCast DEBUG> Epoche 214: Train MSE=0.000330, Val MSE=0.000548, Val MAE=0.017079, Val MedAE=0.014009, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:19.704 1: SolCast DEBUG> Epoche 280: Train MSE=0.000312, Val MSE=0.000539, Val MAE=0.016444, Val MedAE=0.013594, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:22.914 1: SolCast DEBUG> Epoche 300: Train MSE=0.000312, Val MSE=0.000547, Val MAE=0.017776, Val MedAE=0.014873, Bit_Fail=0
2026.01.01 18:47:36.920 1: SolCast DEBUG> Epoche 390: Train MSE=0.000299, Val MSE=0.000534, Val MAE=0.016256, Val MedAE=0.013227, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:37.075 1: SolCast DEBUG> Epoche 391: Train MSE=0.000299, Val MSE=0.000533, Val MAE=0.016248, Val MedAE=0.013207, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:37.692 1: SolCast DEBUG> Epoche 395: Train MSE=0.000298, Val MSE=0.000532, Val MAE=0.016231, Val MedAE=0.013184, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:38.408 1: SolCast DEBUG> Epoche 400: Train MSE=0.000298, Val MSE=0.000533, Val MAE=0.016139, Val MedAE=0.013128, Bit_Fail=0
2026.01.01 18:47:43.011 1: SolCast DEBUG> Epoche 430: Train MSE=0.000294, Val MSE=0.000524, Val MAE=0.016053, Val MedAE=0.013160, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:47:53.755 1: SolCast DEBUG> Epoche 500: Train MSE=0.000294, Val MSE=0.000533, Val MAE=0.017601, Val MedAE=0.015372, Bit_Fail=0
2026.01.01 18:48:03.268 1: SolCast DEBUG> Epoche 560: Train MSE=0.000278, Val MSE=0.000499, Val MAE=0.015935, Val MedAE=0.013052, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:48:10.654 1: SolCast DEBUG> Epoche 600: Train MSE=0.000278, Val MSE=0.000497, Val MAE=0.016063, Val MedAE=0.013071, Bit_Fail=0
2026.01.01 18:48:17.120 1: SolCast DEBUG> Epoche 640: Train MSE=0.000270, Val MSE=0.000494, Val MAE=0.015925, Val MedAE=0.012746, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:48:26.254 1: SolCast DEBUG> Epoche 700: Train MSE=0.000270, Val MSE=0.000494, Val MAE=0.016121, Val MedAE=0.012865, Bit_Fail=0
2026.01.01 18:48:41.338 1: SolCast DEBUG> Epoche 800: Train MSE=0.000270, Val MSE=0.000496, Val MAE=0.016486, Val MedAE=0.013111, Bit_Fail=0
2026.01.01 18:48:50.270 1: SolCast DEBUG> Epoche 860: Train MSE=0.000251, Val MSE=0.000491, Val MAE=0.015786, Val MedAE=0.012241, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:48:56.298 1: SolCast DEBUG> Epoche 900: Train MSE=0.000251, Val MSE=0.000539, Val MAE=0.017781, Val MedAE=0.014813, Bit_Fail=0
2026.01.01 18:49:00.767 1: openMeteo - Open-Meteo API server response: start_SSL https://api.open-meteo.com:443 timed out
2026.01.01 18:49:11.666 1: SolCast DEBUG> Epoche 1000: Train MSE=0.000251, Val MSE=0.000487, Val MAE=0.015740, Val MedAE=0.012296, Bit_Fail=0
2026.01.01 18:49:28.665 1: SolCast DEBUG> Epoche 1100: Train MSE=0.000251, Val MSE=0.000491, Val MAE=0.015728, Val MedAE=0.012462, Bit_Fail=0
2026.01.01 18:49:39.207 1: SolCast DEBUG> Epoche 1168: Train MSE=0.000235, Val MSE=0.000479, Val MAE=0.015557, Val MedAE=0.012237, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:49:44.096 1: SolCast DEBUG> Epoche 1200: Train MSE=0.000235, Val MSE=0.000477, Val MAE=0.015613, Val MedAE=0.012266, Bit_Fail=0
2026.01.01 18:49:59.330 1: SolCast DEBUG> Epoche 1300: Train MSE=0.000235, Val MSE=0.000469, Val MAE=0.015970, Val MedAE=0.012473, Bit_Fail=0
2026.01.01 18:50:02.607 1: SolCast DEBUG> Epoche 1320: Train MSE=0.000230, Val MSE=0.000474, Val MAE=0.015490, Val MedAE=0.011887, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:50:15.063 1: SolCast DEBUG> Epoche 1400: Train MSE=0.000230, Val MSE=0.000469, Val MAE=0.016083, Val MedAE=0.012479, Bit_Fail=0
2026.01.01 18:50:31.357 1: SolCast DEBUG> Epoche 1500: Train MSE=0.000230, Val MSE=0.000461, Val MAE=0.015731, Val MedAE=0.012435, Bit_Fail=0
2026.01.01 18:50:43.405 1: SolCast DEBUG> Epoche 1570: Train MSE=0.000219, Val MSE=0.000452, Val MAE=0.015217, Val MedAE=0.011832, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:50:48.687 1: SolCast DEBUG> Epoche 1600: Train MSE=0.000219, Val MSE=0.000452, Val MAE=0.015676, Val MedAE=0.012380, Bit_Fail=0
2026.01.01 18:51:00.785 1: SolCast DEBUG> Epoche 1680: Train MSE=0.000216, Val MSE=0.000447, Val MAE=0.015153, Val MedAE=0.011761, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:51:02.263 1: SolCast DEBUG> Epoche 1690: Train MSE=0.000215, Val MSE=0.000446, Val MAE=0.015014, Val MedAE=0.011740, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:51:03.808 1: SolCast DEBUG> Epoche 1700: Train MSE=0.000215, Val MSE=0.000444, Val MAE=0.015548, Val MedAE=0.012346, Bit_Fail=0
2026.01.01 18:51:19.267 1: SolCast DEBUG> Epoche 1800: Train MSE=0.000215, Val MSE=0.000456, Val MAE=0.016255, Val MedAE=0.012272, Bit_Fail=0
2026.01.01 18:51:28.478 1: SolCast DEBUG> Epoche 1860: Train MSE=0.000211, Val MSE=0.000430, Val MAE=0.014967, Val MedAE=0.011675, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:51:32.128 1: SolCast DEBUG> Epoche 1885: Train MSE=0.000210, Val MSE=0.000429, Val MAE=0.014936, Val MedAE=0.011634, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:51:34.991 1: SolCast DEBUG> Epoche 1900: Train MSE=0.000210, Val MSE=0.000431, Val MAE=0.015557, Val MedAE=0.012006, Bit_Fail=0
2026.01.01 18:51:36.961 1: SolCast DEBUG> Epoche 1910: Train MSE=0.000209, Val MSE=0.000427, Val MAE=0.014927, Val MedAE=0.011633, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:51:44.135 1: SolCast DEBUG> Epoche 1950: Train MSE=0.000207, Val MSE=0.000425, Val MAE=0.014852, Val MedAE=0.011568, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:51:51.659 1: SolCast DEBUG> Epoche 2000: Train MSE=0.000207, Val MSE=0.000419, Val MAE=0.015028, Val MedAE=0.011705, Bit_Fail=0
2026.01.01 18:52:07.280 1: SolCast DEBUG> Epoche 2100: Train MSE=0.000207, Val MSE=0.000419, Val MAE=0.015127, Val MedAE=0.011801, Bit_Fail=0
2026.01.01 18:52:22.353 1: SolCast DEBUG> Epoche 2200: Train MSE=0.000207, Val MSE=0.000409, Val MAE=0.014933, Val MedAE=0.011578, Bit_Fail=0
2026.01.01 18:52:25.518 1: SolCast DEBUG> Epoche 2220: Train MSE=0.000201, Val MSE=0.000401, Val MAE=0.014505, Val MedAE=0.011123, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:52:38.140 1: SolCast DEBUG> Epoche 2280: Train MSE=0.000200, Val MSE=0.000398, Val MAE=0.014426, Val MedAE=0.010998, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:52:40.466 1: SolCast DEBUG> Epoche 2290: Train MSE=0.000199, Val MSE=0.000397, Val MAE=0.014408, Val MedAE=0.010918, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:52:42.754 1: SolCast DEBUG> Epoche 2300: Train MSE=0.000199, Val MSE=0.000395, Val MAE=0.014771, Val MedAE=0.011372, Bit_Fail=0
2026.01.01 18:53:06.020 1: SolCast DEBUG> Epoche 2400: Train MSE=0.000199, Val MSE=0.000386, Val MAE=0.014179, Val MedAE=0.010473, Bit_Fail=0
2026.01.01 18:53:06.031 1: SolCast DEBUG> Epoche 2400: Train MSE=0.000196, Val MSE=0.000386, Val MAE=0.014179, Val MedAE=0.010473, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:53:27.648 1: SolCast DEBUG> Epoche 2500: Train MSE=0.000196, Val MSE=0.000394, Val MAE=0.015055, Val MedAE=0.011719, Bit_Fail=0
2026.01.01 18:53:48.669 1: SolCast DEBUG> Epoche 2600: Train MSE=0.000196, Val MSE=0.000393, Val MAE=0.015223, Val MedAE=0.011833, Bit_Fail=0
2026.01.01 18:54:04.615 1: SolCast DEBUG> Epoche 2670: Train MSE=0.000190, Val MSE=0.000363, Val MAE=0.014023, Val MedAE=0.010343, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:54:10.539 1: SolCast DEBUG> Epoche 2700: Train MSE=0.000190, Val MSE=0.000399, Val MAE=0.015520, Val MedAE=0.012166, Bit_Fail=0
2026.01.01 18:54:22.630 1: SolCast DEBUG> Epoche 2762: Train MSE=0.000188, Val MSE=0.000359, Val MAE=0.014009, Val MedAE=0.010303, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:54:28.642 1: SolCast DEBUG> Epoche 2800: Train MSE=0.000188, Val MSE=0.000422, Val MAE=0.016216, Val MedAE=0.013541, Bit_Fail=0
2026.01.01 18:54:36.250 1: SolCast DEBUG> Epoche 2850: Train MSE=0.000187, Val MSE=0.000356, Val MAE=0.013892, Val MedAE=0.010014, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:54:37.817 1: SolCast DEBUG> Epoche 2860: Train MSE=0.000186, Val MSE=0.000353, Val MAE=0.013781, Val MedAE=0.009785, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:54:43.894 1: SolCast DEBUG> Epoche 2900: Train MSE=0.000186, Val MSE=0.000373, Val MAE=0.014968, Val MedAE=0.011754, Bit_Fail=0
2026.01.01 18:54:51.665 1: SolCast DEBUG> Epoche 2950: Train MSE=0.000184, Val MSE=0.000350, Val MAE=0.013709, Val MedAE=0.009744, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:54:56.355 1: SolCast DEBUG> Epoche 2980: Train MSE=0.000185, Val MSE=0.000344, Val MAE=0.013542, Val MedAE=0.009640, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:54:59.391 1: SolCast DEBUG> Epoche 3000: Train MSE=0.000185, Val MSE=0.000345, Val MAE=0.013771, Val MedAE=0.010299, Bit_Fail=0
2026.01.01 18:55:15.914 1: SolCast DEBUG> Epoche 3100: Train MSE=0.000185, Val MSE=0.000338, Val MAE=0.013390, Val MedAE=0.009239, Bit_Fail=0
2026.01.01 18:55:15.920 1: SolCast DEBUG> Epoche 3100: Train MSE=0.000183, Val MSE=0.000338, Val MAE=0.013390, Val MedAE=0.009239, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:55:31.223 1: SolCast DEBUG> Epoche 3200: Train MSE=0.000183, Val MSE=0.000374, Val MAE=0.015348, Val MedAE=0.013113, Bit_Fail=0
2026.01.01 18:55:46.650 1: SolCast DEBUG> Epoche 3300: Train MSE=0.000183, Val MSE=0.000395, Val MAE=0.015892, Val MedAE=0.013867, Bit_Fail=0
2026.01.01 18:55:55.663 1: SolCast DEBUG> Epoche 3360: Train MSE=0.000178, Val MSE=0.000336, Val MAE=0.013102, Val MedAE=0.009038, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:55:57.156 1: SolCast DEBUG> Epoche 3370: Train MSE=0.000178, Val MSE=0.000328, Val MAE=0.013027, Val MedAE=0.008576, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 18:56:01.837 1: SolCast DEBUG> Epoche 3400: Train MSE=0.000178, Val MSE=0.000331, Val MAE=0.013966, Val MedAE=0.010989, Bit_Fail=0
2026.01.01 18:56:18.127 1: SolCast DEBUG> Epoche 3500: Train MSE=0.000178, Val MSE=0.000317, Val MAE=0.013546, Val MedAE=0.010578, Bit_Fail=0
2026.01.01 18:56:33.705 1: SolCast DEBUG> Epoche 3600: Train MSE=0.000178, Val MSE=0.000326, Val MAE=0.013924, Val MedAE=0.011087, Bit_Fail=0
2026.01.01 18:56:49.380 1: SolCast DEBUG> Epoche 3700: Train MSE=0.000178, Val MSE=0.000313, Val MAE=0.013647, Val MedAE=0.011350, Bit_Fail=0
2026.01.01 18:57:04.360 1: SolCast DEBUG> Epoche 3800: Train MSE=0.000178, Val MSE=0.000315, Val MAE=0.013759, Val MedAE=0.011353, Bit_Fail=0
2026.01.01 18:57:20.079 1: SolCast DEBUG> Epoche 3900: Train MSE=0.000178, Val MSE=0.000317, Val MAE=0.013889, Val MedAE=0.011544, Bit_Fail=0
2026.01.01 18:57:36.568 1: SolCast DEBUG> Epoche 4000: Train MSE=0.000178, Val MSE=0.000303, Val MAE=0.013266, Val MedAE=0.010514, Bit_Fail=0
2026.01.01 18:57:51.815 1: SolCast DEBUG> Epoche 4100: Train MSE=0.000178, Val MSE=0.000297, Val MAE=0.013051, Val MedAE=0.010491, Bit_Fail=0
2026.01.01 18:58:07.665 1: SolCast DEBUG> Epoche 4200: Train MSE=0.000178, Val MSE=0.000298, Val MAE=0.013165, Val MedAE=0.010657, Bit_Fail=0
2026.01.01 18:58:22.874 1: SolCast DEBUG> Epoche 4300: Train MSE=0.000178, Val MSE=0.000299, Val MAE=0.012652, Val MedAE=0.009298, Bit_Fail=0
2026.01.01 18:58:39.872 1: SolCast DEBUG> Epoche 4400: Train MSE=0.000178, Val MSE=0.000299, Val MAE=0.013357, Val MedAE=0.010952, Bit_Fail=0
2026.01.01 18:58:55.060 1: SolCast DEBUG> Epoche 4500: Train MSE=0.000178, Val MSE=0.000293, Val MAE=0.012888, Val MedAE=0.010075, Bit_Fail=0
2026.01.01 18:59:10.645 1: SolCast DEBUG> Epoche 4600: Train MSE=0.000178, Val MSE=0.000296, Val MAE=0.013170, Val MedAE=0.010801, Bit_Fail=0
2026.01.01 18:59:26.299 1: SolCast DEBUG> Epoche 4700: Train MSE=0.000178, Val MSE=0.000289, Val MAE=0.012813, Val MedAE=0.010297, Bit_Fail=0
2026.01.01 18:59:41.390 1: SolCast DEBUG> Epoche 4800: Train MSE=0.000178, Val MSE=0.000288, Val MAE=0.012730, Val MedAE=0.010022, Bit_Fail=0
2026.01.01 18:59:58.018 1: SolCast DEBUG> Epoche 4900: Train MSE=0.000178, Val MSE=0.000288, Val MAE=0.012927, Val MedAE=0.010486, Bit_Fail=0
2026.01.01 19:00:16.580 1: SolCast DEBUG> Epoche 5000: Train MSE=0.000178, Val MSE=0.000300, Val MAE=0.013538, Val MedAE=0.011570, Bit_Fail=0
2026.01.01 19:00:22.430 1: VRMAPI DEBUG> start add AI raw data for hour: 19
2026.01.01 19:00:22.434 1: VRMAPI DEBUG> AI raw add - 1 entities added to raw data pool (set verbose 4 for output more detail)
2026.01.01 19:00:22.507 1: VRMAPI DEBUG> AI raw data saved into file: ./FHEM/FhemUtils/AIraw_SolarForecast_VRMAPI
2026.01.01 19:00:23.036 1: SolCast DEBUG> start add AI raw data for hour: 19
2026.01.01 19:00:23.041 1: SolCast DEBUG> AI raw add - 1 entities added to raw data pool (set verbose 4 for output more detail)
2026.01.01 19:00:23.490 1: SolCast DEBUG> AI raw data saved into file: ./FHEM/FhemUtils/AIraw_SolarForecast_SolCast
2026.01.01 19:00:25.468 1: openMeteo DEBUG> start add AI raw data for hour: 19
2026.01.01 19:00:25.471 1: openMeteo DEBUG> AI raw add - 1 entities added to raw data pool (set verbose 4 for output more detail)
2026.01.01 19:00:25.529 1: openMeteo DEBUG> AI raw data saved into file: ./FHEM/FhemUtils/AIraw_SolarForecast_openMeteo
2026.01.01 19:00:36.434 1: SolCast DEBUG> Epoche 5100: Train MSE=0.000178, Val MSE=0.000287, Val MAE=0.012656, Val MedAE=0.009749, Bit_Fail=0
2026.01.01 19:00:52.824 1: SolCast DEBUG> Epoche 5200: Train MSE=0.000178, Val MSE=0.000315, Val MAE=0.014053, Val MedAE=0.012264, Bit_Fail=0
2026.01.01 19:01:08.326 1: SolCast DEBUG> Epoche 5300: Train MSE=0.000178, Val MSE=0.000291, Val MAE=0.013064, Val MedAE=0.010484, Bit_Fail=0
2026.01.01 19:01:18.912 1: SolCast DEBUG> Early stopping bei Epoche 5370 (no improvement since 2000 epochs)
2026.01.01 19:01:18.914 1: === Snapshot-Statistik ===
2026.01.01 19:01:18.916 1: Metric-Improvement Snapshots: 64 (letzte Epoche: 3370)
2026.01.01 19:01:18.918 1: Bit-Improvement Snapshots: 3 (letzte Epoche: 159)
2026.01.01 19:01:18.919 1: Bit-Tradeoff Snapshots: 0 (letzte Epoche: 0)
2026.01.01 19:01:18.925 1: SolCast DEBUG> Best Snapshot reloaded from Epoche 3370: Train MSE=0.000178, Val MSE=0.000328, Val MAE=0.013027, Val MedAE=0.008576, Bit_Fail=0,
2026.01.01 19:01:18.927 1: SolCast DEBUG> Run Validation Test with 20% of Input data ...
2026.01.01 19:01:18.969 1: SolCast DEBUG> Validation finished - Best Training MSE=0.000178, Validation MSE=0.000328, Validation Bit_Fail=0
2026.01.01 19:01:18.971 1: SolCast DEBUG> Retrain check ->
-- In Normalization Space: --
Train MSE=0.000178
Val MSE=0.000328
Val Mean=0.0002956156
VAL/TRAIN MSE Ratio=1.837433 (limit=2.5)
Diff=0.000149 (limit=0.005)
ValStd=0.0000173294 (limit=7.39038913958514e-05)
-- At Original Scale: --
MAE=214.560321844596
RMSE/MAE=1.3893 (limit=1.5)
Slope=0.916647 (limit=0.7 .. 1.3)
Bias=2.25 (limit=+-107.280160922298)
R2=0.884124888835566
P95=585.2166 (limit=858.241287378382)
P99=942.9805 (limit=1716.48257475676)
-- Robustness Indicators: --
RMSE relative=64 (limit=20)
BitFail=0 (limit=5)
BitFailRate=0.0000 (limit=0.1)
-> Retrain
2026.01.01 19:01:18.979 1: SolCast DEBUG> Retry attempt 3 with Seed=16689959
2026.01.01 19:01:18.985 1: SolCast DEBUG> AI FANN Training started with Params:
num input datasets=7314,
training algo=FANN_TRAIN_INCREMENTAL,
output AF=LINEAR,
hidden AF=SIGMOID,
hidden Neurons=80,40,20,
hidden steepness=0.9,
Epoches=15000,
mse_error=0.001,
learning rate=0.00500,
learning momentum=0.7,
Data sharing=split after shuffle of training data and use AI internal shuffle (Train=5851, Test=1462),
Data shuffle=2 (period=10)
2026.01.01 19:01:19.145 1: SolCast DEBUG> Epoche 1: Train MSE=0.002202, Val MSE=0.002839, Val MAE=0.031937, Val MedAE=0.027914, Bit_Fail=2 -> Snap saved (bit improved)
2026.01.01 19:01:25.133 1: SolCast DEBUG> Epoche 40: Train MSE=0.002098, Val MSE=0.002825, Val MAE=0.031158, Val MedAE=0.027367, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:27.800 1: SolCast DEBUG> Epoche 57: Train MSE=0.001969, Val MSE=0.002810, Val MAE=0.029915, Val MedAE=0.021870, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:27.982 1: SolCast DEBUG> Epoche 58: Train MSE=0.001947, Val MSE=0.002786, Val MAE=0.029801, Val MedAE=0.021464, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:28.134 1: SolCast DEBUG> Epoche 59: Train MSE=0.001921, Val MSE=0.002758, Val MAE=0.029673, Val MedAE=0.020903, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:28.609 1: SolCast DEBUG> Epoche 62: Train MSE=0.001810, Val MSE=0.002716, Val MAE=0.029480, Val MedAE=0.017887, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:28.767 1: SolCast DEBUG> Epoche 63: Train MSE=0.001761, Val MSE=0.002660, Val MAE=0.029224, Val MedAE=0.017446, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:28.915 1: SolCast DEBUG> Epoche 64: Train MSE=0.001706, Val MSE=0.002597, Val MAE=0.028944, Val MedAE=0.016968, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:29.063 1: SolCast DEBUG> Epoche 65: Train MSE=0.001645, Val MSE=0.002528, Val MAE=0.028652, Val MedAE=0.016879, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:29.207 1: SolCast DEBUG> Epoche 66: Train MSE=0.001581, Val MSE=0.002455, Val MAE=0.028362, Val MedAE=0.016529, Bit_Fail=2 -> Snap saved (metric improved)
2026.01.01 19:01:34.406 1: SolCast DEBUG> Epoche 100: Train MSE=0.001581, Val MSE=0.001674, Val MAE=0.026943, Val MedAE=0.019938, Bit_Fail=1
2026.01.01 19:01:41.897 1: SolCast DEBUG> Epoche 149: Train MSE=0.000574, Val MSE=0.000953, Val MAE=0.021557, Val MedAE=0.017213, Bit_Fail=1 -> Snap saved (bit improved)
2026.01.01 19:01:43.755 1: SolCast DEBUG> Epoche 160: Train MSE=0.000466, Val MSE=0.000806, Val MAE=0.019501, Val MedAE=0.014848, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:43.926 1: SolCast DEBUG> Epoche 161: Train MSE=0.000458, Val MSE=0.000792, Val MAE=0.019351, Val MedAE=0.014777, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:44.118 1: SolCast DEBUG> Epoche 162: Train MSE=0.000451, Val MSE=0.000778, Val MAE=0.019209, Val MedAE=0.014629, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:44.334 1: SolCast DEBUG> Epoche 163: Train MSE=0.000444, Val MSE=0.000764, Val MAE=0.019075, Val MedAE=0.014565, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:44.504 1: SolCast DEBUG> Epoche 164: Train MSE=0.000438, Val MSE=0.000752, Val MAE=0.018948, Val MedAE=0.014360, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:44.716 1: SolCast DEBUG> Epoche 165: Train MSE=0.000432, Val MSE=0.000740, Val MAE=0.018829, Val MedAE=0.014227, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:44.952 1: SolCast DEBUG> Epoche 166: Train MSE=0.000426, Val MSE=0.000729, Val MAE=0.018714, Val MedAE=0.014165, Bit_Fail=1 -> Snap saved (metric improved)
2026.01.01 19:01:45.151 1: SolCast DEBUG> Epoche 167: Train MSE=0.000421, Val MSE=0.000718, Val MAE=0.018605, Val MedAE=0.014070, Bit_Fail=0 -> Snap saved (bit improved)
2026.01.01 19:01:45.311 1: SolCast DEBUG> Epoche 168: Train MSE=0.000416, Val MSE=0.000708, Val MAE=0.018500, Val MedAE=0.013993, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:01:45.475 1: SolCast DEBUG> Epoche 169: Train MSE=0.000411, Val MSE=0.000699, Val MAE=0.018400, Val MedAE=0.013928, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:01:50.312 1: SolCast DEBUG> Epoche 200: Train MSE=0.000411, Val MSE=0.000558, Val MAE=0.017252, Val MedAE=0.013991, Bit_Fail=0
2026.01.01 19:01:50.478 1: SolCast DEBUG> Epoche 201: Train MSE=0.000341, Val MSE=0.000558, Val MAE=0.017237, Val MedAE=0.013915, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:01:50.920 1: SolCast DEBUG> Epoche 204: Train MSE=0.000338, Val MSE=0.000557, Val MAE=0.017191, Val MedAE=0.013805, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:01:51.226 1: SolCast DEBUG> Epoche 206: Train MSE=0.000337, Val MSE=0.000556, Val MAE=0.017163, Val MedAE=0.013746, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:01:58.095 1: SolCast DEBUG> Epoche 250: Train MSE=0.000319, Val MSE=0.000554, Val MAE=0.016637, Val MedAE=0.013530, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:01:58.382 1: SolCast DEBUG> Epoche 252: Train MSE=0.000318, Val MSE=0.000553, Val MAE=0.016627, Val MedAE=0.013499, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:00.397 1: SolCast DEBUG> Epoche 266: Train MSE=0.000315, Val MSE=0.000552, Val MAE=0.016535, Val MedAE=0.013373, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:06.185 1: SolCast DEBUG> Epoche 300: Train MSE=0.000315, Val MSE=0.000521, Val MAE=0.016463, Val MedAE=0.014001, Bit_Fail=0
2026.01.01 19:02:17.223 1: SolCast DEBUG> Epoche 371: Train MSE=0.000296, Val MSE=0.000522, Val MAE=0.016217, Val MedAE=0.013366, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:21.515 1: SolCast DEBUG> Epoche 400: Train MSE=0.000296, Val MSE=0.000500, Val MAE=0.016347, Val MedAE=0.013895, Bit_Fail=0
2026.01.01 19:02:23.239 1: SolCast DEBUG> Epoche 410: Train MSE=0.000290, Val MSE=0.000518, Val MAE=0.016152, Val MedAE=0.013203, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:23.555 1: SolCast DEBUG> Epoche 412: Train MSE=0.000290, Val MSE=0.000517, Val MAE=0.016144, Val MedAE=0.013196, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:24.223 1: SolCast DEBUG> Epoche 416: Train MSE=0.000289, Val MSE=0.000516, Val MAE=0.016133, Val MedAE=0.013144, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:36.913 1: SolCast DEBUG> Epoche 500: Train MSE=0.000289, Val MSE=0.000513, Val MAE=0.016033, Val MedAE=0.012459, Bit_Fail=0
2026.01.01 19:02:36.920 1: SolCast DEBUG> Epoche 500: Train MSE=0.000274, Val MSE=0.000513, Val MAE=0.016033, Val MedAE=0.012459, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:37.941 1: SolCast DEBUG> Epoche 507: Train MSE=0.000273, Val MSE=0.000512, Val MAE=0.016016, Val MedAE=0.012419, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:02:52.279 1: SolCast DEBUG> Epoche 600: Train MSE=0.000273, Val MSE=0.000491, Val MAE=0.015793, Val MedAE=0.012659, Bit_Fail=0
2026.01.01 19:03:07.863 1: SolCast DEBUG> Epoche 700: Train MSE=0.000273, Val MSE=0.000531, Val MAE=0.017652, Val MedAE=0.014846, Bit_Fail=0
2026.01.01 19:03:22.755 1: SolCast DEBUG> Epoche 800: Train MSE=0.000273, Val MSE=0.000485, Val MAE=0.015777, Val MedAE=0.012388, Bit_Fail=0
2026.01.01 19:03:22.761 1: SolCast DEBUG> Epoche 800: Train MSE=0.000246, Val MSE=0.000485, Val MAE=0.015777, Val MedAE=0.012388, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:03:38.201 1: SolCast DEBUG> Epoche 900: Train MSE=0.000246, Val MSE=0.000489, Val MAE=0.015804, Val MedAE=0.012387, Bit_Fail=0
2026.01.01 19:03:53.934 1: SolCast DEBUG> Epoche 1000: Train MSE=0.000246, Val MSE=0.000491, Val MAE=0.016320, Val MedAE=0.012996, Bit_Fail=0
2026.01.01 19:04:12.553 1: SolCast DEBUG> Epoche 1100: Train MSE=0.000246, Val MSE=0.000500, Val MAE=0.016762, Val MedAE=0.013013, Bit_Fail=0
2026.01.01 19:04:29.863 1: SolCast DEBUG> Epoche 1200: Train MSE=0.000246, Val MSE=0.000472, Val MAE=0.015815, Val MedAE=0.012588, Bit_Fail=0
2026.01.01 19:04:39.395 1: SolCast DEBUG> Epoche 1240: Train MSE=0.000226, Val MSE=0.000476, Val MAE=0.015690, Val MedAE=0.012238, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:04:44.449 1: SolCast DEBUG> Epoche 1260: Train MSE=0.000226, Val MSE=0.000472, Val MAE=0.015617, Val MedAE=0.012095, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:04:54.273 1: SolCast DEBUG> Epoche 1300: Train MSE=0.000226, Val MSE=0.000469, Val MAE=0.015375, Val MedAE=0.012019, Bit_Fail=0
2026.01.01 19:04:54.283 1: SolCast DEBUG> Epoche 1300: Train MSE=0.000225, Val MSE=0.000469, Val MAE=0.015375, Val MedAE=0.012019, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:05:19.860 1: SolCast DEBUG> Epoche 1400: Train MSE=0.000225, Val MSE=0.000476, Val MAE=0.016232, Val MedAE=0.012583, Bit_Fail=0
2026.01.01 19:05:46.230 1: SolCast DEBUG> Epoche 1500: Train MSE=0.000225, Val MSE=0.000460, Val MAE=0.015477, Val MedAE=0.012145, Bit_Fail=0
2026.01.01 19:06:01.555 1: SolCast DEBUG> Epoche 1560: Train MSE=0.000215, Val MSE=0.000450, Val MAE=0.015175, Val MedAE=0.011698, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:06:11.656 1: SolCast DEBUG> Epoche 1600: Train MSE=0.000215, Val MSE=0.000446, Val MAE=0.015338, Val MedAE=0.011925, Bit_Fail=0
2026.01.01 19:06:19.086 1: SolCast DEBUG> Epoche 1630: Train MSE=0.000213, Val MSE=0.000443, Val MAE=0.015005, Val MedAE=0.011380, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:06:37.018 1: SolCast DEBUG> Epoche 1700: Train MSE=0.000213, Val MSE=0.000456, Val MAE=0.016104, Val MedAE=0.012245, Bit_Fail=0
2026.01.01 19:06:41.728 1: SolCast DEBUG> Epoche 1720: Train MSE=0.000209, Val MSE=0.000437, Val MAE=0.014979, Val MedAE=0.011226, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:06:54.098 1: SolCast DEBUG> Epoche 1770: Train MSE=0.000208, Val MSE=0.000428, Val MAE=0.014866, Val MedAE=0.011051, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:07:01.420 1: SolCast DEBUG> Epoche 1800: Train MSE=0.000208, Val MSE=0.000421, Val MAE=0.014909, Val MedAE=0.011181, Bit_Fail=0
2026.01.01 19:07:09.022 1: SolCast DEBUG> Epoche 1830: Train MSE=0.000206, Val MSE=0.000425, Val MAE=0.014835, Val MedAE=0.010975, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:07:18.661 1: SolCast DEBUG> Epoche 1870: Train MSE=0.000205, Val MSE=0.000422, Val MAE=0.014635, Val MedAE=0.010337, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:07:26.451 1: SolCast DEBUG> Epoche 1900: Train MSE=0.000205, Val MSE=0.000421, Val MAE=0.015039, Val MedAE=0.011242, Bit_Fail=0
2026.01.01 19:07:35.709 1: SolCast DEBUG> Epoche 1950: Train MSE=0.000204, Val MSE=0.000412, Val MAE=0.014563, Val MedAE=0.010315, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:07:43.401 1: SolCast DEBUG> Epoche 2000: Train MSE=0.000204, Val MSE=0.000478, Val MAE=0.017001, Val MedAE=0.013903, Bit_Fail=0
2026.01.01 19:07:59.225 1: SolCast DEBUG> Epoche 2100: Train MSE=0.000204, Val MSE=0.000400, Val MAE=0.014424, Val MedAE=0.010221, Bit_Fail=0
2026.01.01 19:07:59.231 1: SolCast DEBUG> Epoche 2100: Train MSE=0.000200, Val MSE=0.000400, Val MAE=0.014424, Val MedAE=0.010221, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:08:14.654 1: SolCast DEBUG> Epoche 2200: Train MSE=0.000200, Val MSE=0.000399, Val MAE=0.014978, Val MedAE=0.011324, Bit_Fail=0
2026.01.01 19:08:28.453 1: SolCast DEBUG> Epoche 2290: Train MSE=0.000196, Val MSE=0.000390, Val MAE=0.014290, Val MedAE=0.009855, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:08:29.937 1: SolCast DEBUG> Epoche 2300: Train MSE=0.000196, Val MSE=0.000391, Val MAE=0.014139, Val MedAE=0.009359, Bit_Fail=0
2026.01.01 19:08:46.992 1: SolCast DEBUG> Epoche 2400: Train MSE=0.000196, Val MSE=0.000429, Val MAE=0.016088, Val MedAE=0.013370, Bit_Fail=0
2026.01.01 19:08:59.193 1: SolCast DEBUG> Epoche 2480: Train MSE=0.000193, Val MSE=0.000378, Val MAE=0.014148, Val MedAE=0.009492, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:09:02.241 1: SolCast DEBUG> Epoche 2500: Train MSE=0.000193, Val MSE=0.000384, Val MAE=0.014816, Val MedAE=0.011437, Bit_Fail=0
2026.01.01 19:09:18.312 1: SolCast DEBUG> Epoche 2600: Train MSE=0.000193, Val MSE=0.000373, Val MAE=0.014435, Val MedAE=0.010892, Bit_Fail=0
2026.01.01 19:09:27.592 1: SolCast DEBUG> Epoche 2660: Train MSE=0.000190, Val MSE=0.000367, Val MAE=0.013899, Val MedAE=0.009407, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:09:33.631 1: SolCast DEBUG> Epoche 2700: Train MSE=0.000190, Val MSE=0.000364, Val MAE=0.014131, Val MedAE=0.010351, Bit_Fail=0
2026.01.01 19:09:50.479 1: SolCast DEBUG> Epoche 2800: Train MSE=0.000190, Val MSE=0.000374, Val MAE=0.014829, Val MedAE=0.011905, Bit_Fail=0
2026.01.01 19:10:06.433 1: SolCast DEBUG> Epoche 2900: Train MSE=0.000190, Val MSE=0.000358, Val MAE=0.013816, Val MedAE=0.009626, Bit_Fail=0
2026.01.01 19:10:17.130 1: SolCast DEBUG> Epoche 2970: Train MSE=0.000184, Val MSE=0.000354, Val MAE=0.013688, Val MedAE=0.009390, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:10:21.510 1: SolCast DEBUG> Epoche 3000: Train MSE=0.000184, Val MSE=0.000376, Val MAE=0.015092, Val MedAE=0.012492, Bit_Fail=0
2026.01.01 19:10:37.294 1: SolCast DEBUG> Epoche 3100: Train MSE=0.000184, Val MSE=0.000344, Val MAE=0.013896, Val MedAE=0.010700, Bit_Fail=0
2026.01.01 19:10:52.935 1: SolCast DEBUG> Epoche 3200: Train MSE=0.000184, Val MSE=0.000340, Val MAE=0.013841, Val MedAE=0.010725, Bit_Fail=0
2026.01.01 19:11:09.459 1: SolCast DEBUG> Epoche 3300: Train MSE=0.000184, Val MSE=0.000343, Val MAE=0.014114, Val MedAE=0.011228, Bit_Fail=0
2026.01.01 19:11:25.191 1: SolCast DEBUG> Epoche 3400: Train MSE=0.000184, Val MSE=0.000329, Val MAE=0.013537, Val MedAE=0.010090, Bit_Fail=0
2026.01.01 19:11:40.627 1: SolCast DEBUG> Epoche 3500: Train MSE=0.000184, Val MSE=0.000338, Val MAE=0.014317, Val MedAE=0.012038, Bit_Fail=0
2026.01.01 19:11:56.504 1: SolCast DEBUG> Epoche 3600: Train MSE=0.000184, Val MSE=0.000338, Val MAE=0.014292, Val MedAE=0.011860, Bit_Fail=0
2026.01.01 19:12:13.062 1: SolCast DEBUG> Epoche 3700: Train MSE=0.000184, Val MSE=0.000318, Val MAE=0.013443, Val MedAE=0.010655, Bit_Fail=0
2026.01.01 19:12:28.812 1: SolCast DEBUG> Epoche 3800: Train MSE=0.000184, Val MSE=0.000314, Val MAE=0.013299, Val MedAE=0.010337, Bit_Fail=0
2026.01.01 19:12:44.335 1: SolCast DEBUG> Epoche 3900: Train MSE=0.000184, Val MSE=0.000316, Val MAE=0.013177, Val MedAE=0.009737, Bit_Fail=0
2026.01.01 19:12:59.748 1: SolCast DEBUG> Epoche 4000: Train MSE=0.000184, Val MSE=0.000344, Val MAE=0.014781, Val MedAE=0.012876, Bit_Fail=0
2026.01.01 19:13:16.661 1: SolCast DEBUG> Epoche 4100: Train MSE=0.000184, Val MSE=0.000307, Val MAE=0.013173, Val MedAE=0.010441, Bit_Fail=0
2026.01.01 19:13:31.964 1: SolCast DEBUG> Epoche 4200: Train MSE=0.000184, Val MSE=0.000338, Val MAE=0.013368, Val MedAE=0.008535, Bit_Fail=0
2026.01.01 19:13:31.971 1: SolCast DEBUG> Epoche 4200: Train MSE=0.000173, Val MSE=0.000338, Val MAE=0.013368, Val MedAE=0.008535, Bit_Fail=0 -> Snap saved (metric improved)
2026.01.01 19:13:47.873 1: SolCast DEBUG> Epoche 4300: Train MSE=0.000173, Val MSE=0.000322, Val MAE=0.014152, Val MedAE=0.012068, Bit_Fail=0
2026.01.01 19:14:02.737 1: SolCast DEBUG> Epoche 4400: Train MSE=0.000173, Val MSE=0.000317, Val MAE=0.013926, Val MedAE=0.011788, Bit_Fail=0
2026.01.01 19:14:18.079 1: SolCast DEBUG> Epoche 4500: Train MSE=0.000173, Val MSE=0.000301, Val MAE=0.013120, Val MedAE=0.010500, Bit_Fail=0
2026.01.01 19:14:34.780 1: SolCast DEBUG> Epoche 4600: Train MSE=0.000173, Val MSE=0.000300, Val MAE=0.013251, Val MedAE=0.011131, Bit_Fail=0
2026.01.01 19:14:50.749 1: SolCast DEBUG> Epoche 4700: Train MSE=0.000173, Val MSE=0.000316, Val MAE=0.013979, Val MedAE=0.011920, Bit_Fail=0
2026.01.01 19:15:07.488 1: SolCast DEBUG> Epoche 4800: Train MSE=0.000173, Val MSE=0.000298, Val MAE=0.013297, Val MedAE=0.011209, Bit_Fail=0
2026.01.01 19:15:24.075 1: SolCast DEBUG> Epoche 4900: Train MSE=0.000173, Val MSE=0.000299, Val MAE=0.013338, Val MedAE=0.011219, Bit_Fail=0
2026.01.01 19:15:40.613 1: SolCast DEBUG> Epoche 5000: Train MSE=0.000173, Val MSE=0.000301, Val MAE=0.012879, Val MedAE=0.009926, Bit_Fail=0
2026.01.01 19:15:57.651 1: SolCast DEBUG> Epoche 5100: Train MSE=0.000173, Val MSE=0.000296, Val MAE=0.013288, Val MedAE=0.011301, Bit_Fail=0
2026.01.01 19:16:13.287 1: SolCast DEBUG> Epoche 5200: Train MSE=0.000173, Val MSE=0.000299, Val MAE=0.013429, Val MedAE=0.011297, Bit_Fail=0
2026.01.01 19:16:29.416 1: SolCast DEBUG> Epoche 5300: Train MSE=0.000173, Val MSE=0.000326, Val MAE=0.014362, Val MedAE=0.012558, Bit_Fail=0
2026.01.01 19:16:52.624 1: SolCast DEBUG> Epoche 5400: Train MSE=0.000173, Val MSE=0.000293, Val MAE=0.013008, Val MedAE=0.010932, Bit_Fail=0
2026.01.01 19:17:15.448 1: SolCast DEBUG> Epoche 5500: Train MSE=0.000173, Val MSE=0.000303, Val MAE=0.013566, Val MedAE=0.011497, Bit_Fail=0
2026.01.01 19:17:36.891 1: SolCast DEBUG> Epoche 5600: Train MSE=0.000173, Val MSE=0.000290, Val MAE=0.012844, Val MedAE=0.010516, Bit_Fail=0
2026.01.01 19:17:59.157 1: SolCast DEBUG> Epoche 5700: Train MSE=0.000173, Val MSE=0.000301, Val MAE=0.013589, Val MedAE=0.011589, Bit_Fail=0
2026.01.01 19:18:20.531 1: SolCast DEBUG> Epoche 5800: Train MSE=0.000173, Val MSE=0.000289, Val MAE=0.012913, Val MedAE=0.010712, Bit_Fail=0
2026.01.01 19:18:35.740 1: SolCast DEBUG> Epoche 5900: Train MSE=0.000173, Val MSE=0.000291, Val MAE=0.013056, Val MedAE=0.010867, Bit_Fail=0
2026.01.01 19:18:51.160 1: SolCast DEBUG> Epoche 6000: Train MSE=0.000173, Val MSE=0.000305, Val MAE=0.013648, Val MedAE=0.011687, Bit_Fail=0
2026.01.01 19:19:08.256 1: SolCast DEBUG> Epoche 6100: Train MSE=0.000173, Val MSE=0.000290, Val MAE=0.012878, Val MedAE=0.010646, Bit_Fail=0
2026.01.01 19:19:23.867 1: SolCast DEBUG> Epoche 6200: Train MSE=0.000173, Val MSE=0.000289, Val MAE=0.012900, Val MedAE=0.010677, Bit_Fail=0
2026.01.01 19:19:23.869 1: SolCast DEBUG> Early stopping bei Epoche 6200 (no improvement since 2000 epochs)
2026.01.01 19:19:23.871 1: === Snapshot-Statistik ===
2026.01.01 19:19:23.873 1: Metric-Improvement Snapshots: 47 (letzte Epoche: 4200)
2026.01.01 19:19:23.875 1: Bit-Improvement Snapshots: 3 (letzte Epoche: 167)
2026.01.01 19:19:23.877 1: Bit-Tradeoff Snapshots: 0 (letzte Epoche: 0)
2026.01.01 19:19:23.884 1: SolCast DEBUG> Best Snapshot reloaded from Epoche 4200: Train MSE=0.000173, Val MSE=0.000338, Val MAE=0.013368, Val MedAE=0.008535, Bit_Fail=0,
2026.01.01 19:19:23.886 1: SolCast DEBUG> Run Validation Test with 20% of Input data ...
2026.01.01 19:19:23.930 1: SolCast DEBUG> Validation finished - Best Training MSE=0.000173, Validation MSE=0.000338, Validation Bit_Fail=0
2026.01.01 19:19:23.933 1: SolCast DEBUG> Retrain check ->
-- In Normalization Space: --
Train MSE=0.000173
Val MSE=0.000338
Val Mean=0.0002966460
VAL/TRAIN MSE Ratio=1.953186 (limit=2.5)
Diff=0.000165 (limit=0.005)
ValStd=0.0000123896 (limit=7.41615117947988e-05)
-- At Original Scale: --
MAE=220.184381409254
RMSE/MAE=1.3759 (limit=1.5)
Slope=0.914758 (limit=0.7 .. 1.3)
Bias=-38.97 (limit=+-110.092190704627)
R2=0.880327221041415
P95=605.3179 (limit=880.737525637016)
P99=868.5353 (limit=1761.47505127403)
-- Robustness Indicators: --
RMSE relative=65 (limit=20)
BitFail=0 (limit=5)
BitFailRate=0.0000 (limit=0.1)
-> Retrain
2026.01.01 19:19:23.945 1: SolCast DEBUG> Best model after retries comes from Attempt=3 with:
Seed=16689959,
Model Slope=0.91,
Model Bias=-38.97,
VAL MedAE=140.59,
VAL MAE=220.18,
VAL RMSE=302.94,
VAL RMSE relative=65 %,
VAL RMSE_Rating=very bad,
VAL R2=0.88,
Val MSE=0.000338
</pre>
</div>
</div>

<br>

==== Auswertung der Trainingskennwerte ====

Abrufbar über:

<pre>
get <Name> valDecTree aiNeuralNetConState
</pre>

===== Modellparameter =====

{| class="wikitable"
! Kennwert !! Bedeutung
|-
| Normierungsgrenzen || Skalierung der Eingabedaten
|-
| Trainingsdaten || Anzahl der Datensätze (Training/Validierung)
|-
| Architektur || Inputs, Hidden Layers, Outputs
|-
| Hyperparameter || Learning Rate, Momentum, BitFail‑Limit
|-
| Aktivierungen || Hidden/Output‑Aktivierungsfunktionen
|-
| Zufallsgenerator || Shuffle‑Mode und Shuffle‑Periode
|}

===== Trainingsmetriken =====

{| class="wikitable"
! Kennwert !! Interpretation
|-
| bestes Modell bei Epoche || Zeitpunkt minimalen Validierungsfehlers
|-
| Training MSE / Validation MSE || Fehlermaße; sollten niedrig und ähnlich sein
|-
| Validation Bit_Fail || Anzahl fehlerhafter Klassifikationen
|-
| bester Trainingslauf || Lauf mit bestem Ergebnis
|-
| Trainingsbewertung || Qualitätsindikator (Varianz, Mittelwert)
|}

===== Fehlermaße der Prognosen =====

{| class="wikitable"
! Kennwert !! Bedeutung
|-
| MAE || mittlerer absoluter Fehler (Wh)
|-
| MedAE || medianer Fehler
|-
| RMSE || quadratischer Fehler, betont Ausreißer
|-
| MAPE || prozentualer Fehler
|-
| MdAPE || medianer prozentualer Fehler
|-
| R² || Gütemaß (0–1)
|}

===== Interpretation des Beispielmodells =====

Die Modellkennzahlen können nach ausgführten Training mit

get <Name> valDecTree aiNeuralNetConState

angezeigt werden. Eine Beispielausgabe sieht etwa so aus:

<pre>
letztes KI-Training: 25.12.2025 03:52:41 / Laufzeit in Sekunden: 1951
letzte KI-Ergebnis Generierungsdauer: 20.37 ms

=== Modellparameter ===

Normierungsgrenzen: PV=9276 W, Hausverbrauch: Min=0 W / Max=8937 W
Trainingsdaten: 7760 Datensätze (Training=6208, Validierung=1552)
Architektur: Inputs=41, Hidden Layers=80-40-20, Outputs=1
Hyperparameter: Learning Rate=0.005, Momentum=0.5, BitFail-Limit=0.35
Aktivierungen: Hidden=SIGMOID, Steilheit=0.9, Output=LINEAR
Zufallsgenerator: Mode=2, Periode=10

=== Trainingsmetriken ===

bestes Modell bei Epoche: 8690 (von max. 15000)
Training MSE: 0.000
Validation MSE: 0.000
Validation Bit_Fail: 0
bester Trainingslauf: 2
Trainingsbewertung: ok (Val MSE Standard Deviation=0.000000, Val MSE Avg=0.000003)

=== Fehlermaße der Prognosen ===

MAE: 122.74 Wh
MedAE: 69.28 Wh
RMSE: 0.002
MAPE: 17.526 %
MdAPE: 10.611 %
R²: 0.847
</pre>

Die Interpretation dieser Daten wird im angezeigten Popup mit ausgegeben und ist diesem Fall:

* 7760 Datensätze → sehr gute Basis
* 80‑40‑20 Architektur → geeignet für komplexe Muster
* MSE ≈ 0 → exzellente Modellanpassung
* MAE 122 Wh → sehr präzise
* R² = 0.847 → hohe Erklärungsqualität

Das Modell ist stabil, generalisiert gut und liefert sehr brauchbare Prognosen.

<br>

== Modulinterne Datenstrukturen ==
Das Modul speichert die verschiedenen historischen und aktuellen Daten wie PV-Prognose, Witterungsdaten (Regen, Bewölkung), Strahlungsdaten, Einspeisung, Bezug, reale Erzeugungsdaten und vieles mehr zur Laufzeit im Arbeitsspeicher. Dadurch ist die Verarbeitung dieser Daten im Vergleich zu Lesevorgängen aus dem Filesystem bzw. einer Datenbank sehr performant. Allerdings würden diese Daten bei einem FHEM Absturz bzw. bei einem regulären Shutdown verlorengehen.

Deswegen werden die relevanten Daten regelmäßig in Dateien gesichert und bei Bedarf wiederhergestellt. Diese Dateien befinden sich im Verzeichnis '''../fhem/FHEM/FhemUtils''' und heißen '''.*_SolarForecast_.*'''.

Die Daten werden in jedem Zyklus der Zentralschleife (CentralTask) gesammelt bzw. berechnet. Der Zyklus wird mit dem Attribut '''plantControl->cycleInterval''' eingestellt.

Zur Laufzeit können diese Daten über get-Kommandos abgerufen werden.

<pre>
get ... pvHistory [Tag]
</pre>

Der pvHistory Datenspeicher enthält die vergangenen Kennwerte der letzten 31 Tage mit einer Genauigkeit von einer Stunde. Es werden die Prognosewerte für Erzeugung und Verbrauch, die realen Werte für Erzeugung und Verbrauch sowie ebenso die Laufzeiten jedes einzelnen Verbrauchers (Consumer) festgehalten. Für jeden Tag gibt es die Stunde "99" die eine Summierung der Stundenwerte des Tages bzw. Sonderschlüssel enthält.

Bei Bedarf lässt sich mit dem Befehl "set ... reset pvHistory" der gesamte Inhalt des Speichers löschen (nicht empfohlen). Selektiver funktioniert die Datenlöschung mit "set ... reset pvHistory <Tag>" (Daten eines bestimmten Tages löschen) bzw. "set ... reset pvHistory <Tag> <Stunde>" (Daten der Stunde eines bestimmten Tages löschen). Die letzten beiden Kommandos müssen über die Kommandozeile im Browser ausgeführt werden.

<pre>
get ... pvCircular
</pre>

Dieser Ringspeicher enthält Daten der letzten 24 Stunden sowie fortwährend berechnete Werte wie Korrekturfaktoren der PV-Erzeugung und Prognosequalität.
Neue Stundenwerte des Tages überschreiben die gespeicherten Schüssel des vorangegangenen Tages sofern es sich nicht um fortwährend berechnete Werte handelt.

<pre>
get ... nextHours
</pre>

Der Speicher enthält sämtliche Prognosewerte der kommenden Stunden beginnend mit der aktuellen Stunde.

<pre>
get ... radiationApiData
</pre>

Abhängig von der ausgewählten Strahlungsdaten API enthält dieser Speicher die von der API gelieferten Rohdaten sowie evtl. weitere für die Funktion benötigte Daten wie API-Keys, Response Messages, Anzahl der API Abruf und weitere.

<pre>
get ... valCurrent
</pre>

Diese Struktur wird nicht regelmäßig im Filesystem gespeichert und enthält immer aktuell gesammelte oder berechnete/gelieferte Daten wie z.B. die Autarkierate, letze Laufzeit der Zentralschleife (CentralTask), Zeit des Sonnenauf- und untergangs sowie weitere Betriebsdaten.

<pre>
get ... valConsumerMaster [XX]
</pre>

Zeigt die Daten der aktuell im SolarForecast Device registrierten Verbraucher. Mit der Nummer '''XX''' kann ein bestimmter Verbraucher angesprungen werden. Die Nummer korrespondiert mit dem entsprechenden '''consumerXX''' Attribut.
Neben anderen Betriebs- und Energiedaten werden insbesondere folgende Daten ermittelt, die für die zukünftige Planung der Verbraucherschaltzeiten relevant sind:

* epieces - prognostizierte Energiescheiben pro Betriebsstunde

Ausgehend von gespeicherten historischen Verbrauchsdaten des Verbrauchers wird der Energieverbrauch des Verbrauchers in seiner ersten Betriebsstunde prognostiziert, was insbesondere für die Planung der optimalen Startzeit des Verbrauchers in Bezug zu der prognostizierten PV Energie und den Verbrauchswerten weiterer vorhandener bzw. zu planender Verbraucher Berücksichtigung findet. Weitere Informationen zur Verbrauchersteuerung in diesem [[#Verbrauchersteuerung_-_Registrieren_und_visualisieren_von_Verbrauchern|Abschnitt]].

=== Schnittstelle für Modulautoren bzw. eigenen Code ===

Die im vorherigen Artikel beschriebenen internen Datenstrukturen können durch externen Code abgefragt und ausgewertet werden.
Dazu stehen die folgenden Funktionen zur Verfügung.

::* [FHEM::SolarForecast::]BatteryVal ('<Name>', '<Bn>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... valBattery".

::* [FHEM::SolarForecast::]CurrentVal ('<Name>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... valCurrent".

::* [FHEM::SolarForecast::]InverterVal ('<Name>', '<Nr>', <Key>', <default>) <br> entspricht der Abfrage mit "get ... valInverter".

::* [FHEM::SolarForecast::]ProducerVal ('<Name>', '<Nr>', <Key>', <default>) <br> entspricht der Abfrage mit "get ... valProducer".

::* [FHEM::SolarForecast::]HistoryVal ('<Name>', '<Day>', '<HoD>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... pvHistory".

::* [FHEM::SolarForecast::]CircularVal ('<Name>', '<HoD>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... pvCircular".

::* [FHEM::SolarForecast::]NexthoursVal ('<Name>', <nhr>, '<Key>', <default>) <br> entspricht der Abfrage mit "get ... nextHours".

::* [FHEM::SolarForecast::]ConsumerVal ('<Name>', '<Nr>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... valConsumerMaster".

::* [FHEM::SolarForecast::]RadiationAPIVal ('<Name>', '<String>', '<DateTime>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... radiationApiData".

::* [FHEM::SolarForecast::]WeatherAPIVal ('<Name>', '<APIname>', '<TimeCode>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... weatherApiData".

::* [FHEM::SolarForecast::]StatusAPIVal ('<Name>', '<APIname>', '<QTag>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... statusApiData".

::* [FHEM::SolarForecast::]StringVal ('<Name>', '<String>', '<Key>', <default>) <br> entspricht der Abfrage mit "get ... valStrings".

Die Angabe des Packages (FHEM::SolarForecast::) ist nur notwendig wenn die Funktionen von außerhalb des SolarForecast-Devices aufgerufen werden. Innerhalb des Devices (Code-Ausführung im Attribut ''ctrlUserExitFn'') kann darauf verzichtet werden.

Die Bedeutung der Platzhalter sind:

<pre>
<Name> - Name des SolarForecast Devices
<Day> - abzufragender Tag (01 - 31)
<Bn> - Batterie Nummer (01, 02, ...)
<DateTime> - Startzeit der Form YYYY-MM-DD hh:00:00
<TimeCode> - Zeitwert der Form fcX_XX (z.B. fc1_19)
<APIname> - Hauptname der API gemäß setupWeatherDev1 (z.B. OpenMeteo)
<String> - Name des PV-Modulstrings wie im Attribut 'setupInverterStrings'
<QTag> - Question Tag, z.B. '?All'
<Nr> - laufende Nummer des Verbrauchers / Gerätes (01, 02, 03, 04,...)
<HoD> - abzufragende Stunde (01 - 24, 99)
<nhr> - nächste Stunde (NextHour00, NextHour01,...)
<Key> - der abzufragende Schlüssel
<default> - def default-Rückgabewert
</pre>

<br>
==== Beispiel Auslesen der Batterieladestrategie und Anlegen eines Readings ====

Als Praxisbeispiel soll die aktuelle gesetzte Ladestrategie für Batterie "01" ausgelesen und mit dem Wert ein Reading im SolarForecast Device angelegt werden. <br>
Dazu wird der folgende Code im Attribut ''ctrlUserExitFn'' hinterlegt:

<syntaxhighlight lang="Perl">
{
my $wert = NexthoursVal ($name, 'NextHour00', 'strategybat01', 'loadRelease');
storeReading ('Ladestrategie', $wert);
}
</syntaxhighlight>

Bei jedem Zyklus des SF-Devices wird der aktuelle Wert von ''strategybat01'' gelesen und im Reading ''Ladestrategie'' gespeichert. Die Paket-Definition ''FHEM::SolarForecast::'' braucht nicht verwendet werden, da der Aufruf im Attribut ctrlUserExitFn innerhalb des SolarForecast-Paketes erfolgt.

Für andere Batterienummern ist der NexthoursVal-Schlüssel ''strategybat01'' entsprechend anzupassen.

<br>

=== Auswerten von internen Arrays ===

Die meisten der internen Datenstrukturen liefern bei der Abfrage einen einfachen String oder numerischen Wert der ausgewertet werden kann. Es gibt allerdings auch intern gespeicherte Wertelisten. Werden die Listenstrukturen mit den oben beschriebenen Befehlen abgefragt, wird eine Referenz auf die Liste geliefert sofern sie vorhanden ist.

Um auf die Werte einer solchen Liste zuzugreifen, ist am Beispiel des Arrays ''surplusslidereg'' aus dem Current-Speicher (get ... valCurrent) dargestellt:

<syntaxhighlight lang="Perl">
my $splref = CurrentVal ($name, 'surplusslidereg', '.');
my $spser = ref $splref eq 'ARRAY' ? join ' ', @{$splref} : undef;
</syntaxhighlight>

Die Variable $spser enthält bei Vorhandensein der Liste einen String, der die Listenelemente von 'surplusslidereg' durch Leerzeichen getrennt enthält.

<br>

== Backup und Wiederherstellung der Moduldaten ==
Neben der Datenhaltung in den Attributen und Readings des SolarForecast Devices, erzeugt jedes SolarForecast Device Dateien im Verzeichnis '''../fhem/FHEM/FhemUtils''' mit folgenden Inhalten:

<pre>
PVH_SolarForecast_<name> - PV History
PVC_SolarForecast_<name> - PV Circular
PVCfg_SolarForecast_<name> - PV Anlagenkonfiguration
PVCsm_SolarForecast_<name> - Consumer Status
ScApi_SolarForecast_<name> - Strahlungswerte aus verwendeter API
StatApi_SolarForecast_<name> - Statusdaten der verwendeten APIs
WeatherApi_SolarForecast_<name> - Wetterdaten der gewählten Wetter-API (außer DWD-Device)
AItra_SolarForecast_<name> - KI Entscheidungsquelle (trainierte Daten)
AIraw_SolarForecast_<name> - KI Input Daten = Raw Trainigsdaten
</pre>

Je nach Ausprägung und eingesetzten Features des SolarForecast Devices sind alle oder nur ein Teil dieser Dateien vorhanden. Dabei ist '''<name>''' der Name des SolarForecast Devices.

Bei einem Filebackup des FHEM-Servers ist darauf zu achten, dass diese Dateien in dem Backup enthalten sind. Der Inhalt der Dateien ist nicht statisch, sondern kann sich dynamisch aktualisieren. Um im Bedarfsfall einen aktuellen Datenstand zu haben, ist mindestens ein tägliches Backup dieser Dateien empfehlenswert. Eventuell auch öfter mit Hilfe einer Versionierung welche z.B. immer die letzten drei Versionen aufbewahrt.

Beim Start von FHEM werden bestimmte Dateien automatisch gelesen und in das SolarForecast Device importiert.
Der Vorgang ist mit verbose=3 im Log protokolliert:

<pre>
2023.10.02 09:57:07.967 3: SolCast6 - cached data "pvHistory" restored
2023.10.02 09:57:07.969 3: SolCast6 - cached data "pvCircular" restored
2023.10.02 09:57:07.970 3: SolCast6 - cached data "consumerMaster" restored
2023.10.02 09:57:07.970 3: SolCast6 - cached data "radiationApiData" restored
2023.10.02 09:57:07.970 3: SolCast6 - cached data "statusApiData" restored
2023.10.02 09:57:07.970 3: SolCast6 - cached data "weatherApiData" restored
2023.10.02 09:57:07.974 3: SolCast6 - cached data "aiTrainedData" restored
2023.10.02 09:57:07.976 3: SolCast6 - cached data "aiRawData" restored
</pre>

Bestimmte Betriebsdaten, wie z.B. die witterungsabhängigen Korrekturfaktoren (circular) oder die KI-Daten (aitrained/airaw), bauen sich über die Zeit immer granularer auf und stellen einen wertvollen Datenbestand dar.

Wird das SolarForecast Device gelöscht und anschließend wieder neu mit dem gleichen Namen definiert, können die bisher verfügbaren Daten sehr einfach wiederhergestellt werden:

* 1. definieren des neuen SolarForecast Devices, d.h. ein einfaches "define <Name> SolarForecast", und sichern der FHEM Konfiguration (der Konfigurationsdialog muß nicht durchgeführt werden)
* 2. FHEM stoppen
* 3. wiederherstellen der oben beschriebenen Dateien aus einem Backup in das Verzeichnis ../fhem/FHEM/FhemUtils (Überschreiben evtl. vorhandener Dateien)
* 4. Anpassen der Dateieigentümer und Berechtigungen: chown fhem:dialout /opt/fhem/FHEM/FhemUtils/*, chmod 774 /opt/fhem/FHEM/FhemUtils/*
* 5. starten von FHEM (bestimmte Daten werden automatisch importiert)
* 6. mit dem Befehl "set <name> plantConfiguration restore" die Anlagenkonfiguration wiederherstellen
* 7. FHEM Konfiguration sichern und restarten

<br>
'''Hinweis:''' <br>
Das zuvor beschriebene Verfahren kann auch angewendet werden um das SolarForcast Device von einer FHEM Installation in eine andere Installation umzuziehen. In diesem Fall ist aber besonders darauf zu achten, vorab alle in den SF-Attributen referenzierten Devices wie Inverter, Meter oder DWD-Devices mit den zutreffenden Namen in der neuen Installation anzulegen.

<br>
Soll das neue SolarForecast Device mit einem anderen Namen oder weitere SolarForecast Devices erstellt werden, welche die Betriebsdaten des primären Devices verwenden sollen, ist wie folgt vorzugehen:

* 1. definieren des neuen SolarForecast Devices, d.h. ein einfaches "define <Name> SolarForecast", und sichern der FHEM Konfiguration (der Konfigurationsdialog muß nicht durchgeführt werden)
* 2. FHEM stoppen
* 3. wiederherstellen der oben beschriebenen Dateien aus einem Backup in das Verzeichnis ../fhem/FHEM/FhemUtils (Überschreiben evtl. vorhandener Dateien)
* 4. umbenenen der Dateien, wobei <name> durch den Namen des neuen SolarForecast Devices ersetzt wird
* 5. Anpassen der Dateieigentümer und Berechtigungen: chown fhem:dialout /opt/fhem/FHEM/FhemUtils/*, chmod 774 /opt/fhem/FHEM/FhemUtils/*
* 6. starten von FHEM (bestimmte Daten werden automatisch importiert)
* 7. mit dem Befehl "set <name> plantConfiguration restore" die Anlagenkonfiguration wiederherstellen
* 8. FHEM Konfiguration sichern und restarten

Wenn sich die SolarForecast Devices hinsichtlich ihres Models oder der integrierten Consumer unterscheiden, sind die Dateien "PVCsm_SolarForecast_<name> " , "ScApi_SolarForecast_<name>" von dem Verfahren auszuschließen.

== Batterieintegration und -steuerung ==

=== Wie eine Batterie eingebunden wird ===
Wie immer muß die Batterieanlage zunächst mit einem für die Batterie spezifischen FHEM-Device in FHEM definiert sein.
In diesem Device werden Readings erwartet die folgende Werte bereitstellen:

::* ein Reading welches die aktuelle Batterieladeleistung liefert

::* ein Reading welches die aktuelle Batterieentladeleistung liefert

::* ein Reading welches die installierte Batteriekapazität liefert ('''Hinweis:''' dieser Schlüssel ist für die Aktivierung des Batterie SOC-Managements und die grafische Anzeige des SOC wesentlich!)

::* ein Reading welches die bis dato vorliegende Lade-Energiemenge als fortlaufenden Zähler liefert (optional)

::* ein Reading welches die bis dato vorliegende Entlade-Energiemenge als fortlaufenden Zähler liefert (optional)

::* Reading welches den aktuellen Ladezustand (SOC in Prozent) liefert (optional)

Die Batterie, bzw. das Batteriedevice wird mit dem Attribut '''setupBatteryDev''' im SolarForecast Device registriert. Die Syntax des Attributes ist in der Online-Hilfe zum Attribut umfassend erläutert.
Auch wenn manche Readings optional sind, wird empfohlen alle Werte bereitzustellen um alle Batterie-Funktionen im Modul nutzen zu können. Durch die Weiterentwicklung des Moduls können optionale Readings später auch obligatorisch werden.

==== Visualisierung der Batterie in der Balkengrafik ====

Das Attribut '''setupBatteryDevXX''' verfügt über den Schlüssel '''show''', mit dem die Einblendung des bzw. der Batteriesymbole in den Ebenen der Balkengrafik gesteuert werden kann:
[[Datei:Screenshot 2025-02-23 192002.png|right|thumb|400px|Einblendung der Batterieleiste und Darstellung des Batterie-SoC als Balkencontent in der zweiten Ebene]]

* 0 - keine Anzeige des Gerätes (default)
* 1 - Anzeige des Gerätes in der Balkengrafik Ebene 1
* 2 - Anzeige des Gerätes in der Balkengrafik Ebene 2

Die Symbole und die Farbgebung der Batterie(n) können mittels des Schlüssels '''icon''' verändert werden. Die Online-Hilfe gibt weitere Informationen zur Ausgestaltung.

In der Batteriedarstellung wird das Symbol der aktuellen Stunde hervorgehoben. Ein Mouse-Over zeigt wesentliche Betriebszustände der Batterie. Die Batteriesymbole vergangener Stunden zeigen mit einem Mouse-Over die erreichten SoC (State of Charge) Stände. Die kommenden Stunden visualisieren die folgenden Prognosen:

* der prognostizierte SoC unter Berücksichtigung der PV-Prognose und der [[#Aktivierung_des_Batterie_SOC-Managements|Batteriesteuerung]] sofern sie im Modul aktiviert ist.
* eine Freigabe bzw. Empfehlung der Batterieladung zur [[#Unterstützung_eines_netzdienlichen_Verhaltens|Unterstützung eines netzdienlichen Verhaltens]]

Neben der Einblendung der Batterieleiste über der Balkengrafik selbst können bestimmte Batteriekennwerte als Balkeninhalt dargestellt werden. Die Auswahl erfolgt über das Attribut '''graphicBeamXContent'''.

=== Aktivierung des Batterie SOC- und Lade-Managements ===
Das integrierte SOC- und Lade-Management verfolgt insbesondere diese Ziele:

* den Ladezustand der Batterie(n) zu optmimieren, was besonders in den Monaten mit geringerer PV-Erzeugung einen wertvollen Beitrag zur Erhöhung der Autarkierate und Batteriepflege leisten kann

* eine PV-Prognose und Verbrauch optimierte Beladungssteuerung, die in den Monaten mit hoher PV-Erzeugung hilft eine evtl. Abregelung der Anlage zu verhindern, die Batterie ausgewogen über den Tag zu laden und ein netzdienliches Verhalten zu unterstützen

Diese Aspekte der Batteriesteuerung werden in den folgenden Abschnitten beschrieben. Sind mehrere Batterien installiert, kann die Steuerung getrennt für jede einzelne Batterie aktiviert und eingestellt werden. Dabei ist zu beachten, dass vom Modul nur Signale und Readings bereitgestellt werden, die durch eine entsprechende Routine ausgewertet werden können um spezifische Befehle zur Umsetzung der Steuerung an das Batteriesystem zu senden.

Für eine Aktivierung des Managements muß zunächst das Batterie-Device wie im vorigen Abschnitt im SolarForecast Device registriert werden.
Das Attribut '''ctrlBatSocManagementXX''' aktiviert die im Modul integrierte SOC- und Lade-Management Routine:

attr <Device> ctrlBatSocManagementXX lowSoc=<Wert> upSoC=<Wert> [maxSoC=<Wert>] [careCycle=<Wert>] [loadAbort=<SoC1>:<MinPwr>:<SoC2>] [safetyMargin=<Wert>[:<Wert>]] ...

Die einzelnen Schlüssel werden der Kalkulationsroutine als Steuerungsparameter übergeben und bedeuten:

;lowSoc:unterer Mindest-SoC, die Batterie wird nicht tiefer als dieser Wert entladen (muß > 0 sein). Dieser Wert kann zum Beispiel dazu dienen, stets eine Mindestenergiemenge für den Fall eines Stromausfalls im öffentlichen Netz in den Batterien vorzuhalten.

;upSoC:oberer Mindest-SoC, Der übliche Wert des optimalen SoC bewegt sich in Perioden mit hohen PV-Überschuß tendenziell zwischen 'lowSoC' und 'upSoC', in Perioden mit geringer PV-Ausbeute bzw. geringem PV Energieüberschuß bewegt sich der optimale SoC tendenziell zwischen 'upSoC' und 'maxSoC'. Die Einstellung von upSoC=50 für ein ausgewogenes Verhalten kann als guter Startwert dienen.

;maxSoC:maximaler Mindest-SoC, d.h. der SoC Wert der mindestens im Abstand von 'careCycle' Tagen erreicht werden muß um den Ladungsausgleich im Speicherverbund auszuführen. Die Angabe ist optional (muß <= 100 sein, default: 95)

;stepSoC: Optionale Schrittweite zur optimalen SoC-Berechnung (Battery_OptimumTargetSoC_XX) in %. Mit der Angabe 'stepSoC=0' wird das SoC-Management deaktiviert und Battery_OptimumTargetSoC_XX auf den Wert 'lowSoC' gesetzt. '''Hinweis:''' Die Beziehung 'careCycle * stepSoC = 100' sollte eingehalten werden! Wert: 0..5, default: 5

;careCycle:maximaler Abstand in Tagen, der zwischen zwei Ladungszuständen von mindestens 'maxSoC' auftreten sollte. Anders formuliert legt careCycle fest, alle wieviel Tage mindestens einmal maxSoC erreicht werden sollte. Die Angabe ist optional. (default: 20)

;lcSlot: Es wird ein tägliches Zeitfenster festgelegt, in dem die Ladesteuerung des Moduls für diese Batterie aktiv sein soll. Außerhalb des Zeitfensters wird die Batterieladung mit voller Leistung freigegeben. Das SoC-Management der Batterie ist davon nicht betroffen. Wert: <hh:mm>-<hh:mm>, default: ganztägig

;loadAbort: definiert eine vom Anwender gewünnschte Bedingung für einen generellen Ladeabbruch und Wiederfreigabe der Lademöglichkeit. Die Abbruchbedingung ist erfüllt, wenn der angegebene SoC1 (%) erreicht bzw. überschritten ist '''UND''' die angegebene Ladeleistung <MinPwr> (W) unterschritten wurde -> Reading Battery_ChargeAbort_XX=1. Fällt der aktuelle SoC wieder unter den SoC2, wird Battery_ChargeAbort_XX=0 gesetzt. Ist SoC2 nicht angegeben, gilt SoC2=SoC1.

;loadStrategy: Abhängig von der gewählten Ladestrategie wird die Prognose der Batterieladung und ggf. die Generierung der Steuerreadings beeinflusst. Die Angabe ist optional. Wert: loadRelease | optPower | smartPower, default=loadRelease

;loadTarget: Optionaler Ziel-SoC in % für die Berechnung der Ladefreigabe bzw. der optimalen Ladeleistung. Der Zielwert ist eine kalkulatorische Rechengröße. Der reale SoC kann situativ in Grenzen über- oder unterschritten werden. Der höhere Wert aus Reading Battery_OptimumTargetSoC_XX und 'loadTarget' hat für die Berechnung Vorrang. Wert: 0..100, default=100. <br> In loadTarget kann eine Zielzeit angegeben werden, wann der Ziel-SoC erreicht werden soll. Die optimale Ladeleistung wird entsprechend angepasst. Die Zeitangabe als positive Ganzzahl ist ein Absolutwert (Stunde), in der der Ziel-SoC erreicht sein soll. Ein negativer Integer (z.B. -3) besagt, dass drei Stunden vor dem [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Bestimmung_von_Sonnenaufgang_und_Sonnenuntergang|Sonnenuntergang]] des aktuellen Tages der Ziel-SoC erreicht sein soll. D.h. negative Zahlen sind Relativangaben. Generell wird der Ziel-SoC zur Wunschzeit nur dann erreicht sein, wenn genügend PV-Leistung verfügbar ist.

;safetyMargin: Bei der Berechnung der Ladefreigabe und optimierten Ladeleistung werden Sicherheitszuschläge auf den prognostizierten Ladungsbedarf berücksichtigt. Abweichend vom Default können mit diesem Parameter individuelle Sicherheitszuschläge getrennt für die Berechnung der Ladefreigabe und optimierten Ladeleistung angegeben werden. Der erste Wert ist der Zuschlag bei der Berechnung der Ladefreigabe, der zweite Wert der Zuschlag bei der Berechnung der optimierten Ladeleistung. Beide Angaben sind Prozentwerte von 0..100.

;weightOwnUse: Optionale Gewichtung der stündlichen Verbrauchsprognose als zusätzlich verwendbaren Anteil zur Batterieladung in %. Technisch wird der verfügbare PV-Überschuß zur Berechnung der optimierten Ladeleistung erhöht indem der kalkulierte Verbrauch um den angegebenen Prozentsatz gesenkt wird. Wert: 0..100 default: 0

Alle SoC-Werte sind ganze Zahlen in %. Dabei gilt:

lowSoc < upSoC < maxSoC

==== Erläuterung der Batterie-Steuerungsreadings ====

Für die Steuerung des Batteriesystems gibt es im SolarForecast einen Satz an Readings, die unterschiedliche Zustände signalisieren und für entsprechende Steuerungsaufgaben bezüglich der Batteriesysteme eingesetzt werden können. In den nachfolgenden Abschnitten werden diese Zusammenhänge noch dataillierter beschrieben.

;Hinweis: SolarForecast stellt lediglich Steuerungsinformationen zur Verfügung. Die Umsetzung des Eingriffs in das Batteriesystem erfolgt durch den Anwender selbst über entsprechende Skripte. In den thematischen Abschnitten werden Beispiele für solche Steuerungsskripte vorgestellt.

Alle erstellten Readings gelten für ein Batteriesystem, es können mehrere Batteriesysteme in SolarForecast integriert sein. Die Endung ''XX'' der Readings beschreibt die Nummer des Batteriesystems und korrespondiert mit der Endung des entsprechenden Attributes ''ctrlBatSocManagementXX'' bzw. ''setupBatteryDevXX''.

;Battery_OptimumTargetSoC_XX: Mit den im Attribut ''ctrlBatSocManagementXX'' hinterlegten Parametern unter Berücksichtigung von PV- und Verbrauchsprognosen wird ein optimaler SOC-Wert errechnet. Dieser Wert dient zur Einstellung des unteren SOC des Batteriesystems.

;Battery_ChargeRequest_XX: Dieses Reading signalisiert mit 1 eine Anforderung zur Zwangsladung der Batterie um die Batterie vor Schäden zu schützen (wenn der SOC unter ctrlBatSocManagementXX->lowSoc gefallen ist) oder wenn der aktuelle SOC unter den berechneten Mindest-SOC gefallen ist.

;Battery_ChargeUnrestricted_XX: Dieses Reading kann den Wert '''0''' oder '''1''' einnehmen. Ist der Wert 0, sollte die Batterie nur geladen werden, wenn der im Attribut ''plantControl->feedinPowerLimit'' definierte Wert überschritten wird. Ist der Wert 1, sollte die Batterie mit der vollen zur Verfügung stehenden Ladeleistung angesteuert werden, um wie prognostiziert am Ende des Sonnentages die volle bzw. maximal mögliche Ladung zu erhalten. Der Fokus der Steuerung mit diesem Reading ist es, die Speicherkapazität der Batterie optimal zur Verhinderung der Überschreitung von Einspeiselimits einzusetzen und dennoch einen maximal möglichen SoC am Tagesende zu erreichen. (siehe das beschriebene [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#PV-Prognose_und_Verbrauch_optimierte_Beladungssteuerung_unter_Berücksichtigung_einer_Wirkleistungsbegrenzung|Nutzungsbeispiel]])

;Battery_ChargeOptTargetPower_XX: Dieses Reading enthält einen Richtwert für die optimierte Ladeleistung für jede Batterie. Die Aufladung wird prognosegeführt über den gesamten Tag verteilt, wobei der Fokus auf eine kontinuierliche, aber möglichst niederige Ladeleistung gelegt wird. (siehe diesen [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#leistungsoptimierte_Beladungssteuerung_mit_dem_Fokus_geringe_Verlustleistung_und_Verschleiß|Abschnitt]])

;Battery_ChargeAbort_XX: Im Attribut ''ctrlBatSocManagementXX'' kann mit dem Schlüssel ''loadAbort'' eine Bedingung definiert werden, bei deren Eintritt die Ladung der Batterie abgebrochen werden soll. In diesem Fall wird ''Battery_ChargeAbort_XX=1'' gesetzt. Mit einem entsprechenden Befehl kann der Anwender das Batteriesystem anweisen den Ladevorgang abzubrechen.

;Battery_TargetAchievable_XX: Diese Reading enthält einen Boolean Wert 0|1 und signalisiert ob der im Attribut '''ctrlBatSocManagementXX->loadTarget''' gesetzte Ziel-SoC lt. Prognose am aktuellen Tag tatsächlich erreicht werden kann.

<br>

==== Nutzung des Batterie SOC-Management ====

Oftmals wird durch die Anlagenhersteller ein hoher statischer SOC eingestellt bzw. empfohlen, der eine längere Verharrungszeit auf einem tiefen SOC-Wert verhindern soll. Allerdings wechseln sich in auch in den Herbst-, Frühlings- und Wintermonaten Zeiten mit wenig PV-Erzeugung mit Phasen stärkerer Solarstrahlung bei klarem Himmel und Sonnenschein ab.

Ein statischer SOC würde dazu führen, dass in den erwähnten Phasen zuviel Energie in das öffentliche Netz eingespeist wird. Dies soll verhindert werden da die wertvolle Energie besser im eigenen Netz gespeichert und in Dunkelphasen verwendet werden kann. Andererseits soll die Batterie nicht zu lange auf einem tiefen SOC verbleiben und außerdem in gewissen Abständen auf einen so hohen SOC geladen werden der den internen Zellausgleich ermöglicht.

Die SOC Kalkulationsroutine des Moduls errechnet unter Berücksichtigung des prognostizierten PV-Ertrages der kommenden Tage, des aktuellen SOC und der im Attribut '''ctrlBatSocManagementXX''' (nachfolgend beschrieben) angegebenen Steuerparameter den Vorschlag für eine optimale SOC-Einstellung. Dabei steht 'XX' für die Nummer der Batterie, welche mit dem Attribut setupBatteryDevXX korrespondiert.

Durch das Modul selbst findet keine Steuerung der Batterie statt. Es stellt entsprechende Readings zur Verfügung:

::* das Reading '''Battery_OptimumTargetSoC_XX''' enthält den vom Modul berechneten optimalen SoC.

::* das Reading '''Battery_ChargeRequest_XX''' wird auf '1' gesetzt, wenn der aktuelle SoC unter den optimalen SoC gefallen ist. In diesem Fall sollte die Batterie, unter Umständen mit Netzstrom, zwangsgeladen werden.

Die Readings können zur Steuerung des SoC (State of Charge) sowie zur Steuerung des verwendeten Ladestroms der Batterie verwendet werden.

Die Ermittlung des optimalen SOC erfolgt nach folgender Logik:

# Ausgehend von 'lowSoc' wird der Mindest-SoC kurz vor Sonnenuntergang um 5% inkrementiert sofern am laufenden Tag 'maxSoC' nicht erreicht wurde und die PV-Prognose keinen hinreichenden Ertrag des kommenden Tages vorhersagt. <br><br>
# Wird 'maxSoC' (wieder) erreicht, wird Mindest-SoC um 5%, aber nicht tiefer als 'lowSoc', verringert. Ist der berechnete Mindest-SoC größer als 'upSoc', wird der Mindest-SoC auf 'upSoc' gesetzt. <br><br>
# Mindest-SoC wird soweit verringert, dass die prognostizierte PV Energie des aktuellen bzw. des folgenden Tages von der Batterie aufgenommen werden kann. Mindest-SoC wird typisch auf 'upSoc' und nicht tiefer als 'lowSoc' verringert. <br><br>
# Das Modul erfasst den letzten Zeitpunkt am 'maxSoC'-Level, um eine Ladung auf 'maxSoC' mindestens alle 'careCycle' Tage zu realisieren. Zu diesem Zweck wird der optimierte SoC in Abhängigkeit der Resttage bis zum nächsten 'careCycle' Zeitpunkt derart verändert, dass durch eine tägliche 5% SoC-Steigerung 'maxSoC' am 'careCycle' Zeitpunkt rechnerisch erreicht wird. Wird zwischenzeitlich 'maxSoC' erreicht, beginnt der 'careCycle' Zeitraum erneut. <br><br>
# Im fünften Schritt werden die Grenzen 'lowSoc' und 'upSoc' berücksichtigt. <br><br>
# Im letzten Schritt erfolgt Generierung des Readings '''Battery_ChargeRequest_XX''' zur Signalisierung einer eventuell empfohlenen Zwangsladung auf den berechneten Min-SoC.

Bei sehr wenig Erzeugungungsprognose, d.h. wenn sich der berechnete Min-SoC oberhalb von 'upSoC' bewegt, wird 'upSoC' eingestellt. Liegt der berechnete Min-SoC unterhalb von 'upSoC', ist jedoch größer als 'lowSoC', wird der berechnete SOC im Reading '''Battery_OptimumTargetSoC_XX''' eingestellt. Somit eignet sich die Angabe im Schlüssel 'upSoC' um in Zeiten geringer Solarenergieerzeugung die Batterie für eine Notstromerzeugung auf mindestens diesem Wert zu halten. Sollte die PV-Prognose kurzfristig einen größeren Ertrag vorhersagen als die Batterie durch die Einhaltung von 'upSoC' aufnehmen kann, wird der Min-SoC unter 'upSoC' abgesenkt um möglichst allen PV-Überschuß in der Batterie zu speichern und somit dem Eigenverbrauch zuzuführen.

Der berechnete Mindest-SoC ist immer nur ein unterer Grenzwert. Die Batterie kann durch Ladevorgänge natürlich jederzeit einen höheren als den im Reading '''Battery_OptimumTargetSoC_XX''' dargestellten optimalen SoC haben. Der optimale SoC sollte nicht unterschritten werden um die oben genannten Zusammenhänge abbilden zu können.

<br>

===== Die dynamische SOC Steuerung mit Umsetzungsbeispiel =====
Das Modul bietet eine Unterstützung zur automatisierten Einstellung eines optimalen SoC Wertes.

Ziel ist es, den Minimum SoC in Abhängigkeit der zu erwartenden Solarerträge des aktuellen und des folgenden Tages so einzustellen, dass der prognostizierte Solarertrag von der Batterie aufgenommen werden kann. Die Einspeisung in das öffentliche Netz soll minimiert werden.

Weiterhin soll ein unterer SoC nicht unterschritten, sowie ein oberer Minimum SoC im Normalfall nicht überschritten werden. Der obere Grenzwert stellt sicher, dass die Batterie mindestens bis zu diesem Wert wieder entladen werden kann. Dadurch bleibt innerhalb der Batterie immer genügend Kapazität verfügbar um unvorhergesehene PV Energie aufnehmen zu können.

Aktiviert wird die Unterstützung der Batteriesteuerung durch das Setzen des Attributes '''ctrlBatSocManagementXX''' z.B. mit diesen Angaben:

ctrlBatSocManagementXX lowSoc=x upSoC=x maxSoC=x careCycle=x

so zum Beispiel:

ctrlBatSocManagement01 lowSoc=10 upSoC=50 maxSoC=98 careCycle=20

Dabei steht 'XX' für die Nummer der Batterie, welche mit dem Attribut setupBatteryDevXX korrespondiert.
Ist dieses Attribut gesetzt, werden Steuerungs-Readings erstellt, die der Nutzer auswerten und seine Batterieanlage z.B. via notify oder DOIF steuern kann. <bR>
Das Reading '''Battery_OptimumTargetSoC_XX''' enthält den vom Modul berechneten optimalen Mindest-SoC.
Das Reading '''Battery_ChargeRequest_XX''' wird auf '1' gesetzt, wenn der aktuelle SOC unter den optimalen SOC bzw. minimalen SOC gefallen ist.

Die Schlüssel '''lowSoc''' und '''upSoC''' sind die unteren und oberen Grenzen, zwischen denen sich der Minimum SoC im normalen Betrieb bewegen soll.
Der Schlüssel '''maxSoC''' stellt eine Ladungsgrenze dar, die mindestens alle X (careCycle) Tage erreicht werden soll. Zu diesem Zweck errechnet das Modul die Anzahl der nötigen Erhöhungen der Minimum Batterieladung von 5% pro Tag um ausgehend vom aktuellen SoC-Level. Der resultierende Minimum SoC Wert wird entsprechend angepasst. Wurde der einstellte maxSoC Level erreicht, startet der Wartungszyklus (careCycle) erneut. <br>
Der maxSoC in Verbindung mit dem durch '''careCycle''' definierten Zyklus soll sicherstellen, dass der Batterieverbund in regelmäßigen Abständen einen Ladungsausgleich vollziehen kann.

Durch die Modullogik erfolgt eine 5 protentige Anhebung des Minimum SoC wenn am Vortag maxSoC nicht erreicht wurde. Die Anhebung erfolgt aber nicht über upSoC. upSoC ist die obere Grenze des Minimum SoC. Wird am Vortag mindestens die maxSoC Ladung erreicht, verringert sich der Minimum SoC wieder schrittweise um 5%, aber nicht tiefer als lowSoc.

Ergänzt wird die Logik noch um die PV Vorhersage. Dabei wird die obige Minimum SoC Berechnung um die Erwartung der PV Erwartung am aktuellen und folgenden Tag korrigiert. Das bedeutet, dass der Minimum SoC z.B. von heute 50% auf 10% abgesenkt und dadurch die gespeicherte Energie dem Haushalt zugeführt wird, wenn am heutigen oder kommenden Tag eine entsprechende PV Energie zu erwarten ist um die Batterie wieder vollständig zu zuladen.
Dadurch ist immer genügend "Freiplatz" in der Batterie und andererseits hat die Batterie in langen Dunkelphasen eine Reserve für einen eventuellen Stromausfall (falls der abgesichert werden soll) und wird vor einem dauerhaften tiefen SoC geschützt.

<br>
===== Umsetzungsbeispiel =====

Wie das Reading '''Battery_OptimumTargetSoC_XX''' genutzt werden kann, wird am Beispiel einer Victron Batterieanlage gezeigt. Die Anlage wird durch Cerbo GX Gerät gesteuert. Der Cerbo GX ist per MQTT2 in FHEM eingebunden. Umgesetzt ist die Steuerung der Batterie '01', d.h. die Angabe 'XX' ist durch '01' ersetzt.

Die folgende kleine Logik ist in einem '''99_mySolarForecastUtils.pm''' File eingebaut und wird regelmäßig mit

batSocChargeMgmnt ('<Name SolarForecast Device>');

aufgerufen. Der Aufruf erfolgt durch Angabe der Routine im Attribut '''ctrlUserExitFn''' des SolarForecast Devices:

<pre>
{
# Hinweis: die Zeichen '::' vor der Routine sind durch das SolarForecast Package bedingt
::batSocChargeMgmnt ($name);
return;
}
</pre>

Die Routine wird dadurch automatisch am Ende jedes Zyklus (siehe Attribut plantControl->cycleInterval) ausgeführt.
Um die SOC Managementfunktion nach Bedarf ein- bzw. ausschalten zu können wird zunächst im SolarForecast Device ein userattr zur Steuerung der SOC-Logik angelegt:

attr <Device> userattr userFn_BatterySoCManagement:ein,aus

Die Perl Routine '''batSocChargeMgmnt''' ist wie folgt aufgebaut:

<syntaxhighlight lang="Perl">
###############################################################################
#
# Save this file as 99_mySolarForecastUtils.pm, and create your own functions
# in the new file. They are then available in every Perl expression.
#
###############################################################################
package main;
use strict;
use warnings;

sub
mySolarForecastUtils_Initialize($$)
{
my ($hash) = @_;
}

# ab hier eigenen Code eintragen
###############################################################################

############################################################################
# Batterie SOC und Max. Ladestrom Management
############################################################################
sub batSocChargeMgmnt {
my $name = shift;
my $bn = '01'; # Batterienummer (evtl. im Aufruf mitgeben)
my $hash = $defs{$name};

my $vebus = 'MQTT2_cerboGX_c0619ab34e08_vebus'; # Victron Vebus Device
my $vicsets = 'MQTT2_cerboGX_c0619ab34e08_settings'; # Victron Einstellungen

my $maxcspc = 105; # max. Ladestrom (A) für Victron MPII Verbund
my $preduce = FHEM::SolarForecast::BatteryVal ($name, $bn, 'bpinreduced', $maxcspc); # reduzierte Ladeleistung aus Bat-Konfig (W)
my $actmcc = ReadingsNum ($vicsets, 'MaxChargeCurrent', undef); # akt. Ladestromeinstellung
my $load = $actmcc // $maxcspc; # Soll-Ladestrom (A)

## Battery SoC Management
###########################
my $ubsm = AttrVal ($name, 'userFn_BatterySoCManagement', 'aus');

if ($ubsm eq 'ein') {
my $bcrq = ReadingsNum ($name, 'Battery_ChargeRequest_'.$bn, 0);
my $csoc = ReadingsNum ($vicsets, 'MinimumSocLimit', 10); # akt. SoC
my $osoc = ReadingsNum ($name, 'Battery_OptimumTargetSoC_'.$bn, 10); # Soll-SoC
my $surp = ReadingsNum ($name, 'Current_Surplus', 0); # aktueller PV-Überschuß

if ($csoc != $osoc) {
CommandSet (undef, "$vicsets MinimumSocLimit $osoc");
Log3 ($name, 3, qq{$name - userFn SoCMgmnt -> MinimumSocLimit in $vicsets set to $osoc %});
}

if ($bcrq && $surp < 1000) { # max. Ladestrom (A) b. Battery_ChargeRequest
$load = $preduce / 48; # bei 48V Batteriesystem
}
else {
$load = $maxcspc;
}
}

## Einstellung MPII Verbund MaxChargeCurrent
##############################################
if ($actmcc && $load != $actmcc) {
CommandSet (undef, "$vicsets MaxChargeCurrent $load");

Log3 ($name, 3, qq{$name - userFn ChargeMgmnt -> MaxChargeCurrent in $vicsets set }.
qq{from old $actmcc A to $load A});
}

readingsSingleUpdate ($hash, 'userFn_MPII_MaxChargeCurrent_set', $load, 0);

return;
}

###############################################################################
# Ende eigener Code

1;
</syntaxhighlight>

Ist im SolarForecast Device das Reading '''Battery_ChargeRequest_01''' gesetzt, ist der aktuelle SOC kleiner als der optimale SOC und die Batterie wird (eventuell aus dem öffentlichen Netz) geladen. Das kann automatisch durch den Cerbo GX bzw. in anderen Anlagen durch einen entsprechenden Befehl erfolgen.
Damit die Netzbeladung nicht mit der vollen Ladestromstärke geschieht, wird der Ladestrom auf den gewünschten Wert (hier 21 A -> ca. 1000 W bei einem 48V System) reduziert sofern kein oder zu wenig PV-Überschuß vorhanden ist.

<br>

==== weitere mögliche Aspekte der SOC- und Batterieladesteuerung ====

SolarForecast liefert durch seine internen Logiken bereits sehr hilfreiche Signale zur Steuerung von Batteriesystemen in Form von Readings an. Abhängig von den individuellen Möglichkeiten der vorhandenen Anlage käme zum Beispiel zusätzlich zu einer Steurung des optimalen SOC oder der Zeitfenster für die Batterieaufladung auch eine Steuerung des Ladestroms bzw. der verwendeten Ladeleistung in Betracht.

'''Hintergründe:'''

* Das Laden eines Akkus mit möglichst gleichbleibender und geringer Leistung wirkt sich positiv auf dessen Langlebigkeit aus, was u.a. auch daran liegt, dass der Temperaturstreß im Akku bei langsamer Energiezuführung nur gering ist.

* Ein geringer Ladestrom führt zu einem geringen Absacken der Akkuspannung beim (ggf, temporären) Abschalten des Ladestroms, was sich positiv auf die SOC-Schätzung auswirkt.

* Ein geringer Ladestrom führt, insb. bei Nutzung passiver Balancer (sind in den Akku-Systemen üblicherweise verbaut), zu einer geringen Differenz zwischen den einzelnen Zellspannungen und damit zu einer besseren Kapazitätsausnutzung eins Akkus.

* Ein geringer Ladestrom kann zu einem zeitlich punktgenauen Zielfüllstand (im Winter 100%, ansonsten natürlich weniger) am Ende des Tages führen.

* Eine geringer Ladestrom führt auch zu geringen Leitungsverlusten, da der Strom quadratisch zu den Leitungsverlusten beiträgt.

Weiterhin kann auch die Verweildauer oder die Begrenzung des SOC, auf den die Batterie maximal geladen werden soll, Gegenstand von Optimierungen sein.

Die häufig zu findende Empfehlung, Akkus nicht zu lange bei einem SOC von 100% verweilen zu lassen, liegt weniger an dem SOC als solchem, sondern daran, dass ''SOC=100%'' üblicherweise dadurch ermittelt wird, dass eine Zelle im Akku einen Spannungsschwellenwert überschreitet, der – würde dieser Schwellenwert zeitlich länger überschritten sein – zu einer Schädigung des Akkus führen könnte. Schädlich sind insbesondere häufige Nachladevorgänge bei Werten um die 100% SOC, da Zellen dann ja häufiger und damit - integral gesehen - auch länger den o.g. Schwellenwert überschreiten.

Einige Akku-Hersteller, z.B. BYD, haben auf o.g, Grund in der (neueren) Firmware Ihrer Systeme einen SOC-Threshold (bei BYD liegt dieser bei 95%) eingebaut. Dieser Wert muss nach einem erreichten SOC von 100% unterschritten werden, bevor überhaupt eine weitere Ladung erfolgt. Insbesondere in der dunklen Jahreszeit kann es daher sinnvoll sein, den Akku unter Verwendung von PV-Leistung so zu füllen, dass dieser möglichst nur einmal vor Einbruch der Dunkelheit auf ''SOC=100%'' geladen wird. Hierbei sollte darauf geachtet werden, dass der Ladeschlussstrom des jeweiligen Systems nicht unterschritten wird.

SolarForecast unterstützt die oben betrachtete Batteriesteuerung durch die optionale Angabe von '''loadAbort''' im Attribut '''ctrlBatSocManagementXX'''. Das in diesem Kontext erstellte Reading '''Battery_ChargeAbort_XX''' stellt die auswertbaren Steuerungsinformationen zur Verfügung.

<br>

==== PV-Prognose und Verbrauch optimierte Beladungssteuerung unter Berücksichtigung einer Wirkleistungsbegrenzung ====

[[Datei:Screenshot 2025-04-25 143910.png|right|thumb|400px|Batterie Popup "nur laden wenn Einspeiselimit überschritten"]]

Die in diesem Abschnitt beschriebene Ladestrategie '''loadRelease''' wird im Modul als '''Ladefreigabe''' bezeichnet.

Üblicherweise wird die Batterie geladen. sobald PV-Überschuß vorhanden ist ohne eine Prognose zu berücksichtigen. Dadurch sind die Batterien im Sommer unter Umständen schon um 10-12 Uhr voll geladen und die Anlage liefert ihre mehr oder weniger volle Energie (je nach Ausrichtung) in das öffentliche Netz. Dann könnte es zu einer Begrenzung der PV-Leistung durch einen Schwellenwert (z.B. 70%-Regelung) oder eventuell Zwangsabregelung durch den Netzbetreiber kommen.

Hintergrund dieser Erweiterung ist das Bestreben, eine optimale Unterstützung bei der Maximierung des Eigenverbrauchs zu geben und einen Beitrag zur Netzstabilität zu leisten.
Das Ziel der Beladungssteuerung der Batterie ist es, die Ladung der Batterie über den Tag verteilt so zu steuern, dass die Batterie erst dann geladen wird, wenn durch den PV-Überschuß eine Netzeinspeisung erfolgen würde bzw. ein Grenzwert erreicht werden würde, der zu einer Abregelung der PV-Anlage führen könnte.
Es kann auch zu einer Zwangsabregelung durch den Netzbetreiber führen, was vermieden werden soll.

Die interne Kalkulationslogik erstellt zu diesem Zweck ein Reading '''Battery_ChargeUnrestricted_XX'''.
Dieses Reading gibt dem User ein Signal, ob zu der aktuellen Stunde der Ladevorgang der Batterie freigegeben (1) oder nicht freigegeben werden sollte (0). Die Freigabe zur Ladung bedeutet dass:

* '''Battery_ChargeUnrestricted_XX=1''' die Batterie mit ihrer vollen, oder der im Reading [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#leistungsoptimierte_Beladungssteuerung_mit_dem_Fokus_geringe_Verlustleistung_und_Verschleiß|Battery_ChargeOptTargetPower_XX]] angegebenen Ladeleistung angesteuert werden sollte um wie prognostiziert am Ende des Sonnentages die volle bzw. maximal mögliche Ladung zu erhalten..

* '''Battery_ChargeUnrestricted_XX=0''' die Batterie nur geladen werden sollte wenn der im Attribut plantControl->feedinPowerLimit definierte Wert überschritten wird

Ist keine Freigabe zur Ladung vorhanden, kann bzw. sollte dennoch eine Ladung der Batterie vorgenommen werden, sofern eine über dem im <br>
Attribut '''plantControl->feedinPowerLimit''' definierten Limit liegende Einspeiseleistung vorhanden ist. In diesem Status sollte die Batterie nur mit der Differenzleistung von vorhandener Einspeiseleistung und dem gesetzen Einspeiselimit geladen werden und damit das gesetzte Einspeiselimit einhalten ohne die Anlage abzuregeln. Ist die Batterie in einer Balkengrafikebene dargestellt, wird im Mouse-Over Popup die Battrie mit ''"nur laden wenn Einspeiselimit überschritten"'' gekennzeichnet.

Die Möglichkeiten der Batteriesteuerung sind stark von der individuellen Anlage abhängig und können hier nicht beschrieben werden. Ein Umsetzungsbeispiel mit einer Victron-Anlage mit Pylontech Batterie ist weiter unten dargestellt.

<br>
===== Aktivierung und Arbeitsweise =====

Die implementierte Logik zur optimierten Batterie Beladungssteuerung wird aktiviert, wenn folgende Kriterien erfüllt sind:

* der Schlüssel '''capacity''' in den setupInverterDevXX Atributen ist gesetzt
* das Attribut '''ctrlBatSocManagementXX''' für die jeweilige Batterie ist gesetzt
* der Schlüssel '''cap''' im Attribut setupBatteryDevXX der jeweiligen Batterie ist gesetzt

Die Logik arbeitet wie folgt:

;Der resultierende Schwellenwert der Wirkleistungsbegrenzung: der Gesamtanlage wird durch die Auswertung der in den Inverter-Attributen setupInverterDevXX gesetzen Schlüssel limit (optional) und capacity ermittelt. Inverter mit gesetztem Schlüssel feed = grid (deren Energie wird ausschließlich in das öffentlich Netz eingespeist) werden von der Betrachtung in diesem Kontext ausgeschlossen.

;Die benötigte Beladung bis zu maxSoC (im Attribut setupBatteryDevXX) : wird ermittelt und mit der zu erwartenden PV Tagesprognose in Beziehung gesetzt. Sofern die PV-Erzeugung abzgl. Verbrauch noch nicht das Wirkleistungbegrenzungs-Limit erreicht UND noch genügend PV-Überschuß für eine Ladung auf ''maxSoC'' im Laufe der kommenden Stunden des Tages zu erwarten ist, bleibt das Reading '''Battery_ChargeUnrestricted_XX = 0'''. Die erreichte Qualität der Steuerungslogik ist stark von der Prognosequaliät abhängig. Um die Steuerung resilienter zu gestalten, wird per default ein Sicherheitsaufschlag von 50% auf die prognostizierte benötigte Ladeenenergie auf Stundenbasis einkalkuliert. Dieser Wert kann mit dem Attribut '''ctrlBatSocManagementXX->safetyMargin''' individuell angepasst werden.

;Wird das Wirkleistungbegrenzungs-Limit erreicht/überschritten und/oder die PV-Überschußprognose: zzgl. eines Sicherheitspuffers unterschritten, wird '''Battery_ChargeUnrestricted_XX = 1''' gesetzt. Der User kann darauf reagieren und den Batterie Ladevorgang aktivieren. Die Möglichkeiten der Aktivierung sind natürlich von der installierten Anlage abhängig. Das SolarForecast Device greift nicht in die Batteriesteuerung direkt ein.

Anders ausgedrückt erfolgt immer dann eine Ladefreigabe, wenn einer der nachfolgenden Sachverhalte ''wahr'' ist:

- die benötigte Ladeenergie (aller installierten Batterien) >= PV-Restüberschuß des Tages (Reading RestOfDayPVforecast) zzgl. Sicherheitsaufschlag

ODER

- der Zeitpunkt des PV-Erzeugungszenit des laufenden Tages überschritten ist (Reading Today_MaxPVforecastTime)

ODER

- wenn die aktuelle PV Leistung >= einer eventuellen Wechselrichter-Leistungsbegrenzung ist (Summe aller WR-Begrenzungen)

ODER

- wenn das BatSoc-Management _nicht_ aktiviert ist (nicht alle oben genannten Aktivierungskriterien erfüllt sind)

Sind mehrere Batterien installiert und durch das Management einer Batterie die Einhaltung der genannten Kriterien bzw. Sachverhalte erwirkt wird, bleiben die weiteren Batterien im Modus Ladefreigabe (Battery_ChargeUnrestricted_XX=1).

<br>

===== Umsetzungsbeispiel Batterie Ladesteuerung mit Victron GX Venus über den Grid Setpoint =====

Ziel der Steuerung ist es abhängig vom Wert des Readings Battery_ChargeUnrestricted_XX (z.B. Battery_ChargeUnrestricted_01) die Ladung des angeschlossenen Batteriesystems zu aktivieren bzw. zu deaktivieren.
Das vorliegende Beispiel soll umzusetzen:

* Battery_ChargeUnrestricted_01 = 0 -> Batterie nicht aufladen bzw. nur laden wenn Einspeiselimit überschritten (Attribut plantControl->feedinPowerLimit)
* Battery_ChargeUnrestricted_01 = 1 -> Batterie aufladen

Der Grid Setpoint ist ein Parameter in den Victron Systemeinstellungen. Das Victron System wird den eingestellten Grid Setpoint versuchen einzuhalten und bei einem positiven Wert Energie aus dem Netz beziehen bzw. bei einem negativen Grid Setpoint Energie in das Netz einspeisen.

Normalerweise wird das Victron System die erzeugte PV Energie zunächst zur Deckung des Hausverbrauchs verwenden, ist dann noch ein PV Überschuß vorhanden, die Batterien aufladen und bei weiter vohandenen PV Überschuß diese Energie in das öffentliche Netz einspeisen sofern dem System eine Einspeisung erlaubt ist. Anderenfalls werden die Wechselrichter oder MPPT Smartloader heruntergeregelt bzw. limitiert.

In der Standardeinstellung ist beim Victron System ein Grid Setpoint von ca. 20 bis 50 Watt, d.h. das System strebt danach diese Vorgabe zu erfüllen zieht ständig Energie in diesem Bereich aus dem öffentlich Netz von einem gelegentlichen Überschwingen der Regelung abgesehen. Damit ein eventueller PV Überschuß nicht zum Laden der Batterie verwendet, sondern statt dessen in das öffentliche Netz eingespeist wird, muß der Grid Setpoint um diesen Betrag abgesenkt werden.

[[Datei:Screenshot 2025-02-24 114403.png|right|thumb|400px|Integration des Grid Setpoint-Managements in den Own_Spec-Bereich]]

Damit man später per Attribut bzw. über den [[#Formatierung_der_Inhalte_im_Bereich_"Graphic_Header_Own_Specification"|Own_Spec-Bereich]] die automatische Ladesteuerung über den Grid Setpoint ein- bzw. ausschalten kann, legen wir ein userattr an:

userattr <Name> userFn_GridSetpointManagement:ein,aus

Weiterhin sind einige Vorbereitungen im Device MQTT2_cerboGX_c0619ab34e08_settings vorzunehmen. Dieses Device ist im vorliegenden Beispiel ein in FHEM vorhandenes MQTT2_DEVICE, über das die Victron CerboGX Einstellungen zugreifbar sowie einstellbar sind. Die Vorgehensweise zur Erstellung des MQTT2_DEVICE ist hier nicht beschrieben und wird vorausgesetzt.

Damit ein entsprechender Set-Befehl zur Einstellung des Grid Setpoints vorhanden ist, werden folgende Attribute gesetzt:

attr MQTT2_cerboGX_c0619ab34e08_settings jsonMap Settings_CGwacs_AcPowerSetPoint_value:GridSetpoint
attr MQTT2_cerboGX_c0619ab34e08_settings setList GridSetpoint W/c0619ab34e08/settings/0/Settings/CGwacs/AcPowerSetPoint {"value":$EVTPART1}

Nach dieser Attributierung kann mit einem "''set MQTT2_cerboGX_c0619ab34e08_settings GridSetpoint <Wert>''" der Grid Setpoint eingestellt werden.

Das Attribut userFn_GridSetpointManagement kann nun im Perl Code ausgewertet werden um das Grid Setpoint-Management ein- bzw. auszuschalten.
Der nachfolgende Code wird in die Datei '''99_mySolarForecastUtils.pm''' eingefügt. Ist diese Datei nicht vorhanden, legen wir sie vorab als Kopie der ausgelieferten 99_myUtils.pm an.

<div class="mw-collapsible mw-collapsed">
'''Code Management Batterieladung über Victron Grid Setpoint ->''' <div class="mw-collapsible-content">
<syntaxhighlight lang="Perl">
###############################################################################
#
# Save this file as 99_mySolarForecastUtils.pm, and create your own functions
# in the new file. They are then available in every Perl expression.
#
###############################################################################
package main;
use strict;
use warnings;

sub
mySolarForecastUtils_Initialize($$)
{
my ($hash) = @_;
}

# ab hier eigenen Code eintragen
###############################################################################

############################################################################
# Steuerung Start/Stop der Batterieladung über den Victron Grid Setpoint
############################################################################
sub gridSetpointMgmt {
my $name = shift;
my $hash = $defs{$name};

my $vicsets = 'MQTT2_cerboGX_c0619ab34e08_settings'; # Device Victron Einstellungen
my $gspdef = 20; # Default Einstellung des Grid Setpoint
my $targetgsp = $gspdef; # Voreinstellung Grid Setpoint
my $neggspmax = FHEM::SolarForecast::CurrentVal ($name, 'feedinPowerLimit', 5000); # max. gewünschte Einspeiseleistung in Watt
$neggspmax = $neggspmax * -1;
my $gspm = AttrVal ($name, 'userFn_GridSetpointManagement', 'aus'); # Freischaltung des Grid Setpoint-Managements
my $curgsp = ReadingsNum ($vicsets, 'GridSetpoint', $gspdef); # aktuelle Einstellung Grid Setpoint

if ($gspm eq 'ein') {
my $bcrq = ReadingsNum ($name, 'Battery_ChargeUnrestricted_01', 0); # Ladefreigabe (1 -> Bat Ladefreigabe)
my $surp = ReadingsNum ($name, 'Current_Surplus', 0); # aktueller PV-Überschuß

if (!$bcrq) { # Grid Setpoint absenken wenn keine ..
$targetgsp = $gspdef - $surp; # ..Batterie Ladefreigabe
$targetgsp = $neggspmax if($targetgsp < $neggspmax); # Begrenzung der Einspeiseleistung
}
}

if ($curgsp != $targetgsp) {
fhem ("set $vicsets GridSetpoint $targetgsp");
Log3 ($name, 3, qq{$name - userFn gridSetpointMgmt -> GridSetpoint in $vicsets set to $targetgsp});
}

readingsSingleUpdate ($hash, 'userFn_Victron_GridSetpoint_set', $targetgsp, 0);

return;
}

###############################################################################
# Ende eigener Code

1;
</syntaxhighlight>
</div>
</div>

Der Vergleich des Setpoints mit der Vorgabe von ''$neggspmax'' dient dazu die maximale Einspeiseleistung in das öffentliche Netz zu begrenzen. Ist diese Grenze erreicht, wird der noch verbleibende Überschuß in die Batterie geladen. Dadurch wird eine Abregelung der Anlage vermieden wenn der Schwellenwert ''$neggspmax''erreicht ist sofern die Batterie aufnahmefähig ist und nicht voll geladen ist.

Damit die Routine mit jedem Zyklus im Modul ausgeführt wird, legen wir sie im Attribut '''ctrlUserExitFn''' an:

<pre>
attr <Name> ctrlUserExitFn {
::gridSetpointMgmt ($name);
}
</pre>

Zum Management des automatischen Grid Setpoint und der Anzeige des eingestellten Wertes wird das Attribut und die Readinganzeige in den Own_Spec-Bereich eingebunden, z.B.:

<pre>
attr <Name> graphicHeaderOwnspec #Settings
SetPoint Management:userFn_GridSetpointManagement
Grid Setpoint:GridSetpoint@MQTT2_cerboGX_c0619ab34e08_settings
</pre>

<br>

==== leistungsoptimierte Beladungssteuerung mit dem Fokus geringe Verlustleistung und Verschleiß ====

Über das Attribut ctrlBatSocManagementXX kann mit dem Schlüssel loadStrategy die Ladestrategie '''optPower''' oder '''smartPower''' eingestellt werden.
Das SF-Modul bietet ein weiteres Reading '''Battery_ChargeOptTargetPower_XX''' zur Batteriesteuerung an. Dieses Reading liefert eine kalkulierte optimale Ladeleistung in Watt.

Die in diesem Abschnitt beschriebene Ladestrategie '''optPower''' wird im Modul als '''optimierte Ladeleistung''', die Ladestrategie '''smartPower''' als '''zieloptimierte Ladeleistung''' bezeichnet.

Beide Strategien kalkulieren die Ladeleistung kontinuierlich neu und berücksichtigen dabei:

* die Prognose der PV-Erzeugung der nächsten Stunden und des (Rest-)Tages
* den prognostizierten Verbrauch auf Stunden- bzw. Tagesbasis
* eine eventuell mögliche Überschreitung des gesetzten Einspeiselimits (plantControl->feedinPowerLimit)
* die gesetzten Leistungsparameter der Batterie
* das Ziel, am Tagesende einen möglichst maximalen SoC der Batterie erreicht zu haben bzw. den eingestellten Ziel-SoC '''loadTarget'''
* die Effizienz der Batterieanlage (Einstellung '''setupBatteryDevXX->efficiency''')

Der Fokus der implementierten Logik liegt dabei auf einer kontinuierlichen Ladeleistung, die aber unter den oben genannten Gesichtspunkten möglichst (relativ) gering sein soll um den Batterieverschleiß und die Verlustleistung zu minimieren. Die im Reading angezeigte Ladeleistung kann mit geeigneten Mitteln direkt in die Leistungssteuerung der Batterie eingebracht werden. Natürlich kann die Leistung auch vorab in einen optimalen Ladestrom umgerechnet werden.

Da das Ergebnis der Kalkulation stark von den Prognosen abhängt, ist zur Erhöhung der Resilienz per Default ein Sicherheitszuschlag von 20% eingebaut. Dieser Wert kann mit dem Attribut '''ctrlBatSocManagementXX->safetyMargin''' individuell angepasst werden.

Ist kein PV-Überschuß (mehr) vorhanden / prognostiziert oder das Ladeziel erreicht, erfolgt ein Rückfall der Ladeleistung im Reading Battery_ChargeOptTargetPower_XX auf den im Attribut '''setupBatteryDevXX->pinmax''' angegebenen Wert. Ist dieser Wert nicht gesetzt, erfolgt der Rückfall auf "Unendlich" (9223372036854775807).

Im Reading Battery_ChargeOptTargetPower_XX wird der Wert des Parameters '''setupBatteryDevXX->pinreduced''' gesetzt, wenn weniger Ladeleistung als pinreduced berechnet wurde (Einhaltung einer Mindestladeleistung) oder wenn der SoC der Batterie <= [[#Aktivierung_des_Batterie_SOC-_und_Lade-Managements|lowSoC]] beträgt.
Somit wird die Batterie bei einer Anforderungsladung bei Unterschreitung von lowSoC mit nur wenig Leistung aus dem Grid geladen falls es nötig sein sollte.
Es ist demzufolge ratsam den optionalen Parameter '''setupBatteryDevXX->pinreduced''' zu setzen, da ansonsten ebenfalls ein Rückfall auf '''setupBatteryDevXX->pinmax''' bzw. "Unendlich" erfolgt.

Beide Strategien, optPower und smartPower, setzen die zuvor beschriebene Arbeitsweise um.
Ergänzend wird bei der Ladestrategie '''smartPower''' die generelle Erreichbarkeit des Ladeziels bei der Festlegung der Ladeleistung berücksichtigt. Es führt dazu dass:

* die Ladeleistung im Reading Battery_ChargeOptTargetPower_XX auf einen tendenziell höheren Wert als bei der optPower-Strategie gesetzt wird, wenn/solange das eingestellte Ladeziel als unerreichbar kalkuliert wird
* bei kalkulierter Erreichbarkeit des Ladeziels der Sicherheitsaufschlag linear absenkend proportional zum Kehrwert des verfügbaren PV-Überschusses auf die Ladeleistung angewendet wird

Der nächste Abschnitt erläutert die smartPower Funktionen etwas eingehender.

<br>
===== smartPower - die zieloptimierte Ladeleistung =====
Die hinter smartPower liegende Anpassungslogik wird nachfolgend etwas näher beschrieben.
Ausgangspunkt ist das Ergbnis einer Ratio-Funktion aus dem (Rest)Tages-PV-Überschuß und benötigter Energie zur Erlangung des Batterie Ladeziels.

'''Lineare Interpolation zwischen pinmax und abgesicherter minpower''' <br>

'''Variablen'''

* '''P''': resultierende Leistung.
* '''pinmax''': maximale Ladeleistung.
* '''limpower''': Leistungslimit, d.h. Ladeleistungssollwert.
* '''r''': Verhältnis in Prozent (r = spday·100 / whneed).
* '''otpMargin''': Prozentwert der Bandbreite, über die die Absenkung linear verläuft (die Steilheit kann mit dem Attributwert ctrlBatSocManagementXX->safetyMargin im Device eingestellt werden).

Die Kennlinie der für smartPower eingesetzten Funktion ist stückweise definiert über das Verhältnis Ratio ''𝑟 = spday x 100 / <benötigte Ladeenergie bis Ziel>''.

* Für 𝑟 ≤ 100: ''𝑃 = pinmax'', Interpretation: Es ist viel Bedarf vorhanden bzw. Überschuss ≤ 100 % des Bedarfs → maximal laden.
* Für 𝑟 ≥ 100 + otpMargin: ''𝑃 = limpower ⋅ (1 + otpMargin / 100 )''
* Für 100 < 𝑟 < 100 + otpMargin: lineare Absenkung von '''P''' mit zunehmendem '''r''' für den Bereich 100 < 𝑟 < 100 + otpMargin. '''P''' wird bei 𝑟 = 100 gleich '''pinmax''' und bei 𝑟 = 100 + otpMargin gleich ''limpower ⋅ ( 1 + otpMargin/100 )'', Interpretation: Sobald der Überschuss über den Bedarf hinausgeht (ratio > 100), wird das Ladeleistungslimit schrittweise von pinmax Richtung limpower reduziert; die Reduktion erfolgt gleichmäßig über die Margin-Spanne.

'''Lineare Interpolation und Steigung'''

Die Differenz ''(pinmax − limpower)'' wird gleichmäßig auf die otpMargin-Prozentpunkte verteilt. Die Steigung der Geraden ist

<pre>
slope = − (pinmax − limpower) / otpMargin
</pre>

das heißt die Leistung sinkt um diesen Betrag pro Prozentpunkt von '''r'''.

Nach Umformung ist der Zusammenhang wie folgt darstellbar:

<pre>
𝑃 = pinmax − ( pinmax − limpower) ⋅ ((𝑟 − 100) / otpMargin)
</pre>

und ist äquivalent zu

<pre>
𝑃 = pinmax + ( 𝑟 − 100 ) ⋅ slope
</pre>

'''Numerisches Beispiel'''

* '''limpower''' = 1000 W, '''pinmax''' = 3000 W, '''otpMargin''' = 20
* Unterschied = 2000 W, Steigung = −2000/20 = −100 W/%
* Für '''r = 105''': 𝑃 = 3000 − 2000 ⋅ ( 5 / 20 ) = 3000 − 500 = 2500 W
* Für '''r = 120''' ergibt die Formel den abgesicherten Endwert 1200 W

Die Formel sorgt dafür, dass die Zielleistung stufenlos und vorhersehbar reduziert wird, wenn der relative Rest-Überschuss des Tages über 100% steigt, und erreicht bei Ende der otpMargin den geplanten abgesicherten Wert.

[[Datei:Ratio Kennlinie.png|right|thumb|200px|abfallend proportionale Anpassungsfunktion]]

In einem grafischen Diagramm stellt sich die abfallend proportionale Anpassungsfunktion der resultierenden Soll-Ladeleistung wie nebenstehend abgebildet dar. Dabei entspricht pow=100 dem jeweiligen pinmax Wert (hier 3000 W). So ist auch pow=0 mit dem abgesicherten Endwert (hier 1200 W) gleichzusetzen. Die Linie verläuft waagerecht bei pinmax solange das das Ratio r ≤ 100 % und knickt an r == 100 mit steigenden r nach unten. Es verringert sich pow linear von pinmax zu limpower zzgl. otpMargin.

Durch diese Maßnahmen wird eine flexible Lademöglichkeit bis pinmax erreicht, die sich bei unvorhergesehenen Aufklarungen mit starker Sonneneintrahlung bei ansonsten sehr bedeckten Himmel positiv auswirkt. Andererseits wird die Erhöhung der Ladeleistung weiter begrenzt, wenn viel PV-Überschuß in Verbindung mit einer generellen Erreichbarkeit des Ladeziels zum Ende des Tages prognostiziert ist. Man könnte die Ladestrategie '''smartPower''' in ihrer Wirkung als einen Mix aus '''optPower''' und '''loadRelease''' ansehen.

Zusammenfassend ist optPower vorwiegend für die Nutzergruppe geeignet, die eine tendenziell sparsamere Ladeleistung bevorzugen und dafür bereit sind eventuelle "Verluste" in Form von Einspeisung zu akzeptieren. <br>
Demgegenüber eignet sich das aggressivere smartPower für Anwender, die bei niedrigen PV-Erträgen bewusst das Maximum an Batterieladung anstreben und dafür in Kauf nehmen, dass Ladeleistungen weniger knapp kalkuliert sind.

<br>

===== Unterstützung des Modus "Eigennutzung" bei Hybrid-Wechselrichtern =====
Viele Hybrid-Wechselrichter verteilen die zur Verfügung stehende PV-Leistung nach folgendem Prioritäten, wenn der (übliche) Modus "Eigennutzung" aktiviert ist:

# Nutzung der Leistung zur Deckung des Hausverbrauchs,
# Nutzung der Leistung zur Ladung des bzw. der angeschlossenen Speicher.
# Einspeisung der Leistung in das öffentliche Netz.

Da in aller Regel die Leistung, mit der ein angeschlossener Speicher geladen wird, limitiert werden kann, lassen sich die o.g. Priorität bzgl. des Speichers zugunsten einer Überschusseinspeisung aufweichen. Ein entstehender "Überschuss" steht also ggf. nur deshalb zur Verfügung, weil die Ladeleistung des Speichers begrenzt wurde.

Ab Version 1.58.6 bietet SolarForecat die Möglichkeit, prognostizierte Verbräuche nicht mehr komplett bei der Bestimmung der ''optimalen Ladeleistung'' zu berücksichtigen, sondern nur noch zu einem prozentualen Anteil von 0..100 %. Hierzu muss der Attribut-Schlüssel '''ctrlBatSocManagementXX->weightOwnUse=<Percentage>''' entsprechend gesetzt werden.

So führt beispielsweise weightOwnUse=100 dazu, dass bei der Berechnung der optimalen Ladeleistung prognostizierte Verbräuche nicht mehr berücksichtigt werden indem sie bei der Bestimmung des stündlichen PV-Überschusses unberücksichtigt bleiben. Eine derartige Einstellung kann z.B. sinnvoll sein, wenn alle ansonsten täglich laufende Verbraucher zugunsten einer Batterieladung ausgeschaltet werden können.

Ein Wert von zum Beispiel weightOwnUse=30 lässt 30% der stündlichen Verbrauchslast unberücksichtigt, sodass sich der kalkulierte PV-Überschuß pro Stunde um 30% des prognostizierten Verbrauchs erhöht. Da die Berechnung der optimierten Ladeleistung mit dem zur Verfügung stehenden PV-Überschuß gewichtet erfolgt, würde sich die kalkulierte Ladeleistung in den meisten Fällen ebenfalls um einen gewissen Betrag erhöhen sofern andere Faktoren dies nicht verhindern. Das kann beispielweise der Fall sein, wenn die kalkulierte Ladeleistung zu gering ist und automatisch aif mindestens '''setupBatteryDevXX->pinreduced''' angehoben wurde.

<br>

==== Welche Ladestrategie soll ich wählen? - eine Möglichkeit zur Best-Practice Findung mit Codebeispiel ====

In den vorangegangenen Abschnitten wurden die verschiedenen Möglichkeiten zur Steuerung der Batterieladung und dem SoC vorgestellt. Diese Steuerungsvarianten optimieren die Arbeitweise der Batterie, haben aber jeweils einen eigenen Fokus auch wenn es gewisse Überschneidungen gibt.

Die Steuerungsvarianten lassen sich folgendermaßen klassifizieren:

# Steuerung der Batterieladung über eine Ladefreigabe, die durch bestimmte Indikatoren festgelegt wird. Diese Variante ist in [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#PV-Prognose_und_Verbrauch_optimierte_Beladungssteuerung_unter_Berücksichtigung_einer_Wirkleistungsbegrenzung|diesem]] Abschnitt beschrieben.
# Steuerung der Batterieladung durch eine optimierte maximale Ladeleistung. Diese Variante ist in [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#leistungsoptimierte_Beladungssteuerung_mit_dem_Fokus_geringe_Verlustleistung_und_Verschleiß|diesem]] Abschnitt dargelegt. Zu dieser Variante gehören die Strategien ''optPower'' sowie ''smartPower''. Die Unterschiede beider Strategien sind ebenfalls in dem verlinkten Abschnitt beschrieben.

Die '''Variante 1.)''' gibt die Ladung der Batterie frei wenn der (verbleibende) PV-Überschuß des Tages kleiner oder gleich dem Ladungsbedarf der Batterie ist um einen SoC von 100% bzw. den maximal möglichen SoC am Ende des Tages zu erreichen. Dadurch wird die in der Batterie vorhandene freie Kapazität so lange wie möglich der Einhaltung von besonderen Grenzwerten, z.B. des Einspeiselimits (plantControl->feedinPowerLimit), vorbehalten. Nebeneffekt ist, dass plötzlich und unerwartet auftretende hohe Erzeugungsleistungen in die Batterie geladen werden können und nicht unerwünscht in das öffentliche Netz eingespeist werden.

Die '''Variante 2.)''' lässt die Batterie kontinuierlich laden, wobei die Ladeleistung auf ein optimiertes Minimum reduziert wird ohne das Ziel, einen maximalen SoC am Tagesende zu erreichen, zu ignorieren. Dadurch wird die Batterie schonend, mit möglichst wenig Verlustleistung und verschleißarm geladen. Die Vorhaltung der freien Kapaziäten der Batterie sind in dieser Variante nicht die Prämisse. Die Einhaltung des gesetzten Enispeiselimits wird auch in dieser Variante beachtet sofern es der Ladezustand der Batterie zulässt. Technisch bedingt kann diese Variante nur ungenügend auf unerwartete PV-Überschüsse reagieren, was zu einer Einspeisung in das öffentliche Netz oder im ungünstigsten Fall zur Abregelung der Anlage führen kann. Mit dem Attribut '''ctrlBatSocManagementXX->safetyMargin''' kann man diesem negativen Aspekt in gewissem Maße entgegenwirken.

Ausgehend von diesen unterschiedlichen Optimierungszielen bietet sich die Variante 1.) vorwiegend in den Übergangs- und Wintermonaten an. Durch die beschriebenen Eigenschaften dieser Variante ist bei tendeziell weniger PV-Überschuß über den Tag die Ladung der Batterie komplett freigegeben, wodurch bei plötzlich auftretenden sonnige Abschnitten und Aufklarungen die Batterie sofort mit dem verfügbaren PV-Überschuß geladen wird. Auch eine Einspeisung über das Einspeiselimit hinaus kann verhindert werden. In der übrigen Zeit wird die Ladeleistung durch den verfügbaren PV-Überschuß begrenzt.
Weiterhin soll der SoC nicht dauerhaft tief absinken und ebenfalls nicht auf einem zu hohen Level verharren was auch einer maximal möglichen Energiespeicherung an sonnigen Tagen entgegenwirken würde.
In dieser Zeit ist die Nutzung der Kombination von [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Nutzung_des_Batterie_SOC-Management|SoC-Management]] und Variante 1.) wohl am Besten geeignet um die Ziele zu verwirklichen sowie Notreserven in den Batterien vorzuhalten.

In den Sommermonaten hingegen ist üblicherweise sehr viel PV-Energie und Überschuß vorhanden. In dieser Periode würden die Batterien mit sehr hoher Leistung sehr zeitig am Tag vollgeladen. Die Variante 1.) ist im Prinzip ebenfalls gut geeignet den Zeitpunkt der Vollladung hinauszuzögern, jedoch erscheint die Varinte 2.) in dieser Zeit besser geeignet mit einer über den gesamten Tag verteilten moderaten Ladeleistung den Ziel-SoC zu erreichen. Auch diese Variante versucht eine Überschreitung des Einspeiselimits zu verhindern sofern der Ladezustand der Batterie dies ermöglicht.

Das nachfolgende Codebeispiel bietet die Möglichkeit über ein Attribut die Ladevariante auszuwählen, über ein weiteres Attribut die SoC-Steuerung zu aktivieren/deaktivieren und integriert auch die Ladesteuerung für eine Batterie-Anforderungsladung bei Unterschreitung von ctrlBatSocManagementXX->lowSoc.

Die gesteuerte Batterieanlage besteht aus:

* 3 x Victron MultiPlusII 3000/48
* Steuergerät CerboGX (in FHEM über MQTT eingebunden)
* einem Batteriestack bestehend aus Pylontech US3000C (wird durch CerboxGX gesteuert)

Zur Umschaltung bzw. Auswahl der Ladestrategie und des SoC-Managements werden zwei User-Attribute im SolarForecast Device angelegt.

<pre>
attr ... userattr userFn_BatterySoCManagement:Ein,Aus userFn_BatteryLoadManagement:Aus,loadRelease,optPower,smartPower
</pre>

Im Code werden diese Attribute ausgewertet. Das nachfolgende Script vereint folgende Funktionalitäten:

* die Aktivierung/Deaktivierung des SoC-Managements via Attribut userFn_BatterySoCManagement
* die Auswahl der Ladestrategie oder Deaktivierung der Ladesteuerung via attribut userFn_BatteryLoadManagement
* Integration einer Anforderungsladung bei Signalisierung durch Reading Battery_ChargeRequest_XX
* Generierung von Readings userFn_Victron_GridSetpoint_set und userFn_MPII_MaxChargeCurrent_set zur Dokumentation der eingestellten Soll-Werte

Bei der Nachnutzung des Scripts sind zunächst die '''Konstanten''' und das Device '''MQTT2_cerboGX_c0619ab34e08_setting'''s sowie dessen Readings im Block '''aktuelle Indikatoren''' anzupassen.

Das Script wird in die Datei '''99_mySolarForecastUtils.pm''' eingetragen und im SolarForecast Attribut '''ctrlUserExitFn''' hinterlegt:

<pre>
attr ... ctrlUserExitFn {
::batLoadMgmnt ($name, '01');
# ::batLoadMgmnt ($name, '02'); # optional für eine weitere Batterie '02'
# ::batLoadMgmnt ($name, '0X'); # optional für weitere Batterien
}
</pre>

Mit diesem Script ist der Nutzer in der Lage, das Batterie Lademanagement entsprechend seiner Motivation und gegebenenfalls abhängig von der Jahreszeit umzustellen und das Ergebnis bzw. die Zielerreichung zu testen.

Das Attribut '''userFn_BatteryLoadManagement''' selektiert die gewünschte Ladestrategie:

;Aus: das Lademangement ist ausgeschaltet

;loadRelease: das Lademangement Variante 1.) Ladestrategie Ladefreigabe ist aktiviert

;optPower: das Lademangement Variante 2.) Ladestrategie optimierte Ladeleistung ist aktiviert

;smartPower: das Lademangement Variante 2.) Ladestrategie zieloptimierte Ladeleistung ist aktiviert

Die selektierte Ladestrategie wird im Script in das SolarForecast Device repliziert, d.h. der Attributschlüssel ctrlBatSocManagement01->loadStrategy wird identisch zum Wert des Attributes userFn_BatteryLoadManagement gesetzt. Dazu wird das Set-Kommando ''attrKeyVal'' verwendet. Das globale Attribut ''autosave'' sollte aus diesem Grund NICHT explizit auf "0" gesetzt sein um eine reibungslose Funktion zu ermöglichen.

Hat man die individuell passende Management-Strategie gefunden, bietet sich auch eine automatische (zum Beispiel durch einen Kalender oder Sonnenstand (Elevation) zur Mittagszeit) Umschaltung der Ladestrategie an. Die Unterschreitung der Elevation unter einen bestimmten Wert würde den Beginn des Winterhalbjahres und reverse Überschreitung den Beginn des Sommerhalbjahres kennzeichnen. Entsprechend würde dann die gewünschte Ladestrategie selektiert. Alternativ könnte auch die PV-Überschußprognose für den aktuellen Tag über das Reading ''Today_PVforecast'' für eine Entscheidung bzgl. der Ladestrategie herangezogen werden.

Das SoC-Management kann über das gesamte Jahr aktiviert bleiben, hat jedoch nach bisherigen Erfahrungen nur im Winterhalbjahr eine starke Relevanz.

<div class="mw-collapsible mw-collapsed">
'''Code Lademanagement ->''' <div class="mw-collapsible-content">
<syntaxhighlight lang="perl">
###############################################################################
#
# Save this file as 99_mySolarForecastUtils.pm, and create your own functions
# in the new file. They are then available in every Perl expression.
#
###############################################################################
package main;
use strict;
use warnings;

sub
mySolarForecastUtils_Initialize($$)
{
my ($hash) = @_;
}

# ab hier eigenen Code eintragen
###############################################################################

############################################################################
# Komplettes Batterie Lademanagement
############################################################################
sub batLoadMgmnt {
my $name = shift;
my $bn = shift // '01'; # Batterienummer
my $hash = $defs{$name};

## Konstanten
###############
use constant {
GSPDEF => 20, # Einstellung des Grid Setpoint
FINDEF => 5000, # Default Einspeiselimit
MINSOCDEF => 10, # Default Minimum SoC
MAXPLDEF => 105, # max. Ladestrom (A) Victron MPII
SYSVOLTAG => 48, # Batterie Systemspannung
};

my $batsocmgmt = AttrVal ($name, 'userFn_BatterySoCManagement', 'Aus'); # SoC-Management Vorgabe
my $batloadmgmt = AttrVal ($name, 'userFn_BatteryLoadManagement', 'Aus'); # Lademanagement Vorgabe
my $vicsets = 'MQTT2_cerboGX_c0619ab34e08_settings'; # Victron CerboGX Einstellungen

## Ladestrategie Ist-Einstellung und Soll-Abgleich
####################################################
my $cgbt = AttrVal ($name, 'ctrlBatSocManagement'.$bn, undef);
my $strategy = 'loadRelease';

if ($cgbt) {
my $parsed = FHEM::SolarForecast::__parseAttrBatSoc ($name, $cgbt); # aktuell gesetzte Strategie ermitteln
$strategy = $parsed->{loadStrategy} // $strategy;
}

if ($batloadmgmt ne 'Aus' && $strategy ne $batloadmgmt) {
CommandSet (undef, "$name attrKeyVal ctrlBatSocManagement${bn} loadStrategy=$batloadmgmt");
}

## aktuelle Indikatoren
##########################
my $surp = ReadingsNum ($name, 'Current_Surplus', 0); # aktueller PV-Überschuß
my $bcrq = ReadingsNum ($name, 'Battery_ChargeRequest_'.$bn, 0); # Notfallladung
my $curgsp = ReadingsNum ($vicsets, 'GridSetpoint', GSPDEF); # aktuelle Einstellung Grid Setpoint
my $finplim = FHEM::SolarForecast::CurrentVal ($name, 'feedinPowerLimit', FINDEF); # Limit plantControl->feedinPowerLimit
my $preduce = FHEM::SolarForecast::BatteryVal ($name, $bn, 'bpinreduced', MAXPLDEF); # reduzierte Ladeleistung Bat-Konfig
my $actmcc = ReadingsNum ($vicsets, 'MaxChargeCurrent', 0); # akt. maximale Ladestromeinstellung
my $actmcp = ReadingsNum ($vicsets, 'MaxChargePower', undef); # akt. Ladeleistungseinstellung
my $load = MAXPLDEF; # initialer Soll-Ladestrom (A)

my $targetgsp = GSPDEF; # Voreinstellung Grid Setpoint
my $ctype = 'default'; # Voreinstellung Steuerungstyp

## Battery SoC Management
###########################
if ($batsocmgmt eq 'Ein') {
my $csoc = ReadingsNum ($vicsets, 'MinimumSocLimit', MINSOCDEF); # akt. SoC
my $osoc = ReadingsNum ($name, 'Battery_OptimumTargetSoC_'.$bn, MINSOCDEF); # optimierter Mindest-SoC

if ($csoc != $osoc) {
CommandSet (undef, "$vicsets MinimumSocLimit $osoc");
Log3 ($name, 3, qq{$name - userFn SoCMgmnt -> MinimumSocLimit in $vicsets set to $osoc %});
}
}

## Steuerung nach Ladungsfreigabe
###################################
if ($batloadmgmt eq 'loadRelease') {
$ctype = 'loadRelease';
my $unrestrict = ReadingsNum ($name, 'Battery_ChargeUnrestricted_'.$bn, 0); # Ladefreigabe (1 -> Ladefreigabe)

if (!$unrestrict) { # Grid Setpoint absenken wenn keine ..
$targetgsp = GSPDEF - $surp; # ..Batterie Ladefreigabe
my $neggspmax = -1 * $finplim;
$targetgsp = $neggspmax if($targetgsp < $neggspmax); # Begrenzung der Einspeiseleistung
}
}

if ($curgsp != $targetgsp) { # GridSetpoint setzen
fhem ("set $vicsets GridSetpoint $targetgsp");
Log3 ($name, 3, qq{$name - userFn ChargeMgmnt 'loadRelease' -> GridSetpoint in $vicsets set to $targetgsp});
}

readingsSingleUpdate ($hash, 'userFn_Victron_GridSetpoint_set', $targetgsp, 0);

## Steuerung nach optimaler Ladeleistung
##########################################
if ($batloadmgmt =~ /(?:opt|smart)Power/xs) {
$ctype = 'optPower';
my $otp = ReadingsNum ($name, 'Battery_ChargeOptTargetPower_'.$bn, $preduce); # optimale Ladeleistung (W)
$load = sprintf "%.0f", ($otp / SYSVOLTAG);
}

## Anforderungsladung
#######################
if ($bcrq) { # max. Ladeleistung...
$ctype = 'requestCharging'; # bei Battery_ChargeRequest
my $p;

if ($surp < $preduce) {
$p = $preduce;
}
else {
$p = ReadingsNum ($name, 'Battery_ChargeOptTargetPower_'.$bn, $preduce); # optimale Ladeleistung (W)
}

$load = sprintf "%.0f", ($p / SYSVOLTAG);
}

## Stromeinstellung umsetzen
#############################
if ($load != $actmcc) {
CommandSet (undef, "$vicsets MaxChargeCurrent $load");

Log3 ($name, 3, qq{$name - userFn ChargeMgmnt '$ctype' -> MaxChargeCurrent in $vicsets set }.
qq{from old $actmcc A to $load A});
}

readingsSingleUpdate ($hash, 'userFn_MPII_MaxChargeCurrent_set', $load, 0);

return;
}

###############################################################################
# Ende eigener Code

1;
</syntaxhighlight>
</div>
</div>

<br>

==== barrierSoC - der Parameter den nicht jeder braucht ====

Wie bereits hinlänglich beschrieben, aktiviert das Attribut '''ctrlBatSocManagementXX''' mit diversen Schlüsseln die Batterie SoC- und Ladesteuerung. Für die alltägliche Nutzung und um schnell sichtbare Ergebnisse zu erzielen, ist die die Verwendung der obligatorischen Schlüssel lowSoc, upSoC und vielleicht noch die Auswahl der gewünschten Ladestrategie zunächst völlig ausreichend. Das Modul stellt für die Batteriesteuerung aber noch einige weitere Schlüssel zu Verfügung, die besondere Anforderungen an die Batteriesteuerung unterstützen. Einer dieser Parameter ist der '''barrierSoC''' Schlüssel.

Wird eine der beschriebenen Batterie Ladestrategien ''optPower'' oder ''smartPower'' eingesetzt, wird die Batterieladungsleistung vom aktuell vorhandenen SoC bis zum Ziel-SoC optmiert im Reading Battery_ChargeOptTargetPower_XX bereitgestellt. Dabei wird auch eine eventuell in ''ctrlBatSocManagementXX->loadTarget'' eingestellte Zielzeit berücksichtigt. Möglicherweise besteht der Wunsch die Batterieladung bis zu einem bestimmten Mindest-SoC so schnell wie möglich aufzuladen um z.B. zügig eine Netzausfallreserve aufzubauen.

Zu diesem Zweck kann der optionale Parameter ''ctrlBatSocManagementXX->barrierSoC'' verwendet werden. In dem Ladebereich

lowSoC <= SoC < barrierSoC

kann der User Einfluß auf die berechnete Ladeleistung nehmen und sie ggf. bis zur maximal möglichen Leistung abändern. Das bedeutet alle Manipulationen erfolgen ausschließlich diesem SoC-Bereich.
Dazu kann dem Parameter mit einer bestimmten Syntax das Änderungsverhalten vorgegeben werden:

<pre>
barrierSoC=XX:<Aktion>:<Wert> oder
barrierSoC=XX:<Aktion>:<Reading>:<default>
</pre>

Dabei bedeutet:

<pre>
XX - der Wert von barrierSoC in %. Es gilt lowSoC < XX < maxSoC
</pre>

Mit der '''<Aktion>''' wird eine der möglichen Manipulations-Varianten festgelegt:

;max: - das Ladeleistungslimit wird auf setupBatteryDevXX->pinmax festgelegt
;set: - das Ladeleistungslimit wird auf einen festen Wert oder Readingswert gesetzt
;inc: - das Ladeleistungslimit wird um einen festen Wert oder Readingswert erhöht
;dec: - das Ladeleistungslimit wird um einen festen Wert oder Readingswert verringert
;prc: - das Ladeleistungslimit wird um einen prozentualen Wert / Readingswert geändert

Diese Aktion (außer ''max'') wird auf den angegeben Wert bzw. den Wert des angegebenen Readings angewendet. Das Reading muß im SolarForecast Device enthalten sein. Bei Verwendung eines Readings wird mit ''<default>'' der Standardrückgabewert festgelegt falls das Reading keinen Wert liefert oder nicht vorhanden ist.

Hier sind einige Beispiele für einen barrierSoC. Zur Vereinfachung wird ein barrierSoC von 40 % verwendet und kann natürlich auf einen anderen passenden Wert abgeändert werden.

<pre>
barrierSoC=40:max:- -> das Ladeleistungslimit wird auf setupBatteryDevXX->pinmax gesetzt
barrierSoC=40:set:<Reading>:<default> -> das Ladeleistungslimit auf den Wert <Reading> setzen
barrierSoC=40:set:1350 -> das Ladeleistungslimit wird auf 1350 W gesetzt
barrierSoC=40:inc:<Reading>:<default> -> das Ladeleistungslimit um den Wert <Reading> erhöhen
barrierSoC=40:inc:200 -> das Ladeleistungslimit wird um 200 W erhöht
barrierSoC=40:dec:<Reading>:<default> -> das Ladeleistungslimit um den Wert <Reading> verringern
barrierSoC=40:dec:100 -> das Ladeleistungslimit wird um 100 W verringert
barrierSoC=40:prc:<Reading>:<default> -> das Ladeleistungslimit um <Reading> Prozent ändern (+ erhöhen, - verringern)
barrierSoC=40:prc:50 -> das Ladeleistungslimit um 50% ändern (+ erhöhen, - verringern)
</pre>

<br>

==== sequentielle Batterie-Ladung mehrerer Batterien mit lcSlot ====

Der Parameter '''ctrlBatSocManagementXX->lcSlot''' ("load control Slot") definiert eine Zeitperiode am aktuellen Tag in der die Steuerungslogik für die Batteriesteuerung aktiviert ist. Ist dieser Parameter nicht gesetzt, ist das eingestellte Lademanagement über den gesamten Tag aktiert und wäre identisch mit der Einstellung:

lcSlot=00:00-23:59

Somit ist die Ladesteuerung per default über den gesamten Tag aktiv.

Durch das Setzen von lcSlot auf einen täglichen Slot wird die Ladesteuerung auf diese Periode eingegrenzt. In der übrigen Zeit ist die Ladung der Batterie freigegeben (Reading Battery_ChargeUnrestricted_XX) bzw. auf die maximal konfigurierte Ladeleistung eingestellt (Reading Battery_ChargeOptTargetPower_XX). Diese Readings können je nach verwendeter Ladestrategie ausgewertet und zur Steuerung der Batterie(n) verwendet werden.
Die SoC-Steuerung wird durch die lcSlot-Angabe nicht beeinflusst.

Mit lcSlot kann zum Beispiel ein sequentielles Laden von mehreren Batterien umgesetzt werden. Nachfolgend wird ein solches Szenario mit drei Batterien skizziert:

1. die Batterie 1 soll mit voller Leistung geladen werden, die anderen Batterien nur bei weiterem Überschuß. Man würde die jeweiligen
ctrlBatSocManagementXX->lcSlot Schlüssel definieren:

<pre>
set ... attrKeyVal ctrlBatSocManagement01 lcSlot=23:00-23:10
set ... attrKeyVal ctrlBatSocManagement02 lcSlot=00:00-23:59
set ... attrKeyVal ctrlBatSocManagement03 lcSlot=00:00-23:59
</pre>

;Wie ist der Ablauf: Die Batterie 1 unterliegt keiner Steuerung (nur von 23:00 bis 23:10 als Dummy-Periode). Das Reading Battery_ChargeUnrestricted_01 wird "1" gesetzt, d.h. die Batterie 1 wird zur Ladung uneingeschränkt freigegeben. Die anderen Batterien unterliegen der Steuerung -> Battery_ChargeUnrestricted_02 / 03 sind "0" und sollen nur geladen werden falls ein gesetztes Einspeiselimit überschritten wird.

Ist das Ladeziel der Batterie 1 erreicht, setzt man um die Batterie 2 vollzuladen:

<pre>
set ... attrKeyVal ctrlBatSocManagement01 lcSlot=00:00-23:59
set ... attrKeyVal ctrlBatSocManagement02 lcSlot=23:00-23:10
set ... attrKeyVal ctrlBatSocManagement03 lcSlot=00:00-23:59
</pre>

Die Batterien 1 und 3 unterliegen der Steuerung, d.h. Battery_ChargeUnrestricted_01 / 03 haben den Wert "0". Demgegenüber ist Battery_ChargeUnrestricted_02=1 und soll uneingeschränkt geladen werden.

Ist auch die Batterie 2 voll geladen, würde man das Laden der Batterie 3 aktivieren:

<pre>
set ... attrKeyVal ctrlBatSocManagement01 lcSlot=00:00-23:59
set ... attrKeyVal ctrlBatSocManagement02 lcSlot=00:00-23:59
set ... attrKeyVal ctrlBatSocManagement03 lcSlot=23:00-23:10
</pre>

Das Setzens via '''attrKeyVal''' hat den Vorteil, dass die Zeitfenster-Syntax (Anfangszeit kleiner Endezeit usw.) im Hintergrund peprüft und ggf. ein Fehler zurückgegeben wird, den der Nutzer in seinem Script auswerten kann. Weiterhin werden die Attribute implizit gespeichert sofern global->autosave nicht explizit auf "0" gesetzt ist.

<br>

==== Unterstützung eines netzdienlichen Verhaltens ====

Der Steuerungsprozess der Batterieanlage leistet insgesamt einen kleinen Beitrag zur Netzstabilität, indem die Speicherladung in den Zeitraum der meisten prognostizierten Überschußeinspeisung gelegt wird. Im Sommer kann sich dieser Zeitraum in die Zeit nach dem Maxmimum des prognostizierten PV-Überschusses verlagern, wenn auch danach noch genügend Überschußenergie zu Volladung der Batterie prognostiziert wird. In dem Zusammenhang sollte im Attribut '''plantControl->feedinPowerLimit''' ein Einspeiselimit gesetzt werden.

Zur Verdeutlichung soll das Beispiel dienen:

* die Batterie ist zu 60% geladen
* der User hat upSoC=40 eingestellt
* der User hat maxSoC=90 eingestellt

Am Vormittag ist genügend Sonne vohanden, das Maximumum der Energie über die Zeit wird aber noch erwartet.
Zu diesem Zeitpunkt wird das Reading '''Battery_ChargeUnrestricted_XX''' auf den Wert "0" gesetzt. Durch den Nutzer erfolgt daraufhin, zum Beipiel über ein Notify, ein anlagenspezifischer Befehl "Ladestop" an die Batterieanlage.

Ab diesem Moment wird:

# die Batterie nicht geladen
# die erzeugte PV-Energie dem Haushalt zur Verfügung gestellt bzw. der verbleibende Überschuß eingespeist, sofern der Überschuß unterhalb des im Attribut '''plantControl->feedinPowerLimit''' definierten Limits liegt.
# ein eventuell über dem Limit '''plantControl->feedinPowerLimit''' vorhandener Überschuß in die Batterie geladen und so die Netzlast verringert sowie die Batterie schonend geladen. (dieser Punkt trifft in den Monaten mit wenig PV-Erzeugung eher nicht zu)

Gleichzeitig liefert die Batterie Energie an das Hausnetz und wird von 60% bis maximal einem SoC-Wert entladen, der durch die [[#Die_dynamische_SOC_Steuerung_mit_Umsetzungsbeispiel|dynamische SOC Steuerung]] bestimmt wird. Dazu muß diese Steuerung natürlich implementiert sein. Sofern der berechnete SoC größer als upSoC ist, wird der maximale Entladungs-SoC auf upSoC gesetzt.

Zusätzlich überprüft das Modul permanent bei jedem Zyklus die Differenz des aktuell vorhandenen SoC zum eingestellten maxSoC.
Sie soll nicht größer sein um mit dem (noch) zu erwartenden PV-überschuß des Tages der eingestellte maxSoC bzw. dessen Nähe wahrscheinlich erreicht werden kann.
Sollte der Differenz-Grenzwert erreicht sein, wird '''Battery_ChargeUnrestricted_XX=1''' gesetzt und der Nutzer sollte dann über einen geeigneten Befehl seine Anlage in den Modus "Laden" umschalten.
Dieser Vorgang kann beliebig oft während des Tages alternieren.

<br>

=== Nutzung von batteryTrigger ===
Ergänzt werden die Möglichkeiten durch das set-Kommando:

batteryTrigger <1on>=<Wert> <1off>=<Wert> [<2on>=<Wert> <2off>=<Wert> ...]

Das Kommando setzt Triggerpunkte bei Über- bzw. Unterschreitung bestimmter Batterieladungswerte (SoC in %).

Der verwendete SoC wird als resultierender SoC als Summe der aktuellen Ladung aller registrierten Batterie-Geräte im Verhältnis zur installierten Gesamtkapazität gebildet. Das bedeutet, dass alle einzelnen Batterie-Geräte als ein gemeinsamer Cluster betrachtet werden.

Es kann eine beliebige Anzahl von Triggerbedingungen angegeben werden. Xon/Xoff-Bedingungen müssen nicht zwingend paarweise definiert werden.
Überschreiten die letzten drei SoC-Messungen eine definierte Xon-Bedingung, wird das Reading '''batteryTrigger_X = on''' erstellt/gesetzt.
Unterschreiten die letzten drei SoC-Messungen eine definierte Xoff-Bedingung, wird das Reading '''batteryTrigger_X = off''' erstellt/gesetzt.

Der Inhalt der Readings kann durch ein User-Programm oder, bei Erzeugung von entsprechenden Events, mittels notify-Device ausgewertet werden um bei Eintreten eines definierten Ereignisses entsprechende Reaktionen auszulösen. Das kann zum Beispiel die Freigabe eines Heizstabes oberhalb eines bestimmten SOC sein oder ein Entladeverbot der Batterie unterhalb eines SOC-Wertes um Reserven für einen eventuellen Stromausfall zu behalten.

Damit die Batterietrigger dynamisch geändert werden können, ist die Einstellung als Set-Kommando und nicht als Attribut ausgeführt.

Alle Triggerpunkte können mit dem set-Befehl:

reset batteryTriggerSet

wieder gelöscht werden.

== Verbrauchersteuerung - Registrieren und visualisieren von Verbrauchern ==

Das Modul gestattet es beliebige Verbraucher (Devices) über die Attribute '''consumerXX''' zu registrieren. Durch die Registrierung wird dem Modul der Namen des Devices sowie dessen Eingenschaften durch die Angabe von Schlüssel-Wert Paaren bekannt gemacht.

Nach der Registrierung können die Verbraucher durch das Modul genutzt werden:

* es erfolgt eine Planung der Ein- und Ausschaltzeiten abhängig von der solaren Prognose in Bezug zu den Leistungsdaten des Verbrauchers sowie der anderen registrierten Consumer
* das Modul kann die Ein- und Ausschaltsteuerung der Consumer übernehmen (optional)
* die aktuellen Status (Verbrauchsdaten) werden in der Energiefußgrafik dargestellt
* das Modul lernt mit der Zeit das Verbrauchsverhalten der registrierten Verbraucher

Um einen Verbaucher zu registrieren, wird ein freies '''consumerXX''' Attribut, zum Beispiel consumer01, gesetzt.

Die Eigenschaften und das Schaltverhalten wird durch die Angabe der verfügbaren Schlüssel gesteuert. Die Möglichkeiten sind sehr umfangreich. Die nachfolgenden Abschnitte beschreiben die Verwendung am Beispiel oft vorkommender bzw. nachgefragter Sachverhalte.

=== Die Phasen der Verbrauchersteuerung ===

Jeder Zyklus eines Verbrauchers durchläuft im Modul die folgenden Phasen:

# '''Planung''' der Aktivzeiten des Verbrauchers, d.h. wann der Verbraucher geplant eingeschaltet sowie geplant ausgeschaltet wird und damit der Zyklus beendet wird.
# '''Start''' des Zyklus, d.h. Einschalten des Verbrauchers entsprechend der Planungsdaten sofern weitere, in den Consumer-Schlüsseln definierbare Rahmenbedingungen das Einschalten nicht verhindern (z.B. kein oder zu wenig PV-Energieerzeugung / PV-Überschuss)
# '''Permanente Überprüfung von''' eventuell vorhandenen '''Interruptbedingungen''' die den Verbraucher temporär ausschalten und, sofern die Interruptbedingung nicht mehr vorliegt, den Verbraucher wieder einschalten und so den gestarteten Zyklus fortsetzen.
# '''Beendigung''' der Zyklus. Die Beendigung erfolgt entweder (normalerweise) wenn die geplante Endezeit der Zyklus erreicht ist oder eine optionale Endebedingung erfüllt ist.

==== Steuerung der Phasen ====
Der Ablauf der Phasen kann durch verschiedene Schlüssel-Wert Paare beeinflusst und gesteuert werden.

Mit dem optionalen Schlüssel '''swoncond''' kann eine '''zusätzliche externe Bedingung''' definiert werden um den Einschaltvorgang des Consumers freizugeben. Ist die Bedingung (Regex) nicht erfüllt, erfolgt kein Einschalten des Verbrauchers auch wenn die sonstigen Voraussetzungen wie Zeitplanung, on-Schlüssel, auto-Mode und aktuelle PV-Leistung gegeben sind. Es erfolgt somit eine '''UND-Verknüpfung''' des Schlüssels swoncond mit den Planungsdaten und weiteren Einschaltbedingungen.

Der optionale Schlüssel '''swoffcond''' definiert eine '''vorrangige Ausschaltbedingung''' (Regex). Sobald diese Bedingung erfüllt ist, wird der Consumer ausgeschaltet auch wenn die geplante Endezeit (consumerXX_planned_stop) noch nicht erreicht ist ('''ODER-Verknüpfung'''). Weitere Bedingungen wie off-Schlüssel und auto-Mode müssen zum automatischen Ausschalten erfüllt sein.

Mit dem optionalen Schlüssel '''interruptable''' kann während der geplanten Einschaltzeit eine automatische Unterbrechung sowie Wiedereinschaltung des Verbrauchers vorgenommen werden. Der Verbraucher wird temporär ausgeschaltet (interrupted) und wieder eingeschaltet (continued) wenn die Interrupt-Bedingung nicht mehr vorliegt. Die verbleibende Laufzeit wird durch einen Interrupt nicht beeinflusst!

Der Schlüssel '''power''' gibt die nominale Leistungsaufnahme des Verbrauchers gemäß seines Datenblattes an. Dieser Wert wird verwendet um die Schaltzeiten des Verbrauchers zu planen und das Schalten in Abhängigkeit des tatsächlichen PV-Überschusses zum Einplanungszeitpunkt zu steuern. Ist '''power=0''' gesetzt, wird der Verbraucher unabhängig von einem zum Zeitpunkt des Zyklus-Start eventuell nicht ausreichend vorhandenem PV-Überschuss wie geplant eingeschaltet und somit der Zyklus gestartet.

Durch die Schlüssel '''notbefore''' und '''notafter''' kann der Startzeitpunkt des Verbrauchers so gesteuert werden, dass der Start des Zyklus nicht vor bzw. nach der angegebenen Zeit eingeplant wird. Diese Steuerung bezieht sich auf die ''Planung'', d.h. der eigentliche Start des Verbrauchers kann sich unter Umständen durch vorhandene Rahmenbedingungen verzögern.

Der Schlüssel '''mintime''' legt die geplanten Einschaltzeit, d.h. die Laufzeit des Zyklus fest. Der Name '''mintime''' ist nicht als MInimum-Zeit zu deuten, sondern beschreibt die angegebene Zeit in Minuten die der Zyklus dauern soll.

Dieser Schlüssel ist optional, da sich die Standard-Laufzeit des Verbrauchers von dessen Typ abgeleitet wird. Diese Standard Laufzeiten sind:

{| class="wikitable"
|dryer
|90 Minten
|-
|dishwasher
|180 Minuten
|-
|washingmachine
|120 Minuten
|-
|heater
|240 Minuten
|-
|charger
|120 Minuten
|-
|other
|60 Minuten
|-
|heatpump
|Sonderfall
KI-Prognose (ab V2.0.0) beachten
|}

<br>
=== Der Verbraucher wurde nicht gestartet obwohl die Startzeit der Einplanung erreicht wurde ===

Wenn die Startzeit des Consumers entsprechend der Einplanung erreicht oder überschritten ist, wird der Consumer eingeschaltet wenn die weiteren Voraussetzungen wahr sind:

* es ist aktuell ein PV-Überschuss vorhanden und der PV-Überschuss deckt die kalkulierten Leistungsaufnahme des Verbrauchers ab. Mit den Schlüsseln '''power''' und '''spignorecond''' kann die Einschaltung trotz fehlendem PV-Überschuss ermöglicht werden.

* die Angabe im Schlüssel '''swoncond''' ist wahr (sofern gesetzt)

* das Schalten ist über den Schlüssel '''auto''' freigegeben (sofern gesetzt)

* im Schlüssel '''on''' ist ein valides Einschaltkommando hinterlegt

Sind diese zusätzlichen Bedingungen nicht erfüllt, erfolgt kein Start des eingeplanten Zyklus. Der Verbraucher verbleibt in diesem Fall weiterhin im Status ''planned'' oder ''suspended''. Die Startbedingungen werden regelmäßig reviewed und der Consumer gestartet sobald alle Startbedingungen wahr sind bzw. Start verhindernde Bedingungen entfallen sind.

Dieser Vorgang erfolgt bis das geplante Ende des Verbaucherzyklus erreicht ist oder die Bedingung im Schlüssel '''swoffcond''' zutrifft. Sobald die Bedingung im Schlüssel '''swoffcond''' wahr ist, wird der gesamte Planungszyklus des Consumers beendet.

<br>
=== Kann manuell / automatisiert in den Planungszyklus eines Verbrauchers eingegriffen werden? ===

Die Einplanung und die darauf aufbauenden Schaltprozesse laufen gemäß den hinterlegten Schlüsseloptionen im Modul automatatisch ab ohne dass ein Eingriff durch den Anwender erfolgen muß.

Dennoch kann es gewünscht sein eine Neuplanung oder eine Sofortplanung eines Consumers vorzunehmen weil der Bedarf dazu besteht. Zu diesem Zweck stehen die Set-Kommandos

* consumerNewPlanning

* consumerImmediatePlanning

zur Verfügung.
Beide Befehle initiieren die Consumer-Neuplanung, wobei mit dem Befehl ''consumerImmediatePlanning'' die eventuell im consumerXX Attribut gesetzten Schlüssel notbefore, notafter bzw. mode werden nicht beachtet werden. Dagenen beachtet der Befehl ''consumerNewPlanning'' alle definierten Schlüsseloptionen und dient gewöhnlich dazu einen abgeschlossenen Verbraucherzyklus wiederholt ausführen zu lassen weil die aktuelle Witterungslage dazu geeignet ist.

Ein Anwendungsbeispiel dafür ist zum Beispiel die Ausführung von mehreren Waschmaschinen-Zyklen an einem langen, sonnigen Sommertag.
Diese beiden Set-Befehle können zum Beispiel über ein auf einen Schalter/Taster reagierendes Notify oder DOIF Device ausgeführt werden.

<br>

=== Registrierung eines Verbrauchers mit getrennten Geräten für Messung und Schalten ===

Es existieren in FHEM Geräte, die über verschiedene Kanäle für unterschiedliche Aufgaben verfügen. Diese Kanäle werden jeweils in einem gesonderten Device abgebildet. HomeMatic oder readingsProxy sind Beispiele für solche Varianten.

Um solche Verbraucher einzubinden gibt es im consumerXX Attribut den Schlüssel '''switchdev'''.

Bei der Registrierung gibt man als Consumerdevice das Gerät für die Messung an und im Schüssel switchdev das entsprechende FHEM-Device, welches für die Schaltvorgänge benutzt wird.
Ist switchdev angegeben, beziehen sich die weiteren Schlüssel on, off, swstate, auto und asynchron auf dieses Gerät.

In dem nachfolgenden Beispiel (Homematic) ist ''eg.az.fridge_Pwr'' FHEM Device für die Energiemessung. Die Schlüssel ''pcurr'' und ''etotal'' geben Readings in diesem Device an damit SolarForecast den Verbrauch und die Energiemengen auslesen kann. Demgegenüber ist im Schlüssel ''switchdev'' das zugehörige Schalter-Device der Kombination angegeben.

<pre>
eg.az.fridge_Pwr
type=noSchedule switchdev=eg.az.fridge_Sw power=0 icon=fridge pcurr=power:W:5 etotal=energyCalc:Wh
swstate=state:on:off auto=automatic
</pre>

=== Registrierung von Verbrauchern ohne Zeitplanung und aktivem Schalten ===
Manchmal besteht der Wunsch, Verbraucher in SolarForecast zu integrieren um lediglich folgende Sachverhalte abzubilden:

* Visualisierung des Schaltstatus in der Consumer Legende und/oder der Energieflußgrafik
* Darstellung des aktuellen Energieverbrauchs in der Energieflußgrafik
* Erfassung der (externen) Schaltzeiten, d.h. der Zeiten der Gerätenutzung sowie der Verbrauchsdaten um deren Einfluß bei den Planungszeiten anderer Geräte durch SolarForecast berücksichtigen zu lassen

In solchen Fällen werden bei der Registrierung die Schlüssel ''swstate, pcurr'' und ''etotal'' zur Erfassung der Schaltzustände und der Energieverbrauchs angegeben, jedoch zur Verhinderung der Zeitplanung durch SolarForecast der Schlüssel '''type=noSchedule''' gesetzt sowie die Schlüssel ''on'' und ''off'' '''nicht''' gesetzt.

Das nachfolgende Beispiel zeigt eine mögliche Registrierung eines Zwischensteckers (Shelly) zur Erfassung der Daten eines Gefrierschrankes:

<pre>
Shelly.shellyplug4
type=noSchedule power=65 asynchron=1
icon=gefrierschrank
swstate=state:.*on.*:.*off.*
pcurr=relay_0_power:W:5 etotal=relay_0_energy_Wh:Wh
</pre>

=== Beispiel Sonderregistrierung (ab V2.0.0) einer Wärmepumpe ===

Das nachfolgende Beispiel zeigt die besondere Möglichkeit zur Registrierung (ab V2.0.0.) einer Wärmepumpe - aber nur wenn '''aiConActivate=1''' => KI-Consumerprognose <== gesetzt und genutzt wird!

<pre>
EM_Waermepumpe
type=heatpump
power=3183
icon=sani_heating_heatpump@orange
pcurr=Bezug_Wirkleistung:W
etotal=Bezug_Wirkleistung_Zaehler:kWh
noshow=0
switchdev=MQTT_EMSwp ### extra wg. swstate Reading auf MQTT_EMSwp
swstate=hpcompon:1:off
comforttemp=20
</pre>

Erläuterungen zu diesen 'besondern' Einträgen

Eintrag''' type=heatpump '''

Wenn das gemacht wird, aktiviert sich ein Feature-Set für Wärmepumpen. Dadurch ändern sich die Strukturen und das 'runConTrain' muß erneuert gestartet werden.

In dem Status des Consumer-KI-Status-Popup ist auch erkennbar ob die Wärmepumpe erkannt wird und welches Featureset verwendet wird. Es sollte aber dann z.B. beim ''<nowiki/>'attr aiControl aiConProfile=v1_heatpump_active_pv''' gewählt und auch angezeigt werden.

Eintrag''' power=3183'''

Maximale Leistungsaufnahme der Wärmepumpe in W. Der Wert darf nicht! 0 sein. Die Angabe ist verpflichtend.

Eintrag''' comforttemp=20'''

Solltemperatur (Komforttemperatur) in den Wohnräumen in °C. Die Angabe ist verpflichtend.

Eintrag''' Bezug_Wirkleistung_Zaehler:kWh'''

Reading:Einheit (Wh/kWh) des Consumer Device, welches die Summe der verbrauchten Energie liefert. Die Angabe ist verpflichtend.

Eintrag''' swstate=hpcompon:1:off'''

in diesem Beispiel : Wert 1 = WP-Kompressor aktiv, Wert off= WP-Kompressor aus

Reading:ON:OFF welches den Status der Consumers liefert. Die Angabe bei ''type=heatpump'' ist verpflichtend.

Abweichend von anderen Consumern ist die Angabe verpflichtend, auch wenn der default verwendet werden soll. Durch Erstellung eines passenden userReadings (WP-komplett / WP-Heizen / WP-Kühlen / WP-WW-Aufbereitung etc.) kann damit gesteuert werden, ob man sowohl Laufzeiten für Heiz- und Kühlbetrieb, Warmwassererzeugung und Heizstabbetrieb (in einem Consumer) zusammenfassen will, oder ob man z.B. ausschließlich nur die Laufzeiten des Heiz- und Kühlbetriebs als Zeiten für die Heizung in dem jeweiligen consumerXX separieren möchte.

Eintrag''' pcurr=Bezug_Wirkleistung:W'''

Reading:Einheit (W/kW) welches den aktuellen Energieverbrauch liefert. Die Angabe ist verpflichtend.

=== Beispiel Registrierung eines Shelly Devices ===

Nachfolgendes Beispiel zeigt eine Registrierung eines Heizlüfters der an einem Shelly Zwischenstecker angeschlossen ist und durch das Modul gesteuert werden soll. Dabei soll die Steuerung nicht nur von der Solarprognose, sondern auch von der Raumtemperatur abhängig erfolgen. Im Beispiel wird das Attribut consumer03 verwendet.

Zwingende Angaben sind

consumerXX <Device Name> type=<type> power=<power>

Alle Angaben können mehrzeilig eingegeben werden. Die Schlüssel-Werte Paare sind jeweils durch ein Leerzeichen getrennt.

consumerXX Shelly.shellyplug3 type=heater power=1700

In dem Beispiel ist Shelly.shellyplug3 der Devicename des Shellies in FHEM. Der Schlüssel '''type''' definiert die Art des Verbrauchers. In der Hilfe sind die möglichen Typen aufgeführt. Den richtigen Typ anzugeben hat Einfluß auf die spätere Einschätzung des Leistungsverhaltens über die Laufzeit. So wird von einem '''heater''' gleich nach dem Einschalten die angegebene Nominalleistung abgerufen und wird über die Zeit gleichbleiben.
Eine Waschmaschine oder ein Trockner rufen über ihre Laufzeit die Leistung nicht gleichbleibend ab und ändern die Leistungsaufnahme sich über die Einschaltdauer.

Die Angabe von '''power''' definiert die Nominalleistung (Watt) die für den Verbraucher laut Typenschild vom Hersteller angegeben wird. Diese Angabe wird vom Modul bei der Planung der Einschaltzeiten verwendet indem die Nominalleistung in das Verhältnis zur Solarprognose bzw. Verbrauchsprognose des Netzes gesetzt wird. Weiterhin ist dieser Wert auch wichtig um später den tatsächlichen Einschaltzeitpunkt auszuführen wenn ein realer PV Überschuss festgestellt wird.

Es ist möglich '''power=0''' zu setzen. Das führt dazu, dass die Planung und letztendlich auch der Schaltvorgang unabhängig von der Solarprognose bzw. einem realen PV Überschuss vorgenommen wird.

Es werden weitere Schlüsseleingaben vorgenommen:

Shelly.shellyplug3 type=heater power=1700 icon=vent_ventilation mode=can notbefore=09 mintime=SunPath:60:-60 on=on off=off

Mit dem Schlüssel '''icon''' legt man ein Icon fest welches in der Grafik für den Verbraucher verwendet wird. Der '''mode''' definiert die Art und Weise der Einplanung:

;can: Die Einplanung erfolgt zum Zeitpunkt mit wahrscheinlich genügend verfügbaren PV Überschuss. Der Start des Verbrauchers zum Planungszeitpunkt unterbleibt bei ungenügendem PV-Überschuss.

;must: Der Verbaucher wird optimiert eingeplant auch wenn wahrscheinlich nicht genügend PV Überschuss vorhanden sein wird. Der Start des Verbrauchers erfolgt auch bei ungenügendem PV-Überschuss.

Mit '''notbefore''' wird festgelegt, dass die Einplanung nicht vor neun Uhr morgens erfolgen soll auch falls schon genügend PV Überschuss vorhanden wäre. Der Schlüssel '''mintime''' definiert die Einplanungsdauer des Verbrauchers in Minuten im einfachsten Fall. Die hier verwendete Angabe '''SunPath''' ist ein Spezialfall. Der Verbraucher soll von Sonnenaufgang bis Sonnenuntergang eingeschaltet werden, wobei die Angabe von 60 bzw. -60 ein relative Verschiebung bewirken. Dadurch wird das Einschalten 60 Mintuen nach Sonnenaufgang bis 60 Minuten vor Sonnenuntergang geplant.

Die Schlüssel '''on''' und '''off''' teilen dem Modul die jeweiligen gültigen Ein- und Aus-Kommandos mit, mit dem das (Shelly)Device geschaltet werden kann. Werden diese Schlüssel nicht oder "leer" (on= off=) angegeben, erfolgt kein Schalten durch das Modul, nur die Planungsdaten werden erzeugt.

Die Verbraucherregistrierung wird mit weiteren Angaben ergänzt um das gewünschte Verhalten zu erreichen:

Shelly.shellyplug3 type=heater power=1700 icon=vent_ventilation mode=can notbefore=09 mintime=SunPath:60:-60 on=on off=off etotal=relay_0_energy_Wh:Wh
pcurr=relay_0_power:W auto=automatic interruptable=og.bad.wandthermostat:diff-temp:[0-9]\.[0-9]:0.2

In '''etotal''' wird der Readingname des Shelly Devices angegeben welches die Summe der verbrauchten Energie (Wh/kWh) des Consumer Device liefert. D.h. es muß ein sich stetig erhöhender Wert sein. Durch die Auswertung dieses Readings ermittelt das Modul die in bestimmten Zeiteinheiten verbrauchte Energie zur weiteren Verwendung.

In dem Shelly Device ist per default ein solches Reading nicht vorhanden. Über userReadings kann in dem Device Shelly.shellyplug3 ein Reading für etotal erzeugt werden:

userReadings relay_0_energy_Wh:relay_0_energy.* monotonic { sprintf "%.0f", ReadingsVal ($name, 'relay_0_energy', 0) / 60 }

Der Schlüssel '''pcurr''' enthält das Reading in Shelly.shellyplug3 welches den aktuellen Energieverbrauch liefert.

'''auto''' enthält das Reading in Shelly.shellyplug3 welches zur Freigabe/Sperrung der autmatischen Schaltung durch das Modul dienen soll. Ist das angegebene Reading (im Beispiel "automatic") im Shelly.shellyplug3 nicht vorhanden, wird es vom Modul automatisch mit dem Wert "1" angelegt.
Dadurch ist per default das automatische Schalten von Shelly.shellyplug3 durch das Modul freigegeben.
Der User kann durch Setzen des Readings '''automatic=0''' das automatische Schalten durch das Modul sperren und mit "1" wieder freigeben. Dadurch kann man zu bestimmten Zeiten (Urlaub, Feiertage, etc.) die Schaltung temporär deaktivieren.

Wie oben beschrieben, soll der Heizlüfter als weitere Schaltbedingung die Abhängigkeit von der Raumtemperatur beachten. Konkret soll der Heizlüfter mit einer Hysterese von 0.2 (Grad) bei Erreichen einer Soll-Raumtemperatur ausschalten und bei Unterschreiten einer bestimmten Temperatur einschalten.
Der Schlüssel '''interruptable''' übernimmt diese temporäre Schaltsequenzen.

Zunächst wird in dem Sensordevice (In dem Beispiel ein Homatic Wandthermostat HM-TC-IT-WM-W-EU) ein Reading erstellt welches dann im Schlüssel '''interruptable''' angegeben wird. Dieses Reading soll einen Wert enthalten auf den der angegebene Regex ([0-9]\.[0-9]) matchen soll um Shelly.shellyplug3 temporär auszuschalten.
Im Wandthermostat wird dazu ein userReading angelegt:

userReadings diff-temp:desired-temp.* {
sprintf "%.1f", ReadingsVal ($name, 'measured-temp', 0) - ReadingsVal ($name, 'desired-temp', 0)
}

Das bedeutet, wenn die Raumtemperatur die Solltemperatur erreicht oder höher ist, wird diff-temp >= 0.
In diesem Fall matcht der angebene Regex in:

interruptable=og.bad.wandthermostat:diff-temp:'''[0-9]\.[0-9]''':0.2

und Shelly.shellyplug3 wird ausgeschaltet.
Unterschreitet der Wert von diff-temp 0, matcht der Regex nicht mehr und der Verbraucher wird wieder eingeschaltet. Dabei wird die angegebene Hysterese berücksichtigt, d.h der Verbraucher wird erst ausgeschaltet wenn "diff-temp - 0.2 >= 0" wahr ist.

Für das Wiedereinschalten des Heizlüfters ist außerdem Voraussetzung, dass ein entsprechender PV-Überschuss vorliegt. Diese Bedingung wird durch die Angabe von '''power=1700''' bewirkt. Soll der zwangsweise PV Überschuss ignoriert werden, kann '''power=0''' angegeben werden. Alternativ kann die Berücksichtigung des zwangsweisen PV Überschuss mit dem Schlüssel "spignorecond" im Consumer-Attribut ausgesteuert werden.

<br>

== zusätzliche Readings bzw. Erzeugung von statistischen Readings ==

Zusätzlich zu den zahlreichen im Modul per Standard erzeugten Readings kann der Anwender weitere Readings generieren lassen.
Diese zusätzlichen Readings geben entweder einen bestimmten Sachverhalt (Laufzeit, Status der API-Abfragen, etc.) oder einen statistischen Wert, z.B. die Batterieentladung des aktuellen Tages, wieder.

Die zusätzlich erstellten Readings sind durch den Präfix '''special_''' im Device gekennzeichnet.

Diese zusätzlichen Informationen können durch das Setzen einer oder mehrerer Kennzeichen im Attribut '''ctrlSpecialReadings''' erzeugt werden. Die mögliche Auswahl wird je nach Bedarf ausgebaut und umfasst zum aktuellen Zeitpunkt (07.02.2025) diese Möglichkeiten:

;BatPowerIn_Sum: die Summe der momentanen Batterieladeleistung aller definierten Batterie Geräte
;BatPowerOut_Sum: die Summe der momentanen Batterieentladeleistung aller definierten Batterie Geräte
;allStringsFullfilled: Erfüllungsstatus der fehlerfreien Generierung aller Strings
;conForecastTillNextSunrise: Verbrauchsprognose von aktueller Stunde bis zum kommenden Sonnenaufgang
;currentAPIinterval: das aktuelle Abrufintervall der gewählten Strahlungsdaten-API in Sekunden
;currentRunMtsConsumer_XX: die Laufzeit (Minuten) des Verbrauchers "XX" seit dem letzten Einschalten. (letzter Laufzyklus)
;dayAfterTomorrowPVforecast: liefert die Vorhersage der PV Erzeugung für Übermorgen (sofern verfügbar) ohne Autokorrektur (Rohdaten).
;daysUntilBatteryCare_XX: Tage bis zur nächsten Batterie XX Pflege (Erreichen der Ladung 'maxSoC' aus Attribut ctrlBatSocManagementXX)
;lastretrieval_time: der letzte Abrufzeitpunkt der gewählten Strahlungsdaten-API
;lastretrieval_timestamp: der Timestamp der letzen Abrufzeitpunkt der gewählten Strahlungsdaten-API
;response_message: die letzte Statusmeldung der gewählten Strahlungsdaten-API
;runTimeAvgDayConsumer_XX: die durchschnittliche Laufzeit (Minuten) des Verbrauchers "XX" an einem Tag
;runTimeCentralTask: die Laufzeit des letzten SolarForecast Intervalls (Gesamtprozess) in Sekunden
;runTimeTrainAI: die Laufzeit des letzten KI Trainingszyklus in Sekunden
;runTimeLastAPIAnswer: die letzte Antwortzeit des Strahlungsdaten-API Abrufs auf einen Request in Sekunden
;runTimeLastAPIProc: die letzte Prozesszeit zur Verarbeitung der empfangenen Strahlungsdaten-API Daten
;SunMinutes_Remain: die verbleibenden Minuten bis Sonnenuntergang des aktuellen Tages
;SunHours_Remain: die verbleibenden Stunden bis Sonnenuntergang des aktuellen Tages
;todayConsumptionForecast: Verbrauchsprognose pro Stunde des aktuellen Tages (01-24)
;todayConForecastTillSunset: Verbrauchsprognose von aktueller Stunde bis Stunde vor Sonnenuntergang
;todayDoneAPIcalls: die Anzahl der am aktuellen Tag ausgeführten Strahlungsdaten-API Calls
;todayDoneAPIrequests: die Anzahl der am aktuellen Tag ausgeführten Strahlungsdaten-API Requests
;todayConsumption: der gesamte Energieverbrauch (Wh) des Hauses am aktuellen Tag
;todayGridConsumption: die aus dem öffentlichen Netz bezogene Energie am aktuellen Tag
;todayGridFeedIn: die in das öffentliche Netz eingespeiste PV Energie am aktuellen Tag
;todayMaxAPIcalls: die maximal mögliche Anzahl Strahlungsdaten-API Calls. Ein Call kann mehrere API Requests enthalten.
;todayRemainingAPIcalls: die Anzahl der am aktuellen Tag noch möglichen Strahlungsdaten-API Calls
;todayRemainingAPIrequests: die Anzahl der am aktuellen Tag noch möglichen Strahlungsdaten-API Requests
;todayBatIn_XX: die am aktuellen Tag in die Batterie XX geladene Energie
;todayBatInSum: Summe der am aktuellen Tag in alle Batterien geladene Energie
;todayBatOut_XX: die am aktuellen Tag aus der Batterie XX entnommene Energie
;todayBatOutSum: Summe der am aktuellen Tag aus allen Batterien entnommene Energie

'''Wichtig:''' Manche Angaben sind im Setup des Moduls optional, d.h. sie müssen nicht zwingend beim Setup angegeben werden. Allerdings sind diese Angaben für die Erstellung eines zusätzlichen Readings unter Umständen Voraussetzung. Es empfiehlt sich deshalb bei Setup so viele Informationen wie möglich zu übermitteln.

So ist zum Beispiel für die sinnvolle Erstellung der Informationen '''todayBatInSum''' und '''todayBatOutSum''' (Readings special_todayBatInSum und special_todayBatOutSum) das Vorhandensein der Schlüssel ''intotal'' und ''outtotal'' im Attribut setupBatteryDevXX notwendig (Beispiel):

<pre>
attr <Name> setupBatteryDev01 MQTT2_cerboGX_c0619ab34e08_battery
pin=BatIn:W pout=BatOut:W charge=SOC_value intotal=BatInTotal:Wh outtotal=BatOutTotal:Wh
cap=InstalledCapacity_Wh:Wh asynchron=1 show=1
</pre>

<br>

== Hinweise zur Fehlersuche ==
Das Modul SolarForecast ist sehr komplex und es die verschiedensten Datenquellen ausgewertet, zusammengeführt und daraus Ergebnisse berechnet und/oder visualisiert. Wird etwas nicht wie erwartet durch das Modul geliefert, können die Ursachen vielfältig sein. Natürlich kann ein Fehler im Modulcode vorliegen, oftmals gibt es aber andere Ursachen.

Die nachfolgenden Hinweise sollen Hilfe zur Selbsthilfe geben und sind eine Zusammenfassung von realen Fällen die mit dem beschriebenen Wegen und Verfahren gelöst wurden.

=== Die erwartete erzeugte PV-Energie ist im Modul zu gering und wird im Balkendiagramm nicht angezeigt ===

Die erzeugte PV-Energie wird nicht richtig angezeigt: Am Vormittag sind keine Werte vorhanden und, wenn dann etwas kommt, ist die Anzeige zu gering. Für 13 und 14 Uhr wurden ca. 5.000Wh erwartet (im Vergleich mit den Daten aus einer anderen Auswertungsquelle).

'''Lösungsweg:'''

Aus dem List des Devices wurden die für den Fall wesentlichen Readings herausgezogen:

<pre>
2025-02-02 08:59:55 Today_Hour09_PVforecast 152 Wh
2025-02-02 08:59:55 Today_Hour09_PVreal 0 Wh

2025-02-02 09:59:55 Today_Hour10_PVforecast 1400 Wh
2025-02-02 09:59:55 Today_Hour10_PVreal 0 Wh

2025-02-02 10:59:55 Today_Hour11_PVforecast 2500 Wh
2025-02-02 10:59:55 Today_Hour11_PVreal 0 Wh

2025-02-02 11:59:55 Today_Hour12_PVforecast 4392 Wh
2025-02-02 11:59:55 Today_Hour12_PVreal 0 Wh

2025-02-02 12:59:54 Today_Hour13_PVforecast 4000 Wh
2025-02-02 12:59:54 Today_Hour13_PVreal 300 Wh

2025-02-02 13:59:54 Today_Hour14_PVforecast 6415 Wh
2025-02-02 13:59:54 Today_Hour14_PVreal 3200 Wh

2025-02-02 14:59:54 Today_Hour15_PVforecast 5629 Wh
2025-02-02 14:59:54 Today_Hour15_PVreal 2700 Wh

2025-02-02 15:59:54 Today_Hour16_PVforecast 3958 Wh
2025-02-02 15:59:54 Today_Hour16_PVreal 900 Wh

2025-02-02 16:31:24 Today_Hour17_PVforecast 945 Wh
2025-02-02 16:31:24 Today_Hour17_PVreal 500 Wh

2025-02-02 16:31:24 Today_Hour18_PVforecast 59 Wh
</pre>

Man sieht dass bis 12:00 keine erzeugte Energie vom WR gemeldet wird. Deswegen wird in der Balkengrafik nichts dargestellt. Auch danach bleibt die registrierte PV-Energie hinter den Erwartungen zurück. Zuständig für die Lieferung der PV-Energie an das Modul ist das Reading im Schlüssel:

setupInverterDev01 SH10rt pv=Total_DC_Power:W <mark>etotal=Total_Export_Energy_from_PV:kWh</mark> capacity=10000 strings=Hauptdach,Flachdach

Welche Änderungen es zwischen den Stunden gab, sieht man mit einem "get ... pvHistory XX" ("XX" steht für das Datum, d.h. den Tag, z.B. 02). <br>
Hier ein Beispiel für die Stunden 10 (9:00 - 9:59) und 11 (10:00 - 10:59). <br>
Wichtig ist hier der Key etotali01 für den ersten Inverter. Die Differenz zwischen den Werten beider Stunden ist die in der Stunde erzeugte Energie (hier 380 Wh). Diese 380 Wh findest du auch im Key pvrl01 als PVReal für diese Stunde. Das Modul rechnet intern immer mit Wh, kWh werden vorher in Wh umgerechnet.

10 => pvfc: 365, pvrl: 530, pvrlvd: 1, rad1h: -

<mark>etotali01: 63364714</mark>, etotali02: 3044110, etotali03: -

<mark>pvrl01: 380</mark>, pvrl02: 150, pvrl03: -

etotalp01: -, etotalp02: -, etotalp03: -

pprl01: -, pprl02: -, pprl03: -

confc: 574, con: 518, gcons: 22, conprice: 0.2958

gfeedin: 1, feedprice: 0.1269

DoN: 1, sunaz: 137, sunalt: 12

....

11 => pvfc: 2966, pvrl: 1862, pvrlvd: 1, rad1h: -

<mark>etotali01: 63365094</mark>, etotali02: 3044260, etotali03: -

pvrl01: 1392, pvrl02: 470, pvrl03: -

etotalp01: -, etotalp02: -, etotalp03: -

pprl01: -, pprl02: -, pprl03: -

confc: 774, con: 609, gcons: 25, conprice: 0.2958

gfeedin: 4, feedprice: 0.1269

....

D.h. wenn zwischen den beiden Stunden keine Differenzen zu finden sind, liegt es sehr wahrscheinlich am Input des Readings:

etotal=Total_Export_Energy_from_PV:kWh

welches sich in den ersten Stunden nicht ändert und danach auch nur wenig.

Man kann mit dem Attribut:

ctrlDebug=collectData

die Datensammlung verfolgen (leider entstehen viele Daten im Log). Man sieht welche Werte von dem Inverter/Reading geliefert werden:

....
2025.02.02 19:10:10.558 1: SolCast DEBUG> collect Inverter 01 data - device: STP_5000, delivery: default =>
2025.02.02 19:10:10.558 1: SolCast DEBUG> pv: 0 W, <mark>etotal: 63378810 Wh</mark>
....

Dieser Wert muß bei PV Erzeugung kontinuierlich hochzählen. Wenn nicht, muss das angegebene Reading, d.h. die Quelle überprüft werden.

'''Ergebnis der Prüfung:'''

Tatsächlich wurde ein Reading benutzt, das ungeeignet war: Statt "Total_PV_Generation" wurde "Total_export_energy_from_PV" genutzt. In diesem Reading wurde immer die in die Batterie gespeicherte Energie von der gesamten erzeugten Energie abgezogen. Daher war auch vormittags alles 0, da in dieser Periode alle PV-Energie in die Batterie geladen wurde bzw. in weiteren Stunden ein Anteil der dann bei dem PV-Erzeugungswert fehlte.

Nachdem die Ursache beseitigt war, zeigt SolarForecast wieder die erwarteten PV-Erzeugungswerte an.

<br>
== Konfigurationsbeispiele ==

=== Visualisierung solare Vorhersage und reale Erzeugung ===

Zu Beginn jedes neuen Tages gegen 00:00 Uhr werden durch das SolarForecast Device Events für die initiale PV Prognose des kommenden Tages erstellt.
Der Readingteil dieser Events heißt

AllPVforecastsToEvent

Die Uhrzeiten der Events sind so aufbereitet und können direkt geloggt werden um sie in einen SVG Plot zu integrieren.
Im SolarForecast Device ist dieses Reading nicht sichtbar, nur die Events werden erstellt.

Die meteorologischen Bedingungen verändern sich über den Tag permanent. Je nach gewählter Strahlungsdatenquelle (eine API oder DWD Device) erfolgt eine mehr oder weniger dynamische Anpassung der Prognose an die sich verändernde Umwelt.

Aktuelle Prognosedaten sowie die reale PV Erzeugung der vergangenen Stunde können über die Readings

LastHourPVforecast
LastHourPVreal

[[Datei:Screenshot 2024-10-20 134050.png|right|thumb|400px|Übersicht solare Vorhersage]]
geloggt werden.

Werden alle drei Werte in einem SVG kombiniert, kann die Entwicklung der Prognose über den Tag und die Beziehung von Prognose zu realer PV Erzeugnung pro Stunde visualisiert werden.

Für das rechts abgebildete Beispiel des Plots aus einer Datenbank "LogDBShort" sieht das gplot-File wie folgt aus:

<pre>
# Created by FHEM/98_SVG.pm, 2024-03-08 15:05:31
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<TL>'
set ytics
set y2tics
set grid
set ylabel "Wh"
set y2label "Wh"
set yrange [0:7500]
set y2range [0:7500]

#LogDBShort SolCast:LastHourPVforecast:::
#LogDBShort SolCast:LastHourPVreal:::
#LogDBShort SolCast:AllPVforecastsToEvent:::

plot "<IN>" using 1:2 axes x1y2 title 'aktuelle PV Vorhersage' ls l6fill lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'reale PV Erzeugung' ls l2fill lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'initiale PV Vorhersage' ls l4 lw 1 with lines
</pre>

'''Hinweis:''' In manchen Fällen werden die Vorhersagewerte im SVG-Plot nicht angezeigt wenn FileLog verwendet wird. Ein Setzen des Attribute "fixedrange=3days +1" im SVG löst das Problem. Die Definition des SVG-Devices:

<pre>
define SVG_LogDBShort_SolCast SVG LogDBShort:SVG_LogDBShort_SolCast:HISTORY
attr SVG_LogDBShort_SolCast fixedrange 3days +1
attr SVG_LogDBShort_SolCast room Energie->SolarPrognose
attr SVG_LogDBShort_SolCast sortby 2
attr SVG_LogDBShort_SolCast title "Übersicht solare Vorhersage"
</pre>

Technisch bedingt werden an einem Tag X kurz nach 00:00 Uhr die am Vortag für den Tag X erzeugten Events aktualisiert. Diese Daten erzeugen in der Datenbank einen zweiten Satz an Daten mit dem gleichen Timestamp was für die Anzeige unvorteilhaft ist.
Um nur die aktualisierten Events von '''AllPVforecastsToEvent''' in der Datenbank zu erhalten, bietet sich ein DbRep-Device an. Die nachfolgende Vorschlagsdefinition kann per at-Device jeden Tag kurz vor Mitternacht (z.B. 23:57:10) ausgeführt werden. Es werden immer die in der Vergangenheit geschriebenen (veralteten) Daten aus der Datenbank gelöscht, doppelte Datesätze vermieden und immer die aktuellste initiale Prognose gespeichert:

<pre>
define Rep.Del.AllPVforecastsToEvent DbRep LogDBShort
attr Rep.Del.AllPVforecastsToEvent alias Löschen Readings AllPVforecastsToEvent des Folgetages
attr Rep.Del.AllPVforecastsToEvent comment ermöglicht dass die Readings AllPVforecastsToEvent am Folgetag wieder neu und aktuell geschrieben werden können
attr Rep.Del.AllPVforecastsToEvent devStateIcon initialized:control_3dot_hor_s connected:10px-kreis-gelb .*disconnect:10px-kreis-rot .*done:10px-kreis-gruen
attr Rep.Del.AllPVforecastsToEvent disable 0
attr Rep.Del.AllPVforecastsToEvent event-on-update-reading state
attr Rep.Del.AllPVforecastsToEvent icon edit_delete
attr Rep.Del.AllPVforecastsToEvent room Datenbank->Produktiv
attr Rep.Del.AllPVforecastsToEvent showproctime 1
attr Rep.Del.AllPVforecastsToEvent device TYPE=SolarForecast
attr Rep.Del.AllPVforecastsToEvent timestamp_begin next_day_begin
attr Rep.Del.AllPVforecastsToEvent timestamp_end next_day_end
attr Rep.Del.AllPVforecastsToEvent verbose 2
</pre>

Das angegebene DbLog-Device '''LogDBShort''' ist natürlich anzupassen.

Das at-Device zum Starten der Datenbankbereinigung sieht folgendermaßen aus:

<pre>
define At.Del.AllPVforecastsToEvent at *23:58:10 set Rep.Del.AllPVforecastsToEvent delEntries
attr At.Del.AllPVforecastsToEvent alias Start Löschen Readings AllPVforecastsToEventn LogDBShort
attr At.Del.AllPVforecastsToEvent icon clock
attr At.Del.AllPVforecastsToEvent room Datenbank->Produktiv
</pre>

Natürlich sind auch hier die eigenen Devicenamen entsprechend anzupassen.

Ab SolarForecast Version 1.51.7 kann die Eventerzeugung für bestimmte SVG Plot-Typen optimiert werden. <br>
Die Aktivierung dieser Optimierungen ist in der Online Hilfe zum Attribut '''plantControl->genPVforecastsToEvent''' beschrieben. Bei Nutzung des Attributes plantControl->genPVforecastsToEvent ist ebenfalls das Attribut '''event-on-update-reading=AllPVforecastsToEvent''' zu setzen.

<br>

=== Beispielkonfiguration 1 ===
Dies ist eine Konfiguration mit

SummenDummy für 2 BatterieWR (Namen : SBS25 / SBS25_2)

SummenDummy für 3 PV-Wechselrichter (Namen : SB25 / SB30 / SB40)

mit verschiedenen InverterStrings / ModulDirection / ModulTiltAngle, ModulPeakString

und auch mit den notwendigen zugehörigen anderen Modul-Konfigs.

'''ACHTUNG:''' Zusätzlich enthalten ist bei dem Beispiel-Notify eine Sonderkonstellation für eine Brennstoffzelle "FCU" als weitere bzw. zusätzliche Stromerzeugungsquelle. Diese "FCU" wird dadurch mit in der Grafik mit deren Erzeugungsleistung Tag und Nacht in der Erzeugersumme (am Symbol = Sonne) berücksichtigt.

''(ReadingsVal("FCU","FCU-Strom-aktuelle-Leistung",0)/1000)''

==== DWD ====
Bitte dabei diese DWD-Version aus dem [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/DS_Starter Contrib] von DS_Starter dazu nutzen
{| class="wikitable"
|55_DWD_OpenData.pm
|136.2 KB
|29260
|DS_Starter
|55_DWD_OpenData: contrib 1.17.7
|}
<syntaxhighlight lang="perl">
define DWD DWD_OpenData
attr DWD downloadTimeout 120
attr DWD comment Im DWD Wetterdevice verwendet Solarforecast : \
TTT,Neff,RR1c,ww,SunUp,SunRise,SunSet \
zusätzlich ist jedoch auch noch Rad1h notwendig \
wenn dieses DWD-Device als Strahlungsdevice genutzt wird.\
Die Station 10418 (Lüdenscheid) überträgt aktuell am 09.03.2025 (noch) Rad1h.\
attr DWD downloadTimeout 120
attr DWD forecastDays 7
attr DWD forecastProperties SunUp, SunRise, SunSet, Rad1h, R101, RR1c, TTT, Tx, Tn, Tg, DD, FX1, RR6c, R600, RRhc, Rh00, ww, wwd, Neff
attr DWD forecastRefresh 1
attr DWD forecastResolution 1
attr DWD forecastStation 10418
attr DWD forecastWW2Text 1
attr DWD group Umwelt
attr DWD icon rc_WEB
attr DWD room 021_DWD
attr DWD stateFormat Tomorrow Tmax fc1_Tx °C on fc1_date at fc_description -(state fc_time)
attr DWD verbose 2

</syntaxhighlight>

==== InverterDummy ====
<syntaxhighlight lang="perl">
defmod InverterDummy dummy
attr InverterDummy event-on-change-reading .*
attr InverterDummy group Energy Meter
attr InverterDummy icon measure_photovoltaic_inst@green
attr InverterDummy room 020_PV,Energie
attr InverterDummy stateFormat {sprintf("current %9.3f kW Today_PVforecast %9.3f kWh Today_PV %9.3f kWh Total_PV %9.3f kWh",\
ReadingsVal($name,"total_pac",0)/1,\
ReadingsNum("Forecast","Today_PVforecast",0)/1000,\
ReadingsVal($name,"etoday",0)/1,\
ReadingsVal($name,"etotal",0)/1,)}
attr InverterDummy verbose 2
</syntaxhighlight>

==== SMA_Energymeter ====
<syntaxhighlight lang="perl">
defmod SMA_Energymeter SMAEM
attr SMA_Energymeter DbLogExclude state
attr SMA_Energymeter diffAccept 50
attr SMA_Energymeter disable 0
attr SMA_Energymeter disableSernoInReading 1
attr SMA_Energymeter event-on-update-reading state,Saldo_Wirkleistung,Bezug_Wirkleistung,Einspeisung_Wirkleistung,Bezug_Wirkleistung_Zaehler,Einspeisung_Wirkleistung_Zaehler
attr SMA_Energymeter feedinPrice 0.08
attr SMA_Energymeter group Energy Meter
attr SMA_Energymeter icon measure_power@green
attr SMA_Energymeter interval 15
attr SMA_Energymeter powerCost 0.25
attr SMA_Energymeter room 015_Zaehler,020_PV,Energie
attr SMA_Energymeter serialNumber XXXXXXXXXX
attr SMA_Energymeter stateFormat state W (IN -) P1: L1_Saldo_Wirkleistung P2: L2_Saldo_Wirkleistung P3:L3_Saldo_Wirkleistung
attr SMA_Energymeter verbose 2
</syntaxhighlight>

==== BatteryDummy ====
<syntaxhighlight lang="perl">
defmod BatteryDummy dummy
attr BatteryDummy DbLogExclude .*
attr BatteryDummy event-on-change-reading .*
attr BatteryDummy group Energy Meter
attr BatteryDummy icon batterie@green
attr BatteryDummy room 020_PV,Energie
attr BatteryDummy stateFormat {ReadingsVal("$name","total_pac", undef)." kW ".\
" - total ".ReadingsVal("$name","bat_loadtotal", undef)." kWh (-in)".\
" - ".ReadingsVal("$name","bat_unloadtotal", undef)." kWh (out)".\
" - charged ".ReadingsVal("$name","chargestatus", undef)." % "}
attr BatteryDummy userReadings total_pac, power_out, power_in, chargestatus, bat_rated_capacity, bat_loadtotal, bat_unloadtotal
</syntaxhighlight>

==== "Berechnungs"-Notify der Werte für Batterie- und InverterDummy ====
<syntaxhighlight lang="perl">
defmod N.PV.TotalConsumption.Dum.Energy notify SMA_Energymeter:Saldo_Wirkleistung:.* {\
# Batterie-Bezug -Batterieentnahme\
fhem "setreading Dum.Energy BattLoadIn ".sprintf("%.1f",(ReadingsVal("SBS25","power_out",0)));;\
# Batterie-Beladung Batterie mit Strom füllen\
fhem "setreading Dum.Energy BattLoadOut ".sprintf("%.1f",(ReadingsVal("SBS25","power_in",0)));;\
# Batteriestatus\
fhem "setreading Dum.Energy BattStatusP ".sprintf("%.1f",(ReadingsVal("SBS25","chargestatus",0)));;\
# Batterie-Bezug -Batterieentnahme_2\
fhem "setreading Dum.Energy BattLoadIn_2 ".sprintf("%.1f",(ReadingsVal("SBS25_2","power_out",0)));;\
# Batterie-Beladung_2 Batterie mit Strom füllen\
fhem "setreading Dum.Energy BattLoadOut_2 ".sprintf("%.1f",(ReadingsVal("SBS25_2","power_in",0)));;\
# Batteriestatus_2\
fhem "setreading Dum.Energy BattStatusP_2 ".sprintf("%.1f",(ReadingsVal("SBS25_2","chargestatus",0)));;\
# Forecast Invertererzeugung InverterDummy \
fhem "setreading InverterDummy Today_PVforecast ".sprintf("%.3f",(ReadingsNum("Forecast","Today_PVforecast",0)));;\
# Invertererzeugung InverterDummy \
fhem "setreading InverterDummy etotal ".sprintf("%.3f",(ReadingsNum("SB25","etotal",0))+(ReadingsNum("SB30","etotal",0))+(ReadingsNum("SB40","etotal",0)));;\
# Invertererzeugung InverterDummy \
#fhem "setreading InverterDummy total_pac ".sprintf("%.3f",(ReadingsVal("MB_USRW610_004","Power_Sum__W",0)/1000)+(ReadingsNum("SB25","total_pac",0))+(ReadingsNum("SB30","total_pac",0))+(ReadingsNum("SB40","total_pac",0)));;\
fhem "setreading InverterDummy total_pac ".sprintf("%.3f",(ReadingsNum("SB25","total_pac",0))+(ReadingsNum("SB30","total_pac",0))+(ReadingsNum("SB40","total_pac",0)));;\
#fhem "setreading InverterDummy total_pac ".sprintf("%.3f",(ReadingsVal("FCU","FCU-Strom-aktuelle-Leistung",0)/1000)+(ReadingsNum("SB25","total_pac",0))+(ReadingsNum("SB30","total_pac",0))+(ReadingsNum("SB40","total_pac",0)));;\
# Invertererzeugung InverterDummy \
my $wert1234 = "0" ;;\
$wert1234 = sprintf("%.3f",(ReadingsNum("SB25","etoday",0))+(ReadingsNum("SB30","etoday",0))+(ReadingsNum("SB40","etoday",0)));; \
fhem ("setreading InverterDummy etoday ".sprintf("%.3f",$wert1234));;\
# Batterie-Bezug -Batterieentnahme InverterDummy\
fhem "setreading BatteryDummy power_out ".sprintf("%.0f",(ReadingsNum("SBS25","power_out",0))+(ReadingsNum("SBS25_2","power_out",0)));;\
# Batterie-Beladung InverterDummyBatterie mit Strom füllen\
fhem "setreading BatteryDummy power_in ".sprintf("%.0f",(ReadingsNum("SBS25","power_in",0))+(ReadingsNum("SBS25_2","power_in",0)));;\
# Batterie-Bezug -bat_loadtotal Batterieentnahme InverterDummy\
fhem "setreading BatteryDummy bat_unloadtotal ".sprintf("%.3f",(ReadingsNum("SBS25","bat_unloadtotal",0))+(ReadingsNum("SBS25_2","bat_unloadtotal",0)));;\
# Batterie-Beladung bat_loadtotal InverterDummyBatterie mit Strom füllen\
fhem "setreading BatteryDummy bat_loadtotal ".sprintf("%.3f",(ReadingsNum("SBS25","bat_loadtotal",0))+(ReadingsNum("SBS25_2","bat_loadtotal",0)));;\
# Batteriestatus InverterDummy\
my $wert5 = sprintf("%.2f",(((ReadingsNum("SBS25","chargestatus",0))/2) + ((ReadingsNum("SBS25_2","chargestatus",0))/2)));; \
fhem ("setreading BatteryDummy chargestatus ".sprintf("%.2f",$wert5));;\
# Batterie-total_pac InverterDummy\
my $wert6 = sprintf("%.3f",((ReadingsNum("SBS25","total_pac",0))+(ReadingsNum("SBS25_2","total_pac",0))));; \
fhem ("setreading BatteryDummy total_pac ".sprintf("%.3f",$wert6));;\
# Batterie-total_pac InverterDummy\
my $wert7 = sprintf("%.3f",((ReadingsNum("SBS25","bat_rated_capacity",0))+(ReadingsNum("SBS25_2","bat_rated_capacity",0))));; \
fhem ("setreading BatteryDummy bat_rated_capacity ".sprintf("%.3f",$wert7));;\
# möglicher Aufruf einer Batterie-Bebladung-Routine....SMABatteryChargewithTibber();;\
}
attr N.PV.TotalConsumption.Dum.Energy DbLogExclude .*
attr N.PV.TotalConsumption.Dum.Energy room Energie
attr N.PV.TotalConsumption.Dum.Energy verbose 2
</syntaxhighlight>

==== SolarForecast ====
<syntaxhighlight lang="perl">
defmod Forecast SolarForecast
attr Forecast DbLogExclude .*
attr Forecast DbLogInclude Current_BatCharge999
attr Forecast affectBatteryPreferredCharge 30
attr Forecast affectConsForecastLastDays 31
attr Forecast affect70percentRule 0
attr Forecast comment "wget -qO ./FHEM/76_SolarForecast.pm https://svn.fhem.de/fhem/trunk/fhem/contrib/DS_Starter/76_SolarForecast.pm"\
"wget -qO ./FHEM/55_DWD_OpenData.pm https://svn.fhem.de/fhem/trunk/fhem/contrib/DS_Starter/55_DWD_OpenData.pm"\
"13.01.2025 mit der Version 76_SolarForecast.pm:v1.43.2-s29518/2025-01-12"
attr Forecast graphicHeaderOwnspec PV ;Heute ;real:Today_PVreal Verbrauch ;bis ;Sonnenaufgang ;:special_conForecastTillNextSunrise PV ;Morgen ;erwartet:Tomorrow_PVforecast PV ;Uebermorgen ;erwartet:special_dayAfterTomorrowPVforecast Batt.-Ladeanforderung ;:Battery_ChargeRequest FCU-Erzeugung ;:Current_PP01\
attr Forecast consumer01 FBDECT_fbahahttp_11657_0127183 icon=scene_washing_machine@orange type=washingmachine power=10 swstate:state notbefore=09 notafter=20 pcurr=power:W:3 etotal=energy:Wh interruptable=1 auto=solarforecast_auto surpmeth=default
attr Forecast consumer02 FBDECT_fbahahttp_E8_DF_70_07_3E_57 icon=light_floor_lamp@orange type=other power=15 swstate:state pcurr=power:W:10 etotal=energy:Wh interruptable=0 auto=solarforecast_auto surpmeth=default
attr Forecast consumer03 FBDECT_fbahahttp_E8_DF_70_07_42_0B icon=raspberrypi@orange type=other power=8 swstate:state pcurr=power:W:1 etotal=energy:Wh interruptable=0 auto=solarforecast_auto surpmeth=default
attr Forecast consumer04 FBDECT_fbahahttp_11657_0067275 icon=springbrunnen_icon@orange type=other power=50 swstate:state pcurr=power:W:10 etotal=energy:Wh interruptable=0 auto=solarforecast_auto surpmeth=default
attr Forecast consumer05 FBDECT_fbahahttp_34_31_C4_D4_31_37 icon=sani_domestic_waterworks@orange type=other power=10 swstate:state pcurr=power:W:3 etotal=energy:Wh auto=solarforecast_auto surpmeth=default
attr Forecast consumer06 tuya_local_bf5037060f450bdbd4rl0q icon=scene_clothes_dryer@orange type=dryer power=10 swstate:state pcurr=cur_power:W:3 etotal=energy:Wh auto=solarforecast_auto surpmeth=default
attr Forecast consumer07 tuya_local_bfac44fb487476efd1vhdu icon=weather_sunset@orange type=noSchedule power=5 swstate:state pcurr=cur_power:W:3 etotal=energy:Wh auto=solarforecast_auto surpmeth=default
attr Forecast consumerControl adviceIcon=light_light_dim_100@gold
attr Forecast consumerControl showLegend=icon_top
attr Forecast consumerControl detailLink=1
attr Forecast ctrlAIdataStorageDuration 1825
attr Forecast ctrlAIshiftTrainStart 2
attr Forecast ctrlBatSocManagement01 lowSoc=10 upSoC=30 maxSoC=99 careCycle=20
attr Forecast ctrlBatSocManagement02 lowSoc=10 upSoC=30 maxSoC=99 careCycle=20
attr Forecast ctrlDebug none
attr Forecast plantControl genPVdeviation=continuously
attr Forecast plantControl cycleInterval=15
attr Forecast ctrlNextDayForecastReadings 01,02,03,04,05,06,07,08,09,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24
attr Forecast ctrlNextHoursSoCForecastReadings 00,01,02,03,04,05,06,07,08,09,10,11,12,13,14,15,16,17,18,19,20,21,22,23
attr Forecast ctrlSpecialReadings BatPowerIn_Sum,BatPowerOut_Sum,SunHours_Remain,SunMinutes_Remain,allStringsFullfilled,conForecastTillNextSunrise,currentAPIinterval,currentRunMtsConsumer_01,currentRunMtsConsumer_02,currentRunMtsConsumer_03,currentRunMtsConsumer_04,currentRunMtsConsumer_05,currentRunMtsConsumer_06,currentRunMtsConsumer_07,dayAfterTomorrowPVforecast,daysUntilBatteryCare_01,daysUntilBatteryCare_02,lastretrieval_time,lastretrieval_timestamp,response_message,runTimeAvgDayConsumer_01,runTimeAvgDayConsumer_02,runTimeAvgDayConsumer_03,runTimeAvgDayConsumer_04,runTimeAvgDayConsumer_05,runTimeAvgDayConsumer_06,runTimeAvgDayConsumer_07,runTimeCentralTask,runTimeLastAPIAnswer,runTimeLastAPIProc,runTimeTrainAI,todayBatIn_01,todayBatIn_02,todayBatOut_01,todayBatOut_02,todayConForecastTillSunset,todayConsumptionForecast,todayDoneAPIcalls,todayDoneAPIrequests,todayGridConsumption,todayGridFeedIn,todayMaxAPIcalls,todayRemainingAPIcalls,todayRemainingAPIrequests
attr Forecast disable 0
attr Forecast event-min-interval .*:1800
attr Forecast event-on-change-reading .*
attr Forecast flowGraphicControl animate=1 consumerdist=80 h2consumerdist=50 shiftx=0 shifty=0 showconsumer=1 showconsumerdummy=1 showconsumerpower=1 showconsumerremaintime=0 size=400 strokewidth=12
attr Forecast graphicBeam1Color 3C14FF
attr Forecast graphicBeam1Content pvReal
attr Forecast graphicBeam2Color 19FF29
attr Forecast graphicBeam2Content pvForecast
attr Forecast graphicBeam3Color D60924
attr Forecast graphicBeam3Content batsocforecast_02
attr Forecast graphicBeam3FontColor FFFF0D
attr Forecast graphicBeam4Color FFFF1F
attr Forecast graphicBeam4Content batsocforecast_01
attr Forecast graphicBeam4FontColor 000000
attr Forecast graphicBeamHeightLevel1 200
attr Forecast graphicBeamHeightLevel2 200
attr Forecast graphicHeaderDetail all
attr Forecast graphicHeaderOwnspec #PV\
PV ;Heute ;real:Today_PVreal\
PV ;Morgen ;erwartet:Tomorrow_PVforecast\
PV ;Uebermorgen ;erwartet:special_dayAfterTomorrowPVforecast\
:\
#\
AutarkyRate:Current_AutarkyRate\
Überschuss:Current_Surplus\
aktueller ;Netzbezug:Current_GridConsumption\
:\
#Verbrauch\
bis ;Sonnenuntergang:special_todayConForecastTillSunset\
bis ;Sonnenaufgang ;:special_conForecastTillNextSunrise\
:\
:\
#Batterie01\
Batt.-Ladeanforderung ;:Battery_ChargeRequest_01\
Batt.-Ladung ;empfohlen:Battery_ChargeUnrestricted_01\
Ladung ;heute:special_todayBatIn_01\
Entladung ;heute:special_todayBatOut_01\
#Batterie01_tmp\
Current_PowerBatIn_01:Current_PowerBatIn_01\
Current_PowerBatOut_01:Current_PowerBatOut_01\
:\
:\
#Batterie02\
Batt.-Ladeanforderung ;:Battery_ChargeRequest_02\
Batt.-Ladung ;empfohlen:Battery_ChargeUnrestricted_02\
Ladung ;heute:special_todayBatIn_02\
Entladung ;heute:special_todayBatOut_02\
#Batterie02_tmp\
Current_PowerBatIn_02:Current_PowerBatIn_02\
Current_PowerBatOut_02:Current_PowerBatOut_02\
:\
:\
#Settings\
Autokorrektur:pvCorrectionFactor_Auto \
Wetter:graphicShowWeather\
History:graphicHistoryHour\
ShowNight:graphicShowNight\
Debug:ctrlDebug\
FCU-Modus:FCU-Betriebsmodus@FCU
attr Forecast graphicHistoryHour 4
attr Forecast graphicHourCount 24
attr Forecast graphicLayoutType double
attr Forecast graphicShowDiff top
attr Forecast graphicShowNight 1
attr Forecast graphicShowWeather 1
attr Forecast group Energy Meter
attr Forecast room 020_PV,Energie
attr Forecast setupBatteryDev01 SBS25 pin=-pout:kW pout=total_pac:kW intotal=bat_loadtotal:kWh outtotal=bat_unloadtotal:kWh charge=chargestatus cap=9800 show=2
attr Forecast setupBatteryDev02 SBS25_2 pin=-pout:kW pout=total_pac:kW intotal=bat_loadtotal:kWh outtotal=bat_unloadtotal:kWh charge=chargestatus cap=9800 show=2
attr Forecast setupInverterDev01 SB25 pv=total_pac:kW etotal=etotal:kWh capacity=2500 strings=GarageSE limit=70
attr Forecast setupInverterDev02 SB30 pv=total_pac:kW etotal=etotal:kWh capacity=3000 strings=GarageNW,HausNW limit=70
attr Forecast setupInverterDev03 SB40 pv=total_pac:kW etotal=etotal:kWh capacity=4000 strings=HausSE1,HausSE2,HausSW limit=70
attr Forecast setupInverterStrings GarageSE,GarageNW,HausNW,HausSW,HausSE1,HausSE2
attr Forecast setupMeterDev SMA_Energymeter gcon=Bezug_Wirkleistung:W contotal=Bezug_Wirkleistung_Zaehler:kWh gfeedin=Einspeisung_Wirkleistung:W feedtotal=Einspeisung_Wirkleistung_Zaehler:kWh conprice=0.25:€ feedprice=0.08123:€
attr Forecast setupOtherProducer01 icon=Heizung_FCU_green@red MB_USRW610_004 pcurr=Power_L1__W:W etotal=Energy_L1_import__kWh:kWh
attr Forecast setupRadiationAPI DWD
attr Forecast setupStringPeak GarageSE=2.75 GarageNW=3.200 HausNW=2.230 HausSW=2.230 HausSE1=2.200 HausSE2=2.200
attr Forecast setupWeatherDev1 DWD
attr Forecast stateFormat Current_PV
attr Forecast userReadings Current_BatCharge999 {((ReadingsNum("SBS25","chargestatus",0) * 10 * ReadingsNum("SBS25","bat_rated_capacity",0)) + (ReadingsNum("SBS25_2","chargestatus",0) * 10 * ReadingsNum("SBS25","bat_rated_capacity",0))) / ( (ReadingsNum("SBS25","bat_rated_capacity",0) * 1000) + (ReadingsNum("SBS25_2","bat_rated_capacity",0)*1000))*100}
attr Forecast verbose 2

setstate Forecast 0 W
setstate Forecast 2025-01-13 18:53:55 .FCU_FCU-Betriebsmodus 2
setstate Forecast 2025-01-13 18:53:55 .Forecast_ctrlDebug none
setstate Forecast 2025-01-13 18:53:55 .Forecast_graphicHistoryHour 4
setstate Forecast 2025-01-13 18:53:55 .Forecast_graphicShowNight 1
setstate Forecast 2025-01-13 18:53:55 .Forecast_graphicShowWeather 1
setstate Forecast 2025-01-13 08:24:25 .associatedWith SMA_Energymeter FBDECT_fbahahttp_11657_0127183 FBDECT_fbahahttp_E8_DF_70_07_3E_57 FBDECT_fbahahttp_E8_DF_70_07_42_0B FBDECT_fbahahttp_11657_0067275 FBDECT_fbahahttp_34_31_C4_D4_31_37 tuya_local_bf5037060f450bdbd4rl0q tuya_local_bfac44fb487476efd1vhdu SBS25 SBS25_2 SB25 SB30 SB40 DWD MB_USRW610_004
setstate Forecast 2025-01-13 18:53:54 .lastupdateForecastValues 1736790834
setstate Forecast 2025-01-13 01:00:05 .pvCorrectionFactor_01_apipercentil done
setstate Forecast 2025-01-13 01:00:05 .pvCorrectionFactor_01_cloudcover done
setstate Forecast 2025-01-13 02:00:04 .pvCorrectionFactor_02_apipercentil done
setstate Forecast 2025-01-13 02:00:04 .pvCorrectionFactor_02_cloudcover done
setstate Forecast 2025-01-13 03:00:04 .pvCorrectionFactor_03_apipercentil done
setstate Forecast 2025-01-13 03:00:04 .pvCorrectionFactor_03_cloudcover done
setstate Forecast 2025-01-13 04:00:05 .pvCorrectionFactor_04_apipercentil done
setstate Forecast 2025-01-13 04:00:05 .pvCorrectionFactor_04_cloudcover done
setstate Forecast 2025-01-13 05:00:05 .pvCorrectionFactor_05_apipercentil done
setstate Forecast 2025-01-13 05:00:05 .pvCorrectionFactor_05_cloudcover done
setstate Forecast 2025-01-13 06:00:06 .pvCorrectionFactor_06_apipercentil done
setstate Forecast 2025-01-13 06:00:06 .pvCorrectionFactor_06_cloudcover done
setstate Forecast 2025-01-13 07:00:04 .pvCorrectionFactor_07_apipercentil done
setstate Forecast 2025-01-13 07:00:04 .pvCorrectionFactor_07_cloudcover done
setstate Forecast 2025-01-13 08:00:03 .pvCorrectionFactor_08_apipercentil done
setstate Forecast 2025-01-13 08:00:03 .pvCorrectionFactor_08_cloudcover done
setstate Forecast 2025-01-13 09:00:04 .pvCorrectionFactor_09_apipercentil done
setstate Forecast 2025-01-13 09:00:04 .pvCorrectionFactor_09_cloudcover done
setstate Forecast 2025-01-13 10:00:05 .pvCorrectionFactor_10_apipercentil done
setstate Forecast 2025-01-13 10:00:05 .pvCorrectionFactor_10_cloudcover done
setstate Forecast 2025-01-13 11:00:05 .pvCorrectionFactor_11_apipercentil done
setstate Forecast 2025-01-13 11:00:05 .pvCorrectionFactor_11_cloudcover done
setstate Forecast 2025-01-13 12:00:02 .pvCorrectionFactor_12_apipercentil done
setstate Forecast 2025-01-13 12:00:02 .pvCorrectionFactor_12_cloudcover done
setstate Forecast 2025-01-13 13:00:02 .pvCorrectionFactor_13_apipercentil done
setstate Forecast 2025-01-13 13:00:02 .pvCorrectionFactor_13_cloudcover done
setstate Forecast 2025-01-13 14:00:03 .pvCorrectionFactor_14_apipercentil done
setstate Forecast 2025-01-13 14:00:03 .pvCorrectionFactor_14_cloudcover done
setstate Forecast 2025-01-13 15:00:05 .pvCorrectionFactor_15_apipercentil done
setstate Forecast 2025-01-13 15:00:05 .pvCorrectionFactor_15_cloudcover done
setstate Forecast 2025-01-13 16:00:06 .pvCorrectionFactor_16_apipercentil done
setstate Forecast 2025-01-13 16:00:06 .pvCorrectionFactor_16_cloudcover done
setstate Forecast 2025-01-13 17:00:05 .pvCorrectionFactor_17_apipercentil done
setstate Forecast 2025-01-13 17:00:05 .pvCorrectionFactor_17_cloudcover done
setstate Forecast 2025-01-13 18:00:04 .pvCorrectionFactor_18_apipercentil done
setstate Forecast 2025-01-13 18:00:04 .pvCorrectionFactor_18_cloudcover done
setstate Forecast 2025-01-13 18:53:54 .pvCorrectionFactor_Auto_Soll on_complex_ai
setstate Forecast 2025-01-13 01:00:05 .signaldone_01 done
setstate Forecast 2025-01-13 02:00:04 .signaldone_02 done
setstate Forecast 2025-01-13 03:00:04 .signaldone_03 done
setstate Forecast 2025-01-13 04:00:05 .signaldone_04 done
setstate Forecast 2025-01-13 05:00:05 .signaldone_05 done
setstate Forecast 2025-01-13 06:00:06 .signaldone_06 done
setstate Forecast 2025-01-13 07:00:04 .signaldone_07 done
setstate Forecast 2025-01-13 08:00:03 .signaldone_08 done
setstate Forecast 2025-01-13 09:00:04 .signaldone_09 done
setstate Forecast 2025-01-13 10:00:05 .signaldone_10 done
setstate Forecast 2025-01-13 11:00:05 .signaldone_11 done
setstate Forecast 2025-01-13 12:00:02 .signaldone_12 done
setstate Forecast 2025-01-13 13:00:02 .signaldone_13 done
setstate Forecast 2025-01-13 14:00:03 .signaldone_14 done
setstate Forecast 2025-01-13 15:00:05 .signaldone_15 done
setstate Forecast 2025-01-13 16:00:06 .signaldone_16 done
setstate Forecast 2025-01-13 17:00:05 .signaldone_17 done
setstate Forecast 2025-01-13 18:00:04 .signaldone_18 done
setstate Forecast 2025-01-13 18:53:54 Battery_ChargeUnrestricted_01 1
setstate Forecast 2025-01-13 18:53:54 Battery_ChargeUnrestricted_02 1
setstate Forecast 2025-01-13 18:53:54 Battery_ChargeRequest_01 1
setstate Forecast 2025-01-13 18:53:54 Battery_ChargeRequest_02 1
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour00_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour00_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour01_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour01_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour02_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour02_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour03_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour03_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour04_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour04_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour05_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour05_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour06_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour06_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour07_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour07_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour08_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour08_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour09_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour09_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour10_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour10_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour11_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour11_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour12_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour12_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour13_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour13_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour14_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour14_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour15_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour15_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour16_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour16_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour17_SoCforecast_01 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour17_SoCforecast_02 10.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour18_SoCforecast_01 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour18_SoCforecast_02 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour19_SoCforecast_01 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour19_SoCforecast_02 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour20_SoCforecast_01 42.6 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour20_SoCforecast_02 42.6 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour21_SoCforecast_01 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour21_SoCforecast_02 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour22_SoCforecast_01 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour22_SoCforecast_02 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour23_SoCforecast_01 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_NextHour23_SoCforecast_02 40.0 %
setstate Forecast 2025-01-13 18:53:54 Battery_OptimumTargetSoC_01 40 %
setstate Forecast 2025-01-13 18:53:54 Battery_OptimumTargetSoC_02 40 %
setstate Forecast 2025-01-13 18:53:54 Current_AutarkyRate 83 %
setstate Forecast 2025-01-13 18:53:55 Current_BatCharge999 10
setstate Forecast 2025-01-13 18:53:54 Current_BatCharge_01 12 %
setstate Forecast 2025-01-13 18:53:54 Current_BatCharge_02 8 %
setstate Forecast 2025-01-13 18:53:54 Current_Consumption 626 W
setstate Forecast 2025-01-13 18:53:54 Current_GridConsumption 2 W
setstate Forecast 2025-01-13 18:53:54 Current_GridFeedIn 0 W
setstate Forecast 2025-01-13 18:53:54 Current_PP_01 746.0 W
setstate Forecast 2025-01-13 18:53:54 Current_PV 0 W
setstate Forecast 2025-01-13 18:53:54 Current_PowerBatIn_01 0 W
setstate Forecast 2025-01-13 18:53:54 Current_PowerBatIn_02 132 W
setstate Forecast 2025-01-13 18:53:54 Current_PowerBatOut_01 10 W
setstate Forecast 2025-01-13 18:53:54 Current_PowerBatOut_02 0 W
setstate Forecast 2025-01-13 18:53:54 Current_SelfConsumption 0 W
setstate Forecast 2025-01-13 18:53:54 Current_SelfConsumptionRate 0 %
setstate Forecast 2025-01-13 18:53:54 Current_Surplus 120 W
setstate Forecast 2025-01-13 18:00:00 LastHourGridconsumptionReal 5 Wh
setstate Forecast 2025-01-13 18:00:00 LastHourPVforecast 0 Wh
setstate Forecast 2025-01-13 18:00:00 LastHourPVreal 0 Wh
setstate Forecast 2025-01-13 18:53:54 NextHours_Sum01_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 NextHours_Sum02_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 NextHours_Sum03_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 NextHours_Sum04_ConsumptionForecast 2944 Wh
setstate Forecast 2025-01-13 18:53:54 NextHours_Sum04_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 RestOfDayConsumptionForecast 3609 Wh
setstate Forecast 2025-01-13 18:53:54 RestOfDayPVforecast 0 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_BatIn_01 272 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_BatIn_02 0 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_BatOut_01 0 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_BatOut_02 0 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_GridConsumption 1 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_GridFeedIn 1 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_PPreal_01 748 Wh
setstate Forecast 2025-01-13 00:59:59 Today_Hour01_PVreal 0 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_BatIn_01 266 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_BatIn_02 0 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_BatOut_01 0 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_BatOut_02 0 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_GridConsumption 1 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_GridFeedIn 1 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_PPreal_01 787 Wh
setstate Forecast 2025-01-13 01:59:58 Today_Hour02_PVreal 0 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_BatIn_01 271 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_BatIn_02 0 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_BatOut_01 0 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_BatOut_02 0 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_GridConsumption 2 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_GridFeedIn 2 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_PPreal_01 750 Wh
setstate Forecast 2025-01-13 02:59:53 Today_Hour03_PVreal 0 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_BatIn_01 266 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_BatIn_02 0 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_BatOut_01 0 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_BatOut_02 0 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_GridConsumption 1 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_GridFeedIn 1 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_PPreal_01 745 Wh
setstate Forecast 2025-01-13 03:59:52 Today_Hour04_PVreal 0 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_BatIn_01 267 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_BatIn_02 0 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_BatOut_01 0 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_BatOut_02 0 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_GridConsumption 2 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_GridFeedIn 2 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_PPreal_01 758 Wh
setstate Forecast 2025-01-13 04:59:56 Today_Hour05_PVreal 0 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_BatIn_01 255 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_BatIn_02 0 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_BatOut_01 0 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_BatOut_02 0 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_GridConsumption 1 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_GridFeedIn 1 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_PPreal_01 752 Wh
setstate Forecast 2025-01-13 05:59:59 Today_Hour06_PVreal 0 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_BatIn_01 226 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_BatIn_02 0 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_BatOut_01 50 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_BatOut_02 0 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_GridConsumption 2 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_GridFeedIn 2 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_PPreal_01 681 Wh
setstate Forecast 2025-01-13 06:59:52 Today_Hour07_PVreal 0 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_BatIn_01 0 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_BatIn_02 233 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_BatOut_01 845 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_BatOut_02 0 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_GridConsumption 4 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_GridFeedIn 4 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_PPreal_01 0 Wh
setstate Forecast 2025-01-13 07:59:50 Today_Hour08_PVreal 0 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_BatIn_01 37 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_BatIn_02 90 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_BatOut_01 351 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_BatOut_02 188 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_GridConsumption 447 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_GridFeedIn 4 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_PPreal_01 0 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_PVforecast 127 Wh
setstate Forecast 2025-01-13 08:59:57 Today_Hour09_PVreal 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_BatIn_01 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_BatIn_02 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_BatOut_01 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_BatOut_02 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_GridConsumption 1650 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_GridFeedIn 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_PPreal_01 0 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_PVforecast 478 Wh
setstate Forecast 2025-01-13 09:59:58 Today_Hour10_PVreal 26 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_BatIn_01 0 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_BatIn_02 0 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_BatOut_01 0 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_BatOut_02 0 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_GridConsumption 513 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_GridFeedIn 0 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_PPreal_01 0 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_PVforecast 868 Wh
setstate Forecast 2025-01-13 10:59:58 Today_Hour11_PVreal 97 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_BatIn_01 0 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_BatIn_02 0 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_BatOut_01 0 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_BatOut_02 0 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_GridConsumption 576 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_GridFeedIn 0 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_PPreal_01 0 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_PVforecast 1157 Wh
setstate Forecast 2025-01-13 11:59:49 Today_Hour12_PVreal 320 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_BatIn_01 8 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_BatIn_02 4 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_BatOut_01 0 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_BatOut_02 0 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_GridConsumption 1272 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_GridFeedIn 7 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_PPreal_01 0 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_PVforecast 1238 Wh
setstate Forecast 2025-01-13 12:59:49 Today_Hour13_PVreal 945 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_BatIn_01 410 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_BatIn_02 53 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_BatOut_01 0 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_BatOut_02 0 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_GridConsumption 955 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_GridFeedIn 31 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_PPreal_01 562 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_PVforecast 1168 Wh
setstate Forecast 2025-01-13 13:59:49 Today_Hour14_PVreal 1410 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_BatIn_01 703 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_BatIn_02 500 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_BatOut_01 22 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_BatOut_02 18 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_GridConsumption 32 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_GridFeedIn 71 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_PPreal_01 777 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_PVforecast 1630 Wh
setstate Forecast 2025-01-13 14:59:49 Today_Hour15_PVreal 1416 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_BatIn_01 296 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_BatIn_02 70 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_BatOut_01 74 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_BatOut_02 258 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_GridConsumption 13 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_GridFeedIn 17 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_PPreal_01 732 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_PVforecast 880 Wh
setstate Forecast 2025-01-13 15:59:50 Today_Hour16_PVreal 1051 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_BatIn_01 47 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_BatIn_02 126 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_BatOut_01 102 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_BatOut_02 75 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_GridConsumption 15 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_GridFeedIn 23 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_PPreal_01 771 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_PVforecast 117 Wh
setstate Forecast 2025-01-13 16:59:49 Today_Hour17_PVreal 86 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_BatIn_01 0 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_BatIn_02 410 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_BatOut_01 758 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_BatOut_02 67 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_GridConsumption 5 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_GridFeedIn 5 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_PPreal_01 723 Wh
setstate Forecast 2025-01-13 17:59:54 Today_Hour18_PVreal 0 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_BatIn_01 349 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_BatIn_02 124 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_BatOut_01 73 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_BatOut_02 450 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_GridConsumption 8 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_GridFeedIn 6 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_PPreal_01 671 Wh
setstate Forecast 2025-01-13 18:53:54 Today_Hour19_PVreal 0 Wh
setstate Forecast 2025-01-13 18:53:54 Today_MaxPVforecast 1630 Wh
setstate Forecast 2025-01-13 18:53:54 Today_MaxPVforecastTime 2025-01-13 14:00:00
setstate Forecast 2025-01-13 18:53:54 Today_PVdeviation 30.17 %
setstate Forecast 2025-01-13 18:53:54 Today_PVforecast 7663 Wh
setstate Forecast 2025-01-13 18:53:54 Today_PVreal 5351 Wh
setstate Forecast 2025-01-13 18:53:54 Today_SunRise 08:28
setstate Forecast 2025-01-13 18:53:54 Today_SunSet 16:46
setstate Forecast 2025-01-13 18:53:54 Tomorrow_ConsumptionForecast 17043 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour01_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour02_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour03_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour04_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour05_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour06_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour07_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour08_PVforecast 10 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour09_PVforecast 161 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour10_PVforecast 275 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour11_PVforecast 532 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour12_PVforecast 730 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour13_PVforecast 1252 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour14_PVforecast 818 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour15_PVforecast 1465 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour16_PVforecast 303 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour17_PVforecast 20 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour18_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour19_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour20_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour21_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour22_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour23_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_Hour24_PVforecast 0 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_PVforecast 5566 Wh
setstate Forecast 2025-01-13 18:53:54 Tomorrow_SunRise 08:27
setstate Forecast 2025-01-13 18:53:54 Tomorrow_SunSet 16:47
setstate Forecast 2025-01-13 18:53:54 consumer01 name='_Waschmaschine' state='off' mode='can' planningstate='planned'
setstate Forecast 2025-01-13 18:53:54 consumer01_currentPower 0 W
setstate Forecast 2025-01-13 18:53:54 consumer01_planned_start 14.01.2025 09:00:00
setstate Forecast 2025-01-13 18:53:54 consumer01_planned_stop 14.01.2025 11:00:00
setstate Forecast 2025-01-13 18:53:54 consumer02 name='_Esszimmer' state='on' mode='can' planningstate='planned'
setstate Forecast 2025-01-13 18:53:54 consumer02_currentPower 15.3 W
setstate Forecast 2025-01-13 18:53:54 consumer02_planned_start 14.01.2025 08:00:00
setstate Forecast 2025-01-13 18:53:54 consumer02_planned_stop 14.01.2025 09:00:00
setstate Forecast 2025-01-13 18:53:54 consumer03 name='_FCU' state='on' mode='can' planningstate='planned'
setstate Forecast 2025-01-13 18:53:54 consumer03_currentPower 7.15 W
setstate Forecast 2025-01-13 18:53:54 consumer03_planned_start 14.01.2025 07:00:00
setstate Forecast 2025-01-13 18:53:54 consumer03_planned_stop 14.01.2025 08:00:00
setstate Forecast 2025-01-13 18:53:54 consumer04 name='_Brunnen' state='off' mode='can' planningstate='planned'
setstate Forecast 2025-01-13 18:53:54 consumer04_currentPower 0 W
setstate Forecast 2025-01-13 18:53:54 consumer04_planned_start 14.01.2025 08:00:00
setstate Forecast 2025-01-13 18:53:54 consumer04_planned_stop 14.01.2025 09:00:00
setstate Forecast 2025-01-13 18:53:54 consumer05 name='_Zisterne' state='off' mode='can' planningstate='planned'
setstate Forecast 2025-01-13 18:53:54 consumer05_currentPower 0 W
setstate Forecast 2025-01-13 18:53:54 consumer05_planned_start 14.01.2025 07:00:00
setstate Forecast 2025-01-13 18:53:54 consumer05_planned_stop 14.01.2025 08:00:00
setstate Forecast 2025-01-13 18:53:54 consumer06 name='SW Trockner' state='unknown' mode='can' planningstate='planned'
setstate Forecast 2025-01-13 18:53:54 consumer06_currentPower 0 W
setstate Forecast 2025-01-13 18:53:54 consumer06_planned_start 14.01.2025 07:00:00
setstate Forecast 2025-01-13 18:53:54 consumer06_planned_stop 14.01.2025 08:30:00
setstate Forecast 2025-01-13 18:53:54 consumer07 name='SW Urlaubslicht-Wohnzimmer' state='on' mode='can' planningstate='noSchedule' info='von extern umgeschaltet'
setstate Forecast 2025-01-13 18:53:54 consumer07_currentPower 0 W
setstate Forecast 2025-01-13 18:53:54 nextCycletime 18:54:09
setstate Forecast 2025-01-13 10:00:05 pvCorrectionFactor_10 0.53 (automatic - old factor: 1.00, Sun Alt range: 5, Cloud range: 75, Days in range: 1)
setstate Forecast 2025-01-13 11:00:05 pvCorrectionFactor_11 0.56 (automatic - old factor: 1.00, Sun Alt range: 10, Cloud range: 70, Days in range: 1)
setstate Forecast 2025-01-13 12:00:02 pvCorrectionFactor_12 0.64 (automatic - old factor: 1.00, Sun Alt range: 15, Cloud range: 60, Days in range: 1)
setstate Forecast 2025-01-13 13:00:02 pvCorrectionFactor_13 0.88 (automatic - old factor: 1.00, Sun Alt range: 15, Cloud range: 60, Days in range: 1)
setstate Forecast 2025-01-13 14:00:03 pvCorrectionFactor_14 1.10 (automatic - old factor: 1.00, Sun Alt range: 15, Cloud range: 50, Days in range: 1)
setstate Forecast 2025-01-13 15:00:05 pvCorrectionFactor_15 1.01 (automatic - old factor: 1.06, Sun Alt range: 15, Cloud range: 45, Days in range: 2)
setstate Forecast 2025-01-13 16:00:06 pvCorrectionFactor_16 1.09 (automatic - old factor: 1.00, Sun Alt range: 10, Cloud range: 45, Days in range: 1)
setstate Forecast 2025-01-13 17:00:05 pvCorrectionFactor_17 0.28 (automatic - old factor: 0.52, Sun Alt range: 0, Cloud range: 45, Days in range: 2)
setstate Forecast 2025-01-13 18:53:54 pvCorrectionFactor_Auto on_complex_ai
setstate Forecast 2024-10-30 19:42:19 setupStringAzimuth GarageSE=-55 GarageNW=125 HausNW=125 HausSW=35 HausSE1=-55 HausSE2=-55
setstate Forecast 2024-10-30 19:37:38 setupStringDeclination GarageSE=40 GarageNW=40 HausNW=50 HausSW=50 HausSE1=50 HausSE2=50
setstate Forecast 2025-01-13 18:53:54 special_BatPowerIn_Sum 132 W
setstate Forecast 2025-01-13 18:53:54 special_BatPowerOut_Sum 10 W
setstate Forecast 2025-01-13 18:53:54 special_SunHours_Remain 0.00
setstate Forecast 2025-01-13 18:53:54 special_SunMinutes_Remain 0
setstate Forecast 2025-01-13 18:53:54 special_allStringsFullfilled 1
setstate Forecast 2025-01-13 18:53:54 special_conForecastTillNextSunrise 9467 Wh
setstate Forecast 2025-01-13 18:53:54 special_currentAPIinterval 0
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_01 132 min
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_02 184 min
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_03 329512 min
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_04 200 min
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_05 27 min
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_06 193 min
setstate Forecast 2025-01-13 18:53:54 special_currentRunMtsConsumer_07 106 min
setstate Forecast 2025-01-13 18:53:54 special_dayAfterTomorrowPVforecast 7344 Wh
setstate Forecast 2025-01-13 18:53:54 special_daysUntilBatteryCare_01 12
setstate Forecast 2025-01-13 18:53:54 special_daysUntilBatteryCare_02 12
setstate Forecast 2025-01-13 18:53:54 special_lastretrieval_time 2025-01-13 18:53:54
setstate Forecast 2025-01-13 18:53:54 special_lastretrieval_timestamp 1736790834
setstate Forecast 2025-01-13 18:53:54 special_response_message success
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_01 545.94 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_02 382.10 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_03 1430.13 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_04 262.05 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_05 28.80 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_06 622.63 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeAvgDayConsumer_07 276.51 min
setstate Forecast 2025-01-13 18:53:54 special_runTimeCentralTask 0.3744
setstate Forecast 2025-01-13 18:53:54 special_runTimeLastAPIAnswer -
setstate Forecast 2025-01-13 18:53:54 special_runTimeLastAPIProc -
setstate Forecast 2025-01-13 18:53:54 special_runTimeTrainAI 1.2529
setstate Forecast 2025-01-13 18:53:54 special_todayBatIn_01 3683.0 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayBatIn_02 1617.0 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayBatOut_01 2287.0 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayBatOut_02 1057.0 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConForecastTillSunset 0 Wh
setstate Forecast 2025-01-13 00:59:59 special_todayConsumptionForecast_01 509 Wh
setstate Forecast 2025-01-13 01:59:58 special_todayConsumptionForecast_02 499 Wh
setstate Forecast 2025-01-13 02:59:53 special_todayConsumptionForecast_03 501 Wh
setstate Forecast 2025-01-13 03:59:52 special_todayConsumptionForecast_04 511 Wh
setstate Forecast 2025-01-13 04:59:56 special_todayConsumptionForecast_05 503 Wh
setstate Forecast 2025-01-13 05:59:59 special_todayConsumptionForecast_06 495 Wh
setstate Forecast 2025-01-13 06:59:52 special_todayConsumptionForecast_07 504 Wh
setstate Forecast 2025-01-13 07:59:50 special_todayConsumptionForecast_08 561 Wh
setstate Forecast 2025-01-13 08:59:57 special_todayConsumptionForecast_09 768 Wh
setstate Forecast 2025-01-13 09:59:58 special_todayConsumptionForecast_10 783 Wh
setstate Forecast 2025-01-13 10:59:58 special_todayConsumptionForecast_11 692 Wh
setstate Forecast 2025-01-13 11:59:49 special_todayConsumptionForecast_12 791 Wh
setstate Forecast 2025-01-13 12:59:49 special_todayConsumptionForecast_13 910 Wh
setstate Forecast 2025-01-13 13:59:49 special_todayConsumptionForecast_14 1022 Wh
setstate Forecast 2025-01-13 14:59:49 special_todayConsumptionForecast_15 965 Wh
setstate Forecast 2025-01-13 15:59:50 special_todayConsumptionForecast_16 812 Wh
setstate Forecast 2025-01-13 16:59:49 special_todayConsumptionForecast_17 884 Wh
setstate Forecast 2025-01-13 17:59:54 special_todayConsumptionForecast_18 928 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConsumptionForecast_19 874 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConsumptionForecast_20 763 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConsumptionForecast_21 750 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConsumptionForecast_22 765 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConsumptionForecast_23 643 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayConsumptionForecast_24 601 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayDoneAPIcalls 0
setstate Forecast 2025-01-13 18:53:54 special_todayDoneAPIrequests 4532
setstate Forecast 2025-01-13 18:53:54 special_todayGridConsumption 5500.9 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayGridFeedIn 178.9 Wh
setstate Forecast 2025-01-13 18:53:54 special_todayMaxAPIcalls n.a.
setstate Forecast 2025-01-13 18:53:54 special_todayRemainingAPIcalls n.a.
setstate Forecast 2025-01-13 18:53:54 special_todayRemainingAPIrequests n.a.
setstate Forecast 2025-01-13 18:53:55 state updated
</syntaxhighlight>
So sollte es dann als Ergebnis aussehen:
[[Datei:Bildschirmfoto 2025-01-13.png|zentriert|mini|Ergebnis nach kompletter Einrichtung]]
[[Datei:Bildschirmfoto 2025-01-13 Teil II.png|alternativtext=Unterer Teil der Anzeige|zentriert|mini]]

== Praxisbeispiele und Lösungsansätze für Steuerungen ==
=== Fallstudie: Trockner darf pausiert werden, wenn nicht genug PV-Überschuss vorhanden ist, soll aber nach spätestens X Stunden fertig sein ===
Für diese Aufgabenstellung sind mehrere Schlüssel essentiell wichtig, '''power''', '''mintime''', '''mode''' und '''interruptable'''.

Die Bedingung, dass der Trockner nach spätestens X Stunden fertig sein soll, steht in einem Widerspruch zu der Möglichkeit den Trockner bei zu wenig PV-Überschuss unterbrechen zu können. Im Extremfall könnte nach dem Start die gesamte Planungszeit ungenügender Überschuss vorliegen und der Trockner nicht arbeiten. Der Schlüssel '''mintime''' (in Minuten) wird nun wie folgt angesetzt:

mintime = 2,5 x <gewöhnliche Betriebszeit für einen Trockengang (mneed, z.B. 120)> = 300 Minuten

Das bedeutet, der Trockner wird nach 300 Minuten Laufzeit abgeschaltet werden bzw. vom Netz getrennt. Der Trockenvorgang wird natürlich bereits nach 120 Minuten beendet sein, sofern nach Start keine Unterbrechnung des Vorganges erfolgte. Wurde der Vorgang unterbrochen, soll der Trockner innerhalb

X+120 bis X+300

fertig sein.

Demnach ist die ausgeführte Laufzeit des Trockners permanent zu überwachen, zu summieren (rtsum) und die notwendige Restzeit (mneed - rtsum) mit der noch verbleibenden Restzeit (mrest) bis zur geplanten Abschaltung des Consumers zu vergleichen. Ist der Consumer gestartet, wird die Laufzeit in der pvHistory für jede Stunde des Tages im Schlüssel ''minutescsmXX'' (XX = Consumernummer) aufgezeichnet und kann darüber ausgewertet werden. Somit ist:

msum = for (01 .. 24) {Summe von minutescsmXX} des aktuellen Tages

Solange die Bedingung

mrest >= (mneed - msum)

zutrifft, darf der Trockner unterbrochen werden, anderenfalls darf er nicht mehr unterbrochen werden da die Restzeit evtl. nicht ausreichen könnte um den Vorgang abzuschließen. Für die Planung des Trockners wird der Consumer wie gewöhnlich nach dem Bedarf im Modul registriert. Für die Steuerung der Unterbrechbarkeit wird noch ein Code erstellt, welcher im Trockner-Device ''Dryerdev'' das Reading ''SF_Int'' zur Unterbrechnungssteuerung verwaltet. Dieses Reading wird dem Schlüssel '''interruptable''' übergeben. Für das Beispiel wird der Consumer '07' verwendet, es kann natürlich jede andere freie Nummer verwendet werden:

<pre>
attr <Name> consumer07 Dryerdev:Trockner
icon=scene_cloves_dryer type=dryer power=2000 mode=must mintime=300
on=on off=off etotal=energy_Wh:Wh pcurr=power:W
auto=automatic asynchron=1
interruptable=Dryerdev:SF_Int:1

</pre>

Die Kombination '''auto=automatic''' eröffnet die Möglickeit, in der Consumer-Legende den Trockner-Start zusätzlich manuell freizugeben oder zu verbieten.

Im nachfolgenden Code werden modulinterne Subroutinen verwendet. Diese sind inklusive dem Paket ''FHEM::SolarForecast::'' anzugeben. Die erstellte Subroutine wird in die 99_mySolarForecastUtils.pm eingefügt. Die Datei 99_mySolarForecastUtils.pm wird vorher von 99_myUtils.pm kopiert und enthält für die Übersichtlichkeit nur Routinen für SolarForecast.

<syntaxhighlight lang="Perl">
############################################################################
# Trocknersteuerung (einfügen in 99_mySolarForecastUtils.pm)
############################################################################
sub dryControl {
my $name = shift;
my $c = shift; # Nummer des Verbrauchers, z.B. 07
my $mneed = shift; # gewöhlich benötigte Zeit für
# einen Trockengang, z.B. 120 (Minuten)

$c = sprintf "%02d", $c; # falls führende 0 vergessen wird
my $dryer = FHEM::SolarForecast::ConsumerVal ($name, $c, 'name', ''); # Devicename des Trockners
my $plstate = FHEM::SolarForecast::ConsumerVal ($name, $c, 'planstate', '');
my $simpCstat = FHEM::SolarForecast::simplifyCstate ($plstate); # akt. Status des Consumers

if ($simpCstat =~ /started|interrupt|continu/xs) { # Vorgang ist gestartet
my $t = time;
my $startts = FHEM::SolarForecast::ConsumerVal ($name, $c, 'planswitchon', '');
my $stopts = FHEM::SolarForecast::ConsumerVal ($name, $c, 'planswitchoff', '');
return if(!$startts || !$stopts);

my $mrest = sprintf '%.0f', (($stopts - $t) / 60); # Restlaufzeit (Minuten)
my $dt = FHEM::SolarForecast::timestringsFromOffset ($startts, 0);
my $day = $dt->{day};
my $hstart = int $dt->{hour} + 1; # lfd. Stunde bei Trockner-Start
my $msum = 0;

for my $hod (1..24) { # bisherige Laufzeit des Trockners
next if($hod < $hstart);
$hod = sprintf "%02d", $hod;
$msum += FHEM::SolarForecast::HistoryVal ($name, $day, $hod, "minutescsm${c}", 0);
}

my $dhash = $defs{$dryer};

if ($mrest >= ($mneed - $msum)) {
readingsSingleUpdate ($dhash, 'SF_Int', 1, 0); # Interrupt-Freigabe
}
else {
readingsSingleUpdate ($dhash, 'SF_Int', 0, 0); # keine Interrupt-Freigabe

}
}

return;
}
</syntaxhighlight>

Damit die Routine mit jedem Zyklus im Modul ausgeführt wird, legen wir sie im Attribut '''ctrlUserExitFn''' an. Es werden der Name des SolarForecast-Devices, die Verbrauchernummer (07) und die gewöhnliche Laufzeit des Trockners für einen Trockenvorgang (120 Minuten) übergeben:

<pre>
attr <Name> ctrlUserExitFn {
::dryControl ($name, '07', 120);
}
</pre>

<br>
=== Fallstudie: Umwälzpumpe Pool soll X Stunden am Tag laufen. Ist kein PV-Überschuß vorhanden, müssen die X Stunden/Tag trotzdem erreicht werden ===

Die Vorgehensweise ähnelt der Fallstudie zuvor. Verändernd kommt hinzu, dass der Planungszeitraum bewusst sehr lang angesetzt wird mit der Option, den Zyklus des Consumers vorfristig zu beenden sobald die Laufzeit von X Stunden am Tag erreicht ist.
Im folgenden Beispiel soll die Pumpe 5 Stunden am Tag (300 Minuten) laufen und dabei mögliche PV-Überschüsse ausnutzen.

<pre>
attr <Name> consumer07 Pump:Zirkulationspumpe
icon=sani_pump type=other power=50 mode=must mintime=780 notafter=09
on=on off=off etotal=energy_Wh:Wh pcurr=power:W
auto=automatic
interruptable=1 swoffcond=Pump:SF_Abort:1
</pre>

Mit dieser Registrierung wird die Pumpe ca. 09 Uhr täglich starten. Wenn kein bzw. ungenügender PV-Überschuß vorhanden ist, erfolgt eine Unterbrechung nach dem Start. Ist genügender PV-Überschuß (wieder) vorhanden, erfolgt keine Unterbrechnung (mehr). Zusätzlich wird über den Schlüssel '''swoffcond''' eine vorfristige Beendigung veranlasst, sobald die gewünschte Tageslaufzeit erreicht ist.

Zur Verwaltung des Schlüssels ''interruptable'' und des Readings ''SF_Abort'' verwenden wir eine leicht veränderte Subroutine aus dem vorhergehenden Fallbeispiel:

<syntaxhighlight lang="Perl">
############################################################################
# Pumpensteuerung (einfügen in 99_mySolarForecastUtils.pm)
############################################################################
sub pumpControl {
my $name = shift;
my $c = shift; # Nummer des Verbrauchers, z.B. 07
my $mneed = shift; # Soll-Pumpenzeit, z.B. 300 (Minuten)

$c = sprintf "%02d", $c; # falls führende 0 vergessen wird
my $pump = FHEM::SolarForecast::ConsumerVal ($name, $c, 'name', ''); # Devicename der Pumpe
my $plstate = FHEM::SolarForecast::ConsumerVal ($name, $c, 'planstate', '');
my $intbl = FHEM::SolarForecast::ConsumerVal ($name, $c, 'interruptable', 1);
my $simpCstat = FHEM::SolarForecast::simplifyCstate ($plstate); # akt. Status des Consumers
my $dhash = $defs{$pump};

readingsSingleUpdate ($dhash, 'SF_Abort', 0, 0); # default keine Zyklusbeendigung

if ($simpCstat =~ /started|interrupt|continu/xs) { # Vorgang ist gestartet
my $t = time;
my $startts = FHEM::SolarForecast::ConsumerVal ($name, $c, 'planswitchon', '');
my $stopts = FHEM::SolarForecast::ConsumerVal ($name, $c, 'planswitchoff', '');
return if(!$startts || !$stopts);

my $mrest = sprintf '%.0f', (($stopts - $t) / 60); # Restlaufzeit (Minuten)
my $dt = FHEM::SolarForecast::timestringsFromOffset ($startts, 0);
my $day = $dt->{day};
my $hstart = int $dt->{hour} + 1; # lfd. Stunde bei Pumpen Start
my $msum = 0;

for my $hod (1..24) { # bisherige Laufzeit der Pumpe
next if($hod < $hstart);
$hod = sprintf "%02d", $hod;
$msum += FHEM::SolarForecast::HistoryVal ($name, $day, $hod, "minutescsm${c}", 0);
}

if ($msum >= $mneed) {
readingsSingleUpdate ($dhash, 'SF_Abort', 1, 0); # vorfristige Zyklusbeendigung
return;
}

if ($mrest >= ($mneed - $msum)) {
fhem ("set $name attrKeyVal consumer$c interruptable=1") if(!$intbl); # Interrupt-Freigabe
}
else {
fhem ("set $name attrKeyVal consumer$c interruptable=0") if($intbl); # keine Interrupt-Freigabe
}
}

return;
}
</syntaxhighlight>

Der Befehl ''attrKeyVal'' setzt den Schlüssel ''interruptable'' im Attribut ''consumer07'' dynamisch. Diese Strukturänderung wird automatisch im System gespeichert, sofern ''global->autosave=1'' gesetzt ist. Diese Einstellung ist der FHEM default.

Damit die Routine mit jedem Zyklus im Modul ausgeführt wird, legen wir sie im Attribut '''ctrlUserExitFn''' an. Es werden der Name des SolarForecast-Devices, die Verbrauchernummer (07) und die Mindestlaufzeit der Umwälzpumpe (300 Minuten) übergeben:

<pre>
attr <Name> ctrlUserExitFn {
::pumpControl ($name, '07', 300);
}
</pre>

<br>

=== Dynamische Ladestromsteuerung eines Victron MultiPlus II Chargers mit Pylontech Batterie ===
Die nachfolgend beschriebene Lösung soll als Anregung für eigene Optimierungen verstanden werden und ist weiter ausbaufähig bzw. erweiterbar um zum Beipiel jahreszeitliche Anpassungen des Verfahrens.

Die MultiPlus II Batteriewechselrichter von Victron sollten die Batterien nicht mit dem maximal möglichen Ladestrom beladen, da sich die Effizienz deutlich verschlechtert wenn sich die Ströme den jeweiligen Grenzwerten nähern ([https://www.victronenergy.com/upload/documents/Output-rating-operating-temperature-and-efficiency.pdf Lesestoff]).
Andererseits sollen die Ladeleistungen so gewählt werden, dass die verfügbare Solarenergie eine volle Aufladung der Akkus ermöglicht.

Das Victron System ermöglicht das Auslesen und die Steuerung der Anlage via MQTT. Die Einbindung in FHEM über MQTT soll hier nicht beschrieben werden.
Aber wenn dies erfolgt ist, kann der Ladestrom z.B. mit dem Kommando:

set <Device> MaxChargeCurrent <Wert>

eingestellt bzw. variiert werden.

Das Modul bietet dem Nutzer die Möglichkeit in dem Attribut ''ctrlUserExitFn'' eigenen Code zur Auführung zu bringen. Der in diesem Attribut enthaltene Code wird am Ende jedes Zyklus (siehe Attribut ''plantControl->cycleInterval'') ausgeführt.
In dem Attribut wird dieser Code eingetragen dessen Funktion und Zusammenspiel nachfolgend erläutert wird:

<syntaxhighlight lang="Perl">
{
## Vars
########
my $batdev = (split " ", ReadingsVal ($name, 'currentBatteryDev', ''))[0]; # Batteriedevice
my $vebus = 'MQTT2_cerboGX_c0619ab34e08_vebus'; # Victron Vebus Device
my $mppt1 = 'MQTT2_cerboGX_c0619ab34e08_solarcharger_Common'; # SmartLoader Device
my $maxcspc = 105; # max. Ladesollstrom (A) nominal
my $spcorr = 0.9; # Korrekturfaktor Überschuss 90%
my $sch = 0.25; # Verkürzungsfaktor Zeit bis Vollladung vor Sunset

my $cclvl0 = 15; # Ladestrom Level 0 max. 5 A (240 W) pro WR (720 W)
my $cclvl1 = 27; # Ladestrom Level 1 max. 9 A (432 W) pro WR (1296 W)
my $cclvl2 = 54; # Ladestrom Level 2 max. 18 A (864 W) pro WR (2592 W)
my $cclvl3 = 81; # Ladestrom Level 3 max. 27 A (1296 W) pro WR (3888 W)
###############

my $cofc = ReadingsNum ($name, 'special_todayConForecastTillSunset', 0);
my $pvfc = ReadingsNum ($name, 'RestOfDayPVforecast', 0);
my $cpv = ReadingsNum ($name, 'Current_PV', 0);
my $mppt1c = ReadingsNum ($mppt1, 'DC_0_Current_value', 0); # Load I MPPT1 (max. 44 A)
my $ssts = CurrentVal ($hash, 'sunsetTodayTs', 0);
my $srts = CurrentVal ($hash, 'sunriseTodayTs', 0);
my $sdiff = ($ssts - $srts) / 3600; # Sonnengang heute in h

my $solh = ReadingsNum ($name, 'special_SunHours_Remain', 0); # h bis SunSet
$solh = $solh - ($sdiff * $sch); # h bis SunSet - X
$solh = $solh < 0 ? 0 : $solh;

my $ahrem = ReadingsNum ($batdev, 'EnergyRemain', 0) / 48; # Ah Bat bis SOC
$ahrem = sprintf "%.0f", $ahrem;

my $fcdiff = ($pvfc - $cofc) * $spcorr; # Korrektur d. noch prognostizierten Überschussenergie
$fcdiff = $fcdiff < 0 ? 0 : $fcdiff; # Wh

my $loadcur = $maxcspc;

if ($cpv && $solh && $ahrem && $fcdiff > $ahrem) { # Ladeanforderung und Überschuss übersteigt
# Lademenge
my $cspc = sprintf "%.2f", ($ahrem / $solh); # A = Ah / h -> A Soll Schätzung

Log3 ($name, 3, qq{$name - userFn -> Battery charging process should be completed }.
qq{in >$solh< hours});
Log3 ($name, 3, qq{$name - userFn -> raw Target charging current: $cspc});

$cspc = sprintf "%.2f", ($cspc - $mppt1c); # SmartLoader IST berücksichtigen

Log3 ($name, 3, qq{$name - userFn -> Charge Current minus MPPT load Current >$mppt1c<: $cspc});

$loadcur = $cspc <= 0 ? 0 : # nur MPPT Ladung
$cspc <= $cclvl0 ? $cclvl0 : # Übergangsbereich
$cspc <= $cclvl1 ? $cclvl1 : # Ladung mit Level 1 Leistung
$cspc <= $cclvl2 ? $cclvl2 : # Ladung mit Level 2 Leistung
$cspc <= $cclvl3 ? $cclvl3 : # Ladung mit Level 3 Leistung
$maxcspc; # max. Ladesollstrom

Log3 ($name, 3, qq{$name - userFn -> MaxChargeCurrent calculated: $loadcur});
}

readingsSingleUpdate ($hash, 'userFn_Bat_MaxChargeCurrent', $loadcur.' A', 1);
readingsSingleUpdate ($hash, 'userFn_Bat_HoursUntilChargeFinish', sprintf ("%.2f",$solh), 1);
CommandSet (undef, "$vebus MaxChargeCurrent $loadcur");
}
</syntaxhighlight>

[[Datei:Screenshot 2023-05-03 201457.png|right|thumb|300px|Vorhersage PV Erzeugung und Energieverbrauch des (restlichen) Tages]]
Zunächst wird der am aktuellen Tag zu erwartende Totalüberschuss solarer Energie ermittelt. Das erfolgt aus der Differenz von ''RestOfDayPVforecast'' und ''RestOfDayConsumptionForecast'' unter Berücksichtigung eines Sicherheitsabschlages. Das Ergebnis liegt in Wh vor und wird bezogen auf 48 V (die Spannung des Batteriesystems) in Ah umgerechnet.

Die noch benötigte Ladung der Batterie zur Erreichung des Soll SOC-Wertes ermittelt das ReadingsNum ''special_SunHours_Remain'' aus dem Batteriedevice, welches vom Modulreading ''currentBatteryDev'' ausgelesen wird.

Sofern der so ermittelte solare Überschuss des (Rest)Tages die benötigte Lademenge der Batterie übersteigt, wird der DC Ladestrom so verringert, dass er sich in einem effizienten Bereich des MultiPlus II bewegt und dennoch rechnerisch ausreicht auf den Soll SOC-Wert zu laden.

Zu diesem Zweck wird im Modul über die Auswahl von ''SunHours_Remain'' im Attribut ''ctrlStatisticReadings'' das zusätzliche Reading ''special_SunHours_Remain'' erzeugt. Aus dem (noch) erforderlichen Ladungswert '''EnergyRemain''' (Ah) und der um eine Sicherheitszeit (''Verkürzungsfaktor Zeit bis Vollladung vor Sunset'') reduzierte Zeit bis zum Sonnenuntergang wird die rechnerisch erforderliche mindest Ladestromstärke ermittelt.

Dieser Wert wird auf die zu Anfang des Codeblocks definierten Ladelevel (''Ladestrom Level X'') abstrahiert und ein passender '''effizienter''' Ladestrom-Bereich ausgewählt.

[[Datei:Screenshot 2023-05-03 201719.png|right|thumb|300px|Vorhersage PV Erzeugung und Energieverbrauch des (restlichen) Tages]]

In allen anderen Fällen, wenn z.B. rechnerisch nicht genügend oder keine Solarenergie erzeugt wird (Nachts) oder der Speicher gefüllt ist, wird der maximale (Sollwert) des Ladestroms ''$maxcspc = 35'' eingestellt. Dieser Wert entspricht dem maximalen Ladestrom gemäß Herstellerunterlagen Pylontech.

Die Einstellung erfolgt per Set-Kommando im Victron vebus MQTT Device ''MQTT2_cerboGX_c0619ab34e08_vebus''. Dieses Device wurde auch während der MQTT Intergration des Victron Systems angelegt und wird hier nicht näher diskutiert.
Zur Kontrolle des kalkulierten Wertes werden noch die Readings ''SolCast_userFn_MaxChargeCurrent'' im Batteriedevice und ''userFn_Bat_MaxChargeCurrent'' im SolarForecast Device generiert.

Neben der Effizienzoptimierung hat dieses Verfahren auch den Vorteil einer möglichst schonenden Batterieaufladung was der Lebensdauer der Komponenten zugute kommen sollte.

=== Poolheizung in Abhängigkeit von vorhandenem Photovoltaik-Überschuss aktivieren/deaktivieren (Eigenverbrauch optimieren) ===
Eine (Whirl-)Poolheizung soll bei ausreichend überschüssiger Energie aus einer Photovoltaikanlage dynamisch gesteuert werden (Eigenverbrauchsoptimierung). Im folgenden Beispiel ist ein Device mit der Bezeichnung ''Forecast'' des Typs ''SolarForecast bereits'' angelegt und konfiguriert. Ein freies Consumer-Attribut ''consumer01'' wird beispielhaft wie folgt definiert:

<syntaxhighlight lang="perl">
attr Forecast consumer01 MQTT2_layzspa type=other power=1950 mode=can on="heater on" off="heater off" pcurr=WATT interruptable=1 swstate=heaterstate:1:0 auto=Automatiksteuerung mintime=SunPath spignorecond=EVCharger22:LadungMitPVUeberschussActive:1 icon=scene_pool notbefore=8 notafter=20
</syntaxhighlight>

Die Poolheizung ist innerhalb FHEM bereits im Device ''MQTT2_layzspa'' integriert und lässt sich normalerweise per FHEM-Befehl "set ''MQTT2_layzspa heater on"'' oder ''"set MQTT2_layzspa heater off"'' steuern. Entsprechend werden die Schlüssel-Wert-Paare ''"on="'' und ''"off="'' definiert.

Der Stromverbrauch einer aktiven Poolheizung ist uns bekannt und wird im Schlüssel ''"power=1950"'' definiert. Die Heizfunktion soll nur bei ausreichend Überschuss aktiviert werden dürfen und muss bei Unterschreitung sofort abgeschaltet werden. Diese Eigenschaften werden über die Schlüssel ''"mode=can"'' und ''"interruptable="1"'' festgelegt. Zuletzt soll grundsätzlich nur in der Zeit zwischen 08:00 Uhr bis 20:00 Uhr geheizt werden dürfen.

Die Schlüssel ''"notbefore=8"'' und ''"notafter=20"'' legen diese Eigenschaften fest. Zur Anzeige des Schaltzustands der Heizung wurde der Schlüssel ''"swstate=heaterstate:1:0"'' hinzugefügt (Wert 1 = Heizung aktiv, Wert 0= Heizung aus).

==== Priorisierung vor externen PV-Überschuss gesteuerten Verbrauchern ====
Der Schlüssel-Wert '''"spignorecond="''' bietet optional die Möglichkeit, einen Consumer auch ohne ausreichend PV-Überschuss einzuschalten. Bei erfüllter Bedingung wird der Verbraucher entsprechend der Planung eingeschaltet auch wenn zu dem Zeitpunkt kein PV Überschuss vorliegt. Im obigen Beispiel existiert in der Haus-Elektroinstallation eine Elektroauto-Ladestation mit eigener (externer) dynamischer PV-gesteuerter Fahrzeugladung ohne Integration in ''SolarForecast''.

In Abhängigkeit von PV-Generatorleistung und Sonneneinstrahlung besteht manchmal eine Möglichkeit, dass der gesamte PV-Überschuss zur Fahrzeugladung genutzt wird. Das Modul SolarForecast würde entsprechend keinen (oder zu wenig) PV-Überschuss erkennen und den Consumer ''MQTT2_layzspa'' nicht aktivieren.

Durch Verwendung von ''spignorecond=EVCharger22:LadungMitPVUeberschussActive:1'' wird die Poolheizung gegenüber der Ladestation jedoch priorisiert mit PV-Überschuss versorgt. In diesem Beispiel wird Consumer1 aktiviert, wenn die Ladestation "''EVCharger22''" sich im PV-Überschuss-Modus befindet '''und''' momentan ein Fahrzeug lädt. In der Folge würde der Hausstromverbrauch um ca. 1950 Watt steigen, die externe Fahrzeugladestation diese Änderung registrieren und die Fahrzeugladeleistung entsprechend verringern oder ganz abbrechen.

=== Luftentfeuchter PV-Überschuss gesteuert mit externer Zwangs-Einschaltbedingung ===
Im folgenden Beispiel wird ein Luftentfeuchter normalerweise nur bei ausreichend PV-Überschuss Energie eingeschaltet (Eigenverbrauchsoptimierung), soll jedoch bei hoher Luftfeuchtigkeit zusätzlich aktiviert werden.<syntaxhighlight lang="perl">
attr Forecast SolarForecast ShellyPlug1 type=other power=300 mode=can on=on off=off pcurr=power:W interruptable=1 swstate=state:on:off mintime=SunPath locktime=900 notbefore=07 notafter=22 spignorecond=ESPEasy_ESP_Easy1_am2302_sensor:humidity:high icon=Ventilator_fett
</syntaxhighlight>Das in FHEM bereits angelegte Device namens ''ShellyPlug1'' dient als Zwischenstecker zur Steuerung des Luftentfeuchters. Der Schlüsselwert "''mintime=SunPath''" definiert die zeitliche Einplanung von Sonnenauf- bis untergang. Jedoch soll das Gerät unter keinen Umständen in der Nacht eingeschaltet werden, was über die Schlüssel ''"notbefore=07"'' bzw. ''"notafter=22"'' festgelegt ist. Weiterhin wurde im Schlüssel ''"locktime=900"'' festgelegt, dass zwischen (möglichen) Ein- und Ausschaltintervallen wenigstens 15 Minuten Wartezeit vergehen soll.

Der Schlüssel-Wert '''"spignorecond="''' bietet optional die Möglichkeit, ein Consumer bei erfüllter Bedingung auch ohne ausreichend PV-Überschuss einzuschalten. In diesem Beispiel wird ein Raumluftsensor abgefragt. Bei Vorhandensein der Einschaltschwelle "high" aktiviert sich der Consumer zur geplanten Laufzeit zwischen 07:00 bis 22:00 Uhr solange, bis der Raumluftsensor einen abweichenden Wert meldet.

=== PV-Vorhersage an evcc übertragen (PV-Überschussladen von E-Autos über steuerbare Wallboxen) ===
[https://evcc.io evcc] ist ein Energie-Management-System, mit dem u.a. Überschussladen von Elektroautos möglich ist. Hier ist beschreiben, wie die SolarForecast-Vorhersagedaten per API von evcc abgerufen werden.
Lege im SolarForecast-Device ein User-Reading mit dem Namen forecast_json an. Es wandelt die Forecast-Werte in JSON und ins UTC-Zeitformat um, so dass evcc die Daten einlesen kann. Der Code wird nur ausgeführt, wenn das Reading nextCycletime ein Event erzeugt.<syntaxhighlight lang="perl">

forecast_json:nextCycletime.* {

use strict;
use warnings;
use JSON;
use DateTime;
use DateTime::Format::Strptime;

my $hour = 0;
my $last_start_ts;
my @output;

# Parser für Datum mit CET/CEST
my $parser = DateTime::Format::Strptime->new(
pattern => "%Y-%m-%d %H:%M:%S",
time_zone => "Europe/Berlin",
);
my $start_ts;

# Alle NextHour-Daten durchsuchen (als Fallback zur Vermeidung einer Endlosschleife auf max. 100 Std. begrenzen)
while ($hour < 100) {
my $hour_str = sprintf("NextHour%02d", $hour);
my $start_str = FHEM::SolarForecast::NexthoursVal("$NAME", $hour_str, "starttime", "na");
my $pvfc = FHEM::SolarForecast::NexthoursVal("$NAME", $hour_str, "pvfc", "na");

# Schleife beenden, wenn keine Vorhersage-Werte mehr vorhanden sind
last if $start_str eq "na" or $pvfc eq "na";

$start_ts = $parser->parse_datetime($start_str); # Zeitzone und Sommer/Winterzeit berücksichtigen

# Zeit nach UTC und ISO 8601 konvertieren und Vorhersagewert ergänzen
push @output, {
start => $start_ts->set_time_zone("UTC")->iso8601() . "Z",
end => $start_ts->add(hours => 1)->set_time_zone("UTC")->iso8601() . "Z",
value => 0 + $pvfc,
};
$hour++;
}

# Prüfen, ob der letzte Wert 23 Uhr war -> zusätzliche Stunde anhängen, damit der Tag
# bei evcc als vollständig angezeigt wird (siehe https://github.com/evcc-io/evcc/issues/22979)
if ($start_ts->hour == 23) {

# Zeit nach UTC und ISO 8601 konvertieren und Vorhersagewert ergänzen
push @output, {
start => $start_ts->set_time_zone("UTC")->iso8601() . "Z",
end => $start_ts->add(hours => 1)->set_time_zone("UTC")->iso8601() . "Z",
value => 0,
};
}

# Ausgabe als JSON
my $json = JSON->new->utf8->pretty->encode(\@output);
return $json;
},
</syntaxhighlight>
[[Datei:Screenshot 2025-08-04 104835.png|right|thumb|300px|Darstellung der PV-Vorhersage in evcc auf Basis der SolarForecast-Daten]]
Die Kommunikation läuft über den integrierten FHEM-Webserver, der die JSON-Daten aus dem Reading forecast_json veröffentlicht. Dazu wird in FHEM eine separate Webinstanz auf einem neuen Port erstellt, die ohne [[CsrfToken-HowTo|CSFR-Token]] (Achtung, Auswirkungen auf die Sicherheit beachten!) und nur von localhost aufrufbar ist (Voraussetzung: evcc läuft auf derselben Maschine wie FHEM):<syntaxhighlight>
define WEBapi FHEMWEB 8089
attr WEBapi csrfToken none
</syntaxhighlight>In der [https://docs.evcc.io/docs/tariffs#pv-vorhersage evcc-Konfig unter tariffs] steht die Quelle für die Solar-Vorhersage. Der FHEM-Befehl {ReadingsVal('solarforecast_dev','forecast_json','[]')} wird encoded und in die uri eingetragen. Trage statt solarforecast_dev den passenden Namen deines SolarForecast-Device ein. evcc holt die Daten aus dem Reading forecast_json dann regelmäßig ab.<syntaxhighlight lang="yaml">
solar:
type: custom
interval: 20m
forecast:
source: http
uri: http://localhost:8089/fhem?cmd=%7BReadingsVal%28%27solarforecast_dev%27%2C%27forecast_json%27%2C%27%5B%5D%27%29%7D&XHR=1
</syntaxhighlight>Zur Verbesserung der Sicherheit kann das neue WEBapi Device auch ein [[CsrfToken-HowTo#csrfToken festlegen|festes CSFR-Token]] verwenden. Dieses Token muss dann in der evcc-Konfiguration an die uri mittels &fwcsrf=<festes token> angehängt werden.

=== Poolsteuerung inkl. Eigenverbrauchsoptimierung und zusätzlichem Verbraucher, um Einspeiselimit zu vermeiden + manuelle Steuerung durch Sonderprogramme ===
'''Vorhandene Hardware:'''

* Poolpumpe, die über mehrere Stufen verfügt. Hier werden zwei verwendet.
** Pump Low: Energiesparprogramm um den Pool umzuwälzen, auch wenn nicht genug PV Leistung zur Verfügung steht. -> ca. 250W
** Pump High: Normalbetrieb wenn genug PV Überschuss zur Verfügung steht. -> ca. 800W zusätzlich
* Poolheizung: Wärmepumpe -> ca. 1,5kW elektrisch
* Nachbars Pool: Pumpe + Salzanlage +pH-Regler -> ca. 650W

'''Anforderungen:'''

* Pool muss täglich mindestens 1x umgewälzt werden.
* Im Idealfall wird der Pool > 2x umgewälzt.
* Bei genügend Überschuss soll der Pool geheizt werden. Es soll nur Sonnenstrom für die Poolheizung verwendet werden.
* Um das Einspeiselimit zu vermeiden, soll auch geheizt werden, wenn der Pool schon warm genug ist. (>28,5 °C)
* Sollte trotzdem noch das Einspeiselimit erreicht werden, soll auch der Pool des Nachbarn versorgt werden.

'''Herausforderungen:'''

* Verbraucher dürfen nur in einer gewissen Reihenfolge geschaltet werden, auch wenn der Überschuss eine andere Reihenfolge ergeben würde.
* Pumpe mit mehreren Stufen muss als zwei Consumer abgebildet werden, um die Schaltlogik in SolarForecast abzubilden. Würde die Trennung außerhalb von Solarforecast realisiert, könnte Solarforecast den Verbraucher schlechter "lernen", denn dann wäre es ein Consumer mit ständig wechselndem Verbrauch.
* Pool des Nachbarn darf nicht laut der benötigten Leistung geschaltet werden, sondern in Abhängigkeit der Einspeisebegrenzung.

In diesem Solarforcast-Device sind 16 Verbraucher definiert. Im Weiteren werden jedoch nur die verwendeten betrachtet. Da diese Reglung mittlerweile recht komplex ist, werden auch viele Dinge, die nicht SolarForcast betreffen, aber trotzdem dazu gehören, gezeigt. Es trägt zum Verständnis bei und man kann sich hier sicher Ideen holen.

'''Ergebnis:'''

In den folgenden beiden Bildern sieht man das Regelverhalten recht gut.
[[Datei:Mustertag ohne Wolken.jpg|zentriert|mini|823x823px|Wolkenloser Tag]]
Hier erkennt man gut das Einschalten der jeweiligen Verbraucher (Pump Low, Pump High, Wärmepumpe und Nachbar Pool). Die Wärempumpe schaltet erst bei 5kW Überschuss ein, da der Pool eigentlich schon warm genug ist. Sie dient "nur" dazu, das EInspeiselimit zu verhindern.Auch das Auschalten ist wieder deutlich zu erkennen. Die Regleung folgt dem Überschuss recht gut. (Die Leistungsspitzen auf dem Plateau sind normale Großverbraucher im Haus.)
[[Datei:Wechselhaft.jpg|zentriert|mini|818x818px|Wechselhafter Tag.]]
In diesem Bild sieht man das "verzweifelte" Regeln um das wechselhafte Wetter auszugleichen. Hier gibt es keine korrekte Reaktion und es wird durch die Sperrzeiten und andere Delays versucht, ein zu häufiges hin- und herschalten möglichst zu vermeiden. In Summe aber auch bei so einem Wetter ein akzeptables Verhalten.

'''Definition der Consumer:'''

'''Allgemeine Erklärungen zu den Definitionen:'''

'''asynchron=0''': Da hier die Werte des Überschusses für das Timing der Schaltvorgänge verwendet werden, darf hier keine Eventsteuerung verwendet werden. Sonst kann man nicht mehr sagen, über welchen Zeitraum der Mittelwert oder der Median gebildet wurde. Dafür wurde die Zykluszeit des SolarForecast-Device auf 60 Sekunden geändert, um die Überlegungen zu vereinfachen. Bei Event-Steuerung könnte man nicht sagen ob die letzten 10 Events in den letzten 5 Sekunden oder in den letzten 10 Minuten aufgetreten sind.

'''power=xxx''': Wurde teilweise etwas höher als der tatsächliche Wert gewählt, um nach dem Einschalten sicherzustellen, dass nicht sofort der gesamte Überschuss "verbraucht" wird und somit gleich wieder abgeschaltet wird.

'''auto=xxx''': Jeder Verbraucher benötigt sein eigenes auto-Reading, da die Automatik für die Regelung in verschiedenen Stufen ein- und ausgeschaltet werden muss.

'''dum_valve''': Dummy-Device in dem die Zustände der Regelung abgebildet werden. Notifys lesen bzw. befüllen diesen Dummy und steuern dann die Hardware bzw. wird der Dummy durch Werte aus der Hardware passend befüllt.

'''surpmeth=median_xx:''' Durch das asynchron=0 in allen Consumern und beim Generator wird von Solarforcast genau alle 60 Sekunden ein Zyklus ausgeführt. Das führt dazu, dass der Median genau über xx Minuten gebildet wird.

'''locktime=xx:xx''': Sicherheitsvorkehrung, dass nicht zu oft geschaltet werden kann. Schont die Hardware und verhindert ein Schwingen. Abhänging vom geschalteten Gerät. z.B. soll die Wärmepumpe möglichst wenig takten, um die Lebensdauer zu verlängern.

Es gibt dann auch noch einige weitere Sicherheitsvorkehrungen, um diese Regelung möglichst stabil und hardwareschonend zu gestalten. Die Schwierigkeit sind nicht die Bilderbuchtage mit einem glatten Verlauf der PV-Leistung, sondern Tage mit ständig wechselndem Überschuss in der Nähe der Schaltgrenzen.

'''swoncond= dum_valve:sf_true:{main::xxx_On}:''' Hier werden verschiedene Zustände geprüft, um ein Gerät nur dann einzuschalten, wenn es sinnvoll und sicher ist.

Details unter '''99_mySolarForecastUtils.pm'''

'''swoffcond= dum_valve:sf_true:{main::xxx_Off}''': Hier werden verschiedene Zustände geprüft, um ein Gerät nur dann auszuschalten, wenn es sinnvoll und sicher ist.

Details unter '''99_mySolarForecastUtils.pm'''

'''Pump Low: (consumer01)'''<syntaxhighlight lang="perl">
dum_valve:Pool+Low
aliasshort=Low
asynchron=0
auto=pump_low_auto
icon=scene_pool
interruptable=0
mintime=SunPath:0:180
mode=must
noshow=0
notafter=08:00
off="pump_low off"
on="pump_low on"
pcurr=pump_low_power
power=250
surpmeth=median_13
switchdev=dum_valve
swoffcond=dum_valve:sf_true:{main::Check_Pump_Low_Off}
swoncond=dum_valve:sf_true:{main::Check_Pump_Low_On}
swstate=pump_low:on:off
type=other
</syntaxhighlight>Erläuterungen:

* Die Pumpe soll ab Sonnenaufgang, bis 180 Minuten nach Sonnenuntergang (mintime=SunPath:0:180), bei mindestens 250W Überschuss (power=250) gestartet werden.
* Die Pumpe muss spätestens um 8:00 eingeplant werden (notafter=08:00), um das Umwälzen auch bei Schlechtwetter zu garantieren.
* Die Pumpe muss gestartet werden (mode=must) sobald sie eingeplant ist.
* swoncond sorgt dafür, dass sie vor 8:00 nur bei genügend Überschuss gestartet wird, oder es 8:00 ist. swondcond ist mit der eigentlichen Einschaltbedingung (eingeplant und mode=must) UND verknüpft. -> siehe '''99_mySolarForecastUtils.pm'''
* Überschuss wird auch in swoncond mit der gewählten Methode geprüft.
* Die Pumpe darf, wenn sie gestartet wurde, auch bei fehlendem Überschuss nicht mehr unterbrochen werden. (interruptable=0)
* Die Pumpe wird am Ende der Einplanung ausgeschaltet oder wenn swoffcond erfüllt ist. swoffcond wird true, wenn eine gewisse Wassermenge umgewälzt wurde oder die Sicherheitsbedingungen nicht (mehr) erfüllt sind. swoffcond ist mit der eigentlichen Ausschaltbedingung (Planung endet) ODER verknüpft. -> siehe '''99_mySolarForecastUtils.pm'''
* {'''main::'''xxx} dient dazu, um die Funktion xxx in der 99_mySolarForecastUtils.pm aus Solarforecast erreichbar zu machen.
* dum_valve:sf_true ist ein Reading, das fix 1 ist und als Vergleichswert für den in Klammern folgenden Perlcode dient. Wenn dieses Reading und der Perlcode gleich sind (1==1), ist die swoncond bzw swoffcond erfüllt.

'''Pump High: (consumer03)'''<syntaxhighlight lang="perl">
dum_valve:Pool+High
aliasshort=High
type=other power=1000 asynchron=0
auto=pump_high_auto
icon=scene_pool
pcurr=pump_high_power
switchdev=dum_valve
swstate=pump_high:on:off
mode=can
mintime=SunPath
on="pump_high on"
off="pump_high off"
surpmeth=median_5
noshow=0
locktime=180:300
interruptable=1
swoncond=dum_valve:sf_true:{main::Check_Pump_High_On}
swoffcond=dum_valve:sf_true:{main::Check_Pump_High_Off}
</syntaxhighlight>Erläuterungen:

* Pump HIgh ist die selbe Pumpe, aber eine höhere Durchflussmenge
* Der Mehrverbrauch beträgt eigentlich 800W wird hier aber mit 1000W angegeben, um eine Hysterese von ca. 200W zu erreichen und damit ein schnelles Abschalten nach dem Einschalten zu verhindern.
* Diese Stufe wird nur bei genügend Überschuss aktiviert. (mode=can)
* Diese Stufe wird bei fehlendem Überschuss unterbrochen. (interruptable=1)
* Diese Stufe wird nur während Sonnenschein eingeplant. (mintime=SunPath)
* locktime sorgt dafür, dass bei schnell wechselnden Bedingungen, nicht ständig umgeschaltet wird. -> Schonung der Pumpe.
* swoncond und swoffcond -> siehe '''99_mySolarForecastUtils.pm'''

'''Heatpump: (consumer05)'''<syntaxhighlight lang="perl">
Pool_Strom_Heizung:Poolheizung
aliasshort=WP
type=other power=1800 asynchron=0
icon=sani_heating_heatpump
auto=heatpump_auto
pcurr=Pool_Pin32_monotonic_count_PowerCurrent:W
etotal=Pool_Pin32_monotonic_count_EnergyMeter:kWh
switchdev=dum_valve
swstate=heatpump:on:off
mode=can
locktime=600:600
mintime=SunPath
on="heatpump on"
off="heatpump off"
surpmeth=median_13
noshow=0
swoncond=dum_valve:sf_true:{main::CheckWPOn}
interruptable=1
swoffcond=dum_valve:sf_true:{main::CheckWPOff}
</syntaxhighlight>Erläuterungen:

* Der Verbrauch ist hier wieder etwas zu hoch angegeben (1800W statt realen 1500W), um eine Hysterese zu erreichen.
* Da es sich hier um eine Wärmepumpe handelt, die nicht getaktet werden sollte, ist die locktime in beide Schaltrichtungen mit 10 Minuten relativ hoch.
* Die Ermittlung des Medians ist mit 13 Minuten recht lang, um den Überschuss über lange Zeit zu glätten, damit möglichst selten geschaltet wird. Diese 13 Minuten in Kombination mit der Locktime und der Hysterese führten bei dieser Anlage bisher dazu, dass höchstens 5 Zyklen am Tag geschaltet wurden. -> Hier kann das individuelle Schaltverhalten optimiert werden. Besseres Verfolgen des Überschusses vs. weniger Taktungen der Wärmepumpe.
* swoncond und swoffcond -> siehe '''99_mySolarForecastUtils.pm'''

'''Nachbars Pool: (consumer07)'''<syntaxhighlight lang="perl">
Shelly_Plug_S_1:Kurz+Pool
aliasshort=Kurz
type=other power=650 asynchron=0
icon=scene_pool
auto=pool_kurz_auto
pcurr=power:W
switchdev=dum_valve
swstate=pool_kurz:on:off
mode=can
mintime=SunPath
on="pool_kurz on"
off="pool_kurz off"
surpmeth=median_13
noshow=0
interruptable=1
locktime=600:300
swoncond=dum_valve:sf_true:{main::Check_Pool_Kurz_On}
swoffcond=dum_valve:sf_true:{main::Check_Pool_Kurz_Off}
</syntaxhighlight>Erläuterungen:

* Dieser Consumer dient als Einspeisebegrenzungsschutz und wird aktiviert, sobald sich der Überschuss der Einspeisegrenze nähert. -> siehe '''99_mySolarForecastUtils.pm'''
* Verbraucher kann recht träge geschaltet werden. (surpmeth=median_13 und locktime=600:300)
* Consumer wird ausgeschaltet wenn ein gewisser Überschuss unterschritten wird und somit die Einspeisegrenze wieder weit genug weg ist. -> siehe '''99_mySolarForecastUtils.pm'''
'''99_mySolarForecastUtils.pm'''

Hier sind die Funktionen, die für diese Regelung verwendet werden, der Übersichtlichkeit halber in einzelnen Blöcken mit Erklärungen dargestellt.<syntaxhighlight lang="perl">
package main;
use strict;
use warnings;

my $pool_dummy = 'dum_valve';
my $pool_temperature = 'Pool_Temp';
my $flow_sensor = 'Pool_Pin_A0';
my $water_counter_l1 = 'pump_l1_hc';
my $water_counter_l2 = 'pump_l2_hc';
my $target_temp = 28.4; # maximum temperature for heating, without infeed limit
my $pool_kurz_sw_hofb = 'PwSw_Schalter'; # Homematic switch at pool neighbour
my $pool_kurz_sw_kurz = 'Shelly_Plug_S_1'; # Shelly switch for pool Kurz at home

my $pump_low_id = sprintf "%02d", 1;
my $pump_high_id = sprintf "%02d", 3;
my $heatpump_id = sprintf "%02d", 5;
my $pool_kurz_id = sprintf "%02d", 7;

my $switch_delay = 160; # just under three minutes

sub
SolarForecastUtils_Initialize($$)
{
my ($hash) = @_;
}

</syntaxhighlight>

* Hier werden die IDs der Geräte definiert, um über sprechende Namen darauf zugreifen zu können.
* Einige Devices und Parameter, die immer wieder gebraucht werden sind hier angegeben.
* sprintf wird verwendet um sicherzustellen, dass die IDs zweistellig sind. z.B. 3 -> 03

'''Pump Low'''<syntaxhighlight lang="perl">
###################
### Pumpe - LOW ###
###################

sub
Check_Pump_Low_On{
my $name = 'energy_mgmt';
my $surplus = FHEM::SolarForecast::ConsumerVal ($name,$pump_low_id,'surpmethResult','');
my $nom_power = FHEM::SolarForecast::ConsumerVal ($name,$pump_low_id,'power','');
my ($min, $hour) = (localtime())[1,2];
my $timer = 0;
if($hour > 8 || ($hour == 8 && $min >= 0)){$timer=1;}

if(ReadingsVal($pool_dummy,"valve_position","") eq "normal"
&& ReadingsVal($pool_dummy,"special_function","") eq "none"
&& ($surplus > $nom_power
|| $timer
)
)
{
return 1;}
else
{
return 0;}
}

sub
Check_Pump_Low_Off{
my $bath_mode = ReadingsVal($pool_dummy,"bath_mode",0);
my $m3_l1 = ReadingsVal($water_counter_l1,"waterAmount",0);
my $m3_l2 = ReadingsVal($water_counter_l2,"waterAmount",0);
my $water_volume = AttrVal($pool_dummy,"water_volume",42); #42m³
my $desired_cf_l1 = AttrVal($pool_dummy,"desired_cf_l1",0); #circulation_factor_level1
my $desired_cf_l2 = AttrVal($pool_dummy,"desired_cf_l2",0); #circulation_factor_level2
my $bathmode_factor = AttrVal($pool_dummy,"bathmode_factor",1);
my $desired_amount_l1;
my $desired_amount_l2;
my $amount = $m3_l1 + $m3_l2;
if($bath_mode == 1){
$desired_amount_l1 = $desired_cf_l1 * $water_volume;
$desired_amount_l2 = $desired_cf_l2 * $water_volume;
}else{
$desired_amount_l1 = $desired_cf_l1 * $water_volume/$bathmode_factor;
$desired_amount_l2 = $desired_cf_l2 * $water_volume/$bathmode_factor;
}

if(($amount > $desired_amount_l1)
&& (ReadingsVal($pool_dummy,"pump_high","on") eq "off" && ReadingsAge($pool_dummy,"pump_high",0) >160)
&& ReadingsVal($pool_dummy,"special_function","") eq "none"
&& ReadingsVal($pool_dummy,"valve_position","") eq "normal"
)
{
return 1;
}else{
return 0;
}
}

</syntaxhighlight>Einschalten:

* Es wird der errechnete Wert für den Überschuss von SolarForecast verwendet und auch der benötigte Überschuss aus dem Consumer ausgelesen.
* Das Einschalten wird erst durch erfolgreiche Prüfung der Hardwarevoraussetzungen erlaubt. -> Das Motorventil steht richtig und es ist kein Sonderbetrieb (Reinigung, Massage, Winter, o.ä.) aktiv.
* Es muss entweder genügend Überschuss vorhanden sein oder es ist 8:00.

Ausschalten:

* Wenn der Badebetrieb aktiv ist (bath_mode==1, [bei Außentemperatur > 24°C]) wird nach 90m³ Gesamtumwälzung ausgeschaltet.
* Wenn der Badebetrieb nicht aktiv ist (bath_mode==0, [bei Außentemperatur < 20°C]) wird bereits nach 42m³ Gesamtumwälzung ausgeschaltet.
* Prüfung, ob Pump High schon aus ist. Sollte durch die Logik gar nicht möglich sein, aber es könnte manuell oder durch einen (Logik-)Fehler trotzdem eingeschaltet sein.
* Prüfung, ob alle Hardware-Funktionen in einem für die Automatik geeigneten Zustand sind.
* Es wird auch geprüft, ob Pump High seit mindestens 3 Minuten aus ist, um zu verhindern, dass wegen fehlendem Überschuss gleich mehrere Geräte ausgeschaltet werden.
* Da die Zykluszeit 60 Sekunden ist, führen die 160 Sekunden dazu, dass nach drei Minuten(180 Sekunden) ein definierter Wert gilt. Mit 180 Sekunden könnte es manchaml eine Minute mehr sein.

'''Pump High'''<syntaxhighlight lang="perl">
####################
### Pumpe - HIGH ###
####################

sub
Check_Pump_High_On{
my $bath_mode = ReadingsVal($pool_dummy,"bath_mode",0);
my $m3_l1 = ReadingsVal($water_counter_l1,"waterAmount",0);
my $m3_l2 = ReadingsVal($water_counter_l2,"waterAmount",0);
my $water_volume = AttrVal($pool_dummy,"water_volume",42); #42m³
my $desired_cf_l1 = AttrVal($pool_dummy,"desired_cf_l1",0); #circulation_factor_level1
my $desired_cf_l2 = AttrVal($pool_dummy,"desired_cf_l2",0); #circulation_factor_level2
my $bathmode_factor = AttrVal($pool_dummy,"bathmode_factor",1);
my $desired_amount_l1;
my $desired_amount_l2;
my $amount = $m3_l1 + $m3_l2;
if($bath_mode == 1){
$desired_amount_l1 = $desired_cf_l1 * $water_volume;
$desired_amount_l2 = $desired_cf_l2 * $water_volume;
}else{
$desired_amount_l1 = $desired_cf_l1 * $water_volume/$bathmode_factor;
$desired_amount_l2 = $desired_cf_l2 * $water_volume/$bathmode_factor;
}

if(($amount < $desired_amount_l2)
&& ReadingsVal($pool_dummy,"special_function","") eq "none"
&& ReadingsVal($pool_dummy,"valve_position","") eq "normal"
&& (ReadingsVal($pool_dummy,"pump_low","off") eq "on" && ReadingsAge($pool_dummy,"pump_low",0) > $switch_delay)
)
{return 1}
else
{return 0}
}

sub
Check_Pump_High_Off{
my $bath_mode = ReadingsVal($pool_dummy,"bath_mode",0);
my $m3_l1 = ReadingsVal($water_counter_l1,"waterAmount",0);
my $m3_l2 = ReadingsVal($water_counter_l2,"waterAmount",0);
my $water_volume = AttrVal($pool_dummy,"water_volume",42); #42m³
my $desired_cf_l1 = AttrVal($pool_dummy,"desired_cf_l1",0); #circulation_factor_level1
my $desired_cf_l2 = AttrVal($pool_dummy,"desired_cf_l2",0); #circulation_factor_level2
my $bathmode_factor = AttrVal($pool_dummy,"bathmode_factor",1);
my $desired_amount_l1;
my $desired_amount_l2;
my $amount = $m3_l1 + $m3_l2;

if($bath_mode == 1){
$desired_amount_l1 = $desired_cf_l1 * $water_volume;
$desired_amount_l2 = $desired_cf_l2 * $water_volume;
}else{
$desired_amount_l1 = $desired_cf_l1 * $water_volume/$bathmode_factor;
$desired_amount_l2 = $desired_cf_l2 * $water_volume/$bathmode_factor;
}
if(($amount > $desired_amount_l2)
&& (ReadingsVal($pool_dummy,"heatpump","on") eq "off" && ReadingsAge($pool_dummy,"heatpump",0) >160)
&& ReadingsVal($pool_dummy,"special_function","") eq "none"
&& ReadingsVal($pool_dummy,"valve_position","") eq "normal"
)
{return 1}
else
{return 0}
}

</syntaxhighlight>Einschalten:

* Prüfung, ob die gewünschte Umwälzung bezüglich des Badebetriebs noch nicht erreicht wurde.
* Prüfung der Hardwarevoraussetzungen.
* Prüfung, ob Pump Low schon seit mindestens drei Minuten aktiv ist. (sollte eigentlich immer der Fall sein, wenn die Automatik für Pump High aktiv ist)

Ausschalten:

* Prüfung, ob die gewünschte Umwälzung bezüglich des Badebetriebs bereits erreicht wurde.
* Prüfung der Hardwarevoraussetzungen.
* Prüfung, ob die Wärmepumpe schon seit mindestens drei Minuten aus ist. Ermöglicht drei Minuten lang, den Median für den Überschuss zu aktualisieren.

'''Wärmepumpe'''<syntaxhighlight lang="perl">
##################
### Wärempumpe ###
##################
sub
CheckWPOn(){
my $name = 'energy_mgmt';
my $surplus_on = 5000; # minimum surplus to avoid infeed limit with heatpump
my $surplus_restart = 3000; # minimum surplus to re-enable heatpump, when avoidung infeed limit and a big consumer turned the hp off

my $planstate = FHEM::SolarForecast::ConsumerVal ($name,$heatpump_id,'planstate','');
my $surplus = FHEM::SolarForecast::ConsumerVal ($name,$heatpump_id,'surpmethResult','');
if ($planstate =~ /^([^:]+)/) {
$planstate = $1;
}

if(ReadingsVal($flow_sensor,"reading","off") eq "on"
&& (ReadingsVal($pool_dummy,"special_function","") eq "none"
|| ReadingsVal($pool_dummy,"special_function","") eq "party"
)
&& ReadingsVal($pool_dummy,'heat_protection','on') eq "off"
&& ReadingsVal($pool_dummy,"valve_position","") eq "normal"
&& (ReadingsVal($pool_dummy,"pump_high","off") eq "on" && ReadingsAge($pool_dummy,"pump_high",0) > $switch_delay)
&& (ReadingsVal($pool_temperature,"temperature",30) < $target_temp
|| (ReadingsVal($pool_temperature,"temperature",15) >= $target_temp
&& ( $surplus > $surplus_on
|| (($planstate eq "replanned") && ($surplus > $surplus_restart))
)
)
)
)
{return 1}
else
{return 0}
}

sub
CheckWPOff{
my $name = 'energy_mgmt';
my $surplus_off = 1000; #minimum surplus to keep heatpump on, when avoiding infeed limit

my $surplus = FHEM::SolarForecast::ConsumerVal ($name,$heatpump_id,'surpmethResult','');
if((ReadingsVal($flow_sensor,"reading","on") eq "off"
|| !((ReadingsVal($pool_dummy,"special_function","") eq "none")
|| (ReadingsVal($pool_dummy,"special_function","") eq "party")
)
|| ReadingsVal($pool_dummy,'heat_protection','off') eq "on"
|| ReadingsVal($pool_dummy,"valve_position","") ne "normal"
|| ((ReadingsVal($pool_temperature,"temperature",15) > $target_temp)
&& ($surplus < $surplus_off)
)
)
&& (ReadingsVal($pool_dummy,"heatpump","off") eq "on" && ReadingsAge($pool_dummy,"heatpump",0) > $switch_delay)
)
{return 1}
else
{return 0}
}

</syntaxhighlight>Einschalten:

* Prüfung, ob Flussensor ein. (Pool_pin_A0) -> Wasser fließt durch die Wärmepumpe.
* Prüfung, ob Pool in Normal- oder Partybetrieb ist und das Ventil in Normalposition ist. In beiden Fällen läuft Pump High.
* Einschalten wenn genug Überschuss da ist und die Temperatur <28.4°C ist oder wenn über 5000W Überschuss (Einspeisebegrenzung bei 5900W) da ist, egal wie warm der Pool ist.
* Sonderfall: Wenn die Wärmepumpe durch einen/mehrere Großverbrucher "kurz" ausgeschaltet wurde (swoffcond) wird sie ausgeplant. Ein Notify plant sie wieder ein. Wenn das passiert, soll die Wärmepumpe aber wieder bei 3000W Überschuss gestartet werden, um die Energie noch weiter zu nutzen bis der Überschuss unter 1000W fällt. (Hysterese von 500W, da die WP nur 1500W braucht)

Ausschalten:

* Ausschalten sobald hardwaremäßig irgendetwas faul ist. (Betriebsart, Ventilstellung, Durchfluss)
* Ausschalten wenn kein Überschuss. (interruptable=1)
* Wenn Wassertemperatur über 28,5°C und der Überschuss kleiner als 1000W ist.
* Nur schalten, wenn Wärmepumpe läuft und seit mindestens drei Minuten läuft (Sicherheit). Das verhindert das erneute Triggern des Notifys, wenn die Pumpe schon aus ist. Sollte nicht passieren, aber sicher ist sicher.

'''Nachbar Pool'''<syntaxhighlight lang="perl">
###################
### Pool - KURZ ###
###################
sub
Check_Pool_Kurz_On{
my $name = 'energy_mgmt';
my $surplus = FHEM::SolarForecast::ConsumerVal ($name,$pool_kurz_id,'surpmethResult','');
if(($surplus > 3000)
&& ((ReadingsVal($pool_dummy,"heatpump","off") eq "on" && ReadingsAge($pool_dummy,"heatpump",0) >160) || ReadingsVal($pool_dummy,'heat_protection','off') eq 'on' ))
{return 1}
else
{return 0}
}

sub
Check_Pool_Kurz_Off{
my $name = 'energy_mgmt';
my $surplus = FHEM::SolarForecast::ConsumerVal ($name,$pool_kurz_id,'surpmethResult','');
if(($surplus < 1000 )
&& (ReadingsVal($pool_dummy,"pool_kurz","off") eq "on" && ReadingsAge($pool_dummy,"pool_kurz",0) >160))
{return 1}
else
{return 0}
}
</syntaxhighlight>Einschalten:

* Überschuss ist nahe der Einspeisegrenze (5900W) und Wärmepumpe läuft seit mindestens drei Minuten. Es wird schon bei 3000W eingeschaltet, um dem Nachbarn etwas Gutes zu tun ;-)

Ausschalten:

* Überschuss ist unter 1000W. -> Um noch Reserven für den eigenen Verbrauch zu haben.

'''Hilfsfunktionen'''

'''ctrlUserExitFn'''

Hier erfolgt nach jedem Zyklus die Festlegung der verschiedenen Automatikmodi.<syntaxhighlight lang="perl">
#############################################################
##################### Exit Function #########################
#############################################################
my $ctrl_dummy = "dum_valve"; # dummy device for pool-control
my $automatic = ReadingsNum($ctrl_dummy,"sf_automatic",1);

if($automatic){

my $pump_low_state = ReadingsVal($ctrl_dummy,'pump_low','on');
my $pump_low_auto = FHEM::SolarForecast::ConsumerVal ($name, $pump_low_id, 'auto', ''); # Automatikmodus der Pumpe

my $pump_high_state = ReadingsVal($ctrl_dummy,'pump_high','on');
my $pump_high_auto = FHEM::SolarForecast::ConsumerVal ($name, $pump_high_id, 'auto', ''); # Automatikmodus der Pumpe

my $heatpump_state = ReadingsVal($ctrl_dummy,'heatpump','on');
my $heatpump_auto = FHEM::SolarForecast::ConsumerVal ($name, $heatpump_id, 'auto', ''); # Automatikmodus der Wärmepumpe
my $pool_heat_protection = ReadingsVal($ctrl_dummy,'heat_protection','on');

my $pool_kurz_state = ReadingsVal($ctrl_dummy,'pool_kurz','on');
my $pool_kurz_auto = FHEM::SolarForecast::ConsumerVal ($name, $pool_kurz_id, 'auto', ''); # Automatikmodus des Pools

my $pump_low_delay = FHEM::SolarForecast::ConsumerVal ($name, $pump_low_id, 'surpmeth', '');
if ($pump_low_delay =~ /_(\d+)/) {
$pump_low_delay = int(($1/2 + 1) * 60);
Log3 ("SolarForecast", 1, "SolarForecast: pump_low_delay: $pump_low_delay");
} else {
$pump_low_delay = 220;
Log3 ("SolarForecast", 1, "SolarForecast: warning - surpmeth for pump_low is: $pump_low_delay, but must be given as method_number, using fallback value");
}

my $pump_high_delay = FHEM::SolarForecast::ConsumerVal ($name, $pump_high_id, 'surpmeth', '');
if ($pump_high_delay =~ /_(\d+)/) {
$pump_high_delay = int(($1/2 + 1) * 60);
} else {
$pump_high_delay = 160;
Log3 ("SolarForecast", 1, "SolarForecast: warning - surpmeth for pump_high is: $pump_high_delay, but must be given as method_number, using fallback value");
}

my $heatpump_delay = FHEM::SolarForecast::ConsumerVal ($name, $heatpump_id, 'surpmeth', '');
if ($heatpump_delay =~ /_(\d+)/) {
$heatpump_delay = int(($1/2 + 1) * 60);
} else {
$heatpump_delay = 290;
Log3 ("SolarForecast", 1, "SolarForecast: warning - surpmeth for heatpump is: $heatpump_delay, but must be given as method_number, using fallback value");
}

my $pool_kurz_delay = FHEM::SolarForecast::ConsumerVal ($name, $pool_kurz_id, 'surpmeth', '');
if ($pool_kurz_delay =~ /_(\d+)/) {
$pool_kurz_delay = int(($1/2 + 1) * 60);
} else {
$pool_kurz_delay = 160;
Log3 ("SolarForecast", 1, "SolarForecast: warning - surpmeth for pool_kurz is: $pool_kurz_delay, but must be given as method_number");
}

############################
# Überhitzungsschutz aktiv #
############################

if($pool_heat_protection eq 'on'){
if($heatpump_auto == 1){
fhem("set $ctrl_dummy heatpump_auto 0");
}
if($heatpump_state eq "on"){
fhem("set $ctrl_dummy heatpump off")
}
#################
#### on-chain ###
#################
if($pump_low_state eq "on" && ReadingsAge($ctrl_dummy,'pump_low',0) > $pump_high_delay && $pump_high_auto == 0 && $pool_kurz_auto == 0){
fhem("set $ctrl_dummy pump_high_auto 1");
}elsif($pump_high_state eq "on" && ReadingsAge($ctrl_dummy,'pump_high',0) > $pool_kurz_delay && $pool_kurz_auto == 0 && $pump_high_auto == 1){
fhem("set $ctrl_dummy pool_kurz_auto 1");
}elsif($pool_kurz_state eq "on" && $pool_kurz_auto == 1 && $pump_high_auto == 1){
fhem("set $ctrl_dummy pump_high_auto 0");
}

#################
### off-chain ###
#################
if($pool_kurz_state eq "off" && ReadingsAge($ctrl_dummy,'pool_kurz',0) > $pump_high_delay && $pool_kurz_auto == 1 && $pump_high_auto == 0){
fhem("set $ctrl_dummy pump_high_auto 1");
}elsif($pump_high_state eq "off" && $pump_high_auto == 1 && $pool_kurz_auto == 1){
fhem("set $ctrl_dummy pool_kurz_auto 0");
}elsif($pump_low_state eq "off" && $pump_high_state eq "off" && $pump_high_auto == 1 && $pool_kurz_auto == 0){
fhem("set $ctrl_dummy pump_high_auto 0");
}
##################################
# Überhitzungsschutz nicht aktiv #
##################################
}else{
if($heatpump_auto == 0 && $heatpump_state eq "off"){
if($pool_kurz_state eq "on"){
fhem("set $ctrl_dummy pool_kurz off");
}
if($pool_kurz_auto == 1){
fhem("set $ctrl_dummy pool_kurz_auto 0");
}
}
#################
#### on-chain ###
#################
if($pump_low_state eq "on" && ReadingsAge($ctrl_dummy,'pump_low',0) > $pump_high_delay && $pump_high_auto == 0 && $heatpump_auto == 0 && $pool_kurz_auto == 0){
fhem("set $ctrl_dummy pump_high_auto 1");
}elsif($pump_high_state eq "on" && ReadingsAge($ctrl_dummy,'pump_high',0) > $heatpump_delay && $heatpump_auto == 0 && $pool_kurz_auto == 0 && $pump_high_auto == 1){
fhem("set $ctrl_dummy heatpump_auto 1");
}elsif($heatpump_state eq "on" && ReadingsAge($ctrl_dummy,'heatpump',0) > $pool_kurz_delay && $pump_high_state eq "on" && $pool_kurz_auto == 0 && $pump_high_auto == 1 && $heatpump_auto == 1){
# pump_high muss on sein, da sonst die automatik ausgeschaltet wird wenn die pumpe gerade interrupted ist.
# Bei unterschiedlichen Medianlängen ist es möglich, dass WP ein ist und pump_high abschaltet wegen surplus == 0
# Nachbarpool würde auf EIN warten, aber pump_high dürfte nicht wieder einschalten, obwohl genügend Überschuss da ist.
fhem("set $ctrl_dummy pump_high_auto 0");
fhem("set $ctrl_dummy pool_kurz_auto 1");
}elsif($pool_kurz_state eq "on" && $pool_kurz_auto == 1 && $heatpump_auto == 1 && $pump_high_auto == 0){
fhem("set $ctrl_dummy heatpump_auto 0");
}

#################
### off-chain ###
#################
if($pool_kurz_state eq "off" && ReadingsAge($ctrl_dummy,'pool_kurz',0) > $heatpump_delay && $pool_kurz_auto == 1 && $heatpump_auto == 0 && $pump_high_auto == 0){
fhem("set $ctrl_dummy heatpump_auto 1");
}elsif($heatpump_state eq "off" && ReadingsAge($ctrl_dummy,'heatpump',0) > $pump_high_delay && $heatpump_auto == 1 && $pump_high_auto == 0 && $pool_kurz_auto == 1){
fhem("set $ctrl_dummy pool_kurz_auto 0");
fhem("set $ctrl_dummy pump_high_auto 1");
}elsif($pump_high_state eq "off" && $heatpump_state eq "off" && $pump_high_auto == 1 && $heatpump_auto == 1 && $pool_kurz_auto == 0){
# heatpump muss aus sein, da sonst vor Ablauf der Locktime die Automatik ausgeschaltet wird und die WP nicht mehr ausschalten kann.
fhem("set $ctrl_dummy heatpump_auto 0");
}elsif($pump_low_state eq "off" && $pump_high_state eq "off" && $pump_high_auto == 1 && $heatpump_auto == 0){
fhem("set $ctrl_dummy pump_high_auto 0");
}
}
}
#################################################
# Check hardware-state vs. reading-state
# re-trigger notify
#################################################
my $delay_retrigger = 100; #delay time to wait until re-trigger the notify

if(ReadingsVal($ctrl_dummy,'pool_kurz','on') eq 'off' && ReadingsAge($ctrl_dummy,'pool_kurz',0) > $delay_retrigger && ReadingsVal($pool_kurz_sw_kurz,'state','off') eq 'on'){
# re-trigger notify
fhem("trigger dum_valve pool_kurz: off");
Log3 ("SolarForecast", 1, "SolarForecast: Pool-Kurz-off must be re-triggered");
DebianMail('clemens@familie-hofbauer.at','Notify Pool Kurz',"Notify hat nicht ausgeschaltet -> re-trigger");
}elsif(ReadingsVal($ctrl_dummy,'pool_kurz','off') eq 'on' && ReadingsAge($ctrl_dummy,'pool_kurz',0) > $delay_retrigger && ReadingsVal($pool_kurz_sw_kurz,'state','on') eq 'off'){
# re-trigger notify
fhem("trigger dum_valve pool_kurz: on");
Log3 ("SolarForecast", 1, "SolarForecast: Pool-Kurz-on must be re-triggered");
DebianMail('clemens@familie-hofbauer.at','Notify Pool Kurz',"Notify hat nicht eingeschaltet -> re-trigger");
}elsif((ReadingsVal($pool_kurz_sw_kurz,'state','off') eq 'set_on' || ReadingsVal($pool_kurz_sw_kurz,'state','off') eq 'set_off') && ReadingsAge($pool_kurz_sw_kurz,'state',0) > $delay_retrigger){
# state not clear
Log3 ("SolarForecast", 1, "SolarForecast: Pool-Kurz state unclear");
DebianMail('clemens@familie-hofbauer.at','Status Pool Kurz unklar',"Status HM-Schalter set_xx");
}

}
1;
</syntaxhighlight>
'''Erläuterungen:'''

* '''Verzögerungen der einzelnen Stufen:'''
** Die delays der einzelnen Stufen werden aus den surpmethods berechnet. Das dient dazu, dass der Median mit den Werten nach dem ein-/ausschalten des vorheriegen Verbrauchers bis zur Hälfte + einen Wert gefüllt wird und somit sicher das Umschalten des vorherigen Verbrauchers den Median nicht mehr beeinflusst.
* '''Überhitzungsschutz:'''
** Da durch die Wärmepumpe Überschuss "verheizt" wird, der durch das Einspeiselimit gar nicht produziert würde, kann es vorkommen, dass der Pool unangenehm warm wird.
** Um das zu vermeiden gibt es ein Reading, welches gesetzt wird, wenn der Pool eine gewisse Temperatur überschreitet. Dieses Setzen und Zurücksetzen erfolgt mit einer Hysterese von 0.2°C, um ein Takten der Wärmepumpe zu verhindern. Diese 0.4°C sind bei dieser Wassermenge einige Stunden.
** Wenn der Überhitzungsschutz aktiv ist, wird die Wärmepumpe in der Kette übersprungen.
** Wenn sich der Hitzeschutz während des Betriebs ändert, wird die Wärmepumpe bzw. der Pool vom Nachbarn passend ausgeschaltet und die Modi entsprechend gesetzt.
* '''On-chain:'''
** Wenn am Morgen Pump Low seit $pump_low_delay aktiv ist und alle folgenden Consumer noch nicht, dann wird die nächste Stufe freigegeben. -> Pump High
** Wenn Pump High seit $pump_high_delay aktiv ist und alle folgenden Consumer noch nicht, wird die Wärmepumpe freigegeben. -> Heatpump
** Wenn die Wärmepumpe seit $heatpump_delay aktiv ist und der letzte Consumer noch nicht, wird der letzte Verbraucher freigegeben. -> Pool Kurz Gleichzeitig wird die Automatik für Pump High ausgeschaltet, da dieser Verbraucher erst unterbrochen werden darf wenn die Wärmepumpe aus ist!
** Wenn der letzte Verbraucher aktiviert ist, wird die Automatik der Wärmepumpe deaktiviert, da ja zuerst der letzte Verbraucher (Pool Kurz) wieder ausgeschaltet werden muss, bevor der vorletzte (Wärmepumpe) wieder ausgeschaltet werden darf. Da es keinen nachfolgenden Verbraucher mehr gibt, kann hier auf ein delay verzichtet werden, da es nicht passieren kann, dass zwei Verbraucher wegen sehr hohem Überschuss unmittelbar hintereinander geschaltet werden können.
[[Datei:Poolsteuerung mit unterschiedlichen Automatikmodi.jpg|alternativtext=Poolsteuerung|mini|Consumer der Poolsteuerung|500x500px]]
'''Wichtig:''' Es dürfen immer nur maximal zwei unterbrechbare Consumer im Automatikmodus sein. Der "aktuelle", der ja aufgrund von fehlendem Überschuss jederzeit unterbrochen werden kann und der "folgende" Consumer, der auf das Einschalten wartet. Pump Low ist immer im Automatikmodus, da diese nie unterbrochen wird. (mode=must, interruptable=0)

* '''Off-chain:'''
** Wenn der letzte Verbraucher seit mindestens der delay-Zeit aufgrund von fehlendem Überschuss inaktiv war, im Automatikmodus ist und der vorherige Verbraucher nicht im Automatikmodus ist, wird der vorherige Verbraucher in den Automatikmodus geschaltet und wartet jetzt auch auf das Ausschalten. Wenn der Überschuss steigt, springt man wieder in die on-chain und der letzte Verbraucher wird eingeschaltet und die Automatik des vorletzten Verbrauchers deaktiviert.
** Wenn die Wärmepumpe seit mindestens der delay-Zeit aus ist, sich im Automatikmodus befind und Pump High noch nicht im Automatikmodus ist, wird die Automatik für den Nachbarpool ausgeschaltet, da er ja jetzt nicht mehr einschalten darf, da zuerst die Wärmepumpe ein sein müsste. Die Automatik von Pump High wird wieder aktiviert, da diese jetzt auf das Ausschalten wartet. Steigt der Überschuss wieder, wird in den entsprechenden On-chain Zweig gesprungen.
** Wenn Pump High mindestens die delay-Zeit aus ist, wird die Automatik der Wärmepumpe deaktiviert, da diese ja erst einschalten darf, wenn Pump High wieder läuft. Steigender Überschuss führt wieder zum aktivieren von Pump High und zum Sprung in den entsprechenden On-chain Zweig.
** Wenn Pump Low ausgeschaltet wird, wird sofort die Automatik für Pump High ausgeschaltet, da durch das spätere Ausschalten von (der evtl. wieder eingeschalteten) Pump High, hardwaremäßig wieder Pump Low aktiviert wird, aber durch SolarForecast nie ausgeschaltet wird, da Pump Low vor ein paar Minuten ja schon logisch ausgeschaltet wurde.

'''Wichtig:''' Es dürfen immer nur maximal zwei unterbrechbare Consumer im Automatikmodus sein. Der "aktuelle", der ja aufgrund von neuem Überschuss jederzeit wieder gestartet werden kann und der "vorherige" Consumer, der auf das Ausschalten wartet.

* '''Synchronisation Hardware vs. Reading:'''Manchmal passiert es, dass durch die etwas aufwendigen Umschaltprozesse die Hardware dem Reading nicht folgt/folgen kann. Evtl. Gründe sind Funkunterbrechung, verzögerte Umschaltung usw. Daher wird bei jedem Zyklus der Status geprüft und evtl. das event nochmal getriggert, um die Umschaltung erneut auszuführen.<br />

'''Hilfs-Notifys für die Automatik'''

Da durch das Verwenden von swoffcond die Verbraucher beim Ausschalten auch ausgeplant werden, aber eigentlich "nur" unterbrochen werden sollen, müssen sie wieder neu eingeplant werden. Dazu sind notifys nötig. Wichtig: IDs müssen zweistellig angegeben werden!

Wärmepumpe:<syntaxhighlight lang="perl">
dum_valve:heatpump:.off sleep 10; set energy_mgmt consumerNewPlanning 05
</syntaxhighlight>
Nachbar Pool:<syntaxhighlight lang="perl">
dum_valve:pool_kurz:.off sleep 10; set energy_mgmt consumerNewPlanning 07
</syntaxhighlight>

'''Eine Pumpe mit einem Energiezähler als zwei Consumer verwenden'''

Die verwendete Pumpe hat vier Betriebsarten mit unterschiedlichen Leistungen. Da sie als zwei Consumer abgebildet wird, führt das dazu, dass die Leistung fälschlicherweise von SolarForecast auch zweimal gezählt wird. Die Lösung sind Dummy-Readings, welche die Leistungsdaten passend auseinander rechnen.<syntaxhighlight lang="perl">
Pool_Strom_Pumpe:Pool_Pin31_monotonic_count_PowerCurrent:.* {
my $power = $EVTPART1;
my $pump_low = ReadingsVal('dum_valve','pump_low','off');
my $pump_high = ReadingsVal('dum_valve','pump_high','off');
my $power_low_sim = 250;

if($pump_low eq "on" && $pump_high eq "on"){
my $power_low = $power_low_sim; #fiktiver Verbrauch der niedrigen Stufe
my $power_high = $power - $power_low_sim;
fhem("set dum_valve pump_low_power $power_low");
fhem("set dum_valve pump_high_power $power_high");
}
elsif($pump_low eq "on" && $pump_high eq "off"){
fhem("set dum_valve pump_low_power $power");
fhem("set dum_valve pump_high_power 0");
}
elsif($pump_low eq "off" && $pump_high eq "off"){
fhem("set dum_valve pump_low_power 0");
fhem("set dum_valve pump_high_power 0");
}elsif($pump_low eq "off" && $pump_high eq "on"){
fhem("set dum_valve pump_low_power 0");
fhem("set dum_valve pump_high_power $power");
}
}
</syntaxhighlight>
Erläuterungen:

* Es sind alle vier Möglichkeiten der zwei Pumpenlevel abgebildet.
* Wenn die Automatik deaktiviert ist und die Level 1-4 von extern geschaltet werden, zählen sie dadurch korrekterweise nicht zu diesen beiden Consumern.

'''Notifys für das hardwaremäßige Schalten der Consumer'''

Es werden einige Notifys verwendet, die die Umsetzung vom Dummy-Device auf die Hardware erledigen, da ein logisches Ein teilweise hardwaremäßig einige Dinge erfordert.

Notify für Pump Low:<syntaxhighlight lang="perl">
dum_valve:pump_low:.* {
if($EVTPART1 eq "on"){
fhem("set Pool_Pin26 on; sleep 60; set Pool_Pin25 on; sleep 1; set Pool_Pin26 off");
}elsif($EVTPART1 eq "off"){
fhem("set Pool_Pin14 off; sleep 5; set Pool_Pin12 off; sleep 15; set Pool_Pin25 off");
}else{
Log3 ("Pool", 4, qq{Notify Level1 - parameter is not on or off});
}
}
</syntaxhighlight>Erläuterungen:

* Beim Einschalten ist es nötig für eine Minute Pump High zu aktivieren, um Luft aus der Elektrolysezelle zu spülen, bevor Pump Low aktiv sein darf. (Pin26 und Pin25 sind die Steuerpins auf der Interfacekarte der Pumpe für die beiden Level.)
* Beim Ausschalten werden zuerst die Salzanlage (Pin14) und die pH-Anlage (Pin12) deaktiviert, damit noch 15 Sekunden lang die Elektrolysezelle mit frischem Wasser gespült wird, um das verbleibende Chlor auszuspülen.<br />
Notify für Pump High:<syntaxhighlight lang="perl">
dum_valve:pump_high:.* {
if($EVTPART1 eq "on"){
fhem("set Pool_Pin26 on; sleep 1; set Pool_Pin25 off");
}elsif($EVTPART1 eq "off"){
fhem("set Pool_Pin25 on; sleep 1; set Pool_Pin26 off");
}else{
Log3 ("Pool", 4, qq{Notify Level 2- parameter is not on or off});
}
}
</syntaxhighlight>Erläuterung:

* Da die Interfacekarte immer auf den höchsten Level reagiert, wird beim Umschalten zuerst Pump High aktiviert und nach einer Sekunde Pump Low deaktiviert, um ein "stufenloses" (ohne Ausschalten) Umschalten zu ermöglichen. Beim Ausschalten genauso.

Notify für die Wärmepumpe:<syntaxhighlight lang="perl">
dum_valve:heatpump:.* {
if($EVTPART1 eq "on"){
fhem("set Pool_Pin6 on");
}elsif($EVTPART1 eq "off"){
fhem("set Pool_Pin6 off");
}else{
Log3 ("Pool", 4, qq{Notify heatpump - parameter is not on or off});
}
}
</syntaxhighlight>Erläuterung:

* Hier reicht ein dirketes Übernehmen aus dem Dummy.

Notify für den Nachbar-Pool:<syntaxhighlight lang="perl">
dum_valve:pool_kurz:.* {
if($EVTPART1 eq "on" && ReadingsVal("Shelly_Plug_S_1","state","on") eq "off"){
fhem("set PwSw_Schalter off; sleep 3;{if(ReadingsAge(\"PwSw_Schalter\",\"state\",0)<4 && ReadingsVal(\"PwSw_Schalter\",\"state\",\"on\") eq \"off\"){fhem(\"set Shelly_Plug_S_1 on\")}}; sleep 5; set PwSw_Schalter on");
}elsif($EVTPART1 eq "off" && ReadingsVal("Shelly_Plug_S_1","state","off") eq "on"){
fhem("set PwSw_Schalter off; sleep 3;{if(ReadingsAge(\"PwSw_Schalter\",\"state\",0)<4 && ReadingsVal(\"PwSw_Schalter\",\"state\",\"on\") eq \"off\"){fhem(\"set Shelly_Plug_S_1 off\")}}; sleep 5; set PwSw_Schalter on");
}else{
Log3 ("Pool", 4, qq{Notify Pool Kurz - parameter is not on or off});
}
}
</syntaxhighlight>Erläuterung

* Da hier eine Pumpe durch einen 3-poligen Umschalter zwischen zwei Hausanspeisungen umgeschaltet wird, ist es wichtig, dass die Pumpe dazwischen '''gesichert''' zum Stehen gebracht wird! Sonst führt die rotierende Pumpe als Generator zu einem gewaltigen Kurzschluss mit der "fremden" Phase. War nicht schön ...

'''Sonderprogramme für den Poolbetrieb'''

Hier ist das Aus- und Einschalten der Solarforcast-Automatik zu sehen. Es werden alle Stati gespeichert. Danach kann von beliebigen "Sonderfunktionen" (Reinigung des Filters, Massagefunktion, usw.) auf die Hardware zugegriffen werden. Wenn wieder in den Automatikmodus zurückgewechselt wird, wird hardwaremäßig wieder der Zustand der Automatik von vorher hergestellt, die Stati wieder zurück geschrieben und die Automatik wieder aktiviert.<syntaxhighlight lang="perl">
##############################################
# Status speichern und Automatik ausschalten #
##############################################
sub PoolAutoOff{
my $pump_low_id = sprintf "%02d", 1;
my $pump_high_id = sprintf "%02d", 3;
my $heatpump_id = sprintf "%02d", 5;
my $pool_kurz_id = sprintf "%02d", 7;
my $sf = 'energy_mgmt';

# my $pump_low_state = ReadingsVal($valve_dummy,'pump_low','on');
my $pump_low_auto = FHEM::SolarForecast::ConsumerVal ($sf, $pump_low_id, 'auto', ''); # Automatikmodus der Pumpe
# my $pump_high_state = ReadingsVal($valve_dummy,'pump_high','on');
my $pump_high_auto = FHEM::SolarForecast::ConsumerVal ($sf, $pump_high_id, 'auto', ''); # Automatikmodus der Pumpe
# my $heatpump_state = ReadingsVal($valve_dummy,'heatpump','on');
my $heatpump_auto = FHEM::SolarForecast::ConsumerVal ($sf, $heatpump_id, 'auto', ''); # Automatikmodus der Wärmepumpe
# my $pool_kurz_state = ReadingsVal($valve_dummy,'pool_kurz','on');
my $pool_kurz_auto = FHEM::SolarForecast::ConsumerVal ($sf, $pool_kurz_id, 'auto', ''); # Automatikmodus des Pools
fhem("set $valve_dummy pump_low_auto 0");
fhem("set $valve_dummy pump_high_auto 0");
fhem("set $valve_dummy heatpump_auto 0");
fhem("set $valve_dummy pool_kurz_auto 0");
fhem("setreading $valve_dummy sf_automatic 0");
fhem("setreading $valve_dummy last_auto_pump_low $pump_low_auto");
fhem("setreading $valve_dummy last_auto_pump_high $pump_high_auto");
fhem("setreading $valve_dummy last_auto_heatpump $heatpump_auto");
fhem("setreading $valve_dummy last_auto_pool_kurz $pool_kurz_auto");

my $last_pump_level_1 = ReadingsVal($valve_dummy,"pump_low","off");
my $last_pump_level_2 = ReadingsVal($valve_dummy,"pump_high","off");
my $last_pump_level_3 = ReadingsVal($pump_level_3,"value","off");
my $last_pump_level_4 = ReadingsVal($pump_level_4,"value","off");
my $last_heatpump = ReadingsVal($valve_dummy,"heatpump","off");
fhem("setreading $valve_dummy last_pump_level_1 $last_pump_level_1");
fhem("setreading $valve_dummy last_pump_level_2 $last_pump_level_2");
fhem("setreading $valve_dummy last_pump_level_3 $last_pump_level_3");
fhem("setreading $valve_dummy last_pump_level_4 $last_pump_level_4");
fhem("setreading $valve_dummy last_heatpump $last_heatpump");
}

##########################################
# Status laden und Automatik einschalten #
##########################################
sub PoolAutoOn{
my $last_pump_level_4 = ReadingsVal($valve_dummy,"last_pump_level_4","off");
my $last_pump_level_3 = ReadingsVal($valve_dummy,"last_pump_level_3","off");
my $last_pump_level_2 = ReadingsVal($valve_dummy,"last_pump_level_2","off");
my $last_pump_level_1 = ReadingsVal($valve_dummy,"last_pump_level_1","off");
my $last_heatpump = ReadingsVal($valve_dummy,"last_heatpump","off");
fhem("set $pump_level_4 $last_pump_level_4");
fhem("set $pump_level_3 $last_pump_level_3");
fhem("set $pump_level_2 $last_pump_level_2");
if($last_pump_level_1 eq "on" && $last_pump_level_2 eq "off" && $last_pump_level_3 eq "off" && $last_pump_level_4 eq "off"){
fhem("set $pump_level_2 on; sleep 1; set $pump_level_1 $last_pump_level_1; sleep 28; set $pump_level_2 off; set $valve_dummy sf_automatic 1");
}elsif($last_pump_level_1 eq "on" && $last_pump_level_2 eq "on" && $last_pump_level_3 eq "off" && $last_pump_level_4 eq "off"){
fhem("set $pump_level_1 off; set $valve_dummy sf_automatic 1");
}elsif($last_pump_level_1 eq "off" && $last_pump_level_2 eq "off" && $last_pump_level_3 eq "off" && $last_pump_level_4 eq "off"){
fhem("set $pump_level_1 off; set $valve_dummy sf_automatic 1");
}
fhem("sleep 10; set $heatpump $last_heatpump");
fhem("setreading $valve_dummy last_pump_level_1 none");
fhem("setreading $valve_dummy last_pump_level_2 none");
fhem("setreading $valve_dummy last_pump_level_3 none");
fhem("setreading $valve_dummy last_pump_level_4 none");
fhem("setreading $valve_dummy last_heatpump none");
fhem("setreading $valve_dummy valve_position normal");
my $last_auto_pump_low = ReadingsVal($valve_dummy,"last_auto_pump_low",0);
my $last_auto_pump_high = ReadingsVal($valve_dummy,"last_auto_pump_high",0);
my $last_auto_heatpump = ReadingsVal($valve_dummy,"last_auto_heatpump",0);
my $last_auto_pool_kurz = ReadingsVal($valve_dummy,"last_auto_pool_kurz",0);
fhem("set $valve_dummy pump_low_auto $last_auto_pump_low");
fhem("set $valve_dummy pump_high_auto $last_auto_pump_high");
fhem("set $valve_dummy heatpump_auto $last_auto_heatpump");
fhem("set $valve_dummy pool_kurz_auto $last_auto_pool_kurz");
fhem("setreading $valve_dummy last_auto_pump_low none");
fhem("setreading $valve_dummy last_auto_pump_high none");
fhem("setreading $valve_dummy last_auto_heatpump none");
fhem("setreading $valve_dummy last_auto_pool_kurz none");
}
</syntaxhighlight>Erläuterungen:

* pump_level_1 ist Pump Low, pump_level_2 ist Pump High, pump_level_3 und pump_level_4 sind Sonderfunktionen (Filterreinigung, Massage)
* Beim Wiedereinschalten von Pump Low ist es wieder nötig kurz Pump High zu aktivieren, um Luft auszuspülen.
* Es wird der Zustand von Solarforecast gespeichert und danach auf die Hardware geschrieben. -> Stellt sicher, dass nach dem Einschalten der Automatik der logical switchstate zum physical switchstate passt.

== Tips & Tricks ==
* Interruptable verhält sich völlig anders, wenn der Perlcode 1 oder 0 liefert, als wenn man 1 oder 0 in der Config hinterlegt. -> siehe commandref
* Rückgabewert bei swoncond und swoffcond wird mit dem Readingswert verglichen und nicht dirket verwendet. Bsp. wenn das Reading 100 enthält muss auch der Rückgabewert des Perlcodes 100 liefern, um true zu ergeben.

== weiterführende Links ==
* Forenthema "{{Link2Forum|Topic=137058|LinkText=76_SolarForecast - Informationen/Ideen zu Weiterentwicklung und Support}}"
* Solcast API Toolkit: https://toolkit.solcast.com.au
* Kostal Plenticore 10 Plus mit SQL-Datenbank Integration ([[Kostal Plenticore 10 Plus]])
* Photovoltaik Ingenieurbüro Junge: https://www.ing-büro-junge.de/html/photovoltaik.html

[[Kategorie:Energieerzeugungsmessung]]

BOSE SoundTouch de-clouding

2026-02-12T17:28:47Z

Ph1959de: Typo entfernt

== Zielgruppe ==
Benutzer von BOSE SoundTouch-Systemen

== Lösungsübersicht ==
Cloudfreier Betrieb der BOSE-Boxen, De-bricking nach fehlerhaften Installationen

== Ausgangssituation ==
BOSE wird spätestens im Mai 2026 seine Server aus dem Netz nehmen. Damit wird die Funktionalität der BOSE-Boxen drastisch eingeschränkt, das Abspielen von netzbasierten Radiostreams ist ohne Modifikation der Boxen nicht möglich.

== De-clouding ==
Um einen root-Zugang zum Linux-Betriebssystem der Boxen zu erhalten, wird benötigt:
* USB-Stick, formatiert FAT32, mit einer leeren Datei 'remote_services'. Achtung: Das bootable-Flag des Dateisystems muss gesetzt sein.
* Für BOSE ST10 und ST300 zusätzlich ein USB-OTG-Adapter. Das ist ein Adapter, der eine Buchse vom Typ USB A (in den wird der o.a. Stick gesteckt) mit einem Stecker vom Type USB Micro (Typ Micro B, trapezförmig) verbindet. Darin ist offenbar das 5. (ID-)Pin des Micro USB-Steckers mit GND verbunden. Diese Adapter gibt es für ca. 8 € im Handel, sie werden gerne benutzt, um Smartphones in den USB-Host-Modus zu bringen.
===Vorbereitung allgemein===
In der Regel werden für den cloudfreien Betrieb der Boxen sowohl die Device-ID, als auch die ID des BOSE-Accounts benötigt. Dazu greift man mit einem Browser auf das API der Box zu, und ruft die Adresse
http://<IP-Adresse der Box>:8090/info
auf. Die Rückgabe sieht etwa so aus:
<info deviceID="{Device-ID}">
<name>{Name des Geräts in der BOSE Apps}</name>
<type>SoundTouch 300</type>
<margeAccountUUID>{ID des BOSE-Accounts}</margeAccountUUID>
...
Diese beiden Codes bitte notieren. Außerdem die drei Dateien
http://<IP-Adresse der Box>:8090/info
http://<IP-Adresse der Box>:8090/recents
http://<IP-Adresse der Box>:8090/preset
lokal abspeichern mit den Namen DeviceInfo.xml, Recents.xml, Presets.xml (Achtung, XML-Header nicht vergessen).

===Vorbereitung ST10===
Achtung: Vorher unbedingt die Einbindung der ST10 in ein Stereopaar aufheben! Sonst ist das Gerät nach der Änderung der internen Dateien nur noch ein teurer Ziegelstein ('Brick') und man muss erst die gesamte Firmware neu installieren, siehe unten.
*USB-Stick durch den OTG-Adapter mit dem USB-Port der ST10 verbinden.
*Stromversorgungskabel abziehen.
*Stromversorgungskabel wieder einstecken
*Die ST10 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an.

===Vorbereitung ST20===
*USB-Stick mit dem USB-Port der ST20 verbinden.
*Stromversorgungskabel abziehen.
*Stromversorgungskabel wieder einstecken
*Die ST20 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an.

===Vorbereitung ST300===
*USB-Stick durch den OTG-Adapter mit dem USB-Port der ST300 verbinden.
*Stromversorgungskabel abziehen.
*Infrarot-Fernbedienung der ST300 auf das Gerät richten, den ''SoundTouch''-Button drücken und '''halten''' (2. Button in der 2. Reihe)
*Währenddessen das Stromversorgungskabel wieder einstecken
*Die ST300 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an.
*LEDs der ST300 sollten jetzt gelb blinken, die Taste kann losgelassen werden.

===Zugang===
Der Zugang ist jetzt möglich mit
<syntaxhighlight lang="Bash">
telnet <IP-Adresse der Box>
</syntaxhighlight>
Auf die Rückgabe 'rhino login' einfach 'root' eingeben, ein Passwort ist nicht erforderlich.
Alternativ kann man auch verwenden
<syntaxhighlight lang="Bash">
ssh -o HostKeyAlgorithms=+ssh-rsa -o PubkeyAcceptedAlgorithms=+ssh-rsa root@<IP-Adresse der Box>
</syntaxhighlight>
Möchte man diesen Zugang permanent haben, um ggf. weitere Änderungen einfacher auszuführen, muss man eine leere Datei 'remote_services' erzeugen mit dem Kommando
touch /mnt/nv/remote_services
Während das für die Umstellung auf cloudfreien Betrieb ganz komfortabel ist, sollte man diese Datei nach erfolgreich getester Umstellung wieder löschen, denn sonst ist die Box komplett ungesichert!

===Holen weiterer Daten===
Nach einem Wechsel in das korrekte Verzeichnis
cd /mnt/nv/BoseApp-Persistence/1/
findet man dort auch die schon oben erwähnten Dateien Recents.xml und Presets.xml, sie können auch von hier auf den USB-Stick herunterkopiert werden.

Ebenfalls in diesem Verzeichnis liegt die Datei Sources.xml, dies muss ebenfalls entweder kopiert werden. Entweder lokal auf den USB-Stick oder, z.B. mit dem Befehl
scp Sources.xml {username}@{irgendein computer}
via Netz übertragen werden.

===Umbiegen===
Die Konfiguration der BOSE-Server kann jetzt geändert werden, dazu muss man das richtige Verzeichnis auf der Box kennen, das Dateisystem beschreibbar machen und die entsprechende Datei ändern
cd /opt/Bose/etc/
rw
cp SoundTouchSdkPrivateCfg.xml STSPC.backup
vi SoundTouchSdkPrivateCfg.xml
Für Nicht-Linux-Nutzer ist der vi Editor etwas gewöhnungsbedürftig, hier findet man eine [https://sits.de/vi.html Mini-Anleitung].

Die Datei enthält im BOSE-Urzustand folgende Informationen
<syntaxhighlight lang="XML">
<?xml version="1.0" encoding="utf-8"?>
<SoundTouchSdkPrivateCfg>
<margeServerUrl>https://streaming.bose.com</margeServerUrl>
<statsServerUrl>https://events.api.bosecm.com</statsServerUrl>
<swUpdateUrl>https://worldwide.bose.com/updates/soundtouch</swUpdateUrl>
<usePandoraProductionServer>true</usePandoraProductionServer>
<isZeroconfEnabled>true</isZeroconfEnabled>
<saveMargeCustomerReport>false</saveMargeCustomerReport>
<bmxRegistryUrl>https://content.api.bose.io/bmx/registry/v1/services</bmxRegistryUrl>
</SoundTouchSdkPrivateCfg>>
</syntaxhighlight>
Um die Box auf einen anderen Server umzubiegen, der unter dem Namen oder der IP-adresse <code>'{NeuerServer}:{Port}'</code> erreichbar ist, bitte den Inhalt wie folgt ändern:
<syntaxhighlight lang="XML">
<?xml version="1.0" encoding="utf-8"?>
<SoundTouchSdkPrivateCfg>
<margeServerUrl>http://{NeuerServer}:{Port}/marge</margeServerUrl>
<statsServerUrl>http://{NeuerServer}:{Port}</statsServerUrl>
<swUpdateUrl>http://{NeuerServer}:{Port}/updates/soundtouch</swUpdateUrl>
<usePandoraProductionServer>true</usePandoraProductionServer>
<isZeroconfEnabled>true</isZeroconfEnabled>
<saveMargeCustomerReport>false</saveMargeCustomerReport>
<bmxRegistryUrl>http://{NeuerServer}:{Port}/bmx/registry/v1/services</bmxRegistryUrl>
</SoundTouchSdkPrivateCfg>
</syntaxhighlight>

== De-bricking ==
Für den Fall, dass die BOSE Box nach irgendwelchen Änderungen nicht mehr ins lokale WLAN findet, aber auch keinen eigenen Access Point anbietet, kann man das Gerät dennoch retten. Dazu muss die Firmware komplett neu installiert werden. Zunächst die passende Firmware suchen

[https://archive.org/download/bose-soundtouch-software-and-firmware/ Archiv mit BOSE Firmware]

Die Zip-Datei muss entpackt werden die darin enthaltene Datei mit der Endung ''.stu'' muss auf einen bootfähigen USB-Stick geschrieben werden, siehe oben.

TODO: Unterabschnitte für die anderen Systeme schreiben, da nicht bekannt ist, wie lange [https://downloads.bose.com/ced/soundtouch/soundtouch_usb/index.html?l=de BOSE die Informationen noch zur Verfügung stellt].

===ST10===
*USB-Stick durch den OTG-Adapter mit dem USB-Port der ST10 verbinden.
*Stromversorgungskabel abziehen.
*Auf dem Tastenfeld die Taste „4“ und die „Lautstärke leiser“-Taste drücken und '''halten'''
*Stromversorgungskabel wieder einstecken
*Die ST10 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an. Die Buttons können nun losgelassen werden.
Die Installation dauert ca. 5 Minuten.

== ST10 zum Stereopaar verbinden ==
Zwei ST10-Boxen können auch ohne BOSE App und BOSE Server zu einem Stereopaar verbunden werden.
*Beide ST10 für den telnet-Zugang vorbereiten, so wie oben beschrieben
*Auswählen, welche Box künftig den LINKEN Stereokanal wiedergeben soll, einloggen als root
**Auf dieser Box in das korrekte Verzeichnis wechseln
cd /mnt/nv/BoseApp-Persistence/1/
** Hier liegt eine Datei ''GroupService.xml''. Im normalen (ungepaarten) Zustand hat diese den Inhalt
<?xml version="1.0" encoding="UTF-8" ?>
<group />
**Den Inhalt dieser Datei ersetzen durch
<?xml version="1.0" encoding="UTF-8" ?>
<group id="1234567">
<name>{NAME DES PAARS, z.B. "ST10-1 und ST10-2"}</name>
<masterDeviceId>{BOSE-ID des Master-Devices, z.B. 50338B343905}</masterDeviceId>
<roles>
<groupRole>
<deviceId>{BOSE-ID des Master-Devices, z.B. 50338B343905}</deviceId>
<role>LEFT</role>
<ipAddress>{IP-Adresse des Master-Devices}</ipAddress>
</groupRole>
<groupRole>
<deviceId>{BOSE-ID des Slave-Devices, z.B. 458790343905}</deviceId>
<role>RIGHT</role>
<ipAddress>{IP-Adresse des Slave-Devices}</ipAddress>
</groupRole>
</roles>
<senderIPAddress>{IP-Adresse des Master-Devices}</senderIPAddress>
</group>
** Datei sichern und die Box neu booten
*Auswählen, welche Box künftig den RECHTEN Stereokanal wiedergeben soll, einloggen als root
**Auf dieser Box in das korrekte Verzeichnis wechseln
cd /mnt/nv/BoseApp-Persistence/1/
** Hier liegt eine Datei ''GroupService.xml''. Im normalen (ungepaarten) Zustand hat diese den Inhalt
<?xml version="1.0" encoding="UTF-8" ?>
<group />
**Den Inhalt dieser Datei ersetzen durch
<?xml version="1.0" encoding="UTF-8" ?>
<group id="1234567">
<name>{NAME DES PAARS, z.B. "ST10-1 und ST10-2"}</name>
<masterDeviceId>{BOSE-ID des Master-Devices, z.B. 50338B343905}</masterDeviceId>
<roles>
<groupRole>
<deviceId>{BOSE-ID des Master-Devices, z.B. 50338B343905}</deviceId>
<role>LEFT</role>
<ipAddress>{IP-Adresse des Master-Devices}</ipAddress>
</groupRole>
<groupRole>
<deviceId>{BOSE-ID des Slave-Devices, z.B. 458790343905}</deviceId>
<role>RIGHT</role>
<ipAddress>{IP-Adresse des Slave-Devices}</ipAddress>
</groupRole>
</roles>
<senderIPAddress>{IP-Adresse des Master-Devices}</senderIPAddress>
<status>GROUP_OK</status>
</group>
** Achtung: Der einzige Unterschied zur Datei auf der LINKEN Box ist die vorletzte Zeile mit dem ''status''
**Datei sichern und die Box neu booten
Abspielbefehle werden dann nur an die Master-Box gesendet, diese synchronisiert sich automatisch mit der anderen Box
[[Kategorie:HOWTOS]]
[[Kategorie:BOSE]]

Vitoconnect

2026-02-12T17:27:44Z

Ph1959de: URL für API-Key etc. angepasst; Formatierung überarbeitet

{{SEITENTITEL:vitoconnect}}{{Infobox Modul
|ModPurpose=Steuerung von Viessmann Heizungen
|ModCategory=Heizungssteuerung/Raumklima
|ModCmdRef=vitoconnect
|ModFTopic=140073
|ModType=d
|ModForumArea=Heizungssteuerung/Raumklima
|ModTechName=98_vitoconnect.pm
|ModOwner=stefanru ({{Link2FU|24242|Forum}}/[[Benutzer Diskussion:stefanru|Wiki]])}}
[https://www.viessmann.de/de/viessmann-apps/vitoconnect.html Vitoconnect] ist die Schnittstelle zwischen Viessmann Gerät (Heizkessel, Wärmepumpe,...) und der App ViCare zum Bedienen von Viessmann Heizungsanlagen.

Mit dem FHEM Modul [[vitoconnect]] können die Daten, die über die Internetschnittstelle an den Herstellerserver gemeldet und von diesem über eine API zur Verfügung gestellt werden, in FHEM in Form von Readings angezeigt werden. Auch eine Steuerung der Heizung ist mit diesem Modul möglich.

Wen stört, dass die Daten in der Herstellercloud liegen, sei das Modul [[Vitotronic 200 (Viessmann Heizungssteuerung)]] empfohlen.

Die Idee zu dem Modul enstand aus dem Thread {{Link2Forum|Topic=86073|LinkText="Viessmann VitoConnect API"}}. Es basiert auf dem PHP Modul von [https://github.com/thetrueavatar/Viessmann-Api thetrueavatar].

== Einrichtung ==
=== Vorbereitung ===
<br clear=all>{{Randnotiz|RNTyp=y|RNText=Disclaimer zur Ursprungsversion des Moduls

Das Modul wurde nach bestem Wissen und Gewissen programmiert. Da Änderungen an der Heizung nur über die Viessmann API erfolgen, sollte die Nutzung risikoarm sein. Allerdings kann ich keine Garantie übernehmen, dass es nicht doch zu irgendwelchen unerwünschten Nebeneffekten kommt. Nutzung auf eigene Gefahr!

Diskussionen über Fehler, Verbesserungen usw. finden im Forum im Thread {{Link2Forum|Topic=93664|LinkText="Neues Modul: vitoconnect"}} statt.}}
Zur Nutzung des Moduls muss vorhanden sein:
* Eine aktuelle FHEM Installation
* Internet-Schnittstelle Vitoconnect (Typ OPTO1 oder OPTO2) oder E3 One Base
* Ein Viessmann ViCare Account, wie er im Rahmen der Nutzung der ViCare App erstellt wird.
* Seit 15. Juli 2021 auch einen persönlichen API Key (=Client-ID), diesen gibts hier: <nowiki>https://developer.viessmann-climatesolutions.com/</nowiki>
* Das Modul benötigt mindestens folgende Perl Libraries: Path::Tiny, JSON und DateTime. Diese können mit sudo apt install libtypes-path-tiny-perl libjson-perl libdatetime-perl oder via cpan. Sollten Libraries fehlen erhält man folgende Fehlermeldung "cannot load module vitoconnect". Dann bitte ins Logfile schauen, welche Lib fehlt.

=== Define des Devices ===
{{Randnotiz|RNTyp=|RNText=Aktuelle Entwicklung des Moduls

Das "offizielle" Modul im SVN war "verwaist", der Maintainer (mcp) nicht mehr aktiv:
* Ursprüngliches Forenthema ({{Link2Forum|Topic=86073|LinkText=86073}}): geschlossen; enthält "inoffizielle" Modulupdates von verschiedenen Autoren in verschiedenen Beiträgen
* Neues Forenthema ({{Link2Forum|Topic=140073|LinkText=Vitoconnect - Verbesserte Version}}), Benutzer {{Link2FU|24242|stefanru}}; dieses Forenthema wird der neue "Entwicklungsthread" zum Modul.
Die neue Version des Moduls ist seit dem 29.01.2025 im SVN verfügbar.
Das neue Modul ist abwärtskompatibel, es wird aber empfohlen auf Raw Readings umzustellen (vitoconnect_raw_readings = 1), siehe Wiki.
}}
Dann kann das Gerät angelegt werden:
:<code>define <name> vitoconnect <user> <password> <interval></code>
:z.B.: <code>define vitoconnect vitoconnect user@mail.xx geheim 60</code>

User und Passwort sind das gleiche wie in der ViCare App.

Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:
:<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>
:<code>set vitoconnect password correctPassword 60</code>

Zusätzlich muss der apiKey gesetzt werden.

Dazu muss eine Client-ID unter <nowiki>https://developer.viessmann-climatesolutions.com/</nowiki> erstellt werden.
Nach dem Erstellen eines Kontos muss ein neuer Client (ClientID sollte (muss?) dem angegebenen "user@mail.xx" entsprechen) mit folgenden Einstellungen angelegt werden:
* Google reCAPTCHA deaktiviert
* Redirect URI = <nowiki>http://localhost:4200/</nowiki>
* Nun die Client-ID kopieren und am FHEM Device setzen:
* <code>set vitoconnect apiKey <Client-ID></code>

Sollte die Anlage mehrere Viessmann Geräte oder mehrere Gateways mit mehreren Geräten oder mehrere Standorte mit mehreren Gateways und mehreren Geräten besitzen, wird es eine Meldung im Status des FHEM Devices geben. Bitte mit
:<code>set vitoconnect selectDevice <Devices></code>
das Device auswählen, das FHEM abfragen soll.

Sollen mehrere Devices abgefragt werden, bitte mehrere FHEM vitoconnect Devices anlegen. Hier bitte das API Limit von oben beachten.

Zur nachträgliches Änderung des Intervalls kann das DEF aufgerufen und dort die Parameter korrigiert werden (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes.

=== Betrieb ===
Der Zugriff auf die API von Viessmann ist aktuell auf 1450 pro Tag in der Gratisversion beschränkt, daraus ergibt sich ein Maximum von ca. einer Abfrage pro Minute. Die Anzahl der Zugriffe ist im Entwicklerportal einsehbar: https://developer.viessmann.com/de/clients/history (funktioniert Stand 02/2026 nicht mehr, eine "neue" Seite um die Anzahl der Zugriffe abzufragen ist (mir) nicht bekannt).

== Readings ==
=== Mapping ===
Im neuen Modul kann man per Attribut auswählen, wie die Readings dargestellt werden sollen. Es gibt drei Möglichkeiten:
# Raw Readings: Die Readings werden im API-Format abgelegt.
# Altes SVN Mapping: Die Readings werden wie im alten Modul auf Namen gemappt.
# "Roger Mapping": Die Readings werden wie in den Zwischenversionen von {{Link2FU|185|Roger}} in {{Link2Forum|Topic=93664|Message=1292441|LinkText=diesem Forenbeitrag}} gemappt.

Die Mappings sind passend zur aktuellen API. Ein Mapping lässt jedoch immer Raum für falsche Namen oder ein falsches Mapping, sollte Viessmann einen Namen in der API ändern.

Das Mapping der Readings hat auch einen Einfluss beim Setzen von Werten der Anlage. Das heißt, sie müssen korrekt zurückgemappt werden.

Deshalb empfehle ich, die Möglichkeit 1 zu nutzen. Bei Raw Readings findet kein Mapping statt; es werden die originalen API-Namen von Viessmann verwendet. Man kann mit diesen Namen auch im Viessmann-Forum anfragen oder sogar bei anderen SmartHome-Plattformen. Sollte sich ein Wert der Viessmann API ändern, wird er bei Raw Readings direkt als neues Reading auftauchen. Auch beim Setzen von Werten der Anlage können direkt diese Raw Readings verwendet werden.

Aus Kompatibilitätsgründen verwendet das Modul jedoch standardmäßig das SVN Mapping.

Um dies zu ändern, gibt es folgende Attribute am Modul:
* <code>vitoconnect_mapping_roger</code>
* <code>vitoconnect_raw_readings</code>

Setzt man keines der Attribute, wird das SVN Mapping verwendet. Setzt man eines der beiden Attribute auf 1, wird dieses Mapping verwendet.

Wie oben erklärt, ist die empfohlene Einstellung
:<code>vitoconnect_raw_readings = 1</code>
Weiter unten die Beschreibung des SVN Mappings. Zum "Roger Mapping" gibt es keine Aufstellung, es ähnelt aber stark dem SVN Mapping.

Raw Readings müssen nicht erklärt werden; die Beschreibung der Datenpunkte kann hier bei Viessmann gefunden werden: https://api.viessmann-climatesolutions.com/documentation/data-points

<div class="mw-collapsible mw-collapsed">
=== Altes SVN Mapping ===
<div class="mw-collapsible-content">
Die Readings werden so ausgegeben, wie sie von der API geliefert werden! Alle Reading für HK1 sind auch für HK2 und HK3 verfügbar sofern die Heizung solche Readings liefert.

{| class="wikitable"
|-
!Name!!Datentyp/<BR />Wertebereich!!Bedeutung
|-
|Aktive_Heizkreise||0,1,2
|Liste der aktiven Heizkreise. 0 entspricht HK1
|-
| || ||
|-
|Aussen_Status||connected/notConnected||Ist ein Außensensor angeschlossen?
|-
|''Aussen_StatusWired''||connected/notConnected||Ist ein Außensensor per Kabel angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
|''Aussen_StatusWireless''||connected/notConnected||Ist ein kabelloser Außensensor angeschlossen? (wird seit 16.12.18 nicht mehr geliefert?)
|-
|Aussentemperatur||2.4||Außentemperatur in °C
|-
| || ||
|-
|Brenner_Betriebsstunden||934.336944444444||Brenner Betriebsstunden
|-
|Brenner_Fehlercode||0||Brenner Fehlercode
|-
|Brenner_Modulation||11||Brenner Modulation in %
|-
|Brenner_Starts||2717||Brenner Starts
|-
|Brenner_Status||ok||Brenner Status
|-
|Brenner_aktiv||0,1||Brenneraktiv
|-
| || ||
|-
|Controller_Seriennummer||1234567890123456||Controller Seriennummer
|-
|Device_Time_Offset||61|| ???
|-
|Fehlereinträge_Historie||ErrorListChanges||??? (noch nicht implementiert)
|-
|Fehlereinträge_aktive||ErrorListChanges||??? (noch nicht implementiert)
|-
| || ||
|-
|Gasverbrauch_Heizung/Jahr||3293,0,0||Liste der jährlichen Gasverbräuche Heizung in kWH (aktuelles Jahr und die letzten beiden) '''(bis zum 09.12.2018 lieferte die API Werte, die noch durch 8 geteilt werden mussten, um auf kWh zu kommen!'''
Außerdem liefert Viessmann für manche Heizungstypen (noch) '''keine getrennten Werte für Heizung und WW'''. D.h. in den Reading für WW und Heizung steht der gleiche Wert (vermutlich der Gesamtverbrauch)!
|-
|Gasverbrauch_Heizung/Monat||1078,1384,590,241,0,0,0,0,0,0,0,0,0||Liste der monatlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_Heizung/Tag||76,104,113,99,76,65,60,70||Liste der täglichen Gasverbräuche Heizung in kWH (aktueller und die letzten 7 Tage)
|-
|Gasverbrauch_Heizung/Woche||555,409,416,472,289,196,254,209,24,46,
183,192,49,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
||Liste der wöchentlichen Gasverbräuche Heizung in kWH
|-
|Gasverbrauch_WW/Jahr||235,705,0||Liste der jährlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Monat||27,208,213,193,215,84,0,0,0,0,0,0,0||Liste der monatlichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Tag||2,6,0,0,0,2,9,0||Liste der täglichen Gasverbräuche Warmwasser in kWH
|-
|Gasverbrauch_WW/Woche||17,0,37,43,51,50,41,53,52,47,41,52,44,49,41,45,52,47,45,49,51,33,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0||Liste der wöchentlichen Gasverbräuche Warmwasser in kWH
|-
| || ||
|-
|HK1-Betriebsart||standby, dwh, dhwAndHeating, forcedReduced, forcedNormal||Aus, Nur Warmwasser aktiv , Heizung und Warmwasser aktiv, Dauernd Reduziert, Dauernd Tagbetrieb
|-
| || ||
|-
|HK1-External_Temperatur||0||Temperatur Raumsensor?
|-
|HK1-External_aktiv||0||Raumsensor aktiv?
|-
| || ||
|-
|HK1-Frostschutz_Status||on, off||Frostschutz Status
|-
| || ||
|-
|HK1-Heizkurve-Niveau||0||Heizkurve-Niveau
|-
|HK1-Heizkurve-Steigung||1.4||Heizkurve-Steigung
|-
| || ||
|-
|HK1-Programmstatus||standby, reduced, normal, forcedReduced, forcedNormal|| Programmstatus
|-
|HK1-Raum_Status||error||Raumsensor?
|-
|HK1-Raum_Temperatur||20||Temperatur Raumsensor? Nur vorhanden, wenn HK1-Raum_Status "ok"
|-
|HK1-Reduzierte_Temperatur_erzwungen||0,1||xxx
|-
|HK1-Solltemperatur_aktiv||0,1||Solltemperatur aktiv
|-
|HK1-Solltemperatur_comfort||22||Comfort Solltemeratur
|-
|HK1-Solltemperatur_comfort_aktiv||0,1||Comfort aktiv
|-
|HK1-Solltemperatur_eco||24||Eco Solltemperatur
|-
|HK1-Solltemperatur_eco_aktiv||0,1||Eco aktiv
|-
|HK1-Solltemperatur_erzwungen||0,1||Solltemperatur erzwungen
|-
|HK1-Solltemperatur_normal||24||Solltemperatur normal
|-
|HK1-Solltemperatur_reduziert||16||Solltemperatur reduziert
|-
| HK1-Solltemperatur_reduziert_aktiv||0,1||Reduziert aktiv
|-
|HK1-Standby_aktiv||0,1||Standby aktiv
|-
| || ||
|-
|HK1-Urlaub_Ende
|2019-02-16T00:00:00.000Z||Urlaubsabsenkung Ende
|-
|HK1-Urlaub_Start||2019-02-02T23:59:59.000Z||Urlaubsabsenkung Start
|-
|HK1-Urlaub_aktiv||0,1||Urlaubsabsenkung aktiv
|-
| || ||
|-
|HK1-Vorlauftemperatur||81||Vorlauftemperatir
|-
|HK1-Vorlauftemperatur_aktiv||connected||Vorlauftemperatursensor verbunden
|-
| || ||
|-
|HK1-WW_aktiv||0,1||Modus WW (dhw) aktiv
|-
|HK1-WW_und_Heizen_aktiv
|0,1||Modus WW und Heizen (dhwAndHeating) aktiv
|-
|HK1-Zeitsteuerung_Heizung||
wed start:05:00 mode:normal end:08:00 position:0, mode:normal end:23:00 position:1 start:16:00, sat position:0 end:23:00 mode:normal start:06:00,
thu position:0 mode:normal end:08:00 start:05:00, start:16:00 end:23:00 mode:normal position:1, sun start:06:00 position:0 end:23:00 mode:normal,
mon start:05:00 position:0 end:08:00 mode:normal, start:16:00 position:1 mode:normal end:23:00,
fri start:05:00 position:0 end:08:00 mode:normal, position:1 mode:normal end:23:00 start:16:00,
tue position:0 mode:normal end:08:00 start:05:00, mode:normal end:23:00 position:1 start:16:00,
||Zeitplan für Heizung
|-
|HK1-Zeitsteuerung_Heizung_aktiv||0,1||Zeitplan Heizung aktiv
|-
|''HK1-Zeitsteuerung_Zirkulation''||0,1||Zeitplan für Zirkulationspumpe. Ist irgendwann nach WW gewandert?
|-
|''HK1-Zeitsteuerung_Zirkulation_aktiv''||0,1||Zirkulationspumpe zeitgesteuert
|-
|HK1-Zirkulationspumpe||on,off||Zirkulationspumpe aktiv (neu seit 16.12.18?)
|-
|HK1-aktiv||1||HK1 aktiv
|-
| || ||
|-
|Kessel_Common_Supply||error|| ??? (neu seit 16.12.18?)
|-
|Kessel_Status

|connected||xxx
|-
|Kesseltemperatur||53||xxx
|-
|Kesseltemperatur_exact||53||??? (neu seit 16.12.18?)
|-
|Mehrfamilienhaus_aktiv||0,1||xxx
|-
| || ||
|-
|''Service_Betriebsstunden_seit_letzten''||0||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|''Service_Intervall_Betriebsstunden''||0||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Intervall_Monate||0|| ???
|-
|Service_Letzter||1970-01-01T00:00:00.000Z|| ???
|-
|''Service_Letzter_brennerbasiert''||1970-01-01T00:00:00.000Z||(wird seit 16.12.18 nicht mehr geliefert?)
|-
|Service_Monate_aktiv_seit_letzten_Service||0|| ???
|-
|Service_fällig||0,1||Service fällig?
|-
|''Service_fällig_brennerbasiert''|| ||(wird seit 16.12.18 nicht mehr geliefert?)
|-
| || ||
|-
|Stromverbrauch/Jahr||35573,66052,0 ||Stromverbrauch im Jahr in Wh(?) (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Monat||11860,23713,22851,19264,17924,6013,0,0,0,0,0,0,0||Stromverbrauch im Monat(analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Tag||409,828,720,733,731,727,708,682||Stromverbrauch im Tag (analog Gasverbrauch) (neu seit 15.02.19?)
|-
|Stromverbrauch/Woche||4418,5058,5514,5802,5249,5109,5156,5702,5179,5547,4286,4710,5087,4236,
4075,4633,4307,3675,3721,4148,4594,1419,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
||Stromverbrauch im Woche (analog Gasverbrauch) (neu seit 15.02.19?)
|-
| || ||
|-
|WW-Aufladung||0,1||WW Vorrat wird erhitzt (neu seit 16.12.18?)
|-
|WW-Haupttemperatur||54|| ?? (neu seit 16.12.18?)
|-
|WW-Isttemperatur||56||WW Ist-Temperatur
|-
|WW-Sensoren_Auslauf_Status||error|| ??? (neu seit 16.12.18?)
|-
|WW-Solltemperatur||53||WW Solltemperatur
|-
|WW-Temperatur_aktiv||connected||WW aktiv
|-
|WW-Zeitplan||
fri position:0 mode:on end:22:30 start:06:30, mon start:06:30 mode:on end:22:30 position:0,
sat start:06:30 position:0 mode:on end:22:30, wed end:22:30 mode:on position:0 start:06:30,
thu start:06:30 position:0 mode:on end:22:30,
tue position:0 mode:on end:22:30 start:06:30, sun mode:on end:22:30 position:0 start:06:30,
||WW Zeitplan
|-
|WW-Zirkulationspumpe_Zeitsteuerung_aktiv||0,1||Zeitsteuerung Zirkulationspumpe aktiv(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Status||on||Status Zirkulationspumpe(neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_Zeitplan||
wed start:04:30 mode:on end:22:30 position:0, mon start:04:30 position:0 end:22:30 mode:on,
sun start:04:30 position:0 mode:on end:22:30, sat start:04:30 position:0 end:22:30 mode:on, thu start:04:30 end:22:30 mode:on position:0,
tue start:04:30 mode:on end:22:30 position:0, fri position:0 end:22:30 mode:on start:04:30,
||Zeitplan für die Zirkulationspumpe (neu seit 16.12.18?)
|-
|WW-Zirkulationspumpe_primaer||off||(neu seit 16.12.18?)
|-
|WW-aktiv||0,1||WW aktiv
|-
|WW-onTimeCharge_aktiv||0,1||einmaliges WW Aufladen aktiv
|-
|WW-zeitgesteuert_aktiv||0,1||WW zeitgesteuert
|-
| || ||
|-
|state || ok, Login failure||Status
|-

|}
</div>
</div>

==Settings==

===Set Befehle===
'''Allgemein'''
{| class="wikitable"
|-
!Name!!Datentyp/<BR />Wertebereich !!Beschreibung
|-
|update|| ||löst ein Update der Reading zwischen manuell aus
|-
|clearReadings|| ||clear all readings immeadiatlely
|-
|clearMappedErrors
|
|clear all mapped errors immediately
|-
|password <passwd>||String||store password in key store
|-
|logResponseOnce|| ||dumps the json response of Viessmann server to entities.json, gw.json, actions.json in FHEM log directory
|-
|apiKey <clientID>
|String
|set the viessmann clientID, see define device
|-
|selectDevice
|
|in case of more then one viessmann devic, select the device to be used
|}'''Benutzung der Set-Befehle auf eigenes Risiko!'''

Die set Befehle stehen je nach Mapping und Anlagen Konfiguration zur Verfügung.

Bei vitoconnect_raw_readings haben die set Befehle die selben Namen wie die Readings und sind somit selbst erklärend oder über die Viessmann Doku nachzuschauen: [http://documentation.viessmann.com/static/iot/data-points. http://documentation.viessmann.com/static/iot/data-points.]

Bei SVN oder Roger Mapping sind die Namen gemappt.

<div class="mw-collapsible mw-collapsed">
=== Liste einiger SVN set Befehl ===
<div class="mw-collapsible-content">
Das Modul prüft nicht, ob ein Befehl oder die Parameter für die Heizung sinnvoll und möglich sind. Die API scheint dies mit einem Fehler zu quittieren.

Befehle für HK1 sind auch für HK2 und HK3 verfügbar.

{| class="wikitable"
|-
!Name!!Datentyp/<BR />Wertebereich !!Beschreibung
|-
|HK1-Heizkurve-Niveau <shift>||-13 bis 40||set shift of heating curve
|-
|HK1-Heizkurve-Steigung <slope>||0.2 bis 3.5||set slope of heating curve
|-
|HK1-Betriebsart <mode>||standby,dhw,dhwAndHeating,forcedReduced or forcedNormal||set HK1-Betriebsart
|-
|HK1-Solltemperatur_comfort_aktiv <activate,deactivate>|| ||activate/deactivate comfort temperature
|-
|HK1-Solltemperatur_comfort <targetTemperature>|| ||set comfort target temperatur
|-
|HK1-Solltemperatur_eco_aktiv activate,deactivate|| ||activate/deactivate eco temperature
|-
|HK1-Urlaub_Start <start>||2019-02-02 (früher war das Format mal 2019-02-02T23:59:59.000Z)||set holiday start time
|-
|HK1-Urlaub_Ende <end>||2019-02-16 (früher war das Format mal 2019-02-16T00:00:00.000Z)||set holiday end time (geht nur, wenn schon eine Startzeit gesetzt ist)
|-
|HK1-Urlaub_unschedule|| ||remove holiday start and end time
|-
| HK1-Solltemperatur_normal <targetTemperature>||3 and 37||sets the normale target temperature
|-
|HK1-Solltemperatur_reduziert <targetTemperature>||3 and 37||sets the reduced target temperature
|-
| || ||
|-
|WW-einmaliges_Aufladen activate,deactivate|| ||activate or deactivate one time charge for hot water
|-
|WW-Zirkulationspumpe_Zeitplan <schedule>|| ||not implemented
|-
|WW-Zeitplan <schedule>|| ||not implemented
|-
|WW-Haupttemperatur <targetTemperature>||10 and 60||sets hot water main temperature to targetTemperature
|-
|WW-Solltemperatur <targetTemperature>||10 and 60||sets hot water temperature to targetTemperature
|}
</div>
</div>

==Get==
Derzeit gibt es keine "get"-Kommandos.

{| class="wikitable"
|-
!Name!!Beschreibung
|-
| ||
|}

==Attribute==
===Attribute ===

{| class="wikitable"
|-
!Name!!Datentyp/<BR />Wertebereich !!Default-Wert
!Beschreibung
|-
|disable||0,1|| ||Disable updates
|-
|verbose||0,1,2,3,4,5|| ||Loglevel

|-
|vitoconnect_raw_readings||0,1|| ||Lege Reading mit dem JSON Namen wie 'heating.circuits.0.heating.curve.slope' statt der Deutschen Bezeichnungen an
|-
|vitoconnect_actions_active||0,1|| ||Erzeuge Readings for Befehle wie 'heating.circuits.0.heating.curve.setCurve'
|-
|vitoconnect_mapping_roger
|0,1
|
|Verwenden das Mapping von Roger vom 8. November (<nowiki>https://forum.fhem.de/index.php?msg=1292441</nowiki>) anstelle der SVN-Zuordnung
|-
|vitoconnect_installationID
|
|
|Dieses Attribut wird bei der Initialisierung des FHEM-Geräts befüllt. Muss etwas getan werden gibt es eine Benachrichtigung und der Befehl set selectDevice muss ausgeführt werden.
Sie müssen dieses Attribut nicht manuell setzen.
|-
| vitoconnect_serial
|
|
|Dieses Attribut wird bei der Initialisierung des FHEM-Geräts befüllt. Muss etwas getan werden gibt es eine Benachrichtigung und der Befehl set selectDevice muss ausgeführt werden.
Sie müssen dieses Attribut nicht manuell setzen
|-
|vitoconnect_gw_readings
|0,1
|
|Erstellt ein Reading für Gateway Informationen
|-
|vitoconnect_disable_raw_readings
|0,1
|
|Diese Einstellung deaktiviert die zusätzliche Generierung von raw Readings. Das bedeutet, nur die Readings, im gewählten Mapping werden erzeugt. Diese Einstellung ist nicht aktiv, wenn vitoconnect_raw_readings = 1 gesetzt ist.
|-
|vitoconnect_mappings
|
|
|Eigene Zuordnung von Schlüssel-Wert-Paaren anstelle der eingebauten.
|-
|vitoconnect_translations
|
|
|Eigene Übersetzung; sie wird jedes Wort Teil für Teil übersetzen.
|-
|vitoconnect_device
|0,1
|
|Das Viessmann Gerät kann auf 0 oder 1 gesetzt werden. Standard 0 sollte immer passen. Sollte es einen Fall geben wo dies nicht passt bitte beim Entwickler melden.
|-
|vitoconnect_timeout
|10-30
|
|Setzt ein Timeout für den API-Aufruf.
|}

== Hilfsmittel ==
=== Attribut zum Speichern der wichtigsten Werte mittels DbLog ===
<syntaxhighlight lang="Perl">attr vitoconnect DbLogInclude Gasverbrauch_gestern,Gasverbrauch_Heizung/Jahr,Gasverbrauch_aktuelle_Woche,Gasverbrauch_aktueller_Monat,Gasverbrauch_heute,WW-aktiv,
HK1-Frostschutz_Status,HK1-WW_und_Heizen_aktiv,HK1-WW_aktiv,HK1-Betriebsart,HK1-Programmstatus,Aussentemperatur,HK1-Solltemperatur_normal,Brenner_aktiv,
HK1-Vorlauftemperatur,Kesseltemperatur,WW-Isttemperatur,WW-Solltemperatur</syntaxhighlight>

===Userreadings um Reading für Einzelwerte von Gasverbräuche zu erzeugen===
<syntaxhighlight lang="Perl">
attr vitoconnect userReadings
Gasverbrauch_heute:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_Heizung/Tag",0))[0] },
Gasverbrauch_gestern:Gasverbrauch_Heizung/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Tag",0))[1] },
Gasverbrauch_aktuelle_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[0] },
Gasverbrauch_letzte_Woche:Gasverbrauch_Heizung/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Woche",0))[1] },
Gasverbrauch_aktueller_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[0] },
Gasverbrauch_letzter_Monat:Gasverbrauch_Heizung/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Monat",0))[1] },
Gasverbrauch_aktuelles_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[0] },
Gasverbrauch_letztes_Jahr:Gasverbrauch_Heizung/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_Heizung/Jahr",0))[1] },

Gasverbrauch_WW_heute:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Tag",0))[0] },
Gasverbrauch_WW_gestern:Gasverbrauch_WW/Tag.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Tag",0))[1] },
Gasverbrauch_WW_aktuelle_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[0] },
Gasverbrauch_WW_letzte_Woche:Gasverbrauch_WW/Woche.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Woche",0))[1] },
Gasverbrauch_WW_aktueller_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[0] },
Gasverbrauch_WW_letzter_Monat:Gasverbrauch_WW/Monat.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Monat",0))[1] },
Gasverbrauch_WW_aktuelles_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect","Gasverbrauch_WW/Jahr",0))[0] },
Gasverbrauch_WW_letztes_Jahr:Gasverbrauch_WW/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Gasverbrauch_WW/Jahr",0))[1] },

Stromverbrauch_heute:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[0] },
Stromverbrauch_gestern:Stromverbrauch/Tag.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Tag",0))[1] },
Stromverbrauch_aktuelle_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[0] },
Stromverbrauch_letzte_Woche:Stromverbrauch/Woche.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Woche",0))[1] },
Stromverbrauch_aktueller_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[0] },
Stromverbrauch_letzter_Monat:Stromverbrauch/Monat.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Monat",0))[1] },
Stromverbrauch_aktuelles_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[0] },
Stromverbrauch_letztes_Jahr:Stromverbrauch/Jahr.* { (split /,/, ReadingsVal("vitoconnect", "Stromverbrauch/Jahr",0))[1] }
</syntaxhighlight>

===ReadingsGroup für eine kompakte Darstellung===
<syntaxhighlight lang="perl" style="width:90%;">
defmod vitoconnect_rg readingsGroup
vitoconnect:Aussentemperatur
<Brenner>
vitoconnect:Brenner_Betriebsstunden
vitoconnect:Brenner_Fehlercode
vitoconnect:Brenner_Modulation
vitoconnect:Brenner_Starts
vitoconnect:Brenner_Status
vitoconnect:Brenner_aktiv
<HK1>
vitoconnect:HK1-aktiv
vitoconnect:HK1-Betriebsart

vitoconnect:HK1-Frostschutz_Status

vitoconnect:HK1-Heizkurve-Niveau
vitoconnect:HK1-Heizkurve-Steigung

vitoconnect:HK1-Programmstatus
vitoconnect:HK1-Raum_Status
vitoconnect:HK1-Reduzierte_Temperatur_erzwungen
vitoconnect:HK1-Solltemperatur_aktiv
vitoconnect:HK1-Solltemperatur_erzwungen
vitoconnect:HK1-Solltemperatur_normal
vitoconnect:HK1-Solltemperatur_reduziert
vitoconnect:HK1-Solltemperatur_reduziert_aktiv
vitoconnect:HK1-Standby_aktiv

vitoconnect:HK1-Urlaub_Ende
vitoconnect:HK1-Urlaub_Start
vitoconnect:HK1-Urlaub_aktiv

vitoconnect:HK1-Vorlauftemperatur

vitoconnect:HK1-WW_aktiv
vitoconnect:HK1-WW_und_Heizen_aktiv

vitoconnect:HK1-Zeitsteuerung_Heizung_aktiv
vitoconnect:HK1-Zeitsteuerung_Zirkulation_aktiv

vitoconnect:HK1-Zirkulationspumpe
<Kessel>
vitoconnect:Kesseltemperatur
vitoconnect:Kesseltemperatur_exact
<WW>
vitoconnect:WW-Aufladung
vitoconnect:WW-Haupttemperatur
vitoconnect:WW-Isttemperatur
vitoconnect:WW-Solltemperatur
vitoconnect:WW-Zirklationspumpe_Zeitsteuerung_aktiv
vitoconnect:WW-Zirkulationspumpe_Status
vitoconnect:WW-Zirkulationspumpe_primaer
vitoconnect:WW-aktiv
vitoconnect:WW-onTimeCharge_aktiv
vitoconnect:WW-zeitgesteuert_aktiv
</syntaxhighlight>

<syntaxhighlight lang="perl" style="width:90%;">
attr vitoconnect_rg alias Heizung
attr vitoconnect_rg cellStyle {
"c:0"=>'style="text-align:left"',
"c:1"=>'style="text-align:left"',
"r:2"=>'style="text-align:right;;;;font-weight:bold"'
}
attr vitoconnect_rg mapping {
"Aussentemperatur" => "Aussentemperatur",

"Brenner_Betriebsstunden" => "Betriebsstunden",
"Brenner_Fehlercode" => "Fehlercode",
"Brenner_Modulation" => "Modulation",
"Brenner_Starts" => "Starts",
"Brenner_Status" => "Status",
"Brenner_aktiv" => "aktiv",

"HK1-aktiv" => "aktiv",
"HK1-Betriebsart" => "Betriebsart",
"HK1-Frostschutz_Status" => "Frostschutz_Status",
"HK1-Heizkurve-Niveau" => "Heizkurve-Niveau",
"HK1-Heizkurve-Steigung" => "Heizkurve-Steigung",
"HK1-Programmstatus" => "Programmstatus",
"HK1-Raum_Status" => "Raum Status",
"HK1-Reduzierte_Temperatur_erzwungen" => "Reduzierte Temperatur erzwungen",
"HK1-Solltemperatur_aktiv" => "Solltemperatur aktiv",
"HK1-Solltemperatur_erzwungen" => "Solltemperatur erzwungen",
"HK1-Solltemperatur_normal" => "Solltemperatur normal",
"HK1-Solltemperatur_reduziert" => "Solltemperatur reduziert",
"HK1-Solltemperatur_reduziert_aktiv" => "Solltemperatur reduziert_aktiv",
"HK1-Standby_aktiv" => "Standby aktiv",
"HK1-Urlaub_Ende" => "Urlaub Ende",
"HK1-Urlaub_Start" => "Urlaub Start",
"HK1-Urlaub_aktiv" => "Urlaub aktiv",
"HK1-Vorlauftemperatur" => "Vorlauftemperatur",
"HK1-WW_aktiv" => "WW aktiv",
"HK1-WW_und_Heizen_aktiv" => "WW und Heizen aktiv",
"HK1-Zeitsteuerung_Heizung_aktiv" => "Zeitsteuerung Heizung aktiv",
"HK1-Zirkulationspumpe" => "Zirkulationspumpe",

"Kesseltemperatur" => "Kesseltemperatur",
"Kesseltemperatur_exact" => "Kesseltemperatur exact",

"WW-Aufladung" => "Aufladung",
"WW-Haupttemperatur" => "Haupttemperatur",
"WW-Isttemperatur" => "Isttemperatur",
"WW-Solltemperatur" => "Solltemperatur",
"WW-Zirklationspumpe_Zeitsteuerung_aktiv" => "Zirkulationspumpe Zeitsteuerung aktiv",
"WW-Zirkulationspumpe_Status" => "Zirkulationspumpe Status",
"WW-Zirkulationspumpe_primaer" => "Zirkulationspumpe primaer",
"WW-aktiv" => "aktiv",
"WW-onTimeCharge_aktiv" => "onTimeCharge aktiv",
"WW-zeitgesteuert_aktiv" => "zeitgesteuert aktiv"
}

attr vitoconnect_rg nostate 1
attr vitoconnect_rg notime 1
attr vitoconnect_rg room Heizung
attr vitoconnect_rg sortby 1
attr vitoconnect_rg valueFormat { "Brenner_Betriebsstunden" => "%2d" }
attr vitoconnect_rg valueIcon {'Brenner_aktiv.0' => '1px-spacer',
'Brenner_aktiv.1' => 'icoHEIZUNG',
'HK1-Solltemperatur_reduziert_aktiv.0' => '10px-kreis-rot',
'HK1-Solltemperatur_reduziert_aktiv.1' => '10px-kreis-gruen'
}

attr vitoconnect_rg valueSuffix {
Aussentemperatur => "°C",

Brenner_Betriebsstunden => "h",
Brenner_Modulation => "%",

'HK1-Solltemperatur_normal' => "°C",
'HK1-Solltemperatur_reduziert' => "°C",
'HK1-Vorlauftemperatur' => " °C",

Kesseltemperatur => "°C",
Kesseltemperatur_exact => "°C",

'WW-Solltemperatur' => " °C",
'WW-Isttemperatur' => " °C",

'WW-Solltemperatur' => "°C"
}
</syntaxhighlight>
<br>

[[Datei:ReadingsGroup für Vitoconnect Modul 3.jpg|200px]]
===ReadingsGroup für eine kompakte Darstellung der Verbräuche===
<syntaxhighlight lang="Perl" style="width:100%;">
defmod Heizung_Verbrauch readingsGroup <>,<Periode>,<Heizung>,<Wasser>,<Strom>
vitoconnect:,<heute>,Gasverbrauch_heute,Gasverbrauch_WW_heute,Stromverbrauch_heute
vitoconnect:,<gestern>,Gasverbrauch_gestern,Gasverbrauch_WW_gestern,Stromverbrauch_gestern
vitoconnect:,<Woche>,Gasverbrauch_aktuelle_Woche,Gasverbrauch_WW_aktuelle_Woche,Stromverbrauch_aktuelle_Woche
vitoconnect:,<letzte>,Gasverbrauch_letzte_Woche,Gasverbrauch_WW_letzte_Woche,Stromverbrauch_letzte_Woche
vitoconnect:,<Monat>,Gasverbrauch_aktueller_Monat,Gasverbrauch_WW_aktueller_Monat,Stromverbrauch_aktueller_Monat
vitoconnect:,<letzter>,Gasverbrauch_letzter_Monat,Gasverbrauch_WW_letzter_Monat,Stromverbrauch_letzter_Monat
vitoconnect:,<Jahr>,Gasverbrauch_aktuelles_Jahr,Gasverbrauch_WW_aktuelles_Jahr,Stromverbrauch_aktuelles_Jahr
vitoconnect:,<letztes>,Gasverbrauch_letztes_Jahr,Gasverbrauch_WW_letztes_Jahr,Stromverbrauch_letztes_Jahr

attr Heizung_Verbrauch cellStyle {
"r:1"=>'style="text-align:left;;;;font-weight:bold"',
"c:1"=>'style="text-align:right;;;;font-weight:bold"'
}
attr Heizung_Verbrauch mapping  ;
attr Heizung_Verbrauch nostate 1
attr Heizung_Verbrauch room Heizung
attr Heizung_Verbrauch style style="text-align:right;;;;font-size:18px"
attr Heizung_Verbrauch valueFormat {
Gasverbrauch_heute => "%.0f kWh",
Gasverbrauch_WW_heute => "%.0f kWh",
Stromverbrauch_heute => "%.0f kWh",
Gasverbrauch_gestern => "%.0f kWh",
Gasverbrauch_WW_gestern => "%.0f kWh",
Stromverbrauch_gestern => "%.0f kWh",
Gasverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_WW_aktuelle_Woche => "%.0f kWh",
Stromverbrauch_aktuelle_Woche => "%.0f kWh",
Gasverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_WW_letzte_Woche => "%.0f kWh",
Stromverbrauch_letzte_Woche => "%.0f kWh",
Gasverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_WW_aktueller_Monat => "%.0f kWh",
Stromverbrauch_aktueller_Monat => "%.0f kWh",
Gasverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_WW_letzter_Monat => "%.0f kWh",
Stromverbrauch_letzter_Monat => "%.0f kWh",
Gasverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_WW_aktuelles_Jahr => "%.0f kWh",
Stromverbrauch_aktuelles_Jahr => "%.0f kWh",
Gasverbrauch_letztes_Jahr => "%.0f kWh",
Gasverbrauch_WW_letztes_Jahr => "%.0f kWh",
Stromverbrauch_letztes_Jahr => "%.0f kWh"
}
</syntaxhighlight>
[[Datei:Readuingsgroup Verbräuche aus Vitoconnect 2.jpg|200px]]

=== SVG Graphen ===
==== Gas- und Stromverbrauch ====

[[Datei:SVG Gasverbrauch für vitoconnect Modul.jpg|800px]]

[[Datei:Verbräuche aus Vitoconnect.jpg|800px]]

<br>
==== Weitere Graphen ====
[[Datei:Beispiel für Grafiken aus vitoconnect Daten.jpg|800px]]
<br>

=== Speichern der wichtigsten Werte mittels FileLog und Erzeugung der entspr. SVG Plots ===
==== FileLog erstellen====
Zunächst wird das FileLog mit ausgewählten Parametern erstellt. Dies ist die Voraussetzung für die SVG Plots.
<syntaxhighlight lang="Perl">
define FileLog_VitoConnect FileLog ./log/VitoConnect-%Y-%m.log vitoconnect:Aussentemperatur|vitoconnect:Brenner_Modulation|vitoconnect:Brenner_aktiv|vitoconnect:Gasverbrauch_Heizung/Jahr|vitoconnect:Gasverbrauch_aktuelle_Woche|vitoconnect:Gasverbrauch_aktueller_Monat|vitoconnect:Gasverbrauch_gestern|vitoconnect:Gasverbrauch_heute|vitoconnect:HK1-Betriebsart|vitoconnect:HK1-Frostschutz_Status|vitoconnect:HK1-Programmstatus|vitoconnect:HK1-Solltemperatur_aktiv|vitoconnect:HK1-Solltemperatur_normal|vitoconnect:HK1-Solltemperatur_reduziert|vitoconnect:HK1-Solltemperatur_reduziert_aktiv|vitoconnect:HK1-Vorlauftemperatur|vitoconnect:HK1-WW_aktiv|vitoconnect:HK1-WW_und_Heizen_aktiv|vitoconnect:HK1-Zirkulationspumpe|vitoconnect:Kessel_Common_Supply_Temperatur|vitoconnect:Kesseltemperatur_exact|vitoconnect:WW-Isttemperatur|vitoconnect:WW-Sensoren_Auslauf_Wert|vitoconnect:WW-Solltemperatur|vitoconnect:WW-Zirkulationspumpe_Status|vitoconnect:WW-zeitgesteuert_aktiv
attr FileLog_VitoConnect room Log
</syntaxhighlight>

==== SVG Graphen aus FileLog erstellen ====
Nachdem das FileLog erstellt wurde, kann aus dem Log nun der Plot von ausgewählten Werten erstellt werden.<br>

===== SVG Plot für Heizkreis1 =====
Im folgenden Beispiel werden hier verschiedene Graphen für Heizkreis1 (HK1) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
<br>
<br>
SVG Plot mit Plot Editor:<br>
[[Datei:SVG FileLog VitoConnect 1 HK1 Temps.png|800px]]
<br>
<br>
… mit dem entsprechenden <b>Code</b>:<br>
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_1 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_1:CURRENT
attr SVG_FileLog_VitoConnect_1 room Heizung

setstate SVG_FileLog_VitoConnect_1 initialized
</syntaxhighlight>

<b>SVG_FileLog_VitoConnect_1.gplot</b>:
<syntaxhighlight lang="Perl">
# Created by FHEM/98_SVG.pm, 2019-11-04 20:35:38
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'HK1 Temps'
set ytics
set y2tics
set grid
set ylabel "°C"
set y2label "boolean"
set y2range [0:4]

#FileLog_VitoConnect 4:vitoconnect.Aussentemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_normal\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_reduziert\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_aktiv\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Solltemperatur_reduziert_aktiv\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Vorlauftemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.Kesseltemperatur_exact\x3a::
#FileLog_VitoConnect 4:vitoconnect.HK1-Zirkulationspumpe\x3a::$fld[3]=~"on"?1.5:0

plot "<IN>" using 1:2 axes x1y1 title 'Außentemperatur' ls l7 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Soll normal' ls l0 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Soll reduziert' ls l1 lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'normal-prg' ls l0fill lw 2 with lines,\
"<IN>" using 1:2 axes x1y2 title 'reduziert-prg' ls l1fill lw 2 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Vorlauf' ls l2 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Kesseltemp.' ls l5 lw 1 with lines
"<IN>" using 1:2 axes x1y2 title 'Zirk.pumpe' ls l8fill lw 2 with lines,\
</syntaxhighlight>

===== SVG Plot für Warmwasser =====
Im folgenden Beispiel werden hier verschiedene Graphen für Warmwasser (WW) genommen.
Einige der Logwerte speichern "on"- oder "off"-Werte, diese müssten beispielsweise mit der Formel <syntaxhighlight lang="Perl">$fld[3]=~"on"?1.5:0</syntaxhighlight> erst in Werte (on=1.5, off=0) gewandelt werden.
<br>
<br>
SVG Plot mit Plot Editor:<br>
[[Datei:SVG FileLog VitoConnect 2 WW Temps.png|800px]]
<br>
<br>
… mit dem entsprechenden <b>Code</b>:<br>
<syntaxhighlight lang="Perl">
defmod SVG_FileLog_VitoConnect_2 SVG FileLog_VitoConnect:SVG_FileLog_VitoConnect_2:CURRENT
attr SVG_FileLog_VitoConnect_2 room Heizung

setstate SVG_FileLog_VitoConnect_2 initialized
</syntaxhighlight>

<b>SVG_FileLog_VitoConnect_1.gplot</b>:
<syntaxhighlight lang="Perl">
# Created by FHEM/98_SVG.pm, 2019-11-04 21:08:37
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title 'WW Temps'
set ytics
set y2tics
set grid
set ylabel "°C"
set y2label "boolean"
set y2range [0:4]

#FileLog_VitoConnect 4:vitoconnect.Brenner_aktiv\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Solltemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Isttemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Sensoren_Auslauf_Wert\x3a::
#FileLog_VitoConnect 4:vitoconnect.Kesseltemperatur\x3a::
#FileLog_VitoConnect 4:vitoconnect.WW-Zirkulationspumpe_Status\x3a::$fld[3]=~"on"?1.5:0

plot "<IN>" using 1:2 axes x1y2 title 'Brenner' ls l0fill lw 2 with lines,\
"<IN>" using 1:2 axes x1y1 title 'WW soll' ls l1 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'WW ist' ls l2 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'WW Auslaufwert' ls l3 lw 1 with lines,\
"<IN>" using 1:2 axes x1y1 title 'Kesseltemp.' ls l4 lw 1 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Zirk.pumpe' ls l8fill lw 2 with lines,\
</syntaxhighlight>

== Weblinks ==
* {{Link2Forum|Topic=93664|LinkText=Thread zum Modul im Forum}}

[[Kategorie:Heizungssteuerung]]

Vorlage:EnOceanSubTypeTable

2026-02-10T11:12:35Z

Ph1959de: Schreibweise Micropelt iTRV korrigiert

{|
{{News|'''subType''' |'''Wiki-Seite'''}}
{{News|tempSensor.XX | }}
{{News|roomSensorControl.01 | }}
{{News|tempHumiSensor.02 |[[EnOcean-FBH65TFB-Funk-Bewegungs- Helligkeits- Temperatur- und Feuchte-Sensor]] }}
{{News|lightSensor.XX |[[EnOcean-FAH60-Au%C3%9Fen-Helligkeitssensor]] }}
{{News|occupSensor.XX | }}
{{News|lightTempOccupSensor.XX |[[EnOcean-FBH65S-Funk-Bewegungs- Helligkeitssensor]] }}
{{News||[[EnOcean-FBH65TFB-Funk-Bewegungs- Helligkeits- Temperatur- und Feuchte-Sensor]] }}
{{News|COSensor.01 | }}
{{News|tempHumiCO2Sensor.XX | }}
{{News|vocSensor.01 | }}
{{News|radonSensor.01 | }}
{{News|particlesSensor.01 | }}
{{News|roomSensorControl.XX | }}
{{News|tempCtrlState.01 | }}
{{News|shutterCtrlState.01 |[[EnOcean-D-452-FU-EBIM-JR-Aktor-Beschattungselemente-Rollladen]]}}
{{News|blindsCtrl.00 |[[EnOcean-UPJ230_12-Jalousieaktor]]}}
{{News|lightCtrlState.XX |[[EnOcean-D-452-FU-EBIM-Aktor-2fach]] }}
{{News|autoMeterReading.XX |[[EnOcean-FSR61VA-10A-Stromstoß-Schaltrelais mit Strommessung]] }}
{{News|environmentApp |[[EnOcean-FWS61-24V-DC-Funk-Wetterdaten-Sendemodul]] }}
{{News|multiFuncSensor |[[EnOcean-Roto-Com-Tec-Basic-Fenstersensor]]}}
{{News|hvac.XX |[[EnOcean-MD15-Kleinstellantrieb]] }}
{{News||[[Micropelt iTRV Kleinstellantrieb]] }}
{{News|digitalInput.XX | }}
{{News|gateway; gwCmd switching|[[EnOcean-FSR14-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais]] }}
{{News|gateway; gwCmd dimming|[[EnOcean-FUD12NPN-RS485-Bus-Universal-Dimmaktor]] }}
{{News||[[EnOcean-FUD14-RS485-Bus-Universal-Dimmaktor]] }}
{{News||[[EnOcean-FUD61NPN-Funk-Universal-Dimmaktor]] }}
{{News||[[EnOcean-FUD61NPN-Funk-Universal-Dimmaktor-unidirektional]] }}
{{News||{{Link2Forum|Topic=58832|LinkText=Osram Touch Dim RC}} }}
{{News|gateway; gwCmd blindCmd|[[EnOcean-D-452-FU-EBIM-JR-Aktor-Beschattungselemente-Rollladen]] }}
{{News||[[EnOcean-D-452-FU-EBI-JR-Aktor-Beschattungselemente-Rollladen]] }}
{{News|manufProfile |[[EnOcean-FSB12-RS485-Bus-Schaltaktor-2-Kanal-Beschattungselemente-Rollladen]] }}
{{News||[[EnOcean-FSB14-RS485-Bus-Schaltaktor-2-Kanal-Beschattungselemente-Rollladen]]}}
{{News||[[EnOcean-FSB61-Aktor-Beschattungselemente-Rollladen]]}}
{{News|actuator.01 |[[EnOcean-D-452-FU-EBIM-Aktor-2fach]] }}
{{News||[[EnOcean-PSC234-Zwischenstecker]] }}
{{News|switch.XX |[[EnOcean-PTM-210-Taster]] }}
{{News||[[EnOcean-FBH65TFB-Funk-Bewegungs- Helligkeits- Temperatur- und Feuchte-Sensor]]}}
{{News||[[EnOcean-FSR12-4x-RS485-Bus-Schaltaktor-4-Kanal-Stromstoß-Schaltrelais]]}}
{{News||[[EnOcean-FMS61NP-2-Kanal-Multifunktions-Stromstoßschalter]]}}
{{News||[[EnOcean-FSR61VA-10A-Stromstoß-Schaltrelais mit Strommessung]]}}
{{News||[[EnOcean-SecuSignal-Fenstergriff]]}}
{{News|roomCtrlPanel.00 | }}
{{News|contact |[[EnOcean_Starter_Guide#Kontakte]] }}
{{News||[[EnOcean-STM-250-Fenster-Türkontakt]]}}
{{News|keycard.xx | }}
{{News|windowHandle.XX |[[EnOcean-SecuSignal-Fenstergriff]]}}
{{News|sensor | }}
{{News|smokeDetector.02 |[[EnOcean-FRW-Rauchmelder]]}}
{{News|PM101|[[EnOcean_Starter_Guide#Profilloses_4BS-Teach-In]] }}
{{News|raw | }}
{{News|doorContact|[[EiMSIG Universalsensor mit EnOcean]] }}
|}

<code>Die Endung .XX bei einem subType bedeutet, dass es mehrere subType-Untervarianten gibt, die sich aber nur in Kleinigkeiten -zumeist Skalierung- unterscheiden.</code>
<noinclude>[[Kategorie:Vorlage]]</noinclude>

Micropelt iTRV Kleinstellantrieb

2026-02-10T11:10:28Z

Ph1959de: Ph1959de verschob die Seite Micropelt iRTV Kleinstellantrieb nach Micropelt iTRV Kleinstellantrieb, ohne dabei eine Weiterleitung anzulegen: Falsch geschriebener Name

{{Infobox Hardware
| Bild = ITRV.jpg
| Bildbeschreibung = Batterieloser Heizungssteller
| HWProtocol = EnOcean
| HWType = Aktor
| HWCategory = EnOcean
| HWComm = EnOcean Funk, 868Mhz
| HWProtokoll = EnOcean Protokoll EEP A5-20-01 (Ventil Position in %)
| HWChannels = 1 (bidirektional)
| HWVoltage = 3.2 V, LiFePo-Akku
| HWPowerConsumption = unbekannt
| HWPoweredBy = TEG (Thermoelektrischer Generator;autark)
| HWSize = 59 × 64 × 59 [mm] (Breite × Höhe × Tiefe), Gewicht 260 g
neuere, runde Modelle: 55 x 95 [mm] (Ø x T), 260 g
| HWDeviceFHEM = [http://fhem.de/commandref.html#EnOcean EnOcean]
| HWManufacturer = Micropelt GmbH
}}

'''EnOcean-Micropelt iTRV-Kleinstellantrieb''' ist ein batterieloser Kleinstellantrieb für Raumtemperaturregelung, der seine Energie per Energy Harvesting aus der Wärme des Vorlaufes zieht. Hier wird vorrangig das Modell MVA-002 beschrieben.
Das Modell MVA-004 ist rund und hat einen eigenen PID-Controller, das Modell MVA-005 (ebenfalls rund) hat zusätzlich eine Handverstellung in Ein-Grad-Schritten (bis +/- 5°). Beide Modelle sind noch leiser und sollen laut Hersteller bei schwacher Funkversorgung die Verbindung besser halten. Das Modell MVA-005 hat das EEP A5-20-06, das seit 21.1.2019 von FHEM unterstützt wird.

Aktuell in der Auslieferung sind die Modelle MVA-008 (wie 004) und MVA-009 (wie 005) mit einer USB-Buchse zum Nachladen, falls der eingebaute Speicher leergelaufen sein sollte.

Neben der hier beschriebenen EnOcean-Variante gibt es auch Modelle für LoRaWan.

== Features ==
Kleinstellantrieb, der ohne Batterien auskommt, da er über einen thermolektrischen Generator seine Energie aus der Temperaturdifferenz des Heizungsvorlaufes und der Raumtemperatur bezieht.

== Hinweise zum Betrieb mit FHEM ==

=== Definition/Anlernvorgang ===
4BS-Bidirektionales-Teach-In:

#falls vorhanden, alle bisherigen FHEM Devices des Aktors löschen und nach Speichern der geänderten Konfiguration FHEM neu starten
#FHEM in Lernmodus versetzen: <code><nowiki>set <IODev> teach <time [s]></nowiki></code>
#Taster am iTRV zweimal drücken (Montageposition = 0%). Der erfolgreiche Anlernvorgang wird durch einmaliges Aufleuchten der Status-LED quittiert. (Fehlanzeige: 6mal Blinken)
#Nach Montage Taster einmal drücken - das Ventil fährt die von FHEM gewünschte Position an.
#Aktor-Device wird in FHEM automatisch mit allen notwendigen Parametern angelegt.

Standardmäßig nutzt FHEM den eigenen PID-Regler des FHEM-Moduls, der auf die Eingabe einer Temperaturvorgabe wartet:
<code><nowiki>set <name> desired-temp <wert°C></nowiki></code>

Solange kein Referenz-Device mit <code><nowiki>set <name> temperatureRefDev <Temperaturdevice mit einem Reading temperature></nowiki></code> angegeben wurde, benutzt das Gerät einen internen Temperaturfühler, der bauartbedingt nicht (MVA-005:bedingt) geeignet für eine Raumregelung ist.

Zur Sicherheit des Heizkörperventils gegen Festsetzen durch Rost oder Kalk, wird im Sommermodus pro Tag eine Servicefahrt – einmal auf und zu – des Ventils durchgeführt. Zusätzlich wird dreimal am Tag die Verbindung mit FHEM aufgerufen. Das dient zur Kontrolle, dass alle bislang verbundenen Devices noch vorhanden sind und ordnungsgemäß miteinander kommunizieren.

Wenn mehr als dreimal hintereinander die Funkkommunikation mit FHEM fehlschlug (was mehr als 30 Minuten im Normalbetrieb bedeutet), sendet der Aktor nur noch alle Stunde und - falls das Ventil zu weniger als 50 Prozent geöffent ist, wird es auf 50% aufgefahren bzw. bei MVA-004 und MVA-005 ff. im internen PID-Betrieb auf 21° gesteuert.

'''Durch einmaliges Drücken des Tasters''' kann man im Alltagsbetrieb eine sofortige Funkkommunikation auslösen.

{{Hinweis|Zum Energiesparen verarbeitet der Aktor nur alle 586 oder 587 Sekunden (Sommermodus: alle 8 Stunden) Telegramme von FHEM. Darum zeigen FHEM-Befehle keine sofortige Aktorreaktion, sondern erst nach der genannten Zeitspanne. Die Rückmeldung des Aktors an FHEM über die erfolgte Befehlsausführung erfolgt wiederum erst nach erneutem Ablauf der Zeitspanne.
Falls keine Temperaturdaten geliefert werden, geht das Device in einen Stromsparmodus und fragt nur noch alle 2 Stunden an.
Zur Vermeidung dieses Stromsparmodus, in dem eben auch nicht nachgeregelt wird, sollte bei Referenzgeräte wie einem Raumthermometer das attr event-on-update '''nicht''' benutzt werden. Falls die Temperatur sich 1 Stunde lang nicht ändert, würde entsprechend auch eine Stunde lang kein Referenzwert gesendet, der Stelltrieb in den Sparmodus gehen und für die nächsten 2 Stunden nun kommende Änderungen nicht verarbeiten.
In der Praxis mit einem TCM 310 zeigt sich, dass bei einem RSSI<-80 die Funkkommunikation nicht ausreichend stabil ist. Wenn dreimal hintereinander keine Funktbestätigung erhalten wurde, geht der Aktor in den Notbetrieb und öffnet das Ventil auf 50% oder lässt es auf einem gesetzten größeren Wert bis zur nächsten erfolgreichen bisdirektionalen Kommunikation offen. Das Anpassen der Antennenausrichtung ist hier sehr wichtig.}}

=== Settings ===
{| class="wikitable sortable"
|-
! set !! Wertebereich/Default !! Beschreibung
|-
|desired-temp||10...40||Soll-Temperatur für den FHEM-PID-Controler: der PID-Controler des FHEM-Moduls wird '''ein'''geschaltet
|-
|liftSet||||??
|-
|runInit||||beim nächsten Funkkontakt wird ein Kalibrierungslauf angestoßen
|-
|setpoint||0...100||Setze Aktorposition auf X%; der PID-Controler des FHEM-Moduls wird '''ein'''geschaltet, wenn das attr pidCtrl on ist
|-
|setpointTemp||10...40||Soll-Temperatur für den FHEM-PID-Controler, der PID-Controler des FHEM-Moduls wird '''ein'''geschaltet; ein runInit wird ausgelöst wenn das attr pidCtrl on ist
|-
|ValveCloses||||Ventil auf 0% setzen; der PID-Controler des FHEM-Moduls wird '''aus'''geschaltet
|-
|ValveOpens||||Ventil auf 100% setzen; der PID-Controler des FHEM-Moduls wird '''aus'''geschaltet
|-
|}

=== Readings ===
{| class="wikitable sortable"
|-
! Reading !! Beispiel !! Wertebereich/Default !! Beschreibung
|-
|actuatorState||ok||||wenn 'obstructed', dann ist der metallene Kühlring des Gehäuses z.b. von einem Vorhang bedeckt und der Thermogenerator kann nicht richtig arbeiten
|-
|alarm||no_response_from_actuator||||nur fallweise: wenn Kommunikation ausgefallen; Aktor blinkt dreimal
|-
|battery||ok ||'''ok''' / low||
|-
|cover||closed||||wird vom MVA-002 nicht gesendet
|-
|delta||-9.75||||
|-
|feedTemp
|32.5
|
|Die Modelle ab 004 haben einen zweiten Thermofühler, der verlässlich die Vorlauftemperatur am Ventilsitz misst und zur Steuerung des eingebauten PID-Controlers herangezogen wird.
|-
|energyInput||enabled||'''enabled''' / disabled||enabled zeigt ausreichende Temperaturdifferenz zur Speisung des Akkus an
|-
|energyStorage||charged||'''charged''' / empty ||
|-
|maintenanceMode||off||'''off''' / runinit||
|-
|operationMode||setpointTemp||'''setpointTemp''' / summerMode / setpointSet||'''Betrieb mit Stellwert-Vorgabe''' / im Sommer-Modus / mit Temperatursollwert-Vorgabe
|-
|operationModeRestore||setpointTemp||||nur fallweise: Modus, der beim Beenden des summermode gesetzt wird
|-
|pidAlarm||||actuator_in_errorPos / dead_sensor / no_temperature_value / setpoint_device_missing||
|-
|pidState|||| processing |alarm / idle / '''processing''' / start / stop||
|-
|p_d||0||||
|-
|p_i||100||||
|-
|p_p||-487.5||||
|-
|roomTemp||22.0||||interne Temperatur: wenn attr setpointRefDev nicht gesetzt wird diese Temperatur benutzt - ist für Regelung nicht brauchbar wegen Verfälschung durch Vorlauftemperatur, höhere Temperaturen sind Indiz für Wärmeangebot vom Vorlauf, das den Energiespeicher lädt
|-
|selfCtrl||off||||MVA-002 hat keinen eigenen PID-Controler
|-
|setpoint||0||||beim letzten Funkkontakt gemeldete Ist-Position vom Aktuator in %
|-
|setpointSet||15||||beim nächsten Funkkontakt gesendete Aktuatorstellung in %
|-
|setpointTemp||15.0||||Soll-Temperatur. Kann gesetzt werden über <code><nowiki>set <IODev> desired-temp <°C></nowiki></code> oder auch durch Module wie Heating_Control oder WeekdayTimer
|-
|setpointTempRestore||16.0 ||||nur fallweise: setpointTemp, die bei Beenden des summermode gesetzt wird
|-
|state||T: 23.4 SPT: 15.0 SP: 0||||T:=Raumtemperatur vom Referenzsensor, SPT=setpointTemp, SP=setpoint
|-
|teach||4BS teach-in accepted EEP A5-20-01 Manufacturer: Micropelt GmbH||||Modelle >004: A5-20-06
|-
|temperature||24.75||||zuletzt gemeldete Raumtemperatur vom Referenz-Sensor (siehe Attribut temperatureRefDev)
|-
|waitingCmds||runInit|||noch nicht gesendetes Kommando, hier Kalibrierungslauf|
|-
|wakeUpCycle||240|||das Gerät meldet sich alle 4 Minuten|
|-
|window||closed||open / '''closed'''||wird vom MVA-002 nicht gesendet
|-
|}

=== Attribute ===
{| class="wikitable sortable"
|-
! Attribut !! Beispiel !! Wertebereich/Default !! Beschreibung
|-
|actualTemp
|biDir
|t/°C
|
|-
|comMode||biDir||||
|-
|destinationID||unicast||||
|-
|eep||A5-20-01||||MVA-002 bis MVA-004; beim MVA-005 A5-20-06
|-
|manufID||049||||
|-
|pidActorErrorPos||20||||MVA-002 ignoriert diesen Wert und benutzt '''50%''' oder den zuvor gesendeten höheren Stellwert
|-
|pidActorLimitLower||1||||bei 0% Öffnung wird eine Initialisierung ausgelöst?
|-
|pidCtrl||on||||bei on wird der FHEM Pid-Controler benutzt, bei off der im Actor (Modell MVA-002 hat keinen internen PID-Controler, wohl aber MVA-004 und MVA-005)
|-
|pidFactor_I||0.2||||
|-
|pidFactor_P||50||||
|-
|pidSensorTimeout||3600|||| Zahl der Sekunden, in denen der Sensor auf einen Wert vom temperatureRefDev auf einen Wert wartet, sonst Alarm
|-
|pidDeltaTreshold
|2
|1
|Minimale Veränderung der Aktorstellung in Prozent
|-
|rcvRespAction||||||Hier kann eine Aktion eingetragen werden, die bei Rückmeldung des Aktors durchgeführt wird. Details in der FHEM-Referenz
|-
|setpointRefDev||||||Das Device, das die Ventilöffnung (Aktuator) vorgibt, z.B. ein Raumregler, FHEM-PID20. Typischerweise '''nicht gesetzt, es wird der modul-eigene PID-Controler benutzt'''
|-
|setpointSummerMode||2||||Ventilöffnung, die im Sommer gelten soll
|-
|setpointTempRefDev||CC.Kueche||||Eintragen, wenn ein Device, die Solltemperatur vorgibt, z.B. Heating_Control oder ein physischer Raumthermostat, der in FHEM ausgelesen wird.
|-
|subDef||********||||Sender-ID
|-
|subType||hvac.01||||bei MVA-002 bis MVA-004: hvac.01; ab MVA-005: hvac.06
|-
|summerMode||off||||
|-
|teachMethod||4BS||||
|-
|temperatureRefDev||T.Kueche||||Das Device, das mindestens einmal pro Stunde ein Event mit Namen temperature (aktuelle Raumtemperatur) meldet
|-
|webCmd||setpointTemp||||
|-
|}

== Tipps & Tricks ==
Fehlermeldungen wie Sensor '''dead''' oder '''no Response from actuator''' kann man im Betrieb mit einem externen Sensor verhindern, indem man mindestens alle 5 Minuten einen Temperaturwert sendet (gegebenenfalls mit attr event-min-interval im sendenden Temperatur-Device einstellen). Alternativ kann man auch über ein DOIF alle 24 Stunden den Wunschwert mit <Code>set <Devicename> desired-temp 20</Code> wiederholen, wobei 20 beispielhaft eine Wunschtemperatur ist.

Für eine stabile Funkkommunikation ist ein RSSI von besser als -80 anzustreben. Eine Verbesserungsmöglichkeit bietet das versuchsweise Drehen des Micropelt am Heizkörper um 90°. Normalerweise ist der geprägte Schriftzug Micropelt waagerecht wie auch die innen liegende Antenne. Nach der Drehung steht diese dann aufrecht. Das passt in der Praxis dann manchmal besser zu einer waagerecht angeordneten Senderantenne, deren Leistung sich dann gezielter im Haus verbreitet. Ein RSSI von -70 ist besser als -80.
Die Empfangsqualität aller EnOcean-Geräte lässt sich schnell mit <Code>list .* TCM_ESP3_0_RSSI</Code> abfragen, wobei TCM_ESP3_0 der Name des EnOcean-Gateways ist.

Die neueren Modelle beginnen nach einer sehr langen Sommerpause bei leerem Akku schon nach wenigen Minuten mit Vorlauftemperaturen um 30 Grad wieder ihren Betrieb alleine mit dem Strom, den der kleine Thermo-Generator erzeugt.

== ToDos ==
Optimierungstipps, um möglichst wenig Energie im Aktor zu verbrauchen: Sommerbetrieb und Filtern von Sollwert-Verstellungen.

event-on-NN beim Sensor, wakeupCycle

Sorgt Setpoint 0 für eine Initialisierung?

Optimierung von p_i,p_d,p_p in der Praxis

Bedeutung von set <name> liftSet

Abgrenztung ActualTemp gegenüber temperatureRefDev

== Links ==
* {{Link2Forum|Topic=34314|Message=290203|LinkText=Forenbeitrag}}

[[Kategorie:EnOcean Components]]
[[Kategorie:Heizungsventile]]

Apache Authentication Proxy

2026-01-31T11:06:01Z

Ph1959de: "hr" eingefügt

{{Randnotiz|RNText=Anstatt die unten angegeben einfache BasicAuth zu nutzen kann folgende Erweiterung für eine browserbasierte passwortlose Authentifizierung per QR-Code (Magic-Link) oder Login mit persistentem Cookie verwendet werden. Falls ein gültiges Authentifizierungs-cookie vorliegt wird man transparent zur Applikation weitergeleitet. Andernfalls muss man sich einmal anmelden um das Cookie zu setzen. Anschließend wird man zur Applikation weitergeleitet.
Voraussetzungen ist der Betrieb und Konfiguration eines eigenen Apache2 Webservers in dieser Anleitung. Das AddOn funktioniert u.a. in iOs und dem Passwortmanager und ist [https://github.com/tobiasfaust/SimpleWebAuth hier dokumentiert]
<hr>
Eine sicherere Variante eines Apache Authentication Proxy zusätzlich mit Zertifikaten ist [https://gist.github.com/gbirke/8608543 hier dokumentiert]}}
== Konfiguration ==
Um den Zugriff auf [[FHEMWEB]] etwas sicherer zu machen, kann man den Webzugriff über einen [https://httpd.apache.org/ Apache Webserver] laufen lassen. Dies ist ein kurzes Rezept, um Zugriffe auf FHEMWEB über einen Apachen authentifizieren zu lassen. Erstellt wurde es auf [https://www.debian.org Debian Squeeze]], sollte aber auch mit [https://www.ubuntu.com/ Ubuntu] funktionieren.

<syntaxhighlight lang="bash">
apt-get install apache2 libapache2-mod-proxy-html
</syntaxhighlight>

Step 1) FHEMWEB sollte nur noch auf Anfragen vom selben Rechner lauschen, also kein 'global' Attribut in der Definition in fhem.cfg

<syntaxhighlight lang="perl">
define WEBS FHEMWEB 8084
</syntaxhighlight>

Step 2) die folgenden Apache2 Module müssen aktiviert sein: [https://httpd.apache.org/docs/current/mod/mod_proxy.html mod_proxy] + [http://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html mod_proxy_http]

<syntaxhighlight lang="ini">
a2enmod proxy
a2enmod proxy_http
</syntaxhighlight>

Step 3) neue Datei '''''/etc/apache2/conf.d/fhem''''' anlegen:

Diese Konfiguration sorgt dafür, dass alle Anfragen unter /fhem weiter nach '''http://localhost/fhem''' geleitet werden. Zusätzlich wird eine Basic-Authentifizierung eingeschaltet. Die Benutzerdatenbank ist dann in /etc/fhem-htpasswd zu finden.

<syntaxhighlight lang="ini">
<Location /fhem>
# ProxyPass/ProxyPassReverse leitet HTTP requests auf eine andere URL um
ProxyPass http://localhost:8084/fhem
ProxyPassReverse http://localhost:8084/fhem
ProxyHTMLEnable On
# ProxyHTMLURLMap passt Links im HTML/JavaScript Source an
ProxyHTMLURLMap / /fhem/
ProxyHTMLURLMap /fhem/ /fhem/
AuthType Basic
AuthName "Password Required"
AuthUserFile /etc/fhem-htpasswd
Require valid-user
Order deny,allow
Allow from all
</Location>
</syntaxhighlight>

Step 4) Benutzer-Datenbank in '''''/etc/fhem-htpasswd''''' anlegen

<syntaxhighlight lang="bash">
# -c -> create file
# -s SHA encryption
htpasswd -c -s /etc/fhem-htpasswd <username>
# add more users with
htpasswd -s /etc/fhem-htpasswd <username>
</syntaxhighlight>

Step 5) Apache neu starten

<syntaxhighlight lang="bash">invoke-rc.d apache2 reload</syntaxhighlight>

bzw.

<syntaxhighlight lang="bash">service apache2 reload</syntaxhighlight>

Fertig. FHEM ist jetzt über '''''http://server/fhem''''' erreichbar. Alle Zugriffe müssen aber erst mit Benutzername + Passwort freigeschaltet werden.

=== SSL-Konfiguration ===

Um nicht die Passwörter unverschlüsselt übers Netz zu schicken, ist die Konfiguration eines SSL-Reverse-Proxys noch empfehlenswerter. Die untenstehende Konfiguration zeigt die Verwendung mittels Zertifikaten, die von [https://letsencrypt.org Let's Encrypt] ausgestellt wurden.

<syntaxhighlight lang="ini">
<VirtualHost *:80>
ServerName $host
RedirectPermanent / https://$host/
</VirtualHost>

<VirtualHost *:443>
ServerName $host

SSLEngine on
SSLProtocol all -SSLv2 -SSLv3
SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA
SSLHonorCipherOrder on
SSLCompression off
SSLOptions +StrictRequire

SSLCertificateFile /etc/letsencrypt/live/$host/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/$host/privkey.pem

Use RootDir $dir # hier sollte ein Verzeichnis unter /var/www stehen (kann leer sein, muss aber existieren)

ProxyPass /.well-known !
Alias /.well-known "/var/www/proxy/.well-known"
<Directory "$dir/.well-known">
order allow,deny
allow from all
AllowOverride All
AddDefaultCharset Off
</Directory>

ProxyRequests Off
ProxyVia Off
ProxyPreserveHost On
ProxyPass /fhem http://$fhemhost:$port/fhem
ProxyPassReverse /fhem http://$fhemhost:$port/fhem

Header always set Strict-Transport-Security "max-age=31536000"

<Proxy *>
Order deny,allow
Allow from all
AuthType Basic
AuthName "Password Required"
AuthUserFile /etc/fhem-htpasswd
Require valid-user
</Proxy>
</VirtualHost>
</syntaxhighlight>

Die Proxy-Konfiguration ist so gewählt, dass auch automatische Zertifikats-Aktualisierung per webroot klappt (<code>letsencrypt certonly --renew-by-default --webroot -w $dir -d $host</code>). Initial muss man natürlich ohne Zertifikat einen normalen non-SSL-VHost aufmachen.

== Websockets-Unterstützung ==

<syntaxhighlight lang="ini">
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /fhem(.*) ws://$url$1 [P,L]
RewriteCond %{HTTP:Upgrade} !=websocket [NC]
RewriteRule /fhem(.*) http://$url$1 [P,L]
</syntaxhighlight>

== Hinweis zu Apache 2.4 ==
Es muss zusätzlich das Modul '''proxy_html''' aktiviert werden (<code>a2enmod proxy_html</code>).
Und die zu erstellende Config-Datei muss jetzt nach ''/etc/apache2/conf-available/fhem.conf'' (statt /etc/apache2/conf.d/fhem).

== Mögliche Probleme ==

=== Invalid command 'ProxyHTMLURLMap' ===
Falls nach dem Neustart des Apache folgende Fehlermeldung kommt:

<nowiki>Invalid command 'ProxyHTMLURLMap', perhaps misspelled or defined by a module not included in the server configuration
Action 'configtest' failed.
The Apache error log may have more information.</nowiki>

fehlt das Paket libapache2-mod-proxy-html. Einfach mit

<syntaxhighlight lang="bash">apt-get install libapache2-mod-proxy-html</syntaxhighlight>

nachinstallieren.

=== ProxyHTMLURLMap funktioniert nicht ===

Nicht bei allen Distributionen scheint die Konfigurationsdatei proxy_html.conf mitgeliefert zu werden. Allerdings ist seit einigen Versionen aus mod_proxy_ssl alle Information über zu ersetzende Links etc. entfernt worden. proxy_html.conf wird daher zwingend benötigt. Sie sollte in /etc/apache2/mods-available liegen und bei der Aktivierung des mods nach /etc/apache2/mods-enabled verlinkt werden. Wenn das nicht der Fall ist, kann man das nachholen.

Eine Beispielkonfiguration gibt es [http://apache.webthing.com/svn/apache/filters/proxy_html/proxy_html.conf hier beim ursprünglichen Autor des mods]. Abspeichern unter /etc/apache2/mods-available/proxy_html.conf und dann verlinken:

<syntaxhighlight lang="bash">ln -s /etc/apache2/mods-available/proxy_html.conf /etc/apache2/mods-enabled/proxy_html.conf</syntaxhighlight>

Dann Apache neu starten/laden.

=== Content Encoding Fehler ===

Wenn Firefox und Chromium sich nach der Konfigurationsänderung über Content Encoding Fehler beschweren, könnte Folgendes helfen:

<pre>SetOutputFilter INFLATE;proxy-html;DEFLATE</pre>

Evtl. kann auch folgender Eintrag noch notwendig sein:

<pre>
# Enables outgoing compression for specific file types
<IfModule mod_deflate.c>
<FilesMatch ".*\.(html|htm|shtml|php|css|js|xml|log|txt|bmp|ttf|otf|eot|svg)$">
SetOutputFilter DEFLATE
</FilesMatch>
AddOutputFilterByType DEFLATE text/html text/plain text/css application/json
AddOutputFilterByType DEFLATE application/rss+xml
AddOutputFilterByType DEFLATE text/xml application/xml application/xhtml+xml text/x-com$
AddOutputFilterByType DEFLATE text/javascript application/javascript application/x-java$
</IfModule>
</pre>

==Links==
*[[HTTPS-Absicherung & Authentifizierung via nginx Webserver]]
*[https://github.com/tobiasfaust/SimpleWebAuth A simple apache/php web authenticator with longlife JWT tokens for a permanently signin]

[[Kategorie:HOWTOS]]

Apache Authentication Proxy

2026-01-31T11:05:01Z

Ph1959de: Randnotizen aus Formatierungsgründen zusammengefasst

{{Randnotiz|RNText=Anstatt die unten angegeben einfache BasicAuth zu nutzen kann folgende Erweiterung für eine browserbasierte passwortlose Authentifizierung per QR-Code (Magic-Link) oder Login mit persistentem Cookie verwendet werden. Falls ein gültiges Authentifizierungs-cookie vorliegt wird man transparent zur Applikation weitergeleitet. Andernfalls muss man sich einmal anmelden um das Cookie zu setzen. Anschließend wird man zur Applikation weitergeleitet.
Voraussetzungen ist der Betrieb und Konfiguration eines eigenen Apache2 Webservers in dieser Anleitung. Das AddOn funktioniert u.a. in iOs und dem Passwortmanager und ist [https://github.com/tobiasfaust/SimpleWebAuth hier dokumentiert]

Eine sicherere Variante eines Apache Authentication Proxy zusätzlich mit Zertifikaten ist [https://gist.github.com/gbirke/8608543 hier dokumentiert]}}
== Konfiguration ==
Um den Zugriff auf [[FHEMWEB]] etwas sicherer zu machen, kann man den Webzugriff über einen [https://httpd.apache.org/ Apache Webserver] laufen lassen. Dies ist ein kurzes Rezept, um Zugriffe auf FHEMWEB über einen Apachen authentifizieren zu lassen. Erstellt wurde es auf [https://www.debian.org Debian Squeeze]], sollte aber auch mit [https://www.ubuntu.com/ Ubuntu] funktionieren.

<syntaxhighlight lang="bash">
apt-get install apache2 libapache2-mod-proxy-html
</syntaxhighlight>

Step 1) FHEMWEB sollte nur noch auf Anfragen vom selben Rechner lauschen, also kein 'global' Attribut in der Definition in fhem.cfg

<syntaxhighlight lang="perl">
define WEBS FHEMWEB 8084
</syntaxhighlight>

Step 2) die folgenden Apache2 Module müssen aktiviert sein: [https://httpd.apache.org/docs/current/mod/mod_proxy.html mod_proxy] + [http://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html mod_proxy_http]

<syntaxhighlight lang="ini">
a2enmod proxy
a2enmod proxy_http
</syntaxhighlight>

Step 3) neue Datei '''''/etc/apache2/conf.d/fhem''''' anlegen:

Diese Konfiguration sorgt dafür, dass alle Anfragen unter /fhem weiter nach '''http://localhost/fhem''' geleitet werden. Zusätzlich wird eine Basic-Authentifizierung eingeschaltet. Die Benutzerdatenbank ist dann in /etc/fhem-htpasswd zu finden.

<syntaxhighlight lang="ini">
<Location /fhem>
# ProxyPass/ProxyPassReverse leitet HTTP requests auf eine andere URL um
ProxyPass http://localhost:8084/fhem
ProxyPassReverse http://localhost:8084/fhem
ProxyHTMLEnable On
# ProxyHTMLURLMap passt Links im HTML/JavaScript Source an
ProxyHTMLURLMap / /fhem/
ProxyHTMLURLMap /fhem/ /fhem/
AuthType Basic
AuthName "Password Required"
AuthUserFile /etc/fhem-htpasswd
Require valid-user
Order deny,allow
Allow from all
</Location>
</syntaxhighlight>

Step 4) Benutzer-Datenbank in '''''/etc/fhem-htpasswd''''' anlegen

<syntaxhighlight lang="bash">
# -c -> create file
# -s SHA encryption
htpasswd -c -s /etc/fhem-htpasswd <username>
# add more users with
htpasswd -s /etc/fhem-htpasswd <username>
</syntaxhighlight>

Step 5) Apache neu starten

<syntaxhighlight lang="bash">invoke-rc.d apache2 reload</syntaxhighlight>

bzw.

<syntaxhighlight lang="bash">service apache2 reload</syntaxhighlight>

Fertig. FHEM ist jetzt über '''''http://server/fhem''''' erreichbar. Alle Zugriffe müssen aber erst mit Benutzername + Passwort freigeschaltet werden.

=== SSL-Konfiguration ===

Um nicht die Passwörter unverschlüsselt übers Netz zu schicken, ist die Konfiguration eines SSL-Reverse-Proxys noch empfehlenswerter. Die untenstehende Konfiguration zeigt die Verwendung mittels Zertifikaten, die von [https://letsencrypt.org Let's Encrypt] ausgestellt wurden.

<syntaxhighlight lang="ini">
<VirtualHost *:80>
ServerName $host
RedirectPermanent / https://$host/
</VirtualHost>

<VirtualHost *:443>
ServerName $host

SSLEngine on
SSLProtocol all -SSLv2 -SSLv3
SSLCipherSuite ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA
SSLHonorCipherOrder on
SSLCompression off
SSLOptions +StrictRequire

SSLCertificateFile /etc/letsencrypt/live/$host/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/$host/privkey.pem

Use RootDir $dir # hier sollte ein Verzeichnis unter /var/www stehen (kann leer sein, muss aber existieren)

ProxyPass /.well-known !
Alias /.well-known "/var/www/proxy/.well-known"
<Directory "$dir/.well-known">
order allow,deny
allow from all
AllowOverride All
AddDefaultCharset Off
</Directory>

ProxyRequests Off
ProxyVia Off
ProxyPreserveHost On
ProxyPass /fhem http://$fhemhost:$port/fhem
ProxyPassReverse /fhem http://$fhemhost:$port/fhem

Header always set Strict-Transport-Security "max-age=31536000"

<Proxy *>
Order deny,allow
Allow from all
AuthType Basic
AuthName "Password Required"
AuthUserFile /etc/fhem-htpasswd
Require valid-user
</Proxy>
</VirtualHost>
</syntaxhighlight>

Die Proxy-Konfiguration ist so gewählt, dass auch automatische Zertifikats-Aktualisierung per webroot klappt (<code>letsencrypt certonly --renew-by-default --webroot -w $dir -d $host</code>). Initial muss man natürlich ohne Zertifikat einen normalen non-SSL-VHost aufmachen.

== Websockets-Unterstützung ==

<syntaxhighlight lang="ini">
RewriteEngine On
RewriteCond %{HTTP:Upgrade} =websocket [NC]
RewriteRule /fhem(.*) ws://$url$1 [P,L]
RewriteCond %{HTTP:Upgrade} !=websocket [NC]
RewriteRule /fhem(.*) http://$url$1 [P,L]
</syntaxhighlight>

== Hinweis zu Apache 2.4 ==
Es muss zusätzlich das Modul '''proxy_html''' aktiviert werden (<code>a2enmod proxy_html</code>).
Und die zu erstellende Config-Datei muss jetzt nach ''/etc/apache2/conf-available/fhem.conf'' (statt /etc/apache2/conf.d/fhem).

== Mögliche Probleme ==

=== Invalid command 'ProxyHTMLURLMap' ===
Falls nach dem Neustart des Apache folgende Fehlermeldung kommt:

<nowiki>Invalid command 'ProxyHTMLURLMap', perhaps misspelled or defined by a module not included in the server configuration
Action 'configtest' failed.
The Apache error log may have more information.</nowiki>

fehlt das Paket libapache2-mod-proxy-html. Einfach mit

<syntaxhighlight lang="bash">apt-get install libapache2-mod-proxy-html</syntaxhighlight>

nachinstallieren.

=== ProxyHTMLURLMap funktioniert nicht ===

Nicht bei allen Distributionen scheint die Konfigurationsdatei proxy_html.conf mitgeliefert zu werden. Allerdings ist seit einigen Versionen aus mod_proxy_ssl alle Information über zu ersetzende Links etc. entfernt worden. proxy_html.conf wird daher zwingend benötigt. Sie sollte in /etc/apache2/mods-available liegen und bei der Aktivierung des mods nach /etc/apache2/mods-enabled verlinkt werden. Wenn das nicht der Fall ist, kann man das nachholen.

Eine Beispielkonfiguration gibt es [http://apache.webthing.com/svn/apache/filters/proxy_html/proxy_html.conf hier beim ursprünglichen Autor des mods]. Abspeichern unter /etc/apache2/mods-available/proxy_html.conf und dann verlinken:

<syntaxhighlight lang="bash">ln -s /etc/apache2/mods-available/proxy_html.conf /etc/apache2/mods-enabled/proxy_html.conf</syntaxhighlight>

Dann Apache neu starten/laden.

=== Content Encoding Fehler ===

Wenn Firefox und Chromium sich nach der Konfigurationsänderung über Content Encoding Fehler beschweren, könnte Folgendes helfen:

<pre>SetOutputFilter INFLATE;proxy-html;DEFLATE</pre>

Evtl. kann auch folgender Eintrag noch notwendig sein:

<pre>
# Enables outgoing compression for specific file types
<IfModule mod_deflate.c>
<FilesMatch ".*\.(html|htm|shtml|php|css|js|xml|log|txt|bmp|ttf|otf|eot|svg)$">
SetOutputFilter DEFLATE
</FilesMatch>
AddOutputFilterByType DEFLATE text/html text/plain text/css application/json
AddOutputFilterByType DEFLATE application/rss+xml
AddOutputFilterByType DEFLATE text/xml application/xml application/xhtml+xml text/x-com$
AddOutputFilterByType DEFLATE text/javascript application/javascript application/x-java$
</IfModule>
</pre>

==Links==
*[[HTTPS-Absicherung & Authentifizierung via nginx Webserver]]
*[https://github.com/tobiasfaust/SimpleWebAuth A simple apache/php web authenticator with longlife JWT tokens for a permanently signin]

[[Kategorie:HOWTOS]]

BOSE SoundTouch de-clouding

2026-01-27T18:00:57Z

Ph1959de: Sichtung der letzten Änderungen; kleinere Korrekturen

== Zielgruppe ==
Benutzer von BOSE SoundTouch-Systemen

== Lösungsübersicht ==
Cloudfreier Betrieb der BOSE-Boxen, De-bricking nach fehlerhaften Installationen

== Ausgangssituation ==
BOSE wird im Februar 2026 seine Server aus dem Netz nehmen. Damit wird die Funktionalität der BOSE-Boxen drastisch eingeschränkt, das Abspielen von netzbasierten Radiostreams ist ohne Modifikation der Boxen nicht möglich.

== De-clouding ==
Um einen root-Zugang zum Linux-Betriebssystem der Boxen zu erhalten, wird benötigt:
* USB-Stick, formatiert FAT32, mit einer leeren Datei 'remote_services'. Achtung: Das bootable-Flag des Dateisystems muss gesetzt sein.
* Für BOSE ST10 und ST300 zusätzlich ein USB-OTG-Adapter. Das ist ein Adapter, der eine Buchse vom Typ USB A (in den wird der o.a. Stick gesteckt) mit einem Stecker vom Type USB Micro (Typ Micro B, trapezförmig) verbindet. Darin ist offenbar das 5. (ID-)Pin des Micro USB-Steckers mit GND verbunden. Diese Adapter gibt es für ca. 8 € im Handel, sie werden gerne benutzt, um Smartphones in den USB-Host-Modus zu bringen.
===Vorbereitung allgemein===
In der Regel werden für den cloudfreien Betrieb der Boxen sowohl die Device-ID, als auch die ID des BOSE-Accounts benötigt. Dazu greift man mit einem Browser auf das API der Box zu, und ruft die Adresse
http://<IP-Adresse der Box>:8090/info
auf. Die Rückgabe sieht etwa so aus:
<info deviceID="{Device-ID}">
<name>{Name des Geräts in der BOSE Apps}</name>
<type>SoundTouch 300</type>
<margeAccountUUID>{ID des BOSE-Accounts}</margeAccountUUID>
...
Diese beiden Codes bitte notieren. Außerdem die drei Dateien
http://<IP-Adresse der Box>:8090/info
http://<IP-Adresse der Box>:8090/recents
http://<IP-Adresse der Box>:8090/preset
lokal abspeichern mit den Namen DeviceInfo.xml, Recents.xml, Presets.xml (Achtung, XML-Header nicht vergessen).

===Vorbereitung ST10===
Achtung: Vorher unbedingt die Einbindung der ST10 in ein Stereopaar aufheben! Sonst ist das Gerät nach der Änderung der internen Dateien nur noch ein teurer Ziegelstein ('Brick') und man muss erst die gesamte Firmware neu installieren, siehe unten.
*USB-Stick durch den OTG-Adapter mit dem USB-Port der ST10 verbinden.
*Stromversorgungskabel abziehen.
*Stromversorgungskabel wieder einstecken
*Die ST10 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an.

===Vorbereitung ST20===
*USB-Stick mit dem USB-Port der ST20 verbinden.
*Stromversorgungskabel abziehen.
*Stromversorgungskabel wieder einstecken
*Die ST20 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an.

===Vorbereitung ST300===
*USB-Stick durch den OTG-Adapter mit dem USB-Port der ST300 verbinden.
*Stromversorgungskabel abziehen.
*Infrarot-Fernbedienung der ST300 auf das Gerät richten, den ''SoundTouch''-Button drücken und '''halten''' (2. Button in der 2. Reihe)
*Währenddessen das Stromversorgungskabel wieder einstecken
*Die ST300 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an.
*LEDs der ST300 sollten jetzt gelb blinken

===Zugang===
Der Zugang ist jetzt möglich mit
<syntaxhighlight lang="Bash">
telnet <IP-Adresse der Box>
</syntaxhighlight>
Auf die Rückgabe 'rhino login' einfach 'root' eingeben, ein Passwort ist nicht erforderlich.
Alternativ kann man auch verwenden
<syntaxhighlight lang="Bash">
ssh -o HostKeyAlgorithms=+ssh-rsa -o PubkeyAcceptedAlgorithms=+ssh-rsa root@<IP-Adresse der Box>
</syntaxhighlight>
Möchte man diesen Zugang permanent haben, um ggf. weitere Änderungen einfacher auszuführen, muss man eine leere Datei 'remote_services' erzeugen mit dem Kommando
touch /mnt/nv/remote_services
Während das für die Umstellung auf cloudfreien Betrieb ganz komfortabel ist, sollte man diese Datei nach erfolgreich getester Umstellung wieder löschen, denn sonst ist die Box komplett ungesichert!

===Holen weiterer Daten===
Nach einem Wechsel in das korrekte Verzeichnis
cd /mnt/nv/BoseApp-Persistence/1/
findet man dort auch die schon oben erwähnten Dateien Recents.xml und Presets.xml, sie können auch von hier auf den USB-Stick herunterkopiert werden.

Ebenfalls in diesem Verzeichnis liegt die Datei Sources.xml, dies muss ebenfalls entweder kopiert werden. Entweder local auf den USB-Stick oder, z.B. mit dem Befehl
scp Sources.xml {username}@{irgendein computer}
Via Netz übertragen werden.
===Umbiegen===
Die Konfiguration der BOSE-Server kann jetzt geändert werden, dazu muss man das richtige Verzeichnis auf der Box kennen, das Dateisystem beschreibbar machen und die entsprechende Datei ändern
cd /opt/Bose/etc/
rw
vi SoundTouchSdkPrivateCfg.xml
Für Nicht-Linux-Nutzer ist der vi Editor etwas gewöhnungsbedürftig, hier findet man eine [https://sits.de/vi.html Mini-Anleitung].

Die Datei enthält im BOSE-Urzustand folgende Informationen
<syntaxhighlight lang="XML">
<?xml version="1.0" encoding="utf-8"?>
<SoundTouchSdkPrivateCfg>
<margeServerUrl>https://streaming.bose.com</margeServerUrl>
<statsServerUrl>https://events.api.bosecm.com</statsServerUrl>
<swUpdateUrl>https://worldwide.bose.com/updates/soundtouch</swUpdateUrl>
<usePandoraProductionServer>true</usePandoraProductionServer>
<isZeroconfEnabled>true</isZeroconfEnabled>
<saveMargeCustomerReport>false</saveMargeCustomerReport>
<bmxRegistryUrl>https://content.api.bose.io/bmx/registry/v1/services</bmxRegistryUrl>
</SoundTouchSdkPrivateCfg>>
</syntaxhighlight>
Um die Box auf einen anderen Server umzubiegen, der unter dem Namen oder der IP-adresse <code>'{NeuerServer}:{Port}'</code> erreichbar ist, bitte den Inhalt wie folgt ändern:
<syntaxhighlight lang="XML">
<?xml version="1.0" encoding="utf-8"?>
<SoundTouchSdkPrivateCfg>
<margeServerUrl>http://{NeuerServer}:{Port}/marge</margeServerUrl>
<statsServerUrl>http://{NeuerServer}:{Port}</statsServerUrl>
<swUpdateUrl>http://{NeuerServer}:{Port}/updates/soundtouch</swUpdateUrl>
<usePandoraProductionServer>true</usePandoraProductionServer>
<isZeroconfEnabled>true</isZeroconfEnabled>
<saveMargeCustomerReport>false</saveMargeCustomerReport>
<bmxRegistryUrl>http://{NeuerServer}:{Port}/bmx/registry/v1/services</bmxRegistryUrl>
</SoundTouchSdkPrivateCfg>
</syntaxhighlight>

== De-bricking ==
Für den Fall, dass die BOSE Box nach irgendwelchen Änderungen nicht mehr ins lokale WLAN findet, aber auch keinen eigenen Access Point anbietet, kann man das Gerät dennoch retten. Dazu muss die Firmware komplett neu installiert werden. Zunächst die passende Firmware suchen

[https://archive.org/download/bose-soundtouch-software-and-firmware/ Archiv mit BOSE Firmware]

Die Zip-Datei muss entpackt werden die darin enthaltene Datei mit der Endung ''.stu'' muss auf einen bootfähigen USB-Stick geschrieben werden, siehe oben.

TODO: Unterabschnitte für die anderen Systeme schreiben, da nicht bekannt ist, wie lange [https://downloads.bose.com/ced/soundtouch/soundtouch_usb/index.html?l=de BOSE die Informationen noch zur Verfügung stellt].

===ST10===
*USB-Stick durch den OTG-Adapter mit dem USB-Port der ST10 verbinden.
*Stromversorgungskabel abziehen.
*Auf dem Tastenfeld die Taste „4“ und die „Lautstärke leiser“-Taste drücken und '''halten'''
*Stromversorgungskabel wieder einstecken
*Die ST10 bootet jetzt vom USB-Stick, ggf. zeigt dessen Signal-LED den Zugriff an. Die Buttons können nun losgelassen werden.
Die Installation dauert ca. 5 Minuten.

[[Kategorie:HOWTOS]]
[[Kategorie:BOSE]]

Modul Shelly

2026-01-14T18:56:16Z

Ph1959de: Hinweis auf Umbau / Umstrukturierung der Seiten

{{Baustelle}}{{Todo|'''Achtung: Diese Seite ist teilweise veraltet, insbesondere unterstützt das Modul weitere Aktoren. Bitte Commandref lesen - diese Seite ist in Überarbeitung'''}}{{Todo|Umstrukturierung läuft gerade, weitere betroffene Seiten sind [[Shelly]], [[Shelly (Modul)]], [[ShellyMonitor]], weitere können und werden folgen... --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 19:56, 14. Jan. 2026 (CET)}}{{Infobox Modul
|ModPurpose=Das Modul stellt ein Interface zur Bedienung von Shelly Devices zur Verfügung
|ModType=d
|ModCmdRef=Shelly
|ModForumArea=Sonstige Systeme
|ModFTopic=118446
|ModTechName=36_Shelly.pm
|ModOwner=Starkstrombastler ({{Link2FU|3884|Forum}}/[[Benutzer Diskussion:Starkstrombastler|Wiki]])
}}
Auf dieser Seite werden die Aktoren des bulgarischen Herstellers Allterco Robotics beschrieben (Markenname Shelly) sowie deren Ansteuerung mit FHEM und aufgetretene Probleme.
{{Randnotiz|RNTyp=r|RNText='''Achtung''': Einige der auf dieser Seite erwähnten Geräte und Funktionen sind derzeit nur mit {{Link2Forum|Topic=111905|Message=1285498|LinkText=dieser Testversion}} verfügbar, die manuell installiert werden muss!
* Für die Weiterentwicklung des Moduls wurde im Forum ein neues Thema '''({{Link2Forum|Topic=137222|LinkText=Entwicklungs-Thread Modul 36_Shelly.pm}})''' aufgemacht.}}
Bei den Shelly-Geräten handelt es sich um IP-basierte Schalt- und Dimmaktoren, die auf verschiedene Weise angesteuert werden können
*über die Web-Oberfläche des eingebauten Mikro-Webservers,
*über eine proprietäre App des Herstellers (Achtung, Cloud!),
*über das hier beschriebene FHEM-Modul 36_Shelly.pm
*über MQTT
Ein Teil der Aktoren verfügt über eine eingebaute Leistungsmessung (siehe Spalte Messkanäle in unten stehender Tabelle).

Einen Überblick über die (mittlerweile - Frühjahr 2025 - vier) Gerätegenerationen (Gen1 bis Gen4) bietet die Supportseite [https://support.shelly.cloud/de/support/solutions/articles/103000316073-vergleich-von-shelly-gen-1-gen-2-gen-3-gen4-ger%C3%A4ten Vergleich von Shelly gen1...gen4 Geräten]. Die untenstehende Auflistung muss angesichts der mittlerweile vier Geräteversionen überarbeitet werden.

==Geräteübersicht==
Übersicht der IP-basierten Produktreihen
{| class="wikitable mw:datatable"
! style="width:15px" |ID
! style="width:100px" | Produktreihe
! style="width:225px" |gemeinsame Merkmale
|-
|SH
|erste Generation
|COIOT (Nutzung mit Shelly-Monitor), kein Bluetooth
|-
|SN
|Shelly Plus
Shelly Plus mini
|
|-
|SP
|Shelly Pro
|Montage auf Hutschiene, zusätzlicher Ethernet-Port (RJ45)
|-
|S3
|Shelly Gen3
Shelly Gen3 mini
|proprietärer Prozessor
|-
|SA
|Control Panel
|Android-System
|}
ID: erste beiden Stellen der Modell-ID

Liste der aktuell unterstützten Geräte
(hier nicht aufgeführte Geräte der ersten Generation können zusammen mit dem Shelly-Monitor genutzt werden):
{| class="wikitable sortable"
! data-sort-type="text" style="width:150px" |Modell
! data-sort-type="text" style="width:75px" |Typ
! data-sort-type="number" style="width:20px;text-align:center;" |Schalt- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Dimm- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Mess- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Digital Eingänge
! |Bemerkungen
|-
! colspan="7" |'''Gen 1'''
|-
|Shelly 1
|Schalter
|1
|
|
|1
|
|
|-
|Shelly 1PM
|Schalter
|1
|
|1
|1
|
|
|-
|Shelly 1L
|Schalter
| 1
|
|1
| 1
|
|
|-
| rowspan="2" |Shelly 2
| Schalter
|2
|
|1
|2
|
|
|-
|Rollladenaktor
|1
|
|1
|2
|
|-
| rowspan="2" |Shelly 2.5
|Schalter
| 2
|
|2
|2
|
|-
|Rollladenaktor
|1
|
|1
|2
|
|-
|Shelly 4Pro
|Schalter
|4
|
|4
|4
|
|-
|Shelly i3
| Digitale Eingänge
|
|
|
|3
|
|-
|Shelly EM
|Leistungsmessung
|1
|
|2
|
|
|-
|'''[[Shelly 3EM]]'''
|Leistungsmessung
|1
|
|3
|
|
|-
|'''[[Shelly Uni]]'''
|Universal
|2
|
|
|*)
|1-Wire, 2 potentialfreie Relaisausgänge
Analogeingänge
|-
|Shelly Plug
Shelly Plug S
|Schaltsteckdose
|1
|
|1
|
|1 Taster
|-
| rowspan="2" |Shelly RGBW2
|Dimmer
|
|4
|4
|1
|4-fach Aktor
|-
|Dimmer
|
|1
| 1
|1
|RGBW Controller
|-
|Shelly Dimmer2
|Dimmer
|
| 1
|1
|2
|
|-
|Shelly Duo
|Leuchte
|
|1
|
|
|E27 oder GU10 Fassung
|-
|Shelly Vintage
|Leuchte
|
|1
|
|
|
|-
|Shelly Bulb
|Leuchte
|
|1
|
|
|Modi: weiß oder farbe
|-
! colspan="7" |'''Shelly Plus'''
|-
|Shelly Plus 1

|Schalter
|1
|
|
|1
|
|-
|'''[[Shelly Plus 1PM]]'''
|Schalter
|1
|
|1
|1
|
|-
| rowspan="2" |'''[[Shelly Plus 2PM]]'''
| Schalter
|2
|
|2
|2
|-
|Rollladenaktor
|1
|
| 1
|2
|-
|Shelly Plus i4
|Digitale Eingänge
|
|
|
| 4
|AC und DC - Variante
|-
| Shelly Plus Plug S
Shelly Plus Plug IT
Shelly Plus Plug UK
Shelly Plus Plug US
|Schaltsteckdose

|1
|
|1
|
|1 Taster;
Varianten V1, V2
|-
|Shelly Plus Uni
|Universal
| 2
|
|
|*)
|1-Wire, 2 potentialfreie Relaisausgänge
Analogeingänge; Neu in 2024
|-
|Shelly Plus 0-10V Dimmer
|Dimmer
|
|1
|1
|2
|0-10 V DC Ausgang
|-
| rowspan="2" |Shelly Plus RGBW
|Dimmer
|
|4
|4
|4
|4-fach Aktor
|-
|Dimmer
|
|1
|1
|1
|RGBW Controller
|-
! colspan="7" | '''Shelly Plus Mini'''
|-
|Shelly Plus 1 Mini
|Schalter
|1
|
|
|1
|
|-
|Shelly Plus 1PM Mini
|Schalter
|1
|
|1
|1
|
|-
|Shelly PM Mini
|Leistungsmessung
|
|
| 1
|
|
|-
! colspan="7" |'''Shelly Pro'''
|-
|Shelly Pro 1
|Schalter
|1
|
|
|2
|
|-
|Shelly Pro 1PM
|Schalter
|1
|
|1
|2
|
|-
|Shelly Pro 2
| Schalter
|2
|
|
| 2
|
|-
|Shelly Pro 2PM
|Schalter
|2
|
|2
|2
|
|-
|Shelly Pro Dual
|Rollladenaktor
|4
|
|
|4
|2 Rolladenaktoren
|-
|Shelly Pro Dimmer 1PM
|Dimmer
|
|1
|1
|2
|
|-
|Shelly Pro Dimmer 2PM
|Dimmer
|
| 2
|2
|4
|
|-
|Shelly Pro 3
|Schalter
|3
|
|
|3
|
|-
|Shelly Pro 3EM
|Leistungsmessung
|
|
|3
|
|1 Schaltkanal mit Addon
|-
|Shelly Pro EM50
|Leistungsmessung

|
|
|
|
|
|-
|Shelly Pro 4PM
|Schalter
|4
|
|4
|4
|
|-
! colspan="7" |'''Shelly Gen3'''
|-
| Shelly 1 Gen3
|Schalter
|1
|
|
|1
|
|-
|Shelly 1PM Gen3
|Schalter
|1
|
|1
|1
|
|-
|Shelly i4 Gen3
|Digitale Eingänge
|
|
|
| 4
|
|-
|Shelly Dimmer 0/1-10V Gen3
|Dimmer
|
| 1
| 1
|2
|0-10V DC oder
1-10V DC Ausgang
|-
! colspan="7" |'''Shelly Gen3 Mini'''
|-
|Shelly 1 Mini Gen3
|Schalter
|1
|
|
|1
|
|-
|Shelly 1PM Mini Gen3
|Schalter
|1
|
|1
|1
|
|-
|Shelly PM Mini Gen3
|Leistungsmessung
|
|
|1
|
|
|-
! colspan="7" | '''Control Panels'''
|-
|Shelly Wall Display
| Control Panel
| 1
|
|
| 1
|
|}

==Einbindung in FHEM==
Vorgehensweise zur Einbindung eines Shelly-Gerätes in FHEM:
*Aktor nach Vorschrift anschließen
*mit einem WLAN-fähigen Gerät (Laptop, Smartphone, Tablet...; im Folgenden als '''Laptop''' bezeichnet) nach dem internen Access Point suchen, der durch das Shelly-Gerät erzeugt wird; typischerweise hat es eine SSID ähnlich wie
:<code>shelly1-..., shellyswitch-..., shelly4pro-..., </code>
*'''Laptop''' mit diesem Access Point verbinden; typischerweise bekommt das Gerät dabei die IP-Adresse 192.168.33.2 zugewiesen.
*im Browser des '''Laptops''' die IP-Adresse 192.168.33.1 aufrufen - das ist der Shelly selbst; in der damit angezeigten Weboberfläche kann das Shelly-Gerät konfiguriert werden
**Shelly ins häusliche WLAN anmelden (mit fester IP-Adresse <shelly-ip> natürlich...)
**Internen Access Point abschalten (kann auch nach dem nächsten Schritt oder noch später erfolgen)
**Testen: '''Laptop''' wieder mit dem häuslichen WLAN verbinden, und im Browser die Adresse <shelly-ip> aufrufen
*In FHEM definieren
:<code>define myShelly Shelly <shelly-ip></code>
*Das Modul setzt bei bekannten Geräten das Attribut <code>model</code> automatisch. Bei nicht unterstützten Geräten wird das Attribut auf den Wert <code>generic</code> gesetzt. In diesen Fällen kann das Attribut <code>model</code> auf der Detailseite des Devices manuell gesetzt werden:
:<code> attr myShelly model shellyrgbw|shellydimmer|shelly2.5|shelly2|shellyem|shelly3em|shelly4|shellyplug|shelly1|shellybulb|shelly1pm|shellyuni|generic</code>

Falls es sich um einen Shelly2 oder 2.5 handelt, muss ferner das Attribut <code>mode</code> auf "roller" oder "relay" gesetzt werden. Mit diesem Modul können alle Daten übertragen und (prinzipiell) alle Konfigurationsänderungen durchgeführt werden, außerdem ist es auf einfachste Weise zu installieren. Das Modul pollt im per Attribut <code>interval</code> einstellbaren Abstand zyklisch den Aktor auf Statusänderungen (Wert 0 => kein Polling). Damit der Aktor im Stande ist, irgendwelche Zustandsänderungen ''von sich aus'' an FHEM zu melden, müssen diese als REST-Befehle (also URL-Aufrufe) in der Konfigurationsoberfläche des Shelly-Aktors eingetragen werden. Siehe CommandRef.

Zum Betrieb ist ferner noch zu bemerken, dass das Modul zwar meldet, ob ein Firmware-Update nötig ist, ausgelöst werden muss dieses aber über die Web-Oberfläche des Shelly selber.

===Actions/Webhooks (nur Testversion)===
Ab Shelly Firmware 1.5.0 werden Actions unterstützt. Damit besteht die Möglichkeit, dass ein Shelly bei Eintreten bestimmter Ereignisse von sich aus Meldungen an andere Shellies und/oder übergeordnete Systeme wie FHEM absetzt. Dies ist nützlich, um Statusänderungen, die z.B. durch lokal betätigte Tasten entstehen, direkt an FHEM zu übermitteln.

Nachfolgende Beispiele zeigen den Code, der im Shelly unter URL einzutragen ist:

Ausgang (Relais) eines Shelly1 schaltet ein:
:<code>http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20out_on</code>
hierbei sind:
:<code><FHEM-IP></code> die IP-Adresse des Servers auf dem FHEM läuft
:<code><Port></code> die Port-Nummer
:<code><name></code> der Name des FHEM-Devices
:<code>%20</code> stellt ein Leerzeichen dar

Beispiel 2: Eingang eines Shelly2 wird betätigt:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20input_on%20<ch></syntaxhighlight>
:<code><ch></code> die Nummer des Schaltkanals (Nummer des Eingangs), z.B. <code>0</code> oder <code>1</code>

Beispiel 3: Eingang1 eines ShellyDimmers wird betätigt:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20short_push<nowiki/>%20<inp></syntaxhighlight>
:<code><nowiki><inp></nowiki></code> Nummer des Eingangs, 0 oder 1 (ShellyDimmer verfügen je Schaltkanal über zwei Eingänge)

Beispiel 4: Wirkleistung eines ShellyPro3EM:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?fwcsrf=csrf_368985985592099&cmd=set%20Y173%20Active_Power_$phase%20$active_power</syntaxhighlight>
:<code>fwcsrf=csrf_368985985592099</code> das CSRF-Token (FHEMWeb)
:<code>$phase</code> wird vom Shelly durch a, b oder c ersetzt
: <code>$active_power</code> wird vom Shelly durch die aktuelle Wirkleistung ersetzt

'''Endpoints'''

In vorstehenden Beispielen stellt der Teil <code>set%20<name>%20<cmd></code> den Endpoint dar, d.h. dies ist der Befehl, der vom Shelly-Device in FHEM verarbeitet werden muss.

=====Liste der Befehle der Set-Endpoints:=====
{| class="wikitable sortable mw-collapsible"
|+
!<cmd>
!Wert
!Reading
!Erläuterung
!Geräte
|-
|<code>out_on</code>
|
| rowspan="2" |<code>relay_<ch></code><code>state</code>
|Ausgang ein
| rowspan="2" |alle Shelly mit Relaisausgang
ShellyBulb
ShellyRGBW
|-
|<code>out_off</code>
|
|Ausgang aus
|-
|<code>button_on</code>
|
| rowspan="2" |<code>button_<ch></code>
|Eingang ein
| rowspan="2" |ShellyPlug
ShellyPlugS
|-
|<code>button_off</code>
|
|Eingang aus
|-
|<code>input_on</code>
|
| rowspan="2" |<code>input_<ch></code>
|Eingang ein
| rowspan="2" |alle Shelly mit HW-Eingang, aber nicht Shelly-I-Geräte
|-
|<code>input_off</code>
|
|Eingang aus
|-
|<code>input_on</code>
|
| rowspan="4" |<code>input_<inp></code>
|Eingang ein
| rowspan="4" |ShellyDimmer
|-
|<code>input_off</code>
|
|Eingang aus
|-
|<code>short_push</code>
|
|kurzer Tastendruck
|-
|<code>long_push</code>
|
|langer Tastendruck
|-
|<code>single_push</code>
|
| rowspan="6" |<code>input_<ch></code><code>input_<ch>_action</code>
|kurzer Tastendruck
| rowspan="4" |ShellyI3
ShellyI4
|-
|<code>long_push</code>
|
|langer Tastendruck
|-
|<code>double_push</code>
|
|zweifacher Tastendruck
|-
|<code>triple_push</code>
|
|dreifacher Tastendruck
|-
|<code>short_long_push</code>
|
|Tastersequenz lang-kurz
| rowspan="2" |ShellyI3
|-
|<code>long_short_push</code>
|
|Tastersequenz kurz-lang
|-
|<code>stopped</code>
|
| rowspan="5" |<code>state</code>
|Rollo angehalten
| rowspan="5" | Shelly2/2.5/Plus2/Pro2 mode=roller
<nowiki>*</nowiki>) nur für Shelly Plus2/Pro2
|-
|<code>opening</code>
|
|Rollo wird geöffnet
|-
|<code>closing</code>
|
|Rollo wird geschlossen
|-
|<code>is_open *)</code>
|
|Rollo offen (in oberer Endlage)
|-
|<code>is_closed *)</code>
|
|Rollo geschlossen (in unterer Endlage)
|-
|<code>temperature_over</code>
|
|<code>temperature_<ch>_range</code>
|Temperatur überschreitet eingestellten Grenzwert
| rowspan="5" |ShellyAddOn
|-
|<code>temperature_under</code>
|
|<code>temperature_<ch>_range</code>
|Temperatur unterschreitet eingestellten Grenzwert
|-
|<code>humidity_over</code>
|
|<code>humidity_<ch>_range</code>
|Luftfeuchtigkeit überschreitet eingestellten Grenzwert
|-
| <code>humidity_under</code>
|
|<code>humidity_<ch>_range</code>
|Luftfeuchtigkeit unterschreitet eingestellten Grenzwert
|-
|<code>tempC</code>
|<code>$temperature</code>
|<code>temperature</code>
|Temperatur in °C
|-
|<code>voltage_over</code>
|
| rowspan="2" |<code>voltage_range</code>
|Spannung überschreitet eingestellten Grenzwert
| rowspan="2" |ShellyUni
|-
|<code>voltage_under</code>
|
|Spannung unterschreitet eingestellten Grenzwert
|-
| Active_Power_$phase
|<code>$active_power</code>
|<code>Active_Power_<ph></code>
|Änderung Wirkleistung
| rowspan="3" |ShellyPro3EM
|-
|Voltage_$phase
|<code>$voltage</code>
|<code>Voltage_<ph></code>
| Änderung Spannung
|-
|Current_$phase
|<code>$current</code>
|<code>Current_<ph></code>
|Änderung Strom
|}
Bei Eintreffen eines Set-Endpoints wird im Shelly-Device das zugeordnete Reading entsprechend gesetzt. Damit kann das Shelly-Ereignis z.B. mit einem <code>notify</code> ausgewertet werden. Im Anschluss daran holt sich das Modul die aktuellen Daten vom Shelly und setzt das Intervall zurück.

Anmerkung zum ShellyPro3EM: Die Action wird erst bei einer gewissen Änderung des jeweiligen Wertes ausgelöst. Bei kleinen Schwankungen kommen also keine Webhooks in FHEM an.

===== Get-Endpoint =====
Eine besondere Form stellt der Get-Endpoint dar, mit dem das Shelly-Device in FHEM aufgefordert wird, den Status des Shelly zu holen. Beispiel:
:<code>http://<FHEM-IP>:<Port>/fhem?cmd=get%20<name>%20status</code>

====Attribut webhook (derzeit nur Gen2)====
Durch Setzten des Attributes <code>webhook</code> werden auf dem Shelly die verfügbaren Webhooks automatisiert angelegt (auf der Shelly Oberfläche unter Actions zu sehen). Als Attribut-Wert muss das empfangende FHEMWeb-Device ausgewählt werden. Wird das FHEMWeb-Device mit einem csrf-Token abgesichert, wird der Token in den Webhook eingebunden. Bei Änderungen des Tokens (z.B. bei Neustart von FHEM) werden die entsprechenden Webhooks mit angepasst.

Nach dem Setzen des Attributes müssen die Webhooks mit <code>set myShellyDevice actions create all</code> angelegt werden.

Die vom Modul angelegten Webhooks erhalten im Shelly einen Namen, beginnend mit einem Unterstrich (<code>_</code>). Wird das Attribut geändert oder gelöscht, dann werden auch zugehörige Actions geändert bzw. gelöscht. Durch Entfernen des Unterstrichs im Namen der Action kann dieser Mechanismus unterbunden werden.

Das Reading <code>webhook_cnt</code> zeigt die Anzahl aller auf dem Shelly hinterlegten Webhooks und <code>webhooks_ver</code> den Versionszähler des Shelly.

Eine Übersicht aller Actions/Webhooks eines Shelly bekommt man für Gen2-Geräte mit:
:<code>http://<ip-des-Shelly>/rpc/Webhook.List</code>

===MQTT===
MQTT (Message Queue Telemetry Transport) ist ein nachrichtenbasiertes Protokoll, bei dem Geräte (Devices) nicht direkt miteinander, sondern mit einem zentralen MQTT-Server (in alter Nomenklatur ''Broker'' genannt) kommunizieren. Eine kurze Einführung in MQTT findet man auf der Seite [[MQTT Einführung]]. Mit entsprechend gesetzten Attributen lassen sich die Shelly-Aktoren auch steuern ([[MQTT2-Module - Praxisbeispiele#Shelly|Praxisbeispiele zu den MQTT2-Modulen]]), für Anfänger ist das allerdings nicht unbedingt zu empfehlen.

==Links==
*{{Link2Forum|Topic=118446|LinkText=Support Thread}} zu diesem Modul
*{{Link2Forum|Topic=137222|LinkText=Entwicklungs Thread}} zur Weiterentwicklung des Moduls, ab Februar 2024
*[http://www.shelly.com Website des Herstellers der Geräte]
*[https://community.shelly.cloud Forum des Herstellers (englischsprachig]

[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:MQTT]]
[[Kategorie:Bluetooth]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Shelly]]

Shelly

2026-01-14T18:54:35Z

Ph1959de: Erste Version der Seite

{{Baustelle}}{{Todo|Information zum gesamten Shelly "System" wird gerade umstrukturiert, konsolidiert, erweitert}}
[[Shelly]] bezeichnet die IoT-Geräte der bulgarischen [https://de.wikipedia.org/wiki/Shelly_Group Shelly Group]. Diese Geräte werden in unterschiedlicher Weise von FHEM unterstützt.

== Überblick ==
Die generellen Eigenschaften von Shelly Geräten werden in den folgenden Abschnitten kurz erläutert, eine umfangreiche tabellarische Liste ist im Abschnitt [[Shelly#Geräteübersicht|Geräteübersicht]] zusammengestellt. Diese Liste erhebt keinen Anspruch auf Vollständigkeit.

=== Gerätetypen ===
Arten von verfügbaren Shelly Geräten sind derzeit
* (Unterputz-)Relais (Aktoren)
* Energiezähler
* Sensoren für Temperatur, Bewegung, Feuchtigkeit, Türen/Fenster
* Smarte Steckdosen / Zwischenstecker
* Thermostate und Heizkörperventile

=== Kommunikation ===
Die Kommunikation mit Shelly Geräten erfolgt über WLAN (Access Point und/oder Einbindung in Netzwerk) und/oder Bluetooth (BLE), wobei
unterschiedliche Kommunikationsprotokolle ([[MQTT]], Modbus, RPC über UDP) zum Einsatz kommen können. Die Geräte können in der Regel über eine Web-Oberfläche angesprochen werden oder auch über eine proprietäre App, wobei die Geräte damit in die Hersteller-Cloud eingebunden werden.

Mit der Einführung der Gen4 (Geräte der 4. Generation) kann auch zwischen einer Firmware mit [[Matter]]- oder [[ZigBee]]-Unterstützung gewählt werden.

=== Gerätegenerationen ===
Mittlerweile (2024) gibt es die vierte Gerätegeneration, einen detaillierten Überblick über Funktionalität und Unterschiede gibt die Supportseite [https://support.shelly.cloud/de/support/solutions/articles/103000316073-vergleich-von-shelly-gen-1-gen-2-gen-3-gen4-ger%C3%A4ten Vergleich von Shelly gen1...gen4 Geräten].

== Einbindung von Shelly Geräten in FHEM ==
=== Spezifisches FHEM-Modul ===
Viele Shelly-Geräte werden durch das Modul [[Shelly (Modul)|36_Shelly.pm]] unterstützt, modulspezifische Details dazu finden sich auf der genannten Modul-Seite.

=== MQTT ===
Die Einbindung von Shelly Geräten über MQTT ist auf der Seite [[MQTT2-Module_-_Praxisbeispiele#Shelly|MQTT Praxisbeispiele: Shelly]] beschrieben.

=== ... ===

== Geräteübersicht ==
Liste der aktuell durch das [[Shelly (Modul)|Shelly Modul]] unterstützten Geräte
{{Todo|falls das wirklich die ''unterstützten'' Geräte sind, sollte die Liste auf die 36_Shelly.pm Seite "wandern"}}
{{Todo|''Shelly-Monitor'' muss erläutert / verlinkt werden}}
(hier nicht aufgeführte Geräte der ersten Generation können zusammen mit dem [[ShellyMonitor]] genutzt werden):
{| class="wikitable sortable"
! data-sort-type="text" style="width:150px" |Modell
! data-sort-type="text" style="width:75px" |Typ
! data-sort-type="number" style="width:20px;text-align:center;" |Schalt- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Dimm- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Mess- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Digital Eingänge
! |Bemerkungen
|-
! colspan="7" |'''Gen 1'''
|-
|Shelly 1
|Schalter
|1
|
|
|1
|
|
|-
|Shelly 1PM
|Schalter
|1
|
|1
|1
|
|
|-
|Shelly 1L
|Schalter
| 1
|
|1
| 1
|
|
|-
| rowspan="2" |Shelly 2
| Schalter
|2
|
|1
|2
|
|
|-
|Rollladenaktor
|1
|
|1
|2
|
|-
| rowspan="2" |Shelly 2.5
|Schalter
| 2
|
|2
|2
|
|-
|Rollladenaktor
|1
|
|1
|2
|
|-
|Shelly 4Pro
|Schalter
|4
|
|4
|4
|
|-
|Shelly i3
| Digitale Eingänge
|
|
|
|3
|
|-
|Shelly EM
|Leistungsmessung
|1
|
|2
|
|
|-
|'''[[Shelly 3EM]]'''
|Leistungsmessung
|1
|
|3
|
|
|-
|'''[[Shelly Uni]]'''
|Universal
|2
|
|
|*)
|1-Wire, 2 potentialfreie Relaisausgänge
Analogeingänge
|-
|Shelly Plug
Shelly Plug S
|Schaltsteckdose
|1
|
|1
|
|1 Taster
|-
| rowspan="2" |Shelly RGBW2
|Dimmer
|
|4
|4
|1
|4-fach Aktor
|-
|Dimmer
|
|1
| 1
|1
|RGBW Controller
|-
|Shelly Dimmer2
|Dimmer
|
| 1
|1
|2
|
|-
|Shelly Duo
|Leuchte
|
|1
|
|
|E27 oder GU10 Fassung
|-
|Shelly Vintage
|Leuchte
|
|1
|
|
|
|-
|Shelly Bulb
|Leuchte
|
|1
|
|
|Modi: weiß oder farbe
|-
! colspan="7" |'''Shelly Plus'''
|-
|Shelly Plus 1

|Schalter
|1
|
|
|1
|
|-
|'''[[Shelly Plus 1PM]]'''
|Schalter
|1
|
|1
|1
|
|-
| rowspan="2" |'''[[Shelly Plus 2PM]]'''
| Schalter
|2
|
|2
|2
|-
|Rollladenaktor
|1
|
| 1
|2
|-
|Shelly Plus i4
|Digitale Eingänge
|
|
|
| 4
|AC und DC - Variante
|-
| Shelly Plus Plug S
Shelly Plus Plug IT
Shelly Plus Plug UK
Shelly Plus Plug US
|Schaltsteckdose

|1
|
|1
|
|1 Taster;
Varianten V1, V2
|-
|Shelly Plus Uni
|Universal
| 2
|
|
|*)
|1-Wire, 2 potentialfreie Relaisausgänge
Analogeingänge; Neu in 2024
|-
|Shelly Plus 0-10V Dimmer
|Dimmer
|
|1
|1
|2
|0-10 V DC Ausgang
|-
| rowspan="2" |Shelly Plus RGBW
|Dimmer
|
|4
|4
|4
|4-fach Aktor
|-
|Dimmer
|
|1
|1
|1
|RGBW Controller
|-
! colspan="7" | '''Shelly Plus Mini'''
|-
|Shelly Plus 1 Mini
|Schalter
|1
|
|
|1
|
|-
|Shelly Plus 1PM Mini
|Schalter
|1
|
|1
|1
|
|-
|Shelly PM Mini
|Leistungsmessung
|
|
| 1
|
|
|-
! colspan="7" |'''Shelly Pro'''
|-
|Shelly Pro 1
|Schalter
|1
|
|
|2
|
|-
|Shelly Pro 1PM
|Schalter
|1
|
|1
|2
|
|-
|Shelly Pro 2
| Schalter
|2
|
|
| 2
|
|-
|Shelly Pro 2PM
|Schalter
|2
|
|2
|2
|
|-
|Shelly Pro Dual
|Rollladenaktor
|4
|
|
|4
|2 Rolladenaktoren
|-
|Shelly Pro Dimmer 1PM
|Dimmer
|
|1
|1
|2
|
|-
|Shelly Pro Dimmer 2PM
|Dimmer
|
| 2
|2
|4
|
|-
|Shelly Pro 3
|Schalter
|3
|
|
|3
|
|-
|Shelly Pro 3EM
|Leistungsmessung
|
|
|3
|
|1 Schaltkanal mit Addon
|-
|Shelly Pro EM50
|Leistungsmessung

|
|
|
|
|
|-
|Shelly Pro 4PM
|Schalter
|4
|
|4
|4
|
|-
! colspan="7" |'''Shelly Gen3'''
|-
| Shelly 1 Gen3
|Schalter
|1
|
|
|1
|
|-
|Shelly 1PM Gen3
|Schalter
|1
|
|1
|1
|
|-
|Shelly i4 Gen3
|Digitale Eingänge
|
|
|
| 4
|
|-
|Shelly Dimmer 0/1-10V Gen3
|Dimmer
|
| 1
| 1
|2
|0-10V DC oder
1-10V DC Ausgang
|-
! colspan="7" |'''Shelly Gen3 Mini'''
|-
|Shelly 1 Mini Gen3
|Schalter
|1
|
|
|1
|
|-
|Shelly 1PM Mini Gen3
|Schalter
|1
|
|1
|1
|
|-
|Shelly PM Mini Gen3
|Leistungsmessung
|
|
|1
|
|
|-
! colspan="7" | '''Control Panels'''
|-
|Shelly Wall Display
| Control Panel
| 1
|
|
| 1
|
|}

== Links ==
* [https://support.shelly.cloud/de/support/solutions/articles/103000316073-vergleich-von-shelly-gen-1-gen-2-gen-3-gen4-ger%C3%A4ten Vergleich von Shelly gen1...gen4 Geräten]
* [https://shelly-api-docs.shelly.cloud/gen2/changelog/ Shelly Firmware Change Log]

[[Kategorie:Shelly]]

ShellyMonitor

2026-01-14T18:54:27Z

Ph1959de: Erste Version der Seite

{{Infobox Modul
|ModPurpose=... aktualisiert die Readings von [[Shelly]]-Geräten, die ihre Daten im CoIoT-"Standard" im Netzwerk versenden
|ModType=d
|ModCmdRef=ShellyMonitor
|ModForumArea=Sonstige Systeme
|ModFTopic=117805
|ModTechName=36_ShellyMonitor.pm
|ModOwner=gvzdus ({{Link2FU|23999|Forum}})
}}

{{Todo|Seite ist bisher nur "Stub", muss noch in allen Belangen ergänzt werden!}}

Unstrukturierte Sammlung von Informationen:
* Der Monitor geht nur mit Gen1 (ohne Plus) und im Shelly muss CoIot aktiviert sein.
* Damit wertet der Monitor die Meldungen aus, die der Shelly per UDP ins LAN schickt.

== Links ==
* [[Shelly]] - allgemeine Informationen zum Shelly "System"
* [[Shelly (Modul)]] - das Modul 36_Shelly.pm
* {{Link2Forum|Topic=117805|LinkText=Modul-Thread}} im Forum

[[Kategorie:Shelly]]

Shelly (Modul)

2026-01-14T18:54:14Z

Ph1959de: Erste Version der Seite

{{Infobox Modul
|ModPurpose=Das Modul stellt ein Interface zur Bedienung von Shelly Devices zur Verfügung
|ModType=d
|ModCmdRef=Shelly
|ModForumArea=Sonstige Systeme
|ModFTopic=118446
|ModTechName=36_Shelly.pm
|ModOwner=Starkstrombastler ({{Link2FU|3884|Forum}}/[[Benutzer Diskussion:Starkstrombastler|Wiki]])
}}

== Definition - Anlegen eines Gerätes ==
* Gerät nach Vorschrift anschließen
* mit einem WLAN-fähigen Gerät (Laptop, Smartphone, Tablet...; im Folgenden als '''Laptop''' bezeichnet) nach dem internen Access Point suchen, der durch das Shelly-Gerät erzeugt wird; typischerweise hat es eine SSID ähnlich wie
:<code>shelly1-..., shellyswitch-..., shelly4pro-..., </code>
* '''Laptop''' mit diesem Access Point verbinden; typischerweise bekommt das Gerät dabei die IP-Adresse 192.168.33.2 zugewiesen.
* im Browser des '''Laptops''' die IP-Adresse 192.168.33.1 aufrufen - das ist der Shelly selbst; in der damit angezeigten Weboberfläche kann das Shelly-Gerät konfiguriert werden
** Shelly ins häusliche WLAN anmelden (mit fester IP-Adresse <shelly-ip> natürlich...)
** Internen Access Point abschalten (kann auch nach dem nächsten Schritt oder noch später erfolgen)
** Testen: '''Laptop''' wieder mit dem häuslichen WLAN verbinden, und im Browser die Adresse <shelly-ip> aufrufen
* In FHEM definieren
:<code>define myShelly Shelly <shelly-ip></code>
* Das Modul setzt bei bekannten Geräten das Attribut <code>model</code> automatisch. Bei nicht unterstützten Geräten wird das Attribut auf den Wert <code>generic</code> gesetzt. In diesen Fällen kann das Attribut <code>model</code> auf der Detailseite des Devices manuell gesetzt werden:
::<code> attr myShelly model <model> </code>
: unterstützte Modelle (ab Datum/Modulversion):
:* shellyrgbw
:* shellydimmer
:* shelly2.5
:* shelly2
:* shellyem
:* shelly3em
:* shelly4
:* shellyplug
:* shelly1
:* shellybulb
:* shelly1pm
:* shellyuni
:* generic

Falls es sich um einen Shelly2 oder Shelly2.5 handelt, muss ferner das Attribut <code>mode</code> auf "roller" oder "relay" gesetzt werden.

Mit diesem Modul können alle Daten übertragen und (prinzipiell) alle Konfigurationsänderungen durchgeführt werden, außerdem ist es auf einfachste Weise zu installieren. Das Modul pollt im per Attribut <code>interval</code> einstellbaren Abstand zyklisch den Aktor auf Statusänderungen (Wert 0 => kein Polling). Damit der Aktor im Stande ist, irgendwelche Zustandsänderungen ''von sich aus'' an FHEM zu melden, müssen diese als REST-Befehle (also URL-Aufrufe) in der Konfigurationsoberfläche des Shelly-Aktors eingetragen werden. Siehe CommandRef.

Zum Betrieb ist ferner noch zu bemerken, dass das Modul zwar meldet, ob ein Firmware-Update nötig ist, ausgelöst werden muss dieses aber über die Web-Oberfläche des Shelly selber.

== Aktionen / Webhooks ==
Ab Shelly Firmware 1.5.0 werden Actions unterstützt. Damit besteht die Möglichkeit, dass ein Shelly bei Eintreten bestimmter Ereignisse von sich aus Meldungen an andere Shellies und/oder übergeordnete Systeme wie FHEM absetzt. Dies ist nützlich, um Statusänderungen, die z.B. durch lokal betätigte Tasten entstehen, direkt an FHEM zu übermitteln.

Nachfolgende Beispiele zeigen den Code, der im Shelly unter URL einzutragen ist:

Ausgang (Relais) eines Shelly1 schaltet ein:
:<code>http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20out_on</code>
hierbei sind:
:<code><FHEM-IP></code> die IP-Adresse des Servers auf dem FHEM läuft
:<code><Port></code> die Port-Nummer
:<code><name></code> der Name des FHEM-Devices
:<code>%20</code> stellt ein Leerzeichen dar

Beispiel 2: Eingang eines Shelly2 wird betätigt:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20input_on%20<ch></syntaxhighlight>
:<code><ch></code> die Nummer des Schaltkanals (Nummer des Eingangs), z.B. <code>0</code> oder <code>1</code>

Beispiel 3: Eingang1 eines ShellyDimmers wird betätigt:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20short_push<nowiki/>%20<inp></syntaxhighlight>
:<code><nowiki><inp></nowiki></code> Nummer des Eingangs, 0 oder 1 (ShellyDimmer verfügen je Schaltkanal über zwei Eingänge)

Beispiel 4: Wirkleistung eines ShellyPro3EM:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?fwcsrf=csrf_368985985592099&cmd=set%20Y173%20Active_Power_$phase%20$active_power</syntaxhighlight>
:<code>fwcsrf=csrf_368985985592099</code> das CSRF-Token (FHEMWeb)
:<code>$phase</code> wird vom Shelly durch a, b oder c ersetzt
: <code>$active_power</code> wird vom Shelly durch die aktuelle Wirkleistung ersetzt

'''Endpoints'''

In vorstehenden Beispielen stellt der Teil <code>set%20<name>%20<cmd></code> den Endpoint dar, d.h. dies ist der Befehl, der vom Shelly-Device in FHEM verarbeitet werden muss.
== Bekannte Probleme ==

== Links ==
* {{Link2Forum|Topic=137222|LinkText=Entwicklungs-Thread}} im Forum
* {{Link2Forum|Topic=118446|LinkText=Support-Thread}} im Forum

[[Kategorie:Shelly]]

Strombörse

2026-01-13T10:51:50Z

Ph1959de: Tippfehler korrigiert

{{Todo|Diese Wiki Seite ist noch in Bearbeitung! <br>Siehe auch {{Link2Forum|Topic=142165|LinkText=HTTPMOD: Aktueller Strompreis EEX Strombörse Leipzig abfragen}}}}
[[Bild:Screenshot 2024-01-23 122115.png|mini|400px|rechts|EVU_Tibber_connect]]
Diese Seite beinhaltet Informationen für die Anbindung von Energieversorgungsunternehmen (EVU), die ihre Preise nach der Strombörse z.B. im Stundenrhythmus anbieten.

Als Beispiel wären da:
# {{Link2Forum|Topic=130407|LinkText=Tibber - im Forum}}
# {{Link2Forum|Topic=135906|LinkText=aWATTar - im Forum}}
# {{Link2Forum|Topic=142165|LinkText=EPEX_Spot}}

== 1. Tibber mit Tibber Pulse ==
Eine momentan verbreitete Methode zur Anbindung an Tibber ist ein Lesekopf auf dem EVU Zähler, der als "Tibber Pulse" vertrieben wird. Damit wird ein bestehender digitaler EVU Zähler ausgelesen und die Werte per LAN zu Tibber gesendet. Über eine API bei Tibber können dann die Verbrauchswerte und Kosten sowie ein Live Stream (WebSocket) abgefragt werden.

Die im Folgenden beschriebenen Beispieldevices bieten die oben genannte Abfrage der API mit WebSocket und [[HTTPMOD]]. Das EVU_Tibber Device dient der Darstellung und Steuerung.

=== Voraussetzungen ===
* FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)
* KeyValue() (wird hier beschrieben)
* homeID und personal Token/Access Token/Connect Token
* Tibber Pulse Lesekopf auf dem digitalen EVU Zähler
* Man sollte bereits Tibber Kunde sein, da ansonsten nur Demo Daten abgerufen werden können

=== Token ===
Der Token wird leider unterschiedlich bezeichnet, aber egal ob er personal Token, Access Token oder Connect Token heisst, es bezieht sich auf den gleichen.

Erhältlich ist dieser aktuell (Oktober 24) unter https://developer.tibber.com/

Dort bitte mit deinen Zugangsdaten einloggen ("Sign In", oben rechts) und man bekommt den Access Token direkt angezeigt.

=== homeID ===
Um eine HomeID zu erhalten, muss zuerst der Pulse mit dem Internet bzw. tibber verbunden werden. Wenn die App glücklich ist, gehts hier weiter:

Man loggt sich wieder ein unter https://developer.tibber.com/. Dort geht man dann zum API Explorer.

Leider ist keine der Demo-Abfragen geeignet, die homeID zu erfahren. Dafür gibt man ins linke fenster folgenden Code ein:
<syntaxhighlight lang="Perl">
{
viewer {
homes {
id
address {
address1
postalCode
}
}
}
}
</syntaxhighlight>
Dann startet man mit dem Play-Pfeil und bekommt auf der rechten Seite etwa folgende Ausgabe:

<syntaxhighlight lang="Perl">
{
"data": {
"viewer": {
"homes": [
{
"id": "1234abcd-12ab-34cd-56ef-1234abcd12ab
"address": {
"address1": "Musterstr.1",
"postalCode": "12345"
}
}
]
}
}
}
</syntaxhighlight>
Diese ID ist die homeID und kann unten verwendet werden.

=== EVU_Tibber_connect ===
Das EVU_Tibber_connect fragt mit HTTPMOD Statistiken auf der Tibber API Webseite ab. Zusätzlich wurde in den userReadings die WebSocket Verbindung für die Live Daten integriert.
* Die WebSocket Verbindung wurde leicht angepasst '''[[Websocket|von hier]]''' übernommen
* Im Forum wurde dies '''{{Link2Forum|Topic=130407|Message=1298863|LinkText=ab hier}}''' bearbeitet

==== Verwendete Module ====
* HTTPMOD
* DbLog
* DbRep
* DOIF
* KeyValue()

==== Ablage der homeID und des Tokens ====
Eine Verbindung zur Tibber API mit den '''tatsächlichen Preisen''' bekommen nur Kunden, ansonsten kann man eine Demo mit Kosten in Schwedischen Kronen testweise abfragen.

In diesem Beispiel Device kann man seine homeID und sein Token entweder als Attribut ablegen oder man macht einen Eintrag im KeyStore von FHEM, wodurch man nicht so leicht versehentlich seine Daten im Forum postet.

Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im Datensystem oder im Konfigurationsfile zu finden sind.
Die Funktion befindet sich in der 99_myUtils.pm .

===== Beispiel KeyValue() =====
'''Achtung, der KeyValue ist kein Schutz für Passwort oder Keys!'''
Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im FHEM Device oder im Konfigurationsfile zu finden sind.
Die Funktion befindet sich in der 99_myUtils .

====== KeyValue() Funktion in der ~/FHEM/99_myUtils.pm ======
<syntaxhighlight lang="Perl">
sub KeyValue {
my ($step, $index, $value) = @_;
my $key = getUniqueId().$index;
my $e_value = "";
my $error;

if (eval "use Digest::MD5;1") {
$key = Digest::MD5::md5_hex(unpack "H*", $key);
$key .= Digest::MD5::md5_hex($key);
}

if ($step eq "read") {
($error, $value) = getKeyValue($index);

if ( defined($error) ) {
Log3 $index,3, "$index, can't read key from FhemUtils/uniqueID: $error";
return undef;
}

if ( defined($value) ) {
my $dec_value = '';

for my $char (map { pack('C', hex($_)) } ($value =~ /(..)/g)) {
my $decode = chop($key);
$dec_value .= chr(ord($char)^ord($decode));
$key = $decode.$key;
}
return $dec_value;
}
else {
Log3 $index,3,"$index, no key found in FhemUtils/uniqueID";
return undef;
}
}

if ($step eq "store") {
for my $char (split //, $value) {
my $encode = chop($key);
$e_value .= sprintf("%.2x",ord($char)^ord($encode));
$key = $encode.$key;
}
$error = setKeyValue($index, $e_value);
return "error while saving key : $error" if(defined($error));
return "Key successfully saved in FhemUtils/uniqueID Key $index";
}

};
</syntaxhighlight>

====== Ablegen der homeID und des Token ======
In der FHEM Kommandozeile legt man seinen Daten wie folgt im KeyValue ab. Hier wären als Beispiel der Demo Zugang von Tibber.
Das "read" ist dann auch direkt der erste Test, bevor man weiter macht.
<syntaxhighlight lang="Perl">
{KeyValue("store","EVU_Tibber_connect_token","5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE")}
{KeyValue("store","EVU_Tibber_connect_homeID","96a14971-525a-4420-aae9-e5aedaa129ff")}

{KeyValue("read","EVU_Tibber_connect_token")}
{KeyValue("read","EVU_Tibber_connect_homeID")}
</syntaxhighlight>

===== Beispiel Attribut für homeID und Token =====
Oder, sobald das EVU_Tibber_connect Device erstellt wurde, als Attribut.
<syntaxhighlight lang="Perl">
attr EVU_Tibber_connect ws_homeId 96a14971-525a-4420-aae9-e5aedaa129ff
attr EVU_Tibber_connect ws_myId 96a14971-525a-4420-aae9-e5aedaa129ff <<<< Dies kann wohl eine frei gewählte ID sein, was hier der Einfachheithalber gleich der homeId gesetzt wurde.
attr EVU_Tibber_connect ws_token 5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE
</syntaxhighlight>

==== EVU_Tibber_connect RAW Device====
Das Device EVU_Tibber_connect dient der Verbindung zur Tibber API. Zusätzlich wird für die Abfrage der Live Daten innerhalb der userReadings eine WebSocket Verbindung zu Tibber aufgebaut. Tibber stellt jeweils gegen 14:00 Uhr die Daten für den nächsten Tag bereit, wodurch von 00:00 - 14:00 Uhr diese Information im EVU_Tibber_connect noch nicht angezeigt werden kann.
Das Device arbeitet über die userReadings mit einem MySQL DbRep Device, was somit eine MySQL DbLog Verwendung im FHEM voraussetzt. '''Die Verwendung von FileLog ist nicht unterstützt!'''
<syntaxhighlight lang="Perl">
defmod EVU_Tibber_connect HTTPMOD https://api.tibber.com/v1-beta/gql 0
attr EVU_Tibber_connect userattr ws_homeId ws_minInterval ws_myId ws_token ws_websocketURL
attr EVU_Tibber_connect DbLogExclude .*
attr EVU_Tibber_connect DbLogInclude total_cost_.*,fc0_trigger.*
attr EVU_Tibber_connect comment Version 2024.01.22 14:00 \
https://developer.tibber.com/explorer\
\
In der FHEM Kommandozeile könnt Ihr das token und die homeID im KeyStore ablegen.\
Bitte lest dazu das Thema KeyStore im Wiki und legt die Funktion in Eure 99_myUtils.\
\
{KeyValue("store","EVU_Tibber_connect_token","5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE")}\
{KeyValue("store","EVU_Tibber_connect_homeID","96a14971-525a-4420-aae9-e5aedaa129ff")}\
\
Hierduch kann man einen wirtschaftlicheren trigger_price berechnen lassen:\
setreading EVU_Tibber compensation_grid <Eure Einspeisevergütung>\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
(fc_avg - fc_min) /2 + fc_min\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
# compensation_grid kann auch auf einen für Euch passenden Wert gesetzt werden\
(fc_avg - compensation_grid) *0.85
attr EVU_Tibber_connect disable 0
attr EVU_Tibber_connect enableControlSet 1
attr EVU_Tibber_connect get01-1Name current_currency
attr EVU_Tibber_connect get01-2Name current_level
attr EVU_Tibber_connect get01-3Name current_date
attr EVU_Tibber_connect get01-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get01-4Name current_price
attr EVU_Tibber_connect get01-4OExpr $val *100
attr EVU_Tibber_connect get01Data { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total startsAt currency level}}}}}}" }
attr EVU_Tibber_connect get01Header01 Content-Type: application/json
attr EVU_Tibber_connect get01Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get01JSON data_viewer_home_currentSubscription_priceInfo_current
attr EVU_Tibber_connect get01Name 01_priceInfo
attr EVU_Tibber_connect get01URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get02-10Name fc0_03_total
attr EVU_Tibber_connect get02-11Name fc0_04_startsAt
attr EVU_Tibber_connect get02-11OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-12Name fc0_04_total
attr EVU_Tibber_connect get02-13Name fc0_05_startsAt
attr EVU_Tibber_connect get02-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-14Name fc0_05_total
attr EVU_Tibber_connect get02-15Name fc0_06_startsAt
attr EVU_Tibber_connect get02-15OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-16Name fc0_06_total
attr EVU_Tibber_connect get02-17Name fc0_07_startsAt
attr EVU_Tibber_connect get02-17OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-18Name fc0_07_total
attr EVU_Tibber_connect get02-19Name fc0_08_startsAt
attr EVU_Tibber_connect get02-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-1Name current_date
attr EVU_Tibber_connect get02-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-20Name fc0_08_total
attr EVU_Tibber_connect get02-21Name fc0_09_startsAt
attr EVU_Tibber_connect get02-21OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-22Name fc0_09_total
attr EVU_Tibber_connect get02-23Name fc0_10_startsAt
attr EVU_Tibber_connect get02-23OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-24Name fc0_10_total
attr EVU_Tibber_connect get02-25Name fc0_11_startsAt
attr EVU_Tibber_connect get02-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-26Name fc0_11_total
attr EVU_Tibber_connect get02-27Name fc0_12_startsAt
attr EVU_Tibber_connect get02-27OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-28Name fc0_12_total
attr EVU_Tibber_connect get02-29Name fc0_13_startsAt
attr EVU_Tibber_connect get02-29OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-2Name current_price
attr EVU_Tibber_connect get02-2OExpr $val *100
attr EVU_Tibber_connect get02-30Name fc0_13_total
attr EVU_Tibber_connect get02-31Name fc0_14_startsAt
attr EVU_Tibber_connect get02-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-32Name fc0_14_total
attr EVU_Tibber_connect get02-33Name fc0_15_startsAt
attr EVU_Tibber_connect get02-33OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-34Name fc0_15_total
attr EVU_Tibber_connect get02-35Name fc0_16_startsAt
attr EVU_Tibber_connect get02-35OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-36Name fc0_16_total
attr EVU_Tibber_connect get02-37Name fc0_17_startsAt
attr EVU_Tibber_connect get02-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-38Name fc0_17_total
attr EVU_Tibber_connect get02-39Name fc0_18_startsAt
attr EVU_Tibber_connect get02-39OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-3Name fc0_00_startsAt
attr EVU_Tibber_connect get02-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-40Name fc0_18_total
attr EVU_Tibber_connect get02-41Name fc0_19_startsAt
attr EVU_Tibber_connect get02-41OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-42Name fc0_19_total
attr EVU_Tibber_connect get02-43Name fc0_20_startsAt
attr EVU_Tibber_connect get02-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-44Name fc0_20_total
attr EVU_Tibber_connect get02-45Name fc0_21_startsAt
attr EVU_Tibber_connect get02-45OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-46Name fc0_21_total
attr EVU_Tibber_connect get02-47Name fc0_22_startsAt
attr EVU_Tibber_connect get02-47OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-48Name fc0_22_total
attr EVU_Tibber_connect get02-49Name fc0_23_startsAt
attr EVU_Tibber_connect get02-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-4Name fc0_00_total
attr EVU_Tibber_connect get02-50Name fc0_23_total
attr EVU_Tibber_connect get02-51Name fc1_00_startsAt
attr EVU_Tibber_connect get02-51OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-52Name fc1_00_total
attr EVU_Tibber_connect get02-53Name fc1_01_startsAt
attr EVU_Tibber_connect get02-53OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-54Name fc1_01_total
attr EVU_Tibber_connect get02-55Name fc1_02_startsAt
attr EVU_Tibber_connect get02-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-56Name fc1_02_total
attr EVU_Tibber_connect get02-57Name fc1_03_startsAt
attr EVU_Tibber_connect get02-57OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-58Name fc1_03_total
attr EVU_Tibber_connect get02-59Name fc1_04_startsAt
attr EVU_Tibber_connect get02-59OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-5Name fc0_01_startsAt
attr EVU_Tibber_connect get02-5OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-60Name fc1_04_total
attr EVU_Tibber_connect get02-61Name fc1_05_startsAt
attr EVU_Tibber_connect get02-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-62Name fc1_05_total
attr EVU_Tibber_connect get02-63Name fc1_06_startsAt
attr EVU_Tibber_connect get02-63OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-64Name fc1_06_total
attr EVU_Tibber_connect get02-65Name fc1_07_startsAt
attr EVU_Tibber_connect get02-65OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-66Name fc1_07_total
attr EVU_Tibber_connect get02-67Name fc1_08_startsAt
attr EVU_Tibber_connect get02-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-68Name fc1_08_total
attr EVU_Tibber_connect get02-69Name fc1_09_startsAt
attr EVU_Tibber_connect get02-69OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-6Name fc0_01_total
attr EVU_Tibber_connect get02-70Name fc1_09_total
attr EVU_Tibber_connect get02-71Name fc1_10_startsAt
attr EVU_Tibber_connect get02-71OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-72Name fc1_10_total
attr EVU_Tibber_connect get02-73Name fc1_11_startsAt
attr EVU_Tibber_connect get02-73OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-74Name fc1_11_total
attr EVU_Tibber_connect get02-75Name fc1_12_startsAt
attr EVU_Tibber_connect get02-75OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-76Name fc1_12_total
attr EVU_Tibber_connect get02-77Name fc1_13_startsAt
attr EVU_Tibber_connect get02-77OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-78Name fc1_13_total
attr EVU_Tibber_connect get02-79Name fc1_14_startsAt
attr EVU_Tibber_connect get02-79OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-7Name fc0_02_startsAt
attr EVU_Tibber_connect get02-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-80Name fc1_14_total
attr EVU_Tibber_connect get02-81Name fc1_15_startsAt
attr EVU_Tibber_connect get02-81OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-82Name fc1_15_total
attr EVU_Tibber_connect get02-83Name fc1_16_startsAt
attr EVU_Tibber_connect get02-83OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-84Name fc1_16_total
attr EVU_Tibber_connect get02-85Name fc1_17_startsAt
attr EVU_Tibber_connect get02-85OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-86Name fc1_17_total
attr EVU_Tibber_connect get02-87Name fc1_18_startsAt
attr EVU_Tibber_connect get02-87OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-88Name fc1_18_total
attr EVU_Tibber_connect get02-89Name fc1_19_startsAt
attr EVU_Tibber_connect get02-89OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-8Name fc0_02_total
attr EVU_Tibber_connect get02-90Name fc1_19_total
attr EVU_Tibber_connect get02-91Name fc1_20_startsAt
attr EVU_Tibber_connect get02-91OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-92Name fc1_20_total
attr EVU_Tibber_connect get02-93Name fc1_21_startsAt
attr EVU_Tibber_connect get02-93OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-94Name fc1_21_total
attr EVU_Tibber_connect get02-95Name fc1_22_startsAt
attr EVU_Tibber_connect get02-95OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-96Name fc1_22_total
attr EVU_Tibber_connect get02-97Name fc1_23_startsAt
attr EVU_Tibber_connect get02-97OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-98Name fc1_23_total
attr EVU_Tibber_connect get02-9Name fc0_03_startsAt
attr EVU_Tibber_connect get02-9OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02Data { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total startsAt} today {total startsAt} tomorrow {total startsAt}}}}}}" }
attr EVU_Tibber_connect get02Header01 Content-Type: application/json
attr EVU_Tibber_connect get02Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get02JSON data_viewer_home_currentSubscription_priceInfo
attr EVU_Tibber_connect get02Name 02_priceAll
attr EVU_Tibber_connect get02URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get03-1Name nodes_00_00_from
attr EVU_Tibber_connect get03-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-2Name nodes_00_00_cost
attr EVU_Tibber_connect get03-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-3Name nodes_00_00_consumption
attr EVU_Tibber_connect get03-4Name nodes_00_01_from
attr EVU_Tibber_connect get03-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-50Name nodes_00_01_cost
attr EVU_Tibber_connect get03-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-5Name nodes_00_01_cost
attr EVU_Tibber_connect get03-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-6Name nodes_00_01_consumption
attr EVU_Tibber_connect get03-7Name nodes_00_02_from
attr EVU_Tibber_connect get03-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-8Name nodes_00_02_cost
attr EVU_Tibber_connect get03-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-9Name nodes_00_02_consumption
attr EVU_Tibber_connect get03Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 3) {nodes {from cost consumption }}}}}"}
attr EVU_Tibber_connect get03Header01 Content-Type: application/json
attr EVU_Tibber_connect get03Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get03Name 03_consumption_hour
attr EVU_Tibber_connect get03RegOpt g
attr EVU_Tibber_connect get03Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get03URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get04-10Name nodes_24_03_from
attr EVU_Tibber_connect get04-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-11Name nodes_24_03_cost
attr EVU_Tibber_connect get04-11OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-12Name nodes_24_03_consumption
attr EVU_Tibber_connect get04-13Name nodes_24_04_from
attr EVU_Tibber_connect get04-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-14Name nodes_24_04_cost
attr EVU_Tibber_connect get04-14OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-15Name nodes_24_04_consumption
attr EVU_Tibber_connect get04-16Name nodes_24_05_from
attr EVU_Tibber_connect get04-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-17Name nodes_24_05_cost
attr EVU_Tibber_connect get04-17OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-18Name nodes_24_05_consumption
attr EVU_Tibber_connect get04-19Name nodes_24_06_from
attr EVU_Tibber_connect get04-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-1Name nodes_24_00_from
attr EVU_Tibber_connect get04-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-20Name nodes_24_06_cost
attr EVU_Tibber_connect get04-20OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-21Name nodes_24_06_consumption
attr EVU_Tibber_connect get04-22Name nodes_24_07_from
attr EVU_Tibber_connect get04-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-23Name nodes_24_07_cost
attr EVU_Tibber_connect get04-23OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-24Name nodes_24_07_consumption
attr EVU_Tibber_connect get04-25Name nodes_24_08_from
attr EVU_Tibber_connect get04-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-26Name nodes_24_08_cost
attr EVU_Tibber_connect get04-26OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-27Name nodes_24_08_consumption
attr EVU_Tibber_connect get04-28Name nodes_24_09_from
attr EVU_Tibber_connect get04-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-29Name nodes_24_09_cost
attr EVU_Tibber_connect get04-29OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-2Name nodes_24_00_cost
attr EVU_Tibber_connect get04-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-30Name nodes_24_09_consumption
attr EVU_Tibber_connect get04-31Name nodes_24_10_from
attr EVU_Tibber_connect get04-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-32Name nodes_24_10_cost
attr EVU_Tibber_connect get04-32OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-33Name nodes_24_10_consumption
attr EVU_Tibber_connect get04-34Name nodes_24_11_from
attr EVU_Tibber_connect get04-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-35Name nodes_24_11_cost
attr EVU_Tibber_connect get04-35OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-36Name nodes_24_11_consumption
attr EVU_Tibber_connect get04-37Name nodes_24_12_from
attr EVU_Tibber_connect get04-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-38Name nodes_24_12_cost
attr EVU_Tibber_connect get04-38OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-39Name nodes_24_12_consumption
attr EVU_Tibber_connect get04-3Name nodes_24_00_consumption
attr EVU_Tibber_connect get04-40Name nodes_24_13_from
attr EVU_Tibber_connect get04-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-41Name nodes_24_13_cost
attr EVU_Tibber_connect get04-41OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-42Name nodes_24_13_consumption
attr EVU_Tibber_connect get04-43Name nodes_24_14_from
attr EVU_Tibber_connect get04-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-44Name nodes_24_14_cost
attr EVU_Tibber_connect get04-44OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-45Name nodes_24_14_consumption
attr EVU_Tibber_connect get04-46Name nodes_24_15_from
attr EVU_Tibber_connect get04-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-47Name nodes_24_15_cost
attr EVU_Tibber_connect get04-47OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-48Name nodes_24_15_consumption
attr EVU_Tibber_connect get04-49Name nodes_24_16_from
attr EVU_Tibber_connect get04-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-4Name nodes_24_01_from
attr EVU_Tibber_connect get04-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-50Name nodes_24_16_cost
attr EVU_Tibber_connect get04-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-51Name nodes_24_16_consumption
attr EVU_Tibber_connect get04-52Name nodes_24_17_from
attr EVU_Tibber_connect get04-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-53Name nodes_24_17_cost
attr EVU_Tibber_connect get04-53OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-54Name nodes_24_17_consumption
attr EVU_Tibber_connect get04-55Name nodes_24_18_from
attr EVU_Tibber_connect get04-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-56Name nodes_24_18_cost
attr EVU_Tibber_connect get04-56OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-57Name nodes_24_18_consumption
attr EVU_Tibber_connect get04-58Name nodes_24_19_from
attr EVU_Tibber_connect get04-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-59Name nodes_24_19_cost
attr EVU_Tibber_connect get04-59OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-5Name nodes_24_01_cost
attr EVU_Tibber_connect get04-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-60Name nodes_24_19_consumption
attr EVU_Tibber_connect get04-61Name nodes_24_20_from
attr EVU_Tibber_connect get04-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-62Name nodes_24_20_cost
attr EVU_Tibber_connect get04-62OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-63Name nodes_24_20_consumption
attr EVU_Tibber_connect get04-64Name nodes_24_21_from
attr EVU_Tibber_connect get04-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-65Name nodes_24_21_cost
attr EVU_Tibber_connect get04-65OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-66Name nodes_24_21_consumption
attr EVU_Tibber_connect get04-67Name nodes_24_22_from
attr EVU_Tibber_connect get04-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-68Name nodes_24_22_cost
attr EVU_Tibber_connect get04-68OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-69Name nodes_24_22_consumption
attr EVU_Tibber_connect get04-6Name nodes_24_01_consumption
attr EVU_Tibber_connect get04-70Name nodes_24_23_from
attr EVU_Tibber_connect get04-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-71Name nodes_24_23_cost
attr EVU_Tibber_connect get04-71OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-72Name nodes_24_23_consumption
attr EVU_Tibber_connect get04-7Name nodes_24_02_from
attr EVU_Tibber_connect get04-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-8Name nodes_24_02_cost
attr EVU_Tibber_connect get04-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-9Name nodes_24_02_consumption
attr EVU_Tibber_connect get04Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 24) {nodes {from cost consumption}}}}}"}
attr EVU_Tibber_connect get04Header01 Content-Type: application/json
attr EVU_Tibber_connect get04Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get04Name 04_consumption_hour_24
attr EVU_Tibber_connect get04RegOpt g
attr EVU_Tibber_connect get04Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get04URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get05AutoNumLen 4
attr EVU_Tibber_connect get05Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 100) {nodes {from cost consumption}}}}}"}
attr EVU_Tibber_connect get05Header01 Content-Type: application/json
attr EVU_Tibber_connect get05Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get05JSON data_viewer_home
attr EVU_Tibber_connect get05Name 05_consumption_hourly_100
attr EVU_Tibber_connect get05URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get06-10Name Adresse_07_Telefon
attr EVU_Tibber_connect get06-11Name Adresse_01_Vorname
attr EVU_Tibber_connect get06-12Name Adresse_02_Nachname
attr EVU_Tibber_connect get06-1Name Adresse_03_Strasse
attr EVU_Tibber_connect get06-2Name Adresse_05_Ort
attr EVU_Tibber_connect get06-3Name Adresse_06_Land
attr EVU_Tibber_connect get06-4Name Adresse_05_Ort
attr EVU_Tibber_connect get06-5Name Adresse_06_Land
attr EVU_Tibber_connect get06-6Name Adresse_09_latitude
attr EVU_Tibber_connect get06-7Name Adresse_10_longitude
attr EVU_Tibber_connect get06-8Name Adresse_04_Plz
attr EVU_Tibber_connect get06-9Name Adresse_08_eMail
attr EVU_Tibber_connect get06Data { "query": "{viewer {home(id:\"%%homeID%%\") {address {address1 address2 address3 postalCode city country latitude longitude} owner {firstName lastName contactInfo {email mobile}}}}}" }
attr EVU_Tibber_connect get06Header01 Content-Type: application/json
attr EVU_Tibber_connect get06Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get06JSON data_viewer_home
attr EVU_Tibber_connect get06Name 06_address
attr EVU_Tibber_connect get06URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get07-10Name nodes_24_03_from
attr EVU_Tibber_connect get07-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-11Name nodes_24_03_cost
attr EVU_Tibber_connect get07-11OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-12Name nodes_24_03_consumption
attr EVU_Tibber_connect get07-13Name nodes_24_04_from
attr EVU_Tibber_connect get07-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-14Name nodes_24_04_cost
attr EVU_Tibber_connect get07-14OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-15Name nodes_24_04_consumption
attr EVU_Tibber_connect get07-16Name nodes_24_05_from
attr EVU_Tibber_connect get07-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-17Name nodes_24_05_cost
attr EVU_Tibber_connect get07-17OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-18Name nodes_24_05_consumption
attr EVU_Tibber_connect get07-19Name nodes_24_06_from
attr EVU_Tibber_connect get07-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-1Name features_realTimeConsumptionEnabled
attr EVU_Tibber_connect get07-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-20Name nodes_24_06_cost
attr EVU_Tibber_connect get07-20OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-21Name nodes_24_06_consumption
attr EVU_Tibber_connect get07-22Name nodes_24_07_from
attr EVU_Tibber_connect get07-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-23Name nodes_24_07_cost
attr EVU_Tibber_connect get07-23OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-24Name nodes_24_07_consumption
attr EVU_Tibber_connect get07-25Name nodes_24_08_from
attr EVU_Tibber_connect get07-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-26Name nodes_24_08_cost
attr EVU_Tibber_connect get07-26OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-27Name nodes_24_08_consumption
attr EVU_Tibber_connect get07-28Name nodes_24_09_from
attr EVU_Tibber_connect get07-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-29Name nodes_24_09_cost
attr EVU_Tibber_connect get07-29OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-2Name features_id
attr EVU_Tibber_connect get07-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-30Name nodes_24_09_consumption
attr EVU_Tibber_connect get07-31Name nodes_24_10_from
attr EVU_Tibber_connect get07-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-32Name nodes_24_10_cost
attr EVU_Tibber_connect get07-32OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-33Name nodes_24_10_consumption
attr EVU_Tibber_connect get07-34Name nodes_24_11_from
attr EVU_Tibber_connect get07-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-35Name nodes_24_11_cost
attr EVU_Tibber_connect get07-35OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-36Name nodes_24_11_consumption
attr EVU_Tibber_connect get07-37Name nodes_24_12_from
attr EVU_Tibber_connect get07-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-38Name nodes_24_12_cost
attr EVU_Tibber_connect get07-38OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-39Name nodes_24_12_consumption
attr EVU_Tibber_connect get07-3Name nodes_24_00_consumption
attr EVU_Tibber_connect get07-40Name nodes_24_13_from
attr EVU_Tibber_connect get07-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-41Name nodes_24_13_cost
attr EVU_Tibber_connect get07-41OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-42Name nodes_24_13_consumption
attr EVU_Tibber_connect get07-43Name nodes_24_14_from
attr EVU_Tibber_connect get07-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-44Name nodes_24_14_cost
attr EVU_Tibber_connect get07-44OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-45Name nodes_24_14_consumption
attr EVU_Tibber_connect get07-46Name nodes_24_15_from
attr EVU_Tibber_connect get07-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-47Name nodes_24_15_cost
attr EVU_Tibber_connect get07-47OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-48Name nodes_24_15_consumption
attr EVU_Tibber_connect get07-49Name nodes_24_16_from
attr EVU_Tibber_connect get07-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-4Name nodes_24_01_from
attr EVU_Tibber_connect get07-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-50Name nodes_24_16_cost
attr EVU_Tibber_connect get07-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-51Name nodes_24_16_consumption
attr EVU_Tibber_connect get07-52Name nodes_24_17_from
attr EVU_Tibber_connect get07-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-53Name nodes_24_17_cost
attr EVU_Tibber_connect get07-53OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-54Name nodes_24_17_consumption
attr EVU_Tibber_connect get07-55Name nodes_24_18_from
attr EVU_Tibber_connect get07-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-56Name nodes_24_18_cost
attr EVU_Tibber_connect get07-56OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-57Name nodes_24_18_consumption
attr EVU_Tibber_connect get07-58Name nodes_24_19_from
attr EVU_Tibber_connect get07-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-59Name nodes_24_19_cost
attr EVU_Tibber_connect get07-59OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-5Name nodes_24_01_cost
attr EVU_Tibber_connect get07-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-60Name nodes_24_19_consumption
attr EVU_Tibber_connect get07-61Name nodes_24_20_from
attr EVU_Tibber_connect get07-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-62Name nodes_24_20_cost
attr EVU_Tibber_connect get07-62OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-63Name nodes_24_20_consumption
attr EVU_Tibber_connect get07-64Name nodes_24_21_from
attr EVU_Tibber_connect get07-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-65Name nodes_24_21_cost
attr EVU_Tibber_connect get07-65OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-66Name nodes_24_21_consumption
attr EVU_Tibber_connect get07-67Name nodes_24_22_from
attr EVU_Tibber_connect get07-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-68Name nodes_24_22_cost
attr EVU_Tibber_connect get07-68OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-69Name nodes_24_22_consumption
attr EVU_Tibber_connect get07-6Name nodes_24_01_consumption
attr EVU_Tibber_connect get07-70Name nodes_24_23_from
attr EVU_Tibber_connect get07-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-71Name nodes_24_23_cost
attr EVU_Tibber_connect get07-71OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-72Name nodes_24_23_consumption
attr EVU_Tibber_connect get07-7Name nodes_24_02_from
attr EVU_Tibber_connect get07-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-8Name nodes_24_02_cost
attr EVU_Tibber_connect get07-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-9Name nodes_24_02_consumption
attr EVU_Tibber_connect get07Data { "query": "{viewer {home(id:\"%%homeID%%\") {id features{realTimeConsumptionEnabled} } } }" }
attr EVU_Tibber_connect get07Header01 Content-Type: application/json
attr EVU_Tibber_connect get07Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get07JSON data_viewer_home
attr EVU_Tibber_connect get07Name 07_realTimeConsumptionEnabled
attr EVU_Tibber_connect get07RegOpt g
attr EVU_Tibber_connect get07Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get07URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect group PV Steuerung EVU
attr EVU_Tibber_connect icon stromzaehler_icon
attr EVU_Tibber_connect replacement01Mode expression
attr EVU_Tibber_connect replacement01Regex %%token%%
attr EVU_Tibber_connect replacement01Value {KeyValue("read","EVU_Tibber_connect_token")}
attr EVU_Tibber_connect replacement02Mode expression
attr EVU_Tibber_connect replacement02Regex %%homeID%%
attr EVU_Tibber_connect replacement02Value {KeyValue("read","EVU_Tibber_connect_homeID")}
attr EVU_Tibber_connect requestData { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total energy tax startsAt }}}}}}" }
attr EVU_Tibber_connect requestHeader1 Content-Type: application/json
attr EVU_Tibber_connect requestHeader2 Authorization: Bearer %%token%%
attr EVU_Tibber_connect room Strom->Boerse
attr EVU_Tibber_connect showBody 1
attr EVU_Tibber_connect showError 1
attr EVU_Tibber_connect sortby 313
attr EVU_Tibber_connect timeout 30
attr EVU_Tibber_connect userReadings ws_connect:ws_cmd:.connect {\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
return "Device already open" if (defined($devState));;\
\
# establish connection to websocket\
# format must also include portnumber if a path is to be specified\
$hash->{DeviceName} = AttrVal($name, "ws_websocketURL", "wss:echo.websocket.org:443");;\
\
# special headers needed for Tibber, see also Developer Tools in Browser\
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';;\
$hash->{header}{'Host'} = 'websocket-api.tibber.com';;\
$hash->{header}{'Origin'} = 'https://developer.tibber.com';;\
\
# callback function when "select()" signals data for us\
# websocket Ping/Pongs are treated in DevIo but still call this function\
$hash->{directReadFn} = sub () {\
my $hash = $defs{$name};;\
\
# we can read without closing the DevIo, because select() signalled data\
my $buf = DevIo_SimpleRead($hash);;\
\
# if read fails, close device\
if(!defined($buf)) {\
DevIo_CloseDev($hash);;\
$buf = "not_connected";;\
}\
\
#Log(3, "$name:$reading: websocket data: >>>$buf<<<");;\
\
# only update our reading if buffer is not empty and if last update is older than minInterval\
if ($buf ne "") {\
my $websocketDataAge = ReadingsAge($name, "ws_websocketData", 3600);;\
my $minInterval = AttrVal($name, "ws_minInterval", 0);;\
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);;\
\
readingsBeginUpdate($hash);;\
readingsBulkUpdate($hash, "ws_websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);;\
readingsBulkUpdate($hash, "ws_websocketData", "$buf") if (!$isNext);;\
readingsEndUpdate($hash, 1);;\
#Log(3, "$name:$reading: websocket data written to reading");;\
}\
};;\
\
# open DevIo websocket\
DevIo_OpenDev($hash, 0, undef, sub(){\
my ($hash, $error) = @_;;\
return "$error" if ($error);;\
\
my $token = AttrVal($name, "ws_token", "???");;\
$token = KeyValue("read","EVU_Tibber_connect_token") if ($token eq "???");;\
\
DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);;\
});;\
readingsBulkUpdate($hash, "ws_websocketData", "");;\
#Log(3, "$name:$reading: websocket data cleared in reading");;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_disconnect:ws_cmd:.disconnect {\
Log(3, "$name: disconnect");;\
my $hash = $defs{$name};;\
RemoveInternalTimer($hash);;\
DevIo_SimpleRead($hash);;\
DevIo_CloseDev($hash);;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onDisconnect {\
my $myState = ReadingsVal($name, "state", "???");;\
my $myData = ReadingsVal($name, "ws_websocketData", "???");;\
return if ($myState ne "disconnected" and $myData ne "not_connected");;\
\
## timer callback function, called after a few seconds to initiate a reconnect\
my $timerFunction = sub() {\
my ($arg) = @_;;\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
\
# only re-connect if device is not connected\
readingsSingleUpdate($hash, "ws_cmd", "connect", 1) if (!defined($devState));;\
};;\
RemoveInternalTimer($name.$reading.'Timer');;\
\
# wait a random time before reconnect (exponential backoff TBD):\
my $rwait = int(rand(200)) + 30;;\
InternalTimer(gettimeofday() + $rwait, $timerFunction, $name.$reading.'Timer');;\
\
#set cmd to a new value, informs user and allows to retrigger when timer expires\
my $hash = $defs{$name};;\
readingsBulkUpdate($hash, "ws_cmd", "reconnect attempt in $rwait seconds");;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onTimeout:ws_websocketData:.* {\
#re-establish websocket connection if no data received in the past ten minutes\
#but only if our reading "ws_cmd" was not set to the value "disconnect"\
\
#Log(3, "$name:$reading: websocket data triggert ws_onTimeout");;\
\
#timeout in seconds when the connection is considered dead\
my $timeoutTime = 600;;\
\
# function to execute when timeout expired\
# defining the function here in the userReading, allows us to insert variables directly\
my $timerFunction = sub() {\
my ($arg) = @_;;\
my $hash = $defs{$name};;\
my $rCmd = ReadingsVal($name, "ws_cmd", "???");;\
my $age = ReadingsAge($name, "ws_websocketData", 0);;\
\
Log(3, "$name: onTimeoutTimer triggered >>$arg<<");;\
\
#do not do anything further if disconnect is on purpose\
if ( $rCmd eq "disconnect" ) {\
Log(3, "$name: ws_cmd was set to disconnect");;\
return;;\
}\
\
# for whatever reason, we triggered to soon (80%)\
if ( $age < $timeoutTime*0.8 ) {\
Log(3, "$name: ws_websocketData is not outdated");;\
return;;\
}\
\
DevIo_CloseDev($hash);;\
Log(3, "$name: onTimeoutTimer closed DevIo...");;\
\
readingsSingleUpdate($hash, "ws_cmd", "connect", 1);;\
Log(3, "$name: onTimeoutTimer set ws_cmd to value 'connect'");;\
};;\
\
#Log(3, "$name:$reading: onTimeout function defined");;\
\
#remove/cancel previous timers, because we got fresh data and countdown starts again\
RemoveInternalTimer($name.$reading.'Timer');;\
\
#set timer to expire and execute function defined above, give special arg as identifier\
InternalTimer(gettimeofday() + $timeoutTime, $timerFunction, $name.$reading.'Timer');;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onConnectionAck:ws_websocketData:.*connection_ack.* {\
#ws_websocketData contains the string "connection_ack"\
Log(3, "$name:$reading: got connection ack");;\
\
# do not proceed if connection is lost\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
return "Device not open" if (!defined($devState));;\
\
readingsBulkUpdate($hash, "ws_cmd", "got connection ack");;\
\
my $homeId = AttrVal($name, "ws_homeId", "???");;\
$homeId = KeyValue("read","EVU_Tibber_connect_homeID") if ($homeId eq "???");;\
\
my $myId = AttrVal($name, "ws_myId", "???");;\
$myId = KeyValue("read","EVU_Tibber_connect_homeID") if ($myId eq "???");;\
\
# build the query, do it in pieces, the comma at the end caused perl errors\
# so we put it together in this not very elegant way\
my $json = '{ "id":"'. $myId .'", "type":"subscribe"'.", ";;\
$json .= '"payload":{';;\
$json .= '"variables":{}'.", ";;\
$json .= '"extensions":{}'.", ";;\
$json .= '"query":"subscription { liveMeasurement( homeId: \"'.$homeId.'\" ) ';;\
#$json .= '{ timestamp power accumulatedConsumption accumulatedCost currency minPower averagePower maxPower signalStrength }}"';;\
$json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';;\
$json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';;\
$json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';;\
$json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}"';;\
$json .= '}}';;\
\
#send the string via websocket as ASCII\
Log(3, "$name:$reading: sending JSON: >>>$json<<<");;\
DevIo_SimpleWrite($hash, $json, 2);;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onNextLiveMeasurement:ws_websocketData:.*next.*payload.*data.*liveMeasurement.* {\
#websocketData contains next-live-measurement-data\
my $val = ReadingsVal($name, "ws_websocketData", "{}");;\
my %res = %{json2nameValue($val, undef, undef, "payload_data_liveMeasurement.*")};;\
\
my $ret = "got values for:\n";;\
foreach my $k (sort keys %res) {\
$ret .= "$k\n";;\
readingsBulkUpdate($hash, makeReadingName($k), $res{$k});;\
}\
return $ret;;\
},\
\
nodes_TIMESTAMP:nodes_00_00_cost.* {\
my ($timestamp,$value) = 2x0;;\
my $tmp = 0;;\
\
for (my $loop_last = 0;; $loop_last <= 2;; $loop_last++) {\
$timestamp = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_from","null");;\
$value = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_cost","null");;\
\
if ( $value ne "null" ) {\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_consumption","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
} else {\
$tmp = "null";;\
}\
} # end for\
if ($tmp eq "null") {\
$timestamp = $tmp\
}\
$timestamp;;\
},\
\
nodes_TIMESTAMP:nodes_24_00_cost.* {\
my ($timestamp,$value) = 2x0;;\
my $tmp = 0;;\
\
for (my $loop_last = 0;; $loop_last <= 23;; $loop_last++) {\
$timestamp = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_from","null");;\
$value = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_cost","null");;\
\
if ( $value ne "null" ) {\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_consumption","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
} else {\
$tmp = "null";;\
}\
} # end for\
if ($tmp eq "null") {\
$timestamp = $tmp\
}\
$timestamp;;\
},\
\
nodes_TIMESTAMP:05_consumption_hourly_100-0001.* {\
my ($timestamp,$value) = 2x0;;\
\
for (my $loop_last = 1;; $loop_last <= 300;; $loop_last += 3) {\
\
$timestamp = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last+2),"null");; # timestamp\
$timestamp =~ s/T/ /g ;;\
$timestamp = substr($timestamp,0,19);;\
$value = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last+1),"null");; # cost\
\
if ( $value ne "" ) {\
$value = round($value,4);;\
# print $timestamp." ".$value."\n";;\
\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last),"null");; # consumption\
$value = round($value,4);;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
} # end for\
\
$timestamp;;\
},\
\
nodes_cost_avg:nodes_TIMESTAMP.* {\
## Berechnung des Tages Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(avg(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_avg","null")\
}\
},\
\
nodes_cost_min:nodes_TIMESTAMP.* {\
## Ermittlung des minimal Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(min(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_min","null")\
}\
},\
\
nodes_cost_max:nodes_TIMESTAMP.* {\
## Ermittlung des maximal Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(max(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_max","null")\
}\
},\
\
nodes_consumption_day:nodes_TIMESTAMP.* {\
## Berechnung des Tages Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND date(TIMESTAMP) = curdate() ;;") ;;\
},\
\
nodes_consumption_month:nodes_TIMESTAMP.* {\
## Berechnung des Monats Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND YEAR(TIMESTAMP) = YEAR(curdate())\
AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;") ;;\
},\
\
nodes_consumption_year:nodes_TIMESTAMP.* {\
## Berechnung des Jahres Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;") ;;\
},\
\
fc_avg:current_price.* {\
## Berechnung des durchschnitt Wertes\
my $fc_avg = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
if (AttrVal("$NAME","verbose",0) >=3) {\
Log 3, "$NAME cmd_1 : Tibber Daten für fc1 sind bereits da";;\
}\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) { ## Summe berechnen\
$fc_avg += ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
} # end $k\
} # end $j\
\
return round($fc_avg / (24 *(1+$fc)) *100 ,2);; ## Durchschnitt berechnen\
},\
\
fc_med:current_price.* {\
## Berechnung des median Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT\
cast( ( (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', floor(1+((count(VALUE)-1) / 2))) , ',', -1))\
+ (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', ceiling(1+((count(VALUE)-1) / 2))), ',', -1))\
)/2 *100\
AS DECIMAL(4,2))\
FROM history\
WHERE DEVICE='".$NAME."'\
AND ( READING='fc0_total' AND TIMESTAMP >= DATE_FORMAT(NOW(), '%Y-%m-%d 00:00:00')\
OR READING='fc1_total' AND TIMESTAMP >= DATE_FORMAT(NOW() + INTERVAL 1 DAY, '%Y-%m-%d 00:00:00') ) ;;") ;;\
},\
\
fc_min:current_price.* {\
## Ermittlung des minimal Wertes\
my $fc_min = 0;;\
my $fc_tmp = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) {\
$fc_tmp = ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
\
if (($fc_tmp < $fc_min) or ($j == 0 and $k == 0)) {\
$fc_min = $fc_tmp;;\
}\
} # end $k\
} # end $j\
\
return round($fc_min *100 ,2);; ## Von Euro auf Cent umrechnen\
},\
\
fc_max:current_price.* {\
## Ermittlung des minimal Wertes\
my $fc_max = 0;;\
my $fc_tmp = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) {\
$fc_tmp = ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
\
if (($fc_tmp > $fc_max) or ($j == 0 and $k == 0)) {\
$fc_max = $fc_tmp;;\
}\
} # end $k\
} # end $j\
\
return round($fc_max *100 ,2);; ## Von Euro auf Cent umrechnen\
},\
\
fc_trigger_price:fc_avg.* {\
## fc_trigger_price:[fc_avg|compensation_grid].* {\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_min = ReadingsVal("$NAME","fc_min",0);;\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
if ( ReadingsVal("$NAME","compensation_grid",0) != 0 ) {\
my $price_level_battery = round( ($fc_avg - ReadingsVal("$NAME","compensation_grid",0)) *0.85 , 1) ;;\
if ( $price_level > $price_level_battery ) {\
$price_level = $price_level_battery;;\
}\
}\
$price_level;;\
},\
\
fc0_trigger_start:fc_trigger_price.* {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_stop:fc0_trigger_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc0_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc0_trigger:fc0_trigger_stop.* {\
\
# Setzen des Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",100) < ReadingsVal("$NAME","fc_trigger_price",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc1_trigger_start:fc_trigger_price.* {\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
}\
return("null");;\
},\
\
fc1_trigger_stop:fc0_trigger_start.* {\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc1_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc_trigger_max:fc_avg.* {\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_max = ReadingsVal("$NAME","fc_max",0);;\
\
# Berechnung eines Schwellwertes als täglichen Maximalpreises\
my $price_level = round( ($fc_max - $fc_avg)/2 + $fc_avg , 0);;\
\
$price_level;;\
},\
\
fc0_trigger_max_start:fc_trigger_max.* {\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger_max Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_max_stop:fc0_trigger_max_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_max_start = ReadingsVal("$NAME","fc0_trigger_max_start","null");;\
my $fc_trigger_max_stop = $fc_trigger_max_start;;\
\
if ( $fc_trigger_max_start ne "null" ) {\
$fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_max_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
$fc_trigger_max_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_max_stop);;\
},\
\
fc0_trigger_max:fc0_trigger_max_stop.* {\
\
# Setzen des maximum Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",0) > ReadingsVal("$NAME","fc_trigger_max",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc1_trigger_max_start:fc_trigger_max.* {\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") {\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
}\
return("null");;\
},\
\
fc1_trigger_max_stop:fc0_trigger_max_start.* {\
my $loop_hour = 0;;\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_max_start = ReadingsVal("$NAME","fc1_trigger_max_start","null");;\
my $fc_trigger_max_stop = $fc_trigger_max_start;;\
\
if ( $fc_trigger_max_start ne "null" ) {\
$fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_max_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
$fc_trigger_max_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_max_stop);;\
},\
\
total_cost_day:nodes_TIMESTAMP.* {\
## Berechnung des Tages Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND date(TIMESTAMP) = curdate() ;;") ;;\
},\
\
total_cost_month:nodes_TIMESTAMP.* {\
## Berechnung des monats Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND YEAR(TIMESTAMP) = YEAR(curdate())\
AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;") ;;\
},\
\
total_cost_year:nodes_TIMESTAMP.* {\
## Berechnung des Jahres Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;") ;;\
},\
\
fc_DbLog:fc0_00_total.* {\
my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\
\
for (my $loop_fc = 0;; $loop_fc <= 1;; $loop_fc++) {\
$loop_fc_next = $loop_fc +1;;\
$date = ReadingsVal("$NAME","fc".$loop_fc."_00_startsAt","null");;\
if ($date ne "null") {\
$date =~ /([\d+-]+)/;; $date = $1 ;;\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$hour = sprintf("%02d",$loop_hour);;\
$timestamp = $date." ".$hour.":00:00";;\
$value = ReadingsVal("$NAME","fc".$loop_fc."_".$hour."_total","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','fc".$loop_fc."_total','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
if (ReadingsVal("$NAME","fc".$loop_fc."_00_startsAt","null") eq ReadingsVal("$NAME","fc".$loop_fc_next."_00_startsAt","null")) {\
fhem("deletereading $NAME fc".$loop_fc_next."_.*");;\
}\
} else {\
fhem("deletereading $NAME fc1_.*");;\
}\
}\
ReadingsTimestamp("$NAME","fc0_00_startsAt","null");;\
}
attr EVU_Tibber_connect verbose 0
attr EVU_Tibber_connect ws_minInterval 54
attr EVU_Tibber_connect ws_websocketURL wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions
</syntaxhighlight>

==== EVU_Tibber RAW Device ====
Das Device dient der Anzeige und Steuerung des EVU_Tibber_connect Devices.
<syntaxhighlight lang="Perl">
defmod EVU_Tibber DOIF ## Startup Befehle für den WebSocket vom EVU_Tibber_connect\
init\
{ \
Log(0, "$SELF 0 init : ▶️ EVU_Tibber init");;\
fhem("setreading EVU_Tibber_connect ws_cmd connect");; \
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 0 WebSocket : ▶️ EVU_Tibber_connect start Websocket";;\
}\
Log(0, "$SELF 0 init : 🏁 EVU_Tibber init done");;\
}\
\
################################################################################################################\
## EVU_Tibber_connect start/stop WebSocket\
EVU_Tibber_connect_ws\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
# or [$SELF:ui_command_2] ## Hier wird das uiTable select ausgewertet\
and [$SELF:ui_command_2] ne "---"\
) {\
\
fhem("setreading EVU_Tibber_connect ws_cmd ".[?$SELF:ui_command_2]);; \
\
set_Reading("ui_command_2","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 1 Scheduling für das Abholen von Tibber Daten\
1_EVU_Tibber_PriceInfo\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
( [:03] ## Kurz nach jeder vollen Stunde\
)\
or [$SELF:ui_command_1] eq "1_EVU_Tibber_PriceInfo" ## Hier wird das uiTable select ausgewertet\
) {\
\
::CommandGet(undef, "EVU_Tibber_connect 01_priceInfo");; ## Preis für die aktuelle Stunde\
::CommandGet(undef, "EVU_Tibber_connect 03_consumption_hour");; ## Kosten der letzen drei Stunden\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 1 PriceInfo : Abfrage von Tibber";;\
}\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 2 Scheduling für das Abholen der Tibber Preise\
2_EVU_Tibber_PriceAll\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
([00:03] or [14:03] ## Ab 14:00 Uhr gibt es die Preise für den nächsten Tag\
)\
or [$SELF:ui_command_1] eq "2_EVU_Tibber_PriceAll" ## Hier wird das uiTable select ausgewertet\
) {\
\
::CommandGet(undef, "EVU_Tibber_connect 02_priceAll");;\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 2 priceAll : Abfrage von Tibber für den nächsten Tag";;\
}\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 2 Erstellen des Diagramms im uiTable\
3_EVU_Tibber_Diagramm\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
( [00:05] or [14:05] ## Kurz nach Mitternacht\
)\
or [$SELF:ui_command_1] eq "3_EVU_Tibber_Diagramm" ## Hier wird das uiTable select ausgewertet\
) {\
\
my (@out) = ("") x 2;;\
my $timestamp;;\
\
for (my $j=0;;$j<=1;;$j++){\
\
if (ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_00_startsAt",$j),"null") eq "null") { ## Der nächste Tag ist noch nicht da\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 3 Diagramm : Tibber Daten für fc".$j." sind noch nicht da";;\
}\
\
$timestamp = POSIX::strftime("%Y-%m-%d",localtime(time+86400));; ## Setze das Datum auf morgen\
for (my $k=0;;$k<=24;;$k++) {\
$out[$j] .= sprintf("%s_%02d:00:00 0.0\n", $timestamp, $k);; ## Die Daten mit 0 ergänzen\
}\
$j = 2;; ## Aus der Schleife springen\
\
} else {\
\
for (my $i=0;;$i<=23;;$i++){\
$timestamp = ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_%02d_startsAt",$j,$i),"");;\
$timestamp =~ s/ /_/g;;\
$out[$j] .=$timestamp." ".::round(ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_%02d_total",$j, $i),0)*100,1)."\n";;\
} # End $i\
\
} # End if\
} # End $j\
\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 3 Diagramm : Werte für das Diagramm";;\
print($out[0]);;\
print($out[1]);;\
}\
## Die readings current_price und current_level dienen hier nur als Trigger Events, und müssen für\
## jedes Diagramm unterschiedlich sein, die Daten werden über $out[] bereit gestellt !!\
::DOIF_modify_card_data("EVU_Tibber","EVU_Tibber_connect","current_price","bar1day",0,$out[0]);;\
::DOIF_modify_card_data("EVU_Tibber","EVU_Tibber_connect","current_level","bar1day",-86400,$out[1]);;\
## Mit der Abfrage 03_consumption_hour werden die Trigger erneut ausgelöst\
::CommandGet(undef, "EVU_Tibber_connect 01_priceInfo");; ## Kosten der letzen drei Stunden\
## fhem("get EVU_Tibber_connect 01_priceInfo");; ## Kosten der letzen drei Stunden\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\

attr EVU_Tibber DbLogExclude .*
attr EVU_Tibber comment Version 2023.12.06 13:00 \
Dieses Device benötigt EVU_Tibber_connect als Verbindung zu Tibber.
attr EVU_Tibber disable 0
attr EVU_Tibber group PV Steuerung EVU
attr EVU_Tibber icon stromzaehler_icon
attr EVU_Tibber room Strom->Boerse
attr EVU_Tibber sortby 315
attr EVU_Tibber uiState {\
package ui_Table;;\
$TABLE = "style='width:100%;;'";;\
\
$TD{0..6}{0} = "style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'";;\
$TD{0..6}{1..4} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'";;\
$TD{0..6}{5} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'";;\
\
}\
\
"Kommando<dd>Auswahl</dd>" |widget([$SELF:ui_command_1],"uzsuDropDown,---,1_EVU_Tibber_PriceInfo,2_EVU_Tibber_PriceAll,3_EVU_Tibber_Diagramm") |"LiveMessurement <br>".widget([$SELF:ui_command_2],"uzsuDropDown,---,connect,disconnect")|""|[EVU_Tibber_connect:ws_cmd]\
\
"Strompreis<br>".card([EVU_Tibber_connect:current_price:bar1day],undef,undef,0,60,90,0,"fc0 ".::ReadingsVal(Device(),"current_currency",""),undef,"1","130,,,,,,220").card([EVU_Tibber_connect:current_level:bar1day],undef,undef,0,60,90,0,"fc1 ".::ReadingsVal(Device(),"current_currency",""),undef,"1","130,,,,,,220")|\
"<span style=font-weight:bold>nächste 3h</span><br><br>".Price(1)."<br>".Price(2)."<br>".Price(3)|"<span style=font-weight:bold>Statistik fc0</span><br><br>".::ReadingsVal(Device(),"fc_min",0)." min<br>".::ReadingsVal(Device(),"fc_avg",0)." avg<br>".::ReadingsVal(Device(),"fc_med",0)." med<br>".::ReadingsVal(Device(),"fc_max",0)." max"|\
"<span style=font-weight:bold>Trigger fc0</span><br>Basis ".widget([EVU_Tibber_connect:compensation_grid],"selectnumbers,0,0.1,12,1,lin")."<br>".Format("trigger_0")|\
"<span style=font-weight:bold>Trigger fc1</span><br><br>".Format("trigger_1")
attr EVU_Tibber uiTable {\
package ui_Table;;\
$TABLE = "style='width:100%;;'";;\
\
$TD{0..18}{0} = "style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'";;\
$TD{0..18}{1..5} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'";;\
$TD{0..18}{6} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'";;\
\
sub FUNC_Status {\
my($value, $min, $colorMin, $statusMin, $colorMiddel, $statusMiddle, $max, $colorMax, $statusMax)=@_;;\
my $ret = ($value < $min)? '<span style="color:'.$colorMin.'">'.$statusMin.'</span>' : ($value > $max)? '<span style="color:'.$colorMax.'">'.$statusMax.'</span>' : '<span style="color:'.$colorMiddel.'">'.$statusMiddle.'</span>';;\
return $ret;;\
}\
\
sub Device {\
return "$SELF"."_connect";;\
}\
\
sub Cost {\
my($i)=@_;;\
my $currency = (::ReadingsVal(Device(),"current_currency","") eq "EUR")? " €" : "";;\
\
return ::ReadingsVal(Device(),"total_cost_".$i,0).$currency;;\
}\
\
sub Price {\
my($i)=@_;;\
my $j;;\
my $value;;\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
\
if ($i == 0) {\
$value = ::ReadingsVal(Device(),"current_price",0);;\
$value = ( ::ReadingsVal(Device(),"fc0_trigger","off") eq "on" ) ?\
"<span style='color:green'>".$value."</span>" :\
"<span style='color:red'>".$value."</span>" ;;\
$value .= " ct/kWh";;\
} else {\
$j = $i+$hour;;\
if ($j < 24) {\
$value = ::round(::ReadingsVal(Device(),"fc0_".sprintf("%02d",$j)."_total",0)*100,1);;\
} else {\
$j = $j - 24;;\
$value = ::round(::ReadingsVal(Device(),"fc1_".sprintf("%02d",$j)."_total",0)*100,1);;\
}\
$value = ( ::ReadingsVal(Device(),"fc_trigger_price","0") > $value ) ?\
"<span style='color:green'>".$value."</span>" :\
"<span style='color:red'>".$value."</span>" ;;\
$value = sprintf("%02d",$j)." : ".$value ;;\
}\
return $value;;\
}\
\
sub Format {\
my($i)=@_;;\
\
my $MonthBefore = "LogDBRep_Statistic_previous_Month";;\
my $MonthPrevious = ::ReadingsTimestamp("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month","null");;\
$MonthPrevious = ($MonthPrevious ne "null") ? POSIX::strftime("%Y",localtime(::time_str2num(::ReadingsTimestamp("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month","null")))) : "null";;\
\
my $YearBefore = "LogDBRep_Statistic_previous_Year";;\
my $YearPrevious = ::ReadingsTimestamp("$YearBefore",Device()."_nodes_consumption_year","null");;\
$YearPrevious = ($YearPrevious ne "null") ? POSIX::strftime("%Y",localtime(::time_str2num(::ReadingsTimestamp("$YearBefore",Device()."_nodes_consumption_year","null")))) : "null";;\
\
if ($i eq "day") {\
return sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_day",0));;\
} elsif ($i eq "month") {\
my $evu_em = sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_month",0));;\
$evu_em .= ($MonthPrevious ne "null") ? sprintf(" / %04d", ::ReadingsVal("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month",0) ) : "";;\
return $evu_em;;\
} elsif ($i eq "year") {\
my $evu_ey = sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_year",0));;\
$evu_ey .= ($YearPrevious ne "null") ? sprintf(" / %04d", ::ReadingsVal("$YearBefore","EVU_Tibber_Pulse_nodes_consumption_month",0) ) : "";;\
return $evu_ey;;\
} elsif ($i eq "trigger_0") {\
return ((::ReadingsVal(Device(),"fc0_trigger_start","") eq "null" ) ?\
"<span style='color:red'>Heute kein Trigger <br>mehr unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" :\
"<span style='color:green'>Trigger von<br>".\
::ReadingsVal(Device(),"fc0_trigger_start","00:00")." bis ".::ReadingsVal(Device(),"fc0_trigger_stop","00:00")."<br>unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" );;\
} elsif ($i eq "trigger_1") {\
if (::ReadingsVal(Device(),"fc1_00_startsAt","null") ne "null") {\
return ((::ReadingsVal(Device(),"fc1_trigger_start","null") eq "null" ) ?\
"<span style='color:red'>Morgen kein Trigger <br>mehr unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" :\
"<span style='color:green'>Morgen ein Trigger von<br>".\
::ReadingsVal(Device(),"fc1_trigger_start","00:00")." bis ".::ReadingsVal(Device(),"fc1_trigger_stop","00:00")."<br>unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" );;\
} else {\
return "Morgen noch kein Trigger vorhanden";;\
}\
}\
return "null";;\
}\
\
}\
\
"Statistiken ".::ReadingsVal(Device(),"current_date",0)." in kWh"|"<span style=font-weight:bold>aktuell</span>"|"<span style=font-weight:bold>heute</span>"|"<span style=font-weight:bold>Monat</span>"|"<span style=font-weight:bold>Jahr</span>"\
\
"Strom<dd>Preis / Kosten</dd>"|Price(0)|Cost("day")|Cost("month")|Cost("year")\
\
## Wenn man das liveMessurment von Tibber verwendet\
"Bezug vom Netz"|\
sprintf("%04d W",([EVU_Tibber_connect:payload_data_liveMeasurement_power] >= 0 ? ::ReadingsVal("EVU_Tibber_connect","payload_data_liveMeasurement_power",0) : 0))|\
Format("day")|Format("month")|Format("year")\
\
"Einspeisung ins Netz"|\
sprintf("%04d W",([EVU_Tibber_connect:payload_data_liveMeasurement_powerProduction] >= 0 ? ::ReadingsVal("EVU_Tibber_connect","payload_data_liveMeasurement_powerProduction",0) : 0))|\
""|""|""\
\
## Wenn man einen eigenes SmartMeter verwendet\
## "Bezug vom Netz"|sprintf("%04d W",([WR_0_KSEM:M_AC_Power] >= 0 ? ::round(::ReadingsVal("WR_0_KSEM","M_AC_Power",0),0) : 0) )|Format("day")|Format("month")|Format("year")\
## "Einspeisung ins Netz"|sprintf("%04d W",([WR_0_KSEM:M_AC_Power] <= 0 ? abs(::round(::ReadingsVal("WR_0_KSEM","M_AC_Power",0),0)) : 0) )|""|""|""
attr EVU_Tibber verbose 3

setstate EVU_Tibber 2024-01-23 10:03:00 ui_command_1 ---
setstate EVU_Tibber 2024-01-20 17:40:53 ui_command_2 ---
</syntaxhighlight>

==== LogDBRep_EVU_Tibber_connect_SQL RAW Device ====
Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements werden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.
<syntaxhighlight lang="Perl">
defmod LogDBRep_EVU_Tibber_connect_SQL DbRep LogDB
attr LogDBRep_EVU_Tibber_connect_SQL DbLogExclude .*
attr LogDBRep_EVU_Tibber_connect_SQL room System
attr LogDBRep_EVU_Tibber_connect_SQL sqlCmdHistoryLength 5
attr LogDBRep_EVU_Tibber_connect_SQL timeout 20
</syntaxhighlight>

== 2. aWATTar ==
=== Voraussetzungen ===
* FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)
* Für die Berechnung der tatsächlichen Kosten benötigt man seine lokalen Fixkosten, die je nach Region unterschiedlich sind.
* Die bisherige Berechnung mit Stand 20240123 wäre wie folgt: round(($val+$val*0.03+1.785)*1.19,2)

=== EVU_aWATTar_connect ===
Das EVU_aWATTar_connect fragt mit HTTPMOD die aWATTar API Webseite ab. Es werden keine Live Verbrauchdaten geliefert.

==== Verwendete Module ====
* HTTPMOD
* DbLog
* DbRep

==== EVU_aWATTar_connect RAW Device ====
Momentan fragt das EVU_aWattar_connect lediglich die aktuellen Preise des Tages ab. Die readings sind an die des EVU_Tibber_connect angelehnt, um im weiteren Verlauf eventuell ein gemeinsames Device für die Anzeige und Steuerung zu erarbeiten.
<syntaxhighlight lang="Perl">
defmod EVU_aWATTar_connect HTTPMOD https://api.awattar.de/v1/marketdata/current.yaml 0
attr EVU_aWATTar_connect DbLogExclude .*
attr EVU_aWATTar_connect comment Version 2024.01.23 13:00\
\
Achtung, momentan werden nur die Börsenpreise ohne die fix Kosten dargestellt.\
\
https://api.awattar.de/v1/marketdata
attr EVU_aWATTar_connect enableControlSet 1
attr EVU_aWATTar_connect get01-15Name fc_max
attr EVU_aWATTar_connect get01-15OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-1Name current_date
attr EVU_aWATTar_connect get01-22Name fc_med
attr EVU_aWATTar_connect get01-22OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-29Name fc_avg
attr EVU_aWATTar_connect get01-29OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-36Name current_price
attr EVU_aWATTar_connect get01-36OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-8Name fc_min
attr EVU_aWATTar_connect get01-8OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01Name 01_priceInfo
attr EVU_aWATTar_connect get01RegOpt g
attr EVU_aWATTar_connect get01Regex date_now: (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})|price_low: ([0-9]+[0-9\.]+)|price_high: ([0-9]+[0-9\.]+)|price_median: ([0-9]+[0-9\.]+)|price_average: ([0-9]+[0-9\.]+)|price_current: ([0-9]+[0-9\.]+)
attr EVU_aWATTar_connect get01URL https://api.awattar.de/v1/marketdata/current.yaml
attr EVU_aWATTar_connect get02-10Name fc0_09_total
attr EVU_aWATTar_connect get02-10OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-11Name fc0_10_total
attr EVU_aWATTar_connect get02-11OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-12Name fc0_11_total
attr EVU_aWATTar_connect get02-12OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-13Name fc0_12_total
attr EVU_aWATTar_connect get02-13OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-14Name fc0_13_total
attr EVU_aWATTar_connect get02-14OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-15Name fc0_14_total
attr EVU_aWATTar_connect get02-15OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-16Name fc0_15_total
attr EVU_aWATTar_connect get02-16OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-17Name fc0_16_total
attr EVU_aWATTar_connect get02-17OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-18Name fc0_17_total
attr EVU_aWATTar_connect get02-18OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-19Name fc0_18_total
attr EVU_aWATTar_connect get02-19OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-1Name fc0_00_total
attr EVU_aWATTar_connect get02-1OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-20Name fc0_19_total
attr EVU_aWATTar_connect get02-20OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-21Name fc0_20_total
attr EVU_aWATTar_connect get02-21OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-22Name fc0_21_total
attr EVU_aWATTar_connect get02-22OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-23Name fc0_22_total
attr EVU_aWATTar_connect get02-23OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-24Name fc0_23_total
attr EVU_aWATTar_connect get02-24OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-2Name fc0_01_total
attr EVU_aWATTar_connect get02-2OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-3Name fc0_02_total
attr EVU_aWATTar_connect get02-3OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-4Name fc0_03_total
attr EVU_aWATTar_connect get02-4OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-5Name fc0_04_total
attr EVU_aWATTar_connect get02-5OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-6Name fc0_05_total
attr EVU_aWATTar_connect get02-6OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-7Name fc0_06_total
attr EVU_aWATTar_connect get02-7OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-8Name fc0_07_total
attr EVU_aWATTar_connect get02-8OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-9Name fc0_08_total
attr EVU_aWATTar_connect get02-9OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02FollowGet 01_priceInfo
attr EVU_aWATTar_connect get02Name 02_priceDay
attr EVU_aWATTar_connect get02RegOpt g
attr EVU_aWATTar_connect get02Regex (?<=abs_[0-9]{2}_amount: )([0-9]+[0-9\.]+)
attr EVU_aWATTar_connect get02URL https://api.awattar.de/v1/marketdata/current.yaml
attr EVU_aWATTar_connect get03-1Name fc3_00_startsAt
attr EVU_aWATTar_connect get03-1OExpr POSIX::strftime("%Y-%m-%d %H:%M:%S",localtime(substr($val,0,10)))
attr EVU_aWATTar_connect get03-4Name fc3_00_total
attr EVU_aWATTar_connect get03-4OExpr round($val/1000,4)
attr EVU_aWATTar_connect get03Name 02_priceAll
attr EVU_aWATTar_connect get03RegOpt g
attr EVU_aWATTar_connect get03Regex "start_timestamp": (\d{10})|"marketprice": (\d*\.\d*)
attr EVU_aWATTar_connect get03URL https://api.awattar.de/v1/marketdata?start=1701990000000&end=1702159200000
attr EVU_aWATTar_connect group PV Steuerung EVU
attr EVU_aWATTar_connect icon sani_pump
attr EVU_aWATTar_connect room Strom->Boerse
attr EVU_aWATTar_connect sortby 213
attr EVU_aWATTar_connect userReadings fc_trigger_price:fc_avg.* {\
## fc_trigger_price:[fc_avg|compensation_grid].* {\\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_min = ReadingsVal("$NAME","fc_min",0);;\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
if ( ReadingsVal("$NAME","compensation_grid",0) != 0 ) {\
my $price_level_battery = round( ($fc_avg - ReadingsVal("$NAME","compensation_grid",0)) *0.85 , 1) ;;\
if ( $price_level > $price_level_battery ) {\
$price_level = $price_level_battery;;\
}\
}\
$price_level;;\
},\
\
fc0_trigger_start:fc_trigger_price.* {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_stop:fc0_trigger_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc0_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc0_trigger:fc0_trigger_stop.* {\
\
# Setzen des Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",100) < ReadingsVal("$NAME","fc_trigger_price",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc_DbLog:fc0_00_total.* {\
my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\
\
for (my $loop_fc = 0;; $loop_fc <= 1;; $loop_fc++) {\
$loop_fc_next = $loop_fc +1;;\
$date = ReadingsVal("$NAME","current_date","null");;\
if ($date ne "null") {\
$date =~ /([\d+-]+)/;; $date = $1 ;;\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$hour = sprintf("%02d",$loop_hour);;\
$timestamp = $date." ".$hour.":00:00";;\
$value = ReadingsVal("$NAME","fc".$loop_fc."_".$hour."_total","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','fc".$loop_fc."_total','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
} else {\
fhem("deletereading $NAME fc1_.*");;\
}\
}\
ReadingsVal("$NAME","current_date","null");;\
}
attr EVU_aWATTar_connect verbose 0
</syntaxhighlight>

==== LogDBRep_EVU_aWATTar_connect_SQL RAW Device ====
Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements werden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.
<syntaxhighlight lang="Perl">
defmod LogDBRep_EVU_aWATTar_connect_SQL DbRep LogDB
attr LogDBRep_EVU_aWATTar_connect_SQL DbLogExclude .*
attr LogDBRep_EVU_aWATTar_connect_SQL room System
attr LogDBRep_EVU_aWATTar_connect_SQL sqlCmdHistoryLength 5
attr LogDBRep_EVU_aWATTar_connect_SQL timeout 20
</syntaxhighlight>

== 3. EPEX_Spot ==
=== Voraussetzungen ===
httpmod

==== EPEX_Spot RAW Device ====
Mit diesem device erhält man die viertelstündlichen Börsenpreise für heute und morgen ('EPEX_prices' und zugehörige 'EPEX_timetags' als Listen ) und den aktuellen Preis ('EPEX_price'). <br>
Die 'dayahead' Preise für morgen werden gegen 14:00 am Vortag veröffentlicht. Bis dahin enthalten die Listen 'EPEX_prices' und 'EPEX_timetags' 96 Elemente, danach sind es 192 Elemente.
Die timetags sind die Unix-timestamps der Viertelstunde, ab welcher der jeweilige Preis gilt.<br>

Code für device ''EPEX_Boersenpreise'':<div style="max-height:150px; overflow:auto; padding:4px;">
<pre>
defmod EPEX_Boersenpreise HTTPMOD URL 900
attr EPEX_Boersenpreise alignTime 00:00
attr EPEX_Boersenpreise comment This device queries €/MWh prices for electrical energy from https://api.energy-charts.info/price?bzn=DE-LU.\
\
A reread every 15 min extracts the EPEX-price of the next quarter hour from the data lists in readings\
EPEX_prices and EPEX_timetags, using the code in reading02RecombineExpr. \
Within reading02RecombineExpr, "get $name EPEX_prices" is issued at the beginning of every second odd \
hour in order to keep EPEX_prices and EPEX_timetags up-to-date. \
Note that the reread itself does not perform an explicit request to api.energy-charts.info, except \
for a dummy request to localhost. This above strategy minimizes the number of external requests, \
in order to avoid occasional timeouts as much as possible.\
\
no_of_data, the length of the data lists in EPEX_prices and EPEX_timetags is 96 after midnight, and it \
changes to 192 in the afternoon when the dayahead prices are available.\
\
An event-on-change-reading for no_of_data can be used by a FileLog device to save the new data.

attr EPEX_Boersenpreise disable 0
attr EPEX_Boersenpreise event-on-update-reading EPEX_price.*
attr EPEX_Boersenpreise get01-1Name EPEX_timetags
attr EPEX_Boersenpreise get01-2Name EPEX_prices
attr EPEX_Boersenpreise get01Name EPEX_prices
attr EPEX_Boersenpreise get01Regex unix_seconds":\[(.*?)\],"price":\[(.*?)\]
attr EPEX_Boersenpreise get01Replacement02Value {my ($s,$m,$h,$D,$M,$Y)=localtime();;my $start=int(fhemTimeLocal(0,0,0,$D,$M,$Y));;"https://api.energy-charts.info/price?bzn=DE-LU&start=".sprintf("%d",$start)."&end=".sprintf("%d",$start+86400+86399)}
attr EPEX_Boersenpreise group EPEX
attr EPEX_Boersenpreise reading02Name EPEX_price
attr EPEX_Boersenpreise reading02RecombineExpr {my ($s,$m,$h,$D,$M,$Y)=localtime();; my $time=fhemTimeLocal(0,0,0,$D,$M,$Y);;\
my $price = "error";;\
if (time_str2num(ReadingsTimestamp($name, "EPEX_prices",0)) > $time-86400) {\
$time=fhemTimeLocal(0,15*int($m/15),$h,$D,$M,$Y);;\
my @times = split(/,/,ReadingsVal($name,"EPEX_timetags","-1"));;\
my @prices = split(/,/,ReadingsVal($name,"EPEX_prices","-1"));;\
my %map;; @map{@times} = @prices;; \
if (exists $map{$time}) {$price = $map{$time}};;\
};;\
if ($h % 2 == 0 and $m == 0) {fhem("get $name EPEX_prices")};;\
$price}
attr EPEX_Boersenpreise reading02Regex .
attr EPEX_Boersenpreise replacement02Mode expression
attr EPEX_Boersenpreise replacement02Regex URL
attr EPEX_Boersenpreise replacement02Value {"http://localhost/"}
attr EPEX_Boersenpreise room Energie
attr EPEX_Boersenpreise showError 1
attr EPEX_Boersenpreise stateFormat EPEX_price €/MWh
attr EPEX_Boersenpreise timeout 5
attr EPEX_Boersenpreise userReadings no_of_data:EPEX_prices.* {split(/,/,ReadingsVal("EPEX_Boersenpreise","EPEX_prices",""))}
</pre>
</div>

Code für device ''FileLog_EPEX_Boersenpreise'':

<pre>
define FileLog_EPEX_Boersenpreise FileLog ./log/EPEX_Boersenpreise.log EPEX_Boersenpreise:no_of_data:.192.*
attr FileLog_EPEX_Boersenpreise outputFormat {my @prices=split(/,/,ReadingsVal("EPEX_Boersenpreise","EPEX_prices","-1"));;my @times=split(/,/,ReadingsVal("EPEX_Boersenpreise","EPEX_timetags","-1"));;return join "", map {strftime("%Y-%m-%d_%H:%M:%S", localtime($times[$_]))." "."EPEX_Boersenpreise"." EPEX_price $prices[$_]\n"} $#times - 95 .. $#times}
</pre>

Mit einem at-device kann man die Länge der Daten im Log-File begrenzen, in diesem Beispiel auf drei Tage:
<pre>
define trim_EPEX_Logfile at *00:02:12 {`tail -n 288 ./log/EPEX_Boersenpreise.log > ./log/file.tmp && mv ./log/file.tmp ./log/EPEX_Boersenpreise.log`;;fhem("set FileLog_EPEX_Boersenpreise reopen")}
</pre>

=== Anwendungsbeispiel===
Im Beispiel sind der viertelstündliche Strombezug (falls mitgeloggt) und der viertelstündliche EPEX-Preis am 11.1.2026 (vormittags) dargestellt:
[[Datei:Bezug-EPEX-Preis.png|600px|rahmenlos|links]]
<br clear="all" />

== Links ==
* Website (deutsch) des Anbieters [https://tibber.com/de Tibber]
* Website (deutsch) des Anbieters [https://www.awattar.de/ aWATTar]

[[Kategorie:Strompreis]]

HttpUtils

2026-01-12T19:16:19Z

Ph1959de: (Ober)Kategorie entfernt

{{Infobox Modul
|ModPurpose=Hilfsfunktionen für HTTP-Zugriffe
|ModType=u
|ModForumArea=Automatisierung
|ModTechName=HttpUtils.pm
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}

Das Modul [[HttpUtils]](.pm) ist sowohl für Modulentwickler als auch für Endanwender gedacht, um Daten via HTTP auszutauschen. Es stellt dabei eine Reihe von Funktionen zur Verfügung und wird beispielsweise vom Modul [[HTTPMOD]] intensiv genutzt.

== Primäre Funktionen (HTTP) ==
Es ist zu beachten, dass bei den Funktionen
* <code>GetHttpFile()</code>
* <code>GetFileFromURL</code>
* <code>GetFileFromURLQuiet</code>
* <code>HttpUtils_BlockingGet</code>
ein sogenannter "blockierender" Aufruf durchgeführt wird. Das bedeutet, dass FHEM bei einem Aufruf einer dieser Funktionen solange wartet und dabei absolut nichts macht, bis die Antwort vom HTTP-Server eintrifft und die Funktion damit beendet ist. Das kann bei Verbindungsproblemen evtl. dazu führen, dass FHEM für die gesamte Wartezeit (Timeout) steht und nichts verarbeitet. Problematisch ist das gerade bei Anwendungen oder Hardware, die eine zeitnahe Reaktion von FHEM erwarten (z.B. HomeMatic-Geräte). In der Zeit, in der auf eine HTTP Antwort gewartet wird, steht FHEM dabei komplett.

Es wird daher empfohlen, die Funktionen so sparsam wie möglich zu verwenden und die Timeouts so niedrig wie möglich zu halten, um ein längeres Einfrieren von FHEM möglichst zu vermeiden.

Um eine Blockierung zu vermeiden wird generell die Verwendung von
:<code>HttpUtils_NonblockingGet</code>
empfohlen. Diese führt den HTTP-Request asynchron durch, wodurch ein Blockieren von FHEM verhindert wird. Wie das genau funktioniert, wird in dem entsprechenden Kapitel beschrieben.

=== GetHttpFile ===
Die Funktion GetHttpFile ist die denkbar einfachste Variante um eine URL aufzurufen.
:<code>GetHttpFile($server, $file)</code>
{| class="wikitable"
|-
! Parameter!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$server</code>'''

''mandatory''
|| Der DNS-Name oder die IP-Adresse des HTTP-Servers<br>
Beispiel:

* ''<nowiki>www.myhost.com</nowiki>''
* ''<nowiki>192.168.0.10</nowiki>''
|-
| style="vertical-align:top" | '''<code>$file</code>'''

''mandatory''
|| Die Datei, welche auf dem HTTP-Server aufgerufen werden soll.<br>
Beispiel:
* ''/''
* ''/index.html''
* ''/directory/image.jpg''
|}

Funktionsergebnis ist der Inhalt der aufgerufenen Seite in Form einer Zeichenkette.

=== GetFileFromURL ===
Die Funktion GetFileFromURL ruft die HTTP-URL auf und gibt als Funktionsergebnis den Seiteninhalt zurück. Im Gegensatz zu GetHttpFile beinhaltet GetFileFromURL einige Zusatzoptionen in Form von Funktionsparametern.

'''Aufruf: <code>GetFileFromURL($url, ''[$timeout], [$data], [$noshutdown], [$loglevel]'')</code>'''

{| class="wikitable"
|-
! Parameter!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$url</code>'''

''mandatory''
|| Die HTTP-URL, welche aufgerufen werden soll. Diese kann optional Usernamen, Passwort und einen Port enthalten. Sowohl HTTP als auch HTTPS wird hierbei unterstützt.<br>
Beispiel:

* ''<nowiki>http://www.myhost.com/directory/</nowiki>''
* ''<nowiki>https://www.myhost.com/</nowiki>''
* ''<nowiki>http://www.myhost.com:8080/</nowiki>''
* ''<nowiki>http://user:password@www.myhost.com/</nowiki>''

'''WICHTIG:''' Falls ein Username sowie Passwort übergeben werden, so müssen diese vorher jeweils mittels [[#urlEncode|urlEncode()]] in URL-kompatible Form umgewandelt werden um Probleme mit evtl. enthaltenen Sonderzeichen zu vermeiden.
|-
| style="vertical-align:top" | '''<code>$timeout</code>'''

''optional''
|| Die maximale Dauer in Sekunden für die HTTP-Anfrage

Beispiel: 5 ''(Sekunden)''

Standardwert: 4 Sekunden
|-
| style="vertical-align:top" | '''<code>$data</code>'''

''optional''
|| Wenn man Daten via HTTP-POST übertragen möchte, so kann man die Nutzdaten über $data übergeben. Die Daten werden dabei als Formulardaten übertragen. Wenn man den Content-Type beeinflussen oder mehrere Formular-Felder senden möchte, sollte man zur Funktion HttpUtils_BlockingGet oder HttpUtils_NonblockingGet greifen.

Standardwert: ''[leer]''

|-
| style="vertical-align:top" | '''<code>$noshutdown</code>'''

''optional''
|| Wenn $noshutdown auf 1 gesetzt ist, wird dem HTTP-Server nicht implizit mitgeteilt, dass die Verbindung nach dem Request geschlossen werden soll. Viele Webserver schließen in solch einem Fall die Verbindung, bevor sie die Antwort senden. Bei 0 wird dem Webserver mitgeteilt, dass der Sendevorgang beendet ist und nun die Antwort abgewartet wird.

Standardwert: 1
|-
| style="vertical-align:top" | '''<code>$loglevel</code>'''

''optional''
|| Das [[verbose|Loglevel]], in dem sämtliche Logmeldungen zu dieser HTTP-Abfrage erzeugt werden sollen.

Standardwert: 4
|}

Funktionsergebnis ist der Inhalt der aufgerufenen Seite in Form eines Strings.

=== GetFileFromURLQuiet ===
Diese Funktion funktioniert ähnlich wie GetFileFromURL. Allerdings wird die tatsächliche URL in allen erzeugten Log-Meldungen unkenntlich gemacht um z.B. Zugangsdaten nicht preiszugeben. Die aufgerufene Seite wird ebenfalls als Funktionsergebnis zurückgegeben.

'''Aufruf: <code>GetFileFromURLQuiet($url, ''[$timeout], [$data], [$noshutdown], [$loglevel]'')</code>'''

{| class="wikitable"
|-
! Parameter!! Bedeutung
|-
| style="vertical-align:top" | '''<code>$url</code>'''

''mandatory''
|| Die HTTP-URL, welche aufgerufen werden soll. Diese kann optional Usernamen, Passwort und einen Port enthalten. Sowohl HTTP als auch HTTPS wird hierbei unterstützt.<br>
Beispiel:

* ''<nowiki>http://www.myhost.com/directory/</nowiki>''
* ''<nowiki>https://www.myhost.com/</nowiki>''
* ''<nowiki>http://www.myhost.com:8080/</nowiki>''
* ''<nowiki>http://user:password@www.myhost.com/</nowiki>''

'''WICHTIG:''' Falls ein Username sowie Passwort übergeben werden, so müssen diese vorher jeweils mittels [[#urlEncode|urlEncode()]] in URL-kompatible Form umgewandelt werden um Probleme mit evtl. enthaltenen Sonderzeichen zu vermeiden.
|-
| style="vertical-align:top" | '''<code>$timeout</code>'''

''optional''
|| Die maximale Dauer in Sekunden für die HTTP-Anfrage

Beispiel: 5 ''(Sekunden)''

Standardwert: 4 Sekunden
|-
| style="vertical-align:top" | '''<code>$data</code>'''

''optional''
|| Wenn man Daten via HTTP-POST übertragen möchte, so kann man die Nutzdaten über <code>$data</code> übergeben. Die Daten werden dabei als Formulardaten übertragen. Wenn man den Content-Type beeinflussen möchte, oder mehrere Formular-Felder senden möchte, sollte man zur Funktion HttpUtils_BlockingGet oder HttpUtils_NonblockingGet greifen.

Standardwert: ''[leer]''

|-
| style="vertical-align:top" | '''<code>$noshutdown</code>'''

''optional''
|| Wenn $noshutdown auf 1 gesetzt ist, wird dem HTTP-Server nicht implizit mitgeteilt, dass die Verbindung nach dem Request geschlossen werden soll. Viele Webserver schließen in solch einem Fall die Verbindung bevor, sie die Antwort senden. Bei 0 wird dem Webserver mitgeteilt, dass der Sendevorgang beendet ist und nun die Antwort abgewartet wird.

Standardwert: 1
|-
| style="vertical-align:top" | '''<code>$loglevel</code>'''

''optional''
|| Das Loglevel, in dem sämtliche Logmeldungen zu dieser HTTP-Abfrage erzeugt werden sollen.

Standardwert: 4
|}

Funktionsergebnis ist der Inhalt der aufgerufenen Seite in Form eines Strings.

=== HttpUtils_BlockingGet ===
Wenn die bisher genannten Funktionen nicht ausreichen um die gewünschte Abfrage durchzuführen, so kann man diese Funktion verwenden. Aufgrund zahlreicher Parameter ermöglicht sie viele Anpassungsmöglichkeiten. Diese Funktion hat dabei nicht wie üblich eine Liste an Funktionsparametern, sondern lediglich einen Parameter, welcher eine Hashreferenz mit allen Funktionsparametern darstellt. Dieser Hash enthält sämtliche Parameter inkl. Werten.

'''Aufruf: <code>HttpUtils_BlockingGet($param)</code>'''

Der Parameter $param ist eine Referenz auf eine Hash-Struktur, welche die einzelnen Parameter enthält. Der Hash $param kann folgende Optionen beinhalten:

{| class="wikitable"
|-
! style="width:175px" | Parameter !! style="width:auto" | Bedeutung
|-
| style="vertical-align:top" | '''<code>$param->{url}</code>'''

''mandatory''
|| Die HTTP-URL, welche aufgerufen werden soll. Diese kann optional Usernamen, Passwort und einen Port enthalten. Sowohl HTTP als auch HTTPS wird hierbei unterstützt.<br>
Beispiel:

* ''<nowiki>http://www.myhost.com/directory/</nowiki>''
* ''<nowiki>https://www.myhost.com/</nowiki>''
* ''<nowiki>http://www.myhost.com:8080/</nowiki>''
* ''<nowiki>http://user:password@www.myhost.com/</nowiki>''

'''WICHTIG:''' Alternativ können die Zugangsdaten auch in <code>$param->{user}</code> und <code>$param->{pwd}</code> übergeben werden. Falls Username und Passwort in der URL übergeben werden, so müssen diese vorher jeweils mittels [[#urlEncode|urlEncode()]] in URL-kompatible Form umgewandelt werden um Probleme mit evtl. enthaltenen Sonderzeichen (z.B. ":" und "@") zu vermeiden, da sonst die URL nicht mehr einer validen Syntax entspricht.
|-
| style="vertical-align:top" |'''<code>$param->{timeout}</code>'''

''optional''
|| Die maximale Dauer in Sekunden bis der Server eine Antwort liefern muss. Andernfalls wird der Request mit einer Fehlermeldung abgebrochen.

Beispiel: 5 ''(Sekunden)''

Standardwert: 4 Sekunden
|-
| style="vertical-align:top" |'''<code>$param->{data}</code>'''

''optional''
|| Wenn man Daten via HTTP-POST übertragen möchte, so kann man die Nutzdaten über <code>$param->{data}</code> übergeben. Die Daten werden dabei als Formulardaten übertragen. Die Daten können dabei auf zwei Arten übergeben werden:

1. Daten als Zeichenkette:
:* Die Daten werden komplett als gesamte Zeichenkette in <code>$param->{data}</code> abgelegt (z.B.: <code>$param->{data} = "Jede Menge tolle Daten"</code>).
2. Daten als Hash-Struktur:
:* Die Daten werden als Hash mit Key-Value-Pairs übergeben (z.B.: <code>$param->{data}{field1} = "value1", $param{data}{field2} = "value2", ...</code> ). Die Daten werden dann als Formulardaten mit mehrfachen Datenfeldern übertragen.

Standardwert: ''[leer]''

|-
| style="vertical-align:top" | '''<code>$param->{user}</code>'''

''optional''
||Im Falle einer notwendigen HTTP-Authentifizierung, der zu benutzende Username um sich gegenüber dem Server zu identifizieren. Alternativ kann der Username und das Passwort auch direkt in der URL mitgegeben werden (siehe jedoch <code>$param->{hideurl}</code>).

Standardwert: ''[leer]''
|-
| style="vertical-align:top" | '''<code>$param->{pwd}</code>'''

''optional''
||Im Falle einer notwendigen HTTP-Authentifizierung, das zu benutzende Passwort um sich gegenüber dem Server zu identifizieren. Alternativ kann der Username und das Passwort auch direkt in der URL mitgegeben werden (siehe jedoch <code>$param->{hideurl}</code>).
Standardwert: ''[leer]''
|-
| style="vertical-align:top" | '''<code>$param->{noshutdown}</code>'''

''optional''
||Wenn <code>$param->{noshutdown}</code> auf 1 gesetzt ist, wird dem HTTP-Server nicht implizit mitgeteilt, dass die Verbindung nach dem Request geschlossen werden soll. Viele Webserver schließen in solch einem Fall die Verbindung, bevor sie die Antwort senden. Bei 0 wird dem Webserver mitgeteilt, dass der Sendevorgang beendet ist und nun die Antwort abgewartet wird.

Standardwert: 1
|-
| style="vertical-align:top" | '''<code>$param->{loglevel}</code>'''

''optional''
|| Das Loglevel, in dem sämtliche Logmeldungen zu dieser HTTP-Abfrage erzeugt werden sollen.

Standardwert: 4
|-
| style="vertical-align:top" | '''<code>$param->{hideurl}</code>'''

''optional''
|| Wenn dieser Parameter den Wert 1 trägt, wird die gesamte URL in sämtlichen Log-Ausgaben unkenntlich gemacht. Dies notwendig, wenn z.B. Zugangsdaten direkt in der URL angegeben wurden, oder die URL ein geheimes Token oder andere schützenswerte Informationen enthält.

Standardwert: 0
|-
| style="vertical-align:top" | '''<code>$param->{ignoreredirects}</code>'''

''optional''
|| Wenn dieser Parameter den Wert 1 trägt, werden Umleitungen durch den Server ignoriert und der Request beendet. Dies kann erforderlich sein um evtl. Cookies aus der Antwort, welche eine Umleitung enthält aus dem HTTP Header zu extrahieren um diese im nächsten Request weiterzuverwenden.

Standardwert: 0
|-
| style="vertical-align:top" | '''<code>$param->{method}</code>'''

''optional''
||Die HTTP-Methode, welche zur Abfrage verwendet werden soll. Sofern keine Daten übertragen werden ist dies standardmäßig "GET", ansonsten "POST". Es können aber auch andere Methoden verwendet werden.

Standardwert: "GET"
|-
| style="vertical-align:top" | '''<code>$param->{keepalive}</code>'''

''optional''
||Wenn dieser Parameter auf 1 gesetzt ist, wird dem Server der Wunsch mitgeteilt, die Verbindung offen zu lassen für weitere Anfragen. Sobald die Antwort auf den jeweiligen Request eintrifft, bleibt die TCP-Verbindung bestehen (sofern der Server dies unterstützt). Anschließend kann man den Parameter-Hash mit einer neuen URL und Optionen füllen. Der Parameter "keepalive" sollte dabei weiterhin gesetzt bleiben, sofern die Verbindung auch weiterhin möglichst erhalten bleiben soll.

Um eine offene Verbindung endgültig zu schließen, muss die Funktion [[HttpUtils#HttpUtils_Close|HttpUtils_Close]] aufgerufen werden.

Standardwert: 0
|-
| style="vertical-align:top" | '''<code>$param->{header}</code>'''

''optional''
|| Eigene HTTP-Header-Zeilen können über diesen Parameter eingebracht werden. Er kann dazu genutzt werden um z.B. den Content-Type festzulegen, oder einfach nur zusätzliche Header-Felder zu setzen. Es gibt zwei Möglichkeiten, diesen Parameter zu befüllen.

# Als '''Zeichenkette'''. Mehrere Header-Zeilen müssen dabei mit "\r\n" getrennt werden.
# Als '''Hash-Struktur'''. Hierbei findet eine Zuordnung von Header-Bezeichnung zum Wert als Key-Value-Pair statt.

Beispiel:
* <code>"User-Agent: Mozilla/1.22'''<u>\r\n</u>'''Content-Type: application/xml"</code>
* <code>"Content-Type: application/xml"</code>
* <code>{ "User-Agent" => "Mozilla/1.22", "Content-Type" => "application/xml" }</code>
* <code>{ "Content-Type" => "application/xml" }</code>

Standardwert: ''[leer]''
|-
| style="vertical-align:top" | '''<code>$param->{sslargs}</code>'''

''optional''
|| Eigene SSL-Optionen können über diesen Parameter eingebracht werden. Er kann dazu genutzt werden um z.B. die SSL-Zertifikats Verifikation abzuschalten. Die SSL-Optionen müssen als eigene Hash-Referenz übergeben werden. Eine Liste aller möglichen Optionen findet man in der Perl-Dokumentation zu [http://search.cpan.org/~sullr/IO-Socket-SSL-2.016/lib/IO/Socket/SSL.pod#Description_Of_Methods IO::Socket::SSL].

Beispiel:
* <code>$param->{sslargs} = { SSL_verify_mode => 0, sslOpt2 => 'sslVal2' }</code>

Standardwert: ''{ }''
|-
| style="vertical-align:top" | '''<code>$param->{httpversion}</code>'''

''optional''
|| Die HTTP-Version, welche zur Abfrage verwendet werden soll. Standardmäßig werden alle Abfragen mit HTTP/1.0 durchgeführt. Falls es jedoch notwendig ist HTTP/1.1 zu verwenden, so sollte <code>$param->{httpversion}</code> auf "1.1" gesetzt werden. Bei Version 1.1 wird automatisch der Header "<code>Connection: close</code>" implizit mitgesendet.

Standardwert: "1.0"
|-
| style="vertical-align:top" | '''<code>$param->{digest}</code>'''

''optional''
|| Wenn dieser Parameter den Wert 1 trägt, wird bei vorhandenen Authentifizierungsdaten (Username+Passwort) eine Authentifizierung via Digest-Verfahren nach RFC 2617<ref name="rfc2617">RFC 2617 - HTTP Authentication: Basic and Digest Access Authentication</ref> erwartet. Die Anmeldedaten werden dann nur verwendet, wenn dieser explizit eine HTTP Digest Authentifizierung einleitet. Ist dieser Parameter nicht gesetzt (Wert: 0), wird bei vorhandenen Authentifizierungsdaten immer eine HTTP Basic<ref name="rfc2617" /> Authentifizierung im Request mitgeschickt.

Standardwert: 0
|-
| style="vertical-align:top" | '''<code>$param->{compress}</code>'''

''optional''
|| Wenn dieser Parameter den Wert 1 trägt, wird dem Server die Verwendung von Komprimierung in Form GZIP oder alternativ Deflate<ref>RFC 1951 - DEFLATE Compressed Data Format Specification version 1.3</ref> zur Übertragung der Antwort ermöglicht. Die komprimierte Antwort wird dabei direkt durch HttpUtils.pm wieder dekomprimiert. Wird dieser Parameter auf den Wert 0 gesetzt, so wird keine Komrpimierung ermöglicht.

'''WICHTIG''': Die Verwendung von Komprimierung in HttpUtils.pm kann mit dem globalen Attribut "httpcompress" (Standardwert: 1) durch setzen auf 0 für die gesamte FHEM Installation durch den Nutzer deaktiviert werden. In diesem Fall ist der Parameter <code>$param->{compress} = 1</code> wirkungslos.

Standardwert: 1
|}

Als Rückgabewert von HttpUtils_BlockingGet wird ein Array mit zwei Rückgabewerten zurückgegeben:
:<code>($err, $data) = HttpUtils_BlockingGet( … )</code>
Diese zwei Rückgabewerte haben folgende Bedeutung:

{| class="wikitable"
|-
! Rückgabewert !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$err</code>'''|| Falls beim Aufruf der URL ein Fehler aufgetreten ist (z.B. Server nicht erreichbar oder Verbindungstimeout), dann ist dieser Wert mit einer Fehlermeldung gefüllt.

Wenn kein Fehler aufgetreten ist, ist dieser Wert mit einem Leerstring gefüllt (<code>$err = ""</code>)
|-
| style="vertical-align:top" | '''<code>$data</code>'''|| Die Ergebnisdaten, welche der HTTP-Server zurückgeliefert hat. Die Daten werden als Klartext in Form eines gesamten Strings zurückgegeben.

Falls ein Fehler aufgetreten ist, ist dieser Wert mit einem Leersting gefüllt (<code>$data = ""</code>)
|}

=== HttpUtils_NonblockingGet ===
{{Randnotiz|RNText=Die Funktion HttpUtils_NonblockingGet ist nicht komplett durchgehend "non-blocking". DNS-Abfragen sind weiterhin blockierend. Insbesondere wenn der DNS-Name nicht aufgelöst werden kann.}}
Diese Funktion arbeitet ähnlich wie HttpUtils_BlockingGet. Allerdings wird das Ergebnis nicht als Funktionsergebnis zurückgegeben. Die Funktion HttpUtils_NonblockingGet initiiert den Verbindungsaufbau und übergibt alles weitere an FHEM interne Routinen. Sobald eine Antwort vom HTTP-Server eintrifft, wird eine Callback-Funktion mit verschiedenen Parametern (unter anderem auch das Ergebnis) aufgerufen, um die Antwort entgegenzunehmen und weiter zu verarbeiten.

Der Aufruf ist daher ähnlich zu HttpUtils_BlockingGet mit nur einem Parameter-Hash:

'''Aufruf: <code>HttpUtils_NonblockingGet($param)</code>'''

{| class="wikitable"
|-
! style="width:175px" | Parameter !! style="width:auto" | Bedeutung
|-
| colspan="2" style="text-align:center" | '''''<br>Alle Hash-Parameter, welche für HttpUtils_BlockingGet gelten, sind auch für HttpUtils_NonblockingGet gültig'''''<br>
|-
| style="vertical-align:top" | '''<code>$param->{callback}</code>'''

''mandatory''
|| Eine Funktion (oder eine Referenz auf eine Funktion), welche die Ergebnisdaten entgegennimmt und die Antwort entsprechend weiterverarbeitet. Die Callback-Funktion muss dabei 3 Parameter erwarten. Die Funktionsparameter der Callback-Funktion werden im nachfolgenden Abschnitt näher erläutert.

Beispiel:
* <code>$param->{callback} = \&MyCallbackFn</code> — ''(Referenzzeiger auf Funktionsname)''
* <code>$param->{callback} = sub(){ … }</code> — ''(direkte Funktionsdefinition)''
|-
| style="vertical-align:top;white-space:nowrap;" | '''<code>$param->{incrementalTimeout}</code>'''

''optional''
|| Sofern gesetzt (Wert: <code>1</code>), wird der Timeout nach jedem Empfang von Teil-Daten wieder zurückgesetzt. So können größere Datenmengen von langsamen Sendern empfangen werden, ohne den Parameter <code>timeout</code> zu erhöhen und dadurch tatsächliche Verbindungsprobleme erst spät zu erkennen.

Standardwert: 0
|-
| style="vertical-align:top" | ''Benutzerdefinierte Parameter''
|| Es können im Hash weitere benutzerdefinierte Parameter gesetzt werden, welche evtl. in der Callback-Funktion benötigt werden, um die Antwort korrekt zu verarbeiten.

Zum Beispiel im Rahmen der Modul-Programmierung wäre das <code>$hash</code> der aktuellen Definition. Alle gesetzten Parameter sind in der Callback-Funktion wieder über <code>$param</code> direkt abrufbar und können ausgewertet werden.

Beispiel:
* <code>$param->{hash} = $hash</code>
* <code>$param->{command} = "on"</code>

|}

Ein Funktionsrückgabewert von HttpUtils_NonblockingGet existiert nicht, da die eigentliche Rückgabe der Daten über die Callback-Funktion erfolgt. Die Callback-Funktion wird aufgerufen, sobdald der HTTP-Request abgeschlossen ist, oder ein Fehler aufgetreten ist. Der Funktionsaufruf erfolgt mit den folgenden Parametern:

<code> ''MyCallbackFn'' ( $param, $err, $data )</code>

Diese 3 Parameter haben dabei folgende Bedeutung:

{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$param</code>''' || Der Parameter-Hash, mit allen Argumenten die beim Aufruf der Funktion übergeben worden sind.

Es ist möglich, dass der Parameter-Hash nach erfolgter Abfrage zusätzliche oder veränderte Elemente enthält:
* '''<code>$param->{redirects}</code>''' - Die Anzahl an Umleitungen die erfolgte, bis die Anfrage beantwortet wurde.
* '''<code>$param->{url}</code>''' - Die URL, die nach erfolgter Umleitung die Anfrage beantwortet hat.
* '''<code>$param->{protocol}</code>''' - Das verwendete Protokoll, welches zur Abfrage verwendet wurde ("http" oder "https").
* '''<code>$param->{path}</code>''' - Der Pfad, welcher auf dem HTTP-Server angefragt wurde.
* '''<code>$param->{host}</code>''' - Der Name oder die IP-Adresse des HTTP-Servers.
* '''<code>$param->{httpheader}</code>''' - Der gesamte HTTP Header, welcher der Server bei der letzten Antwort zurücklieferte.
* '''<code>$param->{code}</code>''' - Der HTTP-Statuscode, mit dem die Anfrage vom Server beantwortet wurde.
* '''<code>$param->{addr}</code>''' - Die HTTP-URL ohne Pfad und evtl. Authentifizerungsinformationen des HTTP-Servers (z.B. "<nowiki>http://myserver.com:8080</nowiki>").
* '''<code>$param->{auth}</code>''' - Ein Flag (0/1) ob Zugangsdaten für den Request zur Verfügung standen (durch Angabe in der URL oder direkt in <code>$param</code>).
|-
| style="vertical-align:top" | '''<code>$err</code>'''|| Falls beim Aufruf der URL ein Fehler aufgetreten ist (z.B. Server nicht erreichbar oder Verbindungstimeout), dann ist dieser Wert mit einer Fehlermeldung gefüllt.

Wenn kein Fehler aufgetreten ist, ist dieser Wert mit einem Leerstring gefüllt (<code>$err = ""</code>)
|-
| style="vertical-align:top" | '''<code>$data</code>'''|| Die Ergebnisdaten, welche der HTTP-Server zurückgeliefert hat. Die Daten werden als Klartext in Form eines gesamten Strings zurückgegeben. Es handelt sich hierbei ausschließlich um den HTTP-Body.

Falls ein Fehler aufgetreten ist, ist dieser Wert mit einem Leersting gefüllt (<code>$data = ""</code>)
|}

Die Callback-Funktion kann nun die Daten aus der HTTP-Antwort verarbeiten oder bei Fehlern entsprechende Log-Meldungen ausgeben.

==== Beispiel #1 für HttpUtils_NonblockingGet() für Modulprogrammierer ====
Das folgende Beispiel soll eine Hilfestellung für eigene Anwendungen geben

<syntaxhighlight lang="perl">use HttpUtils;
sub X_PerformHttpRequest($)
{
my ($hash, $def) = @_;
my $name = $hash->{NAME};
my $param = {
url => "http://www.foo.de/",
timeout => 5,
hash => $hash, # Muss gesetzt werden, damit die Callback funktion wieder $hash hat
method => "GET", # Lesen von Inhalten
header => "User-Agent: TeleHeater/2.2.3\r\nAccept: application/json", # Den Header gemäß abzufragender Daten ändern
callback => \&X_ParseHttpResponse # Diese Funktion soll das Ergebnis dieser HTTP Anfrage bearbeiten
};

HttpUtils_NonblockingGet($param); # Starten der HTTP Abfrage. Es gibt keinen Return-Code.
}

sub X_ParseHttpResponse($)
{
my ($param, $err, $data) = @_;
my $hash = $param->{hash};
my $name = $hash->{NAME};

if($err ne "") # wenn ein Fehler bei der HTTP Abfrage aufgetreten ist
{
Log3 $name, 3, "error while requesting ".$param->{url}." - $err"; # Eintrag fürs Log
readingsSingleUpdate($hash, "fullResponse", "ERROR", 0); # Readings erzeugen
}

elsif($data ne "") # wenn die Abfrage erfolgreich war ($data enthält die Ergebnisdaten des HTTP Aufrufes)
{
Log3 $name, 3, "url ".$param->{url}." returned: $data"; # Eintrag fürs Log

# An dieser Stelle die Antwort parsen / verarbeiten mit $data

readingsSingleUpdate($hash, "fullResponse", $data, 0); # Readings erzeugen
}

# Damit ist die Abfrage zuende.
# Evtl. einen InternalTimer neu schedulen
}</syntaxhighlight>

==== Beispiel #2 eines Snippets um eine Datei herunterzuladen und lokal zu speichern ====
Dieses vollständige Beispiel eines Device verwendet <code>HttpUtils_NonblockingGet()</code> um eine Datei herunterzuladen und im lokalem Dateisystem mit den Rechten des FHEM Nutzers zu speichern.<syntaxhighlight lang="perl" line="1">
defmod MyDownloader dummy
attr MyDownloader userattr FilePath
attr MyDownloader comment '\
Beispiel:\
set MyDownloader job Filepath="/opt/fhem/www/Dateiname.bin" https://example.com/datei.bin\
'
attr MyDownloader readingList job
attr MyDownloader setList job
attr MyDownloader userReadings result:job:.* {\
my $hash = $defs{$name};;\
my $job = ReadingsVal($name, "job", 'https://fhem.de/www/images/default/fhemicon.png');;\
my $path = AttrVal($name, "Filepath", "/opt/fhem/www/download.bin");;\
\
if ($job =~ s/(?:Filepath|Dateipfad)="(.*?)"//) {\
$path = $1;;\
}\
\
my $fnFct = sub {\
my ($param, $err, $data) = @_;;\
\
my $len = $data ? length($data) : 0;;\
my $error = $err ? $err : FileWrite($path, $data);;\
\
readingsBeginUpdate($hash);;\
readingsBulkUpdate($hash, "busy", 0, 1);;\
readingsBulkUpdate($hash, "result", "saved $len Bytes", 1) if !$error;;\
readingsBulkUpdate($hash, "result", "error ($error, $err)", 1) if $error;;\
readingsEndUpdate($hash, 1);;\
};;\
\
if ( ReadingsVal($name, "busy", 0) == 0 ) {\
readingsBulkUpdate($hash, "busy", 1, 1);;\
$job =~ s/^\s+|\s+$//g;;\
my $param = {\
url => $job,\
timeout => 10,\
hash => $hash,\
method => "GET",\
callback => $fnFct\
};;\
HttpUtils_NonblockingGet($param);;\
return "download job started";;\
}\
\
return;;\
}
</syntaxhighlight>
Zugehöriger Forumspost: {{Link2Forum|Topic=143117|LinkText=Datei herunterladen, Downloader, HttpUtils_NonblockingGet}}

=== HttpUtils_Close ===
Für den Abbruch von offenen Verbindungen und noch laufenden NonBockingGet-Aufrufen gibt es die Funktion HttpUtils_Close. Diese kann z.B. beim Löschen eines Devices oder Herunterfahren des Servers aufgerufen werden, um bestehende Verbindungen zu schliessen.

Wenn man den Parameter "keepalive" beim Aufruf von HttpUtils_NonBlockingGet/HttpUtils_BlockingGet gesetzt hat, muss man HttpUtils_Close aufrufen um die Verbindung tatsächlich zu schließen, da diese noch durch den Server offen gehalten werden kann.

'''Aufruf: <code>HttpUtils_Close($param)</code>'''

{| class="wikitable"
|-
! style="width:175px" | Parameter !! style="width:auto" | Bedeutung
|-
| style="vertical-align:top" | '''<code>$param</code>'''

''mandatory''
|| Der Hash, der beim vorherigen Aufruf an HTTPUtils Funktionen (HttpUtils_NonblockingGet oder HttpUtils_BlockingGet) übergeben wurde

|}

== Hilfsfunktionen ==

=== urlEncode ===

:<syntaxhighlight lang="perl">
$encoded = urlEncode($string);
</syntaxhighlight>
Die Funktion urlEncode() wandelt die übergebene Zeichenkette <code>$string</code> in eine URL-kompatible<ref name="rfc3986-2.1">[https://tools.ietf.org/html/rfc3986#section-2.1 RFC 3989] - Abschnitt 2.1 "Percent-Encoding"</ref> Zeichenkette um. Der Rückgabewert <code>$encoded</code> ist eine Zeichenkette welche innerhalb einer URL verwendet werden kann, bspw. als Wert eines GET-Parameters.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$string</code>'''

''mandatory''
|| Die Zeichenkette, welche in eine URL-kompatible Form umgewandelt werden soll.
|}

Rückgabewerte:
{| class="wikitable"
|-
! Rückgabewert !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$encoded </code>''' || Die URL-kompatible Version der übergebenen Zeichenkette. Problematische Zeichen sind in diesem Wert durch ein Prozentzeichen gefolgt von der Hexadezimaldarstellung des Zeichens dargestellt.

Bsp:
* "a: b" => "a%3a%20b"
* "a/b" => "a%2fb"
|}

=== urlDecode ===

:<syntaxhighlight lang="perl">
$string = urlDecode($encoded);
</syntaxhighlight>
Die Funktion urlDecode () normalisiert die übergebene Zeichenkette <code>$encoded</code> und ersetzt dabei sämtliche Hexadezimaldarstellungen<ref name="rfc3986-2.1" /> (eingeleitet mit einem Prozentzeichen) durch die entsprechenden Zeichen. Der Rückgabewert <code>$string</code> ist eine Zeichenkette welche keinerlei Hexadezimaldarstellungen mehr aufweist.

Parameter:
{| class="wikitable"
|-
! Parameter !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$encoded</code>'''

''mandatory''
|| Eine Zeichenkette, welche URL-kombatible Hexadezimaldarstellungen enthält.
|}

Rückgabewerte:
{| class="wikitable"
|-
! Rückgabewert !! Bedeutung
|-
| style="vertical-align:top" | '''<code>$string</code>''' || Die normale Version der übergebenen Zeichenkette. Sämtliche Hexadezimalddarstellungen sind in ihre entsprechenden Zeichen umgewandelt.

Bsp:
* "a%3a%20b" => "a: b"
* "a%2fb" => "a/b"
|}

== Referenzen ==
<references />

FritzBoxUtils

2026-01-12T19:14:57Z

Ph1959de: (Ober)Kategorie entfernt

{{Infobox Modul
|ModPurpose=Hilfsfunktionen zur Unterstützung von Fritz!Box Geräten in FHEM
|ModType=u
|ModForumArea=FRITZ!Box
|ModTechName=FritzBoxUtils.pm
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
}}
Das "Modul" [[FritzBoxUtils]](.pm) stellt eine Reihe von Funktionen zur Verfügung, die für die Anbindung von Fritz!Box Geräten des Herstellers AVM an FHEM benötigt werden bzw. benutzt werden können.

== Verwendung ==
Funktionen aus FritzBoxUtils werden z.B. verwendet oder beschrieben in:
* [[Fritzbox: WLAN ein/ausschalten]]
* [[Callmonitor mit Anruferliste und Zusatzfunktionen]]
* [[E-Mail senden]]

== Links ==
* ...

[[Kategorie:FritzBox]]

LandroidUtils

2026-01-12T19:11:15Z

Ph1959de: Kategorie "Development" entfernt, da nicht zutreffend

{{Infobox Modul
|ModPurpose=Hilfsfunktionen für Mähroboter
|ModType=u
|ModForumArea=MQTT
|ModTechName=LandroidUtils.pm
|ModOwner=rudolfkoenig ({{Link2FU|8|Forum}} / [[Benutzer Diskussion:Rudolfkoenig|Wiki]])
frober ({{Link2FU|8261|Forum}} / [[Benutzer Diskussion:frober|Wiki]])
}}
Das "Modul" [[LandroidUtils]](.pm) stellt eine Reihe von Funktionen zur Verfügung, die für die Anbindung bestimmter Mähroboter an FHEM benötigt werden.

== Verwendung ==
Die Verwendung der verfügbaren Funktionen ist (z.B.) beschrieben in:
* [[Mähroboter: Worx Landroid, Kress, Landxcape]]

== Links ==
* Forenthema {{Link2Forum|Topic=111959|LinkText=MQTT2 für Worx Landroid Mähroboter}}

[[Kategorie:Mähroboter]]

Solaranlage Komplettbeispiel Fronius BYD

2026-01-12T18:09:02Z

Ph1959de: Typo

==Einbindung eines Fronius-Wechselrichters, BYD-Speicher, SolarForecast, evcc-Autoladen und FTUI 2 Darstellung in FHEM==
[[Datei:Screenshot 2024-11-14 164746.jpg|mini|Übersicht]]
Dies Wiki beschreibt die beispielhafte Einbindung einer Solaranlage in FHEM. (Stand 02.01.2026)

Alle Module zur Steuerung der Komponenten sind bereits in FHEM vorhanden bzw. werden gerade weiterentwickelt.

Ein Wechselrichter der Fa Fronius aus Österreich sowie der China-Speicher von BYD sind oft die Grundeinheiten einer Einfamilienhauslösung.

Alle notwendigen Readings werden über die vorhandenen Module speziell für dies Paket über Userreadings erzeugt, so dass auch andere Erzeuger oder Speicher in das Grundkonstrukt übernommen werden können. Es gibt auch einen weiteren Grund für die Userreadings: Der Wechselrichter der Frima Fronius erzeugt einige Daten in relativ langen Zeitabständen (>10 Min) so dass diese z.B. nicht für Intergrale zur Leistungsanzeige benutzt werden können.

Diese Beispielanlage besteht aus 4 Strings. Zwei sind an den Fronius WR und zwei weitere an zwei Growatt 2KW WR angschlossen. Weiterhin gibt es einen zusätzlichen Fronius Prower Meter (1 Phasig) für die beiden Growatt WR.
[[Datei:Screenshot 20250612 192318 Fully Kiosk Browser.jpg|mini|ftui2 Übersicht]]

=== Vorbedingungen ===
FHEM läuft und hat genügend Platz für Logdaten (dBLog >5GB/Jahr wenn wirklich alles geloggt wird)

Der Wechselrichter sowie der Speicher sind über Lan oder eine sehr stabile(!) Wlan Verbindung erreichbar.

Von Wlan ist abzuraten, weil diese Verbindungen oftmals zu lange Zeitverzögerungen oder auch kurzzeitige Unterbrechungen haben. Es läuft mit Wlan-- aber oft nicht stabil genug. Der Aufbau eines Lan zu weiter entfernten Einheiten ist u.U. aufwändig, lohnt aber immer.

Alle Daten werden über [[DbLog]] gespeichert und die Graphen daraus gewonnen.

Um die Kommunikation z.B. über Modbus zu ermöglichen, reicht es, wenn der Installateur die Modbus-Verbindung freischaltet . Man benötigt keineswegs das Technician-Passwort des WR.

Wenn Fahrzeugladen über eine Wallbox mit eingebunden werden soll, können geeignete Wallboxen das natürlich selbst steuern. Hier ist ein Beispiel für die Integration der Software EVCC die das Laden eines Fahrzeugs komfortabel steuert vorgestellt. Für diese SW (sie kann paralel z.B. mit FHEM auf einem PI laufen) ist für die meisten Wallboxen ein sog. Token erforderlich, der über Github pro Monat für 1$ gekauft werden muss.

=== Grundstruktur ===
* Der Wechselrichter wird über das Modul [[fronius]] ausgelesen, dabei werden diverse [[userReadings]] erzeugt.
* Zusätzlich werden über [[HTTPMOD]] weitere Daten ausgelesen, diese sind aber nicht für die Berechnungen notwendig.
* Der Speicher ist über den Wechselrichter per [[ModbusAttr]] erreichbar sowie auch direkt über das Modul [[BYDBox]].
* Daraus ergeben sich zusätzliche Darstellungen des Batteriezustands.
* Bezug, Einspeisung, Erzeugung und Hausverbrauch werden über vier [[ElectricityCalculator|ElectricityCalculator]] Devices erzeugt,
* diese Module erzeugen auch die gesammten Statistikdaten. (Heute, Gestern, Monat, Vormonat, Jahr)
* Zwei weitere Dummys plus Berechnungsroutinen erhalten die Daten Eigenverbrauchsquote und Autarkiegrad.
* Das sehr umfangreiche [[SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung|Modul SolarForecast]] wird integriert und es können viele Graphen dargestellt werden.
* Eine größere [[readingsGroup]] stellt die Gesamtstatistik der Anlage dar.
* Das optinonale Programm EVCC kann integriert und auch gesteuert werden.
* Einige FTUI2 Beispiele runden die Darstellung auf einem Tablet ab.

==Fronius_Symo in FHEM==
In FHEM wird das Modul fronius angelegt und darin diverse userReadings erzeugt, ebenso werden damit auch die Daten der zusätzlichen WR ausgelesen und addiert. '''Wichtig''': Es ist ein Autolade_Calculator in den userReadings vorhanden. Wenn der Abschnitt mit Autoladen nicht verwendet wird, bitte die Einträge entfernen. Die dienen nur der korrekten Berechnung und Anzeige des Hausverbrauchs (ohne Autoladen!).

Über Integrale werden einige Strommengen als laufend erhöhende Zähler erzeugt. Dies ist für die weitere Verarbeitung in den Modulen ElectricityCalculator (v.Sailor) erforderlich. Die Zähler sind auch im Fronius Datensatz enthalten, sie werden aber in Abständen >= 10->15 Minuten dort aktualisiert und sind somit für eine Wandanzeige ungeeignet.
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<syntaxhighlight lang="perl">
defmod Fronius_Symo fronius 192.168.xxx.xxx
attr Fronius_Symo DbLogExclude .*
attr Fronius_Symo DbLogInclude User_Consumed_E,Einspeisung,Bezug,Akku_Laden,Akku_Entladen,PowerFlow_Site_P_Grid,PowerFlow_Site_P_Load,Meter_1_PowerReal_P_Sum
attr Fronius_Symo IntervalRealtimeData 60
attr Fronius_Symo comment Auf dem Dach sind 15.6kWp installiert\
Str1: 7640W Süd+Carport\
Str2: 3480W Ost\
Grow1: 2200W West\
Grow2: 2320W GH\
userReadings User_Produced_FPV nur für SolarForecast
attr Fronius_Symo group Fronius
attr Fronius_Symo icon inverter
attr Fronius_Symo room Energie-Strom
attr Fronius_Symo stateFormat {return "Status: ".ReadingsVal($name,"state","")."<br>\\
PV-aktuell: ".sprintf("%.0f",ReadingsVal($name,"PowerFlow_Site_P_PV",0))." W<br>\\
PV Einspeisung: ".sprintf("%.0f",ReadingsVal($name,"Einspeisung",0))." W<br>\\
Netzbezug: ".sprintf("%.0f",ReadingsVal($name,"Bezug",0))." W<br>\\
Ladestand Akku: ".sprintf("%.0f",ReadingsVal($name,"Storage_0_Controller_StateOfCharge_Relative",0))." %<br>\\
PV gesamt: ".sprintf("%.2f",ReadingsVal($name,"PowerFlow_Site_E_Total",0)/1000)." kWh";;;;;;;;}
attr Fronius_Symo userReadings Einspeisung:PowerFlow_Site_P_Grid.* {ReadingsVal($name,"PowerFlow_Site_P_Grid","")<0?ReadingsVal($name,"PowerFlow_Site_P_Grid","")*-1:0},\
Neg_Einspeisung:PowerFlow_Site_P_Grid.* {ReadingsVal($name,"PowerFlow_Site_P_Grid","")<0?ReadingsVal($name,"PowerFlow_Site_P_Grid",""):0},\
Bezug:PowerFlow_Site_P_Grid.* {ReadingsVal($name,"PowerFlow_Site_P_Grid","")>0?ReadingsVal($name,"PowerFlow_Site_P_Grid",""):0},\
Akku_Laden:PowerFlow_Site_P_Akku.* {ReadingsVal($name,"PowerFlow_Site_P_Akku","")<0?ReadingsVal($name,"PowerFlow_Site_P_Akku","")*-1:0},\
Akku_Entladen:PowerFlow_Site_P_Akku.* {ReadingsVal($name,"PowerFlow_Site_P_Akku","")>0?ReadingsVal($name,"PowerFlow_Site_P_Akku",""):0},\
User_Produced_PV:PowerFlow_Site_P_PV.* integral {((ReadingsVal("$name","PowerFlow_Site_P_PV","0"))+(ReadingsVal($name,"Meter_1_PowerReal_P_Sum","0")))/3600000},\
User_Produced_FPV:PowerFlow_Site_P_PV.* integral {(ReadingsVal("$name","PowerFlow_Site_P_PV","0"))/3600000},\
User_Consumed_EN:PowerFlow_Site_P_PV.* {ReadingsVal($name,"PowerFlow_Site_P_PV","")+ReadingsVal($name,"Meter_1_PowerReal_P_Sum","")-(ReadingsVal("MQTT2_evcc1","Ladeleistung","")*1000)+ReadingsVal($name,"PowerFlow_Site_P_Grid","")+ReadingsVal($name,"PowerFlow_Site_P_Akku","")},\
User_Consumed_E:PowerFlow_Site_P_PV.* {ReadingsVal($name,"User_Consumed_EN","")>0?ReadingsVal($name,"User_Consumed_EN",""):0},\
User_Consumed_Energie_C:User_Consumed_E.* integral {ReadingsVal("$name","User_Consumed_E","0")/3600000},

</syntaxhighlight>
</div>
</div>

==FroniusPowerFlow==
Über HTTPMOD können zusätzlich aus dem Fronius '''Device String Werte''' ausgelesen (für FTUI Anzeigen z.B.)
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
defmod FroniusPowerFlow HTTPMOD http://192.168.xxx.xxx/solar_api/v1/GetPowerFlowRealtimeData.fcgi 10
attr FroniusPowerFlow userattr reading1Name reading1JSON
attr FroniusPowerFlow DbLogExclude .*
attr FroniusPowerFlow extractAllJSON 1
attr FroniusPowerFlow group Fronius
attr FroniusPowerFlow icon inverter
attr FroniusPowerFlow room Energie-Strom
attr FroniusPowerFlow stateFormat Leistung: PV_Produktion W
attr FroniusPowerFlow userReadings Neg_Einspeisung:Body_Data_Site_P_Grid.* {ReadingsVal($name,"Body_Data_Site_P_Grid","")<0?ReadingsVal($name,"Body_Data_Site_P_Grid",""):0},\
Bezug:Body_Data_Site_P_Grid.* {ReadingsVal($name,"Body_Data_Site_P_Grid","")>0?ReadingsVal($name,"Body_Data_Site_P_Grid",""):0},\
Akku_Laden:Body_Data_Site_P_Akku.* {ReadingsVal($name,"Body_Data_Site_P_Akku","")<0?ReadingsVal($name,"Body_Data_Site_P_Akku","")*-1:0},\
Akku_Entladen:Body_Data_Site_P_Akku.* {ReadingsVal($name,"Body_Data_Site_P_Akku","")>0?ReadingsVal($name,"Body_Data_Site_P_Akku",""):0},\
PV_Produktion:Body_Data_Site_P_Grid.* {((ReadingsVal("$name","Body_Data_Site_P_PV","0"))+(ReadingsVal("Fronius_Symo","Meter_1_PowerReal_P_Sum","0")))}
</pre>
</div>
</div>

== PV_Batterie ==
Per [[ModbusAttr]] werden Daten der Batterie aus dem Fronius gelesen und es können auch Einstellungen daran vorgenommen werden

min SOC Winter/Sommer oder auch das Verhindern einer Sofortentladung bei Anschluss eines Fahrzeugs zur Aufladung....
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
defmod PV_Batterie ModbusAttr 1 10 192.168.xxx.xxx:502 TCP
attr PV_Batterie DbLogExclude .*
attr PV_Batterie DbLogInclude DCPowerMPPT1,DCPowerMPPT2
attr PV_Batterie dev-h-combine 125
attr PV_Batterie dev-h-defFormat %.1f
attr PV_Batterie dev-h-defLen 2
attr PV_Batterie dev-h-defPoll 1
attr PV_Batterie dev-h-defUnpack f>
attr PV_Batterie devStateStyle style="text-align:right"
attr PV_Batterie disable 0
attr PV_Batterie event-min-interval ACActEnergy:7200,ACPower:7200,Battery.*:7200
attr PV_Batterie event-on-change-reading .*Energy:0.1,ACPower:1,DCPowerMPPT.*:1,status,Battery.*charge.*:1,BatteryState
attr PV_Batterie group Fronius
attr PV_Batterie icon measure_battery_100
attr PV_Batterie obj-h40073-reading ACCurrentPhaseA
attr PV_Batterie obj-h40075-reading ACCurrentPhaseB
attr PV_Batterie obj-h40077-reading ACCurrentPhaseC
attr PV_Batterie obj-h40085-reading ACVoltagePhaseA
attr PV_Batterie obj-h40087-reading ACVoltagePhaseB
attr PV_Batterie obj-h40089-reading ACVoltagePhaseC
attr PV_Batterie obj-h40091-format %.0f
attr PV_Batterie obj-h40091-reading ACPower
attr PV_Batterie obj-h40093-reading ACFrequency
attr PV_Batterie obj-h40109-reading CabinetTemperature
attr PV_Batterie obj-h40117-format %s
attr PV_Batterie obj-h40117-len 1
attr PV_Batterie obj-h40117-map 1:off,2:sleeping,3:starting,4:active,5:throttled,6:shutdown,7:fault,8:standby
attr PV_Batterie obj-h40117-reading status
attr PV_Batterie obj-h40117-unpack n
attr PV_Batterie obj-h40196-expr $val / 1000
attr PV_Batterie obj-h40196-format %.2f
attr PV_Batterie obj-h40196-len 4
attr PV_Batterie obj-h40196-reading ACActEnergy
attr PV_Batterie obj-h40196-unpack Q>
attr PV_Batterie obj-h40267-format %d
attr PV_Batterie obj-h40267-group 1-1
attr PV_Batterie obj-h40267-len 1
attr PV_Batterie obj-h40267-reading DCPowerScale
attr PV_Batterie obj-h40267-unpack s>
attr PV_Batterie obj-h40284-expr $val * 10 ** ReadingsVal($name, 'DCPowerScale', 1)
attr PV_Batterie obj-h40284-group 1-2
attr PV_Batterie obj-h40284-len 1
attr PV_Batterie obj-h40284-reading DCPowerMPPT1
attr PV_Batterie obj-h40284-unpack n
attr PV_Batterie obj-h40304-expr $val * 10 ** ReadingsVal($name, 'DCPowerScale', 1)
attr PV_Batterie obj-h40304-group 1-3
attr PV_Batterie obj-h40304-len 1
attr PV_Batterie obj-h40304-reading DCPowerMPPT2
attr PV_Batterie obj-h40304-unpack n
attr PV_Batterie obj-h40324-expr $val * 10 ** ReadingsVal($name, 'DCPowerScale', 1)
attr PV_Batterie obj-h40324-group 1-4
attr PV_Batterie obj-h40324-len 1
attr PV_Batterie obj-h40324-reading BatteryChargeWatt
attr PV_Batterie obj-h40324-unpack n
attr PV_Batterie obj-h40325-expr $val/1000000
attr PV_Batterie obj-h40325-ignoreExpr $val < 100
attr PV_Batterie obj-h40325-len 2
attr PV_Batterie obj-h40325-poll 300
attr PV_Batterie obj-h40325-reading Summe_Ladung
attr PV_Batterie obj-h40325-unpack N
attr PV_Batterie obj-h40344-expr $val * 10 ** ReadingsVal($name, 'DCPowerScale', 1)
attr PV_Batterie obj-h40344-group 1-5
attr PV_Batterie obj-h40344-len 1
attr PV_Batterie obj-h40344-reading BatteryDischargeWatt
attr PV_Batterie obj-h40344-unpack n
attr PV_Batterie obj-h40345-expr $val/1000000
attr PV_Batterie obj-h40345-ignoreExpr $val < 100
attr PV_Batterie obj-h40345-len 2
attr PV_Batterie obj-h40345-poll 300
attr PV_Batterie obj-h40345-reading Summe_Entladung
attr PV_Batterie obj-h40345-unpack N
attr PV_Batterie obj-h40355-len 1
attr PV_Batterie obj-h40355-reading BatConfigMaxReferenceWatt
attr PV_Batterie obj-h40355-unpack n
attr PV_Batterie obj-h40358-format %s
attr PV_Batterie obj-h40358-len 1
attr PV_Batterie obj-h40358-map 0:none,1:chargeMax,2:dischrMax,3:bothMax
attr PV_Batterie obj-h40358-reading BatConfigMaxEnabled
attr PV_Batterie obj-h40358-set 1
attr PV_Batterie obj-h40358-unpack n
attr PV_Batterie obj-h40360-expr $val / 100
attr PV_Batterie obj-h40360-format %.0f
attr PV_Batterie obj-h40360-len 1
attr PV_Batterie obj-h40360-poll 60
attr PV_Batterie obj-h40360-reading BatConfigReserve
attr PV_Batterie obj-h40360-set 1
attr PV_Batterie obj-h40360-setexpr $val * 100
attr PV_Batterie obj-h40360-unpack n
attr PV_Batterie obj-h40361-expr $val / 100
attr PV_Batterie obj-h40361-len 1
attr PV_Batterie obj-h40361-reading BatteryChargePercent
attr PV_Batterie obj-h40361-unpack n
attr PV_Batterie obj-h40364-format %s
attr PV_Batterie obj-h40364-len 1
attr PV_Batterie obj-h40364-map 1:off,2:empty,3:discharging,4:charging,5:full,6:holding,7:testing
attr PV_Batterie obj-h40364-reading BatteryState
attr PV_Batterie obj-h40364-unpack n
attr PV_Batterie obj-h40365-expr $val / 10000 * ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1)
attr PV_Batterie obj-h40365-len 1
attr PV_Batterie obj-h40365-max ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1)
attr PV_Batterie obj-h40365-min -ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1)
attr PV_Batterie obj-h40365-reading BatConfigMaxDischargeWatt
attr PV_Batterie obj-h40365-set 1
attr PV_Batterie obj-h40365-setexpr $val / ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1) * 10000
attr PV_Batterie obj-h40365-unpack s>
attr PV_Batterie obj-h40366-expr $val / 10000 * ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1)
attr PV_Batterie obj-h40366-len 1
attr PV_Batterie obj-h40366-max ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1)
attr PV_Batterie obj-h40366-min -ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1)
attr PV_Batterie obj-h40366-reading BatConfigMaxChargeWatt
attr PV_Batterie obj-h40366-set 1
attr PV_Batterie obj-h40366-setexpr $val / ReadingsVal($name, 'BatConfigMaxReferenceWatt', 1) * 10000
attr PV_Batterie obj-h40366-unpack s>
attr PV_Batterie room Energie-Strom
attr PV_Batterie stateFormat Status: BatteryState <br/>\
Ladung: BatteryChargePercent % | Reserve: BatConfigReserve %<br/>\
Summe Entladung: Summe_Entladung kWh | Summe Ladung: Summe_Ladung kWh<br/>

</pre>
</div>
</div>

==myBYDBox==
Das Modul BYDBox ermöglicht es, direkt aus der Batterie einzelne Zelldaten auszulesen. Das geht natürlich nur, wenn der Speicher direkt über LAN am Netzwerk angebunden ist. Um ein den Kontakt mit dem Hersteller in China zu unterbinden, kann diese Verbindung Problemlos im Hausnetz z.B. mittels einer Kindersicherung versehen werden. Die Kombi Fronius -> BYD-Box funktioniert damit einwandfrei weil deren nötige Kommunikation mit dem Wechselrichter über Modbus-Kabel erfolgt.

'''Achtung''': IP der BYD-Box nehmen, nicht die vom Fronius!
<syntaxhighlight lang="perl">define myBYDBox BYDBox 192.168.xxx.xxx 60
attr myBYDBox DbLogExclude .*
attr myBYDBox detail-level 1
attr myBYDBox disable 0
attr myBYDBox room Energie-Strom
attr myBYDBox verbose 0</syntaxhighlight>

== BYD.Box_view ==
[[Datei:Screenshot 2024-11-14 164959.jpg|mini|BYD.Box_view]]Runde Darstellung der BYD Speicherwerte

Darstellung der Batterie über ein DOIF aus myBYDBox die ui_Table dazu genutzt<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
define BYD.Box_viev DOIF ##
attr BYD.Box_viev alias BYD.Box_viev
attr BYD.Box_viev room Energie-Strom
attr BYD.Box_viev uiTable {package ui_Table;;}\
"BYDB-Box"| ring2([myBYDBox:BatteryPower],-6000,6000,120,0,"W",200,[(0,120,500,90,6000,60)],"1,font-weight:normal",[myBYDBox:Battery_1_SOC],0,100,0,120,"%",undef,"1,font-weight:normal",undef,undef,"0,,1,0,1") |\
ring2([myBYDBox:BatteryCurrent],-20,20,120,0,"A",200,undef,"1,font-weight:normal",[myBYDBox:BatteryOutVoltage],300,400,0,120,"V",undef,"1,font-weight:normal",undef,undef,"0,,,0,1") |\
ring2([myBYDBox:Battery_1_MaxmVolt],2800,3500,120,0,"mV",200,undef,"1,font-weight:normal",[myBYDBox:Battery_1_MinmVolt],2800,3500,0,120,"mV",undef,"1,font-weight:normal") |\
ring2([myBYDBox:BatteryMaxTemp],10,30,120,0,"°C",200,undef,"1,font-weight:normal",[myBYDBox:BatteryMinTemp],10,30,0,120,"°C",undef,"1,font-weight:normal")
</pre>
</div>
</div>

== BYD_Cells ==
[[Datei:Screenshot 2024-11-14 165025.jpg|mini|BYD_Cells nach dem Laden]]
[[Datei:BYD-Cels.jpg|mini|Balancing nahezu abgeschlossen]]
Ladezustand der einzelnen Zellen einer BYD-Box über ein DOIF aus myBYDBox. Es sind vier oder fünf Zellengruppen definiert, ggf anpassen. Weiterhin ist das Cell Balancing des BMS zu erkennen. Erst einige Zeit nach Ende des Ladevorgangs ist die Energie nahezu gleich auf alle Zellen verteilt.<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
define BYD_Cells DOIF ##
attr BYD_Cells alias BYD_Cells
attr BYD_Cells room Energie-Strom
attr BYD_Cells uiTable {package ui_Table;;\
\
sub floor_round {\
my ($zahl)=@_;;\
return(POSIX::floor($zahl / 10) * 10) - 10;;\
}\
\
sub ceil_round {\
my ($zahl)=@_;;\
return(POSIX::ceil($zahl / 10) * 10) + 10;;\
}\
\
sub colorBYD {\
my ($zahl)=@_;;\
my $min = 2800;;\
my $max = 3550;;\
my $mid = 3000;;\
my $mid2 = 3400;;\
my $color_green = 120;;\
\
my $num = 0;;\
\
if($zahl >= $mid2 && $zahl < $max)\
{\
$num = $color_green - (($zahl-$mid2)/($max-$mid2) * $color_green);;\
}\
elsif($zahl < $mid)\
{\
$num = (($zahl-$min)/($mid-$min) * $color_green);;\
}\
elsif($zahl >= $mid)\
{\
$num = $color_green;;\
}\
\
return(POSIX::ceil($num));;\
}\
}\
\
cylinder_bars("BYD Modul 1",floor_round([myBYDBox:Battery_1_MinmVolt]),ceil_round([myBYDBox:Battery_1_MaxmVolt]),"mV",250,undef,undef,0,\
[myBYDBox:Battery_1_VoltsperCell_000],colorBYD([myBYDBox:Battery_1_VoltsperCell_000]),"0",\
[myBYDBox:Battery_1_VoltsperCell_001],colorBYD([myBYDBox:Battery_1_VoltsperCell_001]),"1",\
[myBYDBox:Battery_1_VoltsperCell_002],colorBYD([myBYDBox:Battery_1_VoltsperCell_002]),"2",\
[myBYDBox:Battery_1_VoltsperCell_003],colorBYD([myBYDBox:Battery_1_VoltsperCell_003]),"3",\
[myBYDBox:Battery_1_VoltsperCell_004],colorBYD([myBYDBox:Battery_1_VoltsperCell_004]),"4",\
[myBYDBox:Battery_1_VoltsperCell_005],colorBYD([myBYDBox:Battery_1_VoltsperCell_005]),"5",\
[myBYDBox:Battery_1_VoltsperCell_006],colorBYD([myBYDBox:Battery_1_VoltsperCell_006]),"6",\
[myBYDBox:Battery_1_VoltsperCell_007],colorBYD([myBYDBox:Battery_1_VoltsperCell_007]),"7",\
[myBYDBox:Battery_1_VoltsperCell_008],colorBYD([myBYDBox:Battery_1_VoltsperCell_008]),"8",\
[myBYDBox:Battery_1_VoltsperCell_009],colorBYD([myBYDBox:Battery_1_VoltsperCell_009]),"9",\
[myBYDBox:Battery_1_VoltsperCell_010],colorBYD([myBYDBox:Battery_1_VoltsperCell_010]),"10",\
[myBYDBox:Battery_1_VoltsperCell_011],colorBYD([myBYDBox:Battery_1_VoltsperCell_011]),"11",\
[myBYDBox:Battery_1_VoltsperCell_012],colorBYD([myBYDBox:Battery_1_VoltsperCell_012]),"12",\
[myBYDBox:Battery_1_VoltsperCell_013],colorBYD([myBYDBox:Battery_1_VoltsperCell_013]),"13",\
[myBYDBox:Battery_1_VoltsperCell_014],colorBYD([myBYDBox:Battery_1_VoltsperCell_014]),"14",\
[myBYDBox:Battery_1_VoltsperCell_015],colorBYD([myBYDBox:Battery_1_VoltsperCell_015]),"15") |\
\
cylinder_bars("BYD Modul 2",floor_round([myBYDBox:Battery_1_MinmVolt]),ceil_round([myBYDBox:Battery_1_MaxmVolt]),"mV",250,undef,undef,0,\
[myBYDBox:Battery_1_VoltsperCell_016],colorBYD([myBYDBox:Battery_1_VoltsperCell_016]),"0",\
[myBYDBox:Battery_1_VoltsperCell_017],colorBYD([myBYDBox:Battery_1_VoltsperCell_017]),"1",\
[myBYDBox:Battery_1_VoltsperCell_018],colorBYD([myBYDBox:Battery_1_VoltsperCell_018]),"2",\
[myBYDBox:Battery_1_VoltsperCell_019],colorBYD([myBYDBox:Battery_1_VoltsperCell_019]),"3",\
[myBYDBox:Battery_1_VoltsperCell_020],colorBYD([myBYDBox:Battery_1_VoltsperCell_020]),"4",\
[myBYDBox:Battery_1_VoltsperCell_021],colorBYD([myBYDBox:Battery_1_VoltsperCell_021]),"5",\
[myBYDBox:Battery_1_VoltsperCell_022],colorBYD([myBYDBox:Battery_1_VoltsperCell_022]),"6",\
[myBYDBox:Battery_1_VoltsperCell_023],colorBYD([myBYDBox:Battery_1_VoltsperCell_023]),"7",\
[myBYDBox:Battery_1_VoltsperCell_024],colorBYD([myBYDBox:Battery_1_VoltsperCell_024]),"8",\
[myBYDBox:Battery_1_VoltsperCell_025],colorBYD([myBYDBox:Battery_1_VoltsperCell_025]),"9",\
[myBYDBox:Battery_1_VoltsperCell_026],colorBYD([myBYDBox:Battery_1_VoltsperCell_026]),"10",\
[myBYDBox:Battery_1_VoltsperCell_027],colorBYD([myBYDBox:Battery_1_VoltsperCell_027]),"11",\
[myBYDBox:Battery_1_VoltsperCell_028],colorBYD([myBYDBox:Battery_1_VoltsperCell_028]),"12",\
[myBYDBox:Battery_1_VoltsperCell_029],colorBYD([myBYDBox:Battery_1_VoltsperCell_029]),"13",\
[myBYDBox:Battery_1_VoltsperCell_030],colorBYD([myBYDBox:Battery_1_VoltsperCell_030]),"14",\
[myBYDBox:Battery_1_VoltsperCell_031],colorBYD([myBYDBox:Battery_1_VoltsperCell_031]),"15") |\
\
cylinder_bars("BYD Modul 3",floor_round([myBYDBox:Battery_1_MinmVolt]),ceil_round([myBYDBox:Battery_1_MaxmVolt]),"mV",250,undef,undef,0,\
[myBYDBox:Battery_1_VoltsperCell_032],colorBYD([myBYDBox:Battery_1_VoltsperCell_032]),"0",\
[myBYDBox:Battery_1_VoltsperCell_033],colorBYD([myBYDBox:Battery_1_VoltsperCell_033]),"1",\
[myBYDBox:Battery_1_VoltsperCell_034],colorBYD([myBYDBox:Battery_1_VoltsperCell_034]),"2",\
[myBYDBox:Battery_1_VoltsperCell_035],colorBYD([myBYDBox:Battery_1_VoltsperCell_035]),"3",\
[myBYDBox:Battery_1_VoltsperCell_036],colorBYD([myBYDBox:Battery_1_VoltsperCell_036]),"4",\
[myBYDBox:Battery_1_VoltsperCell_037],colorBYD([myBYDBox:Battery_1_VoltsperCell_037]),"5",\
[myBYDBox:Battery_1_VoltsperCell_038],colorBYD([myBYDBox:Battery_1_VoltsperCell_038]),"6",\
[myBYDBox:Battery_1_VoltsperCell_039],colorBYD([myBYDBox:Battery_1_VoltsperCell_039]),"7",\
[myBYDBox:Battery_1_VoltsperCell_040],colorBYD([myBYDBox:Battery_1_VoltsperCell_040]),"8",\
[myBYDBox:Battery_1_VoltsperCell_041],colorBYD([myBYDBox:Battery_1_VoltsperCell_041]),"9",\
[myBYDBox:Battery_1_VoltsperCell_042],colorBYD([myBYDBox:Battery_1_VoltsperCell_042]),"10",\
[myBYDBox:Battery_1_VoltsperCell_043],colorBYD([myBYDBox:Battery_1_VoltsperCell_043]),"11",\
[myBYDBox:Battery_1_VoltsperCell_044],colorBYD([myBYDBox:Battery_1_VoltsperCell_044]),"12",\
[myBYDBox:Battery_1_VoltsperCell_045],colorBYD([myBYDBox:Battery_1_VoltsperCell_045]),"13",\
[myBYDBox:Battery_1_VoltsperCell_046],colorBYD([myBYDBox:Battery_1_VoltsperCell_046]),"14",\
[myBYDBox:Battery_1_VoltsperCell_047],colorBYD([myBYDBox:Battery_1_VoltsperCell_047]),"15") |\
\
cylinder_bars("BYD Modul 4",floor_round([myBYDBox:Battery_1_MinmVolt]),ceil_round([myBYDBox:Battery_1_MaxmVolt]),"mV",250,undef,undef,0,\
[myBYDBox:Battery_1_VoltsperCell_048],colorBYD([myBYDBox:Battery_1_VoltsperCell_048]),"0",\
[myBYDBox:Battery_1_VoltsperCell_049],colorBYD([myBYDBox:Battery_1_VoltsperCell_049]),"1",\
[myBYDBox:Battery_1_VoltsperCell_050],colorBYD([myBYDBox:Battery_1_VoltsperCell_050]),"2",\
[myBYDBox:Battery_1_VoltsperCell_051],colorBYD([myBYDBox:Battery_1_VoltsperCell_051]),"3",\
[myBYDBox:Battery_1_VoltsperCell_052],colorBYD([myBYDBox:Battery_1_VoltsperCell_052]),"4",\
[myBYDBox:Battery_1_VoltsperCell_053],colorBYD([myBYDBox:Battery_1_VoltsperCell_053]),"5",\
[myBYDBox:Battery_1_VoltsperCell_054],colorBYD([myBYDBox:Battery_1_VoltsperCell_054]),"6",\
[myBYDBox:Battery_1_VoltsperCell_055],colorBYD([myBYDBox:Battery_1_VoltsperCell_055]),"7",\
[myBYDBox:Battery_1_VoltsperCell_056],colorBYD([myBYDBox:Battery_1_VoltsperCell_056]),"8",\
[myBYDBox:Battery_1_VoltsperCell_057],colorBYD([myBYDBox:Battery_1_VoltsperCell_057]),"9",\
[myBYDBox:Battery_1_VoltsperCell_058],colorBYD([myBYDBox:Battery_1_VoltsperCell_058]),"10",\
[myBYDBox:Battery_1_VoltsperCell_059],colorBYD([myBYDBox:Battery_1_VoltsperCell_059]),"11",\
[myBYDBox:Battery_1_VoltsperCell_060],colorBYD([myBYDBox:Battery_1_VoltsperCell_060]),"12",\
[myBYDBox:Battery_1_VoltsperCell_061],colorBYD([myBYDBox:Battery_1_VoltsperCell_061]),"13",\
[myBYDBox:Battery_1_VoltsperCell_062],colorBYD([myBYDBox:Battery_1_VoltsperCell_062]),"14",\
[myBYDBox:Battery_1_VoltsperCell_063],colorBYD([myBYDBox:Battery_1_VoltsperCell_063]),"15") |\

</pre>
</div>
</div>

== Anlegen der ElectricityCalculator für Bezug, Einspeisung, Erzeugung und Hausverbrauch ==
vier Module ElectricityCalculator (v.Sailor) werden angelegt um die gesammten Statistikdaten

(Heute, Gestern, Monat, Vormonat, Jahr, Vorjahr) zu erzeugen. Das geht auch mit dem Modul Statistics.<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
define Hausverbrauch ElectricityCalculator Fronius_Symo:User_Consumed_Energie_C.*
attr Hausverbrauch BasicPricePerAnnum 0
attr Hausverbrauch Currency €;
attr Hausverbrauch DbLogExclude .*
attr Hausverbrauch DbLogInclude Fronius_Symo_User_Consumed_Energie_C_EnergyDay
attr Hausverbrauch DecimalPlace 3
attr Hausverbrauch ElectricityCounterOffset 0
attr Hausverbrauch ElectricityKwhPerCounts 1
attr Hausverbrauch ElectricityPricePerKWh 0.2567
attr Hausverbrauch MonthOfAnnualReading 1
attr Hausverbrauch MonthlyPayment 0
attr Hausverbrauch ReadingDestination CalculatorDevice
attr Hausverbrauch SiPrefixPower W
attr Hausverbrauch room Energie-Strom
attr Hausverbrauch stateFormat Fronius_Symo_User_Consumed_Energie_C_EnergyDay kWh
attr Hausverbrauch verbose 0

define Fronius_Erzeugung ElectricityCalculator Fronius_Symo:User_Produced_PV.*
attr Fronius_Erzeugung BasicPricePerAnnum 0
attr Fronius_Erzeugung Currency €;
attr Fronius_Erzeugung DbLogExclude .*
attr Fronius_Erzeugung DbLogInclude Fronius_Symo_User_Produced_PV_EnergyDay
attr Fronius_Erzeugung DecimalPlace 3
attr Fronius_Erzeugung ElectricityCounterOffset -0.148
attr Fronius_Erzeugung ElectricityKwhPerCounts 1
attr Fronius_Erzeugung ElectricityPricePerKWh 0.3305
attr Fronius_Erzeugung MonthOfAnnualReading 1
attr Fronius_Erzeugung MonthlyPayment 0
attr Fronius_Erzeugung ReadingDestination CalculatorDevice
attr Fronius_Erzeugung SiPrefixPower W
attr Fronius_Erzeugung alias Erzeugung
attr Fronius_Erzeugung room Energie-Strom
attr Fronius_Erzeugung stateFormat Fronius_Symo_User_Produced_PV_EnergyDay kWh
attr Fronius_Erzeugung verbose 0

define Fronius_Einspeisung ElectricityCalculator Fronius_Symo:Meter_0_EnergyReal_WAC_Minus_Absolute.*
attr Fronius_Einspeisung BasicPricePerAnnum 0
attr Fronius_Einspeisung Currency €;
attr Fronius_Einspeisung DbLogExclude .*
attr Fronius_Einspeisung DbLogInclude Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_PowerCurrent,Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDay
attr Fronius_Einspeisung DecimalPlace 3
attr Fronius_Einspeisung ElectricityCounterOffset 0
attr Fronius_Einspeisung ElectricityKwhPerCounts 0.001
attr Fronius_Einspeisung ElectricityPricePerKWh 0.083
attr Fronius_Einspeisung MonthOfAnnualReading 1
attr Fronius_Einspeisung MonthlyPayment 0
attr Fronius_Einspeisung ReadingDestination CalculatorDevice
attr Fronius_Einspeisung SiPrefixPower W
attr Fronius_Einspeisung alias Einspeisung
attr Fronius_Einspeisung room Energie-Strom
attr Fronius_Einspeisung stateFormat Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDay kWh
attr Fronius_Einspeisung verbose 0

define Fronius_Bezug ElectricityCalculator Fronius_Symo:Meter_0_EnergyReal_WAC_Plus_Absolute.*
attr Fronius_Bezug BasicPricePerAnnum 0
attr Fronius_Bezug Currency €;
attr Fronius_Bezug DbLogExclude .*
attr Fronius_Bezug DbLogInclude Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDay,Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_PowerCurrent
attr Fronius_Bezug DecimalPlace 3
attr Fronius_Bezug ElectricityCounterOffset -36.075
attr Fronius_Bezug ElectricityKwhPerCounts 0.001
attr Fronius_Bezug ElectricityPricePerKWh 0.3305
attr Fronius_Bezug MonthOfAnnualReading 1
attr Fronius_Bezug MonthlyPayment 0
attr Fronius_Bezug ReadingDestination CalculatorDevice
attr Fronius_Bezug SiPrefixPower W
attr Fronius_Bezug alias Bezug
attr Fronius_Bezug room Energie-Strom
attr Fronius_Bezug stateFormat Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDay kWh
attr Fronius_Bezug verbose 0
</pre>
</div>
</div>

== Autarkie, Eigenverbrauch ==
Zwei Dummys mit dazugehörigen Füllroutinen werden angelegt
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
define AutarkieQuote dummy
attr AutarkieQuote DbLogExclude .*
attr AutarkieQuote alias Autarkie
attr AutarkieQuote group Fronius
attr AutarkieQuote room Energie-Strom
attr AutarkieQuote stateFormat Heute
attr AutarkieQuote userReadings Heute {get_autarkie ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyDay",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDay",0) , ReadingsVal("Fronius_Bezug","Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDay",0) )},\
Gestern {get_autarkie ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyDayLast",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDayLast",0) , ReadingsVal("Fronius_Bezug","Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDayLast",0) )},\
Monat {get_autarkie ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyMonth",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyMonth",0) , ReadingsVal("Fronius_Bezug","Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyMonth",0) )},\
Vormonat {get_autarkie ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyMonthLast",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyMonthLast",0) , ReadingsVal("Fronius_Bezug","Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyMonthLast",0) )},\
Jahr {get_autarkie ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyYear",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyYear",0) , ReadingsVal("Fronius_Bezug","Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyYear",0) )}

define EigenverbrQuote dummy
attr EigenverbrQuote DbLogExclude .*
attr EigenverbrQuote alias Eigenverbr.
attr EigenverbrQuote group Fronius
attr EigenverbrQuote room Energie-Strom
attr EigenverbrQuote stateFormat Heute
attr EigenverbrQuote userReadings Heute {get_eigenverbrauch ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyDay",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDay",0) )},\
Gestern {get_eigenverbrauch ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyDayLast",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDayLast",0) )},\
Monat {get_eigenverbrauch ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyMonth",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyMonth",0) )},\
Vormonat {get_eigenverbrauch ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyMonthLast",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyMonthLast",0) )},\
Jahr {get_eigenverbrauch ( ReadingsVal("Fronius_Erzeugung","Fronius_Symo_User_Produced_PV_EnergyYear",0) , ReadingsVal("Fronius_Einspeisung","Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyYear",0) )}

</syntaxhighlight>In die Datei 99_myUtils.pm die Berechnungsroutinen eintragen:<syntaxhighlight lang="perl">
sub get_eigenverbrauch
{
my($erzeugung,$einspeisung) = @_;
return(100) if ($erzeugung)<=0;
my($eigenverbrauch)=(($erzeugung)-($einspeisung))/($erzeugung)*100;
return($eigenverbrauch);
}

sub get_autarkie
{
my($erzeugung,$einspeisung,$bezug) = @_;
my($autarkie)=(($erzeugung)-($einspeisung))/(($erzeugung)-($einspeisung)+($bezug))*100;
return($autarkie);
}

</syntaxhighlight>Zusätzliche Routinen in 99_myUtils.pm um zu kleine oder auch zu große Werte auszusondern. Das "verschönert" die Graphen; kann auch weggelassen werden. Hintergrund: Diffential/Integralberechnungen unter/übersteuern beim Start.<syntaxhighlight lang="perl">
sub reduce_max_value
{
my($device, $reading, $max_value)=@_;
# Begrenzung der Ausgabewerte für Graphen
my($Grenzwert) = ReadingsVal($device,$reading, 0);
return($max_value) if (ReadingsVal($device, $reading,0) > $max_value );
return($Grenzwert);
}

sub reduce_min_value
{
my($device, $reading, $min_value)=@_;
# Begrenzung der Ausgabewerte für Graphen
my($Grenzwert) = ReadingsVal($device,$reading, 0);
return(0) if (ReadingsVal($device, $reading,0) <= $min_value );
return($Grenzwert);
}
</syntaxhighlight>Alle 15 Min erneute Berechnung der Werte (oder eine längere Zeit setzen...)<syntaxhighlight lang="perl">
define Autarkie_Timer at +*00:15:00 {fhem "setreading AutarkieQuote Heute 1"}
attr Autarkie_Timer DbLogExclude .*
attr Autarkie_Timer room Energie-Strom

define Eigenverbr_Timer at +*00:15:00 {fhem "setreading EigenverbrQuote Heute 1"}
attr Eigenverbr_Timer DbLogExclude .*
attr Eigenverbr_Timer room Energie-Strom
</pre>
</div>
</div>

== mySolarStat ==
[[Datei:Screenshot 2024-11-14 164746.jpg|mini|ReadingsGroup]]
Eine größere readingsGroup als Übersichtstabelle, passt auch gut in ftui2 aufs Tablet
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
define mySolarStat readingsGroup < >,<Heute>,<Gestern>,<Monat>,<Vormonat>,<Jahr> \
Fronius_Erzeugung:Fronius_Symo_User_Produced_PV_EnergyDay,Fronius_Symo_User_Produced_PV_EnergyDayLast,Fronius_Symo_User_Produced_PV_EnergyMonth,Fronius_Symo_User_Produced_PV_EnergyMonthLast,Fronius_Symo_User_Produced_PV_EnergyYear \
Fronius_Einspeisung:Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDay,Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDayLast,Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyMonth,Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyMonthLast,Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyYear \
Fronius_Bezug:Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDay,Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDayLast,Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyMonth,Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyMonthLast,Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyYear \
Hausverbrauch:Fronius_Symo_User_Consumed_Energie_C_EnergyDay,Fronius_Symo_User_Consumed_Energie_C_EnergyDayLast,Fronius_Symo_User_Consumed_Energie_C_EnergyMonth,Fronius_Symo_User_Consumed_Energie_C_EnergyMonth,Fronius_Symo_User_Consumed_Energie_C_EnergyYear\
Autolade_Calculator:C_STROM_GAS_counters.A_EnergyDay,C_STROM_GAS_counters.A_EnergyDayLast,C_STROM_GAS_counters.A_EnergyMonth,C_STROM_GAS_counters.A_EnergyMonthLast,C_STROM_GAS_counters.A_EnergyYear \
AutarkieQuote:Heute,Gestern,Monat,Vormonat,Jahr \
EigenverbrQuote:Heute,Gestern,Monat,Vormonat,Jahr
attr mySolarStat alias Solarstromstatistik kWh / %
attr mySolarStat room Energie-Auto,Energie-Strom,Statistik
attr mySolarStat valueFormat %.1f
</pre>
</div>
</div>

== Grafiken ==
[[Datei:Screenshot 2024-11-14 164925.jpg|mini|Erzeugung]]
Strombezug, Stromeinspeisung, Stromerzeugung, Stromverbrauch, Solare Vorhersage
hier "nur" ein Beispiel Stromerzeugung, die anderen Graphen dementsprechend anlegen

<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
defmod SVG_myDbLog_1 SVG myDbLog:SVG_myDbLog_1:HISTORY
attr SVG_myDbLog_1 alias Stromerzeugung
attr SVG_myDbLog_1 fp_Energieerzeugung 415,204,1,SVG_myDbLog_1,
attr SVG_myDbLog_1 fp_Energieverbrauch 204,164,1,SVG_myDbLog_1,
attr SVG_myDbLog_1 label $data{currval1}::$data{currval2}::$data{currval3}::$data{currval4}::$data{currval5}::
attr SVG_myDbLog_1 plotReplace L1={sprintf("%.1f", $data{currval1})} L2={sprintf("%.1f", $data{currval2})}
attr SVG_myDbLog_1 room Energie-Strom
attr SVG_myDbLog_1 title "Stromerzeugung"
</syntaxhighlight>und dazu die .gplot Datei:<syntaxhighlight lang="perl">
# Created by FHEM/98_SVG.pm, 2024-10-31 18:49:58
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set title '<TL> <L1> W <L2>kWh'
set ytics
set y2tics
set grid y2tics
set ylabel "Momentanleistung [W]"
set y2label "Tageserzeugung [kWh]"

#myDbLog Fronius_Symo:PowerFlow_Site_P_PV:::
#myDbLog Fronius_Erzeugung:Fronius_Symo_User_Produced_PV_EnergyDay:::

plot "<IN>" using 1:2 axes x1y1 title 'Momentanleistung <L1> [W]' ls l3 lw 2 with lines,\
"<IN>" using 1:2 axes x1y2 title 'Tageserzeugung <L2> [kWh]' ls l2fill lw 1 with lines

</pre>
</div>
</div>

== SolarForecast ==
[[Datei:Screenshot 2024-11-15 173408.jpg|mini|SolarForecast Darstellung]]
Es müssen vorher unter global die attr longitude und latitude für den Standort der Anlage eingegeben werden, damit die einzelnen Wettermodelle funktionieren. Forecast hat ein prima selbsterklärendes Startmenü und man sieht auch gleich die evt. vorhandenen Einstellungsfehler.

Weiteres dazu im umfangreichen [[SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung|Wiki Solarforecast]].

Die dort beschriebene Grafik "Solare Vorhersage" zeigt die Differenzen zwischen der berechneten Vorhersage und der tatsächlichen PV-Erzeugung eines Tages. Die Werte, die in der Anlagenübersicht angezeigt werden, sollten identisch zu denen in dem u.A. ftui2 Widget sein (Gegenkontrolle).

In diesem Beispiel ist ein Interner consumer01 (Autoladen) eingestellt, dessen Werte nicht mit in den Forecast einbezogen werden.
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
defmod Forecast SolarForecast
attr Forecast DbLogExclude .*
attr Forecast DbLogInclude LastHourPVforecast,LastHourPVreal,AllPVforecastsToEvent
attr Forecast consumer01 MQTT2_evcc1 type=charger power=0 exconfc=1 icon=electric_car_icon pcurr=loadpoints_1_chargePower :W
attr Forecast ctrlLanguage DE
attr Forecast ctrlNextHoursSoCForecastReadings 07,08,09,10,11,12,13,14,15,16,17,18,19,20,21
attr Forecast ctrlSpecialReadings BatPowerIn_Sum,BatPowerOut_Sum,conForecastTillNextSunrise,dayAfterTomorrowPVforecast,todayConsumption,todayConsumptionForecast,todayConsumptionForecastDay,todayGridConsumption,todayGridFeedIn,tomorrowConsumptionForecast
attr Forecast event-on-change-reading .*
attr Forecast graphicControl energyUnit=kWh headerDetail=all,pv
attr Forecast graphicHistoryHour 8
attr Forecast graphicSelect forecast
attr Forecast graphicShowNight 01
attr Forecast plantControl showLink=1
attr Forecast room Energie-Strom
attr Forecast setupBatteryDev01 PV_Batterie pin=BatteryChargeWatt:W pout=BatteryDischargeWatt:W intotal=Summe_Ladung:kWh outtotal=Summe_Entladung:kWh show=1 cap=12800 charge=BatteryChargePercent
attr Forecast setupInverterDev01 Fronius_Symo pvOut=PowerFlow_Site_P_PV:W etotal=User_Produced_FPV:kWh capacity=11000 strings:Ostseite,Suedseite
attr Forecast setupInverterDev02 Fronius_Symo pvOut=Meter_1_PowerReal_P_Sum:W etotal=Meter_1_EnergyReal_WAC_Sum_Produced:Wh capacity=4000 strings:Westseite,GH_Ost,GH_West
attr Forecast setupInverterStrings Suedseite,Westseite,Ostseite,GH_West,GH_Ost
attr Forecast setupMeterDev Fronius_Symo gcon=Bezug:W contotal=Meter_0_EnergyReal_WAC_Plus_Absolute:Wh gfeedin=Einspeisung feedtotal=Meter_0_EnergyReal_WAC_Plus_Absolute:Wh conprice=powerCost:€ feedprice=0.083:€
attr Forecast setupRadiationAPI OpenMeteoDWD_D2-API
attr Forecast setupStringAzimuth Suedseite=0 Westseite=90 Ostseite=-90 GH_Ost=-90 GH_West=90
attr Forecast setupStringDeclination Suedseite=35 Westseite=60 Ostseite=45 GH_West=18 GH_Ost=18
attr Forecast setupStringPeak Suedseite=7.66 Westseite=2.2 Ostseite=3.48 GH_Ost=1.74 GH_West=0.58
attr Forecast setupWeatherDev1 OpenMeteoDWD_D2-API
attr Forecast verbose 0

</pre>
</div>
</div>
[[Datei:Screenshot 2024-11-14 165143.jpg|mini|SolarForecast Diff. Grafik]]

Die Unterschiede vom Forecast zur reellen Erzeugung können in einer Grafik dargestellt werden.

Code siehe weiter unten.

== Autoladen über evcc ==
Integration und Steuerung der Wallbox, Wechselrichter, Batterie sowie zu ladendes Fahrzeug kann über das Programm evcc gemacht werden.

Die Software evcc läuft problemlos parallel auf dem FHEM Systemrechner und kann über MQTT2 eingebunden werden.

Weitere Infos dazu in https://evcc.io/

Der Nachteil dieser (externen) Software ist der Preis. Es wird mit Open-Source-Software geworben, jedoch die meisten Module z.B. zum Steuern eines Fahrzeugs oder einer Wallbox gehen nur über einen sogenannten Sponsortoken, den man für 1$ pro Monat erwerben kann. Aber solange ein solches Modul mit ähnlich umfangreichen Möglichkeiten bei FHEM nicht zur Verfügung steht, hier die Möglichkeit der Integration in FHEM.

Der Clou ist hiebei ist die Hausbatterie entsprechend der evcc Möglichkeiten zu schalten und auch das Programm zu steuern

auf welche Art das Fz geladen werden soll: Sofort, nur PV Überschuss, Minimal + PV oder Aus

Zusätzlich ein weiterer ElectricityCalculator für die Autoladestatistik der Wallbox.

Dieser übergibt seine Autoladungswerte über mqttPublish zurück an fhem.
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
defmod MQTT2_evcc1 MQTT2_DEVICE evcc1
attr MQTT2_evcc1 DbLogExclude .*
attr MQTT2_evcc1 DbLogInclude loadpoints_1_chargePower
attr MQTT2_evcc1 alias Wally
attr MQTT2_evcc1 autocreate 1
attr MQTT2_evcc1 comment Achtung: EVCC greift per Modbus auf Fronius zu Port 502 Adr. 200
attr MQTT2_evcc1 event-on-change-reading .*
attr MQTT2_evcc1 event-on-update-reading .*
attr MQTT2_evcc1 icon wallbox
attr MQTT2_evcc1 room Energie-Auto
attr MQTT2_evcc1 setList ChargeMode:Now,Min+PV,PV,Stop { my %h=(Now=>'now','Min+PV'=>'minpv',PV=>'pv',Stop=>'off');; qq(evcc/loadpoints/1/mode/set $h{$EVTPART1});; } \
PvPriority:Home,Car,FillCar { my %h=(Home=>'95','Car'=>'35','FillCar'=>'15');; qq(evcc/site/prioritySoc/set $h{$EVTPART1});; }\
MaxCurrent:11,14,16,20,24,32 { qq(evcc/loadpoints/1/maxCurrent/set $EVTPART1);; }
attr MQTT2_evcc1 stateFormat Auto_Status | loadpoints_1_mode | loadpoints_1_chargePower W
attr MQTT2_evcc1 userReadings Auto_Status { (ReadingsVal($name,'loadpoints_1_connected','') eq 'true' ? 2 : 0) },\
Reichweite { ((ReadingsVal($name,'loadpoints_1_vehicleSoc','')-10)*0.67) },\
Ladeleistung { (ReadingsVal($name,'loadpoints_1_chargePower','')/1000) }

Und nun noch ein ElectricityCalculator, zur Berechnung der Strommenge:
Die Stromwerte kommen aus einem 1-Wire Counter der einen extra Zähler über den SO Port zählt.

Wenn die Wallbox einen Stromzähler hat, geht das natürlich einfacher; nur die Statistikwerte dieses Zählers werden benötigt.

defmod Autolade_Calculator ElectricityCalculator MQTT2_evcc1:loadpoints_1_chargeTotalImport.*
attr Autolade_Calculator BasicPricePerAnnum 132.84
attr Autolade_Calculator Currency €
attr Autolade_Calculator DbLogExclude .*
attr Autolade_Calculator DbLogInclude MQTT2_evcc1_loadpoints_1_chargeTotalImport_EnergyDay
attr Autolade_Calculator DecimalPlace 3
attr Autolade_Calculator ElectricityCounterOffset 0
attr Autolade_Calculator ElectricityKwhPerCounts 1
attr Autolade_Calculator ElectricityPricePerKWh 0.3305
attr Autolade_Calculator MonthOfAnnualReading 1
attr Autolade_Calculator MonthlyPayment 121
attr Autolade_Calculator ReadingDestination CalculatorDevice
attr Autolade_Calculator SiPrefixPower kW
attr Autolade_Calculator alias Autoladen
attr Autolade_Calculator room Energie-Auto,Steuerung
attr Autolade_Calculator stateFormat Heute: MQTT2_evcc1_loadpoints_1_chargeTotalImport_EnergyDay kWh
</pre>
</div>
</div>

[[Datei:Solaranlage-ftui.jpg|mini|Solaranlagenübersicht]]

==ftui2 Widgets zur Darstellung auf einem Tablet==
Widget pvvis und angepasste Daten zur Darstellung

Einige Werte werden intern berechnet, das {{Link2Forum|Topic=119440|Message=1320903|LinkText=Widget}} selbst kann im Forum geladen werden.

Widget
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content"><pre>
<header>Solaranlage und Batterie</header>

<div data-type="pvvis" data-device="Fronius_Symo"
data-get="Fronius_Symo:Bezug"
data-feed="Fronius_Symo:Neg_Einspeisung"
data-lp1="MQTT2_evcc1:Auto_Status"
data-lp1pow="Autolade_Calculator:Auto_reduce"
data-carsoc="MQTT2_evcc1:loadpoints_1_vehicleSoc"
data-carvol="Autolade_Calculator:C_STROM_GAS_counters.A_EnergyDay"
data-carrange="MQTT2_evcc1:Reichweite"
data-charge="Fronius_Symo:Akku_Laden"
data-discharge="Fronius_Symo:Akku_Entladen"
data-produce="Fronius_Symo:PowerFlow_Site_P_PV"
data-sumproduceday="Fronius_Erzeugung:Fronius_Symo_User_Produced_PV_EnergyDay"
data-sumgridday="Fronius_Bezug:Fronius_Symo_Meter_0_EnergyReal_WAC_Plus_Absolute_EnergyDay"
data-sumfeedday="Fronius_Einspeisung:Fronius_Symo_Meter_0_EnergyReal_WAC_Minus_Absolute_EnergyDay"
data-soc="Fronius_Symo:PowerFlow_Inverters_1_SOC"
data-chargedischarge="Fronius_Symo:PowerFlow_Site_P_Akku"
data-pv-max="10000"
data-batt-max="10240"
data-autarky="AutarkieQuote:Heute"
data-pvhome="Fronius_Symo:PowerFlow_Site_P_Load"
data-width="450" data-height="450" class="centered">
</div>

</pre>
</div>
</div>

== [[SolarForecast FTUI Widget|Widget SolarForecast]] für die Vorschau auf ftui2, darunter die Differenz Vorhersage/reale Erzeugung: ==
<div class="mw-collapsible mw-collapsed">
Code:<div class="mw-collapsible-content">
<pre>
<div class="page" id="content_forecast">
<div class="gridster">
<ul>

<li data-row="1" data-col="1" data-sizex="9" data-sizey="9">
<header>Solar Vorhersage</header>
<div class="cell">
<div data-type="smaportalspg" data-device="Forecast" data-get="state"></div>
</div>
</li>
<li data-row="9" data-col="1" data-sizex="9" data-sizey="4">
<header>Vorhersage</header>
<div data-type="chart"
data-device="Hausverbrauch"
data-logdevice='["myDbLog"]'
data-logfile='["HISTORY"]'
data-columnspec='["Forecast:LastHourPVreal","Forecast:LastHourPVforecast"]'
data-style='["ftui l6fill","ftui l1fill"]'
data-uaxis='["primary","secondary"]'
data-legend='["Akt.Erzeugung","Akt.Vorhersage"]'
data-yunit="°kWh"
data-ytext="Menge"
data-width="100%"
data-height="100%"
data-yticks="auto"
data-minvalue="auto"
data-maxvalue="auto"
data-nofulldays="true"
data-daysago_start="-6H"
data-daysago_end="-22H"
data-xticks="auto"
</div>
</li>

</ul>
</div>
</div>
</pre>(Nur der der Vollständigkeit wegen)
</div>
</div>

[[Kategorie:Wechselrichter]]
[[Kategorie:Energieerzeugungsmessung]]

Diskussion:Solaranlage Komplettbeispiel Fronius BYD

2026-01-12T18:04:10Z

Ph1959de: Neuer Abschnitt /* Datein / Screenshots - Verwendung */

So Leute, die Grundstruktur steht erst mal.
Soll der Titel so bleiben, oder geändert werden?
:Der Titel kann so bleiben - was Du noch machen solltest: an geeigneten Stellen auf diese Beispiel verweisen (kannst Dich vielleicht an [[Spezial:Linkliste/SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung]] orientieren), damit der Beitrag nicht nur "zufällig" oder über einen Verweis aus den Forum gefunden wird. --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 11:34, 5. Nov. 2025 (CET)

== Abhängigkeit von Autolade_Calculator ==
Wenn man den Code im Abschnitt "Fronius_Symo in FHEM" 1:1 übernimmt, führt eine Abhängigkeit von "Autolade_Calculator" in userReadings zu Einträgen im logfile, wenn kein device "Autolade_Calculator" definiert ist:

"User_Consumed_EN:PowerFlow_Site_P_PV.* {ReadingsVal($name,"PowerFlow_Site_P_PV","")-ReadingsVal("Autolade_Calculator","Auto_Ladung_av","")+ReadingsVal($name,"PowerFlow_Site_P_Grid","")+ReadingsVal($name,"PowerFlow_Site_P_Akku","")},"

Ich schlage vor, die Zeile zu entfernen (oder zu erläutern, welches device da verlangt wird).

(Anmerkung: Bei mir irritierte zusätzlich, dass die log-Einträge selbst mit verbose=0 auftraten)

== Linkliste ==

Habe die Linkliste geprüft, alles soweit ok.
Änderungen in anderen WIKI zu Links hierauf werde ich noch nicht erstellen.
Muss das System WIKI erst mal verstehen.....

== Datein / Screenshots - Verwendung ==

Hallo Wds1957,
Du hast die Verlinkung von ''Screenshot 2024-09-25 191422.jpg'' im Artikel ersetzt durch ''Screenshot 20250612 192318 Fully Kiosk Browser.jpg''. Dadurch wird erstere Datei nicht mehr verwendet. Falls sie gelöscht werden soll, bitte durch Kennzeichnung als ''<nowiki>{{Löschkandidat|Grund für Löschung}}</nowiki>'' markieren, anderenfalls bitte an passender Stelle neu verwenden. --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 19:04, 12. Jan. 2026 (CET)

Wattpilot

2026-01-12T12:23:01Z

Ph1959de: Hinweis auf Websocket-Einbindung

{{Infobox Modul
|ModPurpose=Überwachung und Steuerung von Fronius Wattpilot Wallboxen
|ModType=x
|ModCmdRef=
|ModForumArea=Wallboxen und E-Fahrzeuge
|ModFTopic=110282
|ModTechName=72_Wattpilot.pm
|ModOwner=Blablubblaber ({{Link2FU|14511|Forum}})
}}
Das Modul [[Wattpilot]] dient zur Überwachung und Steuerung von Fronius Wattpilot Wallboxen.

Alternativ kann auch die auf [[Websocket#Fronius_Wattpilot|dieser Seite]] beschriebene Anbindung mit den gezeigten Code Snippets über Websocket verwendet werden.

== Quelle und Dokumentation ==
Das Modul ist über die [https://github.com/DennisGrame/FHEM_Modul_Fronius_Wattpilot Github Seite des Autors] verfügbar.

== Links ==
* [https://github.com/DennisGrame/FHEM_Modul_Fronius_Wattpilot Github Seite zum Modul/Projekt]
* Website des Wallbox-Herstellers: [https://www.fronius.com/de-de/germany/solarenergie/eigenheim/produkte-und-loesungen/e-mobilitaet Fronius]

[[Kategorie:Wallboxen]]

Wallboxen Übersicht

2026-01-12T12:20:04Z

Ph1959de: Fronius-Anbindung präzisiert

Diese Seite gibt eine tabellarische Übersicht über die Eckdaten verschiedener Wallboxen.

{| class="wikitable" style="margin:auto"
|-
!rowspan="2"|Hersteller!!rowspan="2"|Typ!!rowspan="2"|Preis in € ca.!!colspan="2"|Ladeleistung kW!!rowspan="2"|FI intern!!rowspan="2"|Zähler!!rowspan="2"|Kabel o. Dose!!rowspan="2"|Netzwerk!!rowspan="2"|Anbindung FHEM!!rowspan="2"|Betrieb!!rowspan="2"|Zugang Kontrolle!!rowspan="2"|Datum
|-
!1-phasig!!3-phasig
|-
|rowspan="2"|ABL ||eMH1 || 200,00 || || 11 ||rowspan="2"| DC+AC ||rowspan="2"| MID || Kabel || || ||
|-
|eMH2 || 900,00 || || 22 || opt. Kabel || || ||
|-
|cfos-emobility || Power Brain Wallbox || 549,00 || 3,7 || 11 || DC || ja || Kabel || WLAN || Modbus TCP || max 45°C || App oder RFID || Dez. 2023 {{Link2Forum|Topic=136113|Message=1298136|LinkText=(F)}}
|-
|E.ON || Drive vBox smart 11|| 490,00 ||3,7 ||1,4-11|| DC ||nein ||opt. Kabel 4,5m||WLAN und LAN, opt. RS485||Modbus TCP ||max 55°C||RFID ||Dez. 2023
|-
|E.ON || Drive vBox pro 22|| 329,00 ||7,4 ||bis 22|| DC ||MID ||mit Kabel 6,5m||WLAN und LAN, LTE||Modbus TCP ||max 55°C||RFID ||März. 2025
|-
|Fronius || Wattpilot Home 11J || 770,00 ||3,7||11 || DC ||nein ||Dose ||WLAN || WebSocket ([[Websocket#Fronius_Wattpilot|Beispielcode]]), Modul ([[Wattpilot]]) ||max 40°C|| App||Dez. 2023
|-
|go-e || eCharger Gemini || 550,00 ||3,7* ||11 ||DC ||MID ||Dose || WLAN ||REST, MQTT, Modbus TCP, [[GoE Charger|HTTPMOD]], [[GoECharger|Modul 46_GoECharger.pm]] (veraltetes API V1) ||max. 40°C||RFID,App||Dez. 2023
|-
|Hardy Barth||eCHARGE cPµ2 PRO || 750,00 || ||1,4-11||ja ||MID extern||Kabel 5m || || || || ||Dez. 2023
|-
|Heidelberg|| Energy Control 11kW || 250,00 zuzgl. wbec Modul 100,00 ||3,7 *||11 ||DC ||ja||Kabel 5m ||WLAN+LAN mit wbec-Modul || REST, MQTT, Modbus TCP mit wbec-Modul, Lademanagement || || Browser ||Dez. 2023 {{Link2Forum|Topic=136113|Message=1298136|LinkText=(F)}}
|-
|rowspan="2"|Elli = VW || ID.Charger Connect|| 800,00 ||rowspan="2"|7,4 ||rowspan="2"|11 ||rowspan="2"|ja ||nein ||rowspan="2"|Kabel ab 4,5m ||rowspan="2"|WLAN, LAN, LTE, opt. RS485 ||rowspan="2"|Software evcc auf externem Server bildet EEBUS auf MQTT ab. EEBUS-Interface für FHEM wäre wünschenswert ||rowspan="2"|max. 40°C||rowspan="2"|RFID,App||rowspan="2"|Dez. 2023
|-
|ID.Charger Pro || 1050,00 ||ja MID
|-
|KEBA ||KeContact P30 a-series|| 200,00 || ||1,4-11||ja ||nein ||Kabel 4m ||LAN ||Modbus TCP || || ||Dez. 2023
|-
|rowspan="2"|OpenWB ||OpenWB series2 Standard || 1100,00 ||rowspan="2"| 7,4|| rowspan="2" |11 oder 22||rowspan="2"|DC || ja|| rowspan="2" |Kabel ab 3m, optional mit Buchse (custom) || rowspan="2" |LAN, WLAN || rowspan="2" |REST, MQTT, Modbus via Adapter
Lademanagement umfangreich, siehe [[OpenWB#Komplexe Anbindung]]
| rowspan="2" |max 45°C || RFID (opt)
PIN (opt, bei display)
| rowspan="2" |Dez. 2023
|-
|OpenWB PRO || 2100,00
|-
|Vestel || EVC04-E11-W-C || colspan="11" |Baugleich mit E.ON Drive vBox smart 11
|-
|Wallbox || Pulsar Plus || 700,00 || ||11 ||DC ||ja, nicht MID|| || WLAN, Bluetooth|| || ||RFID, App ||Dez.2023
|-
! colspan="13" style="text-align:left" |
Bemerkungen:
* Ein * in der Spalte "Ladeleistung 1-phasig" bedeutet, dass die Phasenumschaltung automatisch erfolgt.
* FI = Fehlerstromschutzschalter für Gleichstrom (DC) bzw. Typ A für Wechselstrom (AC).
* Ein interner Zähler kann geeicht sein (nötig nach deutschem Recht für Abrechungen), "nur" MID-konform (internationaler Standard) oder irgendwas...
|}

[[Kategorie:Wallboxen]]

Wallboxen Übersicht

2026-01-12T12:15:09Z

Ph1959de: Legende ans Tabellenende verschoben; einige Module / Beschreibungen verlinkt

Diese Seite gibt eine tabellarische Übersicht über die Eckdaten verschiedener Wallboxen.

{| class="wikitable" style="margin:auto"
|-
!rowspan="2"|Hersteller!!rowspan="2"|Typ!!rowspan="2"|Preis in € ca.!!colspan="2"|Ladeleistung kW!!rowspan="2"|FI intern!!rowspan="2"|Zähler!!rowspan="2"|Kabel o. Dose!!rowspan="2"|Netzwerk!!rowspan="2"|Anbindung FHEM!!rowspan="2"|Betrieb!!rowspan="2"|Zugang Kontrolle!!rowspan="2"|Datum
|-
!1-phasig!!3-phasig
|-
|rowspan="2"|ABL ||eMH1 || 200,00 || || 11 ||rowspan="2"| DC+AC ||rowspan="2"| MID || Kabel || || ||
|-
|eMH2 || 900,00 || || 22 || opt. Kabel || || ||
|-
|cfos-emobility || Power Brain Wallbox || 549,00 || 3,7 || 11 || DC || ja || Kabel || WLAN || Modbus TCP || max 45°C || App oder RFID || Dez. 2023 {{Link2Forum|Topic=136113|Message=1298136|LinkText=(F)}}
|-
|E.ON || Drive vBox smart 11|| 490,00 ||3,7 ||1,4-11|| DC ||nein ||opt. Kabel 4,5m||WLAN und LAN, opt. RS485||Modbus TCP ||max 55°C||RFID ||Dez. 2023
|-
|E.ON || Drive vBox pro 22|| 329,00 ||7,4 ||bis 22|| DC ||MID ||mit Kabel 6,5m||WLAN und LAN, LTE||Modbus TCP ||max 55°C||RFID ||März. 2025
|-
|Fronius || Wattpilot Home 11J || 770,00 ||3,7||11 || DC ||nein ||Dose ||WLAN || WebSocket (Modul [[Wattpilot]]) ||max 40°C|| App||Dez. 2023
|-
|go-e || eCharger Gemini || 550,00 ||3,7* ||11 ||DC ||MID ||Dose || WLAN ||REST, MQTT, Modbus TCP, [[GoE Charger|HTTPMOD]], [[GoECharger|Modul 46_GoECharger.pm]] (veraltetes API V1) ||max. 40°C||RFID,App||Dez. 2023
|-
|Hardy Barth||eCHARGE cPµ2 PRO || 750,00 || ||1,4-11||ja ||MID extern||Kabel 5m || || || || ||Dez. 2023
|-
|Heidelberg|| Energy Control 11kW || 250,00 zuzgl. wbec Modul 100,00 ||3,7 *||11 ||DC ||ja||Kabel 5m ||WLAN+LAN mit wbec-Modul || REST, MQTT, Modbus TCP mit wbec-Modul, Lademanagement || || Browser ||Dez. 2023 {{Link2Forum|Topic=136113|Message=1298136|LinkText=(F)}}
|-
|rowspan="2"|Elli = VW || ID.Charger Connect|| 800,00 ||rowspan="2"|7,4 ||rowspan="2"|11 ||rowspan="2"|ja ||nein ||rowspan="2"|Kabel ab 4,5m ||rowspan="2"|WLAN, LAN, LTE, opt. RS485 ||rowspan="2"|Software evcc auf externem Server bildet EEBUS auf MQTT ab. EEBUS-Interface für FHEM wäre wünschenswert ||rowspan="2"|max. 40°C||rowspan="2"|RFID,App||rowspan="2"|Dez. 2023
|-
|ID.Charger Pro || 1050,00 ||ja MID
|-
|KEBA ||KeContact P30 a-series|| 200,00 || ||1,4-11||ja ||nein ||Kabel 4m ||LAN ||Modbus TCP || || ||Dez. 2023
|-
|rowspan="2"|OpenWB ||OpenWB series2 Standard || 1100,00 ||rowspan="2"| 7,4|| rowspan="2" |11 oder 22||rowspan="2"|DC || ja|| rowspan="2" |Kabel ab 3m, optional mit Buchse (custom) || rowspan="2" |LAN, WLAN || rowspan="2" |REST, MQTT, Modbus via Adapter
Lademanagement umfangreich, siehe [[OpenWB#Komplexe Anbindung]]
| rowspan="2" |max 45°C || RFID (opt)
PIN (opt, bei display)
| rowspan="2" |Dez. 2023
|-
|OpenWB PRO || 2100,00
|-
|Vestel || EVC04-E11-W-C || colspan="11" |Baugleich mit E.ON Drive vBox smart 11
|-
|Wallbox || Pulsar Plus || 700,00 || ||11 ||DC ||ja, nicht MID|| || WLAN, Bluetooth|| || ||RFID, App ||Dez.2023
|-
! colspan="13" style="text-align:left" |
Bemerkungen:
* Ein * in der Spalte "Ladeleistung 1-phasig" bedeutet, dass die Phasenumschaltung automatisch erfolgt.
* FI = Fehlerstromschutzschalter für Gleichstrom (DC) bzw. Typ A für Wechselstrom (AC).
* Ein interner Zähler kann geeicht sein (nötig nach deutschem Recht für Abrechungen), "nur" MID-konform (internationaler Standard) oder irgendwas...
|}

[[Kategorie:Wallboxen]]

Wattpilot

2026-01-12T12:13:49Z

Ph1959de: Modul

{{Infobox Modul
|ModPurpose=Überwachung und Steuerung von Fronius Wattpilot Wallboxen
|ModType=x
|ModCmdRef=
|ModForumArea=Wallboxen und E-Fahrzeuge
|ModFTopic=110282
|ModTechName=72_Wattpilot.pm
|ModOwner=Blablubblaber ({{Link2FU|14511|Forum}})
}}
Das Modul [[Wattpilot]] dient zur Überwachung und Steuerung von Fronius Wattpilot Wallboxen.

== Quelle und Dokumentation ==
Das Modul ist über die [https://github.com/DennisGrame/FHEM_Modul_Fronius_Wattpilot Github Seite des Autors] verfügbar.

== Links ==
* [https://github.com/DennisGrame/FHEM_Modul_Fronius_Wattpilot Github Seite zum Modul/Projekt]
* Website des Wallbox-Herstellers: [https://www.fronius.com/de-de/germany/solarenergie/eigenheim/produkte-und-loesungen/e-mobilitaet Fronius]

[[Kategorie:Wallboxen]]

GoECharger

2026-01-12T12:13:36Z

Ph1959de: Modulseite angelegt

{{Infobox Modul
|ModPurpose=Überwachung und Steuerung von Wallboxen des Herstellers [https://go-e.com/de-de go-e]
|ModType=x
|ModCmdRef=
|ModForumArea=Wallboxen und E-Fahrzeuge
|ModFTopic=143571
|ModTechName=72_Wattpilot.pm
|ModOwner=LR66 ({{Link2FU|4213|Forum}})
}}
Das Modul [[GoECharger]] dient zur Überwachung und Steuerung von go-e Wallboxen.

== Status ==
Das Modul ist (Stand Januar 2026) veraltet und wird allem Anschein nach nicht mehr gepflegt.

Alternativ gibt es die Beschreibung [[GoE Charger]] zur Einbindung der Wallbox in FHEM über [[HTTPMOD]].

== Quelle und Dokumentation ==
Das Modul ist über die [https://github.com/LuRhe/fhem-46_GoECharger Github Seite des Autors] verfügbar.

== Links ==
* [https://github.com/LuRhe/fhem-46_GoECharger Github Seite zum Modul/Projekt]
* Website des Wallbox-Herstellers: [https://go-e.com/de-de go-e]

[[Kategorie:Wallboxen]]

Vorlage:Infobox Modul

2026-01-05T15:24:07Z

Ph1959de: ... give it a fine border

<onlyinclude>
{| class="float-right infobox toccolours" style="margin: 0 0 1em 1em; float:right; border-style: solid; border-width: 1px" width="300"
! colspan="2" style="background-color:#EFEFFF" | {{#if: {{{ModCmdRef|}}}|{{{ModCmdRef}}}|{{PAGENAME}} }}
|- style="background-color:#EFEFFF"
! colspan="2" | Zweck / Funktion
|- style="background-color:#FFFFFF"
| colspan="2" | {{{ModPurpose}}}
|- style="background-color:#EFEFFF"
! colspan="2" | Allgemein
|- bgcolor="#FFFFFF"


| Typ
| {{#switch:
{{{ModType}}} | cmd = Befehl [[Kategorie:FHEM Befehl]] | u = Utilities [[Kategorie:FHEM Utilities]] | contrib = [https://svn.fhem.de/trac/browser/trunk/fhem/contrib Contrib] [[Kategorie:Modul (Contrib)]] | d = Gerätemodul [[Kategorie:Gerätemodul]] | h = Hilfsmodul [[Kategorie:Hilfsmodul]] | x = Inoffiziell [[Kategorie:Modul (Inoffiziell)]] | #default = undefiniert }}

|- style="background-color:#EFEFFF"
! colspan="2" | Details
|- bgcolor="#FFFFFF"

| Dokumentation
| {{#switch:
{{{ModType}}} | x|u = {{#if: {{{ModFTopic|}}} |  {{Link2Forum|Topic={{{ModFTopic}}}}} |  siehe Forum }} |  contrib = {{#if: {{{ModFTopic|}}} |  {{Link2Forum|Topic={{{ModFTopic}}}}} |  siehe Forum }} |  cmd|d|h = {{#if: {{{ModCmdRef|}}} | {{Link2CmdRef|Anker={{{ModCmdRef}}}|Label=EN}} / {{Link2CmdRef|Anker={{{ModCmdRef}}}|Label=DE|Lang=de}} | {{Link2CmdRef|Anker={{PAGENAME}}|Label=EN}} / {{Link2CmdRef|Anker={{PAGENAME}}|Label=DE|Lang=de}} }}{{#if: {{{ModFTopic|}}} | <br>{{Link2Forum|Topic={{{ModFTopic}}}}}|}} | | #default = ModUndef }}

|- bgcolor="#FFFFFF"
{{#if: {{{ModForumArea|}}} |
{{!}} Support (Forum) {{!!}} {{Link2Forum|Area={{{ModForumArea|}}}}}
}}

|- bgcolor="#FFFFFF"
| Modulname || {{{ModTechName}}}

|- bgcolor="#FFFFFF"
| [http://fhem.de/MAINTAINER.txt Ersteller] || {{{ModOwner}}}

|- style="background-color:#7FFFD4"
| colspan="2" | '''Wichtig''': sofern vorhanden, gilt im Zweifel '''immer''' die (englische) Beschreibung in der ''{{Link2CmdRef|Anker=#|Label=commandref}}''!
|}
</onlyinclude>

<noinclude>
__NOTOC__

== Dokumentation ==
Benutzung dieser Vorlage: <nowiki>{{Infobox Modul|...}}</nowiki>

Diese Vorlage dient zur Zusammenfassung von Schlüsseldaten zu einem Modul und sollte auf der Beschreibungsseite des Moduls verwendet werden.

=== Aufrufparameter ===
;ModPurpose
:Kurzbeschreibung der Funktion / des Zwecks dieses Moduls
;ModType
:Modultyp, ausgehend von der Einteilung in der commandref: <br />'''cmd'''="fhem commands" (FHEM-Befehle) <br />'''contrib'''="Contrib" Inoffizielles Modul, das aus dem Contrib-Unterverzeichnis des FHEM-Repositories geladen werden muss; externer Link auf das Verzeichnis wird automatisch generiert. <br />'''d'''="devices" (Geräte) <br />'''h'''="helper modules" (Hilfs(Erweiterungs-)module) <br />'''u'''="Utilities" (Sammlung von Hilfsfunktionen für bestimmte Einsatzbereiche) <br />'''x'''="experimentell" (Inoffiziell; noch nicht Teil des Standard-FHEM, aber auch nicht im "contrib" Unterverzeichnis bei sourceforge abgelegt; derartige Module sind in der Regel über den zugehörigen Diskussionsfaden im [forum.fhem.de FHEM Forum] zu beziehen). <br />Abhängig vom gewählten Modultyp wird ein Kategorieeintrag für ''FHEM Befehl'', ''FHEM Utilities'', ''Gerätemodul'', ''Hilfsmodul'', ''Modul (Contrib)'' oder ''Modul (Inoffiziell)'' erzeugt.
{{Randnotiz|RNTyp=y|RNText=Entspricht der Seitentitel nicht dem Modulnamen, müssen die folgenden zusätzlichen Maßnahmen ergriffen werden:
* An den Beginn der Modul-Seite '''muss''' die Anweisung <nowiki>{{SEITENTITEL:naMeInRichtigerSchreibweise}}</nowiki> eingefügt werden
* Der Parameter ''ModCmdRef=naMeInRichtigerSchreibweise'' '''muss''' für die ''Infobox Modul'' spezifiziert werden.
}}
;ModCmdRef
:optionaler Parameter (für die Bestimmung des Wertes für die Zeile ''Dokumentation''). Falls nicht angegeben, wird aus dem Seitentitel ein Link auf den entsprechenden Abschnitt der commandref generiert. Weicht der Seitentitel von der Bezeichnung des Abschnitts in der commandref ab (z. B., weil der Modulname "eigentlich" mit einem Kleinbuchstaben beginnt), kann hier der Name in der korrekten Schreibweise spezifiziert werden. <br>Für ModType=''x'' und ''contrib'' wird kein Link auf die commandref erzeugt (da der entsprechende Abschnitt noch nicht existieren dürfte), sondern ein schlichter Verweis auf das FHEM Forum. Wenn Parameter '''''ModFTopic''''' spezifiziert ist, wird ein Link auf diesen Forenthread generiert. <br>Ist '''''ModFTopic''''' für "offizielle" Module spezifiziert, wird zusätzlich der Link auf den entsprechenden Forenthread generiert.
;ModFTopic
:optionaler Parameter. Forendiskussion zu diesem Modul; numerischer Wert, der zu einem Verweis auf den ersten Beitrag des Diskussionsfadens (Threads, Topics) führt.
{{Randnotiz|RNTyp=y|RNText=Beispiel für das ''ModOwner''-Feld:
:<code>Peter/ph1959de (<nowiki>{{Link2FU|73|Forum}}/[[Benutzer Diskussion:ph1959de|Wiki]]</nowiki>)</code>
sieht dann so aus:
:Peter/ph1959de ({{Link2FU|73|Forum}}/[[Benutzer Diskussion:ph1959de|Wiki]])
}}
; ModForumArea
: Name des Forenbereichs, in dem Supportanfragen zu dem Modul gestellt werden können bzw. sollen. Die Liste der Zuordnung von Modul zu Forenbereich ist in der [http://fhem.de/MAINTAINER.txt Liste der Maintainer] enthalten. Der Text wird automatisch in einen Link auf den Forenbereich umgesetzt.
;ModTechName
:Technischer Name des Moduls (also z. B. <code>01_FHEMWEB.pm</code>; siehe [http://fhem.de/MAINTAINER.txt Liste der Maintainer])
;ModOwner
:Name des Modulerstellers bzw. -betreuers (siehe [http://fhem.de/MAINTAINER.txt Liste der Maintainer])

=== Felder der Infobox ===
;Titelzeile
:Im Regelfall Seitenname=Modulname=Titelzeile. <br>Stimmt der Modulname nicht mit dem Seitentitel überein, muss der Parameter ''ModCmdRef'' angegeben sein und wird hier verwendet.
;Zweck / Funktion
:Dieses Feld wird direkt aus dem Wert des Parameters ''ModPurpose'' gefüllt.
;Typ
:Modultyp, abgeleitet aus dem Parameter ''ModType''.
;Dokumentation
:Verweis auf die Dokumentation zu diesem Modul; das besteht
:*bei "offiziellen" Modulen aus den automatisch generierten Links auf den entsprechenden Abschnitt der commandref und, optional/zusätzlich, wenn der Parameter ''ModFTopic'' angegeben ist, einem Link auf den spezifizierten Forenthread
:*bei "inoffiziellen" oder "contrib" Modulen aus einem Link auf einen Forenthread (sofern ''ModFTopic'' angegeben ist) oder dem schlichten Hinweis auf das Forum.
;Support (Forum)
:Ein Link auf den Forenbereich, in dem Fragen und Fehlerberichte zu diesem Modul eingestellt werden sollen, das jedoch nur, wenn ''ModForumArea'' angegeben ist.
;Modulname
:Der "technische" Name des Moduls, also z.B. ''01_FHEMWEB.pm''
;Ersteller
:Der Name (Forum/Wiki/...) des Modulverantwortlichen.

=== Kopiervorlage ===
Die folgende (generelle) Schablone wird an den Anfang der Zielseite kopiert und ausgefüllt. Weitere, modultypspezifische Beispiele, sind weiter unten aufgeführt.
<pre style="width:50%;">
{{Infobox Modul
|ModPurpose=
|ModType=[cmd|contrib|d|h|x]
|ModCmdRef=
|ModForumArea=
|ModFTopic=
|ModTechName=
|ModOwner=
}}
</pre>

== Weitere kopierfähige Beispiele ==
=== Modultyp "cmd", "d" oder "h" ===

{{Infobox Modul
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModType=d
|ModForumArea=Forenbereich
|ModTechName=77_Device.pm
|ModOwner=Modulersteller
}}
Infobox - mögliche Werte für die Felder bei einem Geräte-(Device-)Modul. Stimmt der Seitenname nicht mit dem Modulnamen (wie in der commandref vorgegeben) überein, muss zusätzlich der Parameter ''ModCmdRef'' angegeben werden.
<pre style="width:50%;"><nowiki>
{{Infobox Modul
|ModPurpose=Sinn und Zweck dieses Moduls (ein Satz)
|ModType=d
|ModForumArea=Forenbereich
|ModTechName=77_Device.pm
|ModOwner=Modulersteller
}}
</nowiki></pre>

<br clear=all>
=== Modultyp "x" oder "contrib" ===

{{Infobox Modul
|ModPurpose=Ein Modul des Typs "contrib"
|ModType=contrib
|ModFTopic=12345
|ModCmdRef=ContribModul
|ModForumArea=Contrib
|ModTechName=66_Contrib.pm
|ModOwner=Contrib-Owner
}}
Infobox - mögliche/empfohlene Werte für die Felder bei einem inoffiziellen Modul. Stimmt der Seitenname nicht mit dem Modulnamen (wie in der commandref vorgegeben) überein, muss zusätzlich der Parameter ''ModCmdRef'' angegeben werden.
<pre style="width:50%;"><nowiki>
{{Infobox Modul
|ModPurpose=Ein Modul des Typs "contrib"
|ModType=contrib
|ModFTopic=12345
|ModCmdRef=ContribModul
|ModForumArea=Contrib
|ModTechName=66_Contrib.pm
|ModOwner=Contrib-Owner
}}
</nowiki></pre>

=== Komplette Liste möglicher Parameter ===
Die folgende Kopiervorlage enthält alle Schlüsselworte ohne Angabe von Werten:

<pre style="width:550px;"><nowiki>
{{SEITENTITEL:...}} 

{{Infobox Modul
|ModPurpose=...
|ModType=...
|ModCmdRef=...
|ModFTopic=...
|ModForumArea=...
|ModTechName=...
|ModOwner=...
}}
</nowiki></pre>

<templatedata>
{
"params": {
"ModCmdRef": {
"label": "Modulname",
"description": "Sofern der Modulname vom Seitennamen abweicht (bspw. Groß-/Kleinschreibung) kann hier der korrekte Modulname angegeben werden, so wie er in der Commandref zu finden ist. Falls nicht angegeben wird der Wiki-Seitentitel als Modulname verwendet",
"type": "string"
},
"ModPurpose": {
"label": "Kurzbeschreibung",
"description": "Eine kurze Beschreibung der Funktion / Zweck des Moduls.",
"type": "string",
"required": true,
"suggested": true
},
"ModType": {
"label": "Modul-Typ",
"description": "Typ des Moduls (einzelner Wert), ausgehend von der Einteilung in der commandref: (\"d\" => Gerätemodul, \"h\" => Hilfsmodul, \"cmd\" => Befehlsmodul, \"u\" => Utilities, \"contrib\" => Inoffizielles Modul im contrib-Verzeichnis, \"x\" => experimentelles Modul)",
"example": "d",
"required": true,
"suggested": true
},
"ModFTopic": {
"label": "Forumsbeitrag",
"description": "Die Topic-ID zu einer Diskussion im Forum um weitere Informationen zu erhalten. Hierbei nur die Topic-ID aus dem Link angeben",
"type": "number"
},
"ModForumArea": {
"label": "Forumsbereich",
"description": "Der Name des Forumsbereich, in dem Fragen zu diesem Modul diskutiert werden sollten.",
"type": "string",
"required": true
},
"ModTechName": {
"label": "Dateiname",
"description": "Der vollständige Dateiname des Moduls",
"example": "01_FHEMWEB.pm",
"type": "string",
"required": true,
"suggested": true
},
"ModOwner": {
"label": "Modulersteller",
"description": "Name des Moulerstellers bzw. -betreuers",
"type": "content"
}
},
"description": "Eine Infobox um die wichtigsten Daten zu einem FHEM-Modul darzustellen."
}
</templatedata>

== Vorschlag für die Struktur/Gliederung einer Modulseite ==
Eine Seite, die die Vorlage ''Infobox Modul'' verwendet, sollte sich an der folgenden Gliederung orientieren (wobei der Schwerpunkt auf Anwendungsbeispiele gelegt werden sollte; Zweck ist es nicht, die commandref zu kopieren oder zu ersetzen):
<pre><nowiki>
{{Infobox Modul
...
}}
[[Modulname]] ist ... und macht ... (allgemeine Beschreibung, etwas mehr,
als unter "ModPurpose" angegeben)

== Voraussetzungen ==
Um Modul xyz benutzen zu können, muss außerdem ...

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:xyz]]

</nowiki></pre>

Die Vorlage ''Infobox Modul'' wird derzeit verwendet auf den [[Special:Linkliste/Vorlage:Infobox Modul|hier]] gelisteten Seiten.

[[Kategorie:Vorlage]]

</noinclude>

Vorlage:Infobox Hardware

2026-01-05T15:24:05Z

Ph1959de: ... give it a fine border

<onlyinclude>
{| class="float-right infobox toccolours" style="margin: 0 0 1em 1em; float:right; border-style: solid; border-width: 1px" width="300"
! colspan="2" style="background-color:#EFEFFF" | {{#if: {{{Name|}}}|{{{Name}}}|{{PAGENAME}} }}
|- bgcolor="#FFFFFF"
| align="center" colspan="2" | [[Datei:{{{Bild}}}|280px|mini|frameless{{#if:{{{Bildbeschreibung|}}}|{{!}}{{{Bildbeschreibung}}}|}}]]

|- style="background-color:#EFEFFF"
! colspan="2" | Allgemein
|- bgcolor="#FFFFFF"
| Protokoll || {{{HWProtocol}}}
|- bgcolor="#FFFFFF"
| Typ || {{{HWType}}}
|- bgcolor="#FFFFFF"
| Kategorie || {{{HWCategory}}}
|- style="background-color:#EFEFFF"
! colspan="2" | Technische Details
|- bgcolor="#FFFFFF"
| Kommunikation || {{{HWComm}}}
|- bgcolor="#FFFFFF"
| Kanäle || {{{HWChannels}}}
|- bgcolor="#FFFFFF"
| Betriebsspannung || {{{HWVoltage}}}
|- bgcolor="#FFFFFF"
| Leistungsaufnahme || {{{HWPowerConsumption}}}
|- bgcolor="#FFFFFF"
| Versorgung || {{{HWPoweredBy}}}
|- bgcolor="#FFFFFF"
| Abmessungen || {{{HWSize}}}
|- style="background-color:#EFEFFF"
! colspan="2" | Sonstiges
|- bgcolor="#FFFFFF"
| Modulname || {{{HWDeviceFHEM}}}
|- bgcolor="#FFFFFF"
{{#if: {{{ModOwner|}}} |
{{!}} Ersteller {{!!}} {{{ModOwner|}}}
}}
|- bgcolor="#FFFFFF"
| Hersteller || {{{HWManufacturer}}}
|}
</onlyinclude>

<noinclude>
__NOTOC__

== Dokumentation ==
Diese Vorlage dient zur Zusammenfassung von Daten zu einer bestimmten, von [[FHEM]] unterstützten Hardwarekomponente.

=== Kopiervorlage(n) ===
<pre style="width:400px;">
{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=
|HWProtocol=
|HWType=
|HWCategory=
|HWComm=
|HWChannels=
|HWVoltage=
|HWPowerConsumption=
|HWPoweredBy=
|HWSize=
|HWDeviceFHEM=

|HWManufacturer=
}}
</pre>

=== Erläuterung der Parameter ===
{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Beschreibung zum Bild
|HWProtocol=FS20 / FHT / HMS / HomeMatic (BidCos) / EnOcean / 1-Wire
|HWType=Server / Sensor / Aktor / Sender / Empfänger / Gateway
|HWCategory=FS20 / Homematic / ...
|HWComm=868 MHz / 1-Wire / LAN / RS485 / ...
|HWChannels=n/a / 1 / ... Anzahl unterstützter Kanäle
|HWVoltage=3V / 230V / ...
|HWPowerConsumption=0,5W / 2 Jahre
|HWPoweredBy=Batterie 2xLR6 / Netz / ...
|HWSize=Abmessungen LxBxH
|HWDeviceFHEM=see commandref, Devices
|ModOwner=Modulersteller
|HWManufacturer=ELV / eQ-3 / EnOcean ...
}}
Das nebenstehende Beispiel zeigt eine Auswahl der für die einzelnen Zeilen vorgesehenen Werte.

; Bild
: Dateiname der zugehörigen Bilddatei (bitte ''PlatzHalter.png'' verwenden, wenn kein eigenes Bild vorhanden ist)
; Bildbeschreibung
: Erläuterungstext zum Bild
; HWProtocol
: Geräteprotokoll (FS20, HomeMatic, etc.)
; HWType
: Gerätetyp (Sensor, Sender, ...); bei HomeMatic Geräten der ''HomeMatic Type ...'', formatiert als <nowiki>[[HomeMatic Type xyz|xyz]]</nowiki>
; HWCategory
: Gerätekategorie (Max, FHT, HMS, HomeMatic, ...)
; HWComm
: Kommunikation (Funk 868MHz, 1-Wire, RS485, ...)
; HWChannels
: Anzahl unterstützter Kanäle
; HWVoltage
: Betriebsspannung
; HWPowerConsumption
: Leistungsaufnahme (Ruhe / Betrieb in W, Batterielebensdauer, ...)
; HWPoweredBy
: Versorgungsart (Batterie, Netz)
; HWSize
: Abmessungen
; HWDeviceFHEM
: Welches FHEM-Modul unterstützt das Gerät; gibt es eine eigene Modulseite, sollte hier <nowiki>[[ModulName]]</nowiki> (in der korrekten Schreibweise der Modulseite) angegeben werden.
; ModOwner
: (optional) Modulersteller / -betreuer
; HWManufacturer
: Hersteller des Geräts

<templatedata>
{
"params": {
"Name": {
"label": "Name",
"description": "Sofern der Gerätename von dem Namen der Wiki-Seite abweicht kann hiermit ein alternativer Name in der Infobox gewählt werden",
"type": "string"
},
"Bild": {
"label": "Bild",
"description": "Die Bezeichnung des Bildes welches im Wiki dazu hochgeladen ist.",
"type": "wiki-file-name",
"required": true,
"suggested": true
},
"Bildbeschreibung": {
"label": "Bildbeschreibung",
"description": "Kurzer Erläuterungstext zum Bild. Erscheint direkt unter dem Bild.",
"type": "string",
"required": true
},
"HWProtocol": {
"label": "Protokoll",
"description": "Name des Übertragunsprotokolls (z.B. FS20, HomeMatic, etc.)",
"example": "HomeMatic",
"type": "string",
"required": true
},
"HWType": {
"label": "Typ",
"description": "Gerätetyp (Sensor, Sender, ...); bei HomeMatic Geräten der HomeMatic Type ..., formatiert als [[HomeMatic Type xyz|xyz]]",
"example": "Sensor",
"type": "content",
"required": true
},
"HWCategory": {
"label": "Gerätekategorie",
"description": "Gerätekategorie (Max, FHT, HMS, HomeMatic, ...)",
"example": "HomeMatic",
"required": true
},
"HWComm": {
"label": "Kommunikationsart",
"description": "Art der Kommunikation (z.B. Funk 868MHz, 1-Wire, RS485, ...)",
"example": "Funk 868MHz",
"required": true
},
"HWChannels": {
"label": "Unterstützte Kanäle",
"description": "Anzahl unterstützter Kanäle",
"type": "string",
"required": true
},
"HWVoltage": {
"label": "Betriebsspannung (V)",
"description": "Die unterstützte Betriebsspannung(-en) des Geräts",
"example": "230V",
"type": "string",
"required": true,
"suggested": true
},
"HWPowerConsumption": {
"label": "Leistungsaufnahme (W)",
"description": "Die durchschnittliche Leistungsaufnahme (Watt) im Betriebszustand.",
"example": "ca. 1W",
"type": "string",
"required": true,
"suggested": true
},
"HWPoweredBy": {
"label": "Stromversorgung",
"description": "Art der Stromversorgung",
"example": "Batterie (2x AA Mignon)",
"type": "string",
"required": true
},
"HWSize": {
"label": "Abmessungen",
"description": "Die Abmessungen des Geräts (LxBxH)",
"type": "string",
"required": true
},
"HWDeviceFHEM": {
"label": "FHEM-Modul",
"description": "Das zugehörige FHEM-Modul, welches diese Hardware steuern kann.",
"example": "CUL_HM",
"required": true
},
"ModOwner": {
"label": "Modulersteller",
"description": "Der Ersteller / Maintainer des zugehörigen FHEM-Moduls."
},
"HWManufacturer": {
"label": "Hersteller",
"description": "Der Name des Geräteherstellers",
"example": "ELV / eQ3",
"type": "string",
"required": true,
"suggested": true
}
},
"description": "Zusammenstellung aller wichtigen Daten/Fakten zu einem Hardware-Gerät.",
"paramOrder": [
"Bild",
"Bildbeschreibung",
"HWProtocol",
"HWType",
"HWCategory",
"HWComm",
"HWChannels",
"HWVoltage",
"HWPowerConsumption",
"HWPoweredBy",
"HWSize",
"HWDeviceFHEM",
"ModOwner",
"HWManufacturer",
"Name"
],
"format": "block"
}
</templatedata>

=== Beispiele ===
Kopiervorlagen für diverse Anwendungssituationen:

==== HomeMatic, batteriebetrieben ====
Beispielvorlage für batteriebetriebenes HomeMatic Gerät:
<pre style="width:400px;">
{{Infobox Hardware
|Bild=PlatzHalter.png
|Bildbeschreibung=Vorderseite mit Beschriftungen
|HWProtocol=HomeMatic
|HWType=[[HomeMatic Type ...|...]]
|HWCategory=HomeMatic
|HWComm=868MHz
|HWChannels=6
|HWVoltage=3V
|HWPowerConsumption=ca. 5 Jahre
|HWPoweredBy=2x1,5V LR03/Micro AAA
|HWSize=55x55x20mm
|HWDeviceFHEM=[[CUL_HM]]
|HWManufacturer=ELV / eQ-3
}}
</pre>

== Vorschlag für die Seitenstruktur ==
Eine Seite, die die Vorlage ''Infobox Hardware'' verwendet, sollte sich an der folgenden Gliederung orientieren. Je nach Ausführlichkeit und Bedarf können natürliche weitere Abschnitte hinzugefügt werden.
<pre style="width:650px;"><nowiki>
{{Infobox Hardware
...
}}
[[GerätebezeichnungXyz]] ist ... und macht ... (allgemeine Beschreibung, etwas mehr,
als unter "BildBeschreibung" angegeben)

== Features ==
Gerät Xyz hat folgende Funktionen...
* Senden
* Empfangen ...

== Hinweise zum Betrieb mit FHEM ==

=== Definition ===

=== Logbeispiel ===

== Bekannte Probleme ==

== ... ==

== Links ==

[[Kategorie:xyz]]

</nowiki></pre>

Diese Vorlage wird derzeit verwendet auf: [[Special:Linkliste/Vorlage:Infobox Hardware|(Seitenliste)]].

[[Kategorie:Vorlage]]
</noinclude>

Vorlage:Randnotiz

2026-01-05T14:23:07Z

Ph1959de: Mediawiki-Update: Folgeaktion(en)

<onlyinclude><div class="thumb tright" style="width:40%;font-size:100%;padding:1em;float:right;background-color:#{{#switch: {{{RNTyp}}}
| g | Info = E0F8E0
| y | Warn = F2F5A9
| r | Fehl = F6CEE3
| #default = E0F8E0}};border:3px solid #{{#switch:{{{RNTyp}}}
| g | Info = 008000
| y | Warn = 868A08
| r | Fehl = FF0000
| #default = 008000}};">[[File:{{#switch: {{{RNTyp}}}
| g | Info = Info_green.png
| y | Warn = Emblem-question-yellow.svg
| r | Fehl = X mark.svg
| #default = Info_green.png}}|20px]]{{{RNText}}}</div>
</onlyinclude>

<noinclude>
== Dokumentation für diese Vorlage ==
Diese Vorlage fügt einen rechtsbündigen, 40% der Seitenbreite einnehmenden Rahmen mit dem angegebenen Text ein. Rahmen- und Hintergrundfarbe sind wählbar und bestimmen das verwendete "Info-Icon" mit. Syntax für die Verwendung ist:
:<code><nowiki>{{Randnotiz|RNTyp=Info|RNText=Text text text ...}}</nowiki></code>
Unterstützte Werte für RNTyp:
* Info (oder g): grüne Box mit Info-Icon
* Warn (oder y): gelbe Box mit Fragezeichen
* Fehl (oder r): rote Box mit Warnschild

Ist ein Hinweistext in Seitenbreite gewünscht, kann dafür die Vorlage [[Vorlage:Hinweis|Hinweis]] verwendet werden.

== Beispiele ==
{{Randnotiz|RNTyp=Fehl|RNText=Rote Box mit rotem Icon}}
<pre style="width:50%;"><nowiki>
{{Randnotiz|RNTyp=Fehl|RNText=Rote Box mit rotem Icon}}
</nowiki></pre>
<br clear=all>


{{Randnotiz|RNTyp=Warn|RNText=Gelbe ListenBox mit gelbem Icon und
* text
# text
... Verwendung von Aufzählungszeichen!
}}
<pre style="width:50%;"><nowiki>
{{Randnotiz|RNTyp=y|RNText=Gelbe ListenBox mit gelbem Icon und
* text
# text
... Verwendung von Aufzählungszeichen!
}}
</nowiki></pre>
<br clear=all>


{{Randnotiz|RNTyp=Info|RNText=Grüne (Default) Box mit Info-Icon}}
<pre style="width:50%;"><nowiki>
{{Randnotiz|RNText=Grüne Box mit Info-Icon}}
</nowiki></pre>
[[Kategorie:Vorlage]]
</noinclude>

Victron

2025-12-28T21:37:48Z

Ph1959de: Diverse Korrekturen (u.a. syntaxhighlight)

==Übersicht==
Die Familie der Solarlade- und -speichergeräte von Victron verwenden verschiedene Bussysteme, um untereinander zu kommunizieren. Sehr angenehm ist, dass die zentrale Steuerung namens Venus (Victron ENergy Unix System :-) frei verfügbar ist, und gern auf einem RaspberryPi läuft. Integriert ist gleich ein [[MQTT]] Server (mit und ohne SSL), der die Meßwerte der angeschlossenen Geräte - und das sind viele - per MQTT anbietet.

Victron ist generell gut dokumentiert: https://www.victronenergy.com/support-and-downloads/technical-information

==Einbindung in FHEM als MQTT2_DEVICE==
Über MQTT2_CLIENT wird zunächst die Verbindung zum Broker auf dem Victron Venus Gerät angelegt (hier ist die IP noch anzupasssen).
defmod venus MQTT2_CLIENT 10.1.x.x:1883
attr venus autocreate complex
attr venus clientOrder MQTT_GENERIC_BRIDGE MQTT2_DEVICE
attr venus room MQTT2_DEVICE
attr venus verbose 4

Der Wechselrichter wird dann als MQTT2_DEVICE angelegt:
defmod MQTT2_mp2 MQTT2_DEVICE venus
attr MQTT2_mp2 IODev venus

===== Aufbau der Topics von Victron =====
Jede Installation ''Venus'' gibt sich eine vrm_ID, die initial aus der Hardwareadresse abgeleitet wird. Über diese ID wird die Installation auf dem [https:///vrm.victronenergy.com Victron VRM Portal] erkannt. In den Beispielen unten taucht sie als <vrm_ID> auf. Die einzelnen Geräte einer Installation erhalten Nummern, die eine Unterscheidung auch mehrerer Wechselrichter (etwa im 3-Phasenbetrieb) oder mehrerer Solarlader ermöglichen.

Nach Verbindung erscheint eine umfangreiche readingList, aus der hier nur einige Elemente verwendet werden.
* system - Konfiguration des Gesamtsystems bzw. konsolidierte Werte
* solarcharger - MPPT-DC-Lader, Anschluß VE-Direct (seriell, baut auf RS-485), Wartung per Bluetooth und App
* grid - [https://www.victronenergy.com/accessories/energy-meter Stromzähler], Anschluß über RS-485 / wahlweise Ethernet
* vebus - Wechselrichter, Anschluß über Cat5, serielles Protokoll

N/<vrm_ID>/system/0/Batteries:.* { json2nameValue($EVENT, 'Batteries_', $JSONMAP) }
N/<vrm_ID>/solarcharger/290/Yield/Power:.* { json2nameValue($EVENT, 'PVPower_', $JSONMAP) }
N/<vrm_ID>/grid/30/Ac/Power:.* { json2nameValue($EVENT, 'GridPower_', $JSONMAP) }
N/<vrm_ID>/vebus/288/Ac/Out/P:.* { json2nameValue($EVENT, 'P_', $JSONMAP) }
N/<vrm_ID>/system/0/SystemState/State:.* { json2nameValue($EVENT, 'State_', $JSONMAP) }
N/<vrm_ID>/vebus/288/Mode:.* { json2nameValue($EVENT, 'Mode_', $JSONMAP) }

===== Topics zum Schreiben =====
Einige Einstellungen sind schreibbar. Die entsprechenden Topics beginnen mit einem W. Eine setList kann beispielsweise so aussehen und erlaubt dann
* An- und Abschalten
* Inverter- und Charger Mode
* Mode: Betriebszustand
* CurrentLimit: max. Strom aus/in das Netz
* MinimumSocLimit: Entladegranze im ESS (Speicher-)Betrieb, solange das Netz anliegt
* Relay[0|1]: Schalte interne Relais
Eine einfache Setlist:

off W/<vrm_ID>/vebus/288/Mode {"value":4}
on W/<vrm_ID>/vebus/288/Mode {"value":3}
inv W/<vrm_ID>/vebus/288/Mode {"value":2}
chg W/<vrm_ID>/vebus/288/Mode {"value":1}
Mode W/<vrm_ID>/vebus/288/Mode {"value":$EVTPART1}
GridCurrentLimit W/<vrm_ID>/vebus/288/Ac/In/1/CurrentLimit {"value":$EVTPART1}
MinSOC W/<vrm_ID>/settings/0/Settings/CGwacs/BatteryLife/MinimumSocLimit {"value":$EVTPART1}
Relay0 W/<vrm_ID>/system/0/Relay/0/State:.* {"value":$EVTPART1}
Relay1 W/<vrm_ID>/system/0/Relay/1/State:.* {"value":$EVTPART1}

==Einbindung über ModbusAttr==
Die verschiedenen Devices werden intern über verschieden Modbusadressen abgefragt.
Dies kann man dem Excel "Modbus-TCP Register List unter Link 1 entnehmen.

Hier ist der Code für ein MultiPlus II-5000 Device (die Unit ID 227 verweist auf den VE.Bus-Port an ttyS4, an welchem ausschließlich jener Multiplus angeschlossen ist). Leider kann ich es mangels Geräten nicht testen, aber ich vermute, dass wenn der Multiplus an einen anderen Port angeschlossen wird, lediglich die Modbus-ID zu ändern ist.

=== Multiplus II ===
<syntaxhighlight lang="Perl">
defmod MultiPlusII_227 ModbusAttr 227 5 192.168.243.38:502 TCP
attr MultiPlusII_227 dev-h-defPoll 1
attr MultiPlusII_227 obj-h0003-expr $val / 10
attr MultiPlusII_227 obj-h0003-len 2
attr MultiPlusII_227 obj-h0003-reading AC_Input_Voltage_L1
attr MultiPlusII_227 obj-h0003-unpack n
attr MultiPlusII_227 obj-h0004-expr $val / 10
attr MultiPlusII_227 obj-h0004-len 2
attr MultiPlusII_227 obj-h0004-reading AC_Input_Voltage_L2
attr MultiPlusII_227 obj-h0004-unpack n
attr MultiPlusII_227 obj-h0005-expr $val / 10
attr MultiPlusII_227 obj-h0005-reading AC_Input_Voltage_L3
attr MultiPlusII_227 obj-h0005-unpack n
attr MultiPlusII_227 obj-h0006-expr $val / 10
attr MultiPlusII_227 obj-h0006-reading AC_Input_Current_L1
attr MultiPlusII_227 obj-h0006-unpack s>
attr MultiPlusII_227 obj-h0007-expr $val / 10
attr MultiPlusII_227 obj-h0007-reading AC_Input_Current_L2
attr MultiPlusII_227 obj-h0007-unpack s>
attr MultiPlusII_227 obj-h0008-expr $val / 10
attr MultiPlusII_227 obj-h0008-reading AC_Input_Current_L3
attr MultiPlusII_227 obj-h0008-unpack s>
attr MultiPlusII_227 obj-h0009-expr $val / 100
attr MultiPlusII_227 obj-h0009-reading AC_Input_Frequency_L1
attr MultiPlusII_227 obj-h0009-unpack s>
attr MultiPlusII_227 obj-h0010-expr $val / 100
attr MultiPlusII_227 obj-h0010-reading AC_Input_Current_L2
attr MultiPlusII_227 obj-h0010-unpack s>
attr MultiPlusII_227 obj-h0011-expr $val / 100
attr MultiPlusII_227 obj-h0011-reading AC_Input_Frequency_L3
attr MultiPlusII_227 obj-h0011-unpack s>
attr MultiPlusII_227 obj-h0012-expr $val * 10
attr MultiPlusII_227 obj-h0012-reading AC_Input_Power_L1
attr MultiPlusII_227 obj-h0012-unpack s>
attr MultiPlusII_227 obj-h0013-expr $val * 10
attr MultiPlusII_227 obj-h0013-reading AC_Input_Power_L2
attr MultiPlusII_227 obj-h0013-unpack s>
attr MultiPlusII_227 obj-h0014-expr $val * 10
attr MultiPlusII_227 obj-h0014-reading AC_Input_Power_L3
attr MultiPlusII_227 obj-h0014-unpack s>
attr MultiPlusII_227 obj-h0015-expr $val / 10
attr MultiPlusII_227 obj-h0015-reading AC_Output_Voltage_L1
attr MultiPlusII_227 obj-h0015-unpack n
attr MultiPlusII_227 obj-h0016-expr $val / 10
attr MultiPlusII_227 obj-h0016-reading AC_Output_Voltage_L2
attr MultiPlusII_227 obj-h0016-unpack n
attr MultiPlusII_227 obj-h0017-expr $val / 10
attr MultiPlusII_227 obj-h0017-reading AC_Output_Voltage_L3
attr MultiPlusII_227 obj-h0017-unpack n
attr MultiPlusII_227 obj-h0018-expr $val / 10
attr MultiPlusII_227 obj-h0018-reading AC_Output_Current_L1
attr MultiPlusII_227 obj-h0018-unpack s>
attr MultiPlusII_227 obj-h0019-expr $val / 10
attr MultiPlusII_227 obj-h0019-reading AC_Output_Current_L2
attr MultiPlusII_227 obj-h0019-unpack s>
attr MultiPlusII_227 obj-h0020-expr $val / 10
attr MultiPlusII_227 obj-h0020-reading AC_Output_Current_L3
attr MultiPlusII_227 obj-h0020-unpack s>
attr MultiPlusII_227 obj-h0021-expr $val / 100
attr MultiPlusII_227 obj-h0021-reading AC_Output_Frequency
attr MultiPlusII_227 obj-h0021-unpack s>
attr MultiPlusII_227 obj-h0022-expr $val / 10
attr MultiPlusII_227 obj-h0022-reading Active_Input_current_Limit
attr MultiPlusII_227 obj-h0022-unpack s>
attr MultiPlusII_227 obj-h0023-expr $val * 10
attr MultiPlusII_227 obj-h0023-reading AC_Output_Power_L1
attr MultiPlusII_227 obj-h0023-unpack s>
attr MultiPlusII_227 obj-h0024-expr $val * 10
attr MultiPlusII_227 obj-h0024-reading AC_Output_Power_L2
attr MultiPlusII_227 obj-h0024-unpack s>
attr MultiPlusII_227 obj-h0025-expr $val * 10
attr MultiPlusII_227 obj-h0025-reading AC_Output_Power_L3
attr MultiPlusII_227 obj-h0025-unpack s>
attr MultiPlusII_227 obj-h0026-expr $val / 100
attr MultiPlusII_227 obj-h0026-reading Battery_Voltage
attr MultiPlusII_227 obj-h0026-unpack n
attr MultiPlusII_227 obj-h0027-expr $val / 10
attr MultiPlusII_227 obj-h0027-reading Battery_Current
attr MultiPlusII_227 obj-h0027-unpack s>
attr MultiPlusII_227 obj-h0028-reading Phase_Count
attr MultiPlusII_227 obj-h0028-unpack n
attr MultiPlusII_227 obj-h0029-map 0:AC Input 1,1:AC Input 2,240:Disconnected
attr MultiPlusII_227 obj-h0029-reading Active_Input
attr MultiPlusII_227 obj-h0029-unpack n
attr MultiPlusII_227 obj-h0030-expr $val / 10
attr MultiPlusII_227 obj-h0030-reading vebus_soc
attr MultiPlusII_227 obj-h0030-unpack n
attr MultiPlusII_227 obj-h0031-map 0:Off,1:Low Power,2:Fault,3:Bulk,4:Absorption,5:Float,6:Storage,7:Equalize,8:Passthru,9:Inverting,10:Power assist,11:Power supply,244:Sustain,252:External controL
attr MultiPlusII_227 obj-h0031-reading vebus_state
attr MultiPlusII_227 obj-h0031-unpack n
attr MultiPlusII_227 obj-h0032-map 0:No error,1:VE.Bus Error Device is switched off because one of the other phases in the system has switched off,2:VE.Bus Error New and old types MK2 are mixed in the system,3:VE.Bus Error Not all- or more than- the expected devices were found in the system,4:VE.Bus Error No other device whatsoever detected,5:VE.Bus Error Overvoltage on AC-out,6:VE.Bus Error Error in DDC Program,7:VE.Bus BMS connected- which requires an Assistant- but no assistant found,10:VE.Bus Error System time synchronisation problem occurred,14:VE.Bus Error Device cannot transmit data,16:VE.Bus Error Dongle missing,17:VE.Bus Error One of the devices assumed master status because the original master failed,18:VE.Bus Error AC Overvoltage on the output of a slave has occurred while already switched off,22:VE.Bus Error This device cannot function as slave,24:VE.Bus Error Switch-over system protection initiated,25:VE.Bus Error Firmware incompatibility. The firmware of one of the connected device is not sufficiently up to date to operate in conjunction with this device,26:VE.Bus Error Internal error
attr MultiPlusII_227 obj-h0032-reading vebus_error
attr MultiPlusII_227 obj-h0032-unpack n
attr MultiPlusII_227 obj-h0033-map 1:Charger Only,2:Inverter Only,3:Charger and Inverter,4:Off
attr MultiPlusII_227 obj-h0033-reading Device_Status
attr MultiPlusII_227 obj-h0033-unpack n
attr MultiPlusII_227 obj-h0033-set 1
attr MultiPlusII_227 obj-h0034-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0034-reading temperature_alarm
attr MultiPlusII_227 obj-h0034-unpack n
attr MultiPlusII_227 obj-h0035-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0035-reading low_battery_alarm
attr MultiPlusII_227 obj-h0035-unpack n
attr MultiPlusII_227 obj-h0036-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0036-reading overload_alarm
attr MultiPlusII_227 obj-h0036-unpack n
attr MultiPlusII_227 obj-h0037-reading ESS_Power_setpoint_L1
attr MultiPlusII_227 obj-h0037-unpack s>
attr MultiPlusII_227 obj-h0038-map 0:Charge allowed,1:Charge disabled
attr MultiPlusII_227 obj-h0038-reading ESS_disable_charge_flag_phase
attr MultiPlusII_227 obj-h0038-unpack n
attr MultiPlusII_227 obj-h0039-map 0:Feed in allowed,1:Feed in disabled
attr MultiPlusII_227 obj-h0039-reading ESS_disable_feedback_flag_phase
attr MultiPlusII_227 obj-h0039-unpack n
attr MultiPlusII_227 obj-h0040-reading ESS_Power_setpoint_L2
attr MultiPlusII_227 obj-h0040-unpack s>
attr MultiPlusII_227 obj-h0041-reading ESS_Power_setpoint_L3
attr MultiPlusII_227 obj-h0041-unpack s>
attr MultiPlusII_227 obj-h0042-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0042-reading temperature_sensor_alarm
attr MultiPlusII_227 obj-h0042-unpack n
attr MultiPlusII_227 obj-h0043-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0043-reading voltage_sensor_alarm
attr MultiPlusII_227 obj-h0043-unpack n
attr MultiPlusII_227 obj-h0044-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0044-reading temperature_alarm_L1
attr MultiPlusII_227 obj-h0044-unpack n
attr MultiPlusII_227 obj-h0045-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0045-reading low_battery_alarm_L1
attr MultiPlusII_227 obj-h0045-unpack n
attr MultiPlusII_227 obj-h0046-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0046-reading overload_alarm_L1
attr MultiPlusII_227 obj-h0046-unpack n
attr MultiPlusII_227 obj-h0047-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0047-reading ripple_alarm_L1
attr MultiPlusII_227 obj-h0047-unpack n
attr MultiPlusII_227 obj-h0048-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0048-reading temperature_alarm_L2
attr MultiPlusII_227 obj-h0048-unpack n
attr MultiPlusII_227 obj-h0049-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0049-reading low_battery_alarm_L2
attr MultiPlusII_227 obj-h0049-unpack n
attr MultiPlusII_227 obj-h0050-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0050-reading overload_alarm_L2
attr MultiPlusII_227 obj-h0050-unpack n
attr MultiPlusII_227 obj-h0051-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0051-reading ripple_alarm_L2
attr MultiPlusII_227 obj-h0051-unpack n
attr MultiPlusII_227 obj-h0052-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0052-reading temperature_alarm_L3
attr MultiPlusII_227 obj-h0052-unpack n
attr MultiPlusII_227 obj-h0053-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0053-reading low_battery_alarm_L3
attr MultiPlusII_227 obj-h0053-unpack n
attr MultiPlusII_227 obj-h0054-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0054-reading overload_alarm_L3
attr MultiPlusII_227 obj-h0054-unpack n
attr MultiPlusII_227 obj-h0055-map 0:Ok,1:Warning,2:Alarm
attr MultiPlusII_227 obj-h0055-reading ripple_alarm_L3
attr MultiPlusII_227 obj-h0055-unpack n
attr MultiPlusII_227 obj-h0056-map 0:PV enabled,1:PV disabled
attr MultiPlusII_227 obj-h0056-reading disable_pv_inverter
attr MultiPlusII_227 obj-h0056-unpack n
attr MultiPlusII_227 obj-h0057-map 0:No,1:Yes
attr MultiPlusII_227 obj-h0057-reading bms_allow_charge
attr MultiPlusII_227 obj-h0057-unpack n
attr MultiPlusII_227 obj-h0058-map 0:No,1:Yes
attr MultiPlusII_227 obj-h0058-reading bms_allow_discharge
attr MultiPlusII_227 obj-h0058-unpack n
attr MultiPlusII_227 obj-h0059-map 0:No,1:Yes
attr MultiPlusII_227 obj-h0059-reading bms_expected
attr MultiPlusII_227 obj-h0059-unpack n
attr MultiPlusII_227 obj-h0060-map 0:No,1:Yes
attr MultiPlusII_227 obj-h0060-reading bms_error
attr MultiPlusII_227 obj-h0060-unpack n
attr MultiPlusII_227 obj-h0061-expr $val / 10
attr MultiPlusII_227 obj-h0061-reading temperature_battery
attr MultiPlusII_227 obj-h0061-unpack s>
attr MultiPlusII_227 obj-h0062-map 1:VE.Bus reset
attr MultiPlusII_227 obj-h0062-reading vebus_reset
attr MultiPlusII_227 obj-h0062-unpack n
attr MultiPlusII_227 obj-h0063-map 0:Ok,1:Warning
attr MultiPlusII_227 obj-h0063-reading phase_rotation_warning
attr MultiPlusII_227 obj-h0063-unpack n
attr MultiPlusII_227 obj-h0064-map 0:Ok,2:Alarm
attr MultiPlusII_227 obj-h0064-reading grid_lost_alarm
attr MultiPlusII_227 obj-h0064-unpack n
attr MultiPlusII_227 obj-h0065-map 0:Feed in overvoltage,1:Do not feed in overvoltage
attr MultiPlusII_227 obj-h0065-reading feed_dc_overvoltage_into_grid
attr MultiPlusII_227 obj-h0065-unpack n
attr MultiPlusII_227 obj-h0066-expr $val * 100
attr MultiPlusII_227 obj-h0066-reading maximum_overvoltage_feedin_power_L1
attr MultiPlusII_227 obj-h0066-unpack n
attr MultiPlusII_227 obj-h0067-expr $val * 100
attr MultiPlusII_227 obj-h0067-reading maximum_overvoltage_feedin_power_L2
attr MultiPlusII_227 obj-h0067-unpack n
attr MultiPlusII_227 obj-h0068-expr $val * 100
attr MultiPlusII_227 obj-h0068-reading maximum_overvoltage_feedin_power_L3
attr MultiPlusII_227 obj-h0068-unpack n
attr MultiPlusII_227 obj-h0069-map 0:AC input not ignored,1:AC input ignored
attr MultiPlusII_227 obj-h0069-reading ac_input_1_ignored
attr MultiPlusII_227 obj-h0069-unpack n
attr MultiPlusII_227 obj-h0070-map 0:AC input not ignored,1:AC input ignored
attr MultiPlusII_227 obj-h0070-reading ac_input_2_ignored
attr MultiPlusII_227 obj-h0070-unpack n
attr MultiPlusII_227 obj-h0071-map 0:AcPowerSetpoint interpreted normally, 1:AcPowerSetpoint is OvervoltageFeedIn limit
attr MultiPlusII_227 obj-h0071-reading ac_power_setpoint_acts_as_feedin_limit
attr MultiPlusII_227 obj-h0071-unpack n
attr MultiPlusII_227 obj-h0072-map 0:OvervoltageFeedIn uses 1V offset, 1:OvervoltageFeedIn uses 0.1V offset
attr MultiPlusII_227 obj-h0072-reading solar_offset_voltage
attr MultiPlusII_227 obj-h0072-unpack n
attr MultiPlusII_227 obj-h0073-map 0:Sustain inactive, 1:Sustain active
attr MultiPlusII_227 obj-h0073-reading sustain_active
attr MultiPlusII_227 obj-h0073-unpack n
attr MultiPlusII_227 obj-h0074-expr $val / 100
attr MultiPlusII_227 obj-h0074-len 2
attr MultiPlusII_227 obj-h0074-reading energy_from_acIn1_to_acOut
attr MultiPlusII_227 obj-h0074-unpack N
attr MultiPlusII_227 obj-h0076-expr $val / 100
attr MultiPlusII_227 obj-h0076-len 2
attr MultiPlusII_227 obj-h0076-reading energy_from_acIn1_to_battery
attr MultiPlusII_227 obj-h0076-unpack N
attr MultiPlusII_227 obj-h0078-expr $val / 100
attr MultiPlusII_227 obj-h0078-len 2
attr MultiPlusII_227 obj-h0078-reading energy_from_acIn2_to_acOut
attr MultiPlusII_227 obj-h0078-unpack N
attr MultiPlusII_227 obj-h0080-expr $val / 100
attr MultiPlusII_227 obj-h0080-len 2
attr MultiPlusII_227 obj-h0080-reading energy_from_acIn2_to_battery
attr MultiPlusII_227 obj-h0080-unpack N
attr MultiPlusII_227 obj-h0082-expr $val / 100
attr MultiPlusII_227 obj-h0082-len 2
attr MultiPlusII_227 obj-h0082-reading energy_from_acOut_to_acIn1
attr MultiPlusII_227 obj-h0082-unpack N
attr MultiPlusII_227 obj-h0084-expr $val / 100
attr MultiPlusII_227 obj-h0084-len 2
attr MultiPlusII_227 obj-h0084-reading energy_from_acOut_to_acIn2
attr MultiPlusII_227 obj-h0084-unpack f>
attr MultiPlusII_227 obj-h0086-expr $val / 100
attr MultiPlusII_227 obj-h0086-len 2
attr MultiPlusII_227 obj-h0086-reading energy_from_battery_to_AcIn1
attr MultiPlusII_227 obj-h0086-unpack f>
attr MultiPlusII_227 obj-h0088-expr $val / 100
attr MultiPlusII_227 obj-h0088-len 2
attr MultiPlusII_227 obj-h0088-reading energy_from_battery_to_AcIn2
attr MultiPlusII_227 obj-h0088-unpack N
attr MultiPlusII_227 obj-h0090-expr $val / 100
attr MultiPlusII_227 obj-h0090-len 2
attr MultiPlusII_227 obj-h0090-reading energy_from_battery_to_AcOut
attr MultiPlusII_227 obj-h0090-unpack f>
attr MultiPlusII_227 obj-h0092-expr $val / 100
attr MultiPlusII_227 obj-h0092-len 2
attr MultiPlusII_227 obj-h0092-reading energy_from_AcOut_to_battery
attr MultiPlusII_227 obj-h0092-unpack N
attr MultiPlusII_227 obj-h0094-map 0:OK,1:Warning
attr MultiPlusII_227 obj-h0094-reading low_cell_voltage_imminent
attr MultiPlusII_227 obj-h0094-unpack n
attr MultiPlusII_227 obj-h0095-map 0:Initialising,1:Bulk,2:Absorption,3:Float,4:Storage,5:Absorb repeat,6:Forced absorb,7:Equalise,8:Bulk stopped,9:Unknown
attr MultiPlusII_227 obj-h0095-reading charge_state
attr MultiPlusII_227 obj-h0095-unpack n
attr MultiPlusII_227 obj-h0096-reading ESS_Power_setpoint_L1
attr MultiPlusII_227 obj-h0096-unpack f>
attr MultiPlusII_227 obj-h0098-len 2
attr MultiPlusII_227 obj-h0098-reading ESS_Power_setpoint_L2
attr MultiPlusII_227 obj-h0098-unpack f>
attr MultiPlusII_227 obj-h0100-len 2
attr MultiPlusII_227 obj-h0100-reading ESS_Power_setpoint_L2
attr MultiPlusII_227 obj-h0100-unpack f>
attr MultiPlusII_227 obj-h0102-map 0:Renewable energy not preferred,1:Renewable energy preferred
attr MultiPlusII_227 obj-h0102-reading prefer_renewable_energy
attr MultiPlusII_227 obj-h0102-unpack n
attr MultiPlusII_227 obj-h0103-map 0:Generator not selected,1:Generator selected
attr MultiPlusII_227 obj-h0103-reading select_remote_generator
attr MultiPlusII_227 obj-h0103-unpack n
attr MultiPlusII_227 obj-h0104-map 0:Generator not selected,1:Generator selected
attr MultiPlusII_227 obj-h0104-reading remote_generator_selected
attr MultiPlusII_227 obj-h0104-unpack n
attr MultiPlusII_227 obj-h0105-map 0:No Action, 1:Redetect System
attr MultiPlusII_227 obj-h0105-reading redetect_vebus_system
attr MultiPlusII_227 obj-h0105-unpack n
attr MultiPlusII_227 obj-h0106-expr $val / 100
attr MultiPlusII_227 obj-h0106-reading powerAssist_boost_factor
attr MultiPlusII_227 obj-h0106-unpack n
attr MultiPlusII_227 obj-h0107-expr $val / 100
attr MultiPlusII_227 obj-h0107-reading configured_output_voltage
attr MultiPlusII_227 obj-h0107-unpack n
attr MultiPlusII_227 obj-h0108-map 0:disabled, 1:enabled
attr MultiPlusII_227 obj-h0108-reading powerAssist_enabled
attr MultiPlusII_227 obj-h0108-unpack n
attr MultiPlusII_227 obj-h0109-map 0:disabled, 1:enabled
attr MultiPlusII_227 obj-h0109-reading ups_function_enabled
attr MultiPlusII_227 obj-h0109-unpack n
attr MultiPlusII_227 room Solar->Victron
</syntaxhighlight>

=== Cerbo GX mit Unit ID 100 ===
<syntaxhighlight lang="Perl">
defmod Cerbo_100 ModbusAttr 100 5 192.168.243.38:502 TCP
attr Cerbo_100 dev-h-defPoll 1
attr Cerbo_100 obj-h0800-len 6
attr Cerbo_100 obj-h0800-reading system_serial
attr Cerbo_100 obj-h0800-unpack Z12
attr Cerbo_100 obj-h0806-map 0:Open,1:Closed
attr Cerbo_100 obj-h0806-reading CCGX_relay_state_1
attr Cerbo_100 obj-h0806-unpack n
attr Cerbo_100 obj-h0807-map 0:Open,1:Closed
attr Cerbo_100 obj-h0807-reading CCGX_relay_state_2
attr Cerbo_100 obj-h0807-unpack n
attr Cerbo_100 obj-h0808-reading PV_AC_Coupled_output_L1
attr Cerbo_100 obj-h0808-unpack n
attr Cerbo_100 obj-h0809-reading PV_AC_Coupled_output_L2
attr Cerbo_100 obj-h0809-unpack n
attr Cerbo_100 obj-h0810-reading PV_AC_Coupled_output_L3
attr Cerbo_100 obj-h0810-unpack n
attr Cerbo_100 obj-h0811-reading PV_AC_Coupled_input_L1
attr Cerbo_100 obj-h0811-unpack n
attr Cerbo_100 obj-h0812-reading PV_AC_Coupled_input_L2
attr Cerbo_100 obj-h0812-unpack n
attr Cerbo_100 obj-h0813-reading PV_AC_Coupled_input_L3
attr Cerbo_100 obj-h0813-unpack n
attr Cerbo_100 obj-h0814-reading PV_AC_Coupled_generator_L1
attr Cerbo_100 obj-h0814-unpack n
attr Cerbo_100 obj-h0815-reading PV_AC_Coupled_generator_L2
attr Cerbo_100 obj-h0815-unpack n
attr Cerbo_100 obj-h0816-reading PV_AC_Coupled_generator_L3
attr Cerbo_100 obj-h0816-unpack n
attr Cerbo_100 obj-h0817-reading AC_consumption_L1
attr Cerbo_100 obj-h0817-unpack n
attr Cerbo_100 obj-h0818-reading AC_consumption_L2
attr Cerbo_100 obj-h0818-unpack n
attr Cerbo_100 obj-h0819-reading AC_consumption_L3
attr Cerbo_100 obj-h0819-unpack n
attr Cerbo_100 obj-h0820-reading grid_L1
attr Cerbo_100 obj-h0820-unpack s>
attr Cerbo_100 obj-h0821-reading grid_L2
attr Cerbo_100 obj-h0821-unpack s>
attr Cerbo_100 obj-h0822-reading grid_L3
attr Cerbo_100 obj-h0822-unpack s>
attr Cerbo_100 obj-h0823-reading genset_L1
attr Cerbo_100 obj-h0823-unpack s>
attr Cerbo_100 obj-h0824-reading genset_L2
attr Cerbo_100 obj-h0824-unpack s>
attr Cerbo_100 obj-h0825-reading genset_L3
attr Cerbo_100 obj-h0825-unpack s>
attr Cerbo_100 obj-h0826-map 0:Unknown,1:Grid,2:Generator,3:Shore power,240:Not connected
attr Cerbo_100 obj-h0826-reading active_input_source
attr Cerbo_100 obj-h0826-unpack s>
attr Cerbo_100 obj-h0830-len 4
attr Cerbo_100 obj-h0830-reading system_UTC_time
attr Cerbo_100 obj-h0830-unpack Q
attr Cerbo_100 obj-h0840-expr $val / 10
attr Cerbo_100 obj-h0840-reading battery_voltage_system
attr Cerbo_100 obj-h0840-unpack n
attr Cerbo_100 obj-h0841-expr $val / 10
attr Cerbo_100 obj-h0841-reading battery_current_system
attr Cerbo_100 obj-h0841-unpack s>
attr Cerbo_100 obj-h0842-reading battery_power_system
attr Cerbo_100 obj-h0842-unpack s>
attr Cerbo_100 obj-h0843-reading battery_soc_system
attr Cerbo_100 obj-h0843-unpack n
attr Cerbo_100 obj-h0844-map 0:idle,1:charging,2:discharging
attr Cerbo_100 obj-h0844-reading battery_state_system
attr Cerbo_100 obj-h0844-unpack n
attr Cerbo_100 obj-h0845-expr $val /-10
attr Cerbo_100 obj-h0845-reading battery_consumed_amphours_system
attr Cerbo_100 obj-h0845-unpack n
attr Cerbo_100 obj-h0846-expr $val * 100
attr Cerbo_100 obj-h0846-reading battery_timetogo_system
attr Cerbo_100 obj-h0846-unpack n
attr Cerbo_100 obj-h0850-reading PV_DC_Coupled_power
attr Cerbo_100 obj-h0850-unpack n
attr Cerbo_100 obj-h0851-expr $val /10
attr Cerbo_100 obj-h0851-reading PV_DC_Coupled_current
attr Cerbo_100 obj-h0851-unpack s>
attr Cerbo_100 obj-h0855-reading charger_power
attr Cerbo_100 obj-h0855-unpack n
attr Cerbo_100 obj-h0860-reading dc_system_power
attr Cerbo_100 obj-h0860-unpack s>
attr Cerbo_100 obj-h0865-expr $val /10
attr Cerbo_100 obj-h0865-reading vebus_charge_current_system
attr Cerbo_100 obj-h0865-unpack s>
attr Cerbo_100 obj-h0866-reading vebus_charge_power_system
attr Cerbo_100 obj-h0866-unpack s>
attr Cerbo_100 obj-h0867-reading RESERVED
attr Cerbo_100 obj-h0867-unpack n
attr Cerbo_100 obj-h0868-expr $val /10
attr Cerbo_100 obj-h0868-reading inverter_charger_current
attr Cerbo_100 obj-h0868-unpack f>
attr Cerbo_100 obj-h0870-len 2
attr Cerbo_100 obj-h0870-reading inverter_charger_power
attr Cerbo_100 obj-h0870-unpack f>
attr Cerbo_100 obj-h0872-len 2
attr Cerbo_100 obj-h0872-reading power_between_meter_and_charger_L1
attr Cerbo_100 obj-h0872-unpack f>
attr Cerbo_100 obj-h0874-len 2
attr Cerbo_100 obj-h0874-reading power_between_meter_and_charger_L2
attr Cerbo_100 obj-h0874-unpack f>
attr Cerbo_100 obj-h0876-len 2
attr Cerbo_100 obj-h0876-reading power_between_meter_and_charger_L3
attr Cerbo_100 obj-h0876-unpack f>
attr Cerbo_100 obj-h0878-len 2
attr Cerbo_100 obj-h0878-reading power_output_inverter_charger_L1
attr Cerbo_100 obj-h0878-unpack f>
attr Cerbo_100 obj-h0880-len 2
attr Cerbo_100 obj-h0880-reading power_output_inverter_charger_L2
attr Cerbo_100 obj-h0880-unpack f>
attr Cerbo_100 obj-h0882-len 2
attr Cerbo_100 obj-h0882-reading power_output_inverter_charger_L3
attr Cerbo_100 obj-h0882-unpack f>
attr Cerbo_100 room Solar->Victron
</syntaxhighlight>

==Visualisierung==
'''stateFormat''' kann so aussehen:
SSOC Batteries_value_1_soc,
SOC: Batteries_value_1_soc % (MinimumSocLimit_value),
Bat: Batteries_value_1_power W,
PV: PVPower_value W,
ACin: GridPower_value W,
ACout2: P_value W,
State: State_value,
Mode: Mode_value
SSOC wird später für das devStateIcon genutzt.

Das '''[[devStateIcon]]''' bietet einen ersten Blick auf den Ladestand:
SSOC\s[2|3|4].+:measure_battery_25
SSOC\s[5|6].+:measure_battery_50
SSOC\s[7|8].+:measure_battery_75
SSOC\s[9].+:measure_battery_100

Derzeit existiert noch kein Template, aber das kann sich ja ändern.

==Externe Links==
*[https://www.victronenergy.com/support-and-downloads/technical-information Victron Technical Info]
*[https://vrm-api-docs.victronenergy.com/#/ VRm API]
*[https://github.com/victronenergy/dbus-mqtt Venus MQTT Broker]

LightScene

2025-12-28T21:28:56Z

Ph1959de: Syntaxhighlight korrigiert

{{Infobox Modul
|ModPurpose=Speicherung und Wiederherstellung des Zustands von einer Gruppe von Geräten.
|ModType=h


|ModTechName=31_LightScene.pm
|ModOwner=justme1968
}}

'''LightScene''' ist ein Hilfsmodul, das es erlaubt, Zustände einer Gruppe von Geräten abzuspeichern und wiederherzustellen.

== Anwendung ==
=== Define ===
:<code>define <name> LightScene [<dev1>] [<dev2>] [<dev3>] ... </code>
:Beispiele:<syntaxhighlight lang="Perl">
define light_group LightScene Lampe1 Lampe2 Dimmer1
define kino_group LightScene LampeDecke LampeFernseher Fernseher Verstaerker
define Wohnzimmer LightScene Leinwand Beamer TV Leselampe Deckenlampe
</syntaxhighlight>
Die Gerätedetailansicht zeigt eine HTML-Übersicht über den aktuellen Zustand aller eingebundenen Geräte und aller konfigurierten Szenen mit den jeweiligen Gerätezuständen. Die Spaltenüberschrift mit den Gerätenamen ist anklickbar, um zur Detailansicht dieses Geräts zu gelangen. Die erste Zeile, die den aktuellen Gerätezustand anzeigt, ist anklickbar und sollte wie ein Klick auf das Gerätesymbol in einer Raumübersicht reagieren. Damit kann interaktiv eine neue Szene konfiguriert und mit dem Befehlsmenü der Detailansicht gespeichert werden. Die erste Spalte der Tabelle mit den Szenennamen ist anklickbar, um die Szene zu aktivieren.
:'''Achtung''': nach einer Änderung von Szenen muss die FHEM-Konfiguration gespeichert werden, auch wenn nicht wie üblich mit einem roten Fragezeichen angezeigt wird, dass die Konfiguration geändert hat.
:Ein Weblink mit einer Szenenübersicht, der in jeden Raum oder Grundriss eingebunden werden kann, lässt sich erstellen mit:
<syntaxhighlight lang="Perl">
define wlScene weblink htmlCode {LightScene_2html("LightSceneName")}
</syntaxhighlight>

=== Set ===

=== Get ===

=== Attributes ===

== Funktionen ==

== Anwendungsbeispiele ==
* [[XBMC#Lichtsteuerung_durch_KODI_oder_PLEX|Lichtsteuerung durch KODI oder PLEX]]
* [[Zuhause-Status|Umsetzung Zuhause-Status mit LightScene]]
* [[ReadingsGroup#LightScene_DropDown-Men.C3.BC_f.C3.BCr_smallscreen_Styles_oder_Floorplan|LightScene-DropDown-Menü für Smallscreen-Styles oder Floorplan]]

== Links ==
* weitere Dokumentation
* ...

Modul FBTAM

2025-12-28T18:45:58Z

Ph1959de: Typografie; Codefragmente mit Syntaxhighlight

{{Infobox Modul
|ModPurpose=Das Modul stellt eine komfortable Oberfläche bereit, um den Anrufbeantworter der FritzBox abzufragen und zu steuern
|ModType=h
|ModCmdRef=FBTAM
|ModForumArea=Fritz!Box
|ModTechName=72_FBTAM.pm
|ModOwner=Prof. Dr. Peter A. Henning
}}
Für Supportanfragen bitte ''{{Link2Forum|Topic=142205.0|LinkText=diesen Forenthread}}'' verwenden.

=Allgemeines=
Das Modul ''72_FBTAM.pm'' stellt eine komfortable Oberfläche bereit, um den Anrufbeantworter der FritzBox abzufragen und zu steuern.

Zur Einrichtung muss das Modul ''72_FBTAM.pm'' im Modulpfad installiert werden, ebenso die JavaScript-Datei ''fbtam.js'' in www/pgm2.

'''Achtung''': Derzeit geht das Modul davon aus, dass lokal (d.h. in derselben FHEM-Installation) ein Device vom Typ FRITZBOX existiert. Ggf. wird dies in Kürze noch vereinfacht, so dass nur im lokalen Subnetz eine FritzBox existieren muss.
==Definition==
Das FHEM-Device wird in der folgenden Dokumentation mit dem Namen "FritzBoxTAM" verwendet und definiert als
define FritzBoxTAM FBTAM <Name des FRITZBOX-Devices> <Nummer des verwalteten Anrufbeantworters 1..4>
Das Device verfügt dann über die folgenden Attribute
* ''username'' ist ein Benutzername der FritzBox, welcher das Recht zu Abfragen des Anrufbeantworters haben muss
* ''interval'' ist das Abfrageintervall bei der FritzBox, Default = 60 (Sekunden)
* ''targetdir'' ist das Speicherverzeichnis für heruntergeladene Nachrichten, Default = /opt/fhem/www/audio
* ''MailFun'' ist eine mit Perl (nicht FHEM!) ausführbare Funktion zum Versand von Mails. In diesem Funktionstemplate wird beim Versand der String REC durch die Mailadresse des jeweiligen Empfängers, der String META durch die Metadaten der Nachricht und der String FILE durch den Dateinamen der gespeicherten Nachrichtendatei ersetzt.
Beispiel für diesen Attributwert:
attr FritzBoxTAM MailFun sendMail("REC","Anrufbeantworter","META","FILE")
* ''MailRecList'' ist eine durch Leerzeichen getrennte Liste von Mailadressen, an welche ggf. Emails betreffend die Nachrichten versandt werden sollen. '''Achtung''': Das Zeichen "@" muss in dieser Liste stets als "\@" geschrieben werden.
* ''MsgrType'' ist eine Bezeichnung für den Instant Messenger, mit welchem Messages zu den Nachrichten versendet werden sollen.
Beispiel für diesen Attributwert:
attr FritzBoxTAM MsgrType Telegram
* ''MsgrFun'' ist eine mit Perl (nicht FHEM!) ausführbare Funktion zum Versand von Messages. In diesem Funktionstemplate wird beim Versand der String REC durch die Adresse des jeweiligen Empfängers, der String META durch die Metadaten der Nachricht und der String FILE durch den Dateinamen der gespeicherten Nachrichtendatei ersetzt.
Beispiel für diesen Attributwert:
attr FritzBoxTAM MsgrFun fhem('set TelegramBot sendMedia REC FILE')
* ''MsgrRecList'' ist eine durch Leerzeichen getrennte Liste von Messenger-Adressen, an welche ggf. Kurznachrichten betreffend die Nachrichten versandt werden sollen. '''Achtung''': Das Zeichen "@" muss in dieser Liste stets als "\@" geschrieben werden.
* ''Wav2MP3Fun'' ist eine mit Perl (nicht FHEM!) ausführbare Funktion zum Umwandeln von WAV-Dateien in MP3-Dateien. In diesem Funktionstemplate wird der String INPUT durch den Dateinamen der WAV-Datei, OUTPUT durch den Namen der zu erstellenden MP3-Datei ersetzt. '''Achtung''': Oftmals wird für eine solche Konversion das Paket ffmpeg verwendet. Das kann ziemlich mächtig sein, obwohl für den speziellen Zweck nur ein Bruchteil davon benötigt wird. In dem Wiki-Artikel [[Minimales_ffmpeg]] wird erläutert, wie man eine weniger als 2 MByte große Minimalversion des Konversionsprogramms erzeugen kann.
Beispiel für diesen Attributwert:
attr FritzBoxTAM Wav2MP3Fun system('ffmpeg -loglevel error -y -i INPUT -metadata title=\"META\" OUTPUT')
Hinweis: Die Option "-loglevel error" sorgt dafür dass das FHEM Logfile nicht mit Daten des Konversionsprogramms ffmpeg geflutet wird, die Option "-y" sorgt dafür, dass existierende MP3-Dateien ohne Rückfrage überschrieben werden.

== Bedienung ==
Nach der Einrichtung wird regelmäßig die FritzBox nach den gespeicherten Nachrichten befragt. Falls Nachrichten vorhanden sind, erfolgt die Anzeige in einer Tabelle.
* 1.Spalte: Index der Nachricht in der FritzBox = laufende Nummer beginnend bei 0. Ein "*" bei diesem Index zeigt an, dass die Nachricht "neu" ist und noch nicht abgehört wurde.
* 2.Spalte: Datum, Uhrzeit und Dauer der Nachricht
* 3.Spalte: Anrufername und Telefonnummer. Falls der Name nicht bekannt ist, wird die Nummer als Name verwendet
* 4.Spalte: Aktionsbuttons für
** den Versand per Instant Messenger (nur, wenn das Attribut ''MsgrFun'' gesetzt ist) an alle Empfänger in der ''MsgrRecList''
** den Versand per Email (nur, wenn das Attribut ''MailFun'' gesetzt ist) an alle Empfänger in der ''MailRecList''
** das Löschen der Nachricht
** den Download der Nachricht in das durch das Attribut ''targetdir'' bestimmte Verzeichnis
* '''Achtung''': Die korrekte Funktion der Buttons ist nur sichergestellt, wenn die Datei ''fbtam.js'' im Verzeichnis /opt/fhem/www/pgm2 vorhanden ist.

Kommandozeilenbefehle (bzw. über den Button "set FritzBoxTAM ..." auswählbar sind
* ''update'' für sofotiges manuelles Update der Anzeige
* ''deleteMsg <Index der Nachricht>'' für das Löschen
* ''downloadMsg <Index der Nachricht>'' für den Download
* ''sendMessengerMsg <Index der Nachricht> [<Empfänger>]
* ''sendEmailMsg <Index der Nachricht> [<Empfänger>]
* ''on'' Einschalten, ''off'' Ausschalten des Anrufbeantworters
* '' username <Username>'' und ''password <Passwort>''

== Verwendung mit Telegram ==
Mit den nachfolgend beschriebenen Codefragmenten kann der Anrufbeantworter über den Instant Messenger Telegram gesteuert und abgehört werden. Das sieht dann ungefähr so aus.
[[File:Fbtamtg1.png|800px]]

Das Modul 72_FBTAM.pm stellt eine interne Funktion ''FBTAM_renderTgTable'', bereit, die als einziges Argument den Geräte-Hash des FBTAM-Devices benötigt. Von außen kann man diese Funktion also aufrufen als
{FBTAM_renderTgTable($defs{'FritzBoxTAM'})
und erhält als Rückgabewert etwas von der Form
([2*] Peter, 24.08.25:tam_line 0_2) ([1*] Paul, 23.08.25:tam_line 0_1) ([0] Mary, 22.08.25:tam_line 0_0) ENDMENU Anrufbeantworter=on, 2 neue / 1 alte Nachrichten
Speichert man diesen Rückgabewert z.B. im Reading ''fbtamSource'' des Telegram-Bots, kann man mit dem nachfolgenden Codefragment eine Übersicht der gespeicherten Nachrichten als Telegram Inline-Keyboard erzeugen:
<syntaxhighlight lang="Perl">
my $cmd = ReadingsVal("TelegramBot","fbtamSource","");
$cmd =~ s/ENDMENU/$Kommunikation$ $Hauptmenü$/;
if( $cmd =~ /=on/ ){
$cmd = "(Ausschalten:tam_switch off) $cmd";
}else{
$cmd = "(Einschalten:tam_switch on) $cmd";
}
$cmd = "set TelegramBot queryEditInline $menuMsgId \@$queryPeer $cmd";
fhem("$cmd");
</syntaxhighlight>
Dabei wird ENDMENU durch Menüeinträge des Inline-Keyboards ersetzt, die beim Anklicken auf eine höhere Ebene (z.B. "Kommunikation" oder "Hauptmenü" führen sollen.
Außerdem wird an erster Stelle des erzeugten Telegram Keyboards ein Menüeintrag erzeut, mit dem man den Anrufbeantworter an- bzw. Ausschalten kann.

Klickt man nun in Telegram den Button für An- oder Ausschalten an, wird im Bot eine Message mit Nachrichteninhalt ''tam_switch <on/off>'' registriert. Klickt man nun in Telegram eine der angezeigten Einzelnachrichten an, wird im Bot eine Message mit Nachrichteninhalt ''tam_line <n>_<m>'' empfangen. Darin ist <n> der Index des Anrufbeantworters (0 für AB 1, 1 für AB2, ...) und <m> der Index der Nachricht. Diese Message kann man wiederum abfangen. Angenommen, das erste Wort des Nachrichteninhalt sein in $cb1 gespeichert, das zweite in $cb2, so kann das Codefragment
<syntaxhighlight lang="Perl">
...
#-- Level 4 - Hauptmenü->Kommunikation->Anrufbeantworter->An/ausschalten
}elsif( $cb1 eq "tam_switch"){
Log 1,"[telegramRecognition] Level 4 - Hauptmenü->Kommunikation->Anrufbeantworter->An/Ausschalten"
if( $debug);
fhem("set FritzBoxTAM $cb2");
... (hier weitere Aktionen, z.B. re-display der Daten)
return;

#-- Level 4 - Hauptmenü->Kommunikation->Anrufbeantworter->Einzelnachricht
}elsif( $cb1 =~ /tam_line/){
Log 1,"[telegramRecognition] Level 4 - Hauptmenü->Kommunikation->Anrufbeantworter->Nachricht"
if( $debug);
#-- create array from raw list
my $src = ReadingsVal("TelegramBot","fbtamSource","");
$src =~ s/^$//;
$src =~ s/$\s\w.*$//;
my @srces = split /\)\s*\(/,$src;
#-- look up msgIndex in this array
$cb2 =~ /(\d)_(\d+)/;
my $tamIndex=$1;
my $msgIndex=$2;
my $found=0;
my ($si,$sname,$sdate);
for( my $i=0;$i< int(@srces);$i++){
my $msg=$srces[$i];
$msg =~/\[(\d+)\*?\] (\w.*)\, ([\d\.]*)\:.*/;
$si=$1;
$sname=$2;
$sdate=$3;
if( $si == $msgIndex){
$found=1;
last;
}
}
if( $found ){
fhem("set TelegramBot queryEditInline $menuMsgId \@$queryPeer (Abhören:tam_read $cb2|Löschen:tam_delete $cb2) (Anrufbeantworter:tam_main) (Kommunikation) (Hauptmenü) Nachricht $msgIndex von $sname am $sdate;");
}else{
fhem("set TelegramBot queryEditInline $menuMsgId \@$queryPeer (Anrufbeantworter:tam_main) (Hauptmenü) Kommunikation;");
}
return;
</syntaxhighlight>
zunächst den Anrufbeantworter an- oder ausschalten oder eine Einzelnachricht anzeigen. Mit dem nachfolgenden Codefragment kann eine Nachricht dann gelöscht oder als MP3-Datei an den Client gesendet werden
<syntaxhighlight lang="Perl">
#-- Level 5 - Hauptmenü->Kommunikation->Anrufbeantworter->Einzelnachricht->Abhören
}elsif( $cb1 eq "tam_read"){
Log 1,"[telegramRecognition] Level 5 - Hauptmenü->Kommunikation->Anrufbeantworter->Einzelnachricht->Abhören"
if( $debug);
$cb2 =~ /(\d)_(\d+)/;
my $tamIndex=$1;
my $msgIndex=$2;
fhem("set FritzBoxTAM sendMessengerMsg $msgIndex");
return;

#-- Level 5 - Hauptmenü->Kommunikation->Anrufbeantworter->Einzelnachricht->Löschen
}elsif( $cb1 eq "tam_delete"){
Log 1,"[telegramRecognition] Level 5 - Hauptmenü->Kommunikation->Anrufbeantworter->Einzelnachricht->Löschen"
if( $debug);
$cb2 =~ /(\d)_(\d+)/;
my $tamIndex=$1;
my $msgIndex=$2;
fhem("set FritzBoxTAM deleteMsg $msgIndex");
... (weitere Aktionen, z.B. re-display)
return
}
</syntaxhighlight>

[[Kategorie:FritzBox]]

Strombörse

2025-12-19T16:01:29Z

Ph1959de: Kategorie und Baustellenmarkierung eingefügt

{{Todo|Diese Wiki Seite ist noch in Bearbeitung! <br>Siehe auch {{Link2Forum|Topic=142165|LinkText=HTTPMOD: Aktueller Strompreis EEX Strombörse Leipzig abfragen}}}}
[[Bild:Screenshot 2024-01-23 122115.png|mini|400px|rechts|EVU_Tibber_connect]]
Diese Seite beinhaltet Informationen für die Anbindung von Energieversorgungsunternehmen (EVU), die ihre Preise nach der Strombörse z.B. im Stundenrhythmus anbieten.

Als Beispiel wären da:
# {{Link2Forum|Topic=130407|LinkText=Tibber - im Forum}}
# {{Link2Forum|Topic=135906|LinkText=aWATTar - im Forum}}
# {{Link2Forum|Topic=135906|LinkText=EPEX_Spot}}

== 1. Tibber mit Tibber Pulse ==
Eine momentan verbreitete Methode zur Anbindung an Tibber ist ein Lesekopf auf dem EVU Zähler, der als "Tibber Pulse" vertrieben wird. Damit wird ein bestehender digitaler EVU Zähler ausgelesen und die Werte per LAN zu Tibber gesendet. Über eine API bei Tibber können dann die Verbrauchswerte und Kosten sowie ein Live Stream (WebSocket) abgefragt werden.

Die im Folgenden beschriebenen Beispieldevices bieten die oben genannte Abfrage der API mit WebSocket und [[HTTPMOD]]. Das EVU_Tibber Device dient der Darstellung und Steuerung.

=== Vorausetzungen ===
* FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)
* KeyValue() (wird hier beschrieben)
* homeID und personal Token/Access Token/Connect Token
* Tibber Pulse Lesekopf auf dem digitalen EVU Zähler
* Man sollte bereits Tibber Kunde sein, da ansonsten nur Demo Daten abgerufen werden können

=== Token ===
Der Token wird leider unterschiedlich bezeichnet, aber egal ob er personal Token, Access Token oder Connect Token heisst, es bezieht sich auf den gleichen.

Erhältlich ist dieser aktuell (Oktober 24) unter https://developer.tibber.com/

Dort bitte mit deinen Zugangsdaten einloggen ("Sign In", oben rechts) und man bekommt den Access Token direkt angezeigt.

=== homeID ===
Um eine HomeID zu erhalten, muss zuerst der Pulse mit dem Internet bzw. tibber verbunden werden. Wenn die App glücklich ist, gehts hier weiter:

Man loggt sich wieder ein unter https://developer.tibber.com/. Dort geht man dann zum API Explorer.

Leider ist keine der Demo-Abfragen geeignet, die homeID zu erfahren. Dafür gibt man ins linke fenster folgenden Code ein:
<syntaxhighlight lang="Perl">
{
viewer {
homes {
id
address {
address1
postalCode
}
}
}
}
</syntaxhighlight>
Dann startet man mit dem Play-Pfeil und bekommt auf der rechten Seite etwa folgende Ausgabe:

<syntaxhighlight lang="Perl">
{
"data": {
"viewer": {
"homes": [
{
"id": "1234abcd-12ab-34cd-56ef-1234abcd12ab
"address": {
"address1": "Musterstr.1",
"postalCode": "12345"
}
}
]
}
}
}
</syntaxhighlight>
Diese ID ist die homeID und kann unten verwendet werden.

=== EVU_Tibber_connect ===
Das EVU_Tibber_connect fragt mit HTTPMOD Statistiken auf der Tibber API Webseite ab. Zusätzlich wurde in den userReadings die WebSocket Verbindung für die Live Daten integriert.
* Die WebSocket Verbindung wurde leicht angepasst '''[[Websocket|von hier]]''' übernommen
* Im Forum wurde dies '''{{Link2Forum|Topic=130407|Message=1298863|LinkText=ab hier}}''' bearbeitet

==== Verwendete Module ====
* HTTPMOD
* DbLog
* DbRep
* DOIF
* KeyValue()

==== Ablage der homeID und des Tokens ====
Eine Verbindung zur Tibber API mit den '''tatsächlichen Preisen''' bekommen nur Kunden, ansonsten kann man eine Demo mit Kosten in Schwedischen Kronen testweise abfragen.

In diesem Beispiel Device kann man seine homeID und sein Token entweder als Attribut ablegen oder man macht einen Eintrag im KeyStore von FHEM, wodurch man nicht so leicht versehentlich seine Daten im Forum postet.

Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im Datensystem oder im Konfigurationsfile zu finden sind.
Die Funktion befindet sich in der 99_myUtils.pm .

===== Beispiel KeyValue() =====
'''Achtung, der KeyValue ist kein Schutz für Passwort oder Keys!'''
Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im FHEM Device oder im Konfigurationsfile zu finden sind.
Die Funktion befindet sich in der 99_myUtils .

====== KeyValue() Funktion in der ~/FHEM/99_myUtils.pm ======
<syntaxhighlight lang="Perl">
sub KeyValue {
my ($step, $index, $value) = @_;
my $key = getUniqueId().$index;
my $e_value = "";
my $error;

if (eval "use Digest::MD5;1") {
$key = Digest::MD5::md5_hex(unpack "H*", $key);
$key .= Digest::MD5::md5_hex($key);
}

if ($step eq "read") {
($error, $value) = getKeyValue($index);

if ( defined($error) ) {
Log3 $index,3, "$index, can't read key from FhemUtils/uniqueID: $error";
return undef;
}

if ( defined($value) ) {
my $dec_value = '';

for my $char (map { pack('C', hex($_)) } ($value =~ /(..)/g)) {
my $decode = chop($key);
$dec_value .= chr(ord($char)^ord($decode));
$key = $decode.$key;
}
return $dec_value;
}
else {
Log3 $index,3,"$index, no key found in FhemUtils/uniqueID";
return undef;
}
}

if ($step eq "store") {
for my $char (split //, $value) {
my $encode = chop($key);
$e_value .= sprintf("%.2x",ord($char)^ord($encode));
$key = $encode.$key;
}
$error = setKeyValue($index, $e_value);
return "error while saving key : $error" if(defined($error));
return "Key successfully saved in FhemUtils/uniqueID Key $index";
}

};
</syntaxhighlight>

====== Ablegen der homeID und des Token ======
In der FHEM Kommandozeile legt man seinen Daten wie folgt im KeyValue ab. Hier wären als Beispiel der Demo Zugang von Tibber.
Das "read" ist dann auch direkt der erste Test, bevor man weiter macht.
<syntaxhighlight lang="Perl">
{KeyValue("store","EVU_Tibber_connect_token","5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE")}
{KeyValue("store","EVU_Tibber_connect_homeID","96a14971-525a-4420-aae9-e5aedaa129ff")}

{KeyValue("read","EVU_Tibber_connect_token")}
{KeyValue("read","EVU_Tibber_connect_homeID")}
</syntaxhighlight>

===== Beispiel Attribut für homeID und Token =====
Oder, sobald das EVU_Tibber_connect Device erstellt wurde, als Attribut.
<syntaxhighlight lang="Perl">
attr EVU_Tibber_connect ws_homeId 96a14971-525a-4420-aae9-e5aedaa129ff
attr EVU_Tibber_connect ws_myId 96a14971-525a-4420-aae9-e5aedaa129ff <<<< Dies kann wohl eine frei gewählte ID sein, was hier der Einfachheithalber gleich der homeId gesetzt wurde.
attr EVU_Tibber_connect ws_token 5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE
</syntaxhighlight>

==== EVU_Tibber_connect RAW Device====
Das Device EVU_Tibber_connect dient der Verbindung zur Tibber API. Zusätzlich wird für die Abfrage der Live Daten innerhalb der userReadings eine WebSocket Verbindung zu Tibber aufgebaut. Tibber stellt jeweils gegen 14:00 Uhr die Daten für den nächsten Tag bereit, wodurch von 00:00 - 14:00 Uhr diese Information im EVU_Tibber_connect noch nicht angezeigt werden kann.
Das Device arbeitet über die userReadings mit einem MySQL DbRep Device, was somit eine MySQL DbLog Verwendung im FHEM voraussetzt. '''Die Verwendung von FileLog ist nicht unterstützt!'''
<syntaxhighlight lang="Perl">
defmod EVU_Tibber_connect HTTPMOD https://api.tibber.com/v1-beta/gql 0
attr EVU_Tibber_connect userattr ws_homeId ws_minInterval ws_myId ws_token ws_websocketURL
attr EVU_Tibber_connect DbLogExclude .*
attr EVU_Tibber_connect DbLogInclude total_cost_.*,fc0_trigger.*
attr EVU_Tibber_connect comment Version 2024.01.22 14:00 \
https://developer.tibber.com/explorer\
\
In der FHEM Kommandozeile könnt Ihr das token und die homeID im KeyStore ablegen.\
Bitte lest dazu das Thema KeyStore im Wiki und legt die Funktion in Eure 99_myUtils.\
\
{KeyValue("store","EVU_Tibber_connect_token","5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE")}\
{KeyValue("store","EVU_Tibber_connect_homeID","96a14971-525a-4420-aae9-e5aedaa129ff")}\
\
Hierduch kann man einen wirtschaftlicheren trigger_price berechnen lassen:\
setreading EVU_Tibber compensation_grid <Eure Einspeisevergütung>\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
(fc_avg - fc_min) /2 + fc_min\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
# compensation_grid kann auch auf einen für Euch passenden Wert gesetzt werden\
(fc_avg - compensation_grid) *0.85
attr EVU_Tibber_connect disable 0
attr EVU_Tibber_connect enableControlSet 1
attr EVU_Tibber_connect get01-1Name current_currency
attr EVU_Tibber_connect get01-2Name current_level
attr EVU_Tibber_connect get01-3Name current_date
attr EVU_Tibber_connect get01-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get01-4Name current_price
attr EVU_Tibber_connect get01-4OExpr $val *100
attr EVU_Tibber_connect get01Data { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total startsAt currency level}}}}}}" }
attr EVU_Tibber_connect get01Header01 Content-Type: application/json
attr EVU_Tibber_connect get01Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get01JSON data_viewer_home_currentSubscription_priceInfo_current
attr EVU_Tibber_connect get01Name 01_priceInfo
attr EVU_Tibber_connect get01URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get02-10Name fc0_03_total
attr EVU_Tibber_connect get02-11Name fc0_04_startsAt
attr EVU_Tibber_connect get02-11OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-12Name fc0_04_total
attr EVU_Tibber_connect get02-13Name fc0_05_startsAt
attr EVU_Tibber_connect get02-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-14Name fc0_05_total
attr EVU_Tibber_connect get02-15Name fc0_06_startsAt
attr EVU_Tibber_connect get02-15OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-16Name fc0_06_total
attr EVU_Tibber_connect get02-17Name fc0_07_startsAt
attr EVU_Tibber_connect get02-17OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-18Name fc0_07_total
attr EVU_Tibber_connect get02-19Name fc0_08_startsAt
attr EVU_Tibber_connect get02-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-1Name current_date
attr EVU_Tibber_connect get02-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-20Name fc0_08_total
attr EVU_Tibber_connect get02-21Name fc0_09_startsAt
attr EVU_Tibber_connect get02-21OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-22Name fc0_09_total
attr EVU_Tibber_connect get02-23Name fc0_10_startsAt
attr EVU_Tibber_connect get02-23OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-24Name fc0_10_total
attr EVU_Tibber_connect get02-25Name fc0_11_startsAt
attr EVU_Tibber_connect get02-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-26Name fc0_11_total
attr EVU_Tibber_connect get02-27Name fc0_12_startsAt
attr EVU_Tibber_connect get02-27OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-28Name fc0_12_total
attr EVU_Tibber_connect get02-29Name fc0_13_startsAt
attr EVU_Tibber_connect get02-29OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-2Name current_price
attr EVU_Tibber_connect get02-2OExpr $val *100
attr EVU_Tibber_connect get02-30Name fc0_13_total
attr EVU_Tibber_connect get02-31Name fc0_14_startsAt
attr EVU_Tibber_connect get02-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-32Name fc0_14_total
attr EVU_Tibber_connect get02-33Name fc0_15_startsAt
attr EVU_Tibber_connect get02-33OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-34Name fc0_15_total
attr EVU_Tibber_connect get02-35Name fc0_16_startsAt
attr EVU_Tibber_connect get02-35OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-36Name fc0_16_total
attr EVU_Tibber_connect get02-37Name fc0_17_startsAt
attr EVU_Tibber_connect get02-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-38Name fc0_17_total
attr EVU_Tibber_connect get02-39Name fc0_18_startsAt
attr EVU_Tibber_connect get02-39OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-3Name fc0_00_startsAt
attr EVU_Tibber_connect get02-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-40Name fc0_18_total
attr EVU_Tibber_connect get02-41Name fc0_19_startsAt
attr EVU_Tibber_connect get02-41OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-42Name fc0_19_total
attr EVU_Tibber_connect get02-43Name fc0_20_startsAt
attr EVU_Tibber_connect get02-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-44Name fc0_20_total
attr EVU_Tibber_connect get02-45Name fc0_21_startsAt
attr EVU_Tibber_connect get02-45OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-46Name fc0_21_total
attr EVU_Tibber_connect get02-47Name fc0_22_startsAt
attr EVU_Tibber_connect get02-47OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-48Name fc0_22_total
attr EVU_Tibber_connect get02-49Name fc0_23_startsAt
attr EVU_Tibber_connect get02-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-4Name fc0_00_total
attr EVU_Tibber_connect get02-50Name fc0_23_total
attr EVU_Tibber_connect get02-51Name fc1_00_startsAt
attr EVU_Tibber_connect get02-51OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-52Name fc1_00_total
attr EVU_Tibber_connect get02-53Name fc1_01_startsAt
attr EVU_Tibber_connect get02-53OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-54Name fc1_01_total
attr EVU_Tibber_connect get02-55Name fc1_02_startsAt
attr EVU_Tibber_connect get02-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-56Name fc1_02_total
attr EVU_Tibber_connect get02-57Name fc1_03_startsAt
attr EVU_Tibber_connect get02-57OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-58Name fc1_03_total
attr EVU_Tibber_connect get02-59Name fc1_04_startsAt
attr EVU_Tibber_connect get02-59OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-5Name fc0_01_startsAt
attr EVU_Tibber_connect get02-5OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-60Name fc1_04_total
attr EVU_Tibber_connect get02-61Name fc1_05_startsAt
attr EVU_Tibber_connect get02-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-62Name fc1_05_total
attr EVU_Tibber_connect get02-63Name fc1_06_startsAt
attr EVU_Tibber_connect get02-63OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-64Name fc1_06_total
attr EVU_Tibber_connect get02-65Name fc1_07_startsAt
attr EVU_Tibber_connect get02-65OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-66Name fc1_07_total
attr EVU_Tibber_connect get02-67Name fc1_08_startsAt
attr EVU_Tibber_connect get02-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-68Name fc1_08_total
attr EVU_Tibber_connect get02-69Name fc1_09_startsAt
attr EVU_Tibber_connect get02-69OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-6Name fc0_01_total
attr EVU_Tibber_connect get02-70Name fc1_09_total
attr EVU_Tibber_connect get02-71Name fc1_10_startsAt
attr EVU_Tibber_connect get02-71OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-72Name fc1_10_total
attr EVU_Tibber_connect get02-73Name fc1_11_startsAt
attr EVU_Tibber_connect get02-73OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-74Name fc1_11_total
attr EVU_Tibber_connect get02-75Name fc1_12_startsAt
attr EVU_Tibber_connect get02-75OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-76Name fc1_12_total
attr EVU_Tibber_connect get02-77Name fc1_13_startsAt
attr EVU_Tibber_connect get02-77OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-78Name fc1_13_total
attr EVU_Tibber_connect get02-79Name fc1_14_startsAt
attr EVU_Tibber_connect get02-79OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-7Name fc0_02_startsAt
attr EVU_Tibber_connect get02-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-80Name fc1_14_total
attr EVU_Tibber_connect get02-81Name fc1_15_startsAt
attr EVU_Tibber_connect get02-81OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-82Name fc1_15_total
attr EVU_Tibber_connect get02-83Name fc1_16_startsAt
attr EVU_Tibber_connect get02-83OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-84Name fc1_16_total
attr EVU_Tibber_connect get02-85Name fc1_17_startsAt
attr EVU_Tibber_connect get02-85OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-86Name fc1_17_total
attr EVU_Tibber_connect get02-87Name fc1_18_startsAt
attr EVU_Tibber_connect get02-87OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-88Name fc1_18_total
attr EVU_Tibber_connect get02-89Name fc1_19_startsAt
attr EVU_Tibber_connect get02-89OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-8Name fc0_02_total
attr EVU_Tibber_connect get02-90Name fc1_19_total
attr EVU_Tibber_connect get02-91Name fc1_20_startsAt
attr EVU_Tibber_connect get02-91OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-92Name fc1_20_total
attr EVU_Tibber_connect get02-93Name fc1_21_startsAt
attr EVU_Tibber_connect get02-93OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-94Name fc1_21_total
attr EVU_Tibber_connect get02-95Name fc1_22_startsAt
attr EVU_Tibber_connect get02-95OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-96Name fc1_22_total
attr EVU_Tibber_connect get02-97Name fc1_23_startsAt
attr EVU_Tibber_connect get02-97OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-98Name fc1_23_total
attr EVU_Tibber_connect get02-9Name fc0_03_startsAt
attr EVU_Tibber_connect get02-9OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02Data { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total startsAt} today {total startsAt} tomorrow {total startsAt}}}}}}" }
attr EVU_Tibber_connect get02Header01 Content-Type: application/json
attr EVU_Tibber_connect get02Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get02JSON data_viewer_home_currentSubscription_priceInfo
attr EVU_Tibber_connect get02Name 02_priceAll
attr EVU_Tibber_connect get02URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get03-1Name nodes_00_00_from
attr EVU_Tibber_connect get03-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-2Name nodes_00_00_cost
attr EVU_Tibber_connect get03-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-3Name nodes_00_00_consumption
attr EVU_Tibber_connect get03-4Name nodes_00_01_from
attr EVU_Tibber_connect get03-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-50Name nodes_00_01_cost
attr EVU_Tibber_connect get03-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-5Name nodes_00_01_cost
attr EVU_Tibber_connect get03-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-6Name nodes_00_01_consumption
attr EVU_Tibber_connect get03-7Name nodes_00_02_from
attr EVU_Tibber_connect get03-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-8Name nodes_00_02_cost
attr EVU_Tibber_connect get03-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-9Name nodes_00_02_consumption
attr EVU_Tibber_connect get03Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 3) {nodes {from cost consumption }}}}}"}
attr EVU_Tibber_connect get03Header01 Content-Type: application/json
attr EVU_Tibber_connect get03Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get03Name 03_consumption_hour
attr EVU_Tibber_connect get03RegOpt g
attr EVU_Tibber_connect get03Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get03URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get04-10Name nodes_24_03_from
attr EVU_Tibber_connect get04-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-11Name nodes_24_03_cost
attr EVU_Tibber_connect get04-11OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-12Name nodes_24_03_consumption
attr EVU_Tibber_connect get04-13Name nodes_24_04_from
attr EVU_Tibber_connect get04-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-14Name nodes_24_04_cost
attr EVU_Tibber_connect get04-14OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-15Name nodes_24_04_consumption
attr EVU_Tibber_connect get04-16Name nodes_24_05_from
attr EVU_Tibber_connect get04-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-17Name nodes_24_05_cost
attr EVU_Tibber_connect get04-17OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-18Name nodes_24_05_consumption
attr EVU_Tibber_connect get04-19Name nodes_24_06_from
attr EVU_Tibber_connect get04-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-1Name nodes_24_00_from
attr EVU_Tibber_connect get04-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-20Name nodes_24_06_cost
attr EVU_Tibber_connect get04-20OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-21Name nodes_24_06_consumption
attr EVU_Tibber_connect get04-22Name nodes_24_07_from
attr EVU_Tibber_connect get04-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-23Name nodes_24_07_cost
attr EVU_Tibber_connect get04-23OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-24Name nodes_24_07_consumption
attr EVU_Tibber_connect get04-25Name nodes_24_08_from
attr EVU_Tibber_connect get04-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-26Name nodes_24_08_cost
attr EVU_Tibber_connect get04-26OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-27Name nodes_24_08_consumption
attr EVU_Tibber_connect get04-28Name nodes_24_09_from
attr EVU_Tibber_connect get04-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-29Name nodes_24_09_cost
attr EVU_Tibber_connect get04-29OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-2Name nodes_24_00_cost
attr EVU_Tibber_connect get04-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-30Name nodes_24_09_consumption
attr EVU_Tibber_connect get04-31Name nodes_24_10_from
attr EVU_Tibber_connect get04-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-32Name nodes_24_10_cost
attr EVU_Tibber_connect get04-32OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-33Name nodes_24_10_consumption
attr EVU_Tibber_connect get04-34Name nodes_24_11_from
attr EVU_Tibber_connect get04-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-35Name nodes_24_11_cost
attr EVU_Tibber_connect get04-35OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-36Name nodes_24_11_consumption
attr EVU_Tibber_connect get04-37Name nodes_24_12_from
attr EVU_Tibber_connect get04-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-38Name nodes_24_12_cost
attr EVU_Tibber_connect get04-38OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-39Name nodes_24_12_consumption
attr EVU_Tibber_connect get04-3Name nodes_24_00_consumption
attr EVU_Tibber_connect get04-40Name nodes_24_13_from
attr EVU_Tibber_connect get04-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-41Name nodes_24_13_cost
attr EVU_Tibber_connect get04-41OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-42Name nodes_24_13_consumption
attr EVU_Tibber_connect get04-43Name nodes_24_14_from
attr EVU_Tibber_connect get04-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-44Name nodes_24_14_cost
attr EVU_Tibber_connect get04-44OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-45Name nodes_24_14_consumption
attr EVU_Tibber_connect get04-46Name nodes_24_15_from
attr EVU_Tibber_connect get04-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-47Name nodes_24_15_cost
attr EVU_Tibber_connect get04-47OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-48Name nodes_24_15_consumption
attr EVU_Tibber_connect get04-49Name nodes_24_16_from
attr EVU_Tibber_connect get04-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-4Name nodes_24_01_from
attr EVU_Tibber_connect get04-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-50Name nodes_24_16_cost
attr EVU_Tibber_connect get04-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-51Name nodes_24_16_consumption
attr EVU_Tibber_connect get04-52Name nodes_24_17_from
attr EVU_Tibber_connect get04-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-53Name nodes_24_17_cost
attr EVU_Tibber_connect get04-53OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-54Name nodes_24_17_consumption
attr EVU_Tibber_connect get04-55Name nodes_24_18_from
attr EVU_Tibber_connect get04-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-56Name nodes_24_18_cost
attr EVU_Tibber_connect get04-56OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-57Name nodes_24_18_consumption
attr EVU_Tibber_connect get04-58Name nodes_24_19_from
attr EVU_Tibber_connect get04-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-59Name nodes_24_19_cost
attr EVU_Tibber_connect get04-59OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-5Name nodes_24_01_cost
attr EVU_Tibber_connect get04-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-60Name nodes_24_19_consumption
attr EVU_Tibber_connect get04-61Name nodes_24_20_from
attr EVU_Tibber_connect get04-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-62Name nodes_24_20_cost
attr EVU_Tibber_connect get04-62OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-63Name nodes_24_20_consumption
attr EVU_Tibber_connect get04-64Name nodes_24_21_from
attr EVU_Tibber_connect get04-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-65Name nodes_24_21_cost
attr EVU_Tibber_connect get04-65OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-66Name nodes_24_21_consumption
attr EVU_Tibber_connect get04-67Name nodes_24_22_from
attr EVU_Tibber_connect get04-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-68Name nodes_24_22_cost
attr EVU_Tibber_connect get04-68OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-69Name nodes_24_22_consumption
attr EVU_Tibber_connect get04-6Name nodes_24_01_consumption
attr EVU_Tibber_connect get04-70Name nodes_24_23_from
attr EVU_Tibber_connect get04-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-71Name nodes_24_23_cost
attr EVU_Tibber_connect get04-71OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-72Name nodes_24_23_consumption
attr EVU_Tibber_connect get04-7Name nodes_24_02_from
attr EVU_Tibber_connect get04-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-8Name nodes_24_02_cost
attr EVU_Tibber_connect get04-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-9Name nodes_24_02_consumption
attr EVU_Tibber_connect get04Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 24) {nodes {from cost consumption}}}}}"}
attr EVU_Tibber_connect get04Header01 Content-Type: application/json
attr EVU_Tibber_connect get04Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get04Name 04_consumption_hour_24
attr EVU_Tibber_connect get04RegOpt g
attr EVU_Tibber_connect get04Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get04URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get05AutoNumLen 4
attr EVU_Tibber_connect get05Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 100) {nodes {from cost consumption}}}}}"}
attr EVU_Tibber_connect get05Header01 Content-Type: application/json
attr EVU_Tibber_connect get05Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get05JSON data_viewer_home
attr EVU_Tibber_connect get05Name 05_consumption_hourly_100
attr EVU_Tibber_connect get05URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get06-10Name Adresse_07_Telefon
attr EVU_Tibber_connect get06-11Name Adresse_01_Vorname
attr EVU_Tibber_connect get06-12Name Adresse_02_Nachname
attr EVU_Tibber_connect get06-1Name Adresse_03_Strasse
attr EVU_Tibber_connect get06-2Name Adresse_05_Ort
attr EVU_Tibber_connect get06-3Name Adresse_06_Land
attr EVU_Tibber_connect get06-4Name Adresse_05_Ort
attr EVU_Tibber_connect get06-5Name Adresse_06_Land
attr EVU_Tibber_connect get06-6Name Adresse_09_latitude
attr EVU_Tibber_connect get06-7Name Adresse_10_longitude
attr EVU_Tibber_connect get06-8Name Adresse_04_Plz
attr EVU_Tibber_connect get06-9Name Adresse_08_eMail
attr EVU_Tibber_connect get06Data { "query": "{viewer {home(id:\"%%homeID%%\") {address {address1 address2 address3 postalCode city country latitude longitude} owner {firstName lastName contactInfo {email mobile}}}}}" }
attr EVU_Tibber_connect get06Header01 Content-Type: application/json
attr EVU_Tibber_connect get06Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get06JSON data_viewer_home
attr EVU_Tibber_connect get06Name 06_address
attr EVU_Tibber_connect get06URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get07-10Name nodes_24_03_from
attr EVU_Tibber_connect get07-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-11Name nodes_24_03_cost
attr EVU_Tibber_connect get07-11OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-12Name nodes_24_03_consumption
attr EVU_Tibber_connect get07-13Name nodes_24_04_from
attr EVU_Tibber_connect get07-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-14Name nodes_24_04_cost
attr EVU_Tibber_connect get07-14OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-15Name nodes_24_04_consumption
attr EVU_Tibber_connect get07-16Name nodes_24_05_from
attr EVU_Tibber_connect get07-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-17Name nodes_24_05_cost
attr EVU_Tibber_connect get07-17OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-18Name nodes_24_05_consumption
attr EVU_Tibber_connect get07-19Name nodes_24_06_from
attr EVU_Tibber_connect get07-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-1Name features_realTimeConsumptionEnabled
attr EVU_Tibber_connect get07-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-20Name nodes_24_06_cost
attr EVU_Tibber_connect get07-20OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-21Name nodes_24_06_consumption
attr EVU_Tibber_connect get07-22Name nodes_24_07_from
attr EVU_Tibber_connect get07-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-23Name nodes_24_07_cost
attr EVU_Tibber_connect get07-23OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-24Name nodes_24_07_consumption
attr EVU_Tibber_connect get07-25Name nodes_24_08_from
attr EVU_Tibber_connect get07-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-26Name nodes_24_08_cost
attr EVU_Tibber_connect get07-26OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-27Name nodes_24_08_consumption
attr EVU_Tibber_connect get07-28Name nodes_24_09_from
attr EVU_Tibber_connect get07-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-29Name nodes_24_09_cost
attr EVU_Tibber_connect get07-29OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-2Name features_id
attr EVU_Tibber_connect get07-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-30Name nodes_24_09_consumption
attr EVU_Tibber_connect get07-31Name nodes_24_10_from
attr EVU_Tibber_connect get07-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-32Name nodes_24_10_cost
attr EVU_Tibber_connect get07-32OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-33Name nodes_24_10_consumption
attr EVU_Tibber_connect get07-34Name nodes_24_11_from
attr EVU_Tibber_connect get07-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-35Name nodes_24_11_cost
attr EVU_Tibber_connect get07-35OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-36Name nodes_24_11_consumption
attr EVU_Tibber_connect get07-37Name nodes_24_12_from
attr EVU_Tibber_connect get07-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-38Name nodes_24_12_cost
attr EVU_Tibber_connect get07-38OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-39Name nodes_24_12_consumption
attr EVU_Tibber_connect get07-3Name nodes_24_00_consumption
attr EVU_Tibber_connect get07-40Name nodes_24_13_from
attr EVU_Tibber_connect get07-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-41Name nodes_24_13_cost
attr EVU_Tibber_connect get07-41OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-42Name nodes_24_13_consumption
attr EVU_Tibber_connect get07-43Name nodes_24_14_from
attr EVU_Tibber_connect get07-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-44Name nodes_24_14_cost
attr EVU_Tibber_connect get07-44OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-45Name nodes_24_14_consumption
attr EVU_Tibber_connect get07-46Name nodes_24_15_from
attr EVU_Tibber_connect get07-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-47Name nodes_24_15_cost
attr EVU_Tibber_connect get07-47OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-48Name nodes_24_15_consumption
attr EVU_Tibber_connect get07-49Name nodes_24_16_from
attr EVU_Tibber_connect get07-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-4Name nodes_24_01_from
attr EVU_Tibber_connect get07-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-50Name nodes_24_16_cost
attr EVU_Tibber_connect get07-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-51Name nodes_24_16_consumption
attr EVU_Tibber_connect get07-52Name nodes_24_17_from
attr EVU_Tibber_connect get07-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-53Name nodes_24_17_cost
attr EVU_Tibber_connect get07-53OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-54Name nodes_24_17_consumption
attr EVU_Tibber_connect get07-55Name nodes_24_18_from
attr EVU_Tibber_connect get07-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-56Name nodes_24_18_cost
attr EVU_Tibber_connect get07-56OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-57Name nodes_24_18_consumption
attr EVU_Tibber_connect get07-58Name nodes_24_19_from
attr EVU_Tibber_connect get07-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-59Name nodes_24_19_cost
attr EVU_Tibber_connect get07-59OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-5Name nodes_24_01_cost
attr EVU_Tibber_connect get07-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-60Name nodes_24_19_consumption
attr EVU_Tibber_connect get07-61Name nodes_24_20_from
attr EVU_Tibber_connect get07-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-62Name nodes_24_20_cost
attr EVU_Tibber_connect get07-62OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-63Name nodes_24_20_consumption
attr EVU_Tibber_connect get07-64Name nodes_24_21_from
attr EVU_Tibber_connect get07-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-65Name nodes_24_21_cost
attr EVU_Tibber_connect get07-65OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-66Name nodes_24_21_consumption
attr EVU_Tibber_connect get07-67Name nodes_24_22_from
attr EVU_Tibber_connect get07-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-68Name nodes_24_22_cost
attr EVU_Tibber_connect get07-68OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-69Name nodes_24_22_consumption
attr EVU_Tibber_connect get07-6Name nodes_24_01_consumption
attr EVU_Tibber_connect get07-70Name nodes_24_23_from
attr EVU_Tibber_connect get07-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-71Name nodes_24_23_cost
attr EVU_Tibber_connect get07-71OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-72Name nodes_24_23_consumption
attr EVU_Tibber_connect get07-7Name nodes_24_02_from
attr EVU_Tibber_connect get07-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-8Name nodes_24_02_cost
attr EVU_Tibber_connect get07-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-9Name nodes_24_02_consumption
attr EVU_Tibber_connect get07Data { "query": "{viewer {home(id:\"%%homeID%%\") {id features{realTimeConsumptionEnabled} } } }" }
attr EVU_Tibber_connect get07Header01 Content-Type: application/json
attr EVU_Tibber_connect get07Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get07JSON data_viewer_home
attr EVU_Tibber_connect get07Name 07_realTimeConsumptionEnabled
attr EVU_Tibber_connect get07RegOpt g
attr EVU_Tibber_connect get07Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get07URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect group PV Steuerung EVU
attr EVU_Tibber_connect icon stromzaehler_icon
attr EVU_Tibber_connect replacement01Mode expression
attr EVU_Tibber_connect replacement01Regex %%token%%
attr EVU_Tibber_connect replacement01Value {KeyValue("read","EVU_Tibber_connect_token")}
attr EVU_Tibber_connect replacement02Mode expression
attr EVU_Tibber_connect replacement02Regex %%homeID%%
attr EVU_Tibber_connect replacement02Value {KeyValue("read","EVU_Tibber_connect_homeID")}
attr EVU_Tibber_connect requestData { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total energy tax startsAt }}}}}}" }
attr EVU_Tibber_connect requestHeader1 Content-Type: application/json
attr EVU_Tibber_connect requestHeader2 Authorization: Bearer %%token%%
attr EVU_Tibber_connect room Strom->Boerse
attr EVU_Tibber_connect showBody 1
attr EVU_Tibber_connect showError 1
attr EVU_Tibber_connect sortby 313
attr EVU_Tibber_connect timeout 30
attr EVU_Tibber_connect userReadings ws_connect:ws_cmd:.connect {\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
return "Device already open" if (defined($devState));;\
\
# establish connection to websocket\
# format must also include portnumber if a path is to be specified\
$hash->{DeviceName} = AttrVal($name, "ws_websocketURL", "wss:echo.websocket.org:443");;\
\
# special headers needed for Tibber, see also Developer Tools in Browser\
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';;\
$hash->{header}{'Host'} = 'websocket-api.tibber.com';;\
$hash->{header}{'Origin'} = 'https://developer.tibber.com';;\
\
# callback function when "select()" signals data for us\
# websocket Ping/Pongs are treated in DevIo but still call this function\
$hash->{directReadFn} = sub () {\
my $hash = $defs{$name};;\
\
# we can read without closing the DevIo, because select() signalled data\
my $buf = DevIo_SimpleRead($hash);;\
\
# if read fails, close device\
if(!defined($buf)) {\
DevIo_CloseDev($hash);;\
$buf = "not_connected";;\
}\
\
#Log(3, "$name:$reading: websocket data: >>>$buf<<<");;\
\
# only update our reading if buffer is not empty and if last update is older than minInterval\
if ($buf ne "") {\
my $websocketDataAge = ReadingsAge($name, "ws_websocketData", 3600);;\
my $minInterval = AttrVal($name, "ws_minInterval", 0);;\
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);;\
\
readingsBeginUpdate($hash);;\
readingsBulkUpdate($hash, "ws_websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);;\
readingsBulkUpdate($hash, "ws_websocketData", "$buf") if (!$isNext);;\
readingsEndUpdate($hash, 1);;\
#Log(3, "$name:$reading: websocket data written to reading");;\
}\
};;\
\
# open DevIo websocket\
DevIo_OpenDev($hash, 0, undef, sub(){\
my ($hash, $error) = @_;;\
return "$error" if ($error);;\
\
my $token = AttrVal($name, "ws_token", "???");;\
$token = KeyValue("read","EVU_Tibber_connect_token") if ($token eq "???");;\
\
DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);;\
});;\
readingsBulkUpdate($hash, "ws_websocketData", "");;\
#Log(3, "$name:$reading: websocket data cleared in reading");;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_disconnect:ws_cmd:.disconnect {\
Log(3, "$name: disconnect");;\
my $hash = $defs{$name};;\
RemoveInternalTimer($hash);;\
DevIo_SimpleRead($hash);;\
DevIo_CloseDev($hash);;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onDisconnect {\
my $myState = ReadingsVal($name, "state", "???");;\
my $myData = ReadingsVal($name, "ws_websocketData", "???");;\
return if ($myState ne "disconnected" and $myData ne "not_connected");;\
\
## timer callback function, called after a few seconds to initiate a reconnect\
my $timerFunction = sub() {\
my ($arg) = @_;;\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
\
# only re-connect if device is not connected\
readingsSingleUpdate($hash, "ws_cmd", "connect", 1) if (!defined($devState));;\
};;\
RemoveInternalTimer($name.$reading.'Timer');;\
\
# wait a random time before reconnect (exponential backoff TBD):\
my $rwait = int(rand(200)) + 30;;\
InternalTimer(gettimeofday() + $rwait, $timerFunction, $name.$reading.'Timer');;\
\
#set cmd to a new value, informs user and allows to retrigger when timer expires\
my $hash = $defs{$name};;\
readingsBulkUpdate($hash, "ws_cmd", "reconnect attempt in $rwait seconds");;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onTimeout:ws_websocketData:.* {\
#re-establish websocket connection if no data received in the past ten minutes\
#but only if our reading "ws_cmd" was not set to the value "disconnect"\
\
#Log(3, "$name:$reading: websocket data triggert ws_onTimeout");;\
\
#timeout in seconds when the connection is considered dead\
my $timeoutTime = 600;;\
\
# function to execute when timeout expired\
# defining the function here in the userReading, allows us to insert variables directly\
my $timerFunction = sub() {\
my ($arg) = @_;;\
my $hash = $defs{$name};;\
my $rCmd = ReadingsVal($name, "ws_cmd", "???");;\
my $age = ReadingsAge($name, "ws_websocketData", 0);;\
\
Log(3, "$name: onTimeoutTimer triggered >>$arg<<");;\
\
#do not do anything further if disconnect is on purpose\
if ( $rCmd eq "disconnect" ) {\
Log(3, "$name: ws_cmd was set to disconnect");;\
return;;\
}\
\
# for whatever reason, we triggered to soon (80%)\
if ( $age < $timeoutTime*0.8 ) {\
Log(3, "$name: ws_websocketData is not outdated");;\
return;;\
}\
\
DevIo_CloseDev($hash);;\
Log(3, "$name: onTimeoutTimer closed DevIo...");;\
\
readingsSingleUpdate($hash, "ws_cmd", "connect", 1);;\
Log(3, "$name: onTimeoutTimer set ws_cmd to value 'connect'");;\
};;\
\
#Log(3, "$name:$reading: onTimeout function defined");;\
\
#remove/cancel previous timers, because we got fresh data and countdown starts again\
RemoveInternalTimer($name.$reading.'Timer');;\
\
#set timer to expire and execute function defined above, give special arg as identifier\
InternalTimer(gettimeofday() + $timeoutTime, $timerFunction, $name.$reading.'Timer');;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onConnectionAck:ws_websocketData:.*connection_ack.* {\
#ws_websocketData contains the string "connection_ack"\
Log(3, "$name:$reading: got connection ack");;\
\
# do not proceed if connection is lost\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
return "Device not open" if (!defined($devState));;\
\
readingsBulkUpdate($hash, "ws_cmd", "got connection ack");;\
\
my $homeId = AttrVal($name, "ws_homeId", "???");;\
$homeId = KeyValue("read","EVU_Tibber_connect_homeID") if ($homeId eq "???");;\
\
my $myId = AttrVal($name, "ws_myId", "???");;\
$myId = KeyValue("read","EVU_Tibber_connect_homeID") if ($myId eq "???");;\
\
# build the query, do it in pieces, the comma at the end caused perl errors\
# so we put it together in this not very elegant way\
my $json = '{ "id":"'. $myId .'", "type":"subscribe"'.", ";;\
$json .= '"payload":{';;\
$json .= '"variables":{}'.", ";;\
$json .= '"extensions":{}'.", ";;\
$json .= '"query":"subscription { liveMeasurement( homeId: \"'.$homeId.'\" ) ';;\
#$json .= '{ timestamp power accumulatedConsumption accumulatedCost currency minPower averagePower maxPower signalStrength }}"';;\
$json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';;\
$json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';;\
$json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';;\
$json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}"';;\
$json .= '}}';;\
\
#send the string via websocket as ASCII\
Log(3, "$name:$reading: sending JSON: >>>$json<<<");;\
DevIo_SimpleWrite($hash, $json, 2);;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onNextLiveMeasurement:ws_websocketData:.*next.*payload.*data.*liveMeasurement.* {\
#websocketData contains next-live-measurement-data\
my $val = ReadingsVal($name, "ws_websocketData", "{}");;\
my %res = %{json2nameValue($val, undef, undef, "payload_data_liveMeasurement.*")};;\
\
my $ret = "got values for:\n";;\
foreach my $k (sort keys %res) {\
$ret .= "$k\n";;\
readingsBulkUpdate($hash, makeReadingName($k), $res{$k});;\
}\
return $ret;;\
},\
\
nodes_TIMESTAMP:nodes_00_00_cost.* {\
my ($timestamp,$value) = 2x0;;\
my $tmp = 0;;\
\
for (my $loop_last = 0;; $loop_last <= 2;; $loop_last++) {\
$timestamp = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_from","null");;\
$value = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_cost","null");;\
\
if ( $value ne "null" ) {\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_consumption","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
} else {\
$tmp = "null";;\
}\
} # end for\
if ($tmp eq "null") {\
$timestamp = $tmp\
}\
$timestamp;;\
},\
\
nodes_TIMESTAMP:nodes_24_00_cost.* {\
my ($timestamp,$value) = 2x0;;\
my $tmp = 0;;\
\
for (my $loop_last = 0;; $loop_last <= 23;; $loop_last++) {\
$timestamp = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_from","null");;\
$value = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_cost","null");;\
\
if ( $value ne "null" ) {\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_consumption","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
} else {\
$tmp = "null";;\
}\
} # end for\
if ($tmp eq "null") {\
$timestamp = $tmp\
}\
$timestamp;;\
},\
\
nodes_TIMESTAMP:05_consumption_hourly_100-0001.* {\
my ($timestamp,$value) = 2x0;;\
\
for (my $loop_last = 1;; $loop_last <= 300;; $loop_last += 3) {\
\
$timestamp = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last+2),"null");; # timestamp\
$timestamp =~ s/T/ /g ;;\
$timestamp = substr($timestamp,0,19);;\
$value = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last+1),"null");; # cost\
\
if ( $value ne "" ) {\
$value = round($value,4);;\
# print $timestamp." ".$value."\n";;\
\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last),"null");; # consumption\
$value = round($value,4);;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
} # end for\
\
$timestamp;;\
},\
\
nodes_cost_avg:nodes_TIMESTAMP.* {\
## Berechnung des Tages Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(avg(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_avg","null")\
}\
},\
\
nodes_cost_min:nodes_TIMESTAMP.* {\
## Ermittlung des minimal Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(min(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_min","null")\
}\
},\
\
nodes_cost_max:nodes_TIMESTAMP.* {\
## Ermittlung des maximal Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(max(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_max","null")\
}\
},\
\
nodes_consumption_day:nodes_TIMESTAMP.* {\
## Berechnung des Tages Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND date(TIMESTAMP) = curdate() ;;") ;;\
},\
\
nodes_consumption_month:nodes_TIMESTAMP.* {\
## Berechnung des Monats Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND YEAR(TIMESTAMP) = YEAR(curdate())\
AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;") ;;\
},\
\
nodes_consumption_year:nodes_TIMESTAMP.* {\
## Berechnung des Jahres Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;") ;;\
},\
\
fc_avg:current_price.* {\
## Berechnung des durchschnitt Wertes\
my $fc_avg = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
if (AttrVal("$NAME","verbose",0) >=3) {\
Log 3, "$NAME cmd_1 : Tibber Daten für fc1 sind bereits da";;\
}\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) { ## Summe berechnen\
$fc_avg += ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
} # end $k\
} # end $j\
\
return round($fc_avg / (24 *(1+$fc)) *100 ,2);; ## Durchschnitt berechnen\
},\
\
fc_med:current_price.* {\
## Berechnung des median Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT\
cast( ( (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', floor(1+((count(VALUE)-1) / 2))) , ',', -1))\
+ (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', ceiling(1+((count(VALUE)-1) / 2))), ',', -1))\
)/2 *100\
AS DECIMAL(4,2))\
FROM history\
WHERE DEVICE='".$NAME."'\
AND ( READING='fc0_total' AND TIMESTAMP >= DATE_FORMAT(NOW(), '%Y-%m-%d 00:00:00')\
OR READING='fc1_total' AND TIMESTAMP >= DATE_FORMAT(NOW() + INTERVAL 1 DAY, '%Y-%m-%d 00:00:00') ) ;;") ;;\
},\
\
fc_min:current_price.* {\
## Ermittlung des minimal Wertes\
my $fc_min = 0;;\
my $fc_tmp = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) {\
$fc_tmp = ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
\
if (($fc_tmp < $fc_min) or ($j == 0 and $k == 0)) {\
$fc_min = $fc_tmp;;\
}\
} # end $k\
} # end $j\
\
return round($fc_min *100 ,2);; ## Von Euro auf Cent umrechnen\
},\
\
fc_max:current_price.* {\
## Ermittlung des minimal Wertes\
my $fc_max = 0;;\
my $fc_tmp = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) {\
$fc_tmp = ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
\
if (($fc_tmp > $fc_max) or ($j == 0 and $k == 0)) {\
$fc_max = $fc_tmp;;\
}\
} # end $k\
} # end $j\
\
return round($fc_max *100 ,2);; ## Von Euro auf Cent umrechnen\
},\
\
fc_trigger_price:fc_avg.* {\
## fc_trigger_price:[fc_avg|compensation_grid].* {\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_min = ReadingsVal("$NAME","fc_min",0);;\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
if ( ReadingsVal("$NAME","compensation_grid",0) != 0 ) {\
my $price_level_battery = round( ($fc_avg - ReadingsVal("$NAME","compensation_grid",0)) *0.85 , 1) ;;\
if ( $price_level > $price_level_battery ) {\
$price_level = $price_level_battery;;\
}\
}\
$price_level;;\
},\
\
fc0_trigger_start:fc_trigger_price.* {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_stop:fc0_trigger_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc0_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc0_trigger:fc0_trigger_stop.* {\
\
# Setzen des Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",100) < ReadingsVal("$NAME","fc_trigger_price",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc1_trigger_start:fc_trigger_price.* {\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
}\
return("null");;\
},\
\
fc1_trigger_stop:fc0_trigger_start.* {\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc1_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc_trigger_max:fc_avg.* {\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_max = ReadingsVal("$NAME","fc_max",0);;\
\
# Berechnung eines Schwellwertes als täglichen Maximalpreises\
my $price_level = round( ($fc_max - $fc_avg)/2 + $fc_avg , 0);;\
\
$price_level;;\
},\
\
fc0_trigger_max_start:fc_trigger_max.* {\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger_max Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_max_stop:fc0_trigger_max_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_max_start = ReadingsVal("$NAME","fc0_trigger_max_start","null");;\
my $fc_trigger_max_stop = $fc_trigger_max_start;;\
\
if ( $fc_trigger_max_start ne "null" ) {\
$fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_max_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
$fc_trigger_max_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_max_stop);;\
},\
\
fc0_trigger_max:fc0_trigger_max_stop.* {\
\
# Setzen des maximum Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",0) > ReadingsVal("$NAME","fc_trigger_max",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc1_trigger_max_start:fc_trigger_max.* {\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") {\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
}\
return("null");;\
},\
\
fc1_trigger_max_stop:fc0_trigger_max_start.* {\
my $loop_hour = 0;;\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_max_start = ReadingsVal("$NAME","fc1_trigger_max_start","null");;\
my $fc_trigger_max_stop = $fc_trigger_max_start;;\
\
if ( $fc_trigger_max_start ne "null" ) {\
$fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_max_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
$fc_trigger_max_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_max_stop);;\
},\
\
total_cost_day:nodes_TIMESTAMP.* {\
## Berechnung des Tages Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND date(TIMESTAMP) = curdate() ;;") ;;\
},\
\
total_cost_month:nodes_TIMESTAMP.* {\
## Berechnung des monats Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND YEAR(TIMESTAMP) = YEAR(curdate())\
AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;") ;;\
},\
\
total_cost_year:nodes_TIMESTAMP.* {\
## Berechnung des Jahres Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;") ;;\
},\
\
fc_DbLog:fc0_00_total.* {\
my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\
\
for (my $loop_fc = 0;; $loop_fc <= 1;; $loop_fc++) {\
$loop_fc_next = $loop_fc +1;;\
$date = ReadingsVal("$NAME","fc".$loop_fc."_00_startsAt","null");;\
if ($date ne "null") {\
$date =~ /([\d+-]+)/;; $date = $1 ;;\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$hour = sprintf("%02d",$loop_hour);;\
$timestamp = $date." ".$hour.":00:00";;\
$value = ReadingsVal("$NAME","fc".$loop_fc."_".$hour."_total","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','fc".$loop_fc."_total','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
if (ReadingsVal("$NAME","fc".$loop_fc."_00_startsAt","null") eq ReadingsVal("$NAME","fc".$loop_fc_next."_00_startsAt","null")) {\
fhem("deletereading $NAME fc".$loop_fc_next."_.*");;\
}\
} else {\
fhem("deletereading $NAME fc1_.*");;\
}\
}\
ReadingsTimestamp("$NAME","fc0_00_startsAt","null");;\
}
attr EVU_Tibber_connect verbose 0
attr EVU_Tibber_connect ws_minInterval 54
attr EVU_Tibber_connect ws_websocketURL wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions
</syntaxhighlight>

==== EVU_Tibber RAW Device ====
Das Device dient der Anzeige und Steuerung des EVU_Tibber_connect Devices.
<syntaxhighlight lang="Perl">
defmod EVU_Tibber DOIF ## Startup Befehle für den WebSocket vom EVU_Tibber_connect\
init\
{ \
Log(0, "$SELF 0 init : ▶️ EVU_Tibber init");;\
fhem("setreading EVU_Tibber_connect ws_cmd connect");; \
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 0 WebSocket : ▶️ EVU_Tibber_connect start Websocket";;\
}\
Log(0, "$SELF 0 init : 🏁 EVU_Tibber init done");;\
}\
\
################################################################################################################\
## EVU_Tibber_connect start/stop WebSocket\
EVU_Tibber_connect_ws\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
# or [$SELF:ui_command_2] ## Hier wird das uiTable select ausgewertet\
and [$SELF:ui_command_2] ne "---"\
) {\
\
fhem("setreading EVU_Tibber_connect ws_cmd ".[?$SELF:ui_command_2]);; \
\
set_Reading("ui_command_2","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 1 Scheduling für das Abholen von Tibber Daten\
1_EVU_Tibber_PriceInfo\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
( [:03] ## Kurz nach jeder vollen Stunde\
)\
or [$SELF:ui_command_1] eq "1_EVU_Tibber_PriceInfo" ## Hier wird das uiTable select ausgewertet\
) {\
\
::CommandGet(undef, "EVU_Tibber_connect 01_priceInfo");; ## Preis für die aktuelle Stunde\
::CommandGet(undef, "EVU_Tibber_connect 03_consumption_hour");; ## Kosten der letzen drei Stunden\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 1 PriceInfo : Abfrage von Tibber";;\
}\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 2 Scheduling für das Abholen der Tibber Preise\
2_EVU_Tibber_PriceAll\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
([00:03] or [14:03] ## Ab 14:00 Uhr gibt es die Preise für den nächsten Tag\
)\
or [$SELF:ui_command_1] eq "2_EVU_Tibber_PriceAll" ## Hier wird das uiTable select ausgewertet\
) {\
\
::CommandGet(undef, "EVU_Tibber_connect 02_priceAll");;\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 2 priceAll : Abfrage von Tibber für den nächsten Tag";;\
}\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 2 Erstellen des Diagramms im uiTable\
3_EVU_Tibber_Diagramm\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
( [00:05] or [14:05] ## Kurz nach Mitternacht\
)\
or [$SELF:ui_command_1] eq "3_EVU_Tibber_Diagramm" ## Hier wird das uiTable select ausgewertet\
) {\
\
my (@out) = ("") x 2;;\
my $timestamp;;\
\
for (my $j=0;;$j<=1;;$j++){\
\
if (ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_00_startsAt",$j),"null") eq "null") { ## Der nächste Tag ist noch nicht da\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 3 Diagramm : Tibber Daten für fc".$j." sind noch nicht da";;\
}\
\
$timestamp = POSIX::strftime("%Y-%m-%d",localtime(time+86400));; ## Setze das Datum auf morgen\
for (my $k=0;;$k<=24;;$k++) {\
$out[$j] .= sprintf("%s_%02d:00:00 0.0\n", $timestamp, $k);; ## Die Daten mit 0 ergänzen\
}\
$j = 2;; ## Aus der Schleife springen\
\
} else {\
\
for (my $i=0;;$i<=23;;$i++){\
$timestamp = ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_%02d_startsAt",$j,$i),"");;\
$timestamp =~ s/ /_/g;;\
$out[$j] .=$timestamp." ".::round(ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_%02d_total",$j, $i),0)*100,1)."\n";;\
} # End $i\
\
} # End if\
} # End $j\
\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 3 Diagramm : Werte für das Diagramm";;\
print($out[0]);;\
print($out[1]);;\
}\
## Die readings current_price und current_level dienen hier nur als Trigger Events, und müssen für\
## jedes Diagramm unterschiedlich sein, die Daten werden über $out[] bereit gestellt !!\
::DOIF_modify_card_data("EVU_Tibber","EVU_Tibber_connect","current_price","bar1day",0,$out[0]);;\
::DOIF_modify_card_data("EVU_Tibber","EVU_Tibber_connect","current_level","bar1day",-86400,$out[1]);;\
## Mit der Abfrage 03_consumption_hour werden die Trigger erneut ausgelöst\
::CommandGet(undef, "EVU_Tibber_connect 01_priceInfo");; ## Kosten der letzen drei Stunden\
## fhem("get EVU_Tibber_connect 01_priceInfo");; ## Kosten der letzen drei Stunden\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\

attr EVU_Tibber DbLogExclude .*
attr EVU_Tibber comment Version 2023.12.06 13:00 \
Dieses Device benötigt EVU_Tibber_connect als Verbindung zu Tibber.
attr EVU_Tibber disable 0
attr EVU_Tibber group PV Steuerung EVU
attr EVU_Tibber icon stromzaehler_icon
attr EVU_Tibber room Strom->Boerse
attr EVU_Tibber sortby 315
attr EVU_Tibber uiState {\
package ui_Table;;\
$TABLE = "style='width:100%;;'";;\
\
$TD{0..6}{0} = "style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'";;\
$TD{0..6}{1..4} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'";;\
$TD{0..6}{5} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'";;\
\
}\
\
"Kommando<dd>Auswahl</dd>" |widget([$SELF:ui_command_1],"uzsuDropDown,---,1_EVU_Tibber_PriceInfo,2_EVU_Tibber_PriceAll,3_EVU_Tibber_Diagramm") |"LiveMessurement <br>".widget([$SELF:ui_command_2],"uzsuDropDown,---,connect,disconnect")|""|[EVU_Tibber_connect:ws_cmd]\
\
"Strompreis<br>".card([EVU_Tibber_connect:current_price:bar1day],undef,undef,0,60,90,0,"fc0 ".::ReadingsVal(Device(),"current_currency",""),undef,"1","130,,,,,,220").card([EVU_Tibber_connect:current_level:bar1day],undef,undef,0,60,90,0,"fc1 ".::ReadingsVal(Device(),"current_currency",""),undef,"1","130,,,,,,220")|\
"<span style=font-weight:bold>nächste 3h</span><br><br>".Price(1)."<br>".Price(2)."<br>".Price(3)|"<span style=font-weight:bold>Statistik fc0</span><br><br>".::ReadingsVal(Device(),"fc_min",0)." min<br>".::ReadingsVal(Device(),"fc_avg",0)." avg<br>".::ReadingsVal(Device(),"fc_med",0)." med<br>".::ReadingsVal(Device(),"fc_max",0)." max"|\
"<span style=font-weight:bold>Trigger fc0</span><br>Basis ".widget([EVU_Tibber_connect:compensation_grid],"selectnumbers,0,0.1,12,1,lin")."<br>".Format("trigger_0")|\
"<span style=font-weight:bold>Trigger fc1</span><br><br>".Format("trigger_1")
attr EVU_Tibber uiTable {\
package ui_Table;;\
$TABLE = "style='width:100%;;'";;\
\
$TD{0..18}{0} = "style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'";;\
$TD{0..18}{1..5} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'";;\
$TD{0..18}{6} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'";;\
\
sub FUNC_Status {\
my($value, $min, $colorMin, $statusMin, $colorMiddel, $statusMiddle, $max, $colorMax, $statusMax)=@_;;\
my $ret = ($value < $min)? '<span style="color:'.$colorMin.'">'.$statusMin.'</span>' : ($value > $max)? '<span style="color:'.$colorMax.'">'.$statusMax.'</span>' : '<span style="color:'.$colorMiddel.'">'.$statusMiddle.'</span>';;\
return $ret;;\
}\
\
sub Device {\
return "$SELF"."_connect";;\
}\
\
sub Cost {\
my($i)=@_;;\
my $currency = (::ReadingsVal(Device(),"current_currency","") eq "EUR")? " €" : "";;\
\
return ::ReadingsVal(Device(),"total_cost_".$i,0).$currency;;\
}\
\
sub Price {\
my($i)=@_;;\
my $j;;\
my $value;;\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
\
if ($i == 0) {\
$value = ::ReadingsVal(Device(),"current_price",0);;\
$value = ( ::ReadingsVal(Device(),"fc0_trigger","off") eq "on" ) ?\
"<span style='color:green'>".$value."</span>" :\
"<span style='color:red'>".$value."</span>" ;;\
$value .= " ct/kWh";;\
} else {\
$j = $i+$hour;;\
if ($j < 24) {\
$value = ::round(::ReadingsVal(Device(),"fc0_".sprintf("%02d",$j)."_total",0)*100,1);;\
} else {\
$j = $j - 24;;\
$value = ::round(::ReadingsVal(Device(),"fc1_".sprintf("%02d",$j)."_total",0)*100,1);;\
}\
$value = ( ::ReadingsVal(Device(),"fc_trigger_price","0") > $value ) ?\
"<span style='color:green'>".$value."</span>" :\
"<span style='color:red'>".$value."</span>" ;;\
$value = sprintf("%02d",$j)." : ".$value ;;\
}\
return $value;;\
}\
\
sub Format {\
my($i)=@_;;\
\
my $MonthBefore = "LogDBRep_Statistic_previous_Month";;\
my $MonthPrevious = ::ReadingsTimestamp("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month","null");;\
$MonthPrevious = ($MonthPrevious ne "null") ? POSIX::strftime("%Y",localtime(::time_str2num(::ReadingsTimestamp("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month","null")))) : "null";;\
\
my $YearBefore = "LogDBRep_Statistic_previous_Year";;\
my $YearPrevious = ::ReadingsTimestamp("$YearBefore",Device()."_nodes_consumption_year","null");;\
$YearPrevious = ($YearPrevious ne "null") ? POSIX::strftime("%Y",localtime(::time_str2num(::ReadingsTimestamp("$YearBefore",Device()."_nodes_consumption_year","null")))) : "null";;\
\
if ($i eq "day") {\
return sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_day",0));;\
} elsif ($i eq "month") {\
my $evu_em = sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_month",0));;\
$evu_em .= ($MonthPrevious ne "null") ? sprintf(" / %04d", ::ReadingsVal("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month",0) ) : "";;\
return $evu_em;;\
} elsif ($i eq "year") {\
my $evu_ey = sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_year",0));;\
$evu_ey .= ($YearPrevious ne "null") ? sprintf(" / %04d", ::ReadingsVal("$YearBefore","EVU_Tibber_Pulse_nodes_consumption_month",0) ) : "";;\
return $evu_ey;;\
} elsif ($i eq "trigger_0") {\
return ((::ReadingsVal(Device(),"fc0_trigger_start","") eq "null" ) ?\
"<span style='color:red'>Heute kein Trigger <br>mehr unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" :\
"<span style='color:green'>Trigger von<br>".\
::ReadingsVal(Device(),"fc0_trigger_start","00:00")." bis ".::ReadingsVal(Device(),"fc0_trigger_stop","00:00")."<br>unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" );;\
} elsif ($i eq "trigger_1") {\
if (::ReadingsVal(Device(),"fc1_00_startsAt","null") ne "null") {\
return ((::ReadingsVal(Device(),"fc1_trigger_start","null") eq "null" ) ?\
"<span style='color:red'>Morgen kein Trigger <br>mehr unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" :\
"<span style='color:green'>Morgen ein Trigger von<br>".\
::ReadingsVal(Device(),"fc1_trigger_start","00:00")." bis ".::ReadingsVal(Device(),"fc1_trigger_stop","00:00")."<br>unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" );;\
} else {\
return "Morgen noch kein Trigger vorhanden";;\
}\
}\
return "null";;\
}\
\
}\
\
"Statistiken ".::ReadingsVal(Device(),"current_date",0)." in kWh"|"<span style=font-weight:bold>aktuell</span>"|"<span style=font-weight:bold>heute</span>"|"<span style=font-weight:bold>Monat</span>"|"<span style=font-weight:bold>Jahr</span>"\
\
"Strom<dd>Preis / Kosten</dd>"|Price(0)|Cost("day")|Cost("month")|Cost("year")\
\
## Wenn man das liveMessurment von Tibber verwendet\
"Bezug vom Netz"|\
sprintf("%04d W",([EVU_Tibber_connect:payload_data_liveMeasurement_power] >= 0 ? ::ReadingsVal("EVU_Tibber_connect","payload_data_liveMeasurement_power",0) : 0))|\
Format("day")|Format("month")|Format("year")\
\
"Einspeisung ins Netz"|\
sprintf("%04d W",([EVU_Tibber_connect:payload_data_liveMeasurement_powerProduction] >= 0 ? ::ReadingsVal("EVU_Tibber_connect","payload_data_liveMeasurement_powerProduction",0) : 0))|\
""|""|""\
\
## Wenn man einen eigenes SmartMeter verwendet\
## "Bezug vom Netz"|sprintf("%04d W",([WR_0_KSEM:M_AC_Power] >= 0 ? ::round(::ReadingsVal("WR_0_KSEM","M_AC_Power",0),0) : 0) )|Format("day")|Format("month")|Format("year")\
## "Einspeisung ins Netz"|sprintf("%04d W",([WR_0_KSEM:M_AC_Power] <= 0 ? abs(::round(::ReadingsVal("WR_0_KSEM","M_AC_Power",0),0)) : 0) )|""|""|""
attr EVU_Tibber verbose 3

setstate EVU_Tibber 2024-01-23 10:03:00 ui_command_1 ---
setstate EVU_Tibber 2024-01-20 17:40:53 ui_command_2 ---
</syntaxhighlight>

==== LogDBRep_EVU_Tibber_connect_SQL RAW Device ====
Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements werden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.
<syntaxhighlight lang="Perl">
defmod LogDBRep_EVU_Tibber_connect_SQL DbRep LogDB
attr LogDBRep_EVU_Tibber_connect_SQL DbLogExclude .*
attr LogDBRep_EVU_Tibber_connect_SQL room System
attr LogDBRep_EVU_Tibber_connect_SQL sqlCmdHistoryLength 5
attr LogDBRep_EVU_Tibber_connect_SQL timeout 20
</syntaxhighlight>

== 2. aWATTar ==
=== Vorausetzungen ===
* FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)
* Für die Berechnung der tatsächlichen Kosten benötigt man seine lokalen Fixkosten, die je nach Region unterschiedlich sind.
* Die bisherige Berechnung mit Stand 20240123 wäre wie folgt: round(($val+$val*0.03+1.785)*1.19,2)

=== EVU_aWATTar_connect ===
Das EVU_aWATTar_connect fragt mit HTTPMOD die aWATTar API Webseite ab. Es werden keine Live Verbrauchdaten geliefert.

==== Verwendete Module ====
* HTTPMOD
* DbLog
* DbRep

==== EVU_aWATTar_connect RAW Device ====
Momentan fragt das EVU_aWattar_connect lediglich die aktuellen Preise des Tages ab. Die readings sind an die des EVU_Tibber_connect angelehnt, um im weiteren Verlauf eventuell ein gemeinsames Device für die Anzeige und Steuerung zu erarbeiten.
<syntaxhighlight lang="Perl">
defmod EVU_aWATTar_connect HTTPMOD https://api.awattar.de/v1/marketdata/current.yaml 0
attr EVU_aWATTar_connect DbLogExclude .*
attr EVU_aWATTar_connect comment Version 2024.01.23 13:00\
\
Achtung, momentan werden nur die Börsenpreise ohne die fix Kosten dargestellt.\
\
https://api.awattar.de/v1/marketdata
attr EVU_aWATTar_connect enableControlSet 1
attr EVU_aWATTar_connect get01-15Name fc_max
attr EVU_aWATTar_connect get01-15OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-1Name current_date
attr EVU_aWATTar_connect get01-22Name fc_med
attr EVU_aWATTar_connect get01-22OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-29Name fc_avg
attr EVU_aWATTar_connect get01-29OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-36Name current_price
attr EVU_aWATTar_connect get01-36OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-8Name fc_min
attr EVU_aWATTar_connect get01-8OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01Name 01_priceInfo
attr EVU_aWATTar_connect get01RegOpt g
attr EVU_aWATTar_connect get01Regex date_now: (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})|price_low: ([0-9]+[0-9\.]+)|price_high: ([0-9]+[0-9\.]+)|price_median: ([0-9]+[0-9\.]+)|price_average: ([0-9]+[0-9\.]+)|price_current: ([0-9]+[0-9\.]+)
attr EVU_aWATTar_connect get01URL https://api.awattar.de/v1/marketdata/current.yaml
attr EVU_aWATTar_connect get02-10Name fc0_09_total
attr EVU_aWATTar_connect get02-10OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-11Name fc0_10_total
attr EVU_aWATTar_connect get02-11OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-12Name fc0_11_total
attr EVU_aWATTar_connect get02-12OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-13Name fc0_12_total
attr EVU_aWATTar_connect get02-13OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-14Name fc0_13_total
attr EVU_aWATTar_connect get02-14OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-15Name fc0_14_total
attr EVU_aWATTar_connect get02-15OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-16Name fc0_15_total
attr EVU_aWATTar_connect get02-16OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-17Name fc0_16_total
attr EVU_aWATTar_connect get02-17OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-18Name fc0_17_total
attr EVU_aWATTar_connect get02-18OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-19Name fc0_18_total
attr EVU_aWATTar_connect get02-19OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-1Name fc0_00_total
attr EVU_aWATTar_connect get02-1OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-20Name fc0_19_total
attr EVU_aWATTar_connect get02-20OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-21Name fc0_20_total
attr EVU_aWATTar_connect get02-21OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-22Name fc0_21_total
attr EVU_aWATTar_connect get02-22OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-23Name fc0_22_total
attr EVU_aWATTar_connect get02-23OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-24Name fc0_23_total
attr EVU_aWATTar_connect get02-24OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-2Name fc0_01_total
attr EVU_aWATTar_connect get02-2OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-3Name fc0_02_total
attr EVU_aWATTar_connect get02-3OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-4Name fc0_03_total
attr EVU_aWATTar_connect get02-4OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-5Name fc0_04_total
attr EVU_aWATTar_connect get02-5OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-6Name fc0_05_total
attr EVU_aWATTar_connect get02-6OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-7Name fc0_06_total
attr EVU_aWATTar_connect get02-7OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-8Name fc0_07_total
attr EVU_aWATTar_connect get02-8OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-9Name fc0_08_total
attr EVU_aWATTar_connect get02-9OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02FollowGet 01_priceInfo
attr EVU_aWATTar_connect get02Name 02_priceDay
attr EVU_aWATTar_connect get02RegOpt g
attr EVU_aWATTar_connect get02Regex (?<=abs_[0-9]{2}_amount: )([0-9]+[0-9\.]+)
attr EVU_aWATTar_connect get02URL https://api.awattar.de/v1/marketdata/current.yaml
attr EVU_aWATTar_connect get03-1Name fc3_00_startsAt
attr EVU_aWATTar_connect get03-1OExpr POSIX::strftime("%Y-%m-%d %H:%M:%S",localtime(substr($val,0,10)))
attr EVU_aWATTar_connect get03-4Name fc3_00_total
attr EVU_aWATTar_connect get03-4OExpr round($val/1000,4)
attr EVU_aWATTar_connect get03Name 02_priceAll
attr EVU_aWATTar_connect get03RegOpt g
attr EVU_aWATTar_connect get03Regex "start_timestamp": (\d{10})|"marketprice": (\d*\.\d*)
attr EVU_aWATTar_connect get03URL https://api.awattar.de/v1/marketdata?start=1701990000000&end=1702159200000
attr EVU_aWATTar_connect group PV Steuerung EVU
attr EVU_aWATTar_connect icon sani_pump
attr EVU_aWATTar_connect room Strom->Boerse
attr EVU_aWATTar_connect sortby 213
attr EVU_aWATTar_connect userReadings fc_trigger_price:fc_avg.* {\
## fc_trigger_price:[fc_avg|compensation_grid].* {\\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_min = ReadingsVal("$NAME","fc_min",0);;\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
if ( ReadingsVal("$NAME","compensation_grid",0) != 0 ) {\
my $price_level_battery = round( ($fc_avg - ReadingsVal("$NAME","compensation_grid",0)) *0.85 , 1) ;;\
if ( $price_level > $price_level_battery ) {\
$price_level = $price_level_battery;;\
}\
}\
$price_level;;\
},\
\
fc0_trigger_start:fc_trigger_price.* {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_stop:fc0_trigger_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc0_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc0_trigger:fc0_trigger_stop.* {\
\
# Setzen des Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",100) < ReadingsVal("$NAME","fc_trigger_price",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc_DbLog:fc0_00_total.* {\
my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\
\
for (my $loop_fc = 0;; $loop_fc <= 1;; $loop_fc++) {\
$loop_fc_next = $loop_fc +1;;\
$date = ReadingsVal("$NAME","current_date","null");;\
if ($date ne "null") {\
$date =~ /([\d+-]+)/;; $date = $1 ;;\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$hour = sprintf("%02d",$loop_hour);;\
$timestamp = $date." ".$hour.":00:00";;\
$value = ReadingsVal("$NAME","fc".$loop_fc."_".$hour."_total","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','fc".$loop_fc."_total','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
} else {\
fhem("deletereading $NAME fc1_.*");;\
}\
}\
ReadingsVal("$NAME","current_date","null");;\
}
attr EVU_aWATTar_connect verbose 0
</syntaxhighlight>

==== LogDBRep_EVU_aWATTar_connect_SQL RAW Device ====
Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements werden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.
<syntaxhighlight lang="Perl">
defmod LogDBRep_EVU_aWATTar_connect_SQL DbRep LogDB
attr LogDBRep_EVU_aWATTar_connect_SQL DbLogExclude .*
attr LogDBRep_EVU_aWATTar_connect_SQL room System
attr LogDBRep_EVU_aWATTar_connect_SQL sqlCmdHistoryLength 5
attr LogDBRep_EVU_aWATTar_connect_SQL timeout 20
</syntaxhighlight>

== 3. EPEX_Spot ==
=== Vorausetzungen ===
httpmod

==== EPEX_Spot RAW Device ====
Mit diesem device erhält man die viertelstündlichen Börsenpreise für heute und morgen ('EPEX_prices' und zugehörige 'EPEX_timetags' als Listen ) und den aktuellen Preis ('EPEX_price'). <br>
Die 'dayahead' Preise für morgen werden gegen 14:00 am Vortag veröffentlicht. Bis dahin enthalten die Listen 'EPEX_prices' und 'EPEX_timetags' 96 Elemente, danach sind es 192 Elemente.<br>
Die timetags sind die Unix-timestamps der Viertelstunde, ab welcher der jeweilige Preis gilt.
<div class="mw-collapsible mw-collapsed">
Code für device ''EPEX_Boersenpreise'':<div class="mw-collapsible-content">
<pre>
defmod EPEX_Boersenpreise HTTPMOD URL 900
attr EPEX_Boersenpreise alignTime 00:00
attr EPEX_Boersenpreise comment This device queries prices for electrical energy from https://api.energy-charts.info/price?bzn=DE-LU. All prices are in €/MWh
attr EPEX_Boersenpreise disable 0
attr EPEX_Boersenpreise event-on-update-reading EPEX_price.*
attr EPEX_Boersenpreise get01-1Name EPEX_timetags
attr EPEX_Boersenpreise get01-2Name EPEX_prices
attr EPEX_Boersenpreise get01Name EPEX_prices
attr EPEX_Boersenpreise get01Regex unix_seconds":\[(.*?)\],"price":\[(.*?)\]
attr EPEX_Boersenpreise get01Replacement02Value {my ($s,$m,$h,$D,$M,$Y)=localtime();;my $start=int(fhemTimeLocal(0,0,0,$D,$M,$Y));;"https://api.energy-charts.info/price?bzn=DE-LU&start=".sprintf("%d",$start)."&end=".sprintf("%d",$start+86400+86399)}
attr EPEX_Boersenpreise group EPEX
attr EPEX_Boersenpreise reading02Name EPEX_price
attr EPEX_Boersenpreise reading02RecombineExpr {my ($s,$m,$h,$D,$M,$Y)=localtime();; my $time=fhemTimeLocal(0,0,0,$D,$M,$Y);;\
my $price = "error";;\
if (time_str2num(ReadingsTimestamp($name, "EPEX_prices",0)) > $time-86400) {\
$time=fhemTimeLocal(0,15*int($m/15),$h,$D,$M,$Y);;\
my @times = split(/,/,ReadingsVal($name,"EPEX_timetags","-1"));;\
my @prices = split(/,/,ReadingsVal($name,"EPEX_prices","-1"));;\
my %map;; @map{@times} = @prices;; \
if (exists $map{$time}) {$price = $map{$time}};;\
};;\
if ($h % 2 == 0 and $m == 0) {fhem("get $name EPEX_prices")};;\
$price}
attr EPEX_Boersenpreise reading02Regex .
attr EPEX_Boersenpreise replacement02Mode expression
attr EPEX_Boersenpreise replacement02Regex URL
attr EPEX_Boersenpreise replacement02Value {"http://localhost/"}
attr EPEX_Boersenpreise room Energie
attr EPEX_Boersenpreise showError 1
attr EPEX_Boersenpreise stateFormat EPEX_price €/MWh
attr EPEX_Boersenpreise timeout 5
attr EPEX_Boersenpreise userReadings no_of_data:EPEX_prices.* {split(/,/,ReadingsVal("EPEX_Boersenpreise","EPEX_prices",""))}
</pre>
</div>
</div>
Weder get02Poll noch get03Poll sollten auf 1 gesetzt sein, da es dann zu gelegentlichen timeout-Fehlern kommt.

== Links ==
* Website (deutsch) des Anbieters [https://tibber.com/de Tibber]
* Website (deutsch) des Anbieters [https://www.awattar.de/ aWATTar]

[[Kategorie:Strompreis]]

KNX

2025-12-09T19:35:01Z

Ph1959de: Sichtung der letzten Änderungen; kleinere Korrekturen

{{Infobox Modul
|ModPurpose=Unterstützung des KNX Feldbus in FHEM
|ModType=d
|ModForumArea=KNX/EIB
|ModFTopic=122582
|ModTechName=10_KNX.pm
|ModOwner=Erwin ({{Link2FU|115|Forum}}/[[Benutzer Diskussion:Erwin111|Wiki]])
}}
Das Modul [[KNX]] implementiert die Unterstützung für den Gebäudeautomations-Feldbus [https://de.wikipedia.org/wiki/KNX-Standard KNX] (eine Weiterentwicklung von EIB) innerhalb von FHEM.

== Voraussetzungen ==
{{Randnotiz|RNText=Hinweis: Das EIB-Modul ist seit 2018 deprecated und wird auch nicht mehr gewartet. Es ist daher dringend empfohlen, auf das KNX-Modul umzusteigen!
Unterstützung gibt es auf der Wiki Seite [[KNX#Umstellung_von_EIB_auf_KNX_Modul|Umstellung von EIB auf KNX]] oder in {{Link2Forum|Topic=126994|LinkText=diesem Thread im Forum}}|RNTyp=Warn|style=}}

Der KNX support ist in FHEM als 2stufiges Modul konzipiert, braucht daher zusätzlich zu diesem Modul ein sog. IO-Modul, das mit der "Aussenwelt" spricht. Das IO-Modul: [[KNXIO|'''KNXIO''']] ersetzt die bisher verfügbaren Module '''TUL''' und '''KNXTUL''', es unterstützt die (meisten) Funktionen der bisherigen IO-Module und bietet zusätzlich weitere Kommunikationsoptionen.

Weiters wird eine Schnittstellen-Hardware gebraucht zwischen dem KNX-Bus und der LAN- oder USB- oder Seriell-Schnittstelle, das kann ein serielles->KNX-Bus Modul sein (Bsp: siehe Fa. Busware TUL,...) oder auch ein Hardware Gateway oder Router.

Als Middleware kommt meistens knxd zum Einsatz. [https://github.com/knxd/knxd/wiki knxd wiki]

== Anwendung ==
=== Define ===
<syntaxhighlight lang="text">
define <name> KNX <group>:<dpt>[:[gadName]:[set|get|listenonly]:[nosuffix]] [<group>:<dpt> ..] [<group>:<dpt> ..]
</syntaxhighlight>Wie in FHEM üblich, alles was hier zwischen <...> dargestellt ist, sind mandatory Angaben! Optionales wird zwischen [...] dargestellt.

Mehrfache <group><dpt>.... sind in einer Definition zulässig. Damit kann man Geräte mit komplexen Funktionen in einem FHEM Gerät abbilden. (siehe Beispiele)

==== Definitions-Felder im Detail ====
* '''group''' - Das ist die GruppenAdresse (GA) des jeweiligen KNX-Geräts. Diese wird (meist) mit der ETS in das KNX-Gerät programmiert. Ein KNX Aktor reagiert nur auf diese Adresse, wenn es eine seiner eigenen ist. Format: <0-31>/<0-7>/<0-255>
* '''dpt''' - Das ist die Definition (Data Point Type), wie FHEM und auch das KNX-Gerät den gesendeten/empfangenen Wert interpretieren! Die Werte (am Bus) können 1bit, 2bit,....4byte lang sein, oder auch 14Char.Text, oder Zeit und Datum. Falls der dpt in FHEM nicht mit dem im KNX-Gerät übereinstimmt, gibts falsche od. gar keine Werte! Eine vollständige Liste der unterstützen dpt-Types: {{Link2CmdRef|Anker=KNX-dpt}}.

* '''gadName''' - GruppenAdressName bzw. GA-Alias. Angabe ist optional, sinnvoll ist ein "sprechender Name", z.B. "EinAus" od. "steuern" für eine GA die zum senden eines Befehls dient, oder z.B. "status" für die Rückmeldung vom Gerät. Ist kein gadName definiert, wird g1...g9 als gadName verwendet. Der gadName beeinflusst auch die entsprechenden Reading-Namen! Die Wahl eines gadName ist fast völlig frei - (Einschränkungen sind in der cmdref dokumentiert), allerdings ist eine Überlegung, den gadNamen so zu wählen, das der daraus abgeleitete readingName und auch set-cmd mit einem externen System (z.B. Sprachsteuerung) kompatibel ist. Z.B.: für Soll-Temperatur->desired-temp, Luftfeuchte->humidity, Luftdruck->pressure, Temperatur->temperature, usw... Damit erspart man sich mühsame mappings bei der Umsetzung der Sprachsteuerung. Beispiel: ''"Axxx wie ist die Solltemperatur im Wohnzimmer"'' - wird mit <code>get Wohnzimmer desired-temperature</code> übersetzt....
* '''set | get | listenonly''' - alternative optionen, optional, (nur eine Angabe möglich) zur Beeinflussung was FHEM (oder der User) mit dieser Definition machen darf. set bzw get steht für: Fhem darf senden bzw. aktiv ein Gerät abfragen, listenonly bedeutet dass weder was gesendet noch was abgefragt werden darf, es soll nur ankommende Messages verarbeitet werden. Sinnvoll z.B. bei einem Windsensor der in Intervallen die Windgeschwindigkeit auf den Bus sendet.
* '''nosuffix''' - optional, beeinflusst den readingNamen. Ohne diesen Parameter lauten Reading-Namen z.b. "EinAus-set" u. "EinAus-get" bzw. "setG1" u. "getG1", mit nosuffix fällt das -set bzw. -get weg, alle gesendeten- und empfangenen-Messages landen im reading EinAus.

Siehe {{Link2CmdRef|Anker=KNX}}.

==== Define mittels autocreate ====
Autocreate wird unterstützt. Ankommende Messages erhalten DeviceNamen nach dem Schema: '''KNX_nnmmooo'''. "nn" bezeichnet die Hauptlinie, "mm" die Bereichsline und "ooo" das KNX-Gerät (= die GA_Addresse). Als dpt-Typ wird dptRAW gesetzt, weil autocreate keinen richtigen dpt vergeben kann. Wichtig ist, einen korrekten dpt-Typ zu definieren, damit valides en-/de-coding von Messages möglich ist. Es wird auch keine FileLog- oder SVG-Definition erstellt. Sinnvollerweise ändert man auch den DeviceName auf etwas "sprechendes" (z.B. Licht_Wohnzimmer). Man kann das definieren durch autocreate beeinflussen, mit den Attributen: '''autocreateThreshold''' und '''ignoreTypes''' im globalen autocreate-device.

Falls man einen FileLog für ALLE KNX-Geräte haben will, die mittels Autocreate angelegt wurden - oder künftig werden, könnte das so aussehen: <syntaxhighlight lang="text">
define KNX_default_Fl FileLog %L/KNX_default-%Y-W%W.log KNX_.*
attr KNX_default_Fl logtype text
attr KNX_default_Fl nrarchive 2
</syntaxhighlight>

==== ESF-import oder: Wie bekomme ich alle GA's aus der ETS in FHEM definiert? ====
Dazu gibts ein XLSX {{Link2Forum|Topic=128532|Message=1231776|LinkText=im Forum}}, welches automatisiert FHEM Definitionen erstellt. Danke an JooNey, der dafür auch Unterstützung im Forum leistet!

=== Attribute ===
Zusätzlich zu den FHEM-standard Attributen sind folgende Attribute verfügbar:
* '''disable''' - ident zum FHEM Standard - kein Senden oder Empfangen möglich!
* '''format''' - hängt den Inhalt dieses Attr. an den Wert an, - im state Reading! Diese Attribut ist abgekündigt, nicht mehr verwenden. Besser stateCmd, stateRegex oder stateFormat verwenden.
* '''stateRegex''' - beeinflusst, welcher Wert in das Reading state gesetzt wird, und zwar durch string-substitution. Siehe auch Beispiele.
* '''stateCmd''' - beeinflusst, welcher Wert in das Reading state gesetzt wird, mittels perl-funktion. Siehe auch Beispiele.
* '''putCmd''' - Falls dieses Attr gesetzt ist, wird ein read-request vom KNX Gerät beantwortet. Der Rückgabe-Wert wird mit einer perl Funktion bestimmt.
* '''KNX_toggle''' - Bei einem "toggle-cmd" muss das Device den aktuellen Status des Gerätes wissen. Mit diesem Attr. kann das "Status Device" definiert werden.
* '''readingNmap''' - ändert reading Name(n) mittels regex. Beispiele in der cmd-ref. Dieses Attribut wird vor allen anderen Attributen verarbeitet, daher müssen readingNamen die in z.B. stateCmd,..., notifies... verwendet werden, angepasst werden.
* '''IODev''' - Auf Grund von Änderungen im IO-Handling durch FHEM (-core) ist dieses Attribut in den allermeisten Fällen nicht mehr nötig und evtl. sogar kontraproduktiv! Die Ausnahme ist: Falls mehrere KNX-IO (TUL,KNXTUL,KNXIO) devices definiert sind. Hier ist jedoch extreme Vorsicht geboten, es kann zu endlosen msg-loops kommen!

Siehe {{Link2CmdRef|Anker=KNX-attr}}.

=== Set Command ===
Ein Set command ist nur erlaubt, wenn die option im define nicht get oder listenonly ist!

Die Syntax:<syntaxhighlight lang="text">
set <device> <gadName> <wert>
set <device> <wert>
set <device> g1 <wert>
</syntaxhighlight>In der 2ten Zeile fehlt der gadName, das ist dennoch ein gültiges Set, es wird die erste Gruppenadresse (g1) zum senden verwendet.

In der 3ten Zeile wird explizit die erste Gruppenadresse verwendet, allerdings darf dann kein gadName definiert sein!

'''Welche Werte sind im Set Command erlaubt ?'''

Die erlaubten Werte sind vom dpt abhängig!
* Alle Werte / Wertbereiche die für diesen dpt vorgesehen sind - Referenz: {{Link2CmdRef|Anker=KNX-dpt}}
* Für dpt1 und dpt1.001 zusätzlich: toggle, blink <Anzahl> <Dauer>, (on|off)-for-timer <Sekunden>, (on|off)-until <hh:mm:ss>
* Für dpt10, dpt11, dpt19 (Datum/Zeit) zusätzlich: now
* Für dpt16 (14 Char Text) zusätzlich: >CLR< -löscht gesamten Text

=== Get Command ===
Ein Get command ist nur erlaubt, wenn die option im define nicht set oder listenonly ist! Die Syntax ist analog zum Set command (ohne <wert>). Kommt eine Antwort vom KNX-Gerät wird dieser Wert im entsprechenden Reading gespeichert.

== Umstellung von EIB auf KNX Modul ==
Nachdem das EIB-Modul seit März 2018 nicht mehr aktualisiert wurde und abgekündigt ist, möchte ich dazu motivieren, auf das aktuelle KNX-Modul umzustellen.

Ausführliche Erklärungen und Beispiele sind in {{Link2Forum|Topic=126994|LinkText=diesem Forenthema}} zu finden.

== Anwendungsbeispiele ==
Eine umfangreiche Sammlung von Anwendungsbeispielen ist auf der Seite '''[[KNX Device Definition - Beispiele]]''' zusammengestellt.

== Bekannte Probleme ==

== Links ==

[[Kategorie:EIB/KNX]]

FHEMWEB/MiniChart

2025-12-08T15:49:36Z

Ph1959de: Seite Kategorisiert und wikifiziert, Code-Beispiele kompakter dargestellt, teilweise mit syntax-highlighting, Gliederungsebenen bereinigt

[[Datei:Minichart flex mobile.png|Mini|rechts]]
== MiniChart – kompaktes Chart-Widget (Line & Bar) ==
Das MiniChart-Widget visualisiert Messwertverläufe als kompaktes Liniendiagramm oder Balkendiagramm für die Darstellung im [[FHEMWEB]] ([[PGM2]]) Frontend.
Zusätzlich zeigt es drei aktuelle Werte, die aus Label, Reading und Einheit bestehen. Zum Einrichten sind drei Schritte notwendig.

=== Hilfe ===
* Forenthread zum {{Link2Forum|Topic=141857|LinkText=MiniChart Widget}}

== 1️⃣ 99_myUtils.pm – Hilfsfunktion zum Speichern von historischen Werten ==
Zuerst wird eine Subroutine in [[99_myUtils_anlegen|99_myUtils.pm]] angelegt, die neue Werte an ein Fixed-Array anhängt und alte Werte entfernt, falls die maximale Größe überschritten wird.
<syntaxhighlight lang="Perl">
sub AppendToFixedArray {
my ($dev, $reading, $newVal, $maxSize) = @_;
$maxSize //= 250; # Standard: 250 Werte
my $current = ReadingsVal($dev, $reading, '');
my @values = split(',', $current);
if (@values >= $maxSize) {
@values = @values[-($maxSize - 1) .. -1]; # Älteste Werte entfernen
}
push @values, $newVal;
return join(',', @values);
}
</syntaxhighlight>

== 2️⃣ at-Timer zum regelmäßigen Aktualisieren ==
Mit einem `[[at]]`-Timer werden die Werte der Messgeräte regelmäßig in die `chartArray`-Readings geschrieben.
<syntaxhighlight lang="Perl">
defmod chartUpdate at +*00:05 {\
my $val = ReadingsVal("Smartmeter_2E1F50", "APOX_Power", 0);;\
my $new = AppendToFixedArray("Smartmeter_2E1F50", "chartArray", $val);;\
fhem("setreading Smartmeter_2E1F50 chartArray $new");;\
\
my $val1 = ReadingsVal("OpenDTU", "power", 0);;\
my $new1 = AppendToFixedArray("OpenDTU", "chartArray", $val1);;\
fhem("setreading OpenDTU chartArray $new1");;\
\
my $val2 = ReadingsVal("Kuehlschrank", "power", 0);;\
my $new2 = AppendToFixedArray("Kuehlschrank", "chartArray", $val2);;\
fhem("setreading Kuehlschrank chartArray $new2");;\
\
my $val3 = ReadingsVal("Luftentfeuchter", "ENERGY_Power", 0);;\
my $new3 = AppendToFixedArray("Luftentfeuchter", "chartArray", $val3);;\
fhem("setreading Luftentfeuchter chartArray $new3");;\
\
my $val4 = ReadingsVal("Geschirrspueler", "power", 0);;\
my $new4 = AppendToFixedArray("Geschirrspueler", "chartArray", $val4);;\
fhem("setreading Geschirrspueler chartArray $new4");;\
\
my $val5 = ReadingsVal("Trockner", "power", 0);;\
my $new5 = AppendToFixedArray("Trockner", "chartArray", $val5);;\
fhem("setreading Trockner chartArray $new5");;\
\
my $val6 = ReadingsVal("Waschmaschine", "power", 0);;\
my $new6 = AppendToFixedArray("Waschmaschine", "chartArray", $val6);;\
fhem("setreading Waschmaschine chartArray $new6");;\
\
my $val7 = ReadingsVal("Pumpe_FBH_Pwr", "power", 0);;\
my $new7 = AppendToFixedArray("Pumpe_FBH_Pwr", "chartArray", $val7);;\
fhem("setreading Pumpe_FBH_Pwr chartArray $new7");;\
\
my $val8 = ReadingsVal("Heizstab_BW_Pwr", "power", 0);;\
my $new8 = AppendToFixedArray("Heizstab_BW_Pwr", "chartArray", $val8);;\
fhem("setreading Heizstab_BW_Pwr chartArray $new8");;\
}
</syntaxhighlight>

== 3️⃣ Minichart ==
=== 1. Widget-Datei aus contrib laden ===
Bevor das MiniChart-Widget genutzt werden kann, muss die JS-Datei ins FHEM-Webverzeichnis kopiert werden.
Dies kann mit der Perlfunktion <code>{ Svn_GetFile('from SVN Path', 'to local Path') }</code> direkt in der FHEM Kommandozeile erfolgen.
<syntaxhighlight lang="Perl">
{ Svn_GetFile('contrib/fhemweb_minichart.js', 'www/pgm2/fhemweb_minichart.js') }
</syntaxhighlight>

=== 2. Widget im Device mit widgetOverride einrichten ===
=== Werteanzeige ===
Drei Textzeilen können angezeigt werden, jeweils im Format:
:<code>Label@Reading@Einheit</code>

Beispiel:
:<code>Jetzt@power@W,Heute@yieldday@kWh,Gesamt@yieldtotal@kWh</code>

==== Ausblenden einzelner Zeilen ====
Jede der drei Zeilen kann vollständig oder teilweise ausgeblendet werden, indem das jeweilige Element leer gelassen wird. Das Widget setzt intern automatisch ein geschütztes Leerzeichen ( ).

Beispiele:
* Nur Label ausblenden:
:<code>@reading@W</code>
* Nur Reading ausblenden:
:<code>Label@@W</code>
* Nur Einheit ausblenden:
:<code>Label@reading@</code>
* Ganze Zeile ausblenden:
:<code> </code>

=== Diagrammtypen ===
MiniChart unterstützt zwei Diagrammtypen:
* line – geglättetes Liniendiagramm mit Farbverlauf
* bar – Balkendiagramm mit positiver/negativer Farbgebung

Das Chart-Reading benötigt eine kommagetrennte Zahlenliste, z. B.:
:<code>10,20,15,18,25</code>

Chartoptionen:
:<code>chartType@colorPositive@colorNegative</code>

Beispiele:
:<code>line@#3b82f6@#ff0000</code>
:<code>bar@#00cc88@#cc0044</code>

Fallback (nur ChartReading angegeben):
:<code>dann wird automatisch line@#3b82f6@#3b82f6 gesetzt</code>

=== Einrichtung im Device ===
Syntax:
:<code><webCmd>:minichart,Label1@Reading1@Einheit,Label2@Reading2@Einheit,Label3@Reading3@Einheit,ChartReading,chartType@colorPos@colorNeg</code>

Beispiel Liniendiagramm:
<syntaxhighlight lang="Perl" line>
attr <device> webCmd minichart
attr <device> widgetOverride minichart:minichart,Jetzt@power@W,Heute@yieldday@kWh,Gesamt@yieldtotal@kWh,chartArray,line@#3b82f6@#ff0000
</syntaxhighlight>

Beispiel Balkendiagramm:
:<code>...,chartArray,bar@#00cc88@#cc0044</code>

Fallback (Standard line + Standardfarbe):
:<code>...,chartArray</code>

=== Parameterübersicht ===
{| class="wikitable"
! Abschnitt
! Bedeutung
! Beschreibung
|-
| <code><beliebigerName></code>
| webCmd-Zuweisung
| Definiert die Instanz des Widgets.
|-
| <code>minichart</code>
| Widget-Typ
| Aktiviert das MiniChart-Widget.
|-
| <code>Label1@Reading1@Einheit1</code>
| Anzeigezeilen
| Drei frei definierbare Werte-/Statusfelder; mit <code> </code> komplett ausblendbar.
|-
| <code>Label2@Reading2@Einheit2</code>
| Anzeigezeilen
| Drei frei definierbare Werte-/Statusfelder; mit <code> </code> komplett ausblendbar.
|-
| <code>Label3@Reading3@Einheit3</code>
| Anzeigezeilen
| Drei frei definierbare Werte-/Statusfelder; mit <code> </code> komplett ausblendbar.
|-
| <code>ChartReading</code>
| Datenquelle
| Liefert Array-Werte für das Diagramm .
|-
| <code>chartType@colorPos@colorNeg</code>
| Chart-Optionen
| line oder bar; Farben optional.
|}

[[Kategorie:Code Snippets]]
[[Kategorie:FHEM Frontends]]

KNX

2025-12-07T16:12:54Z

Ph1959de: Tippfehler bereinigt

{{Infobox Modul
|ModPurpose=Unterstützung des KNX Feldbus in FHEM
|ModType=d
|ModForumArea=KNX/EIB
|ModFTopic=122582
|ModTechName=10_KNX.pm
|ModOwner=Erwin ({{Link2FU|115|Forum}}/[[Benutzer Diskussion:Erwin111|Wiki]])
}}
Das Modul [[KNX]] implementiert die Unterstützung für den Gebäudeautomations-Feldbus [https://de.wikipedia.org/wiki/KNX-Standard KNX] (eine Weiterentwicklung von EIB) innerhalb von FHEM.

== Voraussetzungen ==
{{Randnotiz|RNText=Hinweis: Das EIB-Modul ist seit 2018 deprecated und wird auch nicht mehr gewartet. Es ist daher dringend empfohlen, auf das KNX-Modul umzusteigen!
Unterstützung gibst hier: https://wiki.fhem.de/wiki/KNX#Umstellung_von_EIB_auf_KNX_Modul oder diesem Thread: https://forum.fhem.de/index.php/topic,126994.0.html im Forum|RNTyp=Warn|style=}}

Der KNX support ist in FHEM als 2stufiges Modul konzipiert, braucht daher zusätzlich zu diesem Modul ein sog. IO-Modul, das mit der "Aussenwelt" spricht. Das IO-Modul: [[KNXIO|'''KNXIO''']] ersetzt die bisher verfügbaren Module '''TUL''' und '''KNXTUL''', es unterstützt die (meisten) Funktionen der bisherigen IO-Module und bietet zusätzlich weitere Kommunikationsoptionen.

Weiters wird eine Schnittstellen-Hardware gebraucht zwischen dem KNX-Bus und der LAN- oder USB- oder Seriell-Schnittstelle, das kann ein serielles->KNX-Bus Modul sein (Bsp: siehe Fa. Busware TUL,...) oder auch ein Hardware Gateway oder Router.

Als Middleware kommt meistens knxd zum Einsatz. [https://github.com/knxd/knxd/wiki knxd wiki]

== Anwendung ==
=== Define ===
<syntaxhighlight lang="text">
define <name> KNX <group>:<dpt>[:[gadName]:[set|get|listenonly]:[nosuffix]] [<group>:<dpt> ..] [<group>:<dpt> ..]
</syntaxhighlight>Wie in FHEM üblich, alles was hier zwischen <...> dargestellt ist, sind mandatory Angaben! Optionales wird zwischen [...] dargestellt.

Mehrfache <group><dpt>.... sind in einer Definition zulässig. Damit kann man Geräte mit komplexen Funktionen in einem FHEM Gerät abbilden. (siehe Beispiele)

==== Definitions-Felder im Detail ====
* '''group''' - Das ist die GruppenAdresse (GA) des jeweiligen KNX-Geräts. Diese wird (meist) mit der ETS in das KNX-Gerät programmiert. Ein KNX Aktor reagiert nur auf diese Adresse, wenn es eine seiner eigenen ist. Format: <0-31>/<0-7>/<0-255>
* '''dpt''' - Das ist die Definition (Data Point Type), wie FHEM und auch das KNX-Gerät den gesendeten/empfangenen Wert interpretieren! Die Werte (am Bus) können 1bit, 2bit,....4byte lang sein, oder auch 14Char.Text, oder Zeit und Datum. Falls der dpt in FHEM nicht mit dem im KNX-Gerät übereinstimmt, gibts falsche od. gar keine Werte! Eine vollständige Liste der unterstützen dpt-Types: {{Link2CmdRef|Anker=KNX-dpt}}.

* '''gadName''' - GruppenAdressName bzw. GA-Alias. Angabe ist optional, sinnvoll ist ein "sprechender Name", z.B. "EinAus" od. "steuern" für eine GA die zum senden eines Befehls dient, oder z.B. "status" für die Rückmeldung vom Gerät. Ist kein gadName definiert, wird g1...g9 als gadName verwendet. Der gadName beeinflusst auch die entsprechenden Reading-Namen! Die Wahl eines gadName ist fast völlig frei - (Einschränkungen sind in der cmdref dokumentiert), allerdings ist eine Überlegung, den gadNamen so zu wählen, das der daraus abgeleitete readingName und auch set-cmd mit einem externen System (z.B. Sprachsteuerung) kompatibel ist. Z.B.: für Soll-Temperatur->desired-temp, Luftfeuchte->humidity, Luftdruck->pressure, Temperatur->temperature, usw... Damit erspart man sich mühsame mappings bei der Umsetzung der Sprachsteuerung. Beispiel: ''"Axxx wie ist die Solltemperatur im Wohnzimmer"'' - wird mit <code>get Wohnzimmer desired-temperature</code> übersetzt....
* '''set | get | listenonly''' - alternative optionen, optional, (nur eine Angabe möglich) zur Beeinflussung was FHEM (oder der User) mit dieser Definition machen darf. set bzw get steht für: Fhem darf senden bzw. aktiv ein Gerät abfragen, listenonly bedeutet dass weder was gesendet noch was abgefragt werden darf, es soll nur ankommende Messages verarbeitet werden. Sinnvoll z.B. bei einem Windsensor der in Intervallen die Windgeschwindigkeit auf den Bus sendet.
* '''nosuffix''' - optional, beeinflusst den readingNamen. Ohne diesen Parameter lauten Reading-Namen z.b. "EinAus-set" u. "EinAus-get" bzw. "setG1" u. "getG1", mit nosuffix fällt das -set bzw. -get weg, alle gesendeten- und empfangenen-Messages landen im reading EinAus.

Siehe {{Link2CmdRef|Anker=KNX}}.

==== Define mittels autocreate ====
Autocreate wird unterstützt. Ankommende Messages erhalten DeviceNamen nach dem Schema: '''KNX_nnmmooo'''. "nn" bezeichnet die Hauptlinie, "mm" die Bereichsline und "ooo" das KNX-Gerät (= die GA_Addresse). Allerdings wird automatisch das disable Attribut gesetzt, weil autocreate keinen dpt vergeben kann und damit en- / de-coding von Messages nicht möglich ist. Es wird auch keine FileLog- oder SVG-Definition erstellt. Um das disable attribut zu löschen, muß man vorher einen gültigen dpt in die Definition einfügen. Sinnvollerweise ändert man auch den DeviceName auf etwas "sprechendes" (z.B. Licht_Wohnzimmer). Man kann das definieren durch autocreate beeinflussen, mit dem Attributen: '''autocreateThreshold''' und '''ignoreTypes''' im globalen autocreate-device.

Falls man einen FileLog für ALLE KNX-Geräte haben will, die mittels Autocreate angelegt wurden - oder künftig werden, könnte das so aussehen: <syntaxhighlight lang="text">
define KNX_default_Fl FileLog %L/KNX_default-%Y-W%W.log KNX_.*
attr KNX_default_Fl logtype text
attr KNX_default_Fl nrarchive 2
</syntaxhighlight>

==== ESF-import oder: Wie bekomme ich alle GA's aus der ETS in FHEM definiert? ====
Dazu gibts ein XLSX [https://forum.fhem.de/index.php/topic,128532.msg1231776.html#msg1231776 im Forum] , welches automatisiert FHEM definitionen erstellt. Danke an JooNey, der dafür auch Unterstützung im Forum leistet!

=== Attribute ===
Zusätzlich zu den FHEM-standard Attributen sind folgende Attribute verfügbar:
* '''disable''' - ident zum FHEM Standard - kein Senden oder Empfangen möglich!
* '''format''' - hängt den Inhalt dieses Attr. an den Wert an, - im state Reading! Diese Attribut ist abgekündigt, nicht mehr verwenden. Besser stateCmd, stateRegex oder stateFormat verwenden.
* '''stateRegex''' - beeinflusst, welcher Wert in das Reading state gesetzt wird, und zwar durch string-substitution. Siehe auch Beispiele.
* '''stateCmd''' - beeinflusst, welcher Wert in das Reading state gesetzt wird, mittels perl-funktion. Siehe auch Beispiele.
* '''putCmd''' - Falls dieses Attr gesetzt ist, wird ein read-request vom KNX Gerät beantwortet. Der Rückgabe-Wert wird mit einer perl Funktion bestimmt.
* '''KNX_toggle''' - Bei einem "toggle-cmd" muss das Device den aktuellen Status des Gerätes wissen. Mit diesem Attr. kann das "Status Device" definiert werden.
* '''readingNmap''' - ändert reading Name(n) mittels regex. Beispiele in der cmd-ref. Dieses Attribut wird vor allen anderen Attributen verarbeitet, daher müssen readingNamen die in z.B. stateCmd,..., notifies... verwendet werden, angepasst werden.
* '''IODev''' - Auf Grund von Änderungen im IO-Handling durch FHEM (-core) ist dieses Attribut in den allermeisten Fällen nicht mehr nötig und evtl. sogar kontraproduktiv! Die Ausnahme ist: Falls mehrere KNX-IO (TUL,KNXTUL,KNXIO) devices definiert sind. Hier ist jedoch extreme Vorsicht geboten, es kann zu endlosen msg-loops kommen!

Siehe {{Link2CmdRef|Anker=KNX-attr}}.

=== Set Command ===
Ein Set command ist nur erlaubt, wenn die option im define nicht get oder listenonly ist!

Die Syntax:<syntaxhighlight lang="text">
set <device> <gadName> <wert>
set <device> <wert>
set <device> g1 <wert>
</syntaxhighlight>In der 2ten Zeile fehlt der gadName, das ist dennoch ein gültiges Set, es wird die erste Gruppenadresse (g1) zum senden verwendet.

In der 3ten Zeile wird explizit die erste Gruppenadresse verwendet, allerdings darf dann kein gadName definiert sein!

'''Welche Werte sind im Set Command erlaubt ?'''

Die erlaubten Werte sind vom dpt abhängig!
* Alle Werte / Wertbereiche die für diesen dpt vorgesehen sind - Referenz: {{Link2CmdRef|Anker=KNX-dpt}}
* Für dpt1 und dpt1.001 zusätzlich: toggle, blink <Anzahl> <Dauer>, (on|off)-for-timer <Sekunden>, (on|off)-until <hh:mm:ss>
* Für dpt10, dpt11, dpt19 (Datum/Zeit) zusätzlich: now
* Für dpt16 (14 Char Text) zusätzlich: >CLR< -löscht gesamten Text

=== Get Command ===
Ein Get command ist nur erlaubt, wenn die option im define nicht set oder listenonly ist! Die Syntax ist analog zum Set command (ohne <wert>). Kommt eine Antwort vom KNX-Gerät wird dieser Wert im entsprechenden Reading gespeichert.

== Umstellung von EIB auf KNX Modul ==
Nachdem das EIB-Modul seit März 2018 nicht mehr aktualisiert wurde und abgekündigt ist, möchte ich dazu motivieren, auf das aktuelle KNX-Modul umzustellen.

Ausführliche Erklärungen und Beispiele sind in {{Link2Forum|Topic=126994|LinkText=diesem Forenthema}} zu finden.

== Anwendungsbeispiele ==
Eine umfangreiche Sammlung von Anwendungsbeispielen ist auf der Seite '''[[KNX Device Definition - Beispiele]]''' zusammengestellt.

== Bekannte Probleme ==

== Links ==

[[Kategorie:EIB/KNX]]

FHEMWEB/Widgets

2025-12-05T16:58:04Z

Ph1959de: Foren- und Intra-Wiki Links umformatiert (cmdref links sollten auch auf Link2CmdRef umgestellt werden)

Widgets sind Frontendelemente, die der Dateneingabe und -anzeige dienen. Die hier gezeigten Frontendelemente werden durch [[FHEMWEB]] ([[PGM2]]) bereitgestellt.

== Syntax ==
Die Syntax der Widgets ist unter dem Attribut [https://fhem.de/commandref_DE.html#widgetOverride widgetOverride] in der Befehlreferenz beschrieben.

== Verwendung ==
Viele Module (u.a. [[DOIF]], [[dummy]], [[MQTT_DEVICE]], [[MQTT2_DEVICE]], [[MYSENSORS_DEVICE]], [[readingsGroup]]) bieten die Möglichkeit eine Benutzerschnittstelle zu erstellen.

Widgets werden über <code><name>:<modifier></code>-Paare an [[Readings]] oder [[Attribute]] gebunden, dabei ist:

* <code><name></code> ein Readingsname, ein Attribut oder ein Mapping-Argument.
* <code><modifier></code> ein Widget einschliesslich Parameter.

Bei der Erstellung spielen verschiedene Attribute zusammen:

* Mit readingList (bzw. bei Modulen, die dies nicht kennen: widgetOverride) ist es möglich den Set-Befehl auf [[Readings]] zu erweitern, siehe [https://fhem.de/commandref_DE.html#readingList readingList].
* Mit [[setList]] (bzw. widgetOverride) werden die Widgets einem Reading zugeordnet und parametrisiert, siehe [https://fhem.de/commandref_DE.html#setList setList].
* Mit [[webCmd]] werden die Widgets angezeigt, siehe [https://fhem.de/commandref_DE.html#setList webCmd].
* Mit webCmdLabel werden die Widgets beschriftet und tabellarisch angeordnet, siehe [https://fhem.de/commandref_DE.html#webCmdLabel webCmdLabel].
* Mit widgetOverride ist es möglich, die im Modul festgelegten Widgets zu überschreiben, siehe [https://fhem.de/commandref_DE.html#widgetOverride widgetOverride].
* Mit [[eventMap]] ist es möglich Widgets an Mapping-Argumente zu binden, siehe [https://fhem.de/commandref_DE.html#eventMap eventMap] und {{Link2Forum|Topic=76755|LinkText=eventMap und Widget-Anbindung}}.
Das Zusammenspiel dieser Attribute ist u.A. im Artikel [[DeviceOverview anpassen#webCmd .26 Co|DeviceOverview anpassen]] näher erläutert.

== Zusammenstellung der Widgets ==
[[Datei:fhemweb_widgets_1.png|mini|rechts]]
Die Bildschirmkopie zeigt das Benutzerinterface des Dummys mit den Widgets

=== weitere Konfiguration ===
* '''knob''', siehe http://anthonyterrien.com/knob/
* '''colorpicker''', siehe [[Color]]

<br clear=all>
== Das Beispiel für [[DOIF/Import_von_Code_Snippets|Raw definition]] zum Ausprobieren ==
In der vorstehenden Abbildung fehlt das Look and Feel der Widgets. Mit dem folgenden Code-Snippet zum Ausprobieren, wird dies ergänzt.

<pre>
defmod widgets dummy
attr widgets readingList 00select 01select 02selectnumbers 03selectnumbers 04textField 05textFieldNL 06textField-long 07textFieldNL-long 08slider 09multiple 10multiple-strict 11knob 12sortable 13sortable-strict 14sortable-given 15uzsuToggle 16uzsuSelect 17uzsuSelectRadio 18uzsuDropDown 19colorpicker_RGB 19colorpicker_HSV 19colorpicker_CT 19colorpicker_HUE 19colorpicker_BRI 20time 21iconRadio 21iconRadio_use4icon 22iconSwitch 23iconLabel 24iconButtons 24iconButtons_use4icon 25bitfield 26widgetList
attr widgets room 0_Test
attr widgets setList 00select:1,2,3,4,5,0,a,b,c,def,hik \
01select:select,1,2,3,4,5,0,a,b,c,def,hik \
02selectnumbers:selectnumbers,-30,3,33,1,lin \
03selectnumbers:selectnumbers,1,0.0625,140000,0,log10 \
04textField:textField \
05textFieldNL:textFieldNL\
06textField-long:textField-long,87 \
07textFieldNL-long:textFieldNL-long,87 \
08slider:slider,7,0.5,30,1 \
09multiple:multiple,shirt,shoes,skirt,trowsers \
10multiple-strict:multiple-strict,red,green,blue,yellow \
11knob:knob,min:0,max:360,width:50,height:50,step:1,lineCap:round,angleOffset:180,cursor:3,thickness:.3 \
12sortable:sortable,blue,shirt,white,shoes,brown,skirt,black,jeans\
13sortable-strict:sortable-strict,blue,shirt,white,shoes,brown,skirt,black,jeans\
14sortable-given:sortable-given,blue,shirt,white,shoes,brown,skirt,black,jeans\
15uzsuToggle:uzsuToggle,ON,OFF\
16uzsuSelect:uzsuSelect,blue,shirt,white,shoes,brown,skirt,black,jeans\
17uzsuSelectRadio:uzsuSelectRadio,MW,KW,UKW\
18uzsuDropDown:uzsuDropDown,red,green,blue,yellow \
19colorpicker_RGB:colorpicker,RGB \
19colorpicker_HSV:colorpicker,HSV \
19colorpicker_CT:colorpicker,CT,2000,10,6500 \
19colorpicker_HUE:colorpicker,HUE,0,1,359 \
19colorpicker_BRI:colorpicker,BRI,0,1,100 \
20time:time \
21iconRadio:iconRadio,#808080,10,fts_shutter_10@FFA500,20,fts_shutter_20@orange,30,fts_shutter_30@orange,40,fts_shutter_40@orange,50,fts_shutter_50@orange,60,fts_shutter_60@orange,70,fts_shutter_70@orange,80,fts_shutter_80@orange,90,fts_shutter_90@orange,100,fts_shutter_100@orange \
21iconRadio_use4icon:iconRadio,use4icon@808080,10,fts_shutter_10@FFA500,20,fts_shutter_20@orange,30,fts_shutter_30@orange,40,fts_shutter_40@orange,50,fts_shutter_50@orange,60,fts_shutter_60@orange,70,fts_shutter_70@orange,80,fts_shutter_80@orange,90,fts_shutter_90@orange,100,fts_shutter_100@orange \
22iconSwitch:iconSwitch,wide#open,@red,half#open,fts_shutter_50@%23cd2906,totally#closed,fts_shutter_100@magenta,half#closed, \
23iconLabel:iconLabel,wide#open,@red,half#open,fts_shutter_50@%23cd2906,totally#closed,fts_shutter_100@magenta,half#closed,\
24iconButtons:iconButtons,orange,Bad,sani_heating@green,Wohnzimmer_1,sani_heating@green,Wohnzimmer_2,sani_heating@green,Esszimmer,sani_heating@green,Diele,sani_heating@green,Gäste_WC,sani_heating@green,Büro,sani_heating@green,Wintergarten,sani_heating@green,Werkstatt,sani_heating@green,Schlafzimmer,sani_heating@green \
24iconButtons_use4icon:iconButtons,use4icon@red,Bad,sani_heating@0000FF,Wohnzimmer_1,sani_heating@blue,Wohnzimmer_2,sani_heating@blue,Esszimmer,sani_heating@blue,Diele,sani_heating@blue,Gäste_WC,sani_heating@blue,Büro,sani_heating@blue,Wintergarten,sani_heating@blue,Werkstatt,sani_heating@blue,Schlafzimmer,sani_heating@0000FF\
25bitfield:bitfield\
26widgetList:widgetList,4,select,Bad,Küche,Wohnzimmer,6,selectnumbers,7,1,30,0,lin
attr widgets userReadings 23iconLabel:22iconSwitch.* {ReadingsVal($name,"22iconSwitch","wideopen")}
attr widgets webCmd 00select:01select:02selectnumbers:03selectnumbers:04textField:05textFieldNL:06textField-long:07textFieldNL-long:08slider:20time:09multiple:10multiple-strict:11knob:12sortable:13sortable-strict:14sortable-given:15uzsuToggle:16uzsuSelect:17uzsuSelectRadio:18uzsuDropDown:19colorpicker_RGB:19colorpicker_HSV:19colorpicker_CT:19colorpicker_HUE:19colorpicker_BRI:21iconRadio:21iconRadio_use4icon:24iconButtons:24iconButtons_use4icon:22iconSwitch:23iconLabel:25bitfield:26widgetList
attr widgets webCmdLabel select (default)\
:select (explicit)\
:selectnumbers (linear)\
:selectnumbers (logarithmic)\
:textField\
:textFieldNL (no label)\
:textField-long (multi-line)\
:textFieldNL-long (multi-line,no label)\
:slider\
:time\
:multiple\
:multiple-strict\
:knob\
:sortable\
:sortable-strict\
:sortable-given\
:uzsuToggle\
:uzsuSelect\
:uzsuSelectRadio\
:uzsuDropDown\
:colorpicker RGB\
:colorpicker HSV\
:colorpicker Farbtemperatur\
:colorpicker Farbton\
:colorpicker Helligkeit\
:iconRadio\
:iconRadio prefix use4icon\
:iconButtons\
:iconButtons prefix use4icon\
:iconSwitch\
:iconLabel\
:bitfield\
:widgetList (Raum Temperatur)
attr widgets widgetOverride readingList|setList|webCmd|webCmdLabel|widgetOverride:textField-long,86

setstate widgets iconSwitch wide#open
setstate widgets 2024-03-19 20:18:38 00select 1
setstate widgets 2021-09-27 18:52:48 01select 0
setstate widgets 2021-09-27 18:52:33 02selectnumbers 0.0
setstate widgets 2021-09-27 12:13:35 03selectnumbers 64938
setstate widgets 2023-01-03 14:32:14 04textField Hello
setstate widgets 2017-08-24 17:39:22 05textField Hallo
setstate widgets 2023-01-03 14:47:53 05textFieldNL Hello
setstate widgets 2023-01-08 19:25:46 06textField-long Hello
setstate widgets 2022-11-28 18:23:30 07textFieldNL-long Hello
setstate widgets 2017-08-24 18:22:07 08slider 17.0
setstate widgets 2017-08-24 18:22:40 09multiple shirt,shoes
setstate widgets 2017-08-24 18:22:57 10multiple-strict red,green
setstate widgets 2021-09-27 03:19:35 11knob 207
setstate widgets 2017-08-24 18:21:09 12sortable blue,shirt,brown,skirt,white,shoes,black,jeans
setstate widgets 2017-08-24 18:48:17 13sortable-strict blue,white,shirt,shoes,brown,skirt,black,jeans
setstate widgets 2017-08-24 18:49:34 14sortable-given blue,shirt,white,shoes,brown,skirt,black,jeans
setstate widgets 2024-03-19 20:11:06 15uzsuToggle OFF
setstate widgets 2024-03-19 20:10:53 16uzsuSelect brown
setstate widgets 2024-03-19 20:11:16 17uzsuSelectRadio UKW
setstate widgets 2024-03-19 20:11:09 18uzsuDropDown blue
setstate widgets 2017-10-07 07:56:43 19colorpicker_BRI 54
setstate widgets 2017-10-07 07:56:31 19colorpicker_CT 5100
setstate widgets 2017-10-07 07:59:26 19colorpicker_HSV 208c20
setstate widgets 2017-10-07 07:56:29 19colorpicker_HUE 94
setstate widgets 2017-10-07 07:53:01 19colorpicker_RGB c95918
setstate widgets 2017-08-24 19:03:20 20time 12:00
setstate widgets 2021-09-27 18:54:56 21iconRadio 90
setstate widgets 2021-09-27 03:19:18 21iconRadio_use4icon 40
setstate widgets 2024-03-20 18:55:18 22iconSwitch half closed
setstate widgets 2024-03-20 18:55:18 23iconLabel half closed
setstate widgets 2021-09-27 18:57:53 24iconButtons Büro,Schlafzimmer
setstate widgets 2017-10-25 08:20:05 24iconButtons_use4icon Bad,Wohnzimmer_2,Diele,Büro,Werkstatt
setstate widgets 2024-03-19 20:07:03 25bitfield 25
setstate widgets 2024-04-11 19:25:52 26widgetList Küche,23
setstate widgets 2021-09-27 19:02:25 state iconSwitch wide#open
</pre>

== Beigesteuerte Widgets ==
[[Datei:datetimepicker.png|mini|rechts]]
* Forenthread {{Link2Forum|Topic=35736|LinkText=neues DateTimePicker Widget}}
<br clear=all>[[Datei:Controlminidash.png|mini|rechts]]
* Wiki Seite [[FHEMWEB/ControlMiniDash|neues ControlMiniDash Widget]]

[[Kategorie:Code Snippets]]
[[Kategorie:Glossary]]
[[Kategorie:HOWTOS]]

Modul Shelly

2025-11-30T11:28:16Z

Ph1959de: Hinweis auf Gen1-4 Übersichtsseite

{{Todo|'''Achtung: Diese Seite ist teilweise veraltet, insbesondere unterstützt das Modul weitere Aktoren. Bitte Commandref lesen - diese Seite ist in Überarbeitung'''}}
{{Infobox Modul
|ModPurpose=Das Modul stellt ein Interface zur Bedienung von Shelly Devices zur Verfügung
|ModType=d
|ModCmdRef=Shelly
|ModForumArea=Sonstige Systeme
|ModFTopic=118446
|ModTechName=36_Shelly.pm
|ModOwner=Starkstrombastler ({{Link2FU|3884|Forum}}/[[Benutzer Diskussion:Starkstrombastler|Wiki]])
}}
Auf dieser Seite werden die Aktoren des bulgarischen Herstellers Allterco Robotics beschrieben (Markenname Shelly) sowie deren Ansteuerung mit FHEM und aufgetretene Probleme.
{{Randnotiz|RNTyp=r|RNText='''Achtung''': Einige der auf dieser Seite erwähnten Geräte und Funktionen sind derzeit nur mit {{Link2Forum|Topic=111905|Message=1285498|LinkText=dieser Testversion}} verfügbar, die manuell installiert werden muss!
* Für die Weiterentwicklung des Moduls wurde im Forum ein neues Thema '''({{Link2Forum|Topic=137222|LinkText=Entwicklungs-Thread Modul 36_Shelly.pm}})''' aufgemacht.}}
Bei den Shelly-Geräten handelt es sich um IP-basierte Schalt- und Dimmaktoren, die auf verschiedene Weise angesteuert werden können
*über die Web-Oberfläche des eingebauten Mikro-Webservers,
*über eine proprietäre App des Herstellers (Achtung, Cloud!),
*über das hier beschriebene FHEM-Modul 36_Shelly.pm
*über MQTT
Ein Teil der Aktoren verfügt über eine eingebaute Leistungsmessung (siehe Spalte Messkanäle in unten stehender Tabelle).

Einen Überblick über die (mittlerweile - Frühjahr 2025 - vier) Gerätegenerationen (Gen1 bis Gen4) bietet die Supportseite [https://support.shelly.cloud/de/support/solutions/articles/103000316073-vergleich-von-shelly-gen-1-gen-2-gen-3-gen4-ger%C3%A4ten Vergleich von Shelly gen1...gen4 Geräten]. Die untenstehende Auflistungmuss angesichts der mittlerweile vier Geräteversionen überarbeitet werden.

==Geräteübersicht==
Übersicht der IP-basierten Produktreihen
{| class="wikitable mw:datatable"
! style="width:15px" |ID
! style="width:100px" | Produktreihe
! style="width:225px" |gemeinsame Merkmale
|-
|SH
|erste Generation
|COIOT (Nutzung mit Shelly-Monitor), kein Bluetooth
|-
|SN
|Shelly Plus
Shelly Plus mini
|
|-
|SP
|Shelly Pro
|Montage auf Hutschiene, zusätzlicher Ethernet-Port (RJ45)
|-
|S3
|Shelly Gen3
Shelly Gen3 mini
|proprietärer Prozessor
|-
|SA
|Control Panel
|Android-System
|}
ID: erste beiden Stellen der Modell-ID

Liste der aktuell unterstützten Geräte
(hier nicht aufgeführte Geräte der ersten Generation können zusammen mit dem Shelly-Monitor genutzt werden):
{| class="wikitable sortable"
! data-sort-type="text" style="width:150px" |Modell
! data-sort-type="text" style="width:75px" |Typ
! data-sort-type="number" style="width:20px;text-align:center;" |Schalt- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Dimm- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Mess- kanäle
! data-sort-type="number" style="width:20px;text-align:center;" |Digital Eingänge
! |Bemerkungen
|-
! colspan="7" |'''Gen 1'''
|-
|Shelly 1
|Schalter
|1
|
|
|1
|
|
|-
|Shelly 1PM
|Schalter
|1
|
|1
|1
|
|
|-
|Shelly 1L
|Schalter
| 1
|
|1
| 1
|
|
|-
| rowspan="2" |Shelly 2
| Schalter
|2
|
|1
|2
|
|
|-
|Rollladenaktor
|1
|
|1
|2
|
|-
| rowspan="2" |Shelly 2.5
|Schalter
| 2
|
|2
|2
|
|-
|Rollladenaktor
|1
|
|1
|2
|
|-
|Shelly 4Pro
|Schalter
|4
|
|4
|4
|
|-
|Shelly i3
| Digitale Eingänge
|
|
|
|3
|
|-
|Shelly EM
|Leistungsmessung
|1
|
|2
|
|
|-
|'''[[Shelly 3EM]]'''
|Leistungsmessung
|1
|
|3
|
|
|-
|'''[[Shelly Uni]]'''
|Universal
|2
|
|
|*)
|1-Wire, 2 potentialfreie Relaisausgänge
Analogeingänge
|-
|Shelly Plug
Shelly Plug S
|Schaltsteckdose
|1
|
|1
|
|1 Taster
|-
| rowspan="2" |Shelly RGBW2
|Dimmer
|
|4
|4
|1
|4-fach Aktor
|-
|Dimmer
|
|1
| 1
|1
|RGBW Controller
|-
|Shelly Dimmer2
|Dimmer
|
| 1
|1
|2
|
|-
|Shelly Duo
|Leuchte
|
|1
|
|
|E27 oder GU10 Fassung
|-
|Shelly Vintage
|Leuchte
|
|1
|
|
|
|-
|Shelly Bulb
|Leuchte
|
|1
|
|
|Modi: weiß oder farbe
|-
! colspan="7" |'''Shelly Plus'''
|-
|Shelly Plus 1

|Schalter
|1
|
|
|1
|
|-
|'''[[Shelly Plus 1PM]]'''
|Schalter
|1
|
|1
|1
|
|-
| rowspan="2" |'''[[Shelly Plus 2PM]]'''
| Schalter
|2
|
|2
|2
|-
|Rollladenaktor
|1
|
| 1
|2
|-
|Shelly Plus i4
|Digitale Eingänge
|
|
|
| 4
|AC und DC - Variante
|-
| Shelly Plus Plug S
Shelly Plus Plug IT
Shelly Plus Plug UK
Shelly Plus Plug US
|Schaltsteckdose

|1
|
|1
|
|1 Taster;
Varianten V1, V2
|-
|Shelly Plus Uni
|Universal
| 2
|
|
|*)
|1-Wire, 2 potentialfreie Relaisausgänge
Analogeingänge; Neu in 2024
|-
|Shelly Plus 0-10V Dimmer
|Dimmer
|
|1
|1
|2
|0-10 V DC Ausgang
|-
| rowspan="2" |Shelly Plus RGBW
|Dimmer
|
|4
|4
|4
|4-fach Aktor
|-
|Dimmer
|
|1
|1
|1
|RGBW Controller
|-
! colspan="7" | '''Shelly Plus Mini'''
|-
|Shelly Plus 1 Mini
|Schalter
|1
|
|
|1
|
|-
|Shelly Plus 1PM Mini
|Schalter
|1
|
|1
|1
|
|-
|Shelly PM Mini
|Leistungsmessung
|
|
| 1
|
|
|-
! colspan="7" |'''Shelly Pro'''
|-
|Shelly Pro 1
|Schalter
|1
|
|
|2
|
|-
|Shelly Pro 1PM
|Schalter
|1
|
|1
|2
|
|-
|Shelly Pro 2
| Schalter
|2
|
|
| 2
|
|-
|Shelly Pro 2PM
|Schalter
|2
|
|2
|2
|
|-
|Shelly Pro Dual
|Rollladenaktor
|4
|
|
|4
|2 Rolladenaktoren
|-
|Shelly Pro Dimmer 1PM
|Dimmer
|
|1
|1
|2
|
|-
|Shelly Pro Dimmer 2PM
|Dimmer
|
| 2
|2
|4
|
|-
|Shelly Pro 3
|Schalter
|3
|
|
|3
|
|-
|Shelly Pro 3EM
|Leistungsmessung
|
|
|3
|
|1 Schaltkanal mit Addon
|-
|Shelly Pro EM50
|Leistungsmessung

|
|
|
|
|
|-
|Shelly Pro 4PM
|Schalter
|4
|
|4
|4
|
|-
! colspan="7" |'''Shelly Gen3'''
|-
| Shelly 1 Gen3
|Schalter
|1
|
|
|1
|
|-
|Shelly 1PM Gen3
|Schalter
|1
|
|1
|1
|
|-
|Shelly i4 Gen3
|Digitale Eingänge
|
|
|
| 4
|
|-
|Shelly Dimmer 0/1-10V Gen3
|Dimmer
|
| 1
| 1
|2
|0-10V DC oder
1-10V DC Ausgang
|-
! colspan="7" |'''Shelly Gen3 Mini'''
|-
|Shelly 1 Mini Gen3
|Schalter
|1
|
|
|1
|
|-
|Shelly 1PM Mini Gen3
|Schalter
|1
|
|1
|1
|
|-
|Shelly PM Mini Gen3
|Leistungsmessung
|
|
|1
|
|
|-
! colspan="7" | '''Control Panels'''
|-
|Shelly Wall Display
| Control Panel
| 1
|
|
| 1
|
|}

==Einbindung in FHEM==
Vorgehensweise zur Einbindung eines Shelly-Gerätes in FHEM:
*Aktor nach Vorschrift anschließen
*mit einem WLAN-fähigen Gerät (Laptop, Smartphone, Tablet...; im Folgenden als '''Laptop''' bezeichnet) nach dem internen Access Point suchen, der durch das Shelly-Gerät erzeugt wird; typischerweise hat es eine SSID ähnlich wie
:<code>shelly1-..., shellyswitch-..., shelly4pro-..., </code>
*'''Laptop''' mit diesem Access Point verbinden; typischerweise bekommt das Gerät dabei die IP-Adresse 192.168.33.2 zugewiesen.
*im Browser des '''Laptops''' die IP-Adresse 192.168.33.1 aufrufen - das ist der Shelly selbst; in der damit angezeigten Weboberfläche kann das Shelly-Gerät konfiguriert werden
**Shelly ins häusliche WLAN anmelden (mit fester IP-Adresse <shelly-ip> natürlich...)
**Internen Access Point abschalten (kann auch nach dem nächsten Schritt oder noch später erfolgen)
**Testen: '''Laptop''' wieder mit dem häuslichen WLAN verbinden, und im Browser die Adresse <shelly-ip> aufrufen
*In FHEM definieren
:<code>define myShelly Shelly <shelly-ip></code>
*Das Modul setzt bei bekannten Geräten das Attribut <code>model</code> automatisch. Bei nicht unterstützten Geräten wird das Attribut auf den Wert <code>generic</code> gesetzt. In diesen Fällen kann das Attribut <code>model</code> auf der Detailseite des Devices manuell gesetzt werden:
:<code> attr myShelly model shellyrgbw|shellydimmer|shelly2.5|shelly2|shellyem|shelly3em|shelly4|shellyplug|shelly1|shellybulb|shelly1pm|shellyuni|generic</code>

Falls es sich um einen Shelly2 oder 2.5 handelt, muss ferner das Attribut <code>mode</code> auf "roller" oder "relay" gesetzt werden. Mit diesem Modul können alle Daten übertragen und (prinzipiell) alle Konfigurationsänderungen durchgeführt werden, außerdem ist es auf einfachste Weise zu installieren. Das Modul pollt im per Attribut <code>interval</code> einstellbaren Abstand zyklisch den Aktor auf Statusänderungen (Wert 0 => kein Polling). Damit der Aktor im Stande ist, irgendwelche Zustandsänderungen ''von sich aus'' an FHEM zu melden, müssen diese als REST-Befehle (also URL-Aufrufe) in der Konfigurationsoberfläche des Shelly-Aktors eingetragen werden. Siehe CommandRef.

Zum Betrieb ist ferner noch zu bemerken, dass das Modul zwar meldet, ob ein Firmware-Update nötig ist, ausgelöst werden muss dieses aber über die Web-Oberfläche des Shelly selber.

===Actions/Webhooks (nur Testversion)===
Ab Shelly Firmware 1.5.0 werden Actions unterstützt. Damit besteht die Möglichkeit, dass ein Shelly bei Eintreten bestimmter Ereignisse von sich aus Meldungen an andere Shellies und/oder übergeordnete Systeme wie FHEM absetzt. Dies ist nützlich, um Statusänderungen, die z.B. durch lokal betätigte Tasten entstehen, direkt an FHEM zu übermitteln.

Nachfolgende Beispiele zeigen den Code, der im Shelly unter URL einzutragen ist:

Ausgang (Relais) eines Shelly1 schaltet ein:
:<code>http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20out_on</code>
hierbei sind:
:<code><FHEM-IP></code> die IP-Adresse des Servers auf dem FHEM läuft
:<code><Port></code> die Port-Nummer
:<code><name></code> der Name des FHEM-Devices
:<code>%20</code> stellt ein Leerzeichen dar

Beispiel 2: Eingang eines Shelly2 wird betätigt:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20input_on%20<ch></syntaxhighlight>
:<code><ch></code> die Nummer des Schaltkanals (Nummer des Eingangs), z.B. <code>0</code> oder <code>1</code>

Beispiel 3: Eingang1 eines ShellyDimmers wird betätigt:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?cmd=set%20<name>%20short_push<nowiki/>%20<inp></syntaxhighlight>
:<code><nowiki><inp></nowiki></code> Nummer des Eingangs, 0 oder 1 (ShellyDimmer verfügen je Schaltkanal über zwei Eingänge)

Beispiel 4: Wirkleistung eines ShellyPro3EM:
<syntaxhighlight lang="html">http://<FHEM-IP>:<Port>/fhem?fwcsrf=csrf_368985985592099&cmd=set%20Y173%20Active_Power_$phase%20$active_power</syntaxhighlight>
:<code>fwcsrf=csrf_368985985592099</code> das CSRF-Token (FHEMWeb)
:<code>$phase</code> wird vom Shelly durch a, b oder c ersetzt
: <code>$active_power</code> wird vom Shelly durch die aktuelle Wirkleistung ersetzt

'''Endpoints'''

In vorstehenden Beispielen stellt der Teil <code>set%20<name>%20<cmd></code> den Endpoint dar, d.h. dies ist der Befehl, der vom Shelly-Device in FHEM verarbeitet werden muss.

=====Liste der Befehle der Set-Endpoints:=====
{| class="wikitable sortable mw-collapsible"
|+
!<cmd>
!Wert
!Reading
!Erläuterung
!Geräte
|-
|<code>out_on</code>
|
| rowspan="2" |<code>relay_<ch></code><code>state</code>
|Ausgang ein
| rowspan="2" |alle Shelly mit Relaisausgang
ShellyBulb
ShellyRGBW
|-
|<code>out_off</code>
|
|Ausgang aus
|-
|<code>button_on</code>
|
| rowspan="2" |<code>button_<ch></code>
|Eingang ein
| rowspan="2" |ShellyPlug
ShellyPlugS
|-
|<code>button_off</code>
|
|Eingang aus
|-
|<code>input_on</code>
|
| rowspan="2" |<code>input_<ch></code>
|Eingang ein
| rowspan="2" |alle Shelly mit HW-Eingang, aber nicht Shelly-I-Geräte
|-
|<code>input_off</code>
|
|Eingang aus
|-
|<code>input_on</code>
|
| rowspan="4" |<code>input_<inp></code>
|Eingang ein
| rowspan="4" |ShellyDimmer
|-
|<code>input_off</code>
|
|Eingang aus
|-
|<code>short_push</code>
|
|kurzer Tastendruck
|-
|<code>long_push</code>
|
|langer Tastendruck
|-
|<code>single_push</code>
|
| rowspan="6" |<code>input_<ch></code><code>input_<ch>_action</code>
|kurzer Tastendruck
| rowspan="4" |ShellyI3
ShellyI4
|-
|<code>long_push</code>
|
|langer Tastendruck
|-
|<code>double_push</code>
|
|zweifacher Tastendruck
|-
|<code>triple_push</code>
|
|dreifacher Tastendruck
|-
|<code>short_long_push</code>
|
|Tastersequenz lang-kurz
| rowspan="2" |ShellyI3
|-
|<code>long_short_push</code>
|
|Tastersequenz kurz-lang
|-
|<code>stopped</code>
|
| rowspan="5" |<code>state</code>
|Rollo angehalten
| rowspan="5" | Shelly2/2.5/Plus2/Pro2 mode=roller
<nowiki>*</nowiki>) nur für Shelly Plus2/Pro2
|-
|<code>opening</code>
|
|Rollo wird geöffnet
|-
|<code>closing</code>
|
|Rollo wird geschlossen
|-
|<code>is_open *)</code>
|
|Rollo offen (in oberer Endlage)
|-
|<code>is_closed *)</code>
|
|Rollo geschlossen (in unterer Endlage)
|-
|<code>temperature_over</code>
|
|<code>temperature_<ch>_range</code>
|Temperatur überschreitet eingestellten Grenzwert
| rowspan="5" |ShellyAddOn
|-
|<code>temperature_under</code>
|
|<code>temperature_<ch>_range</code>
|Temperatur unterschreitet eingestellten Grenzwert
|-
|<code>humidity_over</code>
|
|<code>humidity_<ch>_range</code>
|Luftfeuchtigkeit überschreitet eingestellten Grenzwert
|-
| <code>humidity_under</code>
|
|<code>humidity_<ch>_range</code>
|Luftfeuchtigkeit unterschreitet eingestellten Grenzwert
|-
|<code>tempC</code>
|<code>$temperature</code>
|<code>temperature</code>
|Temperatur in °C
|-
|<code>voltage_over</code>
|
| rowspan="2" |<code>voltage_range</code>
|Spannung überschreitet eingestellten Grenzwert
| rowspan="2" |ShellyUni
|-
|<code>voltage_under</code>
|
|Spannung unterschreitet eingestellten Grenzwert
|-
| Active_Power_$phase
|<code>$active_power</code>
|<code>Active_Power_<ph></code>
|Änderung Wirkleistung
| rowspan="3" |ShellyPro3EM
|-
|Voltage_$phase
|<code>$voltage</code>
|<code>Voltage_<ph></code>
| Änderung Spannung
|-
|Current_$phase
|<code>$current</code>
|<code>Current_<ph></code>
|Änderung Strom
|}
Bei Eintreffen eines Set-Endpoints wird im Shelly-Device das zugeordnete Reading entsprechend gesetzt. Damit kann das Shelly-Ereignis z.B. mit einem <code>notify</code> ausgewertet werden. Im Anschluss daran holt sich das Modul die aktuellen Daten vom Shelly und setzt das Intervall zurück.

Anmerkung zum ShellyPro3EM: Die Action wird erst bei einer gewissen Änderung des jeweiligen Wertes ausgelöst. Bei kleinen Schwankungen kommen also keine Webhooks in FHEM an.

===== Get-Endpoint =====
Eine besondere Form stellt der Get-Endpoint dar, mit dem das Shelly-Device in FHEM aufgefordert wird, den Status des Shelly zu holen. Beispiel:
:<code>http://<FHEM-IP>:<Port>/fhem?cmd=get%20<name>%20status</code>

====Attribut webhook (derzeit nur Gen2)====
Durch Setzten des Attributes <code>webhook</code> werden auf dem Shelly die verfügbaren Webhooks automatisiert angelegt (auf der Shelly Oberfläche unter Actions zu sehen). Als Attribut-Wert muss das empfangende FHEMWeb-Device ausgewählt werden. Wird das FHEMWeb-Device mit einem csrf-Token abgesichert, wird der Token in den Webhook eingebunden. Bei Änderungen des Tokens (z.B. bei Neustart von FHEM) werden die entsprechenden Webhooks mit angepasst.

Nach dem Setzen des Attributes müssen die Webhooks mit <code>set myShellyDevice actions create all</code> angelegt werden.

Die vom Modul angelegten Webhooks erhalten im Shelly einen Namen, beginnend mit einem Unterstrich (<code>_</code>). Wird das Attribut geändert oder gelöscht, dann werden auch zugehörige Actions geändert bzw. gelöscht. Durch Entfernen des Unterstrichs im Namen der Action kann dieser Mechanismus unterbunden werden.

Das Reading <code>webhook_cnt</code> zeigt die Anzahl aller auf dem Shelly hinterlegten Webhooks und <code>webhooks_ver</code> den Versionszähler des Shelly.

Eine Übersicht aller Actions/Webhooks eines Shelly bekommt man für Gen2-Geräte mit:
:<code>http://<ip-des-Shelly>/rpc/Webhook.List</code>

===MQTT===
MQTT (Message Queue Telemetry Transport) ist ein nachrichtenbasiertes Protokoll, bei dem Geräte (Devices) nicht direkt miteinander, sondern mit einem zentralen MQTT-Server (in alter Nomenklatur ''Broker'' genannt) kommunizieren. Eine kurze Einführung in MQTT findet man auf der Seite [[MQTT Einführung]]. Mit entsprechend gesetzten Attributen lassen sich die Shelly-Aktoren auch steuern ([[MQTT2-Module - Praxisbeispiele#Shelly|Praxisbeispiele zu den MQTT2-Modulen]]), für Anfänger ist das allerdings nicht unbedingt zu empfehlen.

==Links==
*{{Link2Forum|Topic=118446|LinkText=Support Thread}} zu diesem Modul
*{{Link2Forum|Topic=137222|LinkText=Entwicklungs Thread}} zur Weiterentwicklung des Moduls, ab Februar 2024
*[http://www.shelly.com Website des Herstellers der Geräte]
*[https://community.shelly.cloud Forum des Herstellers (englischsprachig]

[[Kategorie:Energieverbrauchsmessung]]
[[Kategorie:MQTT]]
[[Kategorie:Bluetooth]]
[[Kategorie:Schalter (Empfänger)]]
[[Kategorie:Shelly]]

Benutzer Diskussion:Schwatter

2025-11-30T10:35:24Z

Ph1959de: Willkommen

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Schwatter,''' willkommen im FHEM Wiki!</span></big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 11:34, 30. Nov. 2025 (CET)
|}

HttpUtils

2025-11-24T09:34:48Z

Ph1959de: Link zu Forenbeitrag über Vorlage

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

2025-11-11T10:42:40Z

Ph1959de: Verweise auf Wiki-Seiten auf ... umgestellt

Diskussion:Solaranlage Komplettbeispiel Fronius BYD

2025-11-05T10:34:53Z

Ph1959de: Antwort auf "Titel ok?"

Strombörse

2025-10-25T16:11:56Z

Ph1959de: Tippfehler korrigiert

[[Bild:Screenshot 2024-01-23 122115.png|mini|400px|rechts|EVU_Tibber_connect]]
Diese Seite beinhaltet Informationen für die Anbindung von Energieversorgungsunternehmen (EVU), die ihre Preise nach der Strombörse z.B. im Stundenrhythmus anbieten.

Als Beispiel wären da:
# {{Link2Forum|Topic=130407|LinkText=Tibber - im Forum}}
# {{Link2Forum|Topic=135906|LinkText=aWATTar - im Forum}}
# {{Link2Forum|Topic=135906|LinkText=EPEX_Spot}}

Diese Wiki Seite ist noch in Bearbeitung!!!

== 1. Tibber mit Tibber Pulse ==
Eine momentan verbreitete Methode zur Anbindung an Tibber ist ein Lesekopf auf dem EVU Zähler, der als "Tibber Pulse" vertrieben wird. Damit wird ein bestehender digitaler EVU Zähler ausgelesen und die Werte per LAN zu Tibber gesendet. Über eine API bei Tibber können dann die Verbrauchswerte und Kosten sowie ein Live Stream (WebSocket) abgefragt werden.

Die im Folgenden beschriebenen Beispieldevices bieten die oben genannte Abfrage der API mit WebSocket und [[HTTPMOD]]. Das EVU_Tibber Device dient der Darstellung und Steuerung.

=== Vorausetzungen ===
* FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)
* KeyValue() (wird hier beschrieben)
* homeID und personal Token/Access Token/Connect Token
* Tibber Pulse Lesekopf auf dem digitalen EVU Zähler
* Man sollte bereits Tibber Kunde sein, da ansonsten nur Demo Daten abgerufen werden können

=== Token ===
Der Token wird leider unterschiedlich bezeichnet, aber egal ob er personal Token, Access Token oder Connect Token heisst, es bezieht sich auf den gleichen.

Erhältlich ist dieser aktuell (Oktober 24) unter https://developer.tibber.com/

Dort bitte mit deinen Zugangsdaten einloggen ("Sign In", oben rechts) und man bekommt den Access Token direkt angezeigt.

=== homeID ===
Um eine HomeID zu erhalten, muss zuerst der Pulse mit dem Internet bzw. tibber verbunden werden. Wenn die App glücklich ist, gehts hier weiter:

Man loggt sich wieder ein unter https://developer.tibber.com/. Dort geht man dann zum API Explorer.

Leider ist keine der Demo-Abfragen geeignet, die homeID zu erfahren. Dafür gibt man ins linke fenster folgenden Code ein:
<syntaxhighlight lang="Perl">
{
viewer {
homes {
id
address {
address1
postalCode
}
}
}
}
</syntaxhighlight>
Dann startet man mit dem Play-Pfeil und bekommt auf der rechten Seite etwa folgende Ausgabe:

<syntaxhighlight lang="Perl">
{
"data": {
"viewer": {
"homes": [
{
"id": "1234abcd-12ab-34cd-56ef-1234abcd12ab
"address": {
"address1": "Musterstr.1",
"postalCode": "12345"
}
}
]
}
}
}
</syntaxhighlight>
Diese ID ist die homeID und kann unten verwendet werden.

=== EVU_Tibber_connect ===
Das EVU_Tibber_connect fragt mit HTTPMOD Statistiken auf der Tibber API Webseite ab. Zusätzlich wurde in den userReadings die WebSocket Verbindung für die Live Daten integriert.
* Die WebSocket Verbindung wurde leicht angepasst '''[[Websocket|von hier]]''' übernommen
* Im Forum wurde dies '''{{Link2Forum|Topic=130407|Message=1298863|LinkText=ab hier}}''' bearbeitet

==== Verwendete Module ====
* HTTPMOD
* DbLog
* DbRep
* DOIF
* KeyValue()

==== Ablage der homeID und des Tokens ====
Eine Verbindung zur Tibber API mit den '''tatsächlichen Preisen''' bekommen nur Kunden, ansonsten kann man eine Demo mit Kosten in Schwedischen Kronen testweise abfragen.

In diesem Beispiel Device kann man seine homeID und sein Token entweder als Attribut ablegen oder man macht einen Eintrag im KeyStore von FHEM, wodurch man nicht so leicht versehentlich seine Daten im Forum postet.

Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im Datensystem oder im Konfigurationsfile zu finden sind.
Die Funktion befindet sich in der 99_myUtils.pm .

===== Beispiel KeyValue() =====
'''Achtung, der KeyValue ist kein Schutz für Passwort oder Keys!'''
Es dient lediglich der Ablage von Keys, damit sie nicht direkt offen im FHEM Device oder im Konfigurationsfile zu finden sind.
Die Funktion befindet sich in der 99_myUtils .

====== KeyValue() Funktion in der ~/FHEM/99_myUtils.pm ======
<syntaxhighlight lang="Perl">
sub KeyValue {
my ($step, $index, $value) = @_;
my $key = getUniqueId().$index;
my $e_value = "";
my $error;

if (eval "use Digest::MD5;1") {
$key = Digest::MD5::md5_hex(unpack "H*", $key);
$key .= Digest::MD5::md5_hex($key);
}

if ($step eq "read") {
($error, $value) = getKeyValue($index);

if ( defined($error) ) {
Log3 $index,3, "$index, can't read key from FhemUtils/uniqueID: $error";
return undef;
}

if ( defined($value) ) {
my $dec_value = '';

for my $char (map { pack('C', hex($_)) } ($value =~ /(..)/g)) {
my $decode = chop($key);
$dec_value .= chr(ord($char)^ord($decode));
$key = $decode.$key;
}
return $dec_value;
}
else {
Log3 $index,3,"$index, no key found in FhemUtils/uniqueID";
return undef;
}
}

if ($step eq "store") {
for my $char (split //, $value) {
my $encode = chop($key);
$e_value .= sprintf("%.2x",ord($char)^ord($encode));
$key = $encode.$key;
}
$error = setKeyValue($index, $e_value);
return "error while saving key : $error" if(defined($error));
return "Key successfully saved in FhemUtils/uniqueID Key $index";
}

};
</syntaxhighlight>

====== Ablegen der homeID und des Token ======
In der FHEM Kommandozeile legt man seinen Daten wie folgt im KeyValue ab. Hier wären als Beispiel der Demo Zugang von Tibber.
Das "read" ist dann auch direkt der erste Test, bevor man weiter macht.
<syntaxhighlight lang="Perl">
{KeyValue("store","EVU_Tibber_connect_token","5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE")}
{KeyValue("store","EVU_Tibber_connect_homeID","96a14971-525a-4420-aae9-e5aedaa129ff")}

{KeyValue("read","EVU_Tibber_connect_token")}
{KeyValue("read","EVU_Tibber_connect_homeID")}
</syntaxhighlight>

===== Beispiel Attribut für homeID und Token =====
Oder, sobald das EVU_Tibber_connect Device erstellt wurde, als Attribut.
<syntaxhighlight lang="Perl">
attr EVU_Tibber_connect ws_homeId 96a14971-525a-4420-aae9-e5aedaa129ff
attr EVU_Tibber_connect ws_myId 96a14971-525a-4420-aae9-e5aedaa129ff <<<< Dies kann wohl eine frei gewählte ID sein, was hier der Einfachheithalber gleich der homeId gesetzt wurde.
attr EVU_Tibber_connect ws_token 5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE
</syntaxhighlight>

==== EVU_Tibber_connect RAW Device====
Das Device EVU_Tibber_connect dient der Verbindung zur Tibber API. Zusätzlich wird für die Abfrage der Live Daten innerhalb der userReadings eine WebSocket Verbindung zu Tibber aufgebaut. Tibber stellt jeweils gegen 14:00 Uhr die Daten für den nächsten Tag bereit, wodurch von 00:00 - 14:00 Uhr diese Information im EVU_Tibber_connect noch nicht angezeigt werden kann.
Das Device arbeitet über die userReadings mit einem MySQL DbRep Device, was somit eine MySQL DbLog Verwendung im FHEM voraussetzt. '''Die Verwendung von FileLog ist nicht unterstützt!'''
<syntaxhighlight lang="Perl">
defmod EVU_Tibber_connect HTTPMOD https://api.tibber.com/v1-beta/gql 0
attr EVU_Tibber_connect userattr ws_homeId ws_minInterval ws_myId ws_token ws_websocketURL
attr EVU_Tibber_connect DbLogExclude .*
attr EVU_Tibber_connect DbLogInclude total_cost_.*,fc0_trigger.*
attr EVU_Tibber_connect comment Version 2024.01.22 14:00 \
https://developer.tibber.com/explorer\
\
In der FHEM Kommandozeile könnt Ihr das token und die homeID im KeyStore ablegen.\
Bitte lest dazu das Thema KeyStore im Wiki und legt die Funktion in Eure 99_myUtils.\
\
{KeyValue("store","EVU_Tibber_connect_token","5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE")}\
{KeyValue("store","EVU_Tibber_connect_homeID","96a14971-525a-4420-aae9-e5aedaa129ff")}\
\
Hierduch kann man einen wirtschaftlicheren trigger_price berechnen lassen:\
setreading EVU_Tibber compensation_grid <Eure Einspeisevergütung>\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
(fc_avg - fc_min) /2 + fc_min\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
# compensation_grid kann auch auf einen für Euch passenden Wert gesetzt werden\
(fc_avg - compensation_grid) *0.85
attr EVU_Tibber_connect disable 0
attr EVU_Tibber_connect enableControlSet 1
attr EVU_Tibber_connect get01-1Name current_currency
attr EVU_Tibber_connect get01-2Name current_level
attr EVU_Tibber_connect get01-3Name current_date
attr EVU_Tibber_connect get01-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get01-4Name current_price
attr EVU_Tibber_connect get01-4OExpr $val *100
attr EVU_Tibber_connect get01Data { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total startsAt currency level}}}}}}" }
attr EVU_Tibber_connect get01Header01 Content-Type: application/json
attr EVU_Tibber_connect get01Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get01JSON data_viewer_home_currentSubscription_priceInfo_current
attr EVU_Tibber_connect get01Name 01_priceInfo
attr EVU_Tibber_connect get01URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get02-10Name fc0_03_total
attr EVU_Tibber_connect get02-11Name fc0_04_startsAt
attr EVU_Tibber_connect get02-11OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-12Name fc0_04_total
attr EVU_Tibber_connect get02-13Name fc0_05_startsAt
attr EVU_Tibber_connect get02-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-14Name fc0_05_total
attr EVU_Tibber_connect get02-15Name fc0_06_startsAt
attr EVU_Tibber_connect get02-15OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-16Name fc0_06_total
attr EVU_Tibber_connect get02-17Name fc0_07_startsAt
attr EVU_Tibber_connect get02-17OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-18Name fc0_07_total
attr EVU_Tibber_connect get02-19Name fc0_08_startsAt
attr EVU_Tibber_connect get02-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-1Name current_date
attr EVU_Tibber_connect get02-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-20Name fc0_08_total
attr EVU_Tibber_connect get02-21Name fc0_09_startsAt
attr EVU_Tibber_connect get02-21OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-22Name fc0_09_total
attr EVU_Tibber_connect get02-23Name fc0_10_startsAt
attr EVU_Tibber_connect get02-23OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-24Name fc0_10_total
attr EVU_Tibber_connect get02-25Name fc0_11_startsAt
attr EVU_Tibber_connect get02-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-26Name fc0_11_total
attr EVU_Tibber_connect get02-27Name fc0_12_startsAt
attr EVU_Tibber_connect get02-27OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-28Name fc0_12_total
attr EVU_Tibber_connect get02-29Name fc0_13_startsAt
attr EVU_Tibber_connect get02-29OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-2Name current_price
attr EVU_Tibber_connect get02-2OExpr $val *100
attr EVU_Tibber_connect get02-30Name fc0_13_total
attr EVU_Tibber_connect get02-31Name fc0_14_startsAt
attr EVU_Tibber_connect get02-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-32Name fc0_14_total
attr EVU_Tibber_connect get02-33Name fc0_15_startsAt
attr EVU_Tibber_connect get02-33OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-34Name fc0_15_total
attr EVU_Tibber_connect get02-35Name fc0_16_startsAt
attr EVU_Tibber_connect get02-35OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-36Name fc0_16_total
attr EVU_Tibber_connect get02-37Name fc0_17_startsAt
attr EVU_Tibber_connect get02-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-38Name fc0_17_total
attr EVU_Tibber_connect get02-39Name fc0_18_startsAt
attr EVU_Tibber_connect get02-39OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-3Name fc0_00_startsAt
attr EVU_Tibber_connect get02-3OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-40Name fc0_18_total
attr EVU_Tibber_connect get02-41Name fc0_19_startsAt
attr EVU_Tibber_connect get02-41OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-42Name fc0_19_total
attr EVU_Tibber_connect get02-43Name fc0_20_startsAt
attr EVU_Tibber_connect get02-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-44Name fc0_20_total
attr EVU_Tibber_connect get02-45Name fc0_21_startsAt
attr EVU_Tibber_connect get02-45OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-46Name fc0_21_total
attr EVU_Tibber_connect get02-47Name fc0_22_startsAt
attr EVU_Tibber_connect get02-47OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-48Name fc0_22_total
attr EVU_Tibber_connect get02-49Name fc0_23_startsAt
attr EVU_Tibber_connect get02-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-4Name fc0_00_total
attr EVU_Tibber_connect get02-50Name fc0_23_total
attr EVU_Tibber_connect get02-51Name fc1_00_startsAt
attr EVU_Tibber_connect get02-51OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-52Name fc1_00_total
attr EVU_Tibber_connect get02-53Name fc1_01_startsAt
attr EVU_Tibber_connect get02-53OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-54Name fc1_01_total
attr EVU_Tibber_connect get02-55Name fc1_02_startsAt
attr EVU_Tibber_connect get02-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-56Name fc1_02_total
attr EVU_Tibber_connect get02-57Name fc1_03_startsAt
attr EVU_Tibber_connect get02-57OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-58Name fc1_03_total
attr EVU_Tibber_connect get02-59Name fc1_04_startsAt
attr EVU_Tibber_connect get02-59OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-5Name fc0_01_startsAt
attr EVU_Tibber_connect get02-5OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-60Name fc1_04_total
attr EVU_Tibber_connect get02-61Name fc1_05_startsAt
attr EVU_Tibber_connect get02-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-62Name fc1_05_total
attr EVU_Tibber_connect get02-63Name fc1_06_startsAt
attr EVU_Tibber_connect get02-63OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-64Name fc1_06_total
attr EVU_Tibber_connect get02-65Name fc1_07_startsAt
attr EVU_Tibber_connect get02-65OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-66Name fc1_07_total
attr EVU_Tibber_connect get02-67Name fc1_08_startsAt
attr EVU_Tibber_connect get02-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-68Name fc1_08_total
attr EVU_Tibber_connect get02-69Name fc1_09_startsAt
attr EVU_Tibber_connect get02-69OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-6Name fc0_01_total
attr EVU_Tibber_connect get02-70Name fc1_09_total
attr EVU_Tibber_connect get02-71Name fc1_10_startsAt
attr EVU_Tibber_connect get02-71OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-72Name fc1_10_total
attr EVU_Tibber_connect get02-73Name fc1_11_startsAt
attr EVU_Tibber_connect get02-73OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-74Name fc1_11_total
attr EVU_Tibber_connect get02-75Name fc1_12_startsAt
attr EVU_Tibber_connect get02-75OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-76Name fc1_12_total
attr EVU_Tibber_connect get02-77Name fc1_13_startsAt
attr EVU_Tibber_connect get02-77OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-78Name fc1_13_total
attr EVU_Tibber_connect get02-79Name fc1_14_startsAt
attr EVU_Tibber_connect get02-79OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-7Name fc0_02_startsAt
attr EVU_Tibber_connect get02-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-80Name fc1_14_total
attr EVU_Tibber_connect get02-81Name fc1_15_startsAt
attr EVU_Tibber_connect get02-81OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-82Name fc1_15_total
attr EVU_Tibber_connect get02-83Name fc1_16_startsAt
attr EVU_Tibber_connect get02-83OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-84Name fc1_16_total
attr EVU_Tibber_connect get02-85Name fc1_17_startsAt
attr EVU_Tibber_connect get02-85OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-86Name fc1_17_total
attr EVU_Tibber_connect get02-87Name fc1_18_startsAt
attr EVU_Tibber_connect get02-87OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-88Name fc1_18_total
attr EVU_Tibber_connect get02-89Name fc1_19_startsAt
attr EVU_Tibber_connect get02-89OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-8Name fc0_02_total
attr EVU_Tibber_connect get02-90Name fc1_19_total
attr EVU_Tibber_connect get02-91Name fc1_20_startsAt
attr EVU_Tibber_connect get02-91OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-92Name fc1_20_total
attr EVU_Tibber_connect get02-93Name fc1_21_startsAt
attr EVU_Tibber_connect get02-93OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-94Name fc1_21_total
attr EVU_Tibber_connect get02-95Name fc1_22_startsAt
attr EVU_Tibber_connect get02-95OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-96Name fc1_22_total
attr EVU_Tibber_connect get02-97Name fc1_23_startsAt
attr EVU_Tibber_connect get02-97OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02-98Name fc1_23_total
attr EVU_Tibber_connect get02-9Name fc0_03_startsAt
attr EVU_Tibber_connect get02-9OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get02Data { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total startsAt} today {total startsAt} tomorrow {total startsAt}}}}}}" }
attr EVU_Tibber_connect get02Header01 Content-Type: application/json
attr EVU_Tibber_connect get02Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get02JSON data_viewer_home_currentSubscription_priceInfo
attr EVU_Tibber_connect get02Name 02_priceAll
attr EVU_Tibber_connect get02URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get03-1Name nodes_00_00_from
attr EVU_Tibber_connect get03-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-2Name nodes_00_00_cost
attr EVU_Tibber_connect get03-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-3Name nodes_00_00_consumption
attr EVU_Tibber_connect get03-4Name nodes_00_01_from
attr EVU_Tibber_connect get03-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-50Name nodes_00_01_cost
attr EVU_Tibber_connect get03-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-5Name nodes_00_01_cost
attr EVU_Tibber_connect get03-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-6Name nodes_00_01_consumption
attr EVU_Tibber_connect get03-7Name nodes_00_02_from
attr EVU_Tibber_connect get03-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get03-8Name nodes_00_02_cost
attr EVU_Tibber_connect get03-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get03-9Name nodes_00_02_consumption
attr EVU_Tibber_connect get03Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 3) {nodes {from cost consumption }}}}}"}
attr EVU_Tibber_connect get03Header01 Content-Type: application/json
attr EVU_Tibber_connect get03Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get03Name 03_consumption_hour
attr EVU_Tibber_connect get03RegOpt g
attr EVU_Tibber_connect get03Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get03URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get04-10Name nodes_24_03_from
attr EVU_Tibber_connect get04-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-11Name nodes_24_03_cost
attr EVU_Tibber_connect get04-11OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-12Name nodes_24_03_consumption
attr EVU_Tibber_connect get04-13Name nodes_24_04_from
attr EVU_Tibber_connect get04-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-14Name nodes_24_04_cost
attr EVU_Tibber_connect get04-14OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-15Name nodes_24_04_consumption
attr EVU_Tibber_connect get04-16Name nodes_24_05_from
attr EVU_Tibber_connect get04-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-17Name nodes_24_05_cost
attr EVU_Tibber_connect get04-17OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-18Name nodes_24_05_consumption
attr EVU_Tibber_connect get04-19Name nodes_24_06_from
attr EVU_Tibber_connect get04-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-1Name nodes_24_00_from
attr EVU_Tibber_connect get04-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-20Name nodes_24_06_cost
attr EVU_Tibber_connect get04-20OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-21Name nodes_24_06_consumption
attr EVU_Tibber_connect get04-22Name nodes_24_07_from
attr EVU_Tibber_connect get04-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-23Name nodes_24_07_cost
attr EVU_Tibber_connect get04-23OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-24Name nodes_24_07_consumption
attr EVU_Tibber_connect get04-25Name nodes_24_08_from
attr EVU_Tibber_connect get04-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-26Name nodes_24_08_cost
attr EVU_Tibber_connect get04-26OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-27Name nodes_24_08_consumption
attr EVU_Tibber_connect get04-28Name nodes_24_09_from
attr EVU_Tibber_connect get04-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-29Name nodes_24_09_cost
attr EVU_Tibber_connect get04-29OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-2Name nodes_24_00_cost
attr EVU_Tibber_connect get04-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-30Name nodes_24_09_consumption
attr EVU_Tibber_connect get04-31Name nodes_24_10_from
attr EVU_Tibber_connect get04-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-32Name nodes_24_10_cost
attr EVU_Tibber_connect get04-32OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-33Name nodes_24_10_consumption
attr EVU_Tibber_connect get04-34Name nodes_24_11_from
attr EVU_Tibber_connect get04-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-35Name nodes_24_11_cost
attr EVU_Tibber_connect get04-35OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-36Name nodes_24_11_consumption
attr EVU_Tibber_connect get04-37Name nodes_24_12_from
attr EVU_Tibber_connect get04-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-38Name nodes_24_12_cost
attr EVU_Tibber_connect get04-38OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-39Name nodes_24_12_consumption
attr EVU_Tibber_connect get04-3Name nodes_24_00_consumption
attr EVU_Tibber_connect get04-40Name nodes_24_13_from
attr EVU_Tibber_connect get04-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-41Name nodes_24_13_cost
attr EVU_Tibber_connect get04-41OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-42Name nodes_24_13_consumption
attr EVU_Tibber_connect get04-43Name nodes_24_14_from
attr EVU_Tibber_connect get04-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-44Name nodes_24_14_cost
attr EVU_Tibber_connect get04-44OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-45Name nodes_24_14_consumption
attr EVU_Tibber_connect get04-46Name nodes_24_15_from
attr EVU_Tibber_connect get04-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-47Name nodes_24_15_cost
attr EVU_Tibber_connect get04-47OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-48Name nodes_24_15_consumption
attr EVU_Tibber_connect get04-49Name nodes_24_16_from
attr EVU_Tibber_connect get04-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-4Name nodes_24_01_from
attr EVU_Tibber_connect get04-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-50Name nodes_24_16_cost
attr EVU_Tibber_connect get04-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-51Name nodes_24_16_consumption
attr EVU_Tibber_connect get04-52Name nodes_24_17_from
attr EVU_Tibber_connect get04-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-53Name nodes_24_17_cost
attr EVU_Tibber_connect get04-53OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-54Name nodes_24_17_consumption
attr EVU_Tibber_connect get04-55Name nodes_24_18_from
attr EVU_Tibber_connect get04-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-56Name nodes_24_18_cost
attr EVU_Tibber_connect get04-56OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-57Name nodes_24_18_consumption
attr EVU_Tibber_connect get04-58Name nodes_24_19_from
attr EVU_Tibber_connect get04-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-59Name nodes_24_19_cost
attr EVU_Tibber_connect get04-59OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-5Name nodes_24_01_cost
attr EVU_Tibber_connect get04-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-60Name nodes_24_19_consumption
attr EVU_Tibber_connect get04-61Name nodes_24_20_from
attr EVU_Tibber_connect get04-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-62Name nodes_24_20_cost
attr EVU_Tibber_connect get04-62OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-63Name nodes_24_20_consumption
attr EVU_Tibber_connect get04-64Name nodes_24_21_from
attr EVU_Tibber_connect get04-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-65Name nodes_24_21_cost
attr EVU_Tibber_connect get04-65OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-66Name nodes_24_21_consumption
attr EVU_Tibber_connect get04-67Name nodes_24_22_from
attr EVU_Tibber_connect get04-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-68Name nodes_24_22_cost
attr EVU_Tibber_connect get04-68OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-69Name nodes_24_22_consumption
attr EVU_Tibber_connect get04-6Name nodes_24_01_consumption
attr EVU_Tibber_connect get04-70Name nodes_24_23_from
attr EVU_Tibber_connect get04-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-71Name nodes_24_23_cost
attr EVU_Tibber_connect get04-71OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-72Name nodes_24_23_consumption
attr EVU_Tibber_connect get04-7Name nodes_24_02_from
attr EVU_Tibber_connect get04-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get04-8Name nodes_24_02_cost
attr EVU_Tibber_connect get04-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get04-9Name nodes_24_02_consumption
attr EVU_Tibber_connect get04Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 24) {nodes {from cost consumption}}}}}"}
attr EVU_Tibber_connect get04Header01 Content-Type: application/json
attr EVU_Tibber_connect get04Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get04Name 04_consumption_hour_24
attr EVU_Tibber_connect get04RegOpt g
attr EVU_Tibber_connect get04Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get04URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get05AutoNumLen 4
attr EVU_Tibber_connect get05Data { "query": "{viewer {home(id:\"%%homeID%%\") {consumption(resolution: HOURLY, last: 100) {nodes {from cost consumption}}}}}"}
attr EVU_Tibber_connect get05Header01 Content-Type: application/json
attr EVU_Tibber_connect get05Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get05JSON data_viewer_home
attr EVU_Tibber_connect get05Name 05_consumption_hourly_100
attr EVU_Tibber_connect get05URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get06-10Name Adresse_07_Telefon
attr EVU_Tibber_connect get06-11Name Adresse_01_Vorname
attr EVU_Tibber_connect get06-12Name Adresse_02_Nachname
attr EVU_Tibber_connect get06-1Name Adresse_03_Strasse
attr EVU_Tibber_connect get06-2Name Adresse_05_Ort
attr EVU_Tibber_connect get06-3Name Adresse_06_Land
attr EVU_Tibber_connect get06-4Name Adresse_05_Ort
attr EVU_Tibber_connect get06-5Name Adresse_06_Land
attr EVU_Tibber_connect get06-6Name Adresse_09_latitude
attr EVU_Tibber_connect get06-7Name Adresse_10_longitude
attr EVU_Tibber_connect get06-8Name Adresse_04_Plz
attr EVU_Tibber_connect get06-9Name Adresse_08_eMail
attr EVU_Tibber_connect get06Data { "query": "{viewer {home(id:\"%%homeID%%\") {address {address1 address2 address3 postalCode city country latitude longitude} owner {firstName lastName contactInfo {email mobile}}}}}" }
attr EVU_Tibber_connect get06Header01 Content-Type: application/json
attr EVU_Tibber_connect get06Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get06JSON data_viewer_home
attr EVU_Tibber_connect get06Name 06_address
attr EVU_Tibber_connect get06URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect get07-10Name nodes_24_03_from
attr EVU_Tibber_connect get07-10OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-11Name nodes_24_03_cost
attr EVU_Tibber_connect get07-11OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-12Name nodes_24_03_consumption
attr EVU_Tibber_connect get07-13Name nodes_24_04_from
attr EVU_Tibber_connect get07-13OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-14Name nodes_24_04_cost
attr EVU_Tibber_connect get07-14OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-15Name nodes_24_04_consumption
attr EVU_Tibber_connect get07-16Name nodes_24_05_from
attr EVU_Tibber_connect get07-16OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-17Name nodes_24_05_cost
attr EVU_Tibber_connect get07-17OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-18Name nodes_24_05_consumption
attr EVU_Tibber_connect get07-19Name nodes_24_06_from
attr EVU_Tibber_connect get07-19OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-1Name features_realTimeConsumptionEnabled
attr EVU_Tibber_connect get07-1OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-20Name nodes_24_06_cost
attr EVU_Tibber_connect get07-20OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-21Name nodes_24_06_consumption
attr EVU_Tibber_connect get07-22Name nodes_24_07_from
attr EVU_Tibber_connect get07-22OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-23Name nodes_24_07_cost
attr EVU_Tibber_connect get07-23OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-24Name nodes_24_07_consumption
attr EVU_Tibber_connect get07-25Name nodes_24_08_from
attr EVU_Tibber_connect get07-25OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-26Name nodes_24_08_cost
attr EVU_Tibber_connect get07-26OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-27Name nodes_24_08_consumption
attr EVU_Tibber_connect get07-28Name nodes_24_09_from
attr EVU_Tibber_connect get07-28OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-29Name nodes_24_09_cost
attr EVU_Tibber_connect get07-29OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-2Name features_id
attr EVU_Tibber_connect get07-2OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-30Name nodes_24_09_consumption
attr EVU_Tibber_connect get07-31Name nodes_24_10_from
attr EVU_Tibber_connect get07-31OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-32Name nodes_24_10_cost
attr EVU_Tibber_connect get07-32OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-33Name nodes_24_10_consumption
attr EVU_Tibber_connect get07-34Name nodes_24_11_from
attr EVU_Tibber_connect get07-34OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-35Name nodes_24_11_cost
attr EVU_Tibber_connect get07-35OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-36Name nodes_24_11_consumption
attr EVU_Tibber_connect get07-37Name nodes_24_12_from
attr EVU_Tibber_connect get07-37OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-38Name nodes_24_12_cost
attr EVU_Tibber_connect get07-38OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-39Name nodes_24_12_consumption
attr EVU_Tibber_connect get07-3Name nodes_24_00_consumption
attr EVU_Tibber_connect get07-40Name nodes_24_13_from
attr EVU_Tibber_connect get07-40OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-41Name nodes_24_13_cost
attr EVU_Tibber_connect get07-41OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-42Name nodes_24_13_consumption
attr EVU_Tibber_connect get07-43Name nodes_24_14_from
attr EVU_Tibber_connect get07-43OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-44Name nodes_24_14_cost
attr EVU_Tibber_connect get07-44OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-45Name nodes_24_14_consumption
attr EVU_Tibber_connect get07-46Name nodes_24_15_from
attr EVU_Tibber_connect get07-46OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-47Name nodes_24_15_cost
attr EVU_Tibber_connect get07-47OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-48Name nodes_24_15_consumption
attr EVU_Tibber_connect get07-49Name nodes_24_16_from
attr EVU_Tibber_connect get07-49OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-4Name nodes_24_01_from
attr EVU_Tibber_connect get07-4OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-50Name nodes_24_16_cost
attr EVU_Tibber_connect get07-50OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-51Name nodes_24_16_consumption
attr EVU_Tibber_connect get07-52Name nodes_24_17_from
attr EVU_Tibber_connect get07-52OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-53Name nodes_24_17_cost
attr EVU_Tibber_connect get07-53OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-54Name nodes_24_17_consumption
attr EVU_Tibber_connect get07-55Name nodes_24_18_from
attr EVU_Tibber_connect get07-55OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-56Name nodes_24_18_cost
attr EVU_Tibber_connect get07-56OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-57Name nodes_24_18_consumption
attr EVU_Tibber_connect get07-58Name nodes_24_19_from
attr EVU_Tibber_connect get07-58OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-59Name nodes_24_19_cost
attr EVU_Tibber_connect get07-59OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-5Name nodes_24_01_cost
attr EVU_Tibber_connect get07-5OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-60Name nodes_24_19_consumption
attr EVU_Tibber_connect get07-61Name nodes_24_20_from
attr EVU_Tibber_connect get07-61OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-62Name nodes_24_20_cost
attr EVU_Tibber_connect get07-62OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-63Name nodes_24_20_consumption
attr EVU_Tibber_connect get07-64Name nodes_24_21_from
attr EVU_Tibber_connect get07-64OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-65Name nodes_24_21_cost
attr EVU_Tibber_connect get07-65OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-66Name nodes_24_21_consumption
attr EVU_Tibber_connect get07-67Name nodes_24_22_from
attr EVU_Tibber_connect get07-67OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-68Name nodes_24_22_cost
attr EVU_Tibber_connect get07-68OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-69Name nodes_24_22_consumption
attr EVU_Tibber_connect get07-6Name nodes_24_01_consumption
attr EVU_Tibber_connect get07-70Name nodes_24_23_from
attr EVU_Tibber_connect get07-70OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-71Name nodes_24_23_cost
attr EVU_Tibber_connect get07-71OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-72Name nodes_24_23_consumption
attr EVU_Tibber_connect get07-7Name nodes_24_02_from
attr EVU_Tibber_connect get07-7OExpr $val =~ s/T/ /g ;; substr($val,0,19)
attr EVU_Tibber_connect get07-8Name nodes_24_02_cost
attr EVU_Tibber_connect get07-8OExpr ($val ne "0" and $val ne "null")? round($val,4) : $val
attr EVU_Tibber_connect get07-9Name nodes_24_02_consumption
attr EVU_Tibber_connect get07Data { "query": "{viewer {home(id:\"%%homeID%%\") {id features{realTimeConsumptionEnabled} } } }" }
attr EVU_Tibber_connect get07Header01 Content-Type: application/json
attr EVU_Tibber_connect get07Header02 Authorization: Bearer %%token%%
attr EVU_Tibber_connect get07JSON data_viewer_home
attr EVU_Tibber_connect get07Name 07_realTimeConsumptionEnabled
attr EVU_Tibber_connect get07RegOpt g
attr EVU_Tibber_connect get07Regex \{"from":"([\d+-]+T[\d+:]+\.000[+-][\d+:]+)","cost":(null|\d+\.\d+|0),"consumption":(null|\d+\.\d+|0)\}
attr EVU_Tibber_connect get07URL https://api.tibber.com/v1-beta/gql
attr EVU_Tibber_connect group PV Steuerung EVU
attr EVU_Tibber_connect icon stromzaehler_icon
attr EVU_Tibber_connect replacement01Mode expression
attr EVU_Tibber_connect replacement01Regex %%token%%
attr EVU_Tibber_connect replacement01Value {KeyValue("read","EVU_Tibber_connect_token")}
attr EVU_Tibber_connect replacement02Mode expression
attr EVU_Tibber_connect replacement02Regex %%homeID%%
attr EVU_Tibber_connect replacement02Value {KeyValue("read","EVU_Tibber_connect_homeID")}
attr EVU_Tibber_connect requestData { "query": "{viewer {home(id:\"%%homeID%%\") {currentSubscription {priceInfo {current {total energy tax startsAt }}}}}}" }
attr EVU_Tibber_connect requestHeader1 Content-Type: application/json
attr EVU_Tibber_connect requestHeader2 Authorization: Bearer %%token%%
attr EVU_Tibber_connect room Strom->Boerse
attr EVU_Tibber_connect showBody 1
attr EVU_Tibber_connect showError 1
attr EVU_Tibber_connect sortby 313
attr EVU_Tibber_connect timeout 30
attr EVU_Tibber_connect userReadings ws_connect:ws_cmd:.connect {\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
return "Device already open" if (defined($devState));;\
\
# establish connection to websocket\
# format must also include portnumber if a path is to be specified\
$hash->{DeviceName} = AttrVal($name, "ws_websocketURL", "wss:echo.websocket.org:443");;\
\
# special headers needed for Tibber, see also Developer Tools in Browser\
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';;\
$hash->{header}{'Host'} = 'websocket-api.tibber.com';;\
$hash->{header}{'Origin'} = 'https://developer.tibber.com';;\
\
# callback function when "select()" signals data for us\
# websocket Ping/Pongs are treated in DevIo but still call this function\
$hash->{directReadFn} = sub () {\
my $hash = $defs{$name};;\
\
# we can read without closing the DevIo, because select() signalled data\
my $buf = DevIo_SimpleRead($hash);;\
\
# if read fails, close device\
if(!defined($buf)) {\
DevIo_CloseDev($hash);;\
$buf = "not_connected";;\
}\
\
#Log(3, "$name:$reading: websocket data: >>>$buf<<<");;\
\
# only update our reading if buffer is not empty and if last update is older than minInterval\
if ($buf ne "") {\
my $websocketDataAge = ReadingsAge($name, "ws_websocketData", 3600);;\
my $minInterval = AttrVal($name, "ws_minInterval", 0);;\
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);;\
\
readingsBeginUpdate($hash);;\
readingsBulkUpdate($hash, "ws_websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);;\
readingsBulkUpdate($hash, "ws_websocketData", "$buf") if (!$isNext);;\
readingsEndUpdate($hash, 1);;\
#Log(3, "$name:$reading: websocket data written to reading");;\
}\
};;\
\
# open DevIo websocket\
DevIo_OpenDev($hash, 0, undef, sub(){\
my ($hash, $error) = @_;;\
return "$error" if ($error);;\
\
my $token = AttrVal($name, "ws_token", "???");;\
$token = KeyValue("read","EVU_Tibber_connect_token") if ($token eq "???");;\
\
DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);;\
});;\
readingsBulkUpdate($hash, "ws_websocketData", "");;\
#Log(3, "$name:$reading: websocket data cleared in reading");;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_disconnect:ws_cmd:.disconnect {\
Log(3, "$name: disconnect");;\
my $hash = $defs{$name};;\
RemoveInternalTimer($hash);;\
DevIo_SimpleRead($hash);;\
DevIo_CloseDev($hash);;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onDisconnect {\
my $myState = ReadingsVal($name, "state", "???");;\
my $myData = ReadingsVal($name, "ws_websocketData", "???");;\
return if ($myState ne "disconnected" and $myData ne "not_connected");;\
\
## timer callback function, called after a few seconds to initiate a reconnect\
my $timerFunction = sub() {\
my ($arg) = @_;;\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
\
# only re-connect if device is not connected\
readingsSingleUpdate($hash, "ws_cmd", "connect", 1) if (!defined($devState));;\
};;\
RemoveInternalTimer($name.$reading.'Timer');;\
\
# wait a random time before reconnect (exponential backoff TBD):\
my $rwait = int(rand(200)) + 30;;\
InternalTimer(gettimeofday() + $rwait, $timerFunction, $name.$reading.'Timer');;\
\
#set cmd to a new value, informs user and allows to retrigger when timer expires\
my $hash = $defs{$name};;\
readingsBulkUpdate($hash, "ws_cmd", "reconnect attempt in $rwait seconds");;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onTimeout:ws_websocketData:.* {\
#re-establish websocket connection if no data received in the past ten minutes\
#but only if our reading "ws_cmd" was not set to the value "disconnect"\
\
#Log(3, "$name:$reading: websocket data triggert ws_onTimeout");;\
\
#timeout in seconds when the connection is considered dead\
my $timeoutTime = 600;;\
\
# function to execute when timeout expired\
# defining the function here in the userReading, allows us to insert variables directly\
my $timerFunction = sub() {\
my ($arg) = @_;;\
my $hash = $defs{$name};;\
my $rCmd = ReadingsVal($name, "ws_cmd", "???");;\
my $age = ReadingsAge($name, "ws_websocketData", 0);;\
\
Log(3, "$name: onTimeoutTimer triggered >>$arg<<");;\
\
#do not do anything further if disconnect is on purpose\
if ( $rCmd eq "disconnect" ) {\
Log(3, "$name: ws_cmd was set to disconnect");;\
return;;\
}\
\
# for whatever reason, we triggered to soon (80%)\
if ( $age < $timeoutTime*0.8 ) {\
Log(3, "$name: ws_websocketData is not outdated");;\
return;;\
}\
\
DevIo_CloseDev($hash);;\
Log(3, "$name: onTimeoutTimer closed DevIo...");;\
\
readingsSingleUpdate($hash, "ws_cmd", "connect", 1);;\
Log(3, "$name: onTimeoutTimer set ws_cmd to value 'connect'");;\
};;\
\
#Log(3, "$name:$reading: onTimeout function defined");;\
\
#remove/cancel previous timers, because we got fresh data and countdown starts again\
RemoveInternalTimer($name.$reading.'Timer');;\
\
#set timer to expire and execute function defined above, give special arg as identifier\
InternalTimer(gettimeofday() + $timeoutTime, $timerFunction, $name.$reading.'Timer');;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onConnectionAck:ws_websocketData:.*connection_ack.* {\
#ws_websocketData contains the string "connection_ack"\
Log(3, "$name:$reading: got connection ack");;\
\
# do not proceed if connection is lost\
my $hash = $defs{$name};;\
my $devState = DevIo_IsOpen($hash);;\
return "Device not open" if (!defined($devState));;\
\
readingsBulkUpdate($hash, "ws_cmd", "got connection ack");;\
\
my $homeId = AttrVal($name, "ws_homeId", "???");;\
$homeId = KeyValue("read","EVU_Tibber_connect_homeID") if ($homeId eq "???");;\
\
my $myId = AttrVal($name, "ws_myId", "???");;\
$myId = KeyValue("read","EVU_Tibber_connect_homeID") if ($myId eq "???");;\
\
# build the query, do it in pieces, the comma at the end caused perl errors\
# so we put it together in this not very elegant way\
my $json = '{ "id":"'. $myId .'", "type":"subscribe"'.", ";;\
$json .= '"payload":{';;\
$json .= '"variables":{}'.", ";;\
$json .= '"extensions":{}'.", ";;\
$json .= '"query":"subscription { liveMeasurement( homeId: \"'.$homeId.'\" ) ';;\
#$json .= '{ timestamp power accumulatedConsumption accumulatedCost currency minPower averagePower maxPower signalStrength }}"';;\
$json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';;\
$json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';;\
$json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';;\
$json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}"';;\
$json .= '}}';;\
\
#send the string via websocket as ASCII\
Log(3, "$name:$reading: sending JSON: >>>$json<<<");;\
DevIo_SimpleWrite($hash, $json, 2);;\
\
return POSIX::strftime("%H:%M:%S",localtime(time()));;\
},\
\
ws_onNextLiveMeasurement:ws_websocketData:.*next.*payload.*data.*liveMeasurement.* {\
#websocketData contains next-live-measurement-data\
my $val = ReadingsVal($name, "ws_websocketData", "{}");;\
my %res = %{json2nameValue($val, undef, undef, "payload_data_liveMeasurement.*")};;\
\
my $ret = "got values for:\n";;\
foreach my $k (sort keys %res) {\
$ret .= "$k\n";;\
readingsBulkUpdate($hash, makeReadingName($k), $res{$k});;\
}\
return $ret;;\
},\
\
nodes_TIMESTAMP:nodes_00_00_cost.* {\
my ($timestamp,$value) = 2x0;;\
my $tmp = 0;;\
\
for (my $loop_last = 0;; $loop_last <= 2;; $loop_last++) {\
$timestamp = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_from","null");;\
$value = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_cost","null");;\
\
if ( $value ne "null" ) {\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","nodes_00_".sprintf("%02d",$loop_last)."_consumption","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
} else {\
$tmp = "null";;\
}\
} # end for\
if ($tmp eq "null") {\
$timestamp = $tmp\
}\
$timestamp;;\
},\
\
nodes_TIMESTAMP:nodes_24_00_cost.* {\
my ($timestamp,$value) = 2x0;;\
my $tmp = 0;;\
\
for (my $loop_last = 0;; $loop_last <= 23;; $loop_last++) {\
$timestamp = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_from","null");;\
$value = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_cost","null");;\
\
if ( $value ne "null" ) {\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","nodes_24_".sprintf("%02d",$loop_last)."_consumption","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
} else {\
$tmp = "null";;\
}\
} # end for\
if ($tmp eq "null") {\
$timestamp = $tmp\
}\
$timestamp;;\
},\
\
nodes_TIMESTAMP:05_consumption_hourly_100-0001.* {\
my ($timestamp,$value) = 2x0;;\
\
for (my $loop_last = 1;; $loop_last <= 300;; $loop_last += 3) {\
\
$timestamp = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last+2),"null");; # timestamp\
$timestamp =~ s/T/ /g ;;\
$timestamp = substr($timestamp,0,19);;\
$value = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last+1),"null");; # cost\
\
if ( $value ne "" ) {\
$value = round($value,4);;\
# print $timestamp." ".$value."\n";;\
\
# Eintragen der Kosten für die Stunde\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_cost','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
# Eintragen des Verbrauchs für die Stunde\
$value = ReadingsVal("$NAME","05_consumption_hourly_100-".sprintf("%04d",$loop_last),"null");; # consumption\
$value = round($value,4);;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','nodes_consumption','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
} # end for\
\
$timestamp;;\
},\
\
nodes_cost_avg:nodes_TIMESTAMP.* {\
## Berechnung des Tages Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(avg(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_avg","null")\
}\
},\
\
nodes_cost_min:nodes_TIMESTAMP.* {\
## Ermittlung des minimal Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(min(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_min","null")\
}\
},\
\
nodes_cost_max:nodes_TIMESTAMP.* {\
## Ermittlung des maximal Wertes\
if ( ReadingsVal("$NAME","nodes_TIMESTAMP","null") ne "null" ) {\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(max(VALUE)*100 AS DECIMAL(4,2)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND TIMESTAMP >= curdate() ;;") ;;\
} else {\
ReadingsVal("$NAME","nodes_cost_max","null")\
}\
},\
\
nodes_consumption_day:nodes_TIMESTAMP.* {\
## Berechnung des Tages Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND date(TIMESTAMP) = curdate() ;;") ;;\
},\
\
nodes_consumption_month:nodes_TIMESTAMP.* {\
## Berechnung des Monats Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND YEAR(TIMESTAMP) = YEAR(curdate())\
AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;") ;;\
},\
\
nodes_consumption_year:nodes_TIMESTAMP.* {\
## Berechnung des Jahres Verbrauches\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT cast(sum(VALUE) AS DECIMAL(10,4)) FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_consumption'\
AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;") ;;\
},\
\
fc_avg:current_price.* {\
## Berechnung des durchschnitt Wertes\
my $fc_avg = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
if (AttrVal("$NAME","verbose",0) >=3) {\
Log 3, "$NAME cmd_1 : Tibber Daten für fc1 sind bereits da";;\
}\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) { ## Summe berechnen\
$fc_avg += ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
} # end $k\
} # end $j\
\
return round($fc_avg / (24 *(1+$fc)) *100 ,2);; ## Durchschnitt berechnen\
},\
\
fc_med:current_price.* {\
## Berechnung des median Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT\
cast( ( (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', floor(1+((count(VALUE)-1) / 2))) , ',', -1))\
+ (SUBSTRING_INDEX(SUBSTRING_INDEX(group_concat(VALUE order by VALUE), ',', ceiling(1+((count(VALUE)-1) / 2))), ',', -1))\
)/2 *100\
AS DECIMAL(4,2))\
FROM history\
WHERE DEVICE='".$NAME."'\
AND ( READING='fc0_total' AND TIMESTAMP >= DATE_FORMAT(NOW(), '%Y-%m-%d 00:00:00')\
OR READING='fc1_total' AND TIMESTAMP >= DATE_FORMAT(NOW() + INTERVAL 1 DAY, '%Y-%m-%d 00:00:00') ) ;;") ;;\
},\
\
fc_min:current_price.* {\
## Ermittlung des minimal Wertes\
my $fc_min = 0;;\
my $fc_tmp = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) {\
$fc_tmp = ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
\
if (($fc_tmp < $fc_min) or ($j == 0 and $k == 0)) {\
$fc_min = $fc_tmp;;\
}\
} # end $k\
} # end $j\
\
return round($fc_min *100 ,2);; ## Von Euro auf Cent umrechnen\
},\
\
fc_max:current_price.* {\
## Ermittlung des minimal Wertes\
my $fc_max = 0;;\
my $fc_tmp = 0;;\
my $fc = 0;;\
\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") { ## Der nächste Tag ist bereits da\
$fc = 1;;\
} # end if\
\
for (my $j=0;;$j<=$fc;;$j++){\
for (my $k=0;;$k<=23;;$k++) {\
$fc_tmp = ReadingsVal("$NAME",sprintf("fc%d_%02d_total",$j,$k),0);;\
\
if (($fc_tmp > $fc_max) or ($j == 0 and $k == 0)) {\
$fc_max = $fc_tmp;;\
}\
} # end $k\
} # end $j\
\
return round($fc_max *100 ,2);; ## Von Euro auf Cent umrechnen\
},\
\
fc_trigger_price:fc_avg.* {\
## fc_trigger_price:[fc_avg|compensation_grid].* {\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_min = ReadingsVal("$NAME","fc_min",0);;\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
if ( ReadingsVal("$NAME","compensation_grid",0) != 0 ) {\
my $price_level_battery = round( ($fc_avg - ReadingsVal("$NAME","compensation_grid",0)) *0.85 , 1) ;;\
if ( $price_level > $price_level_battery ) {\
$price_level = $price_level_battery;;\
}\
}\
$price_level;;\
},\
\
fc0_trigger_start:fc_trigger_price.* {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_stop:fc0_trigger_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc0_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc0_trigger:fc0_trigger_stop.* {\
\
# Setzen des Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",100) < ReadingsVal("$NAME","fc_trigger_price",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc1_trigger_start:fc_trigger_price.* {\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
}\
return("null");;\
},\
\
fc1_trigger_stop:fc0_trigger_start.* {\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc1_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc_trigger_max:fc_avg.* {\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_max = ReadingsVal("$NAME","fc_max",0);;\
\
# Berechnung eines Schwellwertes als täglichen Maximalpreises\
my $price_level = round( ($fc_max - $fc_avg)/2 + $fc_avg , 0);;\
\
$price_level;;\
},\
\
fc0_trigger_max_start:fc_trigger_max.* {\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger_max Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_max_stop:fc0_trigger_max_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_max_start = ReadingsVal("$NAME","fc0_trigger_max_start","null");;\
my $fc_trigger_max_stop = $fc_trigger_max_start;;\
\
if ( $fc_trigger_max_start ne "null" ) {\
$fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_max_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
$fc_trigger_max_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_max_stop);;\
},\
\
fc0_trigger_max:fc0_trigger_max_stop.* {\
\
# Setzen des maximum Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",0) > ReadingsVal("$NAME","fc_trigger_max",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc1_trigger_max_start:fc_trigger_max.* {\
if (ReadingsVal("$NAME","fc1_00_startsAt","null") ne "null") {\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
}\
return("null");;\
},\
\
fc1_trigger_max_stop:fc0_trigger_max_start.* {\
my $loop_hour = 0;;\
my $fc_trigger_max = ReadingsVal("$NAME","fc_trigger_max",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_max_start = ReadingsVal("$NAME","fc1_trigger_max_start","null");;\
my $fc_trigger_max_stop = $fc_trigger_max_start;;\
\
if ( $fc_trigger_max_start ne "null" ) {\
$fc_trigger_max_start =~ /(\d\d):/;; $fc_trigger_max_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_max_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc1_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total > $fc_trigger_max ) {\
$fc_trigger_max_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_max_stop);;\
},\
\
total_cost_day:nodes_TIMESTAMP.* {\
## Berechnung des Tages Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND date(TIMESTAMP) = curdate() ;;") ;;\
},\
\
total_cost_month:nodes_TIMESTAMP.* {\
## Berechnung des monats Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND YEAR(TIMESTAMP) = YEAR(curdate())\
AND MONTH(TIMESTAMP) = MONTH(curdate()) ;;") ;;\
},\
\
total_cost_year:nodes_TIMESTAMP.* {\
## Berechnung des Jahres Wertes\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
SELECT CAST(SUM(VALUE) AS DECIMAL(8,2)) AS VALUE\
FROM history\
WHERE DEVICE='".$NAME."'\
AND READING='nodes_cost'\
AND YEAR(TIMESTAMP) = YEAR(curdate()) ;;") ;;\
},\
\
fc_DbLog:fc0_00_total.* {\
my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\
\
for (my $loop_fc = 0;; $loop_fc <= 1;; $loop_fc++) {\
$loop_fc_next = $loop_fc +1;;\
$date = ReadingsVal("$NAME","fc".$loop_fc."_00_startsAt","null");;\
if ($date ne "null") {\
$date =~ /([\d+-]+)/;; $date = $1 ;;\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$hour = sprintf("%02d",$loop_hour);;\
$timestamp = $date." ".$hour.":00:00";;\
$value = ReadingsVal("$NAME","fc".$loop_fc."_".$hour."_total","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','fc".$loop_fc."_total','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
if (ReadingsVal("$NAME","fc".$loop_fc."_00_startsAt","null") eq ReadingsVal("$NAME","fc".$loop_fc_next."_00_startsAt","null")) {\
fhem("deletereading $NAME fc".$loop_fc_next."_.*");;\
}\
} else {\
fhem("deletereading $NAME fc1_.*");;\
}\
}\
ReadingsTimestamp("$NAME","fc0_00_startsAt","null");;\
}
attr EVU_Tibber_connect verbose 0
attr EVU_Tibber_connect ws_minInterval 54
attr EVU_Tibber_connect ws_websocketURL wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions
</syntaxhighlight>

==== EVU_Tibber RAW Device ====
Das Device dient der Anzeige und Steuerung des EVU_Tibber_connect Devices.
<syntaxhighlight lang="Perl">
defmod EVU_Tibber DOIF ## Startup Befehle für den WebSocket vom EVU_Tibber_connect\
init\
{ \
Log(0, "$SELF 0 init : ▶️ EVU_Tibber init");;\
fhem("setreading EVU_Tibber_connect ws_cmd connect");; \
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 0 WebSocket : ▶️ EVU_Tibber_connect start Websocket";;\
}\
Log(0, "$SELF 0 init : 🏁 EVU_Tibber init done");;\
}\
\
################################################################################################################\
## EVU_Tibber_connect start/stop WebSocket\
EVU_Tibber_connect_ws\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
# or [$SELF:ui_command_2] ## Hier wird das uiTable select ausgewertet\
and [$SELF:ui_command_2] ne "---"\
) {\
\
fhem("setreading EVU_Tibber_connect ws_cmd ".[?$SELF:ui_command_2]);; \
\
set_Reading("ui_command_2","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 1 Scheduling für das Abholen von Tibber Daten\
1_EVU_Tibber_PriceInfo\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
( [:03] ## Kurz nach jeder vollen Stunde\
)\
or [$SELF:ui_command_1] eq "1_EVU_Tibber_PriceInfo" ## Hier wird das uiTable select ausgewertet\
) {\
\
::CommandGet(undef, "EVU_Tibber_connect 01_priceInfo");; ## Preis für die aktuelle Stunde\
::CommandGet(undef, "EVU_Tibber_connect 03_consumption_hour");; ## Kosten der letzen drei Stunden\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 1 PriceInfo : Abfrage von Tibber";;\
}\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 2 Scheduling für das Abholen der Tibber Preise\
2_EVU_Tibber_PriceAll\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
([00:03] or [14:03] ## Ab 14:00 Uhr gibt es die Preise für den nächsten Tag\
)\
or [$SELF:ui_command_1] eq "2_EVU_Tibber_PriceAll" ## Hier wird das uiTable select ausgewertet\
) {\
\
::CommandGet(undef, "EVU_Tibber_connect 02_priceAll");;\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 2 priceAll : Abfrage von Tibber für den nächsten Tag";;\
}\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\
\
################################################################################################################\
## 2 Erstellen des Diagramms im uiTable\
3_EVU_Tibber_Diagramm\
{if( !([$SELF:state] eq "off") ## DOIF enabled\
and\
( [00:05] or [14:05] ## Kurz nach Mitternacht\
)\
or [$SELF:ui_command_1] eq "3_EVU_Tibber_Diagramm" ## Hier wird das uiTable select ausgewertet\
) {\
\
my (@out) = ("") x 2;;\
my $timestamp;;\
\
for (my $j=0;;$j<=1;;$j++){\
\
if (ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_00_startsAt",$j),"null") eq "null") { ## Der nächste Tag ist noch nicht da\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 3 Diagramm : Tibber Daten für fc".$j." sind noch nicht da";;\
}\
\
$timestamp = POSIX::strftime("%Y-%m-%d",localtime(time+86400));; ## Setze das Datum auf morgen\
for (my $k=0;;$k<=24;;$k++) {\
$out[$j] .= sprintf("%s_%02d:00:00 0.0\n", $timestamp, $k);; ## Die Daten mit 0 ergänzen\
}\
$j = 2;; ## Aus der Schleife springen\
\
} else {\
\
for (my $i=0;;$i<=23;;$i++){\
$timestamp = ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_%02d_startsAt",$j,$i),"");;\
$timestamp =~ s/ /_/g;;\
$out[$j] .=$timestamp." ".::round(ReadingsVal("EVU_Tibber_connect",sprintf("fc%d_%02d_total",$j, $i),0)*100,1)."\n";;\
} # End $i\
\
} # End if\
} # End $j\
\
if (AttrVal("$SELF","verbose",0) >=3) {\
Log 3, "$SELF 3 Diagramm : Werte für das Diagramm";;\
print($out[0]);;\
print($out[1]);;\
}\
## Die readings current_price und current_level dienen hier nur als Trigger Events, und müssen für\
## jedes Diagramm unterschiedlich sein, die Daten werden über $out[] bereit gestellt !!\
::DOIF_modify_card_data("EVU_Tibber","EVU_Tibber_connect","current_price","bar1day",0,$out[0]);;\
::DOIF_modify_card_data("EVU_Tibber","EVU_Tibber_connect","current_level","bar1day",-86400,$out[1]);;\
## Mit der Abfrage 03_consumption_hour werden die Trigger erneut ausgelöst\
::CommandGet(undef, "EVU_Tibber_connect 01_priceInfo");; ## Kosten der letzen drei Stunden\
## fhem("get EVU_Tibber_connect 01_priceInfo");; ## Kosten der letzen drei Stunden\
\
set_Reading("ui_command_1","---");; ## Hier wird das uiTable select wieder zurückgesetzt, ansonsten\
## kann das Kommando nicht sofort wiederholt werden\
}\
}\

attr EVU_Tibber DbLogExclude .*
attr EVU_Tibber comment Version 2023.12.06 13:00 \
Dieses Device benötigt EVU_Tibber_connect als Verbindung zu Tibber.
attr EVU_Tibber disable 0
attr EVU_Tibber group PV Steuerung EVU
attr EVU_Tibber icon stromzaehler_icon
attr EVU_Tibber room Strom->Boerse
attr EVU_Tibber sortby 315
attr EVU_Tibber uiState {\
package ui_Table;;\
$TABLE = "style='width:100%;;'";;\
\
$TD{0..6}{0} = "style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'";;\
$TD{0..6}{1..4} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'";;\
$TD{0..6}{5} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'";;\
\
}\
\
"Kommando<dd>Auswahl</dd>" |widget([$SELF:ui_command_1],"uzsuDropDown,---,1_EVU_Tibber_PriceInfo,2_EVU_Tibber_PriceAll,3_EVU_Tibber_Diagramm") |"LiveMessurement <br>".widget([$SELF:ui_command_2],"uzsuDropDown,---,connect,disconnect")|""|[EVU_Tibber_connect:ws_cmd]\
\
"Strompreis<br>".card([EVU_Tibber_connect:current_price:bar1day],undef,undef,0,60,90,0,"fc0 ".::ReadingsVal(Device(),"current_currency",""),undef,"1","130,,,,,,220").card([EVU_Tibber_connect:current_level:bar1day],undef,undef,0,60,90,0,"fc1 ".::ReadingsVal(Device(),"current_currency",""),undef,"1","130,,,,,,220")|\
"<span style=font-weight:bold>nächste 3h</span><br><br>".Price(1)."<br>".Price(2)."<br>".Price(3)|"<span style=font-weight:bold>Statistik fc0</span><br><br>".::ReadingsVal(Device(),"fc_min",0)." min<br>".::ReadingsVal(Device(),"fc_avg",0)." avg<br>".::ReadingsVal(Device(),"fc_med",0)." med<br>".::ReadingsVal(Device(),"fc_max",0)." max"|\
"<span style=font-weight:bold>Trigger fc0</span><br>Basis ".widget([EVU_Tibber_connect:compensation_grid],"selectnumbers,0,0.1,12,1,lin")."<br>".Format("trigger_0")|\
"<span style=font-weight:bold>Trigger fc1</span><br><br>".Format("trigger_1")
attr EVU_Tibber uiTable {\
package ui_Table;;\
$TABLE = "style='width:100%;;'";;\
\
$TD{0..18}{0} = "style='border-top-style:solid;;border-bottom-style:solid;;border-left-style:solid;;border-left-width:2px;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:36%;;font-weight:bold;;'";;\
$TD{0..18}{1..5} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:1px;;width:8%;;text-align:center;;'";;\
$TD{0..18}{6} = "style='border-top-style:solid;;border-bottom-style:solid;;border-right-style:solid;;border-color:darkgreen;;border-top-width:2px;;border-bottom-width:2px;;border-right-width:2px;;width:8%;;text-align:center;;'";;\
\
sub FUNC_Status {\
my($value, $min, $colorMin, $statusMin, $colorMiddel, $statusMiddle, $max, $colorMax, $statusMax)=@_;;\
my $ret = ($value < $min)? '<span style="color:'.$colorMin.'">'.$statusMin.'</span>' : ($value > $max)? '<span style="color:'.$colorMax.'">'.$statusMax.'</span>' : '<span style="color:'.$colorMiddel.'">'.$statusMiddle.'</span>';;\
return $ret;;\
}\
\
sub Device {\
return "$SELF"."_connect";;\
}\
\
sub Cost {\
my($i)=@_;;\
my $currency = (::ReadingsVal(Device(),"current_currency","") eq "EUR")? " €" : "";;\
\
return ::ReadingsVal(Device(),"total_cost_".$i,0).$currency;;\
}\
\
sub Price {\
my($i)=@_;;\
my $j;;\
my $value;;\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
\
if ($i == 0) {\
$value = ::ReadingsVal(Device(),"current_price",0);;\
$value = ( ::ReadingsVal(Device(),"fc0_trigger","off") eq "on" ) ?\
"<span style='color:green'>".$value."</span>" :\
"<span style='color:red'>".$value."</span>" ;;\
$value .= " ct/kWh";;\
} else {\
$j = $i+$hour;;\
if ($j < 24) {\
$value = ::round(::ReadingsVal(Device(),"fc0_".sprintf("%02d",$j)."_total",0)*100,1);;\
} else {\
$j = $j - 24;;\
$value = ::round(::ReadingsVal(Device(),"fc1_".sprintf("%02d",$j)."_total",0)*100,1);;\
}\
$value = ( ::ReadingsVal(Device(),"fc_trigger_price","0") > $value ) ?\
"<span style='color:green'>".$value."</span>" :\
"<span style='color:red'>".$value."</span>" ;;\
$value = sprintf("%02d",$j)." : ".$value ;;\
}\
return $value;;\
}\
\
sub Format {\
my($i)=@_;;\
\
my $MonthBefore = "LogDBRep_Statistic_previous_Month";;\
my $MonthPrevious = ::ReadingsTimestamp("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month","null");;\
$MonthPrevious = ($MonthPrevious ne "null") ? POSIX::strftime("%Y",localtime(::time_str2num(::ReadingsTimestamp("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month","null")))) : "null";;\
\
my $YearBefore = "LogDBRep_Statistic_previous_Year";;\
my $YearPrevious = ::ReadingsTimestamp("$YearBefore",Device()."_nodes_consumption_year","null");;\
$YearPrevious = ($YearPrevious ne "null") ? POSIX::strftime("%Y",localtime(::time_str2num(::ReadingsTimestamp("$YearBefore",Device()."_nodes_consumption_year","null")))) : "null";;\
\
if ($i eq "day") {\
return sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_day",0));;\
} elsif ($i eq "month") {\
my $evu_em = sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_month",0));;\
$evu_em .= ($MonthPrevious ne "null") ? sprintf(" / %04d", ::ReadingsVal("$MonthBefore","EVU_Tibber_Pulse_nodes_consumption_month",0) ) : "";;\
return $evu_em;;\
} elsif ($i eq "year") {\
my $evu_ey = sprintf("%04d",::ReadingsVal(Device(),"nodes_consumption_year",0));;\
$evu_ey .= ($YearPrevious ne "null") ? sprintf(" / %04d", ::ReadingsVal("$YearBefore","EVU_Tibber_Pulse_nodes_consumption_month",0) ) : "";;\
return $evu_ey;;\
} elsif ($i eq "trigger_0") {\
return ((::ReadingsVal(Device(),"fc0_trigger_start","") eq "null" ) ?\
"<span style='color:red'>Heute kein Trigger <br>mehr unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" :\
"<span style='color:green'>Trigger von<br>".\
::ReadingsVal(Device(),"fc0_trigger_start","00:00")." bis ".::ReadingsVal(Device(),"fc0_trigger_stop","00:00")."<br>unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" );;\
} elsif ($i eq "trigger_1") {\
if (::ReadingsVal(Device(),"fc1_00_startsAt","null") ne "null") {\
return ((::ReadingsVal(Device(),"fc1_trigger_start","null") eq "null" ) ?\
"<span style='color:red'>Morgen kein Trigger <br>mehr unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" :\
"<span style='color:green'>Morgen ein Trigger von<br>".\
::ReadingsVal(Device(),"fc1_trigger_start","00:00")." bis ".::ReadingsVal(Device(),"fc1_trigger_stop","00:00")."<br>unter ".\
::ReadingsVal(Device(),"fc_trigger_price","null")." ct</span>" );;\
} else {\
return "Morgen noch kein Trigger vorhanden";;\
}\
}\
return "null";;\
}\
\
}\
\
"Statistiken ".::ReadingsVal(Device(),"current_date",0)." in kWh"|"<span style=font-weight:bold>aktuell</span>"|"<span style=font-weight:bold>heute</span>"|"<span style=font-weight:bold>Monat</span>"|"<span style=font-weight:bold>Jahr</span>"\
\
"Strom<dd>Preis / Kosten</dd>"|Price(0)|Cost("day")|Cost("month")|Cost("year")\
\
## Wenn man das liveMessurment von Tibber verwendet\
"Bezug vom Netz"|\
sprintf("%04d W",([EVU_Tibber_connect:payload_data_liveMeasurement_power] >= 0 ? ::ReadingsVal("EVU_Tibber_connect","payload_data_liveMeasurement_power",0) : 0))|\
Format("day")|Format("month")|Format("year")\
\
"Einspeisung ins Netz"|\
sprintf("%04d W",([EVU_Tibber_connect:payload_data_liveMeasurement_powerProduction] >= 0 ? ::ReadingsVal("EVU_Tibber_connect","payload_data_liveMeasurement_powerProduction",0) : 0))|\
""|""|""\
\
## Wenn man einen eigenes SmartMeter verwendet\
## "Bezug vom Netz"|sprintf("%04d W",([WR_0_KSEM:M_AC_Power] >= 0 ? ::round(::ReadingsVal("WR_0_KSEM","M_AC_Power",0),0) : 0) )|Format("day")|Format("month")|Format("year")\
## "Einspeisung ins Netz"|sprintf("%04d W",([WR_0_KSEM:M_AC_Power] <= 0 ? abs(::round(::ReadingsVal("WR_0_KSEM","M_AC_Power",0),0)) : 0) )|""|""|""
attr EVU_Tibber verbose 3

setstate EVU_Tibber 2024-01-23 10:03:00 ui_command_1 ---
setstate EVU_Tibber 2024-01-20 17:40:53 ui_command_2 ---
</syntaxhighlight>

==== LogDBRep_EVU_Tibber_connect_SQL RAW Device ====
Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements werden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.
<syntaxhighlight lang="Perl">
defmod LogDBRep_EVU_Tibber_connect_SQL DbRep LogDB
attr LogDBRep_EVU_Tibber_connect_SQL DbLogExclude .*
attr LogDBRep_EVU_Tibber_connect_SQL room System
attr LogDBRep_EVU_Tibber_connect_SQL sqlCmdHistoryLength 5
attr LogDBRep_EVU_Tibber_connect_SQL timeout 20
</syntaxhighlight>

== 2. aWATTar ==
=== Vorausetzungen ===
* FHEM mit einer installierten MySQL DbLog (FileLog wird nicht unterstützt)
* Für die Berechnung der tatsächlichen Kosten benötigt man seine lokalen Fixkosten, die je nach Region unterschiedlich sind.
* Die bisherige Berechnung mit Stand 20240123 wäre wie folgt: round(($val+$val*0.03+1.785)*1.19,2)

=== EVU_aWATTar_connect ===
Das EVU_aWATTar_connect fragt mit HTTPMOD die aWATTar API Webseite ab. Es werden keine Live Verbrauchdaten geliefert.

==== Verwendete Module ====
* HTTPMOD
* DbLog
* DbRep

==== EVU_aWATTar_connect RAW Device ====
Momentan fragt das EVU_aWattar_connect lediglich die aktuellen Preise des Tages ab. Die readings sind an die des EVU_Tibber_connect angelehnt, um im weiteren Verlauf eventuell ein gemeinsames Device für die Anzeige und Steuerung zu erarbeiten.
<syntaxhighlight lang="Perl">
defmod EVU_aWATTar_connect HTTPMOD https://api.awattar.de/v1/marketdata/current.yaml 0
attr EVU_aWATTar_connect DbLogExclude .*
attr EVU_aWATTar_connect comment Version 2024.01.23 13:00\
\
Achtung, momentan werden nur die Börsenpreise ohne die fix Kosten dargestellt.\
\
https://api.awattar.de/v1/marketdata
attr EVU_aWATTar_connect enableControlSet 1
attr EVU_aWATTar_connect get01-15Name fc_max
attr EVU_aWATTar_connect get01-15OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-1Name current_date
attr EVU_aWATTar_connect get01-22Name fc_med
attr EVU_aWATTar_connect get01-22OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-29Name fc_avg
attr EVU_aWATTar_connect get01-29OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-36Name current_price
attr EVU_aWATTar_connect get01-36OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01-8Name fc_min
attr EVU_aWATTar_connect get01-8OExpr round(($val+$val*0.03+1.785)*1.19,2)
attr EVU_aWATTar_connect get01Name 01_priceInfo
attr EVU_aWATTar_connect get01RegOpt g
attr EVU_aWATTar_connect get01Regex date_now: (\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})|price_low: ([0-9]+[0-9\.]+)|price_high: ([0-9]+[0-9\.]+)|price_median: ([0-9]+[0-9\.]+)|price_average: ([0-9]+[0-9\.]+)|price_current: ([0-9]+[0-9\.]+)
attr EVU_aWATTar_connect get01URL https://api.awattar.de/v1/marketdata/current.yaml
attr EVU_aWATTar_connect get02-10Name fc0_09_total
attr EVU_aWATTar_connect get02-10OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-11Name fc0_10_total
attr EVU_aWATTar_connect get02-11OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-12Name fc0_11_total
attr EVU_aWATTar_connect get02-12OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-13Name fc0_12_total
attr EVU_aWATTar_connect get02-13OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-14Name fc0_13_total
attr EVU_aWATTar_connect get02-14OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-15Name fc0_14_total
attr EVU_aWATTar_connect get02-15OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-16Name fc0_15_total
attr EVU_aWATTar_connect get02-16OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-17Name fc0_16_total
attr EVU_aWATTar_connect get02-17OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-18Name fc0_17_total
attr EVU_aWATTar_connect get02-18OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-19Name fc0_18_total
attr EVU_aWATTar_connect get02-19OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-1Name fc0_00_total
attr EVU_aWATTar_connect get02-1OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-20Name fc0_19_total
attr EVU_aWATTar_connect get02-20OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-21Name fc0_20_total
attr EVU_aWATTar_connect get02-21OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-22Name fc0_21_total
attr EVU_aWATTar_connect get02-22OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-23Name fc0_22_total
attr EVU_aWATTar_connect get02-23OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-24Name fc0_23_total
attr EVU_aWATTar_connect get02-24OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-2Name fc0_01_total
attr EVU_aWATTar_connect get02-2OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-3Name fc0_02_total
attr EVU_aWATTar_connect get02-3OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-4Name fc0_03_total
attr EVU_aWATTar_connect get02-4OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-5Name fc0_04_total
attr EVU_aWATTar_connect get02-5OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-6Name fc0_05_total
attr EVU_aWATTar_connect get02-6OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-7Name fc0_06_total
attr EVU_aWATTar_connect get02-7OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-8Name fc0_07_total
attr EVU_aWATTar_connect get02-8OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02-9Name fc0_08_total
attr EVU_aWATTar_connect get02-9OExpr round(($val+$val*0.03+1.785)*1.19/100,4)
attr EVU_aWATTar_connect get02FollowGet 01_priceInfo
attr EVU_aWATTar_connect get02Name 02_priceDay
attr EVU_aWATTar_connect get02RegOpt g
attr EVU_aWATTar_connect get02Regex (?<=abs_[0-9]{2}_amount: )([0-9]+[0-9\.]+)
attr EVU_aWATTar_connect get02URL https://api.awattar.de/v1/marketdata/current.yaml
attr EVU_aWATTar_connect get03-1Name fc3_00_startsAt
attr EVU_aWATTar_connect get03-1OExpr POSIX::strftime("%Y-%m-%d %H:%M:%S",localtime(substr($val,0,10)))
attr EVU_aWATTar_connect get03-4Name fc3_00_total
attr EVU_aWATTar_connect get03-4OExpr round($val/1000,4)
attr EVU_aWATTar_connect get03Name 02_priceAll
attr EVU_aWATTar_connect get03RegOpt g
attr EVU_aWATTar_connect get03Regex "start_timestamp": (\d{10})|"marketprice": (\d*\.\d*)
attr EVU_aWATTar_connect get03URL https://api.awattar.de/v1/marketdata?start=1701990000000&end=1702159200000
attr EVU_aWATTar_connect group PV Steuerung EVU
attr EVU_aWATTar_connect icon sani_pump
attr EVU_aWATTar_connect room Strom->Boerse
attr EVU_aWATTar_connect sortby 213
attr EVU_aWATTar_connect userReadings fc_trigger_price:fc_avg.* {\
## fc_trigger_price:[fc_avg|compensation_grid].* {\\
my $fc_avg = ReadingsVal("$NAME","fc_avg",0);;\
my $fc_min = ReadingsVal("$NAME","fc_min",0);;\
\
# Berechnung eines Default Schwellwertes als täglicher Niedrigpreis\
my $price_level = round( ($fc_avg - $fc_min)/2 + $fc_min , 1);;\
\
# Abschätzung von Wirtschaftlichkeit beim Speicher Laden, falls Tibber zu teuer wird\
if ( ReadingsVal("$NAME","compensation_grid",0) != 0 ) {\
my $price_level_battery = round( ($fc_avg - ReadingsVal("$NAME","compensation_grid",0)) *0.85 , 1) ;;\
if ( $price_level > $price_level_battery ) {\
$price_level = $price_level_battery;;\
}\
}\
$price_level;;\
},\
\
fc0_trigger_start:fc_trigger_price.* {\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);; $year += 1900;; $mon += 1 ;;\
my $fc_total = 0;;\
\
for (my $loop_hour = $hour;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc0_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
return(sprintf("%02d:00",$loop_hour)) ;;\
}\
} # end for loop_hour\
\
return("null");;\
},\
\
fc0_trigger_stop:fc0_trigger_start.* {\
my $fc = 0;;\
my $loop_hour = 0;;\
my $fc_trigger_price = ReadingsVal("$NAME","fc_trigger_price",0) /100;;\
\
# Ermitteln des nächsten Trigger Fensters\
my $fc_trigger_start = ReadingsVal("$NAME","fc0_trigger_start","null");;\
my $fc_trigger_stop = $fc_trigger_start;;\
\
if ( $fc_trigger_start ne "null" ) {\
$fc_trigger_start =~ /(\d\d):/;; $fc_trigger_start = $1 ;;\
my $fc_total = 0;;\
\
for ($loop_hour = $fc_trigger_start;; $loop_hour <= 23;; $loop_hour++) {\
$fc_total = ReadingsVal("$NAME","fc".$fc."_".sprintf("%02d",$loop_hour)."_total",0);;\
if ( $fc_total < $fc_trigger_price ) {\
$fc_trigger_stop = sprintf("%02d:00",$loop_hour) ;;\
} else {\
return(sprintf("%02d:00",$loop_hour));;\
}\
\
# wechsel zum nächsten Tag\
if ( $loop_hour == 23 and $fc == 0 ) {\
$fc = 1;;\
$loop_hour = -1;;\
}\
\
} # end for loop_hour\
}\
\
return($fc_trigger_stop);;\
},\
\
fc0_trigger:fc0_trigger_stop.* {\
\
# Setzen des Triggers für die aktuelle Stunde\
if ( ReadingsVal("$NAME","current_price",100) < ReadingsVal("$NAME","fc_trigger_price",0) ) {\
return("on")\
} else {\
return("off")\
}\
},\
\
fc_DbLog:fc0_00_total.* {\
my ($timestamp,$date,$hour,$value,$loop_fc_next) = 5x0;;\
\
for (my $loop_fc = 0;; $loop_fc <= 1;; $loop_fc++) {\
$loop_fc_next = $loop_fc +1;;\
$date = ReadingsVal("$NAME","current_date","null");;\
if ($date ne "null") {\
$date =~ /([\d+-]+)/;; $date = $1 ;;\
for (my $loop_hour = 0;; $loop_hour <= 23;; $loop_hour++) {\
$hour = sprintf("%02d",$loop_hour);;\
$timestamp = $date." ".$hour.":00:00";;\
$value = ReadingsVal("$NAME","fc".$loop_fc."_".$hour."_total","null");;\
::CommandGet(undef, "LogDBRep_".$NAME."_SQL sqlCmdBlocking\
INSERT INTO history (TIMESTAMP,DEVICE,TYPE,READING,VALUE)\
VALUES('".$timestamp."','$NAME','Tibber','fc".$loop_fc."_total','".$value."')\
ON DUPLICATE KEY UPDATE\
VALUE='".$value."';;") ;;\
}\
} else {\
fhem("deletereading $NAME fc1_.*");;\
}\
}\
ReadingsVal("$NAME","current_date","null");;\
}
attr EVU_aWATTar_connect verbose 0
</syntaxhighlight>

==== LogDBRep_EVU_aWATTar_connect_SQL RAW Device ====
Dieses DbRep Device dient der Verbindung zur MySQL DbLog. Die SQL SELECT Statements werden im EVU_Tibber_connect Device generiert und über dieses Device in der MySQL DbLog ausgeführt. Der Name des Devices wird ebenfalls generiert und liegt somit fest.
<syntaxhighlight lang="Perl">
defmod LogDBRep_EVU_aWATTar_connect_SQL DbRep LogDB
attr LogDBRep_EVU_aWATTar_connect_SQL DbLogExclude .*
attr LogDBRep_EVU_aWATTar_connect_SQL room System
attr LogDBRep_EVU_aWATTar_connect_SQL sqlCmdHistoryLength 5
attr LogDBRep_EVU_aWATTar_connect_SQL timeout 20
</syntaxhighlight>

== 3. EPEX_Spot ==
=== Vorausetzungen ===
httpmod

==== EPEX_Spot RAW Device ====
Mit diesem device erhält man die viertelstündlichen Börsenpreise für heute ('EPEX_prices_day'), für morgen ('EPEX_prices_dayahead') und den aktuellen Preis ('EPEX_price').
Die dayahead Preise werden in der Regel gegen 14:00 am Vortag veröffentlicht.
<syntaxhighlight lang="Perl">
defmod EPEX_Boersenpreise HTTPMOD https://api.energy-charts.info/price?bzn=DE-LUtimerange 900
attr EPEX_Boersenpreise alignTime 00:00:30
attr EPEX_Boersenpreise comment This device queries prices for electrical energy from https://api.energy-charts.info/price?bzn=DE-LU.\
The quarter-hour day and dayahead prices are given as lists of 96 elements each, the first price element being valid for the first quarter-hour 00:00 to 00:15, and so on.\
All prices are in €/MWh
attr EPEX_Boersenpreise get02JSON price
attr EPEX_Boersenpreise get02Name EPEX_prices_day
attr EPEX_Boersenpreise get02RecombineExpr join ",", @matchlist
attr EPEX_Boersenpreise get02Replacement01Value {""}
attr EPEX_Boersenpreise get03JSON price
attr EPEX_Boersenpreise get03Name EPEX_prices_dayahead
attr EPEX_Boersenpreise get03RecombineExpr join ",", @matchlist
attr EPEX_Boersenpreise get03Replacement01Value {fhem("setreading $name EPEX_prices_dayahead not yet published");;;;my ($sec, $min, $hour, $mday, $month, $year) = localtime();;;;my $start = 86400+int(fhemTimeLocal(0,0,0, $mday, $month, $year));;;;"&start=".$start."&end=".($start+86399)}
attr EPEX_Boersenpreise reading01JSON price
attr EPEX_Boersenpreise reading01Name EPEX_price
attr EPEX_Boersenpreise replacement01Mode expression
attr EPEX_Boersenpreise replacement01Regex timerange
attr EPEX_Boersenpreise replacement01Value {my ($sec, $min, $hour, $mday, $month, $year) = localtime();;;;"&start=".900 * (int(fhemTimeLocal(0, $min, $hour, $mday, $month, $year) / 900))}
attr EPEX_Boersenpreise stateFormat EPEX_price €/MWh
attr EPEX_Boersenpreise verbose 2
</syntaxhighlight>
Weder get02Poll noch get03Poll sollten auf 1 gesetzt sein, da es dann zu gelegentlichen timeout-Fehlern kommt. Davon abgesehen ist es soowieso überflüssig, die sich nur einmal täglich ändernden 'prices_day' und 'prices_dayahead' Wert zu oft auszulesen.
Folgendes 'at' sorgt dafür, dass beide Preis_Listen nur 1x pro Tag gelesen werden:
<syntaxhighlight lang="Perl">
define get_EPEX_prices at *00:03:00 get EPEX_Boersenpreise EPEX_prices_day;;setreading EPEX_Boersenpreise EPEX_prices_dayahead not yet published;;define get_EPEX_prices_dayahead at 15:03 get EPEX_Boersenpreise EPEX_prices_dayahead
</syntaxhighlight>
Dieses 'at' liest täglich kurz nach Mitternacht die 'day' Preise und erzeugt ein einmal-'at', das kurz nach 15:00 die 'dayahead' Preise liest.

== Links ==
* Website (deutsch) des Anbieters [https://tibber.com/de Tibber]
* Website (deutsch) des Anbieters [https://www.awattar.de/ aWATTar]

Benutzer Diskussion:Gary

2025-10-07T15:47:09Z

Ph1959de: Willkommen

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Gary,''' willkommen im FHEM Wiki!</span></big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 17:46, 7. Okt. 2025 (CEST)
|}

FHEMWiki:Interna

2025-09-21T17:44:20Z

Ph1959de: Update MediaWiki

{{Randnotiz|RNTyp=info|RNText="Infobox Interna" zu FHEM Wiki
* [[Spezial:Version|Versionsinfo]]
* [[Spezial:Statistik|Statistisches]]
}}
[[FHEMWiki:Interna]] wie Informationen über geplante Wartungsarbeiten, Probleme, Erweiterungswünsche etc.

== Anfragen, Ideen, Todo ==
* Suche im Wiki "case-'''in'''-sensitive machen ({{Link2Forum|Topic=123428}})</br>MediaWiki Links:
** https://www.mediawiki.org/wiki/Extension:MixedNamespaceSearchSuggestions
** https://www.mediawiki.org/wiki/Manual:Enabling_autocomplete_in_search_box
* ...

== Aktuell ==

== September 2025 ==
* MediaWiki auf Version 1.39.13 angehoben

== Dezember 2024 ==
* MediaWiki auf Version 1.39.10 angehoben

== April 2024 ==
Umstellung des FHEMWiki-Standardskin ("Style") von 'Vector alt (2010)' auf 'Vector (2022)' um eine bessere Benutzbarkeit auf mobilen Geräten bei nicht registrierten Benutzern zu erreichen. Registrierte Benutzer können unter Einstellungen/Aussehen den Skin selbst ändern. {{Link2Forum|Topic=137399|Diskussion dazu im Forum}}
== März 2023 ==
* Umzug auf neuen Server steht an
* dabei wird auch MediaWiki auf die aktuelle Version angehoben

== April 2021 ==
* 5.4.: MediaWiki wurde auf Version 1.35.1 aktualisiert
:* als Vorbereitung dafür: Upgrade von PHP 7.3.11 auf PHP 7.3.27
:* Extension "UserMerge" installiert (relevant nur für Wiki Admins)

== September 2018 ==
* 9.9.: MediaWiki wurde auf Version 1.31.0 aktualisiert

== Januar 2017 ==
* MediaWiki wurde auf Version 1.28.0 aktualisiert

== Dezember 2016 ==
* Wiki wurde auf einen anderen Server und gleichzeitig auf die Domain wiki.fhem.de umgezogen
* MediaWiki wurde vorerst auf Version 1.24.1 belassen; Update auf aktuelle Version ist vorgesehen, sobald sich das Wiki in der neuen Umgebung eingespielt hat

== Umstellung vom 6.11.2015 ==
* Einige "Standarddateien" (aus wikimedia:common) scheinen verschwunden zu sein; dadurch fehlen aktuell einige Bilder, insbesondere in den Vorlagen "Hallo" und "Randnotiz". Arno wurde per Mail informiert.

== Umstellung vom 30.10.2015 ==
* [[Syntax Highlighting]] wurde auf mehrfachen Wunsch eingerichtet.

== Umstellung vom 10.2.2015 ==
Am 10.2.2015 wurde der Wiki-Server auf eine leistungsfähigere Plattform umgezogen.

Gleichzeitig wurde die MediaWiki Version auf 1.24.1 aktualisiert.

=== Offene Probleme ===
Probleme sind mittlerweile abgearbeitet, Wünsche bearbeitet (abgelehnt oder erfüllt)

=== Erledigte Probleme ===
* Kopfbereich aller Wiki-Seiten hat (noch) die falsche Hintergrundfarbe
** erledigt: [[Benutzer:Akw|Akw]] ([[Benutzer Diskussion:Akw|Diskussion]]) 17:27, 24. Feb. 2015 (CET)
* ''wikitable sortable'' funktioniert nicht (mehr)
** erledigt: --[[Benutzer:Akw|Akw]] ([[Benutzer Diskussion:Akw|Diskussion]]) 22:37, 19. Apr. 2015 (CEST)
* Bearbeitungs- und erweiterte Bearbeitungswerkzeugleiste sind trotz Auswahl in Benutzereinstellung nicht vorhanden (getestete Browser: Firefox, IE)
** erledigt: --[[Benutzer:Akw|Akw]] ([[Benutzer Diskussion:Akw|Diskussion]]) 22:37, 19. Apr. 2015 (CEST)
* Suchvorschlagsliste bei Eingabe des Suchwortes im Suchfeld nicht mehr vorhanden
** erledigt: --[[Benutzer:Krikan|Christian]] ([[Benutzer Diskussion:Krikan|Diskussion]]) 20:23, 22. Apr. 2015 (CEST)
* Darstellung ist "anders" (z.B.: Überschriften auf Level 2 (==) jetzt Serifenschrift)
* (Wunsch:) Wäre es möglich, die Extension [http://www.mediawiki.org/wiki/Extension:DynamicWikiSitemap DynamicWikiSitemap] zu installieren?
** Die funktioniert nicht gut mit dem nginx-webserver. Ich habe statische sitemaps für die Google Webmaster Tools erstellt: http://wiki.fhem.de/w/sitemap/sitemap-index-c1fhemwiki.xml [[Benutzer:Akw|Akw]] ([[Benutzer Diskussion:Akw|Diskussion]]) 17:27, 24. Feb. 2015 (CET)
* Benutzereinstellungen (Spezial:Einstellungen): die Seite bietet keine "Themes" (mehr?) an; es ist "nur noch" '''Benutzeroberfläche''' ''Vector'' installiert.
:: Das ist so gewollt. ([[Benutzer Diskussion:Akw|Diskussion]]) 17:27, 24. Feb. 2015 (CET)
* Bug? Wenn man direkt ein Kapitel einer Seite bearbeitet, bleibt die Schaltfläche "nur Kleinigkeiten wurden verändert" ohne Wirkung.

=== Diskussion ===
:: Es gibt aber allem Anschein nach noch ein offenes Problem mit diesem einzigen verbliebenen Skin: ich bekomme auf allen FHEM-Wiki Seiten (sichtbar "nur" in Firebug) die Fehlermeldung ''<nowiki>"NetworkError: 502 Bad Gateway - http://wiki.fhem.de/w/load.php?debug=false&lang=de&modules=startup&only=scripts&skin=vector&*"</nowiki>''. Nach einer Info, die ich an anderer Stelle gefunden habe, könnte auch die fehlende Werkzeugleiste damit zusammenhängen.
:: Falls die Frage erlaubt ist: was ist der Grund dafür, dass nur noch ein Skin "gewollt" ist? --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 10:56, 2. Apr. 2015 (CEST)
:: <hr />
:: Ich hab den Bug jetzt im Griff, denke ich. Es paar Puffergrößen mussten angepasst werden. --[[Benutzer:Akw|Akw]] ([[Benutzer Diskussion:Akw|Diskussion]]) 22:35, 19. Apr. 2015 (CEST)
:: @Peter: Wenn es zwingend gewünscht wird, lasse ich mich mit den Skins breitschlagen, aber Vector ist doch ganz hübsch oder? Und der Wartungsaufwand wird minimiert.
[[Kategorie:FHEM Wiki]]
::: Ich brauch jedenfalls keine Skins.[[Benutzer:Soulman|Soulman]] ([[Benutzer Diskussion:Soulman|Diskussion]]) 03:47, 26. Apr. 2015 (CEST)
:: <hr />
:: Ich bin neu hier und daher hoffentlich an der richtigen Stelle: Unterstützt die MediaWiki-Software eine Umschaltung der Inhaltssprache? Idealerweise gäbe es zu jedem Artikel ein englisches Äquivalent, das angezeigt wird, wenn der Nutzer englisch eingestellt hat. Aber geht das im FHEMWiki und wenn ja, wie? [[Benutzer:Rollo Wikinger|Rollo Wikinger]] ([[Benutzer Diskussion:Rollo Wikinger|Diskussion]]) 21:35, 5. Jan. 2020 (CET)
::: <hr />
::: Hallo "Rollo",
::: nein, die Mehrsprachigkeit ist nicht implementiert / installiert (bin mir nicht sicher, was dafür alles erforderlich wäre. Ist bisher bei einigen wenigen Seiten "manuell" gelöst, indem an den Seitentitel ein "/en" (siehe z.B. [[Quick-Start/en]]) angehängt ist. Am Anfang der Seite dann jeweils ein Verweis auf die andere(n) Sprachversionen. --[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 18:54, 27. Dez. 2020 (CET)

Kategorie:Akustische Ausgabe

2025-09-05T17:04:19Z

Ph1959de:

[[Kategorie:Kommunikationswege]]

Benutzer Diskussion:Parallix

2025-08-21T08:11:30Z

Ph1959de: Willkommen

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big><span style="color: #FAFAFA">'''Hallo Parallix,''' willkommen im FHEM Wiki!</span></big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]'''<br />''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]'''<br />''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]'''<br />''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]'''<br />''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]'''<br />''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]'''<br />''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. <br /><br />
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|<u>meiner</u> Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 10:11, 21. Aug. 2025 (CEST)
|}

Diskussion:SmartVISU/lichtSzene

2025-06-04T17:29:24Z

Ph1959de: Die Seite wurde neu angelegt: „@wvhn: ich schlage vor, die HTML-Beispiele mit <nowiki><syntaxhighlight lang="html"></nowiki> zu formatieren - das von Dir verwendete nowiki erscheint ziemlich aufwändig und fehleranfällig. Falls es "nur" darum ging, Zeilenumbrüche zu vermeiden / unterdrücken, lassen sich möglicherweise auch noch andere Wege finden. --~~~~“

@wvhn: ich schlage vor, die HTML-Beispiele mit <nowiki><syntaxhighlight lang="html"></nowiki> zu formatieren - das von Dir verwendete nowiki erscheint ziemlich aufwändig und fehleranfällig. Falls es "nur" darum ging, Zeilenumbrüche zu vermeiden / unterdrücken, lassen sich möglicherweise auch noch andere Wege finden.
--[[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 19:29, 4. Jun. 2025 (CEST)