Apple Home (HomeKit) – Devolo Geräte mit der Apple App steuern – Homebridge

Kennt ihr das? Aus der Not heraus, weil ein Dritter irgendwelchen Mist verzapft, entsteht eine großartige Idee, die dann auch noch gut umgesetzt wird?

In meinen Fall war der Dritte Devolo, Devolo hat vor ein paar Wochen ihre Home Control iOS-App auf 1.1 geupdatet. Diese hatte ein tolles neues Feature: „iPad-Ansicht: optimierte Darstellung für iPads (Querformat)“

Geil Freunde, nur leider wird dieses Querformat erzwungen, eine Nutzung am iPad im Hochformat ist nicht mehr möglich. Prima, wenn das iPad mini zur Haussteuerung im Hochformat an der Wand hängt. (Sarkasmus-Schild)

➡ Auch die Version 1.2 die vor ein paar Tagen erschienen ist, hat das „Problem“ nicht behoben – obwohl ich mich mehrfach beschwert habe. UPDATE_20170407: Das ersehnte Update soll voraussichtlich Ende April / Anfang Mai kommen.

Naja, jedenfalls war ich ziemlich sauer, bin oft im Kopf durchgegangen:

• wieder zurück zu Homee?
• andere Alternativen?
• gedulden bis das Problem behoben ist?

Zwische durch hat Amazon Echo mit Alexa die Blogs bestimmt – Skills, Devolo Skill, IFTTT, HA Bridge, Homebridge. Und irgendwie im Gespräch mit meinem Arbeitskollegen Kevin, den einige von euch bereits von unserem Projekt bidvoy kennen, kam die Idee, da er auch gerade auf das Devolo HomeControl umgestiegen ist, dass eine Steuerung in Apples Home App (HomeKit) eine wirklich feine Sache wäre.

Stichwort Homebridge: Homebridge ist eine Schnittstelle, die offiziell nicht HomeKit kompatible Geräte, teilweise HomeKit kompatibel werden lässt. Dazu benötigt man, wie sollte es anders sein, im besten Fall einen Linux-Server oder Raspberry Pi.

Nun ja, für Homebridge gibt es dann jede Menge Plugins, die oftmals nicht vom Homebridge-Entwickler selber stammen, sondern von der Community rundherum.

Ich persönlich nutze aktuell homebridge-cmdswitch2, homebridge-dash, homebridge-devolo, homebridge-fritz, homebridge-harmonyhub, homebridge-http, homebridge-hue, homebridge-netatmo, homebridge-samsungtv-control, homebridge-server, homebridge-sonos und homebridge-wunderground.

Nur leider gab es zu diesem Zeitpunkt noch kein Homebridge-Plugin für Devolo Geräte die mit dem Devolo HomeControl verbunden sind – aufgrund der fehlenden offiziellen API auch so gut wie nicht machbar.

Aber nach etlichen Stunden Reverse Engineering der iOS- & Android-Apps hatten wir alles zusammen, was man für ein funktionierendes Plugin benötigt. (… wir kleinen Blackhats!)
Kevin machte sich an die Arbeit und ein paar Tage später, nachdem wir mit Devolo die rechtliche Seite geklärt hatten, haben wir alles auf GitHub hochgeladen, wo es nun jeder SmartHome-Liebhaber mit Homebridge benutzen kann. Nach und nach werden sicher noch ein paar Features dazukommen. 

Homebridge

Vorbereitung

Um Homebridge installieren zu können, benötigt man noch ein paar weitere Debian Pakete, welche wir mit apt-get nachinstallieren.

apt-get install curl git build-essential libssl-dev libavahi-compat-libdnssd-dev

Da Homebridge für Node.js geschrieben ist, müssen wir natürlich auch Node installieren.

#curl -sL https://deb.nodesource.com/setup_8.x | bash -
curl -sL https://deb.nodesource.com/setup_10.x | bash -
apt-get install nodejs

Installation

Homebridge installieren

Jetzt sind alle Vorbereitungen abgeschlossen und Homebridge kann installiert werden.

npm install -g --unsafe-perm homebridge

Sollte die Installation von Homebridge mit der Fehlermeldung …

ImportError: No module named compiler.ast

… abbrechen, sollte folgende Befehl helfen – natürlich muss danach Homebridge noch erfolgreich installiert werden.

apt install python-dev
npm install -g --unsafe-perm homebridge

Homebridge Dienste erstellen

Damit Homebridge ordentlich, wie es auf Linux-Systemen üblich ist, als Dienst (systemd) laufen kann, werden zwei Dateien benötigt. Eine zur Konfiguration …

vi /etc/default/homebridge

# Defaults / Configuration options for homebridge
# The following settings tells homebridge where to find the config.json file and where to persist the data (i.e. pairing and others)
HOMEBRIDGE_OPTS=-U /var/lib/homebridge

# If you uncomment the following line, homebridge will log more
# You can display this via systemd's journalctl: journalctl -f -u homebridge
# DEBUG=*

… und eine für den Dienst selber.

vi /etc/systemd/system/homebridge.service

[Unit]
Description=Node.js HomeKit Server
After=syslog.target network-online.target

[Service]
Type=simple
User=homebridge
#User=root
EnvironmentFile=/etc/default/homebridge
# Adapt this to your specific setup (could be /usr/bin/homebridge)
# See comments below for more information
#ExecStart= /usr/bin/sudo /usr/local/bin/homebridge $HOMEBRIDGE_OPTS
ExecStart=/usr/bin/homebridge $HOMEBRIDGE_OPTS
Restart=on-failure
RestartSec=10
KillMode=process

[Install]
WantedBy=multi-user.target

Im Verzeichnis /var/lib/homebridge wird die config.json angelegt, die für die gesamte Konfiguration für Homebridge zuständig ist – diese Datei ist für Homebridge das Herzstück! Erstmal muss allerdings das Verzeichnis angelegt werden.

mkdir /var/lib/homebridge

Des Weiteren soll der Dienst nicht unter „root“ laufen, sondern unter dem neuen, unprivilegierten User „homebridge“ – daher muss dieser angelegt werden.

useradd --system homebridge -m -s /bin/bash
mkdir /home/homebridge/.homebridge/
chown -R homebridge:homebridge /home/homebridge
chown -R homebridge:homebridge /var/lib/homebridge

Um Die Installation abzuschließen, sollten noch die Dienste neugeladen werden und der Homebridge-Dienst aktiviert werden, damit dieser beim (Neu)Start des Betriebsystems automatisch gestartet wird.

systemctl daemon-reload
systemctl enable homebridge

Konfiguration

Kommen wir nun zur Konfiguration des, vor ein paar Zeilen erwähnten, Herzstückes von Homebridge. In der nachfolgenden Standardkonfiguration des „nackten“ Homebridges könnt ihr ggf. den Pin anpassen, welchen ihr erst am Ende des Artikels benötigt.

vi /var/lib/homebridge/config.json

{
    "bridge": {
        "name": "Homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "133-77-331"
    },

    "platforms": [
     ],

    "accessories": [
     ]
}

Jetzt starten wir den Dienst „Homebridge“ und prüfen ob dieser erfolgreich war.

service homebridge start
# ein paar Sekunden warten
journalctl -u homebridge --no-pager

Wichtig wäre, dass am Ende der Logdatei „Homebridge is running on port 51826“ erscheint.

systemd[1]: Starting Node.js HomeKit Server...
systemd[1]: Started Node.js HomeKit Server.
homebridge[]: No plugins found. See the README for information on installing plugins.
homebridge[]: Loaded config.json with 0 accessories and 0 platforms.
homebridge[]: ---
homebridge[]: Loading 0 platforms...
homebridge[]: Loading 0 accessories...
homebridge[]: Scan this code with your HomeKit App on your iOS device to pair with Homebridge:
homebridge[]: ┌────────────┐
homebridge[]: │ 133-77-331 │
homebridge[]: └────────────┘
homebridge[]: Homebridge is running on port 51826.

Die Warnmeldungen von „Apple Bonjour“ und „Avahi“ können ignoriert werden – laut Homebridge Entwickler wäre es ein großer Aufwand diese zu unterdrücken, dieser steht aber in keiner Relation zum Nutzen.

Homebridge-Devolo

Nachdem wir die Basis für das Devolo Plugin geschaffen haben, kommen wir nun zum Eingemachten.

Installation

Mit der Paketverwaltung für Node.js (npm) installieren wir nun das Devolo Plugin.

npm install -g homebridge-devolo

Konfiguration

In unserem „Herzstück“ müssen nun im Bereich „platforms“ Anpassungen vorgenommen werden – siehe unten. Achtet hierbei ganz besonders auf die richtige Kommasetzung und die geschweiften Klammern {}, um die Fehlermeldung „There was a problem reading your config.json file“ zu vermeiden.

vi /var/lib/homebridge/config.json

{
    "bridge": {
        "name": "Homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "133-77-331"
    },

    "platforms": [
      {
        "platform" : "Devolo",
        "name" : "Devolo",
        "host" : "192.168.XXX.XXX",
        "email" : "mail@domain.com",
        "password" : "password"
      }
     ],

    "accessories": [
     ]
}

• host = lokale IP von eurer Devolo Zentrale (HomeControl)
  • die Kommunikation zwischen Homebridge und der Zentrale findet im lokalen Netzwerk statt, es wird keine aktive Internetverbindung zur Steuerung der Geräte benötigt
• email = Benutzername mit dem ihr euch bei mydevolo.de anmelden könnt
• password = das dazugehörige Passwort

Um zu prüfen, ob alles funktioniert hat, muss Homebridge neugestartet werden. Sollte die Fehlermeldung „There was a problem reading your config.json file“ erscheinen, ist mit großer Wahrscheinlichkeit ein Komma zu viel oder eine Klammer zu wenig – da kann ich euch JSONLint empfehlen, hier könnt ihr den Inhalt eurer config.json rein kopieren und prüfen lassen.

Nunja, der nachfolgende Neustart von Homebridge ist für die abschließende Konfiguration sehr wichtig, da wir dann in der Logdatei 3 noch benötigte Zeilen finden werden – UUID, GATEWAY und PASSKEY.

service homebridge restart
sleep 5
journalctl -n 50 -u homebridge --no-pager

homebridge[]: Loading 1 platforms...
homebridge[]: [Devolo] Initializing Devolo platform...
homebridge[]: [Devolo] HBDevoloPlatform > Searching for Devolo Central Unit.
homebridge[]: Loading 0 accessories...
homebridge[]: [Devolo] HBDevoloPlatform > Central Unit found.
homebridge[]: [Devolo] HBDevoloPlatform > Please edit config.json and restart homebridge.
homebridge[]: "platforms": [
homebridge[]: {
homebridge[]: "platform": "Devolo",
homebridge[]: "name": "Devolo",
homebridge[]: "host": "192.168.XXX.XXX",
homebridge[]: "email": "mail@domain.com",
homebridge[]: "password": "password",
homebridge[]: "uuid": "ABCDE123-1337-3333-7331-FEDCBA987",
homebridge[]: "gateway": "1234567890123456",
homebridge[]: "passkey": "ABEAC07D3C28C1BEF9E730002C753ED4"
homebridge[]: }
homebridge[]: ]

Diese 3 Zeilen mit der UUID, dem GATEWAY und PASSKEY müssen nun noch in die config.json, …

vi /var/lib/homebridge/config.json

… wenn dies erledigt ist, muss Homebridge ein letztes Mal neugestartet werden.

service homebridge restart

Wenn wir nun in die Logdatei schauen, werden wir endlich für unsere Mühen belohnt, denn wir sehen, dass jede Menge Devolo Geräte gefunden wurden und diese voraussichtlich auch in der Apple Home App angezeigt werden.

journalctl -n 50 -u homebridge --no-pager

homebridge[]: [Devolo] HBDevoloPlatform > Central Unit found.
homebridge[]: [Devolo] HBDevoloCentralUnit > Device "devolo.model.Siren" is not supported (yet). Open an issue on github and ask for adding it.
homebridge[]: [Devolo] Initializing platform accessory 'Devolo Central Unit'...
homebridge[]: [Devolo] Initializing platform accessory 'Entertainment'...
homebridge[]: [Devolo] Initializing platform accessory 'Bewegungsmelder'...
homebridge[]: [Devolo] Initializing platform accessory 'Handtuchheizkörper'...
homebridge[]: [Devolo] Initializing platform accessory 'Fenster'...
homebridge[]: [Devolo] Initializing platform accessory 'Haustür'...
homebridge[]: [Devolo] Initializing platform accessory 'Bewegungsmelder'...
homebridge[]: [Devolo] Initializing platform accessory 'Wassermelder'...
homebridge[]: [Devolo] Initializing platform accessory 'Luftfeuchtemelder'...
homebridge[]: [Devolo] Initializing platform accessory 'Server'...

Tipp: Ich starte über /etc/crontab jede Nacht Homebridge einmal neu – sicher ist sicher.

Apple Home (HomeKit)

Zum Abschluss muss nun nur noch unser iOS-Gerät mit der Homebridge verbunden werden – hierzu benötigen wir nun den Pin, den wir am Anfang in der config.json festgelegt haben.

Verbinden

Ein Tipp am Rande: Aktuell werden von der Apple Home App nicht alle Funktionen unterstützt die HomeKit im Stande wäre umzusetzen – dies wird zwar von iOS Release zu iOS Release besser, aber dennoch lohnt es sich in andere Apps zu schauen die HomeKit unterstützen, beispielsweise Hesperus.

Viel Spaß mit euren Devolo Geräten in Apple Home.

Was habt ihr so für SmartHome-Spielereien in eueren vier Wänden? Was begeistert euch?