Orange Pi5 kernel

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