Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
bttv.h
Go to the documentation of this file.
1 /*
2  *
3  * bttv - Bt848 frame grabber driver
4  *
5  * card ID's and external interfaces of the bttv driver
6  * basically stuff needed by other drivers (i2c, lirc, ...)
7  * and is supported not to change much over time.
8  *
9  * Copyright (C) 1996,97 Ralph Metzler ([email protected])
10  * (c) 1999,2000 Gerd Knorr <[email protected]>
11  *
12  */
13 
14 #ifndef _BTTV_H_
15 #define _BTTV_H_
16 
17 #include <linux/videodev2.h>
18 #include <linux/i2c.h>
19 #include <media/v4l2-device.h>
20 #include <media/i2c-addr.h>
21 #include <media/tuner.h>
22 
23 /* ---------------------------------------------------------- */
24 /* exported by bttv-cards.c */
25 
26 #define BTTV_BOARD_UNKNOWN 0x00
27 #define BTTV_BOARD_MIRO 0x01
28 #define BTTV_BOARD_HAUPPAUGE 0x02
29 #define BTTV_BOARD_STB 0x03
30 #define BTTV_BOARD_INTEL 0x04
31 #define BTTV_BOARD_DIAMOND 0x05
32 #define BTTV_BOARD_AVERMEDIA 0x06
33 #define BTTV_BOARD_MATRIX_VISION 0x07
34 #define BTTV_BOARD_FLYVIDEO 0x08
35 #define BTTV_BOARD_TURBOTV 0x09
36 #define BTTV_BOARD_HAUPPAUGE878 0x0a
37 #define BTTV_BOARD_MIROPRO 0x0b
38 #define BTTV_BOARD_ADSTECH_TV 0x0c
39 #define BTTV_BOARD_AVERMEDIA98 0x0d
40 #define BTTV_BOARD_VHX 0x0e
41 #define BTTV_BOARD_ZOLTRIX 0x0f
42 #define BTTV_BOARD_PIXVIEWPLAYTV 0x10
43 #define BTTV_BOARD_WINVIEW_601 0x11
44 #define BTTV_BOARD_AVEC_INTERCAP 0x12
45 #define BTTV_BOARD_LIFE_FLYKIT 0x13
46 #define BTTV_BOARD_CEI_RAFFLES 0x14
47 #define BTTV_BOARD_CONFERENCETV 0x15
48 #define BTTV_BOARD_PHOEBE_TVMAS 0x16
49 #define BTTV_BOARD_MODTEC_205 0x17
50 #define BTTV_BOARD_MAGICTVIEW061 0x18
51 #define BTTV_BOARD_VOBIS_BOOSTAR 0x19
52 #define BTTV_BOARD_HAUPPAUG_WCAM 0x1a
53 #define BTTV_BOARD_MAXI 0x1b
54 #define BTTV_BOARD_TERRATV 0x1c
55 #define BTTV_BOARD_PXC200 0x1d
56 #define BTTV_BOARD_FLYVIDEO_98 0x1e
57 #define BTTV_BOARD_IPROTV 0x1f
58 #define BTTV_BOARD_INTEL_C_S_PCI 0x20
59 #define BTTV_BOARD_TERRATVALUE 0x21
60 #define BTTV_BOARD_WINFAST2000 0x22
61 #define BTTV_BOARD_CHRONOS_VS2 0x23
62 #define BTTV_BOARD_TYPHOON_TVIEW 0x24
63 #define BTTV_BOARD_PXELVWPLTVPRO 0x25
64 #define BTTV_BOARD_MAGICTVIEW063 0x26
65 #define BTTV_BOARD_PINNACLE 0x27
66 #define BTTV_BOARD_STB2 0x28
67 #define BTTV_BOARD_AVPHONE98 0x29
68 #define BTTV_BOARD_PV951 0x2a
69 #define BTTV_BOARD_ONAIR_TV 0x2b
70 #define BTTV_BOARD_SIGMA_TVII_FM 0x2c
71 #define BTTV_BOARD_MATRIX_VISION2 0x2d
72 #define BTTV_BOARD_ZOLTRIX_GENIE 0x2e
73 #define BTTV_BOARD_TERRATVRADIO 0x2f
74 #define BTTV_BOARD_DYNALINK 0x30
75 #define BTTV_BOARD_GVBCTV3PCI 0x31
76 #define BTTV_BOARD_PXELVWPLTVPAK 0x32
77 #define BTTV_BOARD_EAGLE 0x33
78 #define BTTV_BOARD_PINNACLEPRO 0x34
79 #define BTTV_BOARD_TVIEW_RDS_FM 0x35
80 #define BTTV_BOARD_LIFETEC_9415 0x36
81 #define BTTV_BOARD_BESTBUY_EASYTV 0x37
82 #define BTTV_BOARD_FLYVIDEO_98FM 0x38
83 #define BTTV_BOARD_GRANDTEC 0x39
84 #define BTTV_BOARD_ASKEY_CPH060 0x3a
85 #define BTTV_BOARD_ASKEY_CPH03X 0x3b
86 #define BTTV_BOARD_MM100PCTV 0x3c
87 #define BTTV_BOARD_GMV1 0x3d
88 #define BTTV_BOARD_BESTBUY_EASYTV2 0x3e
89 #define BTTV_BOARD_ATI_TVWONDER 0x3f
90 #define BTTV_BOARD_ATI_TVWONDERVE 0x40
91 #define BTTV_BOARD_FLYVIDEO2000 0x41
92 #define BTTV_BOARD_TERRATVALUER 0x42
93 #define BTTV_BOARD_GVBCTV4PCI 0x43
94 #define BTTV_BOARD_VOODOOTV_FM 0x44
95 #define BTTV_BOARD_AIMMS 0x45
96 #define BTTV_BOARD_PV_BT878P_PLUS 0x46
97 #define BTTV_BOARD_FLYVIDEO98EZ 0x47
98 #define BTTV_BOARD_PV_BT878P_9B 0x48
99 #define BTTV_BOARD_SENSORAY311_611 0x49
100 #define BTTV_BOARD_RV605 0x4a
101 #define BTTV_BOARD_POWERCLR_MTV878 0x4b
102 #define BTTV_BOARD_WINDVR 0x4c
103 #define BTTV_BOARD_GRANDTEC_MULTI 0x4d
104 #define BTTV_BOARD_KWORLD 0x4e
105 #define BTTV_BOARD_DSP_TCVIDEO 0x4f
106 #define BTTV_BOARD_HAUPPAUGEPVR 0x50
107 #define BTTV_BOARD_GVBCTV5PCI 0x51
108 #define BTTV_BOARD_OSPREY1x0 0x52
109 #define BTTV_BOARD_OSPREY1x0_848 0x53
110 #define BTTV_BOARD_OSPREY101_848 0x54
111 #define BTTV_BOARD_OSPREY1x1 0x55
112 #define BTTV_BOARD_OSPREY1x1_SVID 0x56
113 #define BTTV_BOARD_OSPREY2xx 0x57
114 #define BTTV_BOARD_OSPREY2x0_SVID 0x58
115 #define BTTV_BOARD_OSPREY2x0 0x59
116 #define BTTV_BOARD_OSPREY500 0x5a
117 #define BTTV_BOARD_OSPREY540 0x5b
118 #define BTTV_BOARD_OSPREY2000 0x5c
119 #define BTTV_BOARD_IDS_EAGLE 0x5d
120 #define BTTV_BOARD_PINNACLESAT 0x5e
121 #define BTTV_BOARD_FORMAC_PROTV 0x5f
122 #define BTTV_BOARD_MACHTV 0x60
123 #define BTTV_BOARD_EURESYS_PICOLO 0x61
124 #define BTTV_BOARD_PV150 0x62
125 #define BTTV_BOARD_AD_TVK503 0x63
126 #define BTTV_BOARD_HERCULES_SM_TV 0x64
127 #define BTTV_BOARD_PACETV 0x65
128 #define BTTV_BOARD_IVC200 0x66
129 #define BTTV_BOARD_XGUARD 0x67
130 #define BTTV_BOARD_NEBULA_DIGITV 0x68
131 #define BTTV_BOARD_PV143 0x69
132 #define BTTV_BOARD_VD009X1_VD011_MINIDIN 0x6a
133 #define BTTV_BOARD_VD009X1_VD011_COMBI 0x6b
134 #define BTTV_BOARD_VD009_MINIDIN 0x6c
135 #define BTTV_BOARD_VD009_COMBI 0x6d
136 #define BTTV_BOARD_IVC100 0x6e
137 #define BTTV_BOARD_IVC120 0x6f
138 #define BTTV_BOARD_PC_HDTV 0x70
139 #define BTTV_BOARD_TWINHAN_DST 0x71
140 #define BTTV_BOARD_WINFASTVC100 0x72
141 #define BTTV_BOARD_TEV560 0x73
142 #define BTTV_BOARD_SIMUS_GVC1100 0x74
143 #define BTTV_BOARD_NGSTV_PLUS 0x75
144 #define BTTV_BOARD_LMLBT4 0x76
145 #define BTTV_BOARD_TEKRAM_M205 0x77
146 #define BTTV_BOARD_CONTVFMI 0x78
147 #define BTTV_BOARD_PICOLO_TETRA_CHIP 0x79
148 #define BTTV_BOARD_SPIRIT_TV 0x7a
149 #define BTTV_BOARD_AVDVBT_771 0x7b
150 #define BTTV_BOARD_AVDVBT_761 0x7c
151 #define BTTV_BOARD_MATRIX_VISIONSQ 0x7d
152 #define BTTV_BOARD_MATRIX_VISIONSLC 0x7e
153 #define BTTV_BOARD_APAC_VIEWCOMP 0x7f
154 #define BTTV_BOARD_DVICO_DVBT_LITE 0x80
155 #define BTTV_BOARD_VGEAR_MYVCD 0x81
156 #define BTTV_BOARD_SUPER_TV 0x82
157 #define BTTV_BOARD_TIBET_CS16 0x83
158 #define BTTV_BOARD_KODICOM_4400R 0x84
159 #define BTTV_BOARD_KODICOM_4400R_SL 0x85
160 #define BTTV_BOARD_ADLINK_RTV24 0x86
161 #define BTTV_BOARD_DVICO_FUSIONHDTV_5_LITE 0x87
162 #define BTTV_BOARD_ACORP_Y878F 0x88
163 #define BTTV_BOARD_CONCEPTRONIC_CTVFMI2 0x89
164 #define BTTV_BOARD_PV_BT878P_2E 0x8a
165 #define BTTV_BOARD_PV_M4900 0x8b
166 #define BTTV_BOARD_OSPREY440 0x8c
167 #define BTTV_BOARD_ASOUND_SKYEYE 0x8d
168 #define BTTV_BOARD_SABRENT_TVFM 0x8e
169 #define BTTV_BOARD_HAUPPAUGE_IMPACTVCB 0x8f
170 #define BTTV_BOARD_MACHTV_MAGICTV 0x90
171 #define BTTV_BOARD_SSAI_SECURITY 0x91
172 #define BTTV_BOARD_SSAI_ULTRASOUND 0x92
173 #define BTTV_BOARD_VOODOOTV_200 0x93
174 #define BTTV_BOARD_DVICO_FUSIONHDTV_2 0x94
175 #define BTTV_BOARD_TYPHOON_TVTUNERPCI 0x95
176 #define BTTV_BOARD_GEOVISION_GV600 0x96
177 #define BTTV_BOARD_KOZUMI_KTV_01C 0x97
178 #define BTTV_BOARD_ENLTV_FM_2 0x98
179 #define BTTV_BOARD_VD012 0x99
180 #define BTTV_BOARD_VD012_X1 0x9a
181 #define BTTV_BOARD_VD012_X2 0x9b
182 #define BTTV_BOARD_IVCE8784 0x9c
183 #define BTTV_BOARD_GEOVISION_GV800S 0x9d
184 #define BTTV_BOARD_GEOVISION_GV800S_SL 0x9e
185 #define BTTV_BOARD_PV183 0x9f
186 #define BTTV_BOARD_TVT_TD3116 0xa0
187 #define BTTV_BOARD_APOSONIC_WDVR 0xa1
188 
189 /* more card-specific defines */
190 #define PT2254_L_CHANNEL 0x10
191 #define PT2254_R_CHANNEL 0x08
192 #define PT2254_DBS_IN_2 0x400
193 #define PT2254_DBS_IN_10 0x20000
194 #define WINVIEW_PT2254_CLK 0x40
195 #define WINVIEW_PT2254_DATA 0x20
196 #define WINVIEW_PT2254_STROBE 0x80
197 
198 struct bttv_core {
199  /* device structs */
201  struct pci_dev *pci;
203  struct list_head subs; /* struct bttv_sub_device */
204 
205  /* device config */
206  unsigned int nr; /* dev nr (for printk("bttv%d: ..."); */
207  unsigned int type; /* card type (pointer into tvcards[]) */
208 };
209 
210 struct bttv;
211 
212 struct tvcard {
213  char *name;
214  void (*volume_gpio)(struct bttv *btv, __u16 volume);
215  void (*audio_mode_gpio)(struct bttv *btv, struct v4l2_tuner *tuner, int set);
216  void (*muxsel_hook)(struct bttv *btv, unsigned int input);
217 
218  /* MUX bits for each input, two bits per input starting with the LSB */
219  u32 muxsel; /* Use MUXSEL() to set */
220 
222  u32 gpiomux[4]; /* Tuner, Radio, external, internal */
223  u32 gpiomute; /* GPIO mute setting */
224  u32 gpiomask2; /* GPIO MUX mask */
225 
226  unsigned int tuner_type;
228  u8 video_inputs; /* Number of inputs */
229  unsigned int svhs:4; /* Which input is s-video */
230 #define NO_SVHS 15
231  unsigned int pll:2;
232 #define PLL_NONE 0
233 #define PLL_28 1
234 #define PLL_35 2
235 
236  /* i2c audio flags */
237  unsigned int no_msp34xx:1;
238  unsigned int no_tda7432:1;
239  unsigned int msp34xx_alt:1;
240  /* Note: currently no card definition needs to mark the presence
241  of a RDS saa6588 chip. If this is ever needed, then add a new
242  'has_saa6588' bit here. */
243 
244  unsigned int no_video:1; /* video pci function is unused */
245  unsigned int has_dvb:1;
246  unsigned int has_remote:1;
247  unsigned int has_radio:1;
248  unsigned int has_dig_in:1; /* Has digital input (always last input) */
249  unsigned int no_gpioirq:1;
250 };
251 
252 extern struct tvcard bttv_tvcards[];
253 
254 /*
255  * This bit of cpp voodoo is used to create a macro with a variable number of
256  * arguments (1 to 16). It will pack each argument into a word two bits at a
257  * time. It can't be a function because it needs to be compile time constant to
258  * initialize structures. Since each argument must fit in two bits, it's ok
259  * that they are changed to octal. One should not use hex number, macros, or
260  * anything else with this macro. Just use plain integers from 0 to 3.
261  */
262 #define _MUXSELf(a) 0##a << 30
263 #define _MUXSELe(a, b...) 0##a << 28 | _MUXSELf(b)
264 #define _MUXSELd(a, b...) 0##a << 26 | _MUXSELe(b)
265 #define _MUXSELc(a, b...) 0##a << 24 | _MUXSELd(b)
266 #define _MUXSELb(a, b...) 0##a << 22 | _MUXSELc(b)
267 #define _MUXSELa(a, b...) 0##a << 20 | _MUXSELb(b)
268 #define _MUXSEL9(a, b...) 0##a << 18 | _MUXSELa(b)
269 #define _MUXSEL8(a, b...) 0##a << 16 | _MUXSEL9(b)
270 #define _MUXSEL7(a, b...) 0##a << 14 | _MUXSEL8(b)
271 #define _MUXSEL6(a, b...) 0##a << 12 | _MUXSEL7(b)
272 #define _MUXSEL5(a, b...) 0##a << 10 | _MUXSEL6(b)
273 #define _MUXSEL4(a, b...) 0##a << 8 | _MUXSEL5(b)
274 #define _MUXSEL3(a, b...) 0##a << 6 | _MUXSEL4(b)
275 #define _MUXSEL2(a, b...) 0##a << 4 | _MUXSEL3(b)
276 #define _MUXSEL1(a, b...) 0##a << 2 | _MUXSEL2(b)
277 #define MUXSEL(a, b...) (a | _MUXSEL1(b))
278 
279 /* identification / initialization of the card */
280 extern void bttv_idcard(struct bttv *btv);
281 extern void bttv_init_card1(struct bttv *btv);
282 extern void bttv_init_card2(struct bttv *btv);
283 extern void bttv_init_tuner(struct bttv *btv);
284 
285 /* card-specific funtions */
286 extern void tea5757_set_freq(struct bttv *btv, unsigned short freq);
287 extern u32 bttv_tda9880_setnorm(struct bttv *btv, u32 gpiobits);
288 
289 /* extra tweaks for some chipsets */
290 extern void bttv_check_chipset(void);
291 extern int bttv_handle_chipset(struct bttv *btv);
292 
293 /* ---------------------------------------------------------- */
294 /* exported by bttv-if.c */
295 
296 /* this obsolete -- please use the sysfs-based
297  interface below for new code */
298 
299 extern struct pci_dev* bttv_get_pcidev(unsigned int card);
300 
301 /* sets GPOE register (BT848_GPIO_OUT_EN) to new value:
302  data | (current_GPOE_value & ~mask)
303  returns negative value if error occurred
304 */
305 extern int bttv_gpio_enable(unsigned int card,
306  unsigned long mask, unsigned long data);
307 
308 /* fills data with GPDATA register contents
309  returns negative value if error occurred
310 */
311 extern int bttv_read_gpio(unsigned int card, unsigned long *data);
312 
313 /* sets GPDATA register to new value:
314  (data & mask) | (current_GPDATA_value & ~mask)
315  returns negative value if error occurred
316 */
317 extern int bttv_write_gpio(unsigned int card,
318  unsigned long mask, unsigned long data);
319 
320 
321 
322 
323 /* ---------------------------------------------------------- */
324 /* sysfs/driver-moded based gpio access interface */
325 
327  struct device dev;
328  struct bttv_core *core;
329  struct list_head list;
330 };
331 #define to_bttv_sub_dev(x) container_of((x), struct bttv_sub_device, dev)
332 
335  char wanted[20];
336  int (*probe)(struct bttv_sub_device *sub);
337  void (*remove)(struct bttv_sub_device *sub);
338 };
339 #define to_bttv_sub_drv(x) container_of((x), struct bttv_sub_driver, drv)
340 
341 int bttv_sub_register(struct bttv_sub_driver *drv, char *wanted);
342 int bttv_sub_unregister(struct bttv_sub_driver *drv);
343 
344 /* gpio access functions */
345 void bttv_gpio_inout(struct bttv_core *core, u32 mask, u32 outbits);
347 void bttv_gpio_write(struct bttv_core *core, u32 value);
348 void bttv_gpio_bits(struct bttv_core *core, u32 mask, u32 bits);
349 
350 #define gpio_inout(mask,bits) bttv_gpio_inout(&btv->c, mask, bits)
351 #define gpio_read() bttv_gpio_read(&btv->c)
352 #define gpio_write(value) bttv_gpio_write(&btv->c, value)
353 #define gpio_bits(mask,bits) bttv_gpio_bits(&btv->c, mask, bits)
354 
355 
356 /* ---------------------------------------------------------- */
357 /* i2c */
358 
359 #define bttv_call_all(btv, o, f, args...) \
360  v4l2_device_call_all(&btv->c.v4l2_dev, 0, o, f, ##args)
361 
362 extern int bttv_I2CRead(struct bttv *btv, unsigned char addr, char *probe_for);
363 extern int bttv_I2CWrite(struct bttv *btv, unsigned char addr, unsigned char b1,
364  unsigned char b2, int both);
365 extern void bttv_readee(struct bttv *btv, unsigned char *eedata, int addr);
366 
367 extern int bttv_input_init(struct bttv *dev);
368 extern void bttv_input_fini(struct bttv *dev);
369 extern void bttv_input_irq(struct bttv *dev);
370 
371 #endif /* _BTTV_H_ */
372 /*
373  * Local variables:
374  * c-basic-offset: 8
375  * End:
376  */