Linux 4.8.3
[linux/fpc-iii.git] / Documentation / media / uapi / rc / lirc-get-features.rst
blobe763ebfb2cb1c6bdb59e25e1af7b0693b01a2b2a
1 .. -*- coding: utf-8; mode: rst -*-
3 .. _lirc_get_features:
5 ***********************
6 ioctl LIRC_GET_FEATURES
7 ***********************
9 Name
10 ====
12 LIRC_GET_FEATURES - Get the underlying hardware device's features
14 Synopsis
15 ========
17 .. cpp:function:: int ioctl( int fd, int request, __u32 *features)
19 Arguments
20 =========
22 ``fd``
23     File descriptor returned by open().
25 ``request``
26     LIRC_GET_FEATURES
28 ``features``
29     Bitmask with the LIRC features.
32 Description
33 ===========
36 Get the underlying hardware device's features. If a driver does not
37 announce support of certain features, calling of the corresponding ioctls
38 is undefined.
40 LIRC features
41 =============
43 .. _LIRC-CAN-REC-RAW:
45 ``LIRC_CAN_REC_RAW``
47     Unused. Kept just to avoid breaking uAPI.
49 .. _LIRC-CAN-REC-PULSE:
51 ``LIRC_CAN_REC_PULSE``
53     The driver is capable of receiving using
54     :ref:`LIRC_MODE_PULSE <lirc-mode-pulse>`.
56 .. _LIRC-CAN-REC-MODE2:
58 ``LIRC_CAN_REC_MODE2``
60     The driver is capable of receiving using
61     :ref:`LIRC_MODE_MODE2 <lirc-mode-MODE2>`.
63 .. _LIRC-CAN-REC-LIRCCODE:
65 ``LIRC_CAN_REC_LIRCCODE``
67     The driver is capable of receiving using
68     :ref:`LIRC_MODE_LIRCCODE <lirc-mode-LIRCCODE>`.
70 .. _LIRC-CAN-SET-SEND-CARRIER:
72 ``LIRC_CAN_SET_SEND_CARRIER``
74     The driver supports changing the modulation frequency via
75     :ref:`ioctl LIRC_SET_SEND_CARRIER <LIRC_SET_SEND_CARRIER>`.
77 .. _LIRC-CAN-SET-SEND-DUTY-CYCLE:
79 ``LIRC_CAN_SET_SEND_DUTY_CYCLE``
81     The driver supports changing the duty cycle using
82     :ref:`ioctl LIRC_SET_SEND_DUTY_CYCLE <LIRC_SET_SEND_DUTY_CYCLE>`.
84 .. _LIRC-CAN-SET-TRANSMITTER-MASK:
86 ``LIRC_CAN_SET_TRANSMITTER_MASK``
88     The driver supports changing the active transmitter(s) using
89     :ref:`ioctl LIRC_SET_TRANSMITTER_MASK <LIRC_SET_TRANSMITTER_MASK>`.
91 .. _LIRC-CAN-SET-REC-CARRIER:
93 ``LIRC_CAN_SET_REC_CARRIER``
95     The driver supports setting the receive carrier frequency using
96     :ref:`ioctl LIRC_SET_REC_CARRIER <LIRC_SET_REC_CARRIER>`.
98 .. _LIRC-CAN-SET-REC-DUTY-CYCLE-RANGE:
100 ``LIRC_CAN_SET_REC_DUTY_CYCLE_RANGE``
102     Unused. Kept just to avoid breaking uAPI.
104 .. _LIRC-CAN-SET-REC-CARRIER-RANGE:
106 ``LIRC_CAN_SET_REC_CARRIER_RANGE``
108     The driver supports
109     :ref:`ioctl LIRC_SET_REC_CARRIER_RANGE <LIRC_SET_REC_CARRIER_RANGE>`.
111 .. _LIRC-CAN-GET-REC-RESOLUTION:
113 ``LIRC_CAN_GET_REC_RESOLUTION``
115     The driver supports
116     :ref:`ioctl LIRC_GET_REC_RESOLUTION <LIRC_GET_REC_RESOLUTION>`.
118 .. _LIRC-CAN-SET-REC-TIMEOUT:
120 ``LIRC_CAN_SET_REC_TIMEOUT``
122     The driver supports
123     :ref:`ioctl LIRC_SET_REC_TIMEOUT <LIRC_SET_REC_TIMEOUT>`.
125 .. _LIRC-CAN-SET-REC-FILTER:
127 ``LIRC_CAN_SET_REC_FILTER``
129     Unused. Kept just to avoid breaking uAPI.
131 .. _LIRC-CAN-MEASURE-CARRIER:
133 ``LIRC_CAN_MEASURE_CARRIER``
135     The driver supports measuring of the modulation frequency using
136     :ref:`ioctl LIRC_SET_MEASURE_CARRIER_MODE <LIRC_SET_MEASURE_CARRIER_MODE>`.
138 .. _LIRC-CAN-USE-WIDEBAND-RECEIVER:
140 ``LIRC_CAN_USE_WIDEBAND_RECEIVER``
142     The driver supports learning mode using
143     :ref:`ioctl LIRC_SET_WIDEBAND_RECEIVER <LIRC_SET_WIDEBAND_RECEIVER>`.
145 .. _LIRC-CAN-NOTIFY-DECODE:
147 ``LIRC_CAN_NOTIFY_DECODE``
149     Unused. Kept just to avoid breaking uAPI.
151 .. _LIRC-CAN-SEND-RAW:
153 ``LIRC_CAN_SEND_RAW``
155     Unused. Kept just to avoid breaking uAPI.
157 .. _LIRC-CAN-SEND-PULSE:
159 ``LIRC_CAN_SEND_PULSE``
161     The driver supports sending using :ref:`LIRC_MODE_PULSE <lirc-mode-pulse>`.
163 .. _LIRC-CAN-SEND-MODE2:
165 ``LIRC_CAN_SEND_MODE2``
167     The driver supports sending using :ref:`LIRC_MODE_MODE2 <lirc-mode-mode2>`.
169 .. _LIRC-CAN-SEND-LIRCCODE:
171 ``LIRC_CAN_SEND_LIRCCODE``
173     The driver supports sending codes (also called as IR blasting or IR TX).
176 Return Value
177 ============
179 On success 0 is returned, on error -1 and the ``errno`` variable is set
180 appropriately. The generic error codes are described at the
181 :ref:`Generic Error Codes <gen-errors>` chapter.