Homebridge – FHEM-Geräte per Siri steuern

Jeder der ein iOS Gerät sein Eigen nennt, träumt irgendwann davon seine Geräte über Siri steuern zu können. Apple bietet dazu Homekit als Schnittstelle an. Problem dabei ist jedoch, dass es noch nicht allzu viele Geräte gibt, die diese Schnittstelle nutzen bzw. unterstützen. Hier kommt das Projekt „Homebridge“ zur Hilfe. Homebridge simuliert auf dem Raspberry ein Homekit-Schnittstelle und lässt euch so eure FHEM-Geräte über Siri steuern.

In diesem Beitrag erkläre ich euch, wie ihr auf eurem Raspberry Homebridge installiert, einrichtet und die Verbindung mit FHEM herstellt.

Benötigte Pakete installieren

Für den Betrieb von Homebridge wird die aktuelle Version von NodeJS benötigt. Welche momentan aktuell ist könnt ihr auf dieser Seite rausfinden. Zum diesem Zeitpunkt war es Version 4.3.1. Der Befehl zur Installation ist je nach Version des Raspberrys unterschiedlich.

Raspberry  Pi 1:

wget https://nodejs.org/dist/v4.3.1/node-v4.3.1-linux-armv6l.tar.gz
tar -xvf node-v4.3.1-linux-armv6l.tar.gz
cd node-v4.3.1-linux-armv6l

Raspberry Pi 2 / 3:

wget https://nodejs.org/dist/v4.3.1/node-v4.3.1-linux-armv7l.tar.gz
tar -xvf node-v4.3.1-linux-armv7l.tar.gz
cd node-v4.3.1-linux-armv7l

Nun wird der Inhalt in ins Verzeichniss „/user/local“ verschoben:

sudo cp -R * /usr/local/

Nun überprüft ihr am besten ob die Installation erfolgreich war. Dies könnt ihr mit folgendem Befehl machen:

node –v

Jetzt solltet ihr die Version von NodeJS als Ausgabe erhalten.
Hat alles geklappt könnt ihr die heruntergeladene Datei und den entpacken Ordner löschen

Raspberry Pi 1:

rm node-v4.3.1-linux-armv6l.tar.gz
rm -R node-v4.3.1-linux-armv6l/

Raspberry Pi 2 / 3:

rm node-v4.3.1-linux-armv7l.tar.gz
rm -R node-v4.3.1-linux-armv7l/

Damit Homebridge ordnungsgemäß läuft wird noch folgendes Paket benötigt:

sudo apt-get install libavahi-compat-libdnssd-dev

Homebridge installieren

Nachdem alle benötigten Pakete installiert wurden, können ihr mit der Installation von Homebridge beginnen:

sudo npm install -g homebridge

Homebrdge wird nun heruntergeladen und installiert. Dies kann einige Minuten dauern.
Damit Homebridge auch mit den Geräten von FHEM kommuniziert, ist es nötigt das Plugin shim zu installieren:

sudo npm install -g homebridge-fhem

Nach der Installation können ihr damit beginnen Homebridge für den Betrieb mit FHEM zu konfigurieren. Dazu wird ein Verzeichenis mit einer Konfigurataionsdatei erstellt:

mkdir -p ~/.homebridge
cd ~/.homebridge/
nano ~/.homebridge/config.json

In dem nun geöffnetet Editor wird die Konfiguration geschrieben:

{
    "bridge": {
        "name": "Homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "031-45-154"
    },
    "platforms": [
        {
            "platform": "homebridge-fhem.FHEM",
            "name": "FHEM",
            "server": "127.0.0.1",
            "port": "8083",
            "ssl": true,
            "auth": {"user": "FhemUser", "pass": "XXX"},
            "filter": "room=Homekit"
        }
     ],
    "accessories": []
}

Habt ihr eure FHEM-Installation, wie in meinem Artikel beschrieben, mit SSL und einem Passwort abgesichert, müsst ihr den Eintrag „auth“ entsprechend anpassen und an den Eintrag „ssl“ denken. Ansonsten den Eintrag „ssl“ entfernen und die Zeile „auth“ einfach so belassen.

Der Eintrag „server“ muss nur angepasst werden, wenn Homebridge nicht auf dem gleichen System wie die FHEM-Installation läuft.

Mit der obigen Konfigurationsdatei werden alle kompatiblen FHEM-Devices mit Siri steuerbar, welche sich im Raum „Homekit“ befinden. Wollt ihr alle eurer kompatiblen Geräten steuern oder einen anderen Raum verwenden, dann einfach den Eintrag „filter“ anpassen.

Anschließend die Datei speichern und schließen.

Einrichtung unter FHEM

Aufgrund des oben genannten Filters müssen alle Geräte, welche mit Siri gesteuert werden sollen, den Raum „Homekit“ zugeordnet werden. Sind alle gewünschten Geräte in diesem Raum, ist die Einrichtung innerhalb FHEMs auch schon fertig. Die benötigten Attribute werden beim ersten Start von Homebridge automatisch hinzugefügt.

Werden nachträglich neue Geräte zur Homebridge (Raum Homekit) hinzugefügt, muss Homebridge neu gestartet werden (siehe weiter unten).

Homebridge ist nun startbereit und kann über den Befehl

homebridge

gestartet werden.

Ihr sieht nun einen 8stelligen Code für die Konfiguration auf einem iOS-Gerät.

Konfiguration auf einem iOS-Gerät

Für die Konfiguration auf iOS-Geräten hat Apple noch keine eigene App bereitgestellt, sodass wir auf eine Drittanbieter-App ausweichen müssen. Ich benutze dazu „Elgato Eve“ von Elgato Systems.

Download QR-Code

‎Eve für HomeKit

Entwickler: Eve Systems GmbH

Preis: Kostenlos

Beim ersten starten der App muss man zuerst Geräte hinzufügen. Dies geschieht über „Gerät hinzufügen“

Nach der Vergabe eines Namens, beginnt die App auch schon nach kompatiblen Geräten zu suchen. Die eingerichtete Homebridge sollte nun gefunden werden:

Nach auswählen der Homebridge werden wir dazu aufgefordert einen 8-stelligen Einrichtungscode einzugeben. In unserem Fall ist es „031-45-154“.

Da die Homebridge-Installation nicht von Apple verifiziert ist, erhalten man nun eine Warnmeldung, welche einfach mit „Trotzdem hinzufügen“ beantwortet werden kann. Die App beginnt sich nun mit der Homebridge zu koppeln. Nach der erfolgreichen Kopplung kann man  bereits erste Räume hinzufügen oder erstmal mit dem Standardraum fortfahren.

Man erhält nun eine Übersicht alle gefundenen Geräten.

Man sollte nun beginnen sich die gewünschten Räume einzurichten. Dazu über der unteren Leiste auf „Räume“ um alle vorhandenen Räume anzuzeigen.

Geht man nun wieder zur Geräteübersicht kann man durch tippen auf ein Gerät dessen Einstellungen bearbeiten.

Hier kann man nun dem Gerät einen Raum zu ordnen. Wichtig ist hier auch, dass jedes Gerät einen eindeutigen Siri-Namen bekommt. Über diesen Namen steuern wir mit Hilfe von Siri unsere Geräte. Man sollte den Geräten also aussprechbare Namen geben. Des Weiteren ist es wichtig darauf zu achten, dass der Eintrag „Verwendet für“ passend gewählt ist. Dadurch ist es auch möglich, allgemeine Befehle über Siri abzusetzen. Zum Beispiel: „Siri, schalte das Licht in der Küche an“ anstatt „Siri, schalte die LEDLeiste in der Küche an“.

Alle Einstellungen die ihr über diese App tätigt werden eurem Homekit-Profil zugeordnet. Ihr könnt also über alle iOS-Geräte die mit eurer Apple-ID verknüpf sind eure Geräte steuern.

Über die App lässt sich noch einiges weiteres Einstellen (Räume, Szenen, Bereiche), aber diese lassen sich am besten selber durch „rumklicken“ innerhalb der App entdecken.

Homekit automatisch starten

Damit man nach einem Neustart des Raspberrys Homebridge nicht immer manuell neustarten muss, erstellen wir uns einen Service, welcher Homebridge automatisch startet.

sudo nano /etc/init.d/homebridge

Wir fügen folgenden Inhalt hinzu:

#!/bin/sh
### BEGIN INIT INFO
# Provides: homebridge
# Required-Start: $network $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: Start daemon at boot time for homebridge
# Description: Enable service provided by daemon.
### END INIT INFO
export PATH=$PATH:/usr/local/bin
export NODE_PATH=$NODE_PATH:/usr/local/lib/node_modules
PID=`pidof homebridge`
case "$1" in
start)
if ps -p $PID > /dev/null 2>&1; then
        echo "Homebridge is already running"
else
        su - pi -c "homebridge > /dev/null 2>&1 &"
        echo "Homebridge starting"
        $0 status
fi
;;
stop)
if ! ps -p $PID > /dev/null 2>&1; then
        echo "Homebridge is not running"
else
        kill $PID
        echo "Homebridge closed"
fi
;;
restart)
if ! ps -p $PID > /dev/null 2>&1; then
        $0 start
else
        $0 stop
        $0 start
fi
;;
status)
if ps -p $PID > /dev/null 2>&1; then
        echo "Homebridge is running PID $PID"
else
        echo "Homebridge is not running"
fi
;;
*)
echo "Usage: $0 {start|stop|status|restart}"
exit 1
;;
esac
exit 0

Soll Homebridge über einen anderen Benutzer gestartet werden, muss am Anfang der Datei folgende Zeile entsprechend geändert werden:

su - pi -c "homebridge > /dev/null 2>&1 &"

Nun noch den Autostart aktivieren

sudo chmod 755 /etc/init.d/homebridge
sudo update-rc.d homebridge defaults

und Homebridge wird nach einem Neustart automatisch mit neu gestartet.
Manuell kann man Homebridge mit folgenden Befehlen steuern:

sudo service homebridge start

sudo service homebridge stop

sudo service homebridge restart

Weitere Infos zur Homebridge auf dem offiziellen FHEM-Wiki-Eintrag.