52d5e3c7cf6c0dd96646b43c05aaa8d2dd97561b
[linux-2.6.git] / 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>