1 .. SPDX-License-Identifier: GFDL-1.1-no-invari !! 1 .. Permission is granted to copy, distribute and/or modify this
>> 2 .. document under the terms of the GNU Free Documentation License,
>> 3 .. Version 1.1 or any later version published by the Free Software
>> 4 .. Foundation, with no Invariant Sections, no Front-Cover Texts
>> 5 .. and no Back-Cover Texts. A copy of the license is included at
>> 6 .. Documentation/userspace-api/media/fdl-appendix.rst.
>> 7 ..
>> 8 .. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
2 9
3 .. _radio: 10 .. _radio:
4 11
5 *************** 12 ***************
6 Radio Interface 13 Radio Interface
7 *************** 14 ***************
8 15
9 This interface is intended for AM and FM (anal 16 This interface is intended for AM and FM (analog) radio receivers and
10 transmitters. 17 transmitters.
11 18
12 Conventionally V4L2 radio devices are accessed 19 Conventionally V4L2 radio devices are accessed through character device
13 special files named ``/dev/radio`` and ``/dev/ 20 special files named ``/dev/radio`` and ``/dev/radio0`` to
14 ``/dev/radio63`` with major number 81 and mino 21 ``/dev/radio63`` with major number 81 and minor numbers 64 to 127.
15 22
16 23
17 Querying Capabilities 24 Querying Capabilities
18 ===================== 25 =====================
19 26
20 Devices supporting the radio interface set the 27 Devices supporting the radio interface set the ``V4L2_CAP_RADIO`` and
21 ``V4L2_CAP_TUNER`` or ``V4L2_CAP_MODULATOR`` f 28 ``V4L2_CAP_TUNER`` or ``V4L2_CAP_MODULATOR`` flag in the
22 ``capabilities`` field of struct 29 ``capabilities`` field of struct
23 :c:type:`v4l2_capability` returned by the 30 :c:type:`v4l2_capability` returned by the
24 :ref:`VIDIOC_QUERYCAP` ioctl. Other combinatio 31 :ref:`VIDIOC_QUERYCAP` ioctl. Other combinations of
25 capability flags are reserved for future exten 32 capability flags are reserved for future extensions.
26 33
27 34
28 Supplemental Functions 35 Supplemental Functions
29 ====================== 36 ======================
30 37
31 Radio devices can support :ref:`controls <cont 38 Radio devices can support :ref:`controls <control>`, and must support
32 the :ref:`tuner or modulator <tuner>` ioctls. 39 the :ref:`tuner or modulator <tuner>` ioctls.
33 40
34 They do not support the video input or output, 41 They do not support the video input or output, audio input or output,
35 video standard, cropping and scaling, compress 42 video standard, cropping and scaling, compression and streaming
36 parameter, or overlay ioctls. All other ioctls 43 parameter, or overlay ioctls. All other ioctls and I/O methods are
37 reserved for future extensions. 44 reserved for future extensions.
38 45
39 46
40 Programming 47 Programming
41 =========== 48 ===========
42 49
43 Radio devices may have a couple audio controls 50 Radio devices may have a couple audio controls (as discussed in
44 :ref:`control`) such as a volume control, poss 51 :ref:`control`) such as a volume control, possibly custom controls.
45 Further all radio devices have one tuner or mo 52 Further all radio devices have one tuner or modulator (these are
46 discussed in :ref:`tuner`) with index number z 53 discussed in :ref:`tuner`) with index number zero to select the radio
47 frequency and to determine if a monaural or FM 54 frequency and to determine if a monaural or FM stereo program is
48 received/emitted. Drivers switch automatically 55 received/emitted. Drivers switch automatically between AM and FM
49 depending on the selected frequency. The 56 depending on the selected frequency. The
50 :ref:`VIDIOC_G_TUNER <VIDIOC_G_TUNER>` or 57 :ref:`VIDIOC_G_TUNER <VIDIOC_G_TUNER>` or
51 :ref:`VIDIOC_G_MODULATOR <VIDIOC_G_MODULATOR>` 58 :ref:`VIDIOC_G_MODULATOR <VIDIOC_G_MODULATOR>` ioctl reports the
52 supported frequency range. 59 supported frequency range.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.