include/media/tuner.h

   1 /*
   2  * tuner.h - definition for different tuners
   3  *
   4  * Copyright (C) 1997 Markus Schroeder (schroedm@uni-duesseldorf.de)
   5  * minor modifications by Ralph Metzler (rjkm@thp.uni-koeln.de)
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License as published by
   9  * the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  */
  17
  18 #ifndef _TUNER_H
  19 #define _TUNER_H
  20 #ifdef __KERNEL__
  21
  22 #include <linux/videodev2.h>
  23
  24 /**
  25  * enum tuner_pad_index - tuner pad index
  26  *
  27  * @TUNER_PAD_RF_INPUT: Radiofrequency (RF) sink pad, usually linked to a
  28  *                      RF connector entity.
  29  * @TUNER_PAD_OUTPUT:   Tuner output pad. This is actually more complex than
  30  *                      a single pad output, as, in addition to luminance and
  31  *                      chrominance IF a tuner may have internally an
  32  *                      audio decoder (like xc3028) or it may produce an audio
  33  *                      IF that will be used by an audio decoder like msp34xx.
  34  *                      It may also have an IF-PLL demodulator on it, like
  35  *                      tuners with tda9887. Yet, currently, we don't need to
  36  *                      represent all the dirty details, as this is transparent
  37  *                      for the V4L2 API usage. So, let's represent all kinds
  38  *                      of different outputs as a single source pad.
  39  * @TUNER_NUM_PADS:     Number of pads of the tuner.
  40  */
  41 enum tuner_pad_index {
  42         TUNER_PAD_RF_INPUT,
  43         TUNER_PAD_OUTPUT,
  44         TUNER_NUM_PADS
  45 };
  46
  47 #define ADDR_UNSET (255)
  48
  49 #define TUNER_TEMIC_PAL                 0        /* 4002 FH5 (3X 7756, 9483) */
  50 #define TUNER_PHILIPS_PAL_I             1
  51 #define TUNER_PHILIPS_NTSC              2
  52 #define TUNER_PHILIPS_SECAM             3       /* you must actively select B/G, L, L` */
  53
  54 #define TUNER_ABSENT                    4
  55 #define TUNER_PHILIPS_PAL               5
  56 #define TUNER_TEMIC_NTSC                6       /* 4032 FY5 (3X 7004, 9498, 9789)  */
  57 #define TUNER_TEMIC_PAL_I               7       /* 4062 FY5 (3X 8501, 9957) */
  58
  59 #define TUNER_TEMIC_4036FY5_NTSC        8       /* 4036 FY5 (3X 1223, 1981, 7686) */
  60 #define TUNER_ALPS_TSBH1_NTSC           9
  61 #define TUNER_ALPS_TSBE1_PAL            10
  62 #define TUNER_ALPS_TSBB5_PAL_I          11
  63
  64 #define TUNER_ALPS_TSBE5_PAL            12
  65 #define TUNER_ALPS_TSBC5_PAL            13
  66 #define TUNER_TEMIC_4006FH5_PAL         14      /* 4006 FH5 (3X 9500, 9501, 7291) */
  67 #define TUNER_ALPS_TSHC6_NTSC           15
  68
  69 #define TUNER_TEMIC_PAL_DK              16      /* 4016 FY5 (3X 1392, 1393) */
  70 #define TUNER_PHILIPS_NTSC_M            17
  71 #define TUNER_TEMIC_4066FY5_PAL_I       18      /* 4066 FY5 (3X 7032, 7035) */
  72 #define TUNER_TEMIC_4006FN5_MULTI_PAL   19      /* B/G, I and D/K autodetected (3X 7595, 7606, 7657) */
  73
  74 #define TUNER_TEMIC_4009FR5_PAL         20      /* incl. FM radio (3X 7607, 7488, 7711) */
  75 #define TUNER_TEMIC_4039FR5_NTSC        21      /* incl. FM radio (3X 7246, 7578, 7732) */
  76 #define TUNER_TEMIC_4046FM5             22      /* you must actively select B/G, D/K, I, L, L` !  (3X 7804, 7806, 8103, 8104) */
  77 #define TUNER_PHILIPS_PAL_DK            23
  78
  79 #define TUNER_PHILIPS_FQ1216ME          24      /* you must actively select B/G/D/K, I, L, L` */
  80 #define TUNER_LG_PAL_I_FM               25
  81 #define TUNER_LG_PAL_I                  26
  82 #define TUNER_LG_NTSC_FM                27
  83
  84 #define TUNER_LG_PAL_FM                 28
  85 #define TUNER_LG_PAL                    29
  86 #define TUNER_TEMIC_4009FN5_MULTI_PAL_FM 30     /* B/G, I and D/K autodetected (3X 8155, 8160, 8163) */
  87 #define TUNER_SHARP_2U5JF5540_NTSC      31
  88
  89 #define TUNER_Samsung_PAL_TCPM9091PD27  32
  90 #define TUNER_MT2032                    33
  91 #define TUNER_TEMIC_4106FH5             34      /* 4106 FH5 (3X 7808, 7865) */
  92 #define TUNER_TEMIC_4012FY5             35      /* 4012 FY5 (3X 0971, 1099) */
  93
  94 #define TUNER_TEMIC_4136FY5             36      /* 4136 FY5 (3X 7708, 7746) */
  95 #define TUNER_LG_PAL_NEW_TAPC           37
  96 #define TUNER_PHILIPS_FM1216ME_MK3      38
  97 #define TUNER_LG_NTSC_NEW_TAPC          39
  98
  99 #define TUNER_HITACHI_NTSC              40
 100 #define TUNER_PHILIPS_PAL_MK            41
 101 #define TUNER_PHILIPS_FCV1236D          42
 102 #define TUNER_PHILIPS_FM1236_MK3        43
 103
 104 #define TUNER_PHILIPS_4IN1              44      /* ATI TV Wonder Pro - Conexant */
 105         /*
 106          * Microtune merged with Temic 12/31/1999 partially financed by Alps.
 107          * these may be similar to Temic
 108          */
 109 #define TUNER_MICROTUNE_4049FM5         45
 110 #define TUNER_PANASONIC_VP27            46
 111 #define TUNER_LG_NTSC_TAPE              47
 112
 113 #define TUNER_TNF_8831BGFF              48
 114 #define TUNER_MICROTUNE_4042FI5         49      /* DViCO FusionHDTV 3 Gold-Q - 4042 FI5 (3X 8147) */
 115 #define TUNER_TCL_2002N                 50
 116 #define TUNER_PHILIPS_FM1256_IH3        51
 117
 118 #define TUNER_THOMSON_DTT7610           52
 119 #define TUNER_PHILIPS_FQ1286            53
 120 #define TUNER_PHILIPS_TDA8290           54
 121 #define TUNER_TCL_2002MB                55      /* Hauppauge PVR-150 PAL */
 122
 123 #define TUNER_PHILIPS_FQ1216AME_MK4     56      /* Hauppauge PVR-150 PAL */
 124 #define TUNER_PHILIPS_FQ1236A_MK4       57      /* Hauppauge PVR-500MCE NTSC */
 125 #define TUNER_YMEC_TVF_8531MF           58
 126 #define TUNER_YMEC_TVF_5533MF           59      /* Pixelview Pro Ultra NTSC */
 127
 128 #define TUNER_THOMSON_DTT761X           60      /* DTT 7611 7611A 7612 7613 7613A 7614 7615 7615A */
 129 #define TUNER_TENA_9533_DI              61
 130 #define TUNER_TEA5767                   62      /* Only FM Radio Tuner */
 131 #define TUNER_PHILIPS_FMD1216ME_MK3     63
 132
 133 #define TUNER_LG_TDVS_H06XF             64      /* TDVS H061F, H062F, H064F */
 134 #define TUNER_YMEC_TVF66T5_B_DFF        65      /* Acorp Y878F */
 135 #define TUNER_LG_TALN                   66
 136 #define TUNER_PHILIPS_TD1316            67
 137
 138 #define TUNER_PHILIPS_TUV1236D          68      /* ATI HDTV Wonder */
 139 #define TUNER_TNF_5335MF                69      /* Sabrent Bt848   */
 140 #define TUNER_SAMSUNG_TCPN_2121P30A     70      /* Hauppauge PVR-500MCE NTSC */
 141 #define TUNER_XC2028                    71
 142
 143 #define TUNER_THOMSON_FE6600            72      /* DViCO FusionHDTV DVB-T Hybrid */
 144 #define TUNER_SAMSUNG_TCPG_6121P30A     73      /* Hauppauge PVR-500 PAL */
 145 #define TUNER_TDA9887                   74      /* This tuner should be used only internally */
 146 #define TUNER_TEA5761                   75      /* Only FM Radio Tuner */
 147 #define TUNER_XC5000                    76      /* Xceive Silicon Tuner */
 148 #define TUNER_TCL_MF02GIP_5N            77      /* TCL MF02GIP_5N */
 149 #define TUNER_PHILIPS_FMD1216MEX_MK3    78
 150 #define TUNER_PHILIPS_FM1216MK5         79
 151 #define TUNER_PHILIPS_FQ1216LME_MK3     80      /* Active loopthrough, no FM */
 152
 153 #define TUNER_PARTSNIC_PTI_5NF05        81
 154 #define TUNER_PHILIPS_CU1216L           82
 155 #define TUNER_NXP_TDA18271              83
 156 #define TUNER_SONY_BTF_PXN01Z           84
 157 #define TUNER_PHILIPS_FQ1236_MK5        85      /* NTSC, TDA9885, no FM radio */
 158 #define TUNER_TENA_TNF_5337             86
 159
 160 #define TUNER_XC4000                    87      /* Xceive Silicon Tuner */
 161 #define TUNER_XC5000C                   88      /* Xceive Silicon Tuner */
 162
 163 #define TUNER_SONY_BTF_PG472Z           89      /* PAL+SECAM */
 164 #define TUNER_SONY_BTF_PK467Z           90      /* NTSC_JP */
 165 #define TUNER_SONY_BTF_PB463Z           91      /* NTSC */
 166
 167 /* tv card specific */
 168 #define TDA9887_PRESENT                 (1<<0)
 169 #define TDA9887_PORT1_INACTIVE          (1<<1)
 170 #define TDA9887_PORT2_INACTIVE          (1<<2)
 171 #define TDA9887_QSS                     (1<<3)
 172 #define TDA9887_INTERCARRIER            (1<<4)
 173 #define TDA9887_PORT1_ACTIVE            (1<<5)
 174 #define TDA9887_PORT2_ACTIVE            (1<<6)
 175 #define TDA9887_INTERCARRIER_NTSC       (1<<7)
 176 /* Tuner takeover point adjustment, in dB, -16 <= top <= 15 */
 177 #define TDA9887_TOP_MASK                (0x3f << 8)
 178 #define TDA9887_TOP_SET                 (1 << 13)
 179 #define TDA9887_TOP(top)                (TDA9887_TOP_SET | \
 180                                          (((16 + (top)) & 0x1f) << 8))
 181
 182 /* config options */
 183 #define TDA9887_DEEMPHASIS_MASK         (3<<16)
 184 #define TDA9887_DEEMPHASIS_NONE         (1<<16)
 185 #define TDA9887_DEEMPHASIS_50           (2<<16)
 186 #define TDA9887_DEEMPHASIS_75           (3<<16)
 187 #define TDA9887_AUTOMUTE                (1<<18)
 188 #define TDA9887_GATING_18               (1<<19)
 189 #define TDA9887_GAIN_NORMAL             (1<<20)
 190 #define TDA9887_RIF_41_3                (1<<21)  /* radio IF1 41.3 vs 33.3 */
 191
 192 /**
 193  * enum tuner_mode      - Mode of the tuner
 194  *
 195  * @T_RADIO:        Tuner core will work in radio mode
 196  * @T_ANALOG_TV:    Tuner core will work in analog TV mode
 197  *
 198  * Older boards only had a single tuner device, but some devices have a
 199  * separate tuner for radio. In any case, the tuner-core needs to know if
 200  * the tuner chip(s) will be used in radio mode or analog TV mode, as, on
 201  * radio mode, frequencies are specified on a different range than on TV
 202  * mode. This enum is used by the tuner core in order to work with the
 203  * proper tuner range and eventually use a different tuner chip while in
 204  * radio mode.
 205  */
 206 enum tuner_mode {
 207         T_RADIO         = 1 << V4L2_TUNER_RADIO,
 208         T_ANALOG_TV     = 1 << V4L2_TUNER_ANALOG_TV,
 209         /* Don't map V4L2_TUNER_DIGITAL_TV, as tuner-core won't use it */
 210 };
 211
 212 /**
 213  * struct tuner_setup   - setup the tuner chipsets
 214  *
 215  * @addr:               I2C address used to control the tuner device/chipset
 216  * @type:               Type of the tuner, as defined at the TUNER_* macros.
 217  *                      Each different tuner model should have an unique
 218  *                      identifier.
 219  * @mode_mask:          Mask with the allowed tuner modes: V4L2_TUNER_RADIO,
 220  *                      V4L2_TUNER_ANALOG_TV and/or V4L2_TUNER_DIGITAL_TV,
 221  *                      describing if the tuner should be used to support
 222  *                      Radio, analog TV and/or digital TV.
 223  * @config:             Used to send tuner-specific configuration for complex
 224  *                      tuners that require extra parameters to be set.
 225  *                      Only a very few tuners require it and its usage on
 226  *                      newer tuners should be avoided.
 227  * @tuner_callback:     Some tuners require to call back the bridge driver,
 228  *                      in order to do some tasks like rising a GPIO at the
 229  *                      bridge chipset, in order to do things like resetting
 230  *                      the device.
 231  *
 232  * Older boards only had a single tuner device. Nowadays multiple tuner
 233  * devices may be present on a single board. Using TUNER_SET_TYPE_ADDR
 234  * to pass the tuner_setup structure it is possible to setup each tuner
 235  * device in turn.
 236  *
 237  * Since multiple devices may be present it is no longer sufficient to
 238  * send a command to a single i2c device. Instead you should broadcast
 239  * the command to all i2c devices.
 240  *
 241  * By setting the mode_mask correctly you can select which commands are
 242  * accepted by a specific tuner device. For example, set mode_mask to
 243  * T_RADIO if the device is a radio-only tuner. That specific tuner will
 244  * only accept commands when the tuner is in radio mode and ignore them
 245  * when the tuner is set to TV mode.
 246  */
 247
 248 struct tuner_setup {
 249         unsigned short  addr;
 250         unsigned int    type;
 251         unsigned int    mode_mask;
 252         void            *config;
 253         int (*tuner_callback)(void *dev, int component, int cmd, int arg);
 254 };
 255
 256 #endif /* __KERNEL__ */
 257
 258 #endif /* _TUNER_H */