1 // SPDX-License-Identifier: GPL-2.0-only
3 * Driver for the po1030 sensor
5 * Copyright (c) 2008 Erik Andrén
6 * Copyright (c) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project.
7 * Copyright (c) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br>
9 * Portions of code to USB interface and ALi driver software,
10 * Copyright (c) 2006 Willem Duinker
11 * v4l2 interface modeled after the V4L2 driver
12 * for SN9C10x PC Camera Controllers
15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
17 #include "m5602_po1030.h"
19 static int po1030_s_ctrl(struct v4l2_ctrl *ctrl);
20 static void po1030_dump_registers(struct sd *sd);
22 static const unsigned char preinit_po1030[][3] = {
23 {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02},
24 {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0},
25 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
26 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
27 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
28 {BRIDGE, M5602_XB_SENSOR_CTRL, 0x00},
29 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
30 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
31 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
32 {BRIDGE, M5602_XB_GPIO_DAT, 0x04},
33 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
34 {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06},
35 {BRIDGE, M5602_XB_GPIO_DAT_H, 0x02},
37 {SENSOR, PO1030_AUTOCTRL2, PO1030_SENSOR_RESET | (1 << 2)},
39 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x04},
40 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
41 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
42 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
43 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
44 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
45 {BRIDGE, M5602_XB_GPIO_DAT, 0x00}
48 static const unsigned char init_po1030[][3] = {
49 {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02},
50 {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0},
51 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
52 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
53 {BRIDGE, M5602_XB_ADC_CTRL, 0xc0},
54 {BRIDGE, M5602_XB_SENSOR_CTRL, 0x00},
55 {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0c},
57 {SENSOR, PO1030_AUTOCTRL2, PO1030_SENSOR_RESET | (1 << 2)},
59 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
60 {BRIDGE, M5602_XB_GPIO_DAT, 0x04},
61 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
62 {BRIDGE, M5602_XB_GPIO_EN_L, 0x00},
63 {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06},
64 {BRIDGE, M5602_XB_GPIO_DAT_H, 0x02},
65 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x04},
66 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
67 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
68 {BRIDGE, M5602_XB_GPIO_DAT, 0x00},
70 {SENSOR, PO1030_AUTOCTRL2, 0x04},
72 {SENSOR, PO1030_OUTFORMCTRL2, PO1030_RAW_RGB_BAYER},
73 {SENSOR, PO1030_AUTOCTRL1, PO1030_WEIGHT_WIN_2X},
75 {SENSOR, PO1030_CONTROL2, 0x03},
77 {SENSOR, PO1030_YTARGET, 0x60},
79 {SENSOR, PO1030_OUTFORMCTRL1, PO1030_HREF_ENABLE},
80 {SENSOR, PO1030_EDGE_ENH_OFF, 0x00},
81 {SENSOR, PO1030_EGA, 0x80},
84 {SENSOR, PO1030_GLOBALGAINMAX, 0x14},
85 {SENSOR, PO1030_Cb_U_GAIN, 0x38},
86 {SENSOR, PO1030_Cr_V_GAIN, 0x38},
87 {SENSOR, PO1030_CONTROL1, PO1030_SHUTTER_MODE |
88 PO1030_AUTO_SUBSAMPLING |
90 {SENSOR, PO1030_GC0, 0x10},
91 {SENSOR, PO1030_GC1, 0x20},
92 {SENSOR, PO1030_GC2, 0x40},
93 {SENSOR, PO1030_GC3, 0x60},
94 {SENSOR, PO1030_GC4, 0x80},
95 {SENSOR, PO1030_GC5, 0xa0},
96 {SENSOR, PO1030_GC6, 0xc0},
97 {SENSOR, PO1030_GC7, 0xff},
99 /* Set the width to 751 */
100 {SENSOR, PO1030_FRAMEWIDTH_H, 0x02},
101 {SENSOR, PO1030_FRAMEWIDTH_L, 0xef},
103 /* Set the height to 540 */
104 {SENSOR, PO1030_FRAMEHEIGHT_H, 0x02},
105 {SENSOR, PO1030_FRAMEHEIGHT_L, 0x1c},
107 /* Set the x window to 1 */
108 {SENSOR, PO1030_WINDOWX_H, 0x00},
109 {SENSOR, PO1030_WINDOWX_L, 0x01},
111 /* Set the y window to 1 */
112 {SENSOR, PO1030_WINDOWY_H, 0x00},
113 {SENSOR, PO1030_WINDOWY_L, 0x01},
115 /* with a very low lighted environment increase the exposure but
116 * decrease the FPS (Frame Per Second) */
117 {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00},
118 {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0},
120 {BRIDGE, M5602_XB_GPIO_DIR, 0x05},
121 {BRIDGE, M5602_XB_GPIO_DAT, 0x00},
122 {BRIDGE, M5602_XB_GPIO_EN_H, 0x06},
123 {BRIDGE, M5602_XB_GPIO_EN_L, 0x00},
126 static struct v4l2_pix_format po1030_modes[] = {
132 .sizeimage = 640 * 480,
134 .colorspace = V4L2_COLORSPACE_SRGB,
139 static const struct v4l2_ctrl_ops po1030_ctrl_ops = {
140 .s_ctrl = po1030_s_ctrl,
143 static const struct v4l2_ctrl_config po1030_greenbal_cfg = {
144 .ops = &po1030_ctrl_ops,
145 .id = M5602_V4L2_CID_GREEN_BALANCE,
146 .name = "Green Balance",
147 .type = V4L2_CTRL_TYPE_INTEGER,
151 .def = PO1030_GREEN_GAIN_DEFAULT,
152 .flags = V4L2_CTRL_FLAG_SLIDER,
155 int po1030_probe(struct sd *sd)
159 struct gspca_dev *gspca_dev = (struct gspca_dev *)sd;
162 if (force_sensor == PO1030_SENSOR) {
163 pr_info("Forcing a %s sensor\n", po1030.name);
166 /* If we want to force another sensor, don't try to probe this
171 gspca_dbg(gspca_dev, D_PROBE, "Probing for a po1030 sensor\n");
173 /* Run the pre-init to actually probe the unit */
174 for (i = 0; i < ARRAY_SIZE(preinit_po1030); i++) {
175 u8 data = preinit_po1030[i][2];
176 if (preinit_po1030[i][0] == SENSOR)
177 err = m5602_write_sensor(sd, preinit_po1030[i][1],
180 err = m5602_write_bridge(sd, preinit_po1030[i][1],
186 if (m5602_read_sensor(sd, PO1030_DEVID_H, &dev_id_h, 1))
189 if (dev_id_h == 0x30) {
190 pr_info("Detected a po1030 sensor\n");
196 sd->gspca_dev.cam.cam_mode = po1030_modes;
197 sd->gspca_dev.cam.nmodes = ARRAY_SIZE(po1030_modes);
202 int po1030_init(struct sd *sd)
206 /* Init the sensor */
207 for (i = 0; i < ARRAY_SIZE(init_po1030) && !err; i++) {
208 u8 data[2] = {0x00, 0x00};
210 switch (init_po1030[i][0]) {
212 err = m5602_write_bridge(sd,
218 data[0] = init_po1030[i][2];
219 err = m5602_write_sensor(sd,
220 init_po1030[i][1], data, 1);
224 pr_info("Invalid stream command, exiting init\n");
232 po1030_dump_registers(sd);
237 int po1030_init_controls(struct sd *sd)
239 struct v4l2_ctrl_handler *hdl = &sd->gspca_dev.ctrl_handler;
241 sd->gspca_dev.vdev.ctrl_handler = hdl;
242 v4l2_ctrl_handler_init(hdl, 9);
244 sd->auto_white_bal = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops,
245 V4L2_CID_AUTO_WHITE_BALANCE,
247 sd->green_bal = v4l2_ctrl_new_custom(hdl, &po1030_greenbal_cfg, NULL);
248 sd->red_bal = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops,
249 V4L2_CID_RED_BALANCE, 0, 255, 1,
250 PO1030_RED_GAIN_DEFAULT);
251 sd->blue_bal = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops,
252 V4L2_CID_BLUE_BALANCE, 0, 255, 1,
253 PO1030_BLUE_GAIN_DEFAULT);
255 sd->autoexpo = v4l2_ctrl_new_std_menu(hdl, &po1030_ctrl_ops,
256 V4L2_CID_EXPOSURE_AUTO, 1, 0, V4L2_EXPOSURE_MANUAL);
257 sd->expo = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops, V4L2_CID_EXPOSURE,
258 0, 0x2ff, 1, PO1030_EXPOSURE_DEFAULT);
260 sd->gain = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops, V4L2_CID_GAIN, 0,
261 0x4f, 1, PO1030_GLOBAL_GAIN_DEFAULT);
263 sd->hflip = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops, V4L2_CID_HFLIP,
265 sd->vflip = v4l2_ctrl_new_std(hdl, &po1030_ctrl_ops, V4L2_CID_VFLIP,
269 pr_err("Could not initialize controls\n");
273 v4l2_ctrl_auto_cluster(4, &sd->auto_white_bal, 0, false);
274 v4l2_ctrl_auto_cluster(2, &sd->autoexpo, 0, false);
275 v4l2_ctrl_cluster(2, &sd->hflip);
280 int po1030_start(struct sd *sd)
282 struct cam *cam = &sd->gspca_dev.cam;
284 int width = cam->cam_mode[sd->gspca_dev.curr_mode].width;
285 int height = cam->cam_mode[sd->gspca_dev.curr_mode].height;
286 int ver_offs = cam->cam_mode[sd->gspca_dev.curr_mode].priv;
291 data = PO1030_SUBSAMPLING;
292 err = m5602_write_sensor(sd, PO1030_CONTROL3, &data, 1);
296 data = ((width + 3) >> 8) & 0xff;
297 err = m5602_write_sensor(sd, PO1030_WINDOWWIDTH_H, &data, 1);
301 data = (width + 3) & 0xff;
302 err = m5602_write_sensor(sd, PO1030_WINDOWWIDTH_L, &data, 1);
306 data = ((height + 1) >> 8) & 0xff;
307 err = m5602_write_sensor(sd, PO1030_WINDOWHEIGHT_H, &data, 1);
311 data = (height + 1) & 0xff;
312 err = m5602_write_sensor(sd, PO1030_WINDOWHEIGHT_L, &data, 1);
320 err = m5602_write_sensor(sd, PO1030_CONTROL3, &data, 1);
324 data = ((width + 7) >> 8) & 0xff;
325 err = m5602_write_sensor(sd, PO1030_WINDOWWIDTH_H, &data, 1);
329 data = (width + 7) & 0xff;
330 err = m5602_write_sensor(sd, PO1030_WINDOWWIDTH_L, &data, 1);
334 data = ((height + 3) >> 8) & 0xff;
335 err = m5602_write_sensor(sd, PO1030_WINDOWHEIGHT_H, &data, 1);
339 data = (height + 3) & 0xff;
340 err = m5602_write_sensor(sd, PO1030_WINDOWHEIGHT_L, &data, 1);
346 err = m5602_write_bridge(sd, M5602_XB_SENSOR_TYPE, 0x0c);
350 err = m5602_write_bridge(sd, M5602_XB_LINE_OF_FRAME_H, 0x81);
354 err = m5602_write_bridge(sd, M5602_XB_PIX_OF_LINE_H, 0x82);
358 err = m5602_write_bridge(sd, M5602_XB_SIG_INI, 0x01);
362 err = m5602_write_bridge(sd, M5602_XB_VSYNC_PARA,
363 ((ver_offs >> 8) & 0xff));
367 err = m5602_write_bridge(sd, M5602_XB_VSYNC_PARA, (ver_offs & 0xff));
371 for (i = 0; i < 2 && !err; i++)
372 err = m5602_write_bridge(sd, M5602_XB_VSYNC_PARA, 0);
376 err = m5602_write_bridge(sd, M5602_XB_VSYNC_PARA, (height >> 8) & 0xff);
380 err = m5602_write_bridge(sd, M5602_XB_VSYNC_PARA, (height & 0xff));
384 for (i = 0; i < 2 && !err; i++)
385 err = m5602_write_bridge(sd, M5602_XB_VSYNC_PARA, 0);
387 for (i = 0; i < 2 && !err; i++)
388 err = m5602_write_bridge(sd, M5602_XB_SIG_INI, 0);
390 for (i = 0; i < 2 && !err; i++)
391 err = m5602_write_bridge(sd, M5602_XB_HSYNC_PARA, 0);
395 err = m5602_write_bridge(sd, M5602_XB_HSYNC_PARA, (width >> 8) & 0xff);
399 err = m5602_write_bridge(sd, M5602_XB_HSYNC_PARA, (width & 0xff));
403 err = m5602_write_bridge(sd, M5602_XB_SIG_INI, 0);
407 static int po1030_set_exposure(struct gspca_dev *gspca_dev, __s32 val)
409 struct sd *sd = (struct sd *) gspca_dev;
413 gspca_dbg(gspca_dev, D_CONF, "Set exposure to %d\n", val & 0xffff);
415 i2c_data = ((val & 0xff00) >> 8);
416 gspca_dbg(gspca_dev, D_CONF, "Set exposure to high byte to 0x%x\n",
419 err = m5602_write_sensor(sd, PO1030_INTEGLINES_H,
424 i2c_data = (val & 0xff);
425 gspca_dbg(gspca_dev, D_CONF, "Set exposure to low byte to 0x%x\n",
427 err = m5602_write_sensor(sd, PO1030_INTEGLINES_M,
433 static int po1030_set_gain(struct gspca_dev *gspca_dev, __s32 val)
435 struct sd *sd = (struct sd *) gspca_dev;
439 i2c_data = val & 0xff;
440 gspca_dbg(gspca_dev, D_CONF, "Set global gain to %d\n", i2c_data);
441 err = m5602_write_sensor(sd, PO1030_GLOBALGAIN,
446 static int po1030_set_hvflip(struct gspca_dev *gspca_dev)
448 struct sd *sd = (struct sd *) gspca_dev;
452 gspca_dbg(gspca_dev, D_CONF, "Set hvflip %d %d\n",
453 sd->hflip->val, sd->vflip->val);
454 err = m5602_read_sensor(sd, PO1030_CONTROL2, &i2c_data, 1);
458 i2c_data = (0x3f & i2c_data) | (sd->hflip->val << 7) |
459 (sd->vflip->val << 6);
461 err = m5602_write_sensor(sd, PO1030_CONTROL2,
467 static int po1030_set_red_balance(struct gspca_dev *gspca_dev, __s32 val)
469 struct sd *sd = (struct sd *) gspca_dev;
473 i2c_data = val & 0xff;
474 gspca_dbg(gspca_dev, D_CONF, "Set red gain to %d\n", i2c_data);
475 err = m5602_write_sensor(sd, PO1030_RED_GAIN,
480 static int po1030_set_blue_balance(struct gspca_dev *gspca_dev, __s32 val)
482 struct sd *sd = (struct sd *) gspca_dev;
486 i2c_data = val & 0xff;
487 gspca_dbg(gspca_dev, D_CONF, "Set blue gain to %d\n", i2c_data);
488 err = m5602_write_sensor(sd, PO1030_BLUE_GAIN,
494 static int po1030_set_green_balance(struct gspca_dev *gspca_dev, __s32 val)
496 struct sd *sd = (struct sd *) gspca_dev;
500 i2c_data = val & 0xff;
501 gspca_dbg(gspca_dev, D_CONF, "Set green gain to %d\n", i2c_data);
503 err = m5602_write_sensor(sd, PO1030_GREEN_1_GAIN,
508 return m5602_write_sensor(sd, PO1030_GREEN_2_GAIN,
512 static int po1030_set_auto_white_balance(struct gspca_dev *gspca_dev,
515 struct sd *sd = (struct sd *) gspca_dev;
519 err = m5602_read_sensor(sd, PO1030_AUTOCTRL1, &i2c_data, 1);
523 gspca_dbg(gspca_dev, D_CONF, "Set auto white balance to %d\n", val);
524 i2c_data = (i2c_data & 0xfe) | (val & 0x01);
525 err = m5602_write_sensor(sd, PO1030_AUTOCTRL1, &i2c_data, 1);
529 static int po1030_set_auto_exposure(struct gspca_dev *gspca_dev,
532 struct sd *sd = (struct sd *) gspca_dev;
536 err = m5602_read_sensor(sd, PO1030_AUTOCTRL1, &i2c_data, 1);
540 gspca_dbg(gspca_dev, D_CONF, "Set auto exposure to %d\n", val);
541 val = (val == V4L2_EXPOSURE_AUTO);
542 i2c_data = (i2c_data & 0xfd) | ((val & 0x01) << 1);
543 return m5602_write_sensor(sd, PO1030_AUTOCTRL1, &i2c_data, 1);
546 void po1030_disconnect(struct sd *sd)
551 static int po1030_s_ctrl(struct v4l2_ctrl *ctrl)
553 struct gspca_dev *gspca_dev =
554 container_of(ctrl->handler, struct gspca_dev, ctrl_handler);
555 struct sd *sd = (struct sd *) gspca_dev;
558 if (!gspca_dev->streaming)
562 case V4L2_CID_AUTO_WHITE_BALANCE:
563 err = po1030_set_auto_white_balance(gspca_dev, ctrl->val);
564 if (err || ctrl->val)
566 err = po1030_set_green_balance(gspca_dev, sd->green_bal->val);
569 err = po1030_set_red_balance(gspca_dev, sd->red_bal->val);
572 err = po1030_set_blue_balance(gspca_dev, sd->blue_bal->val);
574 case V4L2_CID_EXPOSURE_AUTO:
575 err = po1030_set_auto_exposure(gspca_dev, ctrl->val);
576 if (err || ctrl->val == V4L2_EXPOSURE_AUTO)
578 err = po1030_set_exposure(gspca_dev, sd->expo->val);
581 err = po1030_set_gain(gspca_dev, ctrl->val);
584 err = po1030_set_hvflip(gspca_dev);
593 static void po1030_dump_registers(struct sd *sd)
598 pr_info("Dumping the po1030 sensor core registers\n");
599 for (address = 0; address < 0x7f; address++) {
600 m5602_read_sensor(sd, address, &value, 1);
601 pr_info("register 0x%x contains 0x%x\n", address, value);
604 pr_info("po1030 register state dump complete\n");
606 pr_info("Probing for which registers that are read/write\n");
607 for (address = 0; address < 0xff; address++) {
608 u8 old_value, ctrl_value;
609 u8 test_value[2] = {0xff, 0xff};
611 m5602_read_sensor(sd, address, &old_value, 1);
612 m5602_write_sensor(sd, address, test_value, 1);
613 m5602_read_sensor(sd, address, &ctrl_value, 1);
615 if (ctrl_value == test_value[0])
616 pr_info("register 0x%x is writeable\n", address);
618 pr_info("register 0x%x is read only\n", address);
620 /* Restore original value */
621 m5602_write_sensor(sd, address, &old_value, 1);