1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Support for T4KA3 8M camera sensor.
4 *
5 * Copyright (C) 2015 Intel Corporation. All Rights Reserved.
6 * Copyright (C) 2016 XiaoMi, Inc.
7 * Copyright (C) 2024 Hans de Goede <hansg@kernel.org>
8 * Copyright (C) 2026 Kate Hsuan <hpa@redhat.com>
9 */
10
11 #include <linux/acpi.h>
12 #include <linux/bits.h>
13 #include <linux/delay.h>
14 #include <linux/dev_printk.h>
15 #include <linux/device.h>
16 #include <linux/err.h>
17 #include <linux/errno.h>
18 #include <linux/gpio/consumer.h>
19 #include <linux/i2c.h>
20 #include <linux/mutex.h>
21 #include <linux/pm_runtime.h>
22 #include <linux/regmap.h>
23 #include <linux/types.h>
24
25 #include <media/media-entity.h>
26 #include <media/v4l2-async.h>
27 #include <media/v4l2-cci.h>
28 #include <media/v4l2-common.h>
29 #include <media/v4l2-ctrls.h>
30 #include <media/v4l2-fwnode.h>
31 #include <media/v4l2-subdev.h>
32
33 #define T4KA3_NATIVE_WIDTH 3280
34 #define T4KA3_NATIVE_HEIGHT 2464
35 #define T4KA3_NATIVE_START_LEFT 0
36 #define T4KA3_NATIVE_START_TOP 0
37 #define T4KA3_ACTIVE_WIDTH 3280
38 #define T4KA3_ACTIVE_HEIGHT 2460
39 #define T4KA3_ACTIVE_START_LEFT 0
40 #define T4KA3_ACTIVE_START_TOP 2
41 #define T4KA3_MIN_CROP_WIDTH 2
42 #define T4KA3_MIN_CROP_HEIGHT 2
43
44 #define T4KA3_PIXELS_PER_LINE 3440
45 #define T4KA3_LINES_PER_FRAME_30FPS 2492
46 #define T4KA3_FPS 30
47 #define T4KA3_PIXEL_RATE \
48 (T4KA3_PIXELS_PER_LINE * T4KA3_LINES_PER_FRAME_30FPS * T4KA3_FPS)
49
50 /*
51 * TODO this really should be derived from the 19.2 MHz xvclk combined
52 * with the PLL settings. But without a datasheet this is the closest
53 * approximation possible.
54 *
55 * link-freq = pixel_rate * bpp / (lanes * 2)
56 * (lanes * 2) because CSI lanes use double-data-rate (DDR) signalling.
57 * bpp = 10 and lanes = 4
58 */
59 #define T4KA3_LINK_FREQ ((u64)T4KA3_PIXEL_RATE * 10 / 8)
60
61 /* For enum_frame_size() full-size + binned-/quarter-size */
62 #define T4KA3_FRAME_SIZES 2
63
64 #define T4KA3_REG_PRODUCT_ID_HIGH CCI_REG8(0x0000)
65 #define T4KA3_REG_PRODUCT_ID_LOW CCI_REG8(0x0001)
66 #define T4KA3_PRODUCT_ID 0x1490
67
68 #define T4KA3_REG_STREAM CCI_REG8(0x0100)
69 #define T4KA3_REG_IMG_ORIENTATION CCI_REG8(0x0101)
70 #define T4KA3_HFLIP_BIT BIT(0)
71 #define T4KA3_VFLIP_BIT BIT(1)
72 #define T4KA3_REG_PARAM_HOLD CCI_REG8(0x0104)
73 #define T4KA3_REG_COARSE_INTEGRATION_TIME CCI_REG16(0x0202)
74 #define T4KA3_COARSE_INTEGRATION_TIME_MARGIN 6
75 #define T4KA3_REG_DIGGAIN_GREEN_R CCI_REG16(0x020e)
76 #define T4KA3_REG_DIGGAIN_RED CCI_REG16(0x0210)
77 #define T4KA3_REG_DIGGAIN_BLUE CCI_REG16(0x0212)
78 #define T4KA3_REG_DIGGAIN_GREEN_B CCI_REG16(0x0214)
79 #define T4KA3_REG_GLOBAL_GAIN CCI_REG16(0x0234)
80 #define T4KA3_MIN_GLOBAL_GAIN_SUPPORTED 0x0080
81 #define T4KA3_MAX_GLOBAL_GAIN_SUPPORTED 0x07ff
82 #define T4KA3_REG_FRAME_LENGTH_LINES CCI_REG16(0x0340) /* aka VTS */
83 /* FIXME: need a datasheet to verify the min + max vblank values */
84 #define T4KA3_MIN_VBLANK 4
85 #define T4KA3_MAX_VBLANK 0xffff
86 #define T4KA3_REG_PIXELS_PER_LINE CCI_REG16(0x0342) /* aka HTS */
87 /* These 2 being horz/vert start is a guess (no datasheet), always 0 */
88 #define T4KA3_REG_HORZ_START CCI_REG16(0x0344)
89 #define T4KA3_REG_VERT_START CCI_REG16(0x0346)
90 /* Always 3279 (T4KA3_NATIVE_WIDTH - 1, window is used to crop */
91 #define T4KA3_REG_HORZ_END CCI_REG16(0x0348)
92 /* Always 2463 (T4KA3_NATIVE_HEIGHT - 1, window is used to crop */
93 #define T4KA3_REG_VERT_END CCI_REG16(0x034a)
94 /* Output size (after cropping/window) */
95 #define T4KA3_REG_HORZ_OUTPUT_SIZE CCI_REG16(0x034c)
96 #define T4KA3_REG_VERT_OUTPUT_SIZE CCI_REG16(0x034e)
97 /* Window/crop start + size *after* binning */
98 #define T4KA3_REG_WIN_START_X CCI_REG16(0x0408)
99 #define T4KA3_REG_WIN_START_Y CCI_REG16(0x040a)
100 #define T4KA3_REG_WIN_WIDTH CCI_REG16(0x040c)
101 #define T4KA3_REG_WIN_HEIGHT CCI_REG16(0x040e)
102 #define T4KA3_REG_TEST_PATTERN_MODE CCI_REG8(0x0601)
103 /* Unknown register at address 0x0900 */
104 #define T4KA3_REG_0900 CCI_REG8(0x0900)
105 #define T4KA3_REG_BINNING CCI_REG8(0x0901)
106 #define T4KA3_BINNING_VAL(_bin) \
107 ({ \
108 typeof(_bin) (b) = (_bin); \
109 ((b) << 4) | (b); \
110 })
111
112 #define to_t4ka3_sensor(_sd) container_of_const(_sd, \
113 struct t4ka3_data, sd)
114 #define ctrl_to_t4ka3(_ctrl) container_of_const((_ctrl)->handler, \
115 struct t4ka3_data, \
116 ctrls.handler)
117
118 struct t4ka3_ctrls {
119 struct v4l2_ctrl_handler handler;
120 struct v4l2_ctrl *hflip;
121 struct v4l2_ctrl *vflip;
122 struct v4l2_ctrl *vblank;
123 struct v4l2_ctrl *hblank;
124 struct v4l2_ctrl *exposure;
125 struct v4l2_ctrl *gain;
126 struct v4l2_ctrl *test_pattern;
127 struct v4l2_ctrl *link_freq;
128 struct v4l2_ctrl *pixel_rate;
129 };
130
131 struct t4ka3_mode {
132 int binning;
133 u16 win_x;
134 u16 win_y;
135 };
136
137 struct t4ka3_data {
138 struct v4l2_subdev sd;
139 struct media_pad pad;
140 struct mutex lock; /* serialize sensor's ioctl */
141 struct t4ka3_ctrls ctrls;
142 struct t4ka3_mode mode;
143 struct device *dev;
144 struct regmap *regmap;
145 struct gpio_desc *powerdown_gpio;
146 struct gpio_desc *reset_gpio;
147 int streaming;
148
149 /* MIPI lane info */
150 u32 link_freq_index;
151 u8 mipi_lanes;
152 };
153
154 /* init settings */
155 static const struct cci_reg_sequence t4ka3_init_config[] = {
156 { CCI_REG8(0x4136), 0x13 },
157 { CCI_REG8(0x4137), 0x33 },
158 { CCI_REG8(0x3094), 0x01 },
159 { CCI_REG8(0x0233), 0x01 },
160 { CCI_REG8(0x4B06), 0x01 },
161 { CCI_REG8(0x4B07), 0x01 },
162 { CCI_REG8(0x3028), 0x01 },
163 { CCI_REG8(0x3032), 0x14 },
164 { CCI_REG8(0x305C), 0x0C },
165 { CCI_REG8(0x306D), 0x0A },
166 { CCI_REG8(0x3071), 0xFA },
167 { CCI_REG8(0x307E), 0x0A },
168 { CCI_REG8(0x307F), 0xFC },
169 { CCI_REG8(0x3091), 0x04 },
170 { CCI_REG8(0x3092), 0x60 },
171 { CCI_REG8(0x3096), 0xC0 },
172 { CCI_REG8(0x3100), 0x07 },
173 { CCI_REG8(0x3101), 0x4C },
174 { CCI_REG8(0x3118), 0xCC },
175 { CCI_REG8(0x3139), 0x06 },
176 { CCI_REG8(0x313A), 0x06 },
177 { CCI_REG8(0x313B), 0x04 },
178 { CCI_REG8(0x3143), 0x02 },
179 { CCI_REG8(0x314F), 0x0E },
180 { CCI_REG8(0x3169), 0x99 },
181 { CCI_REG8(0x316A), 0x99 },
182 { CCI_REG8(0x3171), 0x05 },
183 { CCI_REG8(0x31A1), 0xA7 },
184 { CCI_REG8(0x31A2), 0x9C },
185 { CCI_REG8(0x31A3), 0x8F },
186 { CCI_REG8(0x31A4), 0x75 },
187 { CCI_REG8(0x31A5), 0xEE },
188 { CCI_REG8(0x31A6), 0xEA },
189 { CCI_REG8(0x31A7), 0xE4 },
190 { CCI_REG8(0x31A8), 0xE4 },
191 { CCI_REG8(0x31DF), 0x05 },
192 { CCI_REG8(0x31EC), 0x1B },
193 { CCI_REG8(0x31ED), 0x1B },
194 { CCI_REG8(0x31EE), 0x1B },
195 { CCI_REG8(0x31F0), 0x1B },
196 { CCI_REG8(0x31F1), 0x1B },
197 { CCI_REG8(0x31F2), 0x1B },
198 { CCI_REG8(0x3204), 0x3F },
199 { CCI_REG8(0x3205), 0x03 },
200 { CCI_REG8(0x3210), 0x01 },
201 { CCI_REG8(0x3216), 0x68 },
202 { CCI_REG8(0x3217), 0x58 },
203 { CCI_REG8(0x3218), 0x58 },
204 { CCI_REG8(0x321A), 0x68 },
205 { CCI_REG8(0x321B), 0x60 },
206 { CCI_REG8(0x3238), 0x03 },
207 { CCI_REG8(0x3239), 0x03 },
208 { CCI_REG8(0x323A), 0x05 },
209 { CCI_REG8(0x323B), 0x06 },
210 { CCI_REG8(0x3243), 0x03 },
211 { CCI_REG8(0x3244), 0x08 },
212 { CCI_REG8(0x3245), 0x01 },
213 { CCI_REG8(0x3307), 0x19 },
214 { CCI_REG8(0x3308), 0x19 },
215 { CCI_REG8(0x3320), 0x01 },
216 { CCI_REG8(0x3326), 0x15 },
217 { CCI_REG8(0x3327), 0x0D },
218 { CCI_REG8(0x3328), 0x01 },
219 { CCI_REG8(0x3380), 0x01 },
220 { CCI_REG8(0x339E), 0x07 },
221 { CCI_REG8(0x3424), 0x00 },
222 { CCI_REG8(0x343C), 0x01 },
223 { CCI_REG8(0x3398), 0x04 },
224 { CCI_REG8(0x343A), 0x10 },
225 { CCI_REG8(0x339A), 0x22 },
226 { CCI_REG8(0x33B4), 0x00 },
227 { CCI_REG8(0x3393), 0x01 },
228 { CCI_REG8(0x33B3), 0x6E },
229 { CCI_REG8(0x3433), 0x06 },
230 { CCI_REG8(0x3433), 0x00 },
231 { CCI_REG8(0x33B3), 0x00 },
232 { CCI_REG8(0x3393), 0x03 },
233 { CCI_REG8(0x33B4), 0x03 },
234 { CCI_REG8(0x343A), 0x00 },
235 { CCI_REG8(0x339A), 0x00 },
236 { CCI_REG8(0x3398), 0x00 }
237 };
238
239 static const struct cci_reg_sequence t4ka3_pre_mode_set_regs[] = {
240 { CCI_REG8(0x0112), 0x0A },
241 { CCI_REG8(0x0113), 0x0A },
242 { CCI_REG8(0x0114), 0x03 },
243 { CCI_REG8(0x4136), 0x13 },
244 { CCI_REG8(0x4137), 0x33 },
245 { CCI_REG8(0x0820), 0x0A },
246 { CCI_REG8(0x0821), 0x0D },
247 { CCI_REG8(0x0822), 0x00 },
248 { CCI_REG8(0x0823), 0x00 },
249 { CCI_REG8(0x0301), 0x0A },
250 { CCI_REG8(0x0303), 0x01 },
251 { CCI_REG8(0x0305), 0x04 },
252 { CCI_REG8(0x0306), 0x02 },
253 { CCI_REG8(0x0307), 0x18 },
254 { CCI_REG8(0x030B), 0x01 },
255 };
256
257 static const struct cci_reg_sequence t4ka3_post_mode_set_regs[] = {
258 { CCI_REG8(0x0902), 0x00 },
259 { CCI_REG8(0x4220), 0x00 },
260 { CCI_REG8(0x4222), 0x01 },
261 { CCI_REG8(0x3380), 0x01 },
262 { CCI_REG8(0x3090), 0x88 },
263 { CCI_REG8(0x3394), 0x20 },
264 { CCI_REG8(0x3090), 0x08 },
265 { CCI_REG8(0x3394), 0x10 }
266 };
267
268 static const s64 link_freq_menu_items[] = {
269 T4KA3_LINK_FREQ,
270 };
271
272 /* T4KA3 default GRBG */
273 static const int t4ka3_hv_flip_bayer_order[] = {
274 MEDIA_BUS_FMT_SGRBG10_1X10,
275 MEDIA_BUS_FMT_SBGGR10_1X10,
276 MEDIA_BUS_FMT_SRGGB10_1X10,
277 MEDIA_BUS_FMT_SGBRG10_1X10,
278 };
279
280 static const struct v4l2_rect t4ka3_default_crop = {
281 .left = T4KA3_ACTIVE_START_LEFT,
282 .top = T4KA3_ACTIVE_START_TOP,
283 .width = T4KA3_ACTIVE_WIDTH,
284 .height = T4KA3_ACTIVE_HEIGHT,
285 };
286
t4ka3_set_bayer_order(struct t4ka3_data * sensor,struct v4l2_mbus_framefmt * fmt)287 static void t4ka3_set_bayer_order(struct t4ka3_data *sensor,
288 struct v4l2_mbus_framefmt *fmt)
289 {
290 unsigned int hv_flip = 0;
291
292 if (sensor->ctrls.vflip && sensor->ctrls.vflip->val)
293 hv_flip += 1;
294
295 if (sensor->ctrls.hflip && sensor->ctrls.hflip->val)
296 hv_flip += 2;
297
298 fmt->code = t4ka3_hv_flip_bayer_order[hv_flip];
299 }
300
t4ka3_update_exposure_range(struct t4ka3_data * sensor,struct v4l2_mbus_framefmt * fmt)301 static int t4ka3_update_exposure_range(struct t4ka3_data *sensor,
302 struct v4l2_mbus_framefmt *fmt)
303 {
304 int exp_max = fmt->height + sensor->ctrls.vblank->val -
305 T4KA3_COARSE_INTEGRATION_TIME_MARGIN;
306
307 return __v4l2_ctrl_modify_range(sensor->ctrls.exposure, 0, exp_max,
308 1, exp_max);
309 }
310
t4ka3_fill_format(struct t4ka3_data * sensor,struct v4l2_mbus_framefmt * fmt,unsigned int width,unsigned int height)311 static void t4ka3_fill_format(struct t4ka3_data *sensor,
312 struct v4l2_mbus_framefmt *fmt,
313 unsigned int width, unsigned int height)
314 {
315 memset(fmt, 0, sizeof(*fmt));
316 fmt->width = width;
317 fmt->height = height;
318 fmt->field = V4L2_FIELD_NONE;
319 fmt->colorspace = V4L2_COLORSPACE_RAW;
320 t4ka3_set_bayer_order(sensor, fmt);
321 }
322
t4ka3_calc_mode(struct t4ka3_data * sensor,struct v4l2_mbus_framefmt * fmt,struct v4l2_rect * crop)323 static void t4ka3_calc_mode(struct t4ka3_data *sensor,
324 struct v4l2_mbus_framefmt *fmt,
325 struct v4l2_rect *crop)
326 {
327 int width;
328 int height;
329 int binning;
330
331 width = fmt->width;
332 height = fmt->height;
333
334 if (width <= (crop->width / 2) && height <= (crop->height / 2))
335 binning = 2;
336 else
337 binning = 1;
338
339 width *= binning;
340 height *= binning;
341
342 sensor->mode.binning = binning;
343 sensor->mode.win_x = (crop->left + (crop->width - width) / 2) & ~1;
344 sensor->mode.win_y = (crop->top + (crop->height - height) / 2) & ~1;
345 /*
346 * t4ka3's window is done after binning, but must still be a
347 * multiple of 2 ?
348 * Round up to avoid top 2 black lines in 1640x1230 (quarter res) case.
349 */
350 sensor->mode.win_x = DIV_ROUND_UP(sensor->mode.win_x, binning);
351 sensor->mode.win_y = DIV_ROUND_UP(sensor->mode.win_y, binning);
352 }
353
t4ka3_get_vblank_limits(struct t4ka3_data * sensor,struct v4l2_subdev_state * state,int * min,int * max,int * def)354 static void t4ka3_get_vblank_limits(struct t4ka3_data *sensor,
355 struct v4l2_subdev_state *state,
356 int *min, int *max, int *def)
357 {
358 struct v4l2_mbus_framefmt *fmt = v4l2_subdev_state_get_format(state, 0);
359
360 *min = T4KA3_MIN_VBLANK + (sensor->mode.binning - 1) * fmt->height;
361 *max = T4KA3_MAX_VBLANK - fmt->height;
362 *def = T4KA3_LINES_PER_FRAME_30FPS - fmt->height;
363 }
364
t4ka3_set_pad_format(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_format * format)365 static int t4ka3_set_pad_format(struct v4l2_subdev *sd,
366 struct v4l2_subdev_state *sd_state,
367 struct v4l2_subdev_format *format)
368 {
369 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
370 struct v4l2_mbus_framefmt *fmt = &format->format;
371 struct v4l2_rect *crop =
372 v4l2_subdev_state_get_crop(sd_state, format->pad);
373 unsigned int width, height;
374 int min, max, def, ret = 0;
375
376 /* Limit set_fmt max size to crop width / height */
377 width = clamp_val(ALIGN(format->format.width, 2),
378 T4KA3_MIN_CROP_WIDTH, crop->width);
379 height = clamp_val(ALIGN(format->format.height, 2),
380 T4KA3_MIN_CROP_HEIGHT, crop->height);
381 t4ka3_fill_format(sensor, &format->format, width, height);
382
383 if (format->which == V4L2_SUBDEV_FORMAT_ACTIVE && sensor->streaming)
384 return -EBUSY;
385
386 *v4l2_subdev_state_get_format(sd_state, 0) = format->format;
387
388 if (format->which == V4L2_SUBDEV_FORMAT_TRY)
389 return 0;
390
391 t4ka3_calc_mode(sensor, fmt, crop);
392
393 /* vblank range is height dependent adjust and reset to default */
394 t4ka3_get_vblank_limits(sensor, sd_state, &min, &max, &def);
395 ret = __v4l2_ctrl_modify_range(sensor->ctrls.vblank, min, max, 1, def);
396 if (ret)
397 return ret;
398
399 ret = __v4l2_ctrl_s_ctrl(sensor->ctrls.vblank, def);
400 if (ret)
401 return ret;
402
403 def = T4KA3_PIXELS_PER_LINE - fmt->width;
404 ret = __v4l2_ctrl_modify_range(sensor->ctrls.hblank, def, def, 1, def);
405 if (ret)
406 return ret;
407
408 return __v4l2_ctrl_s_ctrl(sensor->ctrls.hblank, def);
409 }
410
411 /* Horizontal or vertically flip the image */
t4ka3_update_flip(struct v4l2_subdev * sd,struct v4l2_mbus_framefmt * fmt,int value,u8 flip_bit)412 static int t4ka3_update_flip(struct v4l2_subdev *sd,
413 struct v4l2_mbus_framefmt *fmt,
414 int value, u8 flip_bit)
415 {
416 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
417 int ret;
418 u64 val;
419
420 if (sensor->streaming)
421 return -EBUSY;
422
423 val = value ? flip_bit : 0;
424
425 ret = cci_update_bits(sensor->regmap, T4KA3_REG_IMG_ORIENTATION,
426 flip_bit, val, NULL);
427 if (ret)
428 return ret;
429
430 t4ka3_set_bayer_order(sensor, fmt);
431
432 return 0;
433 }
434
t4ka3_test_pattern(struct t4ka3_data * sensor,s32 value)435 static int t4ka3_test_pattern(struct t4ka3_data *sensor, s32 value)
436 {
437 return cci_write(sensor->regmap, T4KA3_REG_TEST_PATTERN_MODE,
438 value, NULL);
439 }
440
t4ka3_detect(struct t4ka3_data * sensor,u16 * id)441 static int t4ka3_detect(struct t4ka3_data *sensor, u16 *id)
442 {
443 struct i2c_client *client = v4l2_get_subdevdata(&sensor->sd);
444 struct i2c_adapter *adapter = client->adapter;
445 u64 high, low;
446 int ret = 0;
447
448 /* i2c check */
449 if (!i2c_check_functionality(adapter, I2C_FUNC_I2C))
450 return -ENODEV;
451
452 /* check sensor chip ID */
453 cci_read(sensor->regmap, T4KA3_REG_PRODUCT_ID_HIGH, &high, &ret);
454 cci_read(sensor->regmap, T4KA3_REG_PRODUCT_ID_LOW, &low, &ret);
455 if (ret)
456 return ret;
457
458 *id = (((u8)high) << 8) | (u8)low;
459 if (*id != T4KA3_PRODUCT_ID) {
460 dev_err(sensor->dev, "main sensor t4ka3 ID error\n");
461 return -ENODEV;
462 }
463
464 return 0;
465 }
466
t4ka3_s_ctrl(struct v4l2_ctrl * ctrl)467 static int t4ka3_s_ctrl(struct v4l2_ctrl *ctrl)
468 {
469 struct t4ka3_data *sensor = ctrl_to_t4ka3(ctrl);
470 struct v4l2_subdev_state *state =
471 v4l2_subdev_get_locked_active_state(&sensor->sd);
472 struct v4l2_mbus_framefmt *fmt =
473 v4l2_subdev_state_get_format(state, 0);
474 int ret;
475
476 /* Update exposure range on vblank changes */
477 if (ctrl->id == V4L2_CID_VBLANK) {
478 ret = t4ka3_update_exposure_range(sensor, fmt);
479 if (ret)
480 return ret;
481 }
482
483 /* Only apply changes to the controls if the device is powered up */
484 if (!pm_runtime_get_if_in_use(sensor->sd.dev))
485 return 0;
486
487 switch (ctrl->id) {
488 case V4L2_CID_TEST_PATTERN:
489 ret = t4ka3_test_pattern(sensor, ctrl->val);
490 break;
491 case V4L2_CID_VFLIP:
492 ret = t4ka3_update_flip(&sensor->sd, fmt,
493 ctrl->val, T4KA3_VFLIP_BIT);
494 break;
495 case V4L2_CID_HFLIP:
496 ret = t4ka3_update_flip(&sensor->sd, fmt,
497 ctrl->val, T4KA3_HFLIP_BIT);
498 break;
499 case V4L2_CID_VBLANK:
500 ret = cci_write(sensor->regmap, T4KA3_REG_FRAME_LENGTH_LINES,
501 fmt->height + ctrl->val, NULL);
502 break;
503 case V4L2_CID_EXPOSURE:
504 ret = cci_write(sensor->regmap,
505 T4KA3_REG_COARSE_INTEGRATION_TIME,
506 ctrl->val, NULL);
507 break;
508 case V4L2_CID_ANALOGUE_GAIN:
509 ret = cci_write(sensor->regmap, T4KA3_REG_GLOBAL_GAIN,
510 ctrl->val, NULL);
511 break;
512 default:
513 ret = -EINVAL;
514 break;
515 }
516
517 pm_runtime_put(sensor->sd.dev);
518
519 return ret;
520 }
521
t4ka3_set_mode(struct t4ka3_data * sensor,struct v4l2_subdev_state * state)522 static int t4ka3_set_mode(struct t4ka3_data *sensor,
523 struct v4l2_subdev_state *state)
524 {
525 struct v4l2_mbus_framefmt *fmt = v4l2_subdev_state_get_format(state, 0);
526 int ret = 0;
527
528 cci_write(sensor->regmap, T4KA3_REG_HORZ_OUTPUT_SIZE, fmt->width, &ret);
529 /* Write mode-height - 2 otherwise things don't work, hw-bug ? */
530 cci_write(sensor->regmap, T4KA3_REG_VERT_OUTPUT_SIZE,
531 fmt->height - 2, &ret);
532
533 cci_write(sensor->regmap, T4KA3_REG_PIXELS_PER_LINE,
534 T4KA3_PIXELS_PER_LINE, &ret);
535 /* Always use the full sensor, using window to crop */
536 cci_write(sensor->regmap, T4KA3_REG_HORZ_START, 0, &ret);
537 cci_write(sensor->regmap, T4KA3_REG_VERT_START, 0, &ret);
538 cci_write(sensor->regmap, T4KA3_REG_HORZ_END,
539 T4KA3_NATIVE_WIDTH - 1, &ret);
540 cci_write(sensor->regmap, T4KA3_REG_VERT_END,
541 T4KA3_NATIVE_HEIGHT - 1, &ret);
542 /* Set window */
543 cci_write(sensor->regmap, T4KA3_REG_WIN_START_X,
544 sensor->mode.win_x, &ret);
545 cci_write(sensor->regmap, T4KA3_REG_WIN_START_Y,
546 sensor->mode.win_y, &ret);
547 cci_write(sensor->regmap, T4KA3_REG_WIN_WIDTH, fmt->width, &ret);
548 cci_write(sensor->regmap, T4KA3_REG_WIN_HEIGHT, fmt->height, &ret);
549 /* Write 1 to unknown register 0x0900 */
550 cci_write(sensor->regmap, T4KA3_REG_0900, 1, &ret);
551 cci_write(sensor->regmap, T4KA3_REG_BINNING,
552 T4KA3_BINNING_VAL(sensor->mode.binning), &ret);
553
554 return ret;
555 }
556
t4ka3_enable_stream(struct v4l2_subdev * sd,struct v4l2_subdev_state * state,u32 pad,u64 streams_mask)557 static int t4ka3_enable_stream(struct v4l2_subdev *sd,
558 struct v4l2_subdev_state *state,
559 u32 pad, u64 streams_mask)
560 {
561 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
562 int ret;
563
564 ret = pm_runtime_get_sync(sensor->sd.dev);
565 if (ret < 0) {
566 dev_err(sensor->dev, "power-up err.\n");
567 goto error_powerdown;
568 }
569
570 cci_multi_reg_write(sensor->regmap, t4ka3_init_config,
571 ARRAY_SIZE(t4ka3_init_config), &ret);
572 /* enable group hold */
573 cci_write(sensor->regmap, T4KA3_REG_PARAM_HOLD, 1, &ret);
574 cci_multi_reg_write(sensor->regmap, t4ka3_pre_mode_set_regs,
575 ARRAY_SIZE(t4ka3_pre_mode_set_regs), &ret);
576 if (ret)
577 goto error_powerdown;
578
579 ret = t4ka3_set_mode(sensor, state);
580 if (ret)
581 goto error_powerdown;
582
583 ret = cci_multi_reg_write(sensor->regmap, t4ka3_post_mode_set_regs,
584 ARRAY_SIZE(t4ka3_post_mode_set_regs), NULL);
585 if (ret)
586 goto error_powerdown;
587
588 /* Restore value of all ctrls */
589 ret = __v4l2_ctrl_handler_setup(&sensor->ctrls.handler);
590 if (ret)
591 goto error_powerdown;
592
593 /* disable group hold */
594 cci_write(sensor->regmap, T4KA3_REG_PARAM_HOLD, 0, &ret);
595 cci_write(sensor->regmap, T4KA3_REG_STREAM, 1, &ret);
596 if (ret)
597 goto error_powerdown;
598
599 sensor->streaming = 1;
600
601 return ret;
602
603 error_powerdown:
604 pm_runtime_put(sensor->sd.dev);
605
606 return ret;
607 }
608
t4ka3_disable_stream(struct v4l2_subdev * sd,struct v4l2_subdev_state * state,u32 pad,u64 streams_mask)609 static int t4ka3_disable_stream(struct v4l2_subdev *sd,
610 struct v4l2_subdev_state *state,
611 u32 pad, u64 streams_mask)
612 {
613 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
614 int ret;
615
616 ret = cci_write(sensor->regmap, T4KA3_REG_STREAM, 0, NULL);
617 pm_runtime_put(sensor->sd.dev);
618 sensor->streaming = 0;
619
620 if (ret)
621 dev_err(sensor->dev,
622 "failed to disable stream with return value: %d\n",
623 ret);
624
625 return 0;
626 }
627
t4ka3_get_selection(struct v4l2_subdev * sd,struct v4l2_subdev_state * state,struct v4l2_subdev_selection * sel)628 static int t4ka3_get_selection(struct v4l2_subdev *sd,
629 struct v4l2_subdev_state *state,
630 struct v4l2_subdev_selection *sel)
631 {
632 switch (sel->target) {
633 case V4L2_SEL_TGT_CROP:
634 sel->r = *v4l2_subdev_state_get_crop(state, sel->pad);
635 break;
636 case V4L2_SEL_TGT_NATIVE_SIZE:
637 case V4L2_SEL_TGT_CROP_BOUNDS:
638 sel->r.top = 0;
639 sel->r.left = 0;
640 sel->r.width = T4KA3_NATIVE_WIDTH;
641 sel->r.height = T4KA3_NATIVE_HEIGHT;
642 break;
643 case V4L2_SEL_TGT_CROP_DEFAULT:
644 sel->r = t4ka3_default_crop;
645 break;
646 default:
647 return -EINVAL;
648 }
649
650 return 0;
651 }
652
t4ka3_set_selection(struct v4l2_subdev * sd,struct v4l2_subdev_state * state,struct v4l2_subdev_selection * sel)653 static int t4ka3_set_selection(struct v4l2_subdev *sd,
654 struct v4l2_subdev_state *state,
655 struct v4l2_subdev_selection *sel)
656 {
657 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
658 struct v4l2_mbus_framefmt *format;
659 struct v4l2_rect *crop;
660 struct v4l2_rect rect;
661
662 if (sel->target != V4L2_SEL_TGT_CROP)
663 return -EINVAL;
664
665 /*
666 * Clamp the boundaries of the crop rectangle to the size of the sensor
667 * pixel array. Align to multiples of 2 to ensure Bayer pattern isn't
668 * disrupted.
669 */
670 rect.left = clamp_val(ALIGN(sel->r.left, 2),
671 T4KA3_NATIVE_START_LEFT, T4KA3_NATIVE_WIDTH);
672 rect.top = clamp_val(ALIGN(sel->r.top, 2),
673 T4KA3_NATIVE_START_TOP, T4KA3_NATIVE_HEIGHT);
674 rect.width = clamp_val(ALIGN(sel->r.width, 2), T4KA3_MIN_CROP_WIDTH,
675 T4KA3_NATIVE_WIDTH - rect.left);
676 rect.height = clamp_val(ALIGN(sel->r.height, 2), T4KA3_MIN_CROP_HEIGHT,
677 T4KA3_NATIVE_HEIGHT - rect.top);
678
679 crop = v4l2_subdev_state_get_crop(state, sel->pad);
680
681 if (rect.width != crop->width || rect.height != crop->height) {
682 /*
683 * Reset the output image size if the crop rectangle size has
684 * been modified.
685 */
686 format = v4l2_subdev_state_get_format(state, sel->pad);
687 format->width = rect.width;
688 format->height = rect.height;
689 if (sel->which == V4L2_SUBDEV_FORMAT_ACTIVE)
690 t4ka3_calc_mode(sensor, format, crop);
691 }
692
693 sel->r = *crop = rect;
694
695 return 0;
696 }
697
698 static int
t4ka3_enum_mbus_code(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_mbus_code_enum * code)699 t4ka3_enum_mbus_code(struct v4l2_subdev *sd,
700 struct v4l2_subdev_state *sd_state,
701 struct v4l2_subdev_mbus_code_enum *code)
702 {
703 if (code->index)
704 return -EINVAL;
705
706 code->code = MEDIA_BUS_FMT_SGRBG10_1X10;
707
708 return 0;
709 }
710
t4ka3_enum_frame_size(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state,struct v4l2_subdev_frame_size_enum * fse)711 static int t4ka3_enum_frame_size(struct v4l2_subdev *sd,
712 struct v4l2_subdev_state *sd_state,
713 struct v4l2_subdev_frame_size_enum *fse)
714 {
715 struct v4l2_rect *crop;
716
717 if (fse->index >= T4KA3_FRAME_SIZES)
718 return -EINVAL;
719
720 crop = v4l2_subdev_state_get_crop(sd_state, fse->pad);
721
722 fse->min_width = crop->width / (fse->index + 1);
723 fse->min_height = crop->height / (fse->index + 1);
724 fse->max_width = fse->min_width;
725 fse->max_height = fse->min_height;
726
727 return 0;
728 }
729
t4ka3_check_hwcfg(struct t4ka3_data * sensor)730 static int t4ka3_check_hwcfg(struct t4ka3_data *sensor)
731 {
732 struct fwnode_handle *fwnode = dev_fwnode(sensor->dev);
733 struct v4l2_fwnode_endpoint bus_cfg = {
734 .bus_type = V4L2_MBUS_CSI2_DPHY,
735 };
736 struct fwnode_handle *endpoint;
737 unsigned long link_freq_bitmap;
738 int ret;
739
740 endpoint = fwnode_graph_get_next_endpoint(fwnode, NULL);
741
742 ret = v4l2_fwnode_endpoint_alloc_parse(endpoint, &bus_cfg);
743 fwnode_handle_put(endpoint);
744 if (ret)
745 return ret;
746
747 ret = v4l2_link_freq_to_bitmap(sensor->dev, bus_cfg.link_frequencies,
748 bus_cfg.nr_of_link_frequencies,
749 link_freq_menu_items,
750 ARRAY_SIZE(link_freq_menu_items),
751 &link_freq_bitmap);
752
753 if (ret < 0)
754 goto out_free_bus_cfg;
755
756 sensor->link_freq_index = ffs(link_freq_bitmap) - 1;
757
758 /* 4 MIPI lanes */
759 if (bus_cfg.bus.mipi_csi2.num_data_lanes != 4) {
760 ret = dev_err_probe(sensor->dev, -EINVAL,
761 "number of CSI2 data lanes %u is not supported\n",
762 bus_cfg.bus.mipi_csi2.num_data_lanes);
763 goto out_free_bus_cfg;
764 }
765
766 sensor->mipi_lanes = bus_cfg.bus.mipi_csi2.num_data_lanes;
767
768 out_free_bus_cfg:
769 v4l2_fwnode_endpoint_free(&bus_cfg);
770
771 return ret;
772 }
773
t4ka3_init_state(struct v4l2_subdev * sd,struct v4l2_subdev_state * sd_state)774 static int t4ka3_init_state(struct v4l2_subdev *sd,
775 struct v4l2_subdev_state *sd_state)
776 {
777 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
778
779 *v4l2_subdev_state_get_crop(sd_state, 0) = t4ka3_default_crop;
780
781 t4ka3_fill_format(sensor, v4l2_subdev_state_get_format(sd_state, 0),
782 T4KA3_ACTIVE_WIDTH, T4KA3_ACTIVE_HEIGHT);
783 return 0;
784 }
785
786 static const struct v4l2_ctrl_ops t4ka3_ctrl_ops = {
787 .s_ctrl = t4ka3_s_ctrl,
788 };
789
790 static const struct v4l2_subdev_video_ops t4ka3_video_ops = {
791 .s_stream = v4l2_subdev_s_stream_helper,
792 };
793
794 static const struct v4l2_subdev_pad_ops t4ka3_pad_ops = {
795 .enum_mbus_code = t4ka3_enum_mbus_code,
796 .enum_frame_size = t4ka3_enum_frame_size,
797 .get_fmt = v4l2_subdev_get_fmt,
798 .set_fmt = t4ka3_set_pad_format,
799 .get_selection = t4ka3_get_selection,
800 .set_selection = t4ka3_set_selection,
801 .enable_streams = t4ka3_enable_stream,
802 .disable_streams = t4ka3_disable_stream,
803 };
804
805 static const struct v4l2_subdev_ops t4ka3_ops = {
806 .video = &t4ka3_video_ops,
807 .pad = &t4ka3_pad_ops,
808 };
809
810 static const struct v4l2_subdev_internal_ops t4ka3_internal_ops = {
811 .init_state = t4ka3_init_state,
812 };
813
t4ka3_init_controls(struct t4ka3_data * sensor)814 static int t4ka3_init_controls(struct t4ka3_data *sensor)
815 {
816 const struct v4l2_ctrl_ops *ops = &t4ka3_ctrl_ops;
817 struct t4ka3_ctrls *ctrls = &sensor->ctrls;
818 struct v4l2_subdev_state *state;
819 struct v4l2_mbus_framefmt *fmt;
820 struct v4l2_rect *crop;
821 struct v4l2_ctrl_handler *hdl = &ctrls->handler;
822 struct v4l2_fwnode_device_properties props;
823 int ret, min, max, def;
824 static const char * const test_pattern_menu[] = {
825 "Disabled",
826 "Solid White",
827 "Color Bars",
828 "Gradient",
829 "Random Data",
830 };
831
832 v4l2_ctrl_handler_init(hdl, 11);
833
834 hdl->lock = &sensor->lock;
835
836 ctrls->vflip = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_VFLIP, 0, 1, 1, 0);
837 ctrls->hflip = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_HFLIP, 0, 1, 1, 0);
838
839 ctrls->test_pattern =
840 v4l2_ctrl_new_std_menu_items(hdl, ops,
841 V4L2_CID_TEST_PATTERN,
842 ARRAY_SIZE(test_pattern_menu) - 1,
843 0, 0, test_pattern_menu);
844 ctrls->link_freq = v4l2_ctrl_new_int_menu(hdl, NULL,
845 V4L2_CID_LINK_FREQ,
846 0, 0, link_freq_menu_items);
847 ctrls->pixel_rate = v4l2_ctrl_new_std(hdl, NULL, V4L2_CID_PIXEL_RATE,
848 0, T4KA3_PIXEL_RATE,
849 1, T4KA3_PIXEL_RATE);
850
851 state = v4l2_subdev_lock_and_get_active_state(&sensor->sd);
852 fmt = v4l2_subdev_state_get_format(state, 0);
853 crop = v4l2_subdev_state_get_crop(state, 0);
854
855 t4ka3_calc_mode(sensor, fmt, crop);
856 t4ka3_get_vblank_limits(sensor, state, &min, &max, &def);
857
858 v4l2_subdev_unlock_state(state);
859
860 ctrls->vblank = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_VBLANK,
861 min, max, 1, def);
862
863 def = T4KA3_PIXELS_PER_LINE - T4KA3_ACTIVE_WIDTH;
864 ctrls->hblank = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_HBLANK,
865 def, def, 1, def);
866
867 max = T4KA3_LINES_PER_FRAME_30FPS -
868 T4KA3_COARSE_INTEGRATION_TIME_MARGIN;
869 ctrls->exposure = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_EXPOSURE,
870 0, max, 1, max);
871
872 ctrls->gain = v4l2_ctrl_new_std(hdl, ops, V4L2_CID_ANALOGUE_GAIN,
873 T4KA3_MIN_GLOBAL_GAIN_SUPPORTED,
874 T4KA3_MAX_GLOBAL_GAIN_SUPPORTED,
875 1, T4KA3_MIN_GLOBAL_GAIN_SUPPORTED);
876
877 ret = v4l2_fwnode_device_parse(sensor->dev, &props);
878 if (ret)
879 return ret;
880
881 v4l2_ctrl_new_fwnode_properties(hdl, ops, &props);
882
883 if (hdl->error)
884 return hdl->error;
885
886 ctrls->vflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
887 ctrls->hflip->flags |= V4L2_CTRL_FLAG_MODIFY_LAYOUT;
888 ctrls->link_freq->flags |= V4L2_CTRL_FLAG_READ_ONLY;
889 ctrls->hblank->flags |= V4L2_CTRL_FLAG_READ_ONLY;
890
891 sensor->sd.ctrl_handler = hdl;
892
893 return 0;
894 }
895
t4ka3_pm_suspend(struct device * dev)896 static int t4ka3_pm_suspend(struct device *dev)
897 {
898 struct t4ka3_data *sensor = dev_get_drvdata(dev);
899
900 gpiod_set_value_cansleep(sensor->powerdown_gpio, 1);
901 gpiod_set_value_cansleep(sensor->reset_gpio, 1);
902
903 return 0;
904 }
905
t4ka3_pm_resume(struct device * dev)906 static int t4ka3_pm_resume(struct device *dev)
907 {
908 struct t4ka3_data *sensor = dev_get_drvdata(dev);
909 u16 sensor_id;
910 int ret;
911
912 usleep_range(5000, 6000);
913
914 gpiod_set_value_cansleep(sensor->powerdown_gpio, 0);
915 gpiod_set_value_cansleep(sensor->reset_gpio, 0);
916
917 /* waiting for the sensor after powering up */
918 fsleep(20000);
919
920 ret = t4ka3_detect(sensor, &sensor_id);
921 if (ret) {
922 dev_err(sensor->dev, "sensor detect failed\n");
923 gpiod_set_value_cansleep(sensor->powerdown_gpio, 1);
924 gpiod_set_value_cansleep(sensor->reset_gpio, 1);
925
926 return ret;
927 }
928
929 return 0;
930 }
931
932 static DEFINE_RUNTIME_DEV_PM_OPS(t4ka3_pm_ops, t4ka3_pm_suspend,
933 t4ka3_pm_resume, NULL);
934
t4ka3_remove(struct i2c_client * client)935 static void t4ka3_remove(struct i2c_client *client)
936 {
937 struct v4l2_subdev *sd = i2c_get_clientdata(client);
938 struct t4ka3_data *sensor = to_t4ka3_sensor(sd);
939
940 v4l2_async_unregister_subdev(&sensor->sd);
941 v4l2_ctrl_handler_free(&sensor->ctrls.handler);
942 v4l2_subdev_cleanup(sd);
943 media_entity_cleanup(&sensor->sd.entity);
944
945 /*
946 * Disable runtime PM. In case runtime PM is disabled in the kernel,
947 * make sure to turn power off manually.
948 */
949 pm_runtime_disable(&client->dev);
950 if (!pm_runtime_status_suspended(&client->dev))
951 t4ka3_pm_suspend(&client->dev);
952 pm_runtime_set_suspended(&client->dev);
953 }
954
t4ka3_probe(struct i2c_client * client)955 static int t4ka3_probe(struct i2c_client *client)
956 {
957 struct t4ka3_data *sensor;
958 int ret;
959
960 /* allocate sensor device & init sub device */
961 sensor = devm_kzalloc(&client->dev, sizeof(*sensor), GFP_KERNEL);
962 if (!sensor)
963 return -ENOMEM;
964
965 sensor->dev = &client->dev;
966
967 ret = t4ka3_check_hwcfg(sensor);
968 if (ret)
969 return ret;
970
971 mutex_init(&sensor->lock);
972
973 v4l2_i2c_subdev_init(&sensor->sd, client, &t4ka3_ops);
974 sensor->sd.internal_ops = &t4ka3_internal_ops;
975
976 sensor->powerdown_gpio = devm_gpiod_get(&client->dev, "powerdown",
977 GPIOD_OUT_HIGH);
978 if (IS_ERR(sensor->powerdown_gpio))
979 return dev_err_probe(&client->dev,
980 PTR_ERR(sensor->powerdown_gpio),
981 "getting powerdown GPIO\n");
982
983 sensor->reset_gpio = devm_gpiod_get_optional(&client->dev, "reset",
984 GPIOD_OUT_HIGH);
985 if (IS_ERR(sensor->reset_gpio))
986 return dev_err_probe(&client->dev, PTR_ERR(sensor->reset_gpio),
987 "getting reset GPIO\n");
988
989 sensor->regmap = devm_cci_regmap_init_i2c(client, 16);
990 if (IS_ERR(sensor->regmap))
991 return PTR_ERR(sensor->regmap);
992
993 ret = t4ka3_pm_resume(sensor->dev);
994 if (ret)
995 return ret;
996
997 pm_runtime_set_active(&client->dev);
998 pm_runtime_enable(&client->dev);
999
1000 sensor->sd.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
1001 sensor->pad.flags = MEDIA_PAD_FL_SOURCE;
1002 sensor->sd.entity.function = MEDIA_ENT_F_CAM_SENSOR;
1003
1004 ret = media_entity_pads_init(&sensor->sd.entity, 1, &sensor->pad);
1005 if (ret)
1006 goto err_pm_disable;
1007
1008 sensor->sd.state_lock = sensor->ctrls.handler.lock;
1009 ret = v4l2_subdev_init_finalize(&sensor->sd);
1010 if (ret < 0) {
1011 dev_err(&client->dev, "failed to init subdev: %d", ret);
1012 goto err_media_entity;
1013 }
1014
1015 ret = t4ka3_init_controls(sensor);
1016 if (ret)
1017 goto err_controls;
1018
1019 ret = v4l2_async_register_subdev_sensor(&sensor->sd);
1020 if (ret)
1021 goto err_controls;
1022
1023 pm_runtime_set_autosuspend_delay(&client->dev, 1000);
1024 pm_runtime_idle(&client->dev);
1025
1026 return 0;
1027
1028 err_controls:
1029 v4l2_ctrl_handler_free(&sensor->ctrls.handler);
1030 v4l2_subdev_cleanup(&sensor->sd);
1031
1032 err_media_entity:
1033 media_entity_cleanup(&sensor->sd.entity);
1034
1035 err_pm_disable:
1036 pm_runtime_disable(&client->dev);
1037 pm_runtime_put_noidle(&client->dev);
1038 t4ka3_pm_suspend(&client->dev);
1039
1040 return ret;
1041 }
1042
1043 static const struct acpi_device_id t4ka3_acpi_match[] = {
1044 { "XMCC0003" },
1045 {}
1046 };
1047 MODULE_DEVICE_TABLE(acpi, t4ka3_acpi_match);
1048
1049 static struct i2c_driver t4ka3_driver = {
1050 .driver = {
1051 .name = "t4ka3",
1052 .acpi_match_table = ACPI_PTR(t4ka3_acpi_match),
1053 .pm = pm_sleep_ptr(&t4ka3_pm_ops),
1054 },
1055 .probe = t4ka3_probe,
1056 .remove = t4ka3_remove,
1057 };
1058 module_i2c_driver(t4ka3_driver)
1059
1060 MODULE_DESCRIPTION("A low-level driver for T4KA3 sensor");
1061 MODULE_AUTHOR("HARVEY LV <harvey.lv@intel.com>");
1062 MODULE_AUTHOR("Kate Hsuan <hpa@redhat.com>");
1063 MODULE_LICENSE("GPL");
1064