Homematic IP mit Siri und HomeKit steuern (Homebridge)

01Allgemein

In dieser Anleitung geht es darum, die Homematic mit Sprachbefehlen über Apples Siri und HomeKit zu steuern. "Hey Siri…, Garagentor öffnen"! Das klingt zunächst nach viel Arbeit, ist es aber nicht wirklich. Es sind nur ein paar Zeilen Code, die per Copy and Paste in der richtigen Reihenfolge eingegeben werden müssen. Das ist gut machbar und dauert ca. 2 Stunden – nicht weil es so viel Arbeit ist, sondern weil der Pi eine ganze Weile braucht, bis alles installiert ist. Hinweis (Stand 2026): Diese Anleitung stammt von 2017. Node.js 4, Raspbian Jessie und das Init-Script sind veraltet. Heute installiert man Homebridge am einfachsten über das offizielle Homebridge-Image für den Raspberry Pi bzw. die Homebridge-Anleitung für Raspberry Pi OS; das Prinzip mit dem Gewerk „Homekit“ bleibt gleich. Benötigt werden ein Raspberry Pi (damals Modell 2 oder 3), eine Maus und ein Fernseher oder Monitor mit HDMI für den Desktop des Pi. Sicher funktionieren auch andere „Klein-Computer“, ich beziehe mich hier aber auf den Pi und mache aus ihm eine Homebridge. Ich arbeite zwar mit einem Mac, habe die Windows-Nutzer in dieser Anleitung aber nicht vergessen.

02Anleitung

• Als Erstes braucht man die richtige Software für den Pi. Die gibt es hier (damals Raspbian Jessie, heute Raspberry Pi OS – am einfachsten mit dem Raspberry Pi Imager)
• Nach dem Download muss die ZIP-Datei entpackt werden.
• Nun liegt das Betriebssystem als .img-Datei für den Pi vor.
• Für Windows- und Mac-Nutzer gibt es jeweils einen eigenen Weg, das Image auf die SD-Karte zu kopieren (Kartenleser vorausgesetzt). Heute erledigt das der Raspberry Pi Imager auf beiden Systemen.

03Mac

• Am Mac ist dieser Schritt etwas aufwendiger als unter Windows. Um die SD-Karte richtig zu beschreiben, muss man zuerst den „BSD-Namen“ herausfinden. Diesen findet man unter:

• Apple Logo oben links -> Über diesen Mac -> Systembericht -> USB -> disk2

• Es kann sein, dass bei „disk“ eine andere Zahl steht – diese bitte notieren. Mit einer falschen Nummer überschreibt man womöglich ein anderes Laufwerk!

• Nun Terminal öffnen und diese Zeile schreiben. Achtung die Disk Nummer anpassen sudo diskutil unmount /dev/disk2s1 das s1 lassen und SD Karte nicht entfernen

• Danach dann das Image auf die SD Karte kopieren sudo dd if=Downloads/2017-01-11-raspbian-jessie.img of=/dev/disk2 bs=1m ggf. Pfad und Disk anpassen. Dieser Schritt dauert eine ganze Weile – warten, bis im Terminal wieder die Eingabeaufforderung erscheint.

04Windows

• Für Windows User schlage ich das Programm Win32 Disk Imager vor. Das bitte downloaden und als Administrator öffnen.
• Nun die .img-Datei des Pi-Betriebssystems öffnen und als „Device“ das Laufwerk der SD-Karte wählen.
• Mit Write wird das Image auf die SD Karte geschrieben. Das kann eine ganze Weile dauern also bitte warten.

Abbildung vergrößern

• Nach dem Kopieren kann die SD-Karte entnommen und in den Pi gesteckt werden.
• Nun den Pi einschalten. Ich betreibe den Pi über USB-Strom; ein eigenes Netzteil funktioniert natürlich ebenso.
• Um die Netzwerkverbindung einzurichten, habe ich meinen Pi per HDMI an den Fernseher angeschlossen. Nach dem Hochfahren sieht man dort den Desktop des Pi.
• Die Verbindung zum Router kann über LAN oder WLAN hergestellt werden. An meinem Pi steckt ein kleiner WLAN-Adapter (ab dem Raspberry Pi 3 ist WLAN bereits eingebaut). Über den Desktop des Pi habe ich oben rechts die WLAN-Verbindung aufgebaut. Per LAN klappt die Verbindung automatisch.

Abbildung vergrößern

05SSH Verbindung herstellen

• Als Nächstes braucht man die IP-Adresse des Pi. Diese findet man am schnellsten im Router unter den Netzwerkverbindungen; am besten notiert man sie sich. (Bsp:192.168.178.68)
• Für Windows- und Mac-Nutzer gibt es nun jeweils einen Weg, per SSH auf den Pi zuzugreifen.

06Mac

• Zuerst muss die SSH Verbindung aktiviert werden. Dazu wechselt man auf den Desktop des PI und schaltet die SSH unter: PI -> Preferences -> Raspberry Pi Configuration -> SSH Enabled
• Am Mac öffnen wir nun das Terminal und verbinden uns via SSH mit dem Pi: ssh pi@192.168.178.68
• Password raspberry (Standardpasswort – unbedingt sofort mit dem Befehl passwd ändern! Bei aktuellem Raspberry Pi OS gibt es keinen Standardbenutzer mehr, Benutzer und Passwort legt man beim Einrichten selbst fest.)

07Windows

• Zuerst muss die SSH Verbindung aktiviert werden. Dazu wechselt man auf den Desktop des PI und schaltet die SSH unter: PI -> Preferences -> Raspberry Pi Configuration -> SSH Enabled
• Nun brauchen wir das Programm Putty.
• Unter Hostname geben wir die IP Adresse vom PI an und bei Connection Typ SSH
• Nun verbinden wir uns mit dem Pi mit dem Button Open
• Login: pi
• Passwort: raspberry (Standardpasswort – unbedingt mit passwd ändern!)

Abbildung vergrößern

Abbildung vergrößern

• Ab hier gibt es keine Unterschiede mehr zwischen Mac und Windows: Alle folgenden Befehle sind im Mac-Terminal und in PuTTY unter Windows identisch.

Bitte die Reihenfolge einhalten und jeden Befehl mit Enter bestätigen
Funktioniert etwas nicht, zuerst die Schreibweise prüfen. Manche Browser stellen Hochkommas, Bindestriche und Anführungszeichen anders dar. Klappt Copy and Paste nicht, den Befehl bitte von Hand eingeben.

• Befehl: sudo apt-get update
• Befehl: sudo apt-get upgrade (Dauert sehr lange. Bitte warten)

Hier gibt es einen kleinen Unterschied zwischen den Modellen 2 und 3

Raspberry Pi 2

• Befehl: wget https://nodejs.org/dist/v4.7.2/node-v4.7.2-linux-armv7l.tar.gz
• Befehl: tar -xvf node-v4.7.2-linux-armv7l.tar.gz
• Befehl: cd node-v4.7.2-linux-armv7l
• Befehl: sudo cp -R * /usr/local/
• Befehl: cd
• Befehl: rm node-v4.7.2-linux-armv7l.tar.gz
• Befehl: rm -R node-v4.7.2-linux-armv7l/

Raspberry Pi 3

• Befehl: wget https://nodejs.org/dist/v4.7.2/node-v4.7.2-linux-armv6l.tar.gz
• Befehl: tar -xvf node-v4.7.2-linux-armv6l.tar.gz
• Befehl: cd node-v4.7.2-linux-armv6l
• Befehl: sudo cp -R * /usr/local/
• Befehl: cd
• Befehl: rm node-v4.7.2-linux-armv6l.tar.gz
• Befehl: rm -R node-v4.7.2-linux-armv6l/

Nun wieder für alle Pi Modelle gleich

• Befehl: sudo apt-get install libavahi-compat-libdnssd-dev (mit y bestätigen)
• Befehl: sudo npm install -g --unsafe-perm homebridge
• Befehl: sudo npm install -g homebridge-homematic (Dauert sehr lange. Bitte warten)
• Befehl: sudo npm install forever (optional – den Autostart nach einem Stromausfall übernimmt das folgende Init-Script)
• Befehl: sudo nano /etc/init.d/homebridge (Folgenden Code via nano kopieren)

#!/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
# Description:       Enable service provided by daemon.
### END INIT INFO
 
dir="/home/pi"
cmd="DEBUG=* /usr/local/bin/homebridge"
user="pi"
 
name=`basename $0`
pid_file="/var/run/$name.pid"
stdout_log="/var/log/$name.log"
stderr_log="/var/log/$name.err"
 
get_pid() {
    cat "$pid_file"
}
 
is_running() {
    [ -f "$pid_file" ] && ps `get_pid` > /dev/null 2>&1
}
 
case "$1" in
    start)
    if is_running; then
        echo "Already started"
    else
        echo "Starting $name"
        cd "$dir"
        if [ -z "$user" ]; then
            sudo $cmd >> "$stdout_log" 2>> "$stderr_log" &
        else
            sudo -u "$user" $cmd >> "$stdout_log" 2>> "$stderr_log" &
        fi
        echo $! > "$pid_file"
        if ! is_running; then
            echo "Unable to start, see $stdout_log and $stderr_log"
            exit 1
        fi
    fi
    ;;
    stop)
    if is_running; then
        echo -n "Stopping $name.."
        kill `get_pid`
        for i in 1 2 3 4 5 6 7 8 9 10
        do
            if ! is_running; then
                break
            fi
 
            echo -n "."
            sleep 1
        done
        echo
 
        if is_running; then
            echo "Not stopped; may still be shutting down or shutdown may have failed"
            exit 1
        else
            echo "Stopped"
            if [ -f "$pid_file" ]; then
                rm "$pid_file"
            fi
        fi
    else
        echo "Not running"
    fi
    ;;
    restart)
    $0 stop
    if is_running; then
        echo "Unable to stop, will not attempt to start"
        exit 1
    fi
    $0 start
    ;;
    status)
    if is_running; then
        echo "Running"
    else
        echo "Stopped"
        exit 1
    fi
    ;;
    *)
    echo "Usage: $0 {start|stop|restart|status}"
    exit 1
    ;;
esac
 
exit 0

Nun noch ein paar Zeilen Code

• Befehl: sudo chmod 755 /etc/init.d/homebridge

• Befehl: sudo update-rc.d homebridge defaults

• Befehl: mkdir -p ~/.homebridge

• Befehl: sudo nano ~/.homebridge/config.json (Inhalt dieser Datei in Nano oder Putty kopieren und IP Adresse der CCU ändern)

• Jetzt wechselt man zurück zur CCU und legt ein neues Gewerk an, dem alle Aktoren zugeordnet werden, die mit Siri steuerbar sein sollen.

• Gewerkeliste bearbeiten

• Neues Gewerk anlegen

• Name: Homekit

Abbildung vergrößern

• Das Gewerk muss „Homekit“ heißen, weil es in der config.json so benannt ist. Ein anderer Name wie „Siri“ ist ebenso möglich, muss dann aber auch in der config.json stehen. Den Namen ändert man in der config.json ("subsection": "Homekit")
• Nun klickt man auf „Kanal hinzufügen“ und wählt alle gewünschten Aktoren aus.

Abbildung vergrößern

• Zurück ins Terminal bzw. in PuTTY und folgenden Befehl eingeben:
• Befehl: homebridge Startet die Homebridge. Wenn alles richtig ist, dann erscheint folgender Bildschirm mit einem grauen Kästchen mit der Nummer: 031-45-154)

Abbildung vergrößern

• Die Homebridge ist nun erfolgreich gestartet.

• Zum Koppeln habe ich die App Elgato Eve (heute „Eve“) genutzt. Alternativ koppelt man die Homebridge direkt mit Apples Home-App mit HomeKit.

• App öffnen und den Code der Homebridge in der iPhone- bzw. iPad-App eingeben.

• Gerät auswählen Homebridge

• Gerät hinzufügen und Code eingeben

• Nun sollten alle Aktoren erscheinen, die zuvor in der CCU dem Gewerk „Homekit“ zugeordnet wurden.

Abbildung vergrößern

• Alle gefundenen Geräte landen zunächst im Standardraum.
• Es empfiehlt sich, allen Aktoren den passenden Raum und die passende Funktion zuzuweisen.
• Wie man das organisiert, ist Geschmackssache. Die App erfordert etwas Eingewöhnung.

Abbildung vergrößern

Favoriten anlegen, um schnell auf verschiedene Aktoren zugreifen zu können

Abbildung vergrößern

Raumliste mit zugeordneten Aktoren

Abbildung vergrößern

Raum „Garten“ mit allen Aktoren, die dem Garten zugeordnet sind

Abbildung vergrößern

Aktor-Einstellungen: Hier vergibt man den Namen, auf den Siri hören soll

• Es ist wirklich ein schönes Gefühl, wenn der erste Aktor von Siri gesteuert wird. Herrlich!
• Bei Fragen oder Problemen nutzt bitte die Kommentarfunktion. Ich versuche zu helfen, wo ich kann.
• Wie man dann noch Programme und Variablen in das Homekit integriert folgt in einem weiteren Beitrag hier

08Siri - Sprachbefehle richtig anwenden

Wichtig: Für alle Aktoren sollte man eindeutige Namen und Räume vergeben. Siri ist bei den Formulierungen teilweise recht starr. Darum hier ein paar Beispiele, wie man Siri richtig anspricht.
Ich sage den zugewiesenen Raum des Aktors immer zuerst.

"Hey Siri…," (Wenn das iPhone im Standby ist, ansonsten kann man das weglassen)

• Setze Wohnzimmer Rolladen/Jalousie auf 30%
• Alle Rollos runter
• Wie warm ist es im Wohnzimmer
• Wohnzimmer Heizung auf 21,5 Grad
• Dimme Wohnzimmer Licht auf 50%
• Schalte Garagentor ein
• Schalte Küche Licht ein
• Schalte Garten Beleuchtung ein
• Schalte alle Lichter an / aus
• Etwas Experimentieren gehört dazu, bis Siri versteht, was man von ihr will.
• Ich freue mich, wenn unten in den Kommentaren weitere Kommandos ergänzt werden.

09Wichtige Homebridge Befehle auf dem Pi

Hier die wichtigsten Befehle für die Homebridge auf dem Raspberry Pi (für die hier beschriebene Installation; beim offiziellen Homebridge-Image steuert man den Dienst über die Homebridge UI oder hb-service).

• Befehl: sudo service homebridge stop (Stoppt die Homebridge)
• Befehl: homebridge (Startet die Homebridge)
• Befehl: sudo nano ~/.homebridge/config.json (Konfiguration der Homebridge)
• Befehl: sudo shutdown -r 0 (Neustart des Pi)

Kontakt via Mail hier

10Variablen und Programme der CCU an die Homebridge übergeben

Wer möchte, kann noch einen letzten Schritt gehen und auch Variablen und Programme der CCU mit Siri bedienen. Dazu sind nur wenige Schritte notwendig.

• Das Terminal am Mac bzw. PuTTY unter Windows starten.
• Am Pi anmelden: ssh pi@ipadresse und das Passwort eingeben.
• Die Homebridge stoppen mit: sudo service homebridge stop
• Die config.json mit diesem Befehl öffnen: sudo nano ~/.homebridge/config.json
• Nun ergänzt man alle Variablen und Programme in der config.json. Wichtig: Sie müssen exakt so heißen wie in der CCU, sonst funktionieren sie nicht. Außerdem steht nur eine begrenzte Anzahl an Zeichen zur Verfügung, und Sonderzeichen sollte man vermeiden. Hier ein Beispiel mit meinen Variablen:

Abbildung vergrößern

11Tipps aus der Praxis

• Ins Gewerk „Homekit“ nur die Kanäle aufnehmen, die wirklich per Siri gesteuert werden sollen. Türöffner, Garagentor oder Alarmanlage nur bewusst freigeben – Siri-Befehle lassen sich je nach Einstellung auch vom Sperrbildschirm aus geben.
• Kurze, eindeutige Namen vergeben und jedem Gerät in der Home-App einen Raum zuweisen. Dann genügen Befehle wie „Licht im Wohnzimmer aus“, und Siri verwechselt ähnlich benannte Geräte seltener.
• Nach Änderungen am Gewerk in der CCU die Homebridge neu starten, damit neue Kanäle eingelesen werden und in der Home-App erscheinen.
• Die Beispiel-PIN und den Standard-Benutzernamen aus älteren Anleitungen nicht übernehmen. Jede Homebridge sollte eine eigene PIN und eine eindeutige Kennung haben, und das Passwort des Pi sollte geändert sein.
• Systemvariablen und Programme in der config.json exakt so schreiben wie in der CCU und auf Sonderzeichen verzichten – schon ein abweichendes Leerzeichen verhindert die Zuordnung.
• Wer Homematic auch von unterwegs per Siri steuern möchte, braucht in HomeKit eine Steuerzentrale wie Apple TV oder HomePod.

12Häufige Fragen

13Passende Anleitungen

• Siri und Homematic über Apple TV 4 von unterwegs steuernSiri-Befehle auch von unterwegs nutzen
• Homebridge, HomeKit und npm-PluginsHomebridge um weitere Plugins erweitern
• Homematic mit Amazon Echo und Alexa steuernAlternative Sprachsteuerung mit Alexa
• Homematic Support – persönliche Hilfe per FernwartungHilfe per Fernwartung, wenn es hakt