1// SPDX-License-Identifier: GPL-2.0
2/*
3 * Copyright (C) 2021 Sieć Badawcza Łukasiewicz
4 * - Przemysłowy Instytut Automatyki i Pomiarów PIAP
5 * Written by Krzysztof Hałasa
6 */
7
8#include <linux/clk.h>
9#include <linux/delay.h>
10#include <linux/pm_runtime.h>
11
12#include <media/v4l2-ctrls.h>
13#include <media/v4l2-fwnode.h>
14#include <media/v4l2-subdev.h>
15
16/* External clock (extclk) frequencies */
17#define AR0521_EXTCLK_MIN (10 * 1000 * 1000)
18#define AR0521_EXTCLK_MAX (48 * 1000 * 1000)
19
20/* PLL and PLL2 */
21#define AR0521_PLL_MIN (320 * 1000 * 1000)
22#define AR0521_PLL_MAX (1280 * 1000 * 1000)
23
24/* Effective pixel sample rate on the pixel array. */
25#define AR0521_PIXEL_CLOCK_RATE (184 * 1000 * 1000)
26#define AR0521_PIXEL_CLOCK_MIN (168 * 1000 * 1000)
27#define AR0521_PIXEL_CLOCK_MAX (414 * 1000 * 1000)
28
29#define AR0521_NATIVE_WIDTH 2604u
30#define AR0521_NATIVE_HEIGHT 1964u
31#define AR0521_MIN_X_ADDR_START 0u
32#define AR0521_MIN_Y_ADDR_START 0u
33#define AR0521_MAX_X_ADDR_END 2603u
34#define AR0521_MAX_Y_ADDR_END 1955u
35
36#define AR0521_WIDTH_MIN 8u
37#define AR0521_WIDTH_MAX 2592u
38#define AR0521_HEIGHT_MIN 8u
39#define AR0521_HEIGHT_MAX 1944u
40
41#define AR0521_WIDTH_BLANKING_MIN 572u
42#define AR0521_HEIGHT_BLANKING_MIN 38u /* must be even */
43#define AR0521_TOTAL_HEIGHT_MAX 65535u /* max_frame_length_lines */
44#define AR0521_TOTAL_WIDTH_MAX 65532u /* max_line_length_pck */
45
46#define AR0521_ANA_GAIN_MIN 0x00
47#define AR0521_ANA_GAIN_MAX 0x3f
48#define AR0521_ANA_GAIN_STEP 0x01
49#define AR0521_ANA_GAIN_DEFAULT 0x00
50
51/* AR0521 registers */
52#define AR0521_REG_VT_PIX_CLK_DIV 0x0300
53#define AR0521_REG_FRAME_LENGTH_LINES 0x0340
54
55#define AR0521_REG_CHIP_ID 0x3000
56#define AR0521_REG_COARSE_INTEGRATION_TIME 0x3012
57#define AR0521_REG_ROW_SPEED 0x3016
58#define AR0521_REG_EXTRA_DELAY 0x3018
59#define AR0521_REG_RESET 0x301A
60#define AR0521_REG_RESET_DEFAULTS 0x0238
61#define AR0521_REG_RESET_GROUP_PARAM_HOLD 0x8000
62#define AR0521_REG_RESET_STREAM BIT(2)
63#define AR0521_REG_RESET_RESTART BIT(1)
64#define AR0521_REG_RESET_INIT BIT(0)
65
66#define AR0521_REG_ANA_GAIN_CODE_GLOBAL 0x3028
67
68#define AR0521_REG_GREEN1_GAIN 0x3056
69#define AR0521_REG_BLUE_GAIN 0x3058
70#define AR0521_REG_RED_GAIN 0x305A
71#define AR0521_REG_GREEN2_GAIN 0x305C
72#define AR0521_REG_GLOBAL_GAIN 0x305E
73
74#define AR0521_REG_HISPI_TEST_MODE 0x3066
75#define AR0521_REG_HISPI_TEST_MODE_LP11 0x0004
76
77#define AR0521_REG_TEST_PATTERN_MODE 0x3070
78
79#define AR0521_REG_SERIAL_FORMAT 0x31AE
80#define AR0521_REG_SERIAL_FORMAT_MIPI 0x0200
81
82#define AR0521_REG_HISPI_CONTROL_STATUS 0x31C6
83#define AR0521_REG_HISPI_CONTROL_STATUS_FRAMER_TEST_MODE_ENABLE 0x80
84
85#define be cpu_to_be16
86
87static const char * const ar0521_supply_names[] = {
88 "vdd_io", /* I/O (1.8V) supply */
89 "vdd", /* Core, PLL and MIPI (1.2V) supply */
90 "vaa", /* Analog (2.7V) supply */
91};
92
93static const s64 ar0521_link_frequencies[] = {
94 184000000,
95};
96
97struct ar0521_ctrls {
98 struct v4l2_ctrl_handler handler;
99 struct {
100 struct v4l2_ctrl *gain;
101 struct v4l2_ctrl *red_balance;
102 struct v4l2_ctrl *blue_balance;
103 };
104 struct {
105 struct v4l2_ctrl *hblank;
106 struct v4l2_ctrl *vblank;
107 };
108 struct v4l2_ctrl *pixrate;
109 struct v4l2_ctrl *exposure;
110 struct v4l2_ctrl *test_pattern;
111};
112
113struct ar0521_dev {
114 struct i2c_client *i2c_client;
115 struct v4l2_subdev sd;
116 struct media_pad pad;
117 struct clk *extclk;
118 u32 extclk_freq;
119
120 struct regulator *supplies[ARRAY_SIZE(ar0521_supply_names)];
121 struct gpio_desc *reset_gpio;
122
123 /* lock to protect all members below */
124 struct mutex lock;
125
126 struct v4l2_mbus_framefmt fmt;
127 struct ar0521_ctrls ctrls;
128 unsigned int lane_count;
129 struct {
130 u16 pre;
131 u16 mult;
132 u16 pre2;
133 u16 mult2;
134 u16 vt_pix;
135 } pll;
136};
137
138static inline struct ar0521_dev *to_ar0521_dev(struct v4l2_subdev *sd)
139{
140 return container_of(sd, struct ar0521_dev, sd);
141}
142
143static inline struct v4l2_subdev *ctrl_to_sd(struct v4l2_ctrl *ctrl)
144{
145 return &container_of(ctrl->handler, struct ar0521_dev,
146 ctrls.handler)->sd;
147}
148
149static u32 div64_round(u64 v, u32 d)
150{
151 return div_u64(dividend: v + (d >> 1), divisor: d);
152}
153
154static u32 div64_round_up(u64 v, u32 d)
155{
156 return div_u64(dividend: v + d - 1, divisor: d);
157}
158
159static int ar0521_code_to_bpp(struct ar0521_dev *sensor)
160{
161 switch (sensor->fmt.code) {
162 case MEDIA_BUS_FMT_SGRBG8_1X8:
163 return 8;
164 }
165
166 return -EINVAL;
167}
168
169/* Data must be BE16, the first value is the register address */
170static int ar0521_write_regs(struct ar0521_dev *sensor, const __be16 *data,
171 unsigned int count)
172{
173 struct i2c_client *client = sensor->i2c_client;
174 struct i2c_msg msg;
175 int ret;
176
177 msg.addr = client->addr;
178 msg.flags = client->flags;
179 msg.buf = (u8 *)data;
180 msg.len = count * sizeof(*data);
181
182 ret = i2c_transfer(adap: client->adapter, msgs: &msg, num: 1);
183
184 if (ret < 0) {
185 v4l2_err(&sensor->sd, "%s: I2C write error\n", __func__);
186 return ret;
187 }
188
189 return 0;
190}
191
192static int ar0521_write_reg(struct ar0521_dev *sensor, u16 reg, u16 val)
193{
194 __be16 buf[2] = {be(reg), be(val)};
195
196 return ar0521_write_regs(sensor, data: buf, count: 2);
197}
198
199static int ar0521_set_geometry(struct ar0521_dev *sensor)
200{
201 /* Center the image in the visible output window. */
202 u16 x = clamp((AR0521_WIDTH_MAX - sensor->fmt.width) / 2,
203 AR0521_MIN_X_ADDR_START, AR0521_MAX_X_ADDR_END);
204 u16 y = clamp(((AR0521_HEIGHT_MAX - sensor->fmt.height) / 2) & ~1,
205 AR0521_MIN_Y_ADDR_START, AR0521_MAX_Y_ADDR_END);
206
207 /* All dimensions are unsigned 12-bit integers */
208 __be16 regs[] = {
209 be(AR0521_REG_FRAME_LENGTH_LINES),
210 be(sensor->fmt.height + sensor->ctrls.vblank->val),
211 be(sensor->fmt.width + sensor->ctrls.hblank->val),
212 be(x),
213 be(y),
214 be(x + sensor->fmt.width - 1),
215 be(y + sensor->fmt.height - 1),
216 be(sensor->fmt.width),
217 be(sensor->fmt.height)
218 };
219
220 return ar0521_write_regs(sensor, data: regs, ARRAY_SIZE(regs));
221}
222
223static int ar0521_set_gains(struct ar0521_dev *sensor)
224{
225 int green = sensor->ctrls.gain->val;
226 int red = max(green + sensor->ctrls.red_balance->val, 0);
227 int blue = max(green + sensor->ctrls.blue_balance->val, 0);
228 unsigned int gain = min(red, min(green, blue));
229 unsigned int analog = min(gain, 64u); /* range is 0 - 127 */
230 __be16 regs[5];
231
232 red = min(red - analog + 64, 511u);
233 green = min(green - analog + 64, 511u);
234 blue = min(blue - analog + 64, 511u);
235 regs[0] = be(AR0521_REG_GREEN1_GAIN);
236 regs[1] = be(green << 7 | analog);
237 regs[2] = be(blue << 7 | analog);
238 regs[3] = be(red << 7 | analog);
239 regs[4] = be(green << 7 | analog);
240
241 return ar0521_write_regs(sensor, data: regs, ARRAY_SIZE(regs));
242}
243
244static u32 calc_pll(struct ar0521_dev *sensor, u32 freq, u16 *pre_ptr, u16 *mult_ptr)
245{
246 u16 pre = 1, mult = 1, new_pre;
247 u32 pll = AR0521_PLL_MAX + 1;
248
249 for (new_pre = 1; new_pre < 64; new_pre++) {
250 u32 new_pll;
251 u32 new_mult = div64_round_up(v: (u64)freq * new_pre,
252 d: sensor->extclk_freq);
253
254 if (new_mult < 32)
255 continue; /* Minimum value */
256 if (new_mult > 254)
257 break; /* Maximum, larger pre won't work either */
258 if (sensor->extclk_freq * (u64)new_mult < AR0521_PLL_MIN *
259 new_pre)
260 continue;
261 if (sensor->extclk_freq * (u64)new_mult > AR0521_PLL_MAX *
262 new_pre)
263 break; /* Larger pre won't work either */
264 new_pll = div64_round_up(v: sensor->extclk_freq * (u64)new_mult,
265 d: new_pre);
266 if (new_pll < pll) {
267 pll = new_pll;
268 pre = new_pre;
269 mult = new_mult;
270 }
271 }
272
273 pll = div64_round(v: sensor->extclk_freq * (u64)mult, d: pre);
274 *pre_ptr = pre;
275 *mult_ptr = mult;
276 return pll;
277}
278
279static void ar0521_calc_pll(struct ar0521_dev *sensor)
280{
281 unsigned int pixel_clock;
282 u16 pre, mult;
283 u32 vco;
284 int bpp;
285
286 /*
287 * PLL1 and PLL2 are computed equally even if the application note
288 * suggests a slower PLL1 clock. Maintain pll1 and pll2 divider and
289 * multiplier separated to later specialize the calculation procedure.
290 *
291 * PLL1:
292 * - mclk -> / pre_div1 * pre_mul1 = VCO1 = COUNTER_CLOCK
293 *
294 * PLL2:
295 * - mclk -> / pre_div * pre_mul = VCO
296 *
297 * VCO -> / vt_pix = PIXEL_CLOCK
298 * VCO -> / vt_pix / 2 = WORD_CLOCK
299 * VCO -> / op_sys = SERIAL_CLOCK
300 *
301 * With:
302 * - vt_pix = bpp / 2
303 * - WORD_CLOCK = PIXEL_CLOCK / 2
304 * - SERIAL_CLOCK = MIPI data rate (Mbps / lane) = WORD_CLOCK * bpp
305 * NOTE: this implies the MIPI clock is divided internally by 2
306 * to account for DDR.
307 *
308 * As op_sys_div is fixed to 1:
309 *
310 * SERIAL_CLOCK = VCO
311 * VCO = 2 * MIPI_CLK
312 * VCO = PIXEL_CLOCK * bpp / 2
313 *
314 * In the clock tree:
315 * MIPI_CLK = PIXEL_CLOCK * bpp / 2 / 2
316 *
317 * Generic pixel_rate to bus clock frequency equation:
318 * MIPI_CLK = V4L2_CID_PIXEL_RATE * bpp / lanes / 2
319 *
320 * From which we derive the PIXEL_CLOCK to use in the clock tree:
321 * PIXEL_CLOCK = V4L2_CID_PIXEL_RATE * 2 / lanes
322 *
323 * Documented clock ranges:
324 * WORD_CLOCK = (35MHz - 120 MHz)
325 * PIXEL_CLOCK = (84MHz - 207MHz)
326 * VCO = (320MHz - 1280MHz)
327 *
328 * TODO: in case we have less data lanes we have to reduce the desired
329 * VCO not to exceed the limits specified by the datasheet and
330 * consequently reduce the obtained pixel clock.
331 */
332 pixel_clock = AR0521_PIXEL_CLOCK_RATE * 2 / sensor->lane_count;
333 bpp = ar0521_code_to_bpp(sensor);
334 sensor->pll.vt_pix = bpp / 2;
335 vco = pixel_clock * sensor->pll.vt_pix;
336
337 calc_pll(sensor, freq: vco, pre_ptr: &pre, mult_ptr: &mult);
338
339 sensor->pll.pre = sensor->pll.pre2 = pre;
340 sensor->pll.mult = sensor->pll.mult2 = mult;
341}
342
343static int ar0521_pll_config(struct ar0521_dev *sensor)
344{
345 __be16 pll_regs[] = {
346 be(AR0521_REG_VT_PIX_CLK_DIV),
347 /* 0x300 */ be(sensor->pll.vt_pix), /* vt_pix_clk_div = bpp / 2 */
348 /* 0x302 */ be(1), /* vt_sys_clk_div */
349 /* 0x304 */ be((sensor->pll.pre2 << 8) | sensor->pll.pre),
350 /* 0x306 */ be((sensor->pll.mult2 << 8) | sensor->pll.mult),
351 /* 0x308 */ be(sensor->pll.vt_pix * 2), /* op_pix_clk_div = 2 * vt_pix_clk_div */
352 /* 0x30A */ be(1) /* op_sys_clk_div */
353 };
354
355 ar0521_calc_pll(sensor);
356 return ar0521_write_regs(sensor, data: pll_regs, ARRAY_SIZE(pll_regs));
357}
358
359static int ar0521_set_stream(struct ar0521_dev *sensor, bool on)
360{
361 int ret;
362
363 if (on) {
364 ret = pm_runtime_resume_and_get(dev: &sensor->i2c_client->dev);
365 if (ret < 0)
366 return ret;
367
368 /* Stop streaming for just a moment */
369 ret = ar0521_write_reg(sensor, AR0521_REG_RESET,
370 AR0521_REG_RESET_DEFAULTS);
371 if (ret)
372 return ret;
373
374 ret = ar0521_set_geometry(sensor);
375 if (ret)
376 return ret;
377
378 ret = ar0521_pll_config(sensor);
379 if (ret)
380 goto err;
381
382 ret = __v4l2_ctrl_handler_setup(hdl: &sensor->ctrls.handler);
383 if (ret)
384 goto err;
385
386 /* Exit LP-11 mode on clock and data lanes */
387 ret = ar0521_write_reg(sensor, AR0521_REG_HISPI_CONTROL_STATUS,
388 val: 0);
389 if (ret)
390 goto err;
391
392 /* Start streaming */
393 ret = ar0521_write_reg(sensor, AR0521_REG_RESET,
394 AR0521_REG_RESET_DEFAULTS |
395 AR0521_REG_RESET_STREAM);
396 if (ret)
397 goto err;
398
399 return 0;
400
401err:
402 pm_runtime_put(dev: &sensor->i2c_client->dev);
403 return ret;
404
405 } else {
406 /*
407 * Reset gain, the sensor may produce all white pixels without
408 * this
409 */
410 ret = ar0521_write_reg(sensor, AR0521_REG_GLOBAL_GAIN, val: 0x2000);
411 if (ret)
412 return ret;
413
414 /* Stop streaming */
415 ret = ar0521_write_reg(sensor, AR0521_REG_RESET,
416 AR0521_REG_RESET_DEFAULTS);
417 if (ret)
418 return ret;
419
420 pm_runtime_put(dev: &sensor->i2c_client->dev);
421 return 0;
422 }
423}
424
425static void ar0521_adj_fmt(struct v4l2_mbus_framefmt *fmt)
426{
427 fmt->width = clamp(ALIGN(fmt->width, 4), AR0521_WIDTH_MIN,
428 AR0521_WIDTH_MAX);
429 fmt->height = clamp(ALIGN(fmt->height, 4), AR0521_HEIGHT_MIN,
430 AR0521_HEIGHT_MAX);
431 fmt->code = MEDIA_BUS_FMT_SGRBG8_1X8;
432 fmt->field = V4L2_FIELD_NONE;
433 fmt->colorspace = V4L2_COLORSPACE_SRGB;
434 fmt->ycbcr_enc = V4L2_YCBCR_ENC_DEFAULT;
435 fmt->quantization = V4L2_QUANTIZATION_FULL_RANGE;
436 fmt->xfer_func = V4L2_XFER_FUNC_DEFAULT;
437}
438
439static int ar0521_get_fmt(struct v4l2_subdev *sd,
440 struct v4l2_subdev_state *sd_state,
441 struct v4l2_subdev_format *format)
442{
443 struct ar0521_dev *sensor = to_ar0521_dev(sd);
444 struct v4l2_mbus_framefmt *fmt;
445
446 mutex_lock(&sensor->lock);
447
448 if (format->which == V4L2_SUBDEV_FORMAT_TRY)
449 fmt = v4l2_subdev_state_get_format(sd_state, 0);
450 else
451 fmt = &sensor->fmt;
452
453 format->format = *fmt;
454
455 mutex_unlock(lock: &sensor->lock);
456 return 0;
457}
458
459static int ar0521_set_fmt(struct v4l2_subdev *sd,
460 struct v4l2_subdev_state *sd_state,
461 struct v4l2_subdev_format *format)
462{
463 struct ar0521_dev *sensor = to_ar0521_dev(sd);
464 int max_vblank, max_hblank, exposure_max;
465 int ret;
466
467 ar0521_adj_fmt(fmt: &format->format);
468
469 mutex_lock(&sensor->lock);
470
471 if (format->which == V4L2_SUBDEV_FORMAT_TRY) {
472 struct v4l2_mbus_framefmt *fmt;
473
474 fmt = v4l2_subdev_state_get_format(sd_state, 0);
475 *fmt = format->format;
476
477 mutex_unlock(lock: &sensor->lock);
478
479 return 0;
480 }
481
482 sensor->fmt = format->format;
483 ar0521_calc_pll(sensor);
484
485 /*
486 * Update the exposure and blankings limits. Blankings are also reset
487 * to the minimum.
488 */
489 max_hblank = AR0521_TOTAL_WIDTH_MAX - sensor->fmt.width;
490 ret = __v4l2_ctrl_modify_range(ctrl: sensor->ctrls.hblank,
491 min: sensor->ctrls.hblank->minimum,
492 max: max_hblank, step: sensor->ctrls.hblank->step,
493 def: sensor->ctrls.hblank->minimum);
494 if (ret)
495 goto unlock;
496
497 ret = __v4l2_ctrl_s_ctrl(ctrl: sensor->ctrls.hblank,
498 val: sensor->ctrls.hblank->minimum);
499 if (ret)
500 goto unlock;
501
502 max_vblank = AR0521_TOTAL_HEIGHT_MAX - sensor->fmt.height;
503 ret = __v4l2_ctrl_modify_range(ctrl: sensor->ctrls.vblank,
504 min: sensor->ctrls.vblank->minimum,
505 max: max_vblank, step: sensor->ctrls.vblank->step,
506 def: sensor->ctrls.vblank->minimum);
507 if (ret)
508 goto unlock;
509
510 ret = __v4l2_ctrl_s_ctrl(ctrl: sensor->ctrls.vblank,
511 val: sensor->ctrls.vblank->minimum);
512 if (ret)
513 goto unlock;
514
515 exposure_max = sensor->fmt.height + AR0521_HEIGHT_BLANKING_MIN - 4;
516 ret = __v4l2_ctrl_modify_range(ctrl: sensor->ctrls.exposure,
517 min: sensor->ctrls.exposure->minimum,
518 max: exposure_max,
519 step: sensor->ctrls.exposure->step,
520 def: sensor->ctrls.exposure->default_value);
521unlock:
522 mutex_unlock(lock: &sensor->lock);
523
524 return ret;
525}
526
527static int ar0521_s_ctrl(struct v4l2_ctrl *ctrl)
528{
529 struct v4l2_subdev *sd = ctrl_to_sd(ctrl);
530 struct ar0521_dev *sensor = to_ar0521_dev(sd);
531 int exp_max;
532 int ret;
533
534 /* v4l2_ctrl_lock() locks our own mutex */
535
536 switch (ctrl->id) {
537 case V4L2_CID_VBLANK:
538 exp_max = sensor->fmt.height + ctrl->val - 4;
539 __v4l2_ctrl_modify_range(ctrl: sensor->ctrls.exposure,
540 min: sensor->ctrls.exposure->minimum,
541 max: exp_max, step: sensor->ctrls.exposure->step,
542 def: sensor->ctrls.exposure->default_value);
543 break;
544 }
545
546 /* access the sensor only if it's powered up */
547 if (!pm_runtime_get_if_in_use(dev: &sensor->i2c_client->dev))
548 return 0;
549
550 switch (ctrl->id) {
551 case V4L2_CID_HBLANK:
552 case V4L2_CID_VBLANK:
553 ret = ar0521_set_geometry(sensor);
554 break;
555 case V4L2_CID_ANALOGUE_GAIN:
556 ret = ar0521_write_reg(sensor, AR0521_REG_ANA_GAIN_CODE_GLOBAL,
557 val: ctrl->val);
558 break;
559 case V4L2_CID_GAIN:
560 case V4L2_CID_RED_BALANCE:
561 case V4L2_CID_BLUE_BALANCE:
562 ret = ar0521_set_gains(sensor);
563 break;
564 case V4L2_CID_EXPOSURE:
565 ret = ar0521_write_reg(sensor,
566 AR0521_REG_COARSE_INTEGRATION_TIME,
567 val: ctrl->val);
568 break;
569 case V4L2_CID_TEST_PATTERN:
570 ret = ar0521_write_reg(sensor, AR0521_REG_TEST_PATTERN_MODE,
571 val: ctrl->val);
572 break;
573 default:
574 dev_err(&sensor->i2c_client->dev,
575 "Unsupported control %x\n", ctrl->id);
576 ret = -EINVAL;
577 break;
578 }
579
580 pm_runtime_put(dev: &sensor->i2c_client->dev);
581 return ret;
582}
583
584static const struct v4l2_ctrl_ops ar0521_ctrl_ops = {
585 .s_ctrl = ar0521_s_ctrl,
586};
587
588static const char * const test_pattern_menu[] = {
589 "Disabled",
590 "Solid color",
591 "Color bars",
592 "Faded color bars"
593};
594
595static int ar0521_init_controls(struct ar0521_dev *sensor)
596{
597 const struct v4l2_ctrl_ops *ops = &ar0521_ctrl_ops;
598 struct ar0521_ctrls *ctrls = &sensor->ctrls;
599 struct v4l2_ctrl_handler *hdl = &ctrls->handler;
600 int max_vblank, max_hblank, exposure_max;
601 struct v4l2_ctrl *link_freq;
602 int ret;
603
604 v4l2_ctrl_handler_init(hdl, 32);
605
606 /* We can use our own mutex for the ctrl lock */
607 hdl->lock = &sensor->lock;
608
609 /* Analog gain */
610 v4l2_ctrl_new_std(hdl, ops, V4L2_CID_ANALOGUE_GAIN,
611 AR0521_ANA_GAIN_MIN, AR0521_ANA_GAIN_MAX,
612 AR0521_ANA_GAIN_STEP, AR0521_ANA_GAIN_DEFAULT);
613
614 /* Manual gain */
615 ctrls->gain = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_GAIN, min: 0, max: 511, step: 1, def: 0);
616 ctrls->red_balance = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_RED_BALANCE,
617 min: -512, max: 511, step: 1, def: 0);
618 ctrls->blue_balance = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_BLUE_BALANCE,
619 min: -512, max: 511, step: 1, def: 0);
620 v4l2_ctrl_cluster(ncontrols: 3, controls: &ctrls->gain);
621
622 /* Initialize blanking limits using the default 2592x1944 format. */
623 max_hblank = AR0521_TOTAL_WIDTH_MAX - AR0521_WIDTH_MAX;
624 ctrls->hblank = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_HBLANK,
625 AR0521_WIDTH_BLANKING_MIN,
626 max: max_hblank, step: 1,
627 AR0521_WIDTH_BLANKING_MIN);
628
629 max_vblank = AR0521_TOTAL_HEIGHT_MAX - AR0521_HEIGHT_MAX;
630 ctrls->vblank = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_VBLANK,
631 AR0521_HEIGHT_BLANKING_MIN,
632 max: max_vblank, step: 2,
633 AR0521_HEIGHT_BLANKING_MIN);
634 v4l2_ctrl_cluster(ncontrols: 2, controls: &ctrls->hblank);
635
636 /* Read-only */
637 ctrls->pixrate = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_PIXEL_RATE,
638 AR0521_PIXEL_CLOCK_MIN,
639 AR0521_PIXEL_CLOCK_MAX, step: 1,
640 AR0521_PIXEL_CLOCK_RATE);
641
642 /* Manual exposure time: max exposure time = visible + blank - 4 */
643 exposure_max = AR0521_HEIGHT_MAX + AR0521_HEIGHT_BLANKING_MIN - 4;
644 ctrls->exposure = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_EXPOSURE, min: 0,
645 max: exposure_max, step: 1, def: 0x70);
646
647 link_freq = v4l2_ctrl_new_int_menu(hdl, ops, V4L2_CID_LINK_FREQ,
648 ARRAY_SIZE(ar0521_link_frequencies) - 1,
649 def: 0, qmenu_int: ar0521_link_frequencies);
650 if (link_freq)
651 link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY;
652
653 ctrls->test_pattern = v4l2_ctrl_new_std_menu_items(hdl, ops,
654 V4L2_CID_TEST_PATTERN,
655 ARRAY_SIZE(test_pattern_menu) - 1,
656 mask: 0, def: 0, qmenu: test_pattern_menu);
657
658 if (hdl->error) {
659 ret = hdl->error;
660 goto free_ctrls;
661 }
662
663 sensor->sd.ctrl_handler = hdl;
664 return 0;
665
666free_ctrls:
667 v4l2_ctrl_handler_free(hdl);
668 return ret;
669}
670
671#define REGS_ENTRY(a) {(a), ARRAY_SIZE(a)}
672#define REGS(...) REGS_ENTRY(((const __be16[]){__VA_ARGS__}))
673
674static const struct initial_reg {
675 const __be16 *data; /* data[0] is register address */
676 unsigned int count;
677} initial_regs[] = {
678 REGS(be(0x0112), be(0x0808)), /* 8-bit/8-bit mode */
679
680 /* PEDESTAL+2 :+2 is a workaround for 10bit mode +0.5 rounding */
681 REGS(be(0x301E), be(0x00AA)),
682
683 /* corrections_recommended_bayer */
684 REGS(be(0x3042),
685 be(0x0004), /* 3042: RNC: enable b/w rnc mode */
686 be(0x4580)), /* 3044: RNC: enable row noise correction */
687
688 REGS(be(0x30D2),
689 be(0x0000), /* 30D2: CRM/CC: enable crm on Visible and CC rows */
690 be(0x0000), /* 30D4: CC: CC enabled with 16 samples per column */
691 /* 30D6: CC: bw mode enabled/12 bit data resolution/bw mode */
692 be(0x2FFF)),
693
694 REGS(be(0x30DA),
695 be(0x0FFF), /* 30DA: CC: column correction clip level 2 is 0 */
696 be(0x0FFF), /* 30DC: CC: column correction clip level 3 is 0 */
697 be(0x0000)), /* 30DE: CC: Group FPN correction */
698
699 /* RNC: rnc scaling factor = * 54 / 64 (32 / 38 * 64 = 53.9) */
700 REGS(be(0x30EE), be(0x1136)),
701 REGS(be(0x30FA), be(0xFD00)), /* GPIO0 = flash, GPIO1 = shutter */
702 REGS(be(0x3120), be(0x0005)), /* p1 dither enabled for 10bit mode */
703 REGS(be(0x3172), be(0x0206)), /* txlo clk divider options */
704 /* FDOC:fdoc settings with fdoc every frame turned of */
705 REGS(be(0x3180), be(0x9434)),
706
707 REGS(be(0x31B0),
708 be(0x008B), /* 31B0: frame_preamble - FIXME check WRT lanes# */
709 be(0x0050)), /* 31B2: line_preamble - FIXME check WRT lanes# */
710
711 /* don't use continuous clock mode while shut down */
712 REGS(be(0x31BC), be(0x068C)),
713 REGS(be(0x31E0), be(0x0781)), /* Fuse/2DDC: enable 2ddc */
714
715 /* analog_setup_recommended_10bit */
716 REGS(be(0x341A), be(0x4735)), /* Samp&Hold pulse in ADC */
717 REGS(be(0x3420), be(0x4735)), /* Samp&Hold pulse in ADC */
718 REGS(be(0x3426), be(0x8A1A)), /* ADC offset distribution pulse */
719 REGS(be(0x342A), be(0x0018)), /* pulse_config */
720
721 /* pixel_timing_recommended */
722 REGS(be(0x3D00),
723 /* 3D00 */ be(0x043E), be(0x4760), be(0xFFFF), be(0xFFFF),
724 /* 3D08 */ be(0x8000), be(0x0510), be(0xAF08), be(0x0252),
725 /* 3D10 */ be(0x486F), be(0x5D5D), be(0x8056), be(0x8313),
726 /* 3D18 */ be(0x0087), be(0x6A48), be(0x6982), be(0x0280),
727 /* 3D20 */ be(0x8359), be(0x8D02), be(0x8020), be(0x4882),
728 /* 3D28 */ be(0x4269), be(0x6A95), be(0x5988), be(0x5A83),
729 /* 3D30 */ be(0x5885), be(0x6280), be(0x6289), be(0x6097),
730 /* 3D38 */ be(0x5782), be(0x605C), be(0xBF18), be(0x0961),
731 /* 3D40 */ be(0x5080), be(0x2090), be(0x4390), be(0x4382),
732 /* 3D48 */ be(0x5F8A), be(0x5D5D), be(0x9C63), be(0x8063),
733 /* 3D50 */ be(0xA960), be(0x9757), be(0x8260), be(0x5CFF),
734 /* 3D58 */ be(0xBF10), be(0x1681), be(0x0802), be(0x8000),
735 /* 3D60 */ be(0x141C), be(0x6000), be(0x6022), be(0x4D80),
736 /* 3D68 */ be(0x5C97), be(0x6A69), be(0xAC6F), be(0x4645),
737 /* 3D70 */ be(0x4400), be(0x0513), be(0x8069), be(0x6AC6),
738 /* 3D78 */ be(0x5F95), be(0x5F70), be(0x8040), be(0x4A81),
739 /* 3D80 */ be(0x0300), be(0xE703), be(0x0088), be(0x4A83),
740 /* 3D88 */ be(0x40FF), be(0xFFFF), be(0xFD70), be(0x8040),
741 /* 3D90 */ be(0x4A85), be(0x4FA8), be(0x4F8C), be(0x0070),
742 /* 3D98 */ be(0xBE47), be(0x8847), be(0xBC78), be(0x6B89),
743 /* 3DA0 */ be(0x6A80), be(0x6986), be(0x6B8E), be(0x6B80),
744 /* 3DA8 */ be(0x6980), be(0x6A88), be(0x7C9F), be(0x866B),
745 /* 3DB0 */ be(0x8765), be(0x46FF), be(0xE365), be(0xA679),
746 /* 3DB8 */ be(0x4A40), be(0x4580), be(0x44BC), be(0x7000),
747 /* 3DC0 */ be(0x8040), be(0x0802), be(0x10EF), be(0x0104),
748 /* 3DC8 */ be(0x3860), be(0x5D5D), be(0x5682), be(0x1300),
749 /* 3DD0 */ be(0x8648), be(0x8202), be(0x8082), be(0x598A),
750 /* 3DD8 */ be(0x0280), be(0x2048), be(0x3060), be(0x8042),
751 /* 3DE0 */ be(0x9259), be(0x865A), be(0x8258), be(0x8562),
752 /* 3DE8 */ be(0x8062), be(0x8560), be(0x9257), be(0x8221),
753 /* 3DF0 */ be(0x10FF), be(0xB757), be(0x9361), be(0x1019),
754 /* 3DF8 */ be(0x8020), be(0x9043), be(0x8E43), be(0x845F),
755 /* 3E00 */ be(0x835D), be(0x805D), be(0x8163), be(0x8063),
756 /* 3E08 */ be(0xA060), be(0x9157), be(0x8260), be(0x5CFF),
757 /* 3E10 */ be(0xFFFF), be(0xFFE5), be(0x1016), be(0x2048),
758 /* 3E18 */ be(0x0802), be(0x1C60), be(0x0014), be(0x0060),
759 /* 3E20 */ be(0x2205), be(0x8120), be(0x908F), be(0x6A80),
760 /* 3E28 */ be(0x6982), be(0x5F9F), be(0x6F46), be(0x4544),
761 /* 3E30 */ be(0x0005), be(0x8013), be(0x8069), be(0x6A80),
762 /* 3E38 */ be(0x7000), be(0x0000), be(0x0000), be(0x0000),
763 /* 3E40 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
764 /* 3E48 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
765 /* 3E50 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
766 /* 3E58 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
767 /* 3E60 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
768 /* 3E68 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
769 /* 3E70 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
770 /* 3E78 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
771 /* 3E80 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
772 /* 3E88 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
773 /* 3E90 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
774 /* 3E98 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
775 /* 3EA0 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
776 /* 3EA8 */ be(0x0000), be(0x0000), be(0x0000), be(0x0000),
777 /* 3EB0 */ be(0x0000), be(0x0000), be(0x0000)),
778
779 REGS(be(0x3EB6), be(0x004C)), /* ECL */
780
781 REGS(be(0x3EBA),
782 be(0xAAAD), /* 3EBA */
783 be(0x0086)), /* 3EBC: Bias currents for FSC/ECL */
784
785 REGS(be(0x3EC0),
786 be(0x1E00), /* 3EC0: SFbin/SH mode settings */
787 be(0x100A), /* 3EC2: CLK divider for ramp for 10 bit 400MH */
788 /* 3EC4: FSC clamps for HDR mode and adc comp power down co */
789 be(0x3300),
790 be(0xEA44), /* 3EC6: VLN and clk gating controls */
791 be(0x6F6F), /* 3EC8: Txl0 and Txlo1 settings for normal mode */
792 be(0x2F4A), /* 3ECA: CDAC/Txlo2/RSTGHI/RSTGLO settings */
793 be(0x0506), /* 3ECC: RSTDHI/RSTDLO/CDAC/TXHI settings */
794 /* 3ECE: Ramp buffer settings and Booster enable (bits 0-5) */
795 be(0x203B),
796 be(0x13F0), /* 3ED0: TXLO from atest/sf bin settings */
797 be(0xA53D), /* 3ED2: Ramp offset */
798 be(0x862F), /* 3ED4: TXLO open loop/row driver settings */
799 be(0x4081), /* 3ED6: Txlatch fr cfpn rows/vln bias */
800 be(0x8003), /* 3ED8: Ramp step setting for 10 bit 400 Mhz */
801 be(0xA580), /* 3EDA: Ramp Offset */
802 be(0xC000), /* 3EDC: over range for rst and under range for sig */
803 be(0xC103)), /* 3EDE: over range for sig and col dec clk settings */
804
805 /* corrections_recommended_bayer */
806 REGS(be(0x3F00),
807 be(0x0017), /* 3F00: BM_T0 */
808 be(0x02DD), /* 3F02: BM_T1 */
809 /* 3F04: if Ana_gain less than 2, use noise_floor0, multiply */
810 be(0x0020),
811 /* 3F06: if Ana_gain between 4 and 7, use noise_floor2 and */
812 be(0x0040),
813 /* 3F08: if Ana_gain between 4 and 7, use noise_floor2 and */
814 be(0x0070),
815 /* 3F0A: Define noise_floor0(low address) and noise_floor1 */
816 be(0x0101),
817 be(0x0302)), /* 3F0C: Define noise_floor2 and noise_floor3 */
818
819 REGS(be(0x3F10),
820 be(0x0505), /* 3F10: single k factor 0 */
821 be(0x0505), /* 3F12: single k factor 1 */
822 be(0x0505), /* 3F14: single k factor 2 */
823 be(0x01FF), /* 3F16: cross factor 0 */
824 be(0x01FF), /* 3F18: cross factor 1 */
825 be(0x01FF), /* 3F1A: cross factor 2 */
826 be(0x0022)), /* 3F1E */
827
828 /* GTH_THRES_RTN: 4max,4min filtered out of every 46 samples and */
829 REGS(be(0x3F2C), be(0x442E)),
830
831 REGS(be(0x3F3E),
832 be(0x0000), /* 3F3E: Switch ADC from 12 bit to 10 bit mode */
833 be(0x1511), /* 3F40: couple k factor 0 */
834 be(0x1511), /* 3F42: couple k factor 1 */
835 be(0x0707)), /* 3F44: couple k factor 2 */
836};
837
838static int ar0521_power_off(struct device *dev)
839{
840 struct v4l2_subdev *sd = dev_get_drvdata(dev);
841 struct ar0521_dev *sensor = to_ar0521_dev(sd);
842 int i;
843
844 clk_disable_unprepare(clk: sensor->extclk);
845
846 if (sensor->reset_gpio)
847 gpiod_set_value(desc: sensor->reset_gpio, value: 1); /* assert RESET signal */
848
849 for (i = ARRAY_SIZE(ar0521_supply_names) - 1; i >= 0; i--) {
850 if (sensor->supplies[i])
851 regulator_disable(regulator: sensor->supplies[i]);
852 }
853 return 0;
854}
855
856static int ar0521_power_on(struct device *dev)
857{
858 struct v4l2_subdev *sd = dev_get_drvdata(dev);
859 struct ar0521_dev *sensor = to_ar0521_dev(sd);
860 unsigned int cnt;
861 int ret;
862
863 for (cnt = 0; cnt < ARRAY_SIZE(ar0521_supply_names); cnt++)
864 if (sensor->supplies[cnt]) {
865 ret = regulator_enable(regulator: sensor->supplies[cnt]);
866 if (ret < 0)
867 goto off;
868
869 usleep_range(min: 1000, max: 1500); /* min 1 ms */
870 }
871
872 ret = clk_prepare_enable(clk: sensor->extclk);
873 if (ret < 0) {
874 v4l2_err(&sensor->sd, "error enabling sensor clock\n");
875 goto off;
876 }
877 usleep_range(min: 1000, max: 1500); /* min 1 ms */
878
879 if (sensor->reset_gpio)
880 /* deassert RESET signal */
881 gpiod_set_value(desc: sensor->reset_gpio, value: 0);
882 usleep_range(min: 4500, max: 5000); /* min 45000 clocks */
883
884 for (cnt = 0; cnt < ARRAY_SIZE(initial_regs); cnt++) {
885 ret = ar0521_write_regs(sensor, data: initial_regs[cnt].data,
886 count: initial_regs[cnt].count);
887 if (ret)
888 goto off;
889 }
890
891 ret = ar0521_write_reg(sensor, AR0521_REG_SERIAL_FORMAT,
892 AR0521_REG_SERIAL_FORMAT_MIPI |
893 sensor->lane_count);
894 if (ret)
895 goto off;
896
897 /* set MIPI test mode - disabled for now */
898 ret = ar0521_write_reg(sensor, AR0521_REG_HISPI_TEST_MODE,
899 val: ((0x40 << sensor->lane_count) - 0x40) |
900 AR0521_REG_HISPI_TEST_MODE_LP11);
901 if (ret)
902 goto off;
903
904 ret = ar0521_write_reg(sensor, AR0521_REG_ROW_SPEED, val: 0x110 |
905 4 / sensor->lane_count);
906 if (ret)
907 goto off;
908
909 return 0;
910off:
911 ar0521_power_off(dev);
912 return ret;
913}
914
915static int ar0521_enum_mbus_code(struct v4l2_subdev *sd,
916 struct v4l2_subdev_state *sd_state,
917 struct v4l2_subdev_mbus_code_enum *code)
918{
919 struct ar0521_dev *sensor = to_ar0521_dev(sd);
920
921 if (code->index)
922 return -EINVAL;
923
924 code->code = sensor->fmt.code;
925 return 0;
926}
927
928static int ar0521_enum_frame_size(struct v4l2_subdev *sd,
929 struct v4l2_subdev_state *sd_state,
930 struct v4l2_subdev_frame_size_enum *fse)
931{
932 if (fse->index)
933 return -EINVAL;
934
935 if (fse->code != MEDIA_BUS_FMT_SGRBG8_1X8)
936 return -EINVAL;
937
938 fse->min_width = AR0521_WIDTH_MIN;
939 fse->max_width = AR0521_WIDTH_MAX;
940 fse->min_height = AR0521_HEIGHT_MIN;
941 fse->max_height = AR0521_HEIGHT_MAX;
942
943 return 0;
944}
945
946static int ar0521_pre_streamon(struct v4l2_subdev *sd, u32 flags)
947{
948 struct ar0521_dev *sensor = to_ar0521_dev(sd);
949 int ret;
950
951 if (!(flags & V4L2_SUBDEV_PRE_STREAMON_FL_MANUAL_LP))
952 return -EACCES;
953
954 ret = pm_runtime_resume_and_get(dev: &sensor->i2c_client->dev);
955 if (ret < 0)
956 return ret;
957
958 /* Set LP-11 on clock and data lanes */
959 ret = ar0521_write_reg(sensor, AR0521_REG_HISPI_CONTROL_STATUS,
960 AR0521_REG_HISPI_CONTROL_STATUS_FRAMER_TEST_MODE_ENABLE);
961 if (ret)
962 goto err;
963
964 /* Start streaming LP-11 */
965 ret = ar0521_write_reg(sensor, AR0521_REG_RESET,
966 AR0521_REG_RESET_DEFAULTS |
967 AR0521_REG_RESET_STREAM);
968 if (ret)
969 goto err;
970 return 0;
971
972err:
973 pm_runtime_put(dev: &sensor->i2c_client->dev);
974 return ret;
975}
976
977static int ar0521_post_streamoff(struct v4l2_subdev *sd)
978{
979 struct ar0521_dev *sensor = to_ar0521_dev(sd);
980
981 pm_runtime_put(dev: &sensor->i2c_client->dev);
982 return 0;
983}
984
985static int ar0521_s_stream(struct v4l2_subdev *sd, int enable)
986{
987 struct ar0521_dev *sensor = to_ar0521_dev(sd);
988 int ret;
989
990 mutex_lock(&sensor->lock);
991 ret = ar0521_set_stream(sensor, on: enable);
992 mutex_unlock(lock: &sensor->lock);
993
994 return ret;
995}
996
997static const struct v4l2_subdev_core_ops ar0521_core_ops = {
998 .log_status = v4l2_ctrl_subdev_log_status,
999};
1000
1001static const struct v4l2_subdev_video_ops ar0521_video_ops = {
1002 .s_stream = ar0521_s_stream,
1003 .pre_streamon = ar0521_pre_streamon,
1004 .post_streamoff = ar0521_post_streamoff,
1005};
1006
1007static const struct v4l2_subdev_pad_ops ar0521_pad_ops = {
1008 .enum_mbus_code = ar0521_enum_mbus_code,
1009 .enum_frame_size = ar0521_enum_frame_size,
1010 .get_fmt = ar0521_get_fmt,
1011 .set_fmt = ar0521_set_fmt,
1012};
1013
1014static const struct v4l2_subdev_ops ar0521_subdev_ops = {
1015 .core = &ar0521_core_ops,
1016 .video = &ar0521_video_ops,
1017 .pad = &ar0521_pad_ops,
1018};
1019
1020static int ar0521_probe(struct i2c_client *client)
1021{
1022 struct v4l2_fwnode_endpoint ep = {
1023 .bus_type = V4L2_MBUS_CSI2_DPHY
1024 };
1025 struct device *dev = &client->dev;
1026 struct fwnode_handle *endpoint;
1027 struct ar0521_dev *sensor;
1028 unsigned int cnt;
1029 int ret;
1030
1031 sensor = devm_kzalloc(dev, size: sizeof(*sensor), GFP_KERNEL);
1032 if (!sensor)
1033 return -ENOMEM;
1034
1035 sensor->i2c_client = client;
1036 sensor->fmt.width = AR0521_WIDTH_MAX;
1037 sensor->fmt.height = AR0521_HEIGHT_MAX;
1038
1039 endpoint = fwnode_graph_get_endpoint_by_id(dev_fwnode(dev), port: 0, endpoint: 0,
1040 FWNODE_GRAPH_ENDPOINT_NEXT);
1041 if (!endpoint) {
1042 dev_err(dev, "endpoint node not found\n");
1043 return -EINVAL;
1044 }
1045
1046 ret = v4l2_fwnode_endpoint_parse(fwnode: endpoint, vep: &ep);
1047 fwnode_handle_put(fwnode: endpoint);
1048 if (ret) {
1049 dev_err(dev, "could not parse endpoint\n");
1050 return ret;
1051 }
1052
1053 if (ep.bus_type != V4L2_MBUS_CSI2_DPHY) {
1054 dev_err(dev, "invalid bus type, must be MIPI CSI2\n");
1055 return -EINVAL;
1056 }
1057
1058 sensor->lane_count = ep.bus.mipi_csi2.num_data_lanes;
1059 switch (sensor->lane_count) {
1060 case 1:
1061 case 2:
1062 case 4:
1063 break;
1064 default:
1065 dev_err(dev, "invalid number of MIPI data lanes\n");
1066 return -EINVAL;
1067 }
1068
1069 /* Get master clock (extclk) */
1070 sensor->extclk = devm_clk_get(dev, id: "extclk");
1071 if (IS_ERR(ptr: sensor->extclk)) {
1072 dev_err(dev, "failed to get extclk\n");
1073 return PTR_ERR(ptr: sensor->extclk);
1074 }
1075
1076 sensor->extclk_freq = clk_get_rate(clk: sensor->extclk);
1077
1078 if (sensor->extclk_freq < AR0521_EXTCLK_MIN ||
1079 sensor->extclk_freq > AR0521_EXTCLK_MAX) {
1080 dev_err(dev, "extclk frequency out of range: %u Hz\n",
1081 sensor->extclk_freq);
1082 return -EINVAL;
1083 }
1084
1085 /* Request optional reset pin (usually active low) and assert it */
1086 sensor->reset_gpio = devm_gpiod_get_optional(dev, con_id: "reset",
1087 flags: GPIOD_OUT_HIGH);
1088
1089 v4l2_i2c_subdev_init(sd: &sensor->sd, client, ops: &ar0521_subdev_ops);
1090
1091 sensor->sd.flags = V4L2_SUBDEV_FL_HAS_DEVNODE;
1092 sensor->pad.flags = MEDIA_PAD_FL_SOURCE;
1093 sensor->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
1094 ret = media_entity_pads_init(entity: &sensor->sd.entity, num_pads: 1, pads: &sensor->pad);
1095 if (ret)
1096 return ret;
1097
1098 for (cnt = 0; cnt < ARRAY_SIZE(ar0521_supply_names); cnt++) {
1099 struct regulator *supply = devm_regulator_get(dev,
1100 id: ar0521_supply_names[cnt]);
1101
1102 if (IS_ERR(ptr: supply)) {
1103 dev_info(dev, "no %s regulator found: %li\n",
1104 ar0521_supply_names[cnt], PTR_ERR(supply));
1105 return PTR_ERR(ptr: supply);
1106 }
1107 sensor->supplies[cnt] = supply;
1108 }
1109
1110 mutex_init(&sensor->lock);
1111
1112 ret = ar0521_init_controls(sensor);
1113 if (ret)
1114 goto entity_cleanup;
1115
1116 ar0521_adj_fmt(fmt: &sensor->fmt);
1117
1118 ret = v4l2_async_register_subdev(sd: &sensor->sd);
1119 if (ret)
1120 goto free_ctrls;
1121
1122 /* Turn on the device and enable runtime PM */
1123 ret = ar0521_power_on(dev: &client->dev);
1124 if (ret)
1125 goto disable;
1126 pm_runtime_set_active(dev: &client->dev);
1127 pm_runtime_enable(dev: &client->dev);
1128 pm_runtime_idle(dev: &client->dev);
1129 return 0;
1130
1131disable:
1132 v4l2_async_unregister_subdev(sd: &sensor->sd);
1133 media_entity_cleanup(entity: &sensor->sd.entity);
1134free_ctrls:
1135 v4l2_ctrl_handler_free(hdl: &sensor->ctrls.handler);
1136entity_cleanup:
1137 media_entity_cleanup(entity: &sensor->sd.entity);
1138 mutex_destroy(lock: &sensor->lock);
1139 return ret;
1140}
1141
1142static void ar0521_remove(struct i2c_client *client)
1143{
1144 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1145 struct ar0521_dev *sensor = to_ar0521_dev(sd);
1146
1147 v4l2_async_unregister_subdev(sd: &sensor->sd);
1148 media_entity_cleanup(entity: &sensor->sd.entity);
1149 v4l2_ctrl_handler_free(hdl: &sensor->ctrls.handler);
1150 pm_runtime_disable(dev: &client->dev);
1151 if (!pm_runtime_status_suspended(dev: &client->dev))
1152 ar0521_power_off(dev: &client->dev);
1153 pm_runtime_set_suspended(dev: &client->dev);
1154 mutex_destroy(lock: &sensor->lock);
1155}
1156
1157static const struct dev_pm_ops ar0521_pm_ops = {
1158 SET_RUNTIME_PM_OPS(ar0521_power_off, ar0521_power_on, NULL)
1159};
1160static const struct of_device_id ar0521_dt_ids[] = {
1161 {.compatible = "onnn,ar0521"},
1162 {}
1163};
1164MODULE_DEVICE_TABLE(of, ar0521_dt_ids);
1165
1166static struct i2c_driver ar0521_i2c_driver = {
1167 .driver = {
1168 .name = "ar0521",
1169 .pm = &ar0521_pm_ops,
1170 .of_match_table = ar0521_dt_ids,
1171 },
1172 .probe = ar0521_probe,
1173 .remove = ar0521_remove,
1174};
1175
1176module_i2c_driver(ar0521_i2c_driver);
1177
1178MODULE_DESCRIPTION("AR0521 MIPI Camera subdev driver");
1179MODULE_AUTHOR("Krzysztof Hałasa <khalasa@piap.pl>");
1180MODULE_LICENSE("GPL");
1181

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