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>1712000</constant>,
 221                         <constant>5000000</constant>,
 222                         <constant>6000000</constant>,
 223                         <constant>7000000</constant>,
 224                         <constant>8000000</constant>,
 225                         <constant>10000000</constant>.
 226                 </para>
 227
 228                 <para>Notes:</para>
 229
 230                 <para>1) For ISDB-T it should be always 6000000Hz (6MHz)</para>
 231                 <para>2) For ISDB-Tsb it can vary depending on the number of connected segments</para>
 232                 <para>3) Bandwidth doesn't apply for DVB-C transmissions, as the bandwidth
 233                          for DVB-C depends on the symbol rate</para>
 234                 <para>4) Bandwidth in ISDB-T is fixed (6MHz) or can be easily derived from
 235                         other parameters (DTV_ISDBT_SB_SEGMENT_IDX,
 236                         DTV_ISDBT_SB_SEGMENT_COUNT).</para>
 237                 <para>5) DVB-T supports 6, 7 and 8MHz.</para>
 238                 <para>6) In addition, DVB-T2 supports 1.172, 5 and 10MHz.</para>
 239         </section>
 240
 241         <section id="DTV_DELIVERY_SYSTEM">
 242                 <title><constant>DTV_DELIVERY_SYSTEM</constant></title>
 243
 244                 <para>Specifies the type of Delivery system</para>
 245
 246                 <para>Possible values: </para>
 247 <programlisting>
 248 typedef enum fe_delivery_system {
 249         SYS_UNDEFINED,
 250         SYS_DVBC_ANNEX_AC,
 251         SYS_DVBC_ANNEX_B,
 252         SYS_DVBT,
 253         SYS_DSS,
 254         SYS_DVBS,
 255         SYS_DVBS2,
 256         SYS_DVBH,
 257         SYS_ISDBT,
 258         SYS_ISDBS,
 259         SYS_ISDBC,
 260         SYS_ATSC,
 261         SYS_ATSCMH,
 262         SYS_DMBTH,
 263         SYS_CMMB,
 264         SYS_DAB,
 265         SYS_DVBT2,
 266 } fe_delivery_system_t;
 267 </programlisting>
 268
 269         </section>
 270
 271         <section id="DTV_TRANSMISSION_MODE">
 272                 <title><constant>DTV_TRANSMISSION_MODE</constant></title>
 273
 274                 <para>Specifies the number of carriers used by the standard</para>
 275
 276                 <para>Possible values are:</para>
 277 <programlisting>
 278 typedef enum fe_transmit_mode {
 279         TRANSMISSION_MODE_2K,
 280         TRANSMISSION_MODE_8K,
 281         TRANSMISSION_MODE_AUTO,
 282         TRANSMISSION_MODE_4K,
 283         TRANSMISSION_MODE_1K,
 284         TRANSMISSION_MODE_16K,
 285         TRANSMISSION_MODE_32K,
 286 } fe_transmit_mode_t;
 287 </programlisting>
 288
 289                 <para>Notes:</para>
 290                 <para>1) ISDB-T supports three carrier/symbol-size: 8K, 4K, 2K. It is called
 291                         'mode' in the standard: Mode 1 is 2K, mode 2 is 4K, mode 3 is 8K</para>
 292
 293                 <para>2) If <constant>DTV_TRANSMISSION_MODE</constant> is set the <constant>TRANSMISSION_MODE_AUTO</constant> the
 294                         hardware will try to find the correct FFT-size (if capable) and will
 295                         use TMCC to fill in the missing parameters.</para>
 296                 <para>3) DVB-T specifies 2K and 8K as valid sizes.</para>
 297                 <para>4) DVB-T2 specifies 1K, 2K, 4K, 8K, 16K and 32K.</para>
 298         </section>
 299
 300         <section id="DTV_GUARD_INTERVAL">
 301                 <title><constant>DTV_GUARD_INTERVAL</constant></title>
 302
 303                 <para>Possible values are:</para>
 304 <programlisting>
 305 typedef enum fe_guard_interval {
 306         GUARD_INTERVAL_1_32,
 307         GUARD_INTERVAL_1_16,
 308         GUARD_INTERVAL_1_8,
 309         GUARD_INTERVAL_1_4,
 310         GUARD_INTERVAL_AUTO,
 311         GUARD_INTERVAL_1_128,
 312         GUARD_INTERVAL_19_128,
 313         GUARD_INTERVAL_19_256,
 314 } fe_guard_interval_t;
 315 </programlisting>
 316
 317                 <para>Notes:</para>
 318                 <para>1) If <constant>DTV_GUARD_INTERVAL</constant> is set the <constant>GUARD_INTERVAL_AUTO</constant> the hardware will
 319                         try to find the correct guard interval (if capable) and will use TMCC to fill
 320                         in the missing parameters.</para>
 321                 <para>2) Intervals 1/128, 19/128 and 19/256 are used only for DVB-T2 at present</para>
 322         </section>
 323 </section>
 324
 325 <section id="isdbt">
 326         <title>ISDB-T frontend</title>
 327         <para>This section describes shortly what are the possible parameters in the Linux
 328                 DVB-API called "S2API" and now DVB API 5 in order to tune an ISDB-T/ISDB-Tsb
 329                 demodulator:</para>
 330
 331         <para>This ISDB-T/ISDB-Tsb API extension should reflect all information
 332                 needed to tune any ISDB-T/ISDB-Tsb hardware. Of course it is possible
 333                 that some very sophisticated devices won't need certain parameters to
 334                 tune.</para>
 335
 336         <para>The information given here should help application writers to know how
 337                 to handle ISDB-T and ISDB-Tsb hardware using the Linux DVB-API.</para>
 338
 339         <para>The details given here about ISDB-T and ISDB-Tsb are just enough to
 340                 basically show the dependencies between the needed parameter values,
 341                 but surely some information is left out. For more detailed information
 342                 see the following documents:</para>
 343
 344         <para>ARIB STD-B31 - "Transmission System for Digital Terrestrial
 345                 Television Broadcasting" and</para>
 346         <para>ARIB TR-B14 - "Operational Guidelines for Digital Terrestrial
 347                 Television Broadcasting".</para>
 348
 349         <para>In order to read this document one has to have some knowledge the
 350                 channel structure in ISDB-T and ISDB-Tsb. I.e. it has to be known to
 351                 the reader that an ISDB-T channel consists of 13 segments, that it can
 352                 have up to 3 layer sharing those segments, and things like that.</para>
 353
 354         <para>Parameters used by ISDB-T and ISDB-Tsb.</para>
 355
 356         <section id="isdbt-new-parms">
 357                 <title>ISDB-T only parameters</title>
 358
 359                 <section id="isdbt-part-rec">
 360                         <title><constant>DTV_ISDBT_PARTIAL_RECEPTION</constant></title>
 361
 362                         <para><constant>If DTV_ISDBT_SOUND_BROADCASTING</constant> is '0' this bit-field represents whether
 363                                 the channel is in partial reception mode or not.</para>
 364
 365                         <para>If '1' <constant>DTV_ISDBT_LAYERA_*</constant> values are assigned to the center segment and
 366                                 <constant>DTV_ISDBT_LAYERA_SEGMENT_COUNT</constant> has to be '1'.</para>
 367
 368                         <para>If in addition <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'
 369                                 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> represents whether this ISDB-Tsb channel
 370                                 is consisting of one segment and layer or three segments and two layers.</para>
 371
 372                         <para>Possible values: 0, 1, -1 (AUTO)</para>
 373                 </section>
 374
 375                 <section id="isdbt-sound-bcast">
 376                         <title><constant>DTV_ISDBT_SOUND_BROADCASTING</constant></title>
 377
 378                         <para>This field represents whether the other DTV_ISDBT_*-parameters are
 379                                 referring to an ISDB-T and an ISDB-Tsb channel. (See also
 380                                 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>).</para>
 381
 382                         <para>Possible values: 0, 1, -1 (AUTO)</para>
 383                 </section>
 384
 385                 <section id="isdbt-sb-ch-id">
 386                         <title><constant>DTV_ISDBT_SB_SUBCHANNEL_ID</constant></title>
 387
 388                         <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
 389
 390                         <para>(Note of the author: This might not be the correct description of the
 391                                 <constant>SUBCHANNEL-ID</constant> in all details, but it is my understanding of the technical
 392                                 background needed to program a device)</para>
 393
 394                         <para>An ISDB-Tsb channel (1 or 3 segments) can be broadcasted alone or in a
 395                                 set of connected ISDB-Tsb channels. In this set of channels every
 396                                 channel can be received independently. The number of connected
 397                                 ISDB-Tsb segment can vary, e.g. depending on the frequency spectrum
 398                                 bandwidth available.</para>
 399
 400                         <para>Example: Assume 8 ISDB-Tsb connected segments are broadcasted. The
 401                                 broadcaster has several possibilities to put those channels in the
 402                                 air: Assuming a normal 13-segment ISDB-T spectrum he can align the 8
 403                                 segments from position 1-8 to 5-13 or anything in between.</para>
 404
 405                         <para>The underlying layer of segments are subchannels: each segment is
 406                                 consisting of several subchannels with a predefined IDs. A sub-channel
 407                                 is used to help the demodulator to synchronize on the channel.</para>
 408
 409                         <para>An ISDB-T channel is always centered over all sub-channels. As for
 410                                 the example above, in ISDB-Tsb it is no longer as simple as that.</para>
 411
 412                         <para><constant>The DTV_ISDBT_SB_SUBCHANNEL_ID</constant> parameter is used to give the
 413                                 sub-channel ID of the segment to be demodulated.</para>
 414
 415                         <para>Possible values: 0 .. 41, -1 (AUTO)</para>
 416                 </section>
 417
 418                 <section id="isdbt-sb-seg-idx">
 419
 420                         <title><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant></title>
 421
 422                         <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
 423
 424                         <para><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant> gives the index of the segment to be
 425                                 demodulated for an ISDB-Tsb channel where several of them are
 426                                 transmitted in the connected manner.</para>
 427
 428                         <para>Possible values: 0 .. <constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant> - 1</para>
 429
 430                         <para>Note: This value cannot be determined by an automatic channel search.</para>
 431                 </section>
 432
 433                 <section id="isdbt-sb-seg-cnt">
 434                         <title><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant></title>
 435
 436                         <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
 437
 438                         <para><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant> gives the total count of connected ISDB-Tsb
 439                                 channels.</para>
 440
 441                         <para>Possible values: 1 .. 13</para>
 442
 443                         <para>Note: This value cannot be determined by an automatic channel search.</para>
 444                 </section>
 445
 446                 <section id="isdb-hierq-layers">
 447                         <title>Hierarchical layers</title>
 448
 449                         <para>ISDB-T channels can be coded hierarchically. As opposed to DVB-T in
 450                                 ISDB-T hierarchical layers can be decoded simultaneously. For that
 451                                 reason a ISDB-T demodulator has 3 viterbi and 3 reed-solomon-decoders.</para>
 452
 453                         <para>ISDB-T has 3 hierarchical layers which each can use a part of the
 454                                 available segments. The total number of segments over all layers has
 455                                 to 13 in ISDB-T.</para>
 456
 457                         <section id="isdbt-layer-ena">
 458                                 <title><constant>DTV_ISDBT_LAYER_ENABLED</constant></title>
 459
 460                                 <para>Hierarchical reception in ISDB-T is achieved by enabling or disabling
 461                                         layers in the decoding process. Setting all bits of
 462                                         <constant>DTV_ISDBT_LAYER_ENABLED</constant> to '1' forces all layers (if applicable) to be
 463                                         demodulated. This is the default.</para>
 464
 465                                 <para>If the channel is in the partial reception mode
 466                                         (<constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> = 1) the central segment can be decoded
 467                                         independently of the other 12 segments. In that mode layer A has to
 468                                         have a <constant>SEGMENT_COUNT</constant> of 1.</para>
 469
 470                                 <para>In ISDB-Tsb only layer A is used, it can be 1 or 3 in ISDB-Tsb
 471                                         according to <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>. <constant>SEGMENT_COUNT</constant> must be filled
 472                                         accordingly.</para>
 473
 474                                 <para>Possible values: 0x1, 0x2, 0x4 (|-able)</para>
 475
 476                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[0:0]</constant> - layer A</para>
 477                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[1:1]</constant> - layer B</para>
 478                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[2:2]</constant> - layer C</para>
 479                                 <para><constant>DTV_ISDBT_LAYER_ENABLED[31:3]</constant> unused</para>
 480                         </section>
 481
 482                         <section id="isdbt-layer-fec">
 483                                 <title><constant>DTV_ISDBT_LAYER*_FEC</constant></title>
 484
 485                                 <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>
 486                         </section>
 487
 488                         <section id="isdbt-layer-mod">
 489                                 <title><constant>DTV_ISDBT_LAYER*_MODULATION</constant></title>
 490
 491                                 <para>Possible values: <constant>QAM_AUTO</constant>, QP<constant>SK, QAM_16</constant>, <constant>QAM_64</constant>, <constant>DQPSK</constant></para>
 492
 493                                 <para>Note: If layer C is <constant>DQPSK</constant> layer B has to be <constant>DQPSK</constant>. If layer B is <constant>DQPSK</constant>
 494                                         and <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>=0 layer has to be <constant>DQPSK</constant>.</para>
 495                         </section>
 496
 497                         <section id="isdbt-layer-seg-cnt">
 498                                 <title><constant>DTV_ISDBT_LAYER*_SEGMENT_COUNT</constant></title>
 499
 500                                 <para>Possible values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, -1 (AUTO)</para>
 501
 502                                 <para>Note: Truth table for <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> and
 503                                         <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> and <constant>LAYER</constant>*_SEGMENT_COUNT</para>
 504
 505                                 <informaltable id="isdbt-layer_seg-cnt-table">
 506                                         <tgroup cols="6">
 507
 508                                                 <tbody>
 509                                                         <row>
 510                                                                 <entry>PR</entry>
 511                                                                 <entry>SB</entry>
 512                                                                 <entry>Layer A width</entry>
 513                                                                 <entry>Layer B width</entry>
 514                                                                 <entry>Layer C width</entry>
 515                                                                 <entry>total width</entry>
 516                                                         </row>
 517
 518                                                         <row>
 519                                                                 <entry>0</entry>
 520                                                                 <entry>0</entry>
 521                                                                 <entry>1 .. 13</entry>
 522                                                                 <entry>1 .. 13</entry>
 523                                                                 <entry>1 .. 13</entry>
 524                                                                 <entry>13</entry>
 525                                                         </row>
 526
 527                                                         <row>
 528                                                                 <entry>1</entry>
 529                                                                 <entry>0</entry>
 530                                                                 <entry>1</entry>
 531                                                                 <entry>1 .. 13</entry>
 532                                                                 <entry>1 .. 13</entry>
 533                                                                 <entry>13</entry>
 534                                                         </row>
 535
 536                                                         <row>
 537                                                                 <entry>0</entry>
 538                                                                 <entry>1</entry>
 539                                                                 <entry>1</entry>
 540                                                                 <entry>0</entry>
 541                                                                 <entry>0</entry>
 542                                                                 <entry>1</entry>
 543                                                         </row>
 544
 545                                                         <row>
 546                                                                 <entry>1</entry>
 547                                                                 <entry>1</entry>
 548                                                                 <entry>1</entry>
 549                                                                 <entry>2</entry>
 550                                                                 <entry>0</entry>
 551                                                                 <entry>13</entry>
 552                                                         </row>
 553                                                 </tbody>
 554
 555                                         </tgroup>
 556                                 </informaltable>
 557
 558                         </section>
 559
 560                         <section id="isdbt_layer_t_interl">
 561                                 <title><constant>DTV_ISDBT_LAYER*_TIME_INTERLEAVING</constant></title>
 562
 563                                 <para>Possible values: 0, 1, 2, 3, -1 (AUTO)</para>
 564
 565                                 <para>Note: The real inter-leaver depth-names depend on the mode (fft-size); the values
 566                                         here are referring to what can be found in the TMCC-structure -
 567                                         independent of the mode.</para>
 568                         </section>
 569                 </section>
 570         </section>
 571         <section id="dvbt2-params">
 572                 <title>DVB-T2 parameters</title>
 573
 574                 <para>This section covers parameters that apply only to the DVB-T2 delivery method. DVB-T2
 575                         support is currently in the early stages development so expect this section to grow
 576                         and become more detailed with time.</para>
 577
 578                 <section id="dvbt2-plp-id">
 579                         <title><constant>DTV_DVBT2_PLP_ID</constant></title>
 580
 581                         <para>DVB-T2 supports Physical Layer Pipes (PLP) to allow transmission of
 582                                 many data types via a single multiplex. The API will soon support this
 583                                 at which point this section will be expanded.</para>
 584                 </section>
 585         </section>
 586 </section>
 587 </section>