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 */
135static 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 */
146struct reg_8 {
147 u16 addr;
148 u8 val;
149};
150
151static const struct regmap_config imx274_regmap_config = {
152 .reg_bits = 16,
153 .val_bits = 8,
154 .cache_type = REGCACHE_MAPLE,
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 */
174struct 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 */
187enum {
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
203static 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 */
224static 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 */
265static 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 */
305static 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 */
345static 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 */
384static 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 */
441static 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 */
451static 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 */
460static 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 */
468static 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 */
480static 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 */
490static 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 */
541struct 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 */
567struct 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 */
593static int imx274_set_gain(struct stimx274 *priv, struct v4l2_ctrl *ctrl);
594static int imx274_set_exposure(struct stimx274 *priv, int val);
595static int imx274_set_vflip(struct stimx274 *priv, int val);
596static int imx274_set_test_pattern(struct stimx274 *priv, int val);
597static int __imx274_set_frame_interval(struct stimx274 *priv,
598 struct v4l2_fract frame_interval);
599
600static inline void msleep_range(unsigned int delay_base)
601{
602 usleep_range(min: delay_base * 1000, max: delay_base * 1000 + 500);
603}
604
605/*
606 * v4l2_ctrl and v4l2_subdev related operations
607 */
608static 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
614static 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 */
629static 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(map: regmap,
648 reg: range_start, val: range_vals[0]);
649 else if (range_count > 1)
650 err = regmap_bulk_write(map: regmap, reg: range_start,
651 val: &range_vals[0],
652 val_count: 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(delay_base: 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
682static inline int imx274_write_reg(struct stimx274 *priv, u16 addr, u8 val)
683{
684 int err;
685
686 err = regmap_write(map: priv->regmap, reg: 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 */
712static 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(map: priv->regmap, reg: addr, val: &val_le, val_count: 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 */
744static 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(map: priv->regmap, reg: addr, val: &val_le, val_count: 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 */
768static int imx274_mode_regs(struct stimx274 *priv)
769{
770 int err = 0;
771
772 err = imx274_write_table(priv, table: imx274_start_1);
773 if (err)
774 return err;
775
776 err = imx274_write_table(priv, table: 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 */
787static int imx274_start_stream(struct stimx274 *priv)
788{
789 int err = 0;
790
791 err = __v4l2_ctrl_handler_setup(hdl: &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(delay_base: 11);
803 err = imx274_write_table(priv, table: 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(delay_base: 8);
813 err = imx274_write_table(priv, table: 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 */
830static void imx274_reset(struct stimx274 *priv, int rst)
831{
832 gpiod_set_value_cansleep(desc: priv->reset_gpio, value: 0);
833 usleep_range(IMX274_RESET_DELAY1, IMX274_RESET_DELAY2);
834 gpiod_set_value_cansleep(desc: priv->reset_gpio, value: !!rst);
835 usleep_range(IMX274_RESET_DELAY1, IMX274_RESET_DELAY2);
836}
837
838static 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(priv: imx274, rst: 0);
847
848 ret = clk_prepare_enable(clk: 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, consumers: 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(usec: 2);
863 imx274_reset(priv: imx274, rst: 1);
864
865 return 0;
866
867fail_reg:
868 clk_disable_unprepare(clk: imx274->inck);
869 return ret;
870}
871
872static 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(priv: imx274, rst: 0);
879
880 regulator_bulk_disable(IMX274_NUM_SUPPLIES, consumers: imx274->supplies);
881
882 clk_disable_unprepare(clk: imx274->inck);
883
884 return 0;
885}
886
887static 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 consumers: 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 */
906static 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(dev: &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(priv: imx274, val: 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(priv: 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(priv: imx274, val: 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(priv: imx274, val: ctrl->val);
942 break;
943 }
944
945 pm_runtime_put(dev: &imx274->client->dev);
946
947 return ret;
948}
949
950static 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 */
1006static 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 = v4l2_subdev_state_get_crop(sd_state, 0);
1022 tgt_fmt = v4l2_subdev_state_get_format(sd_state, 0);
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 w: cur_crop->width / wratio, ask_w: *width,
1035 h: cur_crop->height / hratio, ask_h: *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 */
1070static 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(lock: &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 */
1092static 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, which: format->which,
1103 width: &fmt->width, height: &fmt->height, flags: 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 *v4l2_subdev_state_get_format(sd_state, 0) = *fmt;
1116 else
1117 imx274->format = *fmt;
1118
1119out:
1120 mutex_unlock(lock: &imx274->lock);
1121
1122 return err;
1123}
1124
1125static 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 = v4l2_subdev_state_get_crop(sd_state, 0);
1147 src_fmt = v4l2_subdev_state_get_format(sd_state, 0);
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(lock: &imx274->lock);
1176
1177 return ret;
1178}
1179
1180static 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 = v4l2_subdev_state_get_crop(sd_state, 0);
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, which: sel->which,
1233 width: &new_crop.width, height: &new_crop.height,
1234 flags: sel->flags);
1235
1236 mutex_unlock(lock: &imx274->lock);
1237
1238 return 0;
1239}
1240
1241static 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, which: sel->which,
1258 width: &sel->r.width, height: &sel->r.height,
1259 flags: sel->flags);
1260 mutex_unlock(lock: &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
1277static 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(priv: imx274, IMX274_HMAX_REG_LSB, val: hmax, nbytes: 2);
1304 if (!err)
1305 err = imx274_write_mbreg(priv: imx274, IMX274_HTRIM_EN_REG, val: 1, nbytes: 1);
1306 if (!err)
1307 err = imx274_write_mbreg(priv: imx274, IMX274_HTRIM_START_REG_LSB,
1308 val: h_start, nbytes: 2);
1309 if (!err)
1310 err = imx274_write_mbreg(priv: imx274, IMX274_HTRIM_END_REG_LSB,
1311 val: h_end, nbytes: 2);
1312 if (!err)
1313 err = imx274_write_mbreg(priv: imx274, IMX274_VWIDCUTEN_REG, val: 1, nbytes: 1);
1314 if (!err)
1315 err = imx274_write_mbreg(priv: imx274, IMX274_VWIDCUT_REG_LSB,
1316 val: v_cut, nbytes: 2);
1317 if (!err)
1318 err = imx274_write_mbreg(priv: imx274, IMX274_VWINPOS_REG_LSB,
1319 val: v_pos, nbytes: 2);
1320 if (!err)
1321 err = imx274_write_mbreg(priv: imx274, IMX274_WRITE_VSIZE_REG_LSB,
1322 val: write_v_size, nbytes: 2);
1323 if (!err)
1324 err = imx274_write_mbreg(priv: imx274, IMX274_Y_OUT_SIZE_REG_LSB,
1325 val: y_out_size, nbytes: 2);
1326
1327 return err;
1328}
1329
1330static int imx274_get_frame_interval(struct v4l2_subdev *sd,
1331 struct v4l2_subdev_state *sd_state,
1332 struct v4l2_subdev_frame_interval *fi)
1333{
1334 struct stimx274 *imx274 = to_imx274(sd);
1335
1336 /*
1337 * FIXME: Implement support for V4L2_SUBDEV_FORMAT_TRY, using the V4L2
1338 * subdev active state API.
1339 */
1340 if (fi->which != V4L2_SUBDEV_FORMAT_ACTIVE)
1341 return -EINVAL;
1342
1343 fi->interval = imx274->frame_interval;
1344 dev_dbg(&imx274->client->dev, "%s frame rate = %d / %d\n",
1345 __func__, imx274->frame_interval.numerator,
1346 imx274->frame_interval.denominator);
1347
1348 return 0;
1349}
1350
1351static int imx274_set_frame_interval(struct v4l2_subdev *sd,
1352 struct v4l2_subdev_state *sd_state,
1353 struct v4l2_subdev_frame_interval *fi)
1354{
1355 struct stimx274 *imx274 = to_imx274(sd);
1356 struct v4l2_ctrl *ctrl = imx274->ctrls.exposure;
1357 int min, max, def;
1358 int ret;
1359
1360 /*
1361 * FIXME: Implement support for V4L2_SUBDEV_FORMAT_TRY, using the V4L2
1362 * subdev active state API.
1363 */
1364 if (fi->which != V4L2_SUBDEV_FORMAT_ACTIVE)
1365 return -EINVAL;
1366
1367 ret = pm_runtime_resume_and_get(dev: &imx274->client->dev);
1368 if (ret < 0)
1369 return ret;
1370
1371 mutex_lock(&imx274->lock);
1372 ret = __imx274_set_frame_interval(priv: imx274, frame_interval: fi->interval);
1373
1374 if (!ret) {
1375 fi->interval = imx274->frame_interval;
1376
1377 /*
1378 * exposure time range is decided by frame interval
1379 * need to update it after frame interval changes
1380 */
1381 min = IMX274_MIN_EXPOSURE_TIME;
1382 max = fi->interval.numerator * 1000000
1383 / fi->interval.denominator;
1384 def = max;
1385 ret = __v4l2_ctrl_modify_range(ctrl, min, max, step: 1, def);
1386 if (ret) {
1387 dev_err(&imx274->client->dev,
1388 "Exposure ctrl range update failed\n");
1389 goto unlock;
1390 }
1391
1392 /* update exposure time accordingly */
1393 imx274_set_exposure(priv: imx274, val: ctrl->val);
1394
1395 dev_dbg(&imx274->client->dev, "set frame interval to %uus\n",
1396 fi->interval.numerator * 1000000
1397 / fi->interval.denominator);
1398 }
1399
1400unlock:
1401 mutex_unlock(lock: &imx274->lock);
1402 pm_runtime_put(dev: &imx274->client->dev);
1403
1404 return ret;
1405}
1406
1407/**
1408 * imx274_load_default - load default control values
1409 * @priv: Pointer to device structure
1410 *
1411 * Return: 0 on success, errors otherwise
1412 */
1413static void imx274_load_default(struct stimx274 *priv)
1414{
1415 /* load default control values */
1416 priv->frame_interval.numerator = 1;
1417 priv->frame_interval.denominator = IMX274_DEF_FRAME_RATE;
1418 priv->ctrls.exposure->val = 1000000 / IMX274_DEF_FRAME_RATE;
1419 priv->ctrls.gain->val = IMX274_DEF_GAIN;
1420 priv->ctrls.vflip->val = 0;
1421 priv->ctrls.test_pattern->val = TEST_PATTERN_DISABLED;
1422}
1423
1424/**
1425 * imx274_s_stream - It is used to start/stop the streaming.
1426 * @sd: V4L2 Sub device
1427 * @on: Flag (True / False)
1428 *
1429 * This function controls the start or stop of streaming for the
1430 * imx274 sensor.
1431 *
1432 * Return: 0 on success, errors otherwise
1433 */
1434static int imx274_s_stream(struct v4l2_subdev *sd, int on)
1435{
1436 struct stimx274 *imx274 = to_imx274(sd);
1437 int ret = 0;
1438
1439 dev_dbg(&imx274->client->dev, "%s : %s, mode index = %td\n", __func__,
1440 on ? "Stream Start" : "Stream Stop",
1441 imx274->mode - &imx274_modes[0]);
1442
1443 mutex_lock(&imx274->lock);
1444
1445 if (on) {
1446 ret = pm_runtime_resume_and_get(dev: &imx274->client->dev);
1447 if (ret < 0) {
1448 mutex_unlock(lock: &imx274->lock);
1449 return ret;
1450 }
1451
1452 /* load mode registers */
1453 ret = imx274_mode_regs(priv: imx274);
1454 if (ret)
1455 goto fail;
1456
1457 ret = imx274_apply_trimming(imx274);
1458 if (ret)
1459 goto fail;
1460
1461 /*
1462 * update frame rate & exposure. if the last mode is different,
1463 * HMAX could be changed. As the result, frame rate & exposure
1464 * are changed.
1465 * gain is not affected.
1466 */
1467 ret = __imx274_set_frame_interval(priv: imx274,
1468 frame_interval: imx274->frame_interval);
1469 if (ret)
1470 goto fail;
1471
1472 /* start stream */
1473 ret = imx274_start_stream(priv: imx274);
1474 if (ret)
1475 goto fail;
1476 } else {
1477 /* stop stream */
1478 ret = imx274_write_table(priv: imx274, table: imx274_stop);
1479 if (ret)
1480 goto fail;
1481
1482 pm_runtime_put(dev: &imx274->client->dev);
1483 }
1484
1485 mutex_unlock(lock: &imx274->lock);
1486 dev_dbg(&imx274->client->dev, "%s : Done\n", __func__);
1487 return 0;
1488
1489fail:
1490 pm_runtime_put(dev: &imx274->client->dev);
1491 mutex_unlock(lock: &imx274->lock);
1492 dev_err(&imx274->client->dev, "s_stream failed\n");
1493 return ret;
1494}
1495
1496/*
1497 * imx274_get_frame_length - Function for obtaining current frame length
1498 * @priv: Pointer to device structure
1499 * @val: Pointer to obtained value
1500 *
1501 * frame_length = vmax x (svr + 1), in unit of hmax.
1502 *
1503 * Return: 0 on success
1504 */
1505static int imx274_get_frame_length(struct stimx274 *priv, u32 *val)
1506{
1507 int err;
1508 u32 svr;
1509 u32 vmax;
1510
1511 err = imx274_read_mbreg(priv, IMX274_SVR_REG_LSB, val: &svr, nbytes: 2);
1512 if (err)
1513 goto fail;
1514
1515 err = imx274_read_mbreg(priv, IMX274_VMAX_REG_3, val: &vmax, nbytes: 3);
1516 if (err)
1517 goto fail;
1518
1519 *val = vmax * (svr + 1);
1520
1521 return 0;
1522
1523fail:
1524 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1525 return err;
1526}
1527
1528static int imx274_clamp_coarse_time(struct stimx274 *priv, u32 *val,
1529 u32 *frame_length)
1530{
1531 int err;
1532
1533 err = imx274_get_frame_length(priv, val: frame_length);
1534 if (err)
1535 return err;
1536
1537 if (*frame_length < priv->mode->min_frame_len)
1538 *frame_length = priv->mode->min_frame_len;
1539
1540 *val = *frame_length - *val; /* convert to raw shr */
1541 if (*val > *frame_length - IMX274_SHR_LIMIT_CONST)
1542 *val = *frame_length - IMX274_SHR_LIMIT_CONST;
1543 else if (*val < priv->mode->min_SHR)
1544 *val = priv->mode->min_SHR;
1545
1546 return 0;
1547}
1548
1549/*
1550 * imx274_set_digital gain - Function called when setting digital gain
1551 * @priv: Pointer to device structure
1552 * @dgain: Value of digital gain.
1553 *
1554 * Digital gain has only 4 steps: 1x, 2x, 4x, and 8x
1555 *
1556 * Return: 0 on success
1557 */
1558static int imx274_set_digital_gain(struct stimx274 *priv, u32 dgain)
1559{
1560 u8 reg_val;
1561
1562 reg_val = ffs(dgain);
1563
1564 if (reg_val)
1565 reg_val--;
1566
1567 reg_val = clamp(reg_val, (u8)0, (u8)3);
1568
1569 return imx274_write_reg(priv, IMX274_DIGITAL_GAIN_REG,
1570 val: reg_val & IMX274_MASK_LSB_4_BITS);
1571}
1572
1573/*
1574 * imx274_set_gain - Function called when setting gain
1575 * @priv: Pointer to device structure
1576 * @val: Value of gain. the real value = val << IMX274_GAIN_SHIFT;
1577 * @ctrl: v4l2 control pointer
1578 *
1579 * Set the gain based on input value.
1580 * The caller should hold the mutex lock imx274->lock if necessary
1581 *
1582 * Return: 0 on success
1583 */
1584static int imx274_set_gain(struct stimx274 *priv, struct v4l2_ctrl *ctrl)
1585{
1586 int err;
1587 u32 gain, analog_gain, digital_gain, gain_reg;
1588
1589 gain = (u32)(ctrl->val);
1590
1591 dev_dbg(&priv->client->dev,
1592 "%s : input gain = %d.%d\n", __func__,
1593 gain >> IMX274_GAIN_SHIFT,
1594 ((gain & IMX274_GAIN_SHIFT_MASK) * 100) >> IMX274_GAIN_SHIFT);
1595
1596 if (gain > IMX274_MAX_DIGITAL_GAIN * IMX274_MAX_ANALOG_GAIN)
1597 gain = IMX274_MAX_DIGITAL_GAIN * IMX274_MAX_ANALOG_GAIN;
1598 else if (gain < IMX274_MIN_GAIN)
1599 gain = IMX274_MIN_GAIN;
1600
1601 if (gain <= IMX274_MAX_ANALOG_GAIN)
1602 digital_gain = 1;
1603 else if (gain <= IMX274_MAX_ANALOG_GAIN * 2)
1604 digital_gain = 2;
1605 else if (gain <= IMX274_MAX_ANALOG_GAIN * 4)
1606 digital_gain = 4;
1607 else
1608 digital_gain = IMX274_MAX_DIGITAL_GAIN;
1609
1610 analog_gain = gain / digital_gain;
1611
1612 dev_dbg(&priv->client->dev,
1613 "%s : digital gain = %d, analog gain = %d.%d\n",
1614 __func__, digital_gain, analog_gain >> IMX274_GAIN_SHIFT,
1615 ((analog_gain & IMX274_GAIN_SHIFT_MASK) * 100)
1616 >> IMX274_GAIN_SHIFT);
1617
1618 err = imx274_set_digital_gain(priv, dgain: digital_gain);
1619 if (err)
1620 goto fail;
1621
1622 /* convert to register value, refer to imx274 datasheet */
1623 gain_reg = (u32)IMX274_GAIN_CONST -
1624 (IMX274_GAIN_CONST << IMX274_GAIN_SHIFT) / analog_gain;
1625 if (gain_reg > IMX274_GAIN_REG_MAX)
1626 gain_reg = IMX274_GAIN_REG_MAX;
1627
1628 err = imx274_write_mbreg(priv, IMX274_ANALOG_GAIN_ADDR_LSB, val: gain_reg,
1629 nbytes: 2);
1630 if (err)
1631 goto fail;
1632
1633 if (IMX274_GAIN_CONST - gain_reg == 0) {
1634 err = -EINVAL;
1635 goto fail;
1636 }
1637
1638 /* convert register value back to gain value */
1639 ctrl->val = (IMX274_GAIN_CONST << IMX274_GAIN_SHIFT)
1640 / (IMX274_GAIN_CONST - gain_reg) * digital_gain;
1641
1642 dev_dbg(&priv->client->dev,
1643 "%s : GAIN control success, gain_reg = %d, new gain = %d\n",
1644 __func__, gain_reg, ctrl->val);
1645
1646 return 0;
1647
1648fail:
1649 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1650 return err;
1651}
1652
1653/*
1654 * imx274_set_coarse_time - Function called when setting SHR value
1655 * @priv: Pointer to device structure
1656 * @val: Value for exposure time in number of line_length, or [HMAX]
1657 *
1658 * Set SHR value based on input value.
1659 *
1660 * Return: 0 on success
1661 */
1662static int imx274_set_coarse_time(struct stimx274 *priv, u32 *val)
1663{
1664 int err;
1665 u32 coarse_time, frame_length;
1666
1667 coarse_time = *val;
1668
1669 /* convert exposure_time to appropriate SHR value */
1670 err = imx274_clamp_coarse_time(priv, val: &coarse_time, frame_length: &frame_length);
1671 if (err)
1672 goto fail;
1673
1674 err = imx274_write_mbreg(priv, IMX274_SHR_REG_LSB, val: coarse_time, nbytes: 2);
1675 if (err)
1676 goto fail;
1677
1678 *val = frame_length - coarse_time;
1679 return 0;
1680
1681fail:
1682 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1683 return err;
1684}
1685
1686/*
1687 * imx274_set_exposure - Function called when setting exposure time
1688 * @priv: Pointer to device structure
1689 * @val: Variable for exposure time, in the unit of micro-second
1690 *
1691 * Set exposure time based on input value.
1692 * The caller should hold the mutex lock imx274->lock if necessary
1693 *
1694 * Return: 0 on success
1695 */
1696static int imx274_set_exposure(struct stimx274 *priv, int val)
1697{
1698 int err;
1699 u32 hmax;
1700 u32 coarse_time; /* exposure time in unit of line (HMAX)*/
1701
1702 dev_dbg(&priv->client->dev,
1703 "%s : EXPOSURE control input = %d\n", __func__, val);
1704
1705 /* step 1: convert input exposure_time (val) into number of 1[HMAX] */
1706
1707 err = imx274_read_mbreg(priv, IMX274_HMAX_REG_LSB, val: &hmax, nbytes: 2);
1708 if (err)
1709 goto fail;
1710
1711 if (hmax == 0) {
1712 err = -EINVAL;
1713 goto fail;
1714 }
1715
1716 coarse_time = (IMX274_PIXCLK_CONST1 / IMX274_PIXCLK_CONST2 * val
1717 - priv->mode->nocpiop) / hmax;
1718
1719 /* step 2: convert exposure_time into SHR value */
1720
1721 /* set SHR */
1722 err = imx274_set_coarse_time(priv, val: &coarse_time);
1723 if (err)
1724 goto fail;
1725
1726 priv->ctrls.exposure->val =
1727 (coarse_time * hmax + priv->mode->nocpiop)
1728 / (IMX274_PIXCLK_CONST1 / IMX274_PIXCLK_CONST2);
1729
1730 dev_dbg(&priv->client->dev,
1731 "%s : EXPOSURE control success\n", __func__);
1732 return 0;
1733
1734fail:
1735 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1736
1737 return err;
1738}
1739
1740/*
1741 * imx274_set_vflip - Function called when setting vertical flip
1742 * @priv: Pointer to device structure
1743 * @val: Value for vflip setting
1744 *
1745 * Set vertical flip based on input value.
1746 * val = 0: normal, no vertical flip
1747 * val = 1: vertical flip enabled
1748 * The caller should hold the mutex lock imx274->lock if necessary
1749 *
1750 * Return: 0 on success
1751 */
1752static int imx274_set_vflip(struct stimx274 *priv, int val)
1753{
1754 int err;
1755
1756 err = imx274_write_reg(priv, IMX274_VFLIP_REG, val);
1757 if (err) {
1758 dev_err(&priv->client->dev, "VFLIP control error\n");
1759 return err;
1760 }
1761
1762 dev_dbg(&priv->client->dev,
1763 "%s : VFLIP control success\n", __func__);
1764
1765 return 0;
1766}
1767
1768/*
1769 * imx274_set_test_pattern - Function called when setting test pattern
1770 * @priv: Pointer to device structure
1771 * @val: Variable for test pattern
1772 *
1773 * Set to different test patterns based on input value.
1774 *
1775 * Return: 0 on success
1776 */
1777static int imx274_set_test_pattern(struct stimx274 *priv, int val)
1778{
1779 int err = 0;
1780
1781 if (val == TEST_PATTERN_DISABLED) {
1782 err = imx274_write_table(priv, table: imx274_tp_disabled);
1783 } else if (val <= TEST_PATTERN_V_COLOR_BARS) {
1784 err = imx274_write_reg(priv, IMX274_TEST_PATTERN_REG, val: val - 1);
1785 if (!err)
1786 err = imx274_write_table(priv, table: imx274_tp_regs);
1787 } else {
1788 err = -EINVAL;
1789 }
1790
1791 if (!err)
1792 dev_dbg(&priv->client->dev,
1793 "%s : TEST PATTERN control success\n", __func__);
1794 else
1795 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1796
1797 return err;
1798}
1799
1800/*
1801 * imx274_set_frame_length - Function called when setting frame length
1802 * @priv: Pointer to device structure
1803 * @val: Variable for frame length (= VMAX, i.e. vertical drive period length)
1804 *
1805 * Set frame length based on input value.
1806 *
1807 * Return: 0 on success
1808 */
1809static int imx274_set_frame_length(struct stimx274 *priv, u32 val)
1810{
1811 int err;
1812 u32 frame_length;
1813
1814 dev_dbg(&priv->client->dev, "%s : input length = %d\n",
1815 __func__, val);
1816
1817 frame_length = (u32)val;
1818
1819 err = imx274_write_mbreg(priv, IMX274_VMAX_REG_3, val: frame_length, nbytes: 3);
1820 if (err)
1821 goto fail;
1822
1823 return 0;
1824
1825fail:
1826 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1827 return err;
1828}
1829
1830/*
1831 * __imx274_set_frame_interval - Function called when setting frame interval
1832 * @priv: Pointer to device structure
1833 * @frame_interval: Variable for frame interval
1834 *
1835 * Change frame interval by updating VMAX value
1836 * The caller should hold the mutex lock imx274->lock if necessary
1837 *
1838 * Return: 0 on success
1839 */
1840static int __imx274_set_frame_interval(struct stimx274 *priv,
1841 struct v4l2_fract frame_interval)
1842{
1843 int err;
1844 u32 frame_length, req_frame_rate;
1845 u32 svr;
1846 u32 hmax;
1847
1848 dev_dbg(&priv->client->dev, "%s: input frame interval = %d / %d",
1849 __func__, frame_interval.numerator,
1850 frame_interval.denominator);
1851
1852 if (frame_interval.numerator == 0 || frame_interval.denominator == 0) {
1853 frame_interval.denominator = IMX274_DEF_FRAME_RATE;
1854 frame_interval.numerator = 1;
1855 }
1856
1857 req_frame_rate = (u32)(frame_interval.denominator
1858 / frame_interval.numerator);
1859
1860 /* boundary check */
1861 if (req_frame_rate > priv->mode->max_fps) {
1862 frame_interval.numerator = 1;
1863 frame_interval.denominator = priv->mode->max_fps;
1864 } else if (req_frame_rate < IMX274_MIN_FRAME_RATE) {
1865 frame_interval.numerator = 1;
1866 frame_interval.denominator = IMX274_MIN_FRAME_RATE;
1867 }
1868
1869 /*
1870 * VMAX = 1/frame_rate x 72M / (SVR+1) / HMAX
1871 * frame_length (i.e. VMAX) = (frame_interval) x 72M /(SVR+1) / HMAX
1872 */
1873
1874 err = imx274_read_mbreg(priv, IMX274_SVR_REG_LSB, val: &svr, nbytes: 2);
1875 if (err)
1876 goto fail;
1877
1878 dev_dbg(&priv->client->dev,
1879 "%s : register SVR = %d\n", __func__, svr);
1880
1881 err = imx274_read_mbreg(priv, IMX274_HMAX_REG_LSB, val: &hmax, nbytes: 2);
1882 if (err)
1883 goto fail;
1884
1885 dev_dbg(&priv->client->dev,
1886 "%s : register HMAX = %d\n", __func__, hmax);
1887
1888 if (hmax == 0 || frame_interval.denominator == 0) {
1889 err = -EINVAL;
1890 goto fail;
1891 }
1892
1893 frame_length = IMX274_PIXCLK_CONST1 / (svr + 1) / hmax
1894 * frame_interval.numerator
1895 / frame_interval.denominator;
1896
1897 err = imx274_set_frame_length(priv, val: frame_length);
1898 if (err)
1899 goto fail;
1900
1901 priv->frame_interval = frame_interval;
1902 return 0;
1903
1904fail:
1905 dev_err(&priv->client->dev, "%s error = %d\n", __func__, err);
1906 return err;
1907}
1908
1909static int imx274_enum_mbus_code(struct v4l2_subdev *sd,
1910 struct v4l2_subdev_state *sd_state,
1911 struct v4l2_subdev_mbus_code_enum *code)
1912{
1913 if (code->index > 0)
1914 return -EINVAL;
1915
1916 /* only supported format in the driver is Raw 10 bits SRGGB */
1917 code->code = MEDIA_BUS_FMT_SRGGB10_1X10;
1918
1919 return 0;
1920}
1921
1922static const struct v4l2_subdev_pad_ops imx274_pad_ops = {
1923 .enum_mbus_code = imx274_enum_mbus_code,
1924 .get_fmt = imx274_get_fmt,
1925 .set_fmt = imx274_set_fmt,
1926 .get_selection = imx274_get_selection,
1927 .set_selection = imx274_set_selection,
1928 .get_frame_interval = imx274_get_frame_interval,
1929 .set_frame_interval = imx274_set_frame_interval,
1930};
1931
1932static const struct v4l2_subdev_video_ops imx274_video_ops = {
1933 .s_stream = imx274_s_stream,
1934};
1935
1936static const struct v4l2_subdev_ops imx274_subdev_ops = {
1937 .pad = &imx274_pad_ops,
1938 .video = &imx274_video_ops,
1939};
1940
1941static const struct v4l2_ctrl_ops imx274_ctrl_ops = {
1942 .s_ctrl = imx274_s_ctrl,
1943};
1944
1945static const struct of_device_id imx274_of_id_table[] = {
1946 { .compatible = "sony,imx274" },
1947 { }
1948};
1949MODULE_DEVICE_TABLE(of, imx274_of_id_table);
1950
1951static const struct i2c_device_id imx274_id[] = {
1952 { "IMX274" },
1953 { }
1954};
1955MODULE_DEVICE_TABLE(i2c, imx274_id);
1956
1957static int imx274_fwnode_parse(struct device *dev)
1958{
1959 struct fwnode_handle *endpoint;
1960 /* Only CSI2 is supported */
1961 struct v4l2_fwnode_endpoint ep = {
1962 .bus_type = V4L2_MBUS_CSI2_DPHY
1963 };
1964 int ret;
1965
1966 endpoint = fwnode_graph_get_next_endpoint(dev_fwnode(dev), NULL);
1967 if (!endpoint) {
1968 dev_err(dev, "Endpoint node not found\n");
1969 return -EINVAL;
1970 }
1971
1972 ret = v4l2_fwnode_endpoint_parse(fwnode: endpoint, vep: &ep);
1973 fwnode_handle_put(fwnode: endpoint);
1974 if (ret == -ENXIO) {
1975 dev_err(dev, "Unsupported bus type, should be CSI2\n");
1976 return ret;
1977 } else if (ret) {
1978 dev_err(dev, "Parsing endpoint node failed %d\n", ret);
1979 return ret;
1980 }
1981
1982 /* Check number of data lanes, only 4 lanes supported */
1983 if (ep.bus.mipi_csi2.num_data_lanes != 4) {
1984 dev_err(dev, "Invalid data lanes: %d\n",
1985 ep.bus.mipi_csi2.num_data_lanes);
1986 return -EINVAL;
1987 }
1988
1989 return 0;
1990}
1991
1992static int imx274_probe(struct i2c_client *client)
1993{
1994 struct v4l2_subdev *sd;
1995 struct stimx274 *imx274;
1996 struct device *dev = &client->dev;
1997 int ret;
1998
1999 /* initialize imx274 */
2000 imx274 = devm_kzalloc(dev, size: sizeof(*imx274), GFP_KERNEL);
2001 if (!imx274)
2002 return -ENOMEM;
2003
2004 mutex_init(&imx274->lock);
2005
2006 ret = imx274_fwnode_parse(dev);
2007 if (ret)
2008 return ret;
2009
2010 imx274->inck = devm_clk_get_optional(dev, id: "inck");
2011 if (IS_ERR(ptr: imx274->inck))
2012 return PTR_ERR(ptr: imx274->inck);
2013
2014 ret = imx274_regulators_get(dev, imx274);
2015 if (ret) {
2016 dev_err(dev, "Failed to get power regulators, err: %d\n", ret);
2017 return ret;
2018 }
2019
2020 /* initialize format */
2021 imx274->mode = &imx274_modes[0];
2022 imx274->crop.width = IMX274_MAX_WIDTH;
2023 imx274->crop.height = IMX274_MAX_HEIGHT;
2024 imx274->format.width = imx274->crop.width / imx274->mode->wbin_ratio;
2025 imx274->format.height = imx274->crop.height / imx274->mode->hbin_ratio;
2026 imx274->format.field = V4L2_FIELD_NONE;
2027 imx274->format.code = MEDIA_BUS_FMT_SRGGB10_1X10;
2028 imx274->format.colorspace = V4L2_COLORSPACE_SRGB;
2029 imx274->frame_interval.numerator = 1;
2030 imx274->frame_interval.denominator = IMX274_DEF_FRAME_RATE;
2031
2032 /* initialize regmap */
2033 imx274->regmap = devm_regmap_init_i2c(client, &imx274_regmap_config);
2034 if (IS_ERR(ptr: imx274->regmap)) {
2035 dev_err(dev,
2036 "regmap init failed: %ld\n", PTR_ERR(imx274->regmap));
2037 ret = -ENODEV;
2038 goto err_regmap;
2039 }
2040
2041 /* initialize subdevice */
2042 imx274->client = client;
2043 sd = &imx274->sd;
2044 v4l2_i2c_subdev_init(sd, client, ops: &imx274_subdev_ops);
2045 sd->flags |= V4L2_SUBDEV_FL_HAS_DEVNODE | V4L2_SUBDEV_FL_HAS_EVENTS;
2046
2047 /* initialize subdev media pad */
2048 imx274->pad.flags = MEDIA_PAD_FL_SOURCE;
2049 sd->entity.function = MEDIA_ENT_F_CAM_SENSOR;
2050 ret = media_entity_pads_init(entity: &sd->entity, num_pads: 1, pads: &imx274->pad);
2051 if (ret < 0) {
2052 dev_err(dev,
2053 "%s : media entity init Failed %d\n", __func__, ret);
2054 goto err_regmap;
2055 }
2056
2057 /* initialize sensor reset gpio */
2058 imx274->reset_gpio = devm_gpiod_get_optional(dev, con_id: "reset",
2059 flags: GPIOD_OUT_HIGH);
2060 if (IS_ERR(ptr: imx274->reset_gpio)) {
2061 ret = dev_err_probe(dev, err: PTR_ERR(ptr: imx274->reset_gpio),
2062 fmt: "Reset GPIO not setup in DT\n");
2063 goto err_me;
2064 }
2065
2066 /* power on the sensor */
2067 ret = imx274_power_on(dev);
2068 if (ret < 0) {
2069 dev_err(dev, "%s : imx274 power on failed\n", __func__);
2070 goto err_me;
2071 }
2072
2073 /* initialize controls */
2074 ret = v4l2_ctrl_handler_init(&imx274->ctrls.handler, 4);
2075 if (ret < 0) {
2076 dev_err(dev, "%s : ctrl handler init Failed\n", __func__);
2077 goto err_power_off;
2078 }
2079
2080 imx274->ctrls.handler.lock = &imx274->lock;
2081
2082 /* add new controls */
2083 imx274->ctrls.test_pattern = v4l2_ctrl_new_std_menu_items(
2084 hdl: &imx274->ctrls.handler, ops: &imx274_ctrl_ops,
2085 V4L2_CID_TEST_PATTERN,
2086 ARRAY_SIZE(tp_qmenu) - 1, mask: 0, def: 0, qmenu: tp_qmenu);
2087
2088 imx274->ctrls.gain = v4l2_ctrl_new_std(
2089 hdl: &imx274->ctrls.handler,
2090 ops: &imx274_ctrl_ops,
2091 V4L2_CID_GAIN, IMX274_MIN_GAIN,
2092 IMX274_MAX_DIGITAL_GAIN * IMX274_MAX_ANALOG_GAIN, step: 1,
2093 IMX274_DEF_GAIN);
2094
2095 imx274->ctrls.exposure = v4l2_ctrl_new_std(
2096 hdl: &imx274->ctrls.handler,
2097 ops: &imx274_ctrl_ops,
2098 V4L2_CID_EXPOSURE, IMX274_MIN_EXPOSURE_TIME,
2099 max: 1000000 / IMX274_DEF_FRAME_RATE, step: 1,
2100 IMX274_MIN_EXPOSURE_TIME);
2101
2102 imx274->ctrls.vflip = v4l2_ctrl_new_std(
2103 hdl: &imx274->ctrls.handler,
2104 ops: &imx274_ctrl_ops,
2105 V4L2_CID_VFLIP, min: 0, max: 1, step: 1, def: 0);
2106
2107 imx274->sd.ctrl_handler = &imx274->ctrls.handler;
2108 if (imx274->ctrls.handler.error) {
2109 ret = imx274->ctrls.handler.error;
2110 goto err_ctrls;
2111 }
2112
2113 /* load default control values */
2114 imx274_load_default(priv: imx274);
2115
2116 /* register subdevice */
2117 ret = v4l2_async_register_subdev(sd);
2118 if (ret < 0) {
2119 dev_err(dev, "%s : v4l2_async_register_subdev failed %d\n",
2120 __func__, ret);
2121 goto err_ctrls;
2122 }
2123
2124 pm_runtime_set_active(dev);
2125 pm_runtime_enable(dev);
2126 pm_runtime_idle(dev);
2127
2128 dev_info(dev, "imx274 : imx274 probe success !\n");
2129 return 0;
2130
2131err_ctrls:
2132 v4l2_ctrl_handler_free(hdl: &imx274->ctrls.handler);
2133err_power_off:
2134 imx274_power_off(dev);
2135err_me:
2136 media_entity_cleanup(entity: &sd->entity);
2137err_regmap:
2138 mutex_destroy(lock: &imx274->lock);
2139 return ret;
2140}
2141
2142static void imx274_remove(struct i2c_client *client)
2143{
2144 struct v4l2_subdev *sd = i2c_get_clientdata(client);
2145 struct stimx274 *imx274 = to_imx274(sd);
2146
2147 pm_runtime_disable(dev: &client->dev);
2148 if (!pm_runtime_status_suspended(dev: &client->dev))
2149 imx274_power_off(dev: &client->dev);
2150 pm_runtime_set_suspended(dev: &client->dev);
2151
2152 v4l2_async_unregister_subdev(sd);
2153 v4l2_ctrl_handler_free(hdl: &imx274->ctrls.handler);
2154
2155 media_entity_cleanup(entity: &sd->entity);
2156 mutex_destroy(lock: &imx274->lock);
2157}
2158
2159static const struct dev_pm_ops imx274_pm_ops = {
2160 SET_RUNTIME_PM_OPS(imx274_power_off, imx274_power_on, NULL)
2161};
2162
2163static struct i2c_driver imx274_i2c_driver = {
2164 .driver = {
2165 .name = DRIVER_NAME,
2166 .pm = &imx274_pm_ops,
2167 .of_match_table = imx274_of_id_table,
2168 },
2169 .probe = imx274_probe,
2170 .remove = imx274_remove,
2171 .id_table = imx274_id,
2172};
2173
2174module_i2c_driver(imx274_i2c_driver);
2175
2176MODULE_AUTHOR("Leon Luo <leonl@leopardimaging.com>");
2177MODULE_DESCRIPTION("IMX274 CMOS Image Sensor driver");
2178MODULE_LICENSE("GPL v2");
2179

source code of linux/drivers/media/i2c/imx274.c