/* * USBVISION.H * usbvision header file * * Copyright (c) 1999-2005 Joerg Heckenbach * * This module is part of usbvision driver project. * Updates to driver completed by Dwaine P. Garden * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #ifndef __LINUX_USBVISION_H #define __LINUX_USBVISION_H #include #include #include "usbvision-i2c.h" #ifndef VID_HARDWARE_USBVISION #define VID_HARDWARE_USBVISION 34 /* USBVision Video Grabber */ #endif #define USBVISION_PWR_REG 0x00 #define USBVISION_SSPND_EN (1 << 1) #define USBVISION_RES2 (1 << 2) #define USBVISION_PWR_VID (1 << 5) #define USBVISION_E2_EN (1 << 7) #define USBVISION_CONFIG_REG 0x01 #define USBVISION_ADRS_REG 0x02 #define USBVISION_ALTER_REG 0x03 #define USBVISION_FORCE_ALTER_REG 0x04 #define USBVISION_STATUS_REG 0x05 #define USBVISION_IOPIN_REG 0x06 #define USBVISION_IO_1 (1 << 0) #define USBVISION_IO_2 (1 << 1) #define USBVISION_AUDIO_IN 0 #define USBVISION_AUDIO_TV 1 #define USBVISION_AUDIO_RADIO 2 #define USBVISION_AUDIO_MUTE 3 #define USBVISION_SER_MODE 0x07 #define USBVISION_SER_ADRS 0x08 #define USBVISION_SER_CONT 0x09 #define USBVISION_SER_DAT1 0x0A #define USBVISION_SER_DAT2 0x0B #define USBVISION_SER_DAT3 0x0C #define USBVISION_SER_DAT4 0x0D #define USBVISION_EE_DATA 0x0E #define USBVISION_EE_LSBAD 0x0F #define USBVISION_EE_CONT 0x10 #define USBVISION_DRM_CONT 0x12 #define USBVISION_REF (1 << 0) #define USBVISION_RES_UR (1 << 2) #define USBVISION_RES_FDL (1 << 3) #define USBVISION_RES_VDW (1 << 4) #define USBVISION_DRM_PRM1 0x13 #define USBVISION_DRM_PRM2 0x14 #define USBVISION_DRM_PRM3 0x15 #define USBVISION_DRM_PRM4 0x16 #define USBVISION_DRM_PRM5 0x17 #define USBVISION_DRM_PRM6 0x18 #define USBVISION_DRM_PRM7 0x19 #define USBVISION_DRM_PRM8 0x1A #define USBVISION_VIN_REG1 0x1B #define USBVISION_8_422_SYNC 0x01 #define USBVISION_16_422_SYNC 0x02 #define USBVISION_VSNC_POL (1 << 3) #define USBVISION_HSNC_POL (1 << 4) #define USBVISION_FID_POL (1 << 5) #define USBVISION_HVALID_PO (1 << 6) #define USBVISION_VCLK_POL (1 << 7) #define USBVISION_VIN_REG2 0x1C #define USBVISION_AUTO_FID (1 << 0) #define USBVISION_NONE_INTER (1 << 1) #define USBVISION_NOHVALID (1 << 2) #define USBVISION_UV_ID (1 << 3) #define USBVISION_FIX_2C (1 << 4) #define USBVISION_SEND_FID (1 << 5) #define USBVISION_KEEP_BLANK (1 << 7) #define USBVISION_LXSIZE_I 0x1D #define USBVISION_MXSIZE_I 0x1E #define USBVISION_LYSIZE_I 0x1F #define USBVISION_MYSIZE_I 0x20 #define USBVISION_LX_OFFST 0x21 #define USBVISION_MX_OFFST 0x22 #define USBVISION_LY_OFFST 0x23 #define USBVISION_MY_OFFST 0x24 #define USBVISION_FRM_RATE 0x25 #define USBVISION_LXSIZE_O 0x26 #define USBVISION_MXSIZE_O 0x27 #define USBVISION_LYSIZE_O 0x28 #define USBVISION_MYSIZE_O 0x29 #define USBVISION_FILT_CONT 0x2A #define USBVISION_VO_MODE 0x2B #define USBVISION_INTRA_CYC 0x2C #define USBVISION_STRIP_SZ 0x2D #define USBVISION_FORCE_INTRA 0x2E #define USBVISION_FORCE_UP 0x2F #define USBVISION_BUF_THR 0x30 #define USBVISION_DVI_YUV 0x31 #define USBVISION_AUDIO_CONT 0x32 #define USBVISION_AUD_PK_LEN 0x33 #define USBVISION_BLK_PK_LEN 0x34 #define USBVISION_PCM_THR1 0x38 #define USBVISION_PCM_THR2 0x39 #define USBVISION_DIST_THR_L 0x3A #define USBVISION_DIST_THR_H 0x3B #define USBVISION_MAX_DIST_L 0x3C #define USBVISION_MAX_DIST_H 0x3D #define USBVISION_OP_CODE 0x33 #define MAX_BYTES_PER_PIXEL 4 #define MIN_FRAME_WIDTH 64 #define MAX_USB_WIDTH 320 //384 #define MAX_FRAME_WIDTH 320 //384 /*streching sometimes causes crashes*/ #define MIN_FRAME_HEIGHT 48 #define MAX_USB_HEIGHT 240 //288 #define MAX_FRAME_HEIGHT 240 //288 /*Streching sometimes causes crashes*/ #define MAX_FRAME_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT * MAX_BYTES_PER_PIXEL) #define USBVISION_CLIPMASK_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT / 8) //bytesize of clipmask #define USBVISION_URB_FRAMES 32 #define USBVISION_MAX_ISOC_PACKET_SIZE 959 // NT1003 Specs Document says 1023 #define USBVISION_NUM_HEADERMARKER 20 #define USBVISION_NUMFRAMES 2 #define USBVISION_NUMSBUF 2 #define USBVISION_POWEROFF_TIME 3 * (HZ) // 3 seconds /* This macro restricts an int variable to an inclusive range */ #define RESTRICT_TO_RANGE(v,mi,ma) { if ((v) < (mi)) (v) = (mi); else if ((v) > (ma)) (v) = (ma); } /* * We use macros to do YUV -> RGB conversion because this is * very important for speed and totally unimportant for size. * * YUV -> RGB Conversion * --------------------- * * B = 1.164*(Y-16) + 2.018*(V-128) * G = 1.164*(Y-16) - 0.813*(U-128) - 0.391*(V-128) * R = 1.164*(Y-16) + 1.596*(U-128) * * If you fancy integer arithmetics (as you should), hear this: * * 65536*B = 76284*(Y-16) + 132252*(V-128) * 65536*G = 76284*(Y-16) - 53281*(U-128) - 25625*(V-128) * 65536*R = 76284*(Y-16) + 104595*(U-128) * * Make sure the output values are within [0..255] range. */ #define LIMIT_RGB(x) (((x) < 0) ? 0 : (((x) > 255) ? 255 : (x))) #define YUV_TO_RGB_BY_THE_BOOK(my,mu,mv,mr,mg,mb) { \ int mm_y, mm_yc, mm_u, mm_v, mm_r, mm_g, mm_b; \ mm_y = (my) - 16; \ mm_u = (mu) - 128; \ mm_v = (mv) - 128; \ mm_yc= mm_y * 76284; \ mm_b = (mm_yc + 132252*mm_v ) >> 16; \ mm_g = (mm_yc - 53281*mm_u - 25625*mm_v ) >> 16; \ mm_r = (mm_yc + 104595*mm_u ) >> 16; \ mb = LIMIT_RGB(mm_b); \ mg = LIMIT_RGB(mm_g); \ mr = LIMIT_RGB(mm_r); \ } /* Debugging aid */ #define USBVISION_SAY_AND_WAIT(what) { \ wait_queue_head_t wq; \ init_waitqueue_head(&wq); \ printk(KERN_INFO "Say: %s\n", what); \ interruptible_sleep_on_timeout (&wq, HZ*3); \ } /* * This macro checks if usbvision is still operational. The 'usbvision' * pointer must be valid, usbvision->dev must be valid, we are not * removing the device and the device has not erred on us. */ #define USBVISION_IS_OPERATIONAL(udevice) (\ (udevice != NULL) && \ ((udevice)->dev != NULL) && \ ((udevice)->last_error == 0) && \ (!(udevice)->remove_pending)) enum ScanState { ScanState_Scanning, /* Scanning for header */ ScanState_Lines /* Parsing lines */ }; /* Completion states of the data parser */ enum ParseState { ParseState_Continue, /* Just parse next item */ ParseState_NextFrame, /* Frame done, send it to V4L */ ParseState_Out, /* Not enough data for frame */ ParseState_EndParse /* End parsing */ }; enum FrameState { FrameState_Unused, /* Unused (no MCAPTURE) */ FrameState_Ready, /* Ready to start grabbing */ FrameState_Grabbing, /* In the process of being grabbed into */ FrameState_Done, /* Finished grabbing, but not been synced yet */ FrameState_DoneHold, /* Are syncing or reading */ FrameState_Error, /* Something bad happened while processing */ }; enum IsocState { IsocState_InFrame, /* Isoc packet is member of frame */ IsocState_NoFrame, /* Isoc packet is not member of any frame */ }; struct usb_device; struct usbvision_sbuf { char *data; struct urb *urb; }; #define USBVISION_MAGIC_1 0x55 #define USBVISION_MAGIC_2 0xAA #define USBVISION_HEADER_LENGTH 0x0c #define USBVISION_SAA7111_ADDR 0x48 #define USBVISION_SAA7113_ADDR 0x4a #define USBVISION_IIC_LRACK 0x20 #define USBVISION_IIC_LRNACK 0x30 #define USBVISION_FRAME_FORMAT_PARAM_INTRA (1<<7) struct usbvision_v4l2_format_st { int supported; int bytes_per_pixel; int depth; int format; char *desc; }; #define USBVISION_SUPPORTED_PALETTES ARRAY_SIZE(usbvision_v4l2_format) struct usbvision_frame_header { unsigned char magic_1; /* 0 magic */ unsigned char magic_2; /* 1 magic */ unsigned char headerLength; /* 2 */ unsigned char frameNum; /* 3 */ unsigned char framePhase; /* 4 */ unsigned char frameLatency; /* 5 */ unsigned char dataFormat; /* 6 */ unsigned char formatParam; /* 7 */ unsigned char frameWidthLo; /* 8 */ unsigned char frameWidthHi; /* 9 */ unsigned char frameHeightLo; /* 10 */ unsigned char frameHeightHi; /* 11 */ __u16 frameWidth; /* 8 - 9 after endian correction*/ __u16 frameHeight; /* 10 - 11 after endian correction*/ }; struct usbvision_frame { char *data; /* Frame buffer */ struct usbvision_frame_header isocHeader; /* Header from stream */ int width; /* Width application is expecting */ int height; /* Height */ int frmwidth; /* Width the frame actually is */ int frmheight; /* Height */ volatile int grabstate; /* State of grabbing */ int scanstate; /* State of scanning */ int curline; /* Line of frame we're working on */ long scanlength; /* uncompressed, raw data length of frame */ long bytes_read; /* amount of scanlength that has been read from data */ struct usbvision_v4l2_format_st v4l2_format; /* format the user needs*/ int v4l2_linesize; /* bytes for one videoline*/ struct timeval timestamp; wait_queue_head_t wq; /* Processes waiting */ int sequence; // How many video frames we send to user }; #define CODEC_SAA7113 7113 #define CODEC_SAA7111 7111 #define BRIDGE_NT1003 1003 #define BRIDGE_NT1004 1004 #define BRIDGE_NT1005 1005 #define USBVISION_I2C_CLIENTS_MAX 8 struct usbvision_device_data_st { int idVendor; int idProduct; int Interface; /* to handle special interface number like BELKIN and Hauppauge WinTV-USB II */ int Codec; int VideoChannels; __u64 VideoNorm; int AudioChannels; int Radio; int vbi; int Tuner; int TunerType; int Vin_Reg1; int Vin_Reg2; int X_Offset; int Y_Offset; int Dvi_yuv; char *ModelString; }; /* Declared on usbvision-cards.c */ extern struct usbvision_device_data_st usbvision_device_data[]; extern struct usb_device_id usbvision_table[]; struct usb_usbvision { struct video_device *vdev; /* Video Device */ struct video_device *rdev; /* Radio Device */ struct video_device *vbi; /* VBI Device */ struct video_audio audio_dev; /* Current audio params */ /* i2c Declaration Section*/ struct i2c_adapter i2c_adap; struct i2c_algo_usb_data i2c_algo; struct i2c_client i2c_client; int i2c_state, i2c_ok; struct i2c_client *i2c_clients[USBVISION_I2C_CLIENTS_MAX]; struct urb *ctrlUrb; unsigned char ctrlUrbBuffer[8]; int ctrlUrbBusy; struct usb_ctrlrequest ctrlUrbSetup; wait_queue_head_t ctrlUrb_wq; // Processes waiting struct semaphore ctrlUrbLock; int have_tuner; int tuner_type; int bridgeType; // NT1003, NT1004, NT1005 int channel; int radio; int video_inputs; // # of inputs unsigned long freq; int AudioMute; int AudioChannel; int isocMode; // format of video data for the usb isoc-transfer unsigned int nr; // Number of the device < MAX_USBVISION /* Device structure */ struct usb_device *dev; unsigned char iface; /* Video interface number */ unsigned char ifaceAltActive, ifaceAltInactive; /* Alt settings */ unsigned char Vin_Reg2_Preset; struct semaphore lock; struct timer_list powerOffTimer; struct work_struct powerOffWork; int power; /* is the device powered on? */ int user; /* user count for exclusive use */ int usbvision_used; /* Is this structure in use? */ int initialized; /* Had we already sent init sequence? */ int DevModel; /* What type of USBVISION device we got? */ int streaming; /* Are we streaming Isochronous? */ int last_error; /* What calamity struck us? */ int curwidth; /* width of the frame the device is currently set to*/ int curheight; /* height of the frame the device is currently set to*/ int stretch_width; /* stretch-factor for frame width (from usb to screen)*/ int stretch_height; /* stretch-factor for frame height (from usb to screen)*/ char *fbuf; /* Videodev buffer area for mmap*/ int max_frame_size; /* Bytes in one video frame */ int fbuf_size; /* Videodev buffer size */ int curFrameNum; // number of current frame in frame buffer mode struct usbvision_frame *curFrame; // pointer to current frame, set by usbvision_find_header struct usbvision_frame frame[USBVISION_NUMFRAMES]; // frame buffer int curSbufNum; // number of current receiving sbuf struct usbvision_sbuf sbuf[USBVISION_NUMSBUF]; // S buffering volatile int remove_pending; /* If set then about to exit */ /* Scratch space from the Isochronous Pipe.*/ unsigned char *scratch; int scratch_read_ptr; int scratch_write_ptr; int scratch_headermarker[USBVISION_NUM_HEADERMARKER]; int scratch_headermarker_read_ptr; int scratch_headermarker_write_ptr; int isocstate; /* color controls */ int saturation; int hue; int brightness; int contrast; int depth; struct usbvision_v4l2_format_st palette; struct v4l2_capability vcap; /* Video capabilities */ struct v4l2_input input; /* May be used for tuner support */ unsigned char video_endp; /* 0x82 for USBVISION devices based */ // Overlay stuff: struct v4l2_framebuffer vid_buf; struct v4l2_format vid_win; int vid_buf_valid; // Status: video buffer is valid (set) int vid_win_valid; // Status: video window is valid (set) int overlay; /*Status: Are we overlaying? */ unsigned int clipmask[USBVISION_CLIPMASK_SIZE / 4]; unsigned char *overlay_base; /* Virtual base address of video buffer */ unsigned char *overlay_win; /* virt start address of overlay window */ struct usbvision_frame overlay_frame; // Decompression stuff: unsigned char *IntraFrameBuffer; /* Buffer for reference frame */ int BlockPos; //for test only int requestIntra; // 0 = normal; 1 = intra frame is requested; int lastIsocFrameNum; // check for lost isoc frames int isocPacketSize; // need to calculate usedBandwidth int usedBandwidth; // used bandwidth 0-100%, need to set comprLevel int comprLevel; // How strong (100) or weak (0) is compression int lastComprLevel; // How strong (100) or weak (0) was compression int usb_bandwidth; /* Mbit/s */ /* /proc entries, relative to /proc/video/usbvision/ */ struct proc_dir_entry *proc_devdir; /* Per-device proc directory */ struct proc_dir_entry *proc_info; /* /info entry */ struct proc_dir_entry *proc_register; /* /register entry */ struct proc_dir_entry *proc_freq; /* /freq entry */ struct proc_dir_entry *proc_input; /* /input entry */ struct proc_dir_entry *proc_frame; /* /frame entry */ struct proc_dir_entry *proc_button; /* /button entry */ struct proc_dir_entry *proc_control; /* /control entry */ /* Statistics that can be overlayed on the screen */ unsigned long isocUrbCount; // How many URBs we received so far unsigned long urb_length; /* Length of last URB */ unsigned long isocDataCount; /* How many bytes we received */ unsigned long header_count; /* How many frame headers we found */ unsigned long scratch_ovf_count; /* How many times we overflowed scratch */ unsigned long isocSkipCount; /* How many empty ISO packets received */ unsigned long isocErrCount; /* How many bad ISO packets received */ unsigned long isocPacketCount; // How many packets we totally got unsigned long timeInIrq; // How long do we need for interrupt int isocMeasureBandwidthCount; int frame_num; // How many video frames we send to user int maxStripLen; // How big is the biggest strip int comprBlockPos; int stripLenErrors; // How many times was BlockPos greater than StripLen int stripMagicErrors; int stripLineNumberErrors; int ComprBlockTypes[4]; }; #endif /* __LINUX_USBVISION_H */