0001 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
0002
0003 .. _frontend-property-terrestrial-systems:
0004
0005 ***********************************************
0006 Properties used on terrestrial delivery systems
0007 ***********************************************
0008
0009
0010 .. _dvbt-params:
0011
0012 DVB-T delivery system
0013 =====================
0014
0015 The following parameters are valid for DVB-T:
0016
0017 - :ref:`DTV_API_VERSION <DTV-API-VERSION>`
0018
0019 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0020
0021 - :ref:`DTV_TUNE <DTV-TUNE>`
0022
0023 - :ref:`DTV_CLEAR <DTV-CLEAR>`
0024
0025 - :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
0026
0027 - :ref:`DTV_MODULATION <DTV-MODULATION>`
0028
0029 - :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
0030
0031 - :ref:`DTV_INVERSION <DTV-INVERSION>`
0032
0033 - :ref:`DTV_CODE_RATE_HP <DTV-CODE-RATE-HP>`
0034
0035 - :ref:`DTV_CODE_RATE_LP <DTV-CODE-RATE-LP>`
0036
0037 - :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
0038
0039 - :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
0040
0041 - :ref:`DTV_HIERARCHY <DTV-HIERARCHY>`
0042
0043 - :ref:`DTV_LNA <DTV-LNA>`
0044
0045 In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
0046 are also valid.
0047
0048
0049 .. _dvbt2-params:
0050
0051 DVB-T2 delivery system
0052 ======================
0053
0054 DVB-T2 support is currently in the early stages of development, so
0055 expect that this section maygrow and become more detailed with time.
0056
0057 The following parameters are valid for DVB-T2:
0058
0059 - :ref:`DTV_API_VERSION <DTV-API-VERSION>`
0060
0061 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0062
0063 - :ref:`DTV_TUNE <DTV-TUNE>`
0064
0065 - :ref:`DTV_CLEAR <DTV-CLEAR>`
0066
0067 - :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
0068
0069 - :ref:`DTV_MODULATION <DTV-MODULATION>`
0070
0071 - :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
0072
0073 - :ref:`DTV_INVERSION <DTV-INVERSION>`
0074
0075 - :ref:`DTV_CODE_RATE_HP <DTV-CODE-RATE-HP>`
0076
0077 - :ref:`DTV_CODE_RATE_LP <DTV-CODE-RATE-LP>`
0078
0079 - :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
0080
0081 - :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
0082
0083 - :ref:`DTV_HIERARCHY <DTV-HIERARCHY>`
0084
0085 - :ref:`DTV_STREAM_ID <DTV-STREAM-ID>`
0086
0087 - :ref:`DTV_LNA <DTV-LNA>`
0088
0089 In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
0090 are also valid.
0091
0092
0093 .. _isdbt:
0094
0095 ISDB-T delivery system
0096 ======================
0097
0098 This ISDB-T/ISDB-Tsb API extension should reflect all information needed
0099 to tune any ISDB-T/ISDB-Tsb hardware. Of course it is possible that some
0100 very sophisticated devices won't need certain parameters to tune.
0101
0102 The information given here should help application writers to know how
0103 to handle ISDB-T and ISDB-Tsb hardware using the Linux Digital TV API.
0104
0105 The details given here about ISDB-T and ISDB-Tsb are just enough to
0106 basically show the dependencies between the needed parameter values, but
0107 surely some information is left out. For more detailed information see
0108 the following documents:
0109
0110 ARIB STD-B31 - "Transmission System for Digital Terrestrial Television
0111 Broadcasting" and
0112
0113 ARIB TR-B14 - "Operational Guidelines for Digital Terrestrial Television
0114 Broadcasting".
0115
0116 In order to understand the ISDB specific parameters, one has to have
0117 some knowledge the channel structure in ISDB-T and ISDB-Tsb. I.e. it has
0118 to be known to the reader that an ISDB-T channel consists of 13
0119 segments, that it can have up to 3 layer sharing those segments, and
0120 things like that.
0121
0122 The following parameters are valid for ISDB-T:
0123
0124 - :ref:`DTV_API_VERSION <DTV-API-VERSION>`
0125
0126 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0127
0128 - :ref:`DTV_TUNE <DTV-TUNE>`
0129
0130 - :ref:`DTV_CLEAR <DTV-CLEAR>`
0131
0132 - :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
0133
0134 - :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
0135
0136 - :ref:`DTV_INVERSION <DTV-INVERSION>`
0137
0138 - :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
0139
0140 - :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
0141
0142 - :ref:`DTV_ISDBT_LAYER_ENABLED <DTV-ISDBT-LAYER-ENABLED>`
0143
0144 - :ref:`DTV_ISDBT_PARTIAL_RECEPTION <DTV-ISDBT-PARTIAL-RECEPTION>`
0145
0146 - :ref:`DTV_ISDBT_SOUND_BROADCASTING <DTV-ISDBT-SOUND-BROADCASTING>`
0147
0148 - :ref:`DTV_ISDBT_SB_SUBCHANNEL_ID <DTV-ISDBT-SB-SUBCHANNEL-ID>`
0149
0150 - :ref:`DTV_ISDBT_SB_SEGMENT_IDX <DTV-ISDBT-SB-SEGMENT-IDX>`
0151
0152 - :ref:`DTV_ISDBT_SB_SEGMENT_COUNT <DTV-ISDBT-SB-SEGMENT-COUNT>`
0153
0154 - :ref:`DTV_ISDBT_LAYERA_FEC <DTV-ISDBT-LAYER-FEC>`
0155
0156 - :ref:`DTV_ISDBT_LAYERA_MODULATION <DTV-ISDBT-LAYER-MODULATION>`
0157
0158 - :ref:`DTV_ISDBT_LAYERA_SEGMENT_COUNT <DTV-ISDBT-LAYER-SEGMENT-COUNT>`
0159
0160 - :ref:`DTV_ISDBT_LAYERA_TIME_INTERLEAVING <DTV-ISDBT-LAYER-TIME-INTERLEAVING>`
0161
0162 - :ref:`DTV_ISDBT_LAYERB_FEC <DTV-ISDBT-LAYER-FEC>`
0163
0164 - :ref:`DTV_ISDBT_LAYERB_MODULATION <DTV-ISDBT-LAYER-MODULATION>`
0165
0166 - :ref:`DTV_ISDBT_LAYERB_SEGMENT_COUNT <DTV-ISDBT-LAYER-SEGMENT-COUNT>`
0167
0168 - :ref:`DTV_ISDBT_LAYERB_TIME_INTERLEAVING <DTV-ISDBT-LAYER-TIME-INTERLEAVING>`
0169
0170 - :ref:`DTV_ISDBT_LAYERC_FEC <DTV-ISDBT-LAYER-FEC>`
0171
0172 - :ref:`DTV_ISDBT_LAYERC_MODULATION <DTV-ISDBT-LAYER-MODULATION>`
0173
0174 - :ref:`DTV_ISDBT_LAYERC_SEGMENT_COUNT <DTV-ISDBT-LAYER-SEGMENT-COUNT>`
0175
0176 - :ref:`DTV_ISDBT_LAYERC_TIME_INTERLEAVING <DTV-ISDBT-LAYER-TIME-INTERLEAVING>`
0177
0178 In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
0179 are also valid.
0180
0181
0182 .. _atsc-params:
0183
0184 ATSC delivery system
0185 ====================
0186
0187 The following parameters are valid for ATSC:
0188
0189 - :ref:`DTV_API_VERSION <DTV-API-VERSION>`
0190
0191 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0192
0193 - :ref:`DTV_TUNE <DTV-TUNE>`
0194
0195 - :ref:`DTV_CLEAR <DTV-CLEAR>`
0196
0197 - :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
0198
0199 - :ref:`DTV_MODULATION <DTV-MODULATION>`
0200
0201 - :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
0202
0203 In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
0204 are also valid.
0205
0206
0207 .. _atscmh-params:
0208
0209 ATSC-MH delivery system
0210 =======================
0211
0212 The following parameters are valid for ATSC-MH:
0213
0214 - :ref:`DTV_API_VERSION <DTV-API-VERSION>`
0215
0216 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0217
0218 - :ref:`DTV_TUNE <DTV-TUNE>`
0219
0220 - :ref:`DTV_CLEAR <DTV-CLEAR>`
0221
0222 - :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
0223
0224 - :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
0225
0226 - :ref:`DTV_ATSCMH_FIC_VER <DTV-ATSCMH-FIC-VER>`
0227
0228 - :ref:`DTV_ATSCMH_PARADE_ID <DTV-ATSCMH-PARADE-ID>`
0229
0230 - :ref:`DTV_ATSCMH_NOG <DTV-ATSCMH-NOG>`
0231
0232 - :ref:`DTV_ATSCMH_TNOG <DTV-ATSCMH-TNOG>`
0233
0234 - :ref:`DTV_ATSCMH_SGN <DTV-ATSCMH-SGN>`
0235
0236 - :ref:`DTV_ATSCMH_PRC <DTV-ATSCMH-PRC>`
0237
0238 - :ref:`DTV_ATSCMH_RS_FRAME_MODE <DTV-ATSCMH-RS-FRAME-MODE>`
0239
0240 - :ref:`DTV_ATSCMH_RS_FRAME_ENSEMBLE <DTV-ATSCMH-RS-FRAME-ENSEMBLE>`
0241
0242 - :ref:`DTV_ATSCMH_RS_CODE_MODE_PRI <DTV-ATSCMH-RS-CODE-MODE-PRI>`
0243
0244 - :ref:`DTV_ATSCMH_RS_CODE_MODE_SEC <DTV-ATSCMH-RS-CODE-MODE-SEC>`
0245
0246 - :ref:`DTV_ATSCMH_SCCC_BLOCK_MODE <DTV-ATSCMH-SCCC-BLOCK-MODE>`
0247
0248 - :ref:`DTV_ATSCMH_SCCC_CODE_MODE_A <DTV-ATSCMH-SCCC-CODE-MODE-A>`
0249
0250 - :ref:`DTV_ATSCMH_SCCC_CODE_MODE_B <DTV-ATSCMH-SCCC-CODE-MODE-B>`
0251
0252 - :ref:`DTV_ATSCMH_SCCC_CODE_MODE_C <DTV-ATSCMH-SCCC-CODE-MODE-C>`
0253
0254 - :ref:`DTV_ATSCMH_SCCC_CODE_MODE_D <DTV-ATSCMH-SCCC-CODE-MODE-D>`
0255
0256 In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
0257 are also valid.
0258
0259
0260 .. _dtmb-params:
0261
0262 DTMB delivery system
0263 ====================
0264
0265 The following parameters are valid for DTMB:
0266
0267 - :ref:`DTV_API_VERSION <DTV-API-VERSION>`
0268
0269 - :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
0270
0271 - :ref:`DTV_TUNE <DTV-TUNE>`
0272
0273 - :ref:`DTV_CLEAR <DTV-CLEAR>`
0274
0275 - :ref:`DTV_FREQUENCY <DTV-FREQUENCY>`
0276
0277 - :ref:`DTV_MODULATION <DTV-MODULATION>`
0278
0279 - :ref:`DTV_BANDWIDTH_HZ <DTV-BANDWIDTH-HZ>`
0280
0281 - :ref:`DTV_INVERSION <DTV-INVERSION>`
0282
0283 - :ref:`DTV_INNER_FEC <DTV-INNER-FEC>`
0284
0285 - :ref:`DTV_GUARD_INTERVAL <DTV-GUARD-INTERVAL>`
0286
0287 - :ref:`DTV_TRANSMISSION_MODE <DTV-TRANSMISSION-MODE>`
0288
0289 - :ref:`DTV_INTERLEAVING <DTV-INTERLEAVING>`
0290
0291 - :ref:`DTV_LNA <DTV-LNA>`
0292
0293 In addition, the :ref:`DTV QoS statistics <frontend-stat-properties>`
0294 are also valid.