xref: /openbmc/linux/Documentation/userspace-api/media/dvb/frontend.rst (revision cbecf716ca618fd44feda6bd9a64a8179d031fc5)
1*059b1c5bSMauro Carvalho Chehab.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
254f38fcaSMauro Carvalho Chehab
354f38fcaSMauro Carvalho Chehab.. _dvb_frontend:
454f38fcaSMauro Carvalho Chehab
554f38fcaSMauro Carvalho Chehab#######################
654f38fcaSMauro Carvalho ChehabDigital TV Frontend API
754f38fcaSMauro Carvalho Chehab#######################
854f38fcaSMauro Carvalho Chehab
954f38fcaSMauro Carvalho ChehabThe Digital TV frontend API was designed to support three groups of delivery
1054f38fcaSMauro Carvalho Chehabsystems: Terrestrial, cable and Satellite. Currently, the following
1154f38fcaSMauro Carvalho Chehabdelivery systems are supported:
1254f38fcaSMauro Carvalho Chehab
1354f38fcaSMauro Carvalho Chehab-  Terrestrial systems: DVB-T, DVB-T2, ATSC, ATSC M/H, ISDB-T, DVB-H,
1454f38fcaSMauro Carvalho Chehab   DTMB, CMMB
1554f38fcaSMauro Carvalho Chehab
1654f38fcaSMauro Carvalho Chehab-  Cable systems: DVB-C Annex A/C, ClearQAM (DVB-C Annex B)
1754f38fcaSMauro Carvalho Chehab
1854f38fcaSMauro Carvalho Chehab-  Satellite systems: DVB-S, DVB-S2, DVB Turbo, ISDB-S, DSS
1954f38fcaSMauro Carvalho Chehab
2054f38fcaSMauro Carvalho ChehabThe Digital TV frontend controls several sub-devices including:
2154f38fcaSMauro Carvalho Chehab
2254f38fcaSMauro Carvalho Chehab-  Tuner
2354f38fcaSMauro Carvalho Chehab
2454f38fcaSMauro Carvalho Chehab-  Digital TV demodulator
2554f38fcaSMauro Carvalho Chehab
2654f38fcaSMauro Carvalho Chehab-  Low noise amplifier (LNA)
2754f38fcaSMauro Carvalho Chehab
2854f38fcaSMauro Carvalho Chehab-  Satellite Equipment Control (SEC) [#f1]_.
2954f38fcaSMauro Carvalho Chehab
3054f38fcaSMauro Carvalho ChehabThe frontend can be accessed through ``/dev/dvb/adapter?/frontend?``.
3154f38fcaSMauro Carvalho ChehabData types and ioctl definitions can be accessed by including
3254f38fcaSMauro Carvalho Chehab``linux/dvb/frontend.h`` in your application.
3354f38fcaSMauro Carvalho Chehab
3454f38fcaSMauro Carvalho Chehab.. note::
3554f38fcaSMauro Carvalho Chehab
3654f38fcaSMauro Carvalho Chehab   Transmission via the internet (DVB-IP) and MMT (MPEG Media Transport)
3754f38fcaSMauro Carvalho Chehab   is not yet handled by this API but a future extension is possible.
3854f38fcaSMauro Carvalho Chehab
3954f38fcaSMauro Carvalho Chehab.. [#f1]
4054f38fcaSMauro Carvalho Chehab
4154f38fcaSMauro Carvalho Chehab   On Satellite systems, the API support for the Satellite Equipment
4254f38fcaSMauro Carvalho Chehab   Control (SEC) allows to power control and to send/receive signals to
4354f38fcaSMauro Carvalho Chehab   control the antenna subsystem, selecting the polarization and choosing
4454f38fcaSMauro Carvalho Chehab   the Intermediate Frequency IF) of the Low Noise Block Converter Feed
4554f38fcaSMauro Carvalho Chehab   Horn (LNBf). It supports the DiSEqC and V-SEC protocols. The DiSEqC
4654f38fcaSMauro Carvalho Chehab   (digital SEC) specification is available at
4754f38fcaSMauro Carvalho Chehab   `Eutelsat <http://www.eutelsat.com/satellites/4_5_5.html>`__.
4854f38fcaSMauro Carvalho Chehab
4954f38fcaSMauro Carvalho Chehab
5054f38fcaSMauro Carvalho Chehab.. toctree::
5154f38fcaSMauro Carvalho Chehab    :maxdepth: 1
5254f38fcaSMauro Carvalho Chehab
5354f38fcaSMauro Carvalho Chehab    query-dvb-frontend-info
5454f38fcaSMauro Carvalho Chehab    dvb-fe-read-status
5554f38fcaSMauro Carvalho Chehab    dvbproperty
5654f38fcaSMauro Carvalho Chehab    frontend_fcalls
57