Documentation/media/uapi/dvb/fe-type-t.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _fe-type-t:
   4
   5 *************
   6 Frontend type
   7 *************
   8
   9 For historical reasons, frontend types are named by the type of
  10 modulation used in transmission. The fontend types are given by
  11 fe_type_t type, defined as:
  12
  13
  14 .. _fe-type:
  15
  16 .. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
  17
  18 .. flat-table:: Frontend types
  19     :header-rows:  1
  20     :stub-columns: 0
  21     :widths:       3 1 4
  22
  23
  24     -  .. row 1
  25
  26        -  fe_type
  27
  28        -  Description
  29
  30        -  :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` equivalent
  31           type
  32
  33     -  .. row 2
  34
  35        -  .. _FE-QPSK:
  36
  37           ``FE_QPSK``
  38
  39        -  For DVB-S standard
  40
  41        -  ``SYS_DVBS``
  42
  43     -  .. row 3
  44
  45        -  .. _FE-QAM:
  46
  47           ``FE_QAM``
  48
  49        -  For DVB-C annex A standard
  50
  51        -  ``SYS_DVBC_ANNEX_A``
  52
  53     -  .. row 4
  54
  55        -  .. _FE-OFDM:
  56
  57           ``FE_OFDM``
  58
  59        -  For DVB-T standard
  60
  61        -  ``SYS_DVBT``
  62
  63     -  .. row 5
  64
  65        -  .. _FE-ATSC:
  66
  67           ``FE_ATSC``
  68
  69        -  For ATSC standard (terrestrial) or for DVB-C Annex B (cable) used
  70           in US.
  71
  72        -  ``SYS_ATSC`` (terrestrial) or ``SYS_DVBC_ANNEX_B`` (cable)
  73
  74
  75 Newer formats like DVB-S2, ISDB-T, ISDB-S and DVB-T2 are not described
  76 at the above, as they're supported via the new
  77 :ref:`FE_GET_PROPERTY/FE_GET_SET_PROPERTY <FE_GET_PROPERTY>`
  78 ioctl's, using the :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
  79 parameter.
  80
  81 In the old days, struct :c:type:`dvb_frontend_info`
  82 used to contain ``fe_type_t`` field to indicate the delivery systems,
  83 filled with either FE_QPSK, FE_QAM, FE_OFDM or FE_ATSC. While this
  84 is still filled to keep backward compatibility, the usage of this field
  85 is deprecated, as it can report just one delivery system, but some
  86 devices support multiple delivery systems. Please use
  87 :ref:`DTV_ENUM_DELSYS <DTV-ENUM-DELSYS>` instead.
  88
  89 On devices that support multiple delivery systems, struct
  90 :c:type:`dvb_frontend_info`::``fe_type_t`` is
  91 filled with the currently standard, as selected by the last call to
  92 :ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` using the
  93 :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` property.