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