RandomTimer

Aus FHEMWiki
Version vom 27. März 2018, 12:32 Uhr von Ph1959de (Diskussion | Beiträge) (Modulowner aktualisiert)
RandomTimer
Zweck / Funktion
Generierung von "Zufallszeiten"
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Unterstützende Dienste/Kalendermodule
Modulname 98_RandomTimer.pm
Ersteller igami (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


RandomTimer ist ein Hilfsmodul, mit dem in einem bestimmten Zeitraum zu zufälligen Zeitpunkten Schaltvorgänge ausgelöst werden können (ähnlich der Funktionalität der FS20 ZSU).

Voraussetzungen

Keine speziellen Voraussetzungen erforderlich.

Anwendung

Define

Die Syntax für die Definition eines RandomTimer:

define <name> RandomTimer <timespec_start> <device> <timespec_stop> [<timeToSwitch>]

Parameterbedeutung:

name
Eindeutiger Name des anzulegenden RandomTimer.
timespec_start
Zeitpunkt, ab wann der Timer aktiv ist, im Format HH:MM:SS.
device
Der Name des Gerätes, das zu schalten ist.
timespec_stop
Zeitpunkt, ab wann der Timer nicht mehr aktiv ist, im Format HH:MM:SS.
timeToSwitch
Zeit zwischen zwei An- und Aus-Schaltvorgängen; Angabe in Sekunden zwischen 10 und 9999

Attribute

RandomTimer unterstützt die folgenden Attribute:

disableCond
Bedingungen, unter denen der RandomTimer nicht aktiv wird
Beispiel: (!isVerreist()) würde bedeuten, dass der RandomTimer nur aktiv wird, wenn der Status auf eine Abwesenheit hinweist.
keepDeviceAlive
Wenn dieses Attribut gesetzt ist, wird das Gerät bei Erreichen der Ende-Zeit nicht ausgeschaltet
onCmd
Befehl, der als Einschaltbefehl verwendet werden soll (Standardwert: set <device> on)
offCmd
Befehl, der als Ausschaltbefehl verwendet werden soll (Standardwert: set <device> off)
runonce
Legt fest, ob ... (ist in der commandref/RandomTimerAttributes (noch?) nicht beschrieben)
switchmode nnn/nnn
Wahrscheinlichkeit (in Promille), dass der on- bzw. off-Befehl wirklich gesendet wird. Standardwert: 800/200

Anwendungsbeispiel(e)

Ein mit

define ZufallsTimerTisch RandomTimer *{sunset_abs()} StehlampeTisch *{sunset_abs(3*3600)} 480

definierter RandomTimer beginnt bei Sonnenuntergang das Gerät StehlampeTisch alle 480 Sekunden Ein- bzw. Auszuschalten. Diese Schaltvorgänge stoppen 3 Stunden nach Sonnenuntergang.

Links