Lines Matching +full:mode +full:- +full:flag
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
13 VIDIOC_G_TUNER - VIDIOC_S_TUNER - Get or set tuner attributes
46 Tuners have two writable properties, the audio mode and the radio
47 frequency. To change the audio mode, applications initialize the
51 different audio mode if the requested mode is invalid or unsupported.
52 Since this is a write-only ioctl, it does not return the actually
53 selected audio mode.
68 .. flat-table:: struct v4l2_tuner
69 :header-rows: 0
70 :stub-columns: 0
72 * - __u32
73 - ``index``
74 - :cspan:`1` Identifies the tuner, set by the application.
75 * - __u8
76 - ``name``\ [32]
77 - :cspan:`1`
79 Name of the tuner, a NUL-terminated ASCII string.
82 * - __u32
83 - ``type``
84 - :cspan:`1` Type of the tuner, see :c:type:`v4l2_tuner_type`.
85 * - __u32
86 - ``capability``
87 - :cspan:`1`
89 Tuner capability flags, see :ref:`tuner-capability`. Audio flags
100 * - __u32
101 - ``rangelow``
102 - :cspan:`1` The lowest tunable frequency in units of 62.5 kHz, or
103 if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in units
104 of 62.5 Hz, or if the ``capability`` flag ``V4L2_TUNER_CAP_1HZ``
108 * - __u32
109 - ``rangehigh``
110 - :cspan:`1` The highest tunable frequency in units of 62.5 kHz,
111 or if the ``capability`` flag ``V4L2_TUNER_CAP_LOW`` is set, in
112 units of 62.5 Hz, or if the ``capability`` flag
116 * - __u32
117 - ``rxsubchans``
118 - :cspan:`1`
123 :ref:`tuner-rxsubchans` in this field. For example:
124 * -
125 -
126 - ``V4L2_TUNER_SUB_MONO``
127 - receiving mono audio
128 * -
129 -
130 - ``STEREO | SAP``
131 - receiving stereo audio and a secondary audio program
132 * -
133 -
134 - ``MONO | STEREO``
135 - receiving mono or stereo audio, the hardware cannot distinguish
136 * -
137 -
138 - ``LANG1 | LANG2``
139 - receiving bilingual audio
140 * -
141 -
142 - ``MONO | STEREO | LANG1 | LANG2``
143 - receiving mono, stereo or bilingual audio
144 * -
145 -
146 - :cspan:`1`
149 ``_SAP`` flag is cleared in the ``capability`` field, the
150 corresponding ``V4L2_TUNER_SUB_`` flag must not be set here.
154 * - __u32
155 - ``audmode``
156 - :cspan:`1`
158 The selected audio mode, see :ref:`tuner-audmode` for valid
159 values. The audio mode does not affect audio subprogram detection,
161 change unless the requested mode is invalid or unsupported. See
162 :ref:`tuner-matrix` for possible results when the selected and
167 * - __u32
168 - ``signal``
169 - :cspan:`1` The signal strength if known.
172 * - __s32
173 - ``afc``
174 - :cspan:`1` Automatic frequency control.
178 * - __u32
179 - ``reserved``\ [4]
180 - :cspan:`1` Reserved for future extensions.
189 .. flat-table:: enum v4l2_tuner_type
190 :header-rows: 0
191 :stub-columns: 0
194 * - ``V4L2_TUNER_RADIO``
195 - 1
196 - Tuner supports radio
197 * - ``V4L2_TUNER_ANALOG_TV``
198 - 2
199 - Tuner supports analog TV
200 * - ``V4L2_TUNER_SDR``
201 - 4
202 - Tuner controls the A/D and/or D/A block of a
204 * - ``V4L2_TUNER_RF``
205 - 5
206 - Tuner controls the RF part of a Software Digital Radio (SDR)
210 .. _tuner-capability:
214 .. flat-table:: Tuner and Modulator Capability Flags
215 :header-rows: 0
216 :stub-columns: 0
219 * - ``V4L2_TUNER_CAP_LOW``
220 - 0x0001
221 - When set, tuning frequencies are expressed in units of 62.5 Hz
223 * - ``V4L2_TUNER_CAP_NORM``
224 - 0x0002
225 - This is a multi-standard tuner; the video standard can or must be
227 multi-standard because the video standard is automatically
234 * - ``V4L2_TUNER_CAP_HWSEEK_BOUNDED``
235 - 0x0004
236 - If set, then this tuner supports the hardware seek functionality
239 * - ``V4L2_TUNER_CAP_HWSEEK_WRAP``
240 - 0x0008
241 - If set, then this tuner supports the hardware seek functionality
244 * - ``V4L2_TUNER_CAP_STEREO``
245 - 0x0010
246 - Stereo audio reception is supported.
247 * - ``V4L2_TUNER_CAP_LANG1``
248 - 0x0040
249 - Reception of the primary language of a bilingual audio program is
250 supported. Bilingual audio is a feature of two-channel systems,
254 * - ``V4L2_TUNER_CAP_LANG2``
255 - 0x0020
256 - Reception of the secondary language of a bilingual audio program
259 * - ``V4L2_TUNER_CAP_SAP``
260 - 0x0020
261 - Reception of a secondary audio program is supported. This is a
273 * - ``V4L2_TUNER_CAP_RDS``
274 - 0x0080
275 - RDS capture is supported. This capability is only valid for radio
277 * - ``V4L2_TUNER_CAP_RDS_BLOCK_IO``
278 - 0x0100
279 - The RDS data is passed as unparsed RDS blocks.
280 * - ``V4L2_TUNER_CAP_RDS_CONTROLS``
281 - 0x0200
282 - The RDS data is parsed by the hardware and set via controls.
283 * - ``V4L2_TUNER_CAP_FREQ_BANDS``
284 - 0x0400
285 - The :ref:`VIDIOC_ENUM_FREQ_BANDS`
287 * - ``V4L2_TUNER_CAP_HWSEEK_PROG_LIM``
288 - 0x0800
289 - The range to search when using the hardware seek functionality is
293 * - ``V4L2_TUNER_CAP_1HZ``
294 - 0x1000
295 - When set, tuning frequencies are expressed in units of 1 Hz
301 .. _tuner-rxsubchans:
303 .. flat-table:: Tuner Audio Reception Flags
304 :header-rows: 0
305 :stub-columns: 0
308 * - ``V4L2_TUNER_SUB_MONO``
309 - 0x0001
310 - The tuner receives a mono audio signal.
311 * - ``V4L2_TUNER_SUB_STEREO``
312 - 0x0002
313 - The tuner receives a stereo audio signal.
314 * - ``V4L2_TUNER_SUB_LANG1``
315 - 0x0008
316 - The tuner receives the primary language of a bilingual audio
317 signal. Drivers must clear this flag when the current video
319 * - ``V4L2_TUNER_SUB_LANG2``
320 - 0x0004
321 - The tuner receives the secondary language of a bilingual audio
323 * - ``V4L2_TUNER_SUB_SAP``
324 - 0x0004
325 - The tuner receives a Second Audio Program.
330 flags are synonyms. The ``V4L2_TUNER_SUB_SAP`` flag applies
332 * - ``V4L2_TUNER_SUB_RDS``
333 - 0x0010
334 - The tuner receives an RDS channel.
339 .. _tuner-audmode:
341 .. flat-table:: Tuner Audio Modes
342 :header-rows: 0
343 :stub-columns: 0
346 * - ``V4L2_TUNER_MODE_MONO``
347 - 0
348 - Play mono audio. When the tuner receives a stereo signal this a
349 down-mix of the left and right channel. When the tuner receives a
350 bilingual or SAP signal this mode selects the primary language.
351 * - ``V4L2_TUNER_MODE_STEREO``
352 - 1
353 - Play stereo audio. When the tuner receives bilingual audio it may
357 Playing different languages in this mode is deprecated. New
362 * - ``V4L2_TUNER_MODE_LANG1``
363 - 3
364 - Play the primary language, mono or stereo. Only
365 ``V4L2_TUNER_ANALOG_TV`` tuners support this mode.
366 * - ``V4L2_TUNER_MODE_LANG2``
367 - 2
368 - Play the secondary language, mono. When the tuner receives no
370 driver shall fall back to mono or stereo mode. Only
371 ``V4L2_TUNER_ANALOG_TV`` tuners support this mode.
372 * - ``V4L2_TUNER_MODE_SAP``
373 - 2
374 - Play the Second Audio Program. When the tuner receives no
376 driver shall fall back to mono or stereo mode. Only
377 ``V4L2_TUNER_ANALOG_TV`` tuners support this mode.
381 * - ``V4L2_TUNER_MODE_LANG1_LANG2``
382 - 4
383 - Play the primary language on the left channel, the secondary
387 mode.
395 .. _tuner-matrix:
397 .. flat-table:: Tuner Audio Matrix
398 :header-rows: 2
399 :stub-columns: 0
402 * -
403 - :cspan:`4` Selected ``V4L2_TUNER_MODE_``
404 * - Received ``V4L2_TUNER_SUB_``
405 - ``MONO``
406 - ``STEREO``
407 - ``LANG1``
408 - ``LANG2 = SAP``
409 - ``LANG1_LANG2``\ [#f1]_
410 * - ``MONO``
411 - Mono
412 - Mono/Mono
413 - Mono
414 - Mono
415 - Mono/Mono
416 * - ``MONO | SAP``
417 - Mono
418 - Mono/Mono
419 - Mono
420 - SAP
421 - Mono/SAP (preferred) or Mono/Mono
422 * - ``STEREO``
423 - L+R
424 - L/R
425 - Stereo L/R (preferred) or Mono L+R
426 - Stereo L/R (preferred) or Mono L+R
427 - L/R (preferred) or L+R/L+R
428 * - ``STEREO | SAP``
429 - L+R
430 - L/R
431 - Stereo L/R (preferred) or Mono L+R
432 - SAP
433 - L+R/SAP (preferred) or L/R or L+R/L+R
434 * - ``LANG1 | LANG2``
435 - Language 1
436 - Lang1/Lang2 (deprecated\ [#f2]_) or Lang1/Lang1
437 - Language 1
438 - Language 2
439 - Lang1/Lang2 (preferred) or Lang1/Lang1
448 On success 0 is returned, on error -1 and the ``errno`` variable is set
450 :ref:`Generic Error Codes <gen-errors>` chapter.
457 This mode has been added in Linux 2.6.17 and may not be supported by
462 future drivers should produce only the primary language in this mode.