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