Quelltext der Seite SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

{{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, Forecast.Solar API, Victron VRM Portal API oder alternativ DWD Stahlungswerte-Stationen verwendet werden

::* optionale KI Unterstützung bei Verwendung von DWD Stahlungswerten

::* Wetterdaten werden über DWD Wetter-Stationen oder verschiedene API integriert

::* 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 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 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

::* 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 Benutzerlebnis 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 ==

== 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 ein Batteriesystem (Attribut setupBatteryDev), weitere Wetter-Devices (Attribut setupWeatherDev1 - setupWeatherDev3) oder sonstige Erzeuger (z.B. BHKW, Winderzeugung, Notstromaggregat) integriert werden (Attribut setupOtherProducer01 - setupOtherProducer03).


<br>
== 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 (1)
 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.

=== 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 '''ctrlShowLink''' 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.
  

<br>

== Wie funktioniert 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 gespeichert. 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.

<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 ctrlInterval) 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>

=== Wie wird die Verbrauchsprognose erstellt? ===

Aus den gespeicherten con-Werten (Verbrauchsdaten) der pvHistory wird der Durchschnitt der vergangenen Tage ermittelt und für den kommenden Tag angewendet. Dabei geht per default jeder historische Tag gleichberechtigt in die Prognose ein. Mit dem Attribut '''affectConsForecastIdentWeekdays = 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. 

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>

=== Wie kann eine fehlerhafte 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 consumption 07 21

<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 '''ctrlInterval''' 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::]CurrentVal ($defs{'<Name>'}, '<Key>', <default>) <br> entspricht der Abfrage mit "get ... valCurrent". 

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

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

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

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

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

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

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

::* [FHEM::SolarForecast::]StringVal ($defs{'<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)
     <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'
     <c>        - Nummer des Verbrauchers (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>

== 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 API's
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 3 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:
<br>

* 1. definieren des neuen SolarForecast Devices 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. starten von FHEM (bestimmte Daten werden automatisch importiert)
* 5. mit dem Befehl "set <name> plantConfiguration restore" die Anlagenkonfiguration wiederherstellen

<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:
<br>

* 1. definieren des neuen SolarForecast Devices 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. starten von FHEM (die Daten werden automatisch importiert)
* 6. mit dem Befehl "set <name> plantConfiguration restore" die Anlagenkonfiguration wiederherstellen

<br>
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. 


<br>

== dynamische SoC Steuerung für Solarbatterien ==
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 minimalisiert 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 '''ctrlBatSocManagement''' z.B. mit diesen Angaben:
 
 ctrlBatSocManagement lowSoc=10 upSoC=50 maxSoC=98 careCycle=20

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''' enthält den vom Modul berechneten optimalen Mindest-SoC.
Das Reading '''Battery_ChargeRequest''' wird auf '1' gesetzt, wenn der aktuelle SoC unter den Mindest-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%ige 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.

=== 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 %).
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.

Alle Triggerpunkte können mit dem set-Befehl:

 reset batteryTriggerSet

wieder gelöscht werden.


<br>
== 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.



=== 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:
:<code>Shelly.shellyplug3 type=heater power=1700 icon=vent_ventilation mode=can notbefore=09 mintime=SunPath:60:-60 on=on off=off</code>

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>

== 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. <br>
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 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


<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
|135.7 KB 
|28892  
|DS_Starter
|55_DWD_OpenData: contrib 1.17.5
|}
<syntaxhighlight lang="perl">
define DWD DWD_OpenData
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 H568
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 Blintrop   -(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_BatCharge
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"\
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
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
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
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
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
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
attr Forecast consumer07 tuya_local_bf3998b01d59bbaf1e7df1 icon=scene_workshop@orange type=noSchedule power=5 swstate:state pcurr=cur_power:W:3 etotal=energy:Wh auto=solarforecast_auto
attr Forecast consumer08 tuya_local_bfac44fb487476efd1vhdu icon=weather_sunset@orange type=noSchedule power=5 swstate:state pcurr=cur_power:W:3 etotal=energy:Wh auto=solarforecast_auto
attr Forecast consumerAdviceIcon light_light_dim_100@gold
attr Forecast consumerLegend icon_top
attr Forecast consumerLink 1
attr Forecast ctrlBatSocManagement lowSoc=9 upSoC=30 maxSoC=99 careCycle=20
attr Forecast ctrlDebug none
attr Forecast ctrlGenPVdeviation continuously
attr Forecast ctrlInterval 10
attr Forecast ctrlStatisticReadings SunHours_Remain,SunMinutes_Remain,allStringsFullfilled,conForecastTillNextSunrise,currentAPIinterval,currentRunMtsConsumer_01,currentRunMtsConsumer_02,currentRunMtsConsumer_03,currentRunMtsConsumer_04,currentRunMtsConsumer_05,dayAfterTomorrowPVforecast,daysUntilBatteryCare,lastretrieval_time,lastretrieval_timestamp,response_message,runTimeCentralTask,runTimeLastAPIAnswer,runTimeLastAPIProc,runTimeTrainAI,todayBatIn,todayBatOut,todayConForecastTillSunset,todayConsumptionForecast,todayDoneAPIcalls,todayDoneAPIrequests,todayGridConsumption,todayGridFeedIn,todayMaxAPIcalls,todayRemainingAPIcalls,todayRemainingAPIrequests
attr Forecast disable 0
attr Forecast event-on-change-reading .*
attr Forecast flowGraphicAnimate 1
attr Forecast flowGraphicConsumerDistance 80
attr Forecast flowGraphicShift 0
attr Forecast flowGraphicShowConsumer 1
attr Forecast flowGraphicShowConsumerDummy 1
attr Forecast flowGraphicShowConsumerPower 1
attr Forecast flowGraphicShowConsumerRemainTime 0
attr Forecast flowGraphicSize 400
attr Forecast graphicBeam1Color 3C14FF
attr Forecast graphicBeam1Content pvReal
attr Forecast graphicBeam2Color 19FF29
attr Forecast graphicBeam2Content pvForecast
attr Forecast graphicBeam3Color D60924
attr Forecast graphicBeam3Content gridconsumption
attr Forecast graphicBeam3FontColor FFFF0D
attr Forecast graphicBeam4Color FFFF1F
attr Forecast graphicBeam4Content gridfeedin
attr Forecast graphicBeam4FontColor 000000
attr Forecast graphicBeamHeightLevel1 200
attr Forecast graphicBeamHeightLevel2 200
attr Forecast graphicHeaderDetail all
attr Forecast graphicHeaderOwnspec PV&nbsp;;Heute&nbsp;;real:Today_PVreal Verbrauch&nbsp;;bis&nbsp;;Sonnenaufgang&nbsp;;:statistic_conForecastTillNextSunrise PV&nbsp;;Morgen&nbsp;;erwartet:Tomorrow_PVforecast PV&nbsp;;Uebermorgen&nbsp;;erwartet:statistic_dayAfterTomorrowPVforecast  Batt.-Ladeanforderung&nbsp;;:Battery_ChargeRequest FCU-Erzeugung&nbsp;;:Current_PP01\

attr Forecast graphicHistoryHour 8
attr Forecast graphicHourCount 24
attr Forecast graphicLayoutType double
attr Forecast graphicShowDiff top
attr Forecast graphicShowNight 0
attr Forecast group Energy Meter
attr Forecast room 020_PV,Energie
attr Forecast setupBatteryDev BatteryDummy pin=-pout:kW pout=total_pac:kW intotal=bat_loadtotal:kWh outtotal=bat_unloadtotal:kWh charge=chargestatus cap=19600
attr Forecast setupInverterDev InverterDummy pv=total_pac:kW etotal=etotal:kWh capacity=9500
attr Forecast setupInverterStrings GarageSE,GarageNW,HausNW,HausSW
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.025:€ feedprice=0.08123:€
attr Forecast setupRadiationAPI OpenMeteoDWDEnsemble-API
attr Forecast setupStringPeak GarageSE=2.75 GarageNW=3.2 HausNW=2.230 HausSW=2.230
attr Forecast setupWeatherDev1 OpenMeteoDWDEnsemble-API
attr Forecast stateFormat Current_PV
attr Forecast verbose 2

setstate Forecast 3701 W
setstate Forecast 2024-09-22 16:43:24 .associatedWith 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_bf3998b01d59bbaf1e7df1 tuya_local_bfac44fb487476efd1vhdu InverterDummy SMA_Energymeter BatteryDummy
setstate Forecast 2024-09-22 17:17:29 .lastupdateForecastValues 1727018249
setstate Forecast 2024-09-22 01:00:02 .pvCorrectionFactor_01_apipercentil done
setstate Forecast 2024-09-22 01:00:02 .pvCorrectionFactor_01_cloudcover done
setstate Forecast 2024-09-22 02:00:04 .pvCorrectionFactor_02_apipercentil done
setstate Forecast 2024-09-22 02:00:04 .pvCorrectionFactor_02_cloudcover done
setstate Forecast 2024-09-22 03:00:03 .pvCorrectionFactor_03_apipercentil done
setstate Forecast 2024-09-22 03:00:03 .pvCorrectionFactor_03_cloudcover done
setstate Forecast 2024-09-22 04:00:04 .pvCorrectionFactor_04_apipercentil done
setstate Forecast 2024-09-22 04:00:04 .pvCorrectionFactor_04_cloudcover done
setstate Forecast 2024-09-22 05:00:04 .pvCorrectionFactor_05_apipercentil done
setstate Forecast 2024-09-22 05:00:04 .pvCorrectionFactor_05_cloudcover done
setstate Forecast 2024-09-22 06:01:42 .pvCorrectionFactor_06_apipercentil done
setstate Forecast 2024-09-22 06:01:42 .pvCorrectionFactor_06_cloudcover done
setstate Forecast 2024-09-22 07:00:04 .pvCorrectionFactor_07_apipercentil done
setstate Forecast 2024-09-22 07:00:04 .pvCorrectionFactor_07_cloudcover done
setstate Forecast 2024-09-22 08:00:05 .pvCorrectionFactor_08_apipercentil done
setstate Forecast 2024-09-22 08:00:05 .pvCorrectionFactor_08_cloudcover done
setstate Forecast 2024-09-22 09:00:05 .pvCorrectionFactor_09_apipercentil done
setstate Forecast 2024-09-22 09:00:05 .pvCorrectionFactor_09_cloudcover done
setstate Forecast 2024-09-22 10:00:02 .pvCorrectionFactor_10_apipercentil done
setstate Forecast 2024-09-22 10:00:02 .pvCorrectionFactor_10_cloudcover done
setstate Forecast 2024-09-22 11:00:04 .pvCorrectionFactor_11_apipercentil done
setstate Forecast 2024-09-22 11:00:04 .pvCorrectionFactor_11_cloudcover done
setstate Forecast 2024-09-22 12:00:05 .pvCorrectionFactor_12_apipercentil done
setstate Forecast 2024-09-22 12:00:05 .pvCorrectionFactor_12_cloudcover done
setstate Forecast 2024-09-22 13:00:05 .pvCorrectionFactor_13_apipercentil done
setstate Forecast 2024-09-22 13:00:05 .pvCorrectionFactor_13_cloudcover done
setstate Forecast 2024-09-22 14:00:02 .pvCorrectionFactor_14_apipercentil done
setstate Forecast 2024-09-22 14:00:02 .pvCorrectionFactor_14_cloudcover done
setstate Forecast 2024-09-22 15:00:01 .pvCorrectionFactor_15_apipercentil done
setstate Forecast 2024-09-22 15:00:01 .pvCorrectionFactor_15_cloudcover done
setstate Forecast 2024-09-22 16:00:02 .pvCorrectionFactor_16_apipercentil done
setstate Forecast 2024-09-22 16:00:02 .pvCorrectionFactor_16_cloudcover done
setstate Forecast 2024-09-22 17:00:05 .pvCorrectionFactor_17_apipercentil done
setstate Forecast 2024-09-22 17:00:05 .pvCorrectionFactor_17_cloudcover done
setstate Forecast 2024-09-22 17:17:29 .pvCorrectionFactor_Auto_Soll on_complex_ai
setstate Forecast 2024-09-22 01:00:02 .signaldone_01 done
setstate Forecast 2024-09-22 02:00:04 .signaldone_02 done
setstate Forecast 2024-09-22 03:00:03 .signaldone_03 done
setstate Forecast 2024-09-22 04:00:04 .signaldone_04 done
setstate Forecast 2024-09-22 05:00:04 .signaldone_05 done
setstate Forecast 2024-09-22 06:01:42 .signaldone_06 done
setstate Forecast 2024-09-22 07:00:04 .signaldone_07 done
setstate Forecast 2024-09-22 08:00:05 .signaldone_08 done
setstate Forecast 2024-09-22 09:00:05 .signaldone_09 done
setstate Forecast 2024-09-22 10:00:02 .signaldone_10 done
setstate Forecast 2024-09-22 11:00:04 .signaldone_11 done
setstate Forecast 2024-09-22 12:00:05 .signaldone_12 done
setstate Forecast 2024-09-22 13:00:05 .signaldone_13 done
setstate Forecast 2024-09-22 14:00:02 .signaldone_14 done
setstate Forecast 2024-09-22 15:00:01 .signaldone_15 done
setstate Forecast 2024-09-22 16:00:02 .signaldone_16 done
setstate Forecast 2024-09-22 17:00:05 .signaldone_17 done
setstate Forecast 2024-09-22 17:17:29 Battery_ChargeRequest 0
setstate Forecast 2024-09-22 17:17:29 Battery_OptimumTargetSoC 10 %
setstate Forecast 2024-09-22 17:17:29 Current_AutarkyRate 100 %
setstate Forecast 2024-09-22 17:17:29 Current_BatCharge 99.50 %
setstate Forecast 2024-09-22 17:17:29 Current_Consumption 596 W
setstate Forecast 2024-09-22 17:17:29 Current_GridConsumption 0 W
setstate Forecast 2024-09-22 17:17:29 Current_GridFeedIn 3105 W
setstate Forecast 2024-09-09 16:20:33 Current_PP01 0 W
setstate Forecast 2024-09-22 17:17:29 Current_PV 3701 W
setstate Forecast 2024-09-22 17:17:29 Current_PowerBatIn 0 W
setstate Forecast 2024-09-22 17:17:29 Current_PowerBatOut 0 W
setstate Forecast 2024-09-22 17:17:29 Current_SelfConsumption 596 W
setstate Forecast 2024-09-22 17:17:29 Current_SelfConsumptionRate 16 %
setstate Forecast 2024-09-22 17:17:29 Current_Surplus 3105 W
setstate Forecast 2024-09-22 17:00:00 LastHourGridconsumptionReal 0 Wh
setstate Forecast 2024-09-22 17:00:00 LastHourPVforecast 2388 Wh
setstate Forecast 2024-09-22 17:00:00 LastHourPVreal 3424 Wh
setstate Forecast 2024-09-22 17:17:29 NextHours_Sum01_PVforecast 1448 Wh
setstate Forecast 2024-09-22 17:17:29 NextHours_Sum02_PVforecast 1991 Wh
setstate Forecast 2024-09-22 17:17:29 NextHours_Sum03_PVforecast 2004 Wh
setstate Forecast 2024-09-22 17:17:29 NextHours_Sum04_ConsumptionForecast 3354 Wh
setstate Forecast 2024-09-22 17:17:29 NextHours_Sum04_PVforecast 2004 Wh
setstate Forecast 2024-09-22 17:17:29 RestOfDayConsumptionForecast 4994 Wh
setstate Forecast 2024-09-22 17:17:29 RestOfDayPVforecast 2004 Wh
setstate Forecast 2024-09-22 00:59:52 Today_Hour01_BatIn 0 Wh
setstate Forecast 2024-09-22 00:59:52 Today_Hour01_BatOut 523 Wh
setstate Forecast 2024-09-22 00:59:52 Today_Hour01_GridConsumption 1 Wh
setstate Forecast 2024-09-22 00:59:52 Today_Hour01_GridFeedIn 1 Wh
setstate Forecast 2024-09-09 00:59:53 Today_Hour01_PPreal01 0 Wh
setstate Forecast 2024-09-22 00:59:52 Today_Hour01_PVreal 0 Wh
setstate Forecast 2024-09-22 01:59:56 Today_Hour02_BatIn 0 Wh
setstate Forecast 2024-09-22 01:59:56 Today_Hour02_BatOut 501 Wh
setstate Forecast 2024-09-22 01:59:56 Today_Hour02_GridConsumption 1 Wh
setstate Forecast 2024-09-22 01:59:56 Today_Hour02_GridFeedIn 1 Wh
setstate Forecast 2024-09-09 01:59:55 Today_Hour02_PPreal01 0 Wh
setstate Forecast 2024-09-22 01:59:56 Today_Hour02_PVreal 0 Wh
setstate Forecast 2024-09-22 02:59:53 Today_Hour03_BatIn 0 Wh
setstate Forecast 2024-09-22 02:59:53 Today_Hour03_BatOut 509 Wh
setstate Forecast 2024-09-22 02:59:53 Today_Hour03_GridConsumption 2 Wh
setstate Forecast 2024-09-22 02:59:53 Today_Hour03_GridFeedIn 1 Wh
setstate Forecast 2024-09-09 02:59:58 Today_Hour03_PPreal01 0 Wh
setstate Forecast 2024-09-22 02:59:53 Today_Hour03_PVreal 0 Wh
setstate Forecast 2024-09-22 03:59:54 Today_Hour04_BatIn 0 Wh
setstate Forecast 2024-09-22 03:59:54 Today_Hour04_BatOut 499 Wh
setstate Forecast 2024-09-22 03:59:54 Today_Hour04_GridConsumption 1 Wh
setstate Forecast 2024-09-22 03:59:54 Today_Hour04_GridFeedIn 2 Wh
setstate Forecast 2024-09-09 03:59:51 Today_Hour04_PPreal01 0 Wh
setstate Forecast 2024-09-22 03:59:54 Today_Hour04_PVreal 0 Wh
setstate Forecast 2024-09-22 04:59:59 Today_Hour05_BatIn 0 Wh
setstate Forecast 2024-09-22 04:59:59 Today_Hour05_BatOut 511 Wh
setstate Forecast 2024-09-22 04:59:59 Today_Hour05_GridConsumption 1 Wh
setstate Forecast 2024-09-22 04:59:59 Today_Hour05_GridFeedIn 1 Wh
setstate Forecast 2024-09-09 04:59:54 Today_Hour05_PPreal01 0 Wh
setstate Forecast 2024-09-22 04:59:59 Today_Hour05_PVreal 0 Wh
setstate Forecast 2024-09-22 05:59:56 Today_Hour06_BatIn 18 Wh
setstate Forecast 2024-09-22 05:59:56 Today_Hour06_BatOut 526 Wh
setstate Forecast 2024-09-22 05:59:56 Today_Hour06_GridConsumption 3 Wh
setstate Forecast 2024-09-22 05:59:56 Today_Hour06_GridFeedIn 3 Wh
setstate Forecast 2024-09-09 05:59:54 Today_Hour06_PPreal01 0 Wh
setstate Forecast 2024-09-22 05:59:56 Today_Hour06_PVreal 0 Wh
setstate Forecast 2024-09-22 06:59:54 Today_Hour07_BatIn 195 Wh
setstate Forecast 2024-09-22 06:59:54 Today_Hour07_BatOut 737 Wh
setstate Forecast 2024-09-22 06:59:54 Today_Hour07_GridConsumption 2 Wh
setstate Forecast 2024-09-22 06:59:54 Today_Hour07_GridFeedIn 2 Wh
setstate Forecast 2024-09-09 06:59:52 Today_Hour07_PPreal01 0 Wh
setstate Forecast 2024-09-22 06:59:54 Today_Hour07_PVreal 0 Wh
setstate Forecast 2024-09-22 07:59:59 Today_Hour08_BatIn 297 Wh
setstate Forecast 2024-09-22 07:59:59 Today_Hour08_BatOut 811 Wh
setstate Forecast 2024-09-22 07:59:59 Today_Hour08_GridConsumption 2 Wh
setstate Forecast 2024-09-22 07:59:59 Today_Hour08_GridFeedIn 2 Wh
setstate Forecast 2024-09-09 07:59:52 Today_Hour08_PPreal01 0 Wh
setstate Forecast 2024-09-22 07:59:59 Today_Hour08_PVforecast 134 Wh
setstate Forecast 2024-09-22 07:59:59 Today_Hour08_PVreal 28 Wh
setstate Forecast 2024-09-22 08:59:54 Today_Hour09_BatIn 548 Wh
setstate Forecast 2024-09-22 08:59:54 Today_Hour09_BatOut 642 Wh
setstate Forecast 2024-09-22 08:59:54 Today_Hour09_GridConsumption 3 Wh
setstate Forecast 2024-09-22 08:59:54 Today_Hour09_GridFeedIn 2 Wh
setstate Forecast 2024-09-09 08:59:50 Today_Hour09_PPreal01 0 Wh
setstate Forecast 2024-09-22 08:59:54 Today_Hour09_PVforecast 1013 Wh
setstate Forecast 2024-09-22 08:59:54 Today_Hour09_PVreal 424 Wh
setstate Forecast 2024-09-22 09:59:51 Today_Hour10_BatIn 151 Wh
setstate Forecast 2024-09-22 09:59:51 Today_Hour10_BatOut 239 Wh
setstate Forecast 2024-09-22 09:59:51 Today_Hour10_GridConsumption 16 Wh
setstate Forecast 2024-09-22 09:59:51 Today_Hour10_GridFeedIn 17 Wh
setstate Forecast 2024-09-09 09:59:51 Today_Hour10_PPreal01 0 Wh
setstate Forecast 2024-09-22 09:59:51 Today_Hour10_PVforecast 1755 Wh
setstate Forecast 2024-09-22 09:59:51 Today_Hour10_PVreal 703 Wh
setstate Forecast 2024-09-22 10:59:55 Today_Hour11_BatIn 1304 Wh
setstate Forecast 2024-09-22 10:59:55 Today_Hour11_BatOut 0 Wh
setstate Forecast 2024-09-22 10:59:55 Today_Hour11_GridConsumption 7 Wh
setstate Forecast 2024-09-22 10:59:55 Today_Hour11_GridFeedIn 12 Wh
setstate Forecast 2024-09-09 10:59:54 Today_Hour11_PPreal01 0 Wh
setstate Forecast 2024-09-22 10:59:55 Today_Hour11_PVforecast 2611 Wh
setstate Forecast 2024-09-22 10:59:55 Today_Hour11_PVreal 1953 Wh
setstate Forecast 2024-09-22 11:59:54 Today_Hour12_BatIn 2335 Wh
setstate Forecast 2024-09-22 11:59:54 Today_Hour12_BatOut 0 Wh
setstate Forecast 2024-09-22 11:59:54 Today_Hour12_GridConsumption 3 Wh
setstate Forecast 2024-09-22 11:59:54 Today_Hour12_GridFeedIn 4 Wh
setstate Forecast 2024-09-09 11:59:54 Today_Hour12_PPreal01 0 Wh
setstate Forecast 2024-09-22 11:59:54 Today_Hour12_PVforecast 3196 Wh
setstate Forecast 2024-09-22 11:59:54 Today_Hour12_PVreal 3048 Wh
setstate Forecast 2024-09-22 12:59:55 Today_Hour13_BatIn 2869 Wh
setstate Forecast 2024-09-22 12:59:55 Today_Hour13_BatOut 0 Wh
setstate Forecast 2024-09-22 12:59:55 Today_Hour13_GridConsumption 3 Wh
setstate Forecast 2024-09-22 12:59:55 Today_Hour13_GridFeedIn 153 Wh
setstate Forecast 2024-09-09 12:59:53 Today_Hour13_PPreal01 0 Wh
setstate Forecast 2024-09-22 12:59:55 Today_Hour13_PVforecast 3841 Wh
setstate Forecast 2024-09-22 12:59:55 Today_Hour13_PVreal 3664 Wh
setstate Forecast 2024-09-22 13:59:51 Today_Hour14_BatIn 2315 Wh
setstate Forecast 2024-09-22 13:59:51 Today_Hour14_BatOut 0 Wh
setstate Forecast 2024-09-22 13:59:51 Today_Hour14_GridConsumption 0 Wh
setstate Forecast 2024-09-22 13:59:51 Today_Hour14_GridFeedIn 1190 Wh
setstate Forecast 2024-09-09 13:59:54 Today_Hour14_PPreal01 0 Wh
setstate Forecast 2024-09-22 13:59:51 Today_Hour14_PVforecast 5094 Wh
setstate Forecast 2024-09-22 13:59:51 Today_Hour14_PVreal 4139 Wh
setstate Forecast 2024-09-22 14:59:50 Today_Hour15_BatIn 519 Wh
setstate Forecast 2024-09-22 14:59:50 Today_Hour15_BatOut 0 Wh
setstate Forecast 2024-09-22 14:59:50 Today_Hour15_GridConsumption 0 Wh
setstate Forecast 2024-09-22 14:59:50 Today_Hour15_GridFeedIn 3106 Wh
setstate Forecast 2024-09-09 14:59:55 Today_Hour15_PPreal01 0 Wh
setstate Forecast 2024-09-22 14:59:50 Today_Hour15_PVforecast 4420 Wh
setstate Forecast 2024-09-22 14:59:50 Today_Hour15_PVreal 4221 Wh
setstate Forecast 2024-09-22 15:59:51 Today_Hour16_BatIn 57 Wh
setstate Forecast 2024-09-22 15:59:51 Today_Hour16_BatOut 0 Wh
setstate Forecast 2024-09-22 15:59:51 Today_Hour16_GridConsumption 0 Wh
setstate Forecast 2024-09-22 15:59:51 Today_Hour16_GridFeedIn 3478 Wh
setstate Forecast 2024-09-09 15:59:50 Today_Hour16_PPreal01 0 Wh
setstate Forecast 2024-09-22 15:59:51 Today_Hour16_PVforecast 3948 Wh
setstate Forecast 2024-09-22 15:59:51 Today_Hour16_PVreal 4206 Wh
setstate Forecast 2024-09-22 16:59:58 Today_Hour17_BatIn 0 Wh
setstate Forecast 2024-09-22 16:59:58 Today_Hour17_BatOut 0 Wh
setstate Forecast 2024-09-22 16:59:58 Today_Hour17_GridConsumption 0 Wh
setstate Forecast 2024-09-22 16:59:58 Today_Hour17_GridFeedIn 2785 Wh
setstate Forecast 2024-09-09 16:20:33 Today_Hour17_PPreal01 0 Wh
setstate Forecast 2024-09-22 16:59:58 Today_Hour17_PVforecast 2388 Wh
setstate Forecast 2024-09-22 16:59:58 Today_Hour17_PVreal 3424 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour18_BatIn 0 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour18_BatOut 0 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour18_GridConsumption 0 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour18_GridFeedIn 804 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour18_PVforecast 1741 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour18_PVreal 981 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour19_PVforecast 767 Wh
setstate Forecast 2024-09-22 17:17:29 Today_Hour20_PVforecast 19 Wh
setstate Forecast 2024-09-22 17:17:29 Today_MaxPVforecast 5094 Wh
setstate Forecast 2024-09-22 17:17:29 Today_MaxPVforecastTime 2024-09-22 13:00:00
setstate Forecast 2024-09-22 17:17:29 Today_PVdeviation 7.43 %
setstate Forecast 2024-09-22 17:17:29 Today_PVforecast 30927 Wh
setstate Forecast 2024-09-22 17:17:29 Today_PVreal 26791 Wh
setstate Forecast 2024-09-22 17:17:29 Today_SunRise 07:16
setstate Forecast 2024-09-22 17:17:29 Today_SunSet 19:24
setstate Forecast 2024-09-22 17:17:29 Tomorrow_ConsumptionForecast 17369 Wh
setstate Forecast 2024-09-22 17:17:29 Tomorrow_PVforecast 13260 Wh
setstate Forecast 2024-09-22 17:17:29 Tomorrow_SunRise 07:17
setstate Forecast 2024-09-22 17:17:29 Tomorrow_SunSet 19:22
setstate Forecast 2024-05-17 14:13:00 batteryTrigger 1on=30 1off=10 2on=70 2off=20 3on=15 4off=90 5on=87
setstate Forecast 2024-09-16 15:32:18 batteryTrigger_1 on
setstate Forecast 2024-09-17 15:35:05 batteryTrigger_2 on
setstate Forecast 2024-05-17 14:13:07 batteryTrigger_3 on
setstate Forecast 2024-05-17 14:13:07 batteryTrigger_4 off
setstate Forecast 2024-05-17 15:20:57 batteryTrigger_5 on
setstate Forecast 2024-09-22 17:17:29 consumer01 name='_Waschmaschine' state='on' mode='can' planningstate='planned'
setstate Forecast 2024-09-22 17:17:29 consumer01_currentPower 0 W
setstate Forecast 2024-09-22 17:17:29 consumer01_planned_start 22.09.2024 17:15:07
setstate Forecast 2024-09-22 17:17:29 consumer01_planned_stop 22.09.2024 19:15:07
setstate Forecast 2024-09-22 17:17:29 consumer02 name='_Esszimmer' state='off' mode='can' planningstate='planned'
setstate Forecast 2024-09-22 17:17:29 consumer02_currentPower 0 W
setstate Forecast 2024-09-22 17:17:29 consumer02_planned_start 22.09.2024 17:15:07
setstate Forecast 2024-09-22 17:17:29 consumer02_planned_stop 22.09.2024 18:15:07
setstate Forecast 2024-09-22 17:17:29 consumer03 name='_FCU' state='on' mode='can' planningstate='planned'
setstate Forecast 2024-09-22 17:17:29 consumer03_currentPower 8.36 W
setstate Forecast 2024-09-22 17:17:29 consumer03_planned_start 22.09.2024 17:15:07
setstate Forecast 2024-09-22 17:17:29 consumer03_planned_stop 22.09.2024 18:15:07
setstate Forecast 2024-09-22 17:17:29 consumer04 name='_Brunnen' state='on' mode='can' planningstate='planned'
setstate Forecast 2024-09-22 17:17:29 consumer04_currentPower 46.21 W
setstate Forecast 2024-09-22 17:17:29 consumer04_planned_start 22.09.2024 17:15:07
setstate Forecast 2024-09-22 17:17:29 consumer04_planned_stop 22.09.2024 18:15:07
setstate Forecast 2024-09-22 17:17:29 consumer05 name='_Zisterne' state='off' mode='can' planningstate='planned'
setstate Forecast 2024-09-22 17:17:29 consumer05_currentPower 0 W
setstate Forecast 2024-09-22 17:17:29 consumer05_planned_start 22.09.2024 17:15:07
setstate Forecast 2024-09-22 17:17:29 consumer05_planned_stop 22.09.2024 18:15:07
setstate Forecast 2024-09-22 17:17:29 consumer06 name='SW Trockner' state='on' mode='can' planningstate='planned'
setstate Forecast 2024-09-22 17:17:29 consumer06_currentPower 0 W
setstate Forecast 2024-09-22 17:17:29 consumer06_planned_start 22.09.2024 17:15:07
setstate Forecast 2024-09-22 17:17:29 consumer06_planned_stop 22.09.2024 18:45:07
setstate Forecast 2024-09-22 17:17:29 consumer07 name='SW Hobbyraum' state='unknown' mode='can' planningstate='noSchedule'
setstate Forecast 2024-09-22 17:17:29 consumer07_currentPower 0 W
setstate Forecast 2024-09-22 17:17:29 consumer08 name='SW Urlaubslicht-Wohnzimmer' state='off' mode='can' planningstate='noSchedule'
setstate Forecast 2024-09-22 17:17:29 consumer08_currentPower 0 W
setstate Forecast 2024-09-22 17:17:29 nextCycletime 17:17:39
setstate Forecast 2024-09-22 16:30:14 nextRadiationAPICall nach 22.09.2024 16:45:14
setstate Forecast 2024-09-22 08:00:05 pvCorrectionFactor_08 0.60 (automatic - old factor: 1, Sun Alt range: 0, Cloud range: 100, Days in range: 1)
setstate Forecast 2024-09-22 08:00:05 pvCorrectionFactor_08_autocalc done
setstate Forecast 2024-09-22 09:00:05 pvCorrectionFactor_09 0.71 (automatic - old factor: 1, Sun Alt range: 10, Cloud range: 95, Days in range: 1)
setstate Forecast 2024-09-22 09:00:05 pvCorrectionFactor_09_autocalc done
setstate Forecast 2024-09-22 10:00:02 pvCorrectionFactor_10 0.70 (automatic - old factor: 1, Sun Alt range: 20, Cloud range: 75, Days in range: 1)
setstate Forecast 2024-09-22 10:00:02 pvCorrectionFactor_10_autocalc done
setstate Forecast 2024-09-22 11:00:04 pvCorrectionFactor_11 0.88 (automatic - old factor: 1, Sun Alt range: 25, Cloud range: 45, Days in range: 1)
setstate Forecast 2024-09-22 11:00:04 pvCorrectionFactor_11_autocalc done
setstate Forecast 2024-09-22 12:00:05 pvCorrectionFactor_12 0.93 (automatic - old factor: 0.93, Sun Alt range: 35, Cloud range: 05, Days in range: 2)
setstate Forecast 2024-09-22 12:00:05 pvCorrectionFactor_12_autocalc done
setstate Forecast 2024-09-22 13:00:05 pvCorrectionFactor_13 0.97 (automatic - old factor: 1, Sun Alt range: 40, Cloud range: 05, Days in range: 1)
setstate Forecast 2024-09-22 13:00:05 pvCorrectionFactor_13_autocalc done
setstate Forecast 2024-09-22 14:00:02 pvCorrectionFactor_14 0.99 (automatic - old factor: 1, Sun Alt range: 40, Cloud range: 25, Days in range: 1)
setstate Forecast 2024-09-22 14:00:02 pvCorrectionFactor_14_autocalc done
setstate Forecast 2024-09-22 15:00:01 pvCorrectionFactor_15 1.00 (automatic - old factor: 1.02, Sun Alt range: 35, Cloud range: 10, Days in range: 2)
setstate Forecast 2024-09-22 15:00:01 pvCorrectionFactor_15_autocalc done
setstate Forecast 2024-09-22 16:00:02 pvCorrectionFactor_16 1.04 (automatic - old factor: 1, Sun Alt range: 30, Cloud range: 95, Days in range: 1)
setstate Forecast 2024-09-22 16:00:02 pvCorrectionFactor_16_autocalc done
setstate Forecast 2024-09-22 17:00:05 pvCorrectionFactor_17 1.08 (automatic - old factor: 1, Sun Alt range: 25, Cloud range: 100, Days in range: 1)
setstate Forecast 2024-09-22 17:00:05 pvCorrectionFactor_17_autocalc done
setstate Forecast 2024-09-22 17:17:29 pvCorrectionFactor_Auto on_complex_ai
setstate Forecast 2024-06-17 13:56:41 setupStringAzimuth GarageSE=SE GarageNW=NW HausNW=NW HausSW=SW
setstate Forecast 2024-06-17 13:56:41 setupStringDeclination GarageSE=35 GarageNW=35 HausNW=45 HausSW=45
setstate Forecast 2024-09-22 17:17:29 state running
setstate Forecast 2024-09-22 17:17:29 statistic_SunHours_Remain 2.11
setstate Forecast 2024-09-22 17:17:29 statistic_SunMinutes_Remain 127
setstate Forecast 2024-09-22 17:17:29 statistic_allStringsFullfilled 1
setstate Forecast 2024-09-22 17:17:29 statistic_conForecastTillNextSunrise 9133 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_currentAPIinterval 900
setstate Forecast 2024-09-22 17:17:29 statistic_currentRunMtsConsumer_01 0 min
setstate Forecast 2024-09-22 17:17:29 statistic_currentRunMtsConsumer_02 200 min
setstate Forecast 2024-09-22 17:17:29 statistic_currentRunMtsConsumer_03 166635 min
setstate Forecast 2024-09-22 17:17:29 statistic_currentRunMtsConsumer_04 618 min
setstate Forecast 2024-09-22 17:17:29 statistic_currentRunMtsConsumer_05 0 min
setstate Forecast 2024-09-22 17:17:29 statistic_dayAfterTomorrowPVforecast 15060 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_daysUntilBatteryCare 20
setstate Forecast 2024-09-22 17:17:29 statistic_lastretrieval_time 2024-09-22 17:15:28
setstate Forecast 2024-09-22 17:17:29 statistic_lastretrieval_timestamp 1727018128
setstate Forecast 2024-09-22 17:17:29 statistic_response_message Daily API request limit exceeded. Please try again tomorrow.
setstate Forecast 2024-09-22 17:17:29 statistic_runTimeCentralTask 0.2556
setstate Forecast 2024-09-22 17:17:29 statistic_runTimeLastAPIAnswer 1.3633
setstate Forecast 2024-09-22 17:17:29 statistic_runTimeLastAPIProc 0.4403
setstate Forecast 2024-09-22 17:17:29 statistic_runTimeTrainAI 1.0462
setstate Forecast 2024-09-22 17:17:29 statistic_todayBatIn 10640.0 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayBatOut 5503.0 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConForecastTillSunset 1644 Wh
setstate Forecast 2024-09-21 01:59:56 statistic_todayConsumptionForecast_02 411 Wh
setstate Forecast 2024-09-22 02:59:53 statistic_todayConsumptionForecast_03 409 Wh
setstate Forecast 2024-09-22 03:59:54 statistic_todayConsumptionForecast_04 418 Wh
setstate Forecast 2024-09-22 04:59:59 statistic_todayConsumptionForecast_05 421 Wh
setstate Forecast 2024-09-22 05:59:56 statistic_todayConsumptionForecast_06 413 Wh
setstate Forecast 2024-09-22 06:59:54 statistic_todayConsumptionForecast_07 428 Wh
setstate Forecast 2024-09-22 07:59:59 statistic_todayConsumptionForecast_08 468 Wh
setstate Forecast 2024-09-22 08:59:54 statistic_todayConsumptionForecast_09 614 Wh
setstate Forecast 2024-09-22 09:59:51 statistic_todayConsumptionForecast_10 723 Wh
setstate Forecast 2024-09-22 10:59:55 statistic_todayConsumptionForecast_11 633 Wh
setstate Forecast 2024-09-22 11:59:54 statistic_todayConsumptionForecast_12 750 Wh
setstate Forecast 2024-09-22 12:59:55 statistic_todayConsumptionForecast_13 997 Wh
setstate Forecast 2024-09-22 13:59:51 statistic_todayConsumptionForecast_14 1493 Wh
setstate Forecast 2024-09-22 14:59:50 statistic_todayConsumptionForecast_15 1222 Wh
setstate Forecast 2024-09-22 15:59:51 statistic_todayConsumptionForecast_16 1249 Wh
setstate Forecast 2024-09-22 16:59:58 statistic_todayConsumptionForecast_17 988 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_18 981 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_19 866 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_20 778 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_21 801 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_22 742 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_23 612 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayConsumptionForecast_24 509 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayDoneAPIcalls 59
setstate Forecast 2024-09-22 17:17:29 statistic_todayDoneAPIrequests 4720
setstate Forecast 2024-09-22 17:17:29 statistic_todayGridConsumption 45.8 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayGridFeedIn 11564.0 Wh
setstate Forecast 2024-09-22 17:17:29 statistic_todayMaxAPIcalls 50
setstate Forecast 2024-09-22 17:17:29 statistic_todayRemainingAPIcalls 50
setstate Forecast 2024-09-22 17:17:29 statistic_todayRemainingAPIrequests 4980
</syntaxhighlight>
So sollte es dann als Ergebnis aussehen:
[[Datei:SolarForecast Screenshot 2024-09.png|zentriert|mini|Ergebnis nach kompletter Einrichtung]]
== Praxisbeispiele und Lösungsansätze für Steuerungen ==

=== 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 ''ctrlInterval'') 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,  'statistic_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, 'statistic_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 Überschußenergie 
  $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 ''statistic_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 ''statistic_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 vorhandenenm 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, ein 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. 

== weiterführende Links ==
* {{Link2Forum|Topic=117864|LinkText=Forenthema zum Modul}}
* 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]]