]> git.proxmox.com Git - mirror_ubuntu-artful-kernel.git/blame - drivers/media/video/em28xx/em28xx.h
[PATCH] v4l: 885: second round of i2c ids redefinition cleanup
[mirror_ubuntu-artful-kernel.git] / drivers / media / video / em28xx / em28xx.h
CommitLineData
a6c2ba28 1/*
596d92d5 2 em2820-cards.c - driver for Empia EM2800/EM2820/2840 USB video capture devices
a6c2ba28 3
4 Copyright (C) 2005 Markus Rechberger <mrechberger@gmail.com>
4ac97914
MCC
5 Ludovico Cavedon <cavedon@sssup.it>
6 Mauro Carvalho Chehab <mchehab@brturbo.com.br>
a6c2ba28 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 _EM2820_H
26#define _EM2820_H
27
28#include <linux/videodev.h>
29#include <linux/i2c.h>
d5e52653 30#include <media/ir-kbd-i2c.h>
a6c2ba28 31
596d92d5
MCC
32/* Boards supported by driver */
33
34#define EM2800_BOARD_UNKNOWN 0
35#define EM2820_BOARD_UNKNOWN 1
36#define EM2820_BOARD_TERRATEC_CINERGY_250 2
37#define EM2820_BOARD_PINNACLE_USB_2 3
38#define EM2820_BOARD_HAUPPAUGE_WINTV_USB_2 4
39#define EM2820_BOARD_MSI_VOX_USB_2 5
40#define EM2800_BOARD_TERRATEC_CINERGY_200 6
41#define EM2800_BOARD_LEADTEK_WINFAST_USBII 7
42#define EM2800_BOARD_KWORLD_USB2800 8
45632c4f 43#define EM2820_BOARD_PINNACLE_DVC_90 9
596d92d5
MCC
44
45#define UNSET -1
46
47/* maximum number of em28xx boards */
48#define EM2820_MAXBOARDS 1 /*FIXME: should be bigger */
49
a6c2ba28 50/* maximum number of frames that can be queued */
51#define EM2820_NUM_FRAMES 5
52/* number of frames that get used for v4l2_read() */
53#define EM2820_NUM_READ_FRAMES 2
54
55/* number of buffers for isoc transfers */
56#define EM2820_NUM_BUFS 5
57
d5e52653
MCC
58/* number of packets for each buffer
59 windows requests only 40 packets .. so we better do the same
60 this is what I found out for all alternate numbers there!
61 */
a6c2ba28 62#define EM2820_NUM_PACKETS 40
63
a6c2ba28 64/* default alternate; 0 means choose the best */
65#define EM2820_PINOUT 0
66#define EM2820_MAX_ALT 7
67
68#define EM2820_INTERLACED_DEFAULT 1
69
70/*
71#define (use usbview if you want to get the other alternate number infos)
72#define
73#define alternate number 2
74#define Endpoint Address: 82
75 Direction: in
76 Attribute: 1
77 Type: Isoc
78 Max Packet Size: 1448
79 Interval: 125us
80
81 alternate number 7
82
83 Endpoint Address: 82
84 Direction: in
85 Attribute: 1
86 Type: Isoc
87 Max Packet Size: 3072
88 Interval: 125us
89*/
90
91/* time to wait when stopping the isoc transfer */
92#define EM2820_URB_TIMEOUT msecs_to_jiffies(EM2820_NUM_BUFS * EM2820_NUM_PACKETS)
93
596d92d5
MCC
94/* time in msecs to wait for i2c writes to finish */
95#define EM2800_I2C_WRITE_TIMEOUT 20
96
a6c2ba28 97/* the various frame states */
98enum em2820_frame_state {
99 F_UNUSED = 0,
100 F_QUEUED,
101 F_GRABBING,
102 F_DONE,
103 F_ERROR,
104};
105
106/* stream states */
107enum em2820_stream_state {
108 STREAM_OFF,
109 STREAM_INTERRUPT,
110 STREAM_ON,
111};
112
113/* frames */
114struct em2820_frame_t {
115 void *bufmem;
116 struct v4l2_buffer buf;
117 enum em2820_frame_state state;
118 struct list_head frame;
119 unsigned long vma_use_count;
120 int top_field;
121 int fieldbytesused;
122};
123
124/* io methods */
125enum em2820_io_method {
126 IO_NONE,
127 IO_READ,
128 IO_MMAP,
129};
130
131/* inputs */
132
133#define MAX_EM2820_INPUT 4
134enum enum2820_itype {
135 EM2820_VMUX_COMPOSITE1 = 1,
136 EM2820_VMUX_COMPOSITE2,
137 EM2820_VMUX_COMPOSITE3,
138 EM2820_VMUX_COMPOSITE4,
139 EM2820_VMUX_SVIDEO,
140 EM2820_VMUX_TELEVISION,
141 EM2820_VMUX_CABLE,
142 EM2820_VMUX_DVB,
143 EM2820_VMUX_DEBUG,
144 EM2820_RADIO,
145};
146
147struct em2820_input {
148 enum enum2820_itype type;
149 unsigned int vmux;
150 unsigned int amux;
151};
152
153#define INPUT(nr) (&em2820_boards[dev->model].input[nr])
154
155enum em2820_decoder {
156 EM2820_TVP5150,
157 EM2820_SAA7113,
158 EM2820_SAA7114
159};
160
161struct em2820_board {
162 char *name;
a6c2ba28 163 int vchannels;
164 int norm;
165 int tuner_type;
166
167 /* i2c flags */
596d92d5 168 unsigned int is_em2800;
a6c2ba28 169 unsigned int tda9887_conf;
170
171 unsigned int has_tuner:1;
172 unsigned int has_msp34xx:1;
173
174 enum em2820_decoder decoder;
175
176 struct em2820_input input[MAX_EM2820_INPUT];
177};
178
179struct em2820_eeprom {
180 u32 id; /* 0x9567eb1a */
181 u16 vendor_ID;
182 u16 product_ID;
183
184 u16 chip_conf;
185
186 u16 board_conf;
187
188 u16 string1, string2, string3;
189
190 u8 string_idx_table;
191};
192
193/* device states */
194enum em2820_dev_state {
195 DEV_INITIALIZED = 0x01,
196 DEV_DISCONNECTED = 0x02,
197 DEV_MISCONFIGURED = 0x04,
198};
199
200/* tvnorms */
201struct em2820_tvnorm {
202 char *name;
203 v4l2_std_id id;
204 /* mode for saa7113h */
205 int mode;
206};
207
208/* main device struct */
209struct em2820 {
210 /* generic device properties */
211 char name[30]; /* name (including minor) of the device */
212 int model; /* index in the device_data struct */
596d92d5 213 unsigned int is_em2800;
a6c2ba28 214 int video_inputs; /* number of video inputs */
9c75541f 215 struct list_head devlist;
a6c2ba28 216 unsigned int has_tuner:1;
217 unsigned int has_msp34xx:1;
218 unsigned int has_tda9887:1;
219
220 enum em2820_decoder decoder;
221
222 int tuner_type; /* type of the tuner */
223 int tuner_addr; /* tuner address */
224 int tda9887_conf;
225 /* i2c i/o */
226 struct i2c_adapter i2c_adap;
227 struct i2c_client i2c_client;
228 /* video for linux */
229 int users; /* user count for exclusive use */
230 struct video_device *vdev; /* video for linux device struct */
231 struct video_picture vpic; /* picture settings only used to init saa7113h */
232 struct em2820_tvnorm *tvnorm; /* selected tv norm */
233 int ctl_freq; /* selected frequency */
234 unsigned int ctl_input; /* selected input */
235 unsigned int ctl_ainput; /* slected audio input */
236 int mute;
237 int volume;
238 /* frame properties */
239 struct em2820_frame_t frame[EM2820_NUM_FRAMES]; /* list of frames */
240 int num_frames; /* number of frames currently in use */
241 unsigned int frame_count; /* total number of transfered frames */
242 struct em2820_frame_t *frame_current; /* the frame that is being filled */
243 int width; /* current frame width */
244 int height; /* current frame height */
245 int frame_size; /* current frame size */
246 int field_size; /* current field size */
247 int bytesperline;
248 int hscale; /* horizontal scale factor (see datasheet) */
249 int vscale; /* vertical scale factor (see datasheet) */
250 int interlaced; /* 1=interlace fileds, 0=just top fileds */
251 int type;
252
253 /* states */
254 enum em2820_dev_state state;
255 enum em2820_stream_state stream;
256 enum em2820_io_method io;
257 /* locks */
258 struct semaphore lock, fileop_lock;
259 spinlock_t queue_lock;
260 struct list_head inqueue, outqueue;
261 wait_queue_head_t open, wait_frame, wait_stream;
262 struct video_device *vbi_dev;
263
264 unsigned char eedata[256];
265
266 /* usb transfer */
267 struct usb_device *udev; /* the usb device */
268 int alt; /* alternate */
269 int max_pkt_size; /* max packet size of isoc transaction */
270 unsigned int alt_max_pkt_size[EM2820_MAX_ALT + 1]; /* array of wMaxPacketSize */
271 struct urb *urb[EM2820_NUM_BUFS]; /* urb for isoc transfers */
272 char *transfer_buffer[EM2820_NUM_BUFS]; /* transfer buffers for isoc transfer */
273 /* helper funcs that call usb_control_msg */
274 int (*em2820_write_regs) (struct em2820 * dev, u16 reg, char *buf,
275 int len);
276 int (*em2820_read_reg) (struct em2820 * dev, u16 reg);
277 int (*em2820_read_reg_req_len) (struct em2820 * dev, u8 req, u16 reg,
278 char *buf, int len);
279 int (*em2820_write_regs_req) (struct em2820 * dev, u8 req, u16 reg,
280 char *buf, int len);
281 int (*em2820_read_reg_req) (struct em2820 * dev, u8 req, u16 reg);
282};
283
284/* Provided by em2820-i2c.c */
285
286void em2820_i2c_call_clients(struct em2820 *dev, unsigned int cmd, void *arg);
287int em2820_i2c_register(struct em2820 *dev);
288int em2820_i2c_unregister(struct em2820 *dev);
289
d5e52653
MCC
290/* Provided by em2820-input.c */
291
292void em2820_set_ir(struct em2820 * dev,struct IR_i2c *ir);
293
a6c2ba28 294/* Provided by em2820-core.c */
295
296void em2820_print_ioctl(char *name, unsigned int cmd);
297
298u32 em2820_request_buffers(struct em2820 *dev, u32 count);
299void em2820_queue_unusedframes(struct em2820 *dev);
300void em2820_release_buffers(struct em2820 *dev);
301
302int em2820_read_reg_req_len(struct em2820 *dev, u8 req, u16 reg,
303 char *buf, int len);
304int em2820_read_reg_req(struct em2820 *dev, u8 req, u16 reg);
305int em2820_read_reg(struct em2820 *dev, u16 reg);
306int em2820_write_regs_req(struct em2820 *dev, u8 req, u16 reg, char *buf,
307 int len);
308int em2820_write_regs(struct em2820 *dev, u16 reg, char *buf, int len);
309int em2820_write_reg_bits(struct em2820 *dev, u16 reg, u8 val,
310 u8 bitmask);
311int em2820_write_ac97(struct em2820 *dev, u8 reg, u8 * val);
312int em2820_audio_analog_set(struct em2820 *dev);
313int em2820_colorlevels_set_default(struct em2820 *dev);
314int em2820_capture_start(struct em2820 *dev, int start);
315int em2820_outfmt_set_yuv422(struct em2820 *dev);
316int em2820_accumulator_set(struct em2820 *dev, u8 xmin, u8 xmax, u8 ymin,
317 u8 ymax);
318int em2820_capture_area_set(struct em2820 *dev, u8 hstart, u8 vstart,
319 u16 width, u16 height);
320int em2820_scaler_set(struct em2820 *dev, u16 h, u16 v);
321int em2820_resolution_set(struct em2820 *dev);
322void em2820_isocIrq(struct urb *urb, struct pt_regs *regs);
323int em2820_init_isoc(struct em2820 *dev);
324void em2820_uninit_isoc(struct em2820 *dev);
325int em2820_set_alternate(struct em2820 *dev);
326
327/* Provided by em2820-cards.c */
596d92d5 328extern int em2800_variant_detect(struct usb_device* udev,int model);
a6c2ba28 329extern void em2820_card_setup(struct em2820 *dev);
330extern struct em2820_board em2820_boards[];
331extern struct usb_device_id em2820_id_table[];
596d92d5 332extern const unsigned int em2820_bcount;
a6c2ba28 333
334/* em2820 registers */
596d92d5 335#define CHIPID_REG 0x0a
a6c2ba28 336#define USBSUSP_REG 0x0c /* */
337
338#define AUDIOSRC_REG 0x0e
339#define XCLK_REG 0x0f
340
341#define VINMODE_REG 0x10
342#define VINCTRL_REG 0x11
343#define VINENABLE_REG 0x12 /* */
344
345#define GAMMA_REG 0x14
346#define RGAIN_REG 0x15
347#define GGAIN_REG 0x16
348#define BGAIN_REG 0x17
349#define ROFFSET_REG 0x18
350#define GOFFSET_REG 0x19
351#define BOFFSET_REG 0x1a
352
353#define OFLOW_REG 0x1b
354#define HSTART_REG 0x1c
355#define VSTART_REG 0x1d
356#define CWIDTH_REG 0x1e
357#define CHEIGHT_REG 0x1f
358
359#define YGAIN_REG 0x20
360#define YOFFSET_REG 0x21
361#define UVGAIN_REG 0x22
362#define UOFFSET_REG 0x23
363#define VOFFSET_REG 0x24
364#define SHARPNESS_REG 0x25
365
366#define COMPR_REG 0x26
367#define OUTFMT_REG 0x27
368
369#define XMIN_REG 0x28
370#define XMAX_REG 0x29
371#define YMIN_REG 0x2a
372#define YMAX_REG 0x2b
373
374#define HSCALELOW_REG 0x30
375#define HSCALEHIGH_REG 0x31
376#define VSCALELOW_REG 0x32
377#define VSCALEHIGH_REG 0x33
378
379#define AC97LSB_REG 0x40
380#define AC97MSB_REG 0x41
381#define AC97ADDR_REG 0x42
382#define AC97BUSY_REG 0x43
383
384/* em202 registers */
385#define MASTER_AC97 0x02
386#define VIDEO_AC97 0x14
387
388/* register settings */
389#define EM2820_AUDIO_SRC_TUNER 0xc0
390#define EM2820_AUDIO_SRC_LINE 0x80
391
392/* printk macros */
393
394#define em2820_err(fmt, arg...) do {\
4ac97914 395 printk(KERN_ERR fmt , ##arg); } while (0)
a6c2ba28 396
397#define em2820_errdev(fmt, arg...) do {\
4ac97914 398 printk(KERN_ERR "%s: "fmt,\
a6c2ba28 399 dev->name , ##arg); } while (0)
400
401#define em2820_info(fmt, arg...) do {\
4ac97914 402 printk(KERN_INFO "%s: "fmt,\
a6c2ba28 403 dev->name , ##arg); } while (0)
404#define em2820_warn(fmt, arg...) do {\
4ac97914 405 printk(KERN_WARNING "%s: "fmt,\
a6c2ba28 406 dev->name , ##arg); } while (0)
407
408inline static int em2820_audio_source(struct em2820 *dev, int input)
409{
410 return em2820_write_reg_bits(dev, AUDIOSRC_REG, input, 0xc0);
411}
412
413inline static int em2820_audio_usb_mute(struct em2820 *dev, int mute)
414{
415 return em2820_write_reg_bits(dev, XCLK_REG, mute ? 0x00 : 0x80, 0x80);
416}
417
418inline static int em2820_audio_analog_setup(struct em2820 *dev)
419{
420 /* unmute video mixer with default volume level */
421 return em2820_write_ac97(dev, VIDEO_AC97, "\x08\x08");
422}
423
424inline static int em2820_compression_disable(struct em2820 *dev)
425{
426 /* side effect of disabling scaler and mixer */
427 return em2820_write_regs(dev, COMPR_REG, "\x00", 1);
428}
429
430inline static int em2820_contrast_get(struct em2820 *dev)
431{
432 return em2820_read_reg(dev, YGAIN_REG) & 0x1f;
433}
434
435inline static int em2820_brightness_get(struct em2820 *dev)
436{
437 return em2820_read_reg(dev, YOFFSET_REG);
438}
439
440inline static int em2820_saturation_get(struct em2820 *dev)
441{
442 return em2820_read_reg(dev, UVGAIN_REG) & 0x1f;
443}
444
445inline static int em2820_u_balance_get(struct em2820 *dev)
446{
447 return em2820_read_reg(dev, UOFFSET_REG);
448}
449
450inline static int em2820_v_balance_get(struct em2820 *dev)
451{
452 return em2820_read_reg(dev, VOFFSET_REG);
453}
454
455inline static int em2820_gamma_get(struct em2820 *dev)
456{
457 return em2820_read_reg(dev, GAMMA_REG) & 0x3f;
458}
459
460inline static int em2820_contrast_set(struct em2820 *dev, s32 val)
461{
462 u8 tmp = (u8) val;
463 return em2820_write_regs(dev, YGAIN_REG, &tmp, 1);
464}
465
466inline static int em2820_brightness_set(struct em2820 *dev, s32 val)
467{
468 u8 tmp = (u8) val;
469 return em2820_write_regs(dev, YOFFSET_REG, &tmp, 1);
470}
471
472inline static int em2820_saturation_set(struct em2820 *dev, s32 val)
473{
474 u8 tmp = (u8) val;
475 return em2820_write_regs(dev, UVGAIN_REG, &tmp, 1);
476}
477
478inline static int em2820_u_balance_set(struct em2820 *dev, s32 val)
479{
480 u8 tmp = (u8) val;
481 return em2820_write_regs(dev, UOFFSET_REG, &tmp, 1);
482}
483
484inline static int em2820_v_balance_set(struct em2820 *dev, s32 val)
485{
486 u8 tmp = (u8) val;
487 return em2820_write_regs(dev, VOFFSET_REG, &tmp, 1);
488}
489
490inline static int em2820_gamma_set(struct em2820 *dev, s32 val)
491{
492 u8 tmp = (u8) val;
493 return em2820_write_regs(dev, GAMMA_REG, &tmp, 1);
494}
495
496/*FIXME: maxw should be dependent of alt mode */
30556b23
MR
497inline static unsigned int norm_maxw(struct em2820 *dev)
498{
499 switch(dev->model){
500 case (EM2820_BOARD_MSI_VOX_USB_2): return(640);
501 default: return(720);
502 }
503}
504
a6c2ba28 505inline static unsigned int norm_maxh(struct em2820 *dev)
506{
30556b23
MR
507 switch(dev->model){
508 case (EM2820_BOARD_MSI_VOX_USB_2): return(480);
509 default: return (dev->tvnorm->id & V4L2_STD_625_50) ? 576 : 480;
510 }
a6c2ba28 511}
512
513#endif