Merge branch 'master' of master.kernel.org:/pub/scm/linux/kernel/git/mchehab/v4l-dvb
[linux-2.6] / drivers / media / video / ov7670.c
1 /*
2  * A V4L2 driver for OmniVision OV7670 cameras.
3  *
4  * Copyright 2006 One Laptop Per Child Association, Inc.  Written
5  * by Jonathan Corbet with substantial inspiration from Mark
6  * McClelland's ovcamchip code.
7  *
8  * This file may be distributed under the terms of the GNU General
9  * Public License, version 2.
10  */
11 #include <linux/init.h>
12 #include <linux/module.h>
13 #include <linux/moduleparam.h>
14 #include <linux/slab.h>
15 #include <linux/delay.h>
16 #include <linux/videodev.h>
17 #include <media/v4l2-common.h>
18 #include <linux/i2c.h>
19
20
21 MODULE_AUTHOR("Jonathan Corbet <corbet@lwn.net.");
22 MODULE_DESCRIPTION("A low-level driver for OmniVision ov7670 sensors");
23 MODULE_LICENSE("GPL");
24
25 /*
26  * Basic window sizes.  These probably belong somewhere more globally
27  * useful.
28  */
29 #define VGA_WIDTH       640
30 #define VGA_HEIGHT      480
31 #define QVGA_WIDTH      320
32 #define QVGA_HEIGHT     240
33 #define CIF_WIDTH       352
34 #define CIF_HEIGHT      288
35 #define QCIF_WIDTH      176
36 #define QCIF_HEIGHT     144
37
38 /*
39  * Our nominal (default) frame rate.
40  */
41 #define OV7670_FRAME_RATE 30
42
43 /*
44  * The 7670 sits on i2c with ID 0x42
45  */
46 #define OV7670_I2C_ADDR 0x42
47
48 /* Registers */
49 #define REG_GAIN        0x00    /* Gain lower 8 bits (rest in vref) */
50 #define REG_BLUE        0x01    /* blue gain */
51 #define REG_RED         0x02    /* red gain */
52 #define REG_VREF        0x03    /* Pieces of GAIN, VSTART, VSTOP */
53 #define REG_COM1        0x04    /* Control 1 */
54 #define  COM1_CCIR656     0x40  /* CCIR656 enable */
55 #define REG_BAVE        0x05    /* U/B Average level */
56 #define REG_GbAVE       0x06    /* Y/Gb Average level */
57 #define REG_AECHH       0x07    /* AEC MS 5 bits */
58 #define REG_RAVE        0x08    /* V/R Average level */
59 #define REG_COM2        0x09    /* Control 2 */
60 #define  COM2_SSLEEP      0x10  /* Soft sleep mode */
61 #define REG_PID         0x0a    /* Product ID MSB */
62 #define REG_VER         0x0b    /* Product ID LSB */
63 #define REG_COM3        0x0c    /* Control 3 */
64 #define  COM3_SWAP        0x40    /* Byte swap */
65 #define  COM3_SCALEEN     0x08    /* Enable scaling */
66 #define  COM3_DCWEN       0x04    /* Enable downsamp/crop/window */
67 #define REG_COM4        0x0d    /* Control 4 */
68 #define REG_COM5        0x0e    /* All "reserved" */
69 #define REG_COM6        0x0f    /* Control 6 */
70 #define REG_AECH        0x10    /* More bits of AEC value */
71 #define REG_CLKRC       0x11    /* Clocl control */
72 #define   CLK_EXT         0x40    /* Use external clock directly */
73 #define   CLK_SCALE       0x3f    /* Mask for internal clock scale */
74 #define REG_COM7        0x12    /* Control 7 */
75 #define   COM7_RESET      0x80    /* Register reset */
76 #define   COM7_FMT_MASK   0x38
77 #define   COM7_FMT_VGA    0x00
78 #define   COM7_FMT_CIF    0x20    /* CIF format */
79 #define   COM7_FMT_QVGA   0x10    /* QVGA format */
80 #define   COM7_FMT_QCIF   0x08    /* QCIF format */
81 #define   COM7_RGB        0x04    /* bits 0 and 2 - RGB format */
82 #define   COM7_YUV        0x00    /* YUV */
83 #define   COM7_BAYER      0x01    /* Bayer format */
84 #define   COM7_PBAYER     0x05    /* "Processed bayer" */
85 #define REG_COM8        0x13    /* Control 8 */
86 #define   COM8_FASTAEC    0x80    /* Enable fast AGC/AEC */
87 #define   COM8_AECSTEP    0x40    /* Unlimited AEC step size */
88 #define   COM8_BFILT      0x20    /* Band filter enable */
89 #define   COM8_AGC        0x04    /* Auto gain enable */
90 #define   COM8_AWB        0x02    /* White balance enable */
91 #define   COM8_AEC        0x01    /* Auto exposure enable */
92 #define REG_COM9        0x14    /* Control 9  - gain ceiling */
93 #define REG_COM10       0x15    /* Control 10 */
94 #define   COM10_HSYNC     0x40    /* HSYNC instead of HREF */
95 #define   COM10_PCLK_HB   0x20    /* Suppress PCLK on horiz blank */
96 #define   COM10_HREF_REV  0x08    /* Reverse HREF */
97 #define   COM10_VS_LEAD   0x04    /* VSYNC on clock leading edge */
98 #define   COM10_VS_NEG    0x02    /* VSYNC negative */
99 #define   COM10_HS_NEG    0x01    /* HSYNC negative */
100 #define REG_HSTART      0x17    /* Horiz start high bits */
101 #define REG_HSTOP       0x18    /* Horiz stop high bits */
102 #define REG_VSTART      0x19    /* Vert start high bits */
103 #define REG_VSTOP       0x1a    /* Vert stop high bits */
104 #define REG_PSHFT       0x1b    /* Pixel delay after HREF */
105 #define REG_MIDH        0x1c    /* Manuf. ID high */
106 #define REG_MIDL        0x1d    /* Manuf. ID low */
107 #define REG_MVFP        0x1e    /* Mirror / vflip */
108 #define   MVFP_MIRROR     0x20    /* Mirror image */
109 #define   MVFP_FLIP       0x10    /* Vertical flip */
110
111 #define REG_AEW         0x24    /* AGC upper limit */
112 #define REG_AEB         0x25    /* AGC lower limit */
113 #define REG_VPT         0x26    /* AGC/AEC fast mode op region */
114 #define REG_HSYST       0x30    /* HSYNC rising edge delay */
115 #define REG_HSYEN       0x31    /* HSYNC falling edge delay */
116 #define REG_HREF        0x32    /* HREF pieces */
117 #define REG_TSLB        0x3a    /* lots of stuff */
118 #define   TSLB_YLAST      0x04    /* UYVY or VYUY - see com13 */
119 #define REG_COM11       0x3b    /* Control 11 */
120 #define   COM11_NIGHT     0x80    /* NIght mode enable */
121 #define   COM11_NMFR      0x60    /* Two bit NM frame rate */
122 #define   COM11_HZAUTO    0x10    /* Auto detect 50/60 Hz */
123 #define   COM11_50HZ      0x08    /* Manual 50Hz select */
124 #define   COM11_EXP       0x02
125 #define REG_COM12       0x3c    /* Control 12 */
126 #define   COM12_HREF      0x80    /* HREF always */
127 #define REG_COM13       0x3d    /* Control 13 */
128 #define   COM13_GAMMA     0x80    /* Gamma enable */
129 #define   COM13_UVSAT     0x40    /* UV saturation auto adjustment */
130 #define   COM13_UVSWAP    0x01    /* V before U - w/TSLB */
131 #define REG_COM14       0x3e    /* Control 14 */
132 #define   COM14_DCWEN     0x10    /* DCW/PCLK-scale enable */
133 #define REG_EDGE        0x3f    /* Edge enhancement factor */
134 #define REG_COM15       0x40    /* Control 15 */
135 #define   COM15_R10F0     0x00    /* Data range 10 to F0 */
136 #define   COM15_R01FE     0x80    /*            01 to FE */
137 #define   COM15_R00FF     0xc0    /*            00 to FF */
138 #define   COM15_RGB565    0x10    /* RGB565 output */
139 #define   COM15_RGB555    0x30    /* RGB555 output */
140 #define REG_COM16       0x41    /* Control 16 */
141 #define   COM16_AWBGAIN   0x08    /* AWB gain enable */
142 #define REG_COM17       0x42    /* Control 17 */
143 #define   COM17_AECWIN    0xc0    /* AEC window - must match COM4 */
144 #define   COM17_CBAR      0x08    /* DSP Color bar */
145
146 /*
147  * This matrix defines how the colors are generated, must be
148  * tweaked to adjust hue and saturation.
149  *
150  * Order: v-red, v-green, v-blue, u-red, u-green, u-blue
151  *
152  * They are nine-bit signed quantities, with the sign bit
153  * stored in 0x58.  Sign for v-red is bit 0, and up from there.
154  */
155 #define REG_CMATRIX_BASE 0x4f
156 #define   CMATRIX_LEN 6
157 #define REG_CMATRIX_SIGN 0x58
158
159
160 #define REG_BRIGHT      0x55    /* Brightness */
161 #define REG_CONTRAS     0x56    /* Contrast control */
162
163 #define REG_GFIX        0x69    /* Fix gain control */
164
165 #define REG_RGB444      0x8c    /* RGB 444 control */
166 #define   R444_ENABLE     0x02    /* Turn on RGB444, overrides 5x5 */
167 #define   R444_RGBX       0x01    /* Empty nibble at end */
168
169 #define REG_HAECC1      0x9f    /* Hist AEC/AGC control 1 */
170 #define REG_HAECC2      0xa0    /* Hist AEC/AGC control 2 */
171
172 #define REG_BD50MAX     0xa5    /* 50hz banding step limit */
173 #define REG_HAECC3      0xa6    /* Hist AEC/AGC control 3 */
174 #define REG_HAECC4      0xa7    /* Hist AEC/AGC control 4 */
175 #define REG_HAECC5      0xa8    /* Hist AEC/AGC control 5 */
176 #define REG_HAECC6      0xa9    /* Hist AEC/AGC control 6 */
177 #define REG_HAECC7      0xaa    /* Hist AEC/AGC control 7 */
178 #define REG_BD60MAX     0xab    /* 60hz banding step limit */
179
180
181 /*
182  * Information we maintain about a known sensor.
183  */
184 struct ov7670_format_struct;  /* coming later */
185 struct ov7670_info {
186         struct ov7670_format_struct *fmt;  /* Current format */
187         unsigned char sat;              /* Saturation value */
188         int hue;                        /* Hue value */
189 };
190
191
192
193
194 /*
195  * The default register settings, as obtained from OmniVision.  There
196  * is really no making sense of most of these - lots of "reserved" values
197  * and such.
198  *
199  * These settings give VGA YUYV.
200  */
201
202 struct regval_list {
203         unsigned char reg_num;
204         unsigned char value;
205 };
206
207 static struct regval_list ov7670_default_regs[] = {
208         { REG_COM7, COM7_RESET },
209 /*
210  * Clock scale: 3 = 15fps
211  *              2 = 20fps
212  *              1 = 30fps
213  */
214         { REG_CLKRC, 0x1 },     /* OV: clock scale (30 fps) */
215         { REG_TSLB,  0x04 },    /* OV */
216         { REG_COM7, 0 },        /* VGA */
217         /*
218          * Set the hardware window.  These values from OV don't entirely
219          * make sense - hstop is less than hstart.  But they work...
220          */
221         { REG_HSTART, 0x13 },   { REG_HSTOP, 0x01 },
222         { REG_HREF, 0xb6 },     { REG_VSTART, 0x02 },
223         { REG_VSTOP, 0x7a },    { REG_VREF, 0x0a },
224
225         { REG_COM3, 0 },        { REG_COM14, 0 },
226         /* Mystery scaling numbers */
227         { 0x70, 0x3a },         { 0x71, 0x35 },
228         { 0x72, 0x11 },         { 0x73, 0xf0 },
229         { 0xa2, 0x02 },         { REG_COM10, 0x0 },
230
231         /* Gamma curve values */
232         { 0x7a, 0x20 },         { 0x7b, 0x10 },
233         { 0x7c, 0x1e },         { 0x7d, 0x35 },
234         { 0x7e, 0x5a },         { 0x7f, 0x69 },
235         { 0x80, 0x76 },         { 0x81, 0x80 },
236         { 0x82, 0x88 },         { 0x83, 0x8f },
237         { 0x84, 0x96 },         { 0x85, 0xa3 },
238         { 0x86, 0xaf },         { 0x87, 0xc4 },
239         { 0x88, 0xd7 },         { 0x89, 0xe8 },
240
241         /* AGC and AEC parameters.  Note we start by disabling those features,
242            then turn them only after tweaking the values. */
243         { REG_COM8, COM8_FASTAEC | COM8_AECSTEP | COM8_BFILT },
244         { REG_GAIN, 0 },        { REG_AECH, 0 },
245         { REG_COM4, 0x40 }, /* magic reserved bit */
246         { REG_COM9, 0x18 }, /* 4x gain + magic rsvd bit */
247         { REG_BD50MAX, 0x05 },  { REG_BD60MAX, 0x07 },
248         { REG_AEW, 0x95 },      { REG_AEB, 0x33 },
249         { REG_VPT, 0xe3 },      { REG_HAECC1, 0x78 },
250         { REG_HAECC2, 0x68 },   { 0xa1, 0x03 }, /* magic */
251         { REG_HAECC3, 0xd8 },   { REG_HAECC4, 0xd8 },
252         { REG_HAECC5, 0xf0 },   { REG_HAECC6, 0x90 },
253         { REG_HAECC7, 0x94 },
254         { REG_COM8, COM8_FASTAEC|COM8_AECSTEP|COM8_BFILT|COM8_AGC|COM8_AEC },
255
256         /* Almost all of these are magic "reserved" values.  */
257         { REG_COM5, 0x61 },     { REG_COM6, 0x4b },
258         { 0x16, 0x02 },         { REG_MVFP, 0x07|MVFP_MIRROR },
259         { 0x21, 0x02 },         { 0x22, 0x91 },
260         { 0x29, 0x07 },         { 0x33, 0x0b },
261         { 0x35, 0x0b },         { 0x37, 0x1d },
262         { 0x38, 0x71 },         { 0x39, 0x2a },
263         { REG_COM12, 0x78 },    { 0x4d, 0x40 },
264         { 0x4e, 0x20 },         { REG_GFIX, 0 },
265         { 0x6b, 0x4a },         { 0x74, 0x10 },
266         { 0x8d, 0x4f },         { 0x8e, 0 },
267         { 0x8f, 0 },            { 0x90, 0 },
268         { 0x91, 0 },            { 0x96, 0 },
269         { 0x9a, 0 },            { 0xb0, 0x84 },
270         { 0xb1, 0x0c },         { 0xb2, 0x0e },
271         { 0xb3, 0x82 },         { 0xb8, 0x0a },
272
273         /* More reserved magic, some of which tweaks white balance */
274         { 0x43, 0x0a },         { 0x44, 0xf0 },
275         { 0x45, 0x34 },         { 0x46, 0x58 },
276         { 0x47, 0x28 },         { 0x48, 0x3a },
277         { 0x59, 0x88 },         { 0x5a, 0x88 },
278         { 0x5b, 0x44 },         { 0x5c, 0x67 },
279         { 0x5d, 0x49 },         { 0x5e, 0x0e },
280         { 0x6c, 0x0a },         { 0x6d, 0x55 },
281         { 0x6e, 0x11 },         { 0x6f, 0x9f }, /* "9e for advance AWB" */
282         { 0x6a, 0x40 },         { REG_BLUE, 0x40 },
283         { REG_RED, 0x60 },
284         { REG_COM8, COM8_FASTAEC|COM8_AECSTEP|COM8_BFILT|COM8_AGC|COM8_AEC|COM8_AWB },
285
286         /* Matrix coefficients */
287         { 0x4f, 0x80 },         { 0x50, 0x80 },
288         { 0x51, 0 },            { 0x52, 0x22 },
289         { 0x53, 0x5e },         { 0x54, 0x80 },
290         { 0x58, 0x9e },
291
292         { REG_COM16, COM16_AWBGAIN },   { REG_EDGE, 0 },
293         { 0x75, 0x05 },         { 0x76, 0xe1 },
294         { 0x4c, 0 },            { 0x77, 0x01 },
295         { REG_COM13, 0xc3 },    { 0x4b, 0x09 },
296         { 0xc9, 0x60 },         { REG_COM16, 0x38 },
297         { 0x56, 0x40 },
298
299         { 0x34, 0x11 },         { REG_COM11, COM11_EXP|COM11_HZAUTO },
300         { 0xa4, 0x88 },         { 0x96, 0 },
301         { 0x97, 0x30 },         { 0x98, 0x20 },
302         { 0x99, 0x30 },         { 0x9a, 0x84 },
303         { 0x9b, 0x29 },         { 0x9c, 0x03 },
304         { 0x9d, 0x4c },         { 0x9e, 0x3f },
305         { 0x78, 0x04 },
306
307         /* Extra-weird stuff.  Some sort of multiplexor register */
308         { 0x79, 0x01 },         { 0xc8, 0xf0 },
309         { 0x79, 0x0f },         { 0xc8, 0x00 },
310         { 0x79, 0x10 },         { 0xc8, 0x7e },
311         { 0x79, 0x0a },         { 0xc8, 0x80 },
312         { 0x79, 0x0b },         { 0xc8, 0x01 },
313         { 0x79, 0x0c },         { 0xc8, 0x0f },
314         { 0x79, 0x0d },         { 0xc8, 0x20 },
315         { 0x79, 0x09 },         { 0xc8, 0x80 },
316         { 0x79, 0x02 },         { 0xc8, 0xc0 },
317         { 0x79, 0x03 },         { 0xc8, 0x40 },
318         { 0x79, 0x05 },         { 0xc8, 0x30 },
319         { 0x79, 0x26 },
320
321         { 0xff, 0xff }, /* END MARKER */
322 };
323
324
325 /*
326  * Here we'll try to encapsulate the changes for just the output
327  * video format.
328  *
329  * RGB656 and YUV422 come from OV; RGB444 is homebrewed.
330  *
331  * IMPORTANT RULE: the first entry must be for COM7, see ov7670_s_fmt for why.
332  */
333
334
335 static struct regval_list ov7670_fmt_yuv422[] = {
336         { REG_COM7, 0x0 },  /* Selects YUV mode */
337         { REG_RGB444, 0 },      /* No RGB444 please */
338         { REG_COM1, 0 },
339         { REG_COM15, COM15_R00FF },
340         { REG_COM9, 0x18 }, /* 4x gain ceiling; 0x8 is reserved bit */
341         { 0x4f, 0x80 },         /* "matrix coefficient 1" */
342         { 0x50, 0x80 },         /* "matrix coefficient 2" */
343         { 0x51, 0    },         /* vb */
344         { 0x52, 0x22 },         /* "matrix coefficient 4" */
345         { 0x53, 0x5e },         /* "matrix coefficient 5" */
346         { 0x54, 0x80 },         /* "matrix coefficient 6" */
347         { REG_COM13, COM13_GAMMA|COM13_UVSAT },
348         { 0xff, 0xff },
349 };
350
351 static struct regval_list ov7670_fmt_rgb565[] = {
352         { REG_COM7, COM7_RGB }, /* Selects RGB mode */
353         { REG_RGB444, 0 },      /* No RGB444 please */
354         { REG_COM1, 0x0 },
355         { REG_COM15, COM15_RGB565 },
356         { REG_COM9, 0x38 },     /* 16x gain ceiling; 0x8 is reserved bit */
357         { 0x4f, 0xb3 },         /* "matrix coefficient 1" */
358         { 0x50, 0xb3 },         /* "matrix coefficient 2" */
359         { 0x51, 0    },         /* vb */
360         { 0x52, 0x3d },         /* "matrix coefficient 4" */
361         { 0x53, 0xa7 },         /* "matrix coefficient 5" */
362         { 0x54, 0xe4 },         /* "matrix coefficient 6" */
363         { REG_COM13, COM13_GAMMA|COM13_UVSAT },
364         { 0xff, 0xff },
365 };
366
367 static struct regval_list ov7670_fmt_rgb444[] = {
368         { REG_COM7, COM7_RGB }, /* Selects RGB mode */
369         { REG_RGB444, R444_ENABLE },    /* Enable xxxxrrrr ggggbbbb */
370         { REG_COM1, 0x40 },     /* Magic reserved bit */
371         { REG_COM15, COM15_R01FE|COM15_RGB565 }, /* Data range needed? */
372         { REG_COM9, 0x38 },     /* 16x gain ceiling; 0x8 is reserved bit */
373         { 0x4f, 0xb3 },         /* "matrix coefficient 1" */
374         { 0x50, 0xb3 },         /* "matrix coefficient 2" */
375         { 0x51, 0    },         /* vb */
376         { 0x52, 0x3d },         /* "matrix coefficient 4" */
377         { 0x53, 0xa7 },         /* "matrix coefficient 5" */
378         { 0x54, 0xe4 },         /* "matrix coefficient 6" */
379         { REG_COM13, COM13_GAMMA|COM13_UVSAT|0x2 },  /* Magic rsvd bit */
380         { 0xff, 0xff },
381 };
382
383
384
385
386 /*
387  * Low-level register I/O.
388  */
389
390 static int ov7670_read(struct i2c_client *c, unsigned char reg,
391                 unsigned char *value)
392 {
393         int ret;
394
395         ret = i2c_smbus_read_byte_data(c, reg);
396         if (ret >= 0)
397                 *value = (unsigned char) ret;
398         return ret;
399 }
400
401
402 static int ov7670_write(struct i2c_client *c, unsigned char reg,
403                 unsigned char value)
404 {
405         return i2c_smbus_write_byte_data(c, reg, value);
406 }
407
408
409 /*
410  * Write a list of register settings; ff/ff stops the process.
411  */
412 static int ov7670_write_array(struct i2c_client *c, struct regval_list *vals)
413 {
414         while (vals->reg_num != 0xff || vals->value != 0xff) {
415                 int ret = ov7670_write(c, vals->reg_num, vals->value);
416                 if (ret < 0)
417                         return ret;
418                 vals++;
419         }
420         return 0;
421 }
422
423
424 /*
425  * Stuff that knows about the sensor.
426  */
427 static void ov7670_reset(struct i2c_client *client)
428 {
429         ov7670_write(client, REG_COM7, COM7_RESET);
430         msleep(1);
431 }
432
433
434 static int ov7670_init(struct i2c_client *client)
435 {
436         return ov7670_write_array(client, ov7670_default_regs);
437 }
438
439
440
441 static int ov7670_detect(struct i2c_client *client)
442 {
443         unsigned char v;
444         int ret;
445
446         ret = ov7670_init(client);
447         if (ret < 0)
448                 return ret;
449         ret = ov7670_read(client, REG_MIDH, &v);
450         if (ret < 0)
451                 return ret;
452         if (v != 0x7f) /* OV manuf. id. */
453                 return -ENODEV;
454         ret = ov7670_read(client, REG_MIDL, &v);
455         if (ret < 0)
456                 return ret;
457         if (v != 0xa2)
458                 return -ENODEV;
459         /*
460          * OK, we know we have an OmniVision chip...but which one?
461          */
462         ret = ov7670_read(client, REG_PID, &v);
463         if (ret < 0)
464                 return ret;
465         if (v != 0x76)  /* PID + VER = 0x76 / 0x73 */
466                 return -ENODEV;
467         ret = ov7670_read(client, REG_VER, &v);
468         if (ret < 0)
469                 return ret;
470         if (v != 0x73)  /* PID + VER = 0x76 / 0x73 */
471                 return -ENODEV;
472         return 0;
473 }
474
475
476 /*
477  * Store information about the video data format.  The color matrix
478  * is deeply tied into the format, so keep the relevant values here.
479  * The magic matrix nubmers come from OmniVision.
480  */
481 static struct ov7670_format_struct {
482         __u8 *desc;
483         __u32 pixelformat;
484         struct regval_list *regs;
485         int cmatrix[CMATRIX_LEN];
486 } ov7670_formats[] = {
487         {
488                 .desc           = "YUYV 4:2:2",
489                 .pixelformat    = V4L2_PIX_FMT_YUYV,
490                 .regs           = ov7670_fmt_yuv422,
491                 .cmatrix        = { 128, -128, 0, -34, -94, 128 },
492         },
493         {
494                 .desc           = "RGB 444",
495                 .pixelformat    = V4L2_PIX_FMT_RGB444,
496                 .regs           = ov7670_fmt_rgb444,
497                 .cmatrix        = { 179, -179, 0, -61, -176, 228 },
498         },
499         {
500                 .desc           = "RGB 565",
501                 .pixelformat    = V4L2_PIX_FMT_RGB565,
502                 .regs           = ov7670_fmt_rgb565,
503                 .cmatrix        = { 179, -179, 0, -61, -176, 228 },
504         },
505 };
506 #define N_OV7670_FMTS (sizeof(ov7670_formats)/sizeof(ov7670_formats[0]))
507
508 /*
509  * All formats we support are 2 bytes/pixel.
510  */
511 #define BYTES_PER_PIXEL 2
512
513 /*
514  * Then there is the issue of window sizes.  Try to capture the info here.
515  */
516
517 /*
518  * QCIF mode is done (by OV) in a very strange way - it actually looks like
519  * VGA with weird scaling options - they do *not* use the canned QCIF mode
520  * which is allegedly provided by the sensor.  So here's the weird register
521  * settings.
522  */
523 static struct regval_list ov7670_qcif_regs[] = {
524         { REG_COM3, COM3_SCALEEN|COM3_DCWEN },
525         { REG_COM3, COM3_DCWEN },
526         { REG_COM14, COM14_DCWEN | 0x01},
527         { 0x73, 0xf1 },
528         { 0xa2, 0x52 },
529         { 0x7b, 0x1c },
530         { 0x7c, 0x28 },
531         { 0x7d, 0x3c },
532         { 0x7f, 0x69 },
533         { REG_COM9, 0x38 },
534         { 0xa1, 0x0b },
535         { 0x74, 0x19 },
536         { 0x9a, 0x80 },
537         { 0x43, 0x14 },
538         { REG_COM13, 0xc0 },
539         { 0xff, 0xff },
540 };
541
542 static struct ov7670_win_size {
543         int     width;
544         int     height;
545         unsigned char com7_bit;
546         int     hstart;         /* Start/stop values for the camera.  Note */
547         int     hstop;          /* that they do not always make complete */
548         int     vstart;         /* sense to humans, but evidently the sensor */
549         int     vstop;          /* will do the right thing... */
550         struct regval_list *regs; /* Regs to tweak */
551 /* h/vref stuff */
552 } ov7670_win_sizes[] = {
553         /* VGA */
554         {
555                 .width          = VGA_WIDTH,
556                 .height         = VGA_HEIGHT,
557                 .com7_bit       = COM7_FMT_VGA,
558                 .hstart         = 158,          /* These values from */
559                 .hstop          =  14,          /* Omnivision */
560                 .vstart         =  10,
561                 .vstop          = 490,
562                 .regs           = NULL,
563         },
564         /* CIF */
565         {
566                 .width          = CIF_WIDTH,
567                 .height         = CIF_HEIGHT,
568                 .com7_bit       = COM7_FMT_CIF,
569                 .hstart         = 170,          /* Empirically determined */
570                 .hstop          =  90,
571                 .vstart         =  14,
572                 .vstop          = 494,
573                 .regs           = NULL,
574         },
575         /* QVGA */
576         {
577                 .width          = QVGA_WIDTH,
578                 .height         = QVGA_HEIGHT,
579                 .com7_bit       = COM7_FMT_QVGA,
580                 .hstart         = 164,          /* Empirically determined */
581                 .hstop          =  20,
582                 .vstart         =  14,
583                 .vstop          = 494,
584                 .regs           = NULL,
585         },
586         /* QCIF */
587         {
588                 .width          = QCIF_WIDTH,
589                 .height         = QCIF_HEIGHT,
590                 .com7_bit       = COM7_FMT_VGA, /* see comment above */
591                 .hstart         = 456,          /* Empirically determined */
592                 .hstop          =  24,
593                 .vstart         =  14,
594                 .vstop          = 494,
595                 .regs           = ov7670_qcif_regs,
596         },
597 };
598
599 #define N_WIN_SIZES (sizeof(ov7670_win_sizes)/sizeof(ov7670_win_sizes[0]))
600
601
602 /*
603  * Store a set of start/stop values into the camera.
604  */
605 static int ov7670_set_hw(struct i2c_client *client, int hstart, int hstop,
606                 int vstart, int vstop)
607 {
608         int ret;
609         unsigned char v;
610 /*
611  * Horizontal: 11 bits, top 8 live in hstart and hstop.  Bottom 3 of
612  * hstart are in href[2:0], bottom 3 of hstop in href[5:3].  There is
613  * a mystery "edge offset" value in the top two bits of href.
614  */
615         ret =  ov7670_write(client, REG_HSTART, (hstart >> 3) & 0xff);
616         ret += ov7670_write(client, REG_HSTOP, (hstop >> 3) & 0xff);
617         ret += ov7670_read(client, REG_HREF, &v);
618         v = (v & 0xc0) | ((hstop & 0x7) << 3) | (hstart & 0x7);
619         msleep(10);
620         ret += ov7670_write(client, REG_HREF, v);
621 /*
622  * Vertical: similar arrangement, but only 10 bits.
623  */
624         ret += ov7670_write(client, REG_VSTART, (vstart >> 2) & 0xff);
625         ret += ov7670_write(client, REG_VSTOP, (vstop >> 2) & 0xff);
626         ret += ov7670_read(client, REG_VREF, &v);
627         v = (v & 0xf0) | ((vstop & 0x3) << 2) | (vstart & 0x3);
628         msleep(10);
629         ret += ov7670_write(client, REG_VREF, v);
630         return ret;
631 }
632
633
634 static int ov7670_enum_fmt(struct i2c_client *c, struct v4l2_fmtdesc *fmt)
635 {
636         struct ov7670_format_struct *ofmt;
637
638         if (fmt->index >= N_OV7670_FMTS)
639                 return -EINVAL;
640
641         ofmt = ov7670_formats + fmt->index;
642         fmt->flags = 0;
643         strcpy(fmt->description, ofmt->desc);
644         fmt->pixelformat = ofmt->pixelformat;
645         return 0;
646 }
647
648
649 static int ov7670_try_fmt(struct i2c_client *c, struct v4l2_format *fmt,
650                 struct ov7670_format_struct **ret_fmt,
651                 struct ov7670_win_size **ret_wsize)
652 {
653         int index;
654         struct ov7670_win_size *wsize;
655         struct v4l2_pix_format *pix = &fmt->fmt.pix;
656
657         for (index = 0; index < N_OV7670_FMTS; index++)
658                 if (ov7670_formats[index].pixelformat == pix->pixelformat)
659                         break;
660         if (index >= N_OV7670_FMTS)
661                 return -EINVAL;
662         if (ret_fmt != NULL)
663                 *ret_fmt = ov7670_formats + index;
664         /*
665          * Fields: the OV devices claim to be progressive.
666          */
667         if (pix->field == V4L2_FIELD_ANY)
668                 pix->field = V4L2_FIELD_NONE;
669         else if (pix->field != V4L2_FIELD_NONE)
670                 return -EINVAL;
671         /*
672          * Round requested image size down to the nearest
673          * we support, but not below the smallest.
674          */
675         for (wsize = ov7670_win_sizes; wsize < ov7670_win_sizes + N_WIN_SIZES;
676              wsize++)
677                 if (pix->width >= wsize->width && pix->height >= wsize->height)
678                         break;
679         if (wsize >= ov7670_win_sizes + N_WIN_SIZES)
680                 wsize--;   /* Take the smallest one */
681         if (ret_wsize != NULL)
682                 *ret_wsize = wsize;
683         /*
684          * Note the size we'll actually handle.
685          */
686         pix->width = wsize->width;
687         pix->height = wsize->height;
688         pix->bytesperline = pix->width*BYTES_PER_PIXEL;
689         pix->sizeimage = pix->height*pix->bytesperline;
690         return 0;
691 }
692
693 /*
694  * Set a format.
695  */
696 static int ov7670_s_fmt(struct i2c_client *c, struct v4l2_format *fmt)
697 {
698         int ret;
699         struct ov7670_format_struct *ovfmt;
700         struct ov7670_win_size *wsize;
701         struct ov7670_info *info = i2c_get_clientdata(c);
702         unsigned char com7;
703
704         ret = ov7670_try_fmt(c, fmt, &ovfmt, &wsize);
705         if (ret)
706                 return ret;
707         /*
708          * COM7 is a pain in the ass, it doesn't like to be read then
709          * quickly written afterward.  But we have everything we need
710          * to set it absolutely here, as long as the format-specific
711          * register sets list it first.
712          */
713         com7 = ovfmt->regs[0].value;
714         com7 |= wsize->com7_bit;
715         ov7670_write(c, REG_COM7, com7);
716         /*
717          * Now write the rest of the array.  Also store start/stops
718          */
719         ov7670_write_array(c, ovfmt->regs + 1);
720         ov7670_set_hw(c, wsize->hstart, wsize->hstop, wsize->vstart,
721                         wsize->vstop);
722         ret = 0;
723         if (wsize->regs)
724                 ret = ov7670_write_array(c, wsize->regs);
725         info->fmt = ovfmt;
726         return 0;
727 }
728
729 /*
730  * Implement G/S_PARM.  There is a "high quality" mode we could try
731  * to do someday; for now, we just do the frame rate tweak.
732  */
733 static int ov7670_g_parm(struct i2c_client *c, struct v4l2_streamparm *parms)
734 {
735         struct v4l2_captureparm *cp = &parms->parm.capture;
736         unsigned char clkrc;
737         int ret;
738
739         if (parms->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
740                 return -EINVAL;
741         ret = ov7670_read(c, REG_CLKRC, &clkrc);
742         if (ret < 0)
743                 return ret;
744         memset(cp, 0, sizeof(struct v4l2_captureparm));
745         cp->capability = V4L2_CAP_TIMEPERFRAME;
746         cp->timeperframe.numerator = 1;
747         cp->timeperframe.denominator = OV7670_FRAME_RATE;
748         if ((clkrc & CLK_EXT) == 0 && (clkrc & CLK_SCALE) > 1)
749                 cp->timeperframe.denominator /= (clkrc & CLK_SCALE);
750         return 0;
751 }
752
753 static int ov7670_s_parm(struct i2c_client *c, struct v4l2_streamparm *parms)
754 {
755         struct v4l2_captureparm *cp = &parms->parm.capture;
756         struct v4l2_fract *tpf = &cp->timeperframe;
757         unsigned char clkrc;
758         int ret, div;
759
760         if (parms->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
761                 return -EINVAL;
762         if (cp->extendedmode != 0)
763                 return -EINVAL;
764         /*
765          * CLKRC has a reserved bit, so let's preserve it.
766          */
767         ret = ov7670_read(c, REG_CLKRC, &clkrc);
768         if (ret < 0)
769                 return ret;
770         if (tpf->numerator == 0 || tpf->denominator == 0)
771                 div = 1;  /* Reset to full rate */
772         else
773                 div = (tpf->numerator*OV7670_FRAME_RATE)/tpf->denominator;
774         if (div == 0)
775                 div = 1;
776         else if (div > CLK_SCALE)
777                 div = CLK_SCALE;
778         clkrc = (clkrc & 0x80) | div;
779         tpf->numerator = 1;
780         tpf->denominator = OV7670_FRAME_RATE/div;
781         return ov7670_write(c, REG_CLKRC, clkrc);
782 }
783
784
785
786 /*
787  * Code for dealing with controls.
788  */
789
790
791
792
793
794 static int ov7670_store_cmatrix(struct i2c_client *client,
795                 int matrix[CMATRIX_LEN])
796 {
797         int i, ret;
798         unsigned char signbits;
799
800         /*
801          * Weird crap seems to exist in the upper part of
802          * the sign bits register, so let's preserve it.
803          */
804         ret = ov7670_read(client, REG_CMATRIX_SIGN, &signbits);
805         signbits &= 0xc0;
806
807         for (i = 0; i < CMATRIX_LEN; i++) {
808                 unsigned char raw;
809
810                 if (matrix[i] < 0) {
811                         signbits |= (1 << i);
812                         if (matrix[i] < -255)
813                                 raw = 0xff;
814                         else
815                                 raw = (-1 * matrix[i]) & 0xff;
816                 }
817                 else {
818                         if (matrix[i] > 255)
819                                 raw = 0xff;
820                         else
821                                 raw = matrix[i] & 0xff;
822                 }
823                 ret += ov7670_write(client, REG_CMATRIX_BASE + i, raw);
824         }
825         ret += ov7670_write(client, REG_CMATRIX_SIGN, signbits);
826         return ret;
827 }
828
829
830 /*
831  * Hue also requires messing with the color matrix.  It also requires
832  * trig functions, which tend not to be well supported in the kernel.
833  * So here is a simple table of sine values, 0-90 degrees, in steps
834  * of five degrees.  Values are multiplied by 1000.
835  *
836  * The following naive approximate trig functions require an argument
837  * carefully limited to -180 <= theta <= 180.
838  */
839 #define SIN_STEP 5
840 static const int ov7670_sin_table[] = {
841            0,    87,   173,   258,   342,   422,
842          499,   573,   642,   707,   766,   819,
843          866,   906,   939,   965,   984,   996,
844         1000
845 };
846
847 static int ov7670_sine(int theta)
848 {
849         int chs = 1;
850         int sine;
851
852         if (theta < 0) {
853                 theta = -theta;
854                 chs = -1;
855         }
856         if (theta <= 90)
857                 sine = ov7670_sin_table[theta/SIN_STEP];
858         else {
859                 theta -= 90;
860                 sine = 1000 - ov7670_sin_table[theta/SIN_STEP];
861         }
862         return sine*chs;
863 }
864
865 static int ov7670_cosine(int theta)
866 {
867         theta = 90 - theta;
868         if (theta > 180)
869                 theta -= 360;
870         else if (theta < -180)
871                 theta += 360;
872         return ov7670_sine(theta);
873 }
874
875
876
877
878 static void ov7670_calc_cmatrix(struct ov7670_info *info,
879                 int matrix[CMATRIX_LEN])
880 {
881         int i;
882         /*
883          * Apply the current saturation setting first.
884          */
885         for (i = 0; i < CMATRIX_LEN; i++)
886                 matrix[i] = (info->fmt->cmatrix[i]*info->sat) >> 7;
887         /*
888          * Then, if need be, rotate the hue value.
889          */
890         if (info->hue != 0) {
891                 int sinth, costh, tmpmatrix[CMATRIX_LEN];
892
893                 memcpy(tmpmatrix, matrix, CMATRIX_LEN*sizeof(int));
894                 sinth = ov7670_sine(info->hue);
895                 costh = ov7670_cosine(info->hue);
896
897                 matrix[0] = (matrix[3]*sinth + matrix[0]*costh)/1000;
898                 matrix[1] = (matrix[4]*sinth + matrix[1]*costh)/1000;
899                 matrix[2] = (matrix[5]*sinth + matrix[2]*costh)/1000;
900                 matrix[3] = (matrix[3]*costh - matrix[0]*sinth)/1000;
901                 matrix[4] = (matrix[4]*costh - matrix[1]*sinth)/1000;
902                 matrix[5] = (matrix[5]*costh - matrix[2]*sinth)/1000;
903         }
904 }
905
906
907
908 static int ov7670_t_sat(struct i2c_client *client, int value)
909 {
910         struct ov7670_info *info = i2c_get_clientdata(client);
911         int matrix[CMATRIX_LEN];
912         int ret;
913
914         info->sat = value;
915         ov7670_calc_cmatrix(info, matrix);
916         ret = ov7670_store_cmatrix(client, matrix);
917         return ret;
918 }
919
920 static int ov7670_q_sat(struct i2c_client *client, __s32 *value)
921 {
922         struct ov7670_info *info = i2c_get_clientdata(client);
923
924         *value = info->sat;
925         return 0;
926 }
927
928 static int ov7670_t_hue(struct i2c_client *client, int value)
929 {
930         struct ov7670_info *info = i2c_get_clientdata(client);
931         int matrix[CMATRIX_LEN];
932         int ret;
933
934         if (value < -180 || value > 180)
935                 return -EINVAL;
936         info->hue = value;
937         ov7670_calc_cmatrix(info, matrix);
938         ret = ov7670_store_cmatrix(client, matrix);
939         return ret;
940 }
941
942
943 static int ov7670_q_hue(struct i2c_client *client, __s32 *value)
944 {
945         struct ov7670_info *info = i2c_get_clientdata(client);
946
947         *value = info->hue;
948         return 0;
949 }
950
951
952 /*
953  * Some weird registers seem to store values in a sign/magnitude format!
954  */
955 static unsigned char ov7670_sm_to_abs(unsigned char v)
956 {
957         if ((v & 0x80) == 0)
958                 return v + 128;
959         else
960                 return 128 - (v & 0x7f);
961 }
962
963
964 static unsigned char ov7670_abs_to_sm(unsigned char v)
965 {
966         if (v > 127)
967                 return v & 0x7f;
968         else
969                 return (128 - v) | 0x80;
970 }
971
972 static int ov7670_t_brightness(struct i2c_client *client, int value)
973 {
974         unsigned char com8, v;
975         int ret;
976
977         ov7670_read(client, REG_COM8, &com8);
978         com8 &= ~COM8_AEC;
979         ov7670_write(client, REG_COM8, com8);
980         v = ov7670_abs_to_sm(value);
981         ret = ov7670_write(client, REG_BRIGHT, v);
982         return ret;
983 }
984
985 static int ov7670_q_brightness(struct i2c_client *client, __s32 *value)
986 {
987         unsigned char v;
988         int ret = ov7670_read(client, REG_BRIGHT, &v);
989
990         *value = ov7670_sm_to_abs(v);
991         return ret;
992 }
993
994 static int ov7670_t_contrast(struct i2c_client *client, int value)
995 {
996         return ov7670_write(client, REG_CONTRAS, (unsigned char) value);
997 }
998
999 static int ov7670_q_contrast(struct i2c_client *client, __s32 *value)
1000 {
1001         unsigned char v;
1002         int ret = ov7670_read(client, REG_CONTRAS, &v);
1003
1004         *value = v;
1005         return ret;
1006 }
1007
1008 static int ov7670_q_hflip(struct i2c_client *client, __s32 *value)
1009 {
1010         int ret;
1011         unsigned char v;
1012
1013         ret = ov7670_read(client, REG_MVFP, &v);
1014         *value = (v & MVFP_MIRROR) == MVFP_MIRROR;
1015         return ret;
1016 }
1017
1018
1019 static int ov7670_t_hflip(struct i2c_client *client, int value)
1020 {
1021         unsigned char v;
1022         int ret;
1023
1024         ret = ov7670_read(client, REG_MVFP, &v);
1025         if (value)
1026                 v |= MVFP_MIRROR;
1027         else
1028                 v &= ~MVFP_MIRROR;
1029         msleep(10);  /* FIXME */
1030         ret += ov7670_write(client, REG_MVFP, v);
1031         return ret;
1032 }
1033
1034
1035
1036 static int ov7670_q_vflip(struct i2c_client *client, __s32 *value)
1037 {
1038         int ret;
1039         unsigned char v;
1040
1041         ret = ov7670_read(client, REG_MVFP, &v);
1042         *value = (v & MVFP_FLIP) == MVFP_FLIP;
1043         return ret;
1044 }
1045
1046
1047 static int ov7670_t_vflip(struct i2c_client *client, int value)
1048 {
1049         unsigned char v;
1050         int ret;
1051
1052         ret = ov7670_read(client, REG_MVFP, &v);
1053         if (value)
1054                 v |= MVFP_FLIP;
1055         else
1056                 v &= ~MVFP_FLIP;
1057         msleep(10);  /* FIXME */
1058         ret += ov7670_write(client, REG_MVFP, v);
1059         return ret;
1060 }
1061
1062
1063 static struct ov7670_control {
1064         struct v4l2_queryctrl qc;
1065         int (*query)(struct i2c_client *c, __s32 *value);
1066         int (*tweak)(struct i2c_client *c, int value);
1067 } ov7670_controls[] =
1068 {
1069         {
1070                 .qc = {
1071                         .id = V4L2_CID_BRIGHTNESS,
1072                         .type = V4L2_CTRL_TYPE_INTEGER,
1073                         .name = "Brightness",
1074                         .minimum = 0,
1075                         .maximum = 255,
1076                         .step = 1,
1077                         .default_value = 0x80,
1078                         .flags = V4L2_CTRL_FLAG_SLIDER
1079                 },
1080                 .tweak = ov7670_t_brightness,
1081                 .query = ov7670_q_brightness,
1082         },
1083         {
1084                 .qc = {
1085                         .id = V4L2_CID_CONTRAST,
1086                         .type = V4L2_CTRL_TYPE_INTEGER,
1087                         .name = "Contrast",
1088                         .minimum = 0,
1089                         .maximum = 127,
1090                         .step = 1,
1091                         .default_value = 0x40,   /* XXX ov7670 spec */
1092                         .flags = V4L2_CTRL_FLAG_SLIDER
1093                 },
1094                 .tweak = ov7670_t_contrast,
1095                 .query = ov7670_q_contrast,
1096         },
1097         {
1098                 .qc = {
1099                         .id = V4L2_CID_SATURATION,
1100                         .type = V4L2_CTRL_TYPE_INTEGER,
1101                         .name = "Saturation",
1102                         .minimum = 0,
1103                         .maximum = 256,
1104                         .step = 1,
1105                         .default_value = 0x80,
1106                         .flags = V4L2_CTRL_FLAG_SLIDER
1107                 },
1108                 .tweak = ov7670_t_sat,
1109                 .query = ov7670_q_sat,
1110         },
1111         {
1112                 .qc = {
1113                         .id = V4L2_CID_HUE,
1114                         .type = V4L2_CTRL_TYPE_INTEGER,
1115                         .name = "HUE",
1116                         .minimum = -180,
1117                         .maximum = 180,
1118                         .step = 5,
1119                         .default_value = 0,
1120                         .flags = V4L2_CTRL_FLAG_SLIDER
1121                 },
1122                 .tweak = ov7670_t_hue,
1123                 .query = ov7670_q_hue,
1124         },
1125         {
1126                 .qc = {
1127                         .id = V4L2_CID_VFLIP,
1128                         .type = V4L2_CTRL_TYPE_BOOLEAN,
1129                         .name = "Vertical flip",
1130                         .minimum = 0,
1131                         .maximum = 1,
1132                         .step = 1,
1133                         .default_value = 0,
1134                 },
1135                 .tweak = ov7670_t_vflip,
1136                 .query = ov7670_q_vflip,
1137         },
1138         {
1139                 .qc = {
1140                         .id = V4L2_CID_HFLIP,
1141                         .type = V4L2_CTRL_TYPE_BOOLEAN,
1142                         .name = "Horizontal mirror",
1143                         .minimum = 0,
1144                         .maximum = 1,
1145                         .step = 1,
1146                         .default_value = 0,
1147                 },
1148                 .tweak = ov7670_t_hflip,
1149                 .query = ov7670_q_hflip,
1150         },
1151 };
1152 #define N_CONTROLS (sizeof(ov7670_controls)/sizeof(ov7670_controls[0]))
1153
1154 static struct ov7670_control *ov7670_find_control(__u32 id)
1155 {
1156         int i;
1157
1158         for (i = 0; i < N_CONTROLS; i++)
1159                 if (ov7670_controls[i].qc.id == id)
1160                         return ov7670_controls + i;
1161         return NULL;
1162 }
1163
1164
1165 static int ov7670_queryctrl(struct i2c_client *client,
1166                 struct v4l2_queryctrl *qc)
1167 {
1168         struct ov7670_control *ctrl = ov7670_find_control(qc->id);
1169
1170         if (ctrl == NULL)
1171                 return -EINVAL;
1172         *qc = ctrl->qc;
1173         return 0;
1174 }
1175
1176 static int ov7670_g_ctrl(struct i2c_client *client, struct v4l2_control *ctrl)
1177 {
1178         struct ov7670_control *octrl = ov7670_find_control(ctrl->id);
1179         int ret;
1180
1181         if (octrl == NULL)
1182                 return -EINVAL;
1183         ret = octrl->query(client, &ctrl->value);
1184         if (ret >= 0)
1185                 return 0;
1186         return ret;
1187 }
1188
1189 static int ov7670_s_ctrl(struct i2c_client *client, struct v4l2_control *ctrl)
1190 {
1191         struct ov7670_control *octrl = ov7670_find_control(ctrl->id);
1192         int ret;
1193
1194         if (octrl == NULL)
1195                 return -EINVAL;
1196         ret =  octrl->tweak(client, ctrl->value);
1197         if (ret >= 0)
1198                 return 0;
1199         return ret;
1200 }
1201
1202
1203
1204
1205
1206
1207 /*
1208  * Basic i2c stuff.
1209  */
1210 static struct i2c_driver ov7670_driver;
1211
1212 static int ov7670_attach(struct i2c_adapter *adapter)
1213 {
1214         int ret;
1215         struct i2c_client *client;
1216         struct ov7670_info *info;
1217
1218         /*
1219          * For now: only deal with adapters we recognize.
1220          */
1221         if (adapter->id != I2C_HW_SMBUS_CAFE)
1222                 return -ENODEV;
1223
1224         client = kzalloc(sizeof (struct i2c_client), GFP_KERNEL);
1225         if (! client)
1226                 return -ENOMEM;
1227         client->adapter = adapter;
1228         client->addr = OV7670_I2C_ADDR;
1229         client->driver = &ov7670_driver,
1230         strcpy(client->name, "OV7670");
1231         /*
1232          * Set up our info structure.
1233          */
1234         info = kzalloc(sizeof (struct ov7670_info), GFP_KERNEL);
1235         if (! info) {
1236                 ret = -ENOMEM;
1237                 goto out_free;
1238         }
1239         info->fmt = &ov7670_formats[0];
1240         info->sat = 128;        /* Review this */
1241         i2c_set_clientdata(client, info);
1242
1243         /*
1244          * Make sure it's an ov7670
1245          */
1246         ret = ov7670_detect(client);
1247         if (ret)
1248                 goto out_free_info;
1249         i2c_attach_client(client);
1250         return 0;
1251
1252   out_free_info:
1253         kfree(info);
1254   out_free:
1255         kfree(client);
1256         return ret;
1257 }
1258
1259
1260 static int ov7670_detach(struct i2c_client *client)
1261 {
1262         i2c_detach_client(client);
1263         kfree(i2c_get_clientdata(client));
1264         kfree(client);
1265         return 0;
1266 }
1267
1268
1269 static int ov7670_command(struct i2c_client *client, unsigned int cmd,
1270                 void *arg)
1271 {
1272         switch (cmd) {
1273         case VIDIOC_INT_G_CHIP_IDENT:
1274                 * (enum v4l2_chip_ident *) arg = V4L2_IDENT_OV7670;
1275                 return 0;
1276
1277         case VIDIOC_INT_RESET:
1278                 ov7670_reset(client);
1279                 return 0;
1280
1281         case VIDIOC_INT_INIT:
1282                 return ov7670_init(client);
1283
1284         case VIDIOC_ENUM_FMT:
1285                 return ov7670_enum_fmt(client, (struct v4l2_fmtdesc *) arg);
1286         case VIDIOC_TRY_FMT:
1287                 return ov7670_try_fmt(client, (struct v4l2_format *) arg, NULL, NULL);
1288         case VIDIOC_S_FMT:
1289                 return ov7670_s_fmt(client, (struct v4l2_format *) arg);
1290         case VIDIOC_QUERYCTRL:
1291                 return ov7670_queryctrl(client, (struct v4l2_queryctrl *) arg);
1292         case VIDIOC_S_CTRL:
1293                 return ov7670_s_ctrl(client, (struct v4l2_control *) arg);
1294         case VIDIOC_G_CTRL:
1295                 return ov7670_g_ctrl(client, (struct v4l2_control *) arg);
1296         case VIDIOC_S_PARM:
1297                 return ov7670_s_parm(client, (struct v4l2_streamparm *) arg);
1298         case VIDIOC_G_PARM:
1299                 return ov7670_g_parm(client, (struct v4l2_streamparm *) arg);
1300         }
1301         return -EINVAL;
1302 }
1303
1304
1305
1306 static struct i2c_driver ov7670_driver = {
1307         .driver = {
1308                 .name = "ov7670",
1309         },
1310         .id             = I2C_DRIVERID_OV7670,
1311         .class          = I2C_CLASS_CAM_DIGITAL,
1312         .attach_adapter = ov7670_attach,
1313         .detach_client  = ov7670_detach,
1314         .command        = ov7670_command,
1315 };
1316
1317
1318 /*
1319  * Module initialization
1320  */
1321 static int __init ov7670_mod_init(void)
1322 {
1323         printk(KERN_NOTICE "OmniVision ov7670 sensor driver, at your service\n");
1324         return i2c_add_driver(&ov7670_driver);
1325 }
1326
1327 static void __exit ov7670_mod_exit(void)
1328 {
1329         i2c_del_driver(&ov7670_driver);
1330 }
1331
1332 module_init(ov7670_mod_init);
1333 module_exit(ov7670_mod_exit);