Timehandler: Unterschied zwischen den Versionen

Aus FHEMWiki
(Die Seite wurde neu angelegt: „== Definition == Timehandler, auch als Timer bezeichnet, reagieren auf Zeitangaben, verarbeiten sie und liefern ein Ergebnis. == Benutzersicht == Aus…“)
 
K (Haupt-Kategorie FHEM entfernt; ist bereits über Kategoriebaum abgedeckt.)
 
(14 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 3: Zeile 3:


== Benutzersicht ==
== Benutzersicht ==
Aus Benutzersicht sind es [[Module]], bzw. deren [[Gerät|Geräte]], die es erlauben Zeitangaben, die ausgelöste Verarbeitung, das Ergebnis oder Teilaspekte dieser Parameter selbst zu bestimmen.
Aus Benutzersicht sind es [[Modul|Module]], bzw. deren [[Gerät|Geräte]], die es erlauben Zeitangaben, die ausgelöste Verarbeitung, das Ergebnis oder Teilaspekte dieser Parameter selbst zu bestimmen.


=== Allgemeine Timehandler ===
=== Allgemeine Timehandler ===
Allgemeine Timehandler geben dem Benutzer die Möglichkeit die Zeitangaben, die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden Modulen der Fall.
Allgemeine Timehandler geben dem Benutzer die Möglichkeit die Zeitangaben, die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden [[Modul|Modulen]] der Fall.


* [[at]]<ref>{{Link2CmdRef|Anker=at|Lang=de|Label=at}}</ref>
* [[at]]<ref>{{Link2CmdRef|Anker=at|Lang=de}}</ref> Eine Anweisung zu einem späteren Zeitpunkt starten und ggf. wiederholen
* [[DOIF]]<ref>{{Link2CmdRef|Anker=DOIF_|Lang=de|Label=DOIF}}</ref>
* [[DOIF]]<ref>{{Link2CmdRef|Anker=DOIF_|Lang=de}}</ref> universelles [[Modul]], welches ereignis- und zeitgesteuert Anweisungen ausführt
* [[WeekdayTimer]]<ref>{{Link2CmdRef|Anker=WeekdayTimer|Lang=en}}</ref> Eine Art Wochenzeitschaltuhr, die auf Basis einer Liste mit festen oder astronomischen Zeiten Parameter an Devices sendet oder sonstige Anweisungen ausführt.


=== Spezielle Timehandler ===
=== Spezielle Timehandler ===
Spezielle Timehandler dienen der Lösung besonderer wiederkehrender Aufgaben, der Benutzer hat nur eingeschränkte Möglichkeiten die Verarbeitung, das Ergebnis oder Teile davon selbst zu bestimmen. Das ist bei den folgenden Modulen der Fall.
Spezielle Timehandler bieten Lösungen für typische Anwendungsfälle. Das ist bei den folgenden [[Modul|Modulen]] der Fall.


* [[alarmclock]]<ref>{{Link2CmdRef|Anker=alarmclock|Lang=en|Label=alarmclock}}</ref>
* [[alarmclock]]<ref>{{Link2CmdRef|Anker=alarmclock|Lang=en}}</ref> FHEM Weckermodul
* [[Heating_Control]]<ref>{{Link2CmdRef|Anker=Heating_Control|Lang=de|Label=Heating_Control}}</ref>
* [[Heating_Control]]<ref>{{Link2CmdRef|Anker=Heating_Control|Lang=de}}</ref> sendet Temperaturwerte zu festgelegen Zeiten an eine Heizung (deprecated, es sollte stattdessen WeekdayTimer genutzt werden; dieser bietet dieselbe Funktionalität).
* [[WeekdayTimer]]<ref>{{Link2CmdRef|Anker=WeekdayTimer|Lang=en|Label=WeekdayTimer}}</ref>
* [[RandomTimer]]<ref>{{Link2CmdRef|Anker=RandomTimer|Lang=en}}</ref> bildet die Zufallsfunktion einer Zeitschaltuhr (FS20 ZSU) nach.


=== Bedienung ===
=== Bedienung ===
Zeile 24: Zeile 25:
==== Zeitangaben ====
==== Zeitangaben ====
Wenn Zeitangaben und Echtzeit übereinstimmen, dann startet die Verarbeitung und ein Ergebnis wird geliefert.
Wenn Zeitangaben und Echtzeit übereinstimmen, dann startet die Verarbeitung und ein Ergebnis wird geliefert.
Die Syntax der verschiedenen [[Module]] ist unterschiedlich sie in der {{Link2CmdRef|Anker=doctop|Lang=de|Label=Befehlereferenz}} angegeben.
Die Syntax der verschiedenen [[Modul|Module]] ist unterschiedlich, sie ist in der {{Link2CmdRef|Anker=doctop|Lang=de|Label=Befehlsreferenz}} angegeben.


==== Verarbeitung ====
==== Verarbeitung ====
Zeile 30: Zeile 31:


==== Ergebnis ====
==== Ergebnis ====
Als Ergebnis der Zeitverarbeitung werden Befehle ausgeführt, die {{Link2CmdRef|Anker=command|Lang=de|Label=FHEM-Befehlstypen}} sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlereferenz}} beschrieben.
Als Ergebnis der Zeitverarbeitung werden Befehle ausgeführt, die {{Link2CmdRef|Anker=command|Lang=de|Label=FHEM-Befehlstypen}} sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlsreferenz}} beschrieben.


* FHEM-Befehle, sie werden direkt angegben und sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlereferenz}} im Abschnitt '''FHEM-Befehle''' zu finden.
* FHEM-Befehle, sie werden direkt angegben und sind in der {{Link2CmdRef|Anker=command|Lang=de|Label=Befehlsreferenz}} im Abschnitt '''FHEM-Befehle''' zu finden.
* Shellbefehle, sie werden durch doppelte Anführungszeichen <code>"<Shellbefehle>"</code> eingeschlossen.
* Shellbefehle, sie werden durch doppelte Anführungszeichen <code>"<Shellbefehle>"</code> eingeschlossen.
* Perlausdrücke, sie werden von geschweiften Klammern <code>{<Perlausdrücke>}</code> eingeschlossen.
* Perlausdrücke, sie werden von geschweiften Klammern <code>{<Perlausdrücke>}</code> eingeschlossen.
Zeile 44: Zeile 45:


== Links ==
== Links ==
* [[Eventhandler]]
<references />
<references />


[[Kategorie:FHEM-Verwendung]]
[[Kategorie:Glossary]]
[[Kategorie:Glossary]]

Aktuelle Version vom 4. Dezember 2019, 12:33 Uhr

Definition

Timehandler, auch als Timer bezeichnet, reagieren auf Zeitangaben, verarbeiten sie und liefern ein Ergebnis.

Benutzersicht

Aus Benutzersicht sind es Module, bzw. deren Geräte, die es erlauben Zeitangaben, die ausgelöste Verarbeitung, das Ergebnis oder Teilaspekte dieser Parameter selbst zu bestimmen.

Allgemeine Timehandler

Allgemeine Timehandler geben dem Benutzer die Möglichkeit die Zeitangaben, die Verarbeitung und das Ergebnis selbst zu bestimmen. Das ist bei den folgenden Modulen der Fall.

  • at[1] Eine Anweisung zu einem späteren Zeitpunkt starten und ggf. wiederholen
  • DOIF[2] universelles Modul, welches ereignis- und zeitgesteuert Anweisungen ausführt
  • WeekdayTimer[3] Eine Art Wochenzeitschaltuhr, die auf Basis einer Liste mit festen oder astronomischen Zeiten Parameter an Devices sendet oder sonstige Anweisungen ausführt.

Spezielle Timehandler

Spezielle Timehandler bieten Lösungen für typische Anwendungsfälle. Das ist bei den folgenden Modulen der Fall.

  • alarmclock[4] FHEM Weckermodul
  • Heating_Control[5] sendet Temperaturwerte zu festgelegen Zeiten an eine Heizung (deprecated, es sollte stattdessen WeekdayTimer genutzt werden; dieser bietet dieselbe Funktionalität).
  • RandomTimer[6] bildet die Zufallsfunktion einer Zeitschaltuhr (FS20 ZSU) nach.

Bedienung

Es sind Zeitpunkte oder Zeitspannen direkt oder indirekt anzugeben. Die Verarbeitung ist zu beschreiben und das daraus resultierenden Ergebnis ist festzulegen.

Zeitangaben

Wenn Zeitangaben und Echtzeit übereinstimmen, dann startet die Verarbeitung und ein Ergebnis wird geliefert. Die Syntax der verschiedenen Module ist unterschiedlich, sie ist in der Befehlsreferenz angegeben.

Verarbeitung

Die Verarbeitung beinhaltet die Entscheidung welche Befehle ausgeführt werden sollen. Bei der Entscheidungsfindung können die in FHEM vorhandenen Größen und Werte berücksichtigt werden. Die Verküpfung erfolgt durch die vom jeweiligen Timehandler bereitgestellten Möglichkeiten und Perlausdrücke[7].

Ergebnis

Als Ergebnis der Zeitverarbeitung werden Befehle ausgeführt, die FHEM-Befehlstypen sind in der Befehlsreferenz beschrieben.

  • FHEM-Befehle, sie werden direkt angegben und sind in der Befehlsreferenz im Abschnitt FHEM-Befehle zu finden.
  • Shellbefehle, sie werden durch doppelte Anführungszeichen "<Shellbefehle>" eingeschlossen.
  • Perlausdrücke, sie werden von geschweiften Klammern {<Perlausdrücke>} eingeschlossen.

Entwicklungssicht

Aus Entwicklungssicht sind es Funktionen der Modul-API, die Timer behandeln.

Links