treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / drivers / media / i2c / hi556.c
blobc66cd1446c0fd752529ed624057b0924946570dd
1 // SPDX-License-Identifier: GPL-2.0
2 // Copyright (c) 2019 Intel Corporation.
4 #include <asm/unaligned.h>
5 #include <linux/acpi.h>
6 #include <linux/delay.h>
7 #include <linux/i2c.h>
8 #include <linux/module.h>
9 #include <linux/pm_runtime.h>
10 #include <media/v4l2-ctrls.h>
11 #include <media/v4l2-device.h>
12 #include <media/v4l2-fwnode.h>
14 #define HI556_REG_VALUE_08BIT 1
15 #define HI556_REG_VALUE_16BIT 2
16 #define HI556_REG_VALUE_24BIT 3
18 #define HI556_LINK_FREQ_437MHZ 437000000ULL
19 #define HI556_MCLK 19200000
20 #define HI556_DATA_LANES 2
21 #define HI556_RGB_DEPTH 10
23 #define HI556_REG_CHIP_ID 0x0f16
24 #define HI556_CHIP_ID 0x0556
26 #define HI556_REG_MODE_SELECT 0x0a00
27 #define HI556_MODE_STANDBY 0x0000
28 #define HI556_MODE_STREAMING 0x0100
30 /* vertical-timings from sensor */
31 #define HI556_REG_FLL 0x0006
32 #define HI556_FLL_30FPS 0x0814
33 #define HI556_FLL_30FPS_MIN 0x0814
34 #define HI556_FLL_MAX 0x7fff
36 /* horizontal-timings from sensor */
37 #define HI556_REG_LLP 0x0008
39 /* Exposure controls from sensor */
40 #define HI556_REG_EXPOSURE 0x0074
41 #define HI556_EXPOSURE_MIN 6
42 #define HI556_EXPOSURE_MAX_MARGIN 2
43 #define HI556_EXPOSURE_STEP 1
45 /* Analog gain controls from sensor */
46 #define HI556_REG_ANALOG_GAIN 0x0077
47 #define HI556_ANAL_GAIN_MIN 0
48 #define HI556_ANAL_GAIN_MAX 240
49 #define HI556_ANAL_GAIN_STEP 1
51 /* Digital gain controls from sensor */
52 #define HI556_REG_MWB_GR_GAIN 0x0078
53 #define HI556_REG_MWB_GB_GAIN 0x007a
54 #define HI556_REG_MWB_R_GAIN 0x007c
55 #define HI556_REG_MWB_B_GAIN 0x007e
56 #define HI556_DGTL_GAIN_MIN 0
57 #define HI556_DGTL_GAIN_MAX 2048
58 #define HI556_DGTL_GAIN_STEP 1
59 #define HI556_DGTL_GAIN_DEFAULT 256
61 /* Test Pattern Control */
62 #define HI556_REG_ISP 0X0a05
63 #define HI556_REG_ISP_TPG_EN 0x01
64 #define HI556_REG_TEST_PATTERN 0x0201
66 enum {
67 HI556_LINK_FREQ_437MHZ_INDEX,
70 struct hi556_reg {
71 u16 address;
72 u16 val;
75 struct hi556_reg_list {
76 u32 num_of_regs;
77 const struct hi556_reg *regs;
80 struct hi556_link_freq_config {
81 const struct hi556_reg_list reg_list;
84 struct hi556_mode {
85 /* Frame width in pixels */
86 u32 width;
88 /* Frame height in pixels */
89 u32 height;
91 /* Horizontal timining size */
92 u32 llp;
94 /* Default vertical timining size */
95 u32 fll_def;
97 /* Min vertical timining size */
98 u32 fll_min;
100 /* Link frequency needed for this resolution */
101 u32 link_freq_index;
103 /* Sensor register settings for this resolution */
104 const struct hi556_reg_list reg_list;
107 #define to_hi556(_sd) container_of(_sd, struct hi556, sd)
109 //SENSOR_INITIALIZATION
110 static const struct hi556_reg mipi_data_rate_874mbps[] = {
111 {0x0e00, 0x0102},
112 {0x0e02, 0x0102},
113 {0x0e0c, 0x0100},
114 {0x2000, 0x7400},
115 {0x2002, 0x001c},
116 {0x2004, 0x0242},
117 {0x2006, 0x0942},
118 {0x2008, 0x7007},
119 {0x200a, 0x0fd9},
120 {0x200c, 0x0259},
121 {0x200e, 0x7008},
122 {0x2010, 0x160e},
123 {0x2012, 0x0047},
124 {0x2014, 0x2118},
125 {0x2016, 0x0041},
126 {0x2018, 0x00d8},
127 {0x201a, 0x0145},
128 {0x201c, 0x0006},
129 {0x201e, 0x0181},
130 {0x2020, 0x13cc},
131 {0x2022, 0x2057},
132 {0x2024, 0x7001},
133 {0x2026, 0x0fca},
134 {0x2028, 0x00cb},
135 {0x202a, 0x009f},
136 {0x202c, 0x7002},
137 {0x202e, 0x13cc},
138 {0x2030, 0x019b},
139 {0x2032, 0x014d},
140 {0x2034, 0x2987},
141 {0x2036, 0x2766},
142 {0x2038, 0x0020},
143 {0x203a, 0x2060},
144 {0x203c, 0x0e5d},
145 {0x203e, 0x181d},
146 {0x2040, 0x2066},
147 {0x2042, 0x20c4},
148 {0x2044, 0x5000},
149 {0x2046, 0x0005},
150 {0x2048, 0x0000},
151 {0x204a, 0x01db},
152 {0x204c, 0x025a},
153 {0x204e, 0x00c0},
154 {0x2050, 0x0005},
155 {0x2052, 0x0006},
156 {0x2054, 0x0ad9},
157 {0x2056, 0x0259},
158 {0x2058, 0x0618},
159 {0x205a, 0x0258},
160 {0x205c, 0x2266},
161 {0x205e, 0x20c8},
162 {0x2060, 0x2060},
163 {0x2062, 0x707b},
164 {0x2064, 0x0fdd},
165 {0x2066, 0x81b8},
166 {0x2068, 0x5040},
167 {0x206a, 0x0020},
168 {0x206c, 0x5060},
169 {0x206e, 0x3143},
170 {0x2070, 0x5081},
171 {0x2072, 0x025c},
172 {0x2074, 0x7800},
173 {0x2076, 0x7400},
174 {0x2078, 0x001c},
175 {0x207a, 0x0242},
176 {0x207c, 0x0942},
177 {0x207e, 0x0bd9},
178 {0x2080, 0x0259},
179 {0x2082, 0x7008},
180 {0x2084, 0x160e},
181 {0x2086, 0x0047},
182 {0x2088, 0x2118},
183 {0x208a, 0x0041},
184 {0x208c, 0x00d8},
185 {0x208e, 0x0145},
186 {0x2090, 0x0006},
187 {0x2092, 0x0181},
188 {0x2094, 0x13cc},
189 {0x2096, 0x2057},
190 {0x2098, 0x7001},
191 {0x209a, 0x0fca},
192 {0x209c, 0x00cb},
193 {0x209e, 0x009f},
194 {0x20a0, 0x7002},
195 {0x20a2, 0x13cc},
196 {0x20a4, 0x019b},
197 {0x20a6, 0x014d},
198 {0x20a8, 0x2987},
199 {0x20aa, 0x2766},
200 {0x20ac, 0x0020},
201 {0x20ae, 0x2060},
202 {0x20b0, 0x0e5d},
203 {0x20b2, 0x181d},
204 {0x20b4, 0x2066},
205 {0x20b6, 0x20c4},
206 {0x20b8, 0x50a0},
207 {0x20ba, 0x0005},
208 {0x20bc, 0x0000},
209 {0x20be, 0x01db},
210 {0x20c0, 0x025a},
211 {0x20c2, 0x00c0},
212 {0x20c4, 0x0005},
213 {0x20c6, 0x0006},
214 {0x20c8, 0x0ad9},
215 {0x20ca, 0x0259},
216 {0x20cc, 0x0618},
217 {0x20ce, 0x0258},
218 {0x20d0, 0x2266},
219 {0x20d2, 0x20c8},
220 {0x20d4, 0x2060},
221 {0x20d6, 0x707b},
222 {0x20d8, 0x0fdd},
223 {0x20da, 0x86b8},
224 {0x20dc, 0x50e0},
225 {0x20de, 0x0020},
226 {0x20e0, 0x5100},
227 {0x20e2, 0x3143},
228 {0x20e4, 0x5121},
229 {0x20e6, 0x7800},
230 {0x20e8, 0x3140},
231 {0x20ea, 0x01c4},
232 {0x20ec, 0x01c1},
233 {0x20ee, 0x01c0},
234 {0x20f0, 0x01c4},
235 {0x20f2, 0x2700},
236 {0x20f4, 0x3d40},
237 {0x20f6, 0x7800},
238 {0x20f8, 0xffff},
239 {0x27fe, 0xe000},
240 {0x3000, 0x60f8},
241 {0x3002, 0x187f},
242 {0x3004, 0x7060},
243 {0x3006, 0x0114},
244 {0x3008, 0x60b0},
245 {0x300a, 0x1473},
246 {0x300c, 0x0013},
247 {0x300e, 0x140f},
248 {0x3010, 0x0040},
249 {0x3012, 0x100f},
250 {0x3014, 0x60f8},
251 {0x3016, 0x187f},
252 {0x3018, 0x7060},
253 {0x301a, 0x0114},
254 {0x301c, 0x60b0},
255 {0x301e, 0x1473},
256 {0x3020, 0x0013},
257 {0x3022, 0x140f},
258 {0x3024, 0x0040},
259 {0x3026, 0x000f},
261 {0x0b00, 0x0000},
262 {0x0b02, 0x0045},
263 {0x0b04, 0xb405},
264 {0x0b06, 0xc403},
265 {0x0b08, 0x0081},
266 {0x0b0a, 0x8252},
267 {0x0b0c, 0xf814},
268 {0x0b0e, 0xc618},
269 {0x0b10, 0xa828},
270 {0x0b12, 0x004c},
271 {0x0b14, 0x4068},
272 {0x0b16, 0x0000},
273 {0x0f30, 0x5b15},
274 {0x0f32, 0x7067},
275 {0x0954, 0x0009},
276 {0x0956, 0x0000},
277 {0x0958, 0xbb80},
278 {0x095a, 0x5140},
279 {0x0c00, 0x1110},
280 {0x0c02, 0x0011},
281 {0x0c04, 0x0000},
282 {0x0c06, 0x0200},
283 {0x0c10, 0x0040},
284 {0x0c12, 0x0040},
285 {0x0c14, 0x0040},
286 {0x0c16, 0x0040},
287 {0x0a10, 0x4000},
288 {0x3068, 0xf800},
289 {0x306a, 0xf876},
290 {0x006c, 0x0000},
291 {0x005e, 0x0200},
292 {0x000e, 0x0100},
293 {0x0e0a, 0x0001},
294 {0x004a, 0x0100},
295 {0x004c, 0x0000},
296 {0x004e, 0x0100},
297 {0x000c, 0x0022},
298 {0x0008, 0x0b00},
299 {0x005a, 0x0202},
300 {0x0012, 0x000e},
301 {0x0018, 0x0a33},
302 {0x0022, 0x0008},
303 {0x0028, 0x0017},
304 {0x0024, 0x0028},
305 {0x002a, 0x002d},
306 {0x0026, 0x0030},
307 {0x002c, 0x07c9},
308 {0x002e, 0x1111},
309 {0x0030, 0x1111},
310 {0x0032, 0x1111},
311 {0x0006, 0x07bc},
312 {0x0a22, 0x0000},
313 {0x0a12, 0x0a20},
314 {0x0a14, 0x0798},
315 {0x003e, 0x0000},
316 {0x0074, 0x080e},
317 {0x0070, 0x0407},
318 {0x0002, 0x0000},
319 {0x0a02, 0x0100},
320 {0x0a24, 0x0100},
321 {0x0046, 0x0000},
322 {0x0076, 0x0000},
323 {0x0060, 0x0000},
324 {0x0062, 0x0530},
325 {0x0064, 0x0500},
326 {0x0066, 0x0530},
327 {0x0068, 0x0500},
328 {0x0122, 0x0300},
329 {0x015a, 0xff08},
330 {0x0804, 0x0300},
331 {0x0806, 0x0100},
332 {0x005c, 0x0102},
333 {0x0a1a, 0x0800},
336 static const struct hi556_reg mode_2592x1944_regs[] = {
337 {0x0a00, 0x0000},
338 {0x0b0a, 0x8252},
339 {0x0f30, 0x5b15},
340 {0x0f32, 0x7067},
341 {0x004a, 0x0100},
342 {0x004c, 0x0000},
343 {0x004e, 0x0100},
344 {0x000c, 0x0022},
345 {0x0008, 0x0b00},
346 {0x005a, 0x0202},
347 {0x0012, 0x000e},
348 {0x0018, 0x0a33},
349 {0x0022, 0x0008},
350 {0x0028, 0x0017},
351 {0x0024, 0x0028},
352 {0x002a, 0x002d},
353 {0x0026, 0x0030},
354 {0x002c, 0x07c9},
355 {0x002e, 0x1111},
356 {0x0030, 0x1111},
357 {0x0032, 0x1111},
358 {0x0006, 0x0814},
359 {0x0a22, 0x0000},
360 {0x0a12, 0x0a20},
361 {0x0a14, 0x0798},
362 {0x003e, 0x0000},
363 {0x0074, 0x0812},
364 {0x0070, 0x0409},
365 {0x0804, 0x0300},
366 {0x0806, 0x0100},
367 {0x0a04, 0x014a},
368 {0x090c, 0x0fdc},
369 {0x090e, 0x002d},
371 {0x0902, 0x4319},
372 {0x0914, 0xc10a},
373 {0x0916, 0x071f},
374 {0x0918, 0x0408},
375 {0x091a, 0x0c0d},
376 {0x091c, 0x0f09},
377 {0x091e, 0x0a00},
378 {0x0958, 0xbb80},
381 static const struct hi556_reg mode_1296x972_regs[] = {
382 {0x0a00, 0x0000},
383 {0x0b0a, 0x8259},
384 {0x0f30, 0x5b15},
385 {0x0f32, 0x7167},
386 {0x004a, 0x0100},
387 {0x004c, 0x0000},
388 {0x004e, 0x0100},
389 {0x000c, 0x0122},
390 {0x0008, 0x0b00},
391 {0x005a, 0x0404},
392 {0x0012, 0x000c},
393 {0x0018, 0x0a33},
394 {0x0022, 0x0008},
395 {0x0028, 0x0017},
396 {0x0024, 0x0022},
397 {0x002a, 0x002b},
398 {0x0026, 0x0030},
399 {0x002c, 0x07c9},
400 {0x002e, 0x3311},
401 {0x0030, 0x3311},
402 {0x0032, 0x3311},
403 {0x0006, 0x0814},
404 {0x0a22, 0x0000},
405 {0x0a12, 0x0510},
406 {0x0a14, 0x03cc},
407 {0x003e, 0x0000},
408 {0x0074, 0x0812},
409 {0x0070, 0x0409},
410 {0x0804, 0x0308},
411 {0x0806, 0x0100},
412 {0x0a04, 0x016a},
413 {0x090e, 0x0010},
414 {0x090c, 0x09c0},
416 {0x0902, 0x4319},
417 {0x0914, 0xc106},
418 {0x0916, 0x040e},
419 {0x0918, 0x0304},
420 {0x091a, 0x0708},
421 {0x091c, 0x0e06},
422 {0x091e, 0x0300},
423 {0x0958, 0xbb80},
426 static const char * const hi556_test_pattern_menu[] = {
427 "Disabled",
428 "Solid Colour",
429 "100% Colour Bars",
430 "Fade To Grey Colour Bars",
431 "PN9",
432 "Gradient Horizontal",
433 "Gradient Vertical",
434 "Check Board",
435 "Slant Pattern",
438 static const s64 link_freq_menu_items[] = {
439 HI556_LINK_FREQ_437MHZ,
442 static const struct hi556_link_freq_config link_freq_configs[] = {
443 [HI556_LINK_FREQ_437MHZ_INDEX] = {
444 .reg_list = {
445 .num_of_regs = ARRAY_SIZE(mipi_data_rate_874mbps),
446 .regs = mipi_data_rate_874mbps,
451 static const struct hi556_mode supported_modes[] = {
453 .width = 2592,
454 .height = 1944,
455 .fll_def = HI556_FLL_30FPS,
456 .fll_min = HI556_FLL_30FPS_MIN,
457 .llp = 0x0b00,
458 .reg_list = {
459 .num_of_regs = ARRAY_SIZE(mode_2592x1944_regs),
460 .regs = mode_2592x1944_regs,
462 .link_freq_index = HI556_LINK_FREQ_437MHZ_INDEX,
465 .width = 1296,
466 .height = 972,
467 .fll_def = HI556_FLL_30FPS,
468 .fll_min = HI556_FLL_30FPS_MIN,
469 .llp = 0x0b00,
470 .reg_list = {
471 .num_of_regs = ARRAY_SIZE(mode_1296x972_regs),
472 .regs = mode_1296x972_regs,
474 .link_freq_index = HI556_LINK_FREQ_437MHZ_INDEX,
478 struct hi556 {
479 struct v4l2_subdev sd;
480 struct media_pad pad;
481 struct v4l2_ctrl_handler ctrl_handler;
483 /* V4L2 Controls */
484 struct v4l2_ctrl *link_freq;
485 struct v4l2_ctrl *pixel_rate;
486 struct v4l2_ctrl *vblank;
487 struct v4l2_ctrl *hblank;
488 struct v4l2_ctrl *exposure;
490 /* Current mode */
491 const struct hi556_mode *cur_mode;
493 /* To serialize asynchronus callbacks */
494 struct mutex mutex;
496 /* Streaming on/off */
497 bool streaming;
500 static u64 to_pixel_rate(u32 f_index)
502 u64 pixel_rate = link_freq_menu_items[f_index] * 2 * HI556_DATA_LANES;
504 do_div(pixel_rate, HI556_RGB_DEPTH);
506 return pixel_rate;
509 static int hi556_read_reg(struct hi556 *hi556, u16 reg, u16 len, u32 *val)
511 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
512 struct i2c_msg msgs[2];
513 u8 addr_buf[2];
514 u8 data_buf[4] = {0};
515 int ret;
517 if (len > 4)
518 return -EINVAL;
520 put_unaligned_be16(reg, addr_buf);
521 msgs[0].addr = client->addr;
522 msgs[0].flags = 0;
523 msgs[0].len = sizeof(addr_buf);
524 msgs[0].buf = addr_buf;
525 msgs[1].addr = client->addr;
526 msgs[1].flags = I2C_M_RD;
527 msgs[1].len = len;
528 msgs[1].buf = &data_buf[4 - len];
530 ret = i2c_transfer(client->adapter, msgs, ARRAY_SIZE(msgs));
531 if (ret != ARRAY_SIZE(msgs))
532 return -EIO;
534 *val = get_unaligned_be32(data_buf);
536 return 0;
539 static int hi556_write_reg(struct hi556 *hi556, u16 reg, u16 len, u32 val)
541 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
542 u8 buf[6];
544 if (len > 4)
545 return -EINVAL;
547 put_unaligned_be16(reg, buf);
548 put_unaligned_be32(val << 8 * (4 - len), buf + 2);
549 if (i2c_master_send(client, buf, len + 2) != len + 2)
550 return -EIO;
552 return 0;
555 static int hi556_write_reg_list(struct hi556 *hi556,
556 const struct hi556_reg_list *r_list)
558 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
559 unsigned int i;
560 int ret;
562 for (i = 0; i < r_list->num_of_regs; i++) {
563 ret = hi556_write_reg(hi556, r_list->regs[i].address,
564 HI556_REG_VALUE_16BIT,
565 r_list->regs[i].val);
566 if (ret) {
567 dev_err_ratelimited(&client->dev,
568 "failed to write reg 0x%4.4x. error = %d",
569 r_list->regs[i].address, ret);
570 return ret;
574 return 0;
577 static int hi556_update_digital_gain(struct hi556 *hi556, u32 d_gain)
579 int ret;
581 ret = hi556_write_reg(hi556, HI556_REG_MWB_GR_GAIN,
582 HI556_REG_VALUE_16BIT, d_gain);
583 if (ret)
584 return ret;
586 ret = hi556_write_reg(hi556, HI556_REG_MWB_GB_GAIN,
587 HI556_REG_VALUE_16BIT, d_gain);
588 if (ret)
589 return ret;
591 ret = hi556_write_reg(hi556, HI556_REG_MWB_R_GAIN,
592 HI556_REG_VALUE_16BIT, d_gain);
593 if (ret)
594 return ret;
596 return hi556_write_reg(hi556, HI556_REG_MWB_B_GAIN,
597 HI556_REG_VALUE_16BIT, d_gain);
600 static int hi556_test_pattern(struct hi556 *hi556, u32 pattern)
602 int ret;
603 u32 val;
605 if (pattern) {
606 ret = hi556_read_reg(hi556, HI556_REG_ISP,
607 HI556_REG_VALUE_08BIT, &val);
608 if (ret)
609 return ret;
611 ret = hi556_write_reg(hi556, HI556_REG_ISP,
612 HI556_REG_VALUE_08BIT,
613 val | HI556_REG_ISP_TPG_EN);
614 if (ret)
615 return ret;
618 return hi556_write_reg(hi556, HI556_REG_TEST_PATTERN,
619 HI556_REG_VALUE_08BIT, pattern);
622 static int hi556_set_ctrl(struct v4l2_ctrl *ctrl)
624 struct hi556 *hi556 = container_of(ctrl->handler,
625 struct hi556, ctrl_handler);
626 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
627 s64 exposure_max;
628 int ret = 0;
630 /* Propagate change of current control to all related controls */
631 if (ctrl->id == V4L2_CID_VBLANK) {
632 /* Update max exposure while meeting expected vblanking */
633 exposure_max = hi556->cur_mode->height + ctrl->val -
634 HI556_EXPOSURE_MAX_MARGIN;
635 __v4l2_ctrl_modify_range(hi556->exposure,
636 hi556->exposure->minimum,
637 exposure_max, hi556->exposure->step,
638 exposure_max);
641 /* V4L2 controls values will be applied only when power is already up */
642 if (!pm_runtime_get_if_in_use(&client->dev))
643 return 0;
645 switch (ctrl->id) {
646 case V4L2_CID_ANALOGUE_GAIN:
647 ret = hi556_write_reg(hi556, HI556_REG_ANALOG_GAIN,
648 HI556_REG_VALUE_16BIT, ctrl->val);
649 break;
651 case V4L2_CID_DIGITAL_GAIN:
652 ret = hi556_update_digital_gain(hi556, ctrl->val);
653 break;
655 case V4L2_CID_EXPOSURE:
656 ret = hi556_write_reg(hi556, HI556_REG_EXPOSURE,
657 HI556_REG_VALUE_16BIT, ctrl->val);
658 break;
660 case V4L2_CID_VBLANK:
661 /* Update FLL that meets expected vertical blanking */
662 ret = hi556_write_reg(hi556, HI556_REG_FLL,
663 HI556_REG_VALUE_16BIT,
664 hi556->cur_mode->height + ctrl->val);
665 break;
667 case V4L2_CID_TEST_PATTERN:
668 ret = hi556_test_pattern(hi556, ctrl->val);
669 break;
671 default:
672 ret = -EINVAL;
673 break;
676 pm_runtime_put(&client->dev);
678 return ret;
681 static const struct v4l2_ctrl_ops hi556_ctrl_ops = {
682 .s_ctrl = hi556_set_ctrl,
685 static int hi556_init_controls(struct hi556 *hi556)
687 struct v4l2_ctrl_handler *ctrl_hdlr;
688 s64 exposure_max, h_blank;
689 int ret;
691 ctrl_hdlr = &hi556->ctrl_handler;
692 ret = v4l2_ctrl_handler_init(ctrl_hdlr, 8);
693 if (ret)
694 return ret;
696 ctrl_hdlr->lock = &hi556->mutex;
697 hi556->link_freq = v4l2_ctrl_new_int_menu(ctrl_hdlr, &hi556_ctrl_ops,
698 V4L2_CID_LINK_FREQ,
699 ARRAY_SIZE(link_freq_menu_items) - 1,
700 0, link_freq_menu_items);
701 if (hi556->link_freq)
702 hi556->link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY;
704 hi556->pixel_rate = v4l2_ctrl_new_std
705 (ctrl_hdlr, &hi556_ctrl_ops,
706 V4L2_CID_PIXEL_RATE, 0,
707 to_pixel_rate(HI556_LINK_FREQ_437MHZ_INDEX),
709 to_pixel_rate(HI556_LINK_FREQ_437MHZ_INDEX));
710 hi556->vblank = v4l2_ctrl_new_std(ctrl_hdlr, &hi556_ctrl_ops,
711 V4L2_CID_VBLANK,
712 hi556->cur_mode->fll_min -
713 hi556->cur_mode->height,
714 HI556_FLL_MAX -
715 hi556->cur_mode->height, 1,
716 hi556->cur_mode->fll_def -
717 hi556->cur_mode->height);
719 h_blank = hi556->cur_mode->llp - hi556->cur_mode->width;
721 hi556->hblank = v4l2_ctrl_new_std(ctrl_hdlr, &hi556_ctrl_ops,
722 V4L2_CID_HBLANK, h_blank, h_blank, 1,
723 h_blank);
724 if (hi556->hblank)
725 hi556->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
727 v4l2_ctrl_new_std(ctrl_hdlr, &hi556_ctrl_ops, V4L2_CID_ANALOGUE_GAIN,
728 HI556_ANAL_GAIN_MIN, HI556_ANAL_GAIN_MAX,
729 HI556_ANAL_GAIN_STEP, HI556_ANAL_GAIN_MIN);
730 v4l2_ctrl_new_std(ctrl_hdlr, &hi556_ctrl_ops, V4L2_CID_DIGITAL_GAIN,
731 HI556_DGTL_GAIN_MIN, HI556_DGTL_GAIN_MAX,
732 HI556_DGTL_GAIN_STEP, HI556_DGTL_GAIN_DEFAULT);
733 exposure_max = hi556->cur_mode->fll_def - HI556_EXPOSURE_MAX_MARGIN;
734 hi556->exposure = v4l2_ctrl_new_std(ctrl_hdlr, &hi556_ctrl_ops,
735 V4L2_CID_EXPOSURE,
736 HI556_EXPOSURE_MIN, exposure_max,
737 HI556_EXPOSURE_STEP,
738 exposure_max);
739 v4l2_ctrl_new_std_menu_items(ctrl_hdlr, &hi556_ctrl_ops,
740 V4L2_CID_TEST_PATTERN,
741 ARRAY_SIZE(hi556_test_pattern_menu) - 1,
742 0, 0, hi556_test_pattern_menu);
743 if (ctrl_hdlr->error)
744 return ctrl_hdlr->error;
746 hi556->sd.ctrl_handler = ctrl_hdlr;
748 return 0;
751 static void hi556_assign_pad_format(const struct hi556_mode *mode,
752 struct v4l2_mbus_framefmt *fmt)
754 fmt->width = mode->width;
755 fmt->height = mode->height;
756 fmt->code = MEDIA_BUS_FMT_SGRBG10_1X10;
757 fmt->field = V4L2_FIELD_NONE;
760 static int hi556_start_streaming(struct hi556 *hi556)
762 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
763 const struct hi556_reg_list *reg_list;
764 int link_freq_index, ret;
766 link_freq_index = hi556->cur_mode->link_freq_index;
767 reg_list = &link_freq_configs[link_freq_index].reg_list;
768 ret = hi556_write_reg_list(hi556, reg_list);
769 if (ret) {
770 dev_err(&client->dev, "failed to set plls");
771 return ret;
774 reg_list = &hi556->cur_mode->reg_list;
775 ret = hi556_write_reg_list(hi556, reg_list);
776 if (ret) {
777 dev_err(&client->dev, "failed to set mode");
778 return ret;
781 ret = __v4l2_ctrl_handler_setup(hi556->sd.ctrl_handler);
782 if (ret)
783 return ret;
785 ret = hi556_write_reg(hi556, HI556_REG_MODE_SELECT,
786 HI556_REG_VALUE_16BIT, HI556_MODE_STREAMING);
788 if (ret) {
789 dev_err(&client->dev, "failed to set stream");
790 return ret;
793 return 0;
796 static void hi556_stop_streaming(struct hi556 *hi556)
798 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
800 if (hi556_write_reg(hi556, HI556_REG_MODE_SELECT,
801 HI556_REG_VALUE_16BIT, HI556_MODE_STANDBY))
802 dev_err(&client->dev, "failed to set stream");
805 static int hi556_set_stream(struct v4l2_subdev *sd, int enable)
807 struct hi556 *hi556 = to_hi556(sd);
808 struct i2c_client *client = v4l2_get_subdevdata(sd);
809 int ret = 0;
811 if (hi556->streaming == enable)
812 return 0;
814 mutex_lock(&hi556->mutex);
815 if (enable) {
816 ret = pm_runtime_get_sync(&client->dev);
817 if (ret < 0) {
818 pm_runtime_put_noidle(&client->dev);
819 mutex_unlock(&hi556->mutex);
820 return ret;
823 ret = hi556_start_streaming(hi556);
824 if (ret) {
825 enable = 0;
826 hi556_stop_streaming(hi556);
827 pm_runtime_put(&client->dev);
829 } else {
830 hi556_stop_streaming(hi556);
831 pm_runtime_put(&client->dev);
834 hi556->streaming = enable;
835 mutex_unlock(&hi556->mutex);
837 return ret;
840 static int __maybe_unused hi556_suspend(struct device *dev)
842 struct i2c_client *client = to_i2c_client(dev);
843 struct v4l2_subdev *sd = i2c_get_clientdata(client);
844 struct hi556 *hi556 = to_hi556(sd);
846 mutex_lock(&hi556->mutex);
847 if (hi556->streaming)
848 hi556_stop_streaming(hi556);
850 mutex_unlock(&hi556->mutex);
852 return 0;
855 static int __maybe_unused hi556_resume(struct device *dev)
857 struct i2c_client *client = to_i2c_client(dev);
858 struct v4l2_subdev *sd = i2c_get_clientdata(client);
859 struct hi556 *hi556 = to_hi556(sd);
860 int ret;
862 mutex_lock(&hi556->mutex);
863 if (hi556->streaming) {
864 ret = hi556_start_streaming(hi556);
865 if (ret)
866 goto error;
869 mutex_unlock(&hi556->mutex);
871 return 0;
873 error:
874 hi556_stop_streaming(hi556);
875 hi556->streaming = 0;
876 mutex_unlock(&hi556->mutex);
877 return ret;
880 static int hi556_set_format(struct v4l2_subdev *sd,
881 struct v4l2_subdev_pad_config *cfg,
882 struct v4l2_subdev_format *fmt)
884 struct hi556 *hi556 = to_hi556(sd);
885 const struct hi556_mode *mode;
886 s32 vblank_def, h_blank;
888 mode = v4l2_find_nearest_size(supported_modes,
889 ARRAY_SIZE(supported_modes), width,
890 height, fmt->format.width,
891 fmt->format.height);
893 mutex_lock(&hi556->mutex);
894 hi556_assign_pad_format(mode, &fmt->format);
895 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY) {
896 *v4l2_subdev_get_try_format(sd, cfg, fmt->pad) = fmt->format;
897 } else {
898 hi556->cur_mode = mode;
899 __v4l2_ctrl_s_ctrl(hi556->link_freq, mode->link_freq_index);
900 __v4l2_ctrl_s_ctrl_int64(hi556->pixel_rate,
901 to_pixel_rate(mode->link_freq_index));
903 /* Update limits and set FPS to default */
904 vblank_def = mode->fll_def - mode->height;
905 __v4l2_ctrl_modify_range(hi556->vblank,
906 mode->fll_min - mode->height,
907 HI556_FLL_MAX - mode->height, 1,
908 vblank_def);
909 __v4l2_ctrl_s_ctrl(hi556->vblank, vblank_def);
911 h_blank = hi556->cur_mode->llp - hi556->cur_mode->width;
913 __v4l2_ctrl_modify_range(hi556->hblank, h_blank, h_blank, 1,
914 h_blank);
917 mutex_unlock(&hi556->mutex);
919 return 0;
922 static int hi556_get_format(struct v4l2_subdev *sd,
923 struct v4l2_subdev_pad_config *cfg,
924 struct v4l2_subdev_format *fmt)
926 struct hi556 *hi556 = to_hi556(sd);
928 mutex_lock(&hi556->mutex);
929 if (fmt->which == V4L2_SUBDEV_FORMAT_TRY)
930 fmt->format = *v4l2_subdev_get_try_format(&hi556->sd, cfg,
931 fmt->pad);
932 else
933 hi556_assign_pad_format(hi556->cur_mode, &fmt->format);
935 mutex_unlock(&hi556->mutex);
937 return 0;
940 static int hi556_enum_mbus_code(struct v4l2_subdev *sd,
941 struct v4l2_subdev_pad_config *cfg,
942 struct v4l2_subdev_mbus_code_enum *code)
944 if (code->index > 0)
945 return -EINVAL;
947 code->code = MEDIA_BUS_FMT_SGRBG10_1X10;
949 return 0;
952 static int hi556_enum_frame_size(struct v4l2_subdev *sd,
953 struct v4l2_subdev_pad_config *cfg,
954 struct v4l2_subdev_frame_size_enum *fse)
956 if (fse->index >= ARRAY_SIZE(supported_modes))
957 return -EINVAL;
959 if (fse->code != MEDIA_BUS_FMT_SGRBG10_1X10)
960 return -EINVAL;
962 fse->min_width = supported_modes[fse->index].width;
963 fse->max_width = fse->min_width;
964 fse->min_height = supported_modes[fse->index].height;
965 fse->max_height = fse->min_height;
967 return 0;
970 static int hi556_open(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh)
972 struct hi556 *hi556 = to_hi556(sd);
974 mutex_lock(&hi556->mutex);
975 hi556_assign_pad_format(&supported_modes[0],
976 v4l2_subdev_get_try_format(sd, fh->pad, 0));
977 mutex_unlock(&hi556->mutex);
979 return 0;
982 static const struct v4l2_subdev_video_ops hi556_video_ops = {
983 .s_stream = hi556_set_stream,
986 static const struct v4l2_subdev_pad_ops hi556_pad_ops = {
987 .set_fmt = hi556_set_format,
988 .get_fmt = hi556_get_format,
989 .enum_mbus_code = hi556_enum_mbus_code,
990 .enum_frame_size = hi556_enum_frame_size,
993 static const struct v4l2_subdev_ops hi556_subdev_ops = {
994 .video = &hi556_video_ops,
995 .pad = &hi556_pad_ops,
998 static const struct media_entity_operations hi556_subdev_entity_ops = {
999 .link_validate = v4l2_subdev_link_validate,
1002 static const struct v4l2_subdev_internal_ops hi556_internal_ops = {
1003 .open = hi556_open,
1006 static int hi556_identify_module(struct hi556 *hi556)
1008 struct i2c_client *client = v4l2_get_subdevdata(&hi556->sd);
1009 int ret;
1010 u32 val;
1012 ret = hi556_read_reg(hi556, HI556_REG_CHIP_ID,
1013 HI556_REG_VALUE_16BIT, &val);
1014 if (ret)
1015 return ret;
1017 if (val != HI556_CHIP_ID) {
1018 dev_err(&client->dev, "chip id mismatch: %x!=%x",
1019 HI556_CHIP_ID, val);
1020 return -ENXIO;
1023 return 0;
1026 static int hi556_check_hwcfg(struct device *dev)
1028 struct fwnode_handle *ep;
1029 struct fwnode_handle *fwnode = dev_fwnode(dev);
1030 struct v4l2_fwnode_endpoint bus_cfg = {
1031 .bus_type = V4L2_MBUS_CSI2_DPHY
1033 u32 mclk;
1034 int ret = 0;
1035 unsigned int i, j;
1037 if (!fwnode)
1038 return -ENXIO;
1040 ret = fwnode_property_read_u32(fwnode, "clock-frequency", &mclk);
1041 if (ret) {
1042 dev_err(dev, "can't get clock frequency");
1043 return ret;
1046 if (mclk != HI556_MCLK) {
1047 dev_err(dev, "external clock %d is not supported", mclk);
1048 return -EINVAL;
1051 ep = fwnode_graph_get_next_endpoint(fwnode, NULL);
1052 if (!ep)
1053 return -ENXIO;
1055 ret = v4l2_fwnode_endpoint_alloc_parse(ep, &bus_cfg);
1056 fwnode_handle_put(ep);
1057 if (ret)
1058 return ret;
1060 if (bus_cfg.bus.mipi_csi2.num_data_lanes != 2) {
1061 dev_err(dev, "number of CSI2 data lanes %d is not supported",
1062 bus_cfg.bus.mipi_csi2.num_data_lanes);
1063 ret = -EINVAL;
1064 goto check_hwcfg_error;
1067 if (!bus_cfg.nr_of_link_frequencies) {
1068 dev_err(dev, "no link frequencies defined");
1069 ret = -EINVAL;
1070 goto check_hwcfg_error;
1073 for (i = 0; i < ARRAY_SIZE(link_freq_menu_items); i++) {
1074 for (j = 0; j < bus_cfg.nr_of_link_frequencies; j++) {
1075 if (link_freq_menu_items[i] ==
1076 bus_cfg.link_frequencies[j])
1077 break;
1080 if (j == bus_cfg.nr_of_link_frequencies) {
1081 dev_err(dev, "no link frequency %lld supported",
1082 link_freq_menu_items[i]);
1083 ret = -EINVAL;
1084 goto check_hwcfg_error;
1088 check_hwcfg_error:
1089 v4l2_fwnode_endpoint_free(&bus_cfg);
1091 return ret;
1094 static int hi556_remove(struct i2c_client *client)
1096 struct v4l2_subdev *sd = i2c_get_clientdata(client);
1097 struct hi556 *hi556 = to_hi556(sd);
1099 v4l2_async_unregister_subdev(sd);
1100 media_entity_cleanup(&sd->entity);
1101 v4l2_ctrl_handler_free(sd->ctrl_handler);
1102 pm_runtime_disable(&client->dev);
1103 mutex_destroy(&hi556->mutex);
1105 return 0;
1108 static int hi556_probe(struct i2c_client *client)
1110 struct hi556 *hi556;
1111 int ret;
1113 ret = hi556_check_hwcfg(&client->dev);
1114 if (ret) {
1115 dev_err(&client->dev, "failed to check HW configuration: %d",
1116 ret);
1117 return ret;
1120 hi556 = devm_kzalloc(&client->dev, sizeof(*hi556), GFP_KERNEL);
1121 if (!hi556)
1122 return -ENOMEM;
1124 v4l2_i2c_subdev_init(&hi556->sd, client, &hi556_subdev_ops);
1125 ret = hi556_identify_module(hi556);
1126 if (ret) {
1127 dev_err(&client->dev, "failed to find sensor: %d", ret);
1128 return ret;
1131 mutex_init(&hi556->mutex);
1132 hi556->cur_mode = &supported_modes[0];
1133 ret = hi556_init_controls(hi556);
1134 if (ret) {
1135 dev_err(&client->dev, "failed to init controls: %d", ret);
1136 goto probe_error_v4l2_ctrl_handler_free;
1139 hi556->sd.internal_ops = &hi556_internal_ops;
1140 hi556->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
1141 hi556->sd.entity.ops = &hi556_subdev_entity_ops;
1142 hi556->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
1143 hi556->pad.flags = MEDIA_PAD_FL_SOURCE;
1144 ret = media_entity_pads_init(&hi556->sd.entity, 1, &hi556->pad);
1145 if (ret) {
1146 dev_err(&client->dev, "failed to init entity pads: %d", ret);
1147 goto probe_error_v4l2_ctrl_handler_free;
1150 ret = v4l2_async_register_subdev_sensor_common(&hi556->sd);
1151 if (ret < 0) {
1152 dev_err(&client->dev, "failed to register V4L2 subdev: %d",
1153 ret);
1154 goto probe_error_media_entity_cleanup;
1157 pm_runtime_set_active(&client->dev);
1158 pm_runtime_enable(&client->dev);
1159 pm_runtime_idle(&client->dev);
1161 return 0;
1163 probe_error_media_entity_cleanup:
1164 media_entity_cleanup(&hi556->sd.entity);
1166 probe_error_v4l2_ctrl_handler_free:
1167 v4l2_ctrl_handler_free(hi556->sd.ctrl_handler);
1168 mutex_destroy(&hi556->mutex);
1170 return ret;
1173 static const struct dev_pm_ops hi556_pm_ops = {
1174 SET_SYSTEM_SLEEP_PM_OPS(hi556_suspend, hi556_resume)
1177 #ifdef CONFIG_ACPI
1178 static const struct acpi_device_id hi556_acpi_ids[] = {
1179 {"INT3537"},
1183 MODULE_DEVICE_TABLE(acpi, hi556_acpi_ids);
1184 #endif
1186 static struct i2c_driver hi556_i2c_driver = {
1187 .driver = {
1188 .name = "hi556",
1189 .pm = &hi556_pm_ops,
1190 .acpi_match_table = ACPI_PTR(hi556_acpi_ids),
1192 .probe_new = hi556_probe,
1193 .remove = hi556_remove,
1196 module_i2c_driver(hi556_i2c_driver);
1198 MODULE_AUTHOR("Shawn Tu <shawnx.tu@intel.com>");
1199 MODULE_DESCRIPTION("Hynix HI556 sensor driver");
1200 MODULE_LICENSE("GPL v2");