Notify

Todo: generelle Überarbeitung/Aktualisierung EVTPART..., Fehlerkontrolle, Formatierung

Notify, das mächtige Tool

Ein Versuch, die Funktionsweise von Notify verständlich zu erklären. Da ich nur ein KNX (EIB) System habe, beziehen sich alle meine Beispiele auf KNX.

WICHTIG: per Web editieren und den DEF Knopf benutzten. Damit wird der Perlcode einfacher.

Was ist notify? Notify ist eine der mächtigsten Funktionen bei Fhem. Sie dient dazu, Aktionen abhängig von einem anderen Status bzw. Ereignis auszulösen. Es ist damit möglich, Logikfunktionen im Fhem abzubilden.

Z.B.: das Licht in der Küche wird eingeschaltet ====> draus folgt, dass auch das Radio eingeschaltet wird.

Syntax von notify

define <name> notify <pattern> <command>

Das Pattern ist sehr wichtig. Hier steht der Name einer Definition auf die das notify reagiert. Wenn da z.B. Rollo1 steht, dann reagiert notify auf Rollo1 on und off und was es sonst noch alles gibt.

Wenn man mehrere Patterns möchte, kann man diese in Klammer schreiben (Rollo1|Rollo2|Steckdose5) als Trenner wird dann Pipe (|) genutzt.

Man kann auch mit Platzhaltern arbeiten.

• Rollo. ==> das notify reagiert auf alles was mit Rollo und einem weiteren beliebigen Zeichen anfängt. Also auf Rollo1 wie auch auf RolloG, aber nicht auf Rollo_wischundweg
• Rollo.* ==> das notify reagiert auf alles das mit Rollo beginnt.
• .*isch ==> Reagiere auf alles das mit isch aufhört (Tisch, Fisch)

TODO: Bitte korrigieren, regexp = regulärer Ausdruck statt "pattern"

Etwas schalten, wenn ein anderes Gerät geschaltet wird

Wenn man das obige mit KNX abbilden möchte, benötigt man auf der KNX Seite:

Vorbereitung

• Gruppenadresse (GA) für die Steckdose vom Radio (0/0/10)
• GA vom Licht (0/0/20)

Auf der Fhem Seite wird benötigt:

define RadioKueche EIB 0/0/10
define LichtKueche EIB 0/0/20

notify Befehl

define LichtamRadioan notify LichtKueche { fhem "set RadioKueche %" }

oder

define LichtamRadioan notify LichtKueche set RadioKueche %

Erklärung

• Der Begriff "LichtamRadioan" ist nur ein Platzhalter, damit das notify in Fhem verwaltet werden kann.
• "%" ist ein Platzhalter für den Zustand vom Pattern. % enthält ein "off" wenn das LichtKueche aus ist und ein "on" wenn das Licht eingeschaltet ist.
• "{ <perlcode> }" alles was zwischen {} steht ist Perl code. Perl kennt das Schlüsselwort Fhem. Das Schlüsselwort Fhem dient dazu, Fhem Befehle auszuführen. Es wird also der Fhem Befehl "set RadioKueche on/off" ausgeführt. on oder off ist abhängig vom Pattern. Der eigentliche Fhem Befehl muss in " " stehen.

Einschalten von mehreren Geräten/Lampen, wenn das Licht eingeschaltet wird

Vorbereitung

KNX:

• 3 GAs für drei Geräten bzw Lampen (0/0/30 0/0/31 0/0/32)

Fhem:

define LichtWZ EIB 0/0/30
define Steckdose1 EIB 0/0/31
define Steckdose2 EIB 0/0/32

notify Befehl

define SteckdoseWZein notify LichtWZ { fhem "set Steckdose1 %;;set Steckdose2 %" }

oder

define SteckdoseWZein notify LichtWZ set Steckdose1,Steckdose2 %

Erklärung

Wenn das LichtWZ eingeschaltet wird, dann werden auch die Steckdosen (1 und 2) eingeschaltet.

Einfache ODER Funktion

Eine einfache ODER Funktion kann sehr einfach realisiert werden

Vorbereitung

KNX:

• 3x GAs der abzufragende Werte (0/0/40 0/0/41 0/0/42)

Fhem:

define Licht1 EIB 0/0/40
define Licht2 EIB 0/0/41
define Steckdose EIB 0/0/42

notify Befehl

define SteckdoseWZein notify (Licht1|Licht2) set Steckdose %

oder

define SteckdoseWZein notify (Licht.) set Steckdose %

Erklärung

Die Werte in der Klammer (wichtig ist das »|«) sind die Rückgabewerte. Alternativ kann in diesem Beispiel auch »Licht.«  (zu beachten ist der Punkt) geschrieben werden. Der Punkt ist ein Platzhalter für ein Zeichen (kommt glaube ich von Perl)

Danach folgt der set Befehl. Wenn also das Licht1 oder Licht2 den Wert "on" hat, dann hat auch die Steckdose den Wert "on"

Einfache UND Funktion

Ob man dieses Konstrukt noch als einfach bezeichnen kann, wage ich mal zu bezeifeln. In Fhem fehlen Loggingfunktionen, die man alle selber mit Perl Code erstellen kann (Danke an MAZ). Dadurch ist Fhem zwar mächtig, wird aber für viele sehr kompliziert.

In diesem Beispiel soll - wenn drei Rollos geschlossen sind - am Taster eine LED eingeschaltet werden.

Vorbereitung

KNX:

• 3x GDs für die Rückgabewert Rollo geschlossen == 1 (0/0/50 0/0/51 0/0/52)
• GD LED am Lichtschalter (0/0/106)

Fhem:

define R1ZU EIB 0/0/50
attr R1ZU dummy 1
define R2ZU EIB 0/0/51
attr R1ZU dummy 1
define R3ZU EIB 0/0/52
attr R1ZU dummy 1
define LEDalleRolloZu EIB 0/0/106

Durch das Atribut dummy werden keine Schaltfunktion angeboten. Es kann nur Werte anzeigen.

notify Befehl

define nt.allerolloszu notify (R1ZU|R2ZU|R6ZU) {
my $r1 = $value{"R1ZU"};;
my $r2 = $value{"R2ZU"};;
my $r3 = $value{"R6ZU"};;
if ($r1 eq "on" && $r2 eq "on" && $r3 eq "on") {
  fhem "set LEDalleRolloZu on"
} else {
  fhem "set LEDalleRolloZu off"
}
}

Erklärung

Es werden die drei Rückgabewerte R1ZU, R2ZU und R3ZU ausgewertet. Danach folgt Perl Code, deswegen beginnt das ganze mit einer { und endet mit }

my $r1 => Variable $r1 definieren

= $value{"R1ZU"};; ==> weist den Rückgabewert (on oder off) von R1ZU der Variable $r1 zu</nowiki>

Der doppelte ;; ist ein Fhem Thema. Eigendlich würde für Perl ein ; reichen. Aber Fhem nutzt selbst das ; und daher wird ein ;; benötigt. Mit den ersten drei my Zeilen werden die Rückgabewerte den Variabeln zugewiesen.

Danach erfolgt ein normales "if then else" Konstrukt. Die Zeile »($r1 eq "on" && $r2 eq "on" && $r3 eq "on")« kann man so lesen: Wenn $r1 den Wert "on" und (&&) $r2 den Wert "on" und $r3 den Wert "on" dann schalte die LEDalleRolloZu ein {fhem("set LEDalleRolloZu on")} ansonsten else schalte die LED aus. {fhem("set LEDalleRolloZu off")

Zeitverzögert schalten

Aufgabe:	Zeitverzögert schalten
Beschreibung:	Mit einem Notify zeitverzögert eine Aktion auslösen.
Vorbereitung:	Gerät "Lampe" ist definiert und es gibt eine Situation, die ein Ereignis "Fernbedienung:.*" generiert.
Befehl:	define ntfy1 notify Fernbedienung:.* sleep 7.5;; set Lampe $EVENT
Erläuterungen:	Bei Eintreten eines Ereignisses "Fernbedienung*" wird nach einer Pause von siebeneinhalb Sekunden der Befehl <set Lampe ??> ausgeführt, wobei der eigentliche Befehl aus dem auslösenden Ereignis übernommen wird. Quelle: Fhem Forum

Eine PV-Anlage (Solarstrom) zur Steuerung der Rollos nutzen (optional Zeit und Datums abhängig)

Hier ein kleines Beispiel, wie ich mit Hilfe meiner PV-Anlage die Sonneneinstrahlung auf der Südseite ermittele. Optional: Die Funktion soll allerdings nur zwischen 9:30 und 17:00 stattfinden. (zweites Beispiel) Optional: Die Funktion soll nur zwischen dem 6 und 9 Monat funktioneren. (drittes Beispiel)

Vorbereitung

PV Anlage mit SolarView abfragen. Per Hand ermitteln, ab wieviel erzeugtem Strom es sinnvoll ist die Rollos zu schließen.

notify Syntax

Fhem:

define sv SolarView solarview 15000 wr1 wr2 wr3 wr4 (ich habe vier Wechselrichter)

attr sv event-on-change-reading currentPower (weis nicht ob es wirklich benötigt wird)

define nt.sonnenlichtpersolar notify (sv:currentPower.*) { 
if (%EVTPART1 < 3000 ) {
 fhem('set Flur1 Auf');
}else {
 if (%EVTPART1 > 5000 ) {
 fhem('set Flur1 Ab');
 } 
 }
}

Optional 1: Zeitabhängig

(sv:currentPower.*) { 
my $hm = sprintf("%%02d:%%02d", $hour, $min);
if ( $hm gt "09:30" && $hm lt "17:00") { 
 if (%EVTPART1 < 5000 ) {
  fhem('set Flur1 Auf');
  }else {
  if (%EVTPART1 > 8000 ) {
  fhem('set Flur1 Ab');
  } 
  }
 }
}

Optional 2: Zeit und Datum

(sv:currentPower.*) { 
my $hm = sprintf("%%02d:%%02d", $hour, $min);
if( $month ge "6" && $month le "9") {
 if ( $hm gt "09:30" && $hm lt "17:00") { 
 if (%EVTPART1 < 5000 ) {
  fhem('set Flur1,RBUERO1,RBUERO2 Auf');
  }else {
  if (%EVTPART1 > 8000 ) {
  fhem('set Flur1,Flur2,RBUERO1,RBUERO2 Ab');
  } 
  }
 }
 }
}

Erklärung

• Das define wird in der Kommandozeile im Webbrowser eingegeben.
• Anschliessend wird im Webbrowser die DEF bearbeitet, das erspart uns Probleme mit Perl
• define sv SolarView ... <==== ist die Schnittstelle vom SolarView
• define nt.sonnenlichtpersolar notify (sv:currentPower.*) { <==== hier wird ein notify angelegt, der auf das "define sv" Wert "currentPower.*" (.* ist irgendwas) reagiert

if (%EVTPART1 < 3000 ) {
 fhem('set Flur1 Auf');
}else {
 if (%EVTPART1 > 5000 ) {
 fhem('set Flur1 Ab');
 } 
 }
}

Diese IF Funktion wertet den Rückgabewert von currentPower aus. Hierbei muss man wissen, dass %EVTPART1 das Splitergebnis vom Rückgabewert ist

Beispiel: Der Rückgabewert (wie im Beispiel) ist "currentPower: 6000". Jetzt steht im "%EVTPART0 == currentPower:" und im "%EVTPART1 == 6000" Das bedeutet wir müssen uns nicht selbst den richtigen split (Perl Befehl) Aufruf ausdenken, das übernimmt Fhem.

Ergebnis der ganzen Aktion: Das Rollo wird abhängig von der erzeugten IST_Strommenge auf und zu gefahren. Damit dies nicht dauernd hin und her pendelt, habe ich den Auf Wert sehr klein und den Ab Wert sehr groß gewählt.

Optional 1: Der Block "my $hm == sprintf("%%02d:%%02d", $hour, $min);" erzeugt die Variable $hm mit dem Inhalt $hour:$min. %02d (wegen Fhem besonderheit %%02d) begrenzt die Ausgabe auf zwei Stellen (hab jetzt hoffentlich nichts Falsches geschrieben). Danach wird mit "if ( $hm gt "09:30" && $hm lt "17:00") " geprüft, ob die Uhrzeit zwischen 9:30 und 17:00 liegt. lt == kleiner als; gt größer als. Es wäre auch ein le und ge möglich: le == kleiner/gleich als, ge == größer/gleich als.

Optional 2:if( $month ge "6" && $month le "9") {

Hier frage ich die Default Variable $month (Monat) auf größer/gleich bzw kleiner/gleich ab. Die Funktion arbeitet also nur zwischen dem sechsten und dem neunten Monat und dann auch nur zwischen 9:31 und 16:59.

Hinweise

Achtung! Wenn man das Skript für den notify-Befehl über mehrere Zeilen schreibt, muss man anscheinend darauf achten, dass keine abschliessende Leerzeile mitgespeichert wird. Sonst wird der notify-Befehl ignoriert.

Weiterführende Links

• Escapen in Perlbefehlen
• Klammerebenen