xref: /linux/drivers/media/i2c/imx208.c (revision 7ec462100ef9142344ddbf86f2c3008b97acddbe)
1 // SPDX-License-Identifier: GPL-2.0
2 // Copyright (C) 2021 Intel Corporation
3 
4 #include <linux/acpi.h>
5 #include <linux/delay.h>
6 #include <linux/i2c.h>
7 #include <linux/module.h>
8 #include <linux/pm_runtime.h>
9 #include <media/v4l2-ctrls.h>
10 #include <media/v4l2-device.h>
11 #include <linux/unaligned.h>
12 
13 #define IMX208_REG_MODE_SELECT		0x0100
14 #define IMX208_MODE_STANDBY		0x00
15 #define IMX208_MODE_STREAMING		0x01
16 
17 /* Chip ID */
18 #define IMX208_REG_CHIP_ID		0x0000
19 #define IMX208_CHIP_ID			0x0208
20 
21 /* V_TIMING internal */
22 #define IMX208_REG_VTS			0x0340
23 #define IMX208_VTS_60FPS		0x0472
24 #define IMX208_VTS_BINNING		0x0239
25 #define IMX208_VTS_60FPS_MIN		0x0458
26 #define IMX208_VTS_BINNING_MIN		0x0230
27 #define IMX208_VTS_MAX			0xffff
28 
29 /* HBLANK control - read only */
30 #define IMX208_PPL_384MHZ		2248
31 #define IMX208_PPL_96MHZ		2248
32 
33 /* Exposure control */
34 #define IMX208_REG_EXPOSURE		0x0202
35 #define IMX208_EXPOSURE_MIN		4
36 #define IMX208_EXPOSURE_STEP		1
37 #define IMX208_EXPOSURE_DEFAULT		0x190
38 #define IMX208_EXPOSURE_MAX		65535
39 
40 /* Analog gain control */
41 #define IMX208_REG_ANALOG_GAIN		0x0204
42 #define IMX208_ANA_GAIN_MIN		0
43 #define IMX208_ANA_GAIN_MAX		0x00e0
44 #define IMX208_ANA_GAIN_STEP		1
45 #define IMX208_ANA_GAIN_DEFAULT		0x0
46 
47 /* Digital gain control */
48 #define IMX208_REG_GR_DIGITAL_GAIN	0x020e
49 #define IMX208_REG_R_DIGITAL_GAIN	0x0210
50 #define IMX208_REG_B_DIGITAL_GAIN	0x0212
51 #define IMX208_REG_GB_DIGITAL_GAIN	0x0214
52 #define IMX208_DIGITAL_GAIN_SHIFT	8
53 
54 /* Orientation */
55 #define IMX208_REG_ORIENTATION_CONTROL	0x0101
56 
57 /* Test Pattern Control */
58 #define IMX208_REG_TEST_PATTERN_MODE	0x0600
59 #define IMX208_TEST_PATTERN_DISABLE	0x0
60 #define IMX208_TEST_PATTERN_SOLID_COLOR	0x1
61 #define IMX208_TEST_PATTERN_COLOR_BARS	0x2
62 #define IMX208_TEST_PATTERN_GREY_COLOR	0x3
63 #define IMX208_TEST_PATTERN_PN9		0x4
64 #define IMX208_TEST_PATTERN_FIX_1	0x100
65 #define IMX208_TEST_PATTERN_FIX_2	0x101
66 #define IMX208_TEST_PATTERN_FIX_3	0x102
67 #define IMX208_TEST_PATTERN_FIX_4	0x103
68 #define IMX208_TEST_PATTERN_FIX_5	0x104
69 #define IMX208_TEST_PATTERN_FIX_6	0x105
70 
71 /* OTP Access */
72 #define IMX208_OTP_BASE			0x3500
73 #define IMX208_OTP_SIZE			40
74 
75 struct imx208_reg {
76 	u16 address;
77 	u8 val;
78 };
79 
80 struct imx208_reg_list {
81 	u32 num_of_regs;
82 	const struct imx208_reg *regs;
83 };
84 
85 /* Link frequency config */
86 struct imx208_link_freq_config {
87 	u32 pixels_per_line;
88 
89 	/* PLL registers for this link frequency */
90 	struct imx208_reg_list reg_list;
91 };
92 
93 /* Mode : resolution and related config&values */
94 struct imx208_mode {
95 	/* Frame width */
96 	u32 width;
97 	/* Frame height */
98 	u32 height;
99 
100 	/* V-timing */
101 	u32 vts_def;
102 	u32 vts_min;
103 
104 	/* Index of Link frequency config to be used */
105 	u32 link_freq_index;
106 	/* Default register values */
107 	struct imx208_reg_list reg_list;
108 };
109 
110 static const struct imx208_reg pll_ctrl_reg[] = {
111 	{0x0305, 0x02},
112 	{0x0307, 0x50},
113 	{0x303C, 0x3C},
114 };
115 
116 static const struct imx208_reg mode_1936x1096_60fps_regs[] = {
117 	{0x0340, 0x04},
118 	{0x0341, 0x72},
119 	{0x0342, 0x04},
120 	{0x0343, 0x64},
121 	{0x034C, 0x07},
122 	{0x034D, 0x90},
123 	{0x034E, 0x04},
124 	{0x034F, 0x48},
125 	{0x0381, 0x01},
126 	{0x0383, 0x01},
127 	{0x0385, 0x01},
128 	{0x0387, 0x01},
129 	{0x3048, 0x00},
130 	{0x3050, 0x01},
131 	{0x30D5, 0x00},
132 	{0x3301, 0x00},
133 	{0x3318, 0x62},
134 	{0x0202, 0x01},
135 	{0x0203, 0x90},
136 	{0x0205, 0x00},
137 };
138 
139 static const struct imx208_reg mode_968_548_60fps_regs[] = {
140 	{0x0340, 0x02},
141 	{0x0341, 0x39},
142 	{0x0342, 0x08},
143 	{0x0343, 0xC8},
144 	{0x034C, 0x03},
145 	{0x034D, 0xC8},
146 	{0x034E, 0x02},
147 	{0x034F, 0x24},
148 	{0x0381, 0x01},
149 	{0x0383, 0x03},
150 	{0x0385, 0x01},
151 	{0x0387, 0x03},
152 	{0x3048, 0x01},
153 	{0x3050, 0x02},
154 	{0x30D5, 0x03},
155 	{0x3301, 0x10},
156 	{0x3318, 0x75},
157 	{0x0202, 0x01},
158 	{0x0203, 0x90},
159 	{0x0205, 0x00},
160 };
161 
162 static const s64 imx208_discrete_digital_gain[] = {
163 	1, 2, 4, 8, 16,
164 };
165 
166 static const char * const imx208_test_pattern_menu[] = {
167 	"Disabled",
168 	"Solid Color",
169 	"100% Color Bar",
170 	"Fade to Grey Color Bar",
171 	"PN9",
172 	"Fixed Pattern1",
173 	"Fixed Pattern2",
174 	"Fixed Pattern3",
175 	"Fixed Pattern4",
176 	"Fixed Pattern5",
177 	"Fixed Pattern6"
178 };
179 
180 static const int imx208_test_pattern_val[] = {
181 	IMX208_TEST_PATTERN_DISABLE,
182 	IMX208_TEST_PATTERN_SOLID_COLOR,
183 	IMX208_TEST_PATTERN_COLOR_BARS,
184 	IMX208_TEST_PATTERN_GREY_COLOR,
185 	IMX208_TEST_PATTERN_PN9,
186 	IMX208_TEST_PATTERN_FIX_1,
187 	IMX208_TEST_PATTERN_FIX_2,
188 	IMX208_TEST_PATTERN_FIX_3,
189 	IMX208_TEST_PATTERN_FIX_4,
190 	IMX208_TEST_PATTERN_FIX_5,
191 	IMX208_TEST_PATTERN_FIX_6,
192 };
193 
194 /* Configurations for supported link frequencies */
195 #define IMX208_MHZ			(1000 * 1000ULL)
196 #define IMX208_LINK_FREQ_384MHZ		(384ULL * IMX208_MHZ)
197 #define IMX208_LINK_FREQ_96MHZ		(96ULL * IMX208_MHZ)
198 
199 #define IMX208_DATA_RATE_DOUBLE		2
200 #define IMX208_NUM_OF_LANES		2
201 #define IMX208_PIXEL_BITS		10
202 
203 enum {
204 	IMX208_LINK_FREQ_384MHZ_INDEX,
205 	IMX208_LINK_FREQ_96MHZ_INDEX,
206 };
207 
208 /*
209  * pixel_rate = link_freq * data-rate * nr_of_lanes / bits_per_sample
210  * data rate => double data rate; number of lanes => 2; bits per pixel => 10
211  */
link_freq_to_pixel_rate(u64 f)212 static u64 link_freq_to_pixel_rate(u64 f)
213 {
214 	f *= IMX208_DATA_RATE_DOUBLE * IMX208_NUM_OF_LANES;
215 	do_div(f, IMX208_PIXEL_BITS);
216 
217 	return f;
218 }
219 
220 /* Menu items for LINK_FREQ V4L2 control */
221 static const s64 link_freq_menu_items[] = {
222 	[IMX208_LINK_FREQ_384MHZ_INDEX] = IMX208_LINK_FREQ_384MHZ,
223 	[IMX208_LINK_FREQ_96MHZ_INDEX] = IMX208_LINK_FREQ_96MHZ,
224 };
225 
226 /* Link frequency configs */
227 static const struct imx208_link_freq_config link_freq_configs[] = {
228 	[IMX208_LINK_FREQ_384MHZ_INDEX] = {
229 		.pixels_per_line = IMX208_PPL_384MHZ,
230 		.reg_list = {
231 			.num_of_regs = ARRAY_SIZE(pll_ctrl_reg),
232 			.regs = pll_ctrl_reg,
233 		}
234 	},
235 	[IMX208_LINK_FREQ_96MHZ_INDEX] = {
236 		.pixels_per_line = IMX208_PPL_96MHZ,
237 		.reg_list = {
238 			.num_of_regs = ARRAY_SIZE(pll_ctrl_reg),
239 			.regs = pll_ctrl_reg,
240 		}
241 	},
242 };
243 
244 /* Mode configs */
245 static const struct imx208_mode supported_modes[] = {
246 	{
247 		.width = 1936,
248 		.height = 1096,
249 		.vts_def = IMX208_VTS_60FPS,
250 		.vts_min = IMX208_VTS_60FPS_MIN,
251 		.reg_list = {
252 			.num_of_regs = ARRAY_SIZE(mode_1936x1096_60fps_regs),
253 			.regs = mode_1936x1096_60fps_regs,
254 		},
255 		.link_freq_index = IMX208_LINK_FREQ_384MHZ_INDEX,
256 	},
257 	{
258 		.width = 968,
259 		.height = 548,
260 		.vts_def = IMX208_VTS_BINNING,
261 		.vts_min = IMX208_VTS_BINNING_MIN,
262 		.reg_list = {
263 			.num_of_regs = ARRAY_SIZE(mode_968_548_60fps_regs),
264 			.regs = mode_968_548_60fps_regs,
265 		},
266 		.link_freq_index = IMX208_LINK_FREQ_96MHZ_INDEX,
267 	},
268 };
269 
270 struct imx208 {
271 	struct v4l2_subdev sd;
272 	struct media_pad pad;
273 
274 	struct v4l2_ctrl_handler ctrl_handler;
275 	/* V4L2 Controls */
276 	struct v4l2_ctrl *link_freq;
277 	struct v4l2_ctrl *pixel_rate;
278 	struct v4l2_ctrl *vblank;
279 	struct v4l2_ctrl *hblank;
280 	struct v4l2_ctrl *vflip;
281 	struct v4l2_ctrl *hflip;
282 
283 	/* Current mode */
284 	const struct imx208_mode *cur_mode;
285 
286 	/*
287 	 * Mutex for serialized access:
288 	 * Protect sensor set pad format and start/stop streaming safely.
289 	 * Protect access to sensor v4l2 controls.
290 	 */
291 	struct mutex imx208_mx;
292 
293 	/* OTP data */
294 	bool otp_read;
295 	char otp_data[IMX208_OTP_SIZE];
296 
297 	/* True if the device has been identified */
298 	bool identified;
299 };
300 
to_imx208(struct v4l2_subdev * _sd)301 static inline struct imx208 *to_imx208(struct v4l2_subdev *_sd)
302 {
303 	return container_of(_sd, struct imx208, sd);
304 }
305 
306 /* Get bayer order based on flip setting. */
imx208_get_format_code(struct imx208 * imx208)307 static u32 imx208_get_format_code(struct imx208 *imx208)
308 {
309 	/*
310 	 * Only one bayer order is supported.
311 	 * It depends on the flip settings.
312 	 */
313 	static const u32 codes[2][2] = {
314 		{ MEDIA_BUS_FMT_SRGGB10_1X10, MEDIA_BUS_FMT_SGRBG10_1X10, },
315 		{ MEDIA_BUS_FMT_SGBRG10_1X10, MEDIA_BUS_FMT_SBGGR10_1X10, },
316 	};
317 
318 	return codes[imx208->vflip->val][imx208->hflip->val];
319 }
320 
321 /* Read registers up to 4 at a time */
imx208_read_reg(struct imx208 * imx208,u16 reg,u32 len,u32 * val)322 static int imx208_read_reg(struct imx208 *imx208, u16 reg, u32 len, u32 *val)
323 {
324 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
325 	struct i2c_msg msgs[2];
326 	u8 addr_buf[2] = { reg >> 8, reg & 0xff };
327 	u8 data_buf[4] = { 0, };
328 	int ret;
329 
330 	if (len > 4)
331 		return -EINVAL;
332 
333 	/* Write register address */
334 	msgs[0].addr = client->addr;
335 	msgs[0].flags = 0;
336 	msgs[0].len = ARRAY_SIZE(addr_buf);
337 	msgs[0].buf = addr_buf;
338 
339 	/* Read data from register */
340 	msgs[1].addr = client->addr;
341 	msgs[1].flags = I2C_M_RD;
342 	msgs[1].len = len;
343 	msgs[1].buf = &data_buf[4 - len];
344 
345 	ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
346 	if (ret != ARRAY_SIZE(msgs))
347 		return -EIO;
348 
349 	*val = get_unaligned_be32(data_buf);
350 
351 	return 0;
352 }
353 
354 /* Write registers up to 4 at a time */
imx208_write_reg(struct imx208 * imx208,u16 reg,u32 len,u32 val)355 static int imx208_write_reg(struct imx208 *imx208, u16 reg, u32 len, u32 val)
356 {
357 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
358 	u8 buf[6];
359 
360 	if (len > 4)
361 		return -EINVAL;
362 
363 	put_unaligned_be16(reg, buf);
364 	put_unaligned_be32(val << (8 * (4 - len)), buf + 2);
365 	if (i2c_master_send(client, buf, len + 2) != len + 2)
366 		return -EIO;
367 
368 	return 0;
369 }
370 
371 /* Write a list of registers */
imx208_write_regs(struct imx208 * imx208,const struct imx208_reg * regs,u32 len)372 static int imx208_write_regs(struct imx208 *imx208,
373 			     const struct imx208_reg *regs, u32 len)
374 {
375 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
376 	unsigned int i;
377 	int ret;
378 
379 	for (i = 0; i < len; i++) {
380 		ret = imx208_write_reg(imx208, regs[i].address, 1,
381 				       regs[i].val);
382 		if (ret) {
383 			dev_err_ratelimited(&client->dev,
384 					    "Failed to write reg 0x%4.4x. error = %d\n",
385 					    regs[i].address, ret);
386 
387 			return ret;
388 		}
389 	}
390 
391 	return 0;
392 }
393 
394 /* Open sub-device */
imx208_open(struct v4l2_subdev * sd,struct v4l2_subdev_fh * fh)395 static int imx208_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
396 {
397 	struct v4l2_mbus_framefmt *try_fmt =
398 		v4l2_subdev_state_get_format(fh->state, 0);
399 
400 	/* Initialize try_fmt */
401 	try_fmt->width = supported_modes[0].width;
402 	try_fmt->height = supported_modes[0].height;
403 	try_fmt->code = MEDIA_BUS_FMT_SRGGB10_1X10;
404 	try_fmt->field = V4L2_FIELD_NONE;
405 
406 	return 0;
407 }
408 
imx208_update_digital_gain(struct imx208 * imx208,u32 len,u32 val)409 static int imx208_update_digital_gain(struct imx208 *imx208, u32 len, u32 val)
410 {
411 	int ret;
412 
413 	val = imx208_discrete_digital_gain[val] << IMX208_DIGITAL_GAIN_SHIFT;
414 
415 	ret = imx208_write_reg(imx208, IMX208_REG_GR_DIGITAL_GAIN, 2, val);
416 	if (ret)
417 		return ret;
418 
419 	ret = imx208_write_reg(imx208, IMX208_REG_GB_DIGITAL_GAIN, 2, val);
420 	if (ret)
421 		return ret;
422 
423 	ret = imx208_write_reg(imx208, IMX208_REG_R_DIGITAL_GAIN, 2, val);
424 	if (ret)
425 		return ret;
426 
427 	return imx208_write_reg(imx208, IMX208_REG_B_DIGITAL_GAIN, 2, val);
428 }
429 
imx208_set_ctrl(struct v4l2_ctrl * ctrl)430 static int imx208_set_ctrl(struct v4l2_ctrl *ctrl)
431 {
432 	struct imx208 *imx208 =
433 		container_of(ctrl->handler, struct imx208, ctrl_handler);
434 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
435 	int ret;
436 
437 	/*
438 	 * Applying V4L2 control value only happens
439 	 * when power is up for streaming
440 	 */
441 	if (!pm_runtime_get_if_in_use(&client->dev))
442 		return 0;
443 
444 	switch (ctrl->id) {
445 	case V4L2_CID_ANALOGUE_GAIN:
446 		ret = imx208_write_reg(imx208, IMX208_REG_ANALOG_GAIN,
447 				       2, ctrl->val);
448 		break;
449 	case V4L2_CID_EXPOSURE:
450 		ret = imx208_write_reg(imx208, IMX208_REG_EXPOSURE,
451 				       2, ctrl->val);
452 		break;
453 	case V4L2_CID_DIGITAL_GAIN:
454 		ret = imx208_update_digital_gain(imx208, 2, ctrl->val);
455 		break;
456 	case V4L2_CID_VBLANK:
457 		/* Update VTS that meets expected vertical blanking */
458 		ret = imx208_write_reg(imx208, IMX208_REG_VTS, 2,
459 				       imx208->cur_mode->height + ctrl->val);
460 		break;
461 	case V4L2_CID_TEST_PATTERN:
462 		ret = imx208_write_reg(imx208, IMX208_REG_TEST_PATTERN_MODE,
463 				       2, imx208_test_pattern_val[ctrl->val]);
464 		break;
465 	case V4L2_CID_HFLIP:
466 	case V4L2_CID_VFLIP:
467 		ret = imx208_write_reg(imx208, IMX208_REG_ORIENTATION_CONTROL,
468 				       1,
469 				       imx208->hflip->val |
470 				       imx208->vflip->val << 1);
471 		break;
472 	default:
473 		ret = -EINVAL;
474 		dev_err(&client->dev,
475 			"ctrl(id:0x%x,val:0x%x) is not handled\n",
476 			ctrl->id, ctrl->val);
477 		break;
478 	}
479 
480 	pm_runtime_put(&client->dev);
481 
482 	return ret;
483 }
484 
485 static const struct v4l2_ctrl_ops imx208_ctrl_ops = {
486 	.s_ctrl = imx208_set_ctrl,
487 };
488 
489 static const struct v4l2_ctrl_config imx208_digital_gain_control = {
490 	.ops = &imx208_ctrl_ops,
491 	.id = V4L2_CID_DIGITAL_GAIN,
492 	.name = "Digital Gain",
493 	.type = V4L2_CTRL_TYPE_INTEGER_MENU,
494 	.min = 0,
495 	.max = ARRAY_SIZE(imx208_discrete_digital_gain) - 1,
496 	.step = 0,
497 	.def = 0,
498 	.menu_skip_mask = 0,
499 	.qmenu_int = imx208_discrete_digital_gain,
500 };
501 
imx208_enum_mbus_code(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_mbus_code_enum * code)502 static int imx208_enum_mbus_code(struct v4l2_subdev *sd,
503 				 struct v4l2_subdev_state *sd_state,
504 				 struct v4l2_subdev_mbus_code_enum *code)
505 {
506 	struct imx208 *imx208 = to_imx208(sd);
507 
508 	if (code->index > 0)
509 		return -EINVAL;
510 
511 	code->code = imx208_get_format_code(imx208);
512 
513 	return 0;
514 }
515 
imx208_enum_frame_size(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_frame_size_enum * fse)516 static int imx208_enum_frame_size(struct v4l2_subdev *sd,
517 				  struct v4l2_subdev_state *sd_state,
518 				  struct v4l2_subdev_frame_size_enum *fse)
519 {
520 	struct imx208 *imx208 = to_imx208(sd);
521 
522 	if (fse->index >= ARRAY_SIZE(supported_modes))
523 		return -EINVAL;
524 
525 	if (fse->code != imx208_get_format_code(imx208))
526 		return -EINVAL;
527 
528 	fse->min_width = supported_modes[fse->index].width;
529 	fse->max_width = fse->min_width;
530 	fse->min_height = supported_modes[fse->index].height;
531 	fse->max_height = fse->min_height;
532 
533 	return 0;
534 }
535 
imx208_mode_to_pad_format(struct imx208 * imx208,const struct imx208_mode * mode,struct v4l2_subdev_format * fmt)536 static void imx208_mode_to_pad_format(struct imx208 *imx208,
537 				      const struct imx208_mode *mode,
538 				      struct v4l2_subdev_format *fmt)
539 {
540 	fmt->format.width = mode->width;
541 	fmt->format.height = mode->height;
542 	fmt->format.code = imx208_get_format_code(imx208);
543 	fmt->format.field = V4L2_FIELD_NONE;
544 }
545 
__imx208_get_pad_format(struct imx208 * imx208,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_format * fmt)546 static int __imx208_get_pad_format(struct imx208 *imx208,
547 				   struct v4l2_subdev_state *sd_state,
548 				   struct v4l2_subdev_format *fmt)
549 {
550 	if (fmt->which == V4L2_SUBDEV_FORMAT_TRY)
551 		fmt->format = *v4l2_subdev_state_get_format(sd_state,
552 							    fmt->pad);
553 	else
554 		imx208_mode_to_pad_format(imx208, imx208->cur_mode, fmt);
555 
556 	return 0;
557 }
558 
imx208_get_pad_format(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_format * fmt)559 static int imx208_get_pad_format(struct v4l2_subdev *sd,
560 				 struct v4l2_subdev_state *sd_state,
561 				 struct v4l2_subdev_format *fmt)
562 {
563 	struct imx208 *imx208 = to_imx208(sd);
564 	int ret;
565 
566 	mutex_lock(&imx208->imx208_mx);
567 	ret = __imx208_get_pad_format(imx208, sd_state, fmt);
568 	mutex_unlock(&imx208->imx208_mx);
569 
570 	return ret;
571 }
572 
imx208_set_pad_format(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_format * fmt)573 static int imx208_set_pad_format(struct v4l2_subdev *sd,
574 				 struct v4l2_subdev_state *sd_state,
575 				 struct v4l2_subdev_format *fmt)
576 {
577 	struct imx208 *imx208 = to_imx208(sd);
578 	const struct imx208_mode *mode;
579 	s32 vblank_def;
580 	s32 vblank_min;
581 	s64 h_blank;
582 	s64 pixel_rate;
583 	s64 link_freq;
584 
585 	mutex_lock(&imx208->imx208_mx);
586 
587 	fmt->format.code = imx208_get_format_code(imx208);
588 	mode = v4l2_find_nearest_size(supported_modes,
589 				      ARRAY_SIZE(supported_modes), width, height,
590 				      fmt->format.width, fmt->format.height);
591 	imx208_mode_to_pad_format(imx208, mode, fmt);
592 	if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
593 		*v4l2_subdev_state_get_format(sd_state, fmt->pad) = fmt->format;
594 	} else {
595 		imx208->cur_mode = mode;
596 		__v4l2_ctrl_s_ctrl(imx208->link_freq, mode->link_freq_index);
597 		link_freq = link_freq_menu_items[mode->link_freq_index];
598 		pixel_rate = link_freq_to_pixel_rate(link_freq);
599 		__v4l2_ctrl_s_ctrl_int64(imx208->pixel_rate, pixel_rate);
600 		/* Update limits and set FPS to default */
601 		vblank_def = imx208->cur_mode->vts_def -
602 			     imx208->cur_mode->height;
603 		vblank_min = imx208->cur_mode->vts_min -
604 			     imx208->cur_mode->height;
605 		__v4l2_ctrl_modify_range(imx208->vblank, vblank_min,
606 					 IMX208_VTS_MAX - imx208->cur_mode->height,
607 					 1, vblank_def);
608 		__v4l2_ctrl_s_ctrl(imx208->vblank, vblank_def);
609 		h_blank =
610 			link_freq_configs[mode->link_freq_index].pixels_per_line
611 			 - imx208->cur_mode->width;
612 		__v4l2_ctrl_modify_range(imx208->hblank, h_blank,
613 					 h_blank, 1, h_blank);
614 	}
615 
616 	mutex_unlock(&imx208->imx208_mx);
617 
618 	return 0;
619 }
620 
imx208_identify_module(struct imx208 * imx208)621 static int imx208_identify_module(struct imx208 *imx208)
622 {
623 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
624 	int ret;
625 	u32 val;
626 
627 	if (imx208->identified)
628 		return 0;
629 
630 	ret = imx208_read_reg(imx208, IMX208_REG_CHIP_ID,
631 			      2, &val);
632 	if (ret) {
633 		dev_err(&client->dev, "failed to read chip id %x\n",
634 			IMX208_CHIP_ID);
635 		return ret;
636 	}
637 
638 	if (val != IMX208_CHIP_ID) {
639 		dev_err(&client->dev, "chip id mismatch: %x!=%x\n",
640 			IMX208_CHIP_ID, val);
641 		return -EIO;
642 	}
643 
644 	imx208->identified = true;
645 
646 	return 0;
647 }
648 
649 /* Start streaming */
imx208_start_streaming(struct imx208 * imx208)650 static int imx208_start_streaming(struct imx208 *imx208)
651 {
652 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
653 	const struct imx208_reg_list *reg_list;
654 	int ret, link_freq_index;
655 
656 	ret = imx208_identify_module(imx208);
657 	if (ret)
658 		return ret;
659 
660 	/* Setup PLL */
661 	link_freq_index = imx208->cur_mode->link_freq_index;
662 	reg_list = &link_freq_configs[link_freq_index].reg_list;
663 	ret = imx208_write_regs(imx208, reg_list->regs, reg_list->num_of_regs);
664 	if (ret) {
665 		dev_err(&client->dev, "%s failed to set plls\n", __func__);
666 		return ret;
667 	}
668 
669 	/* Apply default values of current mode */
670 	reg_list = &imx208->cur_mode->reg_list;
671 	ret = imx208_write_regs(imx208, reg_list->regs, reg_list->num_of_regs);
672 	if (ret) {
673 		dev_err(&client->dev, "%s failed to set mode\n", __func__);
674 		return ret;
675 	}
676 
677 	/* Apply customized values from user */
678 	ret =  __v4l2_ctrl_handler_setup(imx208->sd.ctrl_handler);
679 	if (ret)
680 		return ret;
681 
682 	/* set stream on register */
683 	return imx208_write_reg(imx208, IMX208_REG_MODE_SELECT,
684 				1, IMX208_MODE_STREAMING);
685 }
686 
687 /* Stop streaming */
imx208_stop_streaming(struct imx208 * imx208)688 static int imx208_stop_streaming(struct imx208 *imx208)
689 {
690 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
691 	int ret;
692 
693 	/* set stream off register */
694 	ret = imx208_write_reg(imx208, IMX208_REG_MODE_SELECT,
695 			       1, IMX208_MODE_STANDBY);
696 	if (ret)
697 		dev_err(&client->dev, "%s failed to set stream\n", __func__);
698 
699 	/*
700 	 * Return success even if it was an error, as there is nothing the
701 	 * caller can do about it.
702 	 */
703 	return 0;
704 }
705 
imx208_set_stream(struct v4l2_subdev * sd,int enable)706 static int imx208_set_stream(struct v4l2_subdev *sd, int enable)
707 {
708 	struct imx208 *imx208 = to_imx208(sd);
709 	struct i2c_client *client = v4l2_get_subdevdata(sd);
710 	int ret = 0;
711 
712 	mutex_lock(&imx208->imx208_mx);
713 
714 	if (enable) {
715 		ret = pm_runtime_resume_and_get(&client->dev);
716 		if (ret) {
717 			mutex_unlock(&imx208->imx208_mx);
718 			return ret;
719 		}
720 
721 		/*
722 		 * Apply default & customized values
723 		 * and then start streaming.
724 		 */
725 		ret = imx208_start_streaming(imx208);
726 		if (ret)
727 			goto err_rpm_put;
728 	} else {
729 		imx208_stop_streaming(imx208);
730 		pm_runtime_put(&client->dev);
731 	}
732 
733 	mutex_unlock(&imx208->imx208_mx);
734 
735 	/* vflip and hflip cannot change during streaming */
736 	v4l2_ctrl_grab(imx208->vflip, enable);
737 	v4l2_ctrl_grab(imx208->hflip, enable);
738 
739 	return ret;
740 
741 err_rpm_put:
742 	pm_runtime_put(&client->dev);
743 	mutex_unlock(&imx208->imx208_mx);
744 
745 	return ret;
746 }
747 
748 /* Verify chip ID */
749 static const struct v4l2_subdev_video_ops imx208_video_ops = {
750 	.s_stream = imx208_set_stream,
751 };
752 
753 static const struct v4l2_subdev_pad_ops imx208_pad_ops = {
754 	.enum_mbus_code = imx208_enum_mbus_code,
755 	.get_fmt = imx208_get_pad_format,
756 	.set_fmt = imx208_set_pad_format,
757 	.enum_frame_size = imx208_enum_frame_size,
758 };
759 
760 static const struct v4l2_subdev_ops imx208_subdev_ops = {
761 	.video = &imx208_video_ops,
762 	.pad = &imx208_pad_ops,
763 };
764 
765 static const struct v4l2_subdev_internal_ops imx208_internal_ops = {
766 	.open = imx208_open,
767 };
768 
imx208_read_otp(struct imx208 * imx208)769 static int imx208_read_otp(struct imx208 *imx208)
770 {
771 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
772 	struct i2c_msg msgs[2];
773 	u8 addr_buf[2] = { IMX208_OTP_BASE >> 8, IMX208_OTP_BASE & 0xff };
774 	int ret = 0;
775 
776 	mutex_lock(&imx208->imx208_mx);
777 
778 	if (imx208->otp_read)
779 		goto out_unlock;
780 
781 	ret = pm_runtime_resume_and_get(&client->dev);
782 	if (ret)
783 		goto out_unlock;
784 
785 	ret = imx208_identify_module(imx208);
786 	if (ret)
787 		goto out_pm_put;
788 
789 	/* Write register address */
790 	msgs[0].addr = client->addr;
791 	msgs[0].flags = 0;
792 	msgs[0].len = ARRAY_SIZE(addr_buf);
793 	msgs[0].buf = addr_buf;
794 
795 	/* Read data from registers */
796 	msgs[1].addr = client->addr;
797 	msgs[1].flags = I2C_M_RD;
798 	msgs[1].len = sizeof(imx208->otp_data);
799 	msgs[1].buf = imx208->otp_data;
800 
801 	ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
802 	if (ret == ARRAY_SIZE(msgs)) {
803 		imx208->otp_read = true;
804 		ret = 0;
805 	}
806 
807 out_pm_put:
808 	pm_runtime_put(&client->dev);
809 
810 out_unlock:
811 	mutex_unlock(&imx208->imx208_mx);
812 
813 	return ret;
814 }
815 
otp_read(struct file * filp,struct kobject * kobj,struct bin_attribute * bin_attr,char * buf,loff_t off,size_t count)816 static ssize_t otp_read(struct file *filp, struct kobject *kobj,
817 			struct bin_attribute *bin_attr,
818 			char *buf, loff_t off, size_t count)
819 {
820 	struct i2c_client *client = to_i2c_client(kobj_to_dev(kobj));
821 	struct v4l2_subdev *sd = i2c_get_clientdata(client);
822 	struct imx208 *imx208 = to_imx208(sd);
823 	int ret;
824 
825 	ret = imx208_read_otp(imx208);
826 	if (ret)
827 		return ret;
828 
829 	memcpy(buf, &imx208->otp_data[off], count);
830 	return count;
831 }
832 
833 static const BIN_ATTR_RO(otp, IMX208_OTP_SIZE);
834 
835 /* Initialize control handlers */
imx208_init_controls(struct imx208 * imx208)836 static int imx208_init_controls(struct imx208 *imx208)
837 {
838 	struct i2c_client *client = v4l2_get_subdevdata(&imx208->sd);
839 	struct v4l2_ctrl_handler *ctrl_hdlr = &imx208->ctrl_handler;
840 	s64 exposure_max;
841 	s64 vblank_def;
842 	s64 vblank_min;
843 	s64 pixel_rate_min;
844 	s64 pixel_rate_max;
845 	int ret;
846 
847 	ret = v4l2_ctrl_handler_init(ctrl_hdlr, 8);
848 	if (ret)
849 		return ret;
850 
851 	mutex_init(&imx208->imx208_mx);
852 	ctrl_hdlr->lock = &imx208->imx208_mx;
853 	imx208->link_freq =
854 		v4l2_ctrl_new_int_menu(ctrl_hdlr,
855 				       &imx208_ctrl_ops,
856 				       V4L2_CID_LINK_FREQ,
857 				       ARRAY_SIZE(link_freq_menu_items) - 1,
858 				       0, link_freq_menu_items);
859 
860 	if (imx208->link_freq)
861 		imx208->link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY;
862 
863 	pixel_rate_max = link_freq_to_pixel_rate(link_freq_menu_items[0]);
864 	pixel_rate_min =
865 		link_freq_to_pixel_rate(link_freq_menu_items[ARRAY_SIZE(link_freq_menu_items) - 1]);
866 	/* By default, PIXEL_RATE is read only */
867 	imx208->pixel_rate = v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops,
868 					       V4L2_CID_PIXEL_RATE,
869 					       pixel_rate_min, pixel_rate_max,
870 					       1, pixel_rate_max);
871 
872 	vblank_def = imx208->cur_mode->vts_def - imx208->cur_mode->height;
873 	vblank_min = imx208->cur_mode->vts_min - imx208->cur_mode->height;
874 	imx208->vblank =
875 		v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops, V4L2_CID_VBLANK,
876 				  vblank_min,
877 				  IMX208_VTS_MAX - imx208->cur_mode->height, 1,
878 				  vblank_def);
879 
880 	imx208->hblank =
881 		v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops, V4L2_CID_HBLANK,
882 				  IMX208_PPL_384MHZ - imx208->cur_mode->width,
883 				  IMX208_PPL_384MHZ - imx208->cur_mode->width,
884 				  1,
885 				  IMX208_PPL_384MHZ - imx208->cur_mode->width);
886 
887 	if (imx208->hblank)
888 		imx208->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
889 
890 	exposure_max = imx208->cur_mode->vts_def - 8;
891 	v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops, V4L2_CID_EXPOSURE,
892 			  IMX208_EXPOSURE_MIN, exposure_max,
893 			  IMX208_EXPOSURE_STEP, IMX208_EXPOSURE_DEFAULT);
894 
895 	imx208->hflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops,
896 					  V4L2_CID_HFLIP, 0, 1, 1, 0);
897 	if (imx208->hflip)
898 		imx208->hflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
899 	imx208->vflip = v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops,
900 					  V4L2_CID_VFLIP, 0, 1, 1, 0);
901 	if (imx208->vflip)
902 		imx208->vflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
903 
904 	v4l2_ctrl_new_std(ctrl_hdlr, &imx208_ctrl_ops, V4L2_CID_ANALOGUE_GAIN,
905 			  IMX208_ANA_GAIN_MIN, IMX208_ANA_GAIN_MAX,
906 			  IMX208_ANA_GAIN_STEP, IMX208_ANA_GAIN_DEFAULT);
907 
908 	v4l2_ctrl_new_custom(ctrl_hdlr, &imx208_digital_gain_control, NULL);
909 
910 	v4l2_ctrl_new_std_menu_items(ctrl_hdlr, &imx208_ctrl_ops,
911 				     V4L2_CID_TEST_PATTERN,
912 				     ARRAY_SIZE(imx208_test_pattern_menu) - 1,
913 				     0, 0, imx208_test_pattern_menu);
914 
915 	if (ctrl_hdlr->error) {
916 		ret = ctrl_hdlr->error;
917 		dev_err(&client->dev, "%s control init failed (%d)\n",
918 			__func__, ret);
919 		goto error;
920 	}
921 
922 	imx208->sd.ctrl_handler = ctrl_hdlr;
923 
924 	return 0;
925 
926 error:
927 	v4l2_ctrl_handler_free(ctrl_hdlr);
928 	mutex_destroy(&imx208->imx208_mx);
929 
930 	return ret;
931 }
932 
imx208_free_controls(struct imx208 * imx208)933 static void imx208_free_controls(struct imx208 *imx208)
934 {
935 	v4l2_ctrl_handler_free(imx208->sd.ctrl_handler);
936 }
937 
imx208_probe(struct i2c_client * client)938 static int imx208_probe(struct i2c_client *client)
939 {
940 	struct imx208 *imx208;
941 	int ret;
942 	bool full_power;
943 	u32 val = 0;
944 
945 	device_property_read_u32(&client->dev, "clock-frequency", &val);
946 	if (val != 19200000) {
947 		dev_err(&client->dev,
948 			"Unsupported clock-frequency %u. Expected 19200000.\n",
949 			val);
950 		return -EINVAL;
951 	}
952 
953 	imx208 = devm_kzalloc(&client->dev, sizeof(*imx208), GFP_KERNEL);
954 	if (!imx208)
955 		return -ENOMEM;
956 
957 	/* Initialize subdev */
958 	v4l2_i2c_subdev_init(&imx208->sd, client, &imx208_subdev_ops);
959 
960 	full_power = acpi_dev_state_d0(&client->dev);
961 	if (full_power) {
962 		/* Check module identity */
963 		ret = imx208_identify_module(imx208);
964 		if (ret) {
965 			dev_err(&client->dev, "failed to find sensor: %d", ret);
966 			goto error_probe;
967 		}
968 	}
969 
970 	/* Set default mode to max resolution */
971 	imx208->cur_mode = &supported_modes[0];
972 
973 	ret = imx208_init_controls(imx208);
974 	if (ret) {
975 		dev_err(&client->dev, "failed to init controls: %d", ret);
976 		goto error_probe;
977 	}
978 
979 	/* Initialize subdev */
980 	imx208->sd.internal_ops = &imx208_internal_ops;
981 	imx208->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
982 	imx208->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
983 
984 	/* Initialize source pad */
985 	imx208->pad.flags = MEDIA_PAD_FL_SOURCE;
986 	ret = media_entity_pads_init(&imx208->sd.entity, 1, &imx208->pad);
987 	if (ret) {
988 		dev_err(&client->dev, "%s failed:%d\n", __func__, ret);
989 		goto error_handler_free;
990 	}
991 
992 	ret = v4l2_async_register_subdev_sensor(&imx208->sd);
993 	if (ret < 0)
994 		goto error_media_entity;
995 
996 	ret = device_create_bin_file(&client->dev, &bin_attr_otp);
997 	if (ret) {
998 		dev_err(&client->dev, "sysfs otp creation failed\n");
999 		goto error_async_subdev;
1000 	}
1001 
1002 	/* Set the device's state to active if it's in D0 state. */
1003 	if (full_power)
1004 		pm_runtime_set_active(&client->dev);
1005 	pm_runtime_enable(&client->dev);
1006 	pm_runtime_idle(&client->dev);
1007 
1008 	return 0;
1009 
1010 error_async_subdev:
1011 	v4l2_async_unregister_subdev(&imx208->sd);
1012 
1013 error_media_entity:
1014 	media_entity_cleanup(&imx208->sd.entity);
1015 
1016 error_handler_free:
1017 	imx208_free_controls(imx208);
1018 
1019 error_probe:
1020 	mutex_destroy(&imx208->imx208_mx);
1021 
1022 	return ret;
1023 }
1024 
imx208_remove(struct i2c_client * client)1025 static void imx208_remove(struct i2c_client *client)
1026 {
1027 	struct v4l2_subdev *sd = i2c_get_clientdata(client);
1028 	struct imx208 *imx208 = to_imx208(sd);
1029 
1030 	device_remove_bin_file(&client->dev, &bin_attr_otp);
1031 	v4l2_async_unregister_subdev(sd);
1032 	media_entity_cleanup(&sd->entity);
1033 	imx208_free_controls(imx208);
1034 
1035 	pm_runtime_disable(&client->dev);
1036 	pm_runtime_set_suspended(&client->dev);
1037 
1038 	mutex_destroy(&imx208->imx208_mx);
1039 }
1040 
1041 #ifdef CONFIG_ACPI
1042 static const struct acpi_device_id imx208_acpi_ids[] = {
1043 	{ "INT3478" },
1044 	{ /* sentinel */ }
1045 };
1046 
1047 MODULE_DEVICE_TABLE(acpi, imx208_acpi_ids);
1048 #endif
1049 
1050 static struct i2c_driver imx208_i2c_driver = {
1051 	.driver = {
1052 		.name = "imx208",
1053 		.acpi_match_table = ACPI_PTR(imx208_acpi_ids),
1054 	},
1055 	.probe = imx208_probe,
1056 	.remove = imx208_remove,
1057 	.flags = I2C_DRV_ACPI_WAIVE_D0_PROBE,
1058 };
1059 
1060 module_i2c_driver(imx208_i2c_driver);
1061 
1062 MODULE_AUTHOR("Yeh, Andy <andy.yeh@intel.com>");
1063 MODULE_AUTHOR("Chen, Ping-chung <ping-chung.chen@intel.com>");
1064 MODULE_AUTHOR("Shawn Tu");
1065 MODULE_DESCRIPTION("Sony IMX208 sensor driver");
1066 MODULE_LICENSE("GPL v2");
1067