homebridge hue
v0.14.7
Copyright © 2016-2024 Erik Baauw. Alle Rechte vorbehalten.
Dieses Homebridge-Plugin stellt Apples HomeKit Hue-kompatible Geräte (Leuchten, Stecker, Sensoren, Schalter usw.) zur Verfügung, die mit einer Hue-Bridge von Signify verbunden sind.
Beachten Sie, dass Hue ursprünglich von Philips entwickelt wurde, bevor diese ihre Beleuchtungssparte in Signify abspalteten. Signify verwendet weiterhin den Markennamen Philips Hue.
Im Wiki finden Sie eine Liste der Homebridge Hue-Funktionen und unterstützten Geräte, einschließlich eines Vergleichs der Funktionen von:
Homebridge Hue erkennt Hue-Brücken automatisch. Es unterstützt mehrere Bridges von einer Installation aus. Es unterstützt sowohl die Hue-Bridge v2 (quadratisch) als auch v1 (rund). Es funktioniert in Kombination mit der nativen HomeKit-Funktionalität der v2 Hue Bridge.
Eine detaillierte Beschreibung von Homebridge Hue finden Sie im Wiki.
Sie benötigen eine Philips Hue Bridge, um Homebridge Hue mit Ihren Hue-kompatiblen Leuchten, Schaltern und Sensoren zu verbinden. Ich empfehle die Verwendung der neuesten Hue Bridge-Firmware mit API v1.61.0 (v2 Bridge) oder v1.16.0 (v1 Bridge) oder höher.
Sie benötigen einen Server, um Homebridge auszuführen. Dies kann alles sein, auf dem Node.js läuft: von einem Raspberry Pi, einem NAS-System oder einem ständig eingeschalteten PC mit Linux, macOS oder Windows. Weitere Informationen finden Sie im Homebridge-Wiki. Ich empfehle die Verwendung von kabelgebundenem Ethernet, um den Server, auf dem Homebridge läuft, die Hue-Bridge und das AppleTV, das als Home-Hub fungiert, zu verbinden.
Um mit HomeKit interagieren zu können, benötigen Sie Siri oder eine HomeKit-App auf einem iPhone, einer Apple Watch, einem iPad, einem iPod Touch oder einem Apple TV (4. Generation oder höher). Ich empfehle, die neuesten veröffentlichten Versionen von iOS, watchOS und tvOS zu verwenden.
Bitte beachten Sie, dass Siri und sogar die Home-App von Apple immer noch nur eingeschränkte HomeKit-Unterstützung bieten. Um alle Funktionen von Homebridge Hue nutzen zu können, sollten Sie sich einige andere HomeKit-Apps ansehen, beispielsweise die Eve-App (kostenlos) oder die Home+-App von Matthias Hochgatterer (kostenpflichtig).
Da HomeKit Multicast-DNS (auch bekannt als Bonjour) verwendet, um Homebridge zu erkennen, muss sich der Server, auf dem Homebridge ausgeführt wird, im selben Subnetz befinden wie Ihre iDevices, auf denen HomeKit ausgeführt wird. Für den Fernzugriff und für HomeKit-Automatisierungen (inkl. Unterstützung für drahtlose Schalter) müssen Sie ein Apple TV (4. Generation oder höher) oder einen HomePod als Home-Hub einrichten.
Homebridge Hue enthält das ph -Befehlszeilendienstprogramm zur Interaktion mit der Hue-API über die Befehlszeile. Eine Einführung in dieses Dienstprogramm finden Sie im Tutorial im Wiki.
Geben Sie ph -h oder ph --help ein, um einen kurzen Überblick über seine Funktionalität und Befehlszeilenargumente zu erhalten.
So installieren Sie Homebridge Hue:
Befolgen Sie die Anweisungen im Homebridge-Wiki, um Node.js und Homebridge zu installieren.
Installieren Sie das Homebridge Hue-Plugin über Homebridge Config UI X oder manuell durch:
$ sudo npm -g i homebridge-hue
Bearbeiten Sie config.json und fügen Sie die von Homebridge Hue bereitgestellte Hue -Plattform hinzu, siehe Konfiguration ;
Führen Sie Homebridge Hue zum ersten Mal aus und drücken Sie die Verbindungstaste auf (jeder) Ihrer Bridge(s). Notieren Sie sich das Bridge-ID/API-Schlüsselpaar für jede Bridge in der Protokollausgabe. Bearbeiten Sie config.json , um diese einzuschließen, siehe Konfiguration .
Beachten Sie, dass Sie diese nicht über die Homebridge Hue -Einstellungen in Homebridge Config UI X hinzufügen können, aber Sie können den Homebridge Config Editor verwenden.
Um Homebridge Hue zu aktualisieren, geben Sie einfach ein weiteres sudo npm -gi homebridge-hue@latest aus. Bitte lesen Sie die Versionshinweise, bevor Sie Homebridge Hue aktualisieren. Beachten Sie, dass eine Änderung an der Nebenversion normalerweise darauf hinweist, dass Sie Ihre HomeKit-Konfiguration überprüfen/erneuern müssen. Aufgrund von Änderungen in der Zuordnung, wie Hue-Bridge-Ressourcen verfügbar gemacht werden, behandelt HomeKit sie möglicherweise als neues Zubehör, Dienste und/oder Eigenschaften und verliert dabei jegliche Zuordnung zu HomeKit-Räumen, Szenen, Aktionen und Auslösern. Um zu einer früheren Version zurückzukehren, geben Sie die Version bei der Installation von Homebridge Hue an, wie in: sudo npm -gi [email protected] .
In config.json von Homebridge müssen Sie Homebridge Hue als Plattform-Plugin angeben. Darüber hinaus müssen Sie angeben, was Sie HomeKit zugänglich machen möchten. Eine vollständige Referenz der von Homebridge Hue verwendeten config.json Einstellungen sowie einige Beispiele finden Sie im Wiki.
Eine detailliertere Steuerung darüber, welche Ressourcen Homebridge Hue HomeKit zur Verfügung stellt und wie Ressourcenverknüpfungen auf der Bridge erstellt werden, finden Sie im Wiki.
Bitte schauen Sie sich die FAQ an.
Wenn beim Start von Homebridge Probleme auftreten, überprüfen Sie bitte noch einmal, welche Versionen von Node.js und Homebridge installiert wurden. Homebridge Hue wurde mit der neuesten LTS-Version von Node.js und der neuesten Version von Homebridge entwickelt und getestet. Andere Versionen könnten funktionieren oder auch nicht – ich habe einfach nicht die Bandbreite, diese zu testen.
Wenn beim Start von Homebridge Probleme auftreten, führen Sie bitte eine separate Instanz von Homebridge aus, wobei in config.json nur Homebridge Hue (und Homebridge Config UI X) aktiviert ist. Auf diese Weise können Sie feststellen, ob das Problem mit Homebridge Hue selbst oder mit dem Zusammenspiel mehrerer Homebridge-Plugins in Ihrem Setup zusammenhängt. Sie können diese separate Instanz von Homebridge auf einem anderen System, als anderer Benutzer oder aus einem anderen Benutzerverzeichnis (angegeben durch das Flag -U ) starten. Stellen Sie sicher, dass Sie in der config.json für jede Instanz einen anderen Homebridge- name , username und (bei Ausführung auf demselben System) port verwenden.
Homebridge Hue gibt für jeden eingestellten HomeKit-Merkmalswert und für jede empfangene HomeKit-Merkmalswert-Änderungsbenachrichtigung eine Infomeldung aus. Wenn Homebridge mit -D gestartet wird, gibt Homebridge Hue eine Debug-Nachricht für jede Anfrage an die Bridge aus, für jede Statusänderung, die es beim Abfragen der Bridge erkennt, und für jede Push-Benachrichtigung, die es vom Gen-2-Hue-Bridge-Ereignisstrom empfängt. Darüber hinaus wird für jede erkannte Bridge-Ressource eine Debug-Meldung ausgegeben.
Um diese Nachrichten in einer Protokolldatei zu erfassen, gehen Sie wie folgt vor:
$ homebridge -CD 2>&1 | tee homebridge.log
$ gzip homebridge.log
Um die Fehlerbehebung zu erleichtern, speichert Homebridge Hue beim Start seine Umgebung, einschließlich seiner config.json Einstellungen und des vollständigen Status aller Bridges, in einer komprimierten JSON-Datei, homebridge-hue.json.gz . IP-Adressen und Bridge-API-Schlüssel werden maskiert. Diese Datei wird standardmäßig im Homebridge-Benutzerverzeichnis ~/.homebridge erstellt. Es kann über die Benutzeroberfläche von Homebridge Config UI X im Popup-Fenster „Homebridge Hue SETTINGS“ auf der Registerkarte „Plugins“ heruntergeladen werden.
Wenn Sie eine Frage haben, posten Sie bitte eine Nachricht an den #hue -Kanal der Homebridge-Community auf Discord.
Wenn Sie auf ein Problem stoßen, öffnen Sie bitte ein Issue auf GitHub. Bitte fügen Sie dem Problem eine Kopie von homebridge-hue.json.gz bei, siehe Debug-Dump-Datei . Bitte fügen Sie dem Problem eine Kopie von homebridge.log.gz bei, siehe Debug-Protokolldatei . Bitte kopieren/fügen Sie keine großen Mengen der Protokollausgabe ein.
Manchmal bekomme ich die Frage, wie Menschen meine Arbeit an Homebridge Hue unterstützen können. Ich habe Homebridge Hue als Hobbyprojekt für meinen eigenen Gebrauch erstellt. Ich teile es auf GitHub, damit andere davon profitieren können und um der Open-Source-Community etwas zurückzugeben, ohne die Homebridge Hue nicht möglich gewesen wäre.
Allerdings ist es sehr schwierig, in Homebridge Hue Unterstützung für neue Geräte hinzuzufügen, ohne physischen Zugriff auf das Gerät zu haben. Da es sich um ein Hobbyprojekt handelt, kann ich es mir nicht leisten, Geld für Geräte auszugeben, die ich nicht selbst nutze, nur um sie zum Nutzen anderer zu integrieren. Ich freue mich über kleine Spenden in Form von neuen Geräten zur Integration oder über das Geld, um diese Geräte selbst zu kaufen. Gerne sende ich die Geräte auch im Nachhinein zurück, wenn Sie die Versandkosten angeben. Bitte kontaktieren Sie mich per E-Mail oder auf Discord für Versanddetails.
Homebridge Hue ist ein Hobbyprojekt von mir, bereitgestellt im Ist-Zustand und ohne jegliche Garantie. Ich betreibe es seit Jahren erfolgreich bei mir zu Hause, aber Ihre Laufleistung kann variieren.
Die HomeKit-Terminologie ist gewöhnungsbedürftig. Ein Zubehör entspricht mehr oder weniger einem physischen Gerät, auf das Sie von Ihrem iOS-Gerät über WLAN oder Bluetooth zugreifen können. Eine Bridge (wie Homebridge) ist ein Zubehörteil, das den Zugriff auf andere überbrückte Zubehörteile ermöglicht. Ein Zubehörteil kann mehrere Dienste bereitstellen. Jeder Dienst entspricht einem virtuellen Gerät (wie einer Glühbirne, einem Schalter, einem Bewegungssensor usw., aber auch: einer programmierbaren Schaltertaste, Zubehörinformationen, Batteriestatus). Siri interagiert mit Diensten, nicht mit Zubehör. Ein Dienst enthält ein oder mehrere Merkmale . Ein Merkmal ist wie ein Dienstattribut, das von HomeKit-Apps gelesen oder geschrieben werden kann. Vielleicht möchten Sie sich den HomeKit-Zubehörsimulator von Apple ansehen, der als zusätzliches Tool für Xcode vertrieben wird.
Intern identifiziert HomeKit Zubehörteile anhand der UUID. Bei Zigbee-Geräten (Leuchten, Sensoren, Schalter) basiert Homebridge Hue diese UUID auf der Zigbee-Mac-Adresse. Für Nicht-Zigbee-Ressourcen (Gruppen, Zeitpläne, CLIP-Sensoren) basiert die UUID auf der Bridge-ID und dem Ressourcenpfad (z. B. /sensors/1 ). Indem Homebridge Hue den Ressourcennamen (z. B. Daylight ) nicht verwendet, kann er mit doppelten Namen umgehen. Darüber hinaus erkennt HomeKit das Zubehör auch dann noch, wenn sich der Ressourcenname auf der Bridge geändert hat, und merkt sich, zu welchem HomeKit-Raum, zu welchen Gruppen, Szenen, Aktionen und Auslösern es gehört. Wenn jedoch eine Nicht-Zigbee-Bridge-Ressource gelöscht und dann neu erstellt wird, was zu einem anderen Ressourcenpfad führt, behandelt HomeKit sie als neues Zubehör und Sie müssen HomeKit neu konfigurieren.
