0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002
0003 *************
0004 Frontend type
0005 *************
0006
0007 For historical reasons, frontend types are named by the type of
0008 modulation used in transmission. The fontend types are given by
0009 fe_type_t type, defined as:
0010
0011
0012 .. c:type:: fe_type
0013
0014 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.5cm}|
0015
0016 .. flat-table:: Frontend types
0017 :header-rows: 1
0018 :stub-columns: 0
0019 :widths: 3 1 4
0020
0021
0022 - .. row 1
0023
0024 - fe_type
0025
0026 - Description
0027
0028 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` equivalent
0029 type
0030
0031 - .. row 2
0032
0033 - .. _FE-QPSK:
0034
0035 ``FE_QPSK``
0036
0037 - For DVB-S standard
0038
0039 - ``SYS_DVBS``
0040
0041 - .. row 3
0042
0043 - .. _FE-QAM:
0044
0045 ``FE_QAM``
0046
0047 - For DVB-C annex A standard
0048
0049 - ``SYS_DVBC_ANNEX_A``
0050
0051 - .. row 4
0052
0053 - .. _FE-OFDM:
0054
0055 ``FE_OFDM``
0056
0057 - For DVB-T standard
0058
0059 - ``SYS_DVBT``
0060
0061 - .. row 5
0062
0063 - .. _FE-ATSC:
0064
0065 ``FE_ATSC``
0066
0067 - For ATSC standard (terrestrial) or for DVB-C Annex B (cable) used
0068 in US.
0069
0070 - ``SYS_ATSC`` (terrestrial) or ``SYS_DVBC_ANNEX_B`` (cable)
0071
0072
0073 Newer formats like DVB-S2, ISDB-T, ISDB-S and DVB-T2 are not described
0074 at the above, as they're supported via the new
0075 :ref:`FE_GET_PROPERTY/FE_GET_SET_PROPERTY <FE_GET_PROPERTY>`
0076 ioctl's, using the :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0077 parameter.
0078
0079 In the old days, struct :c:type:`dvb_frontend_info`
0080 used to contain ``fe_type_t`` field to indicate the delivery systems,
0081 filled with either ``FE_QPSK, FE_QAM, FE_OFDM`` or ``FE_ATSC``. While this
0082 is still filled to keep backward compatibility, the usage of this field
0083 is deprecated, as it can report just one delivery system, but some
0084 devices support multiple delivery systems. Please use
0085 :ref:`DTV_ENUM_DELSYS <DTV-ENUM-DELSYS>` instead.
0086
0087 On devices that support multiple delivery systems, struct
0088 :c:type:`dvb_frontend_info`::``fe_type_t`` is
0089 filled with the currently standard, as selected by the last call to
0090 :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` using the
0091 :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` property.
