FHEM Geräte mittels Google Kalender schalten

Nachdem ich aus meinem Urlaub zurück bin will ich die Gelegenheit direkt einmal nutzen, meine Urlaubsschaltung als Anregung für die Schaltung von Geräten mittels Google Kalender darzustellen. Auf Grund der kürzlichen Änderung des Kalender-Moduls musste ich meine bisherige Urlaubsschaltung leicht modifizieren und habe das zum Anlass genommen, direkt eine etwas generischere Funktion zu realisieren.

FHEM Device mittels Kalender schalten

Kalendermodul und seine Ereignisse

Das FHEM Kalendermodul sendet zu den Terminen des verknüpften Kalenders diverse Ereignisse. So wird z.b. „triggered“ gesendet, sobald der Kalender sich updated. Wird ein Kalendereintrag geändert, so wird ein „changed“ Ereignis gesendet. Die interessantesten Ereignisse sind sicherlich „start“ und „end“, die den Start und das Ende eines konkreten Termins signalisieren.

Diese Ereignisse können mittels einer notify-Definition nun ganz einfach zur Schaltung von Geräten in der FHEM Haussteuerung genutzt werden. Für unser Beispiel nehmen wir an, dass wir einen speziellen Google Kalender „Kalender_Aktionen“ für diese Funktion definiert haben.

In FHEM wird dieser Kalender dann mit folgendem Befehl eingebunden:

define Kalender_Aktion CALENDAR ical url https://www.google.com/calendar/ical/euregooglecalenderurl.calendar.google.com/private-euercode/basic.ics 14400 

Mit der Angabe 14400 wird der Kalender alle 4 Stunden aktualisiert. Das sollte in der Regel ausreichend sein und dient in erster Linie der Ermittlung von Kalenderänderungen.

Auf ein Kalender-Ereignis reagieren

Nun wollen wir ja feststellen, wann ein Termin startet oder beendet wird. Hierzu wird ein entsprechendes notify definiert. In meinem Fall frage ich beide Zustände mit einem notify-Befehl ab. Man könnte natürlich aber jeweils ein notify für den Start bzw. das Ende eines Termin definieren.

define notKalender_Aktion notify Kalender_Aktion:(start|end):.* { KalenderAktion($EVTPART0, $EVTPART1)}

In den geschweiften Klammern habe ich meine Funktion eingefügt, die sich dann um die konkrete Steuerung kümmert. Im einfachsten Fall könnte man die Schaltaktion auch direkt hier eintragen und keine extra Funktion aufrufen. In der Kalendermodulbeschreibung gibt es ein entsprechendes Beispiel, so dass ich hier nicht näher darauf eingehe.

Ich wollte aber eine etwas generischere Funktion nutzen und zum Beispiel nicht die Devicenamen selbst in den Kalender eintragen. Für meine Urlaubsschaltung nutze ich z.B. einen Dummy. Meine Dummy beginnen immer mit „du“, so dass der Name also „duUrlaub“ lautet. Im Kalender möchte ich aber nur „Urlaub“ oder „Besuch“ eintragen und damit entsprechende Aktionen schalten.

Funktion zur Steuerung der Aktionen

Damit die nachfolgend dargestellte Funktion ihren Dienst auch korrekt vollzieht, sollten die zu schaltenden Geräte mittels „on“ und „off“ ein- bzw. ausgeschaltet werden können. Dies ist eigentlich bei den meisten Geräten der Fall. Bei der ursprünglichen Definition meines Urlaubs Dummy hatte ich aber die Werte „ja“ und „nein“ mit einem „setlist“ definiert. In diesem Fall musste ich mit dem Attribut „EventMap“ noch eine entsprechende Übersetzung einbauen (ja:on nein:off).

Die Kalender Funktion zur Steuerung der FHEM Geräte sieht nun wie folgt aus und sollte sich hoffentlich selbst erklären:

#
# Kalenderfunktion zur zeitgesteuerten Schaltung von Devices
#
sub
KalenderAktion($$)
{
   my ($KalenderEreignis, $KalenderUids) = @_;
   my @uids=split(/;/,$KalenderUids);
   my $aktion;
   my @DeviceList = ("Urlaub","Besuch"); #Einträge im Kalender
   my @DeviceNames = ("duUrlaub", "duGast"); #Übersetzung zum Device

   if($KalenderEreignis eq "start:") { $aktion = "on" } else { $aktion = "off" }

   #falls mehrere Termine gleichzeitig starten, diese nun durchlaufen
   foreach my $uid (@uids)
   {
      #Summary auslesen und prüfen, ob es sich um ein Device handelt
      my $Device = fhem("get Kalender_Aktion summary $uid");

      #falls das Device existiert, so wie es im Kalender steht kann die Schaltung direkt erfolgen
      if( defined($defs{$Device}) )
      {  fhem("set $Device $aktion"); }
      else
      {
         #wenn ein entsprechendes Device gefunden wird
         if (true { /$Device/ } @DeviceList)
         { fhem("set $DeviceNames[ first_index { /$Device/ } @DeviceList ] $aktion"); }
      }
   }
}

Damit nun die Geräte zum richtigen Zeitpunkt geschaltet werden trägt man nur die entsprechenden Bezeichnungen im Google Kalender ein. Natürlich könnte man die Funktion noch erweitern, um komplexere Schaltungen zu realisieren. Wenn Geräte z.B. nicht nur einfach mittels on/off geschaltet werden können, müsste man diese explizit abfragen und die entsprechende Schaltfunktion einbauen.

Denkbar ist auch die Ergänzung der Kalendereinträge um weitere Schaltinformationen. So könnte man z.B. eintragen „Devicename on-for-timer 300“. In diesem Fall muß man dann den Summary noch weiter untersuchen und die Aktion entsprechend anpassen.

Ich selbst nutze die Funktion allerdings aktuell tatsächlich in erster Linie für eine spezielle Steuerung meiner Geräte während der Urlaubsabwesenheit. So wird der Wecker ignoriert und die Rolladen zu einer festgelegten Zeit hochgefahren oder Abends per Zufallssteuerung das Flurlicht geschaltet.