Philips Hue über die API erweitern

Nachdem ich bereits sehr lange das Philips Hue System einsetze, habe ich natürlich das System kontinuierlich erweitert. Als letztes Gadget kam jetzt der Motion Sensor dazu. Dieses kleine Teil macht im Prinzip genau das, was ich auch davon erwartet habe. Wird eine Bewegung erkannt, schaltet der Motion Sensor eine oder mehrere Lampen ein und wenn nach x Minuten eben keine Bewegung mehr erkannt wird, die entsprechenden Lampen auch wieder aus.  Zusätzlich kann über die Hue App noch konfiguriert werden, welche Szene verwendet werden soll und ob der Sensor die Lampen z.B. nur Abends einschalten soll (Daylight Sensor).

Prinzipiell macht der Motion Sensor was der Hersteller verspricht. Ein normaler Bewegungssensor kann allerdings noch mehr. Zum Beispiel würde ich gern eine Aktion ausführen (Benachrichtigung versenden, anderes Gerät ebenfalls schalten etc.), wenn eine Bewegung erkannt wurde. Nach Rückfrage bei Philips ist dies leider nicht vorgesehen (steht aber wohl auf der Feature Liste). Da diese Aussage für mich jetzt nicht wirklich befriedigend war, habe ich mir mal die Möglichkeiten der API angeschaut und habe interessantes gefunden.

Über die API können wir nicht nur den Status des Motion Sensor, sondern auch den integrierten Temperatursensor (ja, da ist auch ein solcher Sensor drin) abfragen. Für alle die das Zubehör selbst überwachen wollen, bekommen wir natürlich über die API auch den Batteriestatus von allen verbundenen Geräten (z.B. dem Dimmer Switch), was ab und zu ganz hilfreich sein kann. Der einzige Nachteil an dieser Stelle ist, dass wir das aktiv über ein Skript machen müssen. Der Sensor selbst verhält sich hierbei komplett passiv. Wer aber einen Windows oder Linux Rechner im Netzwerk hat, kann über einen Task diese Informationen auslesen und entsprechend reagieren.

Den Verbindungsaufbau zur Hue Bridge habe ich in meinem Artikel “Z-Way Gateway und Philips Hue” bereits beschrieben. Das Auflisten der Sensoren erfolgt über den folgenden API Aufruf in einem Browser:

Hier werden uns alle vorhandenen Sensoren angezeigt, auch die, die unter anderem von der mobilen App angelegten Routinen (Geo-Fencing, Aufwachen etc.). Uns interessieren hier aber nur die Sensoren vom Typ ZLLPresence und der Modell ID SML001. In der Antwort der API sieht das wie folgt aus:

In meinem Fall finde ich den Motion Sensor unter der ID 11 auf meiner Bridge. Mit dem Aufruf der folgenden API Abfrage bekomme ich nur diesen Sensor angezeigt:

Um jetzt das ganze zu automatisieren, benötige ich ein Skript welches z.B. alle 60 Sekunden den Sensor 11 abfragt und eine definierte Aktion ausführt (E-Mail senden, anderes Skript ausführen) wenn sich der Wert presence von false auf true ändert. Nachfolgend ein simples Beispiel mit einem Linux Bash Skript:

Innerhalb der If – Then Schleife könnten wir zum Beispiel über einen Webhook bei IFTTT weitere Aktionen auslösen. Hier ist viel Raum zum Experimentieren.

Den Temperatursensor finde ich bei mir mit der ID 10. Die Temperatur wird dabei mit zwei Kommastellen ohne das Komma angegeben. Die Ausgabe “2674” bedeutet also 26,74 °C. Hier mal beispielhaft die Ausgabe der API:

Hier können wir mit dem folgenden Bash Skript die Temperatur des Sensors abfragen und ausgeben:

Wer sich meinen anderen Artikel anschaut, wird sicherlich das ganze auch schnell in Powershell umsetzen können. Prinzipiell handelt es sich ja nur um einfache RestAPI / JSON Abfragen, die mit jeder Sprache erzeugt werden können. Beispiele können in meinem GitHub Account gefunden werden.

Viel Spaß beim Experimentieren.