SolarForecast FTUI Widget: Unterschied zwischen den Versionen

Aus FHEMWiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(10 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Das [[{{PAGENAME}}|SMAPortalSPG Widget]] ist ein Widget für [[FHEM Tablet UI]] zur graphischen Anzeige von SMAPortal-Daten im FHEM Tablet UI.
Das [[{{PAGENAME}}|SMAPortalSPG Widget]] ist ein Widget für [[FHEM Tablet UI V2]] zur grafischen Anzeige von SolarForecast-Daten im FHEM Tablet UI.


<gallery>
== Voraussetzungen ==
File:widget_smaportalspg.JPG
</gallery>


Voraussetzung ist das Vorhandensein von SMAPortal-Grafikdevices. Grafikdevices werden im existierenden SMAPortal FHEM-Device angelegt mit:
Voraussetzung ist die erfolgte FTUI2 Installation und die Definition eines [[SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung|SolarForecast]] Devices. <br>
Forum-Thread zum SolarForecast-Modul: https://forum.fhem.de/index.php/topic,117864.0.html


set <SMAPortal-Device> createPortalGraphic <Typ>
Ein SolarForecast-Device wird angelegt mit:


Das entstandene Device ist im Attribut "data-device" des Widgets einzutragen.
define <Name> SolarForecast  # z.B. define SolCast SolarForecast


== Installation ==
== Installation ==


Die Datei widget_smaportalspg.js muss in das js-Verzeichnis der fhem-tablet-ui Installation und die Datei ftui_smaportalspg.css in das entsprechende css-Verzeichnis kopiert werden.
Die FTUI Framework Dateien werden mit dem get-Kommando des SolarForecast Devices in die entsprechenden Verzeichnisse der FTUI-Installation geladen:


In FHEM kann der Befehl:
get <SolarForecast-Device> ftuiFramefiles
<pre>
 
  update all https://raw.githubusercontent.com/nasseeder1/fhem-ftui_smaportalspg_widget/master/controls_smaportalspg_widget.txt
In das Verzeichnis www/tablet/css werden kopiert:
</pre>
 
  * ftui_forecast.css
* ftui_smaportalspg.css
 
In das Verzeichnis www/tablet/js werden kopiert:
 
* widget_forecast.js
* widget_smaportalspg.js
 
 
== Das SMAPortalSPG Widget (ftui_smaportalspg) ==
[[Bild:Screenshot 2023-12-06 214207.png|right|thumb|200px|]]
Im SMAPortalSPG Widget wird anders als in anderen Widgets nicht der angegebene Wert aus dem Device dargestellt, sondern der HTML-Inhalt des angegebenen SolarForecast-Device. Das data-get Reading dient nur dazu ein nötiges Update des SolarForecast Devices zu erkennen. <br>
Dieses Widget stellt die Grafik des SolarForecast Devices so dar wie sie durch die Attribute des SolarForecast Devices eingestellt ist. Werden die darzustellenden Elemente der Grafik im SolarForecast Device geändert, wirkt sich dies auch auf den Widget-Content aus.
 
'''Hinweis:''' Im SolarForecast Device können mit dem Attribut ''graphicHeaderOwnspec'' set-Kommandos oder Attribut-Befehle im Anwender spezifischen Bereich des Headers abgebildet werden. Diese generierten Werte werden aus technischen Gründen generell im Widget ausgeblendet.


verwendet werden um die Dateien einmalig zu installieren. Sollen die Dateien in den regelmäßigen Update-Prozess mit eingebunden werden, kann das control-File in FHEM integriert werden:
<pre>
update add https://raw.githubusercontent.com/nasseeder1/fhem-ftui_smaportalspg_widget/master/controls_smaportalspg_widget.txt
</pre>


== Attribute ==
=== Attribute ===
{| class="wikitable"
{| class="wikitable"
!Attribut
!Attribut
Zeile 32: Zeile 42:
!Beispiel
!Beispiel
|-
|-
|'''data-device'''||SMAPortal-Graphicdevice in FHEM, dessen Inhalt angezeigt werden soll||||
|'''data-device'''||SolarForecast-Device in FHEM, dessen Inhalt angezeigt werden soll||||
|-
|-
|'''data-get'''||Name des Readings, das eine Änderung des SMAPortalSPG-Devices anzeigt||parentState||
|'''data-get'''||Name des Readings, das eine Änderung des SolarForecast-Device anzeigt||parentState||
|-
|-
|'''data-max-update'''||Maximale Häufigkeit in Sekunden für das Update des SMAPortalSPG-Devices||2||
|'''data-max-update'''||Maximale Häufigkeit in Sekunden für das Update des SolarForecast-Device||2||
|}
|}


== Hinweise ==
=== Beispiel ===
Im SMAPortalSPG Widget wird anders als in anderen Widgets nicht der angegebene Wert aus dem Device dargestellt, sondern der HTML-Inhalt des angegebenen SMAPortal-Grafikdevices. Das data-get Reading dient nur dazu ein nötiges Update des SMAPortal-Grafikdevices zu erkennen.
<pre>
    <li data-row="1" data-col="1" data-sizey="4" data-sizex="5">
    <header>Solar Vorhersage</header>
      <div class="cell">
        <div data-type="smaportalspg" data-device="SolCast" data-get="state"></div> 
      </div>
    </li>
</pre>
 
== Das Forecast Widget (ftui_forecast) ==
[[Bild:Screenshot 2023-12-06 223824.png|right|thumb|200px|]]
Im Forecast Widget wird der HTML-Inhalt des  
 
get <SolarFoecast-Device> html <Option>


Es ist immer ein Grafik-Device in FHEM mit SMAPortal zu erstellen und im Attribut "data-device" anzugeben, nicht das SMAPortal-Device selbst !
Kommandos des angegebenen SolarForecast-Device wiedergegeben. Das data-get Reading dient dazu ein nötiges Update des SolarForecast Devices zu erkennen. <br>
Mit diesem Widget kann die darzustellende Grafik im FTUI unabhängig von der Einstellung der Grafik im SolarForecast Device gewählt werden. Die Auswahl
erfolgt durch die Angabe in ''data-html''. Diese Angabe entspricht der '''Option''' im oben gezeigten get-Kommand.


== Beispiel ==
'''Hinweis:''' Im SolarForecast Device können mit dem Attribut ''graphicHeaderOwnspec'' set-Kommandos oder Attribut-Befehle im Anwender spezifischen Bereich des Headers abgebildet werden. Diese generierten Werte werden aus technischen Gründen generell im Widget ausgeblendet.


=== Attribute ===
{| class="wikitable"
!Attribut
!Beschreibung
!Standard-Wert
!Beispiel
|-
|'''data-device'''||SolarForecast-Device in FHEM, dessen Inhalt angezeigt werden soll||||
|-
|'''data-get'''||Name des Readings, das eine Änderung des SolarForecast-Device anzeigt||parentState||
|-
|'''data-html'''||die Option zur Auswahl des Grafik-Content <br>(siehe Hilfe zum get <SolarFoecast-Device> html Kommando)||both||both_noHead
|-
|'''data-max-update'''||Maximale Häufigkeit in Sekunden für das Update des SolarForecast-Device||2||
|}
=== Beispiel ===
<pre>
<pre>
     <li data-row="1" data-col="1" data-sizey="3" data-sizex="4">
     <li data-row="1" data-col="1" data-sizey="3" data-sizex="4">
    <header>SMA Grafik</header>
    <header>PV Forecast</header>
      <div class="cell">
          <div class="cell">
        <div data-type="smaportalspg" data-device="SPG1.Sonnenstrom" data-get="parentState" ></div>  
            <div data-type="forecast" data-device="ForecastDevice" data-get="state" data-html="both"></div>
      </div>
          </div>
     </li>  
     </li>
</pre>
</pre>




[[Kategorie:FHEM Tablet UI|SMAPortalSPG]]
[[Kategorie:FHEM Tablet UI V2|SolarForecast]]

Aktuelle Version vom 3. August 2024, 09:45 Uhr

Das SMAPortalSPG Widget ist ein Widget für FHEM Tablet UI V2 zur grafischen Anzeige von SolarForecast-Daten im FHEM Tablet UI.

Voraussetzungen

Voraussetzung ist die erfolgte FTUI2 Installation und die Definition eines SolarForecast Devices.
Forum-Thread zum SolarForecast-Modul: https://forum.fhem.de/index.php/topic,117864.0.html

Ein SolarForecast-Device wird angelegt mit:

define <Name> SolarForecast  # z.B. define SolCast SolarForecast

Installation

Die FTUI Framework Dateien werden mit dem get-Kommando des SolarForecast Devices in die entsprechenden Verzeichnisse der FTUI-Installation geladen:

get <SolarForecast-Device> ftuiFramefiles

In das Verzeichnis www/tablet/css werden kopiert:

* ftui_forecast.css
* ftui_smaportalspg.css

In das Verzeichnis www/tablet/js werden kopiert:

* widget_forecast.js
* widget_smaportalspg.js


Das SMAPortalSPG Widget (ftui_smaportalspg)

Screenshot 2023-12-06 214207.png

Im SMAPortalSPG Widget wird anders als in anderen Widgets nicht der angegebene Wert aus dem Device dargestellt, sondern der HTML-Inhalt des angegebenen SolarForecast-Device. Das data-get Reading dient nur dazu ein nötiges Update des SolarForecast Devices zu erkennen.
Dieses Widget stellt die Grafik des SolarForecast Devices so dar wie sie durch die Attribute des SolarForecast Devices eingestellt ist. Werden die darzustellenden Elemente der Grafik im SolarForecast Device geändert, wirkt sich dies auch auf den Widget-Content aus.

Hinweis: Im SolarForecast Device können mit dem Attribut graphicHeaderOwnspec set-Kommandos oder Attribut-Befehle im Anwender spezifischen Bereich des Headers abgebildet werden. Diese generierten Werte werden aus technischen Gründen generell im Widget ausgeblendet.


Attribute

Attribut Beschreibung Standard-Wert Beispiel
data-device SolarForecast-Device in FHEM, dessen Inhalt angezeigt werden soll
data-get Name des Readings, das eine Änderung des SolarForecast-Device anzeigt parentState
data-max-update Maximale Häufigkeit in Sekunden für das Update des SolarForecast-Device 2

Beispiel

    <li data-row="1" data-col="1" data-sizey="4" data-sizex="5">
     <header>Solar Vorhersage</header>
       <div class="cell">
         <div data-type="smaportalspg" data-device="SolCast" data-get="state"></div>  
      </div>
    </li> 

Das Forecast Widget (ftui_forecast)

Screenshot 2023-12-06 223824.png

Im Forecast Widget wird der HTML-Inhalt des

get <SolarFoecast-Device> html <Option> 

Kommandos des angegebenen SolarForecast-Device wiedergegeben. Das data-get Reading dient dazu ein nötiges Update des SolarForecast Devices zu erkennen.
Mit diesem Widget kann die darzustellende Grafik im FTUI unabhängig von der Einstellung der Grafik im SolarForecast Device gewählt werden. Die Auswahl erfolgt durch die Angabe in data-html. Diese Angabe entspricht der Option im oben gezeigten get-Kommand.

Hinweis: Im SolarForecast Device können mit dem Attribut graphicHeaderOwnspec set-Kommandos oder Attribut-Befehle im Anwender spezifischen Bereich des Headers abgebildet werden. Diese generierten Werte werden aus technischen Gründen generell im Widget ausgeblendet.


Attribute

Attribut Beschreibung Standard-Wert Beispiel
data-device SolarForecast-Device in FHEM, dessen Inhalt angezeigt werden soll
data-get Name des Readings, das eine Änderung des SolarForecast-Device anzeigt parentState
data-html die Option zur Auswahl des Grafik-Content
(siehe Hilfe zum get <SolarFoecast-Device> html Kommando)
both both_noHead
data-max-update Maximale Häufigkeit in Sekunden für das Update des SolarForecast-Device 2

Beispiel

    <li data-row="1" data-col="1" data-sizey="3" data-sizex="4">
    <header>PV Forecast</header>
          <div class="cell">
             <div data-type="forecast" data-device="ForecastDevice" data-get="state" data-html="both"></div>
          </div>
    </li>