Harmony

harmony
Zweck / Funktion
Anbindung Logitech Harmony Hub basierter Fernsbedienungen
Allgemein
Typ	Gerätemodul
Details
Dokumentation	EN / DE
Support (Forum)	Multimedia
Modulname	37_harmony.pm
Ersteller	Andre (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Das Fhem-Gerätemodul harmony bietet die Möglichkeit Logitech Harmony Hub basierte Fernbedienungen an Fhem anzubinden und so von Fhem aus Aktivitäten zu starten und zu stoppen, in Fhem auf das starten und stoppen von Aktivitäten über eine der mit dem Hub verbundenen Fernbedienungen zu reagieren oder auf Geräteebene jedes im Hub konfigurierte Gerät über IR, Bluetooth und/oder einen Smart Keyboard USB Dongle zu steuern.

Unterstütz werden zur Zeit die Modelle Ultumate Hub, Ultimate Smart Control, Ultimate, Smart Keyboard sowie alle darauf basierenden Kombinationen mit Smart Control und Smart Keyboard Add-On.

Define

 define <hub> harmony <ip>

Allgemeines

Aktivitäten und Geräte lassen sich an allen stellen entweder als ID oder als Name angeben. Wenn der Name angegeben wird müßen hierbei Leerzeichen durch einen Punkt ersetzt werden. Dies kann auch für eventuell andre im Namen vorhandene Sonderzeichen gelten.

Aktivität

Das Reading currentActivity enthält die gerade laufende Aktivität. Beim Wechsel zwischen Aktivitäten erzeugt es Events auf die in Fhem über notify reagiert werden kann. Das Reading previousActivity enthält die davor laufende Aktivität sofern diese bekannt ist. Diese Reading erzeugt keine Events.

In den Inernal currentActivityID und previousActivityID stehen die dazu gehörenden IDs der Aktivitäten.

Innerhalb einer laufenden Aktivität kann mit

 set <hub> command <command>

ein IR Kommando an eines der Beteiligten Geräte gesendet werden.

Geräteebene

Innerhalb und außerhalb einer laufenden Aktivität kann mit

 set <hub> command <id|name> <command>

ein IR Kommando an eines der im Hub bekannten Geräte gesendet werden. Hierbei ist darauf zu achten das innerhalb einer Aktivität keine Kommandos verwendet werden sollten die den Smart-State betreffen.

Fhem Devices auf Geräteebene

Es ist möglich sich für einzelne oder alle im Hub konfigurierten gerät ein zugehöriges Fhem device anlegen zu lassen:

 set <hub> autocreate [<id|name>]

Beim umschalten zwischen Aktivitäten wird in diesen Fhem devices wird im Reading power den in der Aktivität konfigurierten Einschaltzustand: on,off oder manual. Mit einem notify auf power Events lässt sich in Fhem auf einzelne Geräte reagieren.

Wichtig: Diese Fhem devices spiegeln nicht den tatsächlichen Gerätezustand wieder sondern den innerhalb einer Aktivität beabsichtigen Zustand. Der tatsächliche zustand kann z.b. auf Grund von Empfangsproblemen abweichen.

Das get commands sowie die set command, hidDevice, text, cursor und special Kommandos auf Hub ebene stehen hier direkt und ohne Angabe von Device ID oder Name zur verfügung.

Smart Keyboard

Der Harmony Hub kann über Bluetooth oder die zum Smart Keyboard gehörenden USB Dongle mit einem Rechner,Media PC oder sonstigem Gerät das Tastatureingabe unterstütz verbunden werden. Fhem kann diese Verbindung nutzen um beliebige Tastendrücke an ein solches gerät zu senden. Das können Texte sein, Bursorbewegungen oder die Power-, Multimedia oder sonstigen Funktionstasten die das Gerät unterstütz.

Alle gesendeten Tastendrücke beziehen sich normalerweise auf das zur gerade laufenden Aktivität gehörende Tastatureingabegerät. Mit dem hidDevice kommando lässt sich die Tastatureingabe auf jedes im Hub dafür konfigurierte Gerät umschalten.

Wichtig: Dieses Umschalten kann einige Sekunden dauern da zum die bestehende Bluetooth Verbindung getrennt und eine neue aufgebaut wird.

Es stehen die kommandos text, cursor und special zur verfügung.

Beispiele:

Gehe in PLEX auf die Library Musik und spiele das erste item in der OnDeck liste:

 set <hub> text M
 set <hub> cursor right
 set <hub> text p

Weblinks

• myHarmony Logitech Harmony Hersteller
• Harmony Remote Forum deutsches Harmony Forum