Da RaZberry mittlerweile seine HomeKit-Funktionalität entfernt hat, habe ich mich nach einer geeigneten Alternative für einen HomeKit-Server auf meinem Raspberry Pi umgesehen und bin dabei bei dem Projekt „HomeBridge“ gelandet. Dieser Server basiert auf NodeJS und lässt sich dank zahlreich vorhandener Plugins einfach erweitern, sodass man damit bequem über die HomeKit API seine Sensoren und Aktoren ansteuern kann.

In diesem Artikel geht es um die Grundinstallation von HomeBridge auf einem Raspberry Pi. Wie man diese Installation für sein eigenes vorhandenes Setup (z.B. Funksteckdosen, Temperatur- / Luftfeuchtigkeitssensoren, Infrarot-Geräte etc.) mit Hilfe bereits existierender Plugins erweitern kann, folgt in einem separaten Artikel.

Bevor ihr mit der weiteren Installation beginnt, solltet ihr über

Shell
1
2
sudo apt-get update
sudo apt-get upgrade

eure Paketquellen und Pakete auf den aktuellsten Stand bringen, um etwaige Probleme mit Abhängigkeiten von Paketen zu umgehen.

 

1. Update des C++-Compilers

Hinweis: Dieser Schritt ist nur notwendig für Nutzer, die noch Raspbian Wheezy einsetzen. Unter Jessie solltet ihr die aktuelle Version des Compilers bereits installiert haben. Ihr könnt das überprüfen mit g++-4.9 -v. Erhaltet ihr in der letzten Zeile gcc version 4.9.x,so könnt ihr diesen Schritt überspringen. Das gilt natürlich auch für Wheezy-Installationen, bei denen ihr den Compiler schon aktualisiert habt.

Um die neueste Version des Compilers für Raspbian zu installieren, müsst ihr zunächst eure Paketquellen (temporär) ändern. Bearbeitet dazu die Paketquellen, z.B. via sudo nano /etc/apt/sources.list und ersetzt „wheezy“ jeweils mit „jessie“. Speichert die Änderungen und führt ein sudo apt-get update aus, um die Änderungen an den Paketquellen durchzuführen. Anschließend könnt ihr mit sudo apt-get install gcc-4.9 g++-4.9 die benötigte Version des Compilers installieren. Ihr könnt (und solltet) dann die Änderungen an den Paketquellen wieder rückgängig machen, indem ihr diese wieder bearbeitet via sudo nano /etc/apt/sources.list und „jessie“ wieder durch „wheezy“ ersetzt. Ein anschließendes sudo apt-get update bringt eure Quellen wieder auf den Ursprungszustand.

Um die Standardcompilerversion noch der neu installierten Version anzupassen, reichen diese beiden Befehle, die ihr einfach nacheinander aufrufen könnt:

Shell
1
2
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.9 60 --slave /usr/bin/g++ g++ /usr/bin/g++-4.9
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.6 40 --slave /usr/bin/g++ g++ /usr/bin/g++-4.7

Gebt ihr nun g++ -v ein, sollte in der letzten ausgegebenen Zeile

Shell
1
gcc version 4.9.x

stehen.

 

2. Installation von NodeJS

Hinweis: Bei der Installation wird zwischen Raspberry 1 (Raspberry A, Raspberry B, Raspberry B+, Raspberry Zero) und Raspberry 2 (Raspberry Pi B2) unterschieden. Bitte achtet darauf, die richtige Version zu installieren! Falls ihr nicht wisst, welche Version ihr habt, könnt ihr dies an den technischen Daten erkennen. Handelt es sich um ein Modell mit 1GB RAM, so ist es ein Raspberry 2, hat euer Raspberry 512MB oder weniger, so ist es ein Raspberry 1.

Update 03.03.2016: Mittlerweile gibt es einen neuen Raspberry Pi – den Raspberry Pi 3. Auch auf diesem lässt sich HomeBridge installieren. Bei der NodeJS-Version sollte auch hier die ARMv7-Version wie beim Raspberry Pi 2 laufen.

Wechselt zur Installation am Besten über „cd“ erst einmal in euer Home-Verzeichnis. Anschließend schaut ihr auf dieser Seite, welche Version von NodeJS in der LTS-Version aktuell „stable“ ist. Zur Zeit der Artikelerstellung war das 4.3.0.

Ladet euch die Version auf euren Raspberry Pi herunter, entpackt sie und wechselt in das erstellte Verzeichnis:

  • Raspberry 1:
    Shell
    1
    2
    3
    wget https://nodejs.org/dist/v4.3.0/node-v4.3.0-linux-armv6l.tar.gz
    tar -xvf node-v4.3.0-linux-armv6l.tar.gz
    cd node-v4.3.0-linux-armv6l
  • Raspberry 2:
    Shell
    1
    2
    3
    wget https://nodejs.org/dist/v4.3.0/node-v4.3.0-linux-armv7l.tar.gz
    tar -xvf node-v4.3.0-linux-armv7l.tar.gz
    cd node-v4.3.0-linux-armv7l

Anschließend kopiert ihr den Inhalt des Verzeichnisses nach „/usr/local“:

Shell
1
sudo cp -R * /usr/local/

Um die erfolgreiche Installation zu prüfen, führt ihr ein node -vaus, bei dem ihr als Ausgabe nun „v4.3.0“ erhalten solltet (bzw. aktueller).

Hat das soweit geklappt, könnt ihr die heruntergeladene Datei sowie den entpackten Ordner löschen:

  • Raspberry 1:
    Shell
    1
    2
    rm node-v4.3.0-linux-armv6l.tar.gz
    rm -R node-v4.3.0-linux-armv6l/
  • Raspberry 2:
    Shell
    1
    2
    rm node-v4.3.0-linux-armv7l.tar.gz
    rm -R node-v4.3.0-linux-armv7l/

 

3. Installation weiterer Pakete

Ein paar weitere Pakete werden für Avahi noch benötigt. Diese können einfach über apt installiert werden:

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

 

4. Installation von HomeBridge

Die Installation von HomeBridge selbst ist nun denkbar einfach. Ein einfaches

Shell
1
sudo npm install -g --unsafe-perm homebridge

sollte euch HomeBridge in der aktuellsten Version über npm laden und installieren lassen. Das dauert etwas, sollte aber in einigen Minuten (zumindest beim Raspberry 1) abgeschlossen sein.

Ihr könnt anschließend eure Installation prüfen, indem ihr HomeBridge ganz einfach über homebridge im Terminal startet. Es kommen jetzt noch Meldungen, dass keine Plugins und keine Konfigurationsdatei gefunden wurden, das ist in der Grundinstallation normal. Wie ihr eure Geräte einbindet über die Plugins und passende Konfigurationsdateien erstellt, werde ich im nachfolgenden Blogbeitrag beschreiben.

 

5. Autostart von HomeBridge

Der Autostart von HomeBridge ist natürlich nur dann sinnvoll, wenn ihr den Service soweit samt Plugins und Konfiguration auf eurem Raspberry Pi eingerichtet habt. Der Vollständigkeit halber, beschreibe ich diesen Schritt aber auch noch in diesem Artikel.

Hier wird unterschieden, zwischen 2 Möglichkeiten: Einmal via init.d (Wheezy und älter) und über systemd (Jessie und neuer). Da ich selbst auf meinem Raspberry Pi noch Wheezy nutze, gehe ich hier nur auf die Methode via init.d ein. Wer systemd nutzen möchte, findet hier eine ausführliche Beschreibung dazu.

 

5.1 Autostart über init.d

Erstellt zunächst eine neue Datei unter „/etc/init.d/“ über sudo nano /etc/init.d/homebridge, welche ihr mit folgendem Inhalt füllt:

homebridge
Shell
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
#!/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..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

Anschließend ändert ihr noch die Benutzerrechte und installiert das erstellte Script:

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

Ihr könnt nun HomeBridge ganz einfach über sudo /etc/init.d/homebridge start starten. Beim Systemstart sollte HomeBridge zudem nun automatisch gestartet werden. Die Ausgaben von HomeBridge findet ihr nun übrigens unter „/var/log/homebridge.log“ bzw. “/var/log/homebridge.err“.

Damit ist die Grundinstallation vom HomeKit abgeschlossen. Im nächsten Artikel geht es dann um die Konfiguration und Erweiterung der Installation. Dabei werde ich insbesondere auf das Steuern von Funksteckdosen über Raspberry-Remote eingehen und zeigen, wie sich Sensoren einbinden lassen.

Tipp: Ihr könnt die Push-Benachrichtigung eures Browsers verwenden, um über neue Artikel benachrichtigt zu werden. Akzeptiert dazu einfach die Meldung eures Browsers beim Aufruf dieser Seite und ihr werdet automatisch benachrichtigt. Das Abo könnt ihr natürlich jederzeit beenden.

Verwandte Artikel: