2 * Driver for the po1030 sensor.
4 * Copyright (c) 2008 Erik Andrén
5 * Copyright (c) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project.
6 * Copyright (c) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br>
8 * Portions of code to USB interface and ALi driver software,
9 * Copyright (c) 2006 Willem Duinker
10 * v4l2 interface modeled after the V4L2 driver
11 * for SN9C10x PC Camera Controllers
13 * Register defines taken from Pascal Stangs Proxycon Armlib
15 * This program is free software; you can redistribute it and/or
16 * modify it under the terms of the GNU General Public License as
17 * published by the Free Software Foundation, version 2.
21 #ifndef M5602_PO1030_H_
22 #define M5602_PO1030_H_
24 #include "m5602_sensor.h"
26 /*****************************************************************************/
28 #define PO1030_REG_DEVID_H 0x00
29 #define PO1030_REG_DEVID_L 0x01
30 #define PO1030_REG_FRAMEWIDTH_H 0x04
31 #define PO1030_REG_FRAMEWIDTH_L 0x05
32 #define PO1030_REG_FRAMEHEIGHT_H 0x06
33 #define PO1030_REG_FRAMEHEIGHT_L 0x07
34 #define PO1030_REG_WINDOWX_H 0x08
35 #define PO1030_REG_WINDOWX_L 0x09
36 #define PO1030_REG_WINDOWY_H 0x0a
37 #define PO1030_REG_WINDOWY_L 0x0b
38 #define PO1030_REG_WINDOWWIDTH_H 0x0c
39 #define PO1030_REG_WINDOWWIDTH_L 0x0d
40 #define PO1030_REG_WINDOWHEIGHT_H 0x0e
41 #define PO1030_REG_WINDOWHEIGHT_L 0x0f
43 #define PO1030_REG_GLOBALIBIAS 0x12
44 #define PO1030_REG_PIXELIBIAS 0x13
46 #define PO1030_REG_GLOBALGAIN 0x15
47 #define PO1030_REG_RED_GAIN 0x16
48 #define PO1030_REG_GREEN_1_GAIN 0x17
49 #define PO1030_REG_BLUE_GAIN 0x18
50 #define PO1030_REG_GREEN_2_GAIN 0x19
52 #define PO1030_REG_INTEGLINES_H 0x1a
53 #define PO1030_REG_INTEGLINES_M 0x1b
54 #define PO1030_REG_INTEGLINES_L 0x1c
56 #define PO1030_REG_CONTROL1 0x1d
57 #define PO1030_REG_CONTROL2 0x1e
58 #define PO1030_REG_CONTROL3 0x1f
59 #define PO1030_REG_CONTROL4 0x20
61 #define PO1030_REG_PERIOD50_H 0x23
62 #define PO1030_REG_PERIOD50_L 0x24
63 #define PO1030_REG_PERIOD60_H 0x25
64 #define PO1030_REG_PERIOD60_L 0x26
65 #define PO1030_REG_REGCLK167 0x27
66 #define PO1030_REG_DELTA50 0x28
67 #define PO1030_REG_DELTA60 0x29
69 #define PO1030_REG_ADCOFFSET 0x2c
71 /* Gamma Correction Coeffs */
72 #define PO1030_REG_GC0 0x2d
73 #define PO1030_REG_GC1 0x2e
74 #define PO1030_REG_GC2 0x2f
75 #define PO1030_REG_GC3 0x30
76 #define PO1030_REG_GC4 0x31
77 #define PO1030_REG_GC5 0x32
78 #define PO1030_REG_GC6 0x33
79 #define PO1030_REG_GC7 0x34
81 /* Color Transform Matrix */
82 #define PO1030_REG_CT0 0x35
83 #define PO1030_REG_CT1 0x36
84 #define PO1030_REG_CT2 0x37
85 #define PO1030_REG_CT3 0x38
86 #define PO1030_REG_CT4 0x39
87 #define PO1030_REG_CT5 0x3a
88 #define PO1030_REG_CT6 0x3b
89 #define PO1030_REG_CT7 0x3c
90 #define PO1030_REG_CT8 0x3d
92 #define PO1030_REG_AUTOCTRL1 0x3e
93 #define PO1030_REG_AUTOCTRL2 0x3f
95 #define PO1030_REG_YTARGET 0x40
96 #define PO1030_REG_GLOBALGAINMIN 0x41
97 #define PO1030_REG_GLOBALGAINMAX 0x42
99 /* Output format control */
100 #define PO1030_REG_OUTFORMCTRL1 0x5a
101 #define PO1030_REG_OUTFORMCTRL2 0x5b
102 #define PO1030_REG_OUTFORMCTRL3 0x5c
103 #define PO1030_REG_OUTFORMCTRL4 0x5d
104 #define PO1030_REG_OUTFORMCTRL5 0x5e
106 /* Imaging coefficients */
107 #define PO1030_REG_YBRIGHT 0x73
108 #define PO1030_REG_YCONTRAST 0x74
109 #define PO1030_REG_YSATURATION 0x75
111 /*****************************************************************************/
113 #define PO1030_GLOBAL_GAIN_DEFAULT 0x12
114 #define PO1030_EXPOSURE_DEFAULT 0xf0ff
115 #define PO1030_BLUE_GAIN_DEFAULT 0x40
116 #define PO1030_RED_GAIN_DEFAULT 0x40
118 /*****************************************************************************/
120 /* Kernel module parameters */
121 extern int force_sensor;
122 extern int dump_sensor;
123 extern unsigned int m5602_debug;
125 int po1030_probe(struct sd *sd);
126 int po1030_init(struct sd *sd);
127 int po1030_power_down(struct sd *sd);
129 void po1030_dump_registers(struct sd *sd);
131 int po1030_read_sensor(struct sd *sd, const u8 address,
132 u8 *i2c_data, const u8 len);
133 int po1030_write_sensor(struct sd *sd, const u8 address,
134 u8 *i2c_data, const u8 len);
136 int po1030_get_exposure(struct gspca_dev *gspca_dev, __s32 *val);
137 int po1030_set_exposure(struct gspca_dev *gspca_dev, __s32 val);
138 int po1030_get_gain(struct gspca_dev *gspca_dev, __s32 *val);
139 int po1030_set_gain(struct gspca_dev *gspca_dev, __s32 val);
140 int po1030_get_red_balance(struct gspca_dev *gspca_dev, __s32 *val);
141 int po1030_set_red_balance(struct gspca_dev *gspca_dev, __s32 val);
142 int po1030_get_blue_balance(struct gspca_dev *gspca_dev, __s32 *val);
143 int po1030_set_blue_balance(struct gspca_dev *gspca_dev, __s32 val);
145 static struct m5602_sensor po1030 = {
148 .i2c_slave_id = 0xdc,
150 .probe = po1030_probe,
152 .power_down = po1030_power_down,
159 .type = V4L2_CTRL_TYPE_INTEGER,
164 .default_value = PO1030_GLOBAL_GAIN_DEFAULT,
165 .flags = V4L2_CTRL_FLAG_SLIDER
167 .set = po1030_set_gain,
168 .get = po1030_get_gain
171 .id = V4L2_CID_EXPOSURE,
172 .type = V4L2_CTRL_TYPE_INTEGER,
177 .default_value = PO1030_EXPOSURE_DEFAULT,
178 .flags = V4L2_CTRL_FLAG_SLIDER
180 .set = po1030_set_exposure,
181 .get = po1030_get_exposure
184 .id = V4L2_CID_RED_BALANCE,
185 .type = V4L2_CTRL_TYPE_INTEGER,
186 .name = "red balance",
190 .default_value = PO1030_RED_GAIN_DEFAULT,
191 .flags = V4L2_CTRL_FLAG_SLIDER
193 .set = po1030_set_red_balance,
194 .get = po1030_get_red_balance
197 .id = V4L2_CID_BLUE_BALANCE,
198 .type = V4L2_CTRL_TYPE_INTEGER,
199 .name = "blue balance",
203 .default_value = PO1030_BLUE_GAIN_DEFAULT,
204 .flags = V4L2_CTRL_FLAG_SLIDER
206 .set = po1030_set_blue_balance,
207 .get = po1030_get_blue_balance
213 M5602_DEFAULT_FRAME_WIDTH,
214 M5602_DEFAULT_FRAME_HEIGHT,
218 M5602_DEFAULT_FRAME_WIDTH * M5602_DEFAULT_FRAME_HEIGHT,
219 .bytesperline = M5602_DEFAULT_FRAME_WIDTH,
220 .colorspace = V4L2_COLORSPACE_SRGB,
226 static const unsigned char preinit_po1030[][3] =
228 {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02},
229 {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0},
230 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
231 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
232 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
233 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0d},
234 {BRIDGE, M5602_XB_SENSOR_CTRL, 0x00},
235 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
236 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
238 {SENSOR, PO1030_REG_AUTOCTRL2, 0x24},
240 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
241 {BRIDGE, M5602_XB_GPIO_DAT, 0x04},
242 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
243 {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06},
244 {BRIDGE, M5602_XB_GPIO_DAT_H, 0x02},
245 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x04},
246 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
247 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x06},
248 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
249 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
250 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
251 {BRIDGE, M5602_XB_LINE_OF_FRAME_H, 0x81},
252 {BRIDGE, M5602_XB_PIX_OF_LINE_H, 0x82},
253 {BRIDGE, M5602_XB_SIG_INI, 0x01},
254 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
255 {BRIDGE, M5602_XB_VSYNC_PARA, 0x02},
256 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
257 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
258 {BRIDGE, M5602_XB_VSYNC_PARA, 0x01},
259 {BRIDGE, M5602_XB_VSYNC_PARA, 0xec},
260 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
261 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
262 {BRIDGE, M5602_XB_SIG_INI, 0x00},
263 {BRIDGE, M5602_XB_SIG_INI, 0x02},
264 {BRIDGE, M5602_XB_HSYNC_PARA, 0x00},
265 {BRIDGE, M5602_XB_HSYNC_PARA, 0x00},
266 {BRIDGE, M5602_XB_HSYNC_PARA, 0x02},
267 {BRIDGE, M5602_XB_HSYNC_PARA, 0x87},
268 {BRIDGE, M5602_XB_SIG_INI, 0x00},
270 {SENSOR, PO1030_REG_AUTOCTRL2, 0x24},
272 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
273 {BRIDGE, M5602_XB_GPIO_DAT, 0x04},
274 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
275 {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06},
276 {BRIDGE, M5602_XB_GPIO_DAT_H, 0x02},
277 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x04},
278 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
279 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
280 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
281 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
282 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
283 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
284 {BRIDGE, M5602_XB_GPIO_DAT, 0x00}
287 static const unsigned char init_po1030[][4] =
289 {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02},
290 {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0},
292 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
293 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
294 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
295 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0d},
297 {BRIDGE, M5602_XB_SENSOR_CTRL, 0x00},
298 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
299 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
300 /*end of sequence 1*/
302 /*sequence 2 (same as stop sequence)*/
303 {SENSOR, PO1030_REG_AUTOCTRL2, 0x24},
304 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
305 {BRIDGE, M5602_XB_GPIO_DAT, 0x04},
306 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
307 {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06},
308 {BRIDGE, M5602_XB_GPIO_DAT_H, 0x02},
310 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x04},
311 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
312 /*end of sequence 2*/
315 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x06},
316 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
317 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
318 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
319 {BRIDGE, M5602_XB_LINE_OF_FRAME_H, 0x81},
320 {BRIDGE, M5602_XB_PIX_OF_LINE_H, 0x82},
321 {BRIDGE, M5602_XB_SIG_INI, 0x01},
322 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
323 {BRIDGE, M5602_XB_VSYNC_PARA, 0x02},
324 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
325 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
326 {BRIDGE, M5602_XB_VSYNC_PARA, 0x01},
327 {BRIDGE, M5602_XB_VSYNC_PARA, 0xec},
328 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
329 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
330 {BRIDGE, M5602_XB_SIG_INI, 0x00},
331 {BRIDGE, M5602_XB_SIG_INI, 0x02},
332 {BRIDGE, M5602_XB_HSYNC_PARA, 0x00},
333 {BRIDGE, M5602_XB_HSYNC_PARA, 0x00},
334 {BRIDGE, M5602_XB_HSYNC_PARA, 0x02},
335 {BRIDGE, M5602_XB_HSYNC_PARA, 0x87},
336 {BRIDGE, M5602_XB_SIG_INI, 0x00},
337 /*end of sequence 5*/
340 {SENSOR, PO1030_REG_AUTOCTRL2, 0x24},
342 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
343 {BRIDGE, M5602_XB_GPIO_DAT, 0x04},
344 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
345 {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06},
346 {BRIDGE, M5602_XB_GPIO_DAT_H, 0x02},
347 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x04},
348 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
349 /*end of sequence 2 stop */
351 /* ---------------------------------
352 * end of init - begin of start
353 * --------------------------------- */
356 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
357 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
358 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
359 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
360 /*end of sequence 3*/
362 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
363 {BRIDGE, M5602_XB_GPIO_DAT, 0x00},
364 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
365 {BRIDGE, M5602_XB_GPIO_EN_L, 0x00},
367 {SENSOR, PO1030_REG_AUTOCTRL2, 0x04},
369 /* Set the width to 751 */
370 {SENSOR, PO1030_REG_FRAMEWIDTH_H, 0x02},
371 {SENSOR, PO1030_REG_FRAMEWIDTH_L, 0xef},
373 /* Set the height to 540 */
374 {SENSOR, PO1030_REG_FRAMEHEIGHT_H, 0x02},
375 {SENSOR, PO1030_REG_FRAMEHEIGHT_L, 0x1c},
377 /* Set the x window to 1 */
378 {SENSOR, PO1030_REG_WINDOWX_H, 0x00},
379 {SENSOR, PO1030_REG_WINDOWX_L, 0x01},
381 /* Set the y window to 1 */
382 {SENSOR, PO1030_REG_WINDOWY_H, 0x00},
383 {SENSOR, PO1030_REG_WINDOWX_L, 0x01},
385 {SENSOR, PO1030_REG_WINDOWWIDTH_H, 0x02},
386 {SENSOR, PO1030_REG_WINDOWWIDTH_L, 0x87},
387 {SENSOR, PO1030_REG_WINDOWHEIGHT_H, 0x01},
388 {SENSOR, PO1030_REG_WINDOWHEIGHT_L, 0xe3},
390 {SENSOR, PO1030_REG_OUTFORMCTRL2, 0x04},
391 {SENSOR, PO1030_REG_OUTFORMCTRL2, 0x04},
392 {SENSOR, PO1030_REG_AUTOCTRL1, 0x08},
393 {SENSOR, PO1030_REG_CONTROL2, 0x03},
394 {SENSOR, 0x21, 0x90},
395 {SENSOR, PO1030_REG_YTARGET, 0x60},
396 {SENSOR, 0x59, 0x13},
397 {SENSOR, PO1030_REG_OUTFORMCTRL1, 0x40},
398 {SENSOR, 0x5f, 0x00},
399 {SENSOR, 0x60, 0x80},
400 {SENSOR, 0x78, 0x14},
401 {SENSOR, 0x6f, 0x01},
402 {SENSOR, PO1030_REG_CONTROL1, 0x18},
403 {SENSOR, PO1030_REG_GLOBALGAINMAX, 0x14},
404 {SENSOR, 0x63, 0x38},
405 {SENSOR, 0x64, 0x38},
406 {SENSOR, PO1030_REG_CONTROL1, 0x58},
407 {SENSOR, PO1030_REG_RED_GAIN, 0x30},
408 {SENSOR, PO1030_REG_GREEN_1_GAIN, 0x30},
409 {SENSOR, PO1030_REG_BLUE_GAIN, 0x30},
410 {SENSOR, PO1030_REG_GREEN_2_GAIN, 0x30},
411 {SENSOR, PO1030_REG_GC0, 0x10},
412 {SENSOR, PO1030_REG_GC1, 0x20},
413 {SENSOR, PO1030_REG_GC2, 0x40},
414 {SENSOR, PO1030_REG_GC3, 0x60},
415 {SENSOR, PO1030_REG_GC4, 0x80},
416 {SENSOR, PO1030_REG_GC5, 0xa0},
417 {SENSOR, PO1030_REG_GC6, 0xc0},
418 {SENSOR, PO1030_REG_GC7, 0xff},
419 /*end of sequence 4*/
421 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x06},
422 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
423 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
424 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
425 {BRIDGE, M5602_XB_LINE_OF_FRAME_H, 0x81},
426 {BRIDGE, M5602_XB_PIX_OF_LINE_H, 0x82},
427 {BRIDGE, M5602_XB_SIG_INI, 0x01},
428 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
429 {BRIDGE, M5602_XB_VSYNC_PARA, 0x02},
430 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
431 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
432 {BRIDGE, M5602_XB_VSYNC_PARA, 0x01},
433 {BRIDGE, M5602_XB_VSYNC_PARA, 0xec},
434 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
435 {BRIDGE, M5602_XB_VSYNC_PARA, 0x00},
436 {BRIDGE, M5602_XB_SIG_INI, 0x00},
437 {BRIDGE, M5602_XB_SIG_INI, 0x00},
438 {BRIDGE, M5602_XB_HSYNC_PARA, 0x00},
439 {BRIDGE, M5602_XB_HSYNC_PARA, 0x00},
440 {BRIDGE, M5602_XB_HSYNC_PARA, 0x02},
441 {BRIDGE, M5602_XB_HSYNC_PARA, 0x7e},
442 {BRIDGE, M5602_XB_SIG_INI, 0x00},
443 /*end of sequence 5*/
446 /* Changing 40 in f0 the image becomes green in bayer mode and red in
448 {SENSOR, PO1030_REG_RED_GAIN, PO1030_RED_GAIN_DEFAULT},
449 /* in changing 40 in f0 the image becomes green in bayer mode and red in
451 {SENSOR, PO1030_REG_BLUE_GAIN, PO1030_BLUE_GAIN_DEFAULT},
453 /* with a very low lighted environment increase the exposure but
454 * decrease the FPS (Frame Per Second) */
455 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
456 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
458 /* Controls high exposure more than SENSOR_LOW_EXPOSURE, use only in
459 * low lighted environment (f0 is more than ff ?)*/
460 {SENSOR, PO1030_REG_INTEGLINES_H, ((PO1030_EXPOSURE_DEFAULT >> 2)
463 /* Controls middle exposure, use only in high lighted environment */
464 {SENSOR, PO1030_REG_INTEGLINES_M, PO1030_EXPOSURE_DEFAULT & 0xff},
466 /* Controls clarity (not sure) */
467 {SENSOR, PO1030_REG_INTEGLINES_L, 0x00},
468 /* Controls gain (the image is more lighted) */
469 {SENSOR, PO1030_REG_GLOBALGAIN, PO1030_GLOBAL_GAIN_DEFAULT},
472 {SENSOR, PO1030_REG_FRAMEWIDTH_H, 0x02},
473 {SENSOR, PO1030_REG_FRAMEWIDTH_L, 0xef}
474 /*end of sequence 6*/