Documentation/userspace-api/media/rc/lirc-get-rec-resolution.rst

   1 .. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
   2 .. c:namespace:: RC
   3
   4 .. _lirc_get_rec_resolution:
   5
   6 *****************************
   7 ioctl LIRC_GET_REC_RESOLUTION
   8 *****************************
   9
  10 Name
  11 ====
  12
  13 LIRC_GET_REC_RESOLUTION - Obtain the value of receive resolution, in microseconds.
  14
  15 Synopsis
  16 ========
  17
  18 .. c:macro:: LIRC_GET_REC_RESOLUTION
  19
  20 ``int ioctl(int fd, LIRC_GET_REC_RESOLUTION, __u32 *microseconds)``
  21
  22 Arguments
  23 =========
  24
  25 ``fd``
  26     File descriptor returned by open().
  27
  28 ``microseconds``
  29     Resolution, in microseconds.
  30
  31 Description
  32 ===========
  33
  34 Some receivers have maximum resolution which is defined by internal
  35 sample rate or data format limitations. E.g. it's common that
  36 signals can only be reported in 50 microsecond steps.
  37
  38 This ioctl returns the integer value with such resolution, with can be
  39 used by userspace applications like lircd to automatically adjust the
  40 tolerance value.
  41
  42 Return Value
  43 ============
  44
  45 On success 0 is returned, on error -1 and the ``errno`` variable is set
  46 appropriately. The generic error codes are described at the
  47 :ref:`Generic Error Codes <gen-errors>` chapter.