xref: /linux/drivers/media/usb/em28xx/em28xx-camera.c (revision e0bf6c5ca2d3281f231c5f0c9bf145e9513644de)
1 /*
2    em28xx-camera.c - driver for Empia EM25xx/27xx/28xx USB video capture devices
3 
4    Copyright (C) 2009 Mauro Carvalho Chehab <mchehab@infradead.org>
5    Copyright (C) 2013 Frank Schäfer <fschaefer.oss@googlemail.com>
6 
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 2 of the License, or
10    (at your option) any later version.
11 
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16 
17    You should have received a copy of the GNU General Public License
18    along with this program; if not, write to the Free Software
19    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 */
21 
22 #include <linux/i2c.h>
23 #include <media/soc_camera.h>
24 #include <media/mt9v011.h>
25 #include <media/v4l2-clk.h>
26 #include <media/v4l2-common.h>
27 
28 #include "em28xx.h"
29 
30 /* Possible i2c addresses of Micron sensors */
31 static unsigned short micron_sensor_addrs[] = {
32 	0xb8 >> 1,   /* MT9V111, MT9V403 */
33 	0xba >> 1,   /* MT9M001/011/111/112, MT9V011/012/112, MT9D011 */
34 	0x90 >> 1,   /* MT9V012/112, MT9D011 (alternative address) */
35 	I2C_CLIENT_END
36 };
37 
38 /* Possible i2c addresses of Omnivision sensors */
39 static unsigned short omnivision_sensor_addrs[] = {
40 	0x42 >> 1,   /* OV7725, OV7670/60/48 */
41 	0x60 >> 1,   /* OV2640, OV9650/53/55 */
42 	I2C_CLIENT_END
43 };
44 
45 static struct soc_camera_link camlink = {
46 	.bus_id = 0,
47 	.flags = 0,
48 	.module_name = "em28xx",
49 	.unbalanced_power = true,
50 };
51 
52 /* FIXME: Should be replaced by a proper mt9m111 driver */
53 static int em28xx_initialize_mt9m111(struct em28xx *dev)
54 {
55 	int i;
56 	unsigned char regs[][3] = {
57 		{ 0x0d, 0x00, 0x01, },  /* reset and use defaults */
58 		{ 0x0d, 0x00, 0x00, },
59 		{ 0x0a, 0x00, 0x21, },
60 		{ 0x21, 0x04, 0x00, },  /* full readout speed, no row/col skipping */
61 	};
62 
63 	for (i = 0; i < ARRAY_SIZE(regs); i++)
64 		i2c_master_send(&dev->i2c_client[dev->def_i2c_bus],
65 				&regs[i][0], 3);
66 
67 	return 0;
68 }
69 
70 /* FIXME: Should be replaced by a proper mt9m001 driver */
71 static int em28xx_initialize_mt9m001(struct em28xx *dev)
72 {
73 	int i;
74 	unsigned char regs[][3] = {
75 		{ 0x0d, 0x00, 0x01, },
76 		{ 0x0d, 0x00, 0x00, },
77 		{ 0x04, 0x05, 0x00, },	/* hres = 1280 */
78 		{ 0x03, 0x04, 0x00, },  /* vres = 1024 */
79 		{ 0x20, 0x11, 0x00, },
80 		{ 0x06, 0x00, 0x10, },
81 		{ 0x2b, 0x00, 0x24, },
82 		{ 0x2e, 0x00, 0x24, },
83 		{ 0x35, 0x00, 0x24, },
84 		{ 0x2d, 0x00, 0x20, },
85 		{ 0x2c, 0x00, 0x20, },
86 		{ 0x09, 0x0a, 0xd4, },
87 		{ 0x35, 0x00, 0x57, },
88 	};
89 
90 	for (i = 0; i < ARRAY_SIZE(regs); i++)
91 		i2c_master_send(&dev->i2c_client[dev->def_i2c_bus],
92 				&regs[i][0], 3);
93 
94 	return 0;
95 }
96 
97 /*
98  * Probes Micron sensors with 8 bit address and 16 bit register width
99  */
100 static int em28xx_probe_sensor_micron(struct em28xx *dev)
101 {
102 	int ret, i;
103 	char *name;
104 	u8 reg;
105 	__be16 id_be;
106 	u16 id;
107 
108 	struct i2c_client client = dev->i2c_client[dev->def_i2c_bus];
109 
110 	dev->em28xx_sensor = EM28XX_NOSENSOR;
111 	for (i = 0; micron_sensor_addrs[i] != I2C_CLIENT_END; i++) {
112 		client.addr = micron_sensor_addrs[i];
113 		/* NOTE: i2c_smbus_read_word_data() doesn't work with BE data */
114 		/* Read chip ID from register 0x00 */
115 		reg = 0x00;
116 		ret = i2c_master_send(&client, &reg, 1);
117 		if (ret < 0) {
118 			if (ret != -ENXIO)
119 				em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
120 					      client.addr << 1, ret);
121 			continue;
122 		}
123 		ret = i2c_master_recv(&client, (u8 *)&id_be, 2);
124 		if (ret < 0) {
125 			em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
126 				      client.addr << 1, ret);
127 			continue;
128 		}
129 		id = be16_to_cpu(id_be);
130 		/* Read chip ID from register 0xff */
131 		reg = 0xff;
132 		ret = i2c_master_send(&client, &reg, 1);
133 		if (ret < 0) {
134 			em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
135 				      client.addr << 1, ret);
136 			continue;
137 		}
138 		ret = i2c_master_recv(&client, (u8 *)&id_be, 2);
139 		if (ret < 0) {
140 			em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
141 				      client.addr << 1, ret);
142 			continue;
143 		}
144 		/* Validate chip ID to be sure we have a Micron device */
145 		if (id != be16_to_cpu(id_be))
146 			continue;
147 		/* Check chip ID */
148 		id = be16_to_cpu(id_be);
149 		switch (id) {
150 		case 0x1222:
151 			name = "MT9V012"; /* MI370 */ /* 640x480 */
152 			break;
153 		case 0x1229:
154 			name = "MT9V112"; /* 640x480 */
155 			break;
156 		case 0x1433:
157 			name = "MT9M011"; /* 1280x1024 */
158 			break;
159 		case 0x143a:    /* found in the ECS G200 */
160 			name = "MT9M111"; /* MI1310 */ /* 1280x1024 */
161 			dev->em28xx_sensor = EM28XX_MT9M111;
162 			break;
163 		case 0x148c:
164 			name = "MT9M112"; /* MI1320 */ /* 1280x1024 */
165 			break;
166 		case 0x1511:
167 			name = "MT9D011"; /* MI2010 */ /* 1600x1200 */
168 			break;
169 		case 0x8232:
170 		case 0x8243:	/* rev B */
171 			name = "MT9V011"; /* MI360 */ /* 640x480 */
172 			dev->em28xx_sensor = EM28XX_MT9V011;
173 			break;
174 		case 0x8431:
175 			name = "MT9M001"; /* 1280x1024 */
176 			dev->em28xx_sensor = EM28XX_MT9M001;
177 			break;
178 		default:
179 			em28xx_info("unknown Micron sensor detected: 0x%04x\n",
180 				    id);
181 			return 0;
182 		}
183 
184 		if (dev->em28xx_sensor == EM28XX_NOSENSOR)
185 			em28xx_info("unsupported sensor detected: %s\n", name);
186 		else
187 			em28xx_info("sensor %s detected\n", name);
188 
189 		dev->i2c_client[dev->def_i2c_bus].addr = client.addr;
190 		return 0;
191 	}
192 
193 	return -ENODEV;
194 }
195 
196 /*
197  * Probes Omnivision sensors with 8 bit address and register width
198  */
199 static int em28xx_probe_sensor_omnivision(struct em28xx *dev)
200 {
201 	int ret, i;
202 	char *name;
203 	u8 reg;
204 	u16 id;
205 	struct i2c_client client = dev->i2c_client[dev->def_i2c_bus];
206 
207 	dev->em28xx_sensor = EM28XX_NOSENSOR;
208 	/* NOTE: these devices have the register auto incrementation disabled
209 	 * by default, so we have to use single byte reads !              */
210 	for (i = 0; omnivision_sensor_addrs[i] != I2C_CLIENT_END; i++) {
211 		client.addr = omnivision_sensor_addrs[i];
212 		/* Read manufacturer ID from registers 0x1c-0x1d (BE) */
213 		reg = 0x1c;
214 		ret = i2c_smbus_read_byte_data(&client, reg);
215 		if (ret < 0) {
216 			if (ret != -ENXIO)
217 				em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
218 					      client.addr << 1, ret);
219 			continue;
220 		}
221 		id = ret << 8;
222 		reg = 0x1d;
223 		ret = i2c_smbus_read_byte_data(&client, reg);
224 		if (ret < 0) {
225 			em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
226 				      client.addr << 1, ret);
227 			continue;
228 		}
229 		id += ret;
230 		/* Check manufacturer ID */
231 		if (id != 0x7fa2)
232 			continue;
233 		/* Read product ID from registers 0x0a-0x0b (BE) */
234 		reg = 0x0a;
235 		ret = i2c_smbus_read_byte_data(&client, reg);
236 		if (ret < 0) {
237 			em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
238 				      client.addr << 1, ret);
239 			continue;
240 		}
241 		id = ret << 8;
242 		reg = 0x0b;
243 		ret = i2c_smbus_read_byte_data(&client, reg);
244 		if (ret < 0) {
245 			em28xx_errdev("couldn't read from i2c device 0x%02x: error %i\n",
246 				      client.addr << 1, ret);
247 			continue;
248 		}
249 		id += ret;
250 		/* Check product ID */
251 		switch (id) {
252 		case 0x2642:
253 			name = "OV2640";
254 			dev->em28xx_sensor = EM28XX_OV2640;
255 			break;
256 		case 0x7648:
257 			name = "OV7648";
258 			break;
259 		case 0x7660:
260 			name = "OV7660";
261 			break;
262 		case 0x7673:
263 			name = "OV7670";
264 			break;
265 		case 0x7720:
266 			name = "OV7720";
267 			break;
268 		case 0x7721:
269 			name = "OV7725";
270 			break;
271 		case 0x9648: /* Rev 2 */
272 		case 0x9649: /* Rev 3 */
273 			name = "OV9640";
274 			break;
275 		case 0x9650:
276 		case 0x9652: /* OV9653 */
277 			name = "OV9650";
278 			break;
279 		case 0x9656: /* Rev 4 */
280 		case 0x9657: /* Rev 5 */
281 			name = "OV9655";
282 			break;
283 		default:
284 			em28xx_info("unknown OmniVision sensor detected: 0x%04x\n",
285 				    id);
286 			return 0;
287 		}
288 
289 		if (dev->em28xx_sensor == EM28XX_NOSENSOR)
290 			em28xx_info("unsupported sensor detected: %s\n", name);
291 		else
292 			em28xx_info("sensor %s detected\n", name);
293 
294 		dev->i2c_client[dev->def_i2c_bus].addr = client.addr;
295 		return 0;
296 	}
297 
298 	return -ENODEV;
299 }
300 
301 int em28xx_detect_sensor(struct em28xx *dev)
302 {
303 	int ret;
304 
305 	ret = em28xx_probe_sensor_micron(dev);
306 
307 	if (dev->em28xx_sensor == EM28XX_NOSENSOR && ret < 0)
308 		ret = em28xx_probe_sensor_omnivision(dev);
309 
310 	/*
311 	 * NOTE: the Windows driver also probes i2c addresses
312 	 *       0x22 (Samsung ?) and 0x66 (Kodak ?)
313 	 */
314 
315 	if (dev->em28xx_sensor == EM28XX_NOSENSOR && ret < 0) {
316 		em28xx_info("No sensor detected\n");
317 		return -ENODEV;
318 	}
319 
320 	return 0;
321 }
322 
323 int em28xx_init_camera(struct em28xx *dev)
324 {
325 	char clk_name[V4L2_SUBDEV_NAME_SIZE];
326 	struct i2c_client *client = &dev->i2c_client[dev->def_i2c_bus];
327 	struct i2c_adapter *adap = &dev->i2c_adap[dev->def_i2c_bus];
328 	struct em28xx_v4l2 *v4l2 = dev->v4l2;
329 	int ret = 0;
330 
331 	v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
332 			  i2c_adapter_id(adap), client->addr);
333 	v4l2->clk = v4l2_clk_register_fixed(clk_name, "mclk", -EINVAL);
334 	if (IS_ERR(v4l2->clk))
335 		return PTR_ERR(v4l2->clk);
336 
337 	switch (dev->em28xx_sensor) {
338 	case EM28XX_MT9V011:
339 	{
340 		struct mt9v011_platform_data pdata;
341 		struct i2c_board_info mt9v011_info = {
342 			.type = "mt9v011",
343 			.addr = client->addr,
344 			.platform_data = &pdata,
345 		};
346 
347 		v4l2->sensor_xres = 640;
348 		v4l2->sensor_yres = 480;
349 
350 		/*
351 		 * FIXME: mt9v011 uses I2S speed as xtal clk - at least with
352 		 * the Silvercrest cam I have here for testing - for higher
353 		 * resolutions, a high clock cause horizontal artifacts, so we
354 		 * need to use a lower xclk frequency.
355 		 * Yet, it would be possible to adjust xclk depending on the
356 		 * desired resolution, since this affects directly the
357 		 * frame rate.
358 		 */
359 		dev->board.xclk = EM28XX_XCLK_FREQUENCY_4_3MHZ;
360 		em28xx_write_reg(dev, EM28XX_R0F_XCLK, dev->board.xclk);
361 		v4l2->sensor_xtal = 4300000;
362 		pdata.xtal = v4l2->sensor_xtal;
363 		if (NULL ==
364 		    v4l2_i2c_new_subdev_board(&v4l2->v4l2_dev, adap,
365 					      &mt9v011_info, NULL)) {
366 			ret = -ENODEV;
367 			break;
368 		}
369 		/* probably means GRGB 16 bit bayer */
370 		v4l2->vinmode = 0x0d;
371 		v4l2->vinctl = 0x00;
372 
373 		break;
374 	}
375 	case EM28XX_MT9M001:
376 		v4l2->sensor_xres = 1280;
377 		v4l2->sensor_yres = 1024;
378 
379 		em28xx_initialize_mt9m001(dev);
380 
381 		/* probably means BGGR 16 bit bayer */
382 		v4l2->vinmode = 0x0c;
383 		v4l2->vinctl = 0x00;
384 
385 		break;
386 	case EM28XX_MT9M111:
387 		v4l2->sensor_xres = 640;
388 		v4l2->sensor_yres = 512;
389 
390 		dev->board.xclk = EM28XX_XCLK_FREQUENCY_48MHZ;
391 		em28xx_write_reg(dev, EM28XX_R0F_XCLK, dev->board.xclk);
392 		em28xx_initialize_mt9m111(dev);
393 
394 		v4l2->vinmode = 0x0a;
395 		v4l2->vinctl = 0x00;
396 
397 		break;
398 	case EM28XX_OV2640:
399 	{
400 		struct v4l2_subdev *subdev;
401 		struct i2c_board_info ov2640_info = {
402 			.type = "ov2640",
403 			.flags = I2C_CLIENT_SCCB,
404 			.addr = client->addr,
405 			.platform_data = &camlink,
406 		};
407 		struct v4l2_mbus_framefmt fmt;
408 
409 		/*
410 		 * FIXME: sensor supports resolutions up to 1600x1200, but
411 		 * resolution setting/switching needs to be modified to
412 		 * - switch sensor output resolution (including further
413 		 *   configuration changes)
414 		 * - adjust bridge xclk
415 		 * - disable 16 bit (12 bit) output formats on high resolutions
416 		 */
417 		v4l2->sensor_xres = 640;
418 		v4l2->sensor_yres = 480;
419 
420 		subdev =
421 		     v4l2_i2c_new_subdev_board(&v4l2->v4l2_dev, adap,
422 					       &ov2640_info, NULL);
423 		if (NULL == subdev) {
424 			ret = -ENODEV;
425 			break;
426 		}
427 
428 		fmt.code = MEDIA_BUS_FMT_YUYV8_2X8;
429 		fmt.width = 640;
430 		fmt.height = 480;
431 		v4l2_subdev_call(subdev, video, s_mbus_fmt, &fmt);
432 
433 		/* NOTE: for UXGA=1600x1200 switch to 12MHz */
434 		dev->board.xclk = EM28XX_XCLK_FREQUENCY_24MHZ;
435 		em28xx_write_reg(dev, EM28XX_R0F_XCLK, dev->board.xclk);
436 		v4l2->vinmode = 0x08;
437 		v4l2->vinctl = 0x00;
438 
439 		break;
440 	}
441 	case EM28XX_NOSENSOR:
442 	default:
443 		ret = -EINVAL;
444 	}
445 
446 	if (ret < 0) {
447 		v4l2_clk_unregister_fixed(v4l2->clk);
448 		v4l2->clk = NULL;
449 	}
450 
451 	return ret;
452 }
453 EXPORT_SYMBOL_GPL(em28xx_init_camera);
454