[media] omap24xx/tcm825x: move to staging for future removal
[deliverable/linux.git] / drivers / media / usb / em28xx / em28xx.h
CommitLineData
a6c2ba28 1/*
0e7072ef 2 em28xx.h - driver for Empia EM2800/EM2820/2840 USB video capture devices
a6c2ba28 3
4 Copyright (C) 2005 Markus Rechberger <mrechberger@gmail.com>
4ac97914 5 Ludovico Cavedon <cavedon@sssup.it>
2e7c6dc3 6 Mauro Carvalho Chehab <mchehab@infradead.org>
0cf544a6 7 Copyright (C) 2012 Frank Schäfer <fschaefer.oss@googlemail.com>
a6c2ba28 8
9 Based on the em2800 driver from Sascha Sommer <saschasommer@freenet.de>
10
11 This program is free software; you can redistribute it and/or modify
12 it under the terms of the GNU General Public License as published by
13 the Free Software Foundation; either version 2 of the License, or
14 (at your option) any later version.
15
16 This program is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 GNU General Public License for more details.
20
21 You should have received a copy of the GNU General Public License
22 along with this program; if not, write to the Free Software
23 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 */
25
3acf2809
MCC
26#ifndef _EM28XX_H
27#define _EM28XX_H
a6c2ba28 28
39a96b4c
MCC
29#include <linux/workqueue.h>
30#include <linux/i2c.h>
31#include <linux/mutex.h>
cb77d010 32#include <linux/videodev2.h>
39a96b4c 33
d3829fad 34#include <media/videobuf2-vmalloc.h>
f2cf250a 35#include <media/v4l2-device.h>
081b945e 36#include <media/v4l2-ctrls.h>
69a61642 37#include <media/v4l2-fh.h>
d5e52653 38#include <media/ir-kbd-i2c.h>
6bda9644 39#include <media/rc-core.h>
3ca9c093 40#include "tuner-xc2028.h"
82e7dbbd 41#include "xc5000.h"
2ba890ec 42#include "em28xx-reg.h"
3aefb79a
MCC
43
44/* Boards supported by driver */
d5b6a746
FS
45#define EM2800_BOARD_UNKNOWN 0
46#define EM2820_BOARD_UNKNOWN 1
47#define EM2820_BOARD_TERRATEC_CINERGY_250 2
48#define EM2820_BOARD_PINNACLE_USB_2 3
49#define EM2820_BOARD_HAUPPAUGE_WINTV_USB_2 4
50#define EM2820_BOARD_MSI_VOX_USB_2 5
51#define EM2800_BOARD_TERRATEC_CINERGY_200 6
52#define EM2800_BOARD_LEADTEK_WINFAST_USBII 7
53#define EM2800_BOARD_KWORLD_USB2800 8
54#define EM2820_BOARD_PINNACLE_DVC_90 9
55#define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900 10
56#define EM2880_BOARD_TERRATEC_HYBRID_XS 11
57#define EM2820_BOARD_KWORLD_PVRTV2800RF 12
58#define EM2880_BOARD_TERRATEC_PRODIGY_XS 13
59#define EM2820_BOARD_PROLINK_PLAYTV_USB2 14
60#define EM2800_BOARD_VGEAR_POCKETTV 15
61#define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_950 16
62#define EM2880_BOARD_PINNACLE_PCTV_HD_PRO 17
63#define EM2880_BOARD_HAUPPAUGE_WINTV_HVR_900_R2 18
64#define EM2860_BOARD_SAA711X_REFERENCE_DESIGN 19
65#define EM2880_BOARD_AMD_ATI_TV_WONDER_HD_600 20
66#define EM2800_BOARD_GRABBEEX_USB2800 21
95b86a9a
DSL
67#define EM2750_BOARD_UNKNOWN 22
68#define EM2750_BOARD_DLCW_130 23
69#define EM2820_BOARD_DLINK_USB_TV 24
70#define EM2820_BOARD_GADMEI_UTV310 25
71#define EM2820_BOARD_HERCULES_SMART_TV_USB2 26
72#define EM2820_BOARD_PINNACLE_USB_2_FM1216ME 27
73#define EM2820_BOARD_LEADTEK_WINFAST_USBII_DELUXE 28
443fed9f 74#define EM2860_BOARD_TVP5150_REFERENCE_DESIGN 29
95b86a9a
DSL
75#define EM2820_BOARD_VIDEOLOGY_20K14XUSB 30
76#define EM2821_BOARD_USBGEAR_VD204 31
77#define EM2821_BOARD_SUPERCOMP_USB_2 32
8298f2f8 78#define EM2860_BOARD_ELGATO_VIDEO_CAPTURE 33
95b86a9a
DSL
79#define EM2860_BOARD_TERRATEC_HYBRID_XS 34
80#define EM2860_BOARD_TYPHOON_DVD_MAKER 35
81#define EM2860_BOARD_NETGMBH_CAM 36
82#define EM2860_BOARD_GADMEI_UTV330 37
83#define EM2861_BOARD_YAKUMO_MOVIE_MIXER 38
84#define EM2861_BOARD_KWORLD_PVRTV_300U 39
85#define EM2861_BOARD_PLEXTOR_PX_TV100U 40
86#define EM2870_BOARD_KWORLD_350U 41
87#define EM2870_BOARD_KWORLD_355U 42
88#define EM2870_BOARD_TERRATEC_XS 43
89#define EM2870_BOARD_TERRATEC_XS_MT2060 44
90#define EM2870_BOARD_PINNACLE_PCTV_DVB 45
91#define EM2870_BOARD_COMPRO_VIDEOMATE 46
92#define EM2880_BOARD_KWORLD_DVB_305U 47
93#define EM2880_BOARD_KWORLD_DVB_310U 48
94#define EM2880_BOARD_MSI_DIGIVOX_AD 49
95#define EM2880_BOARD_MSI_DIGIVOX_AD_II 50
96#define EM2880_BOARD_TERRATEC_HYBRID_XS_FR 51
97#define EM2881_BOARD_DNT_DA2_HYBRID 52
98#define EM2881_BOARD_PINNACLE_HYBRID_PRO 53
99#define EM2882_BOARD_KWORLD_VS_DVBT 54
100#define EM2882_BOARD_TERRATEC_HYBRID_XS 55
09bc1942 101#define EM2882_BOARD_PINNACLE_HYBRID_PRO_330E 56
d5b6a746 102#define EM2883_BOARD_KWORLD_HYBRID_330U 57
ee281b85 103#define EM2820_BOARD_COMPRO_VIDEOMATE_FORYOU 58
f89bc329 104#define EM2883_BOARD_HAUPPAUGE_WINTV_HVR_850 60
1e1addd5 105#define EM2820_BOARD_PROLINK_PLAYTV_BOX4_USB2 61
f7fe3e6f 106#define EM2820_BOARD_GADMEI_TVR200 62
d5b6a746
FS
107#define EM2860_BOARD_KAIOMY_TVNPC_U2 63
108#define EM2860_BOARD_EASYCAP 64
f74a61e3 109#define EM2820_BOARD_IODATA_GVMVP_SZ 65
e5db5d44 110#define EM2880_BOARD_EMPIRE_DUAL_TV 66
4557af9c 111#define EM2860_BOARD_TERRATEC_GRABBY 67
766ed64d 112#define EM2860_BOARD_TERRATEC_AV350 68
d7de5d8f 113#define EM2882_BOARD_KWORLD_ATSC_315U 69
19859229 114#define EM2882_BOARD_EVGA_INDTUBE 70
d5b6a746
FS
115#define EM2820_BOARD_SILVERCREST_WEBCAM 71
116#define EM2861_BOARD_GADMEI_UTV330PLUS 72
117#define EM2870_BOARD_REDDO_DVB_C_USB_BOX 73
694a101e 118#define EM2800_BOARD_VC211A 74
7ca7ef60 119#define EM2882_BOARD_DIKOM_DK300 75
7e48b30a 120#define EM2870_BOARD_KWORLD_A340 76
fec528b7 121#define EM2874_BOARD_LEADERSHIP_ISDBT 77
d5b6a746 122#define EM28174_BOARD_PCTV_290E 78
fec528b7 123#define EM2884_BOARD_TERRATEC_H5 79
d5b6a746 124#define EM28174_BOARD_PCTV_460E 80
82e7dbbd 125#define EM2884_BOARD_HAUPPAUGE_WINTV_HVR_930C 81
a1ed02e9 126#define EM2884_BOARD_CINERGY_HTC_STICK 82
d5b6a746
FS
127#define EM2860_BOARD_HT_VIDBOX_NW03 83
128#define EM2874_BOARD_MAXMEDIA_UB425_TC 84
129#define EM2884_BOARD_PCTV_510E 85
130#define EM2884_BOARD_PCTV_520E 86
89040136 131#define EM2884_BOARD_TERRATEC_HTC_USB_XS 87
4159d01b 132#define EM2884_BOARD_C3TECH_DIGITAL_DUO 88
7c1dfdb0 133#define EM2874_BOARD_DELOCK_61959 89
6dbea9f0 134#define EM2874_BOARD_KWORLD_UB435Q_V2 90
0c37e736 135#define EM2765_BOARD_SPEEDLINK_VAD_LAPLACE 91
ec573362 136#define EM28178_BOARD_PCTV_461E 92
3aefb79a
MCC
137
138/* Limits minimum and default number of buffers */
139#define EM28XX_MIN_BUF 4
140#define EM28XX_DEF_BUF 8
a6c2ba28 141
c4a98793
MCC
142/*Limits the max URB message size */
143#define URB_MAX_CTRL_SIZE 80
144
95b86a9a
DSL
145/* Params for validated field */
146#define EM28XX_BOARD_NOT_VALIDATED 1
147#define EM28XX_BOARD_VALIDATED 0
148
22cff7b3
DSL
149/* Params for em28xx_cmd() audio */
150#define EM28XX_START_AUDIO 1
151#define EM28XX_STOP_AUDIO 0
152
596d92d5 153/* maximum number of em28xx boards */
3687e1e6 154#define EM28XX_MAXBOARDS 4 /*FIXME: should be bigger */
596d92d5 155
a6c2ba28 156/* maximum number of frames that can be queued */
3acf2809 157#define EM28XX_NUM_FRAMES 5
a6c2ba28 158/* number of frames that get used for v4l2_read() */
3acf2809 159#define EM28XX_NUM_READ_FRAMES 2
a6c2ba28 160
161/* number of buffers for isoc transfers */
3acf2809 162#define EM28XX_NUM_BUFS 5
86d38d1e 163#define EM28XX_DVB_NUM_BUFS 5
a6c2ba28 164
c7a45e5b
MCC
165/* max number of I2C buses on em28xx devices */
166#define NUM_I2C_BUSES 2
167
515688a8 168/* isoc transfers: number of packets for each buffer
33c02fac 169 windows requests only 64 packets .. so we better do the same
d5e52653
MCC
170 this is what I found out for all alternate numbers there!
171 */
515688a8
FS
172#define EM28XX_NUM_ISOC_PACKETS 64
173#define EM28XX_DVB_NUM_ISOC_PACKETS 64
a6c2ba28 174
c647a91a
FS
175/* bulk transfers: transfer buffer size = packet size * packet multiplier
176 USB 2.0 spec says bulk packet size is always 512 bytes
177 */
178#define EM28XX_BULK_PACKET_MULTIPLIER 384
179#define EM28XX_DVB_BULK_PACKET_MULTIPLIER 384
180
3acf2809 181#define EM28XX_INTERLACED_DEFAULT 1
a6c2ba28 182
596d92d5 183/* time in msecs to wait for i2c writes to finish */
2fcc82d8 184#define EM2800_I2C_XFER_TIMEOUT 20
596d92d5 185
f5222609
FS
186/* max. number of button state polling addresses */
187#define EM28XX_NUM_BUTTON_ADDRESSES_MAX 5
188
3aefb79a 189enum em28xx_mode {
2fe3e2ee 190 EM28XX_SUSPEND,
3aefb79a
MCC
191 EM28XX_ANALOG_MODE,
192 EM28XX_DIGITAL_MODE,
193};
194
a6c2ba28 195
579f72e4
AT
196struct em28xx;
197
f0fa9936 198struct em28xx_usb_bufs {
ad0ebb96
MCC
199 /* max packet size of isoc transaction */
200 int max_pkt_size;
201
86d38d1e
GG
202 /* number of packets in each buffer */
203 int num_packets;
204
ad0ebb96
MCC
205 /* number of allocated urbs */
206 int num_bufs;
207
f0fa9936 208 /* urb for isoc/bulk transfers */
ad0ebb96
MCC
209 struct urb **urb;
210
f0fa9936 211 /* transfer buffers for isoc/bulk transfer */
ad0ebb96 212 char **transfer_buffer;
86d38d1e
GG
213};
214
74209dc0
FS
215struct em28xx_usb_ctl {
216 /* isoc/bulk transfer buffers for analog mode */
f0fa9936 217 struct em28xx_usb_bufs analog_bufs;
86d38d1e 218
74209dc0 219 /* isoc/bulk transfer buffers for digital mode */
f0fa9936 220 struct em28xx_usb_bufs digital_bufs;
ad0ebb96 221
ad0ebb96 222 /* Stores already requested buffers */
28abf083
DH
223 struct em28xx_buffer *vid_buf;
224 struct em28xx_buffer *vbi_buf;
ad0ebb96 225
74209dc0
FS
226 /* copy data from URB */
227 int (*urb_data_copy) (struct em28xx *dev, struct urb *urb);
579f72e4 228
ad0ebb96
MCC
229};
230
bddcf633 231/* Struct to enumberate video formats */
ad0ebb96
MCC
232struct em28xx_fmt {
233 char *name;
234 u32 fourcc; /* v4l2 format id */
bddcf633
MCC
235 int depth;
236 int reg;
ad0ebb96
MCC
237};
238
239/* buffer for one video frame */
240struct em28xx_buffer {
241 /* common v4l buffer stuff -- must be first */
d3829fad
DH
242 struct vb2_buffer vb;
243 struct list_head list;
ad0ebb96 244
d3829fad
DH
245 void *mem;
246 unsigned int length;
a6c2ba28 247 int top_field;
8732533b
FS
248
249 /* counter to control buffer fill */
250 unsigned int pos;
251 /* NOTE; in interlaced mode, this value is reset to zero at
252 * the start of each new field (not frame !) */
4078d625
FS
253
254 /* pointer to vmalloc memory address in vb */
255 char *vb_buf;
ad0ebb96
MCC
256};
257
258struct em28xx_dmaqueue {
259 struct list_head active;
ad0ebb96
MCC
260
261 wait_queue_head_t wq;
a6c2ba28 262};
263
a6c2ba28 264/* inputs */
265
3acf2809
MCC
266#define MAX_EM28XX_INPUT 4
267enum enum28xx_itype {
268 EM28XX_VMUX_COMPOSITE1 = 1,
269 EM28XX_VMUX_COMPOSITE2,
270 EM28XX_VMUX_COMPOSITE3,
271 EM28XX_VMUX_COMPOSITE4,
272 EM28XX_VMUX_SVIDEO,
273 EM28XX_VMUX_TELEVISION,
274 EM28XX_VMUX_CABLE,
275 EM28XX_VMUX_DVB,
276 EM28XX_VMUX_DEBUG,
277 EM28XX_RADIO,
a6c2ba28 278};
279
35643943
MCC
280enum em28xx_ac97_mode {
281 EM28XX_NO_AC97 = 0,
282 EM28XX_AC97_EM202,
209acc02 283 EM28XX_AC97_SIGMATEL,
35643943
MCC
284 EM28XX_AC97_OTHER,
285};
286
287struct em28xx_audio_mode {
288 enum em28xx_ac97_mode ac97;
289
290 u16 ac97_feat;
16c7bcad 291 u32 ac97_vendor_id;
35643943
MCC
292
293 unsigned int has_audio:1;
294
295 unsigned int i2s_3rates:1;
296 unsigned int i2s_5rates:1;
5c2231c8
DH
297};
298
5faff789
MCC
299/* em28xx has two audio inputs: tuner and line in.
300 However, on most devices, an auxiliary AC97 codec device is used.
301 The AC97 device may have several different inputs and outputs,
302 depending on their model. So, it is possible to use AC97 mixer to
303 address more than two different entries.
304 */
539c96d0 305enum em28xx_amux {
5faff789
MCC
306 /* This is the only entry for em28xx tuner input */
307 EM28XX_AMUX_VIDEO, /* em28xx tuner, AC97 mixer Video */
308
309 EM28XX_AMUX_LINE_IN, /* AC97 mixer Line In */
310
311 /* Some less-common mixer setups */
312 EM28XX_AMUX_VIDEO2, /* em28xx Line in, AC97 mixer Video */
313 EM28XX_AMUX_PHONE,
314 EM28XX_AMUX_MIC,
315 EM28XX_AMUX_CD,
316 EM28XX_AMUX_AUX,
317 EM28XX_AMUX_PCM_OUT,
539c96d0
MCC
318};
319
35ae6f04 320enum em28xx_aout {
8866f9cf 321 /* AC97 outputs */
e879b8eb
MCC
322 EM28XX_AOUT_MASTER = 1 << 0,
323 EM28XX_AOUT_LINE = 1 << 1,
324 EM28XX_AOUT_MONO = 1 << 2,
325 EM28XX_AOUT_LFE = 1 << 3,
326 EM28XX_AOUT_SURR = 1 << 4,
8866f9cf
MCC
327
328 /* PCM IN Mixer - used by AC97_RECORD_SELECT register */
329 EM28XX_AOUT_PCM_IN = 1 << 7,
330
331 /* Bits 10-8 are used to indicate the PCM IN record select */
332 EM28XX_AOUT_PCM_MIC_PCM = 0 << 8,
333 EM28XX_AOUT_PCM_CD = 1 << 8,
334 EM28XX_AOUT_PCM_VIDEO = 2 << 8,
335 EM28XX_AOUT_PCM_AUX = 3 << 8,
336 EM28XX_AOUT_PCM_LINE = 4 << 8,
337 EM28XX_AOUT_PCM_STEREO = 5 << 8,
338 EM28XX_AOUT_PCM_MONO = 6 << 8,
339 EM28XX_AOUT_PCM_PHONE = 7 << 8,
35ae6f04
MCC
340};
341
32929fb4 342static inline int ac97_return_record_select(int a_out)
8866f9cf
MCC
343{
344 return (a_out & 0x700) >> 8;
345}
346
122b77e5
MCC
347struct em28xx_reg_seq {
348 int reg;
349 unsigned char val, mask;
350 int sleep;
351};
352
3acf2809
MCC
353struct em28xx_input {
354 enum enum28xx_itype type;
a6c2ba28 355 unsigned int vmux;
539c96d0 356 enum em28xx_amux amux;
35ae6f04 357 enum em28xx_aout aout;
122b77e5 358 struct em28xx_reg_seq *gpio;
a6c2ba28 359};
360
3acf2809 361#define INPUT(nr) (&em28xx_boards[dev->model].input[nr])
a6c2ba28 362
3acf2809 363enum em28xx_decoder {
527f09a9 364 EM28XX_NODECODER = 0,
3acf2809 365 EM28XX_TVP5150,
ec5de990 366 EM28XX_SAA711X,
527f09a9
MCC
367};
368
369enum em28xx_sensor {
370 EM28XX_NOSENSOR = 0,
02e7804b 371 EM28XX_MT9V011,
b80fd2d8 372 EM28XX_MT9M001,
f2e26ae7 373 EM28XX_MT9M111,
e4b7131d 374 EM28XX_OV2640,
a6c2ba28 375};
376
df7fa09c
MCC
377enum em28xx_adecoder {
378 EM28XX_NOADECODER = 0,
379 EM28XX_TVAUDIO,
380};
381
6b8a3170
FS
382enum em28xx_led_role {
383 EM28XX_LED_ANALOG_CAPTURING = 0,
6063d077 384 EM28XX_LED_ILLUMINATION,
6b8a3170
FS
385 EM28XX_NUM_LED_ROLES, /* must be the last */
386};
387
07e4de30 388struct em28xx_led {
6b8a3170 389 enum em28xx_led_role role;
07e4de30
FS
390 u8 gpio_reg;
391 u8 gpio_mask;
392 bool inverted;
393};
394
f5222609
FS
395enum em28xx_button_role {
396 EM28XX_BUTTON_SNAPSHOT = 0,
6063d077 397 EM28XX_BUTTON_ILLUMINATION,
f5222609
FS
398 EM28XX_NUM_BUTTON_ROLES, /* must be the last */
399};
400
401struct em28xx_button {
402 enum em28xx_button_role role;
403 u8 reg_r;
404 u8 reg_clearing;
405 u8 mask;
406 bool inverted;
407};
408
3acf2809 409struct em28xx_board {
a6c2ba28 410 char *name;
505b6d0b 411 int vchannels;
a6c2ba28 412 int tuner_type;
66767920 413 int tuner_addr;
aab3125c 414 unsigned def_i2c_bus; /* Default I2C bus */
a6c2ba28 415
416 /* i2c flags */
417 unsigned int tda9887_conf;
418
017ab4b1 419 /* GPIO sequences */
122b77e5 420 struct em28xx_reg_seq *dvb_gpio;
2fe3e2ee 421 struct em28xx_reg_seq *suspend_gpio;
017ab4b1 422 struct em28xx_reg_seq *tuner_gpio;
2bd1d9eb 423 struct em28xx_reg_seq *mute_gpio;
122b77e5 424
74f38a82 425 unsigned int is_em2800:1;
a6c2ba28 426 unsigned int has_msp34xx:1;
5add9a6f 427 unsigned int mts_firmware:1;
c8793b03 428 unsigned int max_range_640_480:1;
3aefb79a 429 unsigned int has_dvb:1;
c43221df 430 unsigned int is_webcam:1;
95b86a9a 431 unsigned int valid:1;
ac07bb73 432 unsigned int has_ir_i2c:1;
3abee53e 433
a2070c66 434 unsigned char xclk, i2c_speed;
f2cf250a
DSL
435 unsigned char radio_addr;
436 unsigned short tvaudio_addr;
a2070c66 437
3acf2809 438 enum em28xx_decoder decoder;
df7fa09c 439 enum em28xx_adecoder adecoder;
a6c2ba28 440
3acf2809 441 struct em28xx_input input[MAX_EM28XX_INPUT];
0be43754 442 struct em28xx_input radio;
02858eed 443 char *ir_codes;
07e4de30
FS
444
445 /* LEDs that need to be controlled explicitly */
6b8a3170 446 struct em28xx_led *leds;
f5222609
FS
447
448 /* Buttons */
449 struct em28xx_button *buttons;
a6c2ba28 450};
451
3acf2809 452struct em28xx_eeprom {
0c28dcc0
FS
453 u8 id[4]; /* 1a eb 67 95 */
454 __le16 vendor_ID;
455 __le16 product_ID;
a6c2ba28 456
0c28dcc0 457 __le16 chip_conf;
a6c2ba28 458
0c28dcc0 459 __le16 board_conf;
a6c2ba28 460
0c28dcc0 461 __le16 string1, string2, string3;
a6c2ba28 462
463 u8 string_idx_table;
464};
465
6d79468d
MCC
466#define EM28XX_AUDIO_BUFS 5
467#define EM28XX_NUM_AUDIO_PACKETS 64
468#define EM28XX_AUDIO_MAX_PACKET_SIZE 196 /* static value */
469#define EM28XX_CAPTURE_STREAM_EN 1
3aefb79a
MCC
470
471/* em28xx extensions */
6d79468d 472#define EM28XX_AUDIO 0x10
3aefb79a 473#define EM28XX_DVB 0x20
f4d4e765 474#define EM28XX_RC 0x30
6d79468d 475
8c873d31
DH
476/* em28xx resource types (used for res_get/res_lock etc */
477#define EM28XX_RESOURCE_VIDEO 0x01
478#define EM28XX_RESOURCE_VBI 0x02
479
6d79468d
MCC
480struct em28xx_audio {
481 char name[50];
482 char *transfer_buffer[EM28XX_AUDIO_BUFS];
483 struct urb *urb[EM28XX_AUDIO_BUFS];
484 struct usb_device *udev;
485 unsigned int capture_transfer_done;
486 struct snd_pcm_substream *capture_pcm_substream;
487
488 unsigned int hwptr_done_capture;
489 struct snd_card *sndcard;
490
c744dff2 491 int users;
6d79468d
MCC
492 spinlock_t slock;
493};
494
52284c3e
MCC
495struct em28xx;
496
497struct em28xx_fh {
69a61642 498 struct v4l2_fh fh;
52284c3e 499 struct em28xx *dev;
52284c3e
MCC
500
501 enum v4l2_buf_type type;
502};
503
a3ea4bf9
FS
504enum em28xx_i2c_algo_type {
505 EM28XX_I2C_ALGO_EM28XX = 0,
506 EM28XX_I2C_ALGO_EM2800,
507 EM28XX_I2C_ALGO_EM25XX_BUS_B,
508};
509
aab3125c
MCC
510struct em28xx_i2c_bus {
511 struct em28xx *dev;
512
513 unsigned bus;
a3ea4bf9 514 enum em28xx_i2c_algo_type algo_type;
aab3125c
MCC
515};
516
517
a6c2ba28 518/* main device struct */
3acf2809 519struct em28xx {
a6c2ba28 520 /* generic device properties */
521 char name[30]; /* name (including minor) of the device */
522 int model; /* index in the device_data struct */
e5589bef 523 int devno; /* marks the number of this device */
600bd7f0 524 enum em28xx_chip_id chip_id;
736a320b 525 unsigned int is_em25xx:1; /* em25xx/em276x/7x/8x family bridge */
505b6d0b 526
2665c299
FS
527 unsigned char disconnected:1; /* device has been diconnected */
528
4f83e7b3
MCC
529 int audio_ifnum;
530
f2cf250a 531 struct v4l2_device v4l2_dev;
081b945e 532 struct v4l2_ctrl_handler ctrl_handler;
fc5d0f8a 533 struct v4l2_clk *clk;
505b6d0b
MCC
534 struct em28xx_board board;
535
d36bb4e7 536 /* Webcam specific fields */
527f09a9 537 enum em28xx_sensor em28xx_sensor;
55699964 538 int sensor_xres, sensor_yres;
d36bb4e7 539 int sensor_xtal;
527f09a9 540
8c301567 541 /* Progressive (non-interlaced) mode */
c2a6b54a
MCC
542 int progressive;
543
579d3152
MCC
544 /* Vinmode/Vinctl used at the driver */
545 int vinmode, vinctl;
546
d7448a8d 547 unsigned int has_audio_class:1;
24a613e4 548 unsigned int has_alsa_audio:1;
4f83e7b3 549 unsigned int is_audio_only:1;
a2070c66 550
39a96b4c 551 /* Controls audio streaming */
d5b6a746
FS
552 struct work_struct wq_trigger; /* Trigger to start/stop audio for alsa module */
553 atomic_t stream_started; /* stream should be running if true */
39a96b4c 554
bddcf633
MCC
555 struct em28xx_fmt *format;
556
a924a499
MCC
557 struct em28xx_IR *ir;
558
89b329ef
MCC
559 /* Some older em28xx chips needs a waiting time after writing */
560 unsigned int wait_after_write;
561
74f38a82
MCC
562 struct list_head devlist;
563
9bb13a6d
MCC
564 u32 i2s_speed; /* I2S speed for audio digital stream */
565
35643943 566 struct em28xx_audio_mode audio_mode;
a6c2ba28 567
568 int tuner_type; /* type of the tuner */
569 int tuner_addr; /* tuner address */
570 int tda9887_conf;
c7a45e5b 571
a6c2ba28 572 /* i2c i/o */
c7a45e5b
MCC
573 struct i2c_adapter i2c_adap[NUM_I2C_BUSES];
574 struct i2c_client i2c_client[NUM_I2C_BUSES];
aab3125c
MCC
575 struct em28xx_i2c_bus i2c_bus[NUM_I2C_BUSES];
576
87b52439 577 unsigned char eeprom_addrwidth_16bit:1;
aab3125c
MCC
578 unsigned def_i2c_bus; /* Default I2C bus */
579 unsigned cur_i2c_bus; /* Current I2C bus */
580 struct rt_mutex i2c_bus_lock;
c7a45e5b 581
a6c2ba28 582 /* video for linux */
583 int users; /* user count for exclusive use */
d3829fad 584 int streaming_users; /* Number of actively streaming users */
a6c2ba28 585 struct video_device *vdev; /* video for linux device struct */
7d497f8a 586 v4l2_std_id norm; /* selected tv norm */
a6c2ba28 587 int ctl_freq; /* selected frequency */
588 unsigned int ctl_input; /* selected input */
95b86a9a 589 unsigned int ctl_ainput;/* selected audio input */
35ae6f04 590 unsigned int ctl_aoutput;/* selected audio output */
a6c2ba28 591 int mute;
592 int volume;
593 /* frame properties */
a6c2ba28 594 int width; /* current frame width */
595 int height; /* current frame height */
d45b9b8a
HV
596 unsigned hscale; /* horizontal scale factor (see datasheet) */
597 unsigned vscale; /* vertical scale factor (see datasheet) */
a6c2ba28 598 int interlaced; /* 1=interlace fileds, 0=just top fileds */
9e31ced8 599 unsigned int video_bytesread; /* Number of bytes read */
a6c2ba28 600
03910cc3 601 unsigned long hash; /* eeprom hash - for boards with generic ID */
6ea54d93
DSL
602 unsigned long i2c_hash; /* i2c devicelist hash -
603 for boards with generic ID */
03910cc3 604
9baed99e 605 struct em28xx_audio adev;
6d79468d 606
960da93b 607 /* capture state tracking */
da52a55c 608 int capture_type;
0455eebf 609 unsigned char top_field:1;
960da93b 610 int vbi_read;
66d9cbad
DH
611 unsigned int vbi_width;
612 unsigned int vbi_height; /* lines per field */
da52a55c 613
d7448a8d
MCC
614 struct work_struct request_module_wk;
615
a6c2ba28 616 /* locks */
5a80415b 617 struct mutex lock;
f2a2e491 618 struct mutex ctrl_urb_lock; /* protects urb_buf */
d7aa8020 619 /* spinlock_t queue_lock; */
a6c2ba28 620 struct list_head inqueue, outqueue;
a6c2ba28 621 struct video_device *vbi_dev;
0be43754 622 struct video_device *radio_dev;
a6c2ba28 623
d3829fad
DH
624 /* Videobuf2 */
625 struct vb2_queue vb_vidq;
626 struct vb2_queue vb_vbiq;
627 struct mutex vb_queue_lock;
628 struct mutex vb_vbi_queue_lock;
629
8c873d31
DH
630 /* resources in use */
631 unsigned int resources;
632
510e884c
FS
633 /* eeprom content */
634 u8 *eedata;
635 u16 eedata_len;
a6c2ba28 636
ad0ebb96
MCC
637 /* Isoc control struct */
638 struct em28xx_dmaqueue vidq;
28abf083 639 struct em28xx_dmaqueue vbiq;
74209dc0 640 struct em28xx_usb_ctl usb_ctl;
ad0ebb96
MCC
641 spinlock_t slock;
642
d3829fad
DH
643 unsigned int field_count;
644 unsigned int vbi_field_count;
645
a6c2ba28 646 /* usb transfer */
647 struct usb_device *udev; /* the usb device */
c647a91a
FS
648 u8 analog_ep_isoc; /* address of isoc endpoint for analog */
649 u8 analog_ep_bulk; /* address of bulk endpoint for analog */
650 u8 dvb_ep_isoc; /* address of isoc endpoint for DVB */
d5b6a746 651 u8 dvb_ep_bulk; /* address of bulk endpoint for DVB */
0cf544a6
FS
652 int alt; /* alternate setting */
653 int max_pkt_size; /* max packet size of the selected ep at alt */
c647a91a
FS
654 int packet_multiplier; /* multiplier for wMaxPacketSize, used for
655 URB buffer size definition */
0cf544a6
FS
656 int num_alt; /* number of alternative settings */
657 unsigned int *alt_max_pkt_size_isoc; /* array of isoc wMaxPacketSize */
7312f2c9
FS
658 unsigned int analog_xfer_bulk:1; /* use bulk instead of isoc
659 transfers for analog */
0cf544a6
FS
660 int dvb_alt_isoc; /* alternate setting for DVB isoc transfers */
661 unsigned int dvb_max_pkt_size_isoc; /* isoc max packet size of the
662 selected DVB ep at dvb_alt */
7312f2c9
FS
663 unsigned int dvb_xfer_bulk:1; /* use bulk instead of isoc
664 transfers for DVB */
c4a98793
MCC
665 char urb_buf[URB_MAX_CTRL_SIZE]; /* urb control msg buffer */
666
a6c2ba28 667 /* helper funcs that call usb_control_msg */
6ea54d93 668 int (*em28xx_write_regs) (struct em28xx *dev, u16 reg,
a6c2ba28 669 char *buf, int len);
6ea54d93
DSL
670 int (*em28xx_read_reg) (struct em28xx *dev, u16 reg);
671 int (*em28xx_read_reg_req_len) (struct em28xx *dev, u8 req, u16 reg,
672 char *buf, int len);
673 int (*em28xx_write_regs_req) (struct em28xx *dev, u8 req, u16 reg,
a6c2ba28 674 char *buf, int len);
6ea54d93 675 int (*em28xx_read_reg_req) (struct em28xx *dev, u8 req, u16 reg);
3aefb79a
MCC
676
677 enum em28xx_mode mode;
678
f5222609
FS
679 /* Button state polling */
680 struct delayed_work buttons_query_work;
681 u8 button_polling_addresses[EM28XX_NUM_BUTTON_ADDRESSES_MAX];
7763481a 682 u8 button_polling_last_values[EM28XX_NUM_BUTTON_ADDRESSES_MAX];
f5222609
FS
683 u8 num_button_polling_addresses;
684 /* Snapshot button input device */
a9fc52bc
DH
685 char snapshot_button_path[30]; /* path of the input dev */
686 struct input_dev *sbutton_input_dev;
a9fc52bc 687
3421b778 688 struct em28xx_dvb *dvb;
a6c2ba28 689};
690
6d79468d
MCC
691struct em28xx_ops {
692 struct list_head next;
693 char *name;
694 int id;
695 int (*init)(struct em28xx *);
696 int (*fini)(struct em28xx *);
a3a048ce
MCC
697};
698
3acf2809 699/* Provided by em28xx-i2c.c */
aab3125c 700void em28xx_do_i2c_scan(struct em28xx *dev, unsigned bus);
a3ea4bf9
FS
701int em28xx_i2c_register(struct em28xx *dev, unsigned bus,
702 enum em28xx_i2c_algo_type algo_type);
aab3125c 703int em28xx_i2c_unregister(struct em28xx *dev, unsigned bus);
a6c2ba28 704
3acf2809 705/* Provided by em28xx-core.c */
3acf2809 706int em28xx_read_reg_req_len(struct em28xx *dev, u8 req, u16 reg,
a6c2ba28 707 char *buf, int len);
3acf2809
MCC
708int em28xx_read_reg_req(struct em28xx *dev, u8 req, u16 reg);
709int em28xx_read_reg(struct em28xx *dev, u16 reg);
710int em28xx_write_regs_req(struct em28xx *dev, u8 req, u16 reg, char *buf,
a6c2ba28 711 int len);
3acf2809 712int em28xx_write_regs(struct em28xx *dev, u16 reg, char *buf, int len);
b6972489 713int em28xx_write_reg(struct em28xx *dev, u16 reg, u8 val);
1bad429e
MCC
714int em28xx_write_reg_bits(struct em28xx *dev, u16 reg, u8 val,
715 u8 bitmask);
6063d077 716int em28xx_toggle_reg_bits(struct em28xx *dev, u16 reg, u8 bitmask);
b6972489 717
531c98e7
MCC
718int em28xx_read_ac97(struct em28xx *dev, u8 reg);
719int em28xx_write_ac97(struct em28xx *dev, u8 reg, u16 val);
720
3acf2809 721int em28xx_audio_analog_set(struct em28xx *dev);
35643943 722int em28xx_audio_setup(struct em28xx *dev);
539c96d0 723
3acf2809 724int em28xx_colorlevels_set_default(struct em28xx *dev);
6b8a3170
FS
725const struct em28xx_led *em28xx_find_led(struct em28xx *dev,
726 enum em28xx_led_role role);
3acf2809 727int em28xx_capture_start(struct em28xx *dev, int start);
da52a55c 728int em28xx_vbi_supported(struct em28xx *dev);
bddcf633 729int em28xx_set_outfmt(struct em28xx *dev);
3acf2809 730int em28xx_resolution_set(struct em28xx *dev);
3acf2809 731int em28xx_set_alternate(struct em28xx *dev);
6ddd89d0
FS
732int em28xx_alloc_urbs(struct em28xx *dev, enum em28xx_mode mode, int xfer_bulk,
733 int num_bufs, int max_pkt_size, int packet_multiplier);
057ca0da
FS
734int em28xx_init_usb_xfer(struct em28xx *dev, enum em28xx_mode mode,
735 int xfer_bulk,
736 int num_bufs, int max_pkt_size, int packet_multiplier,
737 int (*urb_data_copy)
738 (struct em28xx *dev, struct urb *urb));
afb177e0 739void em28xx_uninit_usb_xfer(struct em28xx *dev, enum em28xx_mode mode);
5f5f147f 740void em28xx_stop_urbs(struct em28xx *dev);
c67ec53f
MCC
741int em28xx_set_mode(struct em28xx *dev, enum em28xx_mode set_mode);
742int em28xx_gpio_set(struct em28xx *dev, struct em28xx_reg_seq *gpio);
1a23f81b 743void em28xx_wake_i2c(struct em28xx *dev);
6d79468d
MCC
744int em28xx_register_extension(struct em28xx_ops *dev);
745void em28xx_unregister_extension(struct em28xx_ops *dev);
1a23f81b
MCC
746void em28xx_init_extension(struct em28xx *dev);
747void em28xx_close_extension(struct em28xx *dev);
748
749/* Provided by em28xx-video.c */
d3829fad 750int em28xx_vb2_setup(struct em28xx *dev);
1a23f81b
MCC
751int em28xx_register_analog_devices(struct em28xx *dev);
752void em28xx_release_analog_resources(struct em28xx *dev);
081b945e 753void em28xx_ctrl_notify(struct v4l2_ctrl *ctrl, void *priv);
d3829fad
DH
754int em28xx_start_analog_streaming(struct vb2_queue *vq, unsigned int count);
755int em28xx_stop_vbi_streaming(struct vb2_queue *vq);
081b945e 756extern const struct v4l2_ctrl_ops em28xx_ctrl_ops;
6d79468d 757
3acf2809 758/* Provided by em28xx-cards.c */
3acf2809
MCC
759extern struct em28xx_board em28xx_boards[];
760extern struct usb_device_id em28xx_id_table[];
d7cba043 761int em28xx_tuner_callback(void *ptr, int component, int command, int arg);
1a23f81b 762void em28xx_release_resources(struct em28xx *dev);
c8793b03 763
28abf083 764/* Provided by em28xx-vbi.c */
d3829fad 765extern struct vb2_ops em28xx_vbi_qops;
28abf083 766
855ff38e
FS
767/* Provided by em28xx-camera.c */
768int em28xx_detect_sensor(struct em28xx *dev);
769int em28xx_init_camera(struct em28xx *dev);
770
a6c2ba28 771/* printk macros */
772
3acf2809 773#define em28xx_err(fmt, arg...) do {\
f85c657f 774 printk(KERN_ERR fmt , ##arg); } while (0)
a6c2ba28 775
3acf2809 776#define em28xx_errdev(fmt, arg...) do {\
4ac97914 777 printk(KERN_ERR "%s: "fmt,\
f85c657f 778 dev->name , ##arg); } while (0)
a6c2ba28 779
3acf2809 780#define em28xx_info(fmt, arg...) do {\
4ac97914 781 printk(KERN_INFO "%s: "fmt,\
f85c657f 782 dev->name , ##arg); } while (0)
3acf2809 783#define em28xx_warn(fmt, arg...) do {\
4ac97914 784 printk(KERN_WARNING "%s: "fmt,\
f85c657f 785 dev->name , ##arg); } while (0)
a6c2ba28 786
6ea54d93 787static inline int em28xx_compression_disable(struct em28xx *dev)
a6c2ba28 788{
789 /* side effect of disabling scaler and mixer */
2a29a0d7 790 return em28xx_write_reg(dev, EM28XX_R26_COMPR, 0x00);
a6c2ba28 791}
792
a6c2ba28 793/*FIXME: maxw should be dependent of alt mode */
6ea54d93 794static inline unsigned int norm_maxw(struct em28xx *dev)
30556b23 795{
55699964
MCC
796 if (dev->board.is_webcam)
797 return dev->sensor_xres;
798
1020d13d 799 if (dev->board.max_range_640_480)
7d497f8a 800 return 640;
55699964
MCC
801
802 return 720;
30556b23
MR
803}
804
6ea54d93 805static inline unsigned int norm_maxh(struct em28xx *dev)
a6c2ba28 806{
55699964
MCC
807 if (dev->board.is_webcam)
808 return dev->sensor_yres;
809
505b6d0b 810 if (dev->board.max_range_640_480)
7d497f8a 811 return 480;
55699964
MCC
812
813 return (dev->norm & V4L2_STD_625_50) ? 576 : 480;
a6c2ba28 814}
a6c2ba28 815#endif
This page took 0.905417 seconds and 5 git commands to generate.