system/linux
system/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux synced 2024-10-05 19:02:12 +00:00
Code Issues Packages Projects Releases Wiki Activity
linux/drivers/media/video/usbvision/usbvision.h
Hans Verkuil 8403472f19 V4L/DVB: usbvision: remove BKL from usbvision 
Removed the BKL from usbvision.

There was an initialization bug as well where the i2c bus was registered twice.

Although when the BKL was present no oops was generated, I did run into
other i2c problems. Now that I protect against duplicate i2c registration
that bug is now gone as well.

But trying to disconnect the USB cable while someone is still using the device
still leads to a crash.

Signed-off-by: Hans Verkuil <hverkuil@xs4all.nl>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
2010-10-21 01:06:06 -02:00

529 lines
19 KiB
C
Raw Blame History

/*
* USBVISION.H
* usbvision header file
*
* Copyright (c) 1999-2005 Joerg Heckenbach <joerg@heckenbach-aw.de>
* Dwaine Garden <dwainegarden@rogers.com>
*
*
* Report problems to v4l MailingList: linux-media@vger.kernel.org
*
* This module is part of usbvision driver project.
* Updates to driver completed by Dwaine P. Garden
* v4l2 conversion by Thierry Merle <thierry.merle@free.fr>
*
* 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 <linux/list.h>
#include <linux/usb.h>
#include <linux/i2c.h>
#include <linux/mutex.h>
#include <media/v4l2-device.h>
#include <media/tuner.h>
#include <linux/videodev2.h>
#define USBVISION_DEBUG /* Turn on debug messages */
#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_NUM_HEADERMARKER 20
#define USBVISION_NUMFRAMES 3 /* Maximum number of frames an application can get */
#define USBVISION_NUMSBUF 2 /* Dimensioning the USB S buffering */
#define USBVISION_POWEROFF_TIME 3 * (HZ) // 3 seconds
#define FRAMERATE_MIN 0
#define FRAMERATE_MAX 31
enum {
ISOC_MODE_YUV422 = 0x03,
ISOC_MODE_YUV420 = 0x14,
ISOC_MODE_COMPRESS = 0x60,
};
/* 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))
#define I2C_USB_ADAP_MAX 16
#define USBVISION_NORMS (V4L2_STD_PAL | V4L2_STD_NTSC | V4L2_STD_SECAM | V4L2_STD_PAL_M)
/* ----------------------------------------------------------------- */
/* usbvision video structures */
/* ----------------------------------------------------------------- */
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 */
};
/* stream states */
enum StreamState {
Stream_Off, /* Driver streaming is completely OFF */
Stream_Idle, /* Driver streaming is ready to be put ON by the application */
Stream_Interrupt, /* Driver streaming must be interrupted */
Stream_On, /* Driver streaming is put ON by the application */
};
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 index; /* Frame index */
int frmwidth; /* Width the frame actually is */
int frmheight; /* Height */
volatile int grabstate; /* State of grabbing */
int scanstate; /* State of scanning */
struct list_head frame;
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;
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
struct usbvision_device_data_st {
__u64 VideoNorm;
const char *ModelString;
int Interface; /* to handle special interface number like BELKIN and Hauppauge WinTV-USB II */
__u16 Codec;
unsigned VideoChannels:3;
unsigned AudioChannels:2;
unsigned Radio:1;
unsigned vbi:1;
unsigned Tuner:1;
unsigned Vin_Reg1_override:1; /* Override default value with */
unsigned Vin_Reg2_override:1; /* Vin_Reg1, Vin_Reg2, etc. */
unsigned Dvi_yuv_override:1;
__u8 Vin_Reg1;
__u8 Vin_Reg2;
__u8 Dvi_yuv;
__u8 TunerType;
__s16 X_Offset;
__s16 Y_Offset;
};
/* 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 v4l2_device v4l2_dev;
struct video_device *vdev; /* Video Device */
struct video_device *rdev; /* Radio Device */
/* i2c Declaration Section*/
struct i2c_adapter i2c_adap;
int registered_i2c;
struct urb *ctrlUrb;
unsigned char ctrlUrbBuffer[8];
int ctrlUrbBusy;
struct usb_ctrlrequest ctrlUrbSetup;
wait_queue_head_t ctrlUrb_wq; // Processes waiting
/* configuration part */
int have_tuner;
int tuner_type;
int bridgeType; // NT1003, NT1004, NT1005
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
/* Device structure */
struct usb_device *dev;
/* usb transfer */
int num_alt; /* Number of alternative settings */
unsigned int *alt_max_pkt_size; /* array of wMaxPacketSize */
unsigned char iface; /* Video interface number */
unsigned char ifaceAlt; /* Alt settings */
unsigned char Vin_Reg2_Preset;
struct mutex lock;
struct timer_list powerOffTimer;
struct work_struct powerOffWork;
int power; /* is the device powered on? */
int user; /* user count for exclusive use */
int initialized; /* Had we already sent init sequence? */
int DevModel; /* What type of USBVISION device we got? */
enum StreamState 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 */
spinlock_t queue_lock; /* spinlock for protecting mods on inqueue and outqueue */
struct list_head inqueue, outqueue; /* queued frame list and ready to dequeue frame list */
wait_queue_head_t wait_frame; /* Processes waiting */
wait_queue_head_t wait_stream; /* Processes waiting */
struct usbvision_frame *curFrame; // pointer to current frame, set by usbvision_find_header
struct usbvision_frame frame[USBVISION_NUMFRAMES]; // frame buffer
int num_frames; // number of frames allocated
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;
enum IsocState isocstate;
struct usbvision_v4l2_format_st palette;
struct v4l2_capability vcap; /* Video capabilities */
unsigned int ctl_input; /* selected input */
v4l2_std_id tvnormId; /* selected tv norm */
unsigned char video_endp; /* 0x82 for USBVISION devices based */
// 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 */
/* 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];
};
static inline struct usb_usbvision *to_usbvision(struct v4l2_device *v4l2_dev)
{
return container_of(v4l2_dev, struct usb_usbvision, v4l2_dev);
}
#define call_all(usbvision, o, f, args...) \
v4l2_device_call_all(&usbvision->v4l2_dev, 0, o, f, ##args)
/* --------------------------------------------------------------- */
/* defined in usbvision-i2c.c */
/* i2c-algo-usb declaration */
/* --------------------------------------------------------------- */
/* ----------------------------------------------------------------------- */
/* usbvision specific I2C functions */
/* ----------------------------------------------------------------------- */
int usbvision_i2c_register(struct usb_usbvision *usbvision);
int usbvision_i2c_unregister(struct usb_usbvision *usbvision);
/* defined in usbvision-core.c */
int usbvision_read_reg(struct usb_usbvision *usbvision, unsigned char reg);
int usbvision_write_reg(struct usb_usbvision *usbvision, unsigned char reg,
unsigned char value);
int usbvision_frames_alloc(struct usb_usbvision *usbvision, int number_of_frames);
void usbvision_frames_free(struct usb_usbvision *usbvision);
int usbvision_scratch_alloc(struct usb_usbvision *usbvision);
void usbvision_scratch_free(struct usb_usbvision *usbvision);
int usbvision_decompress_alloc(struct usb_usbvision *usbvision);
void usbvision_decompress_free(struct usb_usbvision *usbvision);
int usbvision_setup(struct usb_usbvision *usbvision,int format);
int usbvision_init_isoc(struct usb_usbvision *usbvision);
int usbvision_restart_isoc(struct usb_usbvision *usbvision);
void usbvision_stop_isoc(struct usb_usbvision *usbvision);
int usbvision_set_alternate(struct usb_usbvision *dev);
int usbvision_set_audio(struct usb_usbvision *usbvision, int AudioChannel);
int usbvision_audio_off(struct usb_usbvision *usbvision);
int usbvision_begin_streaming(struct usb_usbvision *usbvision);
void usbvision_empty_framequeues(struct usb_usbvision *dev);
int usbvision_stream_interrupt(struct usb_usbvision *dev);
int usbvision_muxsel(struct usb_usbvision *usbvision, int channel);
int usbvision_set_input(struct usb_usbvision *usbvision);
int usbvision_set_output(struct usb_usbvision *usbvision, int width, int height);
void usbvision_init_powerOffTimer(struct usb_usbvision *usbvision);
void usbvision_set_powerOffTimer(struct usb_usbvision *usbvision);
void usbvision_reset_powerOffTimer(struct usb_usbvision *usbvision);
int usbvision_power_off(struct usb_usbvision *usbvision);
int usbvision_power_on(struct usb_usbvision *usbvision);
#endif /* __LINUX_USBVISION_H */
/*
* Overrides for Emacs so that we follow Linus's tabbing style.
* ---------------------------------------------------------------------------
* Local variables:
* c-basic-offset: 8
* End:
*/
Reference in a new issue View git blame Copy permalink