clk: bcm2835: remove use of BCM2835_CLOCK_COUNT in driver
[linux/fpc-iii.git] / include / media / tuner-types.h
blob094e112cc325e4e546d6e64da1ebae2429d9feaa
1 /*
2 * descriptions for simple tuners.
3 */
5 #ifndef __TUNER_TYPES_H__
6 #define __TUNER_TYPES_H__
8 /**
9 * enum param_type - type of the tuner pameters
11 * @TUNER_PARAM_TYPE_RADIO: Tuner params are for FM and/or AM radio
12 * @TUNER_PARAM_TYPE_PAL: Tuner params are for PAL color TV standard
13 * @TUNER_PARAM_TYPE_SECAM: Tuner params are for SECAM color TV standard
14 * @TUNER_PARAM_TYPE_NTSC: Tuner params are for NTSC color TV standard
15 * @TUNER_PARAM_TYPE_DIGITAL: Tuner params are for digital TV
17 enum param_type {
18 TUNER_PARAM_TYPE_RADIO,
19 TUNER_PARAM_TYPE_PAL,
20 TUNER_PARAM_TYPE_SECAM,
21 TUNER_PARAM_TYPE_NTSC,
22 TUNER_PARAM_TYPE_DIGITAL,
25 /**
26 * struct tuner_range - define the frequencies supported by the tuner
28 * @limit: Max frequency supported by that range, in 62.5 kHz
29 * (TV) or 62.5 Hz (Radio), as defined by
30 * V4L2_TUNER_CAP_LOW.
31 * @config: Value of the band switch byte (BB) to setup this mode.
32 * @cb: Value of the CB byte to setup this mode.
34 * Please notice that digital tuners like xc3028/xc4000/xc5000 don't use
35 * those ranges, as they're defined inside the driver. This is used by
36 * analog tuners that are compatible with the "Philips way" to setup the
37 * tuners. On those devices, the tuner set is done via 4 bytes:
38 * divider byte1 (DB1), divider byte 2 (DB2), Control byte (CB) and
39 * band switch byte (BB).
40 * Some tuners also have an additional optional Auxiliary byte (AB).
42 struct tuner_range {
43 unsigned short limit;
44 unsigned char config;
45 unsigned char cb;
48 /**
49 * struct tuner_params - Parameters to be used to setup the tuner. Those
50 * are used by drivers/media/tuners/tuner-types.c in
51 * order to specify the tuner properties. Most of
52 * the parameters are for tuners based on tda9887 IF-PLL
53 * multi-standard analog TV/Radio demodulator, with is
54 * very common on legacy analog tuners.
56 * @type: Type of the tuner parameters, as defined at
57 * enum param_type. If the tuner supports multiple
58 * standards, an array should be used, with one
59 * row per different standard.
60 * @cb_first_if_lower_freq: Many Philips-based tuners have a comment in
61 * their datasheet like
62 * "For channel selection involving band
63 * switching, and to ensure smooth tuning to the
64 * desired channel without causing unnecessary
65 * charge pump action, it is recommended to
66 * consider the difference between wanted channel
67 * frequency and the current channel frequency.
68 * Unnecessary charge pump action will result
69 * in very low tuning voltage which may drive the
70 * oscillator to extreme conditions".
71 * Set cb_first_if_lower_freq to 1, if this check
72 * is required for this tuner. I tested this for
73 * PAL by first setting the TV frequency to
74 * 203 MHz and then switching to 96.6 MHz FM
75 * radio. The result was static unless the
76 * control byte was sent first.
77 * @has_tda9887: Set to 1 if this tuner uses a tda9887
78 * @port1_fm_high_sensitivity: Many Philips tuners use tda9887 PORT1 to select
79 * the FM radio sensitivity. If this setting is 1,
80 * then set PORT1 to 1 to get proper FM reception.
81 * @port2_fm_high_sensitivity: Some Philips tuners use tda9887 PORT2 to select
82 * the FM radio sensitivity. If this setting is 1,
83 * then set PORT2 to 1 to get proper FM reception.
84 * @fm_gain_normal: Some Philips tuners use tda9887 cGainNormal to
85 * select the FM radio sensitivity. If this
86 * setting is 1, e register will use cGainNormal
87 * instead of cGainLow.
88 * @intercarrier_mode: Most tuners with a tda9887 use QSS mode.
89 * Some (cheaper) tuners use Intercarrier mode.
90 * If this setting is 1, then the tuner needs to
91 * be set to intercarrier mode.
92 * @port1_active: This setting sets the default value for PORT1.
93 * 0 means inactive, 1 means active. Note: the
94 * actual bit value written to the tda9887 is
95 * inverted. So a 0 here means a 1 in the B6 bit.
96 * @port2_active: This setting sets the default value for PORT2.
97 * 0 means inactive, 1 means active. Note: the
98 * actual bit value written to the tda9887 is
99 * inverted. So a 0 here means a 1 in the B7 bit.
100 * @port1_invert_for_secam_lc: Sometimes PORT1 is inverted when the SECAM-L'
101 * standard is selected. Set this bit to 1 if this
102 * is needed.
103 * @port2_invert_for_secam_lc: Sometimes PORT2 is inverted when the SECAM-L'
104 * standard is selected. Set this bit to 1 if this
105 * is needed.
106 * @port1_set_for_fm_mono: Some cards require PORT1 to be 1 for mono Radio
107 * FM and 0 for stereo.
108 * @default_pll_gating_18: Select 18% (or according to datasheet 0%)
109 * L standard PLL gating, vs the driver default
110 * of 36%.
111 * @radio_if: IF to use in radio mode. Tuners with a
112 * separate radio IF filter seem to use 10.7,
113 * while those without use 33.3 for PAL/SECAM
114 * tuners and 41.3 for NTSC tuners.
115 * 0 = 10.7, 1 = 33.3, 2 = 41.3
116 * @default_top_low: Default tda9887 TOP value in dB for the low
117 * band. Default is 0. Range: -16:+15
118 * @default_top_mid: Default tda9887 TOP value in dB for the mid
119 * band. Default is 0. Range: -16:+15
120 * @default_top_high: Default tda9887 TOP value in dB for the high
121 * band. Default is 0. Range: -16:+15
122 * @default_top_secam_low: Default tda9887 TOP value in dB for SECAM-L/L'
123 * for the low band. Default is 0. Several tuners
124 * require a different TOP value for the
125 * SECAM-L/L' standards. Range: -16:+15
126 * @default_top_secam_mid: Default tda9887 TOP value in dB for SECAM-L/L'
127 * for the mid band. Default is 0. Several tuners
128 * require a different TOP value for the
129 * SECAM-L/L' standards. Range: -16:+15
130 * @default_top_secam_high: Default tda9887 TOP value in dB for SECAM-L/L'
131 * for the high band. Default is 0. Several tuners
132 * require a different TOP value for the
133 * SECAM-L/L' standards. Range: -16:+15
134 * @iffreq: Intermediate frequency (IF) used by the tuner
135 * on digital mode.
136 * @count: Size of the ranges array.
137 * @ranges: Array with the frequency ranges supported by
138 * the tuner.
140 struct tuner_params {
141 enum param_type type;
143 unsigned int cb_first_if_lower_freq:1;
144 unsigned int has_tda9887:1;
145 unsigned int port1_fm_high_sensitivity:1;
146 unsigned int port2_fm_high_sensitivity:1;
147 unsigned int fm_gain_normal:1;
148 unsigned int intercarrier_mode:1;
149 unsigned int port1_active:1;
150 unsigned int port2_active:1;
151 unsigned int port1_invert_for_secam_lc:1;
152 unsigned int port2_invert_for_secam_lc:1;
153 unsigned int port1_set_for_fm_mono:1;
154 unsigned int default_pll_gating_18:1;
155 unsigned int radio_if:2;
156 signed int default_top_low:5;
157 signed int default_top_mid:5;
158 signed int default_top_high:5;
159 signed int default_top_secam_low:5;
160 signed int default_top_secam_mid:5;
161 signed int default_top_secam_high:5;
163 u16 iffreq;
165 unsigned int count;
166 struct tuner_range *ranges;
169 struct tunertype {
170 char *name;
171 unsigned int count;
172 struct tuner_params *params;
174 u16 min;
175 u16 max;
176 u32 stepsize;
178 u8 *initdata;
179 u8 *sleepdata;
182 extern struct tunertype tuners[];
183 extern unsigned const int tuner_count;
185 #endif