usbvision.h revision f2242ee5474f46d87a45cd4e214b5c3aa02ff293
1/* 2 * USBVISION.H 3 * usbvision header file 4 * 5 * Copyright (c) 1999-2005 Joerg Heckenbach <joerg@heckenbach-aw.de> 6 * 7 * This module is part of usbvision driver project. 8 * Updates to driver completed by Dwaine P. Garden 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 26#ifndef __LINUX_USBVISION_H 27#define __LINUX_USBVISION_H 28 29#include <linux/list.h> 30#include <linux/usb.h> 31#include "usbvision-i2c.h" 32 33#ifndef VID_HARDWARE_USBVISION 34 #define VID_HARDWARE_USBVISION 34 /* USBVision Video Grabber */ 35#endif 36 37#define USBVISION_PWR_REG 0x00 38 #define USBVISION_SSPND_EN (1 << 1) 39 #define USBVISION_RES2 (1 << 2) 40 #define USBVISION_PWR_VID (1 << 5) 41 #define USBVISION_E2_EN (1 << 7) 42#define USBVISION_CONFIG_REG 0x01 43#define USBVISION_ADRS_REG 0x02 44#define USBVISION_ALTER_REG 0x03 45#define USBVISION_FORCE_ALTER_REG 0x04 46#define USBVISION_STATUS_REG 0x05 47#define USBVISION_IOPIN_REG 0x06 48 #define USBVISION_IO_1 (1 << 0) 49 #define USBVISION_IO_2 (1 << 1) 50 #define USBVISION_AUDIO_IN 0 51 #define USBVISION_AUDIO_TV 1 52 #define USBVISION_AUDIO_RADIO 2 53 #define USBVISION_AUDIO_MUTE 3 54#define USBVISION_SER_MODE 0x07 55#define USBVISION_SER_ADRS 0x08 56#define USBVISION_SER_CONT 0x09 57#define USBVISION_SER_DAT1 0x0A 58#define USBVISION_SER_DAT2 0x0B 59#define USBVISION_SER_DAT3 0x0C 60#define USBVISION_SER_DAT4 0x0D 61#define USBVISION_EE_DATA 0x0E 62#define USBVISION_EE_LSBAD 0x0F 63#define USBVISION_EE_CONT 0x10 64#define USBVISION_DRM_CONT 0x12 65 #define USBVISION_REF (1 << 0) 66 #define USBVISION_RES_UR (1 << 2) 67 #define USBVISION_RES_FDL (1 << 3) 68 #define USBVISION_RES_VDW (1 << 4) 69#define USBVISION_DRM_PRM1 0x13 70#define USBVISION_DRM_PRM2 0x14 71#define USBVISION_DRM_PRM3 0x15 72#define USBVISION_DRM_PRM4 0x16 73#define USBVISION_DRM_PRM5 0x17 74#define USBVISION_DRM_PRM6 0x18 75#define USBVISION_DRM_PRM7 0x19 76#define USBVISION_DRM_PRM8 0x1A 77#define USBVISION_VIN_REG1 0x1B 78 #define USBVISION_8_422_SYNC 0x01 79 #define USBVISION_16_422_SYNC 0x02 80 #define USBVISION_VSNC_POL (1 << 3) 81 #define USBVISION_HSNC_POL (1 << 4) 82 #define USBVISION_FID_POL (1 << 5) 83 #define USBVISION_HVALID_PO (1 << 6) 84 #define USBVISION_VCLK_POL (1 << 7) 85#define USBVISION_VIN_REG2 0x1C 86 #define USBVISION_AUTO_FID (1 << 0) 87 #define USBVISION_NONE_INTER (1 << 1) 88 #define USBVISION_NOHVALID (1 << 2) 89 #define USBVISION_UV_ID (1 << 3) 90 #define USBVISION_FIX_2C (1 << 4) 91 #define USBVISION_SEND_FID (1 << 5) 92 #define USBVISION_KEEP_BLANK (1 << 7) 93#define USBVISION_LXSIZE_I 0x1D 94#define USBVISION_MXSIZE_I 0x1E 95#define USBVISION_LYSIZE_I 0x1F 96#define USBVISION_MYSIZE_I 0x20 97#define USBVISION_LX_OFFST 0x21 98#define USBVISION_MX_OFFST 0x22 99#define USBVISION_LY_OFFST 0x23 100#define USBVISION_MY_OFFST 0x24 101#define USBVISION_FRM_RATE 0x25 102#define USBVISION_LXSIZE_O 0x26 103#define USBVISION_MXSIZE_O 0x27 104#define USBVISION_LYSIZE_O 0x28 105#define USBVISION_MYSIZE_O 0x29 106#define USBVISION_FILT_CONT 0x2A 107#define USBVISION_VO_MODE 0x2B 108#define USBVISION_INTRA_CYC 0x2C 109#define USBVISION_STRIP_SZ 0x2D 110#define USBVISION_FORCE_INTRA 0x2E 111#define USBVISION_FORCE_UP 0x2F 112#define USBVISION_BUF_THR 0x30 113#define USBVISION_DVI_YUV 0x31 114#define USBVISION_AUDIO_CONT 0x32 115#define USBVISION_AUD_PK_LEN 0x33 116#define USBVISION_BLK_PK_LEN 0x34 117#define USBVISION_PCM_THR1 0x38 118#define USBVISION_PCM_THR2 0x39 119#define USBVISION_DIST_THR_L 0x3A 120#define USBVISION_DIST_THR_H 0x3B 121#define USBVISION_MAX_DIST_L 0x3C 122#define USBVISION_MAX_DIST_H 0x3D 123#define USBVISION_OP_CODE 0x33 124 125#define MAX_BYTES_PER_PIXEL 4 126 127#define MIN_FRAME_WIDTH 64 128#define MAX_USB_WIDTH 320 //384 129#define MAX_FRAME_WIDTH 320 //384 /*streching sometimes causes crashes*/ 130 131#define MIN_FRAME_HEIGHT 48 132#define MAX_USB_HEIGHT 240 //288 133#define MAX_FRAME_HEIGHT 240 //288 /*Streching sometimes causes crashes*/ 134 135#define MAX_FRAME_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT * MAX_BYTES_PER_PIXEL) 136#define USBVISION_CLIPMASK_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT / 8) //bytesize of clipmask 137 138#define USBVISION_URB_FRAMES 32 139#define USBVISION_MAX_ISOC_PACKET_SIZE 959 // NT1003 Specs Document says 1023 140 141#define USBVISION_NUM_HEADERMARKER 20 142#define USBVISION_NUMFRAMES 3 143#define USBVISION_NUMSBUF 2 144 145#define USBVISION_POWEROFF_TIME 3 * (HZ) // 3 seconds 146 147/* This macro restricts an int variable to an inclusive range */ 148#define RESTRICT_TO_RANGE(v,mi,ma) { if ((v) < (mi)) (v) = (mi); else if ((v) > (ma)) (v) = (ma); } 149 150/* 151 * We use macros to do YUV -> RGB conversion because this is 152 * very important for speed and totally unimportant for size. 153 * 154 * YUV -> RGB Conversion 155 * --------------------- 156 * 157 * B = 1.164*(Y-16) + 2.018*(V-128) 158 * G = 1.164*(Y-16) - 0.813*(U-128) - 0.391*(V-128) 159 * R = 1.164*(Y-16) + 1.596*(U-128) 160 * 161 * If you fancy integer arithmetics (as you should), hear this: 162 * 163 * 65536*B = 76284*(Y-16) + 132252*(V-128) 164 * 65536*G = 76284*(Y-16) - 53281*(U-128) - 25625*(V-128) 165 * 65536*R = 76284*(Y-16) + 104595*(U-128) 166 * 167 * Make sure the output values are within [0..255] range. 168 */ 169#define LIMIT_RGB(x) (((x) < 0) ? 0 : (((x) > 255) ? 255 : (x))) 170#define YUV_TO_RGB_BY_THE_BOOK(my,mu,mv,mr,mg,mb) { \ 171 int mm_y, mm_yc, mm_u, mm_v, mm_r, mm_g, mm_b; \ 172 mm_y = (my) - 16; \ 173 mm_u = (mu) - 128; \ 174 mm_v = (mv) - 128; \ 175 mm_yc= mm_y * 76284; \ 176 mm_b = (mm_yc + 132252*mm_v ) >> 16; \ 177 mm_g = (mm_yc - 53281*mm_u - 25625*mm_v ) >> 16; \ 178 mm_r = (mm_yc + 104595*mm_u ) >> 16; \ 179 mb = LIMIT_RGB(mm_b); \ 180 mg = LIMIT_RGB(mm_g); \ 181 mr = LIMIT_RGB(mm_r); \ 182} 183 184 185 186/* Debugging aid */ 187#define USBVISION_SAY_AND_WAIT(what) { \ 188 wait_queue_head_t wq; \ 189 init_waitqueue_head(&wq); \ 190 printk(KERN_INFO "Say: %s\n", what); \ 191 interruptible_sleep_on_timeout (&wq, HZ*3); \ 192} 193 194/* 195 * This macro checks if usbvision is still operational. The 'usbvision' 196 * pointer must be valid, usbvision->dev must be valid, we are not 197 * removing the device and the device has not erred on us. 198 */ 199#define USBVISION_IS_OPERATIONAL(udevice) (\ 200 (udevice != NULL) && \ 201 ((udevice)->dev != NULL) && \ 202 ((udevice)->last_error == 0) && \ 203 (!(udevice)->remove_pending)) 204 205 206enum ScanState { 207 ScanState_Scanning, /* Scanning for header */ 208 ScanState_Lines /* Parsing lines */ 209}; 210 211/* Completion states of the data parser */ 212enum ParseState { 213 ParseState_Continue, /* Just parse next item */ 214 ParseState_NextFrame, /* Frame done, send it to V4L */ 215 ParseState_Out, /* Not enough data for frame */ 216 ParseState_EndParse /* End parsing */ 217}; 218 219enum FrameState { 220 FrameState_Unused, /* Unused (no MCAPTURE) */ 221 FrameState_Ready, /* Ready to start grabbing */ 222 FrameState_Grabbing, /* In the process of being grabbed into */ 223 FrameState_Done, /* Finished grabbing, but not been synced yet */ 224 FrameState_DoneHold, /* Are syncing or reading */ 225 FrameState_Error, /* Something bad happened while processing */ 226}; 227 228/* stream states */ 229enum StreamState { 230 Stream_Off, 231 Stream_Interrupt, 232 Stream_On, 233}; 234 235enum IsocState { 236 IsocState_InFrame, /* Isoc packet is member of frame */ 237 IsocState_NoFrame, /* Isoc packet is not member of any frame */ 238}; 239 240struct usb_device; 241 242struct usbvision_sbuf { 243 char *data; 244 struct urb *urb; 245}; 246 247#define USBVISION_MAGIC_1 0x55 248#define USBVISION_MAGIC_2 0xAA 249#define USBVISION_HEADER_LENGTH 0x0c 250#define USBVISION_SAA7111_ADDR 0x48 251#define USBVISION_SAA7113_ADDR 0x4a 252#define USBVISION_IIC_LRACK 0x20 253#define USBVISION_IIC_LRNACK 0x30 254#define USBVISION_FRAME_FORMAT_PARAM_INTRA (1<<7) 255 256struct usbvision_v4l2_format_st { 257 int supported; 258 int bytes_per_pixel; 259 int depth; 260 int format; 261 char *desc; 262}; 263#define USBVISION_SUPPORTED_PALETTES ARRAY_SIZE(usbvision_v4l2_format) 264 265struct usbvision_frame_header { 266 unsigned char magic_1; /* 0 magic */ 267 unsigned char magic_2; /* 1 magic */ 268 unsigned char headerLength; /* 2 */ 269 unsigned char frameNum; /* 3 */ 270 unsigned char framePhase; /* 4 */ 271 unsigned char frameLatency; /* 5 */ 272 unsigned char dataFormat; /* 6 */ 273 unsigned char formatParam; /* 7 */ 274 unsigned char frameWidthLo; /* 8 */ 275 unsigned char frameWidthHi; /* 9 */ 276 unsigned char frameHeightLo; /* 10 */ 277 unsigned char frameHeightHi; /* 11 */ 278 __u16 frameWidth; /* 8 - 9 after endian correction*/ 279 __u16 frameHeight; /* 10 - 11 after endian correction*/ 280}; 281 282/* tvnorms */ 283struct usbvision_tvnorm { 284 char *name; 285 v4l2_std_id id; 286 /* mode for saa7113h */ 287 int mode; 288}; 289 290struct usbvision_frame { 291 char *data; /* Frame buffer */ 292 struct usbvision_frame_header isocHeader; /* Header from stream */ 293 294 int width; /* Width application is expecting */ 295 int height; /* Height */ 296 int index; /* Frame index */ 297 int frmwidth; /* Width the frame actually is */ 298 int frmheight; /* Height */ 299 300 volatile int grabstate; /* State of grabbing */ 301 int scanstate; /* State of scanning */ 302 303 struct list_head frame; 304 305 int curline; /* Line of frame we're working on */ 306 307 long scanlength; /* uncompressed, raw data length of frame */ 308 long bytes_read; /* amount of scanlength that has been read from data */ 309 struct usbvision_v4l2_format_st v4l2_format; /* format the user needs*/ 310 int v4l2_linesize; /* bytes for one videoline*/ 311 struct timeval timestamp; 312 int sequence; // How many video frames we send to user 313}; 314 315#define CODEC_SAA7113 7113 316#define CODEC_SAA7111 7111 317#define BRIDGE_NT1003 1003 318#define BRIDGE_NT1004 1004 319#define BRIDGE_NT1005 1005 320 321#define USBVISION_I2C_CLIENTS_MAX 8 322 323struct usbvision_device_data_st { 324 int idVendor; 325 int idProduct; 326 int Interface; /* to handle special interface number like BELKIN and Hauppauge WinTV-USB II */ 327 int Codec; 328 int VideoChannels; 329 __u64 VideoNorm; 330 int AudioChannels; 331 int Radio; 332 int vbi; 333 int Tuner; 334 int TunerType; 335 int Vin_Reg1; 336 int Vin_Reg2; 337 int X_Offset; 338 int Y_Offset; 339 int Dvi_yuv; 340 char *ModelString; 341}; 342 343/* Declared on usbvision-cards.c */ 344extern struct usbvision_device_data_st usbvision_device_data[]; 345extern struct usb_device_id usbvision_table[]; 346 347struct usb_usbvision { 348 struct video_device *vdev; /* Video Device */ 349 struct video_device *rdev; /* Radio Device */ 350 struct video_device *vbi; /* VBI Device */ 351 struct video_audio audio_dev; /* Current audio params */ 352 353 /* i2c Declaration Section*/ 354 struct i2c_adapter i2c_adap; 355 struct i2c_algo_usb_data i2c_algo; 356 struct i2c_client i2c_client; 357 int i2c_state, i2c_ok; 358 struct i2c_client *i2c_clients[USBVISION_I2C_CLIENTS_MAX]; 359 360 struct urb *ctrlUrb; 361 unsigned char ctrlUrbBuffer[8]; 362 int ctrlUrbBusy; 363 struct usb_ctrlrequest ctrlUrbSetup; 364 wait_queue_head_t ctrlUrb_wq; // Processes waiting 365 struct semaphore ctrlUrbLock; 366 367 int have_tuner; 368 int tuner_type; 369 int bridgeType; // NT1003, NT1004, NT1005 370 int channel; 371 int radio; 372 int video_inputs; // # of inputs 373 unsigned long freq; 374 int AudioMute; 375 int AudioChannel; 376 int isocMode; // format of video data for the usb isoc-transfer 377 unsigned int nr; // Number of the device < MAX_USBVISION 378 379 /* Device structure */ 380 struct usb_device *dev; 381 unsigned char iface; /* Video interface number */ 382 unsigned char ifaceAltActive, ifaceAltInactive; /* Alt settings */ 383 unsigned char Vin_Reg2_Preset; 384 struct semaphore lock; 385 struct timer_list powerOffTimer; 386 struct work_struct powerOffWork; 387 int power; /* is the device powered on? */ 388 int user; /* user count for exclusive use */ 389 int usbvision_used; /* Is this structure in use? */ 390 int initialized; /* Had we already sent init sequence? */ 391 int DevModel; /* What type of USBVISION device we got? */ 392 enum StreamState streaming; /* Are we streaming Isochronous? */ 393 int last_error; /* What calamity struck us? */ 394 int curwidth; /* width of the frame the device is currently set to*/ 395 int curheight; /* height of the frame the device is currently set to*/ 396 int stretch_width; /* stretch-factor for frame width (from usb to screen)*/ 397 int stretch_height; /* stretch-factor for frame height (from usb to screen)*/ 398 char *fbuf; /* Videodev buffer area for mmap*/ 399 int max_frame_size; /* Bytes in one video frame */ 400 int fbuf_size; /* Videodev buffer size */ 401 spinlock_t queue_lock; /* spinlock for protecting mods on inqueue and outqueue */ 402 struct list_head inqueue, outqueue; /* queued frame list and ready to dequeue frame list */ 403 wait_queue_head_t wait_frame; /* Processes waiting */ 404 wait_queue_head_t wait_stream; /* Processes waiting */ 405 struct usbvision_frame *curFrame; // pointer to current frame, set by usbvision_find_header 406 struct usbvision_frame frame[USBVISION_NUMFRAMES]; // frame buffer 407 int curSbufNum; // number of current receiving sbuf 408 struct usbvision_sbuf sbuf[USBVISION_NUMSBUF]; // S buffering 409 volatile int remove_pending; /* If set then about to exit */ 410 411 /* Scratch space from the Isochronous Pipe.*/ 412 unsigned char *scratch; 413 int scratch_read_ptr; 414 int scratch_write_ptr; 415 int scratch_headermarker[USBVISION_NUM_HEADERMARKER]; 416 int scratch_headermarker_read_ptr; 417 int scratch_headermarker_write_ptr; 418 int isocstate; 419 /* color controls */ 420 int saturation; 421 int hue; 422 int brightness; 423 int contrast; 424 int depth; 425 struct usbvision_v4l2_format_st palette; 426 427 struct v4l2_capability vcap; /* Video capabilities */ 428 unsigned int ctl_input; /* selected input */ 429 struct usbvision_tvnorm *tvnorm; /* selected tv norm */ 430 unsigned char video_endp; /* 0x82 for USBVISION devices based */ 431 432 // Overlay stuff: 433 struct v4l2_framebuffer vid_buf; 434 struct v4l2_format vid_win; 435 int vid_buf_valid; // Status: video buffer is valid (set) 436 int vid_win_valid; // Status: video window is valid (set) 437 int overlay; /*Status: Are we overlaying? */ 438 unsigned int clipmask[USBVISION_CLIPMASK_SIZE / 4]; 439 unsigned char *overlay_base; /* Virtual base address of video buffer */ 440 unsigned char *overlay_win; /* virt start address of overlay window */ 441 struct usbvision_frame overlay_frame; 442 443 // Decompression stuff: 444 unsigned char *IntraFrameBuffer; /* Buffer for reference frame */ 445 int BlockPos; //for test only 446 int requestIntra; // 0 = normal; 1 = intra frame is requested; 447 int lastIsocFrameNum; // check for lost isoc frames 448 int isocPacketSize; // need to calculate usedBandwidth 449 int usedBandwidth; // used bandwidth 0-100%, need to set comprLevel 450 int comprLevel; // How strong (100) or weak (0) is compression 451 int lastComprLevel; // How strong (100) or weak (0) was compression 452 int usb_bandwidth; /* Mbit/s */ 453 454 /* /proc entries, relative to /proc/video/usbvision/ */ 455 struct proc_dir_entry *proc_devdir; /* Per-device proc directory */ 456 struct proc_dir_entry *proc_info; /* <minor#>/info entry */ 457 struct proc_dir_entry *proc_register; /* <minor#>/register entry */ 458 struct proc_dir_entry *proc_freq; /* <minor#>/freq entry */ 459 struct proc_dir_entry *proc_input; /* <minor#>/input entry */ 460 struct proc_dir_entry *proc_frame; /* <minor#>/frame entry */ 461 struct proc_dir_entry *proc_button; /* <minor#>/button entry */ 462 struct proc_dir_entry *proc_control; /* <minor#>/control entry */ 463 464 /* Statistics that can be overlayed on the screen */ 465 unsigned long isocUrbCount; // How many URBs we received so far 466 unsigned long urb_length; /* Length of last URB */ 467 unsigned long isocDataCount; /* How many bytes we received */ 468 unsigned long header_count; /* How many frame headers we found */ 469 unsigned long scratch_ovf_count; /* How many times we overflowed scratch */ 470 unsigned long isocSkipCount; /* How many empty ISO packets received */ 471 unsigned long isocErrCount; /* How many bad ISO packets received */ 472 unsigned long isocPacketCount; // How many packets we totally got 473 unsigned long timeInIrq; // How long do we need for interrupt 474 int isocMeasureBandwidthCount; 475 int frame_num; // How many video frames we send to user 476 int maxStripLen; // How big is the biggest strip 477 int comprBlockPos; 478 int stripLenErrors; // How many times was BlockPos greater than StripLen 479 int stripMagicErrors; 480 int stripLineNumberErrors; 481 int ComprBlockTypes[4]; 482}; 483 484#endif /* __LINUX_USBVISION_H */ 485 486/* 487 * Overrides for Emacs so that we follow Linus's tabbing style. 488 * --------------------------------------------------------------------------- 489 * Local variables: 490 * c-basic-offset: 8 491 * End: 492 */ 493