18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ci============
48c2ecf20Sopenharmony_ciIntroduction
58c2ecf20Sopenharmony_ci============
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_ciThis document covers the Linux Kernel to Userspace API's used by video
88c2ecf20Sopenharmony_ciand radio streaming devices, including video cameras, analog and digital
98c2ecf20Sopenharmony_ciTV receiver cards, AM/FM receiver cards, Software Defined Radio (SDR),
108c2ecf20Sopenharmony_cistreaming capture and output devices, codec devices and remote controllers.
118c2ecf20Sopenharmony_ci
128c2ecf20Sopenharmony_ciA typical media device hardware is shown at :ref:`typical_media_device`.
138c2ecf20Sopenharmony_ci
148c2ecf20Sopenharmony_ci.. _typical_media_device:
158c2ecf20Sopenharmony_ci
168c2ecf20Sopenharmony_ci.. kernel-figure:: typical_media_device.svg
178c2ecf20Sopenharmony_ci    :alt:   typical_media_device.svg
188c2ecf20Sopenharmony_ci    :align: center
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci    Typical Media Device
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ciThe media infrastructure API was designed to control such devices. It is
238c2ecf20Sopenharmony_cidivided into five parts.
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ci1. The :ref:`first part <v4l2spec>` covers radio, video capture and output,
268c2ecf20Sopenharmony_ci   cameras, analog TV devices and codecs.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci2. The :ref:`second part <dvbapi>` covers the API used for digital TV and
298c2ecf20Sopenharmony_ci   Internet reception via one of the several digital tv standards. While it is
308c2ecf20Sopenharmony_ci   called as DVB API, in fact it covers several different video standards
318c2ecf20Sopenharmony_ci   including DVB-T/T2, DVB-S/S2, DVB-C, ATSC, ISDB-T, ISDB-S, DTMB, etc. The
328c2ecf20Sopenharmony_ci   complete list of supported standards can be found at
338c2ecf20Sopenharmony_ci   :c:type:`fe_delivery_system`.
348c2ecf20Sopenharmony_ci
358c2ecf20Sopenharmony_ci3. The :ref:`third part <remote_controllers>` covers the Remote Controller API.
368c2ecf20Sopenharmony_ci
378c2ecf20Sopenharmony_ci4. The :ref:`fourth part <media_controller>` covers the Media Controller API.
388c2ecf20Sopenharmony_ci
398c2ecf20Sopenharmony_ci5. The :ref:`fifth part <cec>` covers the CEC (Consumer Electronics Control) API.
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ciIt should also be noted that a media device may also have audio components, like
428c2ecf20Sopenharmony_cimixers, PCM capture, PCM playback, etc, which are controlled via ALSA API.  For
438c2ecf20Sopenharmony_ciadditional information and for the latest development code, see:
448c2ecf20Sopenharmony_ci`https://linuxtv.org <https://linuxtv.org>`__.  For discussing improvements,
458c2ecf20Sopenharmony_cireporting troubles, sending new drivers, etc, please mail to: `Linux Media
468c2ecf20Sopenharmony_ciMailing List (LMML) <http://vger.kernel.org/vger-lists.html#linux-media>`__.
47