Homebridge auf Raspberry Pi

Über Homebridge kannst du unterschiedlichste Smart-Home-Geräte mit HomeKit verbinden. Die von der Homebridge-Community programmierten Plugins stellen die Verbindung her, sodass du von WLAN-Steckdosen über Luftreiniger und smarte Beleuchtung bis zu Wallboxen für E-Autos die unterschiedlichsten Geräte mit Homebridge verbinden kannst.

Du kannst Homebridge auf einem Raspberry Pi installieren. Darüber hinaus gibt es die Software auch für Linux-Distributionen, macOS, Windows sowie via Docker auch auf Synology DSM, QNAP und Unraid.

Die Konfigurationsdatei (config.json) der Homebridge befindet sich im jeweiligen Homebridge-Verzeichnis. Hast du Homebridge auf einem Raspberry Pi installiert, lautet der Pfad /var/lib/homebridge/config.json. Im Web-Interface kannst du dir die Datei im Reiter Config anzeigen lassen.

Ja, man kann Smart-Home-Geräte von Hama auch in Apple Home (HomeKit) verwenden. Dies gelingt durch die Software Homebridge und das Homebridge Plugin Tuya. Wie die Verknüpfung genau funktioniert, zeigt unsere Anleitung.

Mit einem Klick auf Choose OS kannst du das zu installierende Betriebssystem festlegen. Praktischerweise kannst du hier direkt Homebridge auswählen. Du findest es unter Other specific purpose OS > Home assistants and home automation > Homebridge. Wähle gegebenenfalls die neueste Version von Homebridge aus.

Über den mittleren Button Choose Storage wählst du jetzt deine Speicherkarte aus, auf der du Homebridge installieren möchtest. Beachte, dass sich darauf keine wichtigen Daten mehr befinden dürfen. Alle Daten auf der Speicherkarte werden im Zuge des nächsten Schritts von der Speicherkarte gelöscht.

Nach der Auswahl der Speicherkarte klicke auf Write, um das Homebridge-Image auf die Speicherkarte zu flashen. Dieser Vorgang nimmt einige Minuten in Anspruch. Wie lange es genau dauert, bis Homebridge auf deinem Raspberry Pi einsatzbereit ist, hängt von deiner Downloadgeschwindigkeit sowie der Schreibgeschwindigkeit deiner Speicherkarte ab.

Verbinde deinen Raspberry Pi jetzt mit deinem Router. Im Idealfall wähle dafür die Verbindung via Netzwerkkabel. Nachdem du das Kabel zwischen dem Raspberry Pi und deinem Router angeschlossen hast, schließe das Stromnetzteil an den Raspberry Pi an.

Wenn du deinen Raspberry Pi mit Homebridge über WLAN mit deinem Netzwerk verbinden möchtest, stelle zunächst sicher, dass der Pi nicht via Netzwerkkabel verbunden ist. Starte anschließend das Gerät und warte ein paar Minuten. Such dann mit deinem Handy nach WLANs in Reichweite. Verbinde dich mit dem WLAN Homebridge WiFi Setup. Anschließend kannst du die Zugangsdaten für dein Heim-WLAN eingeben, sodass der Pi sich drahtlos verbinden kann.

Jetzt ist die Homebridge-Installation abgeschlossen. Öffne einen Browser auf deinem Computer und gib im Adressfeld http://homebridge.local ein. Alternativ kannst du auch die lokale IP-Adresse deines Raspberry Pis verwenden. Diese findest du heraus, indem du dich an deinem Router anmeldest und dir die Liste der verbundenen Geräte anzeigen lässt.

Homebridge begrüßt dich mit einem Einrichtungsassistenten. Dort legst du ein Benutzerkonto mit Benutzername und Passwort an und schließt die Ersteinrichtung ab.

Greif nun zu deinem iOS-Gerät und öffne die Home App, um Homebridge mit HomeKit zu verbinden. Füge über das Pluszeichen ein neues Gerät hinzu und scanne anschließend den QR-Code, den Homebridge dir im Browser anzeigt. Bei der Meldung, dass es sich bei Homebridge auf dem Raspberry Pi um ein nicht zertifiziertes Gerät handelt, wähle Trotzdem hinzufügen.

Falls du darüber hinaus noch eine Meldung bekommst, dass noch weitere Einstellungen notwendig sind, ist das völlig in Ordnung, denn in Homebridge auf deinem Raspberry Pi sind ja noch keine Integrationen eingerichtet. Füge Homebridge einem Raum zu und benenne das neue Gerät nach Belieben, bevor du die Einrichtung abschließt.

Leg jetzt auf https://iot.tuya.com ein kostenloses Tuya-Konto an. Falls du bereits ein Tuya-Konto besitzt, melde dich mit deinen Logindaten an.

Klicke nun auf Cloud > Development und erstelle dann mit einem Klick auf Create Cloud Project ein neues Tuya-Projekt für Homebridge auf deinem Raspberry Pi. Vergib einen Projektnamen, etwa HomeKit-Verbindung, wähle im Feld Development Method Smart Home und beim Punkt Data Center den Eintrag Central Europe Data Center aus.

Klicke anschließend auf Create und leg im nächsten Schritt die Schnittstelle fest. Für Homebridge ist lediglich die Schnittstelle (API) Device status notification notwendig. Wähle diese aus und klicke zum Schluss auf Authorize.

Wechsle nun zum Reiter Devices und gehe zu Link Tuya App Account. Dort klickst du auf Add App Account und siehst einen QR-Code. Nimm nun dein Smartphone und öffne die Tuya SmartLife-App. Füge ein neues Gerät hinzu und scanne in diesem Zuge den QR-Code im Browser mit der Tuya SmartLife-App.

Im Browser öffnet sich anschließend ein neues Fenster. Wähle dort den Punkt Automatic Link (recommended) aus. Mit einem Klick auf OK bestätigst du deine Auswahl.

Erledigt. Nun werden deine Hama Smart-Home-Geräte, die du bereits in der Tuya SmartLife App eingerichtet hast, im Reiter All Devices angezeigt.

Um Tuya mit Homebridge auf deinem Raspberry Pi zu verbinden, benötigst du den Authorization Key, der aus einer Access ID und einem Access Secret besteht. Beide Schlüssel findest du in Tuya im Bereich Project Overview. Kopiere die Werte, um sie gleich in Homebridge auf deinem Raspberry Pi einzufügen.

Gehe im oberen Menü auf Plugins und suche nach Tuya. Das korrekte Plugin heißt Homebridge Tuya Platform. Klicke in dessen Kachel auf Install. Der Vorgang kann einige Minuten dauern.

Nach erfolgreicher Installation erscheint ein neues Fenster in Homebridge auf deinem Raspberry Pi. Dort nimmst du die Konfiguration wie folgt vor:

Username: Ihr Benutzername für die Tuya SmartLife-App
Password: Ihr Passwort für die Tuya SmartLife-App

Access-ID: Die Access-ID Ihres Tuya Cloud-Projekts
Access-Key: Der Access-Key Ihres Tuya Cloud-Projekts

Language Code: DE für Deutsch oder EN für Englisch

Project Type: PaaS
PaaS Platform: Smart Life

Country Code: 49 für Deutschland

Fertig. Speichere und Schließe die Config-Datei.

Klicke oben rechts auf das Ein-/Ausschalt-Symbol, um Homebridge auf deinem Raspberry Pi neu zu starten und das Tuya-Plugin in Betrieb zu nehmen. Wenn alles funktioniert hat, siehst du alle Smart-Home-Geräte, die du via Tuya SmartLife-App eingerichtet hast, im Menüpunkt Accessories in Homebridge.