Homebridge einrichten

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 diese Diskussion im FHEM-Forum. Ein Riesendank gilt vor allem Andre (justme1968) .

Eine Sammlung funktionsfähiger Homebridge FHEM Konfiguration können hier gefunden werden http://www.fhemwiki.de/wiki/Hombridge_User_Configs Die Sammlung befindet sich noch im Aufbau

NodeJS installieren

In der Konsole folgende Befehle eingeben:

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

UPDATE: Homebridge funktioniert mit einer kleinen Einschränkung nun auch mit node 4.0.0. Laut Homebridge on a Raspberry Pi müssen die folgenden Abhängigkeiten (Dependencies) aus der package.json entfernt werden:

"harmonyhubjs-client": "^1.1.4",
"harmonyhubjs-discover": "git+https://github.com/swissmanu/harmonyhubjs-discover.git"

Damit es auf einem Raspberry schneller läuft wird darüber hinaus empfohlen auch diese Abhängigkeiten aus der package.json zu entfernen:

Vorher noch ein ein Backup der Datei anlegen

cp package.json package.json.bkp oder sudo cp package.json package.json.bkp 

Am einfachsten geht das entfernen der Zeilen mit dem Editor vi.

vi package.json oder sudo vi package.json

Mit dem Cursor vor die entsprechende Zeile gehen und mit zwei mal Taste d (dd tippen) wird die Zeile gelöscht.

Eventuell muss vi mit sudo vi aufgerufen werden, je nach verwendeter Distribution.

Gespeichert wird dann mit folgendem Ablauf: ESC :wq! Enter

"ad2usb": "git+https://github.com/alistairg/node-ad2usb.git#local",
"carwingsjs": "0.0.x",
"chokidar": "^1.0.5",
"eibd": "^0.3.1",
"elkington": "kevinohara80/elkington",
"harmonyhubjs-client": "^1.1.4",
"harmonyhubjs-discover": "git+https://github.com/swissmanu/harmonyhubjs-discover.git",
"lifx-api": "^1.0.1",
"lifx": "git+https://github.com/magicmonkey/lifxjs.git",
"node-hue-api": "^1.0.5",
"node-icontrol": "^0.1.4",
"node-milight-promise": "0.0.x",
"tough-cookie": "^2.0.0",
"sonos": "0.8.x",
"telldus-live": "0.2.x",
"teslams": "1.0.1",
"unofficial-nest-api": "git+https://github.com/hachidorii/unofficial_nodejs_nest.git#d8d48edc952b049ff6320ef99afa7b2f04cdee98",
"wemo": "0.2.x",
"wink-js": "0.0.5",
"komponist" : "0.1.0",
"yamaha-nodejs": "0.4.x",

Das Konfig file sollte dann wie folgt aussehen: Achtung vor den letzten zwei } am Ende dar kein Komma sein.

{
  "name": "homebridge",
  "description": "HomeKit support for the impatient",
  "version": "0.1.1",
  "scripts": {
    "start": "DEBUG=* node app.js || true"
  },
  "repository": {
    "type": "git",
    "url": "git://github.com/nfarina/homebridge.git"
  },
  "license": "ISC",
  "dependencies": {
    "async": "^1.4.2",
    "color": "0.10.x",
    "debug": "^2.2.0",
    "hap-nodejs": "^0.0.2",
    "isy-js": "",
    "mdns": "^2.2.4",
    "netatmo": "1.3.0",
    "node-cache": "3.0.0",
    "node-persist": "0.0.x",
    "node-xmpp-client": "1.0.0-alpha23",
    "q": "1.4.x",
    "queue": "^3.1.0",
    "request": "2.49.x",
    "xml2js": "0.4.x",
    "xmldoc": "0.1.x"
  }
}

Python, g++, MDNS installieren

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

Homebridge installieren

Die aktuelle Homebridge version wird mit

npm install -g homebridge

installiert, der FHEM platform shim mit

npm install -g https://github.com/justme-1968/homebridge-fhem.git

ERR während der Installation

Bei folgendem Fehler ist das abrufen von Github nicht möglich.

npm ERR! git clone --template=/home/hs-server-admin/.npm/_git-remotes/_templates --mirror 
git://github.com/KhaosT/ed25519.git /home/hs-server-admin/.npm/_git-remotes/git-github-com-KhaosT-ed25519-git-d8bdee1d: 
github.com[0: 192.30.252.128]: errno=Die Wartezeit für die Verbindung ist abgelaufen

Fehlerursache konnte hier durch eine aktive Firewall verursacht werden.

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.

Läuft der Homebridge Server auf dem gleichen Rechner wie FHEM, kann die IP 127.0.0.1 benutzt 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": []
}

Achtung: Für ein FHEM Web Interface mit SSL Zertifikat muss die config wo folgt aussehen:

{
    "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",
            "ssl": "true",
            "auth": {"user": "FhemUser", "pass": "XXX"}
        }
     ],

    "accessories": []
}

FHEM konfigurieren

Um die Device richtig mit FHEM und Homebridge vertraut zu machen, müssen wir noch unter global etwas ergänzen:

attr global userattr genericDeviceType:ignore,switch,outlet,light,blind,speaker,thermostat,ignore,lock,window,contact

Einfach folgende Zeilen an die bestehenden Attribute anhängen:

genericDeviceType:ignore,switch,outlet,light,blind,speaker,thermostat,ignore,lock,window,contact

Diese Einstellungen können auch bei den Einzelnen Devices gemacht werden. Beispiel bei einem HM-CC-RT-DN, hier wird der subType thermostat gesetzt. Einfach in das Device gehen hier das Attr subtype erstellen und thermostat auswählen.

Homebridge starten

homebridge

Hombridge sollte nun laufen. Hier kann man die Kommunikation nachverfolgen. Abbrechen kann das ganze mit ctrl +c. Es sind keine Befehle mehr mit Siri möglich.

Damit Siri auch Befehle ohne ständig offenes Terminal bearbeiten kann, bitten nächsten Punkt beachten.

Homebridge automatisch starten

Eine Anleitung um die Homebridge automatisch zu starten findet sich

• hier: [1] oder
• [2]

Beide Links sind obsoloet da es die app.js nicht mehr gibt Alternative Methode

sudo nano /etc/init.d/homebridge

Code einfügen und ggf. den Pfad zu ".homebridge" anpassen

#!/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
        homebridge -U /home/pi/.homebridge/ > /dev/null 2>&1 &
        echo "Homebridge starting"
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
        homebridge -U /home/pi/.homebridge/ > /dev/null 2>&1 &
        echo "Homebridge starting"
else
        kill $PID
        echo "Homebridge closed"
        homebridge -U /home/pi/.homebridge/ > /dev/null 2>&1 &
        echo "Homebridge starting"
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: /etc/init.d/homebridge {start|stop|status|restart}"
exit 1
;;
esac
exit 0

Autostart aktivieren:

sudo chmod 755 /etc/init.d/homebridge

sudo update-rc.d homebridge defaults

Nun kann man mit

sudo service homebridge start

bzw.

sudo /etc/init.d/homebridge start

den Dienst starten

FHEM Device Einstellungen

Damit die zu schaltenden Geräte überhaupt in der Homebridge aufgenommen werden muss man sie im Raum Homekit hinzufügen.

Um HM-CC-RT-DN Thermostate steuern zu können, muss folgendes attribute gesetzt werden

1. attr Heizung Subtype thermostat

Für einen Dummy muss man folgendes machen.

1. attr Dummy genericDeviceType switch
2. attr Dummy setList on off

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.

HomeBridge Allgemein

Nach allen Änderungen die in FHEM gemacht werden, welche Homebridge betreffen, muss Homebridge neu gestartet werden.

Der Neustart ist abhängig davon, wie man Homebridge gestartet hat.

Bitte den entsprechenden Methoden entnehmen.

Steuerung von MiLight Allgemein

Wie hier im Forum http://forum.fhem.de/index.php/topic,32652.msg351706.html#msg351706 erwähnt, ist es möglich auch MiLight gGeräte per Siri anzusprechen. Hierzu muss die config.jason angepasst werden.

1. Es muss die Bridge hinterlegt werden. Beispiel

        {
            "platform": "MiLight",
            "name": "MiLight",
            "ip_address": "192.168.001.033",
            "port": 8899,
            "type": "rgbw",
            "delay": 30,
            "repeat": 3,
            "zones":["Wohnzimmer Lampen","Badezimmer Lampen","Büro Lampen","Keller Lampen"]
        },

2. Es muss für jedes zu Steuernde Gerät ein Dummy angelegt werden. Beispiel:

        {
            "accessory": "Http",
            "name": "Kitchen Lamp",
            "on_url": "https://192.168.1.22:3030/devices/23222/on",
            "off_url": "https://192.168.1.22:3030/devices/23222/off",
            "brightness_url": "https://192.168.1.22:3030/devices/23222/brightness/%b",
            "http_method": "POST"
        },

Schalten mit Siri

HolyMoly aus dem FHEM-Forum hat ein paar Beispiele gegeben, wie man Siri dazu bringt Devices zu schalten:

"Schalte alle Lampen im Obergeschoss ein."
"Schalte Chloes Licht aus."
"Dimme das Licht in der Küche."
"Dimme das Licht im Esszimmer auf 50 %."
"Stelle das Licht in der Küche am hellsten ein."
"Stelle die Temperatur im Tahoe-Haus auf 22 °C ein."
"Stelle das Thermostat im Erdgeschoss auf 21 °C ein.
"Schalte den Drucker im Büro ein."
"Siri, bereite alles für eine Party vor."
"Bereite das Ambiente fürs Abendessen vor."
"Aktiviere den Nachtruhemodus."

Mittlerweile kann Siri auch noch die Lichtfarbe von LEDs ändern.

Unterstütze Devices

Das Fhem Plugin von Andre (justme1968) unterstützt folgende Geräte

   switches (devices with set on and set off commands)
   lights (devices with set on and set off commands)
   homematc and FS20 dimmers (devices with set on, set off and set dim or set pct commands)
   HUE, WifiLight, SWAP_0000002200000003 (hue, sat, bri, rgb)
   homematic, max and pid20 thermostats
   homematic blinds
   hommatic, MAX and FHTTK contact sensors (door, window)
   HM-SEC-WIN, HM-SEC-KEY
   presence, ROOMMATE
   SONOS (power, volume)
   harmony scenes
   temperaturecw and humidity sensors
   CO20 air quality sensor
   probably some more ...