summaryrefslogtreecommitdiff
path: root/v4l2-spec
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@redhat.com>2009-08-31 22:39:44 -0300
committerMauro Carvalho Chehab <mchehab@redhat.com>2009-08-31 22:39:44 -0300
commit29877b30873e9d0ac1a4756775bcfb1caab42fa1 (patch)
treef78952c2f13fae6938d7d36b3d656b4a171a8691 /v4l2-spec
parent886c0206b83fbc0241cd3842ed49fd002831f1d9 (diff)
downloadmediapointer-dvb-s2-29877b30873e9d0ac1a4756775bcfb1caab42fa1.tar.gz
mediapointer-dvb-s2-29877b30873e9d0ac1a4756775bcfb1caab42fa1.tar.bz2
v4l2-spec: Add an introduction to remote controllers
From: Mauro Carvalho Chehab <mchehab@redhat.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'v4l2-spec')
-rw-r--r--v4l2-spec/remote_controllers.sgml7
1 files changed, 6 insertions, 1 deletions
diff --git a/v4l2-spec/remote_controllers.sgml b/v4l2-spec/remote_controllers.sgml
index 29bdbd54f..f0c215b1c 100644
--- a/v4l2-spec/remote_controllers.sgml
+++ b/v4l2-spec/remote_controllers.sgml
@@ -2,7 +2,10 @@
<section id="Remote_controllers_Intro">
<title>Introduction</title>
-<para>TODO</para>
+<para>Currently, most analog and digital devices have a Infrared input for remote controllers. Each manufacturer has their own type of control. It is not rare that the same manufacturer to ship different types of controls, depending on the device.</para>
+<para>Unfortunately, during several years, there weren't any effort to uniform the IR keycodes under different boards. This resulted that the same IR keyname to be mapped completely different on different IR's. Due to that, V4L2 API now specifies a standard for mapping Media keys on IR.</para>
+<para>This standard should be used by both V4L/DVB drivers and userspace applications</para>
+<para>The modules register the remote as keyboard within the linux input layer. This means that the IR key strokes will look like normal keyboard key strokes (if CONFIG_INPUT_KEYBOARD is enabled). Using the event devices (CONFIG_INPUT_EVDEV) it is possible for applications to access the remote via /dev/input/event devices.</para>
<table pgwide="1" frame="none" id="rc_standard_keymap">
<title>IR default keymapping</title>
@@ -134,6 +137,8 @@
</tgroup>
</table>
+<para>It should be noticed that, sometimes, there some fundamental missing keys at some cheaper IR's. Due to that, it is recommended to:</para>
+
<table pgwide="1" frame="none" id="rc_keymap_notes">
<title>Notes</title>
<tgroup cols="1">