Documentation/media/uapi/dvb/fe_property_parameters.rst

   1 .. -*- coding: utf-8; mode: rst -*-
   2
   3 .. _fe_property_parameters:
   4
   5 ******************************
   6 Digital TV property parameters
   7 ******************************
   8
   9 There are several different Digital TV parameters that can be used by
  10 :ref:`FE_SET_PROPERTY and FE_GET_PROPERTY ioctls<FE_GET_PROPERTY>`.
  11 This section describes each of them. Please notice, however, that only
  12 a subset of them are needed to setup a frontend.
  13
  14
  15 .. _DTV-UNDEFINED:
  16
  17 DTV_UNDEFINED
  18 =============
  19
  20 Used internally. A GET/SET operation for it won't change or return
  21 anything.
  22
  23
  24 .. _DTV-TUNE:
  25
  26 DTV_TUNE
  27 ========
  28
  29 Interpret the cache of data, build either a traditional frontend
  30 tunerequest so we can pass validation in the ``FE_SET_FRONTEND`` ioctl.
  31
  32
  33 .. _DTV-CLEAR:
  34
  35 DTV_CLEAR
  36 =========
  37
  38 Reset a cache of data specific to the frontend here. This does not
  39 effect hardware.
  40
  41
  42 .. _DTV-FREQUENCY:
  43
  44 DTV_FREQUENCY
  45 =============
  46
  47 Frequency of the digital TV transponder/channel.
  48
  49 .. note::
  50
  51   #. For satellite delivery systems, the frequency is in kHz.
  52
  53   #. For cable and terrestrial delivery systems, the frequency is in
  54      Hz.
  55
  56   #. On most delivery systems, the frequency is the center frequency
  57      of the transponder/channel. The exception is for ISDB-T, where
  58      the main carrier has a 1/7 offset from the center.
  59
  60   #. For ISDB-T, the channels are usually transmitted with an offset of
  61      about 143kHz. E.g. a valid frequency could be 474,143 kHz. The
  62      stepping is  bound to the bandwidth of the channel which is
  63      typically 6MHz.
  64
  65   #. In ISDB-Tsb, the channel consists of only one or three segments the
  66      frequency step is 429kHz, 3*429 respectively.
  67
  68
  69 .. _DTV-MODULATION:
  70
  71 DTV_MODULATION
  72 ==============
  73
  74 Specifies the frontend modulation type for delivery systems that
  75 supports more multiple modulations.
  76
  77 The modulation can be one of the types defined by enum :c:type:`fe_modulation`.
  78
  79 Most of the digital TV standards offers more than one possible
  80 modulation type.
  81
  82 The table below presents a summary of the types of modulation types
  83 supported by each delivery system, as currently defined by specs.
  84
  85 ======================= =======================================================
  86 Standard                Modulation types
  87 ======================= =======================================================
  88 ATSC (version 1)        8-VSB and 16-VSB.
  89 DMTB                    4-QAM, 16-QAM, 32-QAM, 64-QAM and 4-QAM-NR.
  90 DVB-C Annex A/C         16-QAM, 32-QAM, 64-QAM and 256-QAM.
  91 DVB-C Annex B           64-QAM.
  92 DVB-T                   QPSK, 16-QAM and 64-QAM.
  93 DVB-T2                  QPSK, 16-QAM, 64-QAM and 256-QAM.
  94 DVB-S                   No need to set. It supports only QPSK.
  95 DVB-S2                  QPSK, 8-PSK, 16-APSK and 32-APSK.
  96 ISDB-T                  QPSK, DQPSK, 16-QAM and 64-QAM.
  97 ISDB-S                  8-PSK, QPSK and BPSK.
  98 ======================= =======================================================
  99
 100 .. note::
 101
 102    Please notice that some of the above modulation types may not be
 103    defined currently at the Kernel. The reason is simple: no driver
 104    needed such definition yet.
 105
 106
 107 .. _DTV-BANDWIDTH-HZ:
 108
 109 DTV_BANDWIDTH_HZ
 110 ================
 111
 112 Bandwidth for the channel, in HZ.
 113
 114 Should be set only for terrestrial delivery systems.
 115
 116 Possible values: ``1712000``, ``5000000``, ``6000000``, ``7000000``,
 117 ``8000000``, ``10000000``.
 118
 119 ======================= =======================================================
 120 Terrestrial Standard    Possible values for bandwidth
 121 ======================= =======================================================
 122 ATSC (version 1)        No need to set. It is always 6MHz.
 123 DMTB                    No need to set. It is always 8MHz.
 124 DVB-T                   6MHz, 7MHz and 8MHz.
 125 DVB-T2                  1.172 MHz, 5MHz, 6MHz, 7MHz, 8MHz and 10MHz
 126 ISDB-T                  5MHz, 6MHz, 7MHz and 8MHz, although most places
 127                         use 6MHz.
 128 ======================= =======================================================
 129
 130
 131 .. note::
 132
 133
 134   #. For ISDB-Tsb, the bandwidth can vary depending on the number of
 135      connected segments.
 136
 137      It can be easily derived from other parameters
 138      (DTV_ISDBT_SB_SEGMENT_IDX, DTV_ISDBT_SB_SEGMENT_COUNT).
 139
 140   #. On Satellite and Cable delivery systems, the bandwidth depends on
 141      the symbol rate. So, the Kernel will silently ignore any setting
 142      :ref:`DTV-BANDWIDTH-HZ`. I will however fill it back with a
 143      bandwidth estimation.
 144
 145      Such bandwidth estimation takes into account the symbol rate set with
 146      :ref:`DTV-SYMBOL-RATE`, and the rolloff factor, with is fixed for
 147      DVB-C and DVB-S.
 148
 149      For DVB-S2, the rolloff should also be set via :ref:`DTV-ROLLOFF`.
 150
 151
 152 .. _DTV-INVERSION:
 153
 154 DTV_INVERSION
 155 =============
 156
 157 Specifies if the frontend should do spectral inversion or not.
 158
 159 The acceptable values are defined by :c:type:`fe_spectral_inversion`.
 160
 161
 162 .. _DTV-DISEQC-MASTER:
 163
 164 DTV_DISEQC_MASTER
 165 =================
 166
 167 Currently not implemented.
 168
 169
 170 .. _DTV-SYMBOL-RATE:
 171
 172 DTV_SYMBOL_RATE
 173 ===============
 174
 175 Used on cable and satellite delivery systems.
 176
 177 Digital TV symbol rate, in bauds (symbols/second).
 178
 179
 180 .. _DTV-INNER-FEC:
 181
 182 DTV_INNER_FEC
 183 =============
 184
 185 Used on cable and satellite delivery systems.
 186
 187 The acceptable values are defined by :c:type:`fe_code_rate`.
 188
 189
 190 .. _DTV-VOLTAGE:
 191
 192 DTV_VOLTAGE
 193 ===========
 194
 195 Used on satellite delivery systems.
 196
 197 The voltage is usually used with non-DiSEqC capable LNBs to switch the
 198 polarzation (horizontal/vertical). When using DiSEqC epuipment this
 199 voltage has to be switched consistently to the DiSEqC commands as
 200 described in the DiSEqC spec.
 201
 202 The acceptable values are defined by :c:type:`fe_sec_voltage`.
 203
 204
 205 .. _DTV-TONE:
 206
 207 DTV_TONE
 208 ========
 209
 210 Currently not used.
 211
 212
 213 .. _DTV-PILOT:
 214
 215 DTV_PILOT
 216 =========
 217
 218 Used on DVB-S2.
 219
 220 Sets DVB-S2 pilot.
 221
 222 The acceptable values are defined by :c:type:`fe_pilot`.
 223
 224
 225 .. _DTV-ROLLOFF:
 226
 227 DTV_ROLLOFF
 228 ===========
 229
 230 Used on DVB-S2.
 231
 232 Sets DVB-S2 rolloff.
 233
 234 The acceptable values are defined by :c:type:`fe_rolloff`.
 235
 236
 237 .. _DTV-DISEQC-SLAVE-REPLY:
 238
 239 DTV_DISEQC_SLAVE_REPLY
 240 ======================
 241
 242 Currently not implemented.
 243
 244
 245 .. _DTV-FE-CAPABILITY-COUNT:
 246
 247 DTV_FE_CAPABILITY_COUNT
 248 =======================
 249
 250 Currently not implemented.
 251
 252
 253 .. _DTV-FE-CAPABILITY:
 254
 255 DTV_FE_CAPABILITY
 256 =================
 257
 258 Currently not implemented.
 259
 260
 261 .. _DTV-DELIVERY-SYSTEM:
 262
 263 DTV_DELIVERY_SYSTEM
 264 ===================
 265
 266 Specifies the type of the delivery system.
 267
 268 The acceptable values are defined by :c:type:`fe_delivery_system`.
 269
 270
 271 .. _DTV-ISDBT-PARTIAL-RECEPTION:
 272
 273 DTV_ISDBT_PARTIAL_RECEPTION
 274 ===========================
 275
 276 Used only on ISDB.
 277
 278 If ``DTV_ISDBT_SOUND_BROADCASTING`` is '0' this bit-field represents
 279 whether the channel is in partial reception mode or not.
 280
 281 If '1' ``DTV_ISDBT_LAYERA_*`` values are assigned to the center segment
 282 and ``DTV_ISDBT_LAYERA_SEGMENT_COUNT`` has to be '1'.
 283
 284 If in addition ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'
 285 ``DTV_ISDBT_PARTIAL_RECEPTION`` represents whether this ISDB-Tsb channel
 286 is consisting of one segment and layer or three segments and two layers.
 287
 288 Possible values: 0, 1, -1 (AUTO)
 289
 290
 291 .. _DTV-ISDBT-SOUND-BROADCASTING:
 292
 293 DTV_ISDBT_SOUND_BROADCASTING
 294 ============================
 295
 296 Used only on ISDB.
 297
 298 This field represents whether the other DTV_ISDBT_*-parameters are
 299 referring to an ISDB-T and an ISDB-Tsb channel. (See also
 300 ``DTV_ISDBT_PARTIAL_RECEPTION``).
 301
 302 Possible values: 0, 1, -1 (AUTO)
 303
 304
 305 .. _DTV-ISDBT-SB-SUBCHANNEL-ID:
 306
 307 DTV_ISDBT_SB_SUBCHANNEL_ID
 308 ==========================
 309
 310 Used only on ISDB.
 311
 312 This field only applies if ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'.
 313
 314 (Note of the author: This might not be the correct description of the
 315 ``SUBCHANNEL-ID`` in all details, but it is my understanding of the
 316 technical background needed to program a device)
 317
 318 An ISDB-Tsb channel (1 or 3 segments) can be broadcasted alone or in a
 319 set of connected ISDB-Tsb channels. In this set of channels every
 320 channel can be received independently. The number of connected ISDB-Tsb
 321 segment can vary, e.g. depending on the frequency spectrum bandwidth
 322 available.
 323
 324 Example: Assume 8 ISDB-Tsb connected segments are broadcasted. The
 325 broadcaster has several possibilities to put those channels in the air:
 326 Assuming a normal 13-segment ISDB-T spectrum he can align the 8 segments
 327 from position 1-8 to 5-13 or anything in between.
 328
 329 The underlying layer of segments are subchannels: each segment is
 330 consisting of several subchannels with a predefined IDs. A sub-channel
 331 is used to help the demodulator to synchronize on the channel.
 332
 333 An ISDB-T channel is always centered over all sub-channels. As for the
 334 example above, in ISDB-Tsb it is no longer as simple as that.
 335
 336 ``The DTV_ISDBT_SB_SUBCHANNEL_ID`` parameter is used to give the
 337 sub-channel ID of the segment to be demodulated.
 338
 339 Possible values: 0 .. 41, -1 (AUTO)
 340
 341
 342 .. _DTV-ISDBT-SB-SEGMENT-IDX:
 343
 344 DTV_ISDBT_SB_SEGMENT_IDX
 345 ========================
 346
 347 Used only on ISDB.
 348
 349 This field only applies if ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'.
 350
 351 ``DTV_ISDBT_SB_SEGMENT_IDX`` gives the index of the segment to be
 352 demodulated for an ISDB-Tsb channel where several of them are
 353 transmitted in the connected manner.
 354
 355 Possible values: 0 .. ``DTV_ISDBT_SB_SEGMENT_COUNT`` - 1
 356
 357 Note: This value cannot be determined by an automatic channel search.
 358
 359
 360 .. _DTV-ISDBT-SB-SEGMENT-COUNT:
 361
 362 DTV_ISDBT_SB_SEGMENT_COUNT
 363 ==========================
 364
 365 Used only on ISDB.
 366
 367 This field only applies if ``DTV_ISDBT_SOUND_BROADCASTING`` is '1'.
 368
 369 ``DTV_ISDBT_SB_SEGMENT_COUNT`` gives the total count of connected
 370 ISDB-Tsb channels.
 371
 372 Possible values: 1 .. 13
 373
 374 Note: This value cannot be determined by an automatic channel search.
 375
 376
 377 .. _isdb-hierq-layers:
 378
 379 DTV-ISDBT-LAYER[A-C] parameters
 380 ===============================
 381
 382 Used only on ISDB.
 383
 384 ISDB-T channels can be coded hierarchically. As opposed to DVB-T in
 385 ISDB-T hierarchical layers can be decoded simultaneously. For that
 386 reason a ISDB-T demodulator has 3 Viterbi and 3 Reed-Solomon decoders.
 387
 388 ISDB-T has 3 hierarchical layers which each can use a part of the
 389 available segments. The total number of segments over all layers has to
 390 13 in ISDB-T.
 391
 392 There are 3 parameter sets, for Layers A, B and C.
 393
 394
 395 .. _DTV-ISDBT-LAYER-ENABLED:
 396
 397 DTV_ISDBT_LAYER_ENABLED
 398 -----------------------
 399
 400 Used only on ISDB.
 401
 402 Hierarchical reception in ISDB-T is achieved by enabling or disabling
 403 layers in the decoding process. Setting all bits of
 404 ``DTV_ISDBT_LAYER_ENABLED`` to '1' forces all layers (if applicable) to
 405 be demodulated. This is the default.
 406
 407 If the channel is in the partial reception mode
 408 (``DTV_ISDBT_PARTIAL_RECEPTION`` = 1) the central segment can be decoded
 409 independently of the other 12 segments. In that mode layer A has to have
 410 a ``SEGMENT_COUNT`` of 1.
 411
 412 In ISDB-Tsb only layer A is used, it can be 1 or 3 in ISDB-Tsb according
 413 to ``DTV_ISDBT_PARTIAL_RECEPTION``. ``SEGMENT_COUNT`` must be filled
 414 accordingly.
 415
 416 Only the values of the first 3 bits are used. Other bits will be silently ignored:
 417
 418 ``DTV_ISDBT_LAYER_ENABLED`` bit 0: layer A enabled
 419
 420 ``DTV_ISDBT_LAYER_ENABLED`` bit 1: layer B enabled
 421
 422 ``DTV_ISDBT_LAYER_ENABLED`` bit 2: layer C enabled
 423
 424 ``DTV_ISDBT_LAYER_ENABLED`` bits 3-31: unused
 425
 426
 427 .. _DTV-ISDBT-LAYER-FEC:
 428
 429 DTV_ISDBT_LAYER[A-C]_FEC
 430 ------------------------
 431
 432 Used only on ISDB.
 433
 434 The Forward Error Correction mechanism used by a given ISDB Layer, as
 435 defined by :c:type:`fe_code_rate`.
 436
 437
 438 Possible values are: ``FEC_AUTO``, ``FEC_1_2``, ``FEC_2_3``, ``FEC_3_4``,
 439 ``FEC_5_6``, ``FEC_7_8``
 440
 441
 442 .. _DTV-ISDBT-LAYER-MODULATION:
 443
 444 DTV_ISDBT_LAYER[A-C]_MODULATION
 445 -------------------------------
 446
 447 Used only on ISDB.
 448
 449 The modulation used by a given ISDB Layer, as defined by
 450 :c:type:`fe_modulation`.
 451
 452 Possible values are: ``QAM_AUTO``, ``QPSK``, ``QAM_16``, ``QAM_64``, ``DQPSK``
 453
 454 .. note::
 455
 456    #. If layer C is ``DQPSK``, then layer B has to be ``DQPSK``.
 457
 458    #. If layer B is ``DQPSK`` and ``DTV_ISDBT_PARTIAL_RECEPTION``\ = 0,
 459       then layer has to be ``DQPSK``.
 460
 461
 462 .. _DTV-ISDBT-LAYER-SEGMENT-COUNT:
 463
 464 DTV_ISDBT_LAYER[A-C]_SEGMENT_COUNT
 465 ----------------------------------
 466
 467 Used only on ISDB.
 468
 469 Possible values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, -1 (AUTO)
 470
 471 Note: Truth table for ``DTV_ISDBT_SOUND_BROADCASTING`` and
 472 ``DTV_ISDBT_PARTIAL_RECEPTION`` and ``LAYER[A-C]_SEGMENT_COUNT``
 473
 474 .. _isdbt-layer_seg-cnt-table:
 475
 476 .. flat-table:: Truth table for ISDB-T Sound Broadcasting
 477     :header-rows:  1
 478     :stub-columns: 0
 479
 480
 481     -  .. row 1
 482
 483        -  Partial Reception
 484
 485        -  Sound Broadcasting
 486
 487        -  Layer A width
 488
 489        -  Layer B width
 490
 491        -  Layer C width
 492
 493        -  total width
 494
 495     -  .. row 2
 496
 497        -  0
 498
 499        -  0
 500
 501        -  1 .. 13
 502
 503        -  1 .. 13
 504
 505        -  1 .. 13
 506
 507        -  13
 508
 509     -  .. row 3
 510
 511        -  1
 512
 513        -  0
 514
 515        -  1
 516
 517        -  1 .. 13
 518
 519        -  1 .. 13
 520
 521        -  13
 522
 523     -  .. row 4
 524
 525        -  0
 526
 527        -  1
 528
 529        -  1
 530
 531        -  0
 532
 533        -  0
 534
 535        -  1
 536
 537     -  .. row 5
 538
 539        -  1
 540
 541        -  1
 542
 543        -  1
 544
 545        -  2
 546
 547        -  0
 548
 549        -  13
 550
 551
 552
 553 .. _DTV-ISDBT-LAYER-TIME-INTERLEAVING:
 554
 555 DTV_ISDBT_LAYER[A-C]_TIME_INTERLEAVING
 556 --------------------------------------
 557
 558 Used only on ISDB.
 559
 560 Valid values: 0, 1, 2, 4, -1 (AUTO)
 561
 562 when DTV_ISDBT_SOUND_BROADCASTING is active, value 8 is also valid.
 563
 564 Note: The real time interleaving length depends on the mode (fft-size).
 565 The values here are referring to what can be found in the
 566 TMCC-structure, as shown in the table below.
 567
 568
 569 .. c:type:: isdbt_layer_interleaving_table
 570
 571 .. flat-table:: ISDB-T time interleaving modes
 572     :header-rows:  1
 573     :stub-columns: 0
 574
 575
 576     -  .. row 1
 577
 578        -  ``DTV_ISDBT_LAYER[A-C]_TIME_INTERLEAVING``
 579
 580        -  Mode 1 (2K FFT)
 581
 582        -  Mode 2 (4K FFT)
 583
 584        -  Mode 3 (8K FFT)
 585
 586     -  .. row 2
 587
 588        -  0
 589
 590        -  0
 591
 592        -  0
 593
 594        -  0
 595
 596     -  .. row 3
 597
 598        -  1
 599
 600        -  4
 601
 602        -  2
 603
 604        -  1
 605
 606     -  .. row 4
 607
 608        -  2
 609
 610        -  8
 611
 612        -  4
 613
 614        -  2
 615
 616     -  .. row 5
 617
 618        -  4
 619
 620        -  16
 621
 622        -  8
 623
 624        -  4
 625
 626
 627
 628 .. _DTV-ATSCMH-FIC-VER:
 629
 630 DTV_ATSCMH_FIC_VER
 631 ------------------
 632
 633 Used only on ATSC-MH.
 634
 635 Version number of the FIC (Fast Information Channel) signaling data.
 636
 637 FIC is used for relaying information to allow rapid service acquisition
 638 by the receiver.
 639
 640 Possible values: 0, 1, 2, 3, ..., 30, 31
 641
 642
 643 .. _DTV-ATSCMH-PARADE-ID:
 644
 645 DTV_ATSCMH_PARADE_ID
 646 --------------------
 647
 648 Used only on ATSC-MH.
 649
 650 Parade identification number
 651
 652 A parade is a collection of up to eight MH groups, conveying one or two
 653 ensembles.
 654
 655 Possible values: 0, 1, 2, 3, ..., 126, 127
 656
 657
 658 .. _DTV-ATSCMH-NOG:
 659
 660 DTV_ATSCMH_NOG
 661 --------------
 662
 663 Used only on ATSC-MH.
 664
 665 Number of MH groups per MH subframe for a designated parade.
 666
 667 Possible values: 1, 2, 3, 4, 5, 6, 7, 8
 668
 669
 670 .. _DTV-ATSCMH-TNOG:
 671
 672 DTV_ATSCMH_TNOG
 673 ---------------
 674
 675 Used only on ATSC-MH.
 676
 677 Total number of MH groups including all MH groups belonging to all MH
 678 parades in one MH subframe.
 679
 680 Possible values: 0, 1, 2, 3, ..., 30, 31
 681
 682
 683 .. _DTV-ATSCMH-SGN:
 684
 685 DTV_ATSCMH_SGN
 686 --------------
 687
 688 Used only on ATSC-MH.
 689
 690 Start group number.
 691
 692 Possible values: 0, 1, 2, 3, ..., 14, 15
 693
 694
 695 .. _DTV-ATSCMH-PRC:
 696
 697 DTV_ATSCMH_PRC
 698 --------------
 699
 700 Used only on ATSC-MH.
 701
 702 Parade repetition cycle.
 703
 704 Possible values: 1, 2, 3, 4, 5, 6, 7, 8
 705
 706
 707 .. _DTV-ATSCMH-RS-FRAME-MODE:
 708
 709 DTV_ATSCMH_RS_FRAME_MODE
 710 ------------------------
 711
 712 Used only on ATSC-MH.
 713
 714 Reed Solomon (RS) frame mode.
 715
 716 The acceptable values are defined by :c:type:`atscmh_rs_frame_mode`.
 717
 718
 719 .. _DTV-ATSCMH-RS-FRAME-ENSEMBLE:
 720
 721 DTV_ATSCMH_RS_FRAME_ENSEMBLE
 722 ----------------------------
 723
 724 Used only on ATSC-MH.
 725
 726 Reed Solomon(RS) frame ensemble.
 727
 728 The acceptable values are defined by :c:type:`atscmh_rs_frame_ensemble`.
 729
 730
 731 .. _DTV-ATSCMH-RS-CODE-MODE-PRI:
 732
 733 DTV_ATSCMH_RS_CODE_MODE_PRI
 734 ---------------------------
 735
 736 Used only on ATSC-MH.
 737
 738 Reed Solomon (RS) code mode (primary).
 739
 740 The acceptable values are defined by :c:type:`atscmh_rs_code_mode`.
 741
 742
 743 .. _DTV-ATSCMH-RS-CODE-MODE-SEC:
 744
 745 DTV_ATSCMH_RS_CODE_MODE_SEC
 746 ---------------------------
 747
 748 Used only on ATSC-MH.
 749
 750 Reed Solomon (RS) code mode (secondary).
 751
 752 The acceptable values are defined by :c:type:`atscmh_rs_code_mode`.
 753
 754
 755 .. _DTV-ATSCMH-SCCC-BLOCK-MODE:
 756
 757 DTV_ATSCMH_SCCC_BLOCK_MODE
 758 --------------------------
 759
 760 Used only on ATSC-MH.
 761
 762 Series Concatenated Convolutional Code Block Mode.
 763
 764 The acceptable values are defined by :c:type:`atscmh_sccc_block_mode`.
 765
 766
 767 .. _DTV-ATSCMH-SCCC-CODE-MODE-A:
 768
 769 DTV_ATSCMH_SCCC_CODE_MODE_A
 770 ---------------------------
 771
 772 Used only on ATSC-MH.
 773
 774 Series Concatenated Convolutional Code Rate.
 775
 776 The acceptable values are defined by :c:type:`atscmh_sccc_code_mode`.
 777
 778 .. _DTV-ATSCMH-SCCC-CODE-MODE-B:
 779
 780 DTV_ATSCMH_SCCC_CODE_MODE_B
 781 ---------------------------
 782
 783 Used only on ATSC-MH.
 784
 785 Series Concatenated Convolutional Code Rate.
 786
 787 Possible values are the same as documented on enum
 788 :c:type:`atscmh_sccc_code_mode`.
 789
 790
 791 .. _DTV-ATSCMH-SCCC-CODE-MODE-C:
 792
 793 DTV_ATSCMH_SCCC_CODE_MODE_C
 794 ---------------------------
 795
 796 Used only on ATSC-MH.
 797
 798 Series Concatenated Convolutional Code Rate.
 799
 800 Possible values are the same as documented on enum
 801 :c:type:`atscmh_sccc_code_mode`.
 802
 803
 804 .. _DTV-ATSCMH-SCCC-CODE-MODE-D:
 805
 806 DTV_ATSCMH_SCCC_CODE_MODE_D
 807 ---------------------------
 808
 809 Used only on ATSC-MH.
 810
 811 Series Concatenated Convolutional Code Rate.
 812
 813 Possible values are the same as documented on enum
 814 :c:type:`atscmh_sccc_code_mode`.
 815
 816
 817 .. _DTV-API-VERSION:
 818
 819 DTV_API_VERSION
 820 ===============
 821
 822 Returns the major/minor version of the Digital TV API
 823
 824
 825 .. _DTV-CODE-RATE-HP:
 826
 827 DTV_CODE_RATE_HP
 828 ================
 829
 830 Used on terrestrial transmissions.
 831
 832 The acceptable values are defined by :c:type:`fe_transmit_mode`.
 833
 834
 835 .. _DTV-CODE-RATE-LP:
 836
 837 DTV_CODE_RATE_LP
 838 ================
 839
 840 Used on terrestrial transmissions.
 841
 842 The acceptable values are defined by :c:type:`fe_transmit_mode`.
 843
 844
 845 .. _DTV-GUARD-INTERVAL:
 846
 847 DTV_GUARD_INTERVAL
 848 ==================
 849
 850 The acceptable values are defined by :c:type:`fe_guard_interval`.
 851
 852 .. note::
 853
 854    #. If ``DTV_GUARD_INTERVAL`` is set the ``GUARD_INTERVAL_AUTO`` the
 855       hardware will try to find the correct guard interval (if capable) and
 856       will use TMCC to fill in the missing parameters.
 857    #. Intervals ``GUARD_INTERVAL_1_128``, ``GUARD_INTERVAL_19_128``
 858       and ``GUARD_INTERVAL_19_256`` are used only for DVB-T2 at
 859       present.
 860    #. Intervals ``GUARD_INTERVAL_PN420``, ``GUARD_INTERVAL_PN595`` and
 861       ``GUARD_INTERVAL_PN945`` are used only for DMTB at the present.
 862       On such standard, only those intervals and ``GUARD_INTERVAL_AUTO``
 863       are valid.
 864
 865 .. _DTV-TRANSMISSION-MODE:
 866
 867 DTV_TRANSMISSION_MODE
 868 =====================
 869
 870
 871 Used only on OFTM-based standards, e. g. DVB-T/T2, ISDB-T, DTMB.
 872
 873 Specifies the FFT size (with corresponds to the approximate number of
 874 carriers) used by the standard.
 875
 876 The acceptable values are defined by :c:type:`fe_transmit_mode`.
 877
 878 .. note::
 879
 880    #. ISDB-T supports three carrier/symbol-size: 8K, 4K, 2K. It is called
 881       **mode** on such standard, and are numbered from 1 to 3:
 882
 883       ====      ========        ========================
 884       Mode      FFT size        Transmission mode
 885       ====      ========        ========================
 886       1         2K              ``TRANSMISSION_MODE_2K``
 887       2         4K              ``TRANSMISSION_MODE_4K``
 888       3         8K              ``TRANSMISSION_MODE_8K``
 889       ====      ========        ========================
 890
 891    #. If ``DTV_TRANSMISSION_MODE`` is set the ``TRANSMISSION_MODE_AUTO``
 892       the hardware will try to find the correct FFT-size (if capable) and
 893       will use TMCC to fill in the missing parameters.
 894
 895    #. DVB-T specifies 2K and 8K as valid sizes.
 896
 897    #. DVB-T2 specifies 1K, 2K, 4K, 8K, 16K and 32K.
 898
 899    #. DTMB specifies C1 and C3780.
 900
 901
 902 .. _DTV-HIERARCHY:
 903
 904 DTV_HIERARCHY
 905 =============
 906
 907 Used only on DVB-T and DVB-T2.
 908
 909 Frontend hierarchy.
 910
 911 The acceptable values are defined by :c:type:`fe_hierarchy`.
 912
 913
 914 .. _DTV-STREAM-ID:
 915
 916 DTV_STREAM_ID
 917 =============
 918
 919 Used on DVB-S2, DVB-T2 and ISDB-S.
 920
 921 DVB-S2, DVB-T2 and ISDB-S support the transmission of several streams on
 922 a single transport stream. This property enables the digital TV driver to
 923 handle substream filtering, when supported by the hardware. By default,
 924 substream filtering is disabled.
 925
 926 For DVB-S2 and DVB-T2, the valid substream id range is from 0 to 255.
 927
 928 For ISDB, the valid substream id range is from 1 to 65535.
 929
 930 To disable it, you should use the special macro NO_STREAM_ID_FILTER.
 931
 932 Note: any value outside the id range also disables filtering.
 933
 934
 935 .. _DTV-DVBT2-PLP-ID-LEGACY:
 936
 937 DTV_DVBT2_PLP_ID_LEGACY
 938 =======================
 939
 940 Obsolete, replaced with DTV_STREAM_ID.
 941
 942
 943 .. _DTV-ENUM-DELSYS:
 944
 945 DTV_ENUM_DELSYS
 946 ===============
 947
 948 A Multi standard frontend needs to advertise the delivery systems
 949 provided. Applications need to enumerate the provided delivery systems,
 950 before using any other operation with the frontend. Prior to it's
 951 introduction, FE_GET_INFO was used to determine a frontend type. A
 952 frontend which provides more than a single delivery system,
 953 FE_GET_INFO doesn't help much. Applications which intends to use a
 954 multistandard frontend must enumerate the delivery systems associated
 955 with it, rather than trying to use FE_GET_INFO. In the case of a
 956 legacy frontend, the result is just the same as with FE_GET_INFO, but
 957 in a more structured format
 958
 959 The acceptable values are defined by :c:type:`fe_delivery_system`.
 960
 961
 962 .. _DTV-INTERLEAVING:
 963
 964 DTV_INTERLEAVING
 965 ================
 966
 967 Time interleaving to be used.
 968
 969 The acceptable values are defined by :c:type:`fe_interleaving`.
 970
 971
 972 .. _DTV-LNA:
 973
 974 DTV_LNA
 975 =======
 976
 977 Low-noise amplifier.
 978
 979 Hardware might offer controllable LNA which can be set manually using
 980 that parameter. Usually LNA could be found only from terrestrial devices
 981 if at all.
 982
 983 Possible values: 0, 1, LNA_AUTO
 984
 985 0, LNA off
 986
 987 1, LNA on
 988
 989 use the special macro LNA_AUTO to set LNA auto