Gira IoT Api - ioBroker-Integration per Adapter
Nachdem nun schon eine ganze Weile der Gira X1 in meiner Verteilung werkelt (die Beiträge hier kennst Du bestimmt), fehlte nur noch eine ioBroker-Integration. Klar, am Ende kann man die ganzen Funktionen auch über die gängigen KNX-Adapter in den ioBroker holen. Aber: Da der Gira X1 (und auch der Gira Homeserver) eine lokale HTTP-Schnittstelle bietet, möchte man diese doch auch nutzen, oder? Zumindest wollte ich die Lücke schließen und habe einen ioBroker-Adapter dafür entwickelt. Die Grundlage dafür wurde bereits vor gut 5 Monaten im Video zur ioBroker-Adapter-Entwicklung gelegt! Seitdem ist wenig passiert - aber nun hatte ich wieder die Motivation das Thema mal wieder anzugehen.
Die Kommunikation mit dem Gira-Gerät findet über HTTPS im lokalen Netzwerk statt. Die Zertifikate werden dabei nicht validiert! Das heißt, dass die Verbindung zwar verschlüsselt ist, aber eben nicht komplett gegen Angriffe geschützt ist. Aber da alles im lokalen Netzwerk stattfindet, ist das halb so wild. Jedenfalls ist es von Gira so vorgesehen, dass der Client (in unserem Fall also der ioBroker) eine Callback-Url beim X1 registriert. An diese URL pusht dann der X1 die Status-Änderungen (per HTTP-Post). Damit der ioBroker diese eingehenden Anfragen auch annehmen kann, brauchen wir einen Webserver. Was liegt also näher. als den Web-Adapter zu nutzen und dort eigene Routen zu implementieren? Das habe ich noch nie gemacht und war daher doppelt interessant für mich. Umso erstaunter war ich, wie einfach das alles geht.
Wichtig ist nur, dass die Web-Instanz auf HTTPS gestellt wird. Ansonsten verweigert der X1 wie gesagt die Kommunikation mit dem Endpunkt und es gibt einen Fehlercode. An dieser Stelle ein großes Lob an Gira - die Dokumentaion ist lückenlos und sehr gelungen! Auch, wenn ich ein paar Aufrufe vermisse (z.B. alle aktuellen Werte gleichzeitig abholen).
Nun muss diese Web-Instanz nur noch in der Instanzkonfiguration des Gira-IoT-Adapters ausgewählt werden. Danach sollte alles automatisch angelget werden!
Video
