GNU Linux-libre 4.9.314-gnu1
[releases.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::
33
34    Transmission via the internet (DVB-IP) is not yet handled by this
35    API but a future extension is possible.
36
37 On Satellite systems, the API support for the Satellite Equipment
38 Control (SEC) allows to power control and to send/receive signals to
39 control the antenna subsystem, selecting the polarization and choosing
40 the Intermediate Frequency IF) of the Low Noise Block Converter Feed
41 Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
42 (digital SEC) specification is available at
43 `Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
44
45
46 .. toctree::
47     :maxdepth: 1
48
49     query-dvb-frontend-info
50     dvb-fe-read-status
51     dvbproperty
52     frontend_fcalls
53     frontend_legacy_dvbv3_api