Homebridge auf Raspberry Pi

• Was ist Homebridge?

  Homebridge ist eine Smart-Home-Software, die smarte Geräte ohne offizielle HomeKit-Zertifizierung mit HomeKit verbindet. So können Sie zahlreiche smarte Geräte unterschiedlicher Hersteller über die Home App von Apple steuern und automatisieren.

• Was kann ich mit Homebridge verbinden?

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

• Wo kann ich Homebridge installieren?

  Sie können 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.

• Wo befindet sich die Konfigurationsdatei (config.json) der Homebridge?

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

• Kann man Smart-Home-Geräte von Hama auch in Apple Home (HomeKit) verwenden?

  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.

• Schritt 1: Raspberry Pi Imager starten

  Der einfachste Weg, um Homebridge auf einem Raspberry Pi zu installieren, bietet ein Tool namens Raspberry Pi Imager. Laden Sie das Programm auf Ihren Computer herunter, stecken Sie die MicroSD-Speicherkarte Ihres Raspberry Pis in den Cardreader Ihres Computers ein und starten Sie den Raspberry Pi Imager.

  
• Schritt 2: Betriebssystem auswählen

  Mit einem Klick auf Choose OS können Sie das zu installierende Betriebssystem festlegen. Praktischerweise können Sie hier direkt Homebridge auswählen. Sie finden es unter Other specific purpose OS > Home assistants and home automation > Homebridge. Wählen Sie gegebenenfalls die neueste Version von Homebridge aus.

  
• Schritt 3: Speicherkarte auswählen

  Über den mittleren Button Choose Storage wählen Sie jetzt Ihre Speicherkarte aus, auf der Sie Homebridge installieren möchten. Beachten Sie, 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.

  
• Schritt 4: Homebridge auf Raspberry Pi installieren

  Nach der Auswahl der Speicherkarte klicken Sie 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 Ihrem Raspberry Pi einsatzbereit ist, hängt von Ihrer Downloadgeschwindigkeit sowie der Schreibgeschwindigkeit Ihrer Speicherkarte ab.

  
• Schritt 5: Netzwerkverbindung einrichten

  Verbinden Sie Ihren Raspberry Pi jetzt mit Ihrem Router. Im Idealfall wählen Sie dafür die Verbindung via Netzwerkkabel. Nachdem Sie das Kabel zwischen dem Raspberry Pi und Ihrem Router angeschlossen haben, schließen Sie das Stromnetzteil an den Raspberry Pi an.

  Wenn Sie Ihren Raspberry Pi mit Homebridge über WLAN mit Ihrem Netzwerk verbinden möchten, stellen Sie zunächst sicher, dass der Pi nicht via Netzwerkkabel verbunden ist. Starten Sie anschließend das Gerät und warten Sie ein paar Minuten. Suchen Sie dann mit Ihrem Handy nach WLANs in Reichweite. Verbinden Sie sich mit dem WLAN Homebridge WiFi Setup. Anschließend können Sie die Zugangsdaten für Ihr Heim-WLAN eingeben, sodass der Pi sich drahtlos verbinden kann.

  
• Schritt 6: Homebridge auf Raspberry Pi aufrufen

  Jetzt ist die Homebridge-Installation abgeschlossen. Öffnen Sie einen Browser auf Ihrem Computer und geben Sie im Adressfeld http://homebridge.local ein. Alternativ können Sie auch die lokale IP-Adresse Ihres Raspberry Pis verwenden. Diese finden Sie heraus, indem Sie sich an Ihrem Router anmelden und sich die Liste der verbundenen Geräte anzeigen lassen.

• Schritt 7: Benutzername und Passwort festlegen

  Homebridge begrüßt Sie mit einem Einrichtungsassistenten. Dort legen Sie ein Benutzerkonto mit Benutzername und Passwort an und schließen die Ersteinrichtung ab.

• Schritt 8: HomeKit mit Homebridge verbinden

  Greifen Sie nun zu Ihrem iOS-Gerät und öffnen Sie die Home App, um Homebridge mit HomeKit zu verbinden. Fügen Sie über das Pluszeichen ein neues Gerät hinzu und scannen Sie anschließend den QR-Code, den Homebridge Ihnen im Browser anzeigt. Bei der Meldung, dass es sich bei Homebridge auf dem Raspberry Pi um ein nicht zertifiziertes Gerät handelt, wählen Sie Trotzdem hinzufügen.

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

Hama Geräte mit Tuya verbinden

• Schritt 1: Geräte in der SmartLife-App einrichten

  Wenn Sie noch keine Smart-Home-Geräte von Hama in Betrieb genommen haben, beginnen Sie damit zuerst. Installieren Sie die Tuya SmartLife-App (Android und iOS) auf Ihrem Smartphone und richten Sie Ihr Smart-Home-Gerät darüber ein.

  Falls Sie das Gerät bereits mit der Hama Smart Home App verwendet haben, wird es mit der Einrichtung in der SmartLife-App aus der Hama Smart Home App entfernt und ist darüber nicht mehr erreichbar.

• Schritt 2: Bei Tuya registrieren

  Legen Sie jetzt auf https://iot.tuya.com ein kostenloses Tuya-Konto an. Falls Sie bereits ein Tuya-Konto besitzen, melden Sie sich mit Ihren Logindaten an.

• Schritt 3: Smart-Home-Projekt für Homebridge anlegen

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

  Klicken Sie anschließend auf Create und legen Sie im nächsten Schritt die Schnittstelle fest. Für Homebridge ist lediglich die Schnittstelle (API) Device status notification notwendig. Wählen Sie diese aus und klicken Sie zum Schluss auf Authorize.

• Schritt 4: Hama Geräte integrieren

  Wechseln Sie nun zum Reiter Devices und gehen Sie zu Link Tuya App Account. Dort klicken Sie auf Add App Account und sehen einen QR-Code. Nehmen Sie nun Ihr Smartphone und öffnen Sie die Tuya SmartLife-App. Fügen Sie ein neues Gerät hinzu und scannen Sie in diesem Zuge den QR-Code im Browser mit der Tuya SmartLife-App.

  Im Browser öffnet sich anschließend ein neues Fenster. Wählen Sie dort den Punkt Automatic Link (recommended) aus. Mit einem Klick auf OK bestätigen Sie Ihre Auswahl.

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

• Schritt 5: Authorization Key kopieren

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

• Schritt 1: Tuya Homebridge-Plugin auf Raspberry Pi installieren

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

• Schritt 2: Homebridge-Config anpassen

  Nach erfolgreicher Installation erscheint ein neues Fenster in Homebridge auf Ihrem Raspberry Pi. Dort nehmen Sie 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. Speichern und schließen Sie die Config-Datei.

• Schritt 3: Homebridge auf Raspberry Pi neustarten

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