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