Eventlircd übersetzt Tastendrücke von Eingabegeräten ^[18] in Lirc-Tastendrücke. Im Prinzip ähnelt die Funktion dem remote-plugin mit dem Unterschied, dass nur Tasten ausgewertet werden, denen über eine Keymap ^[19] eine Funktion zugewiesen wurde.

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 ^[20] 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.

Eventlircd erkennt Eingabegeräte über udev, 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).

Lircd ^[21] kann man über den Switch ^[22] --uinput ^[23] 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.

Bug bei Verwendung von --uinput

Leider scheinen aktuelle Lirc-Versionen unter einem Bug bei der Übergabe von Tastendrücken bei Verwendung von --uinput zu leiden - es kommen dann doppelte Tastendrücke am Eventgerät an (die Tastendrücke an eigentlichen Lircd-Socket hingegen sind in Ordnung). Ein Workaround ist hier für über das WFE konfigurierte und hier für per udev-Regel eingebundene USB-Lirc-Empfänger im Forum beschrieben und wird voraussichtlich seinen Weg in die nächste yaVDR-Version finden.

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)

	Alle Wege führen zu Eventlircd
	Je nachdem welchen Anschluss und welche Treiber die eigenen Empfänger bzw. TV-Karten verwenden kann der Weg eines Tastendrucks also sehr unterschiedlich sein, bis er von eventlircd ausgewertet wird. Dieses Hintergrundwissen ist dann von Vorteil, wenn die Tastenbelegung die Eventlircd ausgibt nicht zur remote.conf von yaVDR passt.

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

	Keine Änderungen für die Fernbedienung an der remote.conf!
	yaVDR ist auf eine standardisierte remote.conf angewiesen, damit die Fernbedienungen richtig funktionieren. Das hat zur Folge, dass die Tastennamen in den Lirc-Konfigurationsdateien, den Keytables von ir-core und den von Eventlircd direkt angesprochenen Geräten Namespace-konform zur remote.conf sein müssen. Die Anpassung des Mappings ist in diesem Kapitel beschrieben.

Die remote.conf liegt unter /var/lib/vdr/remote.conf und ist eine getemplatete Datei. Sie sollte möglichst nicht verändert werden (Ausnahme ist die Konfiguration der Tastenbelegung für Tastaturen), und gibt vor wie die von den Fernbedienungen gelieferten Tastennamen lauten sollten. Die Benennung ist gleichzeitig auf die XBMC-Konfiguration abgestimmt, so dass auch XBMC ohne weitere Anpassung seiner Keymaps bedienbar sein sollte.

Die Zuordnung von Funktion im VDR und Tastennamen sieht bei yaVDR 0.4 so aus:

	Wann sind evmaps sinnvoll?
	evmaps sollten nur für Geräte angelegt werden, die keine andere Möglichkeit bieten die Tastennamen zu verändern. Für Lirc- und rc-core-Geräte sollte man vorzugsweise eine entsprechene Konfigurationsdatei (lircd.conf bzw. Keymap) zur korrekten Belegung der Tasten erstellen.

Alle Tastendrücke, die an Eventlirc weitergereicht werden, können durch Übersetzungstabellen, die sogenannten evmaps ^[24] 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 (z.B. ircore.evmap für Geräte, die mit rc-core als Treiber arbeiten) oder nach der Produkt- und Hersteller-ID aus ihrer udev-Regel benannt.

Beispiel für die Syntax in einer evmap: 

KEY_PROG1       = KEY_MENU #Ich bin ein Kommentar

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

Einen ersten Überblick, ob der Empfänger erkannt wurde gibt die Auflistung der Eingabegeräte des des Systems: 

cat /proc/bus/input/devices

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:

user@yaVDR:~$ cat /proc/bus/input/devices

Power-Button am Gehäuse. 

I: Bus=0019 Vendor=0000 Product=0001 Version=0000
N: Name="Power Button"
P: Phys=PNP0C0C/button/input0
S: Sysfs=/devices/LNXSYSTM:00/device:00/PNP0C0C:00/input/input0
U: Uniq=
H: Handlers=kbd event0
B: PROP=0
B: EV=3
B: KEY=10000000000000 0

I: Bus=0019 Vendor=0000 Product=0001 Version=0000
N: Name="Power Button"
P: Phys=LNXPWRBN/button/input0
S: Sysfs=/devices/LNXSYSTM:00/LNXPWRBN:00/input/input1
U: Uniq=
H: Handlers=kbd event1
B: PROP=0
B: EV=3
B: KEY=10000000000000 0

Angeschlossene Tastatur. 

I: Bus=0011 Vendor=0001 Product=0001 Version=ab41
N: Name="AT Translated Set 2 keyboard"
P: Phys=isa0060/serio0/input0
S: Sysfs=/devices/platform/i8042/serio0/input/input2
U: Uniq=
H: Handlers=sysrq kbd event2
B: PROP=0
B: EV=120013
B: KEY=402000000 3803078f800d001 feffffdfffefffff fffffffffffffffe
B: MSC=10
B: LED=7

direkt eingebundene Fernbedienung, hier Hama MCE Remote mit Tastatur- und Mausfunktion. 

I: Bus=0003 Vendor=05a4 Product=9881 Version=0110 
N: Name="HID 05a4:9881"
P: Phys=usb-0000:00:02.0-2/input0
S: Sysfs=/devices/pci0000:00/0000:00:02.0/usb2/2-2/2-2:1.0/input/input3
U: Uniq=
H: Handlers=sysrq kbd event3 
B: PROP=0
B: EV=120013
B: KEY=e080ffdf01cfffff fffffffffffffffe
B: MSC=10
B: LED=7

I: Bus=0003 Vendor=05a4 Product=9881 Version=0110 
N: Name="HID 05a4:9881"
P: Phys=usb-0000:00:02.0-2/input1
S: Sysfs=/devices/pci0000:00/0000:00:02.0/usb2/2-2/2-2:1.1/input/input4
U: Uniq=
H: Handlers=kbd mouse0 event4 
B: PROP=0
B: EV=17
B: KEY=1f0000 2020000 3878d801d001 1e000000000000 0
B: REL=103
B: MSC=10

Eventlircd. 

I: Bus=0003 Vendor=05a4 Product=9881 Version=0110
N: Name="eventlircd"
P: Phys=/dev/input/event4
S: Sysfs=/devices/virtual/input/input5
U: Uniq=
H: Handlers=mouse1 event5
B: PROP=0
B: EV=7
B: KEY=10000 0 0 0 0
B: REL=3

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.

rc-core Empfänger. 

I: Bus=0018 Vendor=0000 Product=0000 Version=0000
N: Name="i2c IR (Hauppauge WinTV PVR-350"
P: Phys=i2c-2/2-0018/ir0
S: Sysfs=/devices/virtual/rc/rc0/input6 
U: Uniq=
H: Handlers=kbd event6
B: PROP=0
B: EV=100013
B: KEY=108fc010 2468d100000000 0 18000 18040002801 8e168000000000 ffe
B: MSC=10

Lirc-Gerät mit --uinput. 

I: Bus=0000 Vendor=0000 Product=0000 Version=0000
N: Name="lircd"
P: Phys=
S: Sysfs=/devices/virtual/input/input7
U: Uniq=
H: Handlers=sysrq rfkill kbd event7
B: PROP=0
B: EV=100003
B: KEY=ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff ffffffffffffffff fffffffffffffffe

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.

sudo ir-keytable -r

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.

Beispielausgabe ohne geladene Keytable. 

user@yavdr:~$ sudo ir-keytable -t
Testing events. Please, press CTRL-C to abort.
1310546299.271540: event MSC: scancode = 3d
1310546300.071543: event MSC: scancode = 3b
1310546301.471538: event MSC: scancode = 01
1310546301.871547: event MSC: scancode = 02
1310546302.271537: event MSC: scancode = 03

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.

Beispiel für eine selbst definierte Keytable, die unter /etc/rc_keymaps/pvr350 gespeichert würde (Auszug). 

# table rc-rc5-tv, type: RC-5 
0x003b KEY_SETUP
0x003d KEY_POWER2
0x0001 KEY_1
0x0002 KEY_2
0x0003 KEY_3
[...]

Kommentare in den Keymaps

ir-keytable akzeptiert keine reinen Kommentarzeilen. Wird eine Kopfzeile verwendet, die Keytable-Name und Fernbedienungsprotokoll angibt, so muss darauf geachtet werden, dass für beide Parameter erlaubte Werte eingetragen sind. Falsch wäre also:  # table rc-rc5-tv, type # Ich bin ein Kommentar 0x003b KEY_SETUP 0x003d KEY_POWER2 0x0001 KEY_1 0x0002 KEY_2 0x0003 KEY_3 [...] Kein Protokolltyp angegeben reine Kommentarzeilen sind nicht erlaubt Korrekt geht es so:  # table rc-rc5-tv, type: RC-5 0x003b KEY_SETUP # Ich bin ein Kommentar 0x003d KEY_POWER2 0x0001 KEY_1 0x0002 KEY_2 0x0003 KEY_3 Vollständige Angabe des Namens der Keytable und des verwendeten Protokolls Kommentare hinter der Tastendefinition sind erlaubt

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.

/etc/rc_maps.cfg. 

# driver          table                           file
 ir-kbd-i2c      rc-rc5-tv                       /etc/rc_keymaps/pvr350

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

	Wie wird die rc_maps.cfg ausgewertet?
	Dazu wird eine udev-Regel in /lib/udev/rules.d/40-ir-keytable.rules benutzt, die gemäß den Regeln in der /etc/rc_maps.cfg die dort eingestellten Keymaps lädt (ir-keytable -a /etc/rc_maps.cfg).

Manuelles Laden einer Keymap durch ir-keytable. 

user@yavdr:~$ sudo ir-keytable -c  -p rc-5  -w /etc/rc_keymaps/pvr350 

Beispielausgabe von ir-keytable -t für die gleichen Tasten mit passender Keytable. 

user@yavdr:~$ sudo ir-keytable -t
Testing events. Please, press CTRL-C to abort.
1310546400.571539: event MSC: scancode = 3d
1310546400.571545: event key down: KEY_POWER2 (0x0164)
1310546400.571547: event sync
1310546400.820703: event key up: KEY_POWER2 (0x0164)
1310546400.820705: event sync
1310546401.471543: event MSC: scancode = 3b
1310546401.471551: event key down: KEY_SETUP (0x008d)
1310546401.471553: event sync
1310546401.720700: event key up: KEY_SETUP (0x008d)
1310546401.720703: event sync
1310546406.271547: event MSC: scancode = 01
1310546406.271556: event key down: KEY_1 (0x0002)
1310546406.271558: event sync
1310546406.520700: event key up: KEY_1 (0x0002)
1310546406.520703: event sync
1310546407.071539: event MSC: scancode = 02
1310546407.071543: event key down: KEY_2 (0x0003)
1310546407.071545: event sync
1310546407.320705: event key up: KEY_2 (0x0003)
1310546407.320709: event sync
1310546407.871539: event MSC: scancode = 03
1310546407.871544: event key down: KEY_3 (0x0004)
1310546407.871546: event sync
1310546408.120700: event key up: KEY_3 (0x0004)
1310546408.120702: event sync

Ü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.

Beispiel für einen Eintrag in /lib/udev/rules.d/98-eventlircd.rules. 

ENV{ID_VENDOR_ID}=="0419", ENV{ID_MODEL_ID}=="0001", \                      
  ENV{eventlircd_enable}="true",\                                           
  ENV{eventlircd_evmap}="03_$env{ID_VENDOR_ID}_$env{ID_MODEL_ID}.evmap"     

	Sonderfälle
	In einigen Fällen kann mittels Vendor-ID und Model-ID nicht zuverlässig zwischen bestimmten Empfängern unterschieden werden (z.B. X10-Empfänger). Hier werden weitere udev-Attribute ausgewertet. Die für diese Empfänger angepassten udev-Regeln sind unter /lib/udev/rules.d/98-eventlircd-names.conf zu finden.

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:

udevadm. 

user@yavdr:~$ sudo udevadm info --query=all --attribute-walk --name=/dev/input/event4

Udevadm info starts with the device specified by the devpath and then
walks up the chain of parent devices. It prints for every device
found, all possible attributes in the udev rules key format.
A rule to match, can be composed by the attributes of the device
and the attributes from one single parent device.

  looking at device '/devices/virtual/input/input4/event4':
    KERNEL=="event4"
    SUBSYSTEM=="input"
    DRIVER==""

  looking at parent device '/devices/virtual/input/input4':
    KERNELS=="input4"
    SUBSYSTEMS=="input"
    DRIVERS==""
    ATTRS{name}=="Sundtek Ltd. Remote Control"
    ATTRS{phys}==""
    ATTRS{uniq}==""
    ATTRS{modalias}=="input:b0003v0000p0000e0001-e0,1,2,4,14,k71,72,73,74,80,9E,A7,AE,CF,161,174,18E,18F,190,191,192,193,ramlsfw"

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.

Einstellungen im Webfrontend. 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.

Anpassen der lircd.conf. Im nächsten Schritt muss dann noch eine passende lircd.conf nach /etc/lirc/lircd.conf kopiert werden. Die dort verwendeten Tastennamen sollten sich an der remote.conf orientieren, da die Fernbedienung dann sowohl mit dem VDR als auch unter XBMC ohne weitere Konfiguration verwendet werden kann.

yaVDR 0.3 bzw. "alte" lircd.conf. 

[...]
begin codes
          Up                   0x1794
          Down                 0x1795
          Ok                   0x17A5
          left                 0x1796
          right                0x1797
          info                 0x179B
[...]

yaVDR 0.4. 

[...]
begin codes
          KEY_UP                   0x1794
          KEY_DOWN                 0x1795
          KEY_OK                   0x17A5
          KEY_LEFT                 0x1796
          KEY_RIGHT                0x1797
          KEY_INFO                 0x179B
[...]

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.

	Cave Einstellungen zur Fernbedienung im Webfrontend!
	Bei Igor USB-Empfängern darf Lirc nicht für den Igor über das Webfrontend aktiviert und eingerichtet werden, da sonst zwei lircd-Prozesse gestartet werden, die sich gegenseitig blockieren und die Funktion der Fernbedienung verhindern!