FHEM Tablet UI

FHEM Tablet UI

FHEM Tablet UI ist ein leichtgewichtiges aber funktionsreiches Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Zahlreiche Widgets können sehr flexibel und leicht per HTML Code konfiguriert werden.

In dieser Anleitung wird die Installation und Konfiguration des FHEM Tablet UI beschrieben. Beitrag im FHEM-Forum: http://forum.fhem.de/index.php/topic,34233.0.html

Todo: alle Widgets hier übernehmen, Übersetzung, weitere Beispiele aus dem Forum einfügen (evtl. mit Link!?)

Voraussetzungen

Dieses User Interface für Tablets benötigt keine zusätzliche Frameworks, wie PHP, MySQL oder SmartVisu.

Voraussetzungen ist nur ein Standard-FHEM mit HTTPSRV Modul und ein beliebiger Standard-Browser mit Javascript auf einem beliebigen Betriebssystem oder Webviewcontrol.

Alle nötigen Files sind im Zip-File inklusive, die einfach nur in einem bestimmten Unterordner der FHEM Installation kopiert werden müssen.

Installation

• Dateien herunterladen: https://github.com/knowthelist/fhem-tablet-ui
• einen neuen Ordner 'tablet' im Verzeichnis /<fhem-Pfad>/www erstellen
• alle Dateien und Unterordner nach /<fhem-Pfad>/www/tablet kopieren
• in fhem.cfg folgende Zeile einfügen: define tablet_ui HTTPSRV tablet/index.html ./www/tablet Tablet Frontend
• index-example.html in index.html umbenennen oder eine neue index.html erzeugen

Das UI ist über "http://<fhem-url>:8083/fhem/tablet/index.html" zu erreichen.

Update

Zum Update des UI in der FHEM-Befehlszeile eingeben: update all https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt bzw. mit update check https://raw.githubusercontent.com/knowthelist/fhem-tablet-ui/master/controls_fhemtabletui.txt vorher schauen was sich seit dem letzten Download alles geändert hat

Weitere Widgets

Widgets for fhem-tablet-ui

Installation und Update können per FHEM-Update veranlasst werden. Dazu folgenden Befehl in die FHEM-Befehlszeile eingeben: update all https://raw.githubusercontent.com/nesges/Widgets-for-fhem-tablet-ui/master/controls_widgets-for-fhem-tablet-ui.txt. Näheres zur Installation unter Wiki: Installation. Die Dokumentation der einzelnen Widgets befindet sich ebenfalls im Github-Wiki.

Konfiguration

Die Konfiguration der angezeigten Widgets erfolgt in der Datei index.html im Hauptordner 'tablet'.

Metadaten-Konfiguration

Refresh sofort, alle 15 Minuten ein voller Refresh (shortpoll) statt alle 30 Sekunden ein voller Refresh

<meta name="longpoll" content="1">

Drag&Drop deaktivieren

<meta name='gridster_disable' content='1'>

Toast messages deaktivieren

<meta name='toast' content='1'>

Größe des Basis-Rasters (data-sizey=1/data-sizex=1)

<meta name="widget_base_width" content="116">

<meta name="widget_base_height" content="131">

Abstände der Gridsterelemente verkleinern:

<meta name="widget_margin" content="3">

Das Layout und das Aussehen des UI kann durch die Klassen-Attribute beeinflusst werden. Verfügbare Klassen sind:

container, left, right, cell, narrow, darker, big, bigger, small

Farbe

Es besteht die Möglichkeit, die Farbwerte in hexadezimaler Form oder als RGB-Wert anzugeben. Zum Beispiel: Hex: #A3CFA3 RBG: rgb(163, 207, 163).

Knallige Farben wie #ff0000 für Rot oder #00ff00 für Grün sollten vermieden werden. Es ist besser unterhalb von #D0 (208) für die Grundfarben zu bleiben.

Hilfreich bei der Suche nach den Farbwerten ist der color picker: http://www.w3schools.com/tags/ref_colorpicker.asp

CSS Class description

Not all widgets support all classes

• readonly : changing of state is not allowed
• wider : 25px extra space for the widget to the top
• narrow : shorter distant to the widget above
• w1x, w2x, w3x : set the widget to a fix width: 1x, 2x, 3x width
• small : font 80% size (label), small diameter for volume widget
• mini : lowest diameter for volume widget
• large : font 150% size
• big : font 200% size
• bigger : font 320% size
• thin : font thin
• darker : forecolor in gray
• hue-tick : draw ticks in color range
• hue-front : draw handle in color range
• hue-back : draw background in color range
• dim-tick : draw ticks in brightness range
• dim-front : draw handle in brightness range
• dim-back : draw background in brightness range
• red : foreground color red
• green : foreground color green
• blue : foreground color blue
• doublebox-v : container to place 2 small widgets (e.g. switch) one above the other
• doublebox-h : container to place 2 small widgets (e.g. switch) side by side
• timestamp : deliver the date time for the reading instead the value
• inline : positioning elements in a row, no line break
• top-space : 15px extra on top (top-space-2x -> 30px; top-space-3x -> 45px)
• left-space : 15px extra on left (left-space-2x -> 30px; left-space-3x -> 45px)
• right-space : 15px extra on right (right-space-2x -> 30px; right-space-3x -> 45px)
• blink : blink animatation for label or symbol widget

Widgets -- Konfiguration

Zurzeit stehen 17 Widgets zur Verfügung:

• circlemenu: Mehrere Widgets hinter einem Widget verborgen
• dimmer: toogle button with a setter for on value
• homestatus: selector for 4 states (1=home, 2=night, 3=away, 4=holiday)
• image: insert an image, the URL is given by a reading
• label: ein state als Text anzeigen (Farbe einstellbar)
• level: vertical/horizontal bar to show values between min/max value
• pagetab: Element to smoothly exchange the whole page with another page
• playstream: Abspielen eines Webradio-Streams per Button
• push: send any command to FHEM e.g. up / down
• rotor: Umschalten von zwei oder mehr Widgets an einer Position
• select: Combobox to provide a list for selection
• slider: vertical slider to select between min/max value
• switch: Toggle any command to FHEM (e.g. on / off)
• symbol: State als Symbol darstellen (z.B. Fenster offen)
• thermostat: dial for heater thermostates to set desired value and show current value
• volume: dial to set a single value (e.g. 0-60)
• weather: insert an icon or image, represending a weather literal

---

Für alle Widgets gilt:

allgemeine Attribute

data-type	Widget-Typ
data-device	FHEM-Name des Gerätes (mit dem Befehl 'list' bekommt man im FHEM die kpl. Liste)
class	CSS-Klassen für Aussehen und Formatierung des Widgets

CIRCLEMENU

HTML Attribut	Beschreibung	Default Wert
data-item-diameter	diameter of the circle	52
data-circle-radius	radius of each item, in pixel	70
data-direction	position of the items in relation to the center	'full'
data-close-after	closing time of the circle-menu	(item-count + 1s) or a minimum of 4s
class	keepopen

Optionen für data-direction: top | right | bottom | left | top-right | top-left | bottom-right | bottom-left | top-half | right-half | bottom-half | left-half | full

Link zu einem Beispiel

DIMMER

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM	'STATE'
data-get-on	value for ON status to get	'on'
data-get-off	value for OFF status to get	'off'
data-set	(<command> <device> <reading> <value>)
data-set-on	value for ON status to set	value of data-get-on
data-set-off	value for OFF status to set	value of data-get-off
data-cmd	name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)	'set'
data-dim	name of the reading responsible for dim (<command> <device> <reading> <value>)	value of data-get-on
data-icon	name of the font-awesome icon	fa-lightbulb-o

Link zu einem Beispiel

HOMESTATUS

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM	'STATE'
data-set	command to send to FHEM (set <device> <command> <value>)
data-alias	array of fix names to show only in the UI as an alias to the real states
data-icons	array of icons related to the data-get-on array
data-version	name of the status model e.g. 'residents','roommate','guest'	(default NULL)

The default version has 4 states: '1','2','3','4' The default aliases are 'Home','Night','Away','Holiday'; data-version='residents' or 'roommate' or 'guest' has 5 states ('home','asleep','absent','gone','gotosleep') They have these aliases 'Home','Night','Away','Holiday','Retire'

Link zu einem Beispiel

IMAGE

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get an URL from FHEM	'STATE'
data-size	width of the image in px or %, the height scales proportionally	50%
data-url	URL of the image to show (use data-url or data-device + data-get, not both)
data-refresh	Interval in seconds for image refresh for usage together with data-url	900

Link zu einem Beispiel

LABEL

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM
data-fix	keeping a specified number of decimals.	'-1' -> non-numeric
data-part	split position of the space separated value to show or an RegEx
data-colors	a array of color values to affect the colour of the label according to the limit value
data-limits	a array of numeric values to affect the colour of the Label
data-unit	add a unit after a numeric value. use encoded strings e.g. "%B0C%0A"
class	small, large, big, bigger, thin, red, green, blue, darker

Link zu einem Beispiel

LEVEL

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM	'STATE'
data-min	minimal value to set	'0'
data-max	maximal value to set	'100'
data-on	value where the slider moves to max	'on'
data-off	value where the slider moves to min	'off'
data-colors	a array of color values to affect the colour of the label according to the limit value
data-limits	a array of numeric or RegEx values to affect the colour of the label
class	mini, horizontal

Link zu einem Beispiel (fehlt noch)

PAGETAB

HTML Attribut	Beschreibung	Default Wert
data-url	URL of the new page to show
data-icon	name of the font-awesome icon	'fa-power-off'
data-background-icon	name of the font-awesome icon for background
data-on-background-color	color of ON state	'#aa6900'
data-off-background-color	color of OFF state	'#505050'
data-on-color	color of ON state	'#aa6900'
data-off-color	color of Off state	'#505050'
data-get-on	array of status to assign a special icon-list from data-icons
data-icons	array of icons related to the a data-get-on array
class	warn, activate (as additionals for data-icons)

Link zu einem Beispiel

PLAYSTREAM

HTML Attribut	Beschreibung	Default Wert
data-url	URL des Radio-Streams

Link zu einem Beispiel

PUSH

HTML Attribut	Beschreibung	Default-Wert
data-set	value to send to FHEM (<command> <device> <value>)
data-set-on	value to send when the the button get pressed.
data-icon	name of the font-awesome icon
data-background-icon	name of the font-awesome icon for background	'fa-circle'
data-cmd	name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)	'set'
data-doubleclick	timeout to wait for a second click or touch. '0' disables the doubleclick feature.	0
data-countdown	secondes for the countdown progress control	autodetect from 'on-for-timer' command

Link zu einem Beispiel

ROTOR

HTML Attribut	Beschreibung	Default Wert
data-delay	time in millisecondes to wait until next list item get shown	3500
class	fade, rotate

Ohne Angabe von class erfolgt keine Animation.

Link zu einem Beispiel

SELECT

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading that get the selected item of the list
data-set	name of the reading to set on FHEM (<command> <device> <reading> <value>)
data-list	name of the reading to get a :-separated list from FHEM
data-items	an array of fix items to show in the selection box (alternative if data-list is empty)
data-alias	an array of fix names to show only in the selection box as an alias to the real items
data-cmd	name of the command to send to FHEM (<command> <device> <reading> <value>) (e.g. setstate, set, setreading, trigger)	'set'
data-quote	characters to enclose the send value
class	wider, w1x, w2x, w3x, large, big

Link zu einem Beispiel

SLIDER

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM	'STATE'
data-set	command to send to FHEM (set <device> <command> <value>)
data-cmd	name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)	'set'
data-min	minimal value to set	0
data-max	maximal value to set	100
data-on	value where the slider moves to max	'on'
data-off	value where the slider moves to min	'off'
data-value	wenn true wird beim sliden der Wert angezeigt
data-width	width for horizontal sliders	'120px', for mini '60px'
data-height	height for vertical sliders	'120px', for mini '60px'
class	Aussehen/Ausrichtung

Für class steht mini, horizontal und negated (0 liegt oben) zur Verfügung.

Link zu einem Beispiel

SWITCH

HTML-Attribut	Beschreibung	Default-Wert
data-get	Name des Reading, was gelesen werden soll	'STATE'
data-get-on	Wert, bei dem zum Status ON geschaltet werden soll.	'on'
data-get-off	Wert, bei dem zum Status OFF geschaltet werden soll.	'off'
data-set-on	Wert, der zu FHEM gesendet werden soll, wenn das Widget auf ON geschaltet wurde	Wert von data-get-on
data-set-off	Wert, der zu FHEM gesendet werden soll, wenn das Widget auf OFF geschaltet wurde	Wert von data-get-off
data-cmd	Kommando Name (<command> <device> <value>) (z.B setstate, set, setreading, trigger)	'set'
data-icon	Name des Font-Awesome Icon.	'fa-lightbulb-o'
data-background-icon	Name des Font-Awesome Hintergrund Icon.	'fa-circle'
data-on-color	Widget Farbe beim Status ON	'#aa6900'
data-off-color	Widget Farbe beim Status OFF	'#505050'

data-get-on and data-get-off accept also RegEx values. e.g. data-get-on="[0-9]{1,3}|on" means set switch on if STATE is a numeric value or 'on'. data-get-off="!on" means accept all but the data-get-on value (negation)

Link zu einem Beispiel

SYMBOL

HTML Attribut	Beschreibung	Default Wert
data-get	Name des Reading, was gelesen werden soll	'STATE'
data-get-on	value for ON status to get or an array of states.	'open'
data-get-off	value for OFF status to get.	'closed'
data-icon	Name des font-awesome-Symbols	'ftui-window'
data-background-icon	Hintergrundsymbol
data-on-background-color	Farbe für ON-Zustand.	'#aa6900'
data-off-background-color	Farbe für ON-Zustand.	'#505050'
data-on-color	Farbe für ON-Zustand.	'#aa6900'
data-off-color	Farbe für ON-Zustand.	'#505050'
data-icons	Array mit Icons zu data-get-on Array
data-on-colors	array of colors related to the data-get-on array
data-on-background-colors	array of background-colors related to the data-get-on array

To use multiple icons, data-get-on, data-icons and data-on-colors have to be an array with the same size. The value for one icon can also contain an additional animatation CSS name, e.g. "fa-exclamation-triangle fa-blink" for a blinking symbol. data-get-on and data-get-off accept also RegEx values. The value for one icon can also contain an additional animatation CSS name, e.g. "fa-exclamation-triangle fa-blink" for a blinking symbol

Link zu einem Beispiel

THERMOSTAT

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM	'desired-temp'
data-temp	reading for measured temperature of thermostates	'measured-temp'
data-set	command to send to FHEM (set <device> <command> <value>)	'desired-temp'
data-valve	reading for valve position of thermostates
data-min	minimal value to set	10
data-max	maximal value to set	30
data-minColor	Farbe des Keises für Min	#4477FF
data-maxColor	Farbe des Kreises für Max, zwischen Min und Max wird linear interpoliert	#FF0000
data-step	step size for value adjustment e.g. 0.5	1
data-bgColor	Die Farbe der Kreises zwischen den ticks	'transparent'
data-fgColor	Die Farbe der zahl im Kreismittelpunkt	#bbbbbb
data-tkColor	Die Farbe der ticks	#696969
data-angleOffset	Start der ticks im Kreis (in Winkelgraden, 0 = oben)	-120
data-angleArc	Bereich der ticks im Kreis (in Winkelgraden)	240
class	big, readonly

Link zu einem Beispiel

VOLUME

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get from FHEM	'STATE'
data-set	command to send to FHEM (set <device> <command> <value>)
data-cmd	name of the command (<command> <device> <value>) (e.g. setstate, set, setreading, trigger)	'set'
data-min	minimal value to set	0
data-max	maximal value to set	70
class	small, hue-tick, hue-front, hue-back, dim-tick ,dim-front, dim-back

Link zu einem Beispiel (fehlt noch)

WEATHER

HTML Attribut	Beschreibung	Default Wert
data-get	name of the reading to get the weather literal from FHEM	'STATE'
data-imageset	collection of images to display current weather situation. Possible values: 'meteocons', 'kleinklima'	'meteocons'
data-image-path	path to the images of the selected imageset	/images/weather/

Link zu einem Beispiel

Widgets -- Beispiele

Circlemenu

Cover a lot of other button behind one single button

<div class="left">
<div data-type="circlemenu" class="cell circlemenu">
    <ul class="menu">
      <li><div data-type="push" data-icon="fa-wrench"></div></li>
      <li><div data-type="push" data-device="AvReceiver" 
               data-set="remoteControl subwoofer-temporary-level -6" 
               data-icon="">-6</div></li>
      <li><div data-type="push" data-device="AvReceiver" 
               data-set="remoteControl subwoofer-temporary-level -2" 
               data-icon="">-2</div></li>
      <li><div data-type="push" data-device="AvReceiver" 
               data-set="remoteControl subwoofer-temporary-level 0" 
               data-icon="">0</div></li>
      <li><div data-type="push" data-device="AvReceiver" 
               data-set="remoteControl subwoofer-temporary-level +3" 
               data-icon="">2</div></li>
      <li><div data-type="push" data-device="AvReceiver" 
               data-set="remoteControl subwoofer-temporary-level +9" 
               data-icon="">9</div></li>
      <li><div data-type="push" data-device="AvReceiver" 
               data-set="remoteControl subwoofer-temporary-level +C" 
               data-icon="">12</div></li>
    </ul>
</div>
<div data-type="label" class="cell">Woofer</div>
</div>

Dimmer

Dimmer Widget Beispiel für Philips Hue

Minimalvariante

 
<div data-type="dimmer" data-device="HUEDevice1"
        data-get-on="!off" data-get-off="off"
        data-set="pct"</div>

Mit Anzeige der Dimstufe

<div data-type="dimmer" data-device="HUEDevice1"
       data-get="onoff"
       data-get-on="1" data-get-off="0"
       data-set=""
       data-set-on="on" data-set-off="off"
       data-dim="pct">
</div>

Dimmer Widget für MilightDevice

<div data-type="dimmer"
  data-device="SonstWas"
  data-get="brightness"
  data-get-off="0"
  data-get-on="[1-9][0-9]*"
  data-set-on="on"
  data-set-off="off"
  data-dim="dim"
  data-min="0"
  data-max="100"
></div>

Homestatus

Beispiel rechts im Bild:

<div data-type="homestatus" data-device='dummy1'
       data-get-on='["1","2","3","4"]'
       data-alias='["Home","Night","Away","Holiday"]'
       data-icons='["fa-home","fa-bed","fa-car","fa-suitcase"]'>
</div>

Beispiel links im Bild:

<div data-type="homestatus" data-device='dummy1'
        data-get-on='["home","asleep","absent","gone","gotosleep"]'
        data-alias='["Home","Night","Away","Holiday","Retire"]'
        data-icons='["fa-fire","fa-film","fa-plus","fa-car","fa-tint"]'
        data-version='residents'>
</div>

Image

Erzeugt ein Widget mit einem Bild aus dem www, das alle 5 Sekunden aktualisiert wird (hier eine Wetterkarte vom DWD).

<div data-type="image"
     data-size="80%"
     data-url="http://www.dwd.de/wundk/wetter/de/Deutschland.jpg"
</div>

Example for how to add an image to the dashboard which its URL is delivered by a FHEM module like PROPLANTA:

<div data-type="image" data-device="Wetter1" 
     data-get="fc0_weatherDayIcon" 
     data-size="40px" 
     class="cell">
</div>

Label

Example for HM-WDS40-TH-I Funk-Temperatur-/Feuchtesensor innen

STATE   T: 20.0 H: 61

<div data-type="label" data-device="THSensorWZ" 
     data-part="2" data-unit="%B0C%0A" class="cell big"></div>
<div data-type="label" class="cell">Temperatur</div>
<div data-type="label" data-device="THSensorWZ" data-part="4" 
     data-unit="%" class="cell big"></div>
<div data-type="label" class="cell">Luftfeuchte</div>

But the same result can reached by getting single readings:

humidity    58
temperature 20.1

<div data-type="label" data-device="THSensorWZ" 
     data-get="temperature" data-unit="%B0C%0A" class="cell big"></div>
<div data-type="label" class="cell">Temperatur</div>
<div data-type="label" data-device="THSensorWZ" 
     data-get="humidity" data-unit="%" class="cell big"></div>
<div data-type="label" class="cell">Luftfeuchte</div>

Example for how to influence the color of the label according to value limits

<div data-type="label" 
     data-device="OutTemp" 
     data-limits='[-73,10,23]' 
     data-colors='["#6699FF","#AA6900","#FF0000"]' 
     data-unit="%B0C%0A" 
     class="cell big">
</div>

Example for how to create a widget for shutter via push: show state and set up/down

<div data-type="switch" 
     data-device="wzRollo" 
     data-get-on="up" 
     data-get-off="down" 
     data-icon="fa-bars" 
     class="cell" >
</div>
<div data-type="label" 
     class="cell">Rollo</div>

Example for how to create a label for a time value in short format with usage of RegEx.

<div data-type="label" 
     data-device="dummy1" 
     data-part="(\d\d\.\d\d\.).*" 
     class="cell">
</div>

Example for how to show two labels in one line.

<div class="">
   <div type="label" device="OnSunrise" class="inline"></div>bis
   <div type="label" device="OnSunset" class="inline"></div>
</div>

Beispiel für die Anzeige des UV-Indexes und der Abhängigkeit der anzuzeigenden Farbe.

   <div data-type="label" class="wider cell bigger" data-device="ProVorhersage"
        data-get="fc0_uv"
        data-limits="[-2, 2, 5, 7, 10]" 
	data-colors='["#66FF33","#FFFF00","#FF6600","#FF0000","#993399"]'></div>
   <div data-type="label" class="cell" data-device="ProVorhersage" data-get="fc0_date"></div>
   <div data-type="label" class="wider cell bigger" data-device="ProVorhersage"
        data-get="fc1_uv"
	data-limits="[-2, 2, 5, 7, 10]"
	data-colors='["#66FF33","#FFFF00","#FF6600","#FF0000","#993399"]'></div>
   <div data-type="label" class="cell" data-device="ProVorhersage" data-get="fc1_date"></div>

Pagetab

Example for a tab menu to switch smoothly between multiple pages. Multiple pagetabs in a template file: menu.html

<html>
<body>
    <header>MENU</header>
    <div class="cell">
        <div data-type="pagetab" data-url="index.html"  data-icon="fa-home" class="cell"></div>
        <div data-type="pagetab" data-url="index_2.html" data-icon="fa-sliders" class="cell"></div>
        <div data-type="pagetab" data-url="index_3.html" data-icon="fa-music" class="cell"></div>
        <div data-type="pagetab" data-url="index_4.html" data-icon="fa-hotel" class="cell"></div>
        <div data-type="pagetab" data-url="index_5.html" data-icon="fa-music" class="cell"></div>
        <div data-type="pagetab" data-url="index_6.html" data-icon="fa-database" class="cell"></div>
        <div data-type="pagetab" data-url="index_7.html" data-icon="fa-fax" class="cell"></div>
    </div>
</body>
</html>

Playstream

Erzeugt einen Knopf zum direkten Abspielen eines Webradio-Streams.

     <div data-type="playstream" data-url="http://radioeins.de/stream"></div>
     <div data-type="label" class="darker">Radio eins</div>

Push

Example for how to create a push button widget to trigger all devices on:

<div data-type="push" 
     data-device="LightAll" 
     data-cmd="trigger" 
     data-set="on" 
     class="cell">
</div>

Beispiel für zwei horizontale Buttons:

<div class="cell">
    <div class="doublebox-h">
        <div data-type="push" data-device="Rollo" 
             data-icon="fa-angle-up" data-background-icon="fa-square-o" 
             data-set="up">
        </div>
        <div data-type="push" data-device="Rollo" 
             data-icon="fa-angle-down" data-background-icon="fa-square-o" 
             data-set="down">
        </div>
    </div>
</div>

Beispiel für zwei quadratische vertikale Buttons:

<div class="cell">
    <div class="doublebox-v">
        <div data-type="push" data-device="Rollo" 
             data-icon="fa-chevron-up" data-background-icon="fa-square-o" 
             data-set="up">
        </div>
        <div data-type="push" data-device="Rollo" 
            data-icon="fa-chevron-down" data-background-icon="fa-square-o" 
            data-set="down">
        </div>
    </div>
</div>

Rotor

Example for a rotor widget, which switches between to days of weather forecast

<div data-type="rotor" class="fade">
 <ul>
  <li>
    <div data-type="label" class="darker">Heute</div>
    <div data-type="weather" data-device="AgroWeather" data-get="fc0_weatherDay" class="big"></div>
    <div data-type="label" data-device="AgroWeather" data-get="fc0_weatherDay" class=""></div>
    <div data-type="label" data-device="AgroWeather" data-get="fc0_tempMax" data-unit="%B0C%0A" class="large"></div>
  </li>
  <li>
    <div data-type="label" class="darker">Morgen</div>
    <div data-type="weather" data-device="AgroWeather" data-get="fc1_weatherDay" class="big"></div>
    <div data-type="label" data-device="AgroWeather" data-get="fc1_weatherDay" class=""></div>
    <div data-type="label" data-device="AgroWeather" data-get="fc1_tempMax" data-unit="%B0C%0A" class="large"></div>
  </li>
 </ul>
</div>

Select

Erzeugt zwei Comboboxen zur Auswahl des Eingang eines 2-Zonen-AV-Receivers. Die Liste für Zone2 ist fest, die Liste für Zone1 wird von FHEM übergeben.

<div class="cell wider">
          <div data-type="label" class="inline wider">Zone2</div>
          <div data-type="select" data-device="AvReceiverZ2" data-items='["Airplay","Webradio","BD/DVD","PHONO"]' data-get="input" data-set="input" class="cell w2x" ></div>
          <div></div>
          <div data-type="label" class="inline">Zone1</div>
          <div data-type="select" data-device="AvReceiver" data-list="inputs" data-get="input" data-set="input" class="cell w2x" ></div>
</div>

Slider

Slider mit einstellbaren Werten von 10 bis 90:

<div data-type="slider" 
     data-device='Dummy1' 
     data-min="10" 
     data-max="90" 
     class="cell" >
</div>
<div data-type="label" class="cell">Light1</div>

Horizontal angeordneter Slider:

<div data-type="slider"
     data-device='Dummy1' 
     data-min="0" 
     data-max="100" 
     class="horizontal" 
</div>

Switch

Schalter. Usage of RegEx pattern for state request:

<div data-type="switch" class="cell" 
            data-device="MILIGHT_Zone1_Wohnzimmer" 
            data-get-on="on.*"
            data-get-off="off"></div>

Beispiel für eine Gruppe von Schaltern, um zwischen vier verschiedenen Werten eines device umzuschalten:

<div class="cell left">
 <div data-type="switch" data-device="dummy1" 
      data-get-off="((?!Wert1).)*" 
      data-get-on="Wert1" class="cell" ></div>
 <div data-type="label" class="cell">Wert1</div>
 <div data-type="switch" data-device="dummy1" 
      data-get-off="((?!Wert2).)*" 
      data-get-on="Wert2" class="cell" ></div>
 <div data-type="label" class="cell">Wert2</div>
 <div data-type="switch" data-device="dummy1" 
      data-get-off="((?!Wert3).)*" 
      data-get-on="Wert3" class="cell" ></div>
 <div data-type="label" class="cell">Wert3</div>
 <div data-type="switch" data-device="dummy1" 
      data-get-off="((?!Wert4).)*" 
      data-get-on="Wert4" class="cell" ></div>
 <div data-type="label" class="cell">Wert4</div>
</div>

Symbol

Example for a tristate icon

<div data-type="symbol" data-device="dummy1" 
     data-get-on='["wert1","wert2","wert3"]' 
     data-icons='["fa-arrow-up","fa-user","fa-arrow-down"]' 
     data-on-colors='["SeaGreen","SlateBlue","IndianRed"]' 
     class="cell big">
</div>

Example for a tristate icon with blink and spin animation

<div data-type="symbol" data-device="dummy1" 
     data-icons='["fa-exclamation-triangle fa-blink","fa-exclamation-circle","fa-cog fa-spin"]' 
     data-on-colors='["Crimson","GoldenRod","SeaGreen"]' 
     data-get-on='["Wert1","Wert2","Wert3"]' >
</div>

Example for a battery level control with RegEx

<div data-type="symbol" data-device="BadHeizung" data-get="batteryLevel"
     data-icons='["oa-measure_battery_100","oa-measure_battery_75","oa-measure_battery_50","oa-measure_battery_25","oa-measure_battery_0"]'
     data-get-on='["3\\.[0-9]","2\\.[789]","2\\.[456]","2\\.[123]","((2\\.0)|([01]\\.[0-9]))"]'
     data-on-colors='["#505050","#505050","#505050","#ad3333","#ad3333"]'>
</div>

Example for a battery level control with greater-equal compare and 90° rotated symbols

<div data-type="symbol" data-device="BadHeizung" data-get="batteryLevel"
    data-icons='["oa-measure_battery_0 fa-rotate-90","oa-measure_battery_25 fa-rotate-90","oa-measure_battery_50 fa-rotate-90","oa-measure_battery_75 fa-rotate-90","oa-measure_battery_0 fa-rotate-90"]'
    data-get-on='["0","2","2.4","2.7","3.0"]'
    data-on-colors='["#ad3333","#ad3333","#505050","#505050","#505050"]'>
</div>

Thermostat

Configure as data-device='...' that item which delivers temp and desired-temp as reading.

Default parameters are:

data-get="desired-temp" data-temp="measured-temp" data-set="desired-temp"

Therefor for HomaMatic HM-CC-RT-DN this is sufficient.

<div data-type="thermostat" data-device='KH_Clima' class="cell"></div>

The long format looks like this:

<div data-type="thermostat" 
     data-device="KH_Clima" 
     data-get="desired-temp" 
     data-temp="measured-temp" 
     class="cell">
</div>

Example for MAX!:

<div data-type="thermostat" data-device="HZ_Tuer" 
    data-valve="valveposition" 
    data-get="desiredTemperature" 
    data-temp="temperature" 
    data-set="desiredTemperature" 
    class="cell">
</div>

The wigets will show the valve value only in case of a valid data-valve attribute. The default for data-valve ist null. That means, a empty data-valve attribute hides the valve label for the widget.

Weather

Das Widget fügt ein dem Wetter entsprechendes Bild ein. Die Daten können durch FHEM-Module wie PROLANTA, OPENWEATHER und Weather bereitgestellt werden. Add 'big' or 'bigger' to CSS class to get a bigger weather icon.

Beispiel:

<div data-type="weather" 
     data-device="Weather" 
     data-get="fc0_weatherDay" 
     class="cell big">
</div>

Icon-Konfiguration

• Eingebaute Icons: Diese haben das ftui-Präfix. Zurzeit sind folgende verfügbar: ftui-window, ftui-door

• Mehr als 500 Icons von "http://fortawesome.github.io/Font-Awesome/icons" verfügbar. Einfach den Icon-Namen angeben (Suffix "fa-" nicht vergessen, Z.B. data-icon="fa-volume-up"

• Es stehen auch Openautomation Font-Files zur Verfügung. Wer sie nutzen möchte, muss folgende Stylesheets in die index.html hinzufügen.

   <link rel="stylesheet" href="/fhem/tablet/lib/openautomation.css" />
   <link rel="stylesheet" href="/fhem/tablet/lib/fhemSVG.css" />

Diese font icons haben das Präfix 'fs-' bzw. 'oa-'.

Beispiel bei einem Schalter:

<div data-type="switch" data-device='dummy1' data-icon="oa-secur_locked"></div>

Und so als großes Symbol:

<div data-type="symbol" data-device='dummy1'
        data-icon="oa-status_frost"
        data-on-color="#bb3232"
        data-get-on="on"
        data-get-off="!on"
        class="bigger">
</div>

Die Icons kann man auch etwas dicker darstellen mit den Zusatz bold: data-icon="oa-secur_locked bold"

Die Namen der verfügbaren Icons findet man auch in den CSS Files (openautomation.css / fhemSVG.css)

Spezial

Folgender Befehl setzt einen direkten Befehl an FHEM ab (set dummy1 off):

     <div onclick="setFhemStatus('set dummy1 off')">All off!</div>

FAQ

Häufig gestellte Fragen zum FHEM Tablet UI sind in der FHEM Tablet UI FAQ zusammengestellt.

Links

• Forums-Beitrag
• Projekt auf Github
• User-Demos
• Download der User-Demo-Dateien