162306a36Sopenharmony_ci.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
262306a36Sopenharmony_ci
362306a36Sopenharmony_ci.. _dvb_frontend:
462306a36Sopenharmony_ci
562306a36Sopenharmony_ci#######################
662306a36Sopenharmony_ciDigital TV Frontend API
762306a36Sopenharmony_ci#######################
862306a36Sopenharmony_ci
962306a36Sopenharmony_ciThe Digital TV frontend API was designed to support three groups of delivery
1062306a36Sopenharmony_cisystems: Terrestrial, cable and Satellite. Currently, the following
1162306a36Sopenharmony_cidelivery systems are supported:
1262306a36Sopenharmony_ci
1362306a36Sopenharmony_ci-  Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H,
1462306a36Sopenharmony_ci   DTMB, CMMB
1562306a36Sopenharmony_ci
1662306a36Sopenharmony_ci-  Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B)
1762306a36Sopenharmony_ci
1862306a36Sopenharmony_ci-  Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_ciThe Digital TV frontend controls several sub-devices including:
2162306a36Sopenharmony_ci
2262306a36Sopenharmony_ci-  Tuner
2362306a36Sopenharmony_ci
2462306a36Sopenharmony_ci-  Digital TV demodulator
2562306a36Sopenharmony_ci
2662306a36Sopenharmony_ci-  Low noise amplifier (LNA)
2762306a36Sopenharmony_ci
2862306a36Sopenharmony_ci-  Satellite Equipment Control (SEC) [#f1]_.
2962306a36Sopenharmony_ci
3062306a36Sopenharmony_ciThe frontend can be accessed through ``/dev/dvb/adapter?/frontend?``.
3162306a36Sopenharmony_ciData types and ioctl definitions can be accessed by including
3262306a36Sopenharmony_ci``linux/dvb/frontend.h`` in your application.
3362306a36Sopenharmony_ci
3462306a36Sopenharmony_ci.. note::
3562306a36Sopenharmony_ci
3662306a36Sopenharmony_ci   Transmission via the internet (DVB-IP) and MMT (MPEG Media Transport)
3762306a36Sopenharmony_ci   is not yet handled by this API but a future extension is possible.
3862306a36Sopenharmony_ci
3962306a36Sopenharmony_ci.. [#f1]
4062306a36Sopenharmony_ci
4162306a36Sopenharmony_ci   On Satellite systems, the API support for the Satellite Equipment
4262306a36Sopenharmony_ci   Control (SEC) allows to power control and to send/receive signals to
4362306a36Sopenharmony_ci   control the antenna subsystem, selecting the polarization and choosing
4462306a36Sopenharmony_ci   the Intermediate Frequency IF) of the Low Noise Block Converter Feed
4562306a36Sopenharmony_ci   Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
4662306a36Sopenharmony_ci   (digital SEC) specification is available at
4762306a36Sopenharmony_ci   `Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
4862306a36Sopenharmony_ci
4962306a36Sopenharmony_ci
5062306a36Sopenharmony_ci.. toctree::
5162306a36Sopenharmony_ci    :maxdepth: 1
5262306a36Sopenharmony_ci
5362306a36Sopenharmony_ci    query-dvb-frontend-info
5462306a36Sopenharmony_ci    dvb-fe-read-status
5562306a36Sopenharmony_ci    dvbproperty
5662306a36Sopenharmony_ci    frontend_fcalls
57