FTUI Widget Dimmer

Das Dimmer Widget ist ein Widget für FHEM Tablet UI, das einen Ein-/Aus-Button mit inkludiertem Schieberegler erstellt.

Attribute

Attribut	Beschreibung	Standard-Wert	Beispiel
data-get	Device-Reading, welches den Status-Wert enthält	STATE
data-get-on	Wert für EIN	on	data-get-on="An"
data-get-off	Wert für AUS	off	data-get-off="Aus"
data-get-value	RegEx oder Position in einer leerzeichen-getrennten Auflistung, die den Wert repräsentiert	-1 (alles anzeigen)	data-get-value="2"
data-set	Reading, welches geändert werden soll
data-set-on	Wert für EIN, der gesetzt werden soll	data-get-on
data-set-off	Wert für AUS, der gesetzt werden soll	data-get-off
data-set-value	Wert für EIN, der gesetzt werden soll	$v - nur der Wert
data-set-cmd	Name des Befehls zum Ändern des EIN-/AUS-Wertes, der mittels Schieberegler geändert wird	set	data-set-cmd="setreading"
data-cmd-value	Name des Befehls zum Ändern des Wertes, der mittels Schieberegler geändert wird	set
data-dim	Name des Readings, das für den DIM-Wert zuständig ist		data-dim="dim"
data-icon	Name des Icons für den Schieberegler	fa-lightbulb-o
data-max	Maximalwert, der gesetzt werden kann	100	data-max="25"
data-min	Minimalwert, der gesetzt werden kann	0	data-min="10"
data-step	Größe der Änderungsschritte	1	data-step="5"
data-lock	Name des Readings, welches durch einen Boolean-Wert definiert, ob das Widget gesperrt (readonly) ist

CSS Klassen

FS20	Konvertiert den Wertebereich 0...100 in das von FS20-Dimmern erwartete Format

Hinweise

Um den Dim-Wert zu ändern, muss der Button gedrückt und nach unten oder oben verschoben werden.
Im einfachen Modus (ohne data-dim-Parameter) schaltet das Widget zwischen OFF und dem DIM-Wert.
Im erweiterten Modus (mit data-dim-Parameter) wird der DIM-Wert vom definierten Reading empfangen bzw. gesendet und der Button wird nur für EIN/AUS verwendet.
$v ist ein Platzhalter für den numerischen Wert. Er wird zur Laufzeit durch den richtigen Wert ersetzt.
data-lock: Das Widget wird gesperrt (readonly), wenn das definierte Reading den Wert 1, on oder true hat.

Beispiele

HUEDevice

Einfaches Beispiel:

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

Nun ein Beispiel mit einem eigenen Reading für den DIM-Wert. Es ist dasselbe HUEDevice wie oben, nur wird diesmal der pct-Wert getrennt von EIN/AUS geregelt:

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

Homematic-Dimmer

So wird ein Homematic-Dimmer im erweiterten Modus eingebunden:

<div data-type="dimmer" 
     data-device="HomematicDevice1" 
     data-get-on="on|^[1-9][0-9]?$" 
     data-get-off="off" 
     data-set-on="on" 
     data-dim="pct"></div>

RegEx für On-Werte

Dieses Beispiel verwendet einen RegEx-Ausdruck, um alle möglichen Werte für "EIN" abzudecken.

<div data-type="dimmer"
     data-device='Dimmer1'
     data-set="pct"
     data-get-on="[0-9]{1,3}|on"
     data-get-off="off"></div>