1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * Driver for MT9M032 CMOS Image Sensor from Micron
4 *
5 * Copyright (C) 2010-2011 Lund Engineering
6 * Contact: Gil Lund <gwlund@lundeng.com>
7 * Author: Martin Hostettler <martin@neutronstar.dyndns.org>
8 */
9
10 #include <linux/delay.h>
11 #include <linux/i2c.h>
12 #include <linux/init.h>
13 #include <linux/kernel.h>
14 #include <linux/math64.h>
15 #include <linux/module.h>
16 #include <linux/mutex.h>
17 #include <linux/slab.h>
18 #include <linux/v4l2-mediabus.h>
19
20 #include <media/media-entity.h>
21 #include <media/i2c/mt9m032.h>
22 #include <media/v4l2-ctrls.h>
23 #include <media/v4l2-device.h>
24 #include <media/v4l2-subdev.h>
25
26 #include "aptina-pll.h"
27
28 /*
29 * width and height include active boundary and black parts
30 *
31 * column 0- 15 active boundary
32 * column 16-1455 image
33 * column 1456-1471 active boundary
34 * column 1472-1599 black
35 *
36 * row 0- 51 black
37 * row 53- 59 active boundary
38 * row 60-1139 image
39 * row 1140-1147 active boundary
40 * row 1148-1151 black
41 */
42
43 #define MT9M032_PIXEL_ARRAY_WIDTH 1600
44 #define MT9M032_PIXEL_ARRAY_HEIGHT 1152
45
46 #define MT9M032_CHIP_VERSION 0x00
47 #define MT9M032_CHIP_VERSION_VALUE 0x1402
48 #define MT9M032_ROW_START 0x01
49 #define MT9M032_ROW_START_MIN 0
50 #define MT9M032_ROW_START_MAX 1152
51 #define MT9M032_ROW_START_DEF 60
52 #define MT9M032_COLUMN_START 0x02
53 #define MT9M032_COLUMN_START_MIN 0
54 #define MT9M032_COLUMN_START_MAX 1600
55 #define MT9M032_COLUMN_START_DEF 16
56 #define MT9M032_ROW_SIZE 0x03
57 #define MT9M032_ROW_SIZE_MIN 32
58 #define MT9M032_ROW_SIZE_MAX 1152
59 #define MT9M032_ROW_SIZE_DEF 1080
60 #define MT9M032_COLUMN_SIZE 0x04
61 #define MT9M032_COLUMN_SIZE_MIN 32
62 #define MT9M032_COLUMN_SIZE_MAX 1600
63 #define MT9M032_COLUMN_SIZE_DEF 1440
64 #define MT9M032_HBLANK 0x05
65 #define MT9M032_VBLANK 0x06
66 #define MT9M032_VBLANK_MAX 0x7ff
67 #define MT9M032_SHUTTER_WIDTH_HIGH 0x08
68 #define MT9M032_SHUTTER_WIDTH_LOW 0x09
69 #define MT9M032_SHUTTER_WIDTH_MIN 1
70 #define MT9M032_SHUTTER_WIDTH_MAX 1048575
71 #define MT9M032_SHUTTER_WIDTH_DEF 1943
72 #define MT9M032_PIX_CLK_CTRL 0x0a
73 #define MT9M032_PIX_CLK_CTRL_INV_PIXCLK 0x8000
74 #define MT9M032_RESTART 0x0b
75 #define MT9M032_RESET 0x0d
76 #define MT9M032_PLL_CONFIG1 0x11
77 #define MT9M032_PLL_CONFIG1_PREDIV_MASK 0x3f
78 #define MT9M032_PLL_CONFIG1_MUL_SHIFT 8
79 #define MT9M032_READ_MODE1 0x1e
80 #define MT9M032_READ_MODE1_OUTPUT_BAD_FRAMES (1 << 13)
81 #define MT9M032_READ_MODE1_MAINTAIN_FRAME_RATE (1 << 12)
82 #define MT9M032_READ_MODE1_XOR_LINE_VALID (1 << 11)
83 #define MT9M032_READ_MODE1_CONT_LINE_VALID (1 << 10)
84 #define MT9M032_READ_MODE1_INVERT_TRIGGER (1 << 9)
85 #define MT9M032_READ_MODE1_SNAPSHOT (1 << 8)
86 #define MT9M032_READ_MODE1_GLOBAL_RESET (1 << 7)
87 #define MT9M032_READ_MODE1_BULB_EXPOSURE (1 << 6)
88 #define MT9M032_READ_MODE1_INVERT_STROBE (1 << 5)
89 #define MT9M032_READ_MODE1_STROBE_ENABLE (1 << 4)
90 #define MT9M032_READ_MODE1_STROBE_START_TRIG1 (0 << 2)
91 #define MT9M032_READ_MODE1_STROBE_START_EXP (1 << 2)
92 #define MT9M032_READ_MODE1_STROBE_START_SHUTTER (2 << 2)
93 #define MT9M032_READ_MODE1_STROBE_START_TRIG2 (3 << 2)
94 #define MT9M032_READ_MODE1_STROBE_END_TRIG1 (0 << 0)
95 #define MT9M032_READ_MODE1_STROBE_END_EXP (1 << 0)
96 #define MT9M032_READ_MODE1_STROBE_END_SHUTTER (2 << 0)
97 #define MT9M032_READ_MODE1_STROBE_END_TRIG2 (3 << 0)
98 #define MT9M032_READ_MODE2 0x20
99 #define MT9M032_READ_MODE2_VFLIP_SHIFT 15
100 #define MT9M032_READ_MODE2_HFLIP_SHIFT 14
101 #define MT9M032_READ_MODE2_ROW_BLC 0x40
102 #define MT9M032_GAIN_GREEN1 0x2b
103 #define MT9M032_GAIN_BLUE 0x2c
104 #define MT9M032_GAIN_RED 0x2d
105 #define MT9M032_GAIN_GREEN2 0x2e
106
107 /* write only */
108 #define MT9M032_GAIN_ALL 0x35
109 #define MT9M032_GAIN_DIGITAL_MASK 0x7f
110 #define MT9M032_GAIN_DIGITAL_SHIFT 8
111 #define MT9M032_GAIN_AMUL_SHIFT 6
112 #define MT9M032_GAIN_ANALOG_MASK 0x3f
113 #define MT9M032_FORMATTER1 0x9e
114 #define MT9M032_FORMATTER1_PLL_P1_6 (1 << 8)
115 #define MT9M032_FORMATTER1_PARALLEL (1 << 12)
116 #define MT9M032_FORMATTER2 0x9f
117 #define MT9M032_FORMATTER2_DOUT_EN 0x1000
118 #define MT9M032_FORMATTER2_PIXCLK_EN 0x2000
119
120 /*
121 * The available MT9M032 datasheet is missing documentation for register 0x10
122 * MT9P031 seems to be close enough, so use constants from that datasheet for
123 * now.
124 * But keep the name MT9P031 to remind us, that this isn't really confirmed
125 * for this sensor.
126 */
127 #define MT9P031_PLL_CONTROL 0x10
128 #define MT9P031_PLL_CONTROL_PWROFF 0x0050
129 #define MT9P031_PLL_CONTROL_PWRON 0x0051
130 #define MT9P031_PLL_CONTROL_USEPLL 0x0052
131
132 struct mt9m032 {
133 struct v4l2_subdev subdev;
134 struct media_pad pad;
135 struct mt9m032_platform_data *pdata;
136
137 unsigned int pix_clock;
138
139 struct v4l2_ctrl_handler ctrls;
140 struct {
141 struct v4l2_ctrl *hflip;
142 struct v4l2_ctrl *vflip;
143 };
144
145 struct mutex lock; /* Protects streaming, format, interval and crop */
146
147 bool streaming;
148
149 struct v4l2_mbus_framefmt format;
150 struct v4l2_rect crop;
151 struct v4l2_fract frame_interval;
152 };
153
154 #define to_mt9m032(sd) container_of(sd, struct mt9m032, subdev)
155 #define to_dev(sensor) \
156 (&((struct i2c_client *)v4l2_get_subdevdata(&(sensor)->subdev))->dev)
157
mt9m032_read(struct i2c_client * client,u8 reg)158 static int mt9m032_read(struct i2c_client *client, u8 reg)
159 {
160 return i2c_smbus_read_word_swapped(client, reg);
161 }
162
mt9m032_write(struct i2c_client * client,u8 reg,const u16 data)163 static int mt9m032_write(struct i2c_client *client, u8 reg, const u16 data)
164 {
165 return i2c_smbus_write_word_swapped(client, reg, data);
166 }
167
mt9m032_row_time(struct mt9m032 * sensor,unsigned int width)168 static u32 mt9m032_row_time(struct mt9m032 *sensor, unsigned int width)
169 {
170 unsigned int effective_width;
171 u32 ns;
172
173 effective_width = width + 716; /* empirical value */
174 ns = div_u64(1000000000ULL * effective_width, sensor->pix_clock);
175 dev_dbg(to_dev(sensor), "MT9M032 line time: %u ns\n", ns);
176 return ns;
177 }
178
mt9m032_update_timing(struct mt9m032 * sensor,struct v4l2_fract * interval)179 static int mt9m032_update_timing(struct mt9m032 *sensor,
180 struct v4l2_fract *interval)
181 {
182 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
183 struct v4l2_rect *crop = &sensor->crop;
184 unsigned int min_vblank;
185 unsigned int vblank;
186 u32 row_time;
187
188 if (!interval)
189 interval = &sensor->frame_interval;
190
191 row_time = mt9m032_row_time(sensor, crop->width);
192
193 vblank = div_u64(1000000000ULL * interval->numerator,
194 (u64)row_time * interval->denominator)
195 - crop->height;
196
197 if (vblank > MT9M032_VBLANK_MAX) {
198 /* hardware limits to 11 bit values */
199 interval->denominator = 1000;
200 interval->numerator =
201 div_u64((crop->height + MT9M032_VBLANK_MAX) *
202 (u64)row_time * interval->denominator,
203 1000000000ULL);
204 vblank = div_u64(1000000000ULL * interval->numerator,
205 (u64)row_time * interval->denominator)
206 - crop->height;
207 }
208 /* enforce minimal 1.6ms blanking time. */
209 min_vblank = 1600000 / row_time;
210 vblank = clamp_t(unsigned int, vblank, min_vblank, MT9M032_VBLANK_MAX);
211
212 return mt9m032_write(client, MT9M032_VBLANK, vblank);
213 }
214
mt9m032_update_geom_timing(struct mt9m032 * sensor)215 static int mt9m032_update_geom_timing(struct mt9m032 *sensor)
216 {
217 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
218 int ret;
219
220 ret = mt9m032_write(client, MT9M032_COLUMN_SIZE,
221 sensor->crop.width - 1);
222 if (!ret)
223 ret = mt9m032_write(client, MT9M032_ROW_SIZE,
224 sensor->crop.height - 1);
225 if (!ret)
226 ret = mt9m032_write(client, MT9M032_COLUMN_START,
227 sensor->crop.left);
228 if (!ret)
229 ret = mt9m032_write(client, MT9M032_ROW_START,
230 sensor->crop.top);
231 if (!ret)
232 ret = mt9m032_update_timing(sensor, NULL);
233 return ret;
234 }
235
update_formatter2(struct mt9m032 * sensor,bool streaming)236 static int update_formatter2(struct mt9m032 *sensor, bool streaming)
237 {
238 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
239 u16 reg_val = MT9M032_FORMATTER2_DOUT_EN
240 | 0x0070; /* parts reserved! */
241 /* possibly for changing to 14-bit mode */
242
243 if (streaming)
244 reg_val |= MT9M032_FORMATTER2_PIXCLK_EN; /* pixclock enable */
245
246 return mt9m032_write(client, MT9M032_FORMATTER2, reg_val);
247 }
248
mt9m032_setup_pll(struct mt9m032 * sensor)249 static int mt9m032_setup_pll(struct mt9m032 *sensor)
250 {
251 static const struct aptina_pll_limits limits = {
252 .ext_clock_min = 8000000,
253 .ext_clock_max = 16500000,
254 .int_clock_min = 2000000,
255 .int_clock_max = 24000000,
256 .out_clock_min = 322000000,
257 .out_clock_max = 693000000,
258 .pix_clock_max = 99000000,
259 .n_min = 1,
260 .n_max = 64,
261 .m_min = 16,
262 .m_max = 255,
263 .p1_min = 6,
264 .p1_max = 7,
265 };
266
267 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
268 struct mt9m032_platform_data *pdata = sensor->pdata;
269 struct aptina_pll pll;
270 u16 reg_val;
271 int ret;
272
273 pll.ext_clock = pdata->ext_clock;
274 pll.pix_clock = pdata->pix_clock;
275
276 ret = aptina_pll_calculate(&client->dev, &limits, &pll);
277 if (ret < 0)
278 return ret;
279
280 sensor->pix_clock = pdata->pix_clock;
281
282 ret = mt9m032_write(client, MT9M032_PLL_CONFIG1,
283 (pll.m << MT9M032_PLL_CONFIG1_MUL_SHIFT) |
284 ((pll.n - 1) & MT9M032_PLL_CONFIG1_PREDIV_MASK));
285 if (!ret)
286 ret = mt9m032_write(client, MT9P031_PLL_CONTROL,
287 MT9P031_PLL_CONTROL_PWRON |
288 MT9P031_PLL_CONTROL_USEPLL);
289 if (!ret) /* more reserved, Continuous, Master Mode */
290 ret = mt9m032_write(client, MT9M032_READ_MODE1, 0x8000 |
291 MT9M032_READ_MODE1_STROBE_START_EXP |
292 MT9M032_READ_MODE1_STROBE_END_SHUTTER);
293 if (!ret) {
294 reg_val = (pll.p1 == 6 ? MT9M032_FORMATTER1_PLL_P1_6 : 0)
295 | MT9M032_FORMATTER1_PARALLEL | 0x001e; /* 14-bit */
296 ret = mt9m032_write(client, MT9M032_FORMATTER1, reg_val);
297 }
298
299 return ret;
300 }
301
302 /* -----------------------------------------------------------------------------
303 * Subdev pad operations
304 */
305
mt9m032_enum_mbus_code(struct v4l2_subdev * subdev,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_mbus_code_enum * code)306 static int mt9m032_enum_mbus_code(struct v4l2_subdev *subdev,
307 struct v4l2_subdev_pad_config *cfg,
308 struct v4l2_subdev_mbus_code_enum *code)
309 {
310 if (code->index != 0)
311 return -EINVAL;
312
313 code->code = MEDIA_BUS_FMT_Y8_1X8;
314 return 0;
315 }
316
mt9m032_enum_frame_size(struct v4l2_subdev * subdev,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_frame_size_enum * fse)317 static int mt9m032_enum_frame_size(struct v4l2_subdev *subdev,
318 struct v4l2_subdev_pad_config *cfg,
319 struct v4l2_subdev_frame_size_enum *fse)
320 {
321 if (fse->index != 0 || fse->code != MEDIA_BUS_FMT_Y8_1X8)
322 return -EINVAL;
323
324 fse->min_width = MT9M032_COLUMN_SIZE_DEF;
325 fse->max_width = MT9M032_COLUMN_SIZE_DEF;
326 fse->min_height = MT9M032_ROW_SIZE_DEF;
327 fse->max_height = MT9M032_ROW_SIZE_DEF;
328
329 return 0;
330 }
331
332 /**
333 * __mt9m032_get_pad_crop() - get crop rect
334 * @sensor: pointer to the sensor struct
335 * @cfg: v4l2_subdev_pad_config for getting the try crop rect from
336 * @which: select try or active crop rect
337 *
338 * Returns a pointer the current active or fh relative try crop rect
339 */
340 static struct v4l2_rect *
__mt9m032_get_pad_crop(struct mt9m032 * sensor,struct v4l2_subdev_pad_config * cfg,enum v4l2_subdev_format_whence which)341 __mt9m032_get_pad_crop(struct mt9m032 *sensor, struct v4l2_subdev_pad_config *cfg,
342 enum v4l2_subdev_format_whence which)
343 {
344 switch (which) {
345 case V4L2_SUBDEV_FORMAT_TRY:
346 return v4l2_subdev_get_try_crop(&sensor->subdev, cfg, 0);
347 case V4L2_SUBDEV_FORMAT_ACTIVE:
348 return &sensor->crop;
349 default:
350 return NULL;
351 }
352 }
353
354 /**
355 * __mt9m032_get_pad_format() - get format
356 * @sensor: pointer to the sensor struct
357 * @cfg: v4l2_subdev_pad_config for getting the try format from
358 * @which: select try or active format
359 *
360 * Returns a pointer the current active or fh relative try format
361 */
362 static struct v4l2_mbus_framefmt *
__mt9m032_get_pad_format(struct mt9m032 * sensor,struct v4l2_subdev_pad_config * cfg,enum v4l2_subdev_format_whence which)363 __mt9m032_get_pad_format(struct mt9m032 *sensor, struct v4l2_subdev_pad_config *cfg,
364 enum v4l2_subdev_format_whence which)
365 {
366 switch (which) {
367 case V4L2_SUBDEV_FORMAT_TRY:
368 return v4l2_subdev_get_try_format(&sensor->subdev, cfg, 0);
369 case V4L2_SUBDEV_FORMAT_ACTIVE:
370 return &sensor->format;
371 default:
372 return NULL;
373 }
374 }
375
mt9m032_get_pad_format(struct v4l2_subdev * subdev,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_format * fmt)376 static int mt9m032_get_pad_format(struct v4l2_subdev *subdev,
377 struct v4l2_subdev_pad_config *cfg,
378 struct v4l2_subdev_format *fmt)
379 {
380 struct mt9m032 *sensor = to_mt9m032(subdev);
381
382 mutex_lock(&sensor->lock);
383 fmt->format = *__mt9m032_get_pad_format(sensor, cfg, fmt->which);
384 mutex_unlock(&sensor->lock);
385
386 return 0;
387 }
388
mt9m032_set_pad_format(struct v4l2_subdev * subdev,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_format * fmt)389 static int mt9m032_set_pad_format(struct v4l2_subdev *subdev,
390 struct v4l2_subdev_pad_config *cfg,
391 struct v4l2_subdev_format *fmt)
392 {
393 struct mt9m032 *sensor = to_mt9m032(subdev);
394 int ret;
395
396 mutex_lock(&sensor->lock);
397
398 if (sensor->streaming && fmt->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
399 ret = -EBUSY;
400 goto done;
401 }
402
403 /* Scaling is not supported, the format is thus fixed. */
404 fmt->format = *__mt9m032_get_pad_format(sensor, cfg, fmt->which);
405 ret = 0;
406
407 done:
408 mutex_unlock(&sensor->lock);
409 return ret;
410 }
411
mt9m032_get_pad_selection(struct v4l2_subdev * subdev,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_selection * sel)412 static int mt9m032_get_pad_selection(struct v4l2_subdev *subdev,
413 struct v4l2_subdev_pad_config *cfg,
414 struct v4l2_subdev_selection *sel)
415 {
416 struct mt9m032 *sensor = to_mt9m032(subdev);
417
418 if (sel->target != V4L2_SEL_TGT_CROP)
419 return -EINVAL;
420
421 mutex_lock(&sensor->lock);
422 sel->r = *__mt9m032_get_pad_crop(sensor, cfg, sel->which);
423 mutex_unlock(&sensor->lock);
424
425 return 0;
426 }
427
mt9m032_set_pad_selection(struct v4l2_subdev * subdev,struct v4l2_subdev_pad_config * cfg,struct v4l2_subdev_selection * sel)428 static int mt9m032_set_pad_selection(struct v4l2_subdev *subdev,
429 struct v4l2_subdev_pad_config *cfg,
430 struct v4l2_subdev_selection *sel)
431 {
432 struct mt9m032 *sensor = to_mt9m032(subdev);
433 struct v4l2_mbus_framefmt *format;
434 struct v4l2_rect *__crop;
435 struct v4l2_rect rect;
436 int ret = 0;
437
438 if (sel->target != V4L2_SEL_TGT_CROP)
439 return -EINVAL;
440
441 mutex_lock(&sensor->lock);
442
443 if (sensor->streaming && sel->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
444 ret = -EBUSY;
445 goto done;
446 }
447
448 /* Clamp the crop rectangle boundaries and align them to a multiple of 2
449 * pixels to ensure a GRBG Bayer pattern.
450 */
451 rect.left = clamp(ALIGN(sel->r.left, 2), MT9M032_COLUMN_START_MIN,
452 MT9M032_COLUMN_START_MAX);
453 rect.top = clamp(ALIGN(sel->r.top, 2), MT9M032_ROW_START_MIN,
454 MT9M032_ROW_START_MAX);
455 rect.width = clamp_t(unsigned int, ALIGN(sel->r.width, 2),
456 MT9M032_COLUMN_SIZE_MIN, MT9M032_COLUMN_SIZE_MAX);
457 rect.height = clamp_t(unsigned int, ALIGN(sel->r.height, 2),
458 MT9M032_ROW_SIZE_MIN, MT9M032_ROW_SIZE_MAX);
459
460 rect.width = min_t(unsigned int, rect.width,
461 MT9M032_PIXEL_ARRAY_WIDTH - rect.left);
462 rect.height = min_t(unsigned int, rect.height,
463 MT9M032_PIXEL_ARRAY_HEIGHT - rect.top);
464
465 __crop = __mt9m032_get_pad_crop(sensor, cfg, sel->which);
466
467 if (rect.width != __crop->width || rect.height != __crop->height) {
468 /* Reset the output image size if the crop rectangle size has
469 * been modified.
470 */
471 format = __mt9m032_get_pad_format(sensor, cfg, sel->which);
472 format->width = rect.width;
473 format->height = rect.height;
474 }
475
476 *__crop = rect;
477 sel->r = rect;
478
479 if (sel->which == V4L2_SUBDEV_FORMAT_ACTIVE)
480 ret = mt9m032_update_geom_timing(sensor);
481
482 done:
483 mutex_unlock(&sensor->lock);
484 return ret;
485 }
486
mt9m032_get_frame_interval(struct v4l2_subdev * subdev,struct v4l2_subdev_frame_interval * fi)487 static int mt9m032_get_frame_interval(struct v4l2_subdev *subdev,
488 struct v4l2_subdev_frame_interval *fi)
489 {
490 struct mt9m032 *sensor = to_mt9m032(subdev);
491
492 mutex_lock(&sensor->lock);
493 memset(fi, 0, sizeof(*fi));
494 fi->interval = sensor->frame_interval;
495 mutex_unlock(&sensor->lock);
496
497 return 0;
498 }
499
mt9m032_set_frame_interval(struct v4l2_subdev * subdev,struct v4l2_subdev_frame_interval * fi)500 static int mt9m032_set_frame_interval(struct v4l2_subdev *subdev,
501 struct v4l2_subdev_frame_interval *fi)
502 {
503 struct mt9m032 *sensor = to_mt9m032(subdev);
504 int ret;
505
506 mutex_lock(&sensor->lock);
507
508 if (sensor->streaming) {
509 ret = -EBUSY;
510 goto done;
511 }
512
513 /* Avoid divisions by 0. */
514 if (fi->interval.denominator == 0)
515 fi->interval.denominator = 1;
516
517 ret = mt9m032_update_timing(sensor, &fi->interval);
518 if (!ret)
519 sensor->frame_interval = fi->interval;
520
521 done:
522 mutex_unlock(&sensor->lock);
523 return ret;
524 }
525
mt9m032_s_stream(struct v4l2_subdev * subdev,int streaming)526 static int mt9m032_s_stream(struct v4l2_subdev *subdev, int streaming)
527 {
528 struct mt9m032 *sensor = to_mt9m032(subdev);
529 int ret;
530
531 mutex_lock(&sensor->lock);
532 ret = update_formatter2(sensor, streaming);
533 if (!ret)
534 sensor->streaming = streaming;
535 mutex_unlock(&sensor->lock);
536
537 return ret;
538 }
539
540 /* -----------------------------------------------------------------------------
541 * V4L2 subdev core operations
542 */
543
544 #ifdef CONFIG_VIDEO_ADV_DEBUG
mt9m032_g_register(struct v4l2_subdev * sd,struct v4l2_dbg_register * reg)545 static int mt9m032_g_register(struct v4l2_subdev *sd,
546 struct v4l2_dbg_register *reg)
547 {
548 struct mt9m032 *sensor = to_mt9m032(sd);
549 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
550 int val;
551
552 if (reg->reg > 0xff)
553 return -EINVAL;
554
555 val = mt9m032_read(client, reg->reg);
556 if (val < 0)
557 return -EIO;
558
559 reg->size = 2;
560 reg->val = val;
561
562 return 0;
563 }
564
mt9m032_s_register(struct v4l2_subdev * sd,const struct v4l2_dbg_register * reg)565 static int mt9m032_s_register(struct v4l2_subdev *sd,
566 const struct v4l2_dbg_register *reg)
567 {
568 struct mt9m032 *sensor = to_mt9m032(sd);
569 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
570
571 if (reg->reg > 0xff)
572 return -EINVAL;
573
574 return mt9m032_write(client, reg->reg, reg->val);
575 }
576 #endif
577
578 /* -----------------------------------------------------------------------------
579 * V4L2 subdev control operations
580 */
581
update_read_mode2(struct mt9m032 * sensor,bool vflip,bool hflip)582 static int update_read_mode2(struct mt9m032 *sensor, bool vflip, bool hflip)
583 {
584 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
585 int reg_val = (vflip << MT9M032_READ_MODE2_VFLIP_SHIFT)
586 | (hflip << MT9M032_READ_MODE2_HFLIP_SHIFT)
587 | MT9M032_READ_MODE2_ROW_BLC
588 | 0x0007;
589
590 return mt9m032_write(client, MT9M032_READ_MODE2, reg_val);
591 }
592
mt9m032_set_gain(struct mt9m032 * sensor,s32 val)593 static int mt9m032_set_gain(struct mt9m032 *sensor, s32 val)
594 {
595 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
596 int digital_gain_val; /* in 1/8th (0..127) */
597 int analog_mul; /* 0 or 1 */
598 int analog_gain_val; /* in 1/16th. (0..63) */
599 u16 reg_val;
600
601 digital_gain_val = 51; /* from setup example */
602
603 if (val < 63) {
604 analog_mul = 0;
605 analog_gain_val = val;
606 } else {
607 analog_mul = 1;
608 analog_gain_val = val / 2;
609 }
610
611 /* a_gain = (1 + analog_mul) + (analog_gain_val + 1) / 16 */
612 /* overall_gain = a_gain * (1 + digital_gain_val / 8) */
613
614 reg_val = ((digital_gain_val & MT9M032_GAIN_DIGITAL_MASK)
615 << MT9M032_GAIN_DIGITAL_SHIFT)
616 | ((analog_mul & 1) << MT9M032_GAIN_AMUL_SHIFT)
617 | (analog_gain_val & MT9M032_GAIN_ANALOG_MASK);
618
619 return mt9m032_write(client, MT9M032_GAIN_ALL, reg_val);
620 }
621
mt9m032_try_ctrl(struct v4l2_ctrl * ctrl)622 static int mt9m032_try_ctrl(struct v4l2_ctrl *ctrl)
623 {
624 if (ctrl->id == V4L2_CID_GAIN && ctrl->val >= 63) {
625 /* round because of multiplier used for values >= 63 */
626 ctrl->val &= ~1;
627 }
628
629 return 0;
630 }
631
mt9m032_set_ctrl(struct v4l2_ctrl * ctrl)632 static int mt9m032_set_ctrl(struct v4l2_ctrl *ctrl)
633 {
634 struct mt9m032 *sensor =
635 container_of(ctrl->handler, struct mt9m032, ctrls);
636 struct i2c_client *client = v4l2_get_subdevdata(&sensor->subdev);
637 int ret;
638
639 switch (ctrl->id) {
640 case V4L2_CID_GAIN:
641 return mt9m032_set_gain(sensor, ctrl->val);
642
643 case V4L2_CID_HFLIP:
644 /* case V4L2_CID_VFLIP: -- In the same cluster */
645 return update_read_mode2(sensor, sensor->vflip->val,
646 sensor->hflip->val);
647
648 case V4L2_CID_EXPOSURE:
649 ret = mt9m032_write(client, MT9M032_SHUTTER_WIDTH_HIGH,
650 (ctrl->val >> 16) & 0xffff);
651 if (ret < 0)
652 return ret;
653
654 return mt9m032_write(client, MT9M032_SHUTTER_WIDTH_LOW,
655 ctrl->val & 0xffff);
656 }
657
658 return 0;
659 }
660
661 static const struct v4l2_ctrl_ops mt9m032_ctrl_ops = {
662 .s_ctrl = mt9m032_set_ctrl,
663 .try_ctrl = mt9m032_try_ctrl,
664 };
665
666 /* -------------------------------------------------------------------------- */
667
668 static const struct v4l2_subdev_core_ops mt9m032_core_ops = {
669 #ifdef CONFIG_VIDEO_ADV_DEBUG
670 .g_register = mt9m032_g_register,
671 .s_register = mt9m032_s_register,
672 #endif
673 };
674
675 static const struct v4l2_subdev_video_ops mt9m032_video_ops = {
676 .s_stream = mt9m032_s_stream,
677 .g_frame_interval = mt9m032_get_frame_interval,
678 .s_frame_interval = mt9m032_set_frame_interval,
679 };
680
681 static const struct v4l2_subdev_pad_ops mt9m032_pad_ops = {
682 .enum_mbus_code = mt9m032_enum_mbus_code,
683 .enum_frame_size = mt9m032_enum_frame_size,
684 .get_fmt = mt9m032_get_pad_format,
685 .set_fmt = mt9m032_set_pad_format,
686 .set_selection = mt9m032_set_pad_selection,
687 .get_selection = mt9m032_get_pad_selection,
688 };
689
690 static const struct v4l2_subdev_ops mt9m032_ops = {
691 .core = &mt9m032_core_ops,
692 .video = &mt9m032_video_ops,
693 .pad = &mt9m032_pad_ops,
694 };
695
696 /* -----------------------------------------------------------------------------
697 * Driver initialization and probing
698 */
699
mt9m032_probe(struct i2c_client * client,const struct i2c_device_id * devid)700 static int mt9m032_probe(struct i2c_client *client,
701 const struct i2c_device_id *devid)
702 {
703 struct mt9m032_platform_data *pdata = client->dev.platform_data;
704 struct i2c_adapter *adapter = client->adapter;
705 struct mt9m032 *sensor;
706 int chip_version;
707 int ret;
708
709 if (pdata == NULL) {
710 dev_err(&client->dev, "No platform data\n");
711 return -EINVAL;
712 }
713
714 if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) {
715 dev_warn(&client->dev,
716 "I2C-Adapter doesn't support I2C_FUNC_SMBUS_WORD\n");
717 return -EIO;
718 }
719
720 if (!client->dev.platform_data)
721 return -ENODEV;
722
723 sensor = devm_kzalloc(&client->dev, sizeof(*sensor), GFP_KERNEL);
724 if (sensor == NULL)
725 return -ENOMEM;
726
727 mutex_init(&sensor->lock);
728
729 sensor->pdata = pdata;
730
731 v4l2_i2c_subdev_init(&sensor->subdev, client, &mt9m032_ops);
732 sensor->subdev.flags |= V4L2_SUBDEV_FL_HAS_DEVNODE;
733
734 chip_version = mt9m032_read(client, MT9M032_CHIP_VERSION);
735 if (chip_version != MT9M032_CHIP_VERSION_VALUE) {
736 dev_err(&client->dev, "MT9M032 not detected, wrong version "
737 "0x%04x\n", chip_version);
738 ret = -ENODEV;
739 goto error_sensor;
740 }
741
742 dev_info(&client->dev, "MT9M032 detected at address 0x%02x\n",
743 client->addr);
744
745 sensor->frame_interval.numerator = 1;
746 sensor->frame_interval.denominator = 30;
747
748 sensor->crop.left = MT9M032_COLUMN_START_DEF;
749 sensor->crop.top = MT9M032_ROW_START_DEF;
750 sensor->crop.width = MT9M032_COLUMN_SIZE_DEF;
751 sensor->crop.height = MT9M032_ROW_SIZE_DEF;
752
753 sensor->format.width = sensor->crop.width;
754 sensor->format.height = sensor->crop.height;
755 sensor->format.code = MEDIA_BUS_FMT_Y8_1X8;
756 sensor->format.field = V4L2_FIELD_NONE;
757 sensor->format.colorspace = V4L2_COLORSPACE_SRGB;
758
759 v4l2_ctrl_handler_init(&sensor->ctrls, 5);
760
761 v4l2_ctrl_new_std(&sensor->ctrls, &mt9m032_ctrl_ops,
762 V4L2_CID_GAIN, 0, 127, 1, 64);
763
764 sensor->hflip = v4l2_ctrl_new_std(&sensor->ctrls,
765 &mt9m032_ctrl_ops,
766 V4L2_CID_HFLIP, 0, 1, 1, 0);
767 sensor->vflip = v4l2_ctrl_new_std(&sensor->ctrls,
768 &mt9m032_ctrl_ops,
769 V4L2_CID_VFLIP, 0, 1, 1, 0);
770
771 v4l2_ctrl_new_std(&sensor->ctrls, &mt9m032_ctrl_ops,
772 V4L2_CID_EXPOSURE, MT9M032_SHUTTER_WIDTH_MIN,
773 MT9M032_SHUTTER_WIDTH_MAX, 1,
774 MT9M032_SHUTTER_WIDTH_DEF);
775 v4l2_ctrl_new_std(&sensor->ctrls, &mt9m032_ctrl_ops,
776 V4L2_CID_PIXEL_RATE, pdata->pix_clock,
777 pdata->pix_clock, 1, pdata->pix_clock);
778
779 if (sensor->ctrls.error) {
780 ret = sensor->ctrls.error;
781 dev_err(&client->dev, "control initialization error %d\n", ret);
782 goto error_ctrl;
783 }
784
785 v4l2_ctrl_cluster(2, &sensor->hflip);
786
787 sensor->subdev.ctrl_handler = &sensor->ctrls;
788 sensor->subdev.entity.function = MEDIA_ENT_F_CAM_SENSOR;
789 sensor->pad.flags = MEDIA_PAD_FL_SOURCE;
790 ret = media_entity_pads_init(&sensor->subdev.entity, 1, &sensor->pad);
791 if (ret < 0)
792 goto error_ctrl;
793
794 ret = mt9m032_write(client, MT9M032_RESET, 1); /* reset on */
795 if (ret < 0)
796 goto error_entity;
797 ret = mt9m032_write(client, MT9M032_RESET, 0); /* reset off */
798 if (ret < 0)
799 goto error_entity;
800
801 ret = mt9m032_setup_pll(sensor);
802 if (ret < 0)
803 goto error_entity;
804 usleep_range(10000, 11000);
805
806 ret = v4l2_ctrl_handler_setup(&sensor->ctrls);
807 if (ret < 0)
808 goto error_entity;
809
810 /* SIZE */
811 ret = mt9m032_update_geom_timing(sensor);
812 if (ret < 0)
813 goto error_entity;
814
815 ret = mt9m032_write(client, 0x41, 0x0000); /* reserved !!! */
816 if (ret < 0)
817 goto error_entity;
818 ret = mt9m032_write(client, 0x42, 0x0003); /* reserved !!! */
819 if (ret < 0)
820 goto error_entity;
821 ret = mt9m032_write(client, 0x43, 0x0003); /* reserved !!! */
822 if (ret < 0)
823 goto error_entity;
824 ret = mt9m032_write(client, 0x7f, 0x0000); /* reserved !!! */
825 if (ret < 0)
826 goto error_entity;
827 if (sensor->pdata->invert_pixclock) {
828 ret = mt9m032_write(client, MT9M032_PIX_CLK_CTRL,
829 MT9M032_PIX_CLK_CTRL_INV_PIXCLK);
830 if (ret < 0)
831 goto error_entity;
832 }
833
834 ret = mt9m032_write(client, MT9M032_RESTART, 1); /* Restart on */
835 if (ret < 0)
836 goto error_entity;
837 msleep(100);
838 ret = mt9m032_write(client, MT9M032_RESTART, 0); /* Restart off */
839 if (ret < 0)
840 goto error_entity;
841 msleep(100);
842 ret = update_formatter2(sensor, false);
843 if (ret < 0)
844 goto error_entity;
845
846 return ret;
847
848 error_entity:
849 media_entity_cleanup(&sensor->subdev.entity);
850 error_ctrl:
851 v4l2_ctrl_handler_free(&sensor->ctrls);
852 error_sensor:
853 mutex_destroy(&sensor->lock);
854 return ret;
855 }
856
mt9m032_remove(struct i2c_client * client)857 static int mt9m032_remove(struct i2c_client *client)
858 {
859 struct v4l2_subdev *subdev = i2c_get_clientdata(client);
860 struct mt9m032 *sensor = to_mt9m032(subdev);
861
862 v4l2_device_unregister_subdev(subdev);
863 v4l2_ctrl_handler_free(&sensor->ctrls);
864 media_entity_cleanup(&subdev->entity);
865 mutex_destroy(&sensor->lock);
866 return 0;
867 }
868
869 static const struct i2c_device_id mt9m032_id_table[] = {
870 { MT9M032_NAME, 0 },
871 { }
872 };
873
874 MODULE_DEVICE_TABLE(i2c, mt9m032_id_table);
875
876 static struct i2c_driver mt9m032_i2c_driver = {
877 .driver = {
878 .name = MT9M032_NAME,
879 },
880 .probe = mt9m032_probe,
881 .remove = mt9m032_remove,
882 .id_table = mt9m032_id_table,
883 };
884
885 module_i2c_driver(mt9m032_i2c_driver);
886
887 MODULE_AUTHOR("Martin Hostettler <martin@neutronstar.dyndns.org>");
888 MODULE_DESCRIPTION("MT9M032 camera sensor driver");
889 MODULE_LICENSE("GPL v2");
890
