2 * Driver for the s5k4aa 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 * This program is free software; you can redistribute it and/or
14 * modify it under the terms of the GNU General Public License as
15 * published by the Free Software Foundation, version 2.
19 #include "m5602_s5k4aa.h"
23 struct dmi_system_id s5k4aa_vflip_dmi_table[] = {
25 .ident = "Fujitsu-Siemens Amilo Xa 2528",
27 DMI_MATCH(DMI_SYS_VENDOR, "FUJITSU SIEMENS"),
28 DMI_MATCH(DMI_PRODUCT_NAME, "AMILO Xa 2528")
31 .ident = "Fujitsu-Siemens Amilo Xi 2550",
33 DMI_MATCH(DMI_SYS_VENDOR, "FUJITSU SIEMENS"),
34 DMI_MATCH(DMI_PRODUCT_NAME, "AMILO Xi 2550")
39 DMI_MATCH(DMI_SYS_VENDOR, "Micro-Star International"),
40 DMI_MATCH(DMI_PRODUCT_NAME, "GX700"),
41 DMI_MATCH(DMI_BIOS_DATE, "07/26/2007")
44 .ident = "MSI GX700/GX705/EX700",
46 DMI_MATCH(DMI_SYS_VENDOR, "Micro-Star International"),
47 DMI_MATCH(DMI_PRODUCT_NAME, "GX700/GX705/EX700")
53 static void s5k4aa_dump_registers(struct sd *sd);
55 int s5k4aa_probe(struct sd *sd)
57 u8 prod_id[6] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
58 const u8 expected_prod_id[6] = {0x00, 0x10, 0x00, 0x4b, 0x33, 0x75};
62 if (force_sensor == S5K4AA_SENSOR) {
63 info("Forcing a %s sensor", s5k4aa.name);
66 /* If we want to force another sensor, don't try to probe this
71 info("Probing for a s5k4aa sensor");
73 /* Preinit the sensor */
74 for (i = 0; i < ARRAY_SIZE(preinit_s5k4aa) && !err; i++) {
75 u8 data[2] = {0x00, 0x00};
77 switch (preinit_s5k4aa[i][0]) {
79 err = m5602_write_bridge(sd,
81 preinit_s5k4aa[i][2]);
85 data[0] = preinit_s5k4aa[i][2];
86 err = m5602_write_sensor(sd,
92 data[0] = preinit_s5k4aa[i][2];
93 data[1] = preinit_s5k4aa[i][3];
94 err = m5602_write_sensor(sd,
99 info("Invalid stream command, exiting init");
104 /* Test some registers, but we don't know their exact meaning yet */
105 if (m5602_read_sensor(sd, 0x00, prod_id, sizeof(prod_id)))
108 if (memcmp(prod_id, expected_prod_id, sizeof(prod_id)))
111 info("Detected a s5k4aa sensor");
114 sd->gspca_dev.cam.cam_mode = s5k4aa.modes;
115 sd->gspca_dev.cam.nmodes = s5k4aa.nmodes;
116 sd->desc->ctrls = s5k4aa.ctrls;
117 sd->desc->nctrls = s5k4aa.nctrls;
122 int s5k4aa_init(struct sd *sd)
126 for (i = 0; i < ARRAY_SIZE(init_s5k4aa) && !err; i++) {
127 u8 data[2] = {0x00, 0x00};
129 switch (init_s5k4aa[i][0]) {
131 err = m5602_write_bridge(sd,
137 data[0] = init_s5k4aa[i][2];
138 err = m5602_write_sensor(sd,
139 init_s5k4aa[i][1], data, 1);
143 data[0] = init_s5k4aa[i][2];
144 data[1] = init_s5k4aa[i][3];
145 err = m5602_write_sensor(sd,
146 init_s5k4aa[i][1], data, 2);
149 info("Invalid stream command, exiting init");
155 s5k4aa_dump_registers(sd);
157 if (!err && dmi_check_system(s5k4aa_vflip_dmi_table)) {
159 info("vertical flip quirk active");
160 m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
161 m5602_read_sensor(sd, S5K4AA_READ_MODE, &data, 1);
162 data |= S5K4AA_RM_V_FLIP;
163 data &= ~S5K4AA_RM_H_FLIP;
164 m5602_write_sensor(sd, S5K4AA_READ_MODE, &data, 1);
166 /* Decrement COLSTART to preserve color order (BGGR) */
167 m5602_read_sensor(sd, S5K4AA_COLSTART_LO, &data, 1);
169 m5602_write_sensor(sd, S5K4AA_COLSTART_LO, &data, 1);
171 /* Increment ROWSTART to preserve color order (BGGR) */
172 m5602_read_sensor(sd, S5K4AA_ROWSTART_LO, &data, 1);
174 m5602_write_sensor(sd, S5K4AA_ROWSTART_LO, &data, 1);
177 return (err < 0) ? err : 0;
180 int s5k4aa_power_down(struct sd *sd)
185 int s5k4aa_get_exposure(struct gspca_dev *gspca_dev, __s32 *val)
187 struct sd *sd = (struct sd *) gspca_dev;
188 u8 data = S5K4AA_PAGE_MAP_2;
191 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
195 err = m5602_read_sensor(sd, S5K4AA_EXPOSURE_HI, &data, 1);
200 err = m5602_read_sensor(sd, S5K4AA_EXPOSURE_LO, &data, 1);
202 PDEBUG(D_V4L2, "Read exposure %d", *val);
207 int s5k4aa_set_exposure(struct gspca_dev *gspca_dev, __s32 val)
209 struct sd *sd = (struct sd *) gspca_dev;
210 u8 data = S5K4AA_PAGE_MAP_2;
213 PDEBUG(D_V4L2, "Set exposure to %d", val);
214 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
217 data = (val >> 8) & 0xff;
218 err = m5602_write_sensor(sd, S5K4AA_EXPOSURE_HI, &data, 1);
222 err = m5602_write_sensor(sd, S5K4AA_EXPOSURE_LO, &data, 1);
227 int s5k4aa_get_vflip(struct gspca_dev *gspca_dev, __s32 *val)
229 struct sd *sd = (struct sd *) gspca_dev;
230 u8 data = S5K4AA_PAGE_MAP_2;
233 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
237 err = m5602_read_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
238 *val = (data & S5K4AA_RM_V_FLIP) >> 7;
239 PDEBUG(D_V4L2, "Read vertical flip %d", *val);
245 int s5k4aa_set_vflip(struct gspca_dev *gspca_dev, __s32 val)
247 struct sd *sd = (struct sd *) gspca_dev;
248 u8 data = S5K4AA_PAGE_MAP_2;
251 PDEBUG(D_V4L2, "Set vertical flip to %d", val);
252 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
255 err = m5602_write_sensor(sd, S5K4AA_READ_MODE, &data, 1);
258 data = ((data & ~S5K4AA_RM_V_FLIP)
259 | ((val & 0x01) << 7));
260 err = m5602_write_sensor(sd, S5K4AA_READ_MODE, &data, 1);
265 err = m5602_read_sensor(sd, S5K4AA_ROWSTART_LO, &data, 1);
270 err = m5602_write_sensor(sd, S5K4AA_ROWSTART_LO, &data, 1);
272 err = m5602_read_sensor(sd, S5K4AA_ROWSTART_LO, &data, 1);
277 err = m5602_write_sensor(sd, S5K4AA_ROWSTART_LO, &data, 1);
283 int s5k4aa_get_hflip(struct gspca_dev *gspca_dev, __s32 *val)
285 struct sd *sd = (struct sd *) gspca_dev;
286 u8 data = S5K4AA_PAGE_MAP_2;
289 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
293 err = m5602_read_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
294 *val = (data & S5K4AA_RM_H_FLIP) >> 6;
295 PDEBUG(D_V4L2, "Read horizontal flip %d", *val);
300 int s5k4aa_set_hflip(struct gspca_dev *gspca_dev, __s32 val)
302 struct sd *sd = (struct sd *) gspca_dev;
303 u8 data = S5K4AA_PAGE_MAP_2;
306 PDEBUG(D_V4L2, "Set horizontal flip to %d",
308 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
311 err = m5602_write_sensor(sd, S5K4AA_READ_MODE, &data, 1);
315 data = ((data & ~S5K4AA_RM_H_FLIP) | ((val & 0x01) << 6));
316 err = m5602_write_sensor(sd, S5K4AA_READ_MODE, &data, 1);
321 err = m5602_read_sensor(sd, S5K4AA_COLSTART_LO, &data, 1);
325 err = m5602_write_sensor(sd, S5K4AA_COLSTART_LO, &data, 1);
329 err = m5602_read_sensor(sd, S5K4AA_COLSTART_LO, &data, 1);
333 err = m5602_write_sensor(sd, S5K4AA_COLSTART_LO, &data, 1);
339 int s5k4aa_get_gain(struct gspca_dev *gspca_dev, __s32 *val)
341 struct sd *sd = (struct sd *) gspca_dev;
342 u8 data = S5K4AA_PAGE_MAP_2;
345 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
349 err = m5602_read_sensor(sd, S5K4AA_GAIN_2, &data, 1);
351 PDEBUG(D_V4L2, "Read gain %d", *val);
357 int s5k4aa_set_gain(struct gspca_dev *gspca_dev, __s32 val)
359 struct sd *sd = (struct sd *) gspca_dev;
360 u8 data = S5K4AA_PAGE_MAP_2;
363 PDEBUG(D_V4L2, "Set gain to %d", val);
364 err = m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &data, 1);
369 err = m5602_write_sensor(sd, S5K4AA_GAIN_2, &data, 1);
375 static void s5k4aa_dump_registers(struct sd *sd)
379 m5602_read_sensor(sd, S5K4AA_PAGE_MAP, &old_page, 1);
380 for (page = 0; page < 16; page++) {
381 m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &page, 1);
382 info("Dumping the s5k4aa register state for page 0x%x", page);
383 for (address = 0; address <= 0xff; address++) {
385 m5602_read_sensor(sd, address, &value, 1);
386 info("register 0x%x contains 0x%x",
390 info("s5k4aa register state dump complete");
392 for (page = 0; page < 16; page++) {
393 m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &page, 1);
394 info("Probing for which registers that are "
395 "read/write for page 0x%x", page);
396 for (address = 0; address <= 0xff; address++) {
397 u8 old_value, ctrl_value, test_value = 0xff;
399 m5602_read_sensor(sd, address, &old_value, 1);
400 m5602_write_sensor(sd, address, &test_value, 1);
401 m5602_read_sensor(sd, address, &ctrl_value, 1);
403 if (ctrl_value == test_value)
404 info("register 0x%x is writeable", address);
406 info("register 0x%x is read only", address);
408 /* Restore original value */
409 m5602_write_sensor(sd, address, &old_value, 1);
412 info("Read/write register probing complete");
413 m5602_write_sensor(sd, S5K4AA_PAGE_MAP, &old_page, 1);