diff options
author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-12 14:10:50 +0300 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-12 15:42:58 +0300 |
commit | f27637f96f5c146ddc0f99e3e00cb80e517c08ee (patch) | |
tree | fb22a6c53f51e6b9f8d383da22d5b044d974b82d /Documentation/media/uapi | |
parent | ae94d4c9d4b2c1071b5fdd0f6a80caaacfb5fd0a (diff) | |
download | linux-f27637f96f5c146ddc0f99e3e00cb80e517c08ee.tar.xz |
[media] doc-rst: document LIRC_SET_WIDEBAND_RECEIVER
Put documentation for this ioctl on a separate page and
improve it.
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'Documentation/media/uapi')
-rw-r--r-- | Documentation/media/uapi/rc/lirc-set-wideband-receiver.rst | 56 | ||||
-rw-r--r-- | Documentation/media/uapi/rc/lirc_device_interface.rst | 1 | ||||
-rw-r--r-- | Documentation/media/uapi/rc/lirc_ioctl.rst | 19 |
3 files changed, 57 insertions, 19 deletions
diff --git a/Documentation/media/uapi/rc/lirc-set-wideband-receiver.rst b/Documentation/media/uapi/rc/lirc-set-wideband-receiver.rst new file mode 100644 index 000000000000..cffb01fd1042 --- /dev/null +++ b/Documentation/media/uapi/rc/lirc-set-wideband-receiver.rst @@ -0,0 +1,56 @@ +.. -*- coding: utf-8; mode: rst -*- + +.. _lirc_set_wideband_receiver: + +******************************** +ioctl LIRC_SET_WIDEBAND_RECEIVER +******************************** + +Name +==== + +LIRC_SET_WIDEBAND_RECEIVER - enable wide band receiver. + +Synopsis +======== + +.. cpp:function:: int ioctl( int fd, int request, __u32 *enable ) + +Arguments +========= + +``fd`` + File descriptor returned by open(). + +``request`` + LIRC_SET_WIDEBAND_RECEIVER + +``enable`` + enable = 1 means enable wideband receiver, enable = 0 means disable + wideband receiver. + + +Description +=========== + +Some receivers are equipped with special wide band receiver which is +intended to be used to learn output of existing remote. This ioctl +allows enabling or disabling it. + +This might be useful of receivers that have otherwise narrow band receiver +that prevents them to be used with some remotes. Wide band receiver might +also be more precise. On the other hand its disadvantage it usually +reduced range of reception. + +.. note:: Wide band receiver might be implictly enabled if you enable + carrier reports. In that case it will be disabled as soon as you disable + carrier reports. Trying to disable wide band receiver while carrier + reports are active will do nothing. + + +Return Value +============ + +On success 0 is returned, on error -1 and the ``errno`` variable is set +appropriately. The generic error codes are described at the +:ref:`Generic Error Codes <gen-errors>` chapter. diff --git a/Documentation/media/uapi/rc/lirc_device_interface.rst b/Documentation/media/uapi/rc/lirc_device_interface.rst index 2810253ba852..e9cb510349a0 100644 --- a/Documentation/media/uapi/rc/lirc_device_interface.rst +++ b/Documentation/media/uapi/rc/lirc_device_interface.rst @@ -26,4 +26,5 @@ LIRC Device Interface lirc-set-transmitter-mask lirc-set-rec-timeout-reports lirc-set-measure-carrier-mode + lirc-set-wideband-receiver lirc_ioctl diff --git a/Documentation/media/uapi/rc/lirc_ioctl.rst b/Documentation/media/uapi/rc/lirc_ioctl.rst index d220fc233e6d..fe5f2719ea77 100644 --- a/Documentation/media/uapi/rc/lirc_ioctl.rst +++ b/Documentation/media/uapi/rc/lirc_ioctl.rst @@ -54,25 +54,6 @@ device can rely on working with the default settings initially. Set send/receive mode. Largely obsolete for send, as only ``LIRC_MODE_PULSE`` is supported. -.. _LIRC_SET_WIDEBAND_RECEIVER: - -``LIRC_SET_WIDEBAND_RECEIVER`` - - Some receivers are equipped with special wide band receiver which is - intended to be used to learn output of existing remote. Calling that - ioctl with (1) will enable it, and with (0) disable it. This might - be useful of receivers that have otherwise narrow band receiver that - prevents them to be used with some remotes. Wide band receiver might - also be more precise On the other hand its disadvantage it usually - reduced range of reception. - - .. note:: Wide band receiver might be - implictly enabled if you enable carrier reports. In that case it - will be disabled as soon as you disable carrier reports. Trying to - disable wide band receiver while carrier reports are active will do - nothing. - - .. _lirc_dev_errors: Return Value |