SAFE public projects git trees. - safe/jmp/linux-2.6/blob - drivers/media/video/em28xx/em28xx.h

   1 /*
   2    em28xx.h - driver for Empia EM2800/EM2820/2840 USB video capture devices
   3
   4    Copyright (C) 2005 Markus Rechberger <mrechberger@gmail.com>
   5                       Ludovico Cavedon <cavedon@sssup.it>
   6                       Mauro Carvalho Chehab <mchehab@infradead.org>
   7
   8    Based on the em2800 driver from Sascha Sommer <saschasommer@freenet.de>
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 2 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program; if not, write to the Free Software
  22    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  23  */
  24
  25 #ifndef _EM28XX_H
  26 #define _EM28XX_H
  27
  28 #include <linux/videodev2.h>
  29 #include <media/videobuf-vmalloc.h>
  30
  31 #include <linux/i2c.h>
  32 #include <linux/mutex.h>
  33 #include <media/ir-kbd-i2c.h>
  34 #if defined(CONFIG_VIDEO_EM28XX_DVB) || defined(CONFIG_VIDEO_EM28XX_DVB_MODULE)
  35 #include <media/videobuf-dvb.h>
  36 #endif
  37 #include "tuner-xc2028.h"
  38 #include "em28xx-reg.h"
  39
  40 /* Boards supported by driver */
  41 #define EM2800_BOARD_UNKNOWN                    0
  42 #define EM2820_BOARD_UNKNOWN                    1
  43 #define EM2820_BOARD_TERRATEC_CINERGY_250       2
  44 #define EM2820_BOARD_PINNACLE_USB_2             3
  45 #define EM2820_BOARD_HAUPPAUGE_WINTV_USB_2      4
  46 #define EM2820_BOARD_MSI_VOX_USB_2              5
  47 #define EM2800_BOARD_TERRATEC_CINERGY_200       6
  48 #define EM2800_BOARD_LEADTEK_WINFAST_USBII      7
  49 #define EM2800_BOARD_KWORLD_USB2800             8
  50 #define EM2820_BOARD_PINNACLE_DVC_90            9
  51 #define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900    10
  52 #define EM2880_BOARD_TERRATEC_HYBRID_XS         11
  53 #define EM2820_BOARD_KWORLD_PVRTV2800RF         12
  54 #define EM2880_BOARD_TERRATEC_PRODIGY_XS        13
  55 #define EM2820_BOARD_PROLINK_PLAYTV_USB2        14
  56 #define EM2800_BOARD_VGEAR_POCKETTV             15
  57 #define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_950    16
  58 #define EM2880_BOARD_PINNACLE_PCTV_HD_PRO       17
  59 #define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900_R2 18
  60 #define EM2860_BOARD_POINTNIX_INTRAORAL_CAMERA  19
  61 #define EM2880_BOARD_AMD_ATI_TV_WONDER_HD_600   20
  62 #define EM2800_BOARD_GRABBEEX_USB2800           21
  63 #define EM2750_BOARD_UNKNOWN                      22
  64 #define EM2750_BOARD_DLCW_130                     23
  65 #define EM2820_BOARD_DLINK_USB_TV                 24
  66 #define EM2820_BOARD_GADMEI_UTV310                25
  67 #define EM2820_BOARD_HERCULES_SMART_TV_USB2       26
  68 #define EM2820_BOARD_PINNACLE_USB_2_FM1216ME      27
  69 #define EM2820_BOARD_LEADTEK_WINFAST_USBII_DELUXE 28
  70 #define EM2820_BOARD_VIDEOLOGY_20K14XUSB          30
  71 #define EM2821_BOARD_USBGEAR_VD204                31
  72 #define EM2821_BOARD_SUPERCOMP_USB_2              32
  73 #define EM2821_BOARD_PROLINK_PLAYTV_USB2          33
  74 #define EM2860_BOARD_TERRATEC_HYBRID_XS           34
  75 #define EM2860_BOARD_TYPHOON_DVD_MAKER            35
  76 #define EM2860_BOARD_NETGMBH_CAM                  36
  77 #define EM2860_BOARD_GADMEI_UTV330                37
  78 #define EM2861_BOARD_YAKUMO_MOVIE_MIXER           38
  79 #define EM2861_BOARD_KWORLD_PVRTV_300U            39
  80 #define EM2861_BOARD_PLEXTOR_PX_TV100U            40
  81 #define EM2870_BOARD_KWORLD_350U                  41
  82 #define EM2870_BOARD_KWORLD_355U                  42
  83 #define EM2870_BOARD_TERRATEC_XS                  43
  84 #define EM2870_BOARD_TERRATEC_XS_MT2060           44
  85 #define EM2870_BOARD_PINNACLE_PCTV_DVB            45
  86 #define EM2870_BOARD_COMPRO_VIDEOMATE             46
  87 #define EM2880_BOARD_KWORLD_DVB_305U              47
  88 #define EM2880_BOARD_KWORLD_DVB_310U              48
  89 #define EM2880_BOARD_MSI_DIGIVOX_AD               49
  90 #define EM2880_BOARD_MSI_DIGIVOX_AD_II            50
  91 #define EM2880_BOARD_TERRATEC_HYBRID_XS_FR        51
  92 #define EM2881_BOARD_DNT_DA2_HYBRID               52
  93 #define EM2881_BOARD_PINNACLE_HYBRID_PRO          53
  94 #define EM2882_BOARD_KWORLD_VS_DVBT               54
  95 #define EM2882_BOARD_TERRATEC_HYBRID_XS           55
  96 #define EM2882_BOARD_PINNACLE_HYBRID_PRO          56
  97 #define EM2883_BOARD_KWORLD_HYBRID_330U                  57
  98 #define EM2820_BOARD_COMPRO_VIDEOMATE_FORYOU      58
  99 #define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_850      60
 100 #define EM2820_BOARD_PROLINK_PLAYTV_BOX4_USB2     61
 101 #define EM2820_BOARD_GADMEI_TVR200                62
 102 #define EM2860_BOARD_KAIOMY_TVNPC_U2              61
 103
 104 /* Limits minimum and default number of buffers */
 105 #define EM28XX_MIN_BUF 4
 106 #define EM28XX_DEF_BUF 8
 107
 108 /*Limits the max URB message size */
 109 #define URB_MAX_CTRL_SIZE 80
 110
 111 /* Params for validated field */
 112 #define EM28XX_BOARD_NOT_VALIDATED 1
 113 #define EM28XX_BOARD_VALIDATED     0
 114
 115 /* maximum number of em28xx boards */
 116 #define EM28XX_MAXBOARDS 4 /*FIXME: should be bigger */
 117
 118 /* maximum number of frames that can be queued */
 119 #define EM28XX_NUM_FRAMES 5
 120 /* number of frames that get used for v4l2_read() */
 121 #define EM28XX_NUM_READ_FRAMES 2
 122
 123 /* number of buffers for isoc transfers */
 124 #define EM28XX_NUM_BUFS 5
 125
 126 /* number of packets for each buffer
 127    windows requests only 40 packets .. so we better do the same
 128    this is what I found out for all alternate numbers there!
 129  */
 130 #define EM28XX_NUM_PACKETS 40
 131
 132 /* default alternate; 0 means choose the best */
 133 #define EM28XX_PINOUT 0
 134
 135 #define EM28XX_INTERLACED_DEFAULT 1
 136
 137 /*
 138 #define (use usbview if you want to get the other alternate number infos)
 139 #define
 140 #define alternate number 2
 141 #define                         Endpoint Address: 82
 142                         Direction: in
 143                         Attribute: 1
 144                         Type: Isoc
 145                         Max Packet Size: 1448
 146                         Interval: 125us
 147
 148   alternate number 7
 149
 150                         Endpoint Address: 82
 151                         Direction: in
 152                         Attribute: 1
 153                         Type: Isoc
 154                         Max Packet Size: 3072
 155                         Interval: 125us
 156 */
 157
 158 /* time to wait when stopping the isoc transfer */
 159 #define EM28XX_URB_TIMEOUT       msecs_to_jiffies(EM28XX_NUM_BUFS * EM28XX_NUM_PACKETS)
 160
 161 /* time in msecs to wait for i2c writes to finish */
 162 #define EM2800_I2C_WRITE_TIMEOUT 20
 163
 164 enum em28xx_mode {
 165         EM28XX_SUSPEND,
 166         EM28XX_ANALOG_MODE,
 167         EM28XX_DIGITAL_MODE,
 168 };
 169
 170 enum em28xx_stream_state {
 171         STREAM_OFF,
 172         STREAM_INTERRUPT,
 173         STREAM_ON,
 174 };
 175
 176 struct em28xx;
 177
 178 struct em28xx_usb_isoc_ctl {
 179                 /* max packet size of isoc transaction */
 180         int                             max_pkt_size;
 181
 182                 /* number of allocated urbs */
 183         int                             num_bufs;
 184
 185                 /* urb for isoc transfers */
 186         struct urb                      **urb;
 187
 188                 /* transfer buffers for isoc transfer */
 189         char                            **transfer_buffer;
 190
 191                 /* Last buffer command and region */
 192         u8                              cmd;
 193         int                             pos, size, pktsize;
 194
 195                 /* Last field: ODD or EVEN? */
 196         int                             field;
 197
 198                 /* Stores incomplete commands */
 199         u32                             tmp_buf;
 200         int                             tmp_buf_len;
 201
 202                 /* Stores already requested buffers */
 203         struct em28xx_buffer            *buf;
 204
 205                 /* Stores the number of received fields */
 206         int                             nfields;
 207
 208                 /* isoc urb callback */
 209         int (*isoc_copy) (struct em28xx *dev, struct urb *urb);
 210
 211 };
 212
 213 /* Struct to enumberate video formats */
 214 struct em28xx_fmt {
 215         char  *name;
 216         u32   fourcc;          /* v4l2 format id */
 217         int   depth;
 218         int   reg;
 219 };
 220
 221 /* buffer for one video frame */
 222 struct em28xx_buffer {
 223         /* common v4l buffer stuff -- must be first */
 224         struct videobuf_buffer vb;
 225
 226         struct list_head frame;
 227         int top_field;
 228         int receiving;
 229 };
 230
 231 struct em28xx_dmaqueue {
 232         struct list_head       active;
 233         struct list_head       queued;
 234
 235         wait_queue_head_t          wq;
 236
 237         /* Counters to control buffer fill */
 238         int                        pos;
 239 };
 240
 241 /* io methods */
 242 enum em28xx_io_method {
 243         IO_NONE,
 244         IO_READ,
 245         IO_MMAP,
 246 };
 247
 248 /* inputs */
 249
 250 #define MAX_EM28XX_INPUT 4
 251 enum enum28xx_itype {
 252         EM28XX_VMUX_COMPOSITE1 = 1,
 253         EM28XX_VMUX_COMPOSITE2,
 254         EM28XX_VMUX_COMPOSITE3,
 255         EM28XX_VMUX_COMPOSITE4,
 256         EM28XX_VMUX_SVIDEO,
 257         EM28XX_VMUX_TELEVISION,
 258         EM28XX_VMUX_CABLE,
 259         EM28XX_VMUX_DVB,
 260         EM28XX_VMUX_DEBUG,
 261         EM28XX_RADIO,
 262 };
 263
 264 enum em28xx_ac97_mode {
 265         EM28XX_NO_AC97 = 0,
 266         EM28XX_AC97_EM202,
 267         EM28XX_AC97_SIGMATEL,
 268         EM28XX_AC97_OTHER,
 269 };
 270
 271 struct em28xx_audio_mode {
 272         enum em28xx_ac97_mode ac97;
 273
 274         u16 ac97_feat;
 275         u32 ac97_vendor_id;
 276
 277         unsigned int has_audio:1;
 278
 279         unsigned int i2s_3rates:1;
 280         unsigned int i2s_5rates:1;
 281 };
 282
 283 /* em28xx has two audio inputs: tuner and line in.
 284    However, on most devices, an auxiliary AC97 codec device is used.
 285    The AC97 device may have several different inputs and outputs,
 286    depending on their model. So, it is possible to use AC97 mixer to
 287    address more than two different entries.
 288  */
 289 enum em28xx_amux {
 290         /* This is the only entry for em28xx tuner input */
 291         EM28XX_AMUX_VIDEO,      /* em28xx tuner, AC97 mixer Video */
 292
 293         EM28XX_AMUX_LINE_IN,    /* AC97 mixer Line In */
 294
 295         /* Some less-common mixer setups */
 296         EM28XX_AMUX_VIDEO2,     /* em28xx Line in, AC97 mixer Video */
 297         EM28XX_AMUX_PHONE,
 298         EM28XX_AMUX_MIC,
 299         EM28XX_AMUX_CD,
 300         EM28XX_AMUX_AUX,
 301         EM28XX_AMUX_PCM_OUT,
 302 };
 303
 304 enum em28xx_aout {
 305         /* AC97 outputs */
 306         EM28XX_AOUT_MASTER = 1 << 0,
 307         EM28XX_AOUT_LINE   = 1 << 1,
 308         EM28XX_AOUT_MONO   = 1 << 2,
 309         EM28XX_AOUT_LFE    = 1 << 3,
 310         EM28XX_AOUT_SURR   = 1 << 4,
 311
 312         /* PCM IN Mixer - used by AC97_RECORD_SELECT register */
 313         EM28XX_AOUT_PCM_IN = 1 << 7,
 314
 315         /* Bits 10-8 are used to indicate the PCM IN record select */
 316         EM28XX_AOUT_PCM_MIC_PCM = 0 << 8,
 317         EM28XX_AOUT_PCM_CD      = 1 << 8,
 318         EM28XX_AOUT_PCM_VIDEO   = 2 << 8,
 319         EM28XX_AOUT_PCM_AUX     = 3 << 8,
 320         EM28XX_AOUT_PCM_LINE    = 4 << 8,
 321         EM28XX_AOUT_PCM_STEREO  = 5 << 8,
 322         EM28XX_AOUT_PCM_MONO    = 6 << 8,
 323         EM28XX_AOUT_PCM_PHONE   = 7 << 8,
 324 };
 325
 326 static inline int ac97_return_record_select(int a_out)
 327 {
 328         return (a_out & 0x700) >> 8;
 329 }
 330
 331 struct em28xx_reg_seq {
 332         int reg;
 333         unsigned char val, mask;
 334         int sleep;
 335 };
 336
 337 struct em28xx_input {
 338         enum enum28xx_itype type;
 339         unsigned int vmux;
 340         enum em28xx_amux amux;
 341         enum em28xx_aout aout;
 342         struct em28xx_reg_seq *gpio;
 343 };
 344
 345 #define INPUT(nr) (&em28xx_boards[dev->model].input[nr])
 346
 347 enum em28xx_decoder {
 348         EM28XX_NODECODER,
 349         EM28XX_TVP5150,
 350         EM28XX_SAA711X,
 351 };
 352
 353 struct em28xx_board {
 354         char *name;
 355         int vchannels;
 356         int tuner_type;
 357         int tuner_addr;
 358
 359         /* i2c flags */
 360         unsigned int tda9887_conf;
 361
 362         /* GPIO sequences */
 363         struct em28xx_reg_seq *dvb_gpio;
 364         struct em28xx_reg_seq *suspend_gpio;
 365         struct em28xx_reg_seq *tuner_gpio;
 366
 367         unsigned int is_em2800:1;
 368         unsigned int has_msp34xx:1;
 369         unsigned int mts_firmware:1;
 370         unsigned int max_range_640_480:1;
 371         unsigned int has_dvb:1;
 372         unsigned int has_snapshot_button:1;
 373         unsigned int valid:1;
 374
 375         unsigned char xclk, i2c_speed;
 376
 377         enum em28xx_decoder decoder;
 378
 379         struct em28xx_input       input[MAX_EM28XX_INPUT];
 380         struct em28xx_input       radio;
 381         IR_KEYTAB_TYPE            *ir_codes;
 382 };
 383
 384 struct em28xx_eeprom {
 385         u32 id;                 /* 0x9567eb1a */
 386         u16 vendor_ID;
 387         u16 product_ID;
 388
 389         u16 chip_conf;
 390
 391         u16 board_conf;
 392
 393         u16 string1, string2, string3;
 394
 395         u8 string_idx_table;
 396 };
 397
 398 /* device states */
 399 enum em28xx_dev_state {
 400         DEV_INITIALIZED = 0x01,
 401         DEV_DISCONNECTED = 0x02,
 402         DEV_MISCONFIGURED = 0x04,
 403 };
 404
 405 #define EM28XX_AUDIO_BUFS 5
 406 #define EM28XX_NUM_AUDIO_PACKETS 64
 407 #define EM28XX_AUDIO_MAX_PACKET_SIZE 196 /* static value */
 408 #define EM28XX_CAPTURE_STREAM_EN 1
 409
 410 /* em28xx extensions */
 411 #define EM28XX_AUDIO   0x10
 412 #define EM28XX_DVB     0x20
 413
 414 struct em28xx_audio {
 415         char name[50];
 416         char *transfer_buffer[EM28XX_AUDIO_BUFS];
 417         struct urb *urb[EM28XX_AUDIO_BUFS];
 418         struct usb_device *udev;
 419         unsigned int capture_transfer_done;
 420         struct snd_pcm_substream   *capture_pcm_substream;
 421
 422         unsigned int hwptr_done_capture;
 423         struct snd_card            *sndcard;
 424
 425         int users, shutdown;
 426         enum em28xx_stream_state capture_stream;
 427         spinlock_t slock;
 428 };
 429
 430 struct em28xx;
 431
 432 struct em28xx_fh {
 433         struct em28xx *dev;
 434         unsigned int  stream_on:1;      /* Locks streams */
 435         int           radio;
 436
 437         struct videobuf_queue        vb_vidq;
 438
 439         enum v4l2_buf_type           type;
 440 };
 441
 442 /* main device struct */
 443 struct em28xx {
 444         /* generic device properties */
 445         char name[30];          /* name (including minor) of the device */
 446         int model;              /* index in the device_data struct */
 447         int devno;              /* marks the number of this device */
 448         enum em28xx_chip_id chip_id;
 449
 450         struct em28xx_board board;
 451
 452         unsigned int stream_on:1;       /* Locks streams */
 453         unsigned int has_audio_class:1;
 454         unsigned int has_alsa_audio:1;
 455
 456         struct em28xx_fmt *format;
 457
 458         struct em28xx_IR *ir;
 459
 460         /* Some older em28xx chips needs a waiting time after writing */
 461         unsigned int wait_after_write;
 462
 463         struct list_head        devlist;
 464
 465         u32 i2s_speed;          /* I2S speed for audio digital stream */
 466
 467         struct em28xx_audio_mode audio_mode;
 468
 469         int tuner_type;         /* type of the tuner */
 470         int tuner_addr;         /* tuner address */
 471         int tda9887_conf;
 472         /* i2c i/o */
 473         struct i2c_adapter i2c_adap;
 474         struct i2c_client i2c_client;
 475         /* video for linux */
 476         int users;              /* user count for exclusive use */
 477         struct video_device *vdev;      /* video for linux device struct */
 478         v4l2_std_id norm;       /* selected tv norm */
 479         int ctl_freq;           /* selected frequency */
 480         unsigned int ctl_input; /* selected input */
 481         unsigned int ctl_ainput;/* selected audio input */
 482         unsigned int ctl_aoutput;/* selected audio output */
 483         int mute;
 484         int volume;
 485         /* frame properties */
 486         int width;              /* current frame width */
 487         int height;             /* current frame height */
 488         unsigned hscale;        /* horizontal scale factor (see datasheet) */
 489         unsigned vscale;        /* vertical scale factor (see datasheet) */
 490         int interlaced;         /* 1=interlace fileds, 0=just top fileds */
 491         unsigned int video_bytesread;   /* Number of bytes read */
 492
 493         unsigned long hash;     /* eeprom hash - for boards with generic ID */
 494         unsigned long i2c_hash; /* i2c devicelist hash -
 495                                    for boards with generic ID */
 496
 497         struct em28xx_audio adev;
 498
 499         /* states */
 500         enum em28xx_dev_state state;
 501         enum em28xx_io_method io;
 502
 503         struct work_struct         request_module_wk;
 504
 505         /* locks */
 506         struct mutex lock;
 507         struct mutex ctrl_urb_lock;     /* protects urb_buf */
 508         /* spinlock_t queue_lock; */
 509         struct list_head inqueue, outqueue;
 510         wait_queue_head_t open, wait_frame, wait_stream;
 511         struct video_device *vbi_dev;
 512         struct video_device *radio_dev;
 513
 514         unsigned char eedata[256];
 515
 516         /* Isoc control struct */
 517         struct em28xx_dmaqueue vidq;
 518         struct em28xx_usb_isoc_ctl isoc_ctl;
 519         spinlock_t slock;
 520
 521         /* usb transfer */
 522         struct usb_device *udev;        /* the usb device */
 523         int alt;                /* alternate */
 524         int max_pkt_size;       /* max packet size of isoc transaction */
 525         int num_alt;            /* Number of alternative settings */
 526         unsigned int *alt_max_pkt_size; /* array of wMaxPacketSize */
 527         struct urb *urb[EM28XX_NUM_BUFS];       /* urb for isoc transfers */
 528         char *transfer_buffer[EM28XX_NUM_BUFS]; /* transfer buffers for isoc transfer */
 529         char urb_buf[URB_MAX_CTRL_SIZE];        /* urb control msg buffer */
 530
 531         /* helper funcs that call usb_control_msg */
 532         int (*em28xx_write_regs) (struct em28xx *dev, u16 reg,
 533                                         char *buf, int len);
 534         int (*em28xx_read_reg) (struct em28xx *dev, u16 reg);
 535         int (*em28xx_read_reg_req_len) (struct em28xx *dev, u8 req, u16 reg,
 536                                         char *buf, int len);
 537         int (*em28xx_write_regs_req) (struct em28xx *dev, u8 req, u16 reg,
 538                                       char *buf, int len);
 539         int (*em28xx_read_reg_req) (struct em28xx *dev, u8 req, u16 reg);
 540
 541         enum em28xx_mode mode;
 542
 543         /* register numbers for GPO/GPIO registers */
 544         u16 reg_gpo_num, reg_gpio_num;
 545
 546         /* Caches GPO and GPIO registers */
 547         unsigned char   reg_gpo, reg_gpio;
 548
 549         /* Snapshot button */
 550         char snapshot_button_path[30];  /* path of the input dev */
 551         struct input_dev *sbutton_input_dev;
 552         struct delayed_work sbutton_query_work;
 553
 554         struct em28xx_dvb *dvb;
 555 };
 556
 557 struct em28xx_ops {
 558         struct list_head next;
 559         char *name;
 560         int id;
 561         int (*init)(struct em28xx *);
 562         int (*fini)(struct em28xx *);
 563 };
 564
 565 /* Provided by em28xx-i2c.c */
 566
 567 void em28xx_i2c_call_clients(struct em28xx *dev, unsigned int cmd, void *arg);
 568 void em28xx_do_i2c_scan(struct em28xx *dev);
 569 int em28xx_i2c_register(struct em28xx *dev);
 570 int em28xx_i2c_unregister(struct em28xx *dev);
 571
 572 /* Provided by em28xx-core.c */
 573
 574 u32 em28xx_request_buffers(struct em28xx *dev, u32 count);
 575 void em28xx_queue_unusedframes(struct em28xx *dev);
 576 void em28xx_release_buffers(struct em28xx *dev);
 577
 578 int em28xx_read_reg_req_len(struct em28xx *dev, u8 req, u16 reg,
 579                             char *buf, int len);
 580 int em28xx_read_reg_req(struct em28xx *dev, u8 req, u16 reg);
 581 int em28xx_read_reg(struct em28xx *dev, u16 reg);
 582 int em28xx_write_regs_req(struct em28xx *dev, u8 req, u16 reg, char *buf,
 583                           int len);
 584 int em28xx_write_regs(struct em28xx *dev, u16 reg, char *buf, int len);
 585 int em28xx_write_reg(struct em28xx *dev, u16 reg, u8 val);
 586
 587 int em28xx_read_ac97(struct em28xx *dev, u8 reg);
 588 int em28xx_write_ac97(struct em28xx *dev, u8 reg, u16 val);
 589
 590 int em28xx_audio_analog_set(struct em28xx *dev);
 591 int em28xx_audio_setup(struct em28xx *dev);
 592
 593 int em28xx_colorlevels_set_default(struct em28xx *dev);
 594 int em28xx_capture_start(struct em28xx *dev, int start);
 595 int em28xx_set_outfmt(struct em28xx *dev);
 596 int em28xx_resolution_set(struct em28xx *dev);
 597 int em28xx_set_alternate(struct em28xx *dev);
 598 int em28xx_init_isoc(struct em28xx *dev, int max_packets,
 599                      int num_bufs, int max_pkt_size,
 600                      int (*isoc_copy) (struct em28xx *dev, struct urb *urb));
 601 void em28xx_uninit_isoc(struct em28xx *dev);
 602 int em28xx_set_mode(struct em28xx *dev, enum em28xx_mode set_mode);
 603 int em28xx_gpio_set(struct em28xx *dev, struct em28xx_reg_seq *gpio);
 604 void em28xx_wake_i2c(struct em28xx *dev);
 605 void em28xx_remove_from_devlist(struct em28xx *dev);
 606 void em28xx_add_into_devlist(struct em28xx *dev);
 607 struct em28xx *em28xx_get_device(int minor,
 608                                  enum v4l2_buf_type *fh_type,
 609                                  int *has_radio);
 610 int em28xx_register_extension(struct em28xx_ops *dev);
 611 void em28xx_unregister_extension(struct em28xx_ops *dev);
 612 void em28xx_init_extension(struct em28xx *dev);
 613 void em28xx_close_extension(struct em28xx *dev);
 614
 615 /* Provided by em28xx-video.c */
 616 int em28xx_register_analog_devices(struct em28xx *dev);
 617 void em28xx_release_analog_resources(struct em28xx *dev);
 618
 619 /* Provided by em28xx-cards.c */
 620 extern int em2800_variant_detect(struct usb_device *udev, int model);
 621 extern void em28xx_pre_card_setup(struct em28xx *dev);
 622 extern void em28xx_card_setup(struct em28xx *dev);
 623 extern struct em28xx_board em28xx_boards[];
 624 extern struct usb_device_id em28xx_id_table[];
 625 extern const unsigned int em28xx_bcount;
 626 void em28xx_set_ir(struct em28xx *dev, struct IR_i2c *ir);
 627 int em28xx_tuner_callback(void *ptr, int component, int command, int arg);
 628 void em28xx_release_resources(struct em28xx *dev);
 629
 630 /* Provided by em28xx-input.c */
 631 int em28xx_get_key_terratec(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw);
 632 int em28xx_get_key_em_haup(struct IR_i2c *ir, u32 *ir_key, u32 *ir_raw);
 633 int em28xx_get_key_pinnacle_usb_grey(struct IR_i2c *ir, u32 *ir_key,
 634                                      u32 *ir_raw);
 635 void em28xx_register_snapshot_button(struct em28xx *dev);
 636 void em28xx_deregister_snapshot_button(struct em28xx *dev);
 637
 638 int em28xx_ir_init(struct em28xx *dev);
 639 int em28xx_ir_fini(struct em28xx *dev);
 640
 641 /* printk macros */
 642
 643 #define em28xx_err(fmt, arg...) do {\
 644         printk(KERN_ERR fmt , ##arg); } while (0)
 645
 646 #define em28xx_errdev(fmt, arg...) do {\
 647         printk(KERN_ERR "%s: "fmt,\
 648                         dev->name , ##arg); } while (0)
 649
 650 #define em28xx_info(fmt, arg...) do {\
 651         printk(KERN_INFO "%s: "fmt,\
 652                         dev->name , ##arg); } while (0)
 653 #define em28xx_warn(fmt, arg...) do {\
 654         printk(KERN_WARNING "%s: "fmt,\
 655                         dev->name , ##arg); } while (0)
 656
 657 static inline int em28xx_compression_disable(struct em28xx *dev)
 658 {
 659         /* side effect of disabling scaler and mixer */
 660         return em28xx_write_reg(dev, EM28XX_R26_COMPR, 0x00);
 661 }
 662
 663 static inline int em28xx_contrast_get(struct em28xx *dev)
 664 {
 665         return em28xx_read_reg(dev, EM28XX_R20_YGAIN) & 0x1f;
 666 }
 667
 668 static inline int em28xx_brightness_get(struct em28xx *dev)
 669 {
 670         return em28xx_read_reg(dev, EM28XX_R21_YOFFSET);
 671 }
 672
 673 static inline int em28xx_saturation_get(struct em28xx *dev)
 674 {
 675         return em28xx_read_reg(dev, EM28XX_R22_UVGAIN) & 0x1f;
 676 }
 677
 678 static inline int em28xx_u_balance_get(struct em28xx *dev)
 679 {
 680         return em28xx_read_reg(dev, EM28XX_R23_UOFFSET);
 681 }
 682
 683 static inline int em28xx_v_balance_get(struct em28xx *dev)
 684 {
 685         return em28xx_read_reg(dev, EM28XX_R24_VOFFSET);
 686 }
 687
 688 static inline int em28xx_gamma_get(struct em28xx *dev)
 689 {
 690         return em28xx_read_reg(dev, EM28XX_R14_GAMMA) & 0x3f;
 691 }
 692
 693 static inline int em28xx_contrast_set(struct em28xx *dev, s32 val)
 694 {
 695         u8 tmp = (u8) val;
 696         return em28xx_write_regs(dev, EM28XX_R20_YGAIN, &tmp, 1);
 697 }
 698
 699 static inline int em28xx_brightness_set(struct em28xx *dev, s32 val)
 700 {
 701         u8 tmp = (u8) val;
 702         return em28xx_write_regs(dev, EM28XX_R21_YOFFSET, &tmp, 1);
 703 }
 704
 705 static inline int em28xx_saturation_set(struct em28xx *dev, s32 val)
 706 {
 707         u8 tmp = (u8) val;
 708         return em28xx_write_regs(dev, EM28XX_R22_UVGAIN, &tmp, 1);
 709 }
 710
 711 static inline int em28xx_u_balance_set(struct em28xx *dev, s32 val)
 712 {
 713         u8 tmp = (u8) val;
 714         return em28xx_write_regs(dev, EM28XX_R23_UOFFSET, &tmp, 1);
 715 }
 716
 717 static inline int em28xx_v_balance_set(struct em28xx *dev, s32 val)
 718 {
 719         u8 tmp = (u8) val;
 720         return em28xx_write_regs(dev, EM28XX_R24_VOFFSET, &tmp, 1);
 721 }
 722
 723 static inline int em28xx_gamma_set(struct em28xx *dev, s32 val)
 724 {
 725         u8 tmp = (u8) val;
 726         return em28xx_write_regs(dev, EM28XX_R14_GAMMA, &tmp, 1);
 727 }
 728
 729 /*FIXME: maxw should be dependent of alt mode */
 730 static inline unsigned int norm_maxw(struct em28xx *dev)
 731 {
 732         if (dev->board.max_range_640_480)
 733                 return 640;
 734         else
 735                 return 720;
 736 }
 737
 738 static inline unsigned int norm_maxh(struct em28xx *dev)
 739 {
 740         if (dev->board.max_range_640_480)
 741                 return 480;
 742         else
 743                 return (dev->norm & V4L2_STD_625_50) ? 576 : 480;
 744 }
 745 #endif