1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 ============ 3 ============
4 Introduction 4 Introduction
5 ============ 5 ============
6 6
7 This document covers the Linux Kernel to Users 7 This document covers the Linux Kernel to Userspace API's used by video
8 and radio streaming devices, including video c 8 and radio streaming devices, including video cameras, analog and digital
9 TV receiver cards, AM/FM receiver cards, Softw 9 TV receiver cards, AM/FM receiver cards, Software Defined Radio (SDR),
10 streaming capture and output devices, codec de 10 streaming capture and output devices, codec devices and remote controllers.
11 11
12 A typical media device hardware is shown at :r 12 A typical media device hardware is shown at :ref:`typical_media_device`.
13 13
14 .. _typical_media_device: 14 .. _typical_media_device:
15 15
16 .. kernel-figure:: typical_media_device.svg 16 .. kernel-figure:: typical_media_device.svg
17 :alt: typical_media_device.svg 17 :alt: typical_media_device.svg
18 :align: center 18 :align: center
19 19
20 Typical Media Device 20 Typical Media Device
21 21
22 The media infrastructure API was designed to c 22 The media infrastructure API was designed to control such devices. It is
23 divided into five parts. 23 divided into five parts.
24 24
25 1. The :ref:`first part <v4l2spec>` covers rad 25 1. The :ref:`first part <v4l2spec>` covers radio, video capture and output,
26 cameras, analog TV devices and codecs. 26 cameras, analog TV devices and codecs.
27 27
28 2. The :ref:`second part <dvbapi>` covers the 28 2. The :ref:`second part <dvbapi>` covers the API used for digital TV and
29 Internet reception via one of the several d 29 Internet reception via one of the several digital tv standards. While it is
30 called as DVB API, in fact it covers severa 30 called as DVB API, in fact it covers several different video standards
31 including DVB-T/T2, DVB-S/S2, DVB-C, ATSC, 31 including DVB-T/T2, DVB-S/S2, DVB-C, ATSC, ISDB-T, ISDB-S, DTMB, etc. The
32 complete list of supported standards can be 32 complete list of supported standards can be found at
33 :c:type:`fe_delivery_system`. 33 :c:type:`fe_delivery_system`.
34 34
35 3. The :ref:`third part <remote_controllers>` 35 3. The :ref:`third part <remote_controllers>` covers the Remote Controller API.
36 36
37 4. The :ref:`fourth part <media_controller>` c 37 4. The :ref:`fourth part <media_controller>` covers the Media Controller API.
38 38
39 5. The :ref:`fifth part <cec>` covers the CEC 39 5. The :ref:`fifth part <cec>` covers the CEC (Consumer Electronics Control) API.
40 40
41 It should also be noted that a media device ma 41 It should also be noted that a media device may also have audio components, like
42 mixers, PCM capture, PCM playback, etc, which 42 mixers, PCM capture, PCM playback, etc, which are controlled via ALSA API. For
43 additional information and for the latest deve 43 additional information and for the latest development code, see:
44 `https://linuxtv.org <https://linuxtv.org>`__. 44 `https://linuxtv.org <https://linuxtv.org>`__. For discussing improvements,
45 reporting troubles, sending new drivers, etc, 45 reporting troubles, sending new drivers, etc, please mail to: `Linux Media
46 Mailing List (LMML) <http://vger.kernel.org/vg 46 Mailing List (LMML) <http://vger.kernel.org/vger-lists.html#linux-media>`__.
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.