162306a36Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0 262306a36Sopenharmony_ci 362306a36Sopenharmony_ci============ 462306a36Sopenharmony_ciIntroduction 562306a36Sopenharmony_ci============ 662306a36Sopenharmony_ci 762306a36Sopenharmony_ciThis document covers the Linux Kernel to Userspace API's used by video 862306a36Sopenharmony_ciand radio streaming devices, including video cameras, analog and digital 962306a36Sopenharmony_ciTV receiver cards, AM/FM receiver cards, Software Defined Radio (SDR), 1062306a36Sopenharmony_cistreaming capture and output devices, codec devices and remote controllers. 1162306a36Sopenharmony_ci 1262306a36Sopenharmony_ciA typical media device hardware is shown at :ref:`typical_media_device`. 1362306a36Sopenharmony_ci 1462306a36Sopenharmony_ci.. _typical_media_device: 1562306a36Sopenharmony_ci 1662306a36Sopenharmony_ci.. kernel-figure:: typical_media_device.svg 1762306a36Sopenharmony_ci :alt: typical_media_device.svg 1862306a36Sopenharmony_ci :align: center 1962306a36Sopenharmony_ci 2062306a36Sopenharmony_ci Typical Media Device 2162306a36Sopenharmony_ci 2262306a36Sopenharmony_ciThe media infrastructure API was designed to control such devices. It is 2362306a36Sopenharmony_cidivided into five parts. 2462306a36Sopenharmony_ci 2562306a36Sopenharmony_ci1. The :ref:`first part <v4l2spec>` covers radio, video capture and output, 2662306a36Sopenharmony_ci cameras, analog TV devices and codecs. 2762306a36Sopenharmony_ci 2862306a36Sopenharmony_ci2. The :ref:`second part <dvbapi>` covers the API used for digital TV and 2962306a36Sopenharmony_ci Internet reception via one of the several digital tv standards. While it is 3062306a36Sopenharmony_ci called as DVB API, in fact it covers several different video standards 3162306a36Sopenharmony_ci including DVB-T/T2, DVB-S/S2, DVB-C, ATSC, ISDB-T, ISDB-S, DTMB, etc. The 3262306a36Sopenharmony_ci complete list of supported standards can be found at 3362306a36Sopenharmony_ci :c:type:`fe_delivery_system`. 3462306a36Sopenharmony_ci 3562306a36Sopenharmony_ci3. The :ref:`third part <remote_controllers>` covers the Remote Controller API. 3662306a36Sopenharmony_ci 3762306a36Sopenharmony_ci4. The :ref:`fourth part <media_controller>` covers the Media Controller API. 3862306a36Sopenharmony_ci 3962306a36Sopenharmony_ci5. The :ref:`fifth part <cec>` covers the CEC (Consumer Electronics Control) API. 4062306a36Sopenharmony_ci 4162306a36Sopenharmony_ciIt should also be noted that a media device may also have audio components, like 4262306a36Sopenharmony_cimixers, PCM capture, PCM playback, etc, which are controlled via ALSA API. For 4362306a36Sopenharmony_ciadditional information and for the latest development code, see: 4462306a36Sopenharmony_ci`https://linuxtv.org <https://linuxtv.org>`__. For discussing improvements, 4562306a36Sopenharmony_cireporting troubles, sending new drivers, etc, please mail to: `Linux Media 4662306a36Sopenharmony_ciMailing List (LMML) <http://vger.kernel.org/vger-lists.html#linux-media>`__. 47
