Event

Aus FHEMWiki

Definition

Ein Event (Ereignis) ist eine Nachricht die vom FHEM-Server gesendet wird.
Das Event enthält Informationen über den Zustand eines Gerätes (Device).
Der Anstoss zum Senden eines Events geht vom Gerät aus.
Ein Event beinhaltet den Zeitpunkt der Entstehung seines Inhalts.

Aufbau

Events sind wie folgt aufgebaut:

<Datum> <Uhrzeit> <TYPE> <Gerätename> ⟨<Readingname>: ⟩<Wert>

Beispiele

Beispiel eines globalen Events, bei dem der Readingname fehlt:

2016-12-13 11:40:33.240 Global global MODIFIED Test
  • Datum: 2016-12-13
  • Uhrzeit: 11:40:33.240
  • TYPE: Global
  • Gerätename: global
  • Wert: MODIFIED Test

Beispiel eines Geräte-Events mit Readingname:

2016-12-13 11:48:26.836 PRESENCE LaptopAn presence: present
  • Datum: 2016-12-13
  • Uhrzeit: 11:48:26.836
  • TYPE: PRESENCE
  • Gerätename: LaptopAn
  • Readingname present
  • Wert: present

Verwendung

Events stehen allen Geräten des FHEM-Servers zur Weiterverarbeitung zur Verfügung. Einige Gerätetypen erfordern die Angabe von Ereignisfiltern in Form eines regulären Ausdrucks. Im Gerät werden dann nur die gefilterten Events in die Weiterverarbeitung einbezogen, das sind z.B.

Zur Erstellung eines Ereignisfilter ist die genaue Kenntnis über den Inhalt eines Events erforderlich. Die aktuellen Ereignisse können im Eventmonitor angezeigt werden. Der Befehl Trigger simuliert den Anstoss eines Gerätes an den FHEM-Server ein Event zu senden.

Links