Homebridge einrichten

Homebridge einrichten Zusammenfassung

Dieses HOWTO zeigt die Installation und Erstinbetriebnahme von Homebridge. Damit kann Siri benutzt werden, um FHEM-Devices zu steuern. So können Devices angesprochen werden, die offiziell HomeKit nicht unterstützen. (Die Vorgehensweise wurde auf einem Intel NUC mit Ubuntu Server 14.04 LTS und auf einem Raspberry Pi mit Raspian getestet.)

Um Homebridge erfolgreich zu installieren müssen zunächst NPM, NodeJS, Python, g++, MDNS, sowie benötigte Hilfspakete installiert werden:

Der WIKI-Eintrag bezieht sich hauptsächlich auf die Diskussion im FHEM-Forum: http://forum.fhem.de/index.php/topic,32652.0.html Ein riesen Dank gilt vor allem justme1968

NodeJS installieren

In der Konsole folgende Befehle eingeben:

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install build-essential libssl-dev

Da es z.Zt. Probleme mit der neuesten NodeJS Version (4.0) gibt, wird die NodeJs Version 0.12.6 über NVM verwendet.

curl https://raw.githubusercontent.com/creationix/nvm/v0.16.1/install.sh | sh

Nach Ausführung des Skripts ist ein LogOut und erneuter LogIn erforderlich. Alternativ:

source ~/.profile

Mit erfolgreich installierten NVM kann nun die benötigte NodeJS-Version geladen werden:

nvm install 0.12.6
nvm use 0.12.6

Im Anschluss kann mit:

node -v

überprüft werden, ob die Richtige Version genutzt wird.

Python, g++, MDNS installieren

sudo apt-get install python
sudo apt-get install g++
sudo apt-get install libavahi-compat-libdnssd-dev

Homebridge installieren

Dazu im Homeverzeichnis

git clone https://github.com/nfarina/homebridge.git
cd homebridge
git submodule init
git submodule update
npm install

eingeben.

Homebridge konfigurieren

Im Verzeichnis ~/homebridge/ muss nun noch die Config.json erstellt bzw. angepasst werden:

nano config.json

Homebridge muss nicht, kann aber auf dem selben Server laufen wie FHEM. Unter "server" muss die IP des FHEM-Servers und unter "port" der benutzte Port des benutzten FHEMWEBS eingetragen werden.

WICHTIG: Damit nicht alle Devices von Homebridge berücksichtig werden, bietet es sich an die Devices zu filtern. In diesem Beispiel wurden alle Devices, die über Siri steuerbar sein sollen zusätzlich in den ROOM Homekit per FHEM eingerichtet. Der PIN kann beliebig in dem Format xxx-xx-xxx angepasst werden. Dieser muss nur einmal bei der Einrichtung in iOS eingegeben werden.

    "bridge": {
        "name": "Homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "031-45-154"
    },

    "platforms": [
        {
            "platform": "FHEM",
            "name": "FHEM",
            "server": "192.168.xxx.xxx",
            "port": "8083",
            "filter": "room=Homekit",
            "auth": {"user": "FhemUser", "pass": "XXX"}
        }
     ],

    "accessories": []
}

Homebridge starten

Wieder im Verzeichnis ~/homebridge/

npm run start

Hombridge sollte nun laufen.

HomeKit in iOS einrichten

Um FHEM über Homebridge in iOS nutzen zu können muss HomeKit eingerichtet werden. Es gibt verschiedene Apps. Im folgenden wird die App EVE von Elgato empfohlen, die aus dem App-Store geladen werden muss. In der App auf:

Gerät hinzufügen

Es sollte ein Gerät mit der Bezeichnung "Homebridge" zur Auswahl erscheinen. Zur Ersteinrichtung auf PIN manuell eingeben gehen und (falls in der config.json nicht geändert):

031-45-154

eingeben.

Im Anschluss können die Devices nach belieben in verschiedene Räume zugeteilt werden, sowie Szenen und Bereiche erstellt werden.