summaryrefslogtreecommitdiff
path: root/Documentation/media/uapi/rc/lirc-read.rst
diff options
context:
space:
mode:
authorSean Young <sean@mess.org>2017-02-25 14:51:34 +0300
committerMauro Carvalho Chehab <mchehab@s-opensource.com>2017-12-14 18:35:21 +0300
commit7d402db89b5b6d3ca5128937dc04653df8668978 (patch)
tree7d5f59455770fa8051df0874ea5ecf24c11619c9 /Documentation/media/uapi/rc/lirc-read.rst
parentb66218fddfd29f315a103db811152ab0c95fb054 (diff)
downloadlinux-7d402db89b5b6d3ca5128937dc04653df8668978.tar.xz
media: lirc: document LIRC_MODE_SCANCODE
Lirc supports a new mode which requires documentation. Signed-off-by: Sean Young <sean@mess.org> Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'Documentation/media/uapi/rc/lirc-read.rst')
-rw-r--r--Documentation/media/uapi/rc/lirc-read.rst15
1 files changed, 11 insertions, 4 deletions
diff --git a/Documentation/media/uapi/rc/lirc-read.rst b/Documentation/media/uapi/rc/lirc-read.rst
index ff14a69104e5..51d37ed10194 100644
--- a/Documentation/media/uapi/rc/lirc-read.rst
+++ b/Documentation/media/uapi/rc/lirc-read.rst
@@ -45,13 +45,20 @@ descriptor ``fd`` into the buffer starting at ``buf``. If ``count`` is zero,
is greater than ``SSIZE_MAX``, the result is unspecified.
The exact format of the data depends on what :ref:`lirc_modes` a driver
-uses. Use :ref:`lirc_get_features` to get the supported mode.
+uses. Use :ref:`lirc_get_features` to get the supported mode, and use
+:ref:`lirc_set_rec_mode` set the current active mode.
-The generally preferred mode for receive is
-:ref:`LIRC_MODE_MODE2 <lirc-mode-mode2>`,
-in which packets containing an int value describing an IR signal are
+The mode :ref:`LIRC_MODE_MODE2 <lirc-mode-mode2>` is for raw IR,
+in which packets containing an unsigned int value describing an IR signal are
read from the chardev.
+Alternatively, :ref:`LIRC_MODE_SCANCODE <lirc-mode-scancode>` can be available,
+in this mode scancodes which are either decoded by software decoders, or
+by hardware decoders. The ``rc_proto`` member is set to the
+protocol used for transmission, and ``scancode`` to the decoded scancode,
+and the ``keycode`` set to the keycode or ``KEY_RESERVED``.
+
+
Return Value
============