Dokumentation für yaVDR

Auch wenn eine Fernbedienung die Bedienung deutlich bequemer macht, ist es nach der Installation oft hilfreich wenn man yaVDR auch mit der Tastatur bedienen kann.

Kein VDR wäre komplett ohne die Möglichkeit ihn bequem per Fernbedienung zu steuern. yaVDR 0.5 unterstützt ein breites Spektrum von Eingabegeräten, sowohl Infrarot- als auch Funk-Fernbedienungen. Falls die eigene Fernbedienung OOTB zufriedenstellend funktioniert kann man den folgenden Abschnitt überspringen. Wer keine Fernbedienungs-Empfänger Kombination hat, die OOTB funktioniert oder einfach verstehen will wie die Einbindung der Fernbedienungen in yaVDR funktioniert sollte einen Blick auf das Kapitel zur Fernbedienung und Eventlircd und zur remote.conf in dieser Dokumentation werfen.

Falls nicht alle Tasten wie erwartet funktionieren oder gar keine Tastendrücke beim VDR ankommen, konnte die Fernbedienung nicht automatisch durch yaVDR konfiguriert werden. Wie man dann weiter verfährt ist im Folgenden beschrieben:

Im Folgenden ein kurzer Leitfaden, der dabei hilft notwendige Informationen über den verwendeten Empfänger zu sammeln. Dies erleichtert die Suche im Internet und hilft dabei Support-Anfragen im http://vdr-portal.de oder beim Hinzufügen der eigenen Konfiguration zur yaVDR-Konfigurationssammlung im Bug- & Feature-Tracker von yaVDR mit sinnvollen Informationen zu versehen.

Je nach Empfänger empfehlen sich unterschiedliche Herangehensweisen bei der Konfiguration. Um den Aufwand zu verringern folgt man am besten den nachfolgenden Links zum eigenen Empfänger.

Um zu sehen, welche USB-Geräte Linux momentan erkannt hat, kann man den Befehl lsusb benutzen. Er gibt Hinweise auf Hersteller und Typ der angeschlossenen Geräte.

Ruft man dmesg direkt nach dem Einstecken eines USB-Gerätes auf, sieht man, ob Linux für das Gerät Treiber geladen und Geräte angelegt hat.

Für weitere Informationen dazu wie die Fernbedienung eingebunden wird schaut man sich die vom System erkannten Eingabegeräte an: cat /proc/bus/input/devices und folgt abhängig von der Ausgabe den dort verlinkten Abschitten der Dokumentation

Empfänger, die in TV-Karten eingebaut sind, werden normalerweise über rc-core eingebunden und mittels ir-keytable konfiguriert. Für einige Geräte gelten Ausnahmen von dieser Regel. Als Erstes sollte man also überprüfen, ob ein entsprechendes rc-core Gerät erkannt wurde:

Die weitere Konfiguration ist im Abschnitt der Anleitung zu ir-keytable beschrieben.

Um herauszufinden, ob und wie die Fernbedienung eingebunden wird schaut man sich die vom System erkannten Eingabegeräte an: cat /proc/bus/input/devices

Hier kann das VDR-Frontend ausgewählt werden. bei yaVDR 0.5 ist softhddevice vorausgewählt, wenn die Ausgabe über die Grafikkarte des PCs erfolgen soll. Ist eine TT S2-6400 (HD-FF), SD-FF oder eine Hauppauge PVR350 verbaut, werden die entsprechenden Plugins für diese Karten bei der Installation automatisch installiert und aktiviert.

Das Lifeguard-Addon erlaubt es ein automatisches Herunterfahren des VDRs zu verhindern, wenn noch aktive Verbindungen bzw. Prozesse der ausgewählten Dienste bestehen:

Für Sender, die den Elektronischen Programmführer nicht standardkonform encodiert senden, kann der VDR so eingestellt werden, dass er auch in diesen Fällen alle Sonderzeichen korrekt anzeigt.

Hier können die Kanäle des VDR verwaltet werden. Vorhandene Kanäle lassen sich in Gruppen einteilen, per Drag and Drop neu anordnen oder über das Kontextmenü, das per Rechtsklick erreichbar ist, bearbeiten. Mehrere Kanäle lassen sich bei gedrückter Umschalttaste gleichzeitig auswählen. Die Ablage rechts erlaubt es Kanäle zwischenzulagern, z.B. um sie ohne ständiges Hin- und Herscrollen anordnen zu können.

Klickt man auf das Symbol links neben "Kanäle", öffnet sich die Channelpedia:

Dort hinterlegte Sender können ohne Kanalsuchlauf direkt in die Kanalliste übernommen werden. Dazu ruft man mittels Rechtsklick das Kontextmenü eines Kanals oder einer Kanalgruppe auf und übernimmt wahlweise das gerade markierte Objekt oder alle per Häkchen ausgewählten Objekte in die Kanalliste.

yaVDR nutzt Eventlircd, ein Systemdienst, der viele Fernbedienungsempfänger automatisch erkennt und für die mit ihnen ausgelieferte Fernbedienung konfiguriert. Diese Fernbedienungen funktionieren dann ohne weiter Konfiguration, in den Einstellungen des Webfrontends zur Fernbedienung muss nichts angepasst werden.

Für spezielle Empfänger (die z.B. Atric-Einschalter und andere, die über die Serielle Schnittstelle angeschlossen sind, in Ausnahmefällen auch für X10-Emfpänger) kann Lirc aktiviert werden. Für serielle Empfänger muss außerdem angegeben werden, welche serielle Schnittstelle benutzt werden soll. Auch hier sind für einige Empfänger die jeweiligen Tasten der Fernbedienung vorkonfiguriert. Ist dies nicht der Fall oder wird eine andere Fernbedienung verwendet, muss die /etc/lirc/lircd.conf angepasst werden. Dabei ist zu beachten, dass die Tastennamen namespacekonform sind und sich an der Benennung in der /etc/vdr/remote.conf orientieren. So ist sichergestellt, dass die Fernbedienungstasten sowohl mit dem VDR als auch unter XBMC funktionieren. Eingaben von Lircd werden unter Nutzung von uinput (Userland Input) an Eventlircd weitergereicht und werden so wie alle übrigen Tastendrücke von Eventlircd-Eingabegeräten an den VDR weitergegeben.

Diese Seite erlaubt es einzustellen wie der Ton durch den VDR und XBMC ausgegeben werden soll. Es sollten generell nur die benötigten Audiogeräte gewählt werden, um die Systemlast durch Alsa zu reduzieren. Für komplexere Konstellationen und mehreren Soundkarten im Rechner muss die Konfiguration von alsa ggf. von Hand angepasst werden.

Hier kann die Auflösung und Nutzung der angeschlossenen Bildschirme eingestellt werden. Außerdem können hier die Deinterlacing-Methoden für HD- und SD-Material konfiguriert werden.

Ab der nVidia Treiberversion 302.07 hat sich die Einstellung der Overscan-Kompensation verändert. Anstatt nur einen Prozentwert anzugeben, kann man nun den sichtbaren Bildbereich als sogenannten Viewport mit Höhe, Breite und Abstand von der linken oberen Ecke des ausgegebenen Bildes definieren.

Einen Überblick über die Bezeichnungen liefert die folgende Abbildung:

Der ViewPortIn beschreibt die Bildgröße, die von der Grafikkarte berechnet wird. Das Bild wird dann auf die Größe des ViewPortOut (X x Y) skaliert und um x und y relativ zu linken oberen Bildecke versetzt ausgegeben.

Zum Ermitteln der Parameter bietet es sich an, ein helles Bild anzeigen zu lassen, dann den ViewPortOut über x und y so zu verschieben, bis die linke obere Ecke richtig dargestellt wird und zuletzt die Skalierung (X und Y) so anzupassen, dass die rechte untere Ecke passt. Zum Ausprobieren kann man den Knopf nutzen, der eine schnelle Vorschau der gewählten Overscan-Einstellungen zeigt.

Das GraphTFT-Plugin erlaubt es Statusinformationen und das Menü des VDR auf einem zweiten angeschlossenen Bildschirm auszugeben.

Auf dieser Seite kann die Systemsprache gewählt werden und eingestellt werden wie der VDR herunterfährt und aufwacht. Außerdem lässt sich der Timeout für die Anzeige des GRUB-Menü einstellen.

.TODO:

Hier können NFS-Freigaben aus dem Netzwerk und die MAC-Adressen von Rechnern, die später über das OSD per WOL
[Wake On LAN]
geweckt werden sollen, eingetragen werden.

Hier können Konfigurationsdateien direkt im Browser bearbeitet werden. Aktuell können folgende Konfigurations-Dateien über das Webfrontend bearbeitet werden:

Über das Webfrontend können Plugins, Addons und andere VDR-bezogene Pakete verwaltet werden.

Über die Buttons über der Plugin-Liste können die Paketquellen neu eingelesen ("apt-get update"), nicht mehr benötigte als Abhängigkeit installierte Pakete deinstalliert ("apt-get autoremove") und lokale Kopien heruntergeladener Pakete gelöscht werden ("apt-get clean").

Über das mit einem Rechtsklick auf ein Paket in der Liste erreichbare Menü kann das jeweilige Paktet installiert, entfernt oder (de)aktiviert werden.

Eventlircd übersetzt Tastendrücke von Kernel Input Devices
[bzw. Eingabegeräte, für die durch den Treiber ein Eintrag unter /dev/input/ erstellt wird]
in Lirc-Tastendrücke. Im Prinzip ähnelt die Funktion dem remote-plugin mit dem Unterschied, dass zuvor den Tasten über eine evmap
[Konfigurationsdatei, die für die Übersetzung des Tastendrucks auf der Fernbedienung in eine Taste am Computer herangezogen wird]
eine andere Funktion zugewiesen werden kann.

Solche Eingabegeräte sind zum Beispiel normale Tastaturen oder auch Fernbedienungen die über ihre Treiber als Tastaturen eingebunden werden. Fernbedienungen welche an DVB Karten angeschlossen sind, melden sich teilweise ebenfalls als Tastaturen, außerdem existiert eine neue Schnittstelle für Fernbedienungen namens rc-core, auf welche Jarod Wilson
[Neuer Maintainer des Lirc Projektes]
schon einige der bestehenden Lirc Treiber und auch einige Konfigurationen der mit DVB Geräten ausgelieferten Fernbedienungen portiert hat. Auch diese Schnittstelle - auch wenn sie kein normaler Tastaturtreiber ist - stellt ihre Geräte als Eingabegeräte zur Verfügung.

Eingaben von Zeigegeräten (wie Maus, Touchpad, Grafiktablett), die ebenfalls über die Input-Schnittstelle arbeiten, versucht eventlircd unverändert durchzuleiten (es sei denn sie werden über eine evmap auf ein Key-Event umgemappt.

Eventlircd erkennt Eingabegeräte über ein udev-Attribut, auch wenn sie erst nach dem Start des Dämon eingebunden oder angeschlossen werden. Hier liegt einer der Vorteile dieser Lösung, da eventlircd ab seinem Start einen Lirc Socket für den VDR bereitstellt, und nach und nach die ihm zugeordneten Geräte als Eingabegeräte einbinden kann.

Um welche Geräte es sich kümmern soll, erkennt eventlircd anhand von Attributen, welche man den Geräten bei der Initialisierung über udev-Regeln mitgeben kann. Für manche Geräte funktioniert das schon in der Standardkonfiguration (rc-core, Eingabegeräte die das yaVDR-Team selber besitzt, Konfigurationen die an das yaVDR-Team weitergegeben wurden). Die Ausgabe erfolgt nach Verarbeitung durch Eventlircd für die Anwendungen dann so, als würde sie von einem einzigen Gerät stammen.

Da manche Geräte eindeutig erkannt werden können (zum Beispiel USB Geräte), kann man diese über udev-Regeln mit der für das jeweilige Geräte richtigen Konfiguration automatisch einbinden. Die Konfigurationen für all diese Geräte kann man alle gleichzeitig auf dem System haben, da durch udev nur die Konfiguration für angeschlossene Geräte aktiviert wird.

Eventlircd kann geräte- oder treiberabhängig eine Übersetzungstabelle mitgegeben werden, um die Tastenbelegung anzupassen. (sogenannte evmaps)

Lircd
[Der LIRC-Daemon]
kann man über den Switch
[Das Startargument]
--uinput
[User Level Input Subsystem - eine Schnittstelle, um Eingaben aus dem Userland an den Kernel zu übermitteln]
anweisen seine Tastendrücke an ein Gerät unter /dev/input/ zu übergeben. Damit kann dann lircd parallel zu anderen Eingabegeräten gestartet werden und es ist so theoretisch auch möglich mehrere Instanzen von lircd für verschiedene Geräte mit unterschiedlicher Konfiguration gleichzeitig starten. Für USB-Lirc Empfänger wird über eine udev-Regel in /lib/udev/rules.d/98-lircd.rules und dem lircd_helper eine Instanz des Lirc-Daemon gestartet und die in der udev-Regel angegebenen Treiber und lircd.conf benutzt. Für diese Empfänger ist keine Konfiguration über das Webfrontend erforderlich. Weitere noch nicht OOTB unterstützte Lirc-Empfänger sollten entsprechend über ergänzende udev-Regeln nachgepflegt werden.

Bei der yaVDR-Standardbelegung haben sich die Entwickler an der Dokumentation von linux-media (Tabelle am Ende der Seite) orientiert und benutzen diese als Referenz, eine Zuordnung von VDR-Taste und Tastenname kann man sich hier ansehen: neue IR-Integration für yaVDR 0.4

Alle Tastendrücke, die an Eventlirc weitergereicht werden, können durch Übersetzungstabellen, die sogenannten evmaps
[Eventmaps]
noch verändert werden, bevor sie an den VDR übergeben werden. Sie befinden sich unter /etc/eventlircd.d/ und sind entweder nach dem Gerätenamen, dem Treiber oder nach der Produkt- und Hersteller-ID aus ihrer udev-Regel benannt.

Hier wird das Tasten-Event KEY_PROG1 umbenannt. Der VDR empfängt dadurch das Lirc-Event KEY_MENU

Hier werden alle Eingabegeräte aufgelistet, für die ein Eintrag unter /dev/input/ angelegt wird. Für USB-Lirc-Empfänger, die automatisch konfiguriert werden, oder für über das Webfrontend eingerichtete Lirc-Geräte gibt es keinen gesonderten Eintrag, sie können an der Zeile N: Name="lircd" erkannt werden.

Im folgenden mal Beispiele für verschiedene Eingabegeräte:

Dieses Eingabegerät existiert immer, wenn eventlircd läuft. Es ist das virtuelle Eingabegerät, das alle Tastendrücke der angeschlossenen und entsprechend Konfigurierten Empfänger sammelt und an den VDR weiterleitet.

Der folgende Befehl gibt die bereits für einen Empfänger geladene Zuordnung von Scancodes und Tastennamen aus. Das ist insbesondere dann hilfreich, wenn zwar eine Keymap geladen wurde, aber die Benennung der Tasten noch nicht Namespace-konform ist.

Mit ir-keytable kann man auch Tastencodes der Fernbedienung ermitteln, z.B. um zu sehen ob überhaupt Tastendrücke erkannt werden oder um eine Keymap zu erstellen, die zur /vdr/lib/vdr/remote.conf des yaVDR passt. Da Tastendrücke von eventlircd abgefangen werden, muss dieser Dienst gestoppt sein. Außerdem ist es empfehlenswert den VDR vorher zu stoppen, um eine unbeabsichtigte Fehlbedienung zu vermeiden.

Passend zur eigenen Fernbedienung kann man sich nun eine Keymap erstellen, dabei muss der scancode in eine Hexadezimalzahl übertragen und der Taste eine Funktion zugewiesen werden. Aus scancode = 3d wird also 0x003d, aus scancode = 01 wird 0x0001 usw.

Die Keymap wird dann am besten unter einem möglichst aussagekräftigen Namen unter /etc/rc_keymaps/ gespeichert, wo sie keine Gefahr läuft von mit yaVDR-Updates ausgelieferten Keytables überschrieben zu werden. Die von yaVDR mitgelieferten Keytables liegen unter /lib/udev/rc_keymaps/ und können als Vorlage für angepasste Keytables verwendet werden.

Damit die Keytable auch automatisch geladen wird, muss eine Regel in /etc/rc_maps.cfg für die Fernbedienung erstellt werden. Da die Datei getemplated ist, sollte man ein entsprechendes Custom-Template für die eigene Einträge erstellen, um ein Überschreiben der Regel durch Updates von yaVDR zu vermeiden.

Zu Testzwecken kann man Einstellungen für per ir-core eingebundene Geräte auch von Hand laden oder zurücksetzen.

Über Regeln in der Datei /lib/udev/rules.d/98-eventlircd.rules kann festgelegt werden, welche Konfiguration eventlircd für angeschlossene USB-Fernbedienungen lädt.

Weitere Informationen über ein Eingabegerät kann man mittels udevadm herausfinden. Es eignet sich gut, wenn man Kriterien für udev-Regeln bestimmen möchte:

Serielle Empfänger wie z.B. der Atric-Einschalter oder Homebrew-Empfänger lassen sich leider schlecht automatisch vorkonfigurieren, da sie mit beliebigen Fernbedienungen benutzt werden können. Trotzdem lassen sie sich in yaVDR mit wenig Aufwand zusammen mit LIRC einrichten.

Im Abschnitt Fernbedienung des yaVDR-Webfrontend setzt man das Häkchen bei Lirc-Unterstützung und wählt den geeigneten Empfänger aus der Liste. Für Atric-Einschalter ist dies der Eintrag "Home-brew (16x50 UART compatible serial port)". Außerdem muss noch die Serielle Schnittstelle angegeben werden, über die der Empfänger angeschlossen ist. Die Nummerierung orientiert sich normalerweise an den Angaben im Handbuch des Mainboards.

Im nächsten Schritt muss dann noch eine passende lircd.conf nach /etc/lirc/lircd.conf kopiert werden. Die dort verwendeten Tastennamen müssen Namespace-konform zur input.h des Kernels sein und sollten sich (wenn sie zur Steuerung des VDR und XBMC genutzt werden sollen) an der remote.conf orientieren, da die Fernbedienung dann sowohl mit dem VDR als auch unter XBMC ohne weitere Konfiguration verwendet werden kann.

Nach einem Neustart von eventlircd kann man die für den seriellen Empfänger konfigurierte Fernbedienung benutzen. Die Tasten-Ausgabe von lircd kann unter /var/run/lirc/lircd.<PID> mittels irw ausgelesen werden.

Für die Igor USB-Empfänger muss lediglich eine passende Namespace-konforme lircd.conf nach /etc/lirc/ kopiert werden. Über eine udev-Regel wird automatisch ein passender lircd-Prozess gestartet und dessen Ausgabe von eventlircd ausgewertet. Der Socket von lircd liegt typischerweise unter /var/run/lirc/lircd-lirc0 und kann mittels irw auf Funktion überprüft werden.

Der yaUsbIr-Empfänger
[siehe http://www.vdr-portal.de/board18-vdr-hardware/board13-fernbedienungen/111753-yausbir-lirc-f%C3%A4higer-usb-ir-empf%C3%A4nger-sender-mit-einschalter/?s=fe5464cec7949ed10dfae76056ae1404df47e899]
ist ein IR-Empfänger und Einschalter, der über USB angeschlossen wird. Damit stellt er eine interessante Alternative zu den bislang nur mit Serieller Schnittstelle verfügbaren Atric IR-Einschaltern dar. Vermutlich aufgrund eines Bugs in der libusb (es treten unter Ubuntu falsche "remove" Events auf) kann er nicht über udev-Regeln eingerichtet werden, sondern muss im yaVDR-Webfrontend von Hand aktiviert werden.

Die Grundkonfiguration für den Atric IR-WakeupUSB Empfänger kann über das Webfrontend vorgenommen werden (Eintrag Atric IR-WakeupUSB). Der Empfänger ist durch eine Udev-Regel immer unter dem Symlink /dev/irman erreichbar.

Zum Anlernen einer Fernbedienung (nachdem das Protokoll mit Hilfe des Konfigurationsprogrammes festgelegt wurde) führt man diese Befehle aus und folgt den Anweisungen von irrecord. Die gewählten Tastennamen sollten dabei dem yaVDR-Namespace entsprechen:

Nach dem Anlernen kann man lircd wie gewohnt starten:

Damit ein Bluetooth-Gerät mit dem Rechner kommunizieren kann, muss es erst Authentifiziert werden. Um sich nicht von Verwaltungsprogrammen mit GUI abhängig zu machen, verwenden wir die Tools aus dem Paket bluez-utils, das ggf. noch nachinstalliert werden muss.

Hier muss man sich nun das gewünschte Gerät heraussuchen und den Wert für "Address" notieren.

Die "PS3 Remote BD" kann nach dem einmaligen Pairen direkt genutzt werden. Ihre Tasten werden über die /etc/eventlircd.d/ps3remote.evmap konfiguriert.

Im folgenden sind einige Beispiele für die Steuerung von Diensten aufgeführt. Sie lassen sich problemlos auf andere Dienste wie z.B. openbox, vdr-frontend oder lircd übertragen.

Das Streamdev-Server Plugin (Paketname vdr-plugin-streamdev-server) ist bei yaVDR 0.5 vorinstalliert. Es erweitert den VDR um die Fähigkeit Live-TV übers Netzwerk zu streamen.

Für den Zugriff über SVDRP (z.B. wenn ein anderer VDR mit Streamdev-Client Plugin zugreifen können soll) muss die Datei /etc/vdr/svdrphosts.conf wie unter SVDRP beschrieben angepasst werden.

Für den Zugriff auf die von Streamdev-Server bereitgestellten Transportströme muss außerdem die Datei /etv/vdr/plugins/streamdevhosts.conf angepasst werden. Diese Datei ist unter yaVDR 0.5 getemplated.

Der Streamdev-Server stellt auf Port 3000 eine Webinterface mit Links zu den von ihm angeboteten Streams bereit. Unter http://<IP_des_VDR>:3000/channels.m3u kann man eine Playlist mit allen Sendern herunterladen. Ein geeigneter Stream-Client ist z.B. der VLC Media Player.

Das Streamdev-Client Plugin (Paketname: vdr-plugin-streamdev-client) erlaubt einem VDR auf das Streamdev-Server Plugin eines anderen VDR zuzugreifen und somit dessen DVB-Karten zu nutzen. Damit das klappt, müssen die gewünschten Kanäle aus der channels.conf des Servers in die channels.conf auf den Client kopiert werden und auf Server und Client die Verbindungseinstellungen angepasst werden. Es kann über eine Instanz des Streamdev-Clients immer nur ein Transponder übertragen werden.

Standardmäßig dürfen alle Clients in Class-C Netzwerken (IP-Bereicht 192.168.xxx.xxx) auf den Streamdev-Server zugreifen. Falls man den Zugriff genauer steuern oder auf andere Adressbereiche erweitern möchte, muss man dies in der /etc/vdr/plugins/streamdev-server/streamdevhosts.conf entsprechend konfigurieren (siehe oben).

Der Zugriff für von außen zugreifende Clients wird in der /var/lib/vdr/plugins/xvdr/allowed_hosts.conf eingestellt. Die Syntax dieser Konfigurationsdatei entspricht der der svdrphosts.conf:

Um das Plugin nutzen zu können, müssen die Start-Argumente von xine bzw. vdr-sxfe in der Konfigurationsdatei /etc/init/vdr-frontend.conf angepasst werden. Diese Datei ist getemplated und sollte daher nicht direkt bearbeitet werden. Stattdessen muss der für das jeweilige Frontend passende Template-Teil (20_xineliboutput für vdr-sxfe und 25_xine für xine) aus /usr/share/yavdr/templates/etc/init/vdr-frontend.conf/ nach /etc/yavdr/templates_custom/etc/init/vdr-frontend.conf/ kopiert und die Variable XINELIBOUTPUTOPTS bzw. XINEOPTS darin entsprechend angepasst werden. Zum Schluss wird die Konfigurationsdatei neu aus den Templates erzeugt.

Im Folgenden ist das ganze Schritt für Schritt beschrieben:

In den Dateien die Variable XINE(LIBOUTPUT)OPTS erweitern:

bzw.

Die Konfigurationsdatei aus den Templates neu erstellen:

Und zuletzt Openbox neu starten:

Um das Atmolight per Fernbedienung schalten zu können, wurde die Taste KEY_BRIGHTNESS_CYCLE reserviert. Damit vdr-sxfe auf die Taste reagieren kann, muss es zwischen Eventlircd und VDR auf Tastendrücke lauschen. Die Variable XINELIBOUTPUTOPTS muss dann noch um die Hotkey-Unterstützung und den Socket von Eventlircd erweitert werden:

In der /etc/init/vdr.conf muss das Start-Argument --lircd=$LIRC entfernt werden.