Lines Matching +full:cm +full:- +full:name
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
10 Name chapter
13 VIDIOC_G_TUNER - VIDIOC_S_TUNER - Get or set tuner attributes
52 Since this is a write-only ioctl, it does not return the actually
62 .. tabularcolumns:: |p{1.3cm}|p{3.0cm}|p{7.0cm}|p{5.8cm}|
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
108 * - __u32
109 - ``rangehigh``
110 - :cspan:`1` The highest tunable frequency in units of 62.5 kHz,
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`
154 * - __u32
155 - ``audmode``
156 - :cspan:`1`
158 The selected audio mode, see :ref:`tuner-audmode` for valid
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.
185 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}|
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)
208 .. tabularcolumns:: |p{7.0cm}|p{2.2cm}|p{8.1cm}|
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
299 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}|
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
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.
332 * - ``V4L2_TUNER_SUB_RDS``
333 - 0x0010
334 - The tuner receives an RDS channel.
337 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}|
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
351 * - ``V4L2_TUNER_MODE_STEREO``
352 - 1
353 - Play stereo audio. When the tuner receives bilingual audio it may
362 * - ``V4L2_TUNER_MODE_LANG1``
363 - 3
364 - Play the primary language, mono or stereo. Only
366 * - ``V4L2_TUNER_MODE_LANG2``
367 - 2
368 - Play the secondary language, mono. When the tuner receives no
372 * - ``V4L2_TUNER_MODE_SAP``
373 - 2
374 - Play the Second Audio Program. When the tuner receives no
381 * - ``V4L2_TUNER_MODE_LANG1_LANG2``
382 - 4
383 - Play the primary language on the left channel, the secondary
393 .. tabularcolumns:: |p{1.5cm}|p{1.5cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|p{2.9cm}|
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.