Documentation/DocBook/dvb/dvbproperty.xml

   1 <section id="FE_GET_SET_PROPERTY">
   2 <title>FE_GET_PROPERTY/FE_SET_PROPERTY</title>
   3
   4 <programlisting>
   5 /* Reserved fields should be set to 0 */
   6 struct dtv_property {
   7         __u32 cmd;
   8         union {
   9                 __u32 data;
  10                 struct {
  11                         __u8 data[32];
  12                         __u32 len;
  13                         __u32 reserved1[3];
  14                         void *reserved2;
  15                 } buffer;
  16         } u;
  17         int result;
  18 } __attribute__ ((packed));
  19
  20 /* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
  21 #define DTV_IOCTL_MAX_MSGS 64
  22
  23 struct dtv_properties {
  24         __u32 num;
  25         struct dtv_property *props;
  26 };
  27 </programlisting>
  28
  29 <section id="FE_GET_PROPERTY">
  30 <title>FE_GET_PROPERTY</title>
  31 <para>DESCRIPTION
  32 </para>
  33 <informaltable><tgroup cols="1"><tbody><row><entry
  34  align="char">
  35 <para>This ioctl call returns one or more frontend properties. This call only
  36  requires read-only access to the device.</para>
  37 </entry>
  38  </row></tbody></tgroup></informaltable>
  39 <para>SYNOPSIS
  40 </para>
  41 <informaltable><tgroup cols="1"><tbody><row><entry
  42  align="char">
  43 <para>int ioctl(int fd, int request = <link linkend="FE_GET_PROPERTY">FE_GET_PROPERTY</link>,
  44  dtv_properties &#x22C6;props);</para>
  45 </entry>
  46  </row></tbody></tgroup></informaltable>
  47 <para>PARAMETERS
  48 </para>
  49 <informaltable><tgroup cols="2"><tbody><row><entry align="char">
  50 <para>int fd</para>
  51 </entry><entry
  52  align="char">
  53 <para>File descriptor returned by a previous call to open().</para>
  54 </entry>
  55  </row><row><entry
  56  align="char">
  57 <para>int num</para>
  58 </entry><entry
  59  align="char">
  60 <para>Equals <link linkend="FE_GET_PROPERTY">FE_GET_PROPERTY</link> for this command.</para>
  61 </entry>
  62  </row><row><entry
  63  align="char">
  64 <para>struct dtv_property *props</para>
  65 </entry><entry
  66  align="char">
  67 <para>Points to the location where the front-end property commands are stored.</para>
  68 </entry>
  69  </row></tbody></tgroup></informaltable>
  70 <para>ERRORS</para>
  71 <informaltable><tgroup cols="2"><tbody><row>
  72   <entry align="char"><para>EINVAL</para></entry>
  73   <entry align="char"><para>Invalid parameter(s) received or number of parameters out of the range.</para></entry>
  74  </row><row>
  75   <entry align="char"><para>ENOMEM</para></entry>
  76   <entry align="char"><para>Out of memory.</para></entry>
  77  </row><row>
  78   <entry align="char"><para>EFAULT</para></entry>
  79   <entry align="char"><para>Failure while copying data from/to userspace.</para></entry>
  80  </row><row>
  81   <entry align="char"><para>EOPNOTSUPP</para></entry>
  82   <entry align="char"><para>Property type not supported.</para></entry>
  83  </row></tbody></tgroup></informaltable>
  84 </section>
  85
  86 <section id="FE_SET_PROPERTY">
  87 <title>FE_SET_PROPERTY</title>
  88 <para>DESCRIPTION
  89 </para>
  90 <informaltable><tgroup cols="1"><tbody><row><entry
  91  align="char">
  92 <para>This ioctl call sets one or more frontend properties. This call only
  93  requires read-only access to the device.</para>
  94 </entry>
  95  </row></tbody></tgroup></informaltable>
  96 <para>SYNOPSIS
  97 </para>
  98 <informaltable><tgroup cols="1"><tbody><row><entry
  99  align="char">
 100 <para>int ioctl(int fd, int request = <link linkend="FE_SET_PROPERTY">FE_SET_PROPERTY</link>,
 101  dtv_properties &#x22C6;props);</para>
 102 </entry>
 103  </row></tbody></tgroup></informaltable>
 104 <para>PARAMETERS
 105 </para>
 106 <informaltable><tgroup cols="2"><tbody><row><entry align="char">
 107 <para>int fd</para>
 108 </entry><entry
 109  align="char">
 110 <para>File descriptor returned by a previous call to open().</para>
 111 </entry>
 112  </row><row><entry
 113  align="char">
 114 <para>int num</para>
 115 </entry><entry
 116  align="char">
 117 <para>Equals <link linkend="FE_SET_PROPERTY">FE_SET_PROPERTY</link> for this command.</para>
 118 </entry>
 119  </row><row><entry
 120  align="char">
 121 <para>struct dtv_property *props</para>
 122 </entry><entry
 123  align="char">
 124 <para>Points to the location where the front-end property commands are stored.</para>
 125 </entry>
 126  </row></tbody></tgroup></informaltable>
 127 <para>ERRORS
 128 </para>
 129 <informaltable><tgroup cols="2"><tbody><row>
 130   <entry align="char"><para>EINVAL</para></entry>
 131   <entry align="char"><para>Invalid parameter(s) received or number of parameters out of the range.</para></entry>
 132  </row><row>
 133   <entry align="char"><para>ENOMEM</para></entry>
 134   <entry align="char"><para>Out of memory.</para></entry>
 135  </row><row>
 136   <entry align="char"><para>EFAULT</para></entry>
 137   <entry align="char"><para>Failure while copying data from/to userspace.</para></entry>
 138  </row><row>
 139   <entry align="char"><para>EOPNOTSUPP</para></entry>
 140   <entry align="char"><para>Property type not supported.</para></entry>
 141  </row></tbody></tgroup></informaltable>
 142 </section>
 143
 144 <para>
 145 On <link linkend="FE_GET_PROPERTY">FE_GET_PROPERTY</link>/<link linkend="FE_SET_PROPERTY">FE_SET_PROPERTY</link>,
 146 the actual action is determined by the dtv_property cmd/data pairs. With one single ioctl, is possible to
 147 get/set up to 64 properties. The actual meaning of each property is described on the next sections.
 148 </para>
 149
 150 <para>The Available frontend property types are:</para>
 151 <programlisting>
 152 #define DTV_UNDEFINED           0
 153 #define DTV_TUNE                1
 154 #define DTV_CLEAR               2
 155 #define DTV_FREQUENCY           3
 156 #define DTV_MODULATION          4
 157 #define DTV_BANDWIDTH_HZ        5
 158 #define DTV_INVERSION           6
 159 #define DTV_DISEQC_MASTER       7
 160 #define DTV_SYMBOL_RATE         8
 161 #define DTV_INNER_FEC           9
 162 #define DTV_VOLTAGE             10
 163 #define DTV_TONE                11
 164 #define DTV_PILOT               12
 165 #define DTV_ROLLOFF             13
 166 #define DTV_DISEQC_SLAVE_REPLY  14
 167 #define DTV_FE_CAPABILITY_COUNT 15
 168 #define DTV_FE_CAPABILITY       16
 169 #define DTV_DELIVERY_SYSTEM     17
 170 #define DTV_ISDBT_PARTIAL_RECEPTION     18
 171 #define DTV_ISDBT_SOUND_BROADCASTING    19
 172 #define DTV_ISDBT_SB_SUBCHANNEL_ID      20
 173 #define DTV_ISDBT_SB_SEGMENT_IDX        21
 174 #define DTV_ISDBT_SB_SEGMENT_COUNT      22
 175 #define DTV_ISDBT_LAYERA_FEC                    23
 176 #define DTV_ISDBT_LAYERA_MODULATION             24
 177 #define DTV_ISDBT_LAYERA_SEGMENT_COUNT          25
 178 #define DTV_ISDBT_LAYERA_TIME_INTERLEAVING      26
 179 #define DTV_ISDBT_LAYERB_FEC                    27
 180 #define DTV_ISDBT_LAYERB_MODULATION             28
 181 #define DTV_ISDBT_LAYERB_SEGMENT_COUNT          29
 182 #define DTV_ISDBT_LAYERB_TIME_INTERLEAVING      30
 183 #define DTV_ISDBT_LAYERC_FEC                    31
 184 #define DTV_ISDBT_LAYERC_MODULATION             32
 185 #define DTV_ISDBT_LAYERC_SEGMENT_COUNT          33
 186 #define DTV_ISDBT_LAYERC_TIME_INTERLEAVING      34
 187 #define DTV_API_VERSION         35
 188 #define DTV_CODE_RATE_HP        36
 189 #define DTV_CODE_RATE_LP        37
 190 #define DTV_GUARD_INTERVAL      38
 191 #define DTV_TRANSMISSION_MODE   39
 192 #define DTV_HIERARCHY           40
 193 #define DTV_ISDBT_LAYER_ENABLED 41
 194 #define DTV_ISDBS_TS_ID         42
 195 </programlisting>
 196
 197 <section id="fe_property_common">
 198         <title>Parameters that are common to all Digital TV standards</title>
 199         <section id="DTV_FREQUENCY">
 200                 <title><constant>DTV_FREQUENCY</constant></title>
 201
 202                 <para>Central frequency of the channel, in HZ.</para>
 203
 204                 <para>Notes:</para>
 205                 <para>1)For ISDB-T, the channels are usually transmitted with an offset of 143kHz.
 206                         E.g. a valid frequncy could be 474143 kHz. The stepping is bound to the bandwidth of
 207                         the channel which is 6MHz.</para>
 208
 209                 <para>2)As in ISDB-Tsb the channel consists of only one or three segments the
 210                         frequency step is 429kHz, 3*429 respectively. As for ISDB-T the
 211                         central frequency of the channel is expected.</para>
 212         </section>
 213
 214         <section id="DTV_BANDWIDTH_HZ">
 215                 <title><constant>DTV_BANDWIDTH_HZ</constant></title>
 216
 217                 <para>Bandwidth for the channel, in HZ.</para>
 218
 219                 <para>Possible values:
 220                         <constant>6000000</constant>,
 221                         <constant>7000000</constant>,
 222                         <constant>8000000</constant>.
 223                 </para>
 224
 225                 <para>Notes:</para>
 226
 227                 <para>1) For ISDB-T it should be always 6000000Hz (6MHz)</para>
 228                 <para>2) For ISDB-Tsb it can vary depending on the number of connected segments</para>
 229                 <para>3) Bandwidth doesn't apply for DVB-C transmissions, as the bandwidth
 230                          for DVB-C depends on the symbol rate</para>
 231                 <para>4) Bandwidth in ISDB-T is fixed (6MHz) or can be easily derived from
 232                         other parameters (DTV_ISDBT_SB_SEGMENT_IDX,
 233                         DTV_ISDBT_SB_SEGMENT_COUNT).</para>
 234         </section>
 235
 236         <section id="DTV_DELIVERY_SYSTEM">
 237                 <title><constant>DTV_DELIVERY_SYSTEM</constant></title>
 238
 239                 <para>Specifies the type of Delivery system</para>
 240
 241                 <para>Possible values: </para>
 242 <programlisting>
 243 typedef enum fe_delivery_system {
 244         SYS_UNDEFINED,
 245         SYS_DVBC_ANNEX_AC,
 246         SYS_DVBC_ANNEX_B,
 247         SYS_DVBT,
 248         SYS_DSS,
 249         SYS_DVBS,
 250         SYS_DVBS2,
 251         SYS_DVBH,
 252         SYS_ISDBT,
 253         SYS_ISDBS,
 254         SYS_ISDBC,
 255         SYS_ATSC,
 256         SYS_ATSCMH,
 257         SYS_DMBTH,
 258         SYS_CMMB,
 259         SYS_DAB,
 260 } fe_delivery_system_t;
 261 </programlisting>
 262
 263         </section>
 264
 265         <section id="DTV_TRANSMISSION_MODE">
 266                 <title><constant>DTV_TRANSMISSION_MODE</constant></title>
 267
 268                 <para>Specifies the number of carriers used by the standard</para>
 269
 270                 <para>Possible values are:</para>
 271 <programlisting>
 272 typedef enum fe_transmit_mode {
 273         TRANSMISSION_MODE_2K,
 274         TRANSMISSION_MODE_8K,
 275         TRANSMISSION_MODE_AUTO,
 276         TRANSMISSION_MODE_4K
 277 } fe_transmit_mode_t;
 278 </programlisting>
 279
 280                 <para>Notes:</para>
 281                 <para>1) ISDB-T supports three carrier/symbol-size: 8K, 4K, 2K. It is called
 282                         'mode' in the standard: Mode 1 is 2K, mode 2 is 4K, mode 3 is 8K</para>
 283
 284                 <para>2) If <constant>DTV_TRANSMISSION_MODE</constant> is set the <constant>TRANSMISSION_MODE_AUTO</constant> the
 285                         hardware will try to find the correct FFT-size (if capable) and will
 286                         use TMCC to fill in the missing parameters.</para>
 287         </section>
 288
 289         <section id="DTV_GUARD_INTERVAL">
 290                 <title><constant>DTV_GUARD_INTERVAL</constant></title>
 291
 292                 <para>Possible values are:</para>
 293 <programlisting>
 294 typedef enum fe_guard_interval {
 295         GUARD_INTERVAL_1_32,
 296         GUARD_INTERVAL_1_16,
 297         GUARD_INTERVAL_1_8,
 298         GUARD_INTERVAL_1_4,
 299         GUARD_INTERVAL_AUTO
 300 } fe_guard_interval_t;
 301 </programlisting>
 302
 303                 <para>Notes:</para>
 304                 <para>1) If <constant>DTV_GUARD_INTERVAL</constant> is set the <constant>GUARD_INTERVAL_AUTO</constant> the hardware will
 305                         try to find the correct guard interval (if capable) and will use TMCC to fill
 306                         in the missing parameters.</para>
 307         </section>
 308 </section>
 309
 310 <section id="isdbt">
 311         <title>ISDB-T frontend</title>
 312         <para>This section describes shortly what are the possible parameters in the Linux
 313                 DVB-API called "S2API" and now DVB API 5 in order to tune an ISDB-T/ISDB-Tsb
 314                 demodulator:</para>
 315
 316         <para>This ISDB-T/ISDB-Tsb API extension should reflect all information
 317                 needed to tune any ISDB-T/ISDB-Tsb hardware. Of course it is possible
 318                 that some very sophisticated devices won't need certain parameters to
 319                 tune.</para>
 320
 321         <para>The information given here should help application writers to know how
 322                 to handle ISDB-T and ISDB-Tsb hardware using the Linux DVB-API.</para>
 323
 324         <para>The details given here about ISDB-T and ISDB-Tsb are just enough to
 325                 basically show the dependencies between the needed parameter values,
 326                 but surely some information is left out. For more detailed information
 327                 see the following documents:</para>
 328
 329         <para>ARIB STD-B31 - "Transmission System for Digital Terrestrial
 330                 Television Broadcasting" and</para>
 331         <para>ARIB TR-B14 - "Operational Guidelines for Digital Terrestrial
 332                 Television Broadcasting".</para>
 333
 334         <para>In order to read this document one has to have some knowledge the
 335                 channel structure in ISDB-T and ISDB-Tsb. I.e. it has to be known to
 336                 the reader that an ISDB-T channel consists of 13 segments, that it can
 337                 have up to 3 layer sharing those segments, and things like that.</para>
 338
 339         <para>Parameters used by ISDB-T and ISDB-Tsb.</para>
 340
 341         <section id="isdbt-new-parms">
 342                 <title>ISDB-T only parameters</title>
 343
 344                 <section id="isdbt-part-rec">
 345                         <title><constant>DTV_ISDBT_PARTIAL_RECEPTION</constant></title>
 346
 347                         <para><constant>If DTV_ISDBT_SOUND_BROADCASTING</constant> is '0' this bit-field represents whether
 348                                 the channel is in partial reception mode or not.</para>
 349
 350                         <para>If '1' <constant>DTV_ISDBT_LAYERA_*</constant> values are assigned to the center segment and
 351                                 <constant>DTV_ISDBT_LAYERA_SEGMENT_COUNT</constant> has to be '1'.</para>
 352
 353                         <para>If in addition <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'
 354                                 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> represents whether this ISDB-Tsb channel
 355                                 is consisting of one segment and layer or three segments and two layers.</para>
 356
 357                         <para>Possible values: 0, 1, -1 (AUTO)</para>
 358                 </section>
 359
 360                 <section id="isdbt-sound-bcast">
 361                         <title><constant>DTV_ISDBT_SOUND_BROADCASTING</constant></title>
 362
 363                         <para>This field represents whether the other DTV_ISDBT_*-parameters are
 364                                 referring to an ISDB-T and an ISDB-Tsb channel. (See also
 365                                 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>).</para>
 366
 367                         <para>Possible values: 0, 1, -1 (AUTO)</para>
 368                 </section>
 369
 370                 <section id="isdbt-sb-ch-id">
 371                         <title><constant>DTV_ISDBT_SB_SUBCHANNEL_ID</constant></title>
 372
 373                         <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
 374
 375                         <para>(Note of the author: This might not be the correct description of the
 376                                 <constant>SUBCHANNEL-ID</constant> in all details, but it is my understanding of the technical
 377                                 background needed to program a device)</para>
 378
 379                         <para>An ISDB-Tsb channel (1 or 3 segments) can be broadcasted alone or in a
 380                                 set of connected ISDB-Tsb channels. In this set of channels every
 381                                 channel can be received independently. The number of connected
 382                                 ISDB-Tsb segment can vary, e.g. depending on the frequency spectrum
 383                                 bandwidth available.</para>
 384
 385                         <para>Example: Assume 8 ISDB-Tsb connected segments are broadcasted. The
 386                                 broadcaster has several possibilities to put those channels in the
 387                                 air: Assuming a normal 13-segment ISDB-T spectrum he can align the 8
 388                                 segments from position 1-8 to 5-13 or anything in between.</para>
 389
 390                         <para>The underlying layer of segments are subchannels: each segment is
 391                                 consisting of several subchannels with a predefined IDs. A sub-channel
 392                                 is used to help the demodulator to synchronize on the channel.</para>
 393
 394                         <para>An ISDB-T channel is always centered over all sub-channels. As for
 395                                 the example above, in ISDB-Tsb it is no longer as simple as that.</para>
 396
 397                         <para><constant>The DTV_ISDBT_SB_SUBCHANNEL_ID</constant> parameter is used to give the
 398                                 sub-channel ID of the segment to be demodulated.</para>
 399
 400                         <para>Possible values: 0 .. 41, -1 (AUTO)</para>
 401                 </section>
 402
 403                 <section id="isdbt-sb-seg-idx">
 404
 405                         <title><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant></title>
 406
 407                         <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
 408
 409                         <para><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant> gives the index of the segment to be
 410                                 demodulated for an ISDB-Tsb channel where several of them are
 411                                 transmitted in the connected manner.</para>
 412
 413                         <para>Possible values: 0 .. <constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant> - 1</para>
 414
 415                         <para>Note: This value cannot be determined by an automatic channel search.</para>
 416                 </section>
 417
 418                 <section id="isdbt-sb-seg-cnt">
 419                         <title><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant></title>
 420
 421                         <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
 422
 423                         <para><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant> gives the total count of connected ISDB-Tsb
 424                                 channels.</para>
 425
 426                         <para>Possible values: 1 .. 13</para>
 427
 428                         <para>Note: This value cannot be determined by an automatic channel search.</para>
 429                 </section>
 430
 431                 <section id="isdb-hierq-layers">
 432                         <title>Hierarchical layers</title>
 433
 434                         <para>ISDB-T channels can be coded hierarchically. As opposed to DVB-T in
 435                                 ISDB-T hierarchical layers can be decoded simultaneously. For that
 436                                 reason a ISDB-T demodulator has 3 viterbi and 3 reed-solomon-decoders.</para>
 437
 438                         <para>ISDB-T has 3 hierarchical layers which each can use a part of the
 439                                 available segments. The total number of segments over all layers has
 440                                 to 13 in ISDB-T.</para>
 441
 442                         <section id="isdbt-layer-ena">
 443                                 <title><constant>DTV_ISDBT_LAYER_ENABLED</constant></title>
 444
 445                                 <para>Hierarchical reception in ISDB-T is achieved by enabling or disabling
 446                                         layers in the decoding process. Setting all bits of
 447                                         <constant>DTV_ISDBT_LAYER_ENABLED</constant> to '1' forces all layers (if applicable) to be
 448                                         demodulated. This is the default.</para>
 449
 450                                 <para>If the channel is in the partial reception mode
 451                                         (<constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> = 1) the central segment can be decoded
 452                                         independently of the other 12 segments. In that mode layer A has to
 453                                         have a <constant>SEGMENT_COUNT</constant> of 1.</para>
 454
 455                                 <para>In ISDB-Tsb only layer A is used, it can be 1 or 3 in ISDB-Tsb
 456                                         according to <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>. <constant>SEGMENT_COUNT</constant> must be filled
 457                                         accordingly.</para>
 458
 459                                 <para>Possible values: 0x1, 0x2, 0x4 (|-able)</para>
 460
 461                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[0:0]</constant> - layer A</para>
 462                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[1:1]</constant> - layer B</para>
 463                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[2:2]</constant> - layer C</para>
 464                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[31:3]</constant> unused</para>
 465                         </section>
 466
 467                         <section id="isdbt-layer-fec">
 468                                 <title><constant>DTV_ISDBT_LAYER*_FEC</constant></title>
 469
 470                                 <para>Possible values: <constant>FEC_AUTO</constant>, <constant>FEC_1_2</constant>, <constant>FEC_2_3</constant>, <constant>FEC_3_4</constant>, <constant>FEC_5_6</constant>, <constant>FEC_7_8</constant></para>
 471                         </section>
 472
 473                         <section id="isdbt-layer-mod">
 474                                 <title><constant>DTV_ISDBT_LAYER*_MODULATION</constant></title>
 475
 476                                 <para>Possible values: <constant>QAM_AUTO</constant>, QP<constant>SK, QAM_16</constant>, <constant>QAM_64</constant>, <constant>DQPSK</constant></para>
 477
 478                                 <para>Note: If layer C is <constant>DQPSK</constant> layer B has to be <constant>DQPSK</constant>. If layer B is <constant>DQPSK</constant>
 479                                         and <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>=0 layer has to be <constant>DQPSK</constant>.</para>
 480                         </section>
 481
 482                         <section id="isdbt-layer-seg-cnt">
 483                                 <title><constant>DTV_ISDBT_LAYER*_SEGMENT_COUNT</constant></title>
 484
 485                                 <para>Possible values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, -1 (AUTO)</para>
 486
 487                                 <para>Note: Truth table for <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> and
 488                                         <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> and <constant>LAYER</constant>*_SEGMENT_COUNT</para>
 489
 490                                 <informaltable id="isdbt-layer_seg-cnt-table">
 491                                         <tgroup cols="6">
 492
 493                                                 <tbody>
 494                                                         <row>
 495                                                                 <entry>PR</entry>
 496                                                                 <entry>SB</entry>
 497                                                                 <entry>Layer A width</entry>
 498                                                                 <entry>Layer B width</entry>
 499                                                                 <entry>Layer C width</entry>
 500                                                                 <entry>total width</entry>
 501                                                         </row>
 502
 503                                                         <row>
 504                                                                 <entry>0</entry>
 505                                                                 <entry>0</entry>
 506                                                                 <entry>1 .. 13</entry>
 507                                                                 <entry>1 .. 13</entry>
 508                                                                 <entry>1 .. 13</entry>
 509                                                                 <entry>13</entry>
 510                                                         </row>
 511
 512                                                         <row>
 513                                                                 <entry>1</entry>
 514                                                                 <entry>0</entry>
 515                                                                 <entry>1</entry>
 516                                                                 <entry>1 .. 13</entry>
 517                                                                 <entry>1 .. 13</entry>
 518                                                                 <entry>13</entry>
 519                                                         </row>
 520
 521                                                         <row>
 522                                                                 <entry>0</entry>
 523                                                                 <entry>1</entry>
 524                                                                 <entry>1</entry>
 525                                                                 <entry>0</entry>
 526                                                                 <entry>0</entry>
 527                                                                 <entry>1</entry>
 528                                                         </row>
 529
 530                                                         <row>
 531                                                                 <entry>1</entry>
 532                                                                 <entry>1</entry>
 533                                                                 <entry>1</entry>
 534                                                                 <entry>2</entry>
 535                                                                 <entry>0</entry>
 536                                                                 <entry>13</entry>
 537                                                         </row>
 538                                                 </tbody>
 539
 540                                         </tgroup>
 541                                 </informaltable>
 542
 543                         </section>
 544
 545                         <section id="isdbt_layer_t_interl">
 546                                 <title><constant>DTV_ISDBT_LAYER*_TIME_INTERLEAVING</constant></title>
 547
 548                                 <para>Possible values: 0, 1, 2, 3, -1 (AUTO)</para>
 549
 550                                 <para>Note: The real inter-leaver depth-names depend on the mode (fft-size); the values
 551                                         here are referring to what can be found in the TMCC-structure -
 552                                         independent of the mode.</para>
 553                         </section>
 554                 </section>
 555         </section>
 556 </section>
 557 </section>