Revert "[PATCH] paravirt: Add startup infrastructure for paravirtualization"
[pv_ops_mirror.git] / drivers / media / video / usbvision / usbvision.h
blobbd6f6422ed5417053a61475ccab29e11bec02ea1
1 /*
2 * USBVISION.H
3 * usbvision header file
5 * Copyright (c) 1999-2005 Joerg Heckenbach <joerg@heckenbach-aw.de>
6 * Dwaine Garden <dwainegarden@rogers.com>
9 * Report problems to v4l MailingList : http://www.redhat.com/mailman/listinfo/video4linux-list
11 * This module is part of usbvision driver project.
12 * Updates to driver completed by Dwaine P. Garden
13 * v4l2 conversion by Thierry Merle <thierry.merle@free.fr>
15 * This program is free software; you can redistribute it and/or modify
16 * it under the terms of the GNU General Public License as published by
17 * the Free Software Foundation; either version 2 of the License, or
18 * (at your option) any later version.
20 * This program is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
23 * GNU General Public License for more details.
25 * You should have received a copy of the GNU General Public License
26 * along with this program; if not, write to the Free Software
27 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
31 #ifndef __LINUX_USBVISION_H
32 #define __LINUX_USBVISION_H
34 #include <linux/list.h>
35 #include <linux/usb.h>
36 #include <linux/i2c.h>
37 #include <media/v4l2-common.h>
38 #include <media/tuner.h>
39 #include <linux/videodev2.h>
41 #define USBVISION_DEBUG /* Turn on debug messages */
43 #ifndef VID_HARDWARE_USBVISION
44 #define VID_HARDWARE_USBVISION 34 /* USBVision Video Grabber */
45 #endif
47 #define USBVISION_PWR_REG 0x00
48 #define USBVISION_SSPND_EN (1 << 1)
49 #define USBVISION_RES2 (1 << 2)
50 #define USBVISION_PWR_VID (1 << 5)
51 #define USBVISION_E2_EN (1 << 7)
52 #define USBVISION_CONFIG_REG 0x01
53 #define USBVISION_ADRS_REG 0x02
54 #define USBVISION_ALTER_REG 0x03
55 #define USBVISION_FORCE_ALTER_REG 0x04
56 #define USBVISION_STATUS_REG 0x05
57 #define USBVISION_IOPIN_REG 0x06
58 #define USBVISION_IO_1 (1 << 0)
59 #define USBVISION_IO_2 (1 << 1)
60 #define USBVISION_AUDIO_IN 0
61 #define USBVISION_AUDIO_TV 1
62 #define USBVISION_AUDIO_RADIO 2
63 #define USBVISION_AUDIO_MUTE 3
64 #define USBVISION_SER_MODE 0x07
65 #define USBVISION_SER_ADRS 0x08
66 #define USBVISION_SER_CONT 0x09
67 #define USBVISION_SER_DAT1 0x0A
68 #define USBVISION_SER_DAT2 0x0B
69 #define USBVISION_SER_DAT3 0x0C
70 #define USBVISION_SER_DAT4 0x0D
71 #define USBVISION_EE_DATA 0x0E
72 #define USBVISION_EE_LSBAD 0x0F
73 #define USBVISION_EE_CONT 0x10
74 #define USBVISION_DRM_CONT 0x12
75 #define USBVISION_REF (1 << 0)
76 #define USBVISION_RES_UR (1 << 2)
77 #define USBVISION_RES_FDL (1 << 3)
78 #define USBVISION_RES_VDW (1 << 4)
79 #define USBVISION_DRM_PRM1 0x13
80 #define USBVISION_DRM_PRM2 0x14
81 #define USBVISION_DRM_PRM3 0x15
82 #define USBVISION_DRM_PRM4 0x16
83 #define USBVISION_DRM_PRM5 0x17
84 #define USBVISION_DRM_PRM6 0x18
85 #define USBVISION_DRM_PRM7 0x19
86 #define USBVISION_DRM_PRM8 0x1A
87 #define USBVISION_VIN_REG1 0x1B
88 #define USBVISION_8_422_SYNC 0x01
89 #define USBVISION_16_422_SYNC 0x02
90 #define USBVISION_VSNC_POL (1 << 3)
91 #define USBVISION_HSNC_POL (1 << 4)
92 #define USBVISION_FID_POL (1 << 5)
93 #define USBVISION_HVALID_PO (1 << 6)
94 #define USBVISION_VCLK_POL (1 << 7)
95 #define USBVISION_VIN_REG2 0x1C
96 #define USBVISION_AUTO_FID (1 << 0)
97 #define USBVISION_NONE_INTER (1 << 1)
98 #define USBVISION_NOHVALID (1 << 2)
99 #define USBVISION_UV_ID (1 << 3)
100 #define USBVISION_FIX_2C (1 << 4)
101 #define USBVISION_SEND_FID (1 << 5)
102 #define USBVISION_KEEP_BLANK (1 << 7)
103 #define USBVISION_LXSIZE_I 0x1D
104 #define USBVISION_MXSIZE_I 0x1E
105 #define USBVISION_LYSIZE_I 0x1F
106 #define USBVISION_MYSIZE_I 0x20
107 #define USBVISION_LX_OFFST 0x21
108 #define USBVISION_MX_OFFST 0x22
109 #define USBVISION_LY_OFFST 0x23
110 #define USBVISION_MY_OFFST 0x24
111 #define USBVISION_FRM_RATE 0x25
112 #define USBVISION_LXSIZE_O 0x26
113 #define USBVISION_MXSIZE_O 0x27
114 #define USBVISION_LYSIZE_O 0x28
115 #define USBVISION_MYSIZE_O 0x29
116 #define USBVISION_FILT_CONT 0x2A
117 #define USBVISION_VO_MODE 0x2B
118 #define USBVISION_INTRA_CYC 0x2C
119 #define USBVISION_STRIP_SZ 0x2D
120 #define USBVISION_FORCE_INTRA 0x2E
121 #define USBVISION_FORCE_UP 0x2F
122 #define USBVISION_BUF_THR 0x30
123 #define USBVISION_DVI_YUV 0x31
124 #define USBVISION_AUDIO_CONT 0x32
125 #define USBVISION_AUD_PK_LEN 0x33
126 #define USBVISION_BLK_PK_LEN 0x34
127 #define USBVISION_PCM_THR1 0x38
128 #define USBVISION_PCM_THR2 0x39
129 #define USBVISION_DIST_THR_L 0x3A
130 #define USBVISION_DIST_THR_H 0x3B
131 #define USBVISION_MAX_DIST_L 0x3C
132 #define USBVISION_MAX_DIST_H 0x3D
133 #define USBVISION_OP_CODE 0x33
135 #define MAX_BYTES_PER_PIXEL 4
137 #define MIN_FRAME_WIDTH 64
138 #define MAX_USB_WIDTH 320 //384
139 #define MAX_FRAME_WIDTH 320 //384 /*streching sometimes causes crashes*/
141 #define MIN_FRAME_HEIGHT 48
142 #define MAX_USB_HEIGHT 240 //288
143 #define MAX_FRAME_HEIGHT 240 //288 /*Streching sometimes causes crashes*/
145 #define MAX_FRAME_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT * MAX_BYTES_PER_PIXEL)
146 #define USBVISION_CLIPMASK_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT / 8) //bytesize of clipmask
148 #define USBVISION_URB_FRAMES 32
149 #define USBVISION_MAX_ISOC_PACKET_SIZE 959 // NT1003 Specs Document says 1023
151 #define USBVISION_NUM_HEADERMARKER 20
152 #define USBVISION_NUMFRAMES 3 /* Maximum number of frames an application can get */
153 #define USBVISION_NUMSBUF 2 /* Dimensioning the USB S buffering */
155 #define USBVISION_POWEROFF_TIME 3 * (HZ) // 3 seconds
158 #define FRAMERATE_MIN 0
159 #define FRAMERATE_MAX 31
161 enum {
162 ISOC_MODE_YUV422 = 0x03,
163 ISOC_MODE_YUV420 = 0x14,
164 ISOC_MODE_COMPRESS = 0x60,
167 /* This macro restricts an int variable to an inclusive range */
168 #define RESTRICT_TO_RANGE(v,mi,ma) { if ((v) < (mi)) (v) = (mi); else if ((v) > (ma)) (v) = (ma); }
171 * We use macros to do YUV -> RGB conversion because this is
172 * very important for speed and totally unimportant for size.
174 * YUV -> RGB Conversion
175 * ---------------------
177 * B = 1.164*(Y-16) + 2.018*(V-128)
178 * G = 1.164*(Y-16) - 0.813*(U-128) - 0.391*(V-128)
179 * R = 1.164*(Y-16) + 1.596*(U-128)
181 * If you fancy integer arithmetics (as you should), hear this:
183 * 65536*B = 76284*(Y-16) + 132252*(V-128)
184 * 65536*G = 76284*(Y-16) - 53281*(U-128) - 25625*(V-128)
185 * 65536*R = 76284*(Y-16) + 104595*(U-128)
187 * Make sure the output values are within [0..255] range.
189 #define LIMIT_RGB(x) (((x) < 0) ? 0 : (((x) > 255) ? 255 : (x)))
190 #define YUV_TO_RGB_BY_THE_BOOK(my,mu,mv,mr,mg,mb) { \
191 int mm_y, mm_yc, mm_u, mm_v, mm_r, mm_g, mm_b; \
192 mm_y = (my) - 16; \
193 mm_u = (mu) - 128; \
194 mm_v = (mv) - 128; \
195 mm_yc= mm_y * 76284; \
196 mm_b = (mm_yc + 132252*mm_v ) >> 16; \
197 mm_g = (mm_yc - 53281*mm_u - 25625*mm_v ) >> 16; \
198 mm_r = (mm_yc + 104595*mm_u ) >> 16; \
199 mb = LIMIT_RGB(mm_b); \
200 mg = LIMIT_RGB(mm_g); \
201 mr = LIMIT_RGB(mm_r); \
204 /* Debugging aid */
205 #define USBVISION_SAY_AND_WAIT(what) { \
206 wait_queue_head_t wq; \
207 init_waitqueue_head(&wq); \
208 printk(KERN_INFO "Say: %s\n", what); \
209 interruptible_sleep_on_timeout (&wq, HZ*3); \
213 * This macro checks if usbvision is still operational. The 'usbvision'
214 * pointer must be valid, usbvision->dev must be valid, we are not
215 * removing the device and the device has not erred on us.
217 #define USBVISION_IS_OPERATIONAL(udevice) (\
218 (udevice != NULL) && \
219 ((udevice)->dev != NULL) && \
220 ((udevice)->last_error == 0) && \
221 (!(udevice)->remove_pending))
223 #define I2C_USB_ADAP_MAX 16
225 /* ----------------------------------------------------------------- */
226 /* usbvision video structures */
227 /* ----------------------------------------------------------------- */
228 enum ScanState {
229 ScanState_Scanning, /* Scanning for header */
230 ScanState_Lines /* Parsing lines */
233 /* Completion states of the data parser */
234 enum ParseState {
235 ParseState_Continue, /* Just parse next item */
236 ParseState_NextFrame, /* Frame done, send it to V4L */
237 ParseState_Out, /* Not enough data for frame */
238 ParseState_EndParse /* End parsing */
241 enum FrameState {
242 FrameState_Unused, /* Unused (no MCAPTURE) */
243 FrameState_Ready, /* Ready to start grabbing */
244 FrameState_Grabbing, /* In the process of being grabbed into */
245 FrameState_Done, /* Finished grabbing, but not been synced yet */
246 FrameState_DoneHold, /* Are syncing or reading */
247 FrameState_Error, /* Something bad happened while processing */
250 /* stream states */
251 enum StreamState {
252 Stream_Off, /* Driver streaming is completely OFF */
253 Stream_Idle, /* Driver streaming is ready to be put ON by the application */
254 Stream_Interrupt, /* Driver streaming must be interrupted */
255 Stream_On, /* Driver streaming is put ON by the application */
258 enum IsocState {
259 IsocState_InFrame, /* Isoc packet is member of frame */
260 IsocState_NoFrame, /* Isoc packet is not member of any frame */
263 struct usb_device;
265 struct usbvision_sbuf {
266 char *data;
267 struct urb *urb;
270 #define USBVISION_MAGIC_1 0x55
271 #define USBVISION_MAGIC_2 0xAA
272 #define USBVISION_HEADER_LENGTH 0x0c
273 #define USBVISION_SAA7111_ADDR 0x48
274 #define USBVISION_SAA7113_ADDR 0x4a
275 #define USBVISION_IIC_LRACK 0x20
276 #define USBVISION_IIC_LRNACK 0x30
277 #define USBVISION_FRAME_FORMAT_PARAM_INTRA (1<<7)
279 struct usbvision_v4l2_format_st {
280 int supported;
281 int bytes_per_pixel;
282 int depth;
283 int format;
284 char *desc;
286 #define USBVISION_SUPPORTED_PALETTES ARRAY_SIZE(usbvision_v4l2_format)
288 struct usbvision_frame_header {
289 unsigned char magic_1; /* 0 magic */
290 unsigned char magic_2; /* 1 magic */
291 unsigned char headerLength; /* 2 */
292 unsigned char frameNum; /* 3 */
293 unsigned char framePhase; /* 4 */
294 unsigned char frameLatency; /* 5 */
295 unsigned char dataFormat; /* 6 */
296 unsigned char formatParam; /* 7 */
297 unsigned char frameWidthLo; /* 8 */
298 unsigned char frameWidthHi; /* 9 */
299 unsigned char frameHeightLo; /* 10 */
300 unsigned char frameHeightHi; /* 11 */
301 __u16 frameWidth; /* 8 - 9 after endian correction*/
302 __u16 frameHeight; /* 10 - 11 after endian correction*/
305 /* tvnorms */
306 struct usbvision_tvnorm {
307 char *name;
308 v4l2_std_id id;
309 /* mode for saa7113h */
310 int mode;
313 struct usbvision_frame {
314 char *data; /* Frame buffer */
315 struct usbvision_frame_header isocHeader; /* Header from stream */
317 int width; /* Width application is expecting */
318 int height; /* Height */
319 int index; /* Frame index */
320 int frmwidth; /* Width the frame actually is */
321 int frmheight; /* Height */
323 volatile int grabstate; /* State of grabbing */
324 int scanstate; /* State of scanning */
326 struct list_head frame;
328 int curline; /* Line of frame we're working on */
330 long scanlength; /* uncompressed, raw data length of frame */
331 long bytes_read; /* amount of scanlength that has been read from data */
332 struct usbvision_v4l2_format_st v4l2_format; /* format the user needs*/
333 int v4l2_linesize; /* bytes for one videoline*/
334 struct timeval timestamp;
335 int sequence; // How many video frames we send to user
338 #define CODEC_SAA7113 7113
339 #define CODEC_SAA7111 7111
340 #define BRIDGE_NT1003 1003
341 #define BRIDGE_NT1004 1004
342 #define BRIDGE_NT1005 1005
344 struct usbvision_device_data_st {
345 __u64 VideoNorm;
346 const char *ModelString;
347 int Interface; /* to handle special interface number like BELKIN and Hauppauge WinTV-USB II */
348 __u16 Codec;
349 unsigned VideoChannels:3;
350 unsigned AudioChannels:2;
351 unsigned Radio:1;
352 unsigned vbi:1;
353 unsigned Tuner:1;
354 unsigned Vin_Reg1_override:1; /* Override default value with */
355 unsigned Vin_Reg2_override:1; /* Vin_Reg1, Vin_Reg2, etc. */
356 unsigned Dvi_yuv_override:1;
357 __u8 Vin_Reg1;
358 __u8 Vin_Reg2;
359 __u8 Dvi_yuv;
360 __u8 TunerType;
361 __s16 X_Offset;
362 __s16 Y_Offset;
365 /* Declared on usbvision-cards.c */
366 extern struct usbvision_device_data_st usbvision_device_data[];
367 extern struct usb_device_id usbvision_table[];
369 struct usb_usbvision {
370 struct video_device *vdev; /* Video Device */
371 struct video_device *rdev; /* Radio Device */
372 struct video_device *vbi; /* VBI Device */
374 /* i2c Declaration Section*/
375 struct i2c_adapter i2c_adap;
376 struct i2c_client i2c_client;
378 struct urb *ctrlUrb;
379 unsigned char ctrlUrbBuffer[8];
380 int ctrlUrbBusy;
381 struct usb_ctrlrequest ctrlUrbSetup;
382 wait_queue_head_t ctrlUrb_wq; // Processes waiting
383 struct semaphore ctrlUrbLock;
385 /* configuration part */
386 int have_tuner;
387 int tuner_type;
388 int tuner_addr;
389 int bridgeType; // NT1003, NT1004, NT1005
390 int channel;
391 int radio;
392 int video_inputs; // # of inputs
393 unsigned long freq;
394 int AudioMute;
395 int AudioChannel;
396 int isocMode; // format of video data for the usb isoc-transfer
397 unsigned int nr; // Number of the device
399 /* Device structure */
400 struct usb_device *dev;
401 /* usb transfer */
402 int num_alt; /* Number of alternative settings */
403 unsigned int *alt_max_pkt_size; /* array of wMaxPacketSize */
404 unsigned char iface; /* Video interface number */
405 unsigned char ifaceAlt; /* Alt settings */
406 unsigned char Vin_Reg2_Preset;
407 struct semaphore lock;
408 struct timer_list powerOffTimer;
409 struct work_struct powerOffWork;
410 int power; /* is the device powered on? */
411 int user; /* user count for exclusive use */
412 int initialized; /* Had we already sent init sequence? */
413 int DevModel; /* What type of USBVISION device we got? */
414 enum StreamState streaming; /* Are we streaming Isochronous? */
415 int last_error; /* What calamity struck us? */
416 int curwidth; /* width of the frame the device is currently set to*/
417 int curheight; /* height of the frame the device is currently set to*/
418 int stretch_width; /* stretch-factor for frame width (from usb to screen)*/
419 int stretch_height; /* stretch-factor for frame height (from usb to screen)*/
420 char *fbuf; /* Videodev buffer area for mmap*/
421 int max_frame_size; /* Bytes in one video frame */
422 int fbuf_size; /* Videodev buffer size */
423 spinlock_t queue_lock; /* spinlock for protecting mods on inqueue and outqueue */
424 struct list_head inqueue, outqueue; /* queued frame list and ready to dequeue frame list */
425 wait_queue_head_t wait_frame; /* Processes waiting */
426 wait_queue_head_t wait_stream; /* Processes waiting */
427 struct usbvision_frame *curFrame; // pointer to current frame, set by usbvision_find_header
428 struct usbvision_frame frame[USBVISION_NUMFRAMES]; // frame buffer
429 int num_frames; // number of frames allocated
430 struct usbvision_sbuf sbuf[USBVISION_NUMSBUF]; // S buffering
431 volatile int remove_pending; /* If set then about to exit */
433 /* Scratch space from the Isochronous Pipe.*/
434 unsigned char *scratch;
435 int scratch_read_ptr;
436 int scratch_write_ptr;
437 int scratch_headermarker[USBVISION_NUM_HEADERMARKER];
438 int scratch_headermarker_read_ptr;
439 int scratch_headermarker_write_ptr;
440 enum IsocState isocstate;
441 struct usbvision_v4l2_format_st palette;
443 struct v4l2_capability vcap; /* Video capabilities */
444 unsigned int ctl_input; /* selected input */
445 struct usbvision_tvnorm *tvnorm; /* selected tv norm */
446 unsigned char video_endp; /* 0x82 for USBVISION devices based */
448 // Decompression stuff:
449 unsigned char *IntraFrameBuffer; /* Buffer for reference frame */
450 int BlockPos; //for test only
451 int requestIntra; // 0 = normal; 1 = intra frame is requested;
452 int lastIsocFrameNum; // check for lost isoc frames
453 int isocPacketSize; // need to calculate usedBandwidth
454 int usedBandwidth; // used bandwidth 0-100%, need to set comprLevel
455 int comprLevel; // How strong (100) or weak (0) is compression
456 int lastComprLevel; // How strong (100) or weak (0) was compression
457 int usb_bandwidth; /* Mbit/s */
459 /* Statistics that can be overlayed on the screen */
460 unsigned long isocUrbCount; // How many URBs we received so far
461 unsigned long urb_length; /* Length of last URB */
462 unsigned long isocDataCount; /* How many bytes we received */
463 unsigned long header_count; /* How many frame headers we found */
464 unsigned long scratch_ovf_count; /* How many times we overflowed scratch */
465 unsigned long isocSkipCount; /* How many empty ISO packets received */
466 unsigned long isocErrCount; /* How many bad ISO packets received */
467 unsigned long isocPacketCount; // How many packets we totally got
468 unsigned long timeInIrq; // How long do we need for interrupt
469 int isocMeasureBandwidthCount;
470 int frame_num; // How many video frames we send to user
471 int maxStripLen; // How big is the biggest strip
472 int comprBlockPos;
473 int stripLenErrors; // How many times was BlockPos greater than StripLen
474 int stripMagicErrors;
475 int stripLineNumberErrors;
476 int ComprBlockTypes[4];
480 /* --------------------------------------------------------------- */
481 /* defined in usbvision-i2c.c */
482 /* i2c-algo-usb declaration */
483 /* --------------------------------------------------------------- */
485 /* ----------------------------------------------------------------------- */
486 /* usbvision specific I2C functions */
487 /* ----------------------------------------------------------------------- */
488 int usbvision_i2c_register(struct usb_usbvision *usbvision);
489 int usbvision_i2c_unregister(struct usb_usbvision *usbvision);
490 void call_i2c_clients(struct usb_usbvision *usbvision, unsigned int cmd,void *arg);
492 /* defined in usbvision-core.c */
493 int usbvision_read_reg(struct usb_usbvision *usbvision, unsigned char reg);
494 int usbvision_write_reg(struct usb_usbvision *usbvision, unsigned char reg,
495 unsigned char value);
497 int usbvision_frames_alloc(struct usb_usbvision *usbvision, int number_of_frames);
498 void usbvision_frames_free(struct usb_usbvision *usbvision);
499 int usbvision_scratch_alloc(struct usb_usbvision *usbvision);
500 void usbvision_scratch_free(struct usb_usbvision *usbvision);
501 int usbvision_decompress_alloc(struct usb_usbvision *usbvision);
502 void usbvision_decompress_free(struct usb_usbvision *usbvision);
504 int usbvision_setup(struct usb_usbvision *usbvision,int format);
505 int usbvision_init_isoc(struct usb_usbvision *usbvision);
506 int usbvision_restart_isoc(struct usb_usbvision *usbvision);
507 void usbvision_stop_isoc(struct usb_usbvision *usbvision);
508 int usbvision_set_alternate(struct usb_usbvision *dev);
510 int usbvision_set_audio(struct usb_usbvision *usbvision, int AudioChannel);
511 int usbvision_audio_off(struct usb_usbvision *usbvision);
513 int usbvision_begin_streaming(struct usb_usbvision *usbvision);
514 void usbvision_empty_framequeues(struct usb_usbvision *dev);
515 int usbvision_stream_interrupt(struct usb_usbvision *dev);
517 int usbvision_muxsel(struct usb_usbvision *usbvision, int channel);
518 int usbvision_set_input(struct usb_usbvision *usbvision);
519 int usbvision_set_output(struct usb_usbvision *usbvision, int width, int height);
521 void usbvision_init_powerOffTimer(struct usb_usbvision *usbvision);
522 void usbvision_set_powerOffTimer(struct usb_usbvision *usbvision);
523 void usbvision_reset_powerOffTimer(struct usb_usbvision *usbvision);
524 int usbvision_power_off(struct usb_usbvision *usbvision);
525 int usbvision_power_on(struct usb_usbvision *usbvision);
527 #endif /* __LINUX_USBVISION_H */
530 * Overrides for Emacs so that we follow Linus's tabbing style.
531 * ---------------------------------------------------------------------------
532 * Local variables:
533 * c-basic-offset: 8
534 * End: