Merge branch 'for-linus-4.8' of git://git.kernel.org/pub/scm/linux/kernel/git/mason...
[sfrench/cifs-2.6.git] / Documentation / media / uapi / dvb / frontend.rst
1 .. -*- coding: utf-8; mode: rst -*-
2
3 .. _dvb_frontend:
4
5 ################
6 DVB Frontend API
7 ################
8 The DVB frontend API was designed to support three types of delivery
9 systems:
10
11 -  Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H,
12    DTMB, CMMB
13
14 -  Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B), ISDB-C
15
16 -  Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS
17
18 The DVB frontend controls several sub-devices including:
19
20 -  Tuner
21
22 -  Digital TV demodulator
23
24 -  Low noise amplifier (LNA)
25
26 -  Satellite Equipment Control (SEC) hardware (only for Satellite).
27
28 The frontend can be accessed through ``/dev/dvb/adapter?/frontend?``.
29 Data types and ioctl definitions can be accessed by including
30 ``linux/dvb/frontend.h`` in your application.
31
32 .. note:: Transmission via the internet (DVB-IP) is not yet handled by this
33    API but a future extension is possible.
34
35 On Satellite systems, the API support for the Satellite Equipment
36 Control (SEC) allows to power control and to send/receive signals to
37 control the antenna subsystem, selecting the polarization and choosing
38 the Intermediate Frequency IF) of the Low Noise Block Converter Feed
39 Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
40 (digital SEC) specification is available at
41 `Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
42
43
44 .. toctree::
45     :maxdepth: 1
46
47     query-dvb-frontend-info
48     dvb-fe-read-status
49     dvbproperty
50     frontend_fcalls
51     frontend_legacy_dvbv3_api