SmartHome mit FHEM – Umsetzung meines Abfallkalenders

Wie versprochen, werde ich demnächst immer wieder mal meine FHEM-Lösungen im Detail vorstellen. Lösungen für das Thema „Abfallkalender“ werden immer wieder angefragt, so dass ich meine FHEM-Reihe damit beginnen möchte. Wie in meinen vorherigen Artikeln beschrieben, ist die Basis meines FHEM ein Raspberry Pi2 und ich schalte neben ein paar Fritz!Dect Steckdosen in erster Linie Homematic Geräte.

Als Oberfläche für mein Android Tablet, welches im Flur an der Wand hängt, nutze ich die relativ neue Lösung FHEM Tablet UI (FTUI) aus der Community. Meiner Ansicht nach aktuell die beste und am einfachsten umzusetzende Oberfläche für die Haussteuerung mit FHEM.

Auf dem Startscreen meiner FHEM Oberfläche, habe ich einige Infos, die neben den wichtigsten Schaltoptionen angezeigt werden. Hier ist auch meine Umsetzung des Abfallkalenders zu finden. Ich habe mich dazu entschieden, alle unsere Mülltonnen sowie die Anzahl Tage bis zur Abfuhr anzuzeigen. Was man im Screenshot leider nicht erkennt, sind die drehenden Icons der Mülltonne, die am Abend noch raus gestellt werden muss.

Nachdem wir bereits in letzter Zeit übersehen hatten, dass die Termine – auf Grund von Feiertagen – nach Vorne verschoben wurden, habe ich nun auch noch eine Sprachausgabe über meine Sonos Geräte eingebaut. Sobald Abends nach 22:00 Uhr der Fernseher ausgeschaltet wird, erkennt FHEM dies als Schlafmodus und führt entsprechende Schaltvorgänge aus. Hierzu gehört dann auch noch eine Warnmeldung, dass Mülltonnen raus zu stellen sind. Ein Blick auf die drehenden Icons zeigt dann, welche Mülltonne am nächsten Tag abgeholt wird.

Nachfolgend beschreibe ich meine Umsetzung nun Schritt für Schritt.

Basis des Abfallkalenders ist ein Google Kalender

Innerhalb Google habe ich mir einen eigenen Kalender „Abfall“ eingerichtet. Ich denke, dass ich hier nicht näher ausführen muss, wie das funktioniert. Unser Abfuhrunternehmen bietet einen Kalender, den man als iCalender Datei herunter laden und dann bei Google importieren kann.

Hierzu geht man im Google Kalender in die Einstellungen und wählt dort die Funktion „importieren“ aus. Nun kann man in einem Dialog die Datei auswählen und angeben, in welchen Kalender der Import durchgeführt werden soll.

Nun muss dieser Kalender noch im FHEM bekannt gemacht werden. Dies geschieht mit dem Modul „Calendar„. Bei der Definition wird eine URL benötigt, die man sich wieder bei Google besorgen kann. Für den Kalender „Abfall“ ruft man die Einstellungsseite auf und dann findet man im unteren Bereich die Einträge „Kalenderadresse“ und „Privatadresse“. Da der Kalender in der Regel nicht öffentlich verfügbar gemacht wird, muss also die „Privatadresse“ genutzt werden. Mit einem Klick auf den ical-Button kann man sich den Link anzeigen lassen und für die Verwendung in FHEM kopieren.

Der FHEM Befehl für die Definition des Kalenders sieht dann so aus:

define Abfall Calendar ical url https://www.google.com/calendar/ical/veuhdbcagdpbs234fnfes11d9g%40group.calendar.google.com/private-f0412f72xxxxxxxxxxxxxxx87a226/basic.ics 21600

Mit dem Intervall 21600 wird der Kalender nun alle 6 Stunden aktualisiert.

Abfall Kalender auswerten

Im nächsten Schritt muss nun ein notify in FHEM definiert werden, damit aktuelle Termine erkannt werden. Innerhalb meines notify-Befehls rufe ich eine Funktion zur Auswertung der Kalenderinformationen auf.

(UPDATE 09.02.16) Auf Grund des geänderten Calendar-Moduls funktioniert der bisherige Code leider nicht mehr richtig. Sowohl das notifify wie auch die Funktion Abfalltermine habe ich daher geändert, so dass nun hoffentlich wieder alles läuft.

Voraussetzung für die Anpassungen ist, dass man beim Calendar die vergangenen Termine „versteckt“. Dies geschieht mit folgender Einstellung:

attr Abfall hideOlderThan 2d

Damit werden nur Termine berücksichtigt, die maximal 2 Tage zurück liegen. Der notify prüft nun auf jede Änderung (triggered) und die Funktion Abfalltermine benötigt keine Parameter.
(UPDATE ENDE)

(UPDATE 17.04.16) Das Attribut hideOlderThan sollte möglichst auf einen sehr kurzen Zeitraum gesetzt werden. Ich verwende im Mpment 10 Sekunden. Also „attr Abfall hideOlderThan 10“.(UPDATE ENDE)

define notAbfalltermine notify Abfall:triggered { Abfalltermine() }

Der oben definierte notify reagiert auf alle Ereignisse eines Kalenders (siehe Referenz von Calendar).

Die Funktion „Abfalltermine“ wird in der Datei „99_myUtils.pm“ definiert und sieht wie folgt aus. Als Basis habe ich eine Funktion einer Beschreibung aus der Community genutzt.

(UPDATE) Ich hatte die Funktion „KalenderDatum“ in der ursprünglichen Beschreibung vergessen. Nun ist die Funktion im folgenden Codebeispiel zu finden.(ENDE UPDATE)

(UPDATE 08.02.16) Seit gestern gibt es ein modifiziertes Kalendermodul. Daher sollten ein paar Anpassungen im Code vorgenommen werden. Bei den get-Aufrufen für den Kalender bekommt man bei Serienterminen nun möglicherweise mehrere Termine für eine einzelne uid zurück geliefert. Damit das nicht passiert sollten die entsprechenden Aufrufe in „get $Kalendername uid=$KanderUid 1 angepasst werden. Im Code habe ich die Änderungen entsprechend eingebaut.(UPDATE)

(UPDATE 09.02.16) Geändert wurde die Funktion Abfalltermine. Gleichzeitig habe ich versucht, die Funktion ein wenig zu generalisieren, wodurch sie auch deutlich kleiner geworden ist. Man muß nun nur noch die beiden Arrays Tonnen und Suchtexte an die eigenen Bedürfnisse anpassen und natürlich den Dummy „MuellterminDummy“ nutzen.(UPDATE ENDE)

(UPDATE 11.02.16)Zunächst einmal muß ich mich für die vielen Updates entschuldigen, aber die Änderung des Calendar Moduls und meine bescheidenen PErl-Kenntnisse ärgern mich gerade ein wenig ;-). Nachdem mein Abfallkalender heute Minuswerte und keine Icons angezeigt hat, musste ich mir das Ganze nochmal ansehen und die nachfolgenden Funktionen komplett anpassen. Die Einstellung im Kalender, damit ältere Termine als 2 Tage nicht angezeigt werden ist natürlich Quatsch gewesen. Am Folgetag nach der Abholung erscheint der Termin immer noch bei „modeEnd“ und wird auch bei „find“ gefunden (ob das wohl richtig ist?). Versucht man dann aber das Startdatum zu ermitteln bekommt man keine Werte zurück geliefert. Also habe ich nun die Funktionen so angepasst, dass nach dem Termin mit dem nächsten Datum gesucht wird. Ich hoffe, dass damit nun alle Probleme, die durch das neue Calendar-Modul entstanden sind behoben sind. Am besten ihr kopiert euch die beiden Funktionen „KalenderDatum“ und „Abfalltermine“ in eure myUtils.(UPDATE ENDE)

(UPDATE 14.02.16) Da es im Moment bei einigen Konstellationen immer noch ein paar Probleme gibt, habe ich nochmal eine optimierte Version meiner Funktionen unten in den Kommentaren dokumentiert. Bei der neuen Funktion sollten immer die nächsten Termine gefunden werden, egal in welcher Reihenfolge die Termine durch das Calendar-Modul geliefert werden. Vielleicht könnt ihr die Funktionen nochmals testen, bevor ich sie hier im Text anpassen.(UPDATE ENDE)

(UPDATE 16.04.16) Nachdem meine letzten Änderungen bei mir aktuell ohne Probleme laufen, habe ich nachfolgend die beiden Funktionen nochmals angepasst. Es wird nun auch am Abholtag eine „0“ angezeigt.(UPDATE)

(UPDATE 06.11.21) In der Funktion Kalenderdatum habe ich eine kleine Anpassung vorgenommen (UPDATE ENDE)

#
# Hilfsfunktion für Kalenderauswertungen
#

sub
KalenderDatum($)
{
   my ($KalenderName, $KalenderUid) = @_;
   #ALTER CODE my $dt = fhem("get $KalenderName start uid=$KalenderUid 1");
   my $dt = fhem('get '.$KalenderName.' events format:custom="$T1" filter:uid=="'.$KalenderUid.'" limit:count=1',1);
   my $ret = time - (2*86400); # falls kein Datum ermittelt wird Rückgabewert auf "vorgestern" -> also vergangener Termin

   if ($dt and $dt ne "")
   {
      my @SplitDt = split(/ /,$dt);
      my @SplitDate = split(/\./,$SplitDt[0]);
      $ret = timelocal(0,0,0,$SplitDate[0],$SplitDate[1]-1,$SplitDate[2]);
   }

   return $ret;
}

#
# Abfall Kalender auswerten / Google Kalender: "Abfall"
#

sub
Abfalltermine()
{
   my $t  = time;
   my @Tonnen = ("GrueneTonne", "GelbeTonne", "Restmuell", "BioTonne");
   my @SuchTexte = (".*Papier.*", ".*Wertstoff.*", ".*Restmüll.*", ".*Bio.*");
   my $uid;
   my $dayDiff;

   for(my $i=0; $i<4; $i++)
   {
      $dayDiff = -1; #BUG behoben
      my @uids = split(/;/,fhem("get Abfall find $SuchTexte[$i]"));

      # den nächsten Termine finden
      foreach $uid (@uids)
      {
         my $eventDate = KalenderDatum('Abfall', $uid);
         my $dayDiffNeu = floor(($eventDate - $t) / 60 / 60 / 24 + 1);
         if ($dayDiffNeu >= 0 && ($dayDiffNeu < $dayDiff || $dayDiff == -1)) #BUG behoben
         {
            $dayDiff = $dayDiffNeu;
         }
      }

      fhem("setreading MuellterminDummy $Tonnen[$i] $dayDiff");
   }
}

In jedem Kalendereintrag wird nun überprüft, welcher Mülleimer eingetragen ist und dann die Anzahl Tage bis zur nächsten Abfuhr ermittelt. Den entsprechenden Wert habe ich in einem Dummy gespeichert.

define MuellterminDummy dummy

Darstellung im FHEM Tablet UI

Mit den bisherigen Definition wird nun regelmäßig festgestellt, wann eine Mülltonne geleert wird und nun muss diese Infos nur noch sinnvoll dargestellt werden. Der entsprechende Code für das Tablet UI, der in meinem Fall in der index.html definiert wurde sieht wie folgt aus:

<li data-row="4" data-col="2" data-sizex="3" data-sizey="1">
<header><div data-type="label" class="large">Abfall</div></header>
	<div	data-type="symbol"
		data-device="MuellterminDummy"
		data-get="BioTonne"
		data-icons='["fa-trash warn fa-spin","fa-trash warn"]'
		data-on-colors='["SaddleBrown","SaddleBrown"]'
		data-get-on='["0","2"]'
		data-background-icon="fa-circle"
		class="bigger inline" >
	</div>
	<div 	data-type="symbol"
		data-device="MuellterminDummy"
		data-get="GelbeTonne"
		data-icons='["fa-trash warn fa-spin","fa-trash warn"]'
		data-on-colors='["yellow","yellow"]'
		data-get-on='["0","2"]'
		data-background-icon="fa-circle"
		class="bigger inline" >
	</div>
	<div 	data-type="symbol"
		data-device="MuellterminDummy"
		data-get="GrueneTonne"
		data-icons='["fa-trash warn fa-spin","fa-trash warn"]'
		data-on-colors='["green","green"]'
		data-get-on='["0","2"]'
		data-background-icon="fa-circle"
		class="bigger inline" >
	</div>
	<div 	data-type="symbol"
		data-device="MuellterminDummy"
		data-get="Restmuell"
		data-icons='["fa-trash warn fa-spin","fa-trash warn"]'
		data-on-colors='["black","black"]'
		data-get-on='["0","2"]'
		data-background-icon="fa-circle"
		class="bigger inline" >
	</div>
</li>

Zur Darstellung habe ich das FTUI Symbol-Widget verwendet. Als Device nutze ich den definierten Dummy „MuellterminDummy“ aus dem dann die Readings für die jeweiligen Mülleimer zur Ermittlung Abfuhrzeiten (Anzahl Tage) gelesen werden. Die Tage werden dann mittels der Klasse „warn“ im Symbol angezeigt und mit den Array-Definitionen bei data-icons, data-on-colors und data-get-on sorge ich dafür, dass das Symbol sich einen Tag vor der Abfuhr dreht (Klasse „fa-spin“).

Zusätzliche Hinweise einbauen

Je nach eigener FHEM-Umgebung kann man sich nun noch weitere Hinweise einbauen, um an die Abfalltermine erinnert zu werden. Wie eingangs erläutert nutze ich eine „Schlaffunktion“ aus der heraus ich auch noch eine Sprachausgabe auf meinen Sonos Geräten starte. In der Funktion für die Schlafsteuerung rufe ich die Funktion „SprachansageAbfall“ auf, die wie folgt aussieht.

sub SprachansageAbfall()
{

if(ReadingsVal("MuellterminDummy", "BioTonne", "2") <= 1 or
ReadingsVal("MuellterminDummy", "GelbeTonne", "2") <= 1 or
ReadingsVal("MuellterminDummy", "GrueneTonne", "2") <= 1 or
ReadingsVal("MuellterminDummy", "Restmuell", "2") <= 1)
{
fhem("set Sonos_Kueche,Sonos_Bad Speak 50 de Achtung Achtung Die Mülltonnen müssen raus gestellt werden");
};

}

Bei der Sprachausgabe habe ich mich darauf beschränkt, nur allgemein das Herausstellen der Mülltonne nicht zu vergessen. Man könnte nun noch genau ausgeben, welche Mülltonne raus  zu stellen ist. Aber ein kurzer Blick auf die drehenden Icons der Tablet-Oberfläche im Flur, bei dem ggf. auch noch die Weckzeit eingestellt wird, sollte ausreichend sein ;-).

Ich hoffe, dass die interessierten FHEM User mit dieser Beschreibung etwas anfangen können und freue mich natürlich auch auf Verbesserungsvorschläge oder weitere Fragen.