2005-04-17 02:20:36 +04:00
/***************************************************************************
* Video4Linux driver for W996 [ 87 ] CF JPEG USB Dual Mode Camera Chip . *
* *
* Copyright ( C ) 2002 - 2004 by Luca Risolia < luca . risolia @ studio . unibo . it > *
* *
* 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 0213 9 , USA . *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# ifndef _W9968CF_H_
# define _W9968CF_H_
2008-07-25 12:32:50 +04:00
# include <linux/videodev2.h>
2005-04-17 02:20:36 +04:00
# include <linux/usb.h>
# include <linux/i2c.h>
# include <linux/device.h>
# include <linux/spinlock.h>
# include <linux/list.h>
# include <linux/wait.h>
# include <linux/param.h>
# include <linux/types.h>
# include <linux/rwsem.h>
2006-01-11 17:55:29 +03:00
# include <linux/mutex.h>
2005-04-17 02:20:36 +04:00
# include <media/ovcamchip.h>
# include "w9968cf_vpp.h"
/****************************************************************************
* Default values *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# define W9968CF_OVMOD_LOAD 1 /* automatic 'ovcamchip' module loading */
# define W9968CF_VPPMOD_LOAD 1 /* automatic 'w9968cf-vpp' module loading */
/* Comment/uncomment the following line to enable/disable debugging messages */
# define W9968CF_DEBUG
/* These have effect only if W9968CF_DEBUG is defined */
# define W9968CF_DEBUG_LEVEL 2 /* from 0 to 6. 0 for no debug informations */
# define W9968CF_SPECIFIC_DEBUG 0 /* 0 or 1 */
# define W9968CF_MAX_DEVICES 32
# define W9968CF_SIMCAMS W9968CF_MAX_DEVICES /* simultaneous cameras */
# define W9968CF_MAX_BUFFERS 32
# define W9968CF_BUFFERS 2 /* n. of frame buffers from 2 to MAX_BUFFERS */
/* Maximum data payload sizes in bytes for alternate settings */
static const u16 wMaxPacketSize [ ] = { 1023 , 959 , 895 , 831 , 767 , 703 , 639 , 575 ,
2006-03-25 15:19:53 +03:00
511 , 447 , 383 , 319 , 255 , 191 , 127 , 63 } ;
2005-04-17 02:20:36 +04:00
# define W9968CF_PACKET_SIZE 1023 /* according to wMaxPacketSizes[] */
# define W9968CF_MIN_PACKET_SIZE 63 /* minimum value */
# define W9968CF_ISO_PACKETS 5 /* n.of packets for isochronous transfers */
# define W9968CF_USB_CTRL_TIMEOUT 1000 /* timeout (ms) for usb control commands */
# define W9968CF_URBS 2 /* n. of scheduled URBs for ISO transfer */
# define W9968CF_I2C_BUS_DELAY 4 /* delay in us for I2C bit r/w operations */
# define W9968CF_I2C_RW_RETRIES 15 /* number of max I2C r/w retries */
/* Available video formats */
struct w9968cf_format {
const u16 palette ;
const u16 depth ;
const u8 compression ;
} ;
static const struct w9968cf_format w9968cf_formatlist [ ] = {
{ VIDEO_PALETTE_UYVY , 16 , 0 } , /* original video */
{ VIDEO_PALETTE_YUV422P , 16 , 1 } , /* with JPEG compression */
{ VIDEO_PALETTE_YUV420P , 12 , 1 } , /* with JPEG compression */
{ VIDEO_PALETTE_YUV420 , 12 , 1 } , /* same as YUV420P */
{ VIDEO_PALETTE_YUYV , 16 , 0 } , /* software conversion */
{ VIDEO_PALETTE_YUV422 , 16 , 0 } , /* software conversion */
{ VIDEO_PALETTE_GREY , 8 , 0 } , /* software conversion */
{ VIDEO_PALETTE_RGB555 , 16 , 0 } , /* software conversion */
{ VIDEO_PALETTE_RGB565 , 16 , 0 } , /* software conversion */
{ VIDEO_PALETTE_RGB24 , 24 , 0 } , /* software conversion */
{ VIDEO_PALETTE_RGB32 , 32 , 0 } , /* software conversion */
{ 0 , 0 , 0 } /* 0 is a terminating entry */
} ;
# define W9968CF_DECOMPRESSION 2 /* decomp:0=disable,1=force,2=any formats */
# define W9968CF_PALETTE_DECOMP_OFF VIDEO_PALETTE_UYVY /* when decomp=0 */
# define W9968CF_PALETTE_DECOMP_FORCE VIDEO_PALETTE_YUV420P /* when decomp=1 */
# define W9968CF_PALETTE_DECOMP_ON VIDEO_PALETTE_UYVY /* when decomp=2 */
# define W9968CF_FORCE_RGB 0 /* read RGB instead of BGR, yes=1/no=0 */
# define W9968CF_MAX_WIDTH 800 /* Has effect if up-scaling is on */
# define W9968CF_MAX_HEIGHT 600 /* Has effect if up-scaling is on */
# define W9968CF_WIDTH 320 /* from 128 to 352, multiple of 16 */
# define W9968CF_HEIGHT 240 /* from 96 to 288, multiple of 16 */
# define W9968CF_CLAMPING 0 /* 0 disable, 1 enable video data clamping */
# define W9968CF_FILTER_TYPE 0 /* 0 disable 1 (1-2-1), 2 (2-3-6-3-2) */
# define W9968CF_DOUBLE_BUFFER 1 /* 0 disable, 1 enable double buffer */
# define W9968CF_LARGEVIEW 1 /* 0 disable, 1 enable */
# define W9968CF_UPSCALING 0 /* 0 disable, 1 enable */
# define W9968CF_MONOCHROME 0 /* 0 not monochrome, 1 monochrome sensor */
# define W9968CF_BRIGHTNESS 31000 /* from 0 to 65535 */
# define W9968CF_HUE 32768 /* from 0 to 65535 */
# define W9968CF_COLOUR 32768 /* from 0 to 65535 */
# define W9968CF_CONTRAST 50000 /* from 0 to 65535 */
# define W9968CF_WHITENESS 32768 /* from 0 to 65535 */
# define W9968CF_AUTOBRIGHT 0 /* 0 disable, 1 enable automatic brightness */
# define W9968CF_AUTOEXP 1 /* 0 disable, 1 enable automatic exposure */
# define W9968CF_LIGHTFREQ 50 /* light frequency. 50Hz (Europe) or 60Hz */
# define W9968CF_BANDINGFILTER 0 /* 0 disable, 1 enable banding filter */
# define W9968CF_BACKLIGHT 0 /* 0 or 1, 1=object is lit from behind */
# define W9968CF_MIRROR 0 /* 0 or 1 [don't] reverse image horizontally*/
# define W9968CF_CLOCKDIV -1 /* -1 = automatic clock divisor */
# define W9968CF_DEF_CLOCKDIVISOR 0 /* default sensor clock divisor value */
/****************************************************************************
* Globals *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# define W9968CF_MODULE_NAME "V4L driver for W996[87]CF JPEG USB " \
2006-03-25 15:19:53 +03:00
" Dual Mode Camera Chip "
2005-04-17 02:20:36 +04:00
# define W9968CF_MODULE_VERSION "1:1.33-basic"
# define W9968CF_MODULE_AUTHOR "(C) 2002-2004 Luca Risolia"
# define W9968CF_AUTHOR_EMAIL "<luca.risolia@studio.unibo.it>"
# define W9968CF_MODULE_LICENSE "GPL"
static const struct usb_device_id winbond_id_table [ ] = {
{
/* Creative Labs Video Blaster WebCam Go Plus */
USB_DEVICE ( 0x041e , 0x4003 ) ,
. driver_info = ( unsigned long ) " w9968cf " ,
} ,
{
/* Generic W996[87]CF JPEG USB Dual Mode Camera */
USB_DEVICE ( 0x1046 , 0x9967 ) ,
. driver_info = ( unsigned long ) " w9968cf " ,
} ,
{ } /* terminating entry */
} ;
/* W996[87]CF camera models, internal ids: */
enum w9968cf_model_id {
W9968CF_MOD_GENERIC = 1 , /* Generic W996[87]CF based device */
W9968CF_MOD_CLVBWGP = 11 , /*Creative Labs Video Blaster WebCam Go Plus*/
W9968CF_MOD_ADPVDMA = 21 , /* Aroma Digi Pen VGA Dual Mode ADG-5000 */
W9986CF_MOD_AAU = 31 , /* AVerMedia AVerTV USB */
W9968CF_MOD_CLVBWG = 34 , /* Creative Labs Video Blaster WebCam Go */
W9968CF_MOD_LL = 37 , /* Lebon LDC-035A */
W9968CF_MOD_EEEMC = 40 , /* Ezonics EZ-802 EZMega Cam */
W9968CF_MOD_OOE = 42 , /* OmniVision OV8610-EDE */
W9968CF_MOD_ODPVDMPC = 43 , /* OPCOM Digi Pen VGA Dual Mode Pen Camera */
W9968CF_MOD_PDPII = 46 , /* Pretec Digi Pen-II */
W9968CF_MOD_PDP480 = 49 , /* Pretec DigiPen-480 */
} ;
enum w9968cf_frame_status {
F_READY , /* finished grabbing & ready to be read/synced */
F_GRABBING , /* in the process of being grabbed into */
F_ERROR , /* something bad happened while processing */
F_UNUSED /* unused (no VIDIOCMCAPTURE) */
} ;
struct w9968cf_frame_t {
void * buffer ;
unsigned long size ;
u32 length ;
int number ;
enum w9968cf_frame_status status ;
struct w9968cf_frame_t * next ;
u8 queued ;
} ;
enum w9968cf_vpp_flag {
VPP_NONE = 0x00 ,
VPP_UPSCALE = 0x01 ,
VPP_SWAP_YUV_BYTES = 0x02 ,
VPP_DECOMPRESSION = 0x04 ,
VPP_UYVY_TO_RGBX = 0x08 ,
} ;
/* Main device driver structure */
struct w9968cf_device {
struct device dev ; /* device structure */
enum w9968cf_model_id id ; /* private device identifier */
struct video_device * v4ldev ; /* -> V4L structure */
struct list_head v4llist ; /* entry of the list of V4L cameras */
struct usb_device * usbdev ; /* -> main USB structure */
struct urb * urb [ W9968CF_URBS ] ; /* -> USB request block structs */
void * transfer_buffer [ W9968CF_URBS ] ; /* -> ISO transfer buffers */
u16 * control_buffer ; /* -> buffer for control req.*/
u16 * data_buffer ; /* -> data to send to the FSB */
struct w9968cf_frame_t frame [ W9968CF_MAX_BUFFERS ] ;
struct w9968cf_frame_t frame_tmp ; /* temporary frame */
struct w9968cf_frame_t frame_vpp ; /* helper frame.*/
struct w9968cf_frame_t * frame_current ; /* -> frame being grabbed */
struct w9968cf_frame_t * requested_frame [ W9968CF_MAX_BUFFERS ] ;
u8 max_buffers , /* number of requested buffers */
force_palette , /* yes=1/no=0 */
force_rgb , /* read RGB instead of BGR, yes=1, no=0 */
double_buffer , /* hardware double buffering yes=1/no=0 */
clamping , /* video data clamping yes=1/no=0 */
filter_type , /* 0=disabled, 1=3 tap, 2=5 tap filter */
capture , /* 0=disabled, 1=enabled */
largeview , /* 0=disabled, 1=enabled */
decompression , /* 0=disabled, 1=forced, 2=allowed */
upscaling ; /* software image scaling, 0=enabled, 1=disabled */
struct video_picture picture ; /* current picture settings */
struct video_window window ; /* current window settings */
u16 hw_depth , /* depth (used by the chip) */
hw_palette , /* palette (used by the chip) */
hw_width , /* width (used by the chip) */
hw_height , /* height (used by the chip) */
hs_polarity , /* 0=negative sync pulse, 1=positive sync pulse */
vs_polarity , /* 0=negative sync pulse, 1=positive sync pulse */
start_cropx , /* pixels from HS inactive edge to 1st cropped pixel*/
start_cropy ; /* pixels from VS inactive edge to 1st cropped pixel*/
enum w9968cf_vpp_flag vpp_flag ; /* post-processing routines in use */
u8 nbuffers , /* number of allocated frame buffers */
altsetting , /* camera alternate setting */
disconnected , /* flag: yes=1, no=0 */
misconfigured , /* flag: yes=1, no=0 */
users , /* flag: number of users holding the device */
streaming ; /* flag: yes=1, no=0 */
u8 sensor_initialized ; /* flag: yes=1, no=0 */
/* Determined by the image sensor type: */
int sensor , /* type of image sensor chip (CC_*) */
monochrome ; /* image sensor is (probably) monochrome */
u16 maxwidth , /* maximum width supported by the image sensor */
maxheight , /* maximum height supported by the image sensor */
minwidth , /* minimum width supported by the image sensor */
minheight ; /* minimum height supported by the image sensor */
u8 auto_brt , /* auto brightness enabled flag */
auto_exp , /* auto exposure enabled flag */
backlight , /* backlight exposure algorithm flag */
mirror , /* image is reversed horizontally */
lightfreq , /* power (lighting) frequency */
bandfilt ; /* banding filter enabled flag */
s8 clockdiv ; /* clock divisor */
/* I2C interface to kernel */
struct i2c_adapter i2c_adapter ;
struct i2c_client * sensor_client ;
/* Locks */
2006-01-11 17:55:29 +03:00
struct mutex dev_mutex , /* for probe, disconnect,open and close */
2006-03-25 15:19:53 +03:00
fileop_mutex ; /* for read and ioctl */
2005-04-17 02:20:36 +04:00
spinlock_t urb_lock , /* for submit_urb() and unlink_urb() */
2006-03-25 15:19:53 +03:00
flist_lock ; /* for requested frame list accesses */
2005-04-17 02:20:36 +04:00
wait_queue_head_t open , wait_queue ;
char command [ 16 ] ; /* name of the program holding the device */
} ;
/****************************************************************************
* Macros for debugging *
* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
# undef DBG
# undef KDBG
# ifdef W9968CF_DEBUG
/* For device specific debugging messages */
# define DBG(level, fmt, args...) \
{ \
if ( ( ( specific_debug ) & & ( debug = = ( level ) ) ) | | \
( ( ! specific_debug ) & & ( debug > = ( level ) ) ) ) { \
if ( ( level ) = = 1 ) \
dev_err ( & cam - > dev , fmt " \n " , # # args ) ; \
else if ( ( level ) = = 2 | | ( level ) = = 3 ) \
dev_info ( & cam - > dev , fmt " \n " , # # args ) ; \
else if ( ( level ) = = 4 ) \
dev_warn ( & cam - > dev , fmt " \n " , # # args ) ; \
else if ( ( level ) > = 5 ) \
dev_info ( & cam - > dev , " [%s:%d] " fmt " \n " , \
2008-04-09 06:20:00 +04:00
__func__ , __LINE__ , # # args ) ; \
2005-04-17 02:20:36 +04:00
} \
}
/* For generic kernel (not device specific) messages */
# define KDBG(level, fmt, args...) \
{ \
if ( ( ( specific_debug ) & & ( debug = = ( level ) ) ) | | \
( ( ! specific_debug ) & & ( debug > = ( level ) ) ) ) { \
if ( ( level ) > = 1 & & ( level ) < = 4 ) \
pr_info ( " w9968cf: " fmt " \n " , # # args ) ; \
else if ( ( level ) > = 5 ) \
2008-04-09 06:20:00 +04:00
pr_debug ( " w9968cf: [%s:%d] " fmt " \n " , __func__ , \
2006-03-25 15:19:53 +03:00
__LINE__ , # # args ) ; \
2005-04-17 02:20:36 +04:00
} \
}
# else
/* Not debugging: nothing */
# define DBG(level, fmt, args...) do {;} while(0);
# define KDBG(level, fmt, args...) do {;} while(0);
# endif
# undef PDBG
# define PDBG(fmt, args...) \
2008-04-09 06:20:00 +04:00
dev_info ( & cam - > dev , " [%s:%d] " fmt " \n " , __func__ , __LINE__ , # # args ) ;
2005-04-17 02:20:36 +04:00
# undef PDBGG
# define PDBGG(fmt, args...) do {;} while(0); /* nothing: it's a placeholder */
# endif /* _W9968CF_H_ */
