xref: /openbmc/linux/drivers/media/i2c/imx274.c (revision aaeb31c0)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * imx274.c - IMX274 CMOS Image Sensor driver
4  *
5  * Copyright (C) 2017, Leopard Imaging, Inc.
6  *
7  * Leon Luo <leonl@leopardimaging.com>
8  * Edwin Zou <edwinz@leopardimaging.com>
9  * Luca Ceresoli <luca@lucaceresoli.net>
10  */
11 
12 #include <linux/clk.h>
13 #include <linux/delay.h>
14 #include <linux/gpio/consumer.h>
15 #include <linux/i2c.h>
16 #include <linux/init.h>
17 #include <linux/kernel.h>
18 #include <linux/module.h>
19 #include <linux/pm_runtime.h>
20 #include <linux/regmap.h>
21 #include <linux/regulator/consumer.h>
22 #include <linux/slab.h>
23 #include <linux/v4l2-mediabus.h>
24 #include <linux/videodev2.h>
25 
26 #include <media/v4l2-ctrls.h>
27 #include <media/v4l2-device.h>
28 #include <media/v4l2-fwnode.h>
29 #include <media/v4l2-subdev.h>
30 
31 /*
32  * See "SHR, SVR Setting" in datasheet
33  */
34 #define IMX274_DEFAULT_FRAME_LENGTH		(4550)
35 #define IMX274_MAX_FRAME_LENGTH			(0x000fffff)
36 
37 /*
38  * See "Frame Rate Adjustment" in datasheet
39  */
40 #define IMX274_PIXCLK_CONST1			(72000000)
41 #define IMX274_PIXCLK_CONST2			(1000000)
42 
43 /*
44  * The input gain is shifted by IMX274_GAIN_SHIFT to get
45  * decimal number. The real gain is
46  * (float)input_gain_value / (1 << IMX274_GAIN_SHIFT)
47  */
48 #define IMX274_GAIN_SHIFT			(8)
49 #define IMX274_GAIN_SHIFT_MASK			((1 << IMX274_GAIN_SHIFT) - 1)
50 
51 /*
52  * See "Analog Gain" and "Digital Gain" in datasheet
53  * min gain is 1X
54  * max gain is calculated based on IMX274_GAIN_REG_MAX
55  */
56 #define IMX274_GAIN_REG_MAX			(1957)
57 #define IMX274_MIN_GAIN				(0x01 << IMX274_GAIN_SHIFT)
58 #define IMX274_MAX_ANALOG_GAIN			((2048 << IMX274_GAIN_SHIFT)\
59 					/ (2048 - IMX274_GAIN_REG_MAX))
60 #define IMX274_MAX_DIGITAL_GAIN			(8)
61 #define IMX274_DEF_GAIN				(20 << IMX274_GAIN_SHIFT)
62 #define IMX274_GAIN_CONST			(2048) /* for gain formula */
63 
64 /*
65  * 1 line time in us = (HMAX / 72), minimal is 4 lines
66  */
67 #define IMX274_MIN_EXPOSURE_TIME		(4 * 260 / 72)
68 
69 #define IMX274_MAX_WIDTH			(3840)
70 #define IMX274_MAX_HEIGHT			(2160)
71 #define IMX274_MAX_FRAME_RATE			(120)
72 #define IMX274_MIN_FRAME_RATE			(5)
73 #define IMX274_DEF_FRAME_RATE			(60)
74 
75 /*
76  * register SHR is limited to (SVR value + 1) x VMAX value - 4
77  */
78 #define IMX274_SHR_LIMIT_CONST			(4)
79 
80 /*
81  * Min and max sensor reset delay (microseconds)
82  */
83 #define IMX274_RESET_DELAY1			(2000)
84 #define IMX274_RESET_DELAY2			(2200)
85 
86 /*
87  * shift and mask constants
88  */
89 #define IMX274_SHIFT_8_BITS			(8)
90 #define IMX274_SHIFT_16_BITS			(16)
91 #define IMX274_MASK_LSB_2_BITS			(0x03)
92 #define IMX274_MASK_LSB_3_BITS			(0x07)
93 #define IMX274_MASK_LSB_4_BITS			(0x0f)
94 #define IMX274_MASK_LSB_8_BITS			(0x00ff)
95 
96 #define DRIVER_NAME "IMX274"
97 
98 /*
99  * IMX274 register definitions
100  */
101 #define IMX274_SHR_REG_MSB			0x300D /* SHR */
102 #define IMX274_SHR_REG_LSB			0x300C /* SHR */
103 #define IMX274_SVR_REG_MSB			0x300F /* SVR */
104 #define IMX274_SVR_REG_LSB			0x300E /* SVR */
105 #define IMX274_HTRIM_EN_REG			0x3037
106 #define IMX274_HTRIM_START_REG_LSB		0x3038
107 #define IMX274_HTRIM_START_REG_MSB		0x3039
108 #define IMX274_HTRIM_END_REG_LSB		0x303A
109 #define IMX274_HTRIM_END_REG_MSB		0x303B
110 #define IMX274_VWIDCUTEN_REG			0x30DD
111 #define IMX274_VWIDCUT_REG_LSB			0x30DE
112 #define IMX274_VWIDCUT_REG_MSB			0x30DF
113 #define IMX274_VWINPOS_REG_LSB			0x30E0
114 #define IMX274_VWINPOS_REG_MSB			0x30E1
115 #define IMX274_WRITE_VSIZE_REG_LSB		0x3130
116 #define IMX274_WRITE_VSIZE_REG_MSB		0x3131
117 #define IMX274_Y_OUT_SIZE_REG_LSB		0x3132
118 #define IMX274_Y_OUT_SIZE_REG_MSB		0x3133
119 #define IMX274_VMAX_REG_1			0x30FA /* VMAX, MSB */
120 #define IMX274_VMAX_REG_2			0x30F9 /* VMAX */
121 #define IMX274_VMAX_REG_3			0x30F8 /* VMAX, LSB */
122 #define IMX274_HMAX_REG_MSB			0x30F7 /* HMAX */
123 #define IMX274_HMAX_REG_LSB			0x30F6 /* HMAX */
124 #define IMX274_ANALOG_GAIN_ADDR_LSB		0x300A /* ANALOG GAIN LSB */
125 #define IMX274_ANALOG_GAIN_ADDR_MSB		0x300B /* ANALOG GAIN MSB */
126 #define IMX274_DIGITAL_GAIN_REG			0x3012 /* Digital Gain */
127 #define IMX274_VFLIP_REG			0x301A /* VERTICAL FLIP */
128 #define IMX274_TEST_PATTERN_REG			0x303D /* TEST PATTERN */
129 #define IMX274_STANDBY_REG			0x3000 /* STANDBY */
130 
131 #define IMX274_TABLE_WAIT_MS			0
132 #define IMX274_TABLE_END			1
133 
134 /* regulator supplies */
135 static const char * const imx274_supply_names[] = {
136 	"vddl",  /* IF (1.2V) supply */
137 	"vdig",  /* Digital Core (1.8V) supply */
138 	"vana",  /* Analog (2.8V) supply */
139 };
140 
141 #define IMX274_NUM_SUPPLIES ARRAY_SIZE(imx274_supply_names)
142 
143 /*
144  * imx274 I2C operation related structure
145  */
146 struct reg_8 {
147 	u16 addr;
148 	u8 val;
149 };
150 
151 static const struct regmap_config imx274_regmap_config = {
152 	.reg_bits = 16,
153 	.val_bits = 8,
154 	.cache_type = REGCACHE_RBTREE,
155 };
156 
157 /*
158  * Parameters for each imx274 readout mode.
159  *
160  * These are the values to configure the sensor in one of the
161  * implemented modes.
162  *
163  * @init_regs: registers to initialize the mode
164  * @wbin_ratio: width downscale factor (e.g. 3 for 1280; 3 = 3840/1280)
165  * @hbin_ratio: height downscale factor (e.g. 3 for 720; 3 = 2160/720)
166  * @min_frame_len: Minimum frame length for each mode (see "Frame Rate
167  *                 Adjustment (CSI-2)" in the datasheet)
168  * @min_SHR: Minimum SHR register value (see "Shutter Setting (CSI-2)" in the
169  *           datasheet)
170  * @max_fps: Maximum frames per second
171  * @nocpiop: Number of clocks per internal offset period (see "Integration Time
172  *           in Each Readout Drive Mode (CSI-2)" in the datasheet)
173  */
174 struct imx274_mode {
175 	const struct reg_8 *init_regs;
176 	u8 wbin_ratio;
177 	u8 hbin_ratio;
178 	int min_frame_len;
179 	int min_SHR;
180 	int max_fps;
181 	int nocpiop;
182 };
183 
184 /*
185  * imx274 test pattern related structure
186  */
187 enum {
188 	TEST_PATTERN_DISABLED = 0,
189 	TEST_PATTERN_ALL_000H,
190 	TEST_PATTERN_ALL_FFFH,
191 	TEST_PATTERN_ALL_555H,
192 	TEST_PATTERN_ALL_AAAH,
193 	TEST_PATTERN_VSP_5AH, /* VERTICAL STRIPE PATTERN 555H/AAAH */
194 	TEST_PATTERN_VSP_A5H, /* VERTICAL STRIPE PATTERN AAAH/555H */
195 	TEST_PATTERN_VSP_05H, /* VERTICAL STRIPE PATTERN 000H/555H */
196 	TEST_PATTERN_VSP_50H, /* VERTICAL STRIPE PATTERN 555H/000H */
197 	TEST_PATTERN_VSP_0FH, /* VERTICAL STRIPE PATTERN 000H/FFFH */
198 	TEST_PATTERN_VSP_F0H, /* VERTICAL STRIPE PATTERN FFFH/000H */
199 	TEST_PATTERN_H_COLOR_BARS,
200 	TEST_PATTERN_V_COLOR_BARS,
201 };
202 
203 static const char * const tp_qmenu[] = {
204 	"Disabled",
205 	"All 000h Pattern",
206 	"All FFFh Pattern",
207 	"All 555h Pattern",
208 	"All AAAh Pattern",
209 	"Vertical Stripe (555h / AAAh)",
210 	"Vertical Stripe (AAAh / 555h)",
211 	"Vertical Stripe (000h / 555h)",
212 	"Vertical Stripe (555h / 000h)",
213 	"Vertical Stripe (000h / FFFh)",
214 	"Vertical Stripe (FFFh / 000h)",
215 	"Vertical Color Bars",
216 	"Horizontal Color Bars",
217 };
218 
219 /*
220  * All-pixel scan mode (10-bit)
221  * imx274 mode1(refer to datasheet) register configuration with
222  * 3840x2160 resolution, raw10 data and mipi four lane output
223  */
224 static const struct reg_8 imx274_mode1_3840x2160_raw10[] = {
225 	{0x3004, 0x01},
226 	{0x3005, 0x01},
227 	{0x3006, 0x00},
228 	{0x3007, 0xa2},
229 
230 	{0x3018, 0xA2}, /* output XVS, HVS */
231 
232 	{0x306B, 0x05},
233 	{0x30E2, 0x01},
234 
235 	{0x30EE, 0x01},
236 	{0x3342, 0x0A},
237 	{0x3343, 0x00},
238 	{0x3344, 0x16},
239 	{0x3345, 0x00},
240 	{0x33A6, 0x01},
241 	{0x3528, 0x0E},
242 	{0x3554, 0x1F},
243 	{0x3555, 0x01},
244 	{0x3556, 0x01},
245 	{0x3557, 0x01},
246 	{0x3558, 0x01},
247 	{0x3559, 0x00},
248 	{0x355A, 0x00},
249 	{0x35BA, 0x0E},
250 	{0x366A, 0x1B},
251 	{0x366B, 0x1A},
252 	{0x366C, 0x19},
253 	{0x366D, 0x17},
254 	{0x3A41, 0x08},
255 
256 	{IMX274_TABLE_END, 0x00}
257 };
258 
259 /*
260  * Horizontal/vertical 2/2-line binning
261  * (Horizontal and vertical weightedbinning, 10-bit)
262  * imx274 mode3(refer to datasheet) register configuration with
263  * 1920x1080 resolution, raw10 data and mipi four lane output
264  */
265 static const struct reg_8 imx274_mode3_1920x1080_raw10[] = {
266 	{0x3004, 0x02},
267 	{0x3005, 0x21},
268 	{0x3006, 0x00},
269 	{0x3007, 0xb1},
270 
271 	{0x3018, 0xA2}, /* output XVS, HVS */
272 
273 	{0x306B, 0x05},
274 	{0x30E2, 0x02},
275 
276 	{0x30EE, 0x01},
277 	{0x3342, 0x0A},
278 	{0x3343, 0x00},
279 	{0x3344, 0x1A},
280 	{0x3345, 0x00},
281 	{0x33A6, 0x01},
282 	{0x3528, 0x0E},
283 	{0x3554, 0x00},
284 	{0x3555, 0x01},
285 	{0x3556, 0x01},
286 	{0x3557, 0x01},
287 	{0x3558, 0x01},
288 	{0x3559, 0x00},
289 	{0x355A, 0x00},
290 	{0x35BA, 0x0E},
291 	{0x366A, 0x1B},
292 	{0x366B, 0x1A},
293 	{0x366C, 0x19},
294 	{0x366D, 0x17},
295 	{0x3A41, 0x08},
296 
297 	{IMX274_TABLE_END, 0x00}
298 };
299 
300 /*
301  * Vertical 2/3 subsampling binning horizontal 3 binning
302  * imx274 mode5(refer to datasheet) register configuration with
303  * 1280x720 resolution, raw10 data and mipi four lane output
304  */
305 static const struct reg_8 imx274_mode5_1280x720_raw10[] = {
306 	{0x3004, 0x03},
307 	{0x3005, 0x31},
308 	{0x3006, 0x00},
309 	{0x3007, 0xa9},
310 
311 	{0x3018, 0xA2}, /* output XVS, HVS */
312 
313 	{0x306B, 0x05},
314 	{0x30E2, 0x03},
315 
316 	{0x30EE, 0x01},
317 	{0x3342, 0x0A},
318 	{0x3343, 0x00},
319 	{0x3344, 0x1B},
320 	{0x3345, 0x00},
321 	{0x33A6, 0x01},
322 	{0x3528, 0x0E},
323 	{0x3554, 0x00},
324 	{0x3555, 0x01},
325 	{0x3556, 0x01},
326 	{0x3557, 0x01},
327 	{0x3558, 0x01},
328 	{0x3559, 0x00},
329 	{0x355A, 0x00},
330 	{0x35BA, 0x0E},
331 	{0x366A, 0x1B},
332 	{0x366B, 0x19},
333 	{0x366C, 0x17},
334 	{0x366D, 0x17},
335 	{0x3A41, 0x04},
336 
337 	{IMX274_TABLE_END, 0x00}
338 };
339 
340 /*
341  * Vertical 2/8 subsampling horizontal 3 binning
342  * imx274 mode6(refer to datasheet) register configuration with
343  * 1280x540 resolution, raw10 data and mipi four lane output
344  */
345 static const struct reg_8 imx274_mode6_1280x540_raw10[] = {
346 	{0x3004, 0x04}, /* mode setting */
347 	{0x3005, 0x31},
348 	{0x3006, 0x00},
349 	{0x3007, 0x02}, /* mode setting */
350 
351 	{0x3018, 0xA2}, /* output XVS, HVS */
352 
353 	{0x306B, 0x05},
354 	{0x30E2, 0x04}, /* mode setting */
355 
356 	{0x30EE, 0x01},
357 	{0x3342, 0x0A},
358 	{0x3343, 0x00},
359 	{0x3344, 0x16},
360 	{0x3345, 0x00},
361 	{0x33A6, 0x01},
362 	{0x3528, 0x0E},
363 	{0x3554, 0x1F},
364 	{0x3555, 0x01},
365 	{0x3556, 0x01},
366 	{0x3557, 0x01},
367 	{0x3558, 0x01},
368 	{0x3559, 0x00},
369 	{0x355A, 0x00},
370 	{0x35BA, 0x0E},
371 	{0x366A, 0x1B},
372 	{0x366B, 0x1A},
373 	{0x366C, 0x19},
374 	{0x366D, 0x17},
375 	{0x3A41, 0x04},
376 
377 	{IMX274_TABLE_END, 0x00}
378 };
379 
380 /*
381  * imx274 first step register configuration for
382  * starting stream
383  */
384 static const struct reg_8 imx274_start_1[] = {
385 	{IMX274_STANDBY_REG, 0x12},
386 
387 	/* PLRD: clock settings */
388 	{0x3120, 0xF0},
389 	{0x3121, 0x00},
390 	{0x3122, 0x02},
391 	{0x3129, 0x9C},
392 	{0x312A, 0x02},
393 	{0x312D, 0x02},
394 
395 	{0x310B, 0x00},
396 
397 	/* PLSTMG */
398 	{0x304C, 0x00}, /* PLSTMG01 */
399 	{0x304D, 0x03},
400 	{0x331C, 0x1A},
401 	{0x331D, 0x00},
402 	{0x3502, 0x02},
403 	{0x3529, 0x0E},
404 	{0x352A, 0x0E},
405 	{0x352B, 0x0E},
406 	{0x3538, 0x0E},
407 	{0x3539, 0x0E},
408 	{0x3553, 0x00},
409 	{0x357D, 0x05},
410 	{0x357F, 0x05},
411 	{0x3581, 0x04},
412 	{0x3583, 0x76},
413 	{0x3587, 0x01},
414 	{0x35BB, 0x0E},
415 	{0x35BC, 0x0E},
416 	{0x35BD, 0x0E},
417 	{0x35BE, 0x0E},
418 	{0x35BF, 0x0E},
419 	{0x366E, 0x00},
420 	{0x366F, 0x00},
421 	{0x3670, 0x00},
422 	{0x3671, 0x00},
423 
424 	/* PSMIPI */
425 	{0x3304, 0x32}, /* PSMIPI1 */
426 	{0x3305, 0x00},
427 	{0x3306, 0x32},
428 	{0x3307, 0x00},
429 	{0x3590, 0x32},
430 	{0x3591, 0x00},
431 	{0x3686, 0x32},
432 	{0x3687, 0x00},
433 
434 	{IMX274_TABLE_END, 0x00}
435 };
436 
437 /*
438  * imx274 second step register configuration for
439  * starting stream
440  */
441 static const struct reg_8 imx274_start_2[] = {
442 	{IMX274_STANDBY_REG, 0x00},
443 	{0x303E, 0x02}, /* SYS_MODE = 2 */
444 	{IMX274_TABLE_END, 0x00}
445 };
446 
447 /*
448  * imx274 third step register configuration for
449  * starting stream
450  */
451 static const struct reg_8 imx274_start_3[] = {
452 	{0x30F4, 0x00},
453 	{0x3018, 0xA2}, /* XHS VHS OUTPUT */
454 	{IMX274_TABLE_END, 0x00}
455 };
456 
457 /*
458  * imx274 register configuration for stopping stream
459  */
460 static const struct reg_8 imx274_stop[] = {
461 	{IMX274_STANDBY_REG, 0x01},
462 	{IMX274_TABLE_END, 0x00}
463 };
464 
465 /*
466  * imx274 disable test pattern register configuration
467  */
468 static const struct reg_8 imx274_tp_disabled[] = {
469 	{0x303C, 0x00},
470 	{0x377F, 0x00},
471 	{0x3781, 0x00},
472 	{0x370B, 0x00},
473 	{IMX274_TABLE_END, 0x00}
474 };
475 
476 /*
477  * imx274 test pattern register configuration
478  * reg 0x303D defines the test pattern modes
479  */
480 static const struct reg_8 imx274_tp_regs[] = {
481 	{0x303C, 0x11},
482 	{0x370E, 0x01},
483 	{0x377F, 0x01},
484 	{0x3781, 0x01},
485 	{0x370B, 0x11},
486 	{IMX274_TABLE_END, 0x00}
487 };
488 
489 /* nocpiop happens to be the same number for the implemented modes */
490 static const struct imx274_mode imx274_modes[] = {
491 	{
492 		/* mode 1, 4K */
493 		.wbin_ratio = 1, /* 3840 */
494 		.hbin_ratio = 1, /* 2160 */
495 		.init_regs = imx274_mode1_3840x2160_raw10,
496 		.min_frame_len = 4550,
497 		.min_SHR = 12,
498 		.max_fps = 60,
499 		.nocpiop = 112,
500 	},
501 	{
502 		/* mode 3, 1080p */
503 		.wbin_ratio = 2, /* 1920 */
504 		.hbin_ratio = 2, /* 1080 */
505 		.init_regs = imx274_mode3_1920x1080_raw10,
506 		.min_frame_len = 2310,
507 		.min_SHR = 8,
508 		.max_fps = 120,
509 		.nocpiop = 112,
510 	},
511 	{
512 		/* mode 5, 720p */
513 		.wbin_ratio = 3, /* 1280 */
514 		.hbin_ratio = 3, /* 720 */
515 		.init_regs = imx274_mode5_1280x720_raw10,
516 		.min_frame_len = 2310,
517 		.min_SHR = 8,
518 		.max_fps = 120,
519 		.nocpiop = 112,
520 	},
521 	{
522 		/* mode 6, 540p */
523 		.wbin_ratio = 3, /* 1280 */
524 		.hbin_ratio = 4, /* 540 */
525 		.init_regs = imx274_mode6_1280x540_raw10,
526 		.min_frame_len = 2310,
527 		.min_SHR = 4,
528 		.max_fps = 120,
529 		.nocpiop = 112,
530 	},
531 };
532 
533 /*
534  * struct imx274_ctrls - imx274 ctrl structure
535  * @handler: V4L2 ctrl handler structure
536  * @exposure: Pointer to expsure ctrl structure
537  * @gain: Pointer to gain ctrl structure
538  * @vflip: Pointer to vflip ctrl structure
539  * @test_pattern: Pointer to test pattern ctrl structure
540  */
541 struct imx274_ctrls {
542 	struct v4l2_ctrl_handler handler;
543 	struct v4l2_ctrl *exposure;
544 	struct v4l2_ctrl *gain;
545 	struct v4l2_ctrl *vflip;
546 	struct v4l2_ctrl *test_pattern;
547 };
548 
549 /*
550  * struct stim274 - imx274 device structure
551  * @sd: V4L2 subdevice structure
552  * @pad: Media pad structure
553  * @client: Pointer to I2C client
554  * @ctrls: imx274 control structure
555  * @crop: rect to be captured
556  * @compose: compose rect, i.e. output resolution
557  * @format: V4L2 media bus frame format structure
558  *          (width and height are in sync with the compose rect)
559  * @frame_rate: V4L2 frame rate structure
560  * @regmap: Pointer to regmap structure
561  * @reset_gpio: Pointer to reset gpio
562  * @supplies: List of analog and digital supply regulators
563  * @inck: Pointer to sensor input clock
564  * @lock: Mutex structure
565  * @mode: Parameters for the selected readout mode
566  */
567 struct stimx274 {
568 	struct v4l2_subdev sd;
569 	struct media_pad pad;
570 	struct i2c_client *client;
571 	struct imx274_ctrls ctrls;
572 	struct v4l2_rect crop;
573 	struct v4l2_mbus_framefmt format;
574 	struct v4l2_fract frame_interval;
575 	struct regmap *regmap;
576 	struct gpio_desc *reset_gpio;
577 	struct regulator_bulk_data supplies[IMX274_NUM_SUPPLIES];
578 	struct clk *inck;
579 	struct mutex lock; /* mutex lock for operations */
580 	const struct imx274_mode *mode;
581 };
582 
583 #define IMX274_ROUND(dim, step, flags)			\
584 	((flags) & V4L2_SEL_FLAG_GE			\
585 	 ? roundup((dim), (step))			\
586 	 : ((flags) & V4L2_SEL_FLAG_LE			\
587 	    ? rounddown((dim), (step))			\
588 	    : rounddown((dim) + (step) / 2, (step))))
589 
590 /*
591  * Function declaration
592  */
593 static int imx274_set_gain(struct stimx274 *priv, struct v4l2_ctrl *ctrl);
594 static int imx274_set_exposure(struct stimx274 *priv, int val);
595 static int imx274_set_vflip(struct stimx274 *priv, int val);
596 static int imx274_set_test_pattern(struct stimx274 *priv, int val);
597 static int imx274_set_frame_interval(struct stimx274 *priv,
598 				     struct v4l2_fract frame_interval);
599 
msleep_range(unsigned int delay_base)600 static inline void msleep_range(unsigned int delay_base)
601 {
602 	usleep_range(delay_base * 1000, delay_base * 1000 + 500);
603 }
604 
605 /*
606  * v4l2_ctrl and v4l2_subdev related operations
607  */
ctrl_to_sd(struct v4l2_ctrl * ctrl)608 static inline struct v4l2_subdev *ctrl_to_sd(struct v4l2_ctrl *ctrl)
609 {
610 	return &container_of(ctrl->handler,
611 			     struct stimx274, ctrls.handler)->sd;
612 }
613 
to_imx274(struct v4l2_subdev * sd)614 static inline struct stimx274 *to_imx274(struct v4l2_subdev *sd)
615 {
616 	return container_of(sd, struct stimx274, sd);
617 }
618 
619 /*
620  * Writing a register table
621  *
622  * @priv: Pointer to device
623  * @table: Table containing register values (with optional delays)
624  *
625  * This is used to write register table into sensor's reg map.
626  *
627  * Return: 0 on success, errors otherwise
628  */
imx274_write_table(struct stimx274 * priv,const struct reg_8 table[])629 static int imx274_write_table(struct stimx274 *priv, const struct reg_8 table[])
630 {
631 	struct regmap *regmap = priv->regmap;
632 	int err = 0;
633 	const struct reg_8 *next;
634 	u8 val;
635 
636 	int range_start = -1;
637 	int range_count = 0;
638 	u8 range_vals[16];
639 	int max_range_vals = ARRAY_SIZE(range_vals);
640 
641 	for (next = table;; next++) {
642 		if ((next->addr != range_start + range_count) ||
643 		    (next->addr == IMX274_TABLE_END) ||
644 		    (next->addr == IMX274_TABLE_WAIT_MS) ||
645 		    (range_count == max_range_vals)) {
646 			if (range_count == 1)
647 				err = regmap_write(regmap,
648 						   range_start, range_vals[0]);
649 			else if (range_count > 1)
650 				err = regmap_bulk_write(regmap, range_start,
651 							&range_vals[0],
652 							range_count);
653 			else
654 				err = 0;
655 
656 			if (err)
657 				return err;
658 
659 			range_start = -1;
660 			range_count = 0;
661 
662 			/* Handle special address values */
663 			if (next->addr == IMX274_TABLE_END)
664 				break;
665 
666 			if (next->addr == IMX274_TABLE_WAIT_MS) {
667 				msleep_range(next->val);
668 				continue;
669 			}
670 		}
671 
672 		val = next->val;
673 
674 		if (range_start == -1)
675 			range_start = next->addr;
676 
677 		range_vals[range_count++] = val;
678 	}
679 	return 0;
680 }
681 
imx274_write_reg(struct stimx274 * priv,u16 addr,u8 val)682 static inline int imx274_write_reg(struct stimx274 *priv, u16 addr, u8 val)
683 {
684 	int err;
685 
686 	err = regmap_write(priv->regmap, addr, val);
687 	if (err)
688 		dev_err(&priv->client->dev,
689 			"%s : i2c write failed, %x = %x\n", __func__,
690 			addr, val);
691 	else
692 		dev_dbg(&priv->client->dev,
693 			"%s : addr 0x%x, val=0x%x\n", __func__,
694 			addr, val);
695 	return err;
696 }
697 
698 /**
699  * imx274_read_mbreg - Read a multibyte register.
700  *
701  * Uses a bulk read where possible.
702  *
703  * @priv: Pointer to device structure
704  * @addr: Address of the LSB register.  Other registers must be
705  *        consecutive, least-to-most significant.
706  * @val: Pointer to store the register value (cpu endianness)
707  * @nbytes: Number of bytes to read (range: [1..3]).
708  *          Other bytes are zet to 0.
709  *
710  * Return: 0 on success, errors otherwise
711  */
imx274_read_mbreg(struct stimx274 * priv,u16 addr,u32 * val,size_t nbytes)712 static int imx274_read_mbreg(struct stimx274 *priv, u16 addr, u32 *val,
713 			     size_t nbytes)
714 {
715 	__le32 val_le = 0;
716 	int err;
717 
718 	err = regmap_bulk_read(priv->regmap, addr, &val_le, nbytes);
719 	if (err) {
720 		dev_err(&priv->client->dev,
721 			"%s : i2c bulk read failed, %x (%zu bytes)\n",
722 			__func__, addr, nbytes);
723 	} else {
724 		*val = le32_to_cpu(val_le);
725 		dev_dbg(&priv->client->dev,
726 			"%s : addr 0x%x, val=0x%x (%zu bytes)\n",
727 			__func__, addr, *val, nbytes);
728 	}
729 
730 	return err;
731 }
732 
733 /**
734  * imx274_write_mbreg - Write a multibyte register.
735  *
736  * Uses a bulk write where possible.
737  *
738  * @priv: Pointer to device structure
739  * @addr: Address of the LSB register.  Other registers must be
740  *        consecutive, least-to-most significant.
741  * @val: Value to be written to the register (cpu endianness)
742  * @nbytes: Number of bytes to write (range: [1..3])
743  */
imx274_write_mbreg(struct stimx274 * priv,u16 addr,u32 val,size_t nbytes)744 static int imx274_write_mbreg(struct stimx274 *priv, u16 addr, u32 val,
745 			      size_t nbytes)
746 {
747 	__le32 val_le = cpu_to_le32(val);
748 	int err;
749 
750 	err = regmap_bulk_write(priv->regmap, addr, &val_le, nbytes);
751 	if (err)
752 		dev_err(&priv->client->dev,
753 			"%s : i2c bulk write failed, %x = %x (%zu bytes)\n",
754 			__func__, addr, val, nbytes);
755 	else
756 		dev_dbg(&priv->client->dev,
757 			"%s : addr 0x%x, val=0x%x (%zu bytes)\n",
758 			__func__, addr, val, nbytes);
759 	return err;
760 }
761 
762 /*
763  * Set mode registers to start stream.
764  * @priv: Pointer to device structure
765  *
766  * Return: 0 on success, errors otherwise
767  */
imx274_mode_regs(struct stimx274 * priv)768 static int imx274_mode_regs(struct stimx274 *priv)
769 {
770 	int err = 0;
771 
772 	err = imx274_write_table(priv, imx274_start_1);
773 	if (err)
774 		return err;
775 
776 	err = imx274_write_table(priv, priv->mode->init_regs);
777 
778 	return err;
779 }
780 
781 /*
782  * imx274_start_stream - Function for starting stream per mode index
783  * @priv: Pointer to device structure
784  *
785  * Return: 0 on success, errors otherwise
786  */
imx274_start_stream(struct stimx274 * priv)787 static int imx274_start_stream(struct stimx274 *priv)
788 {
789 	int err = 0;
790 
791 	err = __v4l2_ctrl_handler_setup(&priv->ctrls.handler);
792 	if (err) {
793 		dev_err(&priv->client->dev, "Error %d setup controls\n", err);
794 		return err;
795 	}
796 
797 	/*
798 	 * Refer to "Standby Cancel Sequence when using CSI-2" in
799 	 * imx274 datasheet, it should wait 10ms or more here.
800 	 * give it 1 extra ms for margin
801 	 */
802 	msleep_range(11);
803 	err = imx274_write_table(priv, imx274_start_2);
804 	if (err)
805 		return err;
806 
807 	/*
808 	 * Refer to "Standby Cancel Sequence when using CSI-2" in
809 	 * imx274 datasheet, it should wait 7ms or more here.
810 	 * give it 1 extra ms for margin
811 	 */
812 	msleep_range(8);
813 	err = imx274_write_table(priv, imx274_start_3);
814 	if (err)
815 		return err;
816 
817 	return 0;
818 }
819 
820 /*
821  * imx274_reset - Function called to reset the sensor
822  * @priv: Pointer to device structure
823  * @rst: Input value for determining the sensor's end state after reset
824  *
825  * Set the senor in reset and then
826  * if rst = 0, keep it in reset;
827  * if rst = 1, bring it out of reset.
828  *
829  */
imx274_reset(struct stimx274 * priv,int rst)830 static void imx274_reset(struct stimx274 *priv, int rst)
831 {
832 	gpiod_set_value_cansleep(priv->reset_gpio, 0);
833 	usleep_range(IMX274_RESET_DELAY1, IMX274_RESET_DELAY2);
834 	gpiod_set_value_cansleep(priv->reset_gpio, !!rst);
835 	usleep_range(IMX274_RESET_DELAY1, IMX274_RESET_DELAY2);
836 }
837 
imx274_power_on(struct device * dev)838 static int imx274_power_on(struct device *dev)
839 {
840 	struct i2c_client *client = to_i2c_client(dev);
841 	struct v4l2_subdev *sd = i2c_get_clientdata(client);
842 	struct stimx274 *imx274 = to_imx274(sd);
843 	int ret;
844 
845 	/* keep sensor in reset before power on */
846 	imx274_reset(imx274, 0);
847 
848 	ret = clk_prepare_enable(imx274->inck);
849 	if (ret) {
850 		dev_err(&imx274->client->dev,
851 			"Failed to enable input clock: %d\n", ret);
852 		return ret;
853 	}
854 
855 	ret = regulator_bulk_enable(IMX274_NUM_SUPPLIES, imx274->supplies);
856 	if (ret) {
857 		dev_err(&imx274->client->dev,
858 			"Failed to enable regulators: %d\n", ret);
859 		goto fail_reg;
860 	}
861 
862 	udelay(2);
863 	imx274_reset(imx274, 1);
864 
865 	return 0;
866 
867 fail_reg:
868 	clk_disable_unprepare(imx274->inck);
869 	return ret;
870 }
871 
imx274_power_off(struct device * dev)872 static int imx274_power_off(struct device *dev)
873 {
874 	struct i2c_client *client = to_i2c_client(dev);
875 	struct v4l2_subdev *sd = i2c_get_clientdata(client);
876 	struct stimx274 *imx274 = to_imx274(sd);
877 
878 	imx274_reset(imx274, 0);
879 
880 	regulator_bulk_disable(IMX274_NUM_SUPPLIES, imx274->supplies);
881 
882 	clk_disable_unprepare(imx274->inck);
883 
884 	return 0;
885 }
886 
imx274_regulators_get(struct device * dev,struct stimx274 * imx274)887 static int imx274_regulators_get(struct device *dev, struct stimx274 *imx274)
888 {
889 	unsigned int i;
890 
891 	for (i = 0; i < IMX274_NUM_SUPPLIES; i++)
892 		imx274->supplies[i].supply = imx274_supply_names[i];
893 
894 	return devm_regulator_bulk_get(dev, IMX274_NUM_SUPPLIES,
895 					imx274->supplies);
896 }
897 
898 /**
899  * imx274_s_ctrl - This is used to set the imx274 V4L2 controls
900  * @ctrl: V4L2 control to be set
901  *
902  * This function is used to set the V4L2 controls for the imx274 sensor.
903  *
904  * Return: 0 on success, errors otherwise
905  */
imx274_s_ctrl(struct v4l2_ctrl * ctrl)906 static int imx274_s_ctrl(struct v4l2_ctrl *ctrl)
907 {
908 	struct v4l2_subdev *sd = ctrl_to_sd(ctrl);
909 	struct stimx274 *imx274 = to_imx274(sd);
910 	int ret = -EINVAL;
911 
912 	if (!pm_runtime_get_if_in_use(&imx274->client->dev))
913 		return 0;
914 
915 	dev_dbg(&imx274->client->dev,
916 		"%s : s_ctrl: %s, value: %d\n", __func__,
917 		ctrl->name, ctrl->val);
918 
919 	switch (ctrl->id) {
920 	case V4L2_CID_EXPOSURE:
921 		dev_dbg(&imx274->client->dev,
922 			"%s : set V4L2_CID_EXPOSURE\n", __func__);
923 		ret = imx274_set_exposure(imx274, ctrl->val);
924 		break;
925 
926 	case V4L2_CID_GAIN:
927 		dev_dbg(&imx274->client->dev,
928 			"%s : set V4L2_CID_GAIN\n", __func__);
929 		ret = imx274_set_gain(imx274, ctrl);
930 		break;
931 
932 	case V4L2_CID_VFLIP:
933 		dev_dbg(&imx274->client->dev,
934 			"%s : set V4L2_CID_VFLIP\n", __func__);
935 		ret = imx274_set_vflip(imx274, ctrl->val);
936 		break;
937 
938 	case V4L2_CID_TEST_PATTERN:
939 		dev_dbg(&imx274->client->dev,
940 			"%s : set V4L2_CID_TEST_PATTERN\n", __func__);
941 		ret = imx274_set_test_pattern(imx274, ctrl->val);
942 		break;
943 	}
944 
945 	pm_runtime_put(&imx274->client->dev);
946 
947 	return ret;
948 }
949 
imx274_binning_goodness(struct stimx274 * imx274,int w,int ask_w,int h,int ask_h,u32 flags)950 static int imx274_binning_goodness(struct stimx274 *imx274,
951 				   int w, int ask_w,
952 				   int h, int ask_h, u32 flags)
953 {
954 	struct device *dev = &imx274->client->dev;
955 	const int goodness = 100000;
956 	int val = 0;
957 
958 	if (flags & V4L2_SEL_FLAG_GE) {
959 		if (w < ask_w)
960 			val -= goodness;
961 		if (h < ask_h)
962 			val -= goodness;
963 	}
964 
965 	if (flags & V4L2_SEL_FLAG_LE) {
966 		if (w > ask_w)
967 			val -= goodness;
968 		if (h > ask_h)
969 			val -= goodness;
970 	}
971 
972 	val -= abs(w - ask_w);
973 	val -= abs(h - ask_h);
974 
975 	dev_dbg(dev, "%s: ask %dx%d, size %dx%d, goodness %d\n",
976 		__func__, ask_w, ask_h, w, h, val);
977 
978 	return val;
979 }
980 
981 /**
982  * __imx274_change_compose - Helper function to change binning and set both
983  *	compose and format.
984  *
985  * We have two entry points to change binning: set_fmt and
986  * set_selection(COMPOSE). Both have to compute the new output size
987  * and set it in both the compose rect and the frame format size. We
988  * also need to do the same things after setting cropping to restore
989  * 1:1 binning.
990  *
991  * This function contains the common code for these three cases, it
992  * has many arguments in order to accommodate the needs of all of
993  * them.
994  *
995  * Must be called with imx274->lock locked.
996  *
997  * @imx274: The device object
998  * @sd_state: The subdev state we are editing for TRY requests
999  * @which:  V4L2_SUBDEV_FORMAT_ACTIVE or V4L2_SUBDEV_FORMAT_TRY from the caller
1000  * @width:  Input-output parameter: set to the desired width before
1001  *          the call, contains the chosen value after returning successfully
1002  * @height: Input-output parameter for height (see @width)
1003  * @flags:  Selection flags from struct v4l2_subdev_selection, or 0 if not
1004  *          available (when called from set_fmt)
1005  */
__imx274_change_compose(struct stimx274 * imx274,struct v4l2_subdev_state * sd_state,u32 which,u32 * width,u32 * height,u32 flags)1006 static int __imx274_change_compose(struct stimx274 *imx274,
1007 				   struct v4l2_subdev_state *sd_state,
1008 				   u32 which,
1009 				   u32 *width,
1010 				   u32 *height,
1011 				   u32 flags)
1012 {
1013 	struct device *dev = &imx274->client->dev;
1014 	const struct v4l2_rect *cur_crop;
1015 	struct v4l2_mbus_framefmt *tgt_fmt;
1016 	unsigned int i;
1017 	const struct imx274_mode *best_mode = &imx274_modes[0];
1018 	int best_goodness = INT_MIN;
1019 
1020 	if (which == V4L2_SUBDEV_FORMAT_TRY) {
1021 		cur_crop = &sd_state->pads->try_crop;
1022 		tgt_fmt = &sd_state->pads->try_fmt;
1023 	} else {
1024 		cur_crop = &imx274->crop;
1025 		tgt_fmt = &imx274->format;
1026 	}
1027 
1028 	for (i = 0; i < ARRAY_SIZE(imx274_modes); i++) {
1029 		u8 wratio = imx274_modes[i].wbin_ratio;
1030 		u8 hratio = imx274_modes[i].hbin_ratio;
1031 
1032 		int goodness = imx274_binning_goodness(
1033 			imx274,
1034 			cur_crop->width / wratio, *width,
1035 			cur_crop->height / hratio, *height,
1036 			flags);
1037 
1038 		if (goodness >= best_goodness) {
1039 			best_goodness = goodness;
1040 			best_mode = &imx274_modes[i];
1041 		}
1042 	}
1043 
1044 	*width = cur_crop->width / best_mode->wbin_ratio;
1045 	*height = cur_crop->height / best_mode->hbin_ratio;
1046 
1047 	if (which == V4L2_SUBDEV_FORMAT_ACTIVE)
1048 		imx274->mode = best_mode;
1049 
1050 	dev_dbg(dev, "%s: selected %ux%u binning\n",
1051 		__func__, best_mode->wbin_ratio, best_mode->hbin_ratio);
1052 
1053 	tgt_fmt->width = *width;
1054 	tgt_fmt->height = *height;
1055 	tgt_fmt->field = V4L2_FIELD_NONE;
1056 
1057 	return 0;
1058 }
1059 
1060 /**
1061  * imx274_get_fmt - Get the pad format
1062  * @sd: Pointer to V4L2 Sub device structure
1063  * @sd_state: Pointer to sub device state structure
1064  * @fmt: Pointer to pad level media bus format
1065  *
1066  * This function is used to get the pad format information.
1067  *
1068  * Return: 0 on success
1069  */
imx274_get_fmt(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_format * fmt)1070 static int imx274_get_fmt(struct v4l2_subdev *sd,
1071 			  struct v4l2_subdev_state *sd_state,
1072 			  struct v4l2_subdev_format *fmt)
1073 {
1074 	struct stimx274 *imx274 = to_imx274(sd);
1075 
1076 	mutex_lock(&imx274->lock);
1077 	fmt->format = imx274->format;
1078 	mutex_unlock(&imx274->lock);
1079 	return 0;
1080 }
1081 
1082 /**
1083  * imx274_set_fmt - This is used to set the pad format
1084  * @sd: Pointer to V4L2 Sub device structure
1085  * @sd_state: Pointer to sub device state information structure
1086  * @format: Pointer to pad level media bus format
1087  *
1088  * This function is used to set the pad format.
1089  *
1090  * Return: 0 on success
1091  */
imx274_set_fmt(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_format * format)1092 static int imx274_set_fmt(struct v4l2_subdev *sd,
1093 			  struct v4l2_subdev_state *sd_state,
1094 			  struct v4l2_subdev_format *format)
1095 {
1096 	struct v4l2_mbus_framefmt *fmt = &format->format;
1097 	struct stimx274 *imx274 = to_imx274(sd);
1098 	int err = 0;
1099 
1100 	mutex_lock(&imx274->lock);
1101 
1102 	err = __imx274_change_compose(imx274, sd_state, format->which,
1103 				      &fmt->width, &fmt->height, 0);
1104 
1105 	if (err)
1106 		goto out;
1107 
1108 	/*
1109 	 * __imx274_change_compose already set width and height in the
1110 	 * applicable format, but we need to keep all other format
1111 	 * values, so do a full copy here
1112 	 */
1113 	fmt->field = V4L2_FIELD_NONE;
1114 	if (format->which == V4L2_SUBDEV_FORMAT_TRY)
1115 		sd_state->pads->try_fmt = *fmt;
1116 	else
1117 		imx274->format = *fmt;
1118 
1119 out:
1120 	mutex_unlock(&imx274->lock);
1121 
1122 	return err;
1123 }
1124 
imx274_get_selection(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_selection * sel)1125 static int imx274_get_selection(struct v4l2_subdev *sd,
1126 				struct v4l2_subdev_state *sd_state,
1127 				struct v4l2_subdev_selection *sel)
1128 {
1129 	struct stimx274 *imx274 = to_imx274(sd);
1130 	const struct v4l2_rect *src_crop;
1131 	const struct v4l2_mbus_framefmt *src_fmt;
1132 	int ret = 0;
1133 
1134 	if (sel->pad != 0)
1135 		return -EINVAL;
1136 
1137 	if (sel->target == V4L2_SEL_TGT_CROP_BOUNDS) {
1138 		sel->r.left = 0;
1139 		sel->r.top = 0;
1140 		sel->r.width = IMX274_MAX_WIDTH;
1141 		sel->r.height = IMX274_MAX_HEIGHT;
1142 		return 0;
1143 	}
1144 
1145 	if (sel->which == V4L2_SUBDEV_FORMAT_TRY) {
1146 		src_crop = &sd_state->pads->try_crop;
1147 		src_fmt = &sd_state->pads->try_fmt;
1148 	} else {
1149 		src_crop = &imx274->crop;
1150 		src_fmt = &imx274->format;
1151 	}
1152 
1153 	mutex_lock(&imx274->lock);
1154 
1155 	switch (sel->target) {
1156 	case V4L2_SEL_TGT_CROP:
1157 		sel->r = *src_crop;
1158 		break;
1159 	case V4L2_SEL_TGT_COMPOSE_BOUNDS:
1160 		sel->r.top = 0;
1161 		sel->r.left = 0;
1162 		sel->r.width = src_crop->width;
1163 		sel->r.height = src_crop->height;
1164 		break;
1165 	case V4L2_SEL_TGT_COMPOSE:
1166 		sel->r.top = 0;
1167 		sel->r.left = 0;
1168 		sel->r.width = src_fmt->width;
1169 		sel->r.height = src_fmt->height;
1170 		break;
1171 	default:
1172 		ret = -EINVAL;
1173 	}
1174 
1175 	mutex_unlock(&imx274->lock);
1176 
1177 	return ret;
1178 }
1179 
imx274_set_selection_crop(struct stimx274 * imx274,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_selection * sel)1180 static int imx274_set_selection_crop(struct stimx274 *imx274,
1181 				     struct v4l2_subdev_state *sd_state,
1182 				     struct v4l2_subdev_selection *sel)
1183 {
1184 	struct v4l2_rect *tgt_crop;
1185 	struct v4l2_rect new_crop;
1186 	bool size_changed;
1187 
1188 	/*
1189 	 * h_step could be 12 or 24 depending on the binning. But we
1190 	 * won't know the binning until we choose the mode later in
1191 	 * __imx274_change_compose(). Thus let's be safe and use the
1192 	 * most conservative value in all cases.
1193 	 */
1194 	const u32 h_step = 24;
1195 
1196 	new_crop.width = min_t(u32,
1197 			       IMX274_ROUND(sel->r.width, h_step, sel->flags),
1198 			       IMX274_MAX_WIDTH);
1199 
1200 	/* Constraint: HTRIMMING_END - HTRIMMING_START >= 144 */
1201 	if (new_crop.width < 144)
1202 		new_crop.width = 144;
1203 
1204 	new_crop.left = min_t(u32,
1205 			      IMX274_ROUND(sel->r.left, h_step, 0),
1206 			      IMX274_MAX_WIDTH - new_crop.width);
1207 
1208 	new_crop.height = min_t(u32,
1209 				IMX274_ROUND(sel->r.height, 2, sel->flags),
1210 				IMX274_MAX_HEIGHT);
1211 
1212 	new_crop.top = min_t(u32, IMX274_ROUND(sel->r.top, 2, 0),
1213 			     IMX274_MAX_HEIGHT - new_crop.height);
1214 
1215 	sel->r = new_crop;
1216 
1217 	if (sel->which == V4L2_SUBDEV_FORMAT_TRY)
1218 		tgt_crop = &sd_state->pads->try_crop;
1219 	else
1220 		tgt_crop = &imx274->crop;
1221 
1222 	mutex_lock(&imx274->lock);
1223 
1224 	size_changed = (new_crop.width != tgt_crop->width ||
1225 			new_crop.height != tgt_crop->height);
1226 
1227 	/* __imx274_change_compose needs the new size in *tgt_crop */
1228 	*tgt_crop = new_crop;
1229 
1230 	/* if crop size changed then reset the output image size */
1231 	if (size_changed)
1232 		__imx274_change_compose(imx274, sd_state, sel->which,
1233 					&new_crop.width, &new_crop.height,
1234 					sel->flags);
1235 
1236 	mutex_unlock(&imx274->lock);
1237 
1238 	return 0;
1239 }
1240 
imx274_set_selection(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_selection * sel)1241 static int imx274_set_selection(struct v4l2_subdev *sd,
1242 				struct v4l2_subdev_state *sd_state,
1243 				struct v4l2_subdev_selection *sel)
1244 {
1245 	struct stimx274 *imx274 = to_imx274(sd);
1246 
1247 	if (sel->pad != 0)
1248 		return -EINVAL;
1249 
1250 	if (sel->target == V4L2_SEL_TGT_CROP)
1251 		return imx274_set_selection_crop(imx274, sd_state, sel);
1252 
1253 	if (sel->target == V4L2_SEL_TGT_COMPOSE) {
1254 		int err;
1255 
1256 		mutex_lock(&imx274->lock);
1257 		err =  __imx274_change_compose(imx274, sd_state, sel->which,
1258 					       &sel->r.width, &sel->r.height,
1259 					       sel->flags);
1260 		mutex_unlock(&imx274->lock);
1261 
1262 		/*
1263 		 * __imx274_change_compose already set width and
1264 		 * height in set->r, we still need to set top-left
1265 		 */
1266 		if (!err) {
1267 			sel->r.top = 0;
1268 			sel->r.left = 0;
1269 		}
1270 
1271 		return err;
1272 	}
1273 
1274 	return -EINVAL;
1275 }
1276 
imx274_apply_trimming(struct stimx274 * imx274)1277 static int imx274_apply_trimming(struct stimx274 *imx274)
1278 {
1279 	u32 h_start;
1280 	u32 h_end;
1281 	u32 hmax;
1282 	u32 v_cut;
1283 	s32 v_pos;
1284 	u32 write_v_size;
1285 	u32 y_out_size;
1286 	int err;
1287 
1288 	h_start = imx274->crop.left + 12;
1289 	h_end = h_start + imx274->crop.width;
1290 
1291 	/* Use the minimum allowed value of HMAX */
1292 	/* Note: except in mode 1, (width / 16 + 23) is always < hmax_min */
1293 	/* Note: 260 is the minimum HMAX in all implemented modes */
1294 	hmax = max_t(u32, 260, (imx274->crop.width) / 16 + 23);
1295 
1296 	/* invert v_pos if VFLIP */
1297 	v_pos = imx274->ctrls.vflip->cur.val ?
1298 		(-imx274->crop.top / 2) : (imx274->crop.top / 2);
1299 	v_cut = (IMX274_MAX_HEIGHT - imx274->crop.height) / 2;
1300 	write_v_size = imx274->crop.height + 22;
1301 	y_out_size   = imx274->crop.height;
1302 
1303 	err = imx274_write_mbreg(imx274, IMX274_HMAX_REG_LSB, hmax, 2);
1304 	if (!err)
1305 		err = imx274_write_mbreg(imx274, IMX274_HTRIM_EN_REG, 1, 1);
1306 	if (!err)
1307 		err = imx274_write_mbreg(imx274, IMX274_HTRIM_START_REG_LSB,
1308 					 h_start, 2);
1309 	if (!err)
1310 		err = imx274_write_mbreg(imx274, IMX274_HTRIM_END_REG_LSB,
1311 					 h_end, 2);
1312 	if (!err)
1313 		err = imx274_write_mbreg(imx274, IMX274_VWIDCUTEN_REG, 1, 1);
1314 	if (!err)
1315 		err = imx274_write_mbreg(imx274, IMX274_VWIDCUT_REG_LSB,
1316 					 v_cut, 2);
1317 	if (!err)
1318 		err = imx274_write_mbreg(imx274, IMX274_VWINPOS_REG_LSB,
1319 					 v_pos, 2);
1320 	if (!err)
1321 		err = imx274_write_mbreg(imx274, IMX274_WRITE_VSIZE_REG_LSB,
1322 					 write_v_size, 2);
1323 	if (!err)
1324 		err = imx274_write_mbreg(imx274, IMX274_Y_OUT_SIZE_REG_LSB,
1325 					 y_out_size, 2);
1326 
1327 	return err;
1328 }
1329 
1330 /**
1331  * imx274_g_frame_interval - Get the frame interval
1332  * @sd: Pointer to V4L2 Sub device structure
1333  * @fi: Pointer to V4l2 Sub device frame interval structure
1334  *
1335  * This function is used to get the frame interval.
1336  *
1337  * Return: 0 on success
1338  */
imx274_g_frame_interval(struct v4l2_subdev * sd,struct v4l2_subdev_frame_interval * fi)1339 static int imx274_g_frame_interval(struct v4l2_subdev *sd,
1340 				   struct v4l2_subdev_frame_interval *fi)
1341 {
1342 	struct stimx274 *imx274 = to_imx274(sd);
1343 
1344 	fi->interval = imx274->frame_interval;
1345 	dev_dbg(&imx274->client->dev, "%s frame rate = %d / %d\n",
1346 		__func__, imx274->frame_interval.numerator,
1347 		imx274->frame_interval.denominator);
1348 
1349 	return 0;
1350 }
1351 
1352 /**
1353  * imx274_s_frame_interval - Set the frame interval
1354  * @sd: Pointer to V4L2 Sub device structure
1355  * @fi: Pointer to V4l2 Sub device frame interval structure
1356  *
1357  * This function is used to set the frame intervavl.
1358  *
1359  * Return: 0 on success
1360  */
imx274_s_frame_interval(struct v4l2_subdev * sd,struct v4l2_subdev_frame_interval * fi)1361 static int imx274_s_frame_interval(struct v4l2_subdev *sd,
1362 				   struct v4l2_subdev_frame_interval *fi)
1363 {
1364 	struct stimx274 *imx274 = to_imx274(sd);
1365 	struct v4l2_ctrl *ctrl = imx274->ctrls.exposure;
1366 	int min, max, def;
1367 	int ret;
1368 
1369 	ret = pm_runtime_resume_and_get(&imx274->client->dev);
1370 	if (ret < 0)
1371 		return ret;
1372 
1373 	mutex_lock(&imx274->lock);
1374 	ret = imx274_set_frame_interval(imx274, fi->interval);
1375 
1376 	if (!ret) {
1377 		fi->interval = imx274->frame_interval;
1378 
1379 		/*
1380 		 * exposure time range is decided by frame interval
1381 		 * need to update it after frame interval changes
1382 		 */
1383 		min = IMX274_MIN_EXPOSURE_TIME;
1384 		max = fi->interval.numerator * 1000000
1385 			/ fi->interval.denominator;
1386 		def = max;
1387 		ret = __v4l2_ctrl_modify_range(ctrl, min, max, 1, def);
1388 		if (ret) {
1389 			dev_err(&imx274->client->dev,
1390 				"Exposure ctrl range update failed\n");
1391 			goto unlock;
1392 		}
1393 
1394 		/* update exposure time accordingly */
1395 		imx274_set_exposure(imx274, ctrl->val);
1396 
1397 		dev_dbg(&imx274->client->dev, "set frame interval to %uus\n",
1398 			fi->interval.numerator * 1000000
1399 			/ fi->interval.denominator);
1400 	}
1401 
1402 unlock:
1403 	mutex_unlock(&imx274->lock);
1404 	pm_runtime_put(&imx274->client->dev);
1405 
1406 	return ret;
1407 }
1408 
1409 /**
1410  * imx274_load_default - load default control values
1411  * @priv: Pointer to device structure
1412  *
1413  * Return: 0 on success, errors otherwise
1414  */
imx274_load_default(struct stimx274 * priv)1415 static void imx274_load_default(struct stimx274 *priv)
1416 {
1417 	/* load default control values */
1418 	priv->frame_interval.numerator = 1;
1419 	priv->frame_interval.denominator = IMX274_DEF_FRAME_RATE;
1420 	priv->ctrls.exposure->val = 1000000 / IMX274_DEF_FRAME_RATE;
1421 	priv->ctrls.gain->val = IMX274_DEF_GAIN;
1422 	priv->ctrls.vflip->val = 0;
1423 	priv->ctrls.test_pattern->val = TEST_PATTERN_DISABLED;
1424 }
1425 
1426 /**
1427  * imx274_s_stream - It is used to start/stop the streaming.
1428  * @sd: V4L2 Sub device
1429  * @on: Flag (True / False)
1430  *
1431  * This function controls the start or stop of streaming for the
1432  * imx274 sensor.
1433  *
1434  * Return: 0 on success, errors otherwise
1435  */
imx274_s_stream(struct v4l2_subdev * sd,int on)1436 static int imx274_s_stream(struct v4l2_subdev *sd, int on)
1437 {
1438 	struct stimx274 *imx274 = to_imx274(sd);
1439 	int ret = 0;
1440 
1441 	dev_dbg(&imx274->client->dev, "%s : %s, mode index = %td\n", __func__,
1442 		on ? "Stream Start" : "Stream Stop",
1443 		imx274->mode - &imx274_modes[0]);
1444 
1445 	mutex_lock(&imx274->lock);
1446 
1447 	if (on) {
1448 		ret = pm_runtime_resume_and_get(&imx274->client->dev);
1449 		if (ret < 0) {
1450 			mutex_unlock(&imx274->lock);
1451 			return ret;
1452 		}
1453 
1454 		/* load mode registers */
1455 		ret = imx274_mode_regs(imx274);
1456 		if (ret)
1457 			goto fail;
1458 
1459 		ret = imx274_apply_trimming(imx274);
1460 		if (ret)
1461 			goto fail;
1462 
1463 		/*
1464 		 * update frame rate & exposure. if the last mode is different,
1465 		 * HMAX could be changed. As the result, frame rate & exposure
1466 		 * are changed.
1467 		 * gain is not affected.
1468 		 */
1469 		ret = imx274_set_frame_interval(imx274,
1470 						imx274->frame_interval);
1471 		if (ret)
1472 			goto fail;
1473 
1474 		/* start stream */
1475 		ret = imx274_start_stream(imx274);
1476 		if (ret)
1477 			goto fail;
1478 	} else {
1479 		/* stop stream */
1480 		ret = imx274_write_table(imx274, imx274_stop);
1481 		if (ret)
1482 			goto fail;
1483 
1484 		pm_runtime_put(&imx274->client->dev);
1485 	}
1486 
1487 	mutex_unlock(&imx274->lock);
1488 	dev_dbg(&imx274->client->dev, "%s : Done\n", __func__);
1489 	return 0;
1490 
1491 fail:
1492 	pm_runtime_put(&imx274->client->dev);
1493 	mutex_unlock(&imx274->lock);
1494 	dev_err(&imx274->client->dev, "s_stream failed\n");
1495 	return ret;
1496 }
1497 
1498 /*
1499  * imx274_get_frame_length - Function for obtaining current frame length
1500  * @priv: Pointer to device structure
1501  * @val: Pointer to obtained value
1502  *
1503  * frame_length = vmax x (svr + 1), in unit of hmax.
1504  *
1505  * Return: 0 on success
1506  */
imx274_get_frame_length(struct stimx274 * priv,u32 * val)1507 static int imx274_get_frame_length(struct stimx274 *priv, u32 *val)
1508 {
1509 	int err;
1510 	u32 svr;
1511 	u32 vmax;
1512 
1513 	err = imx274_read_mbreg(priv, IMX274_SVR_REG_LSB, &svr, 2);
1514 	if (err)
1515 		goto fail;
1516 
1517 	err = imx274_read_mbreg(priv, IMX274_VMAX_REG_3, &vmax, 3);
1518 	if (err)
1519 		goto fail;
1520 
1521 	*val = vmax * (svr + 1);
1522 
1523 	return 0;
1524 
1525 fail:
1526 	dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1527 	return err;
1528 }
1529 
imx274_clamp_coarse_time(struct stimx274 * priv,u32 * val,u32 * frame_length)1530 static int imx274_clamp_coarse_time(struct stimx274 *priv, u32 *val,
1531 				    u32 *frame_length)
1532 {
1533 	int err;
1534 
1535 	err = imx274_get_frame_length(priv, frame_length);
1536 	if (err)
1537 		return err;
1538 
1539 	if (*frame_length < priv->mode->min_frame_len)
1540 		*frame_length =  priv->mode->min_frame_len;
1541 
1542 	*val = *frame_length - *val; /* convert to raw shr */
1543 	if (*val > *frame_length - IMX274_SHR_LIMIT_CONST)
1544 		*val = *frame_length - IMX274_SHR_LIMIT_CONST;
1545 	else if (*val < priv->mode->min_SHR)
1546 		*val = priv->mode->min_SHR;
1547 
1548 	return 0;
1549 }
1550 
1551 /*
1552  * imx274_set_digital gain - Function called when setting digital gain
1553  * @priv: Pointer to device structure
1554  * @dgain: Value of digital gain.
1555  *
1556  * Digital gain has only 4 steps: 1x, 2x, 4x, and 8x
1557  *
1558  * Return: 0 on success
1559  */
imx274_set_digital_gain(struct stimx274 * priv,u32 dgain)1560 static int imx274_set_digital_gain(struct stimx274 *priv, u32 dgain)
1561 {
1562 	u8 reg_val;
1563 
1564 	reg_val = ffs(dgain);
1565 
1566 	if (reg_val)
1567 		reg_val--;
1568 
1569 	reg_val = clamp(reg_val, (u8)0, (u8)3);
1570 
1571 	return imx274_write_reg(priv, IMX274_DIGITAL_GAIN_REG,
1572 				reg_val & IMX274_MASK_LSB_4_BITS);
1573 }
1574 
1575 /*
1576  * imx274_set_gain - Function called when setting gain
1577  * @priv: Pointer to device structure
1578  * @val: Value of gain. the real value = val << IMX274_GAIN_SHIFT;
1579  * @ctrl: v4l2 control pointer
1580  *
1581  * Set the gain based on input value.
1582  * The caller should hold the mutex lock imx274->lock if necessary
1583  *
1584  * Return: 0 on success
1585  */
imx274_set_gain(struct stimx274 * priv,struct v4l2_ctrl * ctrl)1586 static int imx274_set_gain(struct stimx274 *priv, struct v4l2_ctrl *ctrl)
1587 {
1588 	int err;
1589 	u32 gain, analog_gain, digital_gain, gain_reg;
1590 
1591 	gain = (u32)(ctrl->val);
1592 
1593 	dev_dbg(&priv->client->dev,
1594 		"%s : input gain = %d.%d\n", __func__,
1595 		gain >> IMX274_GAIN_SHIFT,
1596 		((gain & IMX274_GAIN_SHIFT_MASK) * 100) >> IMX274_GAIN_SHIFT);
1597 
1598 	if (gain > IMX274_MAX_DIGITAL_GAIN * IMX274_MAX_ANALOG_GAIN)
1599 		gain = IMX274_MAX_DIGITAL_GAIN * IMX274_MAX_ANALOG_GAIN;
1600 	else if (gain < IMX274_MIN_GAIN)
1601 		gain = IMX274_MIN_GAIN;
1602 
1603 	if (gain <= IMX274_MAX_ANALOG_GAIN)
1604 		digital_gain = 1;
1605 	else if (gain <= IMX274_MAX_ANALOG_GAIN * 2)
1606 		digital_gain = 2;
1607 	else if (gain <= IMX274_MAX_ANALOG_GAIN * 4)
1608 		digital_gain = 4;
1609 	else
1610 		digital_gain = IMX274_MAX_DIGITAL_GAIN;
1611 
1612 	analog_gain = gain / digital_gain;
1613 
1614 	dev_dbg(&priv->client->dev,
1615 		"%s : digital gain = %d, analog gain = %d.%d\n",
1616 		__func__, digital_gain, analog_gain >> IMX274_GAIN_SHIFT,
1617 		((analog_gain & IMX274_GAIN_SHIFT_MASK) * 100)
1618 		>> IMX274_GAIN_SHIFT);
1619 
1620 	err = imx274_set_digital_gain(priv, digital_gain);
1621 	if (err)
1622 		goto fail;
1623 
1624 	/* convert to register value, refer to imx274 datasheet */
1625 	gain_reg = (u32)IMX274_GAIN_CONST -
1626 		(IMX274_GAIN_CONST << IMX274_GAIN_SHIFT) / analog_gain;
1627 	if (gain_reg > IMX274_GAIN_REG_MAX)
1628 		gain_reg = IMX274_GAIN_REG_MAX;
1629 
1630 	err = imx274_write_mbreg(priv, IMX274_ANALOG_GAIN_ADDR_LSB, gain_reg,
1631 				 2);
1632 	if (err)
1633 		goto fail;
1634 
1635 	if (IMX274_GAIN_CONST - gain_reg == 0) {
1636 		err = -EINVAL;
1637 		goto fail;
1638 	}
1639 
1640 	/* convert register value back to gain value */
1641 	ctrl->val = (IMX274_GAIN_CONST << IMX274_GAIN_SHIFT)
1642 			/ (IMX274_GAIN_CONST - gain_reg) * digital_gain;
1643 
1644 	dev_dbg(&priv->client->dev,
1645 		"%s : GAIN control success, gain_reg = %d, new gain = %d\n",
1646 		__func__, gain_reg, ctrl->val);
1647 
1648 	return 0;
1649 
1650 fail:
1651 	dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1652 	return err;
1653 }
1654 
1655 /*
1656  * imx274_set_coarse_time - Function called when setting SHR value
1657  * @priv: Pointer to device structure
1658  * @val: Value for exposure time in number of line_length, or [HMAX]
1659  *
1660  * Set SHR value based on input value.
1661  *
1662  * Return: 0 on success
1663  */
imx274_set_coarse_time(struct stimx274 * priv,u32 * val)1664 static int imx274_set_coarse_time(struct stimx274 *priv, u32 *val)
1665 {
1666 	int err;
1667 	u32 coarse_time, frame_length;
1668 
1669 	coarse_time = *val;
1670 
1671 	/* convert exposure_time to appropriate SHR value */
1672 	err = imx274_clamp_coarse_time(priv, &coarse_time, &frame_length);
1673 	if (err)
1674 		goto fail;
1675 
1676 	err = imx274_write_mbreg(priv, IMX274_SHR_REG_LSB, coarse_time, 2);
1677 	if (err)
1678 		goto fail;
1679 
1680 	*val = frame_length - coarse_time;
1681 	return 0;
1682 
1683 fail:
1684 	dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1685 	return err;
1686 }
1687 
1688 /*
1689  * imx274_set_exposure - Function called when setting exposure time
1690  * @priv: Pointer to device structure
1691  * @val: Variable for exposure time, in the unit of micro-second
1692  *
1693  * Set exposure time based on input value.
1694  * The caller should hold the mutex lock imx274->lock if necessary
1695  *
1696  * Return: 0 on success
1697  */
imx274_set_exposure(struct stimx274 * priv,int val)1698 static int imx274_set_exposure(struct stimx274 *priv, int val)
1699 {
1700 	int err;
1701 	u32 hmax;
1702 	u32 coarse_time; /* exposure time in unit of line (HMAX)*/
1703 
1704 	dev_dbg(&priv->client->dev,
1705 		"%s : EXPOSURE control input = %d\n", __func__, val);
1706 
1707 	/* step 1: convert input exposure_time (val) into number of 1[HMAX] */
1708 
1709 	err = imx274_read_mbreg(priv, IMX274_HMAX_REG_LSB, &hmax, 2);
1710 	if (err)
1711 		goto fail;
1712 
1713 	if (hmax == 0) {
1714 		err = -EINVAL;
1715 		goto fail;
1716 	}
1717 
1718 	coarse_time = (IMX274_PIXCLK_CONST1 / IMX274_PIXCLK_CONST2 * val
1719 			- priv->mode->nocpiop) / hmax;
1720 
1721 	/* step 2: convert exposure_time into SHR value */
1722 
1723 	/* set SHR */
1724 	err = imx274_set_coarse_time(priv, &coarse_time);
1725 	if (err)
1726 		goto fail;
1727 
1728 	priv->ctrls.exposure->val =
1729 			(coarse_time * hmax + priv->mode->nocpiop)
1730 			/ (IMX274_PIXCLK_CONST1 / IMX274_PIXCLK_CONST2);
1731 
1732 	dev_dbg(&priv->client->dev,
1733 		"%s : EXPOSURE control success\n", __func__);
1734 	return 0;
1735 
1736 fail:
1737 	dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1738 
1739 	return err;
1740 }
1741 
1742 /*
1743  * imx274_set_vflip - Function called when setting vertical flip
1744  * @priv: Pointer to device structure
1745  * @val: Value for vflip setting
1746  *
1747  * Set vertical flip based on input value.
1748  * val = 0: normal, no vertical flip
1749  * val = 1: vertical flip enabled
1750  * The caller should hold the mutex lock imx274->lock if necessary
1751  *
1752  * Return: 0 on success
1753  */
imx274_set_vflip(struct stimx274 * priv,int val)1754 static int imx274_set_vflip(struct stimx274 *priv, int val)
1755 {
1756 	int err;
1757 
1758 	err = imx274_write_reg(priv, IMX274_VFLIP_REG, val);
1759 	if (err) {
1760 		dev_err(&priv->client->dev, "VFLIP control error\n");
1761 		return err;
1762 	}
1763 
1764 	dev_dbg(&priv->client->dev,
1765 		"%s : VFLIP control success\n", __func__);
1766 
1767 	return 0;
1768 }
1769 
1770 /*
1771  * imx274_set_test_pattern - Function called when setting test pattern
1772  * @priv: Pointer to device structure
1773  * @val: Variable for test pattern
1774  *
1775  * Set to different test patterns based on input value.
1776  *
1777  * Return: 0 on success
1778  */
imx274_set_test_pattern(struct stimx274 * priv,int val)1779 static int imx274_set_test_pattern(struct stimx274 *priv, int val)
1780 {
1781 	int err = 0;
1782 
1783 	if (val == TEST_PATTERN_DISABLED) {
1784 		err = imx274_write_table(priv, imx274_tp_disabled);
1785 	} else if (val <= TEST_PATTERN_V_COLOR_BARS) {
1786 		err = imx274_write_reg(priv, IMX274_TEST_PATTERN_REG, val - 1);
1787 		if (!err)
1788 			err = imx274_write_table(priv, imx274_tp_regs);
1789 	} else {
1790 		err = -EINVAL;
1791 	}
1792 
1793 	if (!err)
1794 		dev_dbg(&priv->client->dev,
1795 			"%s : TEST PATTERN control success\n", __func__);
1796 	else
1797 		dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1798 
1799 	return err;
1800 }
1801 
1802 /*
1803  * imx274_set_frame_length - Function called when setting frame length
1804  * @priv: Pointer to device structure
1805  * @val: Variable for frame length (= VMAX, i.e. vertical drive period length)
1806  *
1807  * Set frame length based on input value.
1808  *
1809  * Return: 0 on success
1810  */
imx274_set_frame_length(struct stimx274 * priv,u32 val)1811 static int imx274_set_frame_length(struct stimx274 *priv, u32 val)
1812 {
1813 	int err;
1814 	u32 frame_length;
1815 
1816 	dev_dbg(&priv->client->dev, "%s : input length = %d\n",
1817 		__func__, val);
1818 
1819 	frame_length = (u32)val;
1820 
1821 	err = imx274_write_mbreg(priv, IMX274_VMAX_REG_3, frame_length, 3);
1822 	if (err)
1823 		goto fail;
1824 
1825 	return 0;
1826 
1827 fail:
1828 	dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1829 	return err;
1830 }
1831 
1832 /*
1833  * imx274_set_frame_interval - Function called when setting frame interval
1834  * @priv: Pointer to device structure
1835  * @frame_interval: Variable for frame interval
1836  *
1837  * Change frame interval by updating VMAX value
1838  * The caller should hold the mutex lock imx274->lock if necessary
1839  *
1840  * Return: 0 on success
1841  */
imx274_set_frame_interval(struct stimx274 * priv,struct v4l2_fract frame_interval)1842 static int imx274_set_frame_interval(struct stimx274 *priv,
1843 				     struct v4l2_fract frame_interval)
1844 {
1845 	int err;
1846 	u32 frame_length, req_frame_rate;
1847 	u32 svr;
1848 	u32 hmax;
1849 
1850 	dev_dbg(&priv->client->dev, "%s: input frame interval = %d / %d",
1851 		__func__, frame_interval.numerator,
1852 		frame_interval.denominator);
1853 
1854 	if (frame_interval.numerator == 0 || frame_interval.denominator == 0) {
1855 		frame_interval.denominator = IMX274_DEF_FRAME_RATE;
1856 		frame_interval.numerator = 1;
1857 	}
1858 
1859 	req_frame_rate = (u32)(frame_interval.denominator
1860 				/ frame_interval.numerator);
1861 
1862 	/* boundary check */
1863 	if (req_frame_rate > priv->mode->max_fps) {
1864 		frame_interval.numerator = 1;
1865 		frame_interval.denominator = priv->mode->max_fps;
1866 	} else if (req_frame_rate < IMX274_MIN_FRAME_RATE) {
1867 		frame_interval.numerator = 1;
1868 		frame_interval.denominator = IMX274_MIN_FRAME_RATE;
1869 	}
1870 
1871 	/*
1872 	 * VMAX = 1/frame_rate x 72M / (SVR+1) / HMAX
1873 	 * frame_length (i.e. VMAX) = (frame_interval) x 72M /(SVR+1) / HMAX
1874 	 */
1875 
1876 	err = imx274_read_mbreg(priv, IMX274_SVR_REG_LSB, &svr, 2);
1877 	if (err)
1878 		goto fail;
1879 
1880 	dev_dbg(&priv->client->dev,
1881 		"%s : register SVR = %d\n", __func__, svr);
1882 
1883 	err = imx274_read_mbreg(priv, IMX274_HMAX_REG_LSB, &hmax, 2);
1884 	if (err)
1885 		goto fail;
1886 
1887 	dev_dbg(&priv->client->dev,
1888 		"%s : register HMAX = %d\n", __func__, hmax);
1889 
1890 	if (hmax == 0 || frame_interval.denominator == 0) {
1891 		err = -EINVAL;
1892 		goto fail;
1893 	}
1894 
1895 	frame_length = IMX274_PIXCLK_CONST1 / (svr + 1) / hmax
1896 					* frame_interval.numerator
1897 					/ frame_interval.denominator;
1898 
1899 	err = imx274_set_frame_length(priv, frame_length);
1900 	if (err)
1901 		goto fail;
1902 
1903 	priv->frame_interval = frame_interval;
1904 	return 0;
1905 
1906 fail:
1907 	dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1908 	return err;
1909 }
1910 
imx274_enum_mbus_code(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_mbus_code_enum * code)1911 static int imx274_enum_mbus_code(struct v4l2_subdev *sd,
1912 				 struct v4l2_subdev_state *sd_state,
1913 				 struct v4l2_subdev_mbus_code_enum *code)
1914 {
1915 	if (code->index > 0)
1916 		return -EINVAL;
1917 
1918 	/* only supported format in the driver is Raw 10 bits SRGGB */
1919 	code->code = MEDIA_BUS_FMT_SRGGB10_1X10;
1920 
1921 	return 0;
1922 }
1923 
1924 static const struct v4l2_subdev_pad_ops imx274_pad_ops = {
1925 	.enum_mbus_code = imx274_enum_mbus_code,
1926 	.get_fmt = imx274_get_fmt,
1927 	.set_fmt = imx274_set_fmt,
1928 	.get_selection = imx274_get_selection,
1929 	.set_selection = imx274_set_selection,
1930 };
1931 
1932 static const struct v4l2_subdev_video_ops imx274_video_ops = {
1933 	.g_frame_interval = imx274_g_frame_interval,
1934 	.s_frame_interval = imx274_s_frame_interval,
1935 	.s_stream = imx274_s_stream,
1936 };
1937 
1938 static const struct v4l2_subdev_ops imx274_subdev_ops = {
1939 	.pad = &imx274_pad_ops,
1940 	.video = &imx274_video_ops,
1941 };
1942 
1943 static const struct v4l2_ctrl_ops imx274_ctrl_ops = {
1944 	.s_ctrl	= imx274_s_ctrl,
1945 };
1946 
1947 static const struct of_device_id imx274_of_id_table[] = {
1948 	{ .compatible = "sony,imx274" },
1949 	{ }
1950 };
1951 MODULE_DEVICE_TABLE(of, imx274_of_id_table);
1952 
1953 static const struct i2c_device_id imx274_id[] = {
1954 	{ "IMX274", 0 },
1955 	{ }
1956 };
1957 MODULE_DEVICE_TABLE(i2c, imx274_id);
1958 
imx274_fwnode_parse(struct device * dev)1959 static int imx274_fwnode_parse(struct device *dev)
1960 {
1961 	struct fwnode_handle *endpoint;
1962 	/* Only CSI2 is supported */
1963 	struct v4l2_fwnode_endpoint ep = {
1964 		.bus_type = V4L2_MBUS_CSI2_DPHY
1965 	};
1966 	int ret;
1967 
1968 	endpoint = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL);
1969 	if (!endpoint) {
1970 		dev_err(dev, "Endpoint node not found\n");
1971 		return -EINVAL;
1972 	}
1973 
1974 	ret = v4l2_fwnode_endpoint_parse(endpoint, &ep);
1975 	fwnode_handle_put(endpoint);
1976 	if (ret == -ENXIO) {
1977 		dev_err(dev, "Unsupported bus type, should be CSI2\n");
1978 		return ret;
1979 	} else if (ret) {
1980 		dev_err(dev, "Parsing endpoint node failed %d\n", ret);
1981 		return ret;
1982 	}
1983 
1984 	/* Check number of data lanes, only 4 lanes supported */
1985 	if (ep.bus.mipi_csi2.num_data_lanes != 4) {
1986 		dev_err(dev, "Invalid data lanes: %d\n",
1987 			ep.bus.mipi_csi2.num_data_lanes);
1988 		return -EINVAL;
1989 	}
1990 
1991 	return 0;
1992 }
1993 
imx274_probe(struct i2c_client * client)1994 static int imx274_probe(struct i2c_client *client)
1995 {
1996 	struct v4l2_subdev *sd;
1997 	struct stimx274 *imx274;
1998 	struct device *dev = &client->dev;
1999 	int ret;
2000 
2001 	/* initialize imx274 */
2002 	imx274 = devm_kzalloc(dev, sizeof(*imx274), GFP_KERNEL);
2003 	if (!imx274)
2004 		return -ENOMEM;
2005 
2006 	mutex_init(&imx274->lock);
2007 
2008 	ret = imx274_fwnode_parse(dev);
2009 	if (ret)
2010 		return ret;
2011 
2012 	imx274->inck = devm_clk_get_optional(dev, "inck");
2013 	if (IS_ERR(imx274->inck))
2014 		return PTR_ERR(imx274->inck);
2015 
2016 	ret = imx274_regulators_get(dev, imx274);
2017 	if (ret) {
2018 		dev_err(dev, "Failed to get power regulators, err: %d\n", ret);
2019 		return ret;
2020 	}
2021 
2022 	/* initialize format */
2023 	imx274->mode = &imx274_modes[0];
2024 	imx274->crop.width = IMX274_MAX_WIDTH;
2025 	imx274->crop.height = IMX274_MAX_HEIGHT;
2026 	imx274->format.width = imx274->crop.width / imx274->mode->wbin_ratio;
2027 	imx274->format.height = imx274->crop.height / imx274->mode->hbin_ratio;
2028 	imx274->format.field = V4L2_FIELD_NONE;
2029 	imx274->format.code = MEDIA_BUS_FMT_SRGGB10_1X10;
2030 	imx274->format.colorspace = V4L2_COLORSPACE_SRGB;
2031 	imx274->frame_interval.numerator = 1;
2032 	imx274->frame_interval.denominator = IMX274_DEF_FRAME_RATE;
2033 
2034 	/* initialize regmap */
2035 	imx274->regmap = devm_regmap_init_i2c(client, &imx274_regmap_config);
2036 	if (IS_ERR(imx274->regmap)) {
2037 		dev_err(dev,
2038 			"regmap init failed: %ld\n", PTR_ERR(imx274->regmap));
2039 		ret = -ENODEV;
2040 		goto err_regmap;
2041 	}
2042 
2043 	/* initialize subdevice */
2044 	imx274->client = client;
2045 	sd = &imx274->sd;
2046 	v4l2_i2c_subdev_init(sd, client, &imx274_subdev_ops);
2047 	sd->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE | V4L2_SUBDEV_FL_HAS_EVENTS;
2048 
2049 	/* initialize subdev media pad */
2050 	imx274->pad.flags = MEDIA_PAD_FL_SOURCE;
2051 	sd->entity.function = MEDIA_ENT_F_CAM_SENSOR;
2052 	ret = media_entity_pads_init(&sd->entity, 1, &imx274->pad);
2053 	if (ret < 0) {
2054 		dev_err(dev,
2055 			"%s : media entity init Failed %d\n", __func__, ret);
2056 		goto err_regmap;
2057 	}
2058 
2059 	/* initialize sensor reset gpio */
2060 	imx274->reset_gpio = devm_gpiod_get_optional(dev, "reset",
2061 						     GPIOD_OUT_HIGH);
2062 	if (IS_ERR(imx274->reset_gpio)) {
2063 		ret = dev_err_probe(dev, PTR_ERR(imx274->reset_gpio),
2064 				    "Reset GPIO not setup in DT\n");
2065 		goto err_me;
2066 	}
2067 
2068 	/* power on the sensor */
2069 	ret = imx274_power_on(dev);
2070 	if (ret < 0) {
2071 		dev_err(dev, "%s : imx274 power on failed\n", __func__);
2072 		goto err_me;
2073 	}
2074 
2075 	/* initialize controls */
2076 	ret = v4l2_ctrl_handler_init(&imx274->ctrls.handler, 4);
2077 	if (ret < 0) {
2078 		dev_err(dev, "%s : ctrl handler init Failed\n", __func__);
2079 		goto err_power_off;
2080 	}
2081 
2082 	imx274->ctrls.handler.lock = &imx274->lock;
2083 
2084 	/* add new controls */
2085 	imx274->ctrls.test_pattern = v4l2_ctrl_new_std_menu_items(
2086 		&imx274->ctrls.handler, &imx274_ctrl_ops,
2087 		V4L2_CID_TEST_PATTERN,
2088 		ARRAY_SIZE(tp_qmenu) - 1, 0, 0, tp_qmenu);
2089 
2090 	imx274->ctrls.gain = v4l2_ctrl_new_std(
2091 		&imx274->ctrls.handler,
2092 		&imx274_ctrl_ops,
2093 		V4L2_CID_GAIN, IMX274_MIN_GAIN,
2094 		IMX274_MAX_DIGITAL_GAIN * IMX274_MAX_ANALOG_GAIN, 1,
2095 		IMX274_DEF_GAIN);
2096 
2097 	imx274->ctrls.exposure = v4l2_ctrl_new_std(
2098 		&imx274->ctrls.handler,
2099 		&imx274_ctrl_ops,
2100 		V4L2_CID_EXPOSURE, IMX274_MIN_EXPOSURE_TIME,
2101 		1000000 / IMX274_DEF_FRAME_RATE, 1,
2102 		IMX274_MIN_EXPOSURE_TIME);
2103 
2104 	imx274->ctrls.vflip = v4l2_ctrl_new_std(
2105 		&imx274->ctrls.handler,
2106 		&imx274_ctrl_ops,
2107 		V4L2_CID_VFLIP, 0, 1, 1, 0);
2108 
2109 	imx274->sd.ctrl_handler = &imx274->ctrls.handler;
2110 	if (imx274->ctrls.handler.error) {
2111 		ret = imx274->ctrls.handler.error;
2112 		goto err_ctrls;
2113 	}
2114 
2115 	/* load default control values */
2116 	imx274_load_default(imx274);
2117 
2118 	/* register subdevice */
2119 	ret = v4l2_async_register_subdev(sd);
2120 	if (ret < 0) {
2121 		dev_err(dev, "%s : v4l2_async_register_subdev failed %d\n",
2122 			__func__, ret);
2123 		goto err_ctrls;
2124 	}
2125 
2126 	pm_runtime_set_active(dev);
2127 	pm_runtime_enable(dev);
2128 	pm_runtime_idle(dev);
2129 
2130 	dev_info(dev, "imx274 : imx274 probe success !\n");
2131 	return 0;
2132 
2133 err_ctrls:
2134 	v4l2_ctrl_handler_free(&imx274->ctrls.handler);
2135 err_power_off:
2136 	imx274_power_off(dev);
2137 err_me:
2138 	media_entity_cleanup(&sd->entity);
2139 err_regmap:
2140 	mutex_destroy(&imx274->lock);
2141 	return ret;
2142 }
2143 
imx274_remove(struct i2c_client * client)2144 static void imx274_remove(struct i2c_client *client)
2145 {
2146 	struct v4l2_subdev *sd = i2c_get_clientdata(client);
2147 	struct stimx274 *imx274 = to_imx274(sd);
2148 
2149 	pm_runtime_disable(&client->dev);
2150 	if (!pm_runtime_status_suspended(&client->dev))
2151 		imx274_power_off(&client->dev);
2152 	pm_runtime_set_suspended(&client->dev);
2153 
2154 	v4l2_async_unregister_subdev(sd);
2155 	v4l2_ctrl_handler_free(&imx274->ctrls.handler);
2156 
2157 	media_entity_cleanup(&sd->entity);
2158 	mutex_destroy(&imx274->lock);
2159 }
2160 
2161 static const struct dev_pm_ops imx274_pm_ops = {
2162 	SET_RUNTIME_PM_OPS(imx274_power_off, imx274_power_on, NULL)
2163 };
2164 
2165 static struct i2c_driver imx274_i2c_driver = {
2166 	.driver = {
2167 		.name	= DRIVER_NAME,
2168 		.pm = &imx274_pm_ops,
2169 		.of_match_table	= imx274_of_id_table,
2170 	},
2171 	.probe		= imx274_probe,
2172 	.remove		= imx274_remove,
2173 	.id_table	= imx274_id,
2174 };
2175 
2176 module_i2c_driver(imx274_i2c_driver);
2177 
2178 MODULE_AUTHOR("Leon Luo <leonl@leopardimaging.com>");
2179 MODULE_DESCRIPTION("IMX274 CMOS Image Sensor driver");
2180 MODULE_LICENSE("GPL v2");
2181