FHEM per HTTP-Request steuern oder Daten abfragen

Um FHEM, die Open-Source Smart-Home-Steuerung, direkt per HTTP Request zu steuern, kann man den Befehl direkt in den Browser eingeben. Oft häufiger genutzt wird das aber, wenn man damit verschiedene FHEM-Instanzen miteinander verbinden möchte und sie nicht per FHEM2FHEM verbinden möchte oder kann. Wichtig ist die Steuerung per HTTP Request aber auch, wenn man aus einem anderen Skript (aus der Konsole, Python oder PHP…) auf FHEM zugreifen und Aktionen tätigen möchte.

In unseren Beispielen hier läuft FHEM auf der IP-Adresse „192.168.1.1“ und auf Port „8085. Dies muss im Code angepasst werden, wenn FHEM im eigenen Setup auf einem Rechner mit anderer IP und anderen Port installiert ist!

http://192.168.1.1:8085/fhem?cmd=set%20Lampe%20off

Mit diesem Code lässt sich über den Webbrowser der Befehl an FHEM übergeben und so zum Beispiel das Gerät „Lampe“ ausschalten. Der an FHEM übergebene Befehl lautet nämlich:

set Lampe off

Wichtig ist hier, dass Leerzeichen in der URL-Adresse als „%20“ geschrieben werden müssen – außerdem funktioniert dieser Befehl aus Sicherheitsgründen nur, wenn man für den Port 8085 das Attribut „csrfToken“ ausgeschaltet hat. Da dies ein Sicherheitsrisiko darstellen kann, sollte man es nur zum Testen so belassen und später zum Beispiel ein eigenes CSRF-Token übergeben.

Gibt man den Befehl „set Lampe off“ jetzt direkt über die Browser-Adressleiste ein, schaltet man das angegebene Gerät „Lampe“ aus, anschließend wird die FHEM Startseite angezeigt. Dies ist in vielen Fällen unnötig – gerade wenn man von FHEM aus ein anderes FHEM System steuern möchte: Hier wird der gesamte Inhalt der Seite in die Log-Datei geschrieben.

Um das zu verhindern, kann man an das Ende des Befehls noch diesen Parameter anhängen: &XHR=1. Dies bewirkt, dass statt der gesamten Webseite einfach eine leere weiße Seite angezeigt wird. Der komplette Befehl sieht dann so aus:

http://192.168.1.1:8085/fhem?cmd=set%20Lampe%20off&XHR=1

So lässt er sich zum Beispiel auch aus der Linux-Konsole heraus aufrufen – hier sind aber die Anführungszeichen um die URL wichtig, damit das „&“ auch mit übernommen wird:

curl "http://192.168.1.1:8085/fhem?cmd=set%20Lampe%20off&XHR=1"

Daten per HTTP von FHEM abfragen

Per HTTP lassen sich nicht nur Daten an FHEM senden, sondern auch abfragen: Zum Beispiel der Zustand („state“) eines Gerätes, um zu prüfen, ob die Lampe ein- oder ausgeschaltet ist. Der Befehl zum Abfragen des Status eines FHEM device lautet dabei:

list Lampe state

oder als komplette Web-Adresse für den Browser oder Konsolen-Befehl:

http://192.168.1.1:8085/fhem?cmd=list%20Lampe%20state

Auch hier wird wieder die komplette FHEM Webseite übertragen, zusammen mit den gewünschten Daten. Wer das nicht möchte, kann dies deutlich reduzieren, wenn die Adresse wieder um den Parameter „&XHR=1“ ergänzt wird:

http://192.168.1.1:8085/fhem?cmd=list%20Lampe%20state&XHR=1

Statt der gesamten Webseite enthält die Rückgabe dann nur noch den Namen des device, die Uhrzeit der Abfrage und den Status, sieht also zum Beispiel so aus:

Lampe     2018-07-01 17:24:06    on