projects / deliverable / linux.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
[media] DocBook: better document the DVB-S2 rolloff factor
[deliverable/linux.git] / Documentation / DocBook / media / dvb / dvbproperty.xml
CommitLineData
e4aa18d3
MCC		 1<section id="frontend-properties">
2<title>DVB Frontend properties</title>
3<para>Tuning into a Digital TV physical channel and starting decoding it
bf45caf2 4 requires changing a set of parameters, in order to control the
e4aa18d3 5 tuner, the demodulator, the Linear Low-noise Amplifier (LNA) and to set the
6fc1cb2e 6 antenna subsystem via Satellite Equipment Control (SEC), on satellite
e4aa18d3 7 systems. The actual parameters are specific to each particular digital
bf45caf2
MCC		 8 TV standards, and may change as the digital TV specs evolves.</para>
9<para>In the past, the strategy used was to have a union with the parameters
e4aa18d3
MCC		 10 needed to tune for DVB-S, DVB-C, DVB-T and ATSC delivery systems grouped
11 there. The problem is that, as the second generation standards appeared,
12 those structs were not big enough to contain the additional parameters.
13 Also, the union didn't have any space left to be expanded without breaking
14 userspace. So, the decision was to deprecate the legacy union/struct based
15 approach, in favor of a properties set approach.</para>
ac99edd2
MCC		 16
17<para>NOTE: on Linux DVB API version 3, setting a frontend were done via
18 <link linkend="dvb-frontend-parameters">struct <constant>dvb_frontend_parameters</constant></link>.
19 This got replaced on version 5 (also called "S2API", as this API were
20 added originally_enabled to provide support for DVB-S2), because the old
21 API has a very limited support to new standards and new hardware. This
22 section describes the new and recommended way to set the frontend, with
23 suppports all digital TV delivery systems.</para>
e3dae862 24
e4aa18d3
MCC		 25<para>Example: with the properties based approach, in order to set the tuner
26 to a DVB-C channel at 651 kHz, modulated with 256-QAM, FEC 3/4 and symbol
27 rate of 5.217 Mbauds, those properties should be sent to
28 <link linkend="FE_GET_PROPERTY"><constant>FE_SET_PROPERTY</constant></link> ioctl:</para>
29 <itemizedlist>
595d041a
HV		 30 <listitem><para>&DTV-DELIVERY-SYSTEM; = SYS_DVBC_ANNEX_A</para></listitem>
31 <listitem><para>&DTV-FREQUENCY; = 651000000</para></listitem>
32 <listitem><para>&DTV-MODULATION; = QAM_256</para></listitem>
33 <listitem><para>&DTV-INVERSION; = INVERSION_AUTO</para></listitem>
34 <listitem><para>&DTV-SYMBOL-RATE; = 5217000</para></listitem>
35 <listitem><para>&DTV-INNER-FEC; = FEC_3_4</para></listitem>
36 <listitem><para>&DTV-TUNE;</para></listitem>
e4aa18d3 37 </itemizedlist>
e3dae862
MCC		 38
39<para>The code that would do the above is:</para>
40<programlisting>
41#include &lt;stdio.h&gt;
42#include &lt;fcntl.h&gt;
43#include &lt;sys/ioctl.h&gt;
44#include &lt;linux/dvb/frontend.h&gt;
45
46static struct dtv_property props[] = {
47 { .cmd = DTV_DELIVERY_SYSTEM, .u.data = SYS_DVBC_ANNEX_A },
48 { .cmd = DTV_FREQUENCY, .u.data = 651000000 },
49 { .cmd = DTV_MODULATION, .u.data = QAM_256 },
50 { .cmd = DTV_INVERSION, .u.data = INVERSION_AUTO },
51 { .cmd = DTV_SYMBOL_RATE, .u.data = 5217000 },
52 { .cmd = DTV_INNER_FEC, .u.data = FEC_3_4 },
53 { .cmd = DTV_TUNE }
54};
55
56static struct dtv_properties dtv_prop = {
57 .num = 6, .props = props
58};
59
60int main(void)
61{
62 int fd = open("/dev/dvb/adapter0/frontend0", O_RDWR);
63
64 if (!fd) {
65 perror ("open");
66 return -1;
67 }
68 if (ioctl(fd, FE_SET_PROPERTY, &amp;dtv_prop) == -1) {
69 perror("ioctl");
70 return -1;
71 }
72 printf("Frontend set\n");
73 return 0;
74}
75</programlisting>
ac99edd2
MCC		 76
77<para>NOTE: While it is possible to directly call the Kernel code like the
78 above example, it is strongly recommended to use
79 <ulink url="http://linuxtv.org/docs/libdvbv5/index.html">libdvbv5</ulink>,
80 as it provides abstraction to work with the supported digital TV standards
81 and provides methods for usual operations like program scanning and to
82 read/write channel descriptor files.</para>
ffec8bce 83
9569793a 84<section id="dtv-stats">
38fbb986 85<title>struct <structname>dtv_stats</structname></title>
9569793a
MCC		 86<programlisting>
87struct dtv_stats {
88 __u8 scale; /* enum fecap_scale_params type */
89 union {
90 __u64 uvalue; /* for counters and relative scales */
91 __s64 svalue; /* for 1/1000 dB measures */
92 };
93} __packed;
94</programlisting>
95</section>
96<section id="dtv-fe-stats">
38fbb986 97<title>struct <structname>dtv_fe_stats</structname></title>
9569793a
MCC		 98<programlisting>
99#define MAX_DTV_STATS 4
100
101struct dtv_fe_stats {
102 __u8 len;
38fbb986 103 &dtv-stats; stat[MAX_DTV_STATS];
9569793a
MCC		 104} __packed;
105</programlisting>
106</section>
107
3272c3ec 108<section id="dtv-property">
38fbb986 109<title>struct <structname>dtv_property</structname></title>
0ed08b49
MCC		 110<programlisting>
111/* Reserved fields should be set to 0 */
9569793a 112
0ed08b49
MCC		 113struct dtv_property {
114 __u32 cmd;
9569793a 115 __u32 reserved[3];
0ed08b49
MCC		 116 union {
117 __u32 data;
38fbb986 118 &dtv-fe-stats; st;
0ed08b49
MCC		 119 struct {
120 __u8 data[32];
121 __u32 len;
122 __u32 reserved1[3];
123 void *reserved2;
124 } buffer;
125 } u;
126 int result;
127} __attribute__ ((packed));
128
129/* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
130#define DTV_IOCTL_MAX_MSGS 64
3272c3ec
MCC		 131</programlisting>
132</section>
133<section id="dtv-properties">
38fbb986 134<title>struct <structname>dtv_properties</structname></title>
3272c3ec 135<programlisting>
0ed08b49
MCC		 136struct dtv_properties {
137 __u32 num;
38fbb986 138 &dtv-property; *props;
0ed08b49
MCC		 139};
140</programlisting>
3272c3ec 141</section>
0ed08b49 142
5f1e1586
HV		 143<section>
144 <title>Property types</title>
0ed08b49 145<para>
277dfcb4 146On <link linkend="FE_GET_PROPERTY">FE_GET_PROPERTY and FE_SET_PROPERTY</link>,
0ed08b49
MCC		 147the actual action is determined by the dtv_property cmd/data pairs. With one single ioctl, is possible to
148get/set up to 64 properties. The actual meaning of each property is described on the next sections.
149</para>
150
994e262e 151<para>The available frontend property types are shown on the next section.</para>
5f1e1586 152</section>
0ed08b49 153
17d8bb06
MCC		 154<section id="fe_property_parameters">
155 <title>Digital TV property parameters</title>
04a92077
MCC		 156 <section id="DTV-UNDEFINED">
157 <title><constant>DTV_UNDEFINED</constant></title>
158 <para>Used internally. A GET/SET operation for it won't change or return anything.</para>
159 </section>
160 <section id="DTV-TUNE">
161 <title><constant>DTV_TUNE</constant></title>
162 <para>Interpret the cache of data, build either a traditional frontend tunerequest so we can pass validation in the <constant>FE_SET_FRONTEND</constant> ioctl.</para>
163 </section>
164 <section id="DTV-CLEAR">
165 <title><constant>DTV_CLEAR</constant></title>
166 <para>Reset a cache of data specific to the frontend here. This does not effect hardware.</para>
167 </section>
17d8bb06
MCC		 168 <section id="DTV-FREQUENCY">
169 <title><constant>DTV_FREQUENCY</constant></title>
170
a34e2a78 171 <para>Central frequency of the channel.</para>
17d8bb06
MCC		 172
173 <para>Notes:</para>
6fc1cb2e 174 <para>1)For satellite delivery systems, it is measured in kHz.
a34e2a78
MCC		 175 For the other ones, it is measured in Hz.</para>
176 <para>2)For ISDB-T, the channels are usually transmitted with an offset of 143kHz.
c4d28cc7 177 E.g. a valid frequency could be 474143 kHz. The stepping is bound to the bandwidth of
17d8bb06
MCC		 178 the channel which is 6MHz.</para>
179
a34e2a78 180 <para>3)As in ISDB-Tsb the channel consists of only one or three segments the
17d8bb06
MCC		 181 frequency step is 429kHz, 3*429 respectively. As for ISDB-T the
182 central frequency of the channel is expected.</para>
183 </section>
04a92077
MCC		 184 <section id="DTV-MODULATION">
185 <title><constant>DTV_MODULATION</constant></title>
997eb903
MCC		 186<para>Specifies the frontend modulation type for delivery systems that supports
187 more than one modulation type. The modulation can be one of the types
188 defined by &fe-modulation;.</para>
189
190
191<section id="fe-modulation-t">
192<title>Modulation property</title>
193
194<para>Most of the digital TV standards currently offers more than one possible
195 modulation (sometimes called as "constellation" on some standards). This
7832a915 196 enum contains the values used by the Kernel. Please note that not all
997eb903
MCC		 197 modulations are supported by a given standard.</para>
198
199<table pgwide="1" frame="none" id="fe-modulation">
200 <title>enum fe_modulation</title>
201 <tgroup cols="2">
202 &cs-def;
203 <thead>
204 <row>
205 <entry>ID</entry>
206 <entry>Description</entry>
207 </row>
208 </thead>
209 <tbody valign="top">
210 <row>
00c91dfd 211 <entry id="QPSK"><constant>QPSK</constant></entry>
997eb903
MCC		 212 <entry>QPSK modulation</entry>
213 </row><row>
00c91dfd 214 <entry id="QAM-16"><constant>QAM_16</constant></entry>
997eb903
MCC		 215 <entry>16-QAM modulation</entry>
216 </row><row>
00c91dfd 217 <entry id="QAM-32"><constant>QAM_32</constant></entry>
997eb903
MCC		 218 <entry>32-QAM modulation</entry>
219 </row><row>
00c91dfd 220 <entry id="QAM-64"><constant>QAM_64</constant></entry>
997eb903
MCC		 221 <entry>64-QAM modulation</entry>
222 </row><row>
00c91dfd 223 <entry id="QAM-128"><constant>QAM_128</constant></entry>
997eb903
MCC		 224 <entry>128-QAM modulation</entry>
225 </row><row>
00c91dfd 226 <entry id="QAM-256"><constant>QAM_256</constant></entry>
997eb903
MCC		 227 <entry>256-QAM modulation</entry>
228 </row><row>
00c91dfd 229 <entry id="QAM-AUTO"><constant>QAM_AUTO</constant></entry>
997eb903
MCC		 230 <entry>Autodetect QAM modulation</entry>
231 </row><row>
00c91dfd 232 <entry id="VSB-8"><constant>VSB_8</constant></entry>
997eb903
MCC		 233 <entry>8-VSB modulation</entry>
234 </row><row>
00c91dfd 235 <entry id="VSB-16"><constant>VSB_16</constant></entry>
997eb903
MCC		 236 <entry>16-VSB modulation</entry>
237 </row><row>
00c91dfd 238 <entry id="PSK-8"><constant>PSK_8</constant></entry>
997eb903
MCC		 239 <entry>8-PSK modulation</entry>
240 </row><row>
00c91dfd 241 <entry id="APSK-16"><constant>APSK_16</constant></entry>
997eb903
MCC		 242 <entry>16-APSK modulation</entry>
243 </row><row>
00c91dfd 244 <entry id="APSK-32"><constant>APSK_32</constant></entry>
997eb903
MCC		 245 <entry>32-APSK modulation</entry>
246 </row><row>
00c91dfd 247 <entry id="DQPSK"><constant>DQPSK</constant></entry>
997eb903
MCC		 248 <entry>DQPSK modulation</entry>
249 </row><row>
00c91dfd 250 <entry id="QAM-4-NR"><constant>QAM_4_NR</constant></entry>
997eb903
MCC		 251 <entry>4-QAM-NR modulation</entry>
252 </row>
253 </tbody>
254 </tgroup>
255</table>
256</section>
257
04a92077 258 </section>
17d8bb06
MCC		 259 <section id="DTV-BANDWIDTH-HZ">
260 <title><constant>DTV_BANDWIDTH_HZ</constant></title>
261
262 <para>Bandwidth for the channel, in HZ.</para>
263
264 <para>Possible values:
265 <constant>1712000</constant>,
266 <constant>5000000</constant>,
267 <constant>6000000</constant>,
268 <constant>7000000</constant>,
269 <constant>8000000</constant>,
270 <constant>10000000</constant>.
271 </para>
272
273 <para>Notes:</para>
274
275 <para>1) For ISDB-T it should be always 6000000Hz (6MHz)</para>
276 <para>2) For ISDB-Tsb it can vary depending on the number of connected segments</para>
277 <para>3) Bandwidth doesn't apply for DVB-C transmissions, as the bandwidth
278 for DVB-C depends on the symbol rate</para>
279 <para>4) Bandwidth in ISDB-T is fixed (6MHz) or can be easily derived from
280 other parameters (DTV_ISDBT_SB_SEGMENT_IDX,
281 DTV_ISDBT_SB_SEGMENT_COUNT).</para>
282 <para>5) DVB-T supports 6, 7 and 8MHz.</para>
283 <para>6) In addition, DVB-T2 supports 1.172, 5 and 10MHz.</para>
284 </section>
04a92077
MCC		 285 <section id="DTV-INVERSION">
286 <title><constant>DTV_INVERSION</constant></title>
58e11cc3
MCC		 287
288 <para>Specifies if the frontend should do spectral inversion or not.</para>
289
290<section id="fe-spectral-inversion-t">
291<title>enum fe_modulation: Frontend spectral inversion</title>
292
293<para>This parameter indicates if spectral inversion should be presumed or not.
294 In the automatic setting (<constant>INVERSION_AUTO</constant>) the hardware
295 will try to figure out the correct setting by itself. If the hardware
296 doesn't support, the DVB core will try to lock at the carrier first with
297 inversion off. If it fails, it will try to enable inversion.
298</para>
299
300<table pgwide="1" frame="none" id="fe-spectral-inversion">
301 <title>enum fe_modulation</title>
302 <tgroup cols="2">
303 &cs-def;
304 <thead>
305 <row>
306 <entry>ID</entry>
307 <entry>Description</entry>
308 </row>
309 </thead>
310 <tbody valign="top">
311 <row>
00c91dfd 312 <entry id="INVERSION-OFF"><constant>INVERSION_OFF</constant></entry>
58e11cc3
MCC		 313 <entry>Don't do spectral band inversion.</entry>
314 </row><row>
00c91dfd 315 <entry id="INVERSION-ON"><constant>INVERSION_ON</constant></entry>
58e11cc3
MCC		 316 <entry>Do spectral band inversion.</entry>
317 </row><row>
00c91dfd 318 <entry id="INVERSION-AUTO"><constant>INVERSION_AUTO</constant></entry>
58e11cc3
MCC		 319 <entry>Autodetect spectral band inversion.</entry>
320 </row>
321 </tbody>
322 </tgroup>
323</table>
324</section>
325
04a92077
MCC		 326 </section>
327 <section id="DTV-DISEQC-MASTER">
328 <title><constant>DTV_DISEQC_MASTER</constant></title>
329 <para>Currently not implemented.</para>
330 </section>
331 <section id="DTV-SYMBOL-RATE">
332 <title><constant>DTV_SYMBOL_RATE</constant></title>
333 <para>Digital TV symbol rate, in bauds (symbols/second). Used on cable standards.</para>
334 </section>
335 <section id="DTV-INNER-FEC">
336 <title><constant>DTV_INNER_FEC</constant></title>
337 <para>Used cable/satellite transmissions. The acceptable values are:
338 </para>
2d457b8a
MCC		 339<section id="fe-code-rate-t">
340<title>enum fe_code_rate: type of the Forward Error Correction.</title>
341
342<table pgwide="1" frame="none" id="fe-code-rate">
343 <title>enum fe_code_rate</title>
344 <tgroup cols="2">
345 &cs-def;
346 <thead>
347 <row>
348 <entry>ID</entry>
349 <entry>Description</entry>
350 </row>
351 </thead>
352 <tbody valign="top">
353 <row>
00c91dfd 354 <entry id="FEC-NONE"><constant>FEC_NONE</constant></entry>
2d457b8a
MCC		 355 <entry>No Forward Error Correction Code</entry>
356 </row><row>
00c91dfd 357 <entry id="FEC-AUTO"><constant>FEC_AUTO</constant></entry>
2d457b8a
MCC		 358 <entry>Autodetect Error Correction Code</entry>
359 </row><row>
00c91dfd 360 <entry id="FEC-1-2"><constant>FEC_1_2</constant></entry>
2d457b8a
MCC		 361 <entry>Forward Error Correction Code 1/2</entry>
362 </row><row>
00c91dfd 363 <entry id="FEC-2-3"><constant>FEC_2_3</constant></entry>
2d457b8a
MCC		 364 <entry>Forward Error Correction Code 2/3</entry>
365 </row><row>
00c91dfd 366 <entry id="FEC-3-4"><constant>FEC_3_4</constant></entry>
2d457b8a
MCC		 367 <entry>Forward Error Correction Code 3/4</entry>
368 </row><row>
00c91dfd 369 <entry id="FEC-4-5"><constant>FEC_4_5</constant></entry>
2d457b8a
MCC		 370 <entry>Forward Error Correction Code 4/5</entry>
371 </row><row>
00c91dfd 372 <entry id="FEC-5-6"><constant>FEC_5_6</constant></entry>
2d457b8a
MCC		 373 <entry>Forward Error Correction Code 5/6</entry>
374 </row><row>
00c91dfd 375 <entry id="FEC-6-7"><constant>FEC_6_7</constant></entry>
2d457b8a
MCC		 376 <entry>Forward Error Correction Code 6/7</entry>
377 </row><row>
00c91dfd 378 <entry id="FEC-7-8"><constant>FEC_7_8</constant></entry>
2d457b8a
MCC		 379 <entry>Forward Error Correction Code 7/8</entry>
380 </row><row>
00c91dfd 381 <entry id="FEC-8-9"><constant>FEC_8_9</constant></entry>
2d457b8a
MCC		 382 <entry>Forward Error Correction Code 8/9</entry>
383 </row><row>
00c91dfd 384 <entry id="FEC-9-10"><constant>FEC_9_10</constant></entry>
2d457b8a
MCC		 385 <entry>Forward Error Correction Code 9/10</entry>
386 </row><row>
00c91dfd 387 <entry id="FEC-2-5"><constant>FEC_2_5</constant></entry>
2d457b8a
MCC		 388 <entry>Forward Error Correction Code 2/5</entry>
389 </row><row>
00c91dfd 390 <entry id="FEC-3-5"><constant>FEC_3_5</constant></entry>
2d457b8a 391 <entry>Forward Error Correction Code 3/5</entry>
2d457b8a
MCC		 392 </row>
393 </tbody>
394 </tgroup>
395</table>
396</section>
04a92077
MCC		 397 </section>
398 <section id="DTV-VOLTAGE">
399 <title><constant>DTV_VOLTAGE</constant></title>
400 <para>The voltage is usually used with non-DiSEqC capable LNBs to switch
401 the polarzation (horizontal/vertical). When using DiSEqC epuipment this
402 voltage has to be switched consistently to the DiSEqC commands as
403 described in the DiSEqC spec.</para>
ff50574c
MCC		 404
405<table pgwide="1" frame="none" id="fe-sec-voltage">
406 <title id="fe-sec-voltage-t">enum fe_sec_voltage</title>
407 <tgroup cols="2">
408 &cs-def;
409 <thead>
410 <row>
411 <entry>ID</entry>
412 <entry>Description</entry>
413 </row>
414 </thead>
415 <tbody valign="top">
416 <row>
417 <entry align="char" id="SEC-VOLTAGE-13"><constant>SEC_VOLTAGE_13</constant></entry>
418 <entry align="char">Set DC voltage level to 13V</entry>
419 </row><row>
420 <entry align="char" id="SEC-VOLTAGE-18"><constant>SEC_VOLTAGE_18</constant></entry>
421 <entry align="char">Set DC voltage level to 18V</entry>
422 </row><row>
423 <entry align="char" id="SEC-VOLTAGE-OFF"><constant>SEC_VOLTAGE_OFF</constant></entry>
424 <entry align="char">Don't send any voltage to the antenna</entry>
425 </row>
426 </tbody>
427 </tgroup>
428</table>
04a92077
MCC		 429 </section>
430 <section id="DTV-TONE">
431 <title><constant>DTV_TONE</constant></title>
432 <para>Currently not used.</para>
433 </section>
434 <section id="DTV-PILOT">
435 <title><constant>DTV_PILOT</constant></title>
436 <para>Sets DVB-S2 pilot</para>
437 <section id="fe-pilot-t">
438 <title>fe_pilot type</title>
448bac10
MCC		 439<table pgwide="1" frame="none" id="fe-pilot">
440 <title>enum fe_pilot</title>
441 <tgroup cols="2">
442 &cs-def;
443 <thead>
444 <row>
445 <entry>ID</entry>
446 <entry>Description</entry>
447 </row>
448 </thead>
449 <tbody valign="top">
450 <row>
451 <entry align="char" id="PILOT-ON"><constant>PILOT_ON</constant></entry>
452 <entry align="char">Pilot tones enabled</entry>
453 </row><row>
454 <entry align="char" id="PILOT-OFF"><constant>PILOT_OFF</constant></entry>
455 <entry align="char">Pilot tones disabled</entry>
456 </row><row>
457 <entry align="char" id="PILOT-AUTO"><constant>PILOT_AUTO</constant></entry>
458 <entry align="char">Autodetect pilot tones</entry>
459 </row>
460 </tbody>
461 </tgroup>
462</table>
04a92077
MCC		 463 </section>
464 </section>
465 <section id="DTV-ROLLOFF">
466 <title><constant>DTV_ROLLOFF</constant></title>
467 <para>Sets DVB-S2 rolloff</para>
468
469 <section id="fe-rolloff-t">
470 <title>fe_rolloff type</title>
b35f6ba9
MCC		 471<table pgwide="1" frame="none" id="fe-rolloff">
472 <title>enum fe_rolloff</title>
473 <tgroup cols="2">
474 &cs-def;
475 <thead>
476 <row>
477 <entry>ID</entry>
478 <entry>Description</entry>
479 </row>
480 </thead>
481 <tbody valign="top">
482 <row>
483 <entry align="char" id="ROLLOFF-35"><constant>ROLLOFF_35</constant></entry>
484 <entry align="char">Roloff factor: &alpha;=35%</entry>
485 </row><row>
486 <entry align="char" id="ROLLOFF-20"><constant>ROLLOFF_20</constant></entry>
487 <entry align="char">Roloff factor: &alpha;=20%</entry>
488 </row><row>
489 <entry align="char" id="ROLLOFF-25"><constant>ROLLOFF_25</constant></entry>
490 <entry align="char">Roloff factor: &alpha;=25%</entry>
491 </row><row>
492 <entry align="char" id="ROLLOFF-AUTO"><constant>ROLLOFF_AUTO</constant></entry>
493 <entry align="char">Auto-detect the roloff factor.</entry>
494 </row>
495 </tbody>
496 </tgroup>
497</table>
04a92077
MCC		 498 </section>
499 </section>
500 <section id="DTV-DISEQC-SLAVE-REPLY">
501 <title><constant>DTV_DISEQC_SLAVE_REPLY</constant></title>
502 <para>Currently not implemented.</para>
503 </section>
504 <section id="DTV-FE-CAPABILITY-COUNT">
505 <title><constant>DTV_FE_CAPABILITY_COUNT</constant></title>
506 <para>Currently not implemented.</para>
507 </section>
508 <section id="DTV-FE-CAPABILITY">
509 <title><constant>DTV_FE_CAPABILITY</constant></title>
510 <para>Currently not implemented.</para>
511 </section>
17d8bb06
MCC		 512 <section id="DTV-DELIVERY-SYSTEM">
513 <title><constant>DTV_DELIVERY_SYSTEM</constant></title>
514 <para>Specifies the type of Delivery system</para>
515 <section id="fe-delivery-system-t">
516 <title>fe_delivery_system type</title>
517 <para>Possible values: </para>
518<programlisting>
669a4ba4 519
17d8bb06
MCC		 520typedef enum fe_delivery_system {
521 SYS_UNDEFINED,
669a4ba4 522 SYS_DVBC_ANNEX_A,
17d8bb06
MCC		 523 SYS_DVBC_ANNEX_B,
524 SYS_DVBT,
525 SYS_DSS,
526 SYS_DVBS,
527 SYS_DVBS2,
528 SYS_DVBH,
529 SYS_ISDBT,
530 SYS_ISDBS,
531 SYS_ISDBC,
532 SYS_ATSC,
533 SYS_ATSCMH,
224b6642 534 SYS_DTMB,
17d8bb06
MCC		 535 SYS_CMMB,
536 SYS_DAB,
537 SYS_DVBT2,
83dc314b 538 SYS_TURBO,
669a4ba4 539 SYS_DVBC_ANNEX_C,
17d8bb06
MCC		 540} fe_delivery_system_t;
541</programlisting>
542 </section>
543 </section>
544 <section id="DTV-ISDBT-PARTIAL-RECEPTION">
545 <title><constant>DTV_ISDBT_PARTIAL_RECEPTION</constant></title>
546
547 <para>If <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '0' this bit-field represents whether
548 the channel is in partial reception mode or not.</para>
549
550 <para>If '1' <constant>DTV_ISDBT_LAYERA_*</constant> values are assigned to the center segment and
551 <constant>DTV_ISDBT_LAYERA_SEGMENT_COUNT</constant> has to be '1'.</para>
552
553 <para>If in addition <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'
554 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> represents whether this ISDB-Tsb channel
555 is consisting of one segment and layer or three segments and two layers.</para>
556
557 <para>Possible values: 0, 1, -1 (AUTO)</para>
558 </section>
559 <section id="DTV-ISDBT-SOUND-BROADCASTING">
560 <title><constant>DTV_ISDBT_SOUND_BROADCASTING</constant></title>
561
562 <para>This field represents whether the other DTV_ISDBT_*-parameters are
563 referring to an ISDB-T and an ISDB-Tsb channel. (See also
564 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>).</para>
565
566 <para>Possible values: 0, 1, -1 (AUTO)</para>
567 </section>
568 <section id="DTV-ISDBT-SB-SUBCHANNEL-ID">
569 <title><constant>DTV_ISDBT_SB_SUBCHANNEL_ID</constant></title>
570
571 <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
572
573 <para>(Note of the author: This might not be the correct description of the
574 <constant>SUBCHANNEL-ID</constant> in all details, but it is my understanding of the technical
575 background needed to program a device)</para>
576
577 <para>An ISDB-Tsb channel (1 or 3 segments) can be broadcasted alone or in a
578 set of connected ISDB-Tsb channels. In this set of channels every
579 channel can be received independently. The number of connected
580 ISDB-Tsb segment can vary, e.g. depending on the frequency spectrum
581 bandwidth available.</para>
582
583 <para>Example: Assume 8 ISDB-Tsb connected segments are broadcasted. The
584 broadcaster has several possibilities to put those channels in the
585 air: Assuming a normal 13-segment ISDB-T spectrum he can align the 8
586 segments from position 1-8 to 5-13 or anything in between.</para>
587
588 <para>The underlying layer of segments are subchannels: each segment is
589 consisting of several subchannels with a predefined IDs. A sub-channel
590 is used to help the demodulator to synchronize on the channel.</para>
591
592 <para>An ISDB-T channel is always centered over all sub-channels. As for
593 the example above, in ISDB-Tsb it is no longer as simple as that.</para>
594
595 <para><constant>The DTV_ISDBT_SB_SUBCHANNEL_ID</constant> parameter is used to give the
596 sub-channel ID of the segment to be demodulated.</para>
597
598 <para>Possible values: 0 .. 41, -1 (AUTO)</para>
599 </section>
600 <section id="DTV-ISDBT-SB-SEGMENT-IDX">
601 <title><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant></title>
602 <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
603 <para><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant> gives the index of the segment to be
604 demodulated for an ISDB-Tsb channel where several of them are
605 transmitted in the connected manner.</para>
606 <para>Possible values: 0 .. <constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant> - 1</para>
607 <para>Note: This value cannot be determined by an automatic channel search.</para>
608 </section>
609 <section id="DTV-ISDBT-SB-SEGMENT-COUNT">
610 <title><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant></title>
611 <para>This field only applies if <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> is '1'.</para>
612 <para><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant> gives the total count of connected ISDB-Tsb
613 channels.</para>
614 <para>Possible values: 1 .. 13</para>
615 <para>Note: This value cannot be determined by an automatic channel search.</para>
616 </section>
617 <section id="isdb-hierq-layers">
446c18fc 618 <title><constant>DTV-ISDBT-LAYER*</constant> parameters</title>
17d8bb06
MCC		 619 <para>ISDB-T channels can be coded hierarchically. As opposed to DVB-T in
620 ISDB-T hierarchical layers can be decoded simultaneously. For that
9569793a 621 reason a ISDB-T demodulator has 3 Viterbi and 3 Reed-Solomon decoders.</para>
17d8bb06
MCC		 622 <para>ISDB-T has 3 hierarchical layers which each can use a part of the
623 available segments. The total number of segments over all layers has
624 to 13 in ISDB-T.</para>
446c18fc 625 <para>There are 3 parameter sets, for Layers A, B and C.</para>
17d8bb06
MCC		 626 <section id="DTV-ISDBT-LAYER-ENABLED">
627 <title><constant>DTV_ISDBT_LAYER_ENABLED</constant></title>
628 <para>Hierarchical reception in ISDB-T is achieved by enabling or disabling
629 layers in the decoding process. Setting all bits of
630 <constant>DTV_ISDBT_LAYER_ENABLED</constant> to '1' forces all layers (if applicable) to be
631 demodulated. This is the default.</para>
632 <para>If the channel is in the partial reception mode
633 (<constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> = 1) the central segment can be decoded
634 independently of the other 12 segments. In that mode layer A has to
635 have a <constant>SEGMENT_COUNT</constant> of 1.</para>
636 <para>In ISDB-Tsb only layer A is used, it can be 1 or 3 in ISDB-Tsb
637 according to <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>. <constant>SEGMENT_COUNT</constant> must be filled
638 accordingly.</para>
639 <para>Possible values: 0x1, 0x2, 0x4 (|-able)</para>
640 <para><constant>DTV_ISDBT_LAYER_ENABLED[0:0]</constant> - layer A</para>
641 <para><constant>DTV_ISDBT_LAYER_ENABLED[1:1]</constant> - layer B</para>
642 <para><constant>DTV_ISDBT_LAYER_ENABLED[2:2]</constant> - layer C</para>
643 <para><constant>DTV_ISDBT_LAYER_ENABLED[31:3]</constant> unused</para>
644 </section>
645 <section id="DTV-ISDBT-LAYER-FEC">
646 <title><constant>DTV_ISDBT_LAYER*_FEC</constant></title>
647 <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>
648 </section>
649 <section id="DTV-ISDBT-LAYER-MODULATION">
650 <title><constant>DTV_ISDBT_LAYER*_MODULATION</constant></title>
651 <para>Possible values: <constant>QAM_AUTO</constant>, QP<constant>SK, QAM_16</constant>, <constant>QAM_64</constant>, <constant>DQPSK</constant></para>
652 <para>Note: If layer C is <constant>DQPSK</constant> layer B has to be <constant>DQPSK</constant>. If layer B is <constant>DQPSK</constant>
653 and <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant>=0 layer has to be <constant>DQPSK</constant>.</para>
654 </section>
655 <section id="DTV-ISDBT-LAYER-SEGMENT-COUNT">
656 <title><constant>DTV_ISDBT_LAYER*_SEGMENT_COUNT</constant></title>
657 <para>Possible values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, -1 (AUTO)</para>
658 <para>Note: Truth table for <constant>DTV_ISDBT_SOUND_BROADCASTING</constant> and
659 <constant>DTV_ISDBT_PARTIAL_RECEPTION</constant> and <constant>LAYER</constant>*_SEGMENT_COUNT</para>
660 <informaltable id="isdbt-layer_seg-cnt-table">
661 <tgroup cols="6">
662 <tbody>
663 <row>
664 <entry>PR</entry>
665 <entry>SB</entry>
666 <entry>Layer A width</entry>
667 <entry>Layer B width</entry>
668 <entry>Layer C width</entry>
669 <entry>total width</entry>
670 </row>
671 <row>
672 <entry>0</entry>
673 <entry>0</entry>
674 <entry>1 .. 13</entry>
675 <entry>1 .. 13</entry>
676 <entry>1 .. 13</entry>
677 <entry>13</entry>
678 </row>
679 <row>
680 <entry>1</entry>
681 <entry>0</entry>
682 <entry>1</entry>
683 <entry>1 .. 13</entry>
684 <entry>1 .. 13</entry>
685 <entry>13</entry>
686 </row>
687 <row>
688 <entry>0</entry>
689 <entry>1</entry>
690 <entry>1</entry>
691 <entry>0</entry>
692 <entry>0</entry>
693 <entry>1</entry>
694 </row>
695 <row>
696 <entry>1</entry>
697 <entry>1</entry>
698 <entry>1</entry>
699 <entry>2</entry>
700 <entry>0</entry>
701 <entry>13</entry>
702 </row>
703 </tbody>
704 </tgroup>
705 </informaltable>
706 </section>
707 <section id="DTV-ISDBT-LAYER-TIME-INTERLEAVING">
708 <title><constant>DTV_ISDBT_LAYER*_TIME_INTERLEAVING</constant></title>
18b258d6
MCC		 709 <para>Valid values: 0, 1, 2, 4, -1 (AUTO)</para>
710 <para>when DTV_ISDBT_SOUND_BROADCASTING is active, value 8 is also valid.</para>
711 <para>Note: The real time interleaving length depends on the mode (fft-size). The values
712 here are referring to what can be found in the TMCC-structure, as shown in the table below.</para>
713 <informaltable id="isdbt-layer-interleaving-table">
714 <tgroup cols="4" align="center">
715 <tbody>
716 <row>
717 <entry>DTV_ISDBT_LAYER*_TIME_INTERLEAVING</entry>
718 <entry>Mode 1 (2K FFT)</entry>
719 <entry>Mode 2 (4K FFT)</entry>
720 <entry>Mode 3 (8K FFT)</entry>
721 </row>
722 <row>
723 <entry>0</entry>
724 <entry>0</entry>
725 <entry>0</entry>
726 <entry>0</entry>
727 </row>
728 <row>
729 <entry>1</entry>
730 <entry>4</entry>
731 <entry>2</entry>
732 <entry>1</entry>
733 </row>
734 <row>
735 <entry>2</entry>
736 <entry>8</entry>
737 <entry>4</entry>
738 <entry>2</entry>
739 </row>
740 <row>
741 <entry>4</entry>
742 <entry>16</entry>
743 <entry>8</entry>
744 <entry>4</entry>
745 </row>
746 </tbody>
747 </tgroup>
748 </informaltable>
17d8bb06 749 </section>
edaa136d
MK		 750 <section id="DTV-ATSCMH-FIC-VER">
751 <title><constant>DTV_ATSCMH_FIC_VER</constant></title>
752 <para>Version number of the FIC (Fast Information Channel) signaling data.</para>
753 <para>FIC is used for relaying information to allow rapid service acquisition by the receiver.</para>
754 <para>Possible values: 0, 1, 2, 3, ..., 30, 31</para>
755 </section>
756 <section id="DTV-ATSCMH-PARADE-ID">
757 <title><constant>DTV_ATSCMH_PARADE_ID</constant></title>
758 <para>Parade identification number</para>
759 <para>A parade is a collection of up to eight MH groups, conveying one or two ensembles.</para>
760 <para>Possible values: 0, 1, 2, 3, ..., 126, 127</para>
761 </section>
762 <section id="DTV-ATSCMH-NOG">
763 <title><constant>DTV_ATSCMH_NOG</constant></title>
764 <para>Number of MH groups per MH subframe for a designated parade.</para>
765 <para>Possible values: 1, 2, 3, 4, 5, 6, 7, 8</para>
766 </section>
767 <section id="DTV-ATSCMH-TNOG">
768 <title><constant>DTV_ATSCMH_TNOG</constant></title>
769 <para>Total number of MH groups including all MH groups belonging to all MH parades in one MH subframe.</para>
770 <para>Possible values: 0, 1, 2, 3, ..., 30, 31</para>
771 </section>
772 <section id="DTV-ATSCMH-SGN">
773 <title><constant>DTV_ATSCMH_SGN</constant></title>
774 <para>Start group number.</para>
775 <para>Possible values: 0, 1, 2, 3, ..., 14, 15</para>
776 </section>
777 <section id="DTV-ATSCMH-PRC">
778 <title><constant>DTV_ATSCMH_PRC</constant></title>
779 <para>Parade repetition cycle.</para>
780 <para>Possible values: 1, 2, 3, 4, 5, 6, 7, 8</para>
781 </section>
782 <section id="DTV-ATSCMH-RS-FRAME-MODE">
783 <title><constant>DTV_ATSCMH_RS_FRAME_MODE</constant></title>
b69d5f26 784 <para>Reed Solomon (RS) frame mode.</para>
edaa136d 785 <para>Possible values are:</para>
b69d5f26
MCC		 786<table pgwide="1" frame="none" id="atscmh-rs-frame-mode">
787 <title>enum atscmh_rs_frame_mode</title>
788 <tgroup cols="2">
789 &cs-def;
790 <thead>
791 <row>
792 <entry>ID</entry>
793 <entry>Description</entry>
794 </row>
795 </thead>
796 <tbody valign="top">
797 <row>
798 <entry id="ATSCMH-RSFRAME-PRI-ONLY"><constant>ATSCMH_RSFRAME_PRI_ONLY</constant></entry>
8092cd7f
MCC		 799 <entry>Single Frame: There is only a primary RS Frame for all
800 Group Regions.</entry>
b69d5f26
MCC		 801 </row><row>
802 <entry id="ATSCMH-RSFRAME-PRI-SEC"><constant>ATSCMH_RSFRAME_PRI_SEC</constant></entry>
8092cd7f
MCC		 803 <entry>Dual Frame: There are two separate RS Frames: Primary RS
804 Frame for Group Region A and B and Secondary RS Frame for Group
805 Region C and D.</entry>
b69d5f26
MCC		 806 </row>
807 </tbody>
808 </tgroup>
809</table>
edaa136d
MK		 810 </section>
811 <section id="DTV-ATSCMH-RS-FRAME-ENSEMBLE">
812 <title><constant>DTV_ATSCMH_RS_FRAME_ENSEMBLE</constant></title>
8092cd7f 813 <para>Reed Solomon(RS) frame ensemble.</para>
edaa136d 814 <para>Possible values are:</para>
b69d5f26
MCC		 815<table pgwide="1" frame="none" id="atscmh-rs-frame-ensemble">
816 <title>enum atscmh_rs_frame_ensemble</title>
817 <tgroup cols="2">
818 &cs-def;
819 <thead>
820 <row>
821 <entry>ID</entry>
822 <entry>Description</entry>
823 </row>
824 </thead>
825 <tbody valign="top">
826 <row>
827 <entry id="ATSCMH-RSFRAME-ENS-PRI"><constant>ATSCMH_RSFRAME_ENS_PRI</constant></entry>
8092cd7f 828 <entry>Primary Ensemble.</entry>
b69d5f26
MCC		 829 </row><row>
830 <entry id="ATSCMH-RSFRAME-ENS-SEC"><constant>AATSCMH_RSFRAME_PRI_SEC</constant></entry>
8092cd7f 831 <entry>Secondary Ensemble.</entry>
b69d5f26
MCC		 832 </row><row>
833 <entry id="ATSCMH-RSFRAME-RES"><constant>AATSCMH_RSFRAME_RES</constant></entry>
8092cd7f 834 <entry>Reserved. Shouldn't be used.</entry>
b69d5f26
MCC		 835 </row>
836 </tbody>
837 </tgroup>
838</table>
edaa136d
MK		 839 </section>
840 <section id="DTV-ATSCMH-RS-CODE-MODE-PRI">
841 <title><constant>DTV_ATSCMH_RS_CODE_MODE_PRI</constant></title>
8092cd7f 842 <para>Reed Solomon (RS) code mode (primary).</para>
edaa136d 843 <para>Possible values are:</para>
b69d5f26
MCC		 844<table pgwide="1" frame="none" id="atscmh-rs-code-mode">
845 <title>enum atscmh_rs_code_mode</title>
846 <tgroup cols="2">
847 &cs-def;
848 <thead>
849 <row>
850 <entry>ID</entry>
851 <entry>Description</entry>
852 </row>
853 </thead>
854 <tbody valign="top">
855 <row>
856 <entry id="ATSCMH-RSCODE-211-187"><constant>ATSCMH_RSCODE_211_187</constant></entry>
8092cd7f 857 <entry>Reed Solomon code (211,187).</entry>
b69d5f26
MCC		 858 </row><row>
859 <entry id="ATSCMH-RSCODE-223-187"><constant>ATSCMH_RSCODE_223_187</constant></entry>
8092cd7f 860 <entry>Reed Solomon code (223,187).</entry>
b69d5f26
MCC		 861 </row><row>
862 <entry id="ATSCMH-RSCODE-235-187"><constant>ATSCMH_RSCODE_235_187</constant></entry>
8092cd7f 863 <entry>Reed Solomon code (235,187).</entry>
b69d5f26
MCC		 864 </row><row>
865 <entry id="ATSCMH-RSCODE-RES"><constant>ATSCMH_RSCODE_RES</constant></entry>
8092cd7f 866 <entry>Reserved. Shouldn't be used.</entry>
b69d5f26
MCC		 867 </row>
868 </tbody>
869 </tgroup>
870</table>
edaa136d
MK		 871 </section>
872 <section id="DTV-ATSCMH-RS-CODE-MODE-SEC">
873 <title><constant>DTV_ATSCMH_RS_CODE_MODE_SEC</constant></title>
8092cd7f 874 <para>Reed Solomon (RS) code mode (secondary).</para>
b69d5f26
MCC		 875 <para>Possible values are the same as documented on
876 &atscmh-rs-code-mode;:</para>
edaa136d
MK		 877 </section>
878 <section id="DTV-ATSCMH-SCCC-BLOCK-MODE">
879 <title><constant>DTV_ATSCMH_SCCC_BLOCK_MODE</constant></title>
880 <para>Series Concatenated Convolutional Code Block Mode.</para>
881 <para>Possible values are:</para>
b69d5f26
MCC		 882<table pgwide="1" frame="none" id="atscmh-sccc-block-mode">
883 <title>enum atscmh_scc_block_mode</title>
884 <tgroup cols="2">
885 &cs-def;
886 <thead>
887 <row>
888 <entry>ID</entry>
889 <entry>Description</entry>
890 </row>
891 </thead>
892 <tbody valign="top">
893 <row>
894 <entry id="ATSCMH-SCCC-BLK-SEP"><constant>ATSCMH_SCCC_BLK_SEP</constant></entry>
8092cd7f
MCC		 895 <entry>Separate SCCC: the SCCC outer code mode shall be set independently
896 for each Group Region (A, B, C, D)</entry>
b69d5f26
MCC		 897 </row><row>
898 <entry id="ATSCMH-SCCC-BLK-COMB"><constant>ATSCMH_SCCC_BLK_COMB</constant></entry>
8092cd7f
MCC		 899 <entry>Combined SCCC: all four Regions shall have the same SCCC outer
900 code mode.</entry>
b69d5f26
MCC		 901 </row><row>
902 <entry id="ATSCMH-SCCC-BLK-RES"><constant>ATSCMH_SCCC_BLK_RES</constant></entry>
8092cd7f 903 <entry>Reserved. Shouldn't be used.</entry>
b69d5f26
MCC		 904 </row>
905 </tbody>
906 </tgroup>
907</table>
edaa136d
MK		 908 </section>
909 <section id="DTV-ATSCMH-SCCC-CODE-MODE-A">
910 <title><constant>DTV_ATSCMH_SCCC_CODE_MODE_A</constant></title>
911 <para>Series Concatenated Convolutional Code Rate.</para>
912 <para>Possible values are:</para>
b69d5f26
MCC		 913<table pgwide="1" frame="none" id="atscmh-sccc-code-mode">
914 <title>enum atscmh_sccc_code_mode</title>
915 <tgroup cols="2">
916 &cs-def;
917 <thead>
918 <row>
919 <entry>ID</entry>
920 <entry>Description</entry>
921 </row>
922 </thead>
923 <tbody valign="top">
924 <row>
925 <entry id="ATSCMH-SCCC-CODE-HLF"><constant>ATSCMH_SCCC_CODE_HLF</constant></entry>
8092cd7f 926 <entry>The outer code rate of a SCCC Block is 1/2 rate.</entry>
b69d5f26
MCC		 927 </row><row>
928 <entry id="ATSCMH-SCCC-CODE-QTR"><constant>ATSCMH_SCCC_CODE_QTR</constant></entry>
8092cd7f 929 <entry>The outer code rate of a SCCC Block is 1/4 rate.</entry>
b69d5f26
MCC		 930 </row><row>
931 <entry id="ATSCMH-SCCC-CODE-RES"><constant>ATSCMH_SCCC_CODE_RES</constant></entry>
932 <entry>to be documented.</entry>
933 </row>
934 </tbody>
935 </tgroup>
936</table>
edaa136d
MK		 937 </section>
938 <section id="DTV-ATSCMH-SCCC-CODE-MODE-B">
939 <title><constant>DTV_ATSCMH_SCCC_CODE_MODE_B</constant></title>
940 <para>Series Concatenated Convolutional Code Rate.</para>
b69d5f26
MCC		 941 <para>Possible values are the same as documented on
942 &atscmh-sccc-code-mode;.</para>
edaa136d
MK		 943 </section>
944 <section id="DTV-ATSCMH-SCCC-CODE-MODE-C">
945 <title><constant>DTV_ATSCMH_SCCC_CODE_MODE_C</constant></title>
946 <para>Series Concatenated Convolutional Code Rate.</para>
b69d5f26
MCC		 947 <para>Possible values are the same as documented on
948 &atscmh-sccc-code-mode;.</para>
edaa136d
MK		 949 </section>
950 <section id="DTV-ATSCMH-SCCC-CODE-MODE-D">
951 <title><constant>DTV_ATSCMH_SCCC_CODE_MODE_D</constant></title>
952 <para>Series Concatenated Convolutional Code Rate.</para>
b69d5f26
MCC		 953 <para>Possible values are the same as documented on
954 &atscmh-sccc-code-mode;.</para>
edaa136d 955 </section>
17d8bb06 956 </section>
04a92077
MCC		 957 <section id="DTV-API-VERSION">
958 <title><constant>DTV_API_VERSION</constant></title>
959 <para>Returns the major/minor version of the DVB API</para>
960 </section>
961 <section id="DTV-CODE-RATE-HP">
962 <title><constant>DTV_CODE_RATE_HP</constant></title>
2d457b8a
MCC		 963 <para>Used on terrestrial transmissions. The acceptable values are
964 the ones described at &fe-transmit-mode-t;.
04a92077 965 </para>
04a92077
MCC		 966 </section>
967 <section id="DTV-CODE-RATE-LP">
968 <title><constant>DTV_CODE_RATE_LP</constant></title>
2d457b8a
MCC		 969 <para>Used on terrestrial transmissions. The acceptable values are
970 the ones described at &fe-transmit-mode-t;.
04a92077 971 </para>
2d457b8a 972
04a92077 973 </section>
2d457b8a 974
17d8bb06
MCC		 975 <section id="DTV-GUARD-INTERVAL">
976 <title><constant>DTV_GUARD_INTERVAL</constant></title>
0ed08b49 977
17d8bb06 978 <para>Possible values are:</para>
903142e5
MCC		 979
980<section id="fe-guard-interval-t">
981<title>Modulation guard interval</title>
982
983<table pgwide="1" frame="none" id="fe-guard-interval">
984 <title>enum fe_guard_interval</title>
985 <tgroup cols="2">
986 &cs-def;
987 <thead>
988 <row>
989 <entry>ID</entry>
990 <entry>Description</entry>
991 </row>
992 </thead>
993 <tbody valign="top">
994 <row>
00c91dfd 995 <entry id="GUARD-INTERVAL-AUTO"><constant>GUARD_INTERVAL_AUTO</constant></entry>
903142e5
MCC		 996 <entry>Autodetect the guard interval</entry>
997 </row><row>
00c91dfd 998 <entry id="GUARD-INTERVAL-1-128"><constant>GUARD_INTERVAL_1_128</constant></entry>
903142e5
MCC		 999 <entry>Guard interval 1/128</entry>
1000 </row><row>
00c91dfd 1001 <entry id="GUARD-INTERVAL-1-32"><constant>GUARD_INTERVAL_1_32</constant></entry>
903142e5
MCC		 1002 <entry>Guard interval 1/32</entry>
1003 </row><row>
00c91dfd 1004 <entry id="GUARD-INTERVAL-1-16"><constant>GUARD_INTERVAL_1_16</constant></entry>
903142e5
MCC		 1005 <entry>Guard interval 1/16</entry>
1006 </row><row>
00c91dfd 1007 <entry id="GUARD-INTERVAL-1-8"><constant>GUARD_INTERVAL_1_8</constant></entry>
903142e5
MCC		 1008 <entry>Guard interval 1/8</entry>
1009 </row><row>
00c91dfd 1010 <entry id="GUARD-INTERVAL-1-4"><constant>GUARD_INTERVAL_1_4</constant></entry>
903142e5
MCC		 1011 <entry>Guard interval 1/4</entry>
1012 </row><row>
00c91dfd 1013 <entry id="GUARD-INTERVAL-19-128"><constant>GUARD_INTERVAL_19_128</constant></entry>
903142e5
MCC		 1014 <entry>Guard interval 19/128</entry>
1015 </row><row>
00c91dfd 1016 <entry id="GUARD-INTERVAL-19-256"><constant>GUARD_INTERVAL_19_256</constant></entry>
903142e5
MCC		 1017 <entry>Guard interval 19/256</entry>
1018 </row><row>
00c91dfd 1019 <entry id="GUARD-INTERVAL-PN420"><constant>GUARD_INTERVAL_PN420</constant></entry>
903142e5
MCC		 1020 <entry>PN length 420 (1/4)</entry>
1021 </row><row>
00c91dfd 1022 <entry id="GUARD-INTERVAL-PN595"><constant>GUARD_INTERVAL_PN595</constant></entry>
903142e5
MCC		 1023 <entry>PN length 595 (1/6)</entry>
1024 </row><row>
00c91dfd 1025 <entry id="GUARD-INTERVAL-PN945"><constant>GUARD_INTERVAL_PN945</constant></entry>
903142e5
MCC		 1026 <entry>PN length 945 (1/9)</entry>
1027 </row>
1028 </tbody>
1029 </tgroup>
1030</table>
0ed08b49 1031
17d8bb06
MCC		 1032 <para>Notes:</para>
1033 <para>1) If <constant>DTV_GUARD_INTERVAL</constant> is set the <constant>GUARD_INTERVAL_AUTO</constant> the hardware will
1034 try to find the correct guard interval (if capable) and will use TMCC to fill
1035 in the missing parameters.</para>
1036 <para>2) Intervals 1/128, 19/128 and 19/256 are used only for DVB-T2 at present</para>
224b6642 1037 <para>3) DTMB specifies PN420, PN595 and PN945.</para>
595d041a 1038</section>
0ed08b49 1039 </section>
95e61e01 1040 <section id="DTV-TRANSMISSION-MODE">
0ed08b49
MCC		 1041 <title><constant>DTV_TRANSMISSION_MODE</constant></title>
1042
0577a2f6
MCC		 1043 <para>Specifies the number of carriers used by the standard.
1044 This is used only on OFTM-based standards, e. g.
1045 DVB-T/T2, ISDB-T, DTMB</para>
1046
1047<section id="fe-transmit-mode-t">
1048<title>enum fe_transmit_mode: Number of carriers per channel</title>
1049
1050<table pgwide="1" frame="none" id="fe-transmit-mode">
1051 <title>enum fe_transmit_mode</title>
1052 <tgroup cols="2">
1053 &cs-def;
1054 <thead>
1055 <row>
1056 <entry>ID</entry>
1057 <entry>Description</entry>
1058 </row>
1059 </thead>
1060 <tbody valign="top">
1061 <row>
00c91dfd 1062 <entry id="TRANSMISSION-MODE-AUTO"><constant>TRANSMISSION_MODE_AUTO</constant></entry>
0577a2f6
MCC		 1063 <entry>Autodetect transmission mode. The hardware will try to find
1064 the correct FFT-size (if capable) to fill in the missing
1065 parameters.</entry>
1066 </row><row>
00c91dfd 1067 <entry id="TRANSMISSION-MODE-1K"><constant>TRANSMISSION_MODE_1K</constant></entry>
0577a2f6
MCC		 1068 <entry>Transmission mode 1K</entry>
1069 </row><row>
00c91dfd 1070 <entry id="TRANSMISSION-MODE-2K"><constant>TRANSMISSION_MODE_2K</constant></entry>
0577a2f6
MCC		 1071 <entry>Transmission mode 2K</entry>
1072 </row><row>
00c91dfd 1073 <entry id="TRANSMISSION-MODE-8K"><constant>TRANSMISSION_MODE_8K</constant></entry>
0577a2f6
MCC		 1074 <entry>Transmission mode 8K</entry>
1075 </row><row>
00c91dfd 1076 <entry id="TRANSMISSION-MODE-4K"><constant>TRANSMISSION_MODE_4K</constant></entry>
0577a2f6
MCC		 1077 <entry>Transmission mode 4K</entry>
1078 </row><row>
00c91dfd 1079 <entry id="TRANSMISSION-MODE-16K"><constant>TRANSMISSION_MODE_16K</constant></entry>
0577a2f6
MCC		 1080 <entry>Transmission mode 16K</entry>
1081 </row><row>
00c91dfd 1082 <entry id="TRANSMISSION-MODE-32K"><constant>TRANSMISSION_MODE_32K</constant></entry>
0577a2f6
MCC		 1083 <entry>Transmission mode 32K</entry>
1084 </row><row>
00c91dfd 1085 <entry id="TRANSMISSION-MODE-C1"><constant>TRANSMISSION_MODE_C1</constant></entry>
0577a2f6
MCC		 1086 <entry>Single Carrier (C=1) transmission mode (DTMB)</entry>
1087 </row><row>
00c91dfd 1088 <entry id="TRANSMISSION-MODE-C3780"><constant>TRANSMISSION_MODE_C3780</constant></entry>
0577a2f6 1089 <entry>Multi Carrier (C=3780) transmission mode (DTMB)</entry>
0577a2f6
MCC		 1090 </row>
1091 </tbody>
1092 </tgroup>
1093</table>
0577a2f6 1094
0ed08b49 1095
0ed08b49
MCC		 1096 <para>Notes:</para>
1097 <para>1) ISDB-T supports three carrier/symbol-size: 8K, 4K, 2K. It is called
1098 'mode' in the standard: Mode 1 is 2K, mode 2 is 4K, mode 3 is 8K</para>
1099
1100 <para>2) If <constant>DTV_TRANSMISSION_MODE</constant> is set the <constant>TRANSMISSION_MODE_AUTO</constant> the
1101 hardware will try to find the correct FFT-size (if capable) and will
1102 use TMCC to fill in the missing parameters.</para>
cf75f9ba
SK		 1103 <para>3) DVB-T specifies 2K and 8K as valid sizes.</para>
1104 <para>4) DVB-T2 specifies 1K, 2K, 4K, 8K, 16K and 32K.</para>
224b6642 1105 <para>5) DTMB specifies C1 and C3780.</para>
595d041a 1106</section>
0ed08b49 1107 </section>
17d8bb06
MCC		 1108 <section id="DTV-HIERARCHY">
1109 <title><constant>DTV_HIERARCHY</constant></title>
1110 <para>Frontend hierarchy</para>
9df4fc5b
MCC		 1111
1112
1113<section id="fe-hierarchy-t">
1114<title>Frontend hierarchy</title>
1115
1116<table pgwide="1" frame="none" id="fe-hierarchy">
1117 <title>enum fe_hierarchy</title>
1118 <tgroup cols="2">
1119 &cs-def;
1120 <thead>
1121 <row>
1122 <entry>ID</entry>
1123 <entry>Description</entry>
1124 </row>
1125 </thead>
1126 <tbody valign="top">
1127 <row>
00c91dfd 1128 <entry id="HIERARCHY-NONE"><constant>HIERARCHY_NONE</constant></entry>
9df4fc5b
MCC		 1129 <entry>No hierarchy</entry>
1130 </row><row>
00c91dfd 1131 <entry id="HIERARCHY-AUTO"><constant>HIERARCHY_AUTO</constant></entry>
9df4fc5b
MCC		 1132 <entry>Autodetect hierarchy (if supported)</entry>
1133 </row><row>
00c91dfd 1134 <entry id="HIERARCHY-1"><constant>HIERARCHY_1</constant></entry>
9df4fc5b
MCC		 1135 <entry>Hierarchy 1</entry>
1136 </row><row>
00c91dfd 1137 <entry id="HIERARCHY-2"><constant>HIERARCHY_2</constant></entry>
9df4fc5b
MCC		 1138 <entry>Hierarchy 2</entry>
1139 </row><row>
00c91dfd 1140 <entry id="HIERARCHY-4"><constant>HIERARCHY_4</constant></entry>
9df4fc5b
MCC		 1141 <entry>Hierarchy 4</entry>
1142 </row>
1143 </tbody>
1144 </tgroup>
1145</table>
1146</section>
1147
0ed08b49 1148 </section>
81800159
EP		 1149 <section id="DTV-STREAM-ID">
1150 <title><constant>DTV_STREAM_ID</constant></title>
1151 <para>DVB-S2, DVB-T2 and ISDB-S support the transmission of several
1152 streams on a single transport stream.
1153 This property enables the DVB driver to handle substream filtering,
1154 when supported by the hardware.
1155 By default, substream filtering is disabled.
1156 </para><para>
1157 For DVB-S2 and DVB-T2, the valid substream id range is from 0 to 255.
1158 </para><para>
1159 For ISDB, the valid substream id range is from 1 to 65535.
1160 </para><para>
1161 To disable it, you should use the special macro NO_STREAM_ID_FILTER.
1162 </para><para>
1163 Note: any value outside the id range also disables filtering.
1164 </para>
453d63c6 1165 </section>
81800159
EP		 1166 <section id="DTV-DVBT2-PLP-ID-LEGACY">
1167 <title><constant>DTV_DVBT2_PLP_ID_LEGACY</constant></title>
1168 <para>Obsolete, replaced with DTV_STREAM_ID.</para>
17d8bb06 1169 </section>
510f0a0f 1170 <section id="DTV-ENUM-DELSYS">
6c7ef547
MA		 1171 <title><constant>DTV_ENUM_DELSYS</constant></title>
1172 <para>A Multi standard frontend needs to advertise the delivery systems provided.
1173 Applications need to enumerate the provided delivery systems, before using
1174 any other operation with the frontend. Prior to it's introduction,
1175 FE_GET_INFO was used to determine a frontend type. A frontend which
1176 provides more than a single delivery system, FE_GET_INFO doesn't help much.
1177 Applications which intends to use a multistandard frontend must enumerate
1178 the delivery systems associated with it, rather than trying to use
1179 FE_GET_INFO. In the case of a legacy frontend, the result is just the same
1180 as with FE_GET_INFO, but in a more structured format </para>
1181 </section>
224b6642
AP		 1182 <section id="DTV-INTERLEAVING">
1183 <title><constant>DTV_INTERLEAVING</constant></title>
3d6d2137
MCC		 1184
1185<para>Time interleaving to be used. Currently, used only on DTMB.</para>
1186
1187<table pgwide="1" frame="none" id="fe-interleaving">
1188 <title>enum fe_interleaving</title>
1189 <tgroup cols="2">
1190 &cs-def;
1191 <thead>
1192 <row>
1193 <entry>ID</entry>
1194 <entry>Description</entry>
1195 </row>
1196 </thead>
1197 <tbody valign="top">
1198 <row>
1199 <entry id="INTERLEAVING-NONE"><constant>INTERLEAVING_NONE</constant></entry>
1200 <entry>No interleaving.</entry>
1201 </row><row>
1202 <entry id="INTERLEAVING-AUTO"><constant>INTERLEAVING_AUTO</constant></entry>
1203 <entry>Auto-detect interleaving.</entry>
1204 </row><row>
1205 <entry id="INTERLEAVING-240"><constant>INTERLEAVING_240</constant></entry>
1206 <entry>Interleaving of 240 symbols.</entry>
1207 </row><row>
1208 <entry id="INTERLEAVING-720"><constant>INTERLEAVING_720</constant></entry>
1209 <entry>Interleaving of 720 symbols.</entry>
1210 </row>
1211 </tbody>
1212 </tgroup>
1213</table>
1214
224b6642 1215 </section>
ee47e2f9
AP		 1216 <section id="DTV-LNA">
1217 <title><constant>DTV_LNA</constant></title>
1218 <para>Low-noise amplifier.</para>
1219 <para>Hardware might offer controllable LNA which can be set manually
1220 using that parameter. Usually LNA could be found only from
1221 terrestrial devices if at all.</para>
1222 <para>Possible values: 0, 1, LNA_AUTO</para>
1223 <para>0, LNA off</para>
1224 <para>1, LNA on</para>
1225 <para>use the special macro LNA_AUTO to set LNA auto</para>
1226 </section>
994e262e 1227</section>
9569793a
MCC		 1228
1229 <section id="frontend-stat-properties">
1230 <title>Frontend statistics indicators</title>
1231 <para>The values are returned via <constant>dtv_property.stat</constant>.
1232 If the property is supported, <constant>dtv_property.stat.len</constant> is bigger than zero.</para>
1233 <para>For most delivery systems, <constant>dtv_property.stat.len</constant>
1234 will be 1 if the stats is supported, and the properties will
1235 return a single value for each parameter.</para>
7832a915 1236 <para>It should be noted, however, that new OFDM delivery systems
9569793a
MCC		 1237 like ISDB can use different modulation types for each group of
1238 carriers. On such standards, up to 3 groups of statistics can be
1239 provided, and <constant>dtv_property.stat.len</constant> is updated
1240 to reflect the "global" metrics, plus one metric per each carrier
1241 group (called "layer" on ISDB).</para>
1242 <para>So, in order to be consistent with other delivery systems, the first
1243 value at <link linkend="dtv-stats"><constant>dtv_property.stat.dtv_stats</constant></link>
1244 array refers to the global metric. The other elements of the array
1245 represent each layer, starting from layer A(index 1),
1246 layer B (index 2) and so on.</para>
1247 <para>The number of filled elements are stored at <constant>dtv_property.stat.len</constant>.</para>
1248 <para>Each element of the <constant>dtv_property.stat.dtv_stats</constant> array consists on two elements:</para>
1249 <itemizedlist mark='opencircle'>
1250 <listitem><para><constant>svalue</constant> or <constant>uvalue</constant>, where
1251 <constant>svalue</constant> is for signed values of the measure (dB measures)
1252 and <constant>uvalue</constant> is for unsigned values (counters, relative scale)</para></listitem>
1253 <listitem><para><constant>scale</constant> - Scale for the value. It can be:</para>
820eac0e 1254 <itemizedlist mark='bullet' id="fecap-scale-params">
00c91dfd
MCC		 1255 <listitem id="FE-SCALE-NOT-AVAILABLE"><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - The parameter is supported by the frontend, but it was not possible to collect it (could be a transitory or permanent condition)</para></listitem>
1256 <listitem id="FE-SCALE-DECIBEL"><para><constant>FE_SCALE_DECIBEL</constant> - parameter is a signed value, measured in 1/1000 dB</para></listitem>
1257 <listitem id="FE-SCALE-RELATIVE"><para><constant>FE_SCALE_RELATIVE</constant> - parameter is a unsigned value, where 0 means 0% and 65535 means 100%.</para></listitem>
1258 <listitem id="FE-SCALE-COUNTER"><para><constant>FE_SCALE_COUNTER</constant> - parameter is a unsigned value that counts the occurrence of an event, like bit error, block error, or lapsed time.</para></listitem>
9569793a 1259 </itemizedlist>
9569793a
MCC		 1260 </listitem>
1261 </itemizedlist>
1262 <section id="DTV-STAT-SIGNAL-STRENGTH">
1263 <title><constant>DTV_STAT_SIGNAL_STRENGTH</constant></title>
1264 <para>Indicates the signal strength level at the analog part of the tuner or of the demod.</para>
1265 <para>Possible scales for this metric are:</para>
1266 <itemizedlist mark='bullet'>
820eac0e 1267 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
4c12adad 1268 <listitem><para><constant>FE_SCALE_DECIBEL</constant> - signal strength is in 0.001 dBm units, power measured in miliwatts. This value is generally negative.</para></listitem>
820eac0e 1269 <listitem><para><constant>FE_SCALE_RELATIVE</constant> - The frontend provides a 0% to 100% measurement for power (actually, 0 to 65535).</para></listitem>
9569793a
MCC		 1270 </itemizedlist>
1271 </section>
1272 <section id="DTV-STAT-CNR">
1273 <title><constant>DTV_STAT_CNR</constant></title>
1274 <para>Indicates the Signal to Noise ratio for the main carrier.</para>
1275 <para>Possible scales for this metric are:</para>
1276 <itemizedlist mark='bullet'>
820eac0e 1277 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
4c12adad 1278 <listitem><para><constant>FE_SCALE_DECIBEL</constant> - Signal/Noise ratio is in 0.001 dB units.</para></listitem>
820eac0e 1279 <listitem><para><constant>FE_SCALE_RELATIVE</constant> - The frontend provides a 0% to 100% measurement for Signal/Noise (actually, 0 to 65535).</para></listitem>
9569793a
MCC		 1280 </itemizedlist>
1281 </section>
1282 <section id="DTV-STAT-PRE-ERROR-BIT-COUNT">
1283 <title><constant>DTV_STAT_PRE_ERROR_BIT_COUNT</constant></title>
1284 <para>Measures the number of bit errors before the forward error correction (FEC) on the inner coding block (before Viterbi, LDPC or other inner code).</para>
1285 <para>This measure is taken during the same interval as <constant>DTV_STAT_PRE_TOTAL_BIT_COUNT</constant>.</para>
1286 <para>In order to get the BER (Bit Error Rate) measurement, it should be divided by
1287 <link linkend="DTV-STAT-PRE-TOTAL-BIT-COUNT"><constant>DTV_STAT_PRE_TOTAL_BIT_COUNT</constant></link>.</para>
1288 <para>This measurement is monotonically increased, as the frontend gets more bit count measurements.
1289 The frontend may reset it when a channel/transponder is tuned.</para>
1290 <para>Possible scales for this metric are:</para>
1291 <itemizedlist mark='bullet'>
820eac0e
HV		 1292 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
1293 <listitem><para><constant>FE_SCALE_COUNTER</constant> - Number of error bits counted before the inner coding.</para></listitem>
9569793a
MCC		 1294 </itemizedlist>
1295 </section>
1296 <section id="DTV-STAT-PRE-TOTAL-BIT-COUNT">
1297 <title><constant>DTV_STAT_PRE_TOTAL_BIT_COUNT</constant></title>
1298 <para>Measures the amount of bits received before the inner code block, during the same period as
1299 <link linkend="DTV-STAT-PRE-ERROR-BIT-COUNT"><constant>DTV_STAT_PRE_ERROR_BIT_COUNT</constant></link> measurement was taken.</para>
7832a915 1300 <para>It should be noted that this measurement can be smaller than the total amount of bits on the transport stream,
842059aa 1301 as the frontend may need to manually restart the measurement, losing some data between each measurement interval.</para>
9569793a
MCC		 1302 <para>This measurement is monotonically increased, as the frontend gets more bit count measurements.
1303 The frontend may reset it when a channel/transponder is tuned.</para>
1304 <para>Possible scales for this metric are:</para>
1305 <itemizedlist mark='bullet'>
820eac0e
HV		 1306 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
1307 <listitem><para><constant>FE_SCALE_COUNTER</constant> - Number of bits counted while measuring
1308 <link linkend="DTV-STAT-PRE-ERROR-BIT-COUNT"><constant>DTV_STAT_PRE_ERROR_BIT_COUNT</constant></link>.</para></listitem>
9569793a
MCC		 1309 </itemizedlist>
1310 </section>
1311 <section id="DTV-STAT-POST-ERROR-BIT-COUNT">
1312 <title><constant>DTV_STAT_POST_ERROR_BIT_COUNT</constant></title>
1313 <para>Measures the number of bit errors after the forward error correction (FEC) done by inner code block (after Viterbi, LDPC or other inner code).</para>
1314 <para>This measure is taken during the same interval as <constant>DTV_STAT_POST_TOTAL_BIT_COUNT</constant>.</para>
1315 <para>In order to get the BER (Bit Error Rate) measurement, it should be divided by
1316 <link linkend="DTV-STAT-POST-TOTAL-BIT-COUNT"><constant>DTV_STAT_POST_TOTAL_BIT_COUNT</constant></link>.</para>
1317 <para>This measurement is monotonically increased, as the frontend gets more bit count measurements.
1318 The frontend may reset it when a channel/transponder is tuned.</para>
1319 <para>Possible scales for this metric are:</para>
1320 <itemizedlist mark='bullet'>
820eac0e
HV		 1321 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
1322 <listitem><para><constant>FE_SCALE_COUNTER</constant> - Number of error bits counted after the inner coding.</para></listitem>
9569793a
MCC		 1323 </itemizedlist>
1324 </section>
1325 <section id="DTV-STAT-POST-TOTAL-BIT-COUNT">
1326 <title><constant>DTV_STAT_POST_TOTAL_BIT_COUNT</constant></title>
1327 <para>Measures the amount of bits received after the inner coding, during the same period as
1328 <link linkend="DTV-STAT-POST-ERROR-BIT-COUNT"><constant>DTV_STAT_POST_ERROR_BIT_COUNT</constant></link> measurement was taken.</para>
7832a915 1329 <para>It should be noted that this measurement can be smaller than the total amount of bits on the transport stream,
842059aa 1330 as the frontend may need to manually restart the measurement, losing some data between each measurement interval.</para>
9569793a
MCC		 1331 <para>This measurement is monotonically increased, as the frontend gets more bit count measurements.
1332 The frontend may reset it when a channel/transponder is tuned.</para>
1333 <para>Possible scales for this metric are:</para>
1334 <itemizedlist mark='bullet'>
820eac0e
HV		 1335 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
1336 <listitem><para><constant>FE_SCALE_COUNTER</constant> - Number of bits counted while measuring
1337 <link linkend="DTV-STAT-POST-ERROR-BIT-COUNT"><constant>DTV_STAT_POST_ERROR_BIT_COUNT</constant></link>.</para></listitem>
9569793a
MCC		 1338 </itemizedlist>
1339 </section>
1340 <section id="DTV-STAT-ERROR-BLOCK-COUNT">
1341 <title><constant>DTV_STAT_ERROR_BLOCK_COUNT</constant></title>
1342 <para>Measures the number of block errors after the outer forward error correction coding (after Reed-Solomon or other outer code).</para>
1343 <para>This measurement is monotonically increased, as the frontend gets more bit count measurements.
1344 The frontend may reset it when a channel/transponder is tuned.</para>
1345 <para>Possible scales for this metric are:</para>
1346 <itemizedlist mark='bullet'>
820eac0e
HV		 1347 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
1348 <listitem><para><constant>FE_SCALE_COUNTER</constant> - Number of error blocks counted after the outer coding.</para></listitem>
9569793a
MCC		 1349 </itemizedlist>
1350 </section>
1351 <section id="DTV-STAT-TOTAL-BLOCK-COUNT">
1352 <title><constant>DTV-STAT_TOTAL_BLOCK_COUNT</constant></title>
1353 <para>Measures the total number of blocks received during the same period as
1354 <link linkend="DTV-STAT-ERROR-BLOCK-COUNT"><constant>DTV_STAT_ERROR_BLOCK_COUNT</constant></link> measurement was taken.</para>
1355 <para>It can be used to calculate the PER indicator, by dividing
1356 <link linkend="DTV-STAT-ERROR-BLOCK-COUNT"><constant>DTV_STAT_ERROR_BLOCK_COUNT</constant></link>
1357 by <link linkend="DTV-STAT-TOTAL-BLOCK-COUNT"><constant>DTV-STAT-TOTAL-BLOCK-COUNT</constant></link>.</para>
1358 <para>Possible scales for this metric are:</para>
1359 <itemizedlist mark='bullet'>
820eac0e
HV		 1360 <listitem><para><constant>FE_SCALE_NOT_AVAILABLE</constant> - it failed to measure it, or the measurement was not complete yet.</para></listitem>
1361 <listitem><para><constant>FE_SCALE_COUNTER</constant> - Number of blocks counted while measuring
1362 <link linkend="DTV-STAT-ERROR-BLOCK-COUNT"><constant>DTV_STAT_ERROR_BLOCK_COUNT</constant></link>.</para></listitem>
9569793a
MCC		 1363 </itemizedlist>
1364 </section>
1365 </section>
1366
994e262e
MCC		 1367 <section id="frontend-property-terrestrial-systems">
1368 <title>Properties used on terrestrial delivery systems</title>
1369 <section id="dvbt-params">
1370 <title>DVB-T delivery system</title>
1371 <para>The following parameters are valid for DVB-T:</para>
1372 <itemizedlist mark='opencircle'>
1373 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
e7da0ae3 1374 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
994e262e
MCC		 1375 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1376 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1377 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1378 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
1379 <listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>
1380 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
1381 <listitem><para><link linkend="DTV-CODE-RATE-HP"><constant>DTV_CODE_RATE_HP</constant></link></para></listitem>
1382 <listitem><para><link linkend="DTV-CODE-RATE-LP"><constant>DTV_CODE_RATE_LP</constant></link></para></listitem>
1383 <listitem><para><link linkend="DTV-GUARD-INTERVAL"><constant>DTV_GUARD_INTERVAL</constant></link></para></listitem>
1384 <listitem><para><link linkend="DTV-TRANSMISSION-MODE"><constant>DTV_TRANSMISSION_MODE</constant></link></para></listitem>
1385 <listitem><para><link linkend="DTV-HIERARCHY"><constant>DTV_HIERARCHY</constant></link></para></listitem>
ee47e2f9 1386 <listitem><para><link linkend="DTV-LNA"><constant>DTV_LNA</constant></link></para></listitem>
994e262e 1387 </itemizedlist>
9569793a 1388 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
994e262e
MCC		 1389 </section>
1390 <section id="dvbt2-params">
1391 <title>DVB-T2 delivery system</title>
ff74b8ee
MCC		 1392 <para>DVB-T2 support is currently in the early stages
1393 of development, so expect that this section maygrow and become
994e262e
MCC		 1394 more detailed with time.</para>
1395 <para>The following parameters are valid for DVB-T2:</para>
1396 <itemizedlist mark='opencircle'>
1397 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
e7da0ae3 1398 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
994e262e
MCC		 1399 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1400 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1401 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1402 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
1403 <listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>
1404 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
1405 <listitem><para><link linkend="DTV-CODE-RATE-HP"><constant>DTV_CODE_RATE_HP</constant></link></para></listitem>
1406 <listitem><para><link linkend="DTV-CODE-RATE-LP"><constant>DTV_CODE_RATE_LP</constant></link></para></listitem>
1407 <listitem><para><link linkend="DTV-GUARD-INTERVAL"><constant>DTV_GUARD_INTERVAL</constant></link></para></listitem>
1408 <listitem><para><link linkend="DTV-TRANSMISSION-MODE"><constant>DTV_TRANSMISSION_MODE</constant></link></para></listitem>
1409 <listitem><para><link linkend="DTV-HIERARCHY"><constant>DTV_HIERARCHY</constant></link></para></listitem>
81800159 1410 <listitem><para><link linkend="DTV-STREAM-ID"><constant>DTV_STREAM_ID</constant></link></para></listitem>
ee47e2f9 1411 <listitem><para><link linkend="DTV-LNA"><constant>DTV_LNA</constant></link></para></listitem>
994e262e 1412 </itemizedlist>
9569793a 1413 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
994e262e 1414 </section>
17d8bb06 1415 <section id="isdbt">
994e262e 1416 <title>ISDB-T delivery system</title>
17d8bb06
MCC		 1417 <para>This ISDB-T/ISDB-Tsb API extension should reflect all information
1418 needed to tune any ISDB-T/ISDB-Tsb hardware. Of course it is possible
1419 that some very sophisticated devices won't need certain parameters to
1420 tune.</para>
1421 <para>The information given here should help application writers to know how
1422 to handle ISDB-T and ISDB-Tsb hardware using the Linux DVB-API.</para>
1423 <para>The details given here about ISDB-T and ISDB-Tsb are just enough to
1424 basically show the dependencies between the needed parameter values,
1425 but surely some information is left out. For more detailed information
1426 see the following documents:</para>
1427 <para>ARIB STD-B31 - "Transmission System for Digital Terrestrial
1428 Television Broadcasting" and</para>
1429 <para>ARIB TR-B14 - "Operational Guidelines for Digital Terrestrial
1430 Television Broadcasting".</para>
994e262e
MCC		 1431 <para>In order to understand the ISDB specific parameters,
1432 one has to have some knowledge the channel structure in
1433 ISDB-T and ISDB-Tsb. I.e. it has to be known to
1434 the reader that an ISDB-T channel consists of 13 segments,
1435 that it can have up to 3 layer sharing those segments,
1436 and things like that.</para>
1437 <para>The following parameters are valid for ISDB-T:</para>
1438 <itemizedlist mark='opencircle'>
1439 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
e7da0ae3 1440 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
994e262e
MCC		 1441 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1442 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1443 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
994e262e
MCC		 1444 <listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>
1445 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
994e262e
MCC		 1446 <listitem><para><link linkend="DTV-GUARD-INTERVAL"><constant>DTV_GUARD_INTERVAL</constant></link></para></listitem>
1447 <listitem><para><link linkend="DTV-TRANSMISSION-MODE"><constant>DTV_TRANSMISSION_MODE</constant></link></para></listitem>
994e262e
MCC		 1448 <listitem><para><link linkend="DTV-ISDBT-LAYER-ENABLED"><constant>DTV_ISDBT_LAYER_ENABLED</constant></link></para></listitem>
1449 <listitem><para><link linkend="DTV-ISDBT-PARTIAL-RECEPTION"><constant>DTV_ISDBT_PARTIAL_RECEPTION</constant></link></para></listitem>
1450 <listitem><para><link linkend="DTV-ISDBT-SOUND-BROADCASTING"><constant>DTV_ISDBT_SOUND_BROADCASTING</constant></link></para></listitem>
1451 <listitem><para><link linkend="DTV-ISDBT-SB-SUBCHANNEL-ID"><constant>DTV_ISDBT_SB_SUBCHANNEL_ID</constant></link></para></listitem>
1452 <listitem><para><link linkend="DTV-ISDBT-SB-SEGMENT-IDX"><constant>DTV_ISDBT_SB_SEGMENT_IDX</constant></link></para></listitem>
1453 <listitem><para><link linkend="DTV-ISDBT-SB-SEGMENT-COUNT"><constant>DTV_ISDBT_SB_SEGMENT_COUNT</constant></link></para></listitem>
1454 <listitem><para><link linkend="DTV-ISDBT-LAYER-FEC"><constant>DTV_ISDBT_LAYERA_FEC</constant></link></para></listitem>
1455 <listitem><para><link linkend="DTV-ISDBT-LAYER-MODULATION"><constant>DTV_ISDBT_LAYERA_MODULATION</constant></link></para></listitem>
1456 <listitem><para><link linkend="DTV-ISDBT-LAYER-SEGMENT-COUNT"><constant>DTV_ISDBT_LAYERA_SEGMENT_COUNT</constant></link></para></listitem>
1457 <listitem><para><link linkend="DTV-ISDBT-LAYER-TIME-INTERLEAVING"><constant>DTV_ISDBT_LAYERA_TIME_INTERLEAVING</constant></link></para></listitem>
1458 <listitem><para><link linkend="DTV-ISDBT-LAYER-FEC"><constant>DTV_ISDBT_LAYERB_FEC</constant></link></para></listitem>
1459 <listitem><para><link linkend="DTV-ISDBT-LAYER-MODULATION"><constant>DTV_ISDBT_LAYERB_MODULATION</constant></link></para></listitem>
1460 <listitem><para><link linkend="DTV-ISDBT-LAYER-SEGMENT-COUNT"><constant>DTV_ISDBT_LAYERB_SEGMENT_COUNT</constant></link></para></listitem>
1461 <listitem><para><link linkend="DTV-ISDBT-LAYER-TIME-INTERLEAVING"><constant>DTV_ISDBT_LAYERB_TIME_INTERLEAVING</constant></link></para></listitem>
1462 <listitem><para><link linkend="DTV-ISDBT-LAYER-FEC"><constant>DTV_ISDBT_LAYERC_FEC</constant></link></para></listitem>
1463 <listitem><para><link linkend="DTV-ISDBT-LAYER-MODULATION"><constant>DTV_ISDBT_LAYERC_MODULATION</constant></link></para></listitem>
1464 <listitem><para><link linkend="DTV-ISDBT-LAYER-SEGMENT-COUNT"><constant>DTV_ISDBT_LAYERC_SEGMENT_COUNT</constant></link></para></listitem>
1465 <listitem><para><link linkend="DTV-ISDBT-LAYER-TIME-INTERLEAVING"><constant>DTV_ISDBT_LAYERC_TIME_INTERLEAVING</constant></link></para></listitem>
1466 </itemizedlist>
9569793a 1467 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
cf75f9ba 1468 </section>
76f9a69a
MCC		 1469 <section id="atsc-params">
1470 <title>ATSC delivery system</title>
1471 <para>The following parameters are valid for ATSC:</para>
1472 <itemizedlist mark='opencircle'>
1473 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1474 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1475 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1476 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1477 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1478 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
1479 <listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>
1480 </itemizedlist>
9569793a 1481 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
76f9a69a 1482 </section>
edaa136d
MK		 1483 <section id="atscmh-params">
1484 <title>ATSC-MH delivery system</title>
1485 <para>The following parameters are valid for ATSC-MH:</para>
1486 <itemizedlist mark='opencircle'>
1487 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1488 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1489 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1490 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1491 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1492 <listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>
1493 <listitem><para><link linkend="DTV-ATSCMH-FIC-VER"><constant>DTV_ATSCMH_FIC_VER</constant></link></para></listitem>
1494 <listitem><para><link linkend="DTV-ATSCMH-PARADE-ID"><constant>DTV_ATSCMH_PARADE_ID</constant></link></para></listitem>
1495 <listitem><para><link linkend="DTV-ATSCMH-NOG"><constant>DTV_ATSCMH_NOG</constant></link></para></listitem>
1496 <listitem><para><link linkend="DTV-ATSCMH-TNOG"><constant>DTV_ATSCMH_TNOG</constant></link></para></listitem>
1497 <listitem><para><link linkend="DTV-ATSCMH-SGN"><constant>DTV_ATSCMH_SGN</constant></link></para></listitem>
1498 <listitem><para><link linkend="DTV-ATSCMH-PRC"><constant>DTV_ATSCMH_PRC</constant></link></para></listitem>
1499 <listitem><para><link linkend="DTV-ATSCMH-RS-FRAME-MODE"><constant>DTV_ATSCMH_RS_FRAME_MODE</constant></link></para></listitem>
1500 <listitem><para><link linkend="DTV-ATSCMH-RS-FRAME-ENSEMBLE"><constant>DTV_ATSCMH_RS_FRAME_ENSEMBLE</constant></link></para></listitem>
510f0a0f
HV		 1501 <listitem><para><link linkend="DTV-ATSCMH-RS-CODE-MODE-PRI"><constant>DTV_ATSCMH_RS_CODE_MODE_PRI</constant></link></para></listitem>
1502 <listitem><para><link linkend="DTV-ATSCMH-RS-CODE-MODE-SEC"><constant>DTV_ATSCMH_RS_CODE_MODE_SEC</constant></link></para></listitem>
edaa136d 1503 <listitem><para><link linkend="DTV-ATSCMH-SCCC-BLOCK-MODE"><constant>DTV_ATSCMH_SCCC_BLOCK_MODE</constant></link></para></listitem>
510f0a0f
HV		 1504 <listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE-MODE-A"><constant>DTV_ATSCMH_SCCC_CODE_MODE_A</constant></link></para></listitem>
1505 <listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE-MODE-B"><constant>DTV_ATSCMH_SCCC_CODE_MODE_B</constant></link></para></listitem>
1506 <listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE-MODE-C"><constant>DTV_ATSCMH_SCCC_CODE_MODE_C</constant></link></para></listitem>
1507 <listitem><para><link linkend="DTV-ATSCMH-SCCC-CODE-MODE-D"><constant>DTV_ATSCMH_SCCC_CODE_MODE_D</constant></link></para></listitem>
edaa136d 1508 </itemizedlist>
9569793a 1509 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
edaa136d 1510 </section>
224b6642
AP		 1511 <section id="dtmb-params">
1512 <title>DTMB delivery system</title>
1513 <para>The following parameters are valid for DTMB:</para>
1514 <itemizedlist mark='opencircle'>
1515 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1516 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1517 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1518 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1519 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1520 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
1521 <listitem><para><link linkend="DTV-BANDWIDTH-HZ"><constant>DTV_BANDWIDTH_HZ</constant></link></para></listitem>
1522 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
1523 <listitem><para><link linkend="DTV-INNER-FEC"><constant>DTV_INNER_FEC</constant></link></para></listitem>
1524 <listitem><para><link linkend="DTV-GUARD-INTERVAL"><constant>DTV_GUARD_INTERVAL</constant></link></para></listitem>
1525 <listitem><para><link linkend="DTV-TRANSMISSION-MODE"><constant>DTV_TRANSMISSION_MODE</constant></link></para></listitem>
1526 <listitem><para><link linkend="DTV-INTERLEAVING"><constant>DTV_INTERLEAVING</constant></link></para></listitem>
ee47e2f9 1527 <listitem><para><link linkend="DTV-LNA"><constant>DTV_LNA</constant></link></para></listitem>
224b6642 1528 </itemizedlist>
9569793a 1529 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
224b6642 1530 </section>
cf75f9ba 1531 </section>
994e262e 1532 <section id="frontend-property-cable-systems">
ff74b8ee 1533 <title>Properties used on cable delivery systems</title>
e7da0ae3
MCC		 1534 <section id="dvbc-params">
1535 <title>DVB-C delivery system</title>
669a4ba4
MCC		 1536 <para>The DVB-C Annex-A is the widely used cable standard. Transmission uses QAM modulation.</para>
1537 <para>The DVB-C Annex-C is optimized for 6MHz, and is used in Japan. It supports a subset of the Annex A modulation types, and a roll-off of 0.13, instead of 0.15</para>
e7da0ae3
MCC		 1538 <para>The following parameters are valid for DVB-C Annex A/C:</para>
1539 <itemizedlist mark='opencircle'>
1540 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1541 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1542 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1543 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1544 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1545 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
1546 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
1547 <listitem><para><link linkend="DTV-SYMBOL-RATE"><constant>DTV_SYMBOL_RATE</constant></link></para></listitem>
1548 <listitem><para><link linkend="DTV-INNER-FEC"><constant>DTV_INNER_FEC</constant></link></para></listitem>
ee47e2f9 1549 <listitem><para><link linkend="DTV-LNA"><constant>DTV_LNA</constant></link></para></listitem>
e7da0ae3 1550 </itemizedlist>
9569793a 1551 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
e7da0ae3
MCC		 1552 </section>
1553 <section id="dvbc-annex-b-params">
1554 <title>DVB-C Annex B delivery system</title>
1555 <para>The DVB-C Annex-B is only used on a few Countries like the United States.</para>
1556 <para>The following parameters are valid for DVB-C Annex B:</para>
1557 <itemizedlist mark='opencircle'>
1558 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1559 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1560 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1561 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1562 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1563 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
1564 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
ee47e2f9 1565 <listitem><para><link linkend="DTV-LNA"><constant>DTV_LNA</constant></link></para></listitem>
e7da0ae3 1566 </itemizedlist>
9569793a 1567 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
e7da0ae3 1568 </section>
994e262e 1569 </section>
6fc1cb2e
HV		 1570 <section id="frontend-property-satellite-systems">
1571 <title>Properties used on satellite delivery systems</title>
ff74b8ee
MCC		 1572 <section id="dvbs-params">
1573 <title>DVB-S delivery system</title>
1574 <para>The following parameters are valid for DVB-S:</para>
1575 <itemizedlist mark='opencircle'>
1576 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1577 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1578 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1579 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1580 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1581 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
1582 <listitem><para><link linkend="DTV-SYMBOL-RATE"><constant>DTV_SYMBOL_RATE</constant></link></para></listitem>
1583 <listitem><para><link linkend="DTV-INNER-FEC"><constant>DTV_INNER_FEC</constant></link></para></listitem>
7fc9da2a
AO		 1584 <listitem><para><link linkend="DTV-VOLTAGE"><constant>DTV_VOLTAGE</constant></link></para></listitem>
1585 <listitem><para><link linkend="DTV-TONE"><constant>DTV_TONE</constant></link></para></listitem>
ff74b8ee 1586 </itemizedlist>
9569793a 1587 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
ff74b8ee
MCC		 1588 <para>Future implementations might add those two missing parameters:</para>
1589 <itemizedlist mark='opencircle'>
1590 <listitem><para><link linkend="DTV-DISEQC-MASTER"><constant>DTV_DISEQC_MASTER</constant></link></para></listitem>
1591 <listitem><para><link linkend="DTV-DISEQC-SLAVE-REPLY"><constant>DTV_DISEQC_SLAVE_REPLY</constant></link></para></listitem>
1592 </itemizedlist>
1593 </section>
1594 <section id="dvbs2-params">
1595 <title>DVB-S2 delivery system</title>
7fc9da2a 1596 <para>In addition to all parameters valid for DVB-S, DVB-S2 supports the following parameters:</para>
ff74b8ee 1597 <itemizedlist mark='opencircle'>
7fc9da2a 1598 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
ff74b8ee
MCC		 1599 <listitem><para><link linkend="DTV-PILOT"><constant>DTV_PILOT</constant></link></para></listitem>
1600 <listitem><para><link linkend="DTV-ROLLOFF"><constant>DTV_ROLLOFF</constant></link></para></listitem>
81800159 1601 <listitem><para><link linkend="DTV-STREAM-ID"><constant>DTV_STREAM_ID</constant></link></para></listitem>
ff74b8ee 1602 </itemizedlist>
9569793a 1603 <para>In addition, the <link linkend="frontend-stat-properties">DTV QoS statistics</link> are also valid.</para>
7fc9da2a
AO		 1604 </section>
1605 <section id="turbo-params">
1606 <title>Turbo code delivery system</title>
1607 <para>In addition to all parameters valid for DVB-S, turbo code supports the following parameters:</para>
ff74b8ee 1608 <itemizedlist mark='opencircle'>
7fc9da2a 1609 <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
ff74b8ee
MCC		 1610 </itemizedlist>
1611 </section>
1612 <section id="isdbs-params">
1613 <title>ISDB-S delivery system</title>
1614 <para>The following parameters are valid for ISDB-S:</para>
1615 <itemizedlist mark='opencircle'>
1616 <listitem><para><link linkend="DTV-API-VERSION"><constant>DTV_API_VERSION</constant></link></para></listitem>
1617 <listitem><para><link linkend="DTV-DELIVERY-SYSTEM"><constant>DTV_DELIVERY_SYSTEM</constant></link></para></listitem>
1618 <listitem><para><link linkend="DTV-TUNE"><constant>DTV_TUNE</constant></link></para></listitem>
1619 <listitem><para><link linkend="DTV-CLEAR"><constant>DTV_CLEAR</constant></link></para></listitem>
1620 <listitem><para><link linkend="DTV-FREQUENCY"><constant>DTV_FREQUENCY</constant></link></para></listitem>
1621 <listitem><para><link linkend="DTV-INVERSION"><constant>DTV_INVERSION</constant></link></para></listitem>
1622 <listitem><para><link linkend="DTV-SYMBOL-RATE"><constant>DTV_SYMBOL_RATE</constant></link></para></listitem>
1623 <listitem><para><link linkend="DTV-INNER-FEC"><constant>DTV_INNER_FEC</constant></link></para></listitem>
1624 <listitem><para><link linkend="DTV-VOLTAGE"><constant>DTV_VOLTAGE</constant></link></para></listitem>
81800159 1625 <listitem><para><link linkend="DTV-STREAM-ID"><constant>DTV_STREAM_ID</constant></link></para></listitem>
ff74b8ee
MCC		 1626 </itemizedlist>
1627 </section>
994e262e 1628 </section>
131db3a1 1629</section>
Linux kernel - Deliverables
This page took 0.351159 seconds and 5 git commands to generate.