1 // SPDX-License-Identifier: GPL-2.0-only
3 * Driver for MT9V022, MT9V024, MT9V032, and MT9V034 CMOS Image Sensors
7 * Based on the MT9M001 driver,
12 #include <linux/clk.h>
13 #include <linux/delay.h>
14 #include <linux/gpio/consumer.h>
15 #include <linux/i2c.h>
16 #include <linux/log2.h>
17 #include <linux/mutex.h>
19 #include <linux/of_graph.h>
20 #include <linux/regmap.h>
21 #include <linux/slab.h>
22 #include <linux/videodev2.h>
23 #include <linux/v4l2-mediabus.h>
24 #include <linux/module.h>
26 #include <media/i2c/mt9v032.h>
27 #include <media/v4l2-ctrls.h>
28 #include <media/v4l2-device.h>
29 #include <media/v4l2-fwnode.h>
30 #include <media/v4l2-subdev.h>
32 /* The first four rows are black rows. The active area spans 753x481 pixels. */
33 #define MT9V032_PIXEL_ARRAY_HEIGHT 485
34 #define MT9V032_PIXEL_ARRAY_WIDTH 753
36 #define MT9V032_SYSCLK_FREQ_DEF 26600000
38 #define MT9V032_CHIP_VERSION 0x00
39 #define MT9V032_CHIP_ID_REV1 0x1311
40 #define MT9V032_CHIP_ID_REV3 0x1313
41 #define MT9V034_CHIP_ID_REV1 0X1324
42 #define MT9V032_COLUMN_START 0x01
43 #define MT9V032_COLUMN_START_MIN 1
44 #define MT9V032_COLUMN_START_DEF 1
45 #define MT9V032_COLUMN_START_MAX 752
46 #define MT9V032_ROW_START 0x02
47 #define MT9V032_ROW_START_MIN 4
48 #define MT9V032_ROW_START_DEF 5
49 #define MT9V032_ROW_START_MAX 482
50 #define MT9V032_WINDOW_HEIGHT 0x03
51 #define MT9V032_WINDOW_HEIGHT_MIN 1
52 #define MT9V032_WINDOW_HEIGHT_DEF 480
53 #define MT9V032_WINDOW_HEIGHT_MAX 480
54 #define MT9V032_WINDOW_WIDTH 0x04
55 #define MT9V032_WINDOW_WIDTH_MIN 1
56 #define MT9V032_WINDOW_WIDTH_DEF 752
57 #define MT9V032_WINDOW_WIDTH_MAX 752
58 #define MT9V032_HORIZONTAL_BLANKING 0x05
59 #define MT9V032_HORIZONTAL_BLANKING_MIN 43
60 #define MT9V034_HORIZONTAL_BLANKING_MIN 61
61 #define MT9V032_HORIZONTAL_BLANKING_DEF 94
62 #define MT9V032_HORIZONTAL_BLANKING_MAX 1023
63 #define MT9V032_VERTICAL_BLANKING 0x06
64 #define MT9V032_VERTICAL_BLANKING_MIN 4
65 #define MT9V034_VERTICAL_BLANKING_MIN 2
66 #define MT9V032_VERTICAL_BLANKING_DEF 45
67 #define MT9V032_VERTICAL_BLANKING_MAX 3000
68 #define MT9V034_VERTICAL_BLANKING_MAX 32288
69 #define MT9V032_CHIP_CONTROL 0x07
70 #define MT9V032_CHIP_CONTROL_MASTER_MODE (1 << 3)
71 #define MT9V032_CHIP_CONTROL_DOUT_ENABLE (1 << 7)
72 #define MT9V032_CHIP_CONTROL_SEQUENTIAL (1 << 8)
73 #define MT9V032_SHUTTER_WIDTH1 0x08
74 #define MT9V032_SHUTTER_WIDTH2 0x09
75 #define MT9V032_SHUTTER_WIDTH_CONTROL 0x0a
76 #define MT9V032_TOTAL_SHUTTER_WIDTH 0x0b
77 #define MT9V032_TOTAL_SHUTTER_WIDTH_MIN 1
78 #define MT9V034_TOTAL_SHUTTER_WIDTH_MIN 0
79 #define MT9V032_TOTAL_SHUTTER_WIDTH_DEF 480
80 #define MT9V032_TOTAL_SHUTTER_WIDTH_MAX 32767
81 #define MT9V034_TOTAL_SHUTTER_WIDTH_MAX 32765
82 #define MT9V032_RESET 0x0c
83 #define MT9V032_READ_MODE 0x0d
84 #define MT9V032_READ_MODE_ROW_BIN_MASK (3 << 0)
85 #define MT9V032_READ_MODE_ROW_BIN_SHIFT 0
86 #define MT9V032_READ_MODE_COLUMN_BIN_MASK (3 << 2)
87 #define MT9V032_READ_MODE_COLUMN_BIN_SHIFT 2
88 #define MT9V032_READ_MODE_ROW_FLIP (1 << 4)
89 #define MT9V032_READ_MODE_COLUMN_FLIP (1 << 5)
90 #define MT9V032_READ_MODE_DARK_COLUMNS (1 << 6)
91 #define MT9V032_READ_MODE_DARK_ROWS (1 << 7)
92 #define MT9V032_READ_MODE_RESERVED 0x0300
93 #define MT9V032_PIXEL_OPERATION_MODE 0x0f
94 #define MT9V034_PIXEL_OPERATION_MODE_HDR (1 << 0)
95 #define MT9V034_PIXEL_OPERATION_MODE_COLOR (1 << 1)
96 #define MT9V032_PIXEL_OPERATION_MODE_COLOR (1 << 2)
97 #define MT9V032_PIXEL_OPERATION_MODE_HDR (1 << 6)
98 #define MT9V032_ANALOG_GAIN 0x35
99 #define MT9V032_ANALOG_GAIN_MIN 16
100 #define MT9V032_ANALOG_GAIN_DEF 16
101 #define MT9V032_ANALOG_GAIN_MAX 64
102 #define MT9V032_MAX_ANALOG_GAIN 0x36
103 #define MT9V032_MAX_ANALOG_GAIN_MAX 127
104 #define MT9V032_FRAME_DARK_AVERAGE 0x42
105 #define MT9V032_DARK_AVG_THRESH 0x46
106 #define MT9V032_DARK_AVG_LOW_THRESH_MASK (255 << 0)
107 #define MT9V032_DARK_AVG_LOW_THRESH_SHIFT 0
108 #define MT9V032_DARK_AVG_HIGH_THRESH_MASK (255 << 8)
109 #define MT9V032_DARK_AVG_HIGH_THRESH_SHIFT 8
110 #define MT9V032_ROW_NOISE_CORR_CONTROL 0x70
111 #define MT9V034_ROW_NOISE_CORR_ENABLE (1 << 0)
112 #define MT9V034_ROW_NOISE_CORR_USE_BLK_AVG (1 << 1)
113 #define MT9V032_ROW_NOISE_CORR_ENABLE (1 << 5)
114 #define MT9V032_ROW_NOISE_CORR_USE_BLK_AVG (1 << 7)
115 #define MT9V032_PIXEL_CLOCK 0x74
116 #define MT9V034_PIXEL_CLOCK 0x72
117 #define MT9V032_PIXEL_CLOCK_INV_LINE (1 << 0)
118 #define MT9V032_PIXEL_CLOCK_INV_FRAME (1 << 1)
119 #define MT9V032_PIXEL_CLOCK_XOR_LINE (1 << 2)
120 #define MT9V032_PIXEL_CLOCK_CONT_LINE (1 << 3)
121 #define MT9V032_PIXEL_CLOCK_INV_PXL_CLK (1 << 4)
122 #define MT9V032_TEST_PATTERN 0x7f
123 #define MT9V032_TEST_PATTERN_DATA_MASK (1023 << 0)
124 #define MT9V032_TEST_PATTERN_DATA_SHIFT 0
125 #define MT9V032_TEST_PATTERN_USE_DATA (1 << 10)
126 #define MT9V032_TEST_PATTERN_GRAY_MASK (3 << 11)
127 #define MT9V032_TEST_PATTERN_GRAY_NONE (0 << 11)
128 #define MT9V032_TEST_PATTERN_GRAY_VERTICAL (1 << 11)
129 #define MT9V032_TEST_PATTERN_GRAY_HORIZONTAL (2 << 11)
130 #define MT9V032_TEST_PATTERN_GRAY_DIAGONAL (3 << 11)
131 #define MT9V032_TEST_PATTERN_ENABLE (1 << 13)
132 #define MT9V032_TEST_PATTERN_FLIP (1 << 14)
133 #define MT9V032_AEGC_DESIRED_BIN 0xa5
134 #define MT9V032_AEC_UPDATE_FREQUENCY 0xa6
135 #define MT9V032_AEC_LPF 0xa8
136 #define MT9V032_AGC_UPDATE_FREQUENCY 0xa9
137 #define MT9V032_AGC_LPF 0xaa
138 #define MT9V032_AEC_AGC_ENABLE 0xaf
139 #define MT9V032_AEC_ENABLE (1 << 0)
140 #define MT9V032_AGC_ENABLE (1 << 1)
141 #define MT9V034_AEC_MAX_SHUTTER_WIDTH 0xad
142 #define MT9V032_AEC_MAX_SHUTTER_WIDTH 0xbd
143 #define MT9V032_THERMAL_INFO 0xc1
146 MT9V032_MODEL_V022_COLOR, /* MT9V022IX7ATC */
147 MT9V032_MODEL_V022_MONO, /* MT9V022IX7ATM */
148 MT9V032_MODEL_V024_COLOR, /* MT9V024IA7XTC */
149 MT9V032_MODEL_V024_MONO, /* MT9V024IA7XTM */
150 MT9V032_MODEL_V032_COLOR, /* MT9V032C12STM */
151 MT9V032_MODEL_V032_MONO, /* MT9V032C12STC */
152 MT9V032_MODEL_V034_COLOR,
153 MT9V032_MODEL_V034_MONO,
156 struct mt9v032_model_version {
157 unsigned int version;
161 struct mt9v032_model_data {
162 unsigned int min_row_time;
163 unsigned int min_hblank;
164 unsigned int min_vblank;
165 unsigned int max_vblank;
166 unsigned int min_shutter;
167 unsigned int max_shutter;
168 unsigned int pclk_reg;
169 unsigned int aec_max_shutter_reg;
170 const struct v4l2_ctrl_config * const aec_max_shutter_v4l2_ctrl;
173 struct mt9v032_model_info {
174 const struct mt9v032_model_data *data;
178 static const struct mt9v032_model_version mt9v032_versions[] = {
179 { MT9V032_CHIP_ID_REV1, "MT9V022/MT9V032 rev1/2" },
180 { MT9V032_CHIP_ID_REV3, "MT9V022/MT9V032 rev3" },
181 { MT9V034_CHIP_ID_REV1, "MT9V024/MT9V034 rev1" },
185 struct v4l2_subdev subdev;
186 struct media_pad pad;
188 struct v4l2_mbus_framefmt format;
189 struct v4l2_rect crop;
193 struct v4l2_ctrl_handler ctrls;
195 struct v4l2_ctrl *link_freq;
196 struct v4l2_ctrl *pixel_rate;
199 struct mutex power_lock;
202 struct regmap *regmap;
204 struct gpio_desc *reset_gpio;
205 struct gpio_desc *standby_gpio;
207 struct mt9v032_platform_data *pdata;
208 const struct mt9v032_model_info *model;
209 const struct mt9v032_model_version *version;
215 struct v4l2_ctrl *test_pattern;
216 struct v4l2_ctrl *test_pattern_color;
220 static struct mt9v032 *to_mt9v032(struct v4l2_subdev *sd)
222 return container_of(sd, struct mt9v032, subdev);
226 mt9v032_update_aec_agc(struct mt9v032 *mt9v032, u16 which, int enable)
228 struct regmap *map = mt9v032->regmap;
229 u16 value = mt9v032->aec_agc;
237 ret = regmap_write(map, MT9V032_AEC_AGC_ENABLE, value);
241 mt9v032->aec_agc = value;
246 mt9v032_update_hblank(struct mt9v032 *mt9v032)
248 struct v4l2_rect *crop = &mt9v032->crop;
249 unsigned int min_hblank = mt9v032->model->data->min_hblank;
252 if (mt9v032->version->version == MT9V034_CHIP_ID_REV1)
253 min_hblank += (mt9v032->hratio - 1) * 10;
254 min_hblank = max_t(int, mt9v032->model->data->min_row_time - crop->width,
256 hblank = max_t(unsigned int, mt9v032->hblank, min_hblank);
258 return regmap_write(mt9v032->regmap, MT9V032_HORIZONTAL_BLANKING,
262 static int mt9v032_power_on(struct mt9v032 *mt9v032)
264 struct regmap *map = mt9v032->regmap;
267 gpiod_set_value_cansleep(mt9v032->reset_gpio, 1);
269 ret = clk_set_rate(mt9v032->clk, mt9v032->sysclk);
273 /* System clock has to be enabled before releasing the reset */
274 ret = clk_prepare_enable(mt9v032->clk);
280 if (mt9v032->reset_gpio) {
281 gpiod_set_value_cansleep(mt9v032->reset_gpio, 0);
283 /* After releasing reset we need to wait 10 clock cycles
284 * before accessing the sensor over I2C. As the minimum SYSCLK
285 * frequency is 13MHz, waiting 1µs will be enough in the worst
291 /* Reset the chip and stop data read out */
292 ret = regmap_write(map, MT9V032_RESET, 1);
296 ret = regmap_write(map, MT9V032_RESET, 0);
300 ret = regmap_write(map, MT9V032_CHIP_CONTROL,
301 MT9V032_CHIP_CONTROL_MASTER_MODE);
308 clk_disable_unprepare(mt9v032->clk);
312 static void mt9v032_power_off(struct mt9v032 *mt9v032)
314 clk_disable_unprepare(mt9v032->clk);
317 static int __mt9v032_set_power(struct mt9v032 *mt9v032, bool on)
319 struct regmap *map = mt9v032->regmap;
323 mt9v032_power_off(mt9v032);
327 ret = mt9v032_power_on(mt9v032);
331 /* Configure the pixel clock polarity */
332 if (mt9v032->pdata && mt9v032->pdata->clk_pol) {
333 ret = regmap_write(map, mt9v032->model->data->pclk_reg,
334 MT9V032_PIXEL_CLOCK_INV_PXL_CLK);
339 /* Disable the noise correction algorithm and restore the controls. */
340 ret = regmap_write(map, MT9V032_ROW_NOISE_CORR_CONTROL, 0);
344 return v4l2_ctrl_handler_setup(&mt9v032->ctrls);
347 /* -----------------------------------------------------------------------------
348 * V4L2 subdev video operations
351 static struct v4l2_mbus_framefmt *
352 __mt9v032_get_pad_format(struct mt9v032 *mt9v032,
353 struct v4l2_subdev_state *sd_state,
354 unsigned int pad, enum v4l2_subdev_format_whence which)
357 case V4L2_SUBDEV_FORMAT_TRY:
358 return v4l2_subdev_get_try_format(&mt9v032->subdev, sd_state,
360 case V4L2_SUBDEV_FORMAT_ACTIVE:
361 return &mt9v032->format;
367 static struct v4l2_rect *
368 __mt9v032_get_pad_crop(struct mt9v032 *mt9v032,
369 struct v4l2_subdev_state *sd_state,
370 unsigned int pad, enum v4l2_subdev_format_whence which)
373 case V4L2_SUBDEV_FORMAT_TRY:
374 return v4l2_subdev_get_try_crop(&mt9v032->subdev, sd_state,
376 case V4L2_SUBDEV_FORMAT_ACTIVE:
377 return &mt9v032->crop;
383 static int mt9v032_s_stream(struct v4l2_subdev *subdev, int enable)
385 const u16 mode = MT9V032_CHIP_CONTROL_DOUT_ENABLE
386 | MT9V032_CHIP_CONTROL_SEQUENTIAL;
387 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
388 struct v4l2_rect *crop = &mt9v032->crop;
389 struct regmap *map = mt9v032->regmap;
395 return regmap_update_bits(map, MT9V032_CHIP_CONTROL, mode, 0);
397 /* Configure the window size and row/column bin */
398 hbin = fls(mt9v032->hratio) - 1;
399 vbin = fls(mt9v032->vratio) - 1;
400 ret = regmap_update_bits(map, MT9V032_READ_MODE,
401 ~MT9V032_READ_MODE_RESERVED,
402 hbin << MT9V032_READ_MODE_COLUMN_BIN_SHIFT |
403 vbin << MT9V032_READ_MODE_ROW_BIN_SHIFT);
407 ret = regmap_write(map, MT9V032_COLUMN_START, crop->left);
411 ret = regmap_write(map, MT9V032_ROW_START, crop->top);
415 ret = regmap_write(map, MT9V032_WINDOW_WIDTH, crop->width);
419 ret = regmap_write(map, MT9V032_WINDOW_HEIGHT, crop->height);
423 ret = mt9v032_update_hblank(mt9v032);
427 /* Switch to master "normal" mode */
428 return regmap_update_bits(map, MT9V032_CHIP_CONTROL, mode, mode);
431 static int mt9v032_enum_mbus_code(struct v4l2_subdev *subdev,
432 struct v4l2_subdev_state *sd_state,
433 struct v4l2_subdev_mbus_code_enum *code)
435 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
440 code->code = mt9v032->format.code;
444 static int mt9v032_enum_frame_size(struct v4l2_subdev *subdev,
445 struct v4l2_subdev_state *sd_state,
446 struct v4l2_subdev_frame_size_enum *fse)
448 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
452 if (mt9v032->format.code != fse->code)
455 fse->min_width = MT9V032_WINDOW_WIDTH_DEF / (1 << fse->index);
456 fse->max_width = fse->min_width;
457 fse->min_height = MT9V032_WINDOW_HEIGHT_DEF / (1 << fse->index);
458 fse->max_height = fse->min_height;
463 static int mt9v032_get_format(struct v4l2_subdev *subdev,
464 struct v4l2_subdev_state *sd_state,
465 struct v4l2_subdev_format *format)
467 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
469 format->format = *__mt9v032_get_pad_format(mt9v032, sd_state,
475 static void mt9v032_configure_pixel_rate(struct mt9v032 *mt9v032)
477 struct i2c_client *client = v4l2_get_subdevdata(&mt9v032->subdev);
480 ret = v4l2_ctrl_s_ctrl_int64(mt9v032->pixel_rate,
481 mt9v032->sysclk / mt9v032->hratio);
483 dev_warn(&client->dev, "failed to set pixel rate (%d)\n", ret);
486 static unsigned int mt9v032_calc_ratio(unsigned int input, unsigned int output)
488 /* Compute the power-of-two binning factor closest to the input size to
489 * output size ratio. Given that the output size is bounded by input/4
490 * and input, a generic implementation would be an ineffective luxury.
492 if (output * 3 > input * 2)
494 if (output * 3 > input)
499 static int mt9v032_set_format(struct v4l2_subdev *subdev,
500 struct v4l2_subdev_state *sd_state,
501 struct v4l2_subdev_format *format)
503 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
504 struct v4l2_mbus_framefmt *__format;
505 struct v4l2_rect *__crop;
511 __crop = __mt9v032_get_pad_crop(mt9v032, sd_state, format->pad,
514 /* Clamp the width and height to avoid dividing by zero. */
515 width = clamp(ALIGN(format->format.width, 2),
516 max_t(unsigned int, __crop->width / 4,
517 MT9V032_WINDOW_WIDTH_MIN),
519 height = clamp(ALIGN(format->format.height, 2),
520 max_t(unsigned int, __crop->height / 4,
521 MT9V032_WINDOW_HEIGHT_MIN),
524 hratio = mt9v032_calc_ratio(__crop->width, width);
525 vratio = mt9v032_calc_ratio(__crop->height, height);
527 __format = __mt9v032_get_pad_format(mt9v032, sd_state, format->pad,
529 __format->width = __crop->width / hratio;
530 __format->height = __crop->height / vratio;
532 if (format->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
533 mt9v032->hratio = hratio;
534 mt9v032->vratio = vratio;
535 mt9v032_configure_pixel_rate(mt9v032);
538 format->format = *__format;
543 static int mt9v032_get_selection(struct v4l2_subdev *subdev,
544 struct v4l2_subdev_state *sd_state,
545 struct v4l2_subdev_selection *sel)
547 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
549 if (sel->target != V4L2_SEL_TGT_CROP)
552 sel->r = *__mt9v032_get_pad_crop(mt9v032, sd_state, sel->pad,
557 static int mt9v032_set_selection(struct v4l2_subdev *subdev,
558 struct v4l2_subdev_state *sd_state,
559 struct v4l2_subdev_selection *sel)
561 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
562 struct v4l2_mbus_framefmt *__format;
563 struct v4l2_rect *__crop;
564 struct v4l2_rect rect;
566 if (sel->target != V4L2_SEL_TGT_CROP)
569 /* Clamp the crop rectangle boundaries and align them to a non multiple
570 * of 2 pixels to ensure a GRBG Bayer pattern.
572 rect.left = clamp(ALIGN(sel->r.left + 1, 2) - 1,
573 MT9V032_COLUMN_START_MIN,
574 MT9V032_COLUMN_START_MAX);
575 rect.top = clamp(ALIGN(sel->r.top + 1, 2) - 1,
576 MT9V032_ROW_START_MIN,
577 MT9V032_ROW_START_MAX);
578 rect.width = clamp_t(unsigned int, ALIGN(sel->r.width, 2),
579 MT9V032_WINDOW_WIDTH_MIN,
580 MT9V032_WINDOW_WIDTH_MAX);
581 rect.height = clamp_t(unsigned int, ALIGN(sel->r.height, 2),
582 MT9V032_WINDOW_HEIGHT_MIN,
583 MT9V032_WINDOW_HEIGHT_MAX);
585 rect.width = min_t(unsigned int,
586 rect.width, MT9V032_PIXEL_ARRAY_WIDTH - rect.left);
587 rect.height = min_t(unsigned int,
588 rect.height, MT9V032_PIXEL_ARRAY_HEIGHT - rect.top);
590 __crop = __mt9v032_get_pad_crop(mt9v032, sd_state, sel->pad,
593 if (rect.width != __crop->width || rect.height != __crop->height) {
594 /* Reset the output image size if the crop rectangle size has
597 __format = __mt9v032_get_pad_format(mt9v032, sd_state,
600 __format->width = rect.width;
601 __format->height = rect.height;
602 if (sel->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
605 mt9v032_configure_pixel_rate(mt9v032);
615 /* -----------------------------------------------------------------------------
616 * V4L2 subdev control operations
619 #define V4L2_CID_TEST_PATTERN_COLOR (V4L2_CID_USER_BASE | 0x1001)
621 * Value between 1 and 64 to set the desired bin. This is effectively a measure
622 * of how bright the image is supposed to be. Both AGC and AEC try to reach
625 #define V4L2_CID_AEGC_DESIRED_BIN (V4L2_CID_USER_BASE | 0x1002)
627 * LPF is the low pass filter capability of the chip. Both AEC and AGC have
628 * this setting. This limits the speed in which AGC/AEC adjust their settings.
629 * Possible values are 0-2. 0 means no LPF. For 1 and 2 this equation is used:
631 * if |(calculated new exp - current exp)| > (current exp / 4)
632 * next exp = calculated new exp
634 * next exp = current exp + ((calculated new exp - current exp) / 2^LPF)
636 #define V4L2_CID_AEC_LPF (V4L2_CID_USER_BASE | 0x1003)
637 #define V4L2_CID_AGC_LPF (V4L2_CID_USER_BASE | 0x1004)
639 * Value between 0 and 15. This is the number of frames being skipped before
640 * updating the auto exposure/gain.
642 #define V4L2_CID_AEC_UPDATE_INTERVAL (V4L2_CID_USER_BASE | 0x1005)
643 #define V4L2_CID_AGC_UPDATE_INTERVAL (V4L2_CID_USER_BASE | 0x1006)
645 * Maximum shutter width used for AEC.
647 #define V4L2_CID_AEC_MAX_SHUTTER_WIDTH (V4L2_CID_USER_BASE | 0x1007)
649 static int mt9v032_s_ctrl(struct v4l2_ctrl *ctrl)
651 struct mt9v032 *mt9v032 =
652 container_of(ctrl->handler, struct mt9v032, ctrls);
653 struct regmap *map = mt9v032->regmap;
658 case V4L2_CID_AUTOGAIN:
659 return mt9v032_update_aec_agc(mt9v032, MT9V032_AGC_ENABLE,
663 return regmap_write(map, MT9V032_ANALOG_GAIN, ctrl->val);
665 case V4L2_CID_EXPOSURE_AUTO:
666 return mt9v032_update_aec_agc(mt9v032, MT9V032_AEC_ENABLE,
669 case V4L2_CID_EXPOSURE:
670 return regmap_write(map, MT9V032_TOTAL_SHUTTER_WIDTH,
673 case V4L2_CID_HBLANK:
674 mt9v032->hblank = ctrl->val;
675 return mt9v032_update_hblank(mt9v032);
677 case V4L2_CID_VBLANK:
678 return regmap_write(map, MT9V032_VERTICAL_BLANKING,
681 case V4L2_CID_PIXEL_RATE:
682 case V4L2_CID_LINK_FREQ:
683 if (mt9v032->link_freq == NULL)
686 freq = mt9v032->pdata->link_freqs[mt9v032->link_freq->val];
687 *mt9v032->pixel_rate->p_new.p_s64 = freq;
688 mt9v032->sysclk = freq;
691 case V4L2_CID_TEST_PATTERN:
692 switch (mt9v032->test_pattern->val) {
697 data = MT9V032_TEST_PATTERN_GRAY_VERTICAL
698 | MT9V032_TEST_PATTERN_ENABLE;
701 data = MT9V032_TEST_PATTERN_GRAY_HORIZONTAL
702 | MT9V032_TEST_PATTERN_ENABLE;
705 data = MT9V032_TEST_PATTERN_GRAY_DIAGONAL
706 | MT9V032_TEST_PATTERN_ENABLE;
709 data = (mt9v032->test_pattern_color->val <<
710 MT9V032_TEST_PATTERN_DATA_SHIFT)
711 | MT9V032_TEST_PATTERN_USE_DATA
712 | MT9V032_TEST_PATTERN_ENABLE
713 | MT9V032_TEST_PATTERN_FLIP;
716 return regmap_write(map, MT9V032_TEST_PATTERN, data);
718 case V4L2_CID_AEGC_DESIRED_BIN:
719 return regmap_write(map, MT9V032_AEGC_DESIRED_BIN, ctrl->val);
721 case V4L2_CID_AEC_LPF:
722 return regmap_write(map, MT9V032_AEC_LPF, ctrl->val);
724 case V4L2_CID_AGC_LPF:
725 return regmap_write(map, MT9V032_AGC_LPF, ctrl->val);
727 case V4L2_CID_AEC_UPDATE_INTERVAL:
728 return regmap_write(map, MT9V032_AEC_UPDATE_FREQUENCY,
731 case V4L2_CID_AGC_UPDATE_INTERVAL:
732 return regmap_write(map, MT9V032_AGC_UPDATE_FREQUENCY,
735 case V4L2_CID_AEC_MAX_SHUTTER_WIDTH:
736 return regmap_write(map,
737 mt9v032->model->data->aec_max_shutter_reg,
744 static const struct v4l2_ctrl_ops mt9v032_ctrl_ops = {
745 .s_ctrl = mt9v032_s_ctrl,
748 static const char * const mt9v032_test_pattern_menu[] = {
750 "Gray Vertical Shade",
751 "Gray Horizontal Shade",
752 "Gray Diagonal Shade",
756 static const struct v4l2_ctrl_config mt9v032_test_pattern_color = {
757 .ops = &mt9v032_ctrl_ops,
758 .id = V4L2_CID_TEST_PATTERN_COLOR,
759 .type = V4L2_CTRL_TYPE_INTEGER,
760 .name = "Test Pattern Color",
768 static const struct v4l2_ctrl_config mt9v032_aegc_controls[] = {
770 .ops = &mt9v032_ctrl_ops,
771 .id = V4L2_CID_AEGC_DESIRED_BIN,
772 .type = V4L2_CTRL_TYPE_INTEGER,
773 .name = "AEC/AGC Desired Bin",
780 .ops = &mt9v032_ctrl_ops,
781 .id = V4L2_CID_AEC_LPF,
782 .type = V4L2_CTRL_TYPE_INTEGER,
783 .name = "AEC Low Pass Filter",
790 .ops = &mt9v032_ctrl_ops,
791 .id = V4L2_CID_AGC_LPF,
792 .type = V4L2_CTRL_TYPE_INTEGER,
793 .name = "AGC Low Pass Filter",
800 .ops = &mt9v032_ctrl_ops,
801 .id = V4L2_CID_AEC_UPDATE_INTERVAL,
802 .type = V4L2_CTRL_TYPE_INTEGER,
803 .name = "AEC Update Interval",
810 .ops = &mt9v032_ctrl_ops,
811 .id = V4L2_CID_AGC_UPDATE_INTERVAL,
812 .type = V4L2_CTRL_TYPE_INTEGER,
813 .name = "AGC Update Interval",
822 static const struct v4l2_ctrl_config mt9v032_aec_max_shutter_width = {
823 .ops = &mt9v032_ctrl_ops,
824 .id = V4L2_CID_AEC_MAX_SHUTTER_WIDTH,
825 .type = V4L2_CTRL_TYPE_INTEGER,
826 .name = "AEC Max Shutter Width",
834 static const struct v4l2_ctrl_config mt9v034_aec_max_shutter_width = {
835 .ops = &mt9v032_ctrl_ops,
836 .id = V4L2_CID_AEC_MAX_SHUTTER_WIDTH,
837 .type = V4L2_CTRL_TYPE_INTEGER,
838 .name = "AEC Max Shutter Width",
846 /* -----------------------------------------------------------------------------
847 * V4L2 subdev core operations
850 static int mt9v032_set_power(struct v4l2_subdev *subdev, int on)
852 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
855 mutex_lock(&mt9v032->power_lock);
857 /* If the power count is modified from 0 to != 0 or from != 0 to 0,
858 * update the power state.
860 if (mt9v032->power_count == !on) {
861 ret = __mt9v032_set_power(mt9v032, !!on);
866 /* Update the power count. */
867 mt9v032->power_count += on ? 1 : -1;
868 WARN_ON(mt9v032->power_count < 0);
871 mutex_unlock(&mt9v032->power_lock);
875 /* -----------------------------------------------------------------------------
876 * V4L2 subdev internal operations
879 static int mt9v032_registered(struct v4l2_subdev *subdev)
881 struct i2c_client *client = v4l2_get_subdevdata(subdev);
882 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
887 dev_info(&client->dev, "Probing MT9V032 at address 0x%02x\n",
890 ret = mt9v032_power_on(mt9v032);
892 dev_err(&client->dev, "MT9V032 power up failed\n");
896 /* Read and check the sensor version */
897 ret = regmap_read(mt9v032->regmap, MT9V032_CHIP_VERSION, &version);
899 mt9v032_power_off(mt9v032);
902 dev_err(&client->dev, "Failed reading chip version\n");
906 for (i = 0; i < ARRAY_SIZE(mt9v032_versions); ++i) {
907 if (mt9v032_versions[i].version == version) {
908 mt9v032->version = &mt9v032_versions[i];
913 if (mt9v032->version == NULL) {
914 dev_err(&client->dev, "Unsupported chip version 0x%04x\n",
919 dev_info(&client->dev, "%s detected at address 0x%02x\n",
920 mt9v032->version->name, client->addr);
922 mt9v032_configure_pixel_rate(mt9v032);
927 static int mt9v032_open(struct v4l2_subdev *subdev, struct v4l2_subdev_fh *fh)
929 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
930 struct v4l2_mbus_framefmt *format;
931 struct v4l2_rect *crop;
933 crop = v4l2_subdev_get_try_crop(subdev, fh->state, 0);
934 crop->left = MT9V032_COLUMN_START_DEF;
935 crop->top = MT9V032_ROW_START_DEF;
936 crop->width = MT9V032_WINDOW_WIDTH_DEF;
937 crop->height = MT9V032_WINDOW_HEIGHT_DEF;
939 format = v4l2_subdev_get_try_format(subdev, fh->state, 0);
941 if (mt9v032->model->color)
942 format->code = MEDIA_BUS_FMT_SGRBG10_1X10;
944 format->code = MEDIA_BUS_FMT_Y10_1X10;
946 format->width = MT9V032_WINDOW_WIDTH_DEF;
947 format->height = MT9V032_WINDOW_HEIGHT_DEF;
948 format->field = V4L2_FIELD_NONE;
949 format->colorspace = V4L2_COLORSPACE_SRGB;
951 return mt9v032_set_power(subdev, 1);
954 static int mt9v032_close(struct v4l2_subdev *subdev, struct v4l2_subdev_fh *fh)
956 return mt9v032_set_power(subdev, 0);
959 static const struct v4l2_subdev_core_ops mt9v032_subdev_core_ops = {
960 .s_power = mt9v032_set_power,
963 static const struct v4l2_subdev_video_ops mt9v032_subdev_video_ops = {
964 .s_stream = mt9v032_s_stream,
967 static const struct v4l2_subdev_pad_ops mt9v032_subdev_pad_ops = {
968 .enum_mbus_code = mt9v032_enum_mbus_code,
969 .enum_frame_size = mt9v032_enum_frame_size,
970 .get_fmt = mt9v032_get_format,
971 .set_fmt = mt9v032_set_format,
972 .get_selection = mt9v032_get_selection,
973 .set_selection = mt9v032_set_selection,
976 static const struct v4l2_subdev_ops mt9v032_subdev_ops = {
977 .core = &mt9v032_subdev_core_ops,
978 .video = &mt9v032_subdev_video_ops,
979 .pad = &mt9v032_subdev_pad_ops,
982 static const struct v4l2_subdev_internal_ops mt9v032_subdev_internal_ops = {
983 .registered = mt9v032_registered,
984 .open = mt9v032_open,
985 .close = mt9v032_close,
988 static const struct regmap_config mt9v032_regmap_config = {
991 .max_register = 0xff,
992 .cache_type = REGCACHE_RBTREE,
995 /* -----------------------------------------------------------------------------
996 * Driver initialization and probing
999 static struct mt9v032_platform_data *
1000 mt9v032_get_pdata(struct i2c_client *client)
1002 struct mt9v032_platform_data *pdata = NULL;
1003 struct v4l2_fwnode_endpoint endpoint = { .bus_type = 0 };
1004 struct device_node *np;
1005 struct property *prop;
1007 if (!IS_ENABLED(CONFIG_OF) || !client->dev.of_node)
1008 return client->dev.platform_data;
1010 np = of_graph_get_next_endpoint(client->dev.of_node, NULL);
1014 if (v4l2_fwnode_endpoint_parse(of_fwnode_handle(np), &endpoint) < 0)
1017 pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
1021 prop = of_find_property(np, "link-frequencies", NULL);
1024 size_t size = prop->length / sizeof(*link_freqs);
1026 link_freqs = devm_kcalloc(&client->dev, size,
1027 sizeof(*link_freqs), GFP_KERNEL);
1031 if (of_property_read_u64_array(np, "link-frequencies",
1032 link_freqs, size) < 0)
1035 pdata->link_freqs = link_freqs;
1036 pdata->link_def_freq = link_freqs[0];
1039 pdata->clk_pol = !!(endpoint.bus.parallel.flags &
1040 V4L2_MBUS_PCLK_SAMPLE_RISING);
1047 static int mt9v032_probe(struct i2c_client *client)
1049 const struct i2c_device_id *did = i2c_client_get_device_id(client);
1050 struct mt9v032_platform_data *pdata = mt9v032_get_pdata(client);
1051 struct mt9v032 *mt9v032;
1055 mt9v032 = devm_kzalloc(&client->dev, sizeof(*mt9v032), GFP_KERNEL);
1059 mt9v032->regmap = devm_regmap_init_i2c(client, &mt9v032_regmap_config);
1060 if (IS_ERR(mt9v032->regmap))
1061 return PTR_ERR(mt9v032->regmap);
1063 mt9v032->clk = devm_clk_get(&client->dev, NULL);
1064 if (IS_ERR(mt9v032->clk))
1065 return PTR_ERR(mt9v032->clk);
1067 mt9v032->reset_gpio = devm_gpiod_get_optional(&client->dev, "reset",
1069 if (IS_ERR(mt9v032->reset_gpio))
1070 return PTR_ERR(mt9v032->reset_gpio);
1072 mt9v032->standby_gpio = devm_gpiod_get_optional(&client->dev, "standby",
1074 if (IS_ERR(mt9v032->standby_gpio))
1075 return PTR_ERR(mt9v032->standby_gpio);
1077 mutex_init(&mt9v032->power_lock);
1078 mt9v032->pdata = pdata;
1079 mt9v032->model = (const void *)did->driver_data;
1081 v4l2_ctrl_handler_init(&mt9v032->ctrls, 11 +
1082 ARRAY_SIZE(mt9v032_aegc_controls));
1084 v4l2_ctrl_new_std(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1085 V4L2_CID_AUTOGAIN, 0, 1, 1, 1);
1086 v4l2_ctrl_new_std(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1087 V4L2_CID_GAIN, MT9V032_ANALOG_GAIN_MIN,
1088 MT9V032_ANALOG_GAIN_MAX, 1, MT9V032_ANALOG_GAIN_DEF);
1089 v4l2_ctrl_new_std_menu(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1090 V4L2_CID_EXPOSURE_AUTO, V4L2_EXPOSURE_MANUAL, 0,
1091 V4L2_EXPOSURE_AUTO);
1092 v4l2_ctrl_new_std(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1093 V4L2_CID_EXPOSURE, mt9v032->model->data->min_shutter,
1094 mt9v032->model->data->max_shutter, 1,
1095 MT9V032_TOTAL_SHUTTER_WIDTH_DEF);
1096 v4l2_ctrl_new_std(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1097 V4L2_CID_HBLANK, mt9v032->model->data->min_hblank,
1098 MT9V032_HORIZONTAL_BLANKING_MAX, 1,
1099 MT9V032_HORIZONTAL_BLANKING_DEF);
1100 v4l2_ctrl_new_std(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1101 V4L2_CID_VBLANK, mt9v032->model->data->min_vblank,
1102 mt9v032->model->data->max_vblank, 1,
1103 MT9V032_VERTICAL_BLANKING_DEF);
1104 mt9v032->test_pattern = v4l2_ctrl_new_std_menu_items(&mt9v032->ctrls,
1105 &mt9v032_ctrl_ops, V4L2_CID_TEST_PATTERN,
1106 ARRAY_SIZE(mt9v032_test_pattern_menu) - 1, 0, 0,
1107 mt9v032_test_pattern_menu);
1108 mt9v032->test_pattern_color = v4l2_ctrl_new_custom(&mt9v032->ctrls,
1109 &mt9v032_test_pattern_color, NULL);
1111 v4l2_ctrl_new_custom(&mt9v032->ctrls,
1112 mt9v032->model->data->aec_max_shutter_v4l2_ctrl,
1114 for (i = 0; i < ARRAY_SIZE(mt9v032_aegc_controls); ++i)
1115 v4l2_ctrl_new_custom(&mt9v032->ctrls, &mt9v032_aegc_controls[i],
1118 v4l2_ctrl_cluster(2, &mt9v032->test_pattern);
1120 mt9v032->pixel_rate =
1121 v4l2_ctrl_new_std(&mt9v032->ctrls, &mt9v032_ctrl_ops,
1122 V4L2_CID_PIXEL_RATE, 1, INT_MAX, 1, 1);
1124 if (pdata && pdata->link_freqs) {
1125 unsigned int def = 0;
1127 for (i = 0; pdata->link_freqs[i]; ++i) {
1128 if (pdata->link_freqs[i] == pdata->link_def_freq)
1132 mt9v032->link_freq =
1133 v4l2_ctrl_new_int_menu(&mt9v032->ctrls,
1135 V4L2_CID_LINK_FREQ, i - 1, def,
1137 v4l2_ctrl_cluster(2, &mt9v032->link_freq);
1141 mt9v032->subdev.ctrl_handler = &mt9v032->ctrls;
1143 if (mt9v032->ctrls.error) {
1144 dev_err(&client->dev, "control initialization error %d\n",
1145 mt9v032->ctrls.error);
1146 ret = mt9v032->ctrls.error;
1150 mt9v032->crop.left = MT9V032_COLUMN_START_DEF;
1151 mt9v032->crop.top = MT9V032_ROW_START_DEF;
1152 mt9v032->crop.width = MT9V032_WINDOW_WIDTH_DEF;
1153 mt9v032->crop.height = MT9V032_WINDOW_HEIGHT_DEF;
1155 if (mt9v032->model->color)
1156 mt9v032->format.code = MEDIA_BUS_FMT_SGRBG10_1X10;
1158 mt9v032->format.code = MEDIA_BUS_FMT_Y10_1X10;
1160 mt9v032->format.width = MT9V032_WINDOW_WIDTH_DEF;
1161 mt9v032->format.height = MT9V032_WINDOW_HEIGHT_DEF;
1162 mt9v032->format.field = V4L2_FIELD_NONE;
1163 mt9v032->format.colorspace = V4L2_COLORSPACE_SRGB;
1165 mt9v032->hratio = 1;
1166 mt9v032->vratio = 1;
1168 mt9v032->aec_agc = MT9V032_AEC_ENABLE | MT9V032_AGC_ENABLE;
1169 mt9v032->hblank = MT9V032_HORIZONTAL_BLANKING_DEF;
1170 mt9v032->sysclk = MT9V032_SYSCLK_FREQ_DEF;
1172 v4l2_i2c_subdev_init(&mt9v032->subdev, client, &mt9v032_subdev_ops);
1173 mt9v032->subdev.internal_ops = &mt9v032_subdev_internal_ops;
1174 mt9v032->subdev.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
1176 mt9v032->subdev.entity.function = MEDIA_ENT_F_CAM_SENSOR;
1177 mt9v032->pad.flags = MEDIA_PAD_FL_SOURCE;
1178 ret = media_entity_pads_init(&mt9v032->subdev.entity, 1, &mt9v032->pad);
1182 mt9v032->subdev.dev = &client->dev;
1183 ret = v4l2_async_register_subdev(&mt9v032->subdev);
1190 media_entity_cleanup(&mt9v032->subdev.entity);
1191 v4l2_ctrl_handler_free(&mt9v032->ctrls);
1195 static void mt9v032_remove(struct i2c_client *client)
1197 struct v4l2_subdev *subdev = i2c_get_clientdata(client);
1198 struct mt9v032 *mt9v032 = to_mt9v032(subdev);
1200 v4l2_async_unregister_subdev(subdev);
1201 v4l2_ctrl_handler_free(&mt9v032->ctrls);
1202 media_entity_cleanup(&subdev->entity);
1205 static const struct mt9v032_model_data mt9v032_model_data[] = {
1207 /* MT9V022, MT9V032 revisions 1/2/3 */
1208 .min_row_time = 660,
1209 .min_hblank = MT9V032_HORIZONTAL_BLANKING_MIN,
1210 .min_vblank = MT9V032_VERTICAL_BLANKING_MIN,
1211 .max_vblank = MT9V032_VERTICAL_BLANKING_MAX,
1212 .min_shutter = MT9V032_TOTAL_SHUTTER_WIDTH_MIN,
1213 .max_shutter = MT9V032_TOTAL_SHUTTER_WIDTH_MAX,
1214 .pclk_reg = MT9V032_PIXEL_CLOCK,
1215 .aec_max_shutter_reg = MT9V032_AEC_MAX_SHUTTER_WIDTH,
1216 .aec_max_shutter_v4l2_ctrl = &mt9v032_aec_max_shutter_width,
1218 /* MT9V024, MT9V034 */
1219 .min_row_time = 690,
1220 .min_hblank = MT9V034_HORIZONTAL_BLANKING_MIN,
1221 .min_vblank = MT9V034_VERTICAL_BLANKING_MIN,
1222 .max_vblank = MT9V034_VERTICAL_BLANKING_MAX,
1223 .min_shutter = MT9V034_TOTAL_SHUTTER_WIDTH_MIN,
1224 .max_shutter = MT9V034_TOTAL_SHUTTER_WIDTH_MAX,
1225 .pclk_reg = MT9V034_PIXEL_CLOCK,
1226 .aec_max_shutter_reg = MT9V034_AEC_MAX_SHUTTER_WIDTH,
1227 .aec_max_shutter_v4l2_ctrl = &mt9v034_aec_max_shutter_width,
1231 static const struct mt9v032_model_info mt9v032_models[] = {
1232 [MT9V032_MODEL_V022_COLOR] = {
1233 .data = &mt9v032_model_data[0],
1236 [MT9V032_MODEL_V022_MONO] = {
1237 .data = &mt9v032_model_data[0],
1240 [MT9V032_MODEL_V024_COLOR] = {
1241 .data = &mt9v032_model_data[1],
1244 [MT9V032_MODEL_V024_MONO] = {
1245 .data = &mt9v032_model_data[1],
1248 [MT9V032_MODEL_V032_COLOR] = {
1249 .data = &mt9v032_model_data[0],
1252 [MT9V032_MODEL_V032_MONO] = {
1253 .data = &mt9v032_model_data[0],
1256 [MT9V032_MODEL_V034_COLOR] = {
1257 .data = &mt9v032_model_data[1],
1260 [MT9V032_MODEL_V034_MONO] = {
1261 .data = &mt9v032_model_data[1],
1266 static const struct i2c_device_id mt9v032_id[] = {
1267 { "mt9v022", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V022_COLOR] },
1268 { "mt9v022m", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V022_MONO] },
1269 { "mt9v024", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V024_COLOR] },
1270 { "mt9v024m", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V024_MONO] },
1271 { "mt9v032", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V032_COLOR] },
1272 { "mt9v032m", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V032_MONO] },
1273 { "mt9v034", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V034_COLOR] },
1274 { "mt9v034m", (kernel_ulong_t)&mt9v032_models[MT9V032_MODEL_V034_MONO] },
1277 MODULE_DEVICE_TABLE(i2c, mt9v032_id);
1279 #if IS_ENABLED(CONFIG_OF)
1280 static const struct of_device_id mt9v032_of_match[] = {
1281 { .compatible = "aptina,mt9v022" },
1282 { .compatible = "aptina,mt9v022m" },
1283 { .compatible = "aptina,mt9v024" },
1284 { .compatible = "aptina,mt9v024m" },
1285 { .compatible = "aptina,mt9v032" },
1286 { .compatible = "aptina,mt9v032m" },
1287 { .compatible = "aptina,mt9v034" },
1288 { .compatible = "aptina,mt9v034m" },
1291 MODULE_DEVICE_TABLE(of, mt9v032_of_match);
1294 static struct i2c_driver mt9v032_driver = {
1297 .of_match_table = of_match_ptr(mt9v032_of_match),
1299 .probe = mt9v032_probe,
1300 .remove = mt9v032_remove,
1301 .id_table = mt9v032_id,
1304 module_i2c_driver(mt9v032_driver);
1306 MODULE_DESCRIPTION("Aptina MT9V032 Camera driver");
1308 MODULE_LICENSE("GPL");