blob: 0bfade2b72cfccee857c47972f7b5bbef01f1b4e [file] [log] [blame]
Markus Heiser5377d912016-06-30 15:18:56 +02001.. -*- coding: utf-8; mode: rst -*-
2
3.. _dvb_frontend:
4
5################
6DVB Frontend API
7################
Mauro Carvalho Chehab3430b8e92017-08-26 06:07:10 -04008
9The DVB frontend API was designed to support three groups of delivery
10systems: Terrestrial, cable and Satellite. Currently, the following
11delivery systems are supported:
Markus Heiser5377d912016-06-30 15:18:56 +020012
13- Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H,
14 DTMB, CMMB
15
Mauro Carvalho Chehab3430b8e92017-08-26 06:07:10 -040016- Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B)
Markus Heiser5377d912016-06-30 15:18:56 +020017
18- Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS
19
20The DVB frontend controls several sub-devices including:
21
22- Tuner
23
24- Digital TV demodulator
25
26- Low noise amplifier (LNA)
27
Mauro Carvalho Chehab2258ee72017-08-26 06:07:11 -040028- Satellite Equipment Control (SEC) [#f1]_.
Markus Heiser5377d912016-06-30 15:18:56 +020029
30The frontend can be accessed through ``/dev/dvb/adapter?/frontend?``.
31Data types and ioctl definitions can be accessed by including
32``linux/dvb/frontend.h`` in your application.
33
Mauro Carvalho Chehabb6b6e672016-08-15 17:49:50 -030034.. note::
35
36 Transmission via the internet (DVB-IP) is not yet handled by this
Mauro Carvalho Chehab706f8a92016-07-10 11:57:43 -030037 API but a future extension is possible.
Markus Heiser5377d912016-06-30 15:18:56 +020038
Mauro Carvalho Chehab2258ee72017-08-26 06:07:11 -040039
40.. [#f1]
41
42 On Satellite systems, the API support for the Satellite Equipment
43 Control (SEC) allows to power control and to send/receive signals to
44 control the antenna subsystem, selecting the polarization and choosing
45 the Intermediate Frequency IF) of the Low Noise Block Converter Feed
46 Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
47 (digital SEC) specification is available at
48 `Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
Markus Heiser5377d912016-06-30 15:18:56 +020049
50
51.. toctree::
52 :maxdepth: 1
53
54 query-dvb-frontend-info
55 dvb-fe-read-status
56 dvbproperty
57 frontend_fcalls
58 frontend_legacy_dvbv3_api