• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Driver for M-5MOLS 8M Pixel camera sensor with ISP
3  *
4  * Copyright (C) 2011 Samsung Electronics Co., Ltd.
5  * Author: HeungJun Kim <riverful.kim@samsung.com>
6  *
7  * Copyright (C) 2009 Samsung Electronics Co., Ltd.
8  * Author: Dongsoo Nathaniel Kim <dongsoo45.kim@samsung.com>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  */
15 
16 #include <linux/i2c.h>
17 #include <linux/slab.h>
18 #include <linux/irq.h>
19 #include <linux/interrupt.h>
20 #include <linux/delay.h>
21 #include <linux/gpio.h>
22 #include <linux/regulator/consumer.h>
23 #include <linux/videodev2.h>
24 #include <linux/module.h>
25 #include <media/v4l2-ctrls.h>
26 #include <media/v4l2-device.h>
27 #include <media/v4l2-subdev.h>
28 #include <media/i2c/m5mols.h>
29 
30 #include "m5mols.h"
31 #include "m5mols_reg.h"
32 
33 int m5mols_debug;
34 module_param(m5mols_debug, int, 0644);
35 
36 #define MODULE_NAME		"M5MOLS"
37 #define M5MOLS_I2C_CHECK_RETRY	500
38 
39 /* The regulator consumer names for external voltage regulators */
40 static struct regulator_bulk_data supplies[] = {
41 	{
42 		.supply = "core",	/* ARM core power, 1.2V */
43 	}, {
44 		.supply	= "dig_18",	/* digital power 1, 1.8V */
45 	}, {
46 		.supply	= "d_sensor",	/* sensor power 1, 1.8V */
47 	}, {
48 		.supply	= "dig_28",	/* digital power 2, 2.8V */
49 	}, {
50 		.supply	= "a_sensor",	/* analog power */
51 	}, {
52 		.supply	= "dig_12",	/* digital power 3, 1.2V */
53 	},
54 };
55 
56 static struct v4l2_mbus_framefmt m5mols_default_ffmt[M5MOLS_RESTYPE_MAX] = {
57 	[M5MOLS_RESTYPE_MONITOR] = {
58 		.width		= 1920,
59 		.height		= 1080,
60 		.code		= MEDIA_BUS_FMT_VYUY8_2X8,
61 		.field		= V4L2_FIELD_NONE,
62 		.colorspace	= V4L2_COLORSPACE_JPEG,
63 	},
64 	[M5MOLS_RESTYPE_CAPTURE] = {
65 		.width		= 1920,
66 		.height		= 1080,
67 		.code		= MEDIA_BUS_FMT_JPEG_1X8,
68 		.field		= V4L2_FIELD_NONE,
69 		.colorspace	= V4L2_COLORSPACE_JPEG,
70 	},
71 };
72 #define SIZE_DEFAULT_FFMT	ARRAY_SIZE(m5mols_default_ffmt)
73 
74 static const struct m5mols_resolution m5mols_reg_res[] = {
75 	{ 0x01, M5MOLS_RESTYPE_MONITOR, 128, 96 },	/* SUB-QCIF */
76 	{ 0x03, M5MOLS_RESTYPE_MONITOR, 160, 120 },	/* QQVGA */
77 	{ 0x05, M5MOLS_RESTYPE_MONITOR, 176, 144 },	/* QCIF */
78 	{ 0x06, M5MOLS_RESTYPE_MONITOR, 176, 176 },
79 	{ 0x08, M5MOLS_RESTYPE_MONITOR, 240, 320 },	/* QVGA */
80 	{ 0x09, M5MOLS_RESTYPE_MONITOR, 320, 240 },	/* QVGA */
81 	{ 0x0c, M5MOLS_RESTYPE_MONITOR, 240, 400 },	/* WQVGA */
82 	{ 0x0d, M5MOLS_RESTYPE_MONITOR, 400, 240 },	/* WQVGA */
83 	{ 0x0e, M5MOLS_RESTYPE_MONITOR, 352, 288 },	/* CIF */
84 	{ 0x13, M5MOLS_RESTYPE_MONITOR, 480, 360 },
85 	{ 0x15, M5MOLS_RESTYPE_MONITOR, 640, 360 },	/* qHD */
86 	{ 0x17, M5MOLS_RESTYPE_MONITOR, 640, 480 },	/* VGA */
87 	{ 0x18, M5MOLS_RESTYPE_MONITOR, 720, 480 },
88 	{ 0x1a, M5MOLS_RESTYPE_MONITOR, 800, 480 },	/* WVGA */
89 	{ 0x1f, M5MOLS_RESTYPE_MONITOR, 800, 600 },	/* SVGA */
90 	{ 0x21, M5MOLS_RESTYPE_MONITOR, 1280, 720 },	/* HD */
91 	{ 0x25, M5MOLS_RESTYPE_MONITOR, 1920, 1080 },	/* 1080p */
92 	{ 0x29, M5MOLS_RESTYPE_MONITOR, 3264, 2448 },	/* 2.63fps 8M */
93 	{ 0x39, M5MOLS_RESTYPE_MONITOR, 800, 602 },	/* AHS_MON debug */
94 
95 	{ 0x02, M5MOLS_RESTYPE_CAPTURE, 320, 240 },	/* QVGA */
96 	{ 0x04, M5MOLS_RESTYPE_CAPTURE, 400, 240 },	/* WQVGA */
97 	{ 0x07, M5MOLS_RESTYPE_CAPTURE, 480, 360 },
98 	{ 0x08, M5MOLS_RESTYPE_CAPTURE, 640, 360 },	/* qHD */
99 	{ 0x09, M5MOLS_RESTYPE_CAPTURE, 640, 480 },	/* VGA */
100 	{ 0x0a, M5MOLS_RESTYPE_CAPTURE, 800, 480 },	/* WVGA */
101 	{ 0x10, M5MOLS_RESTYPE_CAPTURE, 1280, 720 },	/* HD */
102 	{ 0x14, M5MOLS_RESTYPE_CAPTURE, 1280, 960 },	/* 1M */
103 	{ 0x17, M5MOLS_RESTYPE_CAPTURE, 1600, 1200 },	/* 2M */
104 	{ 0x19, M5MOLS_RESTYPE_CAPTURE, 1920, 1080 },	/* Full-HD */
105 	{ 0x1a, M5MOLS_RESTYPE_CAPTURE, 2048, 1152 },	/* 3Mega */
106 	{ 0x1b, M5MOLS_RESTYPE_CAPTURE, 2048, 1536 },
107 	{ 0x1c, M5MOLS_RESTYPE_CAPTURE, 2560, 1440 },	/* 4Mega */
108 	{ 0x1d, M5MOLS_RESTYPE_CAPTURE, 2560, 1536 },
109 	{ 0x1f, M5MOLS_RESTYPE_CAPTURE, 2560, 1920 },	/* 5Mega */
110 	{ 0x21, M5MOLS_RESTYPE_CAPTURE, 3264, 1836 },	/* 6Mega */
111 	{ 0x22, M5MOLS_RESTYPE_CAPTURE, 3264, 1960 },
112 	{ 0x25, M5MOLS_RESTYPE_CAPTURE, 3264, 2448 },	/* 8Mega */
113 };
114 
115 /**
116  * m5mols_swap_byte - an byte array to integer conversion function
117  * @data: byte array
118  * @length: size in bytes of I2C packet defined in the M-5MOLS datasheet
119  *
120  * Convert I2C data byte array with performing any required byte
121  * reordering to assure proper values for each data type, regardless
122  * of the architecture endianness.
123  */
m5mols_swap_byte(u8 * data,u8 length)124 static u32 m5mols_swap_byte(u8 *data, u8 length)
125 {
126 	if (length == 1)
127 		return *data;
128 	else if (length == 2)
129 		return be16_to_cpu(*((__be16 *)data));
130 	else
131 		return be32_to_cpu(*((__be32 *)data));
132 }
133 
134 /**
135  * m5mols_read -  I2C read function
136  * @sd: sub-device, as pointed by struct v4l2_subdev
137  * @size: desired size of I2C packet
138  * @reg: combination of size, category and command for the I2C packet
139  * @val: read value
140  *
141  * Returns 0 on success, or else negative errno.
142  */
m5mols_read(struct v4l2_subdev * sd,u32 size,u32 reg,u32 * val)143 static int m5mols_read(struct v4l2_subdev *sd, u32 size, u32 reg, u32 *val)
144 {
145 	struct i2c_client *client = v4l2_get_subdevdata(sd);
146 	struct m5mols_info *info = to_m5mols(sd);
147 	u8 rbuf[M5MOLS_I2C_MAX_SIZE + 1];
148 	u8 category = I2C_CATEGORY(reg);
149 	u8 cmd = I2C_COMMAND(reg);
150 	struct i2c_msg msg[2];
151 	u8 wbuf[5];
152 	int ret;
153 
154 	if (!client->adapter)
155 		return -ENODEV;
156 
157 	msg[0].addr = client->addr;
158 	msg[0].flags = 0;
159 	msg[0].len = 5;
160 	msg[0].buf = wbuf;
161 	wbuf[0] = 5;
162 	wbuf[1] = M5MOLS_BYTE_READ;
163 	wbuf[2] = category;
164 	wbuf[3] = cmd;
165 	wbuf[4] = size;
166 
167 	msg[1].addr = client->addr;
168 	msg[1].flags = I2C_M_RD;
169 	msg[1].len = size + 1;
170 	msg[1].buf = rbuf;
171 
172 	/* minimum stabilization time */
173 	usleep_range(200, 300);
174 
175 	ret = i2c_transfer(client->adapter, msg, 2);
176 
177 	if (ret == 2) {
178 		*val = m5mols_swap_byte(&rbuf[1], size);
179 		return 0;
180 	}
181 
182 	if (info->isp_ready)
183 		v4l2_err(sd, "read failed: size:%d cat:%02x cmd:%02x. %d\n",
184 			 size, category, cmd, ret);
185 
186 	return ret < 0 ? ret : -EIO;
187 }
188 
m5mols_read_u8(struct v4l2_subdev * sd,u32 reg,u8 * val)189 int m5mols_read_u8(struct v4l2_subdev *sd, u32 reg, u8 *val)
190 {
191 	u32 val_32;
192 	int ret;
193 
194 	if (I2C_SIZE(reg) != 1) {
195 		v4l2_err(sd, "Wrong data size\n");
196 		return -EINVAL;
197 	}
198 
199 	ret = m5mols_read(sd, I2C_SIZE(reg), reg, &val_32);
200 	if (ret)
201 		return ret;
202 
203 	*val = (u8)val_32;
204 	return ret;
205 }
206 
m5mols_read_u16(struct v4l2_subdev * sd,u32 reg,u16 * val)207 int m5mols_read_u16(struct v4l2_subdev *sd, u32 reg, u16 *val)
208 {
209 	u32 val_32;
210 	int ret;
211 
212 	if (I2C_SIZE(reg) != 2) {
213 		v4l2_err(sd, "Wrong data size\n");
214 		return -EINVAL;
215 	}
216 
217 	ret = m5mols_read(sd, I2C_SIZE(reg), reg, &val_32);
218 	if (ret)
219 		return ret;
220 
221 	*val = (u16)val_32;
222 	return ret;
223 }
224 
m5mols_read_u32(struct v4l2_subdev * sd,u32 reg,u32 * val)225 int m5mols_read_u32(struct v4l2_subdev *sd, u32 reg, u32 *val)
226 {
227 	if (I2C_SIZE(reg) != 4) {
228 		v4l2_err(sd, "Wrong data size\n");
229 		return -EINVAL;
230 	}
231 
232 	return m5mols_read(sd, I2C_SIZE(reg), reg, val);
233 }
234 
235 /**
236  * m5mols_write - I2C command write function
237  * @sd: sub-device, as pointed by struct v4l2_subdev
238  * @reg: combination of size, category and command for the I2C packet
239  * @val: value to write
240  *
241  * Returns 0 on success, or else negative errno.
242  */
m5mols_write(struct v4l2_subdev * sd,u32 reg,u32 val)243 int m5mols_write(struct v4l2_subdev *sd, u32 reg, u32 val)
244 {
245 	struct i2c_client *client = v4l2_get_subdevdata(sd);
246 	struct m5mols_info *info = to_m5mols(sd);
247 	u8 wbuf[M5MOLS_I2C_MAX_SIZE + 4];
248 	u8 category = I2C_CATEGORY(reg);
249 	u8 cmd = I2C_COMMAND(reg);
250 	u8 size	= I2C_SIZE(reg);
251 	u32 *buf = (u32 *)&wbuf[4];
252 	struct i2c_msg msg[1];
253 	int ret;
254 
255 	if (!client->adapter)
256 		return -ENODEV;
257 
258 	if (size != 1 && size != 2 && size != 4) {
259 		v4l2_err(sd, "Wrong data size\n");
260 		return -EINVAL;
261 	}
262 
263 	msg->addr = client->addr;
264 	msg->flags = 0;
265 	msg->len = (u16)size + 4;
266 	msg->buf = wbuf;
267 	wbuf[0] = size + 4;
268 	wbuf[1] = M5MOLS_BYTE_WRITE;
269 	wbuf[2] = category;
270 	wbuf[3] = cmd;
271 
272 	*buf = m5mols_swap_byte((u8 *)&val, size);
273 
274 	/* minimum stabilization time */
275 	usleep_range(200, 300);
276 
277 	ret = i2c_transfer(client->adapter, msg, 1);
278 	if (ret == 1)
279 		return 0;
280 
281 	if (info->isp_ready)
282 		v4l2_err(sd, "write failed: cat:%02x cmd:%02x ret:%d\n",
283 			 category, cmd, ret);
284 
285 	return ret < 0 ? ret : -EIO;
286 }
287 
288 /**
289  * m5mols_busy_wait - Busy waiting with I2C register polling
290  * @sd: sub-device, as pointed by struct v4l2_subdev
291  * @reg: the I2C_REG() address of an 8-bit status register to check
292  * @value: expected status register value
293  * @mask: bit mask for the read status register value
294  * @timeout: timeout in miliseconds, or -1 for default timeout
295  *
296  * The @reg register value is ORed with @mask before comparing with @value.
297  *
298  * Return: 0 if the requested condition became true within less than
299  *         @timeout ms, or else negative errno.
300  */
m5mols_busy_wait(struct v4l2_subdev * sd,u32 reg,u32 value,u32 mask,int timeout)301 int m5mols_busy_wait(struct v4l2_subdev *sd, u32 reg, u32 value, u32 mask,
302 		     int timeout)
303 {
304 	int ms = timeout < 0 ? M5MOLS_BUSY_WAIT_DEF_TIMEOUT : timeout;
305 	unsigned long end = jiffies + msecs_to_jiffies(ms);
306 	u8 status;
307 
308 	do {
309 		int ret = m5mols_read_u8(sd, reg, &status);
310 
311 		if (ret < 0 && !(mask & M5MOLS_I2C_RDY_WAIT_FL))
312 			return ret;
313 		if (!ret && (status & mask & 0xff) == (value & 0xff))
314 			return 0;
315 		usleep_range(100, 250);
316 	} while (ms > 0 && time_is_after_jiffies(end));
317 
318 	return -EBUSY;
319 }
320 
321 /**
322  * m5mols_enable_interrupt - Clear interrupt pending bits and unmask interrupts
323  * @sd: sub-device, as pointed by struct v4l2_subdev
324  * @reg: combination of size, category and command for the I2C packet
325  *
326  * Before writing desired interrupt value the INT_FACTOR register should
327  * be read to clear pending interrupts.
328  */
m5mols_enable_interrupt(struct v4l2_subdev * sd,u8 reg)329 int m5mols_enable_interrupt(struct v4l2_subdev *sd, u8 reg)
330 {
331 	struct m5mols_info *info = to_m5mols(sd);
332 	u8 mask = is_available_af(info) ? REG_INT_AF : 0;
333 	u8 dummy;
334 	int ret;
335 
336 	ret = m5mols_read_u8(sd, SYSTEM_INT_FACTOR, &dummy);
337 	if (!ret)
338 		ret = m5mols_write(sd, SYSTEM_INT_ENABLE, reg & ~mask);
339 	return ret;
340 }
341 
m5mols_wait_interrupt(struct v4l2_subdev * sd,u8 irq_mask,u32 timeout)342 int m5mols_wait_interrupt(struct v4l2_subdev *sd, u8 irq_mask, u32 timeout)
343 {
344 	struct m5mols_info *info = to_m5mols(sd);
345 
346 	int ret = wait_event_interruptible_timeout(info->irq_waitq,
347 				atomic_add_unless(&info->irq_done, -1, 0),
348 				msecs_to_jiffies(timeout));
349 	if (ret <= 0)
350 		return ret ? ret : -ETIMEDOUT;
351 
352 	return m5mols_busy_wait(sd, SYSTEM_INT_FACTOR, irq_mask,
353 				M5MOLS_I2C_RDY_WAIT_FL | irq_mask, -1);
354 }
355 
356 /**
357  * m5mols_reg_mode - Write the mode and check busy status
358  * @sd: sub-device, as pointed by struct v4l2_subdev
359  * @mode: the required operation mode
360  *
361  * It always accompanies a little delay changing the M-5MOLS mode, so it is
362  * needed checking current busy status to guarantee right mode.
363  */
m5mols_reg_mode(struct v4l2_subdev * sd,u8 mode)364 static int m5mols_reg_mode(struct v4l2_subdev *sd, u8 mode)
365 {
366 	int ret = m5mols_write(sd, SYSTEM_SYSMODE, mode);
367 	if (ret < 0)
368 		return ret;
369 	return m5mols_busy_wait(sd, SYSTEM_SYSMODE, mode, 0xff,
370 				M5MOLS_MODE_CHANGE_TIMEOUT);
371 }
372 
373 /**
374  * m5mols_set_mode - set the M-5MOLS controller mode
375  * @info: M-5MOLS driver data structure
376  * @mode: the required operation mode
377  *
378  * The commands of M-5MOLS are grouped into specific modes. Each functionality
379  * can be guaranteed only when the sensor is operating in mode which a command
380  * belongs to.
381  */
m5mols_set_mode(struct m5mols_info * info,u8 mode)382 int m5mols_set_mode(struct m5mols_info *info, u8 mode)
383 {
384 	struct v4l2_subdev *sd = &info->sd;
385 	int ret = -EINVAL;
386 	u8 reg;
387 
388 	if (mode < REG_PARAMETER || mode > REG_CAPTURE)
389 		return ret;
390 
391 	ret = m5mols_read_u8(sd, SYSTEM_SYSMODE, &reg);
392 	if (ret || reg == mode)
393 		return ret;
394 
395 	switch (reg) {
396 	case REG_PARAMETER:
397 		ret = m5mols_reg_mode(sd, REG_MONITOR);
398 		if (mode == REG_MONITOR)
399 			break;
400 		if (!ret)
401 			ret = m5mols_reg_mode(sd, REG_CAPTURE);
402 		break;
403 
404 	case REG_MONITOR:
405 		if (mode == REG_PARAMETER) {
406 			ret = m5mols_reg_mode(sd, REG_PARAMETER);
407 			break;
408 		}
409 
410 		ret = m5mols_reg_mode(sd, REG_CAPTURE);
411 		break;
412 
413 	case REG_CAPTURE:
414 		ret = m5mols_reg_mode(sd, REG_MONITOR);
415 		if (mode == REG_MONITOR)
416 			break;
417 		if (!ret)
418 			ret = m5mols_reg_mode(sd, REG_PARAMETER);
419 		break;
420 
421 	default:
422 		v4l2_warn(sd, "Wrong mode: %d\n", mode);
423 	}
424 
425 	if (!ret)
426 		info->mode = mode;
427 
428 	return ret;
429 }
430 
431 /**
432  * m5mols_get_version - retrieve full revisions information of M-5MOLS
433  * @sd: sub-device, as pointed by struct v4l2_subdev
434  *
435  * The version information includes revisions of hardware and firmware,
436  * AutoFocus alghorithm version and the version string.
437  */
m5mols_get_version(struct v4l2_subdev * sd)438 static int m5mols_get_version(struct v4l2_subdev *sd)
439 {
440 	struct m5mols_info *info = to_m5mols(sd);
441 	struct m5mols_version *ver = &info->ver;
442 	u8 *str = ver->str;
443 	int i;
444 	int ret;
445 
446 	ret = m5mols_read_u8(sd, SYSTEM_VER_CUSTOMER, &ver->customer);
447 	if (!ret)
448 		ret = m5mols_read_u8(sd, SYSTEM_VER_PROJECT, &ver->project);
449 	if (!ret)
450 		ret = m5mols_read_u16(sd, SYSTEM_VER_FIRMWARE, &ver->fw);
451 	if (!ret)
452 		ret = m5mols_read_u16(sd, SYSTEM_VER_HARDWARE, &ver->hw);
453 	if (!ret)
454 		ret = m5mols_read_u16(sd, SYSTEM_VER_PARAMETER, &ver->param);
455 	if (!ret)
456 		ret = m5mols_read_u16(sd, SYSTEM_VER_AWB, &ver->awb);
457 	if (!ret)
458 		ret = m5mols_read_u8(sd, AF_VERSION, &ver->af);
459 	if (ret)
460 		return ret;
461 
462 	for (i = 0; i < VERSION_STRING_SIZE; i++) {
463 		ret = m5mols_read_u8(sd, SYSTEM_VER_STRING, &str[i]);
464 		if (ret)
465 			return ret;
466 	}
467 
468 	v4l2_info(sd, "Manufacturer\t[%s]\n",
469 			is_manufacturer(info, REG_SAMSUNG_ELECTRO) ?
470 			"Samsung Electro-Mechanics" :
471 			is_manufacturer(info, REG_SAMSUNG_OPTICS) ?
472 			"Samsung Fiber-Optics" :
473 			is_manufacturer(info, REG_SAMSUNG_TECHWIN) ?
474 			"Samsung Techwin" : "None");
475 	v4l2_info(sd, "Customer/Project\t[0x%02x/0x%02x]\n",
476 			info->ver.customer, info->ver.project);
477 
478 	if (!is_available_af(info))
479 		v4l2_info(sd, "No support Auto Focus on this firmware\n");
480 
481 	return ret;
482 }
483 
484 /**
485  * __find_restype - Lookup M-5MOLS resolution type according to pixel code
486  * @code: pixel code
487  */
__find_restype(u32 code)488 static enum m5mols_restype __find_restype(u32 code)
489 {
490 	enum m5mols_restype type = M5MOLS_RESTYPE_MONITOR;
491 
492 	do {
493 		if (code == m5mols_default_ffmt[type].code)
494 			return type;
495 	} while (type++ != SIZE_DEFAULT_FFMT);
496 
497 	return 0;
498 }
499 
500 /**
501  * __find_resolution - Lookup preset and type of M-5MOLS's resolution
502  * @sd: sub-device, as pointed by struct v4l2_subdev
503  * @mf: pixel format to find/negotiate the resolution preset for
504  * @type: M-5MOLS resolution type
505  * @resolution:	M-5MOLS resolution preset register value
506  *
507  * Find nearest resolution matching resolution preset and adjust mf
508  * to supported values.
509  */
__find_resolution(struct v4l2_subdev * sd,struct v4l2_mbus_framefmt * mf,enum m5mols_restype * type,u32 * resolution)510 static int __find_resolution(struct v4l2_subdev *sd,
511 			     struct v4l2_mbus_framefmt *mf,
512 			     enum m5mols_restype *type,
513 			     u32 *resolution)
514 {
515 	const struct m5mols_resolution *fsize = &m5mols_reg_res[0];
516 	const struct m5mols_resolution *match = NULL;
517 	enum m5mols_restype stype = __find_restype(mf->code);
518 	int i = ARRAY_SIZE(m5mols_reg_res);
519 	unsigned int min_err = ~0;
520 
521 	while (i--) {
522 		int err;
523 		if (stype == fsize->type) {
524 			err = abs(fsize->width - mf->width)
525 				+ abs(fsize->height - mf->height);
526 
527 			if (err < min_err) {
528 				min_err = err;
529 				match = fsize;
530 			}
531 		}
532 		fsize++;
533 	}
534 	if (match) {
535 		mf->width  = match->width;
536 		mf->height = match->height;
537 		*resolution = match->reg;
538 		*type = stype;
539 		return 0;
540 	}
541 
542 	return -EINVAL;
543 }
544 
__find_format(struct m5mols_info * info,struct v4l2_subdev_pad_config * cfg,enum v4l2_subdev_format_whence which,enum m5mols_restype type)545 static struct v4l2_mbus_framefmt *__find_format(struct m5mols_info *info,
546 				struct v4l2_subdev_pad_config *cfg,
547 				enum v4l2_subdev_format_whence which,
548 				enum m5mols_restype type)
549 {
550 	if (which == V4L2_SUBDEV_FORMAT_TRY)
551 		return cfg ? v4l2_subdev_get_try_format(&info->sd, cfg, 0) : NULL;
552 
553 	return &info->ffmt[type];
554 }
555 
m5mols_get_fmt(struct v4l2_subdev * sd,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_format * fmt)556 static int m5mols_get_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_pad_config *cfg,
557 			  struct v4l2_subdev_format *fmt)
558 {
559 	struct m5mols_info *info = to_m5mols(sd);
560 	struct v4l2_mbus_framefmt *format;
561 	int ret = 0;
562 
563 	mutex_lock(&info->lock);
564 
565 	format = __find_format(info, cfg, fmt->which, info->res_type);
566 	if (format)
567 		fmt->format = *format;
568 	else
569 		ret = -EINVAL;
570 
571 	mutex_unlock(&info->lock);
572 	return ret;
573 }
574 
m5mols_set_fmt(struct v4l2_subdev * sd,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_format * fmt)575 static int m5mols_set_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_pad_config *cfg,
576 			  struct v4l2_subdev_format *fmt)
577 {
578 	struct m5mols_info *info = to_m5mols(sd);
579 	struct v4l2_mbus_framefmt *format = &fmt->format;
580 	struct v4l2_mbus_framefmt *sfmt;
581 	enum m5mols_restype type;
582 	u32 resolution = 0;
583 	int ret;
584 
585 	ret = __find_resolution(sd, format, &type, &resolution);
586 	if (ret < 0)
587 		return ret;
588 
589 	sfmt = __find_format(info, cfg, fmt->which, type);
590 	if (!sfmt)
591 		return 0;
592 
593 	mutex_lock(&info->lock);
594 
595 	format->code = m5mols_default_ffmt[type].code;
596 	format->colorspace = V4L2_COLORSPACE_JPEG;
597 	format->field = V4L2_FIELD_NONE;
598 
599 	if (fmt->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
600 		*sfmt = *format;
601 		info->resolution = resolution;
602 		info->res_type = type;
603 	}
604 
605 	mutex_unlock(&info->lock);
606 	return ret;
607 }
608 
m5mols_get_frame_desc(struct v4l2_subdev * sd,unsigned int pad,struct v4l2_mbus_frame_desc * fd)609 static int m5mols_get_frame_desc(struct v4l2_subdev *sd, unsigned int pad,
610 				 struct v4l2_mbus_frame_desc *fd)
611 {
612 	struct m5mols_info *info = to_m5mols(sd);
613 
614 	if (pad != 0 || fd == NULL)
615 		return -EINVAL;
616 
617 	mutex_lock(&info->lock);
618 	/*
619 	 * .get_frame_desc is only used for compressed formats,
620 	 * thus we always return the capture frame parameters here.
621 	 */
622 	fd->entry[0].length = info->cap.buf_size;
623 	fd->entry[0].pixelcode = info->ffmt[M5MOLS_RESTYPE_CAPTURE].code;
624 	mutex_unlock(&info->lock);
625 
626 	fd->entry[0].flags = V4L2_MBUS_FRAME_DESC_FL_LEN_MAX;
627 	fd->num_entries = 1;
628 
629 	return 0;
630 }
631 
m5mols_set_frame_desc(struct v4l2_subdev * sd,unsigned int pad,struct v4l2_mbus_frame_desc * fd)632 static int m5mols_set_frame_desc(struct v4l2_subdev *sd, unsigned int pad,
633 				 struct v4l2_mbus_frame_desc *fd)
634 {
635 	struct m5mols_info *info = to_m5mols(sd);
636 	struct v4l2_mbus_framefmt *mf = &info->ffmt[M5MOLS_RESTYPE_CAPTURE];
637 
638 	if (pad != 0 || fd == NULL)
639 		return -EINVAL;
640 
641 	fd->entry[0].flags = V4L2_MBUS_FRAME_DESC_FL_LEN_MAX;
642 	fd->num_entries = 1;
643 	fd->entry[0].length = clamp_t(u32, fd->entry[0].length,
644 				      mf->width * mf->height,
645 				      M5MOLS_MAIN_JPEG_SIZE_MAX);
646 	mutex_lock(&info->lock);
647 	info->cap.buf_size = fd->entry[0].length;
648 	mutex_unlock(&info->lock);
649 
650 	return 0;
651 }
652 
653 
m5mols_enum_mbus_code(struct v4l2_subdev * sd,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_mbus_code_enum * code)654 static int m5mols_enum_mbus_code(struct v4l2_subdev *sd,
655 				 struct v4l2_subdev_pad_config *cfg,
656 				 struct v4l2_subdev_mbus_code_enum *code)
657 {
658 	if (!code || code->index >= SIZE_DEFAULT_FFMT)
659 		return -EINVAL;
660 
661 	code->code = m5mols_default_ffmt[code->index].code;
662 
663 	return 0;
664 }
665 
666 static const struct v4l2_subdev_pad_ops m5mols_pad_ops = {
667 	.enum_mbus_code	= m5mols_enum_mbus_code,
668 	.get_fmt	= m5mols_get_fmt,
669 	.set_fmt	= m5mols_set_fmt,
670 	.get_frame_desc	= m5mols_get_frame_desc,
671 	.set_frame_desc	= m5mols_set_frame_desc,
672 };
673 
674 /**
675  * m5mols_restore_controls - Apply current control values to the registers
676  * @info: M-5MOLS driver data structure
677  *
678  * m5mols_do_scenemode() handles all parameters for which there is yet no
679  * individual control. It should be replaced at some point by setting each
680  * control individually, in required register set up order.
681  */
m5mols_restore_controls(struct m5mols_info * info)682 int m5mols_restore_controls(struct m5mols_info *info)
683 {
684 	int ret;
685 
686 	if (info->ctrl_sync)
687 		return 0;
688 
689 	ret = m5mols_do_scenemode(info, REG_SCENE_NORMAL);
690 	if (ret)
691 		return ret;
692 
693 	ret = v4l2_ctrl_handler_setup(&info->handle);
694 	info->ctrl_sync = !ret;
695 
696 	return ret;
697 }
698 
699 /**
700  * m5mols_start_monitor - Start the monitor mode
701  * @info: M-5MOLS driver data structure
702  *
703  * Before applying the controls setup the resolution and frame rate
704  * in PARAMETER mode, and then switch over to MONITOR mode.
705  */
m5mols_start_monitor(struct m5mols_info * info)706 static int m5mols_start_monitor(struct m5mols_info *info)
707 {
708 	struct v4l2_subdev *sd = &info->sd;
709 	int ret;
710 
711 	ret = m5mols_set_mode(info, REG_PARAMETER);
712 	if (!ret)
713 		ret = m5mols_write(sd, PARM_MON_SIZE, info->resolution);
714 	if (!ret)
715 		ret = m5mols_write(sd, PARM_MON_FPS, REG_FPS_30);
716 	if (!ret)
717 		ret = m5mols_set_mode(info, REG_MONITOR);
718 	if (!ret)
719 		ret = m5mols_restore_controls(info);
720 
721 	return ret;
722 }
723 
m5mols_s_stream(struct v4l2_subdev * sd,int enable)724 static int m5mols_s_stream(struct v4l2_subdev *sd, int enable)
725 {
726 	struct m5mols_info *info = to_m5mols(sd);
727 	u32 code;
728 	int ret;
729 
730 	mutex_lock(&info->lock);
731 	code = info->ffmt[info->res_type].code;
732 
733 	if (enable) {
734 		if (is_code(code, M5MOLS_RESTYPE_MONITOR))
735 			ret = m5mols_start_monitor(info);
736 		else if (is_code(code, M5MOLS_RESTYPE_CAPTURE))
737 			ret = m5mols_start_capture(info);
738 		else
739 			ret = -EINVAL;
740 	} else {
741 		ret = m5mols_set_mode(info, REG_PARAMETER);
742 	}
743 
744 	mutex_unlock(&info->lock);
745 	return ret;
746 }
747 
748 static const struct v4l2_subdev_video_ops m5mols_video_ops = {
749 	.s_stream	= m5mols_s_stream,
750 };
751 
m5mols_sensor_power(struct m5mols_info * info,bool enable)752 static int m5mols_sensor_power(struct m5mols_info *info, bool enable)
753 {
754 	struct v4l2_subdev *sd = &info->sd;
755 	struct i2c_client *client = v4l2_get_subdevdata(sd);
756 	const struct m5mols_platform_data *pdata = info->pdata;
757 	int ret;
758 
759 	if (info->power == enable)
760 		return 0;
761 
762 	if (enable) {
763 		if (info->set_power) {
764 			ret = info->set_power(&client->dev, 1);
765 			if (ret)
766 				return ret;
767 		}
768 
769 		ret = regulator_bulk_enable(ARRAY_SIZE(supplies), supplies);
770 		if (ret) {
771 			if (info->set_power)
772 				info->set_power(&client->dev, 0);
773 			return ret;
774 		}
775 
776 		gpio_set_value(pdata->gpio_reset, !pdata->reset_polarity);
777 		info->power = 1;
778 
779 		return ret;
780 	}
781 
782 	ret = regulator_bulk_disable(ARRAY_SIZE(supplies), supplies);
783 	if (ret)
784 		return ret;
785 
786 	if (info->set_power)
787 		info->set_power(&client->dev, 0);
788 
789 	gpio_set_value(pdata->gpio_reset, pdata->reset_polarity);
790 
791 	info->isp_ready = 0;
792 	info->power = 0;
793 
794 	return ret;
795 }
796 
797 /* m5mols_update_fw - optional firmware update routine */
m5mols_update_fw(struct v4l2_subdev * sd,int (* set_power)(struct m5mols_info *,bool))798 int __attribute__ ((weak)) m5mols_update_fw(struct v4l2_subdev *sd,
799 		int (*set_power)(struct m5mols_info *, bool))
800 {
801 	return 0;
802 }
803 
804 /**
805  * m5mols_fw_start - M-5MOLS internal ARM controller initialization
806  * @sd: sub-device, as pointed by struct v4l2_subdev
807  *
808  * Execute the M-5MOLS internal ARM controller initialization sequence.
809  * This function should be called after the supply voltage has been
810  * applied and before any requests to the device are made.
811  */
m5mols_fw_start(struct v4l2_subdev * sd)812 static int m5mols_fw_start(struct v4l2_subdev *sd)
813 {
814 	struct m5mols_info *info = to_m5mols(sd);
815 	int ret;
816 
817 	atomic_set(&info->irq_done, 0);
818 	/* Wait until I2C slave is initialized in Flash Writer mode */
819 	ret = m5mols_busy_wait(sd, FLASH_CAM_START, REG_IN_FLASH_MODE,
820 			       M5MOLS_I2C_RDY_WAIT_FL | 0xff, -1);
821 	if (!ret)
822 		ret = m5mols_write(sd, FLASH_CAM_START, REG_START_ARM_BOOT);
823 	if (!ret)
824 		ret = m5mols_wait_interrupt(sd, REG_INT_MODE, 2000);
825 	if (ret < 0)
826 		return ret;
827 
828 	info->isp_ready = 1;
829 
830 	ret = m5mols_get_version(sd);
831 	if (!ret)
832 		ret = m5mols_update_fw(sd, m5mols_sensor_power);
833 	if (ret)
834 		return ret;
835 
836 	v4l2_dbg(1, m5mols_debug, sd, "Success ARM Booting\n");
837 
838 	ret = m5mols_write(sd, PARM_INTERFACE, REG_INTERFACE_MIPI);
839 	if (!ret)
840 		ret = m5mols_enable_interrupt(sd,
841 				REG_INT_AF | REG_INT_CAPTURE);
842 
843 	return ret;
844 }
845 
846 /* Execute the lens soft-landing algorithm */
m5mols_auto_focus_stop(struct m5mols_info * info)847 static int m5mols_auto_focus_stop(struct m5mols_info *info)
848 {
849 	int ret;
850 
851 	ret = m5mols_write(&info->sd, AF_EXECUTE, REG_AF_STOP);
852 	if (!ret)
853 		ret = m5mols_write(&info->sd, AF_MODE, REG_AF_POWEROFF);
854 	if (!ret)
855 		ret = m5mols_busy_wait(&info->sd, SYSTEM_STATUS, REG_AF_IDLE,
856 				       0xff, -1);
857 	return ret;
858 }
859 
860 /**
861  * m5mols_s_power - Main sensor power control function
862  * @sd: sub-device, as pointed by struct v4l2_subdev
863  * @on: if true, powers on the device; powers off otherwise.
864  *
865  * To prevent breaking the lens when the sensor is powered off the Soft-Landing
866  * algorithm is called where available. The Soft-Landing algorithm availability
867  * dependends on the firmware provider.
868  */
m5mols_s_power(struct v4l2_subdev * sd,int on)869 static int m5mols_s_power(struct v4l2_subdev *sd, int on)
870 {
871 	struct m5mols_info *info = to_m5mols(sd);
872 	int ret;
873 
874 	mutex_lock(&info->lock);
875 
876 	if (on) {
877 		ret = m5mols_sensor_power(info, true);
878 		if (!ret)
879 			ret = m5mols_fw_start(sd);
880 	} else {
881 		if (is_manufacturer(info, REG_SAMSUNG_TECHWIN)) {
882 			ret = m5mols_set_mode(info, REG_MONITOR);
883 			if (!ret)
884 				ret = m5mols_auto_focus_stop(info);
885 			if (ret < 0)
886 				v4l2_warn(sd, "Soft landing lens failed\n");
887 		}
888 		ret = m5mols_sensor_power(info, false);
889 
890 		info->ctrl_sync = 0;
891 	}
892 
893 	mutex_unlock(&info->lock);
894 	return ret;
895 }
896 
m5mols_log_status(struct v4l2_subdev * sd)897 static int m5mols_log_status(struct v4l2_subdev *sd)
898 {
899 	struct m5mols_info *info = to_m5mols(sd);
900 
901 	v4l2_ctrl_handler_log_status(&info->handle, sd->name);
902 
903 	return 0;
904 }
905 
906 static const struct v4l2_subdev_core_ops m5mols_core_ops = {
907 	.s_power	= m5mols_s_power,
908 	.log_status	= m5mols_log_status,
909 };
910 
911 /*
912  * V4L2 subdev internal operations
913  */
m5mols_open(struct v4l2_subdev * sd,struct v4l2_subdev_fh * fh)914 static int m5mols_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
915 {
916 	struct v4l2_mbus_framefmt *format = v4l2_subdev_get_try_format(sd, fh->pad, 0);
917 
918 	*format = m5mols_default_ffmt[0];
919 	return 0;
920 }
921 
922 static const struct v4l2_subdev_internal_ops m5mols_subdev_internal_ops = {
923 	.open		= m5mols_open,
924 };
925 
926 static const struct v4l2_subdev_ops m5mols_ops = {
927 	.core		= &m5mols_core_ops,
928 	.pad		= &m5mols_pad_ops,
929 	.video		= &m5mols_video_ops,
930 };
931 
m5mols_irq_handler(int irq,void * data)932 static irqreturn_t m5mols_irq_handler(int irq, void *data)
933 {
934 	struct m5mols_info *info = to_m5mols(data);
935 
936 	atomic_set(&info->irq_done, 1);
937 	wake_up_interruptible(&info->irq_waitq);
938 
939 	return IRQ_HANDLED;
940 }
941 
m5mols_probe(struct i2c_client * client,const struct i2c_device_id * id)942 static int m5mols_probe(struct i2c_client *client,
943 			const struct i2c_device_id *id)
944 {
945 	const struct m5mols_platform_data *pdata = client->dev.platform_data;
946 	unsigned long gpio_flags;
947 	struct m5mols_info *info;
948 	struct v4l2_subdev *sd;
949 	int ret;
950 
951 	if (pdata == NULL) {
952 		dev_err(&client->dev, "No platform data\n");
953 		return -EINVAL;
954 	}
955 
956 	if (!gpio_is_valid(pdata->gpio_reset)) {
957 		dev_err(&client->dev, "No valid RESET GPIO specified\n");
958 		return -EINVAL;
959 	}
960 
961 	if (!client->irq) {
962 		dev_err(&client->dev, "Interrupt not assigned\n");
963 		return -EINVAL;
964 	}
965 
966 	info = devm_kzalloc(&client->dev, sizeof(*info), GFP_KERNEL);
967 	if (!info)
968 		return -ENOMEM;
969 
970 	info->pdata = pdata;
971 	info->set_power	= pdata->set_power;
972 
973 	gpio_flags = pdata->reset_polarity
974 		   ? GPIOF_OUT_INIT_HIGH : GPIOF_OUT_INIT_LOW;
975 	ret = devm_gpio_request_one(&client->dev, pdata->gpio_reset, gpio_flags,
976 				    "M5MOLS_NRST");
977 	if (ret) {
978 		dev_err(&client->dev, "Failed to request gpio: %d\n", ret);
979 		return ret;
980 	}
981 
982 	ret = devm_regulator_bulk_get(&client->dev, ARRAY_SIZE(supplies),
983 				      supplies);
984 	if (ret) {
985 		dev_err(&client->dev, "Failed to get regulators: %d\n", ret);
986 		return ret;
987 	}
988 
989 	sd = &info->sd;
990 	v4l2_i2c_subdev_init(sd, client, &m5mols_ops);
991 	strlcpy(sd->name, MODULE_NAME, sizeof(sd->name));
992 	sd->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
993 
994 	sd->internal_ops = &m5mols_subdev_internal_ops;
995 	info->pad.flags = MEDIA_PAD_FL_SOURCE;
996 	ret = media_entity_pads_init(&sd->entity, 1, &info->pad);
997 	if (ret < 0)
998 		return ret;
999 	sd->entity.function = MEDIA_ENT_F_CAM_SENSOR;
1000 
1001 	init_waitqueue_head(&info->irq_waitq);
1002 	mutex_init(&info->lock);
1003 
1004 	ret = devm_request_irq(&client->dev, client->irq, m5mols_irq_handler,
1005 			       IRQF_TRIGGER_RISING, MODULE_NAME, sd);
1006 	if (ret) {
1007 		dev_err(&client->dev, "Interrupt request failed: %d\n", ret);
1008 		goto error;
1009 	}
1010 	info->res_type = M5MOLS_RESTYPE_MONITOR;
1011 	info->ffmt[0] = m5mols_default_ffmt[0];
1012 	info->ffmt[1] =	m5mols_default_ffmt[1];
1013 
1014 	ret = m5mols_sensor_power(info, true);
1015 	if (ret)
1016 		goto error;
1017 
1018 	ret = m5mols_fw_start(sd);
1019 	if (!ret)
1020 		ret = m5mols_init_controls(sd);
1021 
1022 	ret = m5mols_sensor_power(info, false);
1023 	if (!ret)
1024 		return 0;
1025 error:
1026 	media_entity_cleanup(&sd->entity);
1027 	return ret;
1028 }
1029 
m5mols_remove(struct i2c_client * client)1030 static int m5mols_remove(struct i2c_client *client)
1031 {
1032 	struct v4l2_subdev *sd = i2c_get_clientdata(client);
1033 
1034 	v4l2_device_unregister_subdev(sd);
1035 	v4l2_ctrl_handler_free(sd->ctrl_handler);
1036 	media_entity_cleanup(&sd->entity);
1037 
1038 	return 0;
1039 }
1040 
1041 static const struct i2c_device_id m5mols_id[] = {
1042 	{ MODULE_NAME, 0 },
1043 	{ },
1044 };
1045 MODULE_DEVICE_TABLE(i2c, m5mols_id);
1046 
1047 static struct i2c_driver m5mols_i2c_driver = {
1048 	.driver = {
1049 		.name	= MODULE_NAME,
1050 	},
1051 	.probe		= m5mols_probe,
1052 	.remove		= m5mols_remove,
1053 	.id_table	= m5mols_id,
1054 };
1055 
1056 module_i2c_driver(m5mols_i2c_driver);
1057 
1058 MODULE_AUTHOR("HeungJun Kim <riverful.kim@samsung.com>");
1059 MODULE_AUTHOR("Dongsoo Kim <dongsoo45.kim@samsung.com>");
1060 MODULE_DESCRIPTION("Fujitsu M-5MOLS 8M Pixel camera driver");
1061 MODULE_LICENSE("GPL");
1062