linux/include/media/tuner-types.h
<<
>>
Prefs
   1/*
   2 * descriptions for simple tuners.
   3 */
   4
   5#ifndef __TUNER_TYPES_H__
   6#define __TUNER_TYPES_H__
   7
   8enum param_type {
   9        TUNER_PARAM_TYPE_RADIO,
  10        TUNER_PARAM_TYPE_PAL,
  11        TUNER_PARAM_TYPE_SECAM,
  12        TUNER_PARAM_TYPE_NTSC,
  13        TUNER_PARAM_TYPE_DIGITAL,
  14};
  15
  16struct tuner_range {
  17        unsigned short limit;
  18        unsigned char config;
  19        unsigned char cb;
  20};
  21
  22struct tuner_params {
  23        enum param_type type;
  24
  25        /* Many Philips based tuners have a comment like this in their
  26         * datasheet:
  27         *
  28         *   For channel selection involving band switching, and to ensure
  29         *   smooth tuning to the desired channel without causing
  30         *   unnecessary charge pump action, it is recommended to consider
  31         *   the difference between wanted channel frequency and the
  32         *   current channel frequency.  Unnecessary charge pump action
  33         *   will result in very low tuning voltage which may drive the
  34         *   oscillator to extreme conditions.
  35         *
  36         * Set cb_first_if_lower_freq to 1, if this check is
  37         * required for this tuner.
  38         *
  39         * I tested this for PAL by first setting the TV frequency to
  40         * 203 MHz and then switching to 96.6 MHz FM radio. The result was
  41         * static unless the control byte was sent first.
  42         */
  43        unsigned int cb_first_if_lower_freq:1;
  44        /* Set to 1 if this tuner uses a tda9887 */
  45        unsigned int has_tda9887:1;
  46        /* Many Philips tuners use tda9887 PORT1 to select the FM radio
  47           sensitivity. If this setting is 1, then set PORT1 to 1 to
  48           get proper FM reception. */
  49        unsigned int port1_fm_high_sensitivity:1;
  50        /* Some Philips tuners use tda9887 PORT2 to select the FM radio
  51           sensitivity. If this setting is 1, then set PORT2 to 1 to
  52           get proper FM reception. */
  53        unsigned int port2_fm_high_sensitivity:1;
  54        /* Some Philips tuners use tda9887 cGainNormal to select the FM radio
  55           sensitivity. If this setting is 1, e register will use cGainNormal
  56           instead of cGainLow. */
  57        unsigned int fm_gain_normal:1;
  58        /* Most tuners with a tda9887 use QSS mode. Some (cheaper) tuners
  59           use Intercarrier mode. If this setting is 1, then the tuner
  60           needs to be set to intercarrier mode. */
  61        unsigned int intercarrier_mode:1;
  62        /* This setting sets the default value for PORT1.
  63           0 means inactive, 1 means active. Note: the actual bit
  64           value written to the tda9887 is inverted. So a 0 here
  65           means a 1 in the B6 bit. */
  66        unsigned int port1_active:1;
  67        /* This setting sets the default value for PORT2.
  68           0 means inactive, 1 means active. Note: the actual bit
  69           value written to the tda9887 is inverted. So a 0 here
  70           means a 1 in the B7 bit. */
  71        unsigned int port2_active:1;
  72        /* Sometimes PORT1 is inverted when the SECAM-L' standard is selected.
  73           Set this bit to 1 if this is needed. */
  74        unsigned int port1_invert_for_secam_lc:1;
  75        /* Sometimes PORT2 is inverted when the SECAM-L' standard is selected.
  76           Set this bit to 1 if this is needed. */
  77        unsigned int port2_invert_for_secam_lc:1;
  78        /* Some cards require PORT1 to be 1 for mono Radio FM and 0 for stereo. */
  79        unsigned int port1_set_for_fm_mono:1;
  80        /* Select 18% (or according to datasheet 0%) L standard PLL gating,
  81           vs the driver default of 36%. */
  82        unsigned int default_pll_gating_18:1;
  83        /* IF to use in radio mode.  Tuners with a separate radio IF filter
  84           seem to use 10.7, while those without use 33.3 for PAL/SECAM tuners
  85           and 41.3 for NTSC tuners. 0 = 10.7, 1 = 33.3, 2 = 41.3 */
  86        unsigned int radio_if:2;
  87        /* Default tda9887 TOP value in dB for the low band. Default is 0.
  88           Range: -16:+15 */
  89        signed int default_top_low:5;
  90        /* Default tda9887 TOP value in dB for the mid band. Default is 0.
  91           Range: -16:+15 */
  92        signed int default_top_mid:5;
  93        /* Default tda9887 TOP value in dB for the high band. Default is 0.
  94           Range: -16:+15 */
  95        signed int default_top_high:5;
  96        /* Default tda9887 TOP value in dB for SECAM-L/L' for the low band.
  97           Default is 0. Several tuners require a different TOP value for
  98           the SECAM-L/L' standards. Range: -16:+15 */
  99        signed int default_top_secam_low:5;
 100        /* Default tda9887 TOP value in dB for SECAM-L/L' for the mid band.
 101           Default is 0. Several tuners require a different TOP value for
 102           the SECAM-L/L' standards. Range: -16:+15 */
 103        signed int default_top_secam_mid:5;
 104        /* Default tda9887 TOP value in dB for SECAM-L/L' for the high band.
 105           Default is 0. Several tuners require a different TOP value for
 106           the SECAM-L/L' standards. Range: -16:+15 */
 107        signed int default_top_secam_high:5;
 108
 109        u16 iffreq;
 110
 111        unsigned int count;
 112        struct tuner_range *ranges;
 113};
 114
 115struct tunertype {
 116        char *name;
 117        unsigned int count;
 118        struct tuner_params *params;
 119
 120        u16 min;
 121        u16 max;
 122        u32 stepsize;
 123
 124        u8 *initdata;
 125        u8 *sleepdata;
 126};
 127
 128extern struct tunertype tuners[];
 129extern unsigned const int tuner_count;
 130
 131#endif
 132