xref: /linux/Documentation/userspace-api/media/dvb/legacy_dvb_apis.rst (revision 54f38fcae536ea202ce7d6a359521492fba30c1f)
1*54f38fcaSMauro Carvalho Chehab.. Permission is granted to copy, distribute and/or modify this
2*54f38fcaSMauro Carvalho Chehab.. document under the terms of the GNU Free Documentation License,
3*54f38fcaSMauro Carvalho Chehab.. Version 1.1 or any later version published by the Free Software
4*54f38fcaSMauro Carvalho Chehab.. Foundation, with no Invariant Sections, no Front-Cover Texts
5*54f38fcaSMauro Carvalho Chehab.. and no Back-Cover Texts. A copy of the license is included at
6*54f38fcaSMauro Carvalho Chehab.. Documentation/userspace-api/media/fdl-appendix.rst.
7*54f38fcaSMauro Carvalho Chehab..
8*54f38fcaSMauro Carvalho Chehab.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
9*54f38fcaSMauro Carvalho Chehab
10*54f38fcaSMauro Carvalho Chehab.. _legacy_dvb_apis:
11*54f38fcaSMauro Carvalho Chehab
12*54f38fcaSMauro Carvalho Chehab***************************
13*54f38fcaSMauro Carvalho ChehabDigital TV Deprecated APIs
14*54f38fcaSMauro Carvalho Chehab***************************
15*54f38fcaSMauro Carvalho Chehab
16*54f38fcaSMauro Carvalho ChehabThe APIs described here **should not** be used on new drivers or applications.
17*54f38fcaSMauro Carvalho Chehab
18*54f38fcaSMauro Carvalho ChehabThe DVBv3 frontend API has issues with new delivery systems, including
19*54f38fcaSMauro Carvalho ChehabDVB-S2, DVB-T2, ISDB, etc.
20*54f38fcaSMauro Carvalho Chehab
21*54f38fcaSMauro Carvalho ChehabThere's just one driver for a very legacy hardware using the Digital TV
22*54f38fcaSMauro Carvalho Chehabaudio and video APIs. No modern drivers should use it. Instead, audio and
23*54f38fcaSMauro Carvalho Chehabvideo should be using the V4L2 and ALSA APIs, and the pipelines should
24*54f38fcaSMauro Carvalho Chehabbe set via the Media Controller API.
25*54f38fcaSMauro Carvalho Chehab
26*54f38fcaSMauro Carvalho Chehab.. attention::
27*54f38fcaSMauro Carvalho Chehab
28*54f38fcaSMauro Carvalho Chehab   The APIs described here doesn't necessarily reflect the current
29*54f38fcaSMauro Carvalho Chehab   code implementation, as this section of the document was written
30*54f38fcaSMauro Carvalho Chehab   for DVB version 1, while the code reflects DVB version 3
31*54f38fcaSMauro Carvalho Chehab   implementation.
32*54f38fcaSMauro Carvalho Chehab
33*54f38fcaSMauro Carvalho Chehab
34*54f38fcaSMauro Carvalho Chehab.. toctree::
35*54f38fcaSMauro Carvalho Chehab    :maxdepth: 1
36*54f38fcaSMauro Carvalho Chehab
37*54f38fcaSMauro Carvalho Chehab    frontend_legacy_dvbv3_api
38*54f38fcaSMauro Carvalho Chehab    video
39*54f38fcaSMauro Carvalho Chehab    audio
40