Linux 4.11-rc6
[linux/fpc-iii.git] / Documentation / media / uapi / rc / lirc-set-rec-carrier-range.rst
bloba83fbbfa0d3bcd12517907c4f14535d1f4a4b18f
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _lirc_set_rec_carrier_range:
5 ********************************
6 ioctl LIRC_SET_REC_CARRIER_RANGE
7 ********************************
9 Name
10 ====
12 LIRC_SET_REC_CARRIER_RANGE - Set lower bond of the carrier used to modulate
13 IR receive.
15 Synopsis
16 ========
18 .. c:function:: int ioctl( int fd, LIRC_SET_REC_CARRIER_RANGE, __u32 *frequency )
19     :name: LIRC_SET_REC_CARRIER_RANGE
21 Arguments
22 =========
24 ``fd``
25     File descriptor returned by open().
27 ``frequency``
28     Frequency of the carrier that modulates PWM data, in Hz.
30 Description
31 ===========
33 This ioctl sets the upper range of carrier frequency that will be recognized
34 by the IR receiver.
36 .. note::
38    To set a range use :ref:`LIRC_SET_REC_CARRIER_RANGE
39    <LIRC_SET_REC_CARRIER_RANGE>` with the lower bound first and later call
40    :ref:`LIRC_SET_REC_CARRIER <LIRC_SET_REC_CARRIER>` with the upper bound.
42 Return Value
43 ============
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.