at

at
Zweck / Funktion
Setzt einen Fhem-Befehl zu einem späteren Zeitpunkt ab.
Allgemein
Typ	Hilfsmodul
Details
Dokumentation	EN / DE
Modulname	90_at.pm
Ersteller	rudolfkoenig / rudolfkoenig
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

at ist ein Erweiterungsmodul, mit dessen Hilfe Fhem-Befehle/-Aktionen zu einem späteren Zeitpunkt ausgeführt werden können. Es läßt sich sowohl einmalige Ausführung, als auch regelmäßige Wiederholung erzielen, Zeitangaben können relativ oder absolut erfolgen.

Voraussetzungen

Keine.

Anwendung

Define

define <name> at <timespec|datespec> <command>

Beispiele

• define MeineAktion at 02:02:00 set lamp on → das nächste Mal um zwei Minuten nach 2 Uhr "lamp" einschalten
• define MeineAktion at *02:02:00 set lamp on → jeden Tag um zwei Minuten nach 2 Uhr "lamp" einschalten
• define MeineAktion at 2016-01-25T02:02:00 set lamp on → das nächste Mal am 25.01.2016 um zwei Minuten nach 2 Uhr "lamp" einschalten
• define MeineAktion at +02:02:00 set lamp on → in zwei Stunden und 2 Minuten "lamp" einschalten
• define MeineAktion at +*02:02:00 set lamp on → alle zwei Stunden und 2 Minuten "lamp" einschalten

Mehrere Aktionen ausführen

• set lampe1 on ; set lampe2 on → Schaltet sofort beide Lampen ein ( ein bisschen OT, weil kein at)
• define morgens at *7:00:00 set lampe1 on ; set lampe2 on → schaltet lampe 1 immer um 7 an, aber lampe2 sofort. Der erste Befehl landet in der config (im at) der zweite Befehl wird genau wie der define Befehl einfach sofort ausgeführt.
• define morgens at *7:00:00 set lampe1 on ;; set lampe2 on → schaltet BEIDE Lampen immer um 7 an. Beide Befehle landen in der config (im at), nur der define Befehl wird ausgeführt
• define morgens at *7:00:00 set lampe1,lampe2 on → schaltet BEIDE Lampen immer um 7 an. Geht nur wenn der gleiche Befehl an 2 oder mehr Geräte gesendet werden soll

Attribute

...

Testen

Versionsspezifisch: Der Befehl execNow ist in FHEM 5.7/90_at.pm ab 30.4.2016 verfügbar.

Mit dem Befehl

set <devspec> execNow

lässt sich eine at-Definition (einmalig, beispielsweise zu Testzwecken) unabhängig vom Erreichen der angegebenen Zeitspezifikation ausführen.

Anwendungsbeispiele

• at an einem bestimmten Wochentag ausführen
• at um eine Temperaturabhängige Nachtabsenkung zu realisieren
• at zu einem absoluten Datum ausführen
• at in Verbindung mit SUNRISE_EL

Links

• Abfrage, ob at definiert ist: Beitrag