[[Vorlage(Getestet, Focal)]] 
{{{#!vorlage Wissen
[:Pakete_installieren: Installation von Programmen] 
[:Terminal: Ein Terminal öffnen] 
[:Editor: Einen Editor öffnen]
[:Programme_starten: Ein Programm starten]
}}}
[[Inhaltsverzeichnis(3)]]  
[[Bild(./harmony.png, 60, align=left)]] 
[http://www.logitech.com/index.cfm/remotes/universal_remotes/&cl=de,de Logitech Harmony] {de} ist eine Serie von Universalfernbedienungen, also Fernbedienungen mit denen man mehrere Geräte auf einmal steuern kann. Diese werden über eine Webseite programmiert. Ist die Programmierung abgeschlossen, so wird eine Datei auf die Fernbedienung übertragen. Mit Hilfe der Bibliothek [http://www.phildev.net/harmony/ Concordance] {en} ist es externen Programmen und Skripten erlaubt, Logitech Harmony Fernbedienungen unter Linux anzusprechen. Welche Modelle der Fernbedienung derzeit unterstützt werden, kann auf der [http://www.phildev.net/harmony/supported_models.shtml Webseite des Entwicklers] {en} nachgelesen werden. 

Concordance teilt sich in zwei Teile auf: die eigentliche Bibliothek '''libconcord''' und das Terminalprogramm '''concordance''', mit dem die Fernbedienung angesprochen werden kann. Des Weiteren gibt es mit '''congruity''' ein Pythonskript, welches eine simple grafische Oberfläche zur einfacheren Verwaltung der Fernbedienung bietet.

= Installation =
Es genügt, die beiden Pakete aus den Paketquellen zu installieren [1] und danach die [#udev-Regel-anlegen udev Regeln zu erweitern.]
{{{#!vorlage Paketinstallation
congruity
concordance
}}}

= udev-Regel anlegen =
Im Idealfall ist es nicht nötig eine solche [:udev:]-Regel anzulegen. Sollte die Fernbedienung aber nicht vom System erkannt werden, so muss dann doch eine Regel für das Gerät angelegt werden. Dazu ist es notwendig die Vendor- und Product-ID der jeweiligen Fernbedienung zu ermitteln. Dazu in einem Terminal [2]

{{{#!vorlage Befehl
lsusb
}}}

bei, per USB, angeschlossener Fernbedienung eingeben und die Vendor:Product-ID notieren. Als Ausgabe erscheint folgendes:

{{{
Bus 007 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 006 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
Bus 005 Device 008: ID 046d:c111 Logitech, Inc.
}}}

Nun muss eine neue Datei namens '''85-harmony.rules''' im Pfad '''/etc/udev/rules.d''' erzeugt [3] werden. Diese muss folgenden Inhalt haben:
 
{{{SYSFS{idVendor}=="046d", SYSFS{idProduct}=="[ID_PRODUCT]", MODE="666"
}}}

SYSFS{idProduct}=="[ID_PRODUCT]" muss auf das eigene Modell abgestimmt sein. Hier einige Beispiele:

|| <rowclass="kopf"> Produktbezeichnung || ID_PRODUCT ||
|| Harmony 555 (Mocha Grande)|| c111 ||
|| <rowclass="highlight"> Harmony 885 (Espresso) || c110 ||
|| Harmony 300 || c124 ||

Damit ergibt sich dann folgender oder ähnlicher Aufbau für eine Harmony 555:

{{{
SYSFS{idVendor}=="046d", SYSFS{idProduct}=="c111", MODE="666"
}}}

Nachdem udev mittels folgenden Befehls

{{{#!vorlage Befehl
sudo /etc/init.d/udev restart
}}}

neu gestartet wurde wurde, kann das Gerät abgezogen und wieder angesteckt werden. Durch die Eingabe von:

{{{#!vorlage Befehl
concordance -i
}}}

kann geprüft werden, ob die Verbindung funktioniert. Im Erfolgsfall sieht die Ausgabe folgendermaßen oder ähnlich aus:

{{{
Concordance 0.21
Copyright 2007 Kevin Timmerman and Phil Dibowitz
This software is distributed under the GPLv3.

Requesting Identity: 100%                 done
  Model: Logitech Harmony 555 (Mocha Grande)
  Firmware Version: 3.0
  Hardware Version: 3.0
  Config Flash Used: 13% (51 of 384 KiB)

Success!
}}}

= Backup =

Bevor man über den Webbrowser und '''congruity''' die Harmony programmiert, sollte eine Sicherheitskopie der aktuellen Einstellungen in der Fernbedienung gesichert werden. Dazu die Fernbedienung mit dem USB-Kabel an den Rechner anschließen und im Terminal [2]


{{{#!vorlage Befehl
concordance --dump-config DATINAME.EZhex
}}}
eingeben. Im Fehlerfall kann diese Sicherheitskopie jederzeit durch die Eingabe von 


{{{#!vorlage Befehl
concordance --write-config DATEINAME.EZhex
}}}
wieder in die Fernbedienung geschrieben werden. 
[[Bild(MHGUI.png, 60, right)]]
= Programmierung der Fernbedienung =
Mit dem Paket [packages:congruity:] wurde unter anderem das Desktopprogramm "MHGUI" installiert. Dieses kann man jetzt in seinen Programmen finden. Die Fernbedienung sollte jetzt per USB verbunden sein. Dann muss man MHGUI starten.

Nachdem man MHGUI gestartet hat, muss man sich bei einem bestehenden Logitech Account einloggen oder einen neuen erstellen. Mit ''"Vor"'' geht es weiter.
[[Bild(Konfiguration.png, 300, right)]]
Anschließend muss man eine oder mehrere Fernbedienung/en zum Account hinzufügen und eine der hinzugefügten Fernbedienungen auswählen. Danach auf ''"Vor"'' klicken.

Jetzt kann man mit ''"Add Device"'' diverse Geräte (TV-Geräte, BD-Player, Receiver, etc.) zur Fernbedienung hinzufügen. Außerdem können die verschiedenen Komfortfunktionen (siehe Anleitung der Fernbedienung) konfiguriert werden. Zum Abschluss muss man alles mit ''"Sync Remote"'' zur Fernbedienung übertragen. MHGUI kann dann mit ''"Schließen"'' beendet werden.

= Problemlösungen =
Falls das Gerät nicht funktioniert, kann es daran liegen, das der Benutzer nicht in der Gruppe "plugdev" eingetragen ist.

= Links =
 * [http://www.phildev.net/harmony/ Webseite des Concordance-Projekts] {en}  
 * [sourceforge:congruity:Webseite des Congruity-Projekts] {en}

#tag: Hardware, Logitech