1 /*
2  *  bttv - Bt848 frame grabber driver
3  *
4  *  card ID's and external interfaces of the bttv driver
5  *  basically stuff needed by other drivers (i2c, lirc, ...)
6  *  and is supported not to change much over time.
7  *
8  *  Copyright (C) 1996,97 Ralph Metzler (rjkm@thp.uni-koeln.de)
9  *  (c) 1999,2000 Gerd Knorr <kraxel@goldbach.in-berlin.de>
10  *
11  */
12 
13 #ifndef _BTTV_H_
14 #define _BTTV_H_
15 
16 #include <linux/videodev.h>
17 
18 /* ---------------------------------------------------------- */
19 /* exported by bttv-cards.c                                   */
20 
21 #define BTTV_UNKNOWN       0x00
22 #define BTTV_MIRO          0x01
23 #define BTTV_HAUPPAUGE     0x02
24 #define BTTV_STB           0x03
25 #define BTTV_INTEL         0x04
26 #define BTTV_DIAMOND       0x05
27 #define BTTV_AVERMEDIA     0x06
28 #define BTTV_MATRIX_VISION 0x07
29 #define BTTV_FLYVIDEO      0x08
30 #define BTTV_TURBOTV       0x09
31 #define BTTV_HAUPPAUGE878  0x0a
32 #define BTTV_MIROPRO       0x0b
33 #define BTTV_ADSTECH_TV    0x0c
34 #define BTTV_AVERMEDIA98   0x0d
35 #define BTTV_VHX           0x0e
36 #define BTTV_ZOLTRIX       0x0f
37 #define BTTV_PIXVIEWPLAYTV 0x10
38 #define BTTV_WINVIEW_601   0x11
39 #define BTTV_AVEC_INTERCAP 0x12
40 #define BTTV_LIFE_FLYKIT   0x13
41 #define BTTV_CEI_RAFFLES   0x14
42 #define BTTV_CONFERENCETV  0x15
43 #define BTTV_PHOEBE_TVMAS  0x16
44 #define BTTV_MODTEC_205    0x17
45 #define BTTV_MAGICTVIEW061 0x18
46 #define BTTV_VOBIS_BOOSTAR 0x19
47 #define BTTV_HAUPPAUG_WCAM 0x1a
48 #define BTTV_MAXI          0x1b
49 #define BTTV_TERRATV       0x1c
50 #define BTTV_PXC200        0x1d
51 #define BTTV_FLYVIDEO_98   0x1e
52 #define BTTV_IPROTV        0x1f
53 #define BTTV_INTEL_C_S_PCI 0x20
54 #define BTTV_TERRATVALUE   0x21
55 #define BTTV_WINFAST2000   0x22
56 #define BTTV_CHRONOS_VS2   0x23
57 #define BTTV_TYPHOON_TVIEW 0x24
58 #define BTTV_PXELVWPLTVPRO 0x25
59 #define BTTV_MAGICTVIEW063 0x26
60 #define BTTV_PINNACLE      0x27
61 #define BTTV_STB2          0x28
62 #define BTTV_AVPHONE98     0x29
63 #define BTTV_PV951         0x2a
64 #define BTTV_ONAIR_TV      0x2b
65 #define BTTV_SIGMA_TVII_FM 0x2c
66 #define BTTV_MATRIX_VISION2 0x2d
67 #define BTTV_ZOLTRIX_GENIE 0x2e
68 #define BTTV_TERRATVRADIO  0x2f
69 #define BTTV_DYNALINK      0x30
70 #define BTTV_GVBCTV3PCI    0x31
71 #define BTTV_PXELVWPLTVPAK 0x32
72 #define BTTV_EAGLE         0x33
73 #define BTTV_PINNACLEPRO   0x34
74 #define BTTV_TVIEW_RDS_FM  0x35
75 #define BTTV_LIFETEC_9415  0x36
76 #define BTTV_BESTBUY_EASYTV 0x37
77 #define BTTV_FLYVIDEO_98FM 0x38
78 #define BTTV_GMV1          0x3d
79 #define BTTV_BESTBUY_EASYTV2 0x3e
80 #define BTTV_ATI_TVWONDER  0x3f
81 #define BTTV_ATI_TVWONDERVE 0x40
82 #define BTTV_FLYVIDEO2000   0x41
83 #define BTTV_TERRATVALUER   0x42
84 #define BTTV_GVBCTV4PCI     0x43
85 #define BTTV_VOODOOTV_FM    0x44
86 #define BTTV_AIMMS          0x45
87 #define BTTV_PV_BT878P_PLUS 0x46
88 #define BTTV_FLYVIDEO98EZ   0x47
89 #define BTTV_PV_BT878P_9B   0x48
90 #define BTTV_SENSORAY311    0x49
91 #define BTTV_RV605          0x4a
92 #define BTTV_WINDVR         0x4c
93 #define BTTV_GRANDTEC       0x4d
94 #define BTTV_KWORLD         0x4e
95 #define BTTV_HAUPPAUGEPVR   0x50
96 #define BTTV_GVBCTV5PCI     0x51
97 #define BTTV_OSPREY1x0      0x52
98 #define BTTV_OSPREY1x0_848  0x53
99 #define BTTV_OSPREY101_848  0x54
100 #define BTTV_OSPREY1x1      0x55
101 #define BTTV_OSPREY1x1_SVID 0x56
102 #define BTTV_OSPREY2xx      0x57
103 #define BTTV_OSPREY2x0_SVID 0x58
104 #define BTTV_OSPREY2x0      0x59
105 #define BTTV_OSPREY500      0x5a
106 #define BTTV_OSPREY540      0x5b
107 #define BTTV_OSPREY2000     0x5c
108 #define BTTV_IDS_EAGLE      0x5d
109 #define BTTV_PINNACLESAT    0x5e
110 #define BTTV_FORMAC_PROTV   0x5f
111 #define BTTV_EURESYS_PICOLO 0x61
112 #define BTTV_PV150          0x62
113 #define BTTV_AD_TVK503      0x63
114 #define BTTV_IVC200         0x66
115 #define BTTV_XGUARD         0x67
116 #define BTTV_NEBULA_DIGITV  0x68
117 #define BTTV_PV143          0x69
118 
119 /* i2c address list */
120 #define I2C_TSA5522        0xc2
121 #define I2C_TDA7432        0x8a
122 #define I2C_BT832_ALT1	   0x88
123 #define I2C_BT832_ALT2	   0x8a // alternate setting
124 #define I2C_TDA8425        0x82
125 #define I2C_TDA9840        0x84
126 #define I2C_TDA9850        0xb6 /* also used by 9855,9873 */
127 #define I2C_TDA9874        0xb0 /* also used by 9875 */
128 #define I2C_TDA9875        0xb0
129 #define I2C_HAUPEE         0xa0
130 #define I2C_STBEE          0xae
131 #define I2C_VHX            0xc0
132 #define I2C_MSP3400        0x80
133 #define I2C_MSP3400_ALT    0x88
134 #define I2C_TEA6300        0x80
135 #define I2C_DPL3518	   0x84
136 #define I2C_TDA9887	   0x86
137 
138 /* more card-specific defines */
139 #define PT2254_L_CHANNEL 0x10
140 #define PT2254_R_CHANNEL 0x08
141 #define PT2254_DBS_IN_2 0x400
142 #define PT2254_DBS_IN_10 0x20000
143 #define WINVIEW_PT2254_CLK  0x40
144 #define WINVIEW_PT2254_DATA 0x20
145 #define WINVIEW_PT2254_STROBE 0x80
146 
147 /* digital_mode */
148 #define DIGITAL_MODE_VIDEO 1
149 #define DIGITAL_MODE_CAMERA 2
150 
151 struct bttv;
152 
153 struct tvcard
154 {
155         char *name;
156         unsigned int video_inputs;
157         unsigned int audio_inputs;
158         unsigned int tuner;
159         unsigned int svhs;
160 	unsigned int digital_mode; // DIGITAL_MODE_CAMERA or DIGITAL_MODE_VIDEO
161         u32 gpiomask;
162         u32 muxsel[16];
163         u32 audiomux[6]; /* Tuner, Radio, external, internal, mute, stereo */
164         u32 gpiomask2;   /* GPIO MUX mask */
165 
166 	/* i2c audio flags */
167 	unsigned int no_msp34xx:1;
168 	unsigned int no_tda9875:1;
169 	unsigned int no_tda7432:1;
170 	unsigned int needs_tvaudio:1;
171 	unsigned int msp34xx_alt:1;
172 
173 	/* other settings */
174 	unsigned int pll;
175 #define PLL_NONE 0
176 #define PLL_28   1
177 #define PLL_35   2
178 
179 	unsigned int tuner_type;
180 	unsigned int has_radio;
181 	void (*audio_hook)(struct bttv *btv, struct video_audio *v, int set);
182 	void (*muxsel_hook)(struct bttv *btv, unsigned int input);
183 };
184 
185 extern struct tvcard bttv_tvcards[];
186 extern const unsigned int bttv_num_tvcards;
187 
188 /* identification / initialization of the card */
189 extern void bttv_idcard(struct bttv *btv);
190 extern void bttv_init_card1(struct bttv *btv);
191 extern void bttv_init_card2(struct bttv *btv);
192 
193 /* card-specific funtions */
194 extern void tea5757_set_freq(struct bttv *btv, unsigned short freq);
195 extern void bttv_tda9880_setnorm(struct bttv *btv, int norm);
196 
197 /* kernel cmd line parse helper */
198 extern int bttv_parse(char *str, int max, int *vals);
199 
200 /* extra tweaks for some chipsets */
201 extern void bttv_check_chipset(void);
202 extern int bttv_handle_chipset(struct bttv *btv);
203 
204 /* ---------------------------------------------------------- */
205 /* exported by bttv-if.c                                      */
206 /* interface for gpio access by other modules                 */
207 
208 /* returns card type + card ID (for bt878-based ones)
209    for possible values see lines below beginning with #define BTTV_UNKNOWN
210    returns negative value if error occurred
211 */
212 extern int bttv_get_cardinfo(unsigned int card, int *type,
213 			     unsigned int *cardid);
214 extern struct pci_dev* bttv_get_pcidev(unsigned int card);
215 
216 /* obsolete, use bttv_get_cardinfo instead */
217 extern int bttv_get_id(unsigned int card);
218 
219 /* sets GPOE register (BT848_GPIO_OUT_EN) to new value:
220    data | (current_GPOE_value & ~mask)
221    returns negative value if error occurred
222 */
223 extern int bttv_gpio_enable(unsigned int card,
224 			    unsigned long mask, unsigned long data);
225 
226 /* fills data with GPDATA register contents
227    returns negative value if error occurred
228 */
229 extern int bttv_read_gpio(unsigned int card, unsigned long *data);
230 
231 /* sets GPDATA register to new value:
232   (data & mask) | (current_GPDATA_value & ~mask)
233   returns negative value if error occurred
234 */
235 extern int bttv_write_gpio(unsigned int card,
236 			   unsigned long mask, unsigned long data);
237 
238 /* returns pointer to task queue which can be used as parameter to
239    interruptible_sleep_on
240    in interrupt handler if BT848_INT_GPINT bit is set - this queue is activated
241    (wake_up_interruptible) and following call to the function bttv_read_gpio
242    should return new value of GPDATA,
243    returns NULL value if error occurred or queue is not available
244    WARNING: because there is no buffer for GPIO data, one MUST
245    process data ASAP
246 */
247 extern wait_queue_head_t* bttv_get_gpio_queue(unsigned int card);
248 
249 /* call i2c clients
250 */
251 extern void bttv_i2c_call(unsigned int card, unsigned int cmd, void *arg);
252 
253 
254 /* i2c */
255 extern void bttv_bit_setscl(void *data, int state);
256 extern void bttv_bit_setsda(void *data, int state);
257 extern void bttv_call_i2c_clients(struct bttv *btv, unsigned int cmd, void *arg);
258 extern int bttv_I2CRead(struct bttv *btv, unsigned char addr, char *probe_for);
259 extern int bttv_I2CWrite(struct bttv *btv, unsigned char addr, unsigned char b1,
260 			 unsigned char b2, int both);
261 extern void bttv_readee(struct bttv *btv, unsigned char *eedata, int addr);
262 
263 #endif /* _BTTV_H_ */
264 /*
265  * Local variables:
266  * c-basic-offset: 8
267  * End:
268  */
269