1 #ifndef __LINUX_OV511_H
2 #define __LINUX_OV511_H
4 #include <asm/uaccess.h>
5 #include <linux/videodev.h>
6 #include <media/v4l2-common.h>
7 #include <media/v4l2-ioctl.h>
9 #include <linux/mutex.h>
11 #define OV511_DEBUG /* Turn on debug messages */
14 #define PDEBUG(level, fmt, args...) \
15 if (debug >= (level)) \
16 printk(KERN_INFO KBUILD_MODNAME "[%s:%d] \n" fmt, \
17 __func__, __LINE__ , ## args)
19 #define PDEBUG(level, fmt, args...) do {} while(0)
22 /* This macro restricts an int variable to an inclusive range */
23 #define RESTRICT_TO_RANGE(v,mi,ma) { \
24 if ((v) < (mi)) (v) = (mi); \
25 else if ((v) > (ma)) (v) = (ma); \
28 /* --------------------------------- */
29 /* DEFINES FOR OV511 AND OTHER CHIPS */
30 /* --------------------------------- */
33 #define VEND_OMNIVISION 0x05A9
34 #define PROD_OV511 0x0511
35 #define PROD_OV511PLUS 0xA511
36 #define PROD_OV518 0x0518
37 #define PROD_OV518PLUS 0xA518
39 #define VEND_MATTEL 0x0813
40 #define PROD_ME2CAM 0x0002
42 /* --------------------------------- */
43 /* OV51x REGISTER MNEMONICS */
44 /* --------------------------------- */
46 /* Camera interface register numbers */
47 #define R511_CAM_DELAY 0x10
48 #define R511_CAM_EDGE 0x11
49 #define R511_CAM_PXCNT 0x12
50 #define R511_CAM_LNCNT 0x13
51 #define R511_CAM_PXDIV 0x14
52 #define R511_CAM_LNDIV 0x15
53 #define R511_CAM_UV_EN 0x16
54 #define R511_CAM_LINE_MODE 0x17
55 #define R511_CAM_OPTS 0x18
57 /* Snapshot mode camera interface register numbers */
58 #define R511_SNAP_FRAME 0x19
59 #define R511_SNAP_PXCNT 0x1A
60 #define R511_SNAP_LNCNT 0x1B
61 #define R511_SNAP_PXDIV 0x1C
62 #define R511_SNAP_LNDIV 0x1D
63 #define R511_SNAP_UV_EN 0x1E
64 #define R511_SNAP_OPTS 0x1F
66 /* DRAM register numbers */
67 #define R511_DRAM_FLOW_CTL 0x20
68 #define R511_DRAM_ARCP 0x21
69 #define R511_DRAM_MRC 0x22
70 #define R511_DRAM_RFC 0x23
72 /* ISO FIFO register numbers */
73 #define R51x_FIFO_PSIZE 0x30 /* 2 bytes wide w/ OV518(+) */
74 #define R511_FIFO_OPTS 0x31
76 /* Parallel IO register numbers */
77 #define R511_PIO_OPTS 0x38
78 #define R511_PIO_DATA 0x39
79 #define R511_PIO_BIST 0x3E
80 #define R518_GPIO_IN 0x55 /* OV518(+) only */
81 #define R518_GPIO_OUT 0x56 /* OV518(+) only */
82 #define R518_GPIO_CTL 0x57 /* OV518(+) only */
83 #define R518_GPIO_PULSE_IN 0x58 /* OV518(+) only */
84 #define R518_GPIO_PULSE_CLEAR 0x59 /* OV518(+) only */
85 #define R518_GPIO_PULSE_POL 0x5a /* OV518(+) only */
86 #define R518_GPIO_PULSE_EN 0x5b /* OV518(+) only */
87 #define R518_GPIO_RESET 0x5c /* OV518(+) only */
90 #define R511_I2C_CTL 0x40
91 #define R518_I2C_CTL 0x47 /* OV518(+) only */
92 #define R51x_I2C_W_SID 0x41
93 #define R51x_I2C_SADDR_3 0x42
94 #define R51x_I2C_SADDR_2 0x43
95 #define R51x_I2C_R_SID 0x44
96 #define R51x_I2C_DATA 0x45
97 #define R51x_I2C_CLOCK 0x46
98 #define R51x_I2C_TIMEOUT 0x47
100 /* I2C snapshot registers */
101 #define R511_SI2C_SADDR_3 0x48
102 #define R511_SI2C_DATA 0x49
104 /* System control registers */
105 #define R51x_SYS_RESET 0x50
106 /* Reset type definitions */
107 #define OV511_RESET_UDC 0x01
108 #define OV511_RESET_I2C 0x02
109 #define OV511_RESET_FIFO 0x04
110 #define OV511_RESET_OMNICE 0x08
111 #define OV511_RESET_DRAM 0x10
112 #define OV511_RESET_CAM_INT 0x20
113 #define OV511_RESET_OV511 0x40
114 #define OV511_RESET_NOREGS 0x3F /* All but OV511 & regs */
115 #define OV511_RESET_ALL 0x7F
117 #define R511_SYS_CLOCK_DIV 0x51
118 #define R51x_SYS_SNAP 0x52
119 #define R51x_SYS_INIT 0x53
120 #define R511_SYS_PWR_CLK 0x54 /* OV511+/OV518(+) only */
121 #define R511_SYS_LED_CTL 0x55 /* OV511+ only */
122 #define R511_SYS_USER 0x5E
123 #define R511_SYS_CUST_ID 0x5F
125 /* OmniCE (compression) registers */
126 #define R511_COMP_PHY 0x70
127 #define R511_COMP_PHUV 0x71
128 #define R511_COMP_PVY 0x72
129 #define R511_COMP_PVUV 0x73
130 #define R511_COMP_QHY 0x74
131 #define R511_COMP_QHUV 0x75
132 #define R511_COMP_QVY 0x76
133 #define R511_COMP_QVUV 0x77
134 #define R511_COMP_EN 0x78
135 #define R511_COMP_LUT_EN 0x79
136 #define R511_COMP_LUT_BEGIN 0x80
138 /* --------------------------------- */
139 /* ALTERNATE NUMBERS */
140 /* --------------------------------- */
142 /* Alternate numbers for various max packet sizes (OV511 only) */
143 #define OV511_ALT_SIZE_992 0
144 #define OV511_ALT_SIZE_993 1
145 #define OV511_ALT_SIZE_768 2
146 #define OV511_ALT_SIZE_769 3
147 #define OV511_ALT_SIZE_512 4
148 #define OV511_ALT_SIZE_513 5
149 #define OV511_ALT_SIZE_257 6
150 #define OV511_ALT_SIZE_0 7
152 /* Alternate numbers for various max packet sizes (OV511+ only) */
153 #define OV511PLUS_ALT_SIZE_0 0
154 #define OV511PLUS_ALT_SIZE_33 1
155 #define OV511PLUS_ALT_SIZE_129 2
156 #define OV511PLUS_ALT_SIZE_257 3
157 #define OV511PLUS_ALT_SIZE_385 4
158 #define OV511PLUS_ALT_SIZE_513 5
159 #define OV511PLUS_ALT_SIZE_769 6
160 #define OV511PLUS_ALT_SIZE_961 7
162 /* Alternate numbers for various max packet sizes (OV518(+) only) */
163 #define OV518_ALT_SIZE_0 0
164 #define OV518_ALT_SIZE_128 1
165 #define OV518_ALT_SIZE_256 2
166 #define OV518_ALT_SIZE_384 3
167 #define OV518_ALT_SIZE_512 4
168 #define OV518_ALT_SIZE_640 5
169 #define OV518_ALT_SIZE_768 6
170 #define OV518_ALT_SIZE_896 7
172 /* --------------------------------- */
173 /* OV7610 REGISTER MNEMONICS */
174 /* --------------------------------- */
176 /* OV7610 registers */
177 #define OV7610_REG_GAIN 0x00 /* gain setting (5:0) */
178 #define OV7610_REG_BLUE 0x01 /* blue channel balance */
179 #define OV7610_REG_RED 0x02 /* red channel balance */
180 #define OV7610_REG_SAT 0x03 /* saturation */
182 #define OV7610_REG_CNT 0x05 /* Y contrast */
183 #define OV7610_REG_BRT 0x06 /* Y brightness */
185 #define OV7610_REG_BLUE_BIAS 0x0C /* blue channel bias (5:0) */
186 #define OV7610_REG_RED_BIAS 0x0D /* read channel bias (5:0) */
187 #define OV7610_REG_GAMMA_COEFF 0x0E /* gamma settings */
188 #define OV7610_REG_WB_RANGE 0x0F /* AEC/ALC/S-AWB settings */
189 #define OV7610_REG_EXP 0x10 /* manual exposure setting */
190 #define OV7610_REG_CLOCK 0x11 /* polarity/clock prescaler */
191 #define OV7610_REG_COM_A 0x12 /* misc common regs */
192 #define OV7610_REG_COM_B 0x13 /* misc common regs */
193 #define OV7610_REG_COM_C 0x14 /* misc common regs */
194 #define OV7610_REG_COM_D 0x15 /* misc common regs */
195 #define OV7610_REG_FIELD_DIVIDE 0x16 /* field interval/mode settings */
196 #define OV7610_REG_HWIN_START 0x17 /* horizontal window start */
197 #define OV7610_REG_HWIN_END 0x18 /* horizontal window end */
198 #define OV7610_REG_VWIN_START 0x19 /* vertical window start */
199 #define OV7610_REG_VWIN_END 0x1A /* vertical window end */
200 #define OV7610_REG_PIXEL_SHIFT 0x1B /* pixel shift */
201 #define OV7610_REG_ID_HIGH 0x1C /* manufacturer ID MSB */
202 #define OV7610_REG_ID_LOW 0x1D /* manufacturer ID LSB */
204 #define OV7610_REG_COM_E 0x20 /* misc common regs */
205 #define OV7610_REG_YOFFSET 0x21 /* Y channel offset */
206 #define OV7610_REG_UOFFSET 0x22 /* U channel offset */
208 #define OV7610_REG_ECW 0x24 /* Exposure white level for AEC */
209 #define OV7610_REG_ECB 0x25 /* Exposure black level for AEC */
210 #define OV7610_REG_COM_F 0x26 /* misc settings */
211 #define OV7610_REG_COM_G 0x27 /* misc settings */
212 #define OV7610_REG_COM_H 0x28 /* misc settings */
213 #define OV7610_REG_COM_I 0x29 /* misc settings */
214 #define OV7610_REG_FRAMERATE_H 0x2A /* frame rate MSB + misc */
215 #define OV7610_REG_FRAMERATE_L 0x2B /* frame rate LSB */
216 #define OV7610_REG_ALC 0x2C /* Auto Level Control settings */
217 #define OV7610_REG_COM_J 0x2D /* misc settings */
218 #define OV7610_REG_VOFFSET 0x2E /* V channel offset adjustment */
219 #define OV7610_REG_ARRAY_BIAS 0x2F /* Array bias -- don't change */
221 #define OV7610_REG_YGAMMA 0x33 /* misc gamma settings (7:6) */
222 #define OV7610_REG_BIAS_ADJUST 0x34 /* misc bias settings */
223 #define OV7610_REG_COM_L 0x35 /* misc settings */
225 #define OV7610_REG_COM_K 0x38 /* misc registers */
227 /* --------------------------------- */
229 /* --------------------------------- */
231 #define OV7xx0_SID 0x42
232 #define OV6xx0_SID 0xC0
233 #define OV8xx0_SID 0xA0
234 #define KS0127_SID 0xD8
235 #define SAA7111A_SID 0x48
237 /* --------------------------------- */
238 /* MISCELLANEOUS DEFINES */
239 /* --------------------------------- */
241 #define I2C_CLOCK_PRESCALER 0x03
243 #define FRAMES_PER_DESC 10 /* FIXME - What should this be? */
244 #define MAX_FRAME_SIZE_PER_DESC 993 /* For statically allocated stuff */
245 #define PIXELS_PER_SEG 256 /* Pixels per segment */
247 #define OV511_ENDPOINT_ADDRESS 1 /* Isoc endpoint number */
249 #define OV511_NUMFRAMES 2
250 #if OV511_NUMFRAMES > VIDEO_MAX_FRAME
251 #error "OV511_NUMFRAMES is too high"
254 #define OV511_NUMSBUF 2
256 /* Control transfers use up to 4 bytes */
257 #define OV511_CBUF_SIZE 4
259 /* Size of usb_make_path() buffer */
260 #define OV511_USB_PATH_LEN 64
296 STATE_SCANNING
, /* Scanning for start */
297 STATE_HEADER
, /* Parsing header */
298 STATE_LINES
, /* Parsing lines */
307 /* --------- Definition of ioctl interface --------- */
309 #define OV511_INTERFACE_VER 101
318 /* Raw frame formats */
327 struct ov511_i2c_struct
{
328 unsigned char slave
; /* Write slave ID (read ID - 1) */
329 unsigned char reg
; /* Index of register */
330 unsigned char value
; /* User sets this w/ write, driver does w/ read */
331 unsigned char mask
; /* Bits to be changed. Not used with read ops */
335 #define OV511IOC_WI2C _IOW('v', BASE_VIDIOCPRIVATE + 5, \
336 struct ov511_i2c_struct)
337 #define OV511IOC_RI2C _IOWR('v', BASE_VIDIOCPRIVATE + 6, \
338 struct ov511_i2c_struct)
339 /* ------------- End IOCTL interface -------------- */
341 struct usb_ov511
; /* Forward declaration */
344 struct usb_ov511
*ov
;
352 FRAME_UNUSED
, /* Unused (no MCAPTURE) */
353 FRAME_READY
, /* Ready to start grabbing */
354 FRAME_GRABBING
, /* In the process of being grabbed into */
355 FRAME_DONE
, /* Finished grabbing, but not been synced yet */
356 FRAME_ERROR
, /* Something bad happened while processing */
359 struct ov511_regvals
{
370 int framenum
; /* Index of this frame */
371 unsigned char *data
; /* Frame buffer */
372 unsigned char *tempdata
; /* Temp buffer for multi-stage conversions */
373 unsigned char *rawdata
; /* Raw camera data buffer */
374 unsigned char *compbuf
; /* Temp buffer for decompressor */
376 int depth
; /* Bytes per pixel */
377 int width
; /* Width application is expecting */
378 int height
; /* Height application is expecting */
380 int rawwidth
; /* Actual width of frame sent from camera */
381 int rawheight
; /* Actual height of frame sent from camera */
383 int sub_flag
; /* Sub-capture mode for this frame? */
384 unsigned int format
; /* Format for this frame */
385 int compressed
; /* Is frame compressed? */
387 volatile int grabstate
; /* State of grabbing */
388 int scanstate
; /* State of scanning */
390 int bytes_recvd
; /* Number of image bytes received from camera */
392 long bytes_read
; /* Amount that has been read() */
394 wait_queue_head_t wq
; /* Processes waiting */
396 int snapshot
; /* True if frame was a snapshot */
399 #define DECOMP_INTERFACE_VER 4
401 /* Compression module operations */
402 struct ov51x_decomp_ops
{
403 int (*decomp_400
)(unsigned char *, unsigned char *, unsigned char *,
405 int (*decomp_420
)(unsigned char *, unsigned char *, unsigned char *,
407 int (*decomp_422
)(unsigned char *, unsigned char *, unsigned char *,
409 struct module
*owner
;
413 struct video_device
*vdev
;
414 struct usb_device
*dev
;
419 char usb_path
[OV511_USB_PATH_LEN
];
421 /* Determined by sensor type */
433 int auto_brt
; /* Auto brightness enabled flag */
434 int auto_gain
; /* Auto gain control enabled flag */
435 int auto_exp
; /* Auto exposure enabled flag */
436 int backlight
; /* Backlight exposure algorithm flag */
437 int mirror
; /* Image is reversed horizontally */
439 int led_policy
; /* LED: off|on|auto; OV511+ only */
441 struct mutex lock
; /* Serializes user-accessible operations */
442 int user
; /* user count for exclusive use */
444 int streaming
; /* Are we streaming Isochronous? */
445 int grabbing
; /* Are we grabbing? */
447 int compress
; /* Should the next frame be compressed? */
448 int compress_inited
; /* Are compression params uploaded? */
450 int lightfreq
; /* Power (lighting) frequency */
451 int bandfilt
; /* Banding filter enabled flag */
453 unsigned char *fbuf
; /* Videodev buffer area */
454 unsigned char *tempfbuf
; /* Temporary (intermediate) buffer area */
455 unsigned char *rawfbuf
; /* Raw camera data buffer area */
457 int sub_flag
; /* Pix Array subcapture on flag */
458 int subx
; /* Pix Array subcapture x offset */
459 int suby
; /* Pix Array subcapture y offset */
460 int subw
; /* Pix Array subcapture width */
461 int subh
; /* Pix Array subcapture height */
463 int curframe
; /* Current receiving sbuf */
464 struct ov511_frame frame
[OV511_NUMFRAMES
];
466 struct ov511_sbuf sbuf
[OV511_NUMSBUF
];
468 wait_queue_head_t wq
; /* Processes waiting */
470 int snap_enabled
; /* Snapshot mode enabled */
472 int bridge
; /* Type of bridge (BRG_*) */
473 int bclass
; /* Class of bridge (BCL_*) */
474 int sensor
; /* Type of image sensor chip (SEN_*) */
476 int packet_size
; /* Frame size per isoc desc */
477 int packet_numbering
; /* Is ISO frame numbering enabled? */
479 /* Framebuffer/sbuf management */
481 struct mutex buf_lock
;
483 struct ov51x_decomp_ops
*decomp_ops
;
485 /* Stop streaming while changing picture settings */
488 int stopped
; /* Streaming is temporarily paused */
490 /* Video decoder stuff */
491 int input
; /* Composite, S-VIDEO, etc... */
492 int num_inputs
; /* Number of inputs */
493 int norm
; /* NTSC / PAL / SECAM */
494 int has_decoder
; /* Device has a video decoder */
495 int pal
; /* Device is designed for PAL resolution */
497 /* ov511 device number ID */
498 int nr
; /* Stores a device number */
501 struct mutex i2c_lock
; /* Protect I2C controller regs */
502 unsigned char primary_i2c_slave
; /* I2C write id of sensor */
504 /* Control transaction stuff */
505 unsigned char *cbuf
; /* Buffer for payload */
506 struct mutex cbuf_lock
;
509 /* Used to represent a list of values and their respective symbolic names */
510 struct symbolic_list
{
515 #define NOT_DEFINED_STR "Unknown"
517 /* Returns the name of the matching element in the symbolic_list array. The
518 * end of the list must be marked with an element that has a NULL name.
521 symbolic(struct symbolic_list list
[], int num
)
525 for (i
= 0; list
[i
].name
!= NULL
; i
++)
526 if (list
[i
].num
== num
)
527 return (list
[i
].name
);
529 return (NOT_DEFINED_STR
);
532 /* Compression stuff */
534 #define OV511_QUANTABLESIZE 64
535 #define OV518_QUANTABLESIZE 32
537 #define OV511_YQUANTABLE { \
538 0, 1, 1, 2, 2, 3, 3, 4, \
539 1, 1, 1, 2, 2, 3, 4, 4, \
540 1, 1, 2, 2, 3, 4, 4, 4, \
541 2, 2, 2, 3, 4, 4, 4, 4, \
542 2, 2, 3, 4, 4, 5, 5, 5, \
543 3, 3, 4, 4, 5, 5, 5, 5, \
544 3, 4, 4, 4, 5, 5, 5, 5, \
545 4, 4, 4, 4, 5, 5, 5, 5 \
548 #define OV511_UVQUANTABLE { \
549 0, 2, 2, 3, 4, 4, 4, 4, \
550 2, 2, 2, 4, 4, 4, 4, 4, \
551 2, 2, 3, 4, 4, 4, 4, 4, \
552 3, 4, 4, 4, 4, 4, 4, 4, \
553 4, 4, 4, 4, 4, 4, 4, 4, \
554 4, 4, 4, 4, 4, 4, 4, 4, \
555 4, 4, 4, 4, 4, 4, 4, 4, \
556 4, 4, 4, 4, 4, 4, 4, 4 \
559 #define OV518_YQUANTABLE { \
560 5, 4, 5, 6, 6, 7, 7, 7, \
561 5, 5, 5, 5, 6, 7, 7, 7, \
562 6, 6, 6, 6, 7, 7, 7, 8, \
563 7, 7, 6, 7, 7, 7, 8, 8 \
566 #define OV518_UVQUANTABLE { \
567 6, 6, 6, 7, 7, 7, 7, 7, \
568 6, 6, 6, 7, 7, 7, 7, 7, \
569 6, 6, 6, 7, 7, 7, 7, 8, \
570 7, 7, 7, 7, 7, 7, 8, 8 \