drivers/media/video/bttv.h

   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 (rjkm@thp.uni-koeln.de)
  10  *  (c) 1999,2000 Gerd Knorr <kraxel@goldbach.in-berlin.de>
  11  *
  12  */
  13
  14 #ifndef _BTTV_H_
  15 #define _BTTV_H_
  16
  17 #include <linux/videodev.h>
  18 #include <linux/i2c.h>
  19
  20 /* ---------------------------------------------------------- */
  21 /* exported by bttv-cards.c                                   */
  22
  23 #define BTTV_BOARD_UNKNOWN                 0x00
  24 #define BTTV_BOARD_MIRO                    0x01
  25 #define BTTV_BOARD_HAUPPAUGE               0x02
  26 #define BTTV_BOARD_STB                     0x03
  27 #define BTTV_BOARD_INTEL                   0x04
  28 #define BTTV_BOARD_DIAMOND                 0x05
  29 #define BTTV_BOARD_AVERMEDIA               0x06
  30 #define BTTV_BOARD_MATRIX_VISION           0x07
  31 #define BTTV_BOARD_FLYVIDEO                0x08
  32 #define BTTV_BOARD_TURBOTV                 0x09
  33 #define BTTV_BOARD_HAUPPAUGE878            0x0a
  34 #define BTTV_BOARD_MIROPRO                 0x0b
  35 #define BTTV_BOARD_ADSTECH_TV              0x0c
  36 #define BTTV_BOARD_AVERMEDIA98             0x0d
  37 #define BTTV_BOARD_VHX                     0x0e
  38 #define BTTV_BOARD_ZOLTRIX                 0x0f
  39 #define BTTV_BOARD_PIXVIEWPLAYTV           0x10
  40 #define BTTV_BOARD_WINVIEW_601             0x11
  41 #define BTTV_BOARD_AVEC_INTERCAP           0x12
  42 #define BTTV_BOARD_LIFE_FLYKIT             0x13
  43 #define BTTV_BOARD_CEI_RAFFLES             0x14
  44 #define BTTV_BOARD_CONFERENCETV            0x15
  45 #define BTTV_BOARD_PHOEBE_TVMAS            0x16
  46 #define BTTV_BOARD_MODTEC_205              0x17
  47 #define BTTV_BOARD_MAGICTVIEW061           0x18
  48 #define BTTV_BOARD_VOBIS_BOOSTAR           0x19
  49 #define BTTV_BOARD_HAUPPAUG_WCAM           0x1a
  50 #define BTTV_BOARD_MAXI                    0x1b
  51 #define BTTV_BOARD_TERRATV                 0x1c
  52 #define BTTV_BOARD_PXC200                  0x1d
  53 #define BTTV_BOARD_FLYVIDEO_98             0x1e
  54 #define BTTV_BOARD_IPROTV                  0x1f
  55 #define BTTV_BOARD_INTEL_C_S_PCI           0x20
  56 #define BTTV_BOARD_TERRATVALUE             0x21
  57 #define BTTV_BOARD_WINFAST2000             0x22
  58 #define BTTV_BOARD_CHRONOS_VS2             0x23
  59 #define BTTV_BOARD_TYPHOON_TVIEW           0x24
  60 #define BTTV_BOARD_PXELVWPLTVPRO           0x25
  61 #define BTTV_BOARD_MAGICTVIEW063           0x26
  62 #define BTTV_BOARD_PINNACLE                0x27
  63 #define BTTV_BOARD_STB2                    0x28
  64 #define BTTV_BOARD_AVPHONE98               0x29
  65 #define BTTV_BOARD_PV951                   0x2a
  66 #define BTTV_BOARD_ONAIR_TV                0x2b
  67 #define BTTV_BOARD_SIGMA_TVII_FM           0x2c
  68 #define BTTV_BOARD_MATRIX_VISION2          0x2d
  69 #define BTTV_BOARD_ZOLTRIX_GENIE           0x2e
  70 #define BTTV_BOARD_TERRATVRADIO            0x2f
  71 #define BTTV_BOARD_DYNALINK                0x30
  72 #define BTTV_BOARD_GVBCTV3PCI              0x31
  73 #define BTTV_BOARD_PXELVWPLTVPAK           0x32
  74 #define BTTV_BOARD_EAGLE                   0x33
  75 #define BTTV_BOARD_PINNACLEPRO             0x34
  76 #define BTTV_BOARD_TVIEW_RDS_FM            0x35
  77 #define BTTV_BOARD_LIFETEC_9415            0x36
  78 #define BTTV_BOARD_BESTBUY_EASYTV          0x37
  79 #define BTTV_BOARD_FLYVIDEO_98FM           0x38
  80 #define BTTV_BOARD_GRANDTEC                0x39
  81 #define BTTV_BOARD_ASKEY_CPH060            0x3a
  82 #define BTTV_BOARD_ASKEY_CPH03X            0x3b
  83 #define BTTV_BOARD_MM100PCTV               0x3c
  84 #define BTTV_BOARD_GMV1                    0x3d
  85 #define BTTV_BOARD_BESTBUY_EASYTV2         0x3e
  86 #define BTTV_BOARD_ATI_TVWONDER            0x3f
  87 #define BTTV_BOARD_ATI_TVWONDERVE          0x40
  88 #define BTTV_BOARD_FLYVIDEO2000            0x41
  89 #define BTTV_BOARD_TERRATVALUER            0x42
  90 #define BTTV_BOARD_GVBCTV4PCI              0x43
  91 #define BTTV_BOARD_VOODOOTV_FM             0x44
  92 #define BTTV_BOARD_AIMMS                   0x45
  93 #define BTTV_BOARD_PV_BT878P_PLUS          0x46
  94 #define BTTV_BOARD_FLYVIDEO98EZ            0x47
  95 #define BTTV_BOARD_PV_BT878P_9B            0x48
  96 #define BTTV_BOARD_SENSORAY311             0x49
  97 #define BTTV_BOARD_RV605                   0x4a
  98 #define BTTV_BOARD_POWERCLR_MTV878         0x4b
  99 #define BTTV_BOARD_WINDVR                  0x4c
 100 #define BTTV_BOARD_GRANDTEC_MULTI          0x4d
 101 #define BTTV_BOARD_KWORLD                  0x4e
 102 #define BTTV_BOARD_DSP_TCVIDEO             0x4f
 103 #define BTTV_BOARD_HAUPPAUGEPVR            0x50
 104 #define BTTV_BOARD_GVBCTV5PCI              0x51
 105 #define BTTV_BOARD_OSPREY1x0               0x52
 106 #define BTTV_BOARD_OSPREY1x0_848           0x53
 107 #define BTTV_BOARD_OSPREY101_848           0x54
 108 #define BTTV_BOARD_OSPREY1x1               0x55
 109 #define BTTV_BOARD_OSPREY1x1_SVID          0x56
 110 #define BTTV_BOARD_OSPREY2xx               0x57
 111 #define BTTV_BOARD_OSPREY2x0_SVID          0x58
 112 #define BTTV_BOARD_OSPREY2x0               0x59
 113 #define BTTV_BOARD_OSPREY500               0x5a
 114 #define BTTV_BOARD_OSPREY540               0x5b
 115 #define BTTV_BOARD_OSPREY2000              0x5c
 116 #define BTTV_BOARD_IDS_EAGLE               0x5d
 117 #define BTTV_BOARD_PINNACLESAT             0x5e
 118 #define BTTV_BOARD_FORMAC_PROTV            0x5f
 119 #define BTTV_BOARD_MACHTV                  0x60
 120 #define BTTV_BOARD_EURESYS_PICOLO          0x61
 121 #define BTTV_BOARD_PV150                   0x62
 122 #define BTTV_BOARD_AD_TVK503               0x63
 123 #define BTTV_BOARD_HERCULES_SM_TV          0x64
 124 #define BTTV_BOARD_PACETV                  0x65
 125 #define BTTV_BOARD_IVC200                  0x66
 126 #define BTTV_BOARD_XGUARD                  0x67
 127 #define BTTV_BOARD_NEBULA_DIGITV           0x68
 128 #define BTTV_BOARD_PV143                   0x69
 129 #define BTTV_BOARD_VD009X1_MINIDIN         0x6a
 130 #define BTTV_BOARD_VD009X1_COMBI           0x6b
 131 #define BTTV_BOARD_VD009_MINIDIN           0x6c
 132 #define BTTV_BOARD_VD009_COMBI             0x6d
 133 #define BTTV_BOARD_IVC100                  0x6e
 134 #define BTTV_BOARD_IVC120                  0x6f
 135 #define BTTV_BOARD_PC_HDTV                 0x70
 136 #define BTTV_BOARD_TWINHAN_DST             0x71
 137 #define BTTV_BOARD_WINFASTVC100            0x72
 138 #define BTTV_BOARD_TEV560                  0x73
 139 #define BTTV_BOARD_SIMUS_GVC1100           0x74
 140 #define BTTV_BOARD_NGSTV_PLUS              0x75
 141 #define BTTV_BOARD_LMLBT4                  0x76
 142 #define BTTV_BOARD_TEKRAM_M205             0x77
 143 #define BTTV_BOARD_CONTVFMI                0x78
 144 #define BTTV_BOARD_PICOLO_TETRA_CHIP       0x79
 145 #define BTTV_BOARD_SPIRIT_TV               0x7a
 146 #define BTTV_BOARD_AVDVBT_771              0x7b
 147 #define BTTV_BOARD_AVDVBT_761              0x7c
 148 #define BTTV_BOARD_MATRIX_VISIONSQ         0x7d
 149 #define BTTV_BOARD_MATRIX_VISIONSLC        0x7e
 150 #define BTTV_BOARD_APAC_VIEWCOMP           0x7f
 151 #define BTTV_BOARD_DVICO_DVBT_LITE         0x80
 152 #define BTTV_BOARD_VGEAR_MYVCD             0x81
 153 #define BTTV_BOARD_SUPER_TV                0x82
 154 #define BTTV_BOARD_TIBET_CS16              0x83
 155 #define BTTV_BOARD_KODICOM_4400R           0x84
 156 #define BTTV_BOARD_KODICOM_4400R_SL        0x85
 157 #define BTTV_BOARD_ADLINK_RTV24            0x86
 158 #define BTTV_BOARD_DVICO_FUSIONHDTV_5_LITE 0x87
 159 #define BTTV_BOARD_ACORP_Y878F             0x88
 160 #define BTTV_BOARD_CONCEPTRONIC_CTVFMI2    0x89
 161 #define BTTV_BOARD_PV_BT878P_2E            0x8a
 162 #define BTTV_BOARD_PV_M4900                0x8b
 163 #define BTTV_BOARD_OSPREY440               0x8c
 164
 165 /* i2c address list */
 166 #define I2C_TSA5522        0xc2
 167 #define I2C_TDA7432        0x8a
 168 #define I2C_BT832_ALT1     0x88
 169 #define I2C_BT832_ALT2     0x8a // alternate setting
 170 #define I2C_TDA8425        0x82
 171 #define I2C_TDA9840        0x84
 172 #define I2C_TDA9850        0xb6 /* also used by 9855,9873 */
 173 #define I2C_TDA9874        0xb0 /* also used by 9875 */
 174 #define I2C_TDA9875        0xb0
 175 #define I2C_HAUPEE         0xa0
 176 #define I2C_STBEE          0xae
 177 #define I2C_VHX            0xc0
 178 #define I2C_MSP3400        0x80
 179 #define I2C_MSP3400_ALT    0x88
 180 #define I2C_TEA6300        0x80 /* also used by 6320 */
 181 #define I2C_DPL3518        0x84
 182 #define I2C_TDA9887        0x86
 183
 184 /* more card-specific defines */
 185 #define PT2254_L_CHANNEL 0x10
 186 #define PT2254_R_CHANNEL 0x08
 187 #define PT2254_DBS_IN_2 0x400
 188 #define PT2254_DBS_IN_10 0x20000
 189 #define WINVIEW_PT2254_CLK  0x40
 190 #define WINVIEW_PT2254_DATA 0x20
 191 #define WINVIEW_PT2254_STROBE 0x80
 192
 193 /* digital_mode */
 194 #define DIGITAL_MODE_VIDEO 1
 195 #define DIGITAL_MODE_CAMERA 2
 196
 197 struct bttv_core {
 198         /* device structs */
 199         struct pci_dev       *pci;
 200         struct i2c_adapter   i2c_adap;
 201         struct list_head     subs;     /* struct bttv_sub_device */
 202
 203         /* device config */
 204         unsigned int         nr;       /* dev nr (for printk("bttv%d: ...");  */
 205         unsigned int         type;     /* card type (pointer into tvcards[])  */
 206         char                 name[8];  /* dev name */
 207 };
 208
 209 struct bttv;
 210
 211 struct tvcard
 212 {
 213         char *name;
 214         unsigned int video_inputs;
 215         unsigned int audio_inputs;
 216         unsigned int tuner;
 217         unsigned int svhs;
 218         unsigned int digital_mode; // DIGITAL_MODE_CAMERA or DIGITAL_MODE_VIDEO
 219         u32 gpiomask;
 220         u32 muxsel[16];
 221         u32 audiomux[6]; /* Tuner, Radio, external, internal, mute, stereo */
 222         u32 gpiomask2;   /* GPIO MUX mask */
 223
 224         /* i2c audio flags */
 225         unsigned int no_msp34xx:1;
 226         unsigned int no_tda9875:1;
 227         unsigned int no_tda7432:1;
 228         unsigned int needs_tvaudio:1;
 229         unsigned int msp34xx_alt:1;
 230
 231         /* flag: video pci function is unused */
 232         unsigned int no_video:1;
 233         unsigned int has_dvb:1;
 234         unsigned int has_remote:1;
 235         unsigned int no_gpioirq:1;
 236
 237         /* other settings */
 238         unsigned int pll;
 239 #define PLL_NONE 0
 240 #define PLL_28   1
 241 #define PLL_35   2
 242
 243         unsigned int tuner_type;
 244         unsigned int tuner_addr;
 245         unsigned int radio_addr;
 246
 247         unsigned int has_radio;
 248         void (*audio_hook)(struct bttv *btv, struct video_audio *v, int set);
 249         void (*muxsel_hook)(struct bttv *btv, unsigned int input);
 250 };
 251
 252 extern struct tvcard bttv_tvcards[];
 253
 254 /* identification / initialization of the card */
 255 extern void bttv_idcard(struct bttv *btv);
 256 extern void bttv_init_card1(struct bttv *btv);
 257 extern void bttv_init_card2(struct bttv *btv);
 258
 259 /* card-specific funtions */
 260 extern void tea5757_set_freq(struct bttv *btv, unsigned short freq);
 261 extern void bttv_tda9880_setnorm(struct bttv *btv, int norm);
 262
 263 /* extra tweaks for some chipsets */
 264 extern void bttv_check_chipset(void);
 265 extern int bttv_handle_chipset(struct bttv *btv);
 266
 267 /* ---------------------------------------------------------- */
 268 /* exported by bttv-if.c                                      */
 269
 270 /* this obsolete -- please use the sysfs-based
 271    interface below for new code */
 272
 273 /* returns card type + card ID (for bt878-based ones)
 274    for possible values see lines below beginning with #define BTTV_BOARD_UNKNOWN
 275    returns negative value if error occurred
 276 */
 277 extern int bttv_get_cardinfo(unsigned int card, int *type,
 278                              unsigned int *cardid);
 279 extern struct pci_dev* bttv_get_pcidev(unsigned int card);
 280
 281 /* obsolete, use bttv_get_cardinfo instead */
 282 extern int bttv_get_id(unsigned int card);
 283
 284 /* sets GPOE register (BT848_GPIO_OUT_EN) to new value:
 285    data | (current_GPOE_value & ~mask)
 286    returns negative value if error occurred
 287 */
 288 extern int bttv_gpio_enable(unsigned int card,
 289                             unsigned long mask, unsigned long data);
 290
 291 /* fills data with GPDATA register contents
 292    returns negative value if error occurred
 293 */
 294 extern int bttv_read_gpio(unsigned int card, unsigned long *data);
 295
 296 /* sets GPDATA register to new value:
 297   (data & mask) | (current_GPDATA_value & ~mask)
 298   returns negative value if error occurred
 299 */
 300 extern int bttv_write_gpio(unsigned int card,
 301                            unsigned long mask, unsigned long data);
 302
 303 /* returns pointer to task queue which can be used as parameter to
 304    interruptible_sleep_on
 305    in interrupt handler if BT848_INT_GPINT bit is set - this queue is activated
 306    (wake_up_interruptible) and following call to the function bttv_read_gpio
 307    should return new value of GPDATA,
 308    returns NULL value if error occurred or queue is not available
 309    WARNING: because there is no buffer for GPIO data, one MUST
 310    process data ASAP
 311 */
 312 extern wait_queue_head_t* bttv_get_gpio_queue(unsigned int card);
 313
 314 /* call i2c clients
 315 */
 316 extern void bttv_i2c_call(unsigned int card, unsigned int cmd, void *arg);
 317
 318
 319
 320 /* ---------------------------------------------------------- */
 321 /* sysfs/driver-moded based gpio access interface             */
 322
 323
 324 struct bttv_sub_device {
 325         struct device    dev;
 326         struct bttv_core *core;
 327         struct list_head list;
 328 };
 329 #define to_bttv_sub_dev(x) container_of((x), struct bttv_sub_device, dev)
 330
 331 struct bttv_sub_driver {
 332         struct device_driver   drv;
 333         char                   wanted[BUS_ID_SIZE];
 334         void                   (*gpio_irq)(struct bttv_sub_device *sub);
 335 };
 336 #define to_bttv_sub_drv(x) container_of((x), struct bttv_sub_driver, drv)
 337
 338 int bttv_sub_register(struct bttv_sub_driver *drv, char *wanted);
 339 int bttv_sub_unregister(struct bttv_sub_driver *drv);
 340
 341 /* gpio access functions */
 342 void bttv_gpio_inout(struct bttv_core *core, u32 mask, u32 outbits);
 343 u32 bttv_gpio_read(struct bttv_core *core);
 344 void bttv_gpio_write(struct bttv_core *core, u32 value);
 345 void bttv_gpio_bits(struct bttv_core *core, u32 mask, u32 bits);
 346
 347 #define gpio_inout(mask,bits)  bttv_gpio_inout(&btv->c, mask, bits)
 348 #define gpio_read()            bttv_gpio_read(&btv->c)
 349 #define gpio_write(value)      bttv_gpio_write(&btv->c, value)
 350 #define gpio_bits(mask,bits)   bttv_gpio_bits(&btv->c, mask, bits)
 351
 352
 353 /* ---------------------------------------------------------- */
 354 /* i2c                                                        */
 355
 356 extern void bttv_call_i2c_clients(struct bttv *btv, unsigned int cmd, void *arg);
 357 extern int bttv_I2CRead(struct bttv *btv, unsigned char addr, char *probe_for);
 358 extern int bttv_I2CWrite(struct bttv *btv, unsigned char addr, unsigned char b1,
 359                          unsigned char b2, int both);
 360 extern void bttv_readee(struct bttv *btv, unsigned char *eedata, int addr);
 361
 362 #endif /* _BTTV_H_ */
 363 /*
 364  * Local variables:
 365  * c-basic-offset: 8
 366  * End:
 367  */