usbcam.h

Windows CE下USB驱动（OV511）

#ifndef __USBCAM_H_
#define __USBCAM_H_

#include <windows.h>                 // For all that Windows stuff
#include <USBdi.h>					// USB includes
#include <usb100.h>					// USB includes
#include "usbclient.h"				// USB client driver helper code
#include <winioctl.h>

//定义USB常量
#define DRIVER_NAME   TEXT("usbcamera.dll")
#define DEVICE_PREFIX TEXT("CAM")

#define CLASS_NAME_SZ    TEXT("Video_Class")
#define CLIENT_REGKEY_SZ TEXT("Drivers\\USB\\ClientDrivers\\Video_Class")

//USB视频设备接口定义(类号码为14)
#define USB_DEVICE_CLASS_VIDEO                   0x0E

//定义USB设备ID
#define VEND_OMNIVISION	    0x05A9
#define PROD_OV511	        0x0511
#define PROD_OV511PLUS	    0xA511
#define PROD_OV518	        0x0518
#define PROD_OV518PLUS	    0xA518

#define VEND_MATTEL         0x0813
#define PROD_ME2CAM     	0x0002

//一些常量定义
//USB相关
#define USB_TYPE_VENDOR (0x02 << 5)
#define USB_RECIP_DEVICE 0x00
#define USB_DIR_IN 0x80 

//OV511相关
#define OV511_NUMSBUF  2
#define OV511_NUMFRAMES	2

#define OV511_NUMSBUF		2

#define FRAMES_PER_DESC		10
//////////////////////////////////////////////////////////////

#define MAXPACKETS 10


//定义OV51X系列摄像头寄存器
/* Camera interface register numbers */
#define R511_CAM_DELAY	    	0x10
#define R511_CAM_EDGE	    	0x11
#define R511_CAM_PXCNT      	0x12
#define R511_CAM_LNCNT	    	0x13
#define R511_CAM_PXDIV  		0x14
#define R511_CAM_LNDIV  		0x15
#define R511_CAM_UV_EN	    	0x16
#define R511_CAM_LINE_MODE  	0x17
#define R511_CAM_OPTS	    	0x18

/* Snapshot mode camera interface register numbers */
#define R511_SNAP_FRAME	    	0x19
#define R511_SNAP_PXCNT	    	0x1A
#define R511_SNAP_LNCNT 		0x1B
#define R511_SNAP_PXDIV 		0x1C
#define R511_SNAP_LNDIV 		0x1D
#define R511_SNAP_UV_EN 		0x1E
#define R511_SNAP_OPTS  		0x1F

/* DRAM register numbers */
#define R511_DRAM_FLOW_CTL  	0x20
#define R511_DRAM_ARCP  		0x21
#define R511_DRAM_MRC   		0x22
#define R511_DRAM_RFC   		0x23
    
/* ISO FIFO register numbers */
#define R51x_FIFO_PSIZE     	0x30	/* 2 bytes wide w/ OV518(+) */
#define R511_FIFO_OPTS  		0x31

/* Parallel IO register numbers */
#define R511_PIO_OPTS	    	0x38
#define R511_PIO_DATA   		0x39
#define R511_PIO_BIST		    0x3E
#define R518_GPIO_IN		    0x55	/* OV518(+) only */
#define R518_GPIO_OUT		    0x56	/* OV518(+) only */
#define R518_GPIO_CTL		    0x57	/* OV518(+) only */
#define R518_GPIO_PULSE_IN	    0x58	/* OV518(+) only */
#define R518_GPIO_PULSE_CLEAR	0x59	/* OV518(+) only */
#define R518_GPIO_PULSE_POL 	0x5a	/* OV518(+) only */
#define R518_GPIO_PULSE_EN	    0x5b	/* OV518(+) only */
#define R518_GPIO_RESET		    0x5c	/* OV518(+) only */

/* I2C registers */
#define R511_I2C_CTL		    0x40
#define R518_I2C_CTL	    	0x47	/* OV518(+) only */
#define R51x_I2C_W_SID	    	0x41
#define R51x_I2C_SADDR_3    	0x42
#define R51x_I2C_SADDR_2    	0x43
#define R51x_I2C_R_SID	    	0x44
#define R51x_I2C_DATA	    	0x45
#define R51x_I2C_CLOCK	    	0x46
#define R51x_I2C_TIMEOUT    	0x47

/* I2C snapshot registers */
#define R511_SI2C_SADDR_3   	0x48
#define R511_SI2C_DATA	    	0x49

/* System control registers */
#define R51x_SYS_RESET	    	0x50
/* Reset type definitions */
#define 	OV511_RESET_UDC		0x01
#define 	OV511_RESET_I2C		0x02
#define 	OV511_RESET_FIFO	0x04
#define 	OV511_RESET_OMNICE	0x08
#define 	OV511_RESET_DRAM	0x10
#define 	OV511_RESET_CAM_INT	0x20
#define 	OV511_RESET_OV511	0x40
#define 	OV511_RESET_NOREGS	0x3F /* All but OV511 & regs */
#define 	OV511_RESET_ALL		0x7F

#define R511_SYS_CLOCK_DIV  	0x51
#define R51x_SYS_SNAP	    	0x52
#define R51x_SYS_INIT       	0x53
#define R511_SYS_PWR_CLK    	0x54 /* OV511+/OV518(+) only */
#define R511_SYS_LED_CTL	    0x55 /* OV511+ only */
#define R511_SYS_USER		    0x5E
#define R511_SYS_CUST_ID	    0x5F

/* OmniCE (compression) registers */
#define R511_COMP_PHY	    	0x70
#define R511_COMP_PHUV	    	0x71
#define R511_COMP_PVY	    	0x72
#define R511_COMP_PVUV	    	0x73
#define R511_COMP_QHY	    	0x74
#define R511_COMP_QHUV	    	0x75
#define R511_COMP_QVY	    	0x76
#define R511_COMP_QVUV	    	0x77
#define R511_COMP_EN	    	0x78
#define R511_COMP_LUT_EN    	0x79		
#define R511_COMP_LUT_BEGIN	    0x80

/* --------------------------------- */
/*         ALTERNATE NUMBERS         */
/* --------------------------------- */

/* Alternate numbers for various max packet sizes (OV511 only) */
#define OV511_ALT_SIZE_992	0
#define OV511_ALT_SIZE_993	1
#define OV511_ALT_SIZE_768	2
#define OV511_ALT_SIZE_769	3
#define OV511_ALT_SIZE_512	4
#define OV511_ALT_SIZE_513	5
#define OV511_ALT_SIZE_257	6
#define OV511_ALT_SIZE_0	7

/* Alternate numbers for various max packet sizes (OV511+ only) */
#define OV511PLUS_ALT_SIZE_0	0
#define OV511PLUS_ALT_SIZE_33	1
#define OV511PLUS_ALT_SIZE_129	2
#define OV511PLUS_ALT_SIZE_257	3
#define OV511PLUS_ALT_SIZE_385	4
#define OV511PLUS_ALT_SIZE_513	5
#define OV511PLUS_ALT_SIZE_769	6
#define OV511PLUS_ALT_SIZE_961	7

/* Alternate numbers for various max packet sizes (OV518(+) only) */
#define OV518_ALT_SIZE_0	0
#define OV518_ALT_SIZE_128	1
#define OV518_ALT_SIZE_256	2
#define OV518_ALT_SIZE_384	3
#define OV518_ALT_SIZE_512	4
#define OV518_ALT_SIZE_640	5
#define OV518_ALT_SIZE_768	6
#define OV518_ALT_SIZE_896	7

/* --------------------------------- */
/*     OV7610 REGISTER MNEMONICS     */
/* --------------------------------- */

/* OV7610 registers */
#define OV7610_REG_GAIN          0x00	/* gain setting (5:0) */
#define OV7610_REG_BLUE          0x01	/* blue channel balance */
#define OV7610_REG_RED           0x02	/* red channel balance */
#define OV7610_REG_SAT           0x03	/* saturation */
/* 04 reserved */
#define OV7610_REG_CNT           0x05	/* Y contrast */
#define OV7610_REG_BRT           0x06	/* Y brightness */
/* 08-0b reserved */
#define OV7610_REG_BLUE_BIAS     0x0C	/* blue channel bias (5:0) */
#define OV7610_REG_RED_BIAS      0x0D	/* read channel bias (5:0) */
#define OV7610_REG_GAMMA_COEFF   0x0E	/* gamma settings */
#define OV7610_REG_WB_RANGE      0x0F	/* AEC/ALC/S-AWB settings */
#define OV7610_REG_EXP           0x10	/* manual exposure setting */
#define OV7610_REG_CLOCK         0x11	/* polarity/clock prescaler */
#define OV7610_REG_COM_A         0x12	/* misc common regs */
#define OV7610_REG_COM_B         0x13	/* misc common regs */
#define OV7610_REG_COM_C         0x14	/* misc common regs */
#define OV7610_REG_COM_D         0x15	/* misc common regs */
#define OV7610_REG_FIELD_DIVIDE  0x16	/* field interval/mode settings */
#define OV7610_REG_HWIN_START    0x17	/* horizontal window start */
#define OV7610_REG_HWIN_END      0x18	/* horizontal window end */
#define OV7610_REG_VWIN_START    0x19	/* vertical window start */
#define OV7610_REG_VWIN_END      0x1A	/* vertical window end */
#define OV7610_REG_PIXEL_SHIFT   0x1B	/* pixel shift */
#define OV7610_REG_ID_HIGH       0x1C	/* manufacturer ID MSB */
#define OV7610_REG_ID_LOW        0x1D	/* manufacturer ID LSB */
/* 0e-0f reserved */
#define OV7610_REG_COM_E         0x20	/* misc common regs */
#define OV7610_REG_YOFFSET       0x21	/* Y channel offset */
#define OV7610_REG_UOFFSET       0x22	/* U channel offset */
/* 23 reserved */
#define OV7610_REG_ECW           0x24	/* Exposure white level for AEC */
#define OV7610_REG_ECB           0x25	/* Exposure black level for AEC */
#define OV7610_REG_COM_F         0x26	/* misc settings */
#define OV7610_REG_COM_G         0x27	/* misc settings */
#define OV7610_REG_COM_H         0x28	/* misc settings */
#define OV7610_REG_COM_I         0x29	/* misc settings */
#define OV7610_REG_FRAMERATE_H   0x2A	/* frame rate MSB + misc */
#define OV7610_REG_FRAMERATE_L   0x2B	/* frame rate LSB */
#define OV7610_REG_ALC           0x2C	/* Auto Level Control settings */
#define OV7610_REG_COM_J         0x2D	/* misc settings */
#define OV7610_REG_VOFFSET       0x2E	/* V channel offset adjustment */
#define OV7610_REG_ARRAY_BIAS	 0x2F	/* Array bias -- don't change */
/* 30-32 reserved */
#define OV7610_REG_YGAMMA        0x33	/* misc gamma settings (7:6) */
#define OV7610_REG_BIAS_ADJUST   0x34	/* misc bias settings */
#define OV7610_REG_COM_L         0x35	/* misc settings */
/* 36-37 reserved */
#define OV7610_REG_COM_K         0x38	/* misc registers */

/* --------------------------------- */
/*           I2C ADDRESSES           */
/* --------------------------------- */

#define OV7xx0_SID   0x42
#define OV6xx0_SID   0xC0
#define OV8xx0_SID   0xA0
#define KS0127_SID   0xD8
#define SAA7111A_SID 0x48

#define FRAMES_PER_DESC		10	/* FIXME - What should this be? */
#define MAX_FRAME_SIZE_PER_DESC	993	/* For statically allocated stuff */
#define PIXELS_PER_SEG		256	/* Pixels per segment */

#define OV511_ENDPOINT_ADDRESS	1	/* Isoc endpoint number */

#define OV511_NUMSBUF		2

/* Control transfers use up to 4 bytes */
#define OV511_CBUF_SIZE		4

/* Size of usb_make_path() buffer */
#define OV511_USB_PATH_LEN	64

/* --------------------------------- */
/*       MISCELLANEOUS DEFINES       */
/* --------------------------------- */

#define I2C_CLOCK_PRESCALER 	0x03

//USB驱动设置(设定设备特定特定的信息)
//USB_DRIVER_SETTINGS
#ifndef DRIVER_SETTINGS
#define DRIVER_SETTINGS \
    sizeof(USB_DRIVER_SETTINGS),  \
    USB_NO_INFO,   \
    USB_NO_INFO,   \
    USB_NO_INFO,   \
    USB_NO_INFO,   \
    USB_NO_INFO,   \
    USB_NO_INFO,   \
    USB_DEVICE_CLASS_VIDEO,   \
    USB_NO_INFO,   \
    USB_NO_INFO

#endif

typedef struct {
	USB_INTERFACE_DESCRIPTOR    ifDesc;
	BOOL                        fEndpoint;
	USB_ENDPOINT_DESCRIPTOR     epDesc;
} USBIF, *PUSBIF;

//管道结构体
typedef struct {
		USB_PIPE    hPipe;
		UCHAR       ucAddr;
		WORD        wPacketSize;
		HANDLE      hEvent;
} PIPE,*LPPIPE;    

//设备上下文结构体
typedef struct {
	HANDLE hVendorEvent;

	int nInterfaces;    //视频接口
	PUSBIF usbVideoIF;	//视频管道
	PIPE pipeVideo;
} DEVICECONTEXT, *PDEVICECONTEXT;

//驱动程序上下文结构体
typedef struct {
    DWORD dwSize;
    int nNumOpens;              //打开次数
	CRITICAL_SECTION csDCall;   //应用程序操作临界区
	HANDLE hStreamDevice;       //存储ActivateDevice返回值