Logitech Harmony Hub Smart-Home-Integration, kostenlos und Open Source

Logitech Harmony Hub im lokalen Netzwerk: Aktivitäten, Fernbedienungsbefehle, Szenen.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Steuere deinen Logitech Harmony Hub über Gladys im lokalen Netzwerk: Starte eine Aktivität („Fernsehen“, „Musik hören“), schalte alles aus, sende jede Fernbedienungstaste an die Geräte, die der Hub steuert (Fernseher, Verstärker, Mediaplayer…), und starte Szenen, wenn eine Aktivität beginnt — dimme das Licht, wenn „Film ansehen“ startet, egal ob über die Harmony-Fernbedienung, die App oder Gladys.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration ist nicht mit Logitech verbunden; Harmony ist eine Marke von Logitech.

Voraussetzungen

• Ein Logitech Harmony Hub (allein oder der Hub einer Harmony Companion, Elite, Pro oder Smart Control), mit der Harmony-App eingerichtet, im selben lokalen Netzwerk wie Gladys.
• Gladys 5.1 oder neuer.
• Am besten eine feste Adresse für den Hub in deinem Router (DHCP-Reservierung): Die Integration folgt einem Hub, der seine Adresse wechselt, aber mit einer festen Adresse ist die Verbindung schneller wieder da.

Kein Logitech-Konto, kein Passwort und kein Cloud-Zugang nötig: Die Integration spricht direkt mit dem Hub, über seinen lokalen Port 8088 (die WebSocket-API, die die Harmony-App nutzt). Die alte XMPP-API, auf neueren Firmwares standardmäßig deaktiviert, wird nicht verwendet.

Konfiguration

1. Installiere die Integration (Integrationen → Von GitHub installieren).
2. Öffne ihren Tab Konfiguration. Die Hubs im lokalen Netzwerk werden automatisch gesucht (SSDP, über Gladys weitergeleitet). Wird deiner nicht gefunden, gib seine IP-Adresse unter IP-Adressen der Hubs ein (mehrere Hubs: durch Kommas getrennt). Die Harmony-App zeigt sie unter Menü → Harmony-Einrichtung → Geräte & Aktivitäten hinzufügen/bearbeiten → Hub → Netzwerkinfo; auch dein Router listet sie auf.
3. Sprache legt die Namen der Funktionen neuer Geräte fest, den Namen der Auswahl „Aus“ und die Sprache der Fehlermeldungen (standardmäßig Französisch).
4. Hubs suchen startet eine Suche und listet die gefundenen Hubs auf, mit ihrer Adresse, der Anzahl ihrer Aktivitäten und Geräte und ob sie antworten.
5. Öffne den Tab Entdecken und füge die gewünschten Geräte hinzu (siehe unten).

Die Geräte

Jeder Hub liefert drei Arten von Geräten, die du einzeln im Tab „Entdecken“ hinzufügst. Jeder Gerätename beginnt mit dem Namen des Hubs, zum Beispiel „Harmony Living Room · Watch TV“.

Der Hub

• Aktuelle Aktivität: der Name der laufenden Aktivität oder „Aus“.
• Aktivität: eine Liste der Aktivitäten des Hubs, plus „Aus“. Eine Auswahl startet sie (oder schaltet alles aus). In einer Szene bietet die Kern-Aktion „Gerätewert setzen“ dieselbe Liste.

Die Aktivitäten

Ein Gerät pro Aktivität, mit einem einzigen Schalter, Läuft: an, solange die Aktivität läuft. Einschalten startet die Aktivität; Ausschalten schaltet alles aus (wenn diese Aktivität lief). Da es Geräte sind, lassen sich die Aktivitäten in den Szenen-Auslösern, den Szenen-Aktionen und den Widget-Einstellungen aus Listen auswählen.

Die vom Hub gesteuerten Geräte

Ein Gerät pro vom Hub gesteuertem Gerät (Fernseher, Verstärker, Apple TV…):

• Befehl: die Liste aller Befehle, die der Hub für das Gerät kennt (Eingänge, Klangmodi, Farbtasten…). Eine Auswahl sendet ihn.
• Drucktasten für die üblichen Fernbedienungstasten, die das Gerät hat: Lautstärke höher und niedriger, stumm, Kanäle, Pfeile und OK, Menü, Programm, Info, zurück, beenden, abspielen, Pause, Stopp, zurück- und vorspulen, vorheriger und nächster Titel, aufnehmen.

Die Befehle stammen aus der Konfiguration des Hubs: Ändere sie in der Harmony-App, und die Integration liest die neue Konfiguration von selbst.

Echtzeit

Der Hub meldet der Integration sofort, wenn eine Aktivität startet oder alles ausgeschaltet wird, egal wer es ausgelöst hat: Die Zustände ändern sich in Gladys in weniger als einer Sekunde. Zusätzlich liest die Integration alle 30 Sekunden die aktuelle Aktivität (eine verpasste Meldung, eine verlorene Verbindung) und sendet unveränderte Zustände alle 6 Stunden erneut, damit Gladys sie nie als veraltet anzeigt. Der Zeitplaner von Gladys wird nicht gebraucht.

Antwortet der Hub nicht mehr, tragen seine Geräte das Abzeichen „nicht erreichbar“, und die Integration verbindet sich von selbst neu, immer langsamer (bis zu einmal pro Minute).

Netzwerknutzung

Alles bleibt im lokalen Netzwerk: Kein Logitech-Server wird kontaktiert. Die Integration hält pro Hub eine Verbindung offen und sendet ihm alle 30 Sekunden eine kleine Anfrage, plus eine pro Befehl; die Konfiguration wird gelesen, wenn sie sich ändert. Eine Suche (beim Start, alle 15 Minuten und über die Taste) sendet eine SSDP-Anfrage über Gladys und fragt jede gefundene Adresse, ob sie ein Hub ist.

Szenen

Auslöser

• Harmony-Aktivität gestartet: Eine Aktivität startet, über die Fernbedienung, die App oder Gladys. Filter (optional): die Aktivität, der Hub. An die Aktionen weitergegebene Informationen: die Aktivität, die vorherige Aktivität, der Hub.
• Harmony hat alles ausgeschaltet: Der Hub schaltet alles aus. Filter (optional): der Hub. Informationen: die vorherige Aktivität, der Hub.

Die Auslöser reagieren, wenn der Hub die Änderung meldet, während er verbunden ist: Eine Änderung während einer Unterbrechung aktualisiert die Zustände, sobald die Verbindung zurück ist, ohne Szenen zu starten. Wechseln die Aktivitäten mehr als sechsmal in einer Minute (zwei Szenen, die gegenseitig ihre Aktivität starten), pausieren die Auslöser eine Minute lang.

Aktionen

• Harmony-Aktivität starten: Wähle das Aktivitätsgerät; die Aktion wartet, bis der Hub jedes Gerät eingeschaltet hat (bis zu 90 Sekunden).
• Alles ausschalten (Harmony): Wähle den Hub oder eines seiner Geräte.
• Harmony-Befehl senden: Wähle das Gerät, dann einen Befehl aus der Liste der üblichen oder gib den Namen eines beliebigen anderen unter Anderer Befehl ein (seinen Namen oder seine Bezeichnung, wie in der Liste „Befehl“ des Geräts, zum Beispiel InputHdmi1). Wiederholungen sendet ihn mehrmals, mit Pause zwischen Wiederholungen (in Millisekunden) dazwischen.

Ideen für Szenen

• Auslöser „Harmony-Aktivität gestartet“, Aktivität „Film ansehen“ → das Wohnzimmerlicht auf 20 % dimmen, die Rollläden schließen.
• Auslöser „Harmony hat alles ausgeschaltet“ → das Wohnzimmerlicht wieder einschalten.
• Jede Nacht um 1 Uhr → Aktion „Alles ausschalten (Harmony)“ (es wird nichts gesendet, wenn schon alles aus ist).
• Es klingelt an der Tür → Aktion „Harmony-Befehl senden“, Gerät „Denon AV Receiver“, Befehl „Stumm“.

Dashboard-Widget

Harmony-Fernbedienung zeigt die aktuelle Aktivität, eine Taste für bis zu drei Lieblingsaktivitäten (die ersten des Hubs, wenn in seinen Einstellungen keine gewählt ist) und eine Taste Ausschalten. Die laufende Aktivität trägt ein Häkchen. Ein Tippen antwortet, sobald der Hub den Befehl angenommen hat; das Widget folgt der Änderung. Bei mehreren Hubs wählst du einen in den Widget-Einstellungen.

Fehlerbehebung

• Kein Hub gefunden: Prüfe, ob der Hub im selben Netzwerk wie Gladys ist, und gib seine IP-Adresse in der Konfiguration ein. Die Suche über Gladys braucht ein Gladys, das SSDP weiterleitet; eingegebene Adressen funktionieren immer.
• „Kein Hub antwortet unter…“: Die Adresse antwortet nicht auf Port 8088. Prüfe die Adresse und ob der Hub Strom hat (seine Leuchte).
• Der Hub ist nicht erreichbar: Die Integration versucht es weiter; prüfe das WLAN des Hubs. Ein Hub mit neuer Adresse wird bei der nächsten Suche wiedergefunden (alle 15 Minuten oder über die Taste Hubs suchen).
• Ein Befehl bewirkt nichts: Der Hub hat ihn per Infrarot gesendet; prüfe, dass nichts zwischen dem Hub (oder seinem IR-Sender) und dem Gerät steht und dass der Befehl in der Harmony-App funktioniert.
• Eine neue Aktivität fehlt: Die Aktivität erscheint im Tab „Entdecken“, sobald sich der Hub mit der Harmony-App synchronisiert hat (etwa eine Minute).
• Mehr Details: Setze die Umgebungsvariable LOG_LEVEL auf debug und lies die Protokolle der Integration.

Grenzen

• Ohne die Hardware entwickelt: Das Protokoll folgt aioharmony, der Bibliothek der Home-Assistant-Integration, aber diese Integration wurde noch nicht an einem echten Hub getestet. Sag uns, was funktioniert und was nicht.
• Die Szenen-Aktion „Harmony-Befehl senden“ bietet die üblichen Befehle in einer Liste an; die anderen werden eingegeben. Die vollständige Liste eines Geräts ist seine Funktion Befehl (Kern-Aktion „Gerätewert setzen“).
• Zweimal hintereinander denselben Befehl in der Liste Befehl des Dashboards zu wählen, bewirkt beim zweiten Mal nichts (die Liste behält ihre Auswahl): Nutze für wiederholte Tasten die Drucktasten, das Widget oder eine Szene.
• Eine Taste wird gedrückt und sofort losgelassen: kein langes Drücken.
• Der Hub kennt nur, was er gesendet hat: Der Zustand von Fernseher oder Verstärker selbst (an, Lautstärke, Eingang) ist nicht bekannt, nur die laufende Aktivität.
• Harmony-„Sequenzen“, Hue-Lampen und mit dem Hub gekoppelte Smart-Home-Geräte werden nicht bereitgestellt.
• Logitech verkauft und entwickelt keine Harmony-Produkte mehr; ein Firmware-Update, das die lokale API schließt, würde diese Integration stoppen.

Konfigurationseinstellungen

Diese Einstellungen fragt Logitech Harmony Hub in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Deine Hubs finden	section	Nein	Harmony Hubs im selben Netzwerk wie Gladys werden automatisch gesucht: Öffne den Tab „Entdecken“. Fehlt deiner, gib unten seine IP-Adresse ein (Harmony-App: Menü, Harmony-Einrichtung, Geräte & Aktivitäten hinzufügen/bearbeiten, Hub, Netzwerkinfo). Ohne die Hardware entwickelt: Rückmeldungen willkommen. Nicht mit Logitech verbunden.
IP-Adressen der Hubs	string	Nein	Optional, durch Kommas getrennt. Nur für Hubs nötig, die die automatische Suche nicht findet. Gib dem Hub eine feste Adresse in deinem Router.
Sprache	select	Nein	Namen, die den Funktionen neuer Geräte gegeben werden (Aktivität, Befehl…), Name der Auswahl „Aus“ und Sprache der Fehlermeldungen.

So installierst du Logitech Harmony Hub in Gladys

1. Öffne in Gladys Integrationen: Logitech Harmony Hub erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-harmony:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-harmony.

Logitech Harmony Hub benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Logitech Harmony Hub ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂