Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
mt9m111.c
Go to the documentation of this file.
1 /*
2  * Driver for MT9M111/MT9M112/MT9M131 CMOS Image Sensor from Micron/Aptina
3  *
4  * Copyright (C) 2008, Robert Jarzmik <[email protected]>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation.
9  */
10 #include <linux/videodev2.h>
11 #include <linux/slab.h>
12 #include <linux/i2c.h>
13 #include <linux/log2.h>
14 #include <linux/gpio.h>
15 #include <linux/delay.h>
16 #include <linux/v4l2-mediabus.h>
17 #include <linux/module.h>
18 
19 #include <media/soc_camera.h>
20 #include <media/v4l2-common.h>
21 #include <media/v4l2-ctrls.h>
22 #include <media/v4l2-chip-ident.h>
23 
24 /*
25  * MT9M111, MT9M112 and MT9M131:
26  * i2c address is 0x48 or 0x5d (depending on SADDR pin)
27  * The platform has to define i2c_board_info and call i2c_register_board_info()
28  */
29 
30 /*
31  * Sensor core register addresses (0x000..0x0ff)
32  */
33 #define MT9M111_CHIP_VERSION 0x000
34 #define MT9M111_ROW_START 0x001
35 #define MT9M111_COLUMN_START 0x002
36 #define MT9M111_WINDOW_HEIGHT 0x003
37 #define MT9M111_WINDOW_WIDTH 0x004
38 #define MT9M111_HORIZONTAL_BLANKING_B 0x005
39 #define MT9M111_VERTICAL_BLANKING_B 0x006
40 #define MT9M111_HORIZONTAL_BLANKING_A 0x007
41 #define MT9M111_VERTICAL_BLANKING_A 0x008
42 #define MT9M111_SHUTTER_WIDTH 0x009
43 #define MT9M111_ROW_SPEED 0x00a
44 #define MT9M111_EXTRA_DELAY 0x00b
45 #define MT9M111_SHUTTER_DELAY 0x00c
46 #define MT9M111_RESET 0x00d
47 #define MT9M111_READ_MODE_B 0x020
48 #define MT9M111_READ_MODE_A 0x021
49 #define MT9M111_FLASH_CONTROL 0x023
50 #define MT9M111_GREEN1_GAIN 0x02b
51 #define MT9M111_BLUE_GAIN 0x02c
52 #define MT9M111_RED_GAIN 0x02d
53 #define MT9M111_GREEN2_GAIN 0x02e
54 #define MT9M111_GLOBAL_GAIN 0x02f
55 #define MT9M111_CONTEXT_CONTROL 0x0c8
56 #define MT9M111_PAGE_MAP 0x0f0
57 #define MT9M111_BYTE_WISE_ADDR 0x0f1
58 
59 #define MT9M111_RESET_SYNC_CHANGES (1 << 15)
60 #define MT9M111_RESET_RESTART_BAD_FRAME (1 << 9)
61 #define MT9M111_RESET_SHOW_BAD_FRAMES (1 << 8)
62 #define MT9M111_RESET_RESET_SOC (1 << 5)
63 #define MT9M111_RESET_OUTPUT_DISABLE (1 << 4)
64 #define MT9M111_RESET_CHIP_ENABLE (1 << 3)
65 #define MT9M111_RESET_ANALOG_STANDBY (1 << 2)
66 #define MT9M111_RESET_RESTART_FRAME (1 << 1)
67 #define MT9M111_RESET_RESET_MODE (1 << 0)
68 
69 #define MT9M111_RM_FULL_POWER_RD (0 << 10)
70 #define MT9M111_RM_LOW_POWER_RD (1 << 10)
71 #define MT9M111_RM_COL_SKIP_4X (1 << 5)
72 #define MT9M111_RM_ROW_SKIP_4X (1 << 4)
73 #define MT9M111_RM_COL_SKIP_2X (1 << 3)
74 #define MT9M111_RM_ROW_SKIP_2X (1 << 2)
75 #define MT9M111_RMB_MIRROR_COLS (1 << 1)
76 #define MT9M111_RMB_MIRROR_ROWS (1 << 0)
77 #define MT9M111_CTXT_CTRL_RESTART (1 << 15)
78 #define MT9M111_CTXT_CTRL_DEFECTCOR_B (1 << 12)
79 #define MT9M111_CTXT_CTRL_RESIZE_B (1 << 10)
80 #define MT9M111_CTXT_CTRL_CTRL2_B (1 << 9)
81 #define MT9M111_CTXT_CTRL_GAMMA_B (1 << 8)
82 #define MT9M111_CTXT_CTRL_XENON_EN (1 << 7)
83 #define MT9M111_CTXT_CTRL_READ_MODE_B (1 << 3)
84 #define MT9M111_CTXT_CTRL_LED_FLASH_EN (1 << 2)
85 #define MT9M111_CTXT_CTRL_VBLANK_SEL_B (1 << 1)
86 #define MT9M111_CTXT_CTRL_HBLANK_SEL_B (1 << 0)
87 
88 /*
89  * Colorpipe register addresses (0x100..0x1ff)
90  */
91 #define MT9M111_OPER_MODE_CTRL 0x106
92 #define MT9M111_OUTPUT_FORMAT_CTRL 0x108
93 #define MT9M111_REDUCER_XZOOM_B 0x1a0
94 #define MT9M111_REDUCER_XSIZE_B 0x1a1
95 #define MT9M111_REDUCER_YZOOM_B 0x1a3
96 #define MT9M111_REDUCER_YSIZE_B 0x1a4
97 #define MT9M111_REDUCER_XZOOM_A 0x1a6
98 #define MT9M111_REDUCER_XSIZE_A 0x1a7
99 #define MT9M111_REDUCER_YZOOM_A 0x1a9
100 #define MT9M111_REDUCER_YSIZE_A 0x1aa
101 
102 #define MT9M111_OUTPUT_FORMAT_CTRL2_A 0x13a
103 #define MT9M111_OUTPUT_FORMAT_CTRL2_B 0x19b
104 
105 #define MT9M111_OPMODE_AUTOEXPO_EN (1 << 14)
106 #define MT9M111_OPMODE_AUTOWHITEBAL_EN (1 << 1)
107 #define MT9M111_OUTFMT_FLIP_BAYER_COL (1 << 9)
108 #define MT9M111_OUTFMT_FLIP_BAYER_ROW (1 << 8)
109 #define MT9M111_OUTFMT_PROCESSED_BAYER (1 << 14)
110 #define MT9M111_OUTFMT_BYPASS_IFP (1 << 10)
111 #define MT9M111_OUTFMT_INV_PIX_CLOCK (1 << 9)
112 #define MT9M111_OUTFMT_RGB (1 << 8)
113 #define MT9M111_OUTFMT_RGB565 (0 << 6)
114 #define MT9M111_OUTFMT_RGB555 (1 << 6)
115 #define MT9M111_OUTFMT_RGB444x (2 << 6)
116 #define MT9M111_OUTFMT_RGBx444 (3 << 6)
117 #define MT9M111_OUTFMT_TST_RAMP_OFF (0 << 4)
118 #define MT9M111_OUTFMT_TST_RAMP_COL (1 << 4)
119 #define MT9M111_OUTFMT_TST_RAMP_ROW (2 << 4)
120 #define MT9M111_OUTFMT_TST_RAMP_FRAME (3 << 4)
121 #define MT9M111_OUTFMT_SHIFT_3_UP (1 << 3)
122 #define MT9M111_OUTFMT_AVG_CHROMA (1 << 2)
123 #define MT9M111_OUTFMT_SWAP_YCbCr_C_Y_RGB_EVEN (1 << 1)
124 #define MT9M111_OUTFMT_SWAP_YCbCr_Cb_Cr_RGB_R_B (1 << 0)
125 
126 /*
127  * Camera control register addresses (0x200..0x2ff not implemented)
128  */
129 
130 #define reg_read(reg) mt9m111_reg_read(client, MT9M111_##reg)
131 #define reg_write(reg, val) mt9m111_reg_write(client, MT9M111_##reg, (val))
132 #define reg_set(reg, val) mt9m111_reg_set(client, MT9M111_##reg, (val))
133 #define reg_clear(reg, val) mt9m111_reg_clear(client, MT9M111_##reg, (val))
134 #define reg_mask(reg, val, mask) mt9m111_reg_mask(client, MT9M111_##reg, \
135  (val), (mask))
136 
137 #define MT9M111_MIN_DARK_ROWS 8
138 #define MT9M111_MIN_DARK_COLS 26
139 #define MT9M111_MAX_HEIGHT 1024
140 #define MT9M111_MAX_WIDTH 1280
141 
152 };
153 
154 static struct mt9m111_context context_a = {
155  .read_mode = MT9M111_READ_MODE_A,
156  .blanking_h = MT9M111_HORIZONTAL_BLANKING_A,
157  .blanking_v = MT9M111_VERTICAL_BLANKING_A,
158  .reducer_xzoom = MT9M111_REDUCER_XZOOM_A,
159  .reducer_yzoom = MT9M111_REDUCER_YZOOM_A,
160  .reducer_xsize = MT9M111_REDUCER_XSIZE_A,
161  .reducer_ysize = MT9M111_REDUCER_YSIZE_A,
162  .output_fmt_ctrl2 = MT9M111_OUTPUT_FORMAT_CTRL2_A,
163  .control = MT9M111_CTXT_CTRL_RESTART,
164 };
165 
166 static struct mt9m111_context context_b = {
167  .read_mode = MT9M111_READ_MODE_B,
168  .blanking_h = MT9M111_HORIZONTAL_BLANKING_B,
169  .blanking_v = MT9M111_VERTICAL_BLANKING_B,
170  .reducer_xzoom = MT9M111_REDUCER_XZOOM_B,
171  .reducer_yzoom = MT9M111_REDUCER_YZOOM_B,
172  .reducer_xsize = MT9M111_REDUCER_XSIZE_B,
173  .reducer_ysize = MT9M111_REDUCER_YSIZE_B,
174  .output_fmt_ctrl2 = MT9M111_OUTPUT_FORMAT_CTRL2_B,
175  .control = MT9M111_CTXT_CTRL_RESTART |
180 };
181 
182 /* MT9M111 has only one fixed colorspace per pixelcode */
186 };
187 
188 static const struct mt9m111_datafmt mt9m111_colour_fmts[] = {
201 };
202 
203 struct mt9m111 {
206  struct v4l2_ctrl *gain;
207  int model; /* V4L2_IDENT_MT9M111 or V4L2_IDENT_MT9M112 code
208  * from v4l2-chip-ident.h */
210  struct v4l2_rect rect; /* cropping rectangle */
211  int width; /* output */
212  int height; /* sizes */
213  struct mutex power_lock; /* lock to protect power_count */
215  const struct mt9m111_datafmt *fmt;
216  int lastpage; /* PageMap cache value */
217 };
218 
219 /* Find a data format by a pixel code */
220 static const struct mt9m111_datafmt *mt9m111_find_datafmt(struct mt9m111 *mt9m111,
222 {
223  int i;
224  for (i = 0; i < ARRAY_SIZE(mt9m111_colour_fmts); i++)
225  if (mt9m111_colour_fmts[i].code == code)
226  return mt9m111_colour_fmts + i;
227 
228  return mt9m111->fmt;
229 }
230 
231 static struct mt9m111 *to_mt9m111(const struct i2c_client *client)
232 {
233  return container_of(i2c_get_clientdata(client), struct mt9m111, subdev);
234 }
235 
236 static int reg_page_map_set(struct i2c_client *client, const u16 reg)
237 {
238  int ret;
239  u16 page;
240  struct mt9m111 *mt9m111 = to_mt9m111(client);
241 
242  page = (reg >> 8);
243  if (page == mt9m111->lastpage)
244  return 0;
245  if (page > 2)
246  return -EINVAL;
247 
248  ret = i2c_smbus_write_word_swapped(client, MT9M111_PAGE_MAP, page);
249  if (!ret)
250  mt9m111->lastpage = page;
251  return ret;
252 }
253 
254 static int mt9m111_reg_read(struct i2c_client *client, const u16 reg)
255 {
256  int ret;
257 
258  ret = reg_page_map_set(client, reg);
259  if (!ret)
260  ret = i2c_smbus_read_word_swapped(client, reg & 0xff);
261 
262  dev_dbg(&client->dev, "read reg.%03x -> %04x\n", reg, ret);
263  return ret;
264 }
265 
266 static int mt9m111_reg_write(struct i2c_client *client, const u16 reg,
267  const u16 data)
268 {
269  int ret;
270 
271  ret = reg_page_map_set(client, reg);
272  if (!ret)
273  ret = i2c_smbus_write_word_swapped(client, reg & 0xff, data);
274  dev_dbg(&client->dev, "write reg.%03x = %04x -> %d\n", reg, data, ret);
275  return ret;
276 }
277 
278 static int mt9m111_reg_set(struct i2c_client *client, const u16 reg,
279  const u16 data)
280 {
281  int ret;
282 
283  ret = mt9m111_reg_read(client, reg);
284  if (ret >= 0)
285  ret = mt9m111_reg_write(client, reg, ret | data);
286  return ret;
287 }
288 
289 static int mt9m111_reg_clear(struct i2c_client *client, const u16 reg,
290  const u16 data)
291 {
292  int ret;
293 
294  ret = mt9m111_reg_read(client, reg);
295  if (ret >= 0)
296  ret = mt9m111_reg_write(client, reg, ret & ~data);
297  return ret;
298 }
299 
300 static int mt9m111_reg_mask(struct i2c_client *client, const u16 reg,
301  const u16 data, const u16 mask)
302 {
303  int ret;
304 
305  ret = mt9m111_reg_read(client, reg);
306  if (ret >= 0)
307  ret = mt9m111_reg_write(client, reg, (ret & ~mask) | data);
308  return ret;
309 }
310 
311 static int mt9m111_set_context(struct mt9m111 *mt9m111,
312  struct mt9m111_context *ctx)
313 {
314  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
315  return reg_write(CONTEXT_CONTROL, ctx->control);
316 }
317 
318 static int mt9m111_setup_rect_ctx(struct mt9m111 *mt9m111,
319  struct mt9m111_context *ctx, struct v4l2_rect *rect,
320  unsigned int width, unsigned int height)
321 {
322  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
323  int ret = mt9m111_reg_write(client, ctx->reducer_xzoom, rect->width);
324  if (!ret)
325  ret = mt9m111_reg_write(client, ctx->reducer_yzoom, rect->height);
326  if (!ret)
327  ret = mt9m111_reg_write(client, ctx->reducer_xsize, width);
328  if (!ret)
329  ret = mt9m111_reg_write(client, ctx->reducer_ysize, height);
330  return ret;
331 }
332 
333 static int mt9m111_setup_geometry(struct mt9m111 *mt9m111, struct v4l2_rect *rect,
334  int width, int height, enum v4l2_mbus_pixelcode code)
335 {
336  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
337  int ret;
338 
339  ret = reg_write(COLUMN_START, rect->left);
340  if (!ret)
341  ret = reg_write(ROW_START, rect->top);
342 
343  if (!ret)
344  ret = reg_write(WINDOW_WIDTH, rect->width);
345  if (!ret)
346  ret = reg_write(WINDOW_HEIGHT, rect->height);
347 
349  /* IFP in use, down-scaling possible */
350  if (!ret)
351  ret = mt9m111_setup_rect_ctx(mt9m111, &context_b,
352  rect, width, height);
353  if (!ret)
354  ret = mt9m111_setup_rect_ctx(mt9m111, &context_a,
355  rect, width, height);
356  }
357 
358  dev_dbg(&client->dev, "%s(%x): %ux%u@%u:%u -> %ux%u = %d\n",
359  __func__, code, rect->width, rect->height, rect->left, rect->top,
360  width, height, ret);
361 
362  return ret;
363 }
364 
365 static int mt9m111_enable(struct mt9m111 *mt9m111)
366 {
367  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
369 }
370 
371 static int mt9m111_reset(struct mt9m111 *mt9m111)
372 {
373  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
374  int ret;
375 
377  if (!ret)
379  if (!ret)
382 
383  return ret;
384 }
385 
386 static int mt9m111_s_crop(struct v4l2_subdev *sd, const struct v4l2_crop *a)
387 {
388  struct v4l2_rect rect = a->c;
389  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
390  int width, height;
391  int ret;
392 
394  return -EINVAL;
395 
396  if (mt9m111->fmt->code == V4L2_MBUS_FMT_SBGGR8_1X8 ||
397  mt9m111->fmt->code == V4L2_MBUS_FMT_SBGGR10_2X8_PADHI_LE) {
398  /* Bayer format - even size lengths */
399  rect.width = ALIGN(rect.width, 2);
400  rect.height = ALIGN(rect.height, 2);
401  /* Let the user play with the starting pixel */
402  }
403 
404  /* FIXME: the datasheet doesn't specify minimum sizes */
405  soc_camera_limit_side(&rect.left, &rect.width,
407 
408  soc_camera_limit_side(&rect.top, &rect.height,
410 
411  width = min(mt9m111->width, rect.width);
412  height = min(mt9m111->height, rect.height);
413 
414  ret = mt9m111_setup_geometry(mt9m111, &rect, width, height, mt9m111->fmt->code);
415  if (!ret) {
416  mt9m111->rect = rect;
417  mt9m111->width = width;
418  mt9m111->height = height;
419  }
420 
421  return ret;
422 }
423 
424 static int mt9m111_g_crop(struct v4l2_subdev *sd, struct v4l2_crop *a)
425 {
426  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
427 
428  a->c = mt9m111->rect;
430 
431  return 0;
432 }
433 
434 static int mt9m111_cropcap(struct v4l2_subdev *sd, struct v4l2_cropcap *a)
435 {
437  return -EINVAL;
438 
439  a->bounds.left = MT9M111_MIN_DARK_COLS;
440  a->bounds.top = MT9M111_MIN_DARK_ROWS;
441  a->bounds.width = MT9M111_MAX_WIDTH;
442  a->bounds.height = MT9M111_MAX_HEIGHT;
443  a->defrect = a->bounds;
444  a->pixelaspect.numerator = 1;
445  a->pixelaspect.denominator = 1;
446 
447  return 0;
448 }
449 
450 static int mt9m111_g_fmt(struct v4l2_subdev *sd,
451  struct v4l2_mbus_framefmt *mf)
452 {
453  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
454 
455  mf->width = mt9m111->width;
456  mf->height = mt9m111->height;
457  mf->code = mt9m111->fmt->code;
458  mf->colorspace = mt9m111->fmt->colorspace;
459  mf->field = V4L2_FIELD_NONE;
460 
461  return 0;
462 }
463 
464 static int mt9m111_set_pixfmt(struct mt9m111 *mt9m111,
465  enum v4l2_mbus_pixelcode code)
466 {
467  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
468  u16 data_outfmt2, mask_outfmt2 = MT9M111_OUTFMT_PROCESSED_BAYER |
474  int ret;
475 
476  switch (code) {
478  data_outfmt2 = MT9M111_OUTFMT_PROCESSED_BAYER |
480  break;
483  break;
485  data_outfmt2 = MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB555 |
487  break;
489  data_outfmt2 = MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB555;
490  break;
492  data_outfmt2 = MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB565 |
494  break;
496  data_outfmt2 = MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB565;
497  break;
499  data_outfmt2 = MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB565 |
501  break;
503  data_outfmt2 = MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB565 |
506  break;
508  data_outfmt2 = 0;
509  break;
512  break;
515  break;
519  break;
520  default:
521  dev_err(&client->dev, "Pixel format not handled: %x\n", code);
522  return -EINVAL;
523  }
524 
525  ret = mt9m111_reg_mask(client, context_a.output_fmt_ctrl2,
526  data_outfmt2, mask_outfmt2);
527  if (!ret)
528  ret = mt9m111_reg_mask(client, context_b.output_fmt_ctrl2,
529  data_outfmt2, mask_outfmt2);
530 
531  return ret;
532 }
533 
534 static int mt9m111_try_fmt(struct v4l2_subdev *sd,
535  struct v4l2_mbus_framefmt *mf)
536 {
537  struct i2c_client *client = v4l2_get_subdevdata(sd);
538  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
539  const struct mt9m111_datafmt *fmt;
540  struct v4l2_rect *rect = &mt9m111->rect;
541  bool bayer;
542 
543  fmt = mt9m111_find_datafmt(mt9m111, mf->code);
544 
545  bayer = fmt->code == V4L2_MBUS_FMT_SBGGR8_1X8 ||
547 
548  /*
549  * With Bayer format enforce even side lengths, but let the user play
550  * with the starting pixel
551  */
552  if (bayer) {
553  rect->width = ALIGN(rect->width, 2);
554  rect->height = ALIGN(rect->height, 2);
555  }
556 
558  /* IFP bypass mode, no scaling */
559  mf->width = rect->width;
560  mf->height = rect->height;
561  } else {
562  /* No upscaling */
563  if (mf->width > rect->width)
564  mf->width = rect->width;
565  if (mf->height > rect->height)
566  mf->height = rect->height;
567  }
568 
569  dev_dbg(&client->dev, "%s(): %ux%u, code=%x\n", __func__,
570  mf->width, mf->height, fmt->code);
571 
572  mf->code = fmt->code;
573  mf->colorspace = fmt->colorspace;
574 
575  return 0;
576 }
577 
578 static int mt9m111_s_fmt(struct v4l2_subdev *sd,
579  struct v4l2_mbus_framefmt *mf)
580 {
581  const struct mt9m111_datafmt *fmt;
582  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
583  struct v4l2_rect *rect = &mt9m111->rect;
584  int ret;
585 
586  mt9m111_try_fmt(sd, mf);
587  fmt = mt9m111_find_datafmt(mt9m111, mf->code);
588  /* try_fmt() guarantees fmt != NULL && fmt->code == mf->code */
589 
590  ret = mt9m111_setup_geometry(mt9m111, rect, mf->width, mf->height, mf->code);
591  if (!ret)
592  ret = mt9m111_set_pixfmt(mt9m111, mf->code);
593  if (!ret) {
594  mt9m111->width = mf->width;
595  mt9m111->height = mf->height;
596  mt9m111->fmt = fmt;
597  }
598 
599  return ret;
600 }
601 
602 static int mt9m111_g_chip_ident(struct v4l2_subdev *sd,
603  struct v4l2_dbg_chip_ident *id)
604 {
605  struct i2c_client *client = v4l2_get_subdevdata(sd);
606  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
607 
608  if (id->match.type != V4L2_CHIP_MATCH_I2C_ADDR)
609  return -EINVAL;
610 
611  if (id->match.addr != client->addr)
612  return -ENODEV;
613 
614  id->ident = mt9m111->model;
615  id->revision = 0;
616 
617  return 0;
618 }
619 
620 #ifdef CONFIG_VIDEO_ADV_DEBUG
621 static int mt9m111_g_register(struct v4l2_subdev *sd,
622  struct v4l2_dbg_register *reg)
623 {
624  struct i2c_client *client = v4l2_get_subdevdata(sd);
625  int val;
626 
627  if (reg->match.type != V4L2_CHIP_MATCH_I2C_ADDR || reg->reg > 0x2ff)
628  return -EINVAL;
629  if (reg->match.addr != client->addr)
630  return -ENODEV;
631 
632  val = mt9m111_reg_read(client, reg->reg);
633  reg->size = 2;
634  reg->val = (u64)val;
635 
636  if (reg->val > 0xffff)
637  return -EIO;
638 
639  return 0;
640 }
641 
642 static int mt9m111_s_register(struct v4l2_subdev *sd,
643  struct v4l2_dbg_register *reg)
644 {
645  struct i2c_client *client = v4l2_get_subdevdata(sd);
646 
647  if (reg->match.type != V4L2_CHIP_MATCH_I2C_ADDR || reg->reg > 0x2ff)
648  return -EINVAL;
649 
650  if (reg->match.addr != client->addr)
651  return -ENODEV;
652 
653  if (mt9m111_reg_write(client, reg->reg, reg->val) < 0)
654  return -EIO;
655 
656  return 0;
657 }
658 #endif
659 
660 static int mt9m111_set_flip(struct mt9m111 *mt9m111, int flip, int mask)
661 {
662  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
663  int ret;
664 
665  if (flip)
666  ret = mt9m111_reg_set(client, mt9m111->ctx->read_mode, mask);
667  else
668  ret = mt9m111_reg_clear(client, mt9m111->ctx->read_mode, mask);
669 
670  return ret;
671 }
672 
673 static int mt9m111_get_global_gain(struct mt9m111 *mt9m111)
674 {
675  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
676  int data;
677 
678  data = reg_read(GLOBAL_GAIN);
679  if (data >= 0)
680  return (data & 0x2f) * (1 << ((data >> 10) & 1)) *
681  (1 << ((data >> 9) & 1));
682  return data;
683 }
684 
685 static int mt9m111_set_global_gain(struct mt9m111 *mt9m111, int gain)
686 {
687  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
688  u16 val;
689 
690  if (gain > 63 * 2 * 2)
691  return -EINVAL;
692 
693  if ((gain >= 64 * 2) && (gain < 63 * 2 * 2))
694  val = (1 << 10) | (1 << 9) | (gain / 4);
695  else if ((gain >= 64) && (gain < 64 * 2))
696  val = (1 << 9) | (gain / 2);
697  else
698  val = gain;
699 
700  return reg_write(GLOBAL_GAIN, val);
701 }
702 
703 static int mt9m111_set_autoexposure(struct mt9m111 *mt9m111, int on)
704 {
705  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
706 
707  if (on)
708  return reg_set(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOEXPO_EN);
709  return reg_clear(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOEXPO_EN);
710 }
711 
712 static int mt9m111_set_autowhitebalance(struct mt9m111 *mt9m111, int on)
713 {
714  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
715 
716  if (on)
717  return reg_set(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOWHITEBAL_EN);
718  return reg_clear(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOWHITEBAL_EN);
719 }
720 
721 static int mt9m111_s_ctrl(struct v4l2_ctrl *ctrl)
722 {
723  struct mt9m111 *mt9m111 = container_of(ctrl->handler,
724  struct mt9m111, hdl);
725 
726  switch (ctrl->id) {
727  case V4L2_CID_VFLIP:
728  return mt9m111_set_flip(mt9m111, ctrl->val,
730  case V4L2_CID_HFLIP:
731  return mt9m111_set_flip(mt9m111, ctrl->val,
733  case V4L2_CID_GAIN:
734  return mt9m111_set_global_gain(mt9m111, ctrl->val);
736  return mt9m111_set_autoexposure(mt9m111, ctrl->val);
738  return mt9m111_set_autowhitebalance(mt9m111, ctrl->val);
739  }
740 
741  return -EINVAL;
742 }
743 
744 static int mt9m111_suspend(struct mt9m111 *mt9m111)
745 {
746  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
747  int ret;
748 
749  v4l2_ctrl_s_ctrl(mt9m111->gain, mt9m111_get_global_gain(mt9m111));
750 
752  if (!ret)
756  if (!ret)
758 
759  return ret;
760 }
761 
762 static void mt9m111_restore_state(struct mt9m111 *mt9m111)
763 {
764  mt9m111_set_context(mt9m111, mt9m111->ctx);
765  mt9m111_set_pixfmt(mt9m111, mt9m111->fmt->code);
766  mt9m111_setup_geometry(mt9m111, &mt9m111->rect,
767  mt9m111->width, mt9m111->height, mt9m111->fmt->code);
768  v4l2_ctrl_handler_setup(&mt9m111->hdl);
769 }
770 
771 static int mt9m111_resume(struct mt9m111 *mt9m111)
772 {
773  int ret = mt9m111_enable(mt9m111);
774  if (!ret)
775  ret = mt9m111_reset(mt9m111);
776  if (!ret)
777  mt9m111_restore_state(mt9m111);
778 
779  return ret;
780 }
781 
782 static int mt9m111_init(struct mt9m111 *mt9m111)
783 {
784  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
785  int ret;
786 
787  /* Default HIGHPOWER context */
788  mt9m111->ctx = &context_b;
789  ret = mt9m111_enable(mt9m111);
790  if (!ret)
791  ret = mt9m111_reset(mt9m111);
792  if (!ret)
793  ret = mt9m111_set_context(mt9m111, mt9m111->ctx);
794  if (ret)
795  dev_err(&client->dev, "mt9m111 init failed: %d\n", ret);
796  return ret;
797 }
798 
799 static int mt9m111_power_on(struct mt9m111 *mt9m111)
800 {
801  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
802  struct soc_camera_link *icl = soc_camera_i2c_to_link(client);
803  int ret;
804 
805  ret = soc_camera_power_on(&client->dev, icl);
806  if (ret < 0)
807  return ret;
808 
809  ret = mt9m111_resume(mt9m111);
810  if (ret < 0) {
811  dev_err(&client->dev, "Failed to resume the sensor: %d\n", ret);
812  soc_camera_power_off(&client->dev, icl);
813  }
814 
815  return ret;
816 }
817 
818 static void mt9m111_power_off(struct mt9m111 *mt9m111)
819 {
820  struct i2c_client *client = v4l2_get_subdevdata(&mt9m111->subdev);
821  struct soc_camera_link *icl = soc_camera_i2c_to_link(client);
822 
823  mt9m111_suspend(mt9m111);
824  soc_camera_power_off(&client->dev, icl);
825 }
826 
827 static int mt9m111_s_power(struct v4l2_subdev *sd, int on)
828 {
829  struct mt9m111 *mt9m111 = container_of(sd, struct mt9m111, subdev);
830  int ret = 0;
831 
832  mutex_lock(&mt9m111->power_lock);
833 
834  /*
835  * If the power count is modified from 0 to != 0 or from != 0 to 0,
836  * update the power state.
837  */
838  if (mt9m111->power_count == !on) {
839  if (on)
840  ret = mt9m111_power_on(mt9m111);
841  else
842  mt9m111_power_off(mt9m111);
843  }
844 
845  if (!ret) {
846  /* Update the power count. */
847  mt9m111->power_count += on ? 1 : -1;
848  WARN_ON(mt9m111->power_count < 0);
849  }
850 
851  mutex_unlock(&mt9m111->power_lock);
852  return ret;
853 }
854 
855 static const struct v4l2_ctrl_ops mt9m111_ctrl_ops = {
856  .s_ctrl = mt9m111_s_ctrl,
857 };
858 
859 static struct v4l2_subdev_core_ops mt9m111_subdev_core_ops = {
860  .g_chip_ident = mt9m111_g_chip_ident,
861  .s_power = mt9m111_s_power,
862 #ifdef CONFIG_VIDEO_ADV_DEBUG
863  .g_register = mt9m111_g_register,
864  .s_register = mt9m111_s_register,
865 #endif
866 };
867 
868 static int mt9m111_enum_fmt(struct v4l2_subdev *sd, unsigned int index,
869  enum v4l2_mbus_pixelcode *code)
870 {
871  if (index >= ARRAY_SIZE(mt9m111_colour_fmts))
872  return -EINVAL;
873 
874  *code = mt9m111_colour_fmts[index].code;
875  return 0;
876 }
877 
878 static int mt9m111_g_mbus_config(struct v4l2_subdev *sd,
879  struct v4l2_mbus_config *cfg)
880 {
881  struct i2c_client *client = v4l2_get_subdevdata(sd);
882  struct soc_camera_link *icl = soc_camera_i2c_to_link(client);
883 
887  cfg->type = V4L2_MBUS_PARALLEL;
888  cfg->flags = soc_camera_apply_board_flags(icl, cfg);
889 
890  return 0;
891 }
892 
893 static struct v4l2_subdev_video_ops mt9m111_subdev_video_ops = {
894  .s_mbus_fmt = mt9m111_s_fmt,
895  .g_mbus_fmt = mt9m111_g_fmt,
896  .try_mbus_fmt = mt9m111_try_fmt,
897  .s_crop = mt9m111_s_crop,
898  .g_crop = mt9m111_g_crop,
899  .cropcap = mt9m111_cropcap,
900  .enum_mbus_fmt = mt9m111_enum_fmt,
901  .g_mbus_config = mt9m111_g_mbus_config,
902 };
903 
904 static struct v4l2_subdev_ops mt9m111_subdev_ops = {
905  .core = &mt9m111_subdev_core_ops,
906  .video = &mt9m111_subdev_video_ops,
907 };
908 
909 /*
910  * Interface active, can use i2c. If it fails, it can indeed mean, that
911  * this wasn't our capture interface, so, we wait for the right one
912  */
913 static int mt9m111_video_probe(struct i2c_client *client)
914 {
915  struct mt9m111 *mt9m111 = to_mt9m111(client);
916  s32 data;
917  int ret;
918 
919  ret = mt9m111_s_power(&mt9m111->subdev, 1);
920  if (ret < 0)
921  return ret;
922 
923  data = reg_read(CHIP_VERSION);
924 
925  switch (data) {
926  case 0x143a: /* MT9M111 or MT9M131 */
927  mt9m111->model = V4L2_IDENT_MT9M111;
928  dev_info(&client->dev,
929  "Detected a MT9M111/MT9M131 chip ID %x\n", data);
930  break;
931  case 0x148c: /* MT9M112 */
932  mt9m111->model = V4L2_IDENT_MT9M112;
933  dev_info(&client->dev, "Detected a MT9M112 chip ID %x\n", data);
934  break;
935  default:
936  dev_err(&client->dev,
937  "No MT9M111/MT9M112/MT9M131 chip detected register read %x\n",
938  data);
939  ret = -ENODEV;
940  goto done;
941  }
942 
943  ret = mt9m111_init(mt9m111);
944  if (ret)
945  goto done;
946 
947  ret = v4l2_ctrl_handler_setup(&mt9m111->hdl);
948 
949 done:
950  mt9m111_s_power(&mt9m111->subdev, 0);
951  return ret;
952 }
953 
954 static int mt9m111_probe(struct i2c_client *client,
955  const struct i2c_device_id *did)
956 {
957  struct mt9m111 *mt9m111;
958  struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
959  struct soc_camera_link *icl = soc_camera_i2c_to_link(client);
960  int ret;
961 
962  if (!icl) {
963  dev_err(&client->dev, "mt9m111: driver needs platform data\n");
964  return -EINVAL;
965  }
966 
967  if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) {
968  dev_warn(&adapter->dev,
969  "I2C-Adapter doesn't support I2C_FUNC_SMBUS_WORD\n");
970  return -EIO;
971  }
972 
973  mt9m111 = kzalloc(sizeof(struct mt9m111), GFP_KERNEL);
974  if (!mt9m111)
975  return -ENOMEM;
976 
977  v4l2_i2c_subdev_init(&mt9m111->subdev, client, &mt9m111_subdev_ops);
978  v4l2_ctrl_handler_init(&mt9m111->hdl, 5);
979  v4l2_ctrl_new_std(&mt9m111->hdl, &mt9m111_ctrl_ops,
980  V4L2_CID_VFLIP, 0, 1, 1, 0);
981  v4l2_ctrl_new_std(&mt9m111->hdl, &mt9m111_ctrl_ops,
982  V4L2_CID_HFLIP, 0, 1, 1, 0);
983  v4l2_ctrl_new_std(&mt9m111->hdl, &mt9m111_ctrl_ops,
984  V4L2_CID_AUTO_WHITE_BALANCE, 0, 1, 1, 1);
985  mt9m111->gain = v4l2_ctrl_new_std(&mt9m111->hdl, &mt9m111_ctrl_ops,
986  V4L2_CID_GAIN, 0, 63 * 2 * 2, 1, 32);
987  v4l2_ctrl_new_std_menu(&mt9m111->hdl,
988  &mt9m111_ctrl_ops, V4L2_CID_EXPOSURE_AUTO, 1, 0,
990  mt9m111->subdev.ctrl_handler = &mt9m111->hdl;
991  if (mt9m111->hdl.error) {
992  int err = mt9m111->hdl.error;
993 
994  kfree(mt9m111);
995  return err;
996  }
997 
998  /* Second stage probe - when a capture adapter is there */
999  mt9m111->rect.left = MT9M111_MIN_DARK_COLS;
1000  mt9m111->rect.top = MT9M111_MIN_DARK_ROWS;
1001  mt9m111->rect.width = MT9M111_MAX_WIDTH;
1002  mt9m111->rect.height = MT9M111_MAX_HEIGHT;
1003  mt9m111->fmt = &mt9m111_colour_fmts[0];
1004  mt9m111->lastpage = -1;
1005  mutex_init(&mt9m111->power_lock);
1006 
1007  ret = mt9m111_video_probe(client);
1008  if (ret) {
1009  v4l2_ctrl_handler_free(&mt9m111->hdl);
1010  kfree(mt9m111);
1011  }
1012 
1013  return ret;
1014 }
1015 
1016 static int mt9m111_remove(struct i2c_client *client)
1017 {
1018  struct mt9m111 *mt9m111 = to_mt9m111(client);
1019 
1021  v4l2_ctrl_handler_free(&mt9m111->hdl);
1022  kfree(mt9m111);
1023 
1024  return 0;
1025 }
1026 
1027 static const struct i2c_device_id mt9m111_id[] = {
1028  { "mt9m111", 0 },
1029  { }
1030 };
1031 MODULE_DEVICE_TABLE(i2c, mt9m111_id);
1032 
1033 static struct i2c_driver mt9m111_i2c_driver = {
1034  .driver = {
1035  .name = "mt9m111",
1036  },
1037  .probe = mt9m111_probe,
1038  .remove = mt9m111_remove,
1039  .id_table = mt9m111_id,
1040 };
1041 
1042 module_i2c_driver(mt9m111_i2c_driver);
1043 
1044 MODULE_DESCRIPTION("Micron/Aptina MT9M111/MT9M112/MT9M131 Camera driver");
1045 MODULE_AUTHOR("Robert Jarzmik");
1046 MODULE_LICENSE("GPL");