18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ci.. _dvb_frontend:
48c2ecf20Sopenharmony_ci
58c2ecf20Sopenharmony_ci#######################
68c2ecf20Sopenharmony_ciDigital TV Frontend API
78c2ecf20Sopenharmony_ci#######################
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ciThe Digital TV frontend API was designed to support three groups of delivery
108c2ecf20Sopenharmony_cisystems: Terrestrial, cable and Satellite. Currently, the following
118c2ecf20Sopenharmony_cidelivery systems are supported:
128c2ecf20Sopenharmony_ci
138c2ecf20Sopenharmony_ci-  Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H,
148c2ecf20Sopenharmony_ci   DTMB, CMMB
158c2ecf20Sopenharmony_ci
168c2ecf20Sopenharmony_ci-  Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B)
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci-  Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ciThe Digital TV frontend controls several sub-devices including:
218c2ecf20Sopenharmony_ci
228c2ecf20Sopenharmony_ci-  Tuner
238c2ecf20Sopenharmony_ci
248c2ecf20Sopenharmony_ci-  Digital TV demodulator
258c2ecf20Sopenharmony_ci
268c2ecf20Sopenharmony_ci-  Low noise amplifier (LNA)
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci-  Satellite Equipment Control (SEC) [#f1]_.
298c2ecf20Sopenharmony_ci
308c2ecf20Sopenharmony_ciThe frontend can be accessed through ``/dev/dvb/adapter?/frontend?``.
318c2ecf20Sopenharmony_ciData types and ioctl definitions can be accessed by including
328c2ecf20Sopenharmony_ci``linux/dvb/frontend.h`` in your application.
338c2ecf20Sopenharmony_ci
348c2ecf20Sopenharmony_ci.. note::
358c2ecf20Sopenharmony_ci
368c2ecf20Sopenharmony_ci   Transmission via the internet (DVB-IP) and MMT (MPEG Media Transport)
378c2ecf20Sopenharmony_ci   is not yet handled by this API but a future extension is possible.
388c2ecf20Sopenharmony_ci
398c2ecf20Sopenharmony_ci.. [#f1]
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ci   On Satellite systems, the API support for the Satellite Equipment
428c2ecf20Sopenharmony_ci   Control (SEC) allows to power control and to send/receive signals to
438c2ecf20Sopenharmony_ci   control the antenna subsystem, selecting the polarization and choosing
448c2ecf20Sopenharmony_ci   the Intermediate Frequency IF) of the Low Noise Block Converter Feed
458c2ecf20Sopenharmony_ci   Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
468c2ecf20Sopenharmony_ci   (digital SEC) specification is available at
478c2ecf20Sopenharmony_ci   `Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
488c2ecf20Sopenharmony_ci
498c2ecf20Sopenharmony_ci
508c2ecf20Sopenharmony_ci.. toctree::
518c2ecf20Sopenharmony_ci    :maxdepth: 1
528c2ecf20Sopenharmony_ci
538c2ecf20Sopenharmony_ci    query-dvb-frontend-info
548c2ecf20Sopenharmony_ci    dvb-fe-read-status
558c2ecf20Sopenharmony_ci    dvbproperty
568c2ecf20Sopenharmony_ci    frontend_fcalls
57