]>
Commit | Line | Data |
---|---|---|
5377d91f MH |
1 | .. -*- coding: utf-8; mode: rst -*- |
2 | ||
40f7bc9b MCC |
3 | .. include:: <isonum.txt> |
4 | ||
5377d91f | 5 | ############################## |
39ab6323 | 6 | Linux Media Infrastructure API |
5377d91f MH |
7 | ############################## |
8 | ||
40f7bc9b | 9 | **Copyright** |copy| 2009-2016 : LinuxTV Developers |
5377d91f MH |
10 | |
11 | Permission is granted to copy, distribute and/or modify this document | |
12 | under the terms of the GNU Free Documentation License, Version 1.1 or | |
13 | any later version published by the Free Software Foundation. A copy of | |
14 | the license is included in the chapter entitled "GNU Free Documentation | |
72f5a661 | 15 | License". |
5377d91f MH |
16 | |
17 | ||
18 | ============ | |
19 | Introduction | |
20 | ============ | |
21 | ||
22 | This document covers the Linux Kernel to Userspace API's used by video | |
23 | and radio streaming devices, including video cameras, analog and digital | |
72f5a661 MCC |
24 | TV receiver cards, AM/FM receiver cards, Software Defined Radio (SDR), |
25 | streaming capture and output devices, codec devices and remote controllers. | |
5377d91f MH |
26 | |
27 | A typical media device hardware is shown at | |
28 | :ref:`typical_media_device`. | |
29 | ||
30 | ||
31 | .. _typical_media_device: | |
32 | ||
33 | .. figure:: media_api_files/typical_media_device.* | |
34 | :alt: typical_media_device.svg | |
35 | :align: center | |
36 | ||
37 | Typical Media Device | |
38 | ||
5377d91f MH |
39 | The media infrastructure API was designed to control such devices. It is |
40 | divided into four parts. | |
41 | ||
766e137d | 42 | The :Ref:`first part <v4l2spec>` covers radio, video capture and output, |
72f5a661 | 43 | cameras, analog TV devices and codecs. |
5377d91f | 44 | |
766e137d MCC |
45 | The :Ref:`second part <dvbapi>` covers the API used for digital TV and |
46 | Internet reception via one of the several digital tv standards. While it | |
47 | is called as DVB API, in fact it covers several different video | |
48 | standards including DVB-T/T2, DVB-S/S2, DVB-C, ATSC, ISDB-T, ISDB-S, | |
49 | DTMB, etc. The complete list of supported standards can be found at | |
5377d91f MH |
50 | :ref:`fe-delivery-system-t`. |
51 | ||
766e137d | 52 | The :Ref:`third part <remote_controllers>` covers the Remote Controller API. |
5377d91f | 53 | |
766e137d | 54 | The :Ref:`fourth part <media_controller>` covers the Media Controller API. |
5377d91f MH |
55 | |
56 | It should also be noted that a media device may also have audio | |
57 | components, like mixers, PCM capture, PCM playback, etc, which are | |
58 | controlled via ALSA API. | |
59 | ||
60 | For additional information and for the latest development code, see: | |
61 | `https://linuxtv.org <https://linuxtv.org>`__. | |
62 | ||
63 | For discussing improvements, reporting troubles, sending new drivers, | |
64 | etc, please mail to: | |
65 | `Linux Media Mailing List (LMML). <http://vger.kernel.org/vger-lists.html#linux-media>`__. | |
66 | ||
67 | ||
68 | .. toctree:: | |
69 | :maxdepth: 1 | |
70 | ||
71 | media/v4l/v4l2 | |
72 | media/dvb/dvbapi | |
f5eebeef | 73 | media/rc/remote_controllers |
7322c84c | 74 | media/mediactl/media-controller |
b6967199 MCC |
75 | media/gen-errors |
76 | media/fdl-appendix | |
5377d91f | 77 | |
5377d91f MH |
78 | .. only:: html |
79 | ||
80 | Retrieval | |
81 | ========= | |
82 | ||
83 | * :ref:`genindex` |