ReadingsProxy: Unterschied zwischen den Versionen
Andies (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Andies (Diskussion | Beiträge) K (→Attribute) |
||
(14 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 18: | Zeile 18: | ||
=== Definition === | === Definition === | ||
Im Folgenden wird das Readingsproxy auch als ''Proxy Device'' bezeichnet. | Im Folgenden wird das Readingsproxy auch als ''Proxy Device'' oder nur ''Proxy'' bezeichnet. | ||
Das Readingsproxy ist ein eigenständiges Gerät und wird durch den Befehl | Das Readingsproxy ist ein eigenständiges Gerät und wird durch den Befehl | ||
Zeile 28: | Zeile 28: | ||
;readingFnAttributes | ;readingFnAttributes | ||
:... | :... | ||
;setFn | |||
setFn Mit setFn können set-Befehl an das übergeordnete Gerät (parent device) durchgereicht werden. setFn ist ein Attribut, es muss aber eine Funktion übergeben werden. Dazu wird am besten ein Beispiel präsentiert. | |||
Das parent device <MQTT device> sei ein MQTT-Gerät, bei dem ein set-Befehl zum ein- oder ausschalten wie folgt lautet | |||
set <MQTT-device> switch1 on/off. | |||
Der Zustand des Schalters wird im Reading myswitch1 wiedergegeben. Dann kann man ein ReadingsProxy definieren, dass auf dieses Reading Bezug nimmt | |||
defmod <Proxy-device> readingsProxy <MQTT-device>:myswitch1 | |||
Damit set-Befehle übergeben werden, wird nun setFn wie folgt festgelegt | |||
attr <Proxy-device> setFn {($CMD eq "on")?"switch1 on":"switch1 off"} | |||
Zuerst einmal handelt es sich um einen Perl-Ausdruck, was man an den geschweiften Klammern erkennt. Weiter erkennt man eine Funktion, die Eingaben wie die Variable $CMD besitzt und in Abhängigkeit von dieser Eingabe einen Rückgabe (direkt an MQTT-device) geben wird. Verwendet werden können die folgenden Variablen: $CMD (das vom Proxy ausgelöste set-Kommando), $DEVICE (der Name des parent-Geräts), $READING (der Name des betreffenden Reading), wahrscheinlich auch $VALUE (der Wert des betreffenden Readings) and $ARGS (unklar). Der oben stehende Befehl ist eine if-then-else Abfrage: Wenn das Kommando "on" lautete (genauer ''set <Proxy-device> on''), dann wird ''switch1 on'' an das MQTT-Gerät übergeben und es wird damit ''set <MQTT-device> switch1 on'' aufgerufen. War der Befehl nicht on, wird ''set <MQTT-device> switch1 off'' aufgerufen. | |||
;getFn | ;getFn | ||
Hier gilt das oben für setFn gesagte, nur dass es sich in diesem Fall nicht um einen set-Befehl, sondern einen get-Befehl handelt. | |||
;valueFn | ;valueFn | ||
:... | valueFn bestimmt, wie sich das Reading state des Readingsproxy berechnet. Ist dieses Attribut nicht gesetzt, so ändert sich das Reading nicht. Ist das Attribut definiert, so sollte es sich um eine Perl-Funktion handeln (d.h. eingerahmt in geschweifte Klammern), die dann definiert, wie sich state ermittelt. Im folgenden Fall | ||
attr <Proxy-device> valueFn {($VALUE == 0)?"off":"on"} | |||
ist das Reading state gleich off, wenn der Wert des parent Devices (auf das sich readingProxy bezieht) gleich null ist. In allen anderen Fällen ist der Zustand state gleich on. Wieder können die Variablen $CMD (das vom Proxy ausgelöste set-Kommando), $DEVICE (der Name des parent-Geräts) und $READING (der Name des betreffenden Readings) sowie $VALUE (Wert des Readings) verwendet werden. | |||
Noch einmal zusammengefasst. Legt man valueFn und setFn wie oben beschrieben fest, so hat man | |||
set <Proxy-device> on ===> set <MQTT-device> switch1 on | |||
<MQTT-device>:myswitch1 = "on" ===> <Proxy-device>:state = "on" | |||
== Anwendungsbeispiele == | == Anwendungsbeispiele == | ||
Zeile 58: | Zeile 75: | ||
attr proxy setFn {($CMD eq "on")?"off":"on"} | attr proxy setFn {($CMD eq "on")?"off":"on"} | ||
attr proxy valueFn {($VALUE eq "on")?"off":"on"} | attr proxy valueFn {($VALUE eq "on")?"off":"on"} | ||
</pre> | |||
=== Schalter für das GästeWLAN einer Fritzbox === | |||
<pre style="width:500px;"> | |||
define Gast_WLAN readingsProxy Fritzbox:box_guestWlan | |||
attr Gast_WLAN setList guestWlan:on,off | |||
</pre> | |||
=== Vereinzelung eines MySensors-Temperatur-Readings === | |||
<pre style="width:500px;"> | |||
define Aussentemperatur_Nord readingsProxy MYSENSOR_97:temperature2 | |||
attr Aussentemperatur_Nord stateFormat state °C | |||
</pre> | </pre> | ||
Aktuelle Version vom 7. Februar 2019, 20:14 Uhr
readingsProxy | |
---|---|
Zweck / Funktion | |
Aufsplitten von Mehrfachgeräten in einzelne FHEM-Devices | |
Allgemein | |
Typ | Hilfsmodul |
Details | |
Dokumentation | EN / DE |
Support (Forum) | Automatisierung |
Modulname | 33_readingsProxy.pm |
Ersteller | Andre (Forum / Wiki) |
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! |
Eventuell ist es nötig, die Readings eines Gerätes durch ein anderes, eigenständiges Gerät verwalten (auslesen, beschreiben) zu lassen. Auf diese Weise könnten auch neue Readings für ein Gerät (indirekt) erstellt werden, welches über diese Eigenschaften ursprünglich gar nicht verfügt. Auch können beispielsweise Mehrfachsensoren und Aktoren (1-Wire 2- oder 8-fach Schalter, EnOcean Serienschalter, ...) einzeln bedienbaren Geräte zugeordnet.
Hierzu dient das FHEM-Hilfsmodul readingsProxy. Sobald das Proxy Device on und off bereitstellt, stehen über die setExtentions auch on-for-timer, on-till, blink, usw. zur Verfügung.
Für das Proxy Device sind keine speziellen Voraussetzungen nötig.
Anwendung
Definition
Im Folgenden wird das Readingsproxy auch als Proxy Device oder nur Proxy bezeichnet.
Das Readingsproxy ist ein eigenständiges Gerät und wird durch den Befehl
define <name> readingsProxy <device>:<reading>
definiert. Dabei bezieht sich <device> auf das Gerät, dessen Reading durch den Proxy verwaltet werden soll, <reading> ist das zu verwaltende Reading. Sind Wildcards wie .* und RegEx möglich?
Attribute
Attribute mit spezieller Bedeutung für Proxy Devices:
- readingFnAttributes
- ...
- setFn
setFn Mit setFn können set-Befehl an das übergeordnete Gerät (parent device) durchgereicht werden. setFn ist ein Attribut, es muss aber eine Funktion übergeben werden. Dazu wird am besten ein Beispiel präsentiert.
Das parent device <MQTT device> sei ein MQTT-Gerät, bei dem ein set-Befehl zum ein- oder ausschalten wie folgt lautet
set <MQTT-device> switch1 on/off.
Der Zustand des Schalters wird im Reading myswitch1 wiedergegeben. Dann kann man ein ReadingsProxy definieren, dass auf dieses Reading Bezug nimmt
defmod <Proxy-device> readingsProxy <MQTT-device>:myswitch1
Damit set-Befehle übergeben werden, wird nun setFn wie folgt festgelegt
attr <Proxy-device> setFn {($CMD eq "on")?"switch1 on":"switch1 off"}
Zuerst einmal handelt es sich um einen Perl-Ausdruck, was man an den geschweiften Klammern erkennt. Weiter erkennt man eine Funktion, die Eingaben wie die Variable $CMD besitzt und in Abhängigkeit von dieser Eingabe einen Rückgabe (direkt an MQTT-device) geben wird. Verwendet werden können die folgenden Variablen: $CMD (das vom Proxy ausgelöste set-Kommando), $DEVICE (der Name des parent-Geräts), $READING (der Name des betreffenden Reading), wahrscheinlich auch $VALUE (der Wert des betreffenden Readings) and $ARGS (unklar). Der oben stehende Befehl ist eine if-then-else Abfrage: Wenn das Kommando "on" lautete (genauer set <Proxy-device> on), dann wird switch1 on an das MQTT-Gerät übergeben und es wird damit set <MQTT-device> switch1 on aufgerufen. War der Befehl nicht on, wird set <MQTT-device> switch1 off aufgerufen.
- getFn
Hier gilt das oben für setFn gesagte, nur dass es sich in diesem Fall nicht um einen set-Befehl, sondern einen get-Befehl handelt.
- valueFn
valueFn bestimmt, wie sich das Reading state des Readingsproxy berechnet. Ist dieses Attribut nicht gesetzt, so ändert sich das Reading nicht. Ist das Attribut definiert, so sollte es sich um eine Perl-Funktion handeln (d.h. eingerahmt in geschweifte Klammern), die dann definiert, wie sich state ermittelt. Im folgenden Fall
attr <Proxy-device> valueFn {($VALUE == 0)?"off":"on"}
ist das Reading state gleich off, wenn der Wert des parent Devices (auf das sich readingProxy bezieht) gleich null ist. In allen anderen Fällen ist der Zustand state gleich on. Wieder können die Variablen $CMD (das vom Proxy ausgelöste set-Kommando), $DEVICE (der Name des parent-Geräts) und $READING (der Name des betreffenden Readings) sowie $VALUE (Wert des Readings) verwendet werden.
Noch einmal zusammengefasst. Legt man valueFn und setFn wie oben beschrieben fest, so hat man
set <Proxy-device> on ===> set <MQTT-device> switch1 on <MQTT-device>:myswitch1 = "on" ===> <Proxy-device>:state = "on"
Anwendungsbeispiele
Achtung: Die Beispiele enthalten keine Maskierungen oder Verdoppelungen für ; und Zeilenende, sondern sind so angegeben, wie sie in FHEMWEB im Befehl-Eingabefeld oder nach Klick auf DEF eingegeben werden. Bei manuellem Einfügen in eine Konfigurationsdatei sind diese Maskierungen oder Verdoppelungen natürlich vorzunehmen.
1-Wire dual switch (DS2406) mit OWDevice als input (erster Kanal)
define myProxy readingsProxy myDS2406:latch.A attr myProxy valueFn {($VALUE == 1)?"on":"off"}
1-Wire 8-fach switch (DS2408) mit OWSWITCH als Output (erster Kanal)
define SchalterA readingsProxy OWX:xxx attr SchalterA setFn {($CMD eq "on")?"output A off":"output A on"} attr SchalterA setList on off attr SchalterA valueFn {($VALUE == 0)?"off":"on"} attr SchalterA webCmd on:off
on/off vertauschen
define proxy readingsProxy meineLampe:state attr proxy setFn {($CMD eq "on")?"off":"on"} attr proxy valueFn {($VALUE eq "on")?"off":"on"}
Schalter für das GästeWLAN einer Fritzbox
define Gast_WLAN readingsProxy Fritzbox:box_guestWlan attr Gast_WLAN setList guestWlan:on,off
Vereinzelung eines MySensors-Temperatur-Readings
define Aussentemperatur_Nord readingsProxy MYSENSOR_97:temperature2 attr Aussentemperatur_Nord stateFormat state °C
EnOcean Serienschalter
Siehe auch EnOcean Starter Guide
#Kanal A zur Steuerung mit on und off define Schalter_channelA readingsProxy Schalter:state attr Schalter_channelA setFn {($CMD eq "on")?"AI":"A0";;} attr Schalter_channelA setList on off attr Schalter_channelA valueFn {$LASTCMD} attr Schalter_channelA webCmd on:off #Kanal B zur Steuerung mit on und off define Schalter_channelB readingsProxy Schalter:state attr Schalter_channelB setFn {($CMD eq "on")?"BI":"B0";;} attr Schalter_channelB setList on off attr Schalter_channelB valueFn {$LASTCMD} attr Schalter_channelB webCmd on:off
setExtensions für Geräte implementieren
Wenn ein (Original-)Device von sich aus die setExtentions nicht unterstützt, kann das durch Verwendung eines Proxy Device behoben/implementiert werden. Sobald ein Proxy Device on und off bereitstellt, stehen über die setExtensions auch on-for-timer, on-till, blink, usw. zur Verfügung.
define STECKD_TEST readingsProxy STECKD_BAUHS:state attr STECKD_TEST setFn {($CMD eq "on")?"angle 3874":"angle 3873";} attr STECKD_TEST setList on off attr STECKD_TEST valueFn {$LASTCMD}
Beispiel aus diesem Forenthread übernommen. (Anmerkung: Die im Forenthread noch verwendete Lösung über setFN mit "readingsSingleUpdate" sowie valueFn {} ist nach Einführung von $LASTCMD in readingsProxy nicht mehr notwendig. Dementsprechend wurde hier die neuere Variante mit $LASTCMD genutzt)
Shellkommando zum Schalten verwenden
define <name> readingsProxy <name> attr <name> setList on off attr <name> setFn { fhem('"<shell command to execute> '. ($CMD eq 'on' ?'<on>':'<off>') .'"') }
Button für eine bestimmte Harmony Activity im Frontend und Homekit
siehe harmony
Links
- Forenthema zur Vorstellung des Moduls
- Forenthema zur Fragestellung "DS2408 Ports aufsplitten"
- Forenthema zur Fragestellung "Zwei Icons für Channel A und B"