Merge branch 'x86-urgent-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[linux-3.10.git] / Documentation / video4linux / README.ir
1
2 infrared remote control support in video4linux drivers
3 ======================================================
4
5
6 basics
7 ------
8
9 Current versions use the linux input layer to support infrared
10 remote controls.  I suggest to download my input layer tools
11 from http://bytesex.org/snapshot/input-<date>.tar.gz
12
13 Modules you have to load:
14
15   saa7134       statically built in, i.e. just the driver :)
16   bttv          ir-kbd-gpio or ir-kbd-i2c depending on your
17                 card.
18
19 ir-kbd-gpio and ir-kbd-i2c don't support all cards lirc supports
20 (yet), mainly for the reason that the code of lirc_i2c and lirc_gpio
21 was very confusing and I decided to basically start over from scratch.
22 Feel free to contact me in case of trouble.  Note that the ir-kbd-*
23 modules work on 2.6.x kernels only through ...
24
25
26 how it works
27 ------------
28
29 The modules register the remote as keyboard within the linux input
30 layer, i.e. you'll see the keys of the remote as normal key strokes
31 (if CONFIG_INPUT_KEYBOARD is enabled).
32
33 Using the event devices (CONFIG_INPUT_EVDEV) it is possible for
34 applications to access the remote via /dev/input/event<n> devices.
35 You might have to create the special files using "/sbin/MAKEDEV
36 input".  The input layer tools mentioned above use the event device.
37
38 The input layer tools are nice for trouble shooting, i.e. to check
39 whenever the input device is really present, which of the devices it
40 is, check whenever pressing keys on the remote actually generates
41 events and the like.  You can also use the kbd utility to change the
42 keymaps (2.6.x kernels only through).
43
44
45 using with lircd
46 ================
47
48 The cvs version of the lircd daemon supports reading events from the
49 linux input layer (via event device).  The input layer tools tarball
50 comes with a lircd config file.
51
52
53 using without lircd
54 ===================
55
56 XFree86 likely can be configured to recognise the remote keys.  Once I
57 simply tried to configure one of the multimedia keyboards as input
58 device, which had the effect that XFree86 recognised some of the keys
59 of my remote control and passed volume up/down key presses as
60 XF86AudioRaiseVolume and XF86AudioLowerVolume key events to the X11
61 clients.
62
63 It likely is possible to make that fly with a nice xkb config file,
64 I know next to nothing about that through.
65
66
67 Have fun,
68
69   Gerd
70
71 --
72 Gerd Knorr <kraxel@bytesex.org>