include/uapi/linux/dvb/frontend.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ WITH Linux-syscall-note */
   2 /*
   3  * frontend.h
   4  *
   5  * Copyright (C) 2000 Marcus Metzler <marcus@convergence.de>
   6  *                  Ralph  Metzler <ralph@convergence.de>
   7  *                  Holger Waechtler <holger@convergence.de>
   8  *                  Andre Draszik <ad@convergence.de>
   9  *                  for convergence integrated media GmbH
  10  *
  11  * This program is free software; you can redistribute it and/or
  12  * modify it under the terms of the GNU Lesser General Public License
  13  * as published by the Free Software Foundation; either version 2.1
  14  * of the License, or (at your option) any later version.
  15  *
  16  * This program is distributed in the hope that it will be useful,
  17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19  * GNU General Public License for more details.
  20  *
  21  * You should have received a copy of the GNU Lesser General Public License
  22  * along with this program; if not, write to the Free Software
  23  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  24  *
  25  */
  26
  27 #ifndef _DVBFRONTEND_H_
  28 #define _DVBFRONTEND_H_
  29
  30 #include <linux/types.h>
  31
  32 /**
  33  * enum fe_caps - Frontend capabilities
  34  *
  35  * @FE_IS_STUPID:                       There's something wrong at the
  36  *                                      frontend, and it can't report its
  37  *                                      capabilities.
  38  * @FE_CAN_INVERSION_AUTO:              Can auto-detect frequency spectral
  39  *                                      band inversion
  40  * @FE_CAN_FEC_1_2:                     Supports FEC 1/2
  41  * @FE_CAN_FEC_2_3:                     Supports FEC 2/3
  42  * @FE_CAN_FEC_3_4:                     Supports FEC 3/4
  43  * @FE_CAN_FEC_4_5:                     Supports FEC 4/5
  44  * @FE_CAN_FEC_5_6:                     Supports FEC 5/6
  45  * @FE_CAN_FEC_6_7:                     Supports FEC 6/7
  46  * @FE_CAN_FEC_7_8:                     Supports FEC 7/8
  47  * @FE_CAN_FEC_8_9:                     Supports FEC 8/9
  48  * @FE_CAN_FEC_AUTO:                    Can auto-detect FEC
  49  * @FE_CAN_QPSK:                        Supports QPSK modulation
  50  * @FE_CAN_QAM_16:                      Supports 16-QAM modulation
  51  * @FE_CAN_QAM_32:                      Supports 32-QAM modulation
  52  * @FE_CAN_QAM_64:                      Supports 64-QAM modulation
  53  * @FE_CAN_QAM_128:                     Supports 128-QAM modulation
  54  * @FE_CAN_QAM_256:                     Supports 256-QAM modulation
  55  * @FE_CAN_QAM_AUTO:                    Can auto-detect QAM modulation
  56  * @FE_CAN_TRANSMISSION_MODE_AUTO:      Can auto-detect transmission mode
  57  * @FE_CAN_BANDWIDTH_AUTO:              Can auto-detect bandwidth
  58  * @FE_CAN_GUARD_INTERVAL_AUTO:         Can auto-detect guard interval
  59  * @FE_CAN_HIERARCHY_AUTO:              Can auto-detect hierarchy
  60  * @FE_CAN_8VSB:                        Supports 8-VSB modulation
  61  * @FE_CAN_16VSB:                       Supporta 16-VSB modulation
  62  * @FE_HAS_EXTENDED_CAPS:               Unused
  63  * @FE_CAN_MULTISTREAM:                 Supports multistream filtering
  64  * @FE_CAN_TURBO_FEC:                   Supports "turbo FEC" modulation
  65  * @FE_CAN_2G_MODULATION:               Supports "2nd generation" modulation,
  66  *                                      e. g. DVB-S2, DVB-T2, DVB-C2
  67  * @FE_NEEDS_BENDING:                   Unused
  68  * @FE_CAN_RECOVER:                     Can recover from a cable unplug
  69  *                                      automatically
  70  * @FE_CAN_MUTE_TS:                     Can stop spurious TS data output
  71  */
  72 enum fe_caps {
  73         FE_IS_STUPID                    = 0,
  74         FE_CAN_INVERSION_AUTO           = 0x1,
  75         FE_CAN_FEC_1_2                  = 0x2,
  76         FE_CAN_FEC_2_3                  = 0x4,
  77         FE_CAN_FEC_3_4                  = 0x8,
  78         FE_CAN_FEC_4_5                  = 0x10,
  79         FE_CAN_FEC_5_6                  = 0x20,
  80         FE_CAN_FEC_6_7                  = 0x40,
  81         FE_CAN_FEC_7_8                  = 0x80,
  82         FE_CAN_FEC_8_9                  = 0x100,
  83         FE_CAN_FEC_AUTO                 = 0x200,
  84         FE_CAN_QPSK                     = 0x400,
  85         FE_CAN_QAM_16                   = 0x800,
  86         FE_CAN_QAM_32                   = 0x1000,
  87         FE_CAN_QAM_64                   = 0x2000,
  88         FE_CAN_QAM_128                  = 0x4000,
  89         FE_CAN_QAM_256                  = 0x8000,
  90         FE_CAN_QAM_AUTO                 = 0x10000,
  91         FE_CAN_TRANSMISSION_MODE_AUTO   = 0x20000,
  92         FE_CAN_BANDWIDTH_AUTO           = 0x40000,
  93         FE_CAN_GUARD_INTERVAL_AUTO      = 0x80000,
  94         FE_CAN_HIERARCHY_AUTO           = 0x100000,
  95         FE_CAN_8VSB                     = 0x200000,
  96         FE_CAN_16VSB                    = 0x400000,
  97         FE_HAS_EXTENDED_CAPS            = 0x800000,
  98         FE_CAN_MULTISTREAM              = 0x4000000,
  99         FE_CAN_TURBO_FEC                = 0x8000000,
 100         FE_CAN_2G_MODULATION            = 0x10000000,
 101         FE_NEEDS_BENDING                = 0x20000000,
 102         FE_CAN_RECOVER                  = 0x40000000,
 103         FE_CAN_MUTE_TS                  = 0x80000000
 104 };
 105
 106 /*
 107  * DEPRECATED: Should be kept just due to backward compatibility.
 108  */
 109 enum fe_type {
 110         FE_QPSK,
 111         FE_QAM,
 112         FE_OFDM,
 113         FE_ATSC
 114 };
 115
 116 /**
 117  * struct dvb_frontend_info - Frontend properties and capabilities
 118  *
 119  * @name:                       Name of the frontend
 120  * @type:                       **DEPRECATED**.
 121  *                              Should not be used on modern programs,
 122  *                              as a frontend may have more than one type.
 123  *                              In order to get the support types of a given
 124  *                              frontend, use :c:type:`DTV_ENUM_DELSYS`
 125  *                              instead.
 126  * @frequency_min:              Minimal frequency supported by the frontend.
 127  * @frequency_max:              Minimal frequency supported by the frontend.
 128  * @frequency_stepsize:         All frequencies are multiple of this value.
 129  * @frequency_tolerance:        Frequency tolerance.
 130  * @symbol_rate_min:            Minimal symbol rate, in bauds
 131  *                              (for Cable/Satellite systems).
 132  * @symbol_rate_max:            Maximal symbol rate, in bauds
 133  *                              (for Cable/Satellite systems).
 134  * @symbol_rate_tolerance:      Maximal symbol rate tolerance, in ppm
 135  *                              (for Cable/Satellite systems).
 136  * @notifier_delay:             **DEPRECATED**. Not used by any driver.
 137  * @caps:                       Capabilities supported by the frontend,
 138  *                              as specified in &enum fe_caps.
 139  *
 140  * .. note:
 141  *
 142  *    #. The frequencies are specified in Hz for Terrestrial and Cable
 143  *       systems.
 144  *    #. The frequencies are specified in kHz for Satellite systems.
 145  */
 146 struct dvb_frontend_info {
 147         char       name[128];
 148         enum fe_type type;      /* DEPRECATED. Use DTV_ENUM_DELSYS instead */
 149         __u32      frequency_min;
 150         __u32      frequency_max;
 151         __u32      frequency_stepsize;
 152         __u32      frequency_tolerance;
 153         __u32      symbol_rate_min;
 154         __u32      symbol_rate_max;
 155         __u32      symbol_rate_tolerance;
 156         __u32      notifier_delay;              /* DEPRECATED */
 157         enum fe_caps caps;
 158 };
 159
 160 /**
 161  * struct dvb_diseqc_master_cmd - DiSEqC master command
 162  *
 163  * @msg:
 164  *      DiSEqC message to be sent. It contains a 3 bytes header with:
 165  *      framing + address + command, and an optional argument
 166  *      of up to 3 bytes of data.
 167  * @msg_len:
 168  *      Length of the DiSEqC message. Valid values are 3 to 6.
 169  *
 170  * Check out the DiSEqC bus spec available on http://www.eutelsat.org/ for
 171  * the possible messages that can be used.
 172  */
 173 struct dvb_diseqc_master_cmd {
 174         __u8 msg[6];
 175         __u8 msg_len;
 176 };
 177
 178 /**
 179  * struct dvb_diseqc_slave_reply - DiSEqC received data
 180  *
 181  * @msg:
 182  *      DiSEqC message buffer to store a message received via DiSEqC.
 183  *      It contains one byte header with: framing and
 184  *      an optional argument of up to 3 bytes of data.
 185  * @msg_len:
 186  *      Length of the DiSEqC message. Valid values are 0 to 4,
 187  *      where 0 means no message.
 188  * @timeout:
 189  *      Return from ioctl after timeout ms with errorcode when
 190  *      no message was received.
 191  *
 192  * Check out the DiSEqC bus spec available on http://www.eutelsat.org/ for
 193  * the possible messages that can be used.
 194  */
 195 struct dvb_diseqc_slave_reply {
 196         __u8 msg[4];
 197         __u8 msg_len;
 198         int  timeout;
 199 };
 200
 201 /**
 202  * enum fe_sec_voltage - DC Voltage used to feed the LNBf
 203  *
 204  * @SEC_VOLTAGE_13:     Output 13V to the LNBf
 205  * @SEC_VOLTAGE_18:     Output 18V to the LNBf
 206  * @SEC_VOLTAGE_OFF:    Don't feed the LNBf with a DC voltage
 207  */
 208 enum fe_sec_voltage {
 209         SEC_VOLTAGE_13,
 210         SEC_VOLTAGE_18,
 211         SEC_VOLTAGE_OFF
 212 };
 213
 214 /**
 215  * enum fe_sec_tone_mode - Type of tone to be send to the LNBf.
 216  * @SEC_TONE_ON:        Sends a 22kHz tone burst to the antenna.
 217  * @SEC_TONE_OFF:       Don't send a 22kHz tone to the antenna (except
 218  *                      if the ``FE_DISEQC_*`` ioctls are called).
 219  */
 220 enum fe_sec_tone_mode {
 221         SEC_TONE_ON,
 222         SEC_TONE_OFF
 223 };
 224
 225 /**
 226  * enum fe_sec_mini_cmd - Type of mini burst to be sent
 227  *
 228  * @SEC_MINI_A:         Sends a mini-DiSEqC 22kHz '0' Tone Burst to select
 229  *                      satellite-A
 230  * @SEC_MINI_B:         Sends a mini-DiSEqC 22kHz '1' Data Burst to select
 231  *                      satellite-B
 232  */
 233 enum fe_sec_mini_cmd {
 234         SEC_MINI_A,
 235         SEC_MINI_B
 236 };
 237
 238 /**
 239  * enum fe_status - Enumerates the possible frontend status.
 240  * @FE_NONE:            The frontend doesn't have any kind of lock.
 241  *                      That's the initial frontend status
 242  * @FE_HAS_SIGNAL:      Has found something above the noise level.
 243  * @FE_HAS_CARRIER:     Has found a signal.
 244  * @FE_HAS_VITERBI:     FEC inner coding (Viterbi, LDPC or other inner code).
 245  *                      is stable.
 246  * @FE_HAS_SYNC:        Synchronization bytes was found.
 247  * @FE_HAS_LOCK:        Digital TV were locked and everything is working.
 248  * @FE_TIMEDOUT:        Fo lock within the last about 2 seconds.
 249  * @FE_REINIT:          Frontend was reinitialized, application is recommended
 250  *                      to reset DiSEqC, tone and parameters.
 251  */
 252 enum fe_status {
 253         FE_NONE                 = 0x00,
 254         FE_HAS_SIGNAL           = 0x01,
 255         FE_HAS_CARRIER          = 0x02,
 256         FE_HAS_VITERBI          = 0x04,
 257         FE_HAS_SYNC             = 0x08,
 258         FE_HAS_LOCK             = 0x10,
 259         FE_TIMEDOUT             = 0x20,
 260         FE_REINIT               = 0x40,
 261 };
 262
 263 /**
 264  * enum fe_spectral_inversion - Type of inversion band
 265  *
 266  * @INVERSION_OFF:      Don't do spectral band inversion.
 267  * @INVERSION_ON:       Do spectral band inversion.
 268  * @INVERSION_AUTO:     Autodetect spectral band inversion.
 269  *
 270  * This parameter indicates if spectral inversion should be presumed or
 271  * not. In the automatic setting (``INVERSION_AUTO``) the hardware will try
 272  * to figure out the correct setting by itself. If the hardware doesn't
 273  * support, the %dvb_frontend will try to lock at the carrier first with
 274  * inversion off. If it fails, it will try to enable inversion.
 275  */
 276 enum fe_spectral_inversion {
 277         INVERSION_OFF,
 278         INVERSION_ON,
 279         INVERSION_AUTO
 280 };
 281
 282 /**
 283  * enum fe_code_rate - Type of Forward Error Correction (FEC)
 284  *
 285  *
 286  * @FEC_NONE: No Forward Error Correction Code
 287  * @FEC_1_2:  Forward Error Correction Code 1/2
 288  * @FEC_2_3:  Forward Error Correction Code 2/3
 289  * @FEC_3_4:  Forward Error Correction Code 3/4
 290  * @FEC_4_5:  Forward Error Correction Code 4/5
 291  * @FEC_5_6:  Forward Error Correction Code 5/6
 292  * @FEC_6_7:  Forward Error Correction Code 6/7
 293  * @FEC_7_8:  Forward Error Correction Code 7/8
 294  * @FEC_8_9:  Forward Error Correction Code 8/9
 295  * @FEC_AUTO: Autodetect Error Correction Code
 296  * @FEC_3_5:  Forward Error Correction Code 3/5
 297  * @FEC_9_10: Forward Error Correction Code 9/10
 298  * @FEC_2_5:  Forward Error Correction Code 2/5
 299  *
 300  * Please note that not all FEC types are supported by a given standard.
 301  */
 302 enum fe_code_rate {
 303         FEC_NONE = 0,
 304         FEC_1_2,
 305         FEC_2_3,
 306         FEC_3_4,
 307         FEC_4_5,
 308         FEC_5_6,
 309         FEC_6_7,
 310         FEC_7_8,
 311         FEC_8_9,
 312         FEC_AUTO,
 313         FEC_3_5,
 314         FEC_9_10,
 315         FEC_2_5,
 316 };
 317
 318 /**
 319  * enum fe_modulation - Type of modulation/constellation
 320  * @QPSK:       QPSK modulation
 321  * @QAM_16:     16-QAM modulation
 322  * @QAM_32:     32-QAM modulation
 323  * @QAM_64:     64-QAM modulation
 324  * @QAM_128:    128-QAM modulation
 325  * @QAM_256:    256-QAM modulation
 326  * @QAM_AUTO:   Autodetect QAM modulation
 327  * @VSB_8:      8-VSB modulation
 328  * @VSB_16:     16-VSB modulation
 329  * @PSK_8:      8-PSK modulation
 330  * @APSK_16:    16-APSK modulation
 331  * @APSK_32:    32-APSK modulation
 332  * @DQPSK:      DQPSK modulation
 333  * @QAM_4_NR:   4-QAM-NR modulation
 334  *
 335  * Please note that not all modulations are supported by a given standard.
 336  *
 337  */
 338 enum fe_modulation {
 339         QPSK,
 340         QAM_16,
 341         QAM_32,
 342         QAM_64,
 343         QAM_128,
 344         QAM_256,
 345         QAM_AUTO,
 346         VSB_8,
 347         VSB_16,
 348         PSK_8,
 349         APSK_16,
 350         APSK_32,
 351         DQPSK,
 352         QAM_4_NR,
 353 };
 354
 355 /**
 356  * enum fe_transmit_mode - Transmission mode
 357  *
 358  * @TRANSMISSION_MODE_AUTO:
 359  *      Autodetect transmission mode. The hardware will try to find the
 360  *      correct FFT-size (if capable) to fill in the missing parameters.
 361  * @TRANSMISSION_MODE_1K:
 362  *      Transmission mode 1K
 363  * @TRANSMISSION_MODE_2K:
 364  *      Transmission mode 2K
 365  * @TRANSMISSION_MODE_8K:
 366  *      Transmission mode 8K
 367  * @TRANSMISSION_MODE_4K:
 368  *      Transmission mode 4K
 369  * @TRANSMISSION_MODE_16K:
 370  *      Transmission mode 16K
 371  * @TRANSMISSION_MODE_32K:
 372  *      Transmission mode 32K
 373  * @TRANSMISSION_MODE_C1:
 374  *      Single Carrier (C=1) transmission mode (DTMB only)
 375  * @TRANSMISSION_MODE_C3780:
 376  *      Multi Carrier (C=3780) transmission mode (DTMB only)
 377  *
 378  * Please note that not all transmission modes are supported by a given
 379  * standard.
 380  */
 381 enum fe_transmit_mode {
 382         TRANSMISSION_MODE_2K,
 383         TRANSMISSION_MODE_8K,
 384         TRANSMISSION_MODE_AUTO,
 385         TRANSMISSION_MODE_4K,
 386         TRANSMISSION_MODE_1K,
 387         TRANSMISSION_MODE_16K,
 388         TRANSMISSION_MODE_32K,
 389         TRANSMISSION_MODE_C1,
 390         TRANSMISSION_MODE_C3780,
 391 };
 392
 393 /**
 394  * enum fe_guard_interval - Guard interval
 395  *
 396  * @GUARD_INTERVAL_AUTO:        Autodetect the guard interval
 397  * @GUARD_INTERVAL_1_128:       Guard interval 1/128
 398  * @GUARD_INTERVAL_1_32:        Guard interval 1/32
 399  * @GUARD_INTERVAL_1_16:        Guard interval 1/16
 400  * @GUARD_INTERVAL_1_8:         Guard interval 1/8
 401  * @GUARD_INTERVAL_1_4:         Guard interval 1/4
 402  * @GUARD_INTERVAL_19_128:      Guard interval 19/128
 403  * @GUARD_INTERVAL_19_256:      Guard interval 19/256
 404  * @GUARD_INTERVAL_PN420:       PN length 420 (1/4)
 405  * @GUARD_INTERVAL_PN595:       PN length 595 (1/6)
 406  * @GUARD_INTERVAL_PN945:       PN length 945 (1/9)
 407  *
 408  * Please note that not all guard intervals are supported by a given standard.
 409  */
 410 enum fe_guard_interval {
 411         GUARD_INTERVAL_1_32,
 412         GUARD_INTERVAL_1_16,
 413         GUARD_INTERVAL_1_8,
 414         GUARD_INTERVAL_1_4,
 415         GUARD_INTERVAL_AUTO,
 416         GUARD_INTERVAL_1_128,
 417         GUARD_INTERVAL_19_128,
 418         GUARD_INTERVAL_19_256,
 419         GUARD_INTERVAL_PN420,
 420         GUARD_INTERVAL_PN595,
 421         GUARD_INTERVAL_PN945,
 422 };
 423
 424 /**
 425  * enum fe_hierarchy - Hierarchy
 426  * @HIERARCHY_NONE:     No hierarchy
 427  * @HIERARCHY_AUTO:     Autodetect hierarchy (if supported)
 428  * @HIERARCHY_1:        Hierarchy 1
 429  * @HIERARCHY_2:        Hierarchy 2
 430  * @HIERARCHY_4:        Hierarchy 4
 431  *
 432  * Please note that not all hierarchy types are supported by a given standard.
 433  */
 434 enum fe_hierarchy {
 435         HIERARCHY_NONE,
 436         HIERARCHY_1,
 437         HIERARCHY_2,
 438         HIERARCHY_4,
 439         HIERARCHY_AUTO
 440 };
 441
 442 /**
 443  * enum fe_interleaving - Interleaving
 444  * @INTERLEAVING_NONE:  No interleaving.
 445  * @INTERLEAVING_AUTO:  Auto-detect interleaving.
 446  * @INTERLEAVING_240:   Interleaving of 240 symbols.
 447  * @INTERLEAVING_720:   Interleaving of 720 symbols.
 448  *
 449  * Please note that, currently, only DTMB uses it.
 450  */
 451 enum fe_interleaving {
 452         INTERLEAVING_NONE,
 453         INTERLEAVING_AUTO,
 454         INTERLEAVING_240,
 455         INTERLEAVING_720,
 456 };
 457
 458 /* DVBv5 property Commands */
 459
 460 #define DTV_UNDEFINED           0
 461 #define DTV_TUNE                1
 462 #define DTV_CLEAR               2
 463 #define DTV_FREQUENCY           3
 464 #define DTV_MODULATION          4
 465 #define DTV_BANDWIDTH_HZ        5
 466 #define DTV_INVERSION           6
 467 #define DTV_DISEQC_MASTER       7
 468 #define DTV_SYMBOL_RATE         8
 469 #define DTV_INNER_FEC           9
 470 #define DTV_VOLTAGE             10
 471 #define DTV_TONE                11
 472 #define DTV_PILOT               12
 473 #define DTV_ROLLOFF             13
 474 #define DTV_DISEQC_SLAVE_REPLY  14
 475
 476 /* Basic enumeration set for querying unlimited capabilities */
 477 #define DTV_FE_CAPABILITY_COUNT 15
 478 #define DTV_FE_CAPABILITY       16
 479 #define DTV_DELIVERY_SYSTEM     17
 480
 481 /* ISDB-T and ISDB-Tsb */
 482 #define DTV_ISDBT_PARTIAL_RECEPTION     18
 483 #define DTV_ISDBT_SOUND_BROADCASTING    19
 484
 485 #define DTV_ISDBT_SB_SUBCHANNEL_ID      20
 486 #define DTV_ISDBT_SB_SEGMENT_IDX        21
 487 #define DTV_ISDBT_SB_SEGMENT_COUNT      22
 488
 489 #define DTV_ISDBT_LAYERA_FEC                    23
 490 #define DTV_ISDBT_LAYERA_MODULATION             24
 491 #define DTV_ISDBT_LAYERA_SEGMENT_COUNT          25
 492 #define DTV_ISDBT_LAYERA_TIME_INTERLEAVING      26
 493
 494 #define DTV_ISDBT_LAYERB_FEC                    27
 495 #define DTV_ISDBT_LAYERB_MODULATION             28
 496 #define DTV_ISDBT_LAYERB_SEGMENT_COUNT          29
 497 #define DTV_ISDBT_LAYERB_TIME_INTERLEAVING      30
 498
 499 #define DTV_ISDBT_LAYERC_FEC                    31
 500 #define DTV_ISDBT_LAYERC_MODULATION             32
 501 #define DTV_ISDBT_LAYERC_SEGMENT_COUNT          33
 502 #define DTV_ISDBT_LAYERC_TIME_INTERLEAVING      34
 503
 504 #define DTV_API_VERSION         35
 505
 506 #define DTV_CODE_RATE_HP        36
 507 #define DTV_CODE_RATE_LP        37
 508 #define DTV_GUARD_INTERVAL      38
 509 #define DTV_TRANSMISSION_MODE   39
 510 #define DTV_HIERARCHY           40
 511
 512 #define DTV_ISDBT_LAYER_ENABLED 41
 513
 514 #define DTV_STREAM_ID           42
 515 #define DTV_ISDBS_TS_ID_LEGACY  DTV_STREAM_ID
 516 #define DTV_DVBT2_PLP_ID_LEGACY 43
 517
 518 #define DTV_ENUM_DELSYS         44
 519
 520 /* ATSC-MH */
 521 #define DTV_ATSCMH_FIC_VER              45
 522 #define DTV_ATSCMH_PARADE_ID            46
 523 #define DTV_ATSCMH_NOG                  47
 524 #define DTV_ATSCMH_TNOG                 48
 525 #define DTV_ATSCMH_SGN                  49
 526 #define DTV_ATSCMH_PRC                  50
 527 #define DTV_ATSCMH_RS_FRAME_MODE        51
 528 #define DTV_ATSCMH_RS_FRAME_ENSEMBLE    52
 529 #define DTV_ATSCMH_RS_CODE_MODE_PRI     53
 530 #define DTV_ATSCMH_RS_CODE_MODE_SEC     54
 531 #define DTV_ATSCMH_SCCC_BLOCK_MODE      55
 532 #define DTV_ATSCMH_SCCC_CODE_MODE_A     56
 533 #define DTV_ATSCMH_SCCC_CODE_MODE_B     57
 534 #define DTV_ATSCMH_SCCC_CODE_MODE_C     58
 535 #define DTV_ATSCMH_SCCC_CODE_MODE_D     59
 536
 537 #define DTV_INTERLEAVING                        60
 538 #define DTV_LNA                                 61
 539
 540 /* Quality parameters */
 541 #define DTV_STAT_SIGNAL_STRENGTH        62
 542 #define DTV_STAT_CNR                    63
 543 #define DTV_STAT_PRE_ERROR_BIT_COUNT    64
 544 #define DTV_STAT_PRE_TOTAL_BIT_COUNT    65
 545 #define DTV_STAT_POST_ERROR_BIT_COUNT   66
 546 #define DTV_STAT_POST_TOTAL_BIT_COUNT   67
 547 #define DTV_STAT_ERROR_BLOCK_COUNT      68
 548 #define DTV_STAT_TOTAL_BLOCK_COUNT      69
 549
 550 #define DTV_MAX_COMMAND         DTV_STAT_TOTAL_BLOCK_COUNT
 551
 552 /**
 553  * enum fe_pilot - Type of pilot tone
 554  *
 555  * @PILOT_ON:   Pilot tones enabled
 556  * @PILOT_OFF:  Pilot tones disabled
 557  * @PILOT_AUTO: Autodetect pilot tones
 558  */
 559 enum fe_pilot {
 560         PILOT_ON,
 561         PILOT_OFF,
 562         PILOT_AUTO,
 563 };
 564
 565 /**
 566  * enum fe_rolloff - Rolloff factor
 567  * @ROLLOFF_35:         Roloff factor: α=35%
 568  * @ROLLOFF_20:         Roloff factor: α=20%
 569  * @ROLLOFF_25:         Roloff factor: α=25%
 570  * @ROLLOFF_AUTO:       Auto-detect the roloff factor.
 571  *
 572  * .. note:
 573  *
 574  *    Roloff factor of 35% is implied on DVB-S. On DVB-S2, it is default.
 575  */
 576 enum fe_rolloff {
 577         ROLLOFF_35,
 578         ROLLOFF_20,
 579         ROLLOFF_25,
 580         ROLLOFF_AUTO,
 581 };
 582
 583 /**
 584  * enum fe_delivery_system - Type of the delivery system
 585  *
 586  * @SYS_UNDEFINED:
 587  *      Undefined standard. Generally, indicates an error
 588  * @SYS_DVBC_ANNEX_A:
 589  *      Cable TV: DVB-C following ITU-T J.83 Annex A spec
 590  * @SYS_DVBC_ANNEX_B:
 591  *      Cable TV: DVB-C following ITU-T J.83 Annex B spec (ClearQAM)
 592  * @SYS_DVBC_ANNEX_C:
 593  *      Cable TV: DVB-C following ITU-T J.83 Annex C spec
 594  * @SYS_ISDBC:
 595  *      Cable TV: ISDB-C (no drivers yet)
 596  * @SYS_DVBT:
 597  *      Terrestrial TV: DVB-T
 598  * @SYS_DVBT2:
 599  *      Terrestrial TV: DVB-T2
 600  * @SYS_ISDBT:
 601  *      Terrestrial TV: ISDB-T
 602  * @SYS_ATSC:
 603  *      Terrestrial TV: ATSC
 604  * @SYS_ATSCMH:
 605  *      Terrestrial TV (mobile): ATSC-M/H
 606  * @SYS_DTMB:
 607  *      Terrestrial TV: DTMB
 608  * @SYS_DVBS:
 609  *      Satellite TV: DVB-S
 610  * @SYS_DVBS2:
 611  *      Satellite TV: DVB-S2
 612  * @SYS_TURBO:
 613  *      Satellite TV: DVB-S Turbo
 614  * @SYS_ISDBS:
 615  *      Satellite TV: ISDB-S
 616  * @SYS_DAB:
 617  *      Digital audio: DAB (not fully supported)
 618  * @SYS_DSS:
 619  *      Satellite TV: DSS (not fully supported)
 620  * @SYS_CMMB:
 621  *      Terrestrial TV (mobile): CMMB (not fully supported)
 622  * @SYS_DVBH:
 623  *      Terrestrial TV (mobile): DVB-H (standard deprecated)
 624  */
 625 enum fe_delivery_system {
 626         SYS_UNDEFINED,
 627         SYS_DVBC_ANNEX_A,
 628         SYS_DVBC_ANNEX_B,
 629         SYS_DVBT,
 630         SYS_DSS,
 631         SYS_DVBS,
 632         SYS_DVBS2,
 633         SYS_DVBH,
 634         SYS_ISDBT,
 635         SYS_ISDBS,
 636         SYS_ISDBC,
 637         SYS_ATSC,
 638         SYS_ATSCMH,
 639         SYS_DTMB,
 640         SYS_CMMB,
 641         SYS_DAB,
 642         SYS_DVBT2,
 643         SYS_TURBO,
 644         SYS_DVBC_ANNEX_C,
 645 };
 646
 647 /* backward compatibility definitions for delivery systems */
 648 #define SYS_DVBC_ANNEX_AC       SYS_DVBC_ANNEX_A
 649 #define SYS_DMBTH               SYS_DTMB /* DMB-TH is legacy name, use DTMB */
 650
 651 /* ATSC-MH specific parameters */
 652
 653 /**
 654  * enum atscmh_sccc_block_mode - Type of Series Concatenated Convolutional
 655  *                               Code Block Mode.
 656  *
 657  * @ATSCMH_SCCC_BLK_SEP:
 658  *      Separate SCCC: the SCCC outer code mode shall be set independently
 659  *      for each Group Region (A, B, C, D)
 660  * @ATSCMH_SCCC_BLK_COMB:
 661  *      Combined SCCC: all four Regions shall have the same SCCC outer
 662  *      code mode.
 663  * @ATSCMH_SCCC_BLK_RES:
 664  *      Reserved. Shouldn't be used.
 665  */
 666 enum atscmh_sccc_block_mode {
 667         ATSCMH_SCCC_BLK_SEP      = 0,
 668         ATSCMH_SCCC_BLK_COMB     = 1,
 669         ATSCMH_SCCC_BLK_RES      = 2,
 670 };
 671
 672 /**
 673  * enum atscmh_sccc_code_mode - Type of Series Concatenated Convolutional
 674  *                              Code Rate.
 675  *
 676  * @ATSCMH_SCCC_CODE_HLF:
 677  *      The outer code rate of a SCCC Block is 1/2 rate.
 678  * @ATSCMH_SCCC_CODE_QTR:
 679  *      The outer code rate of a SCCC Block is 1/4 rate.
 680  * @ATSCMH_SCCC_CODE_RES:
 681  *      Reserved. Should not be used.
 682  */
 683 enum atscmh_sccc_code_mode {
 684         ATSCMH_SCCC_CODE_HLF     = 0,
 685         ATSCMH_SCCC_CODE_QTR     = 1,
 686         ATSCMH_SCCC_CODE_RES     = 2,
 687 };
 688
 689 /**
 690  * enum atscmh_rs_frame_ensemble - Reed Solomon(RS) frame ensemble.
 691  *
 692  * @ATSCMH_RSFRAME_ENS_PRI:     Primary Ensemble.
 693  * @ATSCMH_RSFRAME_ENS_SEC:     Secondary Ensemble.
 694  */
 695 enum atscmh_rs_frame_ensemble {
 696         ATSCMH_RSFRAME_ENS_PRI   = 0,
 697         ATSCMH_RSFRAME_ENS_SEC   = 1,
 698 };
 699
 700 /**
 701  * enum atscmh_rs_frame_mode - Reed Solomon (RS) frame mode.
 702  *
 703  * @ATSCMH_RSFRAME_PRI_ONLY:
 704  *      Single Frame: There is only a primary RS Frame for all Group
 705  *      Regions.
 706  * @ATSCMH_RSFRAME_PRI_SEC:
 707  *      Dual Frame: There are two separate RS Frames: Primary RS Frame for
 708  *      Group Region A and B and Secondary RS Frame for Group Region C and
 709  *      D.
 710  * @ATSCMH_RSFRAME_RES:
 711  *      Reserved. Shouldn't be used.
 712  */
 713 enum atscmh_rs_frame_mode {
 714         ATSCMH_RSFRAME_PRI_ONLY  = 0,
 715         ATSCMH_RSFRAME_PRI_SEC   = 1,
 716         ATSCMH_RSFRAME_RES       = 2,
 717 };
 718
 719 /**
 720  * enum atscmh_rs_code_mode
 721  * @ATSCMH_RSCODE_211_187:      Reed Solomon code (211,187).
 722  * @ATSCMH_RSCODE_223_187:      Reed Solomon code (223,187).
 723  * @ATSCMH_RSCODE_235_187:      Reed Solomon code (235,187).
 724  * @ATSCMH_RSCODE_RES:          Reserved. Shouldn't be used.
 725  */
 726 enum atscmh_rs_code_mode {
 727         ATSCMH_RSCODE_211_187    = 0,
 728         ATSCMH_RSCODE_223_187    = 1,
 729         ATSCMH_RSCODE_235_187    = 2,
 730         ATSCMH_RSCODE_RES        = 3,
 731 };
 732
 733 #define NO_STREAM_ID_FILTER     (~0U)
 734 #define LNA_AUTO                (~0U)
 735
 736 /**
 737  * enum fecap_scale_params - scale types for the quality parameters.
 738  *
 739  * @FE_SCALE_NOT_AVAILABLE: That QoS measure is not available. That
 740  *                          could indicate a temporary or a permanent
 741  *                          condition.
 742  * @FE_SCALE_DECIBEL: The scale is measured in 0.001 dB steps, typically
 743  *                    used on signal measures.
 744  * @FE_SCALE_RELATIVE: The scale is a relative percentual measure,
 745  *                     ranging from 0 (0%) to 0xffff (100%).
 746  * @FE_SCALE_COUNTER: The scale counts the occurrence of an event, like
 747  *                    bit error, block error, lapsed time.
 748  */
 749 enum fecap_scale_params {
 750         FE_SCALE_NOT_AVAILABLE = 0,
 751         FE_SCALE_DECIBEL,
 752         FE_SCALE_RELATIVE,
 753         FE_SCALE_COUNTER
 754 };
 755
 756 /**
 757  * struct dtv_stats - Used for reading a DTV status property
 758  *
 759  * @scale:      Filled with enum fecap_scale_params - the scale
 760  *              in usage for that parameter
 761  *
 762  * The ``{unnamed_union}`` may have either one of the values below:
 763  *
 764  * %svalue
 765  *      integer value of the measure, for %FE_SCALE_DECIBEL,
 766  *      used for dB measures. The unit is 0.001 dB.
 767  *
 768  * %uvalue
 769  *      unsigned integer value of the measure, used when @scale is
 770  *      either %FE_SCALE_RELATIVE or %FE_SCALE_COUNTER.
 771  *
 772  * For most delivery systems, this will return a single value for each
 773  * parameter.
 774  *
 775  * It should be noticed, however, that new OFDM delivery systems like
 776  * ISDB can use different modulation types for each group of carriers.
 777  * On such standards, up to 8 groups of statistics can be provided, one
 778  * for each carrier group (called "layer" on ISDB).
 779  *
 780  * In order to be consistent with other delivery systems, the first
 781  * value refers to the entire set of carriers ("global").
 782  *
 783  * @scale should use the value %FE_SCALE_NOT_AVAILABLE when
 784  * the value for the entire group of carriers or from one specific layer
 785  * is not provided by the hardware.
 786  *
 787  * @len should be filled with the latest filled status + 1.
 788  *
 789  * In other words, for ISDB, those values should be filled like::
 790  *
 791  *      u.st.stat.svalue[0] = global statistics;
 792  *      u.st.stat.scale[0] = FE_SCALE_DECIBEL;
 793  *      u.st.stat.value[1] = layer A statistics;
 794  *      u.st.stat.scale[1] = FE_SCALE_NOT_AVAILABLE (if not available);
 795  *      u.st.stat.svalue[2] = layer B statistics;
 796  *      u.st.stat.scale[2] = FE_SCALE_DECIBEL;
 797  *      u.st.stat.svalue[3] = layer C statistics;
 798  *      u.st.stat.scale[3] = FE_SCALE_DECIBEL;
 799  *      u.st.len = 4;
 800  */
 801 struct dtv_stats {
 802         __u8 scale;     /* enum fecap_scale_params type */
 803         union {
 804                 __u64 uvalue;   /* for counters and relative scales */
 805                 __s64 svalue;   /* for 0.001 dB measures */
 806         };
 807 } __attribute__ ((packed));
 808
 809
 810 #define MAX_DTV_STATS   4
 811
 812 /**
 813  * struct dtv_fe_stats - store Digital TV frontend statistics
 814  *
 815  * @len:        length of the statistics - if zero, stats is disabled.
 816  * @stat:       array with digital TV statistics.
 817  *
 818  * On most standards, @len can either be 0 or 1. However, for ISDB, each
 819  * layer is modulated in separate. So, each layer may have its own set
 820  * of statistics. If so, stat[0] carries on a global value for the property.
 821  * Indexes 1 to 3 means layer A to B.
 822  */
 823 struct dtv_fe_stats {
 824         __u8 len;
 825         struct dtv_stats stat[MAX_DTV_STATS];
 826 } __attribute__ ((packed));
 827
 828 /**
 829  * struct dtv_property - store one of frontend command and its value
 830  *
 831  * @cmd:        Digital TV command.
 832  * @reserved:   Not used.
 833  * @u:          Union with the values for the command.
 834  * @result:     Result of the command set (currently unused).
 835  *
 836  * The @u union may have either one of the values below:
 837  *
 838  * %data
 839  *      an unsigned 32-bits number.
 840  * %st
 841  *      a &struct dtv_fe_stats array of statistics.
 842  * %buffer
 843  *      a buffer of up to 32 characters (currently unused).
 844  */
 845 struct dtv_property {
 846         __u32 cmd;
 847         __u32 reserved[3];
 848         union {
 849                 __u32 data;
 850                 struct dtv_fe_stats st;
 851                 struct {
 852                         __u8 data[32];
 853                         __u32 len;
 854                         __u32 reserved1[3];
 855                         void *reserved2;
 856                 } buffer;
 857         } u;
 858         int result;
 859 } __attribute__ ((packed));
 860
 861 /* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
 862 #define DTV_IOCTL_MAX_MSGS 64
 863
 864 /**
 865  * struct dtv_properties - a set of command/value pairs.
 866  *
 867  * @num:        amount of commands stored at the struct.
 868  * @props:      a pointer to &struct dtv_property.
 869  */
 870 struct dtv_properties {
 871         __u32 num;
 872         struct dtv_property *props;
 873 };
 874
 875 /*
 876  * When set, this flag will disable any zigzagging or other "normal" tuning
 877  * behavior. Additionally, there will be no automatic monitoring of the lock
 878  * status, and hence no frontend events will be generated. If a frontend device
 879  * is closed, this flag will be automatically turned off when the device is
 880  * reopened read-write.
 881  */
 882 #define FE_TUNE_MODE_ONESHOT 0x01
 883
 884 /* Digital TV Frontend API calls */
 885
 886 #define FE_GET_INFO                _IOR('o', 61, struct dvb_frontend_info)
 887
 888 #define FE_DISEQC_RESET_OVERLOAD   _IO('o', 62)
 889 #define FE_DISEQC_SEND_MASTER_CMD  _IOW('o', 63, struct dvb_diseqc_master_cmd)
 890 #define FE_DISEQC_RECV_SLAVE_REPLY _IOR('o', 64, struct dvb_diseqc_slave_reply)
 891 #define FE_DISEQC_SEND_BURST       _IO('o', 65)  /* fe_sec_mini_cmd_t */
 892
 893 #define FE_SET_TONE                _IO('o', 66)  /* fe_sec_tone_mode_t */
 894 #define FE_SET_VOLTAGE             _IO('o', 67)  /* fe_sec_voltage_t */
 895 #define FE_ENABLE_HIGH_LNB_VOLTAGE _IO('o', 68)  /* int */
 896
 897 #define FE_READ_STATUS             _IOR('o', 69, fe_status_t)
 898 #define FE_READ_BER                _IOR('o', 70, __u32)
 899 #define FE_READ_SIGNAL_STRENGTH    _IOR('o', 71, __u16)
 900 #define FE_READ_SNR                _IOR('o', 72, __u16)
 901 #define FE_READ_UNCORRECTED_BLOCKS _IOR('o', 73, __u32)
 902
 903 #define FE_SET_FRONTEND_TUNE_MODE  _IO('o', 81) /* unsigned int */
 904 #define FE_GET_EVENT               _IOR('o', 78, struct dvb_frontend_event)
 905
 906 #define FE_DISHNETWORK_SEND_LEGACY_CMD _IO('o', 80) /* unsigned int */
 907
 908 #define FE_SET_PROPERTY            _IOW('o', 82, struct dtv_properties)
 909 #define FE_GET_PROPERTY            _IOR('o', 83, struct dtv_properties)
 910
 911 #if defined(__DVB_CORE__) || !defined(__KERNEL__)
 912
 913 /*
 914  * DEPRECATED: Everything below is deprecated in favor of DVBv5 API
 915  *
 916  * The DVBv3 only ioctls, structs and enums should not be used on
 917  * newer programs, as it doesn't support the second generation of
 918  * digital TV standards, nor supports newer delivery systems.
 919  * They also don't support modern frontends with usually support multiple
 920  * delivery systems.
 921  *
 922  * Drivers shouldn't use them.
 923  *
 924  * New applications should use DVBv5 delivery system instead
 925  */
 926
 927 /*
 928  */
 929
 930 enum fe_bandwidth {
 931         BANDWIDTH_8_MHZ,
 932         BANDWIDTH_7_MHZ,
 933         BANDWIDTH_6_MHZ,
 934         BANDWIDTH_AUTO,
 935         BANDWIDTH_5_MHZ,
 936         BANDWIDTH_10_MHZ,
 937         BANDWIDTH_1_712_MHZ,
 938 };
 939
 940 /* This is kept for legacy userspace support */
 941 typedef enum fe_sec_voltage fe_sec_voltage_t;
 942 typedef enum fe_caps fe_caps_t;
 943 typedef enum fe_type fe_type_t;
 944 typedef enum fe_sec_tone_mode fe_sec_tone_mode_t;
 945 typedef enum fe_sec_mini_cmd fe_sec_mini_cmd_t;
 946 typedef enum fe_status fe_status_t;
 947 typedef enum fe_spectral_inversion fe_spectral_inversion_t;
 948 typedef enum fe_code_rate fe_code_rate_t;
 949 typedef enum fe_modulation fe_modulation_t;
 950 typedef enum fe_transmit_mode fe_transmit_mode_t;
 951 typedef enum fe_bandwidth fe_bandwidth_t;
 952 typedef enum fe_guard_interval fe_guard_interval_t;
 953 typedef enum fe_hierarchy fe_hierarchy_t;
 954 typedef enum fe_pilot fe_pilot_t;
 955 typedef enum fe_rolloff fe_rolloff_t;
 956 typedef enum fe_delivery_system fe_delivery_system_t;
 957
 958 /* DVBv3 structs */
 959
 960 struct dvb_qpsk_parameters {
 961         __u32           symbol_rate;  /* symbol rate in Symbols per second */
 962         fe_code_rate_t  fec_inner;    /* forward error correction (see above) */
 963 };
 964
 965 struct dvb_qam_parameters {
 966         __u32           symbol_rate; /* symbol rate in Symbols per second */
 967         fe_code_rate_t  fec_inner;   /* forward error correction (see above) */
 968         fe_modulation_t modulation;  /* modulation type (see above) */
 969 };
 970
 971 struct dvb_vsb_parameters {
 972         fe_modulation_t modulation;  /* modulation type (see above) */
 973 };
 974
 975 struct dvb_ofdm_parameters {
 976         fe_bandwidth_t      bandwidth;
 977         fe_code_rate_t      code_rate_HP;  /* high priority stream code rate */
 978         fe_code_rate_t      code_rate_LP;  /* low priority stream code rate */
 979         fe_modulation_t     constellation; /* modulation type (see above) */
 980         fe_transmit_mode_t  transmission_mode;
 981         fe_guard_interval_t guard_interval;
 982         fe_hierarchy_t      hierarchy_information;
 983 };
 984
 985 struct dvb_frontend_parameters {
 986         __u32 frequency;  /* (absolute) frequency in Hz for DVB-C/DVB-T/ATSC */
 987                           /* intermediate frequency in kHz for DVB-S */
 988         fe_spectral_inversion_t inversion;
 989         union {
 990                 struct dvb_qpsk_parameters qpsk;        /* DVB-S */
 991                 struct dvb_qam_parameters  qam;         /* DVB-C */
 992                 struct dvb_ofdm_parameters ofdm;        /* DVB-T */
 993                 struct dvb_vsb_parameters vsb;          /* ATSC */
 994         } u;
 995 };
 996
 997 struct dvb_frontend_event {
 998         fe_status_t status;
 999         struct dvb_frontend_parameters parameters;
1000 };
1001
1002 /* DVBv3 API calls */
1003
1004 #define FE_SET_FRONTEND            _IOW('o', 76, struct dvb_frontend_parameters)
1005 #define FE_GET_FRONTEND            _IOR('o', 77, struct dvb_frontend_parameters)
1006
1007 #endif
1008
1009 #endif /*_DVBFRONTEND_H_*/