YAF: Unterschied zwischen den Versionen

Aus FHEMWiki
K (→‎Installation mit FHEM Update: ->veralteten Hinweis auf Modul-Datei im Forum entfernt -> korrigierte Fassung ist im svn)
 
(33 dazwischenliegende Versionen von 8 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Infobox Modul
|ModPurpose=Alternative zum FLOORPLAN-Modul
|ModType=x
|ModFTopic=12629
|ModForumArea=Frontends
|ModTechName=01_YAF.pm
|ModOwner=danielweisensee
}}


= Projekt YAF =
[[YAF]] ist ein Floorplan, der es erlaubt, Geräte per Drag&Drop zu platzieren.


YAF entstand als Projektarbeit von Daniel Weisensee und Markus Mangei an der Hochschule
[[Datei:YAF_Beispielansicht.png|600px|thumb|right|YAF mit mehreren Widgets]]
Karlsruhe Technik
und Wirtschaft.


Es steht für “Yet Another Floorplan” und soll eine Alternative
== Projekt YAF ==
zum bisher vorhandenen Floorplan bieten. YAF basiert auf ClientSeite
YAF entstand als Projektarbeit von Daniel Weisensee und Markus Mangei an der Hochschule Karlsruhe Technik und Wirtschaft.  
aus den JavaScript
Frameworks JQuery und JQuery UI, serverseitig werden die CPAN Module <strike>XML::LibXML (bindet
libxml2 an Perl an) und</strike> JSON::XS verwendet, um die Konfiguration zu persisitieren und um
Daten zwischen der Oberfläche und dem Server austauschen zu können.


Durch die Erweiterbarkeit von Widgets soll YAF flexibel gehalten werden. Mit Hilfe dieser
Es steht für “Yet Another Floorplan” und soll eine Alternative zum bisher vorhandenen [[FLOORPLAN|Floorplan]]-Modul bieten. YAF basiert auf Clientseite auf den JavaScript Frameworks JQuery und JQuery UI, <strike>serverseitig werden die CPAN Module XML::LibXML (bindet libxml2 an Perl an) und JSON::XS verwendet,</strike> um die Konfiguration zu persistieren und um Daten zwischen der Oberfläche und dem Server austauschen wird die FHEM Konfiguration sowie eine Webschnittstelle verwendet.
Schnittstelle können problemlos Widgets von verschiedenen Entwicklern veröffentlicht werden,
ohne dass sich diese über gewünschte Änderungen am YAF Code mit der Community
abstimmen müssen. Es soll ähnlich dem Prinzip der Widgets unter Android oder Windows
funktionieren. Widgets sollen speziell für FHEM Plugins geschrieben werden, um somit
möglichst komfortable Oberflächen bieten zu können.


Durch die Erweiterbarkeit von Widgets soll YAF flexibel gehalten werden. Mit Hilfe dieser Schnittstelle können problemlos Widgets von verschiedenen Entwicklern veröffentlicht werden, ohne dass sich diese über gewünschte Änderungen am YAF Code mit der Community abstimmen müssen. Es soll ähnlich dem Prinzip der Widgets unter Android oder Windows funktionieren. Widgets sollen speziell für FHEM Plugins geschrieben werden, um somit möglichst komfortable Oberflächen bieten zu können.


* Das Projekt ist freie Software unter der GNU General Public License und befindet sich auf dem offiziellen FHEM SourceForge.net Repository:
* Das Projekt ist freie Software unter der GNU General Public License und befindet sich auf dem offiziellen FHEM SVN Repository: https://svn.fhem.de/trac/browser/trunk/fhem/contrib/YAF/
https://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/YAF/


* Im FHEM Forum gibt es einen Thread mit dem Titel “Yet Another Floorplan YAF”:
* Im FHEM Forum gibt es einen Thread mit dem Titel {{Link2Forum|Topic=12629|LinkText=Yet Another Floorplan YAF}}
http://forum.fhem.de/index.php?t=msg&th=12629&start=0&rid=0


[[Kategorie:FHEM Frontends]]
== Installation==
=== Installation mit FHEM Update ===
<pre>update all https://svn.fhem.de/fhem/trunk/fhem/contrib/YAF/controls_yaf.txt</pre>
 
== Konfiguration ==
 
YAF wird durch die folgende Definition aktivert:
 
define yaf YAF
 
Die weitere Konfiguration kann beinahe komplett über das YAF Interface erfolgen, welches von nun an über die Weboberfläche von FHEM erreichbar ist. Einzig Hintergrundgrafiken können bisher noch nicht über das YAF Interface verwaltet oder eingetragen werden.
 
Gespeichert wird die Konfiguration in den Attributen des YAF Device:
attr yaf backgrounds 1,1,1,/path/to/local/image;;2,1,1,http://path.to/remote/image.png
attr yaf refresh_interval 10
attr yaf views 1,Haus;;2,Test
 
Legt man die neue Ansicht (view) über die fhem.cfg an, ist es wichtig, diese als benutzerdefiniertes Attribut in FHEM zu konfigurieren. Dazu pro Ansicht ein yaf_x anhängen, wobei x=[Nummer der Ansicht]. Ansonsten verschwinden angelegte Widgets nach einem erneuten Aufruf von YAF und im Log wird eine Fehlermeldung ausgegeben, dass das Attribut yaf_x ungültig sei. Für zwei Ansichten, wie in der Konfiguration hier, sieht die Zeile beispielsweise so aus:
attr global userattr devStateIcon devStateStyle icon sortby webCmd yaf_1 yaf_2
 
== Widgets ==
Ein Widget ist die Darstellung eines Gerätes (Device) auf dem Floorplan. Die Konfiguration des Widget wird im Device unter der Eigenschaft <code>yaf_#</code> gespeichert, wobei <code>#</code> die Nummer des YAF-View ist, in der das Widget angezeigt wird.
 
Beispiel:
attr somedevice yaf_1 id=3,fhemname=somedevice,x_pos=432,y_pos=205,name=fhttk,
 
=== fhttk ===
 
Zur Anzeige von [[FHT80TF|FHTTK  Fenstersensoren]].
 
==== Beispiel ====
 
define CUL_FHTTK_xxxxxx CUL_FHTTK xxxxxx
attr CUL_FHTTK_xxxxxx devStateIcon Closed:signal_Fenster_Offen.off Open:signal_Fenster_Offen.on
attr CUL_FHTTK_xxxxxx yaf_2 id=10,showlabel=0,fhemname=CUL_FHTTK_xxxxxx,y_pos=410,x_pos=379,name=fhttk,showicon=1,
 
=== fs20st ===
 
=== fs20easylamp ===
 
=== generic ===
Erlaubt das Einfügen beliebiger Geräte im Plan.
 
==== Beispiele ====
Die Widgets im Beispielplan auf dieser Seite sind "generic"-Widgets (Bis auf die FHT80-Heizungsanzeigen).
 
'''Anzeige eines [[FS20_ST_Steckdosenfunkschalter|FS20 Steckdosenschalters]] mit Schaltfunktion im Plan'''
define FS20_xxxxyy FS20 xxxx yy
attr FS20_xxxxyy alias Testlampe
attr FS20_xxxxyy devStateIcon on:FS20.on off:FS20.off toggle:toggle
attr FS20_xxxxyy yaf_2 id=12,name=generic,showicon=1,fhemname=FS20_xxxxyy,showlabel=1,y_pos=209,x_pos=403,labeltype=alias,_on=off,_off=on
 
'''Anzeige der Ist-Temperatur einer [[FHT80b|FHT80 Heizungssteuerung]] mit dem Inhalt des "comment" Felds als Label'''
define FHT_xxxx FHT xxxx
attr FHT_xxxx comment Eltern
attr FHT_xxxx yaf_2 id=14,name=generic,fhemname=FHT_xxxx,showlabel=1,x_pos=415,y_pos=431,labeltype=comment,statetype=measured-temp,
 
'''Anzeige eines [[FHT80TF|FHTTK  Fenstersensors]]'''
define CUL_FHTTK_xyz CUL_FHTTK xyz
attr CUL_FHTTK_xyz devStateIcon Closed:signal_Fenster_Offen.off Open:signal_Fenster_Offen.on
attr CUL_FHTTK_xyz yaf_2 id=4,fhemname=CUL_FHTTK_xyz,x_pos=27,y_pos=261,name=generic,showlabel=0
 
'''Präsenzanzeige eines Handies im WLAN mit [[PRESENCE]]'''
define presence_android PRESENCE lan-ping 10.1.2.3
attr presence_android devStateIcon present:WLAN_Status.1 absent:WLAN_Status.0
attr presence_android yaf_2 id=1,fhemname=presence_android,showlabel=0,y_pos=266,x_pos=46,name=generic,showicon=1,labeltype=alias,
 
'''Anzeige eines Homematic [[HM-Sec-WDS Funk-Wassermelder]]'''
define CUL_HM_HM_SEC_WDS_xyz CUL_HM xyz
attr CUL_HM_HM_SEC_WDS_xyz alias WassermelderHeizung
attr CUL_HM_HM_SEC_WDS_xyz devStateIcon dry:wasseralarm wet:wasseralarm_rot damp:wasseralarm_rot
attr CUL_HM_HM_SEC_WDS_xyz yaf_2 id=5,fhemname=CUL_HM_HM_SEC_WDS_xyz,x_pos=324,y_pos=139,name=generic,labeltype=alias,
 
==== Parameter ====
{|
|<code>id</code>
|interne ID des Widgets, immer der erste Parameter
|-
|<code>fhemname</code>
|interner Name des Geräte im FHEM
|-
|<code>x_pos</code>
|X-Koordinate des Widget
|-
|<code>y_pos</code>
|Y-Koordinate des Widget
|-
|<code>name</code>
|Typ des Widgets
|-
|<code>labeltype</code>
|Welcher Eigenschaftswert soll als Label angezeigt werden?
|-
|<code>statetype</code>
|Welches Reading soll als Wert angezeigt werden?
|-
|<code>showlabel</code>
|Soll das Label angezeigt werden? (1/0)
|-
|<code>showicon</code>
|Soll das devStateIcon angezeigt werden? (1/0)
|}
 
==== Schaltfunktion ====
Mit zusätzlichen Parametern kann eine Schaltfunktion konfiguriert werden, womit im Plan durch Klicken auf das Widget eine Aktion des Gerätes durchgeführt werden kann.
 
Beispiel:
_on=off,_off=on
Im Beispiel wird nach dem Klick auf das Widget der aktuelle Status des Gerätes geprüft. Ist der Status "on", wird der "off" Befehl gesendet. Ist der Status "off", wird der "on" Befehl gesendet. Zwischen dem Unterstrich "_" und dem Gleichheitszeichen (=) können zur Definition des Status reguläre Ausdrücke verwendet werden.


=Installation=
=== fht80 ===
==Installation mit FHEM Update==
Zeigt Informationen über eine [[FHT80b|FHT80]] Heizungssteuerung an.
<pre>update thirdparty http://svn.code.sf.net/p/fhem/code/trunk/fhem/contrib/YAF/ yaf</pre>
== Voraussetzungen ==
=== <strike>XML::LibXML auf einer Synology</strike> ===
In der aktuellen Version nutzt YAF die FHEM Konfiguration, LibXML ist nicht mehr notwendig.
JSON::XS ist notwendig.


<strike>
YAF benötigt (neben anderen Modulen, siehe HOWTO im SVN), das PERL Modul XML::LibXML.


Dies kann einen fast zur Verzweiflung bringen, da das Modul weder mit CPAN noch manuell kompilieren möchte.
==== Aussehen des Widgets ====
Das Problem ist, das "perl Makefile.PL" sich weigert, den Makefile zu erstellen.
----
Die wenig elegante, aber funktionierende Lösung ist, den entsprechenden Code aus der Datei Makefile.PL zu entfernen:


<pre>
<div aria-disabled="true" style="text-align:center"><span class="widget_fht80_alias" style="font-size: 1.2em;">Heizung&nbsp;Kinderzimmer</span><br><span title="2013-09-08 11:32:11">22.9</span> °C <span title="auto">⊗</span> <span title="Actuator: 0%">16.0 °C</span></div>


print "Checking for ability to link against xml2...";
----
#if ( _libxml_check_lib('xml2') ) {
Links: Ist-Temperatur (Tooltip: Timestamp des Readings)
#    print "yes\n";
Mitte: Automatischer Modus (⊗) oder manueller Modus (⊕)
#}
  Rechts: Zieltemperatur (Tooltip: Öffnungsgrad des Stellmotors)
#else {
#    print "no\n";
#    print "Checking for ability to link against libxml2...";
#    if ( _libxml_check_lib('libxml2')) {
#        print "yes\n";
#    }
#    else {
#        print STDERR <<"DEATH";
#libxml2, zlib, and/or the Math library (-lm) have not been found.
#Try setting LIBS and INC values on the command line
#Or get libxml2 from
# http://xmlsoft.org/
#If you install via RPMs, make sure you also install the -devel
#RPMs, as this is where the headers (.h files) are.
#
#Also, you may try to run perl Makefile.PL with the DEBUG=1 parameter
#to see the exact reason why the detection of libxml2 installation
#failed or why Makefile.PL was not able to compile a test program.
#DEATH
#        exit 0; # 0 recommended by http://cpantest.grango.org (Notes for CPAN Authors)
#    }
#}


# -------------------------------------------------------------------------- #
Die Konfiguration unterstützt nicht alle Parameter über das YAF Interface, einige müssen über FHEMWeb gesetzt werden.
# _NOW_ write the Makefile
</pre>


danach:
==== Beispiele ====
<pre>
attr FHT_abcd yaf_1 id=14,fhemname=FHT_abcd,y_pos=235,x_pos=239,name=fht80,labeltype=Alias,
perl Makefile.PL
attr FHT_wxyz yaf_1 id=4,fhemname=FHT_wxyz,y_pos=241,x_pos=434,name=fht80,labeltype=Alias,size=0.8,
make
attr FHT_lmno yaf_1 id=10,fhemname=FHT_lmno,nomode=1,y_pos=183,x_pos=533,name=fht80,labeltype=Comment,size=0.7,
make install
</pre>
</strike>


= Konfiguration =
==== Parameter ====


YAF wird durch die folgende Definition aktivert:
{|
|<code>id</code>
|interne ID des Widgets, immer der erste Parameter
|-
|<code>fhemname</code>
|interner Name des Geräte im FHEM
|-
|<code>x_pos</code>
|X-Koordinate des Widget
|-
|<code>y_pos</code>
|Y-Koordinate des Widget
|-
|<code>name</code>
|Typ des Widgets
|-
|<code>labeltype</code>
|Welcher Eigenschaftswert soll als Label angezeigt werden?
|-
|<code>nomode</code>
|Ausblenden der Modusanzeige
|-
|<code>size</code>
|Relative Textgröße
|}


define yaf YAF
=== webcam ===


Die weitere Konfiguration kann komplett über das YAF Interface erfolgen, außer das Setzen des Hintergrundbildes.
Blendet ein Webcambild im Floorplan ein, basierend auf einem [http://fhem.de/commandref.html#dummy dummy] oder [[PRESENCE]] Device.
Der Pfad zum Hintergrundbild muss im Attribut <code>backgrounds</code> definiert werden.


attr yaf backgrounds 1,1,1,/path/to/image;;2,1,1,/path/to/another/image.jpg
Das Widget kann aktuell nur über FHEMWeb konfiguriert werden.
attr yaf refresh_interval 10
attr yaf views 1,Haus;;2,Test


= Widgets =
==== Beispiel ====
'''Anzeige des statischen Bildes einer Webcam, deren Status per PRESENCE ping überprüft wird'''
define webcam PRESENCE lan-ping 10.x.y.z
attr webcam yaf_2 id=15,fhemname=webcam,showmethod=img,x_pos=224,y_pos=88,name=webcam,path=/image.jpg,hover=0,user=username,pass=password


== fhttk ==
Die Definition führt zur Anzeige des Bildes unter <nowiki>http://username:password@10.x.y.z/image.jpg</nowiki>


== fs20st ==
Bei Einsatz eines Dummy device muss im yaf-Attribut zusätzlich der Parameter "address" gesetzt werden.


== fs20easylamp ==
==== Parameter ====
{|
|<code>id</code>
|interne ID des Widgets, immer der erste Parameter
|-
|<code>fhemname</code>
|interner Name des Geräte im FHEM
|-
|<code>x_pos</code>
|X-Koordinate des Widget
|-
|<code>y_pos</code>
|Y-Koordinate des Widget
|-
|<code>name</code>
|Typ des Widgets
|-
|<code>showmethod</code>
|Welche Anzeigemethode soll verwendet werden.<br />Zur Zeit implementiert: <code>img</code> (Anzeige mit dem HTML <code>img</code> Tag)
|-
|<code>path</code>
|absoluter Pfad zur anzuzeigenden Ressource
|-
|<code>hover</code>
|''reserviert''
|-
|<code>user</code>
|Benutzername
|-
|<code>pass</code>
|Passwort<br />'''Achtung! Passwort wird im Klartext gespeichert!'''
|-
|<code>address</code>
|Hostname (nur bei Dummy Device notwendig)
|-
|<code>proto</code>
|Protokoll. Standard: <code>http</code>
|}


== generic ==
== Links ==
* {{Link2Forum|Topic=31999|Message=261064|LinkText=Anleitung zum Schnelleinstieg in YAF}}


== fht80 ==
[[Kategorie:FHEM Frontends]]

Aktuelle Version vom 19. März 2018, 22:04 Uhr

YAF
Zweck / Funktion
Alternative zum FLOORPLAN-Modul
Allgemein
Typ Inoffiziell
Details
Dokumentation Thema
Support (Forum) Frontends
Modulname 01_YAF.pm
Ersteller danielweisensee
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


YAF ist ein Floorplan, der es erlaubt, Geräte per Drag&Drop zu platzieren.

YAF mit mehreren Widgets

Projekt YAF

YAF entstand als Projektarbeit von Daniel Weisensee und Markus Mangei an der Hochschule Karlsruhe Technik und Wirtschaft.

Es steht für “Yet Another Floorplan” und soll eine Alternative zum bisher vorhandenen Floorplan-Modul bieten. YAF basiert auf Clientseite auf den JavaScript Frameworks JQuery und JQuery UI, serverseitig werden die CPAN Module XML::LibXML (bindet libxml2 an Perl an) und JSON::XS verwendet, um die Konfiguration zu persistieren und um Daten zwischen der Oberfläche und dem Server austauschen wird die FHEM Konfiguration sowie eine Webschnittstelle verwendet.

Durch die Erweiterbarkeit von Widgets soll YAF flexibel gehalten werden. Mit Hilfe dieser Schnittstelle können problemlos Widgets von verschiedenen Entwicklern veröffentlicht werden, ohne dass sich diese über gewünschte Änderungen am YAF Code mit der Community abstimmen müssen. Es soll ähnlich dem Prinzip der Widgets unter Android oder Windows funktionieren. Widgets sollen speziell für FHEM Plugins geschrieben werden, um somit möglichst komfortable Oberflächen bieten zu können.

Installation

Installation mit FHEM Update

update all https://svn.fhem.de/fhem/trunk/fhem/contrib/YAF/controls_yaf.txt

Konfiguration

YAF wird durch die folgende Definition aktivert: 

define yaf YAF

Die weitere Konfiguration kann beinahe komplett über das YAF Interface erfolgen, welches von nun an über die Weboberfläche von FHEM erreichbar ist. Einzig Hintergrundgrafiken können bisher noch nicht über das YAF Interface verwaltet oder eingetragen werden.

Gespeichert wird die Konfiguration in den Attributen des YAF Device: 

attr yaf backgrounds 1,1,1,/path/to/local/image;;2,1,1,http://path.to/remote/image.png
attr yaf refresh_interval 10
attr yaf views 1,Haus;;2,Test

Legt man die neue Ansicht (view) über die fhem.cfg an, ist es wichtig, diese als benutzerdefiniertes Attribut in FHEM zu konfigurieren. Dazu pro Ansicht ein yaf_x anhängen, wobei x=[Nummer der Ansicht]. Ansonsten verschwinden angelegte Widgets nach einem erneuten Aufruf von YAF und im Log wird eine Fehlermeldung ausgegeben, dass das Attribut yaf_x ungültig sei. Für zwei Ansichten, wie in der Konfiguration hier, sieht die Zeile beispielsweise so aus: 

attr global userattr devStateIcon devStateStyle icon sortby webCmd yaf_1 yaf_2

Widgets

Ein Widget ist die Darstellung eines Gerätes (Device) auf dem Floorplan. Die Konfiguration des Widget wird im Device unter der Eigenschaft yaf_# gespeichert, wobei # die Nummer des YAF-View ist, in der das Widget angezeigt wird.

Beispiel: 

attr somedevice yaf_1 id=3,fhemname=somedevice,x_pos=432,y_pos=205,name=fhttk,

fhttk

Zur Anzeige von FHTTK Fenstersensoren.

Beispiel

define CUL_FHTTK_xxxxxx CUL_FHTTK xxxxxx
attr CUL_FHTTK_xxxxxx devStateIcon Closed:signal_Fenster_Offen.off Open:signal_Fenster_Offen.on
attr CUL_FHTTK_xxxxxx yaf_2 id=10,showlabel=0,fhemname=CUL_FHTTK_xxxxxx,y_pos=410,x_pos=379,name=fhttk,showicon=1,

fs20st

fs20easylamp

generic

Erlaubt das Einfügen beliebiger Geräte im Plan.

Beispiele

Die Widgets im Beispielplan auf dieser Seite sind "generic"-Widgets (Bis auf die FHT80-Heizungsanzeigen).

Anzeige eines FS20 Steckdosenschalters mit Schaltfunktion im Plan 

define FS20_xxxxyy FS20 xxxx yy
attr FS20_xxxxyy alias Testlampe
attr FS20_xxxxyy devStateIcon on:FS20.on off:FS20.off toggle:toggle
attr FS20_xxxxyy yaf_2 id=12,name=generic,showicon=1,fhemname=FS20_xxxxyy,showlabel=1,y_pos=209,x_pos=403,labeltype=alias,_on=off,_off=on

Anzeige der Ist-Temperatur einer FHT80 Heizungssteuerung mit dem Inhalt des "comment" Felds als Label 

define FHT_xxxx FHT xxxx
attr FHT_xxxx comment Eltern
attr FHT_xxxx yaf_2 id=14,name=generic,fhemname=FHT_xxxx,showlabel=1,x_pos=415,y_pos=431,labeltype=comment,statetype=measured-temp,

Anzeige eines FHTTK Fenstersensors 

define CUL_FHTTK_xyz CUL_FHTTK xyz
attr CUL_FHTTK_xyz devStateIcon Closed:signal_Fenster_Offen.off Open:signal_Fenster_Offen.on
attr CUL_FHTTK_xyz yaf_2 id=4,fhemname=CUL_FHTTK_xyz,x_pos=27,y_pos=261,name=generic,showlabel=0

Präsenzanzeige eines Handies im WLAN mit PRESENCE 

define presence_android PRESENCE lan-ping 10.1.2.3
attr presence_android devStateIcon present:WLAN_Status.1 absent:WLAN_Status.0
attr presence_android yaf_2 id=1,fhemname=presence_android,showlabel=0,y_pos=266,x_pos=46,name=generic,showicon=1,labeltype=alias,

Anzeige eines Homematic HM-Sec-WDS Funk-Wassermelder 

define CUL_HM_HM_SEC_WDS_xyz CUL_HM xyz
attr CUL_HM_HM_SEC_WDS_xyz alias WassermelderHeizung
attr CUL_HM_HM_SEC_WDS_xyz devStateIcon dry:wasseralarm wet:wasseralarm_rot damp:wasseralarm_rot
attr CUL_HM_HM_SEC_WDS_xyz yaf_2 id=5,fhemname=CUL_HM_HM_SEC_WDS_xyz,x_pos=324,y_pos=139,name=generic,labeltype=alias,

Parameter

id interne ID des Widgets, immer der erste Parameter
fhemname interner Name des Geräte im FHEM
x_pos X-Koordinate des Widget
y_pos Y-Koordinate des Widget
name Typ des Widgets
labeltype Welcher Eigenschaftswert soll als Label angezeigt werden?
statetype Welches Reading soll als Wert angezeigt werden?
showlabel Soll das Label angezeigt werden? (1/0)
showicon Soll das devStateIcon angezeigt werden? (1/0)

Schaltfunktion

Mit zusätzlichen Parametern kann eine Schaltfunktion konfiguriert werden, womit im Plan durch Klicken auf das Widget eine Aktion des Gerätes durchgeführt werden kann.

Beispiel: 

_on=off,_off=on

Im Beispiel wird nach dem Klick auf das Widget der aktuelle Status des Gerätes geprüft. Ist der Status "on", wird der "off" Befehl gesendet. Ist der Status "off", wird der "on" Befehl gesendet. Zwischen dem Unterstrich "_" und dem Gleichheitszeichen (=) können zur Definition des Status reguläre Ausdrücke verwendet werden.

fht80

Zeigt Informationen über eine FHT80 Heizungssteuerung an.


Aussehen des Widgets

Heizung Kinderzimmer
22.9 °C ⊗ 16.0 °C
Links: Ist-Temperatur (Tooltip: Timestamp des Readings)
Mitte: Automatischer Modus (⊗) oder manueller Modus (⊕)
Rechts: Zieltemperatur (Tooltip: Öffnungsgrad des Stellmotors)

Die Konfiguration unterstützt nicht alle Parameter über das YAF Interface, einige müssen über FHEMWeb gesetzt werden.

Beispiele

attr FHT_abcd yaf_1 id=14,fhemname=FHT_abcd,y_pos=235,x_pos=239,name=fht80,labeltype=Alias,
attr FHT_wxyz yaf_1 id=4,fhemname=FHT_wxyz,y_pos=241,x_pos=434,name=fht80,labeltype=Alias,size=0.8,
attr FHT_lmno yaf_1 id=10,fhemname=FHT_lmno,nomode=1,y_pos=183,x_pos=533,name=fht80,labeltype=Comment,size=0.7,

Parameter

id interne ID des Widgets, immer der erste Parameter
fhemname interner Name des Geräte im FHEM
x_pos X-Koordinate des Widget
y_pos Y-Koordinate des Widget
name Typ des Widgets
labeltype Welcher Eigenschaftswert soll als Label angezeigt werden?
nomode Ausblenden der Modusanzeige
size Relative Textgröße

webcam

Blendet ein Webcambild im Floorplan ein, basierend auf einem dummy oder PRESENCE Device.

Das Widget kann aktuell nur über FHEMWeb konfiguriert werden.

Beispiel

Anzeige des statischen Bildes einer Webcam, deren Status per PRESENCE ping überprüft wird 

define webcam PRESENCE lan-ping 10.x.y.z
attr webcam yaf_2 id=15,fhemname=webcam,showmethod=img,x_pos=224,y_pos=88,name=webcam,path=/image.jpg,hover=0,user=username,pass=password

Die Definition führt zur Anzeige des Bildes unter http://username:password@10.x.y.z/image.jpg

Bei Einsatz eines Dummy device muss im yaf-Attribut zusätzlich der Parameter "address" gesetzt werden.

Parameter

id interne ID des Widgets, immer der erste Parameter
fhemname interner Name des Geräte im FHEM
x_pos X-Koordinate des Widget
y_pos Y-Koordinate des Widget
name Typ des Widgets
showmethod Welche Anzeigemethode soll verwendet werden.
Zur Zeit implementiert: img (Anzeige mit dem HTML img Tag)
path absoluter Pfad zur anzuzeigenden Ressource
hover reserviert
user Benutzername
pass Passwort
Achtung! Passwort wird im Klartext gespeichert!
address Hostname (nur bei Dummy Device notwendig)
proto Protokoll. Standard: http

Links

Abgerufen von „http://wiki.fhem.de/w/index.php?title=YAF&oldid=26106“