drivers/media/i2c/soc_camera/soc_mt9v022.c

   1 /*
   2  * Driver for MT9V022 CMOS Image Sensor from Micron
   3  *
   4  * Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
   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
  11 #include <linux/videodev2.h>
  12 #include <linux/slab.h>
  13 #include <linux/i2c.h>
  14 #include <linux/delay.h>
  15 #include <linux/log2.h>
  16 #include <linux/module.h>
  17
  18 #include <media/i2c/mt9v022.h>
  19 #include <media/soc_camera.h>
  20 #include <media/drv-intf/soc_mediabus.h>
  21 #include <media/v4l2-subdev.h>
  22 #include <media/v4l2-clk.h>
  23 #include <media/v4l2-ctrls.h>
  24
  25 /*
  26  * mt9v022 i2c address 0x48, 0x4c, 0x58, 0x5c
  27  * The platform has to define struct i2c_board_info objects and link to them
  28  * from struct soc_camera_host_desc
  29  */
  30
  31 static char *sensor_type;
  32 module_param(sensor_type, charp, S_IRUGO);
  33 MODULE_PARM_DESC(sensor_type, "Sensor type: \"colour\" or \"monochrome\"");
  34
  35 /* mt9v022 selected register addresses */
  36 #define MT9V022_CHIP_VERSION            0x00
  37 #define MT9V022_COLUMN_START            0x01
  38 #define MT9V022_ROW_START               0x02
  39 #define MT9V022_WINDOW_HEIGHT           0x03
  40 #define MT9V022_WINDOW_WIDTH            0x04
  41 #define MT9V022_HORIZONTAL_BLANKING     0x05
  42 #define MT9V022_VERTICAL_BLANKING       0x06
  43 #define MT9V022_CHIP_CONTROL            0x07
  44 #define MT9V022_SHUTTER_WIDTH1          0x08
  45 #define MT9V022_SHUTTER_WIDTH2          0x09
  46 #define MT9V022_SHUTTER_WIDTH_CTRL      0x0a
  47 #define MT9V022_TOTAL_SHUTTER_WIDTH     0x0b
  48 #define MT9V022_RESET                   0x0c
  49 #define MT9V022_READ_MODE               0x0d
  50 #define MT9V022_MONITOR_MODE            0x0e
  51 #define MT9V022_PIXEL_OPERATION_MODE    0x0f
  52 #define MT9V022_LED_OUT_CONTROL         0x1b
  53 #define MT9V022_ADC_MODE_CONTROL        0x1c
  54 #define MT9V022_REG32                   0x20
  55 #define MT9V022_ANALOG_GAIN             0x35
  56 #define MT9V022_BLACK_LEVEL_CALIB_CTRL  0x47
  57 #define MT9V022_PIXCLK_FV_LV            0x74
  58 #define MT9V022_DIGITAL_TEST_PATTERN    0x7f
  59 #define MT9V022_AEC_AGC_ENABLE          0xAF
  60 #define MT9V022_MAX_TOTAL_SHUTTER_WIDTH 0xBD
  61
  62 /* mt9v024 partial list register addresses changes with respect to mt9v022 */
  63 #define MT9V024_PIXCLK_FV_LV            0x72
  64 #define MT9V024_MAX_TOTAL_SHUTTER_WIDTH 0xAD
  65
  66 /* Progressive scan, master, defaults */
  67 #define MT9V022_CHIP_CONTROL_DEFAULT    0x188
  68
  69 #define MT9V022_MAX_WIDTH               752
  70 #define MT9V022_MAX_HEIGHT              480
  71 #define MT9V022_MIN_WIDTH               48
  72 #define MT9V022_MIN_HEIGHT              32
  73 #define MT9V022_COLUMN_SKIP             1
  74 #define MT9V022_ROW_SKIP                4
  75
  76 #define MT9V022_HORIZONTAL_BLANKING_MIN 43
  77 #define MT9V022_HORIZONTAL_BLANKING_MAX 1023
  78 #define MT9V022_HORIZONTAL_BLANKING_DEF 94
  79 #define MT9V022_VERTICAL_BLANKING_MIN   2
  80 #define MT9V022_VERTICAL_BLANKING_MAX   3000
  81 #define MT9V022_VERTICAL_BLANKING_DEF   45
  82
  83 #define is_mt9v022_rev3(id)     (id == 0x1313)
  84 #define is_mt9v024(id)          (id == 0x1324)
  85
  86 /* MT9V022 has only one fixed colorspace per pixelcode */
  87 struct mt9v022_datafmt {
  88         u32     code;
  89         enum v4l2_colorspace            colorspace;
  90 };
  91
  92 /* Find a data format by a pixel code in an array */
  93 static const struct mt9v022_datafmt *mt9v022_find_datafmt(
  94         u32 code, const struct mt9v022_datafmt *fmt,
  95         int n)
  96 {
  97         int i;
  98         for (i = 0; i < n; i++)
  99                 if (fmt[i].code == code)
 100                         return fmt + i;
 101
 102         return NULL;
 103 }
 104
 105 static const struct mt9v022_datafmt mt9v022_colour_fmts[] = {
 106         /*
 107          * Order important: first natively supported,
 108          * second supported with a GPIO extender
 109          */
 110         {MEDIA_BUS_FMT_SBGGR10_1X10, V4L2_COLORSPACE_SRGB},
 111         {MEDIA_BUS_FMT_SBGGR8_1X8, V4L2_COLORSPACE_SRGB},
 112 };
 113
 114 static const struct mt9v022_datafmt mt9v022_monochrome_fmts[] = {
 115         /* Order important - see above */
 116         {MEDIA_BUS_FMT_Y10_1X10, V4L2_COLORSPACE_JPEG},
 117         {MEDIA_BUS_FMT_Y8_1X8, V4L2_COLORSPACE_JPEG},
 118 };
 119
 120 /* only registers with different addresses on different mt9v02x sensors */
 121 struct mt9v02x_register {
 122         u8      max_total_shutter_width;
 123         u8      pixclk_fv_lv;
 124 };
 125
 126 static const struct mt9v02x_register mt9v022_register = {
 127         .max_total_shutter_width        = MT9V022_MAX_TOTAL_SHUTTER_WIDTH,
 128         .pixclk_fv_lv                   = MT9V022_PIXCLK_FV_LV,
 129 };
 130
 131 static const struct mt9v02x_register mt9v024_register = {
 132         .max_total_shutter_width        = MT9V024_MAX_TOTAL_SHUTTER_WIDTH,
 133         .pixclk_fv_lv                   = MT9V024_PIXCLK_FV_LV,
 134 };
 135
 136 enum mt9v022_model {
 137         MT9V022IX7ATM,
 138         MT9V022IX7ATC,
 139 };
 140
 141 struct mt9v022 {
 142         struct v4l2_subdev subdev;
 143         struct v4l2_ctrl_handler hdl;
 144         struct {
 145                 /* exposure/auto-exposure cluster */
 146                 struct v4l2_ctrl *autoexposure;
 147                 struct v4l2_ctrl *exposure;
 148         };
 149         struct {
 150                 /* gain/auto-gain cluster */
 151                 struct v4l2_ctrl *autogain;
 152                 struct v4l2_ctrl *gain;
 153         };
 154         struct v4l2_ctrl *hblank;
 155         struct v4l2_ctrl *vblank;
 156         struct v4l2_rect rect;  /* Sensor window */
 157         struct v4l2_clk *clk;
 158         const struct mt9v022_datafmt *fmt;
 159         const struct mt9v022_datafmt *fmts;
 160         const struct mt9v02x_register *reg;
 161         int num_fmts;
 162         enum mt9v022_model model;
 163         u16 chip_control;
 164         u16 chip_version;
 165         unsigned short y_skip_top;      /* Lines to skip at the top */
 166 };
 167
 168 static struct mt9v022 *to_mt9v022(const struct i2c_client *client)
 169 {
 170         return container_of(i2c_get_clientdata(client), struct mt9v022, subdev);
 171 }
 172
 173 static int reg_read(struct i2c_client *client, const u8 reg)
 174 {
 175         return i2c_smbus_read_word_swapped(client, reg);
 176 }
 177
 178 static int reg_write(struct i2c_client *client, const u8 reg,
 179                      const u16 data)
 180 {
 181         return i2c_smbus_write_word_swapped(client, reg, data);
 182 }
 183
 184 static int reg_set(struct i2c_client *client, const u8 reg,
 185                    const u16 data)
 186 {
 187         int ret;
 188
 189         ret = reg_read(client, reg);
 190         if (ret < 0)
 191                 return ret;
 192         return reg_write(client, reg, ret | data);
 193 }
 194
 195 static int reg_clear(struct i2c_client *client, const u8 reg,
 196                      const u16 data)
 197 {
 198         int ret;
 199
 200         ret = reg_read(client, reg);
 201         if (ret < 0)
 202                 return ret;
 203         return reg_write(client, reg, ret & ~data);
 204 }
 205
 206 static int mt9v022_init(struct i2c_client *client)
 207 {
 208         struct mt9v022 *mt9v022 = to_mt9v022(client);
 209         int ret;
 210
 211         /*
 212          * Almost the default mode: master, parallel, simultaneous, and an
 213          * undocumented bit 0x200, which is present in table 7, but not in 8,
 214          * plus snapshot mode to disable scan for now
 215          */
 216         mt9v022->chip_control |= 0x10;
 217         ret = reg_write(client, MT9V022_CHIP_CONTROL, mt9v022->chip_control);
 218         if (!ret)
 219                 ret = reg_write(client, MT9V022_READ_MODE, 0x300);
 220
 221         /* All defaults */
 222         if (!ret)
 223                 /* AEC, AGC on */
 224                 ret = reg_set(client, MT9V022_AEC_AGC_ENABLE, 0x3);
 225         if (!ret)
 226                 ret = reg_write(client, MT9V022_ANALOG_GAIN, 16);
 227         if (!ret)
 228                 ret = reg_write(client, MT9V022_TOTAL_SHUTTER_WIDTH, 480);
 229         if (!ret)
 230                 ret = reg_write(client, mt9v022->reg->max_total_shutter_width, 480);
 231         if (!ret)
 232                 /* default - auto */
 233                 ret = reg_clear(client, MT9V022_BLACK_LEVEL_CALIB_CTRL, 1);
 234         if (!ret)
 235                 ret = reg_write(client, MT9V022_DIGITAL_TEST_PATTERN, 0);
 236         if (!ret)
 237                 return v4l2_ctrl_handler_setup(&mt9v022->hdl);
 238
 239         return ret;
 240 }
 241
 242 static int mt9v022_s_stream(struct v4l2_subdev *sd, int enable)
 243 {
 244         struct i2c_client *client = v4l2_get_subdevdata(sd);
 245         struct mt9v022 *mt9v022 = to_mt9v022(client);
 246
 247         if (enable) {
 248                 /* Switch to master "normal" mode */
 249                 mt9v022->chip_control &= ~0x10;
 250                 if (is_mt9v022_rev3(mt9v022->chip_version) ||
 251                     is_mt9v024(mt9v022->chip_version)) {
 252                         /*
 253                          * Unset snapshot mode specific settings: clear bit 9
 254                          * and bit 2 in reg. 0x20 when in normal mode.
 255                          */
 256                         if (reg_clear(client, MT9V022_REG32, 0x204))
 257                                 return -EIO;
 258                 }
 259         } else {
 260                 /* Switch to snapshot mode */
 261                 mt9v022->chip_control |= 0x10;
 262                 if (is_mt9v022_rev3(mt9v022->chip_version) ||
 263                     is_mt9v024(mt9v022->chip_version)) {
 264                         /*
 265                          * Required settings for snapshot mode: set bit 9
 266                          * (RST enable) and bit 2 (CR enable) in reg. 0x20
 267                          * See TechNote TN0960 or TN-09-225.
 268                          */
 269                         if (reg_set(client, MT9V022_REG32, 0x204))
 270                                 return -EIO;
 271                 }
 272         }
 273
 274         if (reg_write(client, MT9V022_CHIP_CONTROL, mt9v022->chip_control) < 0)
 275                 return -EIO;
 276         return 0;
 277 }
 278
 279 static int mt9v022_set_selection(struct v4l2_subdev *sd,
 280                 struct v4l2_subdev_pad_config *cfg,
 281                 struct v4l2_subdev_selection *sel)
 282 {
 283         struct i2c_client *client = v4l2_get_subdevdata(sd);
 284         struct mt9v022 *mt9v022 = to_mt9v022(client);
 285         struct v4l2_rect rect = sel->r;
 286         int min_row, min_blank;
 287         int ret;
 288
 289         if (sel->which != V4L2_SUBDEV_FORMAT_ACTIVE ||
 290             sel->target != V4L2_SEL_TGT_CROP)
 291                 return -EINVAL;
 292
 293         /* Bayer format - even size lengths */
 294         if (mt9v022->fmts == mt9v022_colour_fmts) {
 295                 rect.width      = ALIGN(rect.width, 2);
 296                 rect.height     = ALIGN(rect.height, 2);
 297                 /* Let the user play with the starting pixel */
 298         }
 299
 300         soc_camera_limit_side(&rect.left, &rect.width,
 301                      MT9V022_COLUMN_SKIP, MT9V022_MIN_WIDTH, MT9V022_MAX_WIDTH);
 302
 303         soc_camera_limit_side(&rect.top, &rect.height,
 304                      MT9V022_ROW_SKIP, MT9V022_MIN_HEIGHT, MT9V022_MAX_HEIGHT);
 305
 306         /* Like in example app. Contradicts the datasheet though */
 307         ret = reg_read(client, MT9V022_AEC_AGC_ENABLE);
 308         if (ret >= 0) {
 309                 if (ret & 1) /* Autoexposure */
 310                         ret = reg_write(client, mt9v022->reg->max_total_shutter_width,
 311                                         rect.height + mt9v022->y_skip_top + 43);
 312                 /*
 313                  * If autoexposure is off, there is no need to set
 314                  * MT9V022_TOTAL_SHUTTER_WIDTH here. Autoexposure can be off
 315                  * only if the user has set exposure manually, using the
 316                  * V4L2_CID_EXPOSURE_AUTO with the value V4L2_EXPOSURE_MANUAL.
 317                  * In this case the register MT9V022_TOTAL_SHUTTER_WIDTH
 318                  * already contains the correct value.
 319                  */
 320         }
 321         /* Setup frame format: defaults apart from width and height */
 322         if (!ret)
 323                 ret = reg_write(client, MT9V022_COLUMN_START, rect.left);
 324         if (!ret)
 325                 ret = reg_write(client, MT9V022_ROW_START, rect.top);
 326         /*
 327          * mt9v022: min total row time is 660 columns, min blanking is 43
 328          * mt9v024: min total row time is 690 columns, min blanking is 61
 329          */
 330         if (is_mt9v024(mt9v022->chip_version)) {
 331                 min_row = 690;
 332                 min_blank = 61;
 333         } else {
 334                 min_row = 660;
 335                 min_blank = 43;
 336         }
 337         if (!ret)
 338                 ret = v4l2_ctrl_s_ctrl(mt9v022->hblank,
 339                                 rect.width > min_row - min_blank ?
 340                                 min_blank : min_row - rect.width);
 341         if (!ret)
 342                 ret = v4l2_ctrl_s_ctrl(mt9v022->vblank, 45);
 343         if (!ret)
 344                 ret = reg_write(client, MT9V022_WINDOW_WIDTH, rect.width);
 345         if (!ret)
 346                 ret = reg_write(client, MT9V022_WINDOW_HEIGHT,
 347                                 rect.height + mt9v022->y_skip_top);
 348
 349         if (ret < 0)
 350                 return ret;
 351
 352         dev_dbg(&client->dev, "Frame %dx%d pixel\n", rect.width, rect.height);
 353
 354         mt9v022->rect = rect;
 355
 356         return 0;
 357 }
 358
 359 static int mt9v022_get_selection(struct v4l2_subdev *sd,
 360                 struct v4l2_subdev_pad_config *cfg,
 361                 struct v4l2_subdev_selection *sel)
 362 {
 363         struct i2c_client *client = v4l2_get_subdevdata(sd);
 364         struct mt9v022 *mt9v022 = to_mt9v022(client);
 365
 366         if (sel->which != V4L2_SUBDEV_FORMAT_ACTIVE)
 367                 return -EINVAL;
 368
 369         switch (sel->target) {
 370         case V4L2_SEL_TGT_CROP_BOUNDS:
 371                 sel->r.left = MT9V022_COLUMN_SKIP;
 372                 sel->r.top = MT9V022_ROW_SKIP;
 373                 sel->r.width = MT9V022_MAX_WIDTH;
 374                 sel->r.height = MT9V022_MAX_HEIGHT;
 375                 return 0;
 376         case V4L2_SEL_TGT_CROP:
 377                 sel->r = mt9v022->rect;
 378                 return 0;
 379         default:
 380                 return -EINVAL;
 381         }
 382 }
 383
 384 static int mt9v022_get_fmt(struct v4l2_subdev *sd,
 385                 struct v4l2_subdev_pad_config *cfg,
 386                 struct v4l2_subdev_format *format)
 387 {
 388         struct v4l2_mbus_framefmt *mf = &format->format;
 389         struct i2c_client *client = v4l2_get_subdevdata(sd);
 390         struct mt9v022 *mt9v022 = to_mt9v022(client);
 391
 392         if (format->pad)
 393                 return -EINVAL;
 394
 395         mf->width       = mt9v022->rect.width;
 396         mf->height      = mt9v022->rect.height;
 397         mf->code        = mt9v022->fmt->code;
 398         mf->colorspace  = mt9v022->fmt->colorspace;
 399         mf->field       = V4L2_FIELD_NONE;
 400
 401         return 0;
 402 }
 403
 404 static int mt9v022_s_fmt(struct v4l2_subdev *sd,
 405                          const struct mt9v022_datafmt *fmt,
 406                          struct v4l2_mbus_framefmt *mf)
 407 {
 408         struct i2c_client *client = v4l2_get_subdevdata(sd);
 409         struct mt9v022 *mt9v022 = to_mt9v022(client);
 410         struct v4l2_subdev_selection sel = {
 411                 .which = V4L2_SUBDEV_FORMAT_ACTIVE,
 412                 .target = V4L2_SEL_TGT_CROP,
 413                 .r.left = mt9v022->rect.left,
 414                 .r.top = mt9v022->rect.top,
 415                 .r.width = mf->width,
 416                 .r.height = mf->height,
 417         };
 418         int ret;
 419
 420         /*
 421          * The caller provides a supported format, as verified per call to
 422          * .set_fmt(FORMAT_TRY), datawidth is from our supported format list
 423          */
 424         switch (mf->code) {
 425         case MEDIA_BUS_FMT_Y8_1X8:
 426         case MEDIA_BUS_FMT_Y10_1X10:
 427                 if (mt9v022->model != MT9V022IX7ATM)
 428                         return -EINVAL;
 429                 break;
 430         case MEDIA_BUS_FMT_SBGGR8_1X8:
 431         case MEDIA_BUS_FMT_SBGGR10_1X10:
 432                 if (mt9v022->model != MT9V022IX7ATC)
 433                         return -EINVAL;
 434                 break;
 435         default:
 436                 return -EINVAL;
 437         }
 438
 439         /* No support for scaling on this camera, just crop. */
 440         ret = mt9v022_set_selection(sd, NULL, &sel);
 441         if (!ret) {
 442                 mf->width       = mt9v022->rect.width;
 443                 mf->height      = mt9v022->rect.height;
 444                 mt9v022->fmt    = fmt;
 445                 mf->colorspace  = fmt->colorspace;
 446         }
 447
 448         return ret;
 449 }
 450
 451 static int mt9v022_set_fmt(struct v4l2_subdev *sd,
 452                 struct v4l2_subdev_pad_config *cfg,
 453                 struct v4l2_subdev_format *format)
 454 {
 455         struct v4l2_mbus_framefmt *mf = &format->format;
 456         struct i2c_client *client = v4l2_get_subdevdata(sd);
 457         struct mt9v022 *mt9v022 = to_mt9v022(client);
 458         const struct mt9v022_datafmt *fmt;
 459         int align = mf->code == MEDIA_BUS_FMT_SBGGR8_1X8 ||
 460                 mf->code == MEDIA_BUS_FMT_SBGGR10_1X10;
 461
 462         if (format->pad)
 463                 return -EINVAL;
 464
 465         v4l_bound_align_image(&mf->width, MT9V022_MIN_WIDTH,
 466                 MT9V022_MAX_WIDTH, align,
 467                 &mf->height, MT9V022_MIN_HEIGHT + mt9v022->y_skip_top,
 468                 MT9V022_MAX_HEIGHT + mt9v022->y_skip_top, align, 0);
 469
 470         fmt = mt9v022_find_datafmt(mf->code, mt9v022->fmts,
 471                                    mt9v022->num_fmts);
 472         if (!fmt) {
 473                 fmt = mt9v022->fmt;
 474                 mf->code = fmt->code;
 475         }
 476
 477         mf->colorspace  = fmt->colorspace;
 478
 479         if (format->which == V4L2_SUBDEV_FORMAT_ACTIVE)
 480                 return mt9v022_s_fmt(sd, fmt, mf);
 481         cfg->try_fmt = *mf;
 482         return 0;
 483 }
 484
 485 #ifdef CONFIG_VIDEO_ADV_DEBUG
 486 static int mt9v022_g_register(struct v4l2_subdev *sd,
 487                               struct v4l2_dbg_register *reg)
 488 {
 489         struct i2c_client *client = v4l2_get_subdevdata(sd);
 490
 491         if (reg->reg > 0xff)
 492                 return -EINVAL;
 493
 494         reg->size = 2;
 495         reg->val = reg_read(client, reg->reg);
 496
 497         if (reg->val > 0xffff)
 498                 return -EIO;
 499
 500         return 0;
 501 }
 502
 503 static int mt9v022_s_register(struct v4l2_subdev *sd,
 504                               const struct v4l2_dbg_register *reg)
 505 {
 506         struct i2c_client *client = v4l2_get_subdevdata(sd);
 507
 508         if (reg->reg > 0xff)
 509                 return -EINVAL;
 510
 511         if (reg_write(client, reg->reg, reg->val) < 0)
 512                 return -EIO;
 513
 514         return 0;
 515 }
 516 #endif
 517
 518 static int mt9v022_s_power(struct v4l2_subdev *sd, int on)
 519 {
 520         struct i2c_client *client = v4l2_get_subdevdata(sd);
 521         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 522         struct mt9v022 *mt9v022 = to_mt9v022(client);
 523
 524         return soc_camera_set_power(&client->dev, ssdd, mt9v022->clk, on);
 525 }
 526
 527 static int mt9v022_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
 528 {
 529         struct mt9v022 *mt9v022 = container_of(ctrl->handler,
 530                                                struct mt9v022, hdl);
 531         struct v4l2_subdev *sd = &mt9v022->subdev;
 532         struct i2c_client *client = v4l2_get_subdevdata(sd);
 533         struct v4l2_ctrl *gain = mt9v022->gain;
 534         struct v4l2_ctrl *exp = mt9v022->exposure;
 535         unsigned long range;
 536         int data;
 537
 538         switch (ctrl->id) {
 539         case V4L2_CID_AUTOGAIN:
 540                 data = reg_read(client, MT9V022_ANALOG_GAIN);
 541                 if (data < 0)
 542                         return -EIO;
 543
 544                 range = gain->maximum - gain->minimum;
 545                 gain->val = ((data - 16) * range + 24) / 48 + gain->minimum;
 546                 return 0;
 547         case V4L2_CID_EXPOSURE_AUTO:
 548                 data = reg_read(client, MT9V022_TOTAL_SHUTTER_WIDTH);
 549                 if (data < 0)
 550                         return -EIO;
 551
 552                 range = exp->maximum - exp->minimum;
 553                 exp->val = ((data - 1) * range + 239) / 479 + exp->minimum;
 554                 return 0;
 555         case V4L2_CID_HBLANK:
 556                 data = reg_read(client, MT9V022_HORIZONTAL_BLANKING);
 557                 if (data < 0)
 558                         return -EIO;
 559                 ctrl->val = data;
 560                 return 0;
 561         case V4L2_CID_VBLANK:
 562                 data = reg_read(client, MT9V022_VERTICAL_BLANKING);
 563                 if (data < 0)
 564                         return -EIO;
 565                 ctrl->val = data;
 566                 return 0;
 567         }
 568         return -EINVAL;
 569 }
 570
 571 static int mt9v022_s_ctrl(struct v4l2_ctrl *ctrl)
 572 {
 573         struct mt9v022 *mt9v022 = container_of(ctrl->handler,
 574                                                struct mt9v022, hdl);
 575         struct v4l2_subdev *sd = &mt9v022->subdev;
 576         struct i2c_client *client = v4l2_get_subdevdata(sd);
 577         int data;
 578
 579         switch (ctrl->id) {
 580         case V4L2_CID_VFLIP:
 581                 if (ctrl->val)
 582                         data = reg_set(client, MT9V022_READ_MODE, 0x10);
 583                 else
 584                         data = reg_clear(client, MT9V022_READ_MODE, 0x10);
 585                 if (data < 0)
 586                         return -EIO;
 587                 return 0;
 588         case V4L2_CID_HFLIP:
 589                 if (ctrl->val)
 590                         data = reg_set(client, MT9V022_READ_MODE, 0x20);
 591                 else
 592                         data = reg_clear(client, MT9V022_READ_MODE, 0x20);
 593                 if (data < 0)
 594                         return -EIO;
 595                 return 0;
 596         case V4L2_CID_AUTOGAIN:
 597                 if (ctrl->val) {
 598                         if (reg_set(client, MT9V022_AEC_AGC_ENABLE, 0x2) < 0)
 599                                 return -EIO;
 600                 } else {
 601                         struct v4l2_ctrl *gain = mt9v022->gain;
 602                         /* mt9v022 has minimum == default */
 603                         unsigned long range = gain->maximum - gain->minimum;
 604                         /* Valid values 16 to 64, 32 to 64 must be even. */
 605                         unsigned long gain_val = ((gain->val - (s32)gain->minimum) *
 606                                               48 + range / 2) / range + 16;
 607
 608                         if (gain_val >= 32)
 609                                 gain_val &= ~1;
 610
 611                         /*
 612                          * The user wants to set gain manually, hope, she
 613                          * knows, what she's doing... Switch AGC off.
 614                          */
 615                         if (reg_clear(client, MT9V022_AEC_AGC_ENABLE, 0x2) < 0)
 616                                 return -EIO;
 617
 618                         dev_dbg(&client->dev, "Setting gain from %d to %lu\n",
 619                                 reg_read(client, MT9V022_ANALOG_GAIN), gain_val);
 620                         if (reg_write(client, MT9V022_ANALOG_GAIN, gain_val) < 0)
 621                                 return -EIO;
 622                 }
 623                 return 0;
 624         case V4L2_CID_EXPOSURE_AUTO:
 625                 if (ctrl->val == V4L2_EXPOSURE_AUTO) {
 626                         data = reg_set(client, MT9V022_AEC_AGC_ENABLE, 0x1);
 627                 } else {
 628                         struct v4l2_ctrl *exp = mt9v022->exposure;
 629                         unsigned long range = exp->maximum - exp->minimum;
 630                         unsigned long shutter = ((exp->val - (s32)exp->minimum) *
 631                                         479 + range / 2) / range + 1;
 632
 633                         /*
 634                          * The user wants to set shutter width manually, hope,
 635                          * she knows, what she's doing... Switch AEC off.
 636                          */
 637                         data = reg_clear(client, MT9V022_AEC_AGC_ENABLE, 0x1);
 638                         if (data < 0)
 639                                 return -EIO;
 640                         dev_dbg(&client->dev, "Shutter width from %d to %lu\n",
 641                                         reg_read(client, MT9V022_TOTAL_SHUTTER_WIDTH),
 642                                         shutter);
 643                         if (reg_write(client, MT9V022_TOTAL_SHUTTER_WIDTH,
 644                                                 shutter) < 0)
 645                                 return -EIO;
 646                 }
 647                 return 0;
 648         case V4L2_CID_HBLANK:
 649                 if (reg_write(client, MT9V022_HORIZONTAL_BLANKING,
 650                                 ctrl->val) < 0)
 651                         return -EIO;
 652                 return 0;
 653         case V4L2_CID_VBLANK:
 654                 if (reg_write(client, MT9V022_VERTICAL_BLANKING,
 655                                 ctrl->val) < 0)
 656                         return -EIO;
 657                 return 0;
 658         }
 659         return -EINVAL;
 660 }
 661
 662 /*
 663  * Interface active, can use i2c. If it fails, it can indeed mean, that
 664  * this wasn't our capture interface, so, we wait for the right one
 665  */
 666 static int mt9v022_video_probe(struct i2c_client *client)
 667 {
 668         struct mt9v022 *mt9v022 = to_mt9v022(client);
 669         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 670         s32 data;
 671         int ret;
 672         unsigned long flags;
 673
 674         ret = mt9v022_s_power(&mt9v022->subdev, 1);
 675         if (ret < 0)
 676                 return ret;
 677
 678         /* Read out the chip version register */
 679         data = reg_read(client, MT9V022_CHIP_VERSION);
 680
 681         /* must be 0x1311, 0x1313 or 0x1324 */
 682         if (data != 0x1311 && data != 0x1313 && data != 0x1324) {
 683                 ret = -ENODEV;
 684                 dev_info(&client->dev, "No MT9V022 found, ID register 0x%x\n",
 685                          data);
 686                 goto ei2c;
 687         }
 688
 689         mt9v022->chip_version = data;
 690
 691         mt9v022->reg = is_mt9v024(data) ? &mt9v024_register :
 692                         &mt9v022_register;
 693
 694         /* Soft reset */
 695         ret = reg_write(client, MT9V022_RESET, 1);
 696         if (ret < 0)
 697                 goto ei2c;
 698         /* 15 clock cycles */
 699         udelay(200);
 700         if (reg_read(client, MT9V022_RESET)) {
 701                 dev_err(&client->dev, "Resetting MT9V022 failed!\n");
 702                 if (ret > 0)
 703                         ret = -EIO;
 704                 goto ei2c;
 705         }
 706
 707         /* Set monochrome or colour sensor type */
 708         if (sensor_type && (!strcmp("colour", sensor_type) ||
 709                             !strcmp("color", sensor_type))) {
 710                 ret = reg_write(client, MT9V022_PIXEL_OPERATION_MODE, 4 | 0x11);
 711                 mt9v022->model = MT9V022IX7ATC;
 712                 mt9v022->fmts = mt9v022_colour_fmts;
 713         } else {
 714                 ret = reg_write(client, MT9V022_PIXEL_OPERATION_MODE, 0x11);
 715                 mt9v022->model = MT9V022IX7ATM;
 716                 mt9v022->fmts = mt9v022_monochrome_fmts;
 717         }
 718
 719         if (ret < 0)
 720                 goto ei2c;
 721
 722         mt9v022->num_fmts = 0;
 723
 724         /*
 725          * This is a 10bit sensor, so by default we only allow 10bit.
 726          * The platform may support different bus widths due to
 727          * different routing of the data lines.
 728          */
 729         if (ssdd->query_bus_param)
 730                 flags = ssdd->query_bus_param(ssdd);
 731         else
 732                 flags = SOCAM_DATAWIDTH_10;
 733
 734         if (flags & SOCAM_DATAWIDTH_10)
 735                 mt9v022->num_fmts++;
 736         else
 737                 mt9v022->fmts++;
 738
 739         if (flags & SOCAM_DATAWIDTH_8)
 740                 mt9v022->num_fmts++;
 741
 742         mt9v022->fmt = &mt9v022->fmts[0];
 743
 744         dev_info(&client->dev, "Detected a MT9V022 chip ID %x, %s sensor\n",
 745                  data, mt9v022->model == MT9V022IX7ATM ?
 746                  "monochrome" : "colour");
 747
 748         ret = mt9v022_init(client);
 749         if (ret < 0)
 750                 dev_err(&client->dev, "Failed to initialise the camera\n");
 751
 752 ei2c:
 753         mt9v022_s_power(&mt9v022->subdev, 0);
 754         return ret;
 755 }
 756
 757 static int mt9v022_g_skip_top_lines(struct v4l2_subdev *sd, u32 *lines)
 758 {
 759         struct i2c_client *client = v4l2_get_subdevdata(sd);
 760         struct mt9v022 *mt9v022 = to_mt9v022(client);
 761
 762         *lines = mt9v022->y_skip_top;
 763
 764         return 0;
 765 }
 766
 767 static const struct v4l2_ctrl_ops mt9v022_ctrl_ops = {
 768         .g_volatile_ctrl = mt9v022_g_volatile_ctrl,
 769         .s_ctrl = mt9v022_s_ctrl,
 770 };
 771
 772 static const struct v4l2_subdev_core_ops mt9v022_subdev_core_ops = {
 773 #ifdef CONFIG_VIDEO_ADV_DEBUG
 774         .g_register     = mt9v022_g_register,
 775         .s_register     = mt9v022_s_register,
 776 #endif
 777         .s_power        = mt9v022_s_power,
 778 };
 779
 780 static int mt9v022_enum_mbus_code(struct v4l2_subdev *sd,
 781                 struct v4l2_subdev_pad_config *cfg,
 782                 struct v4l2_subdev_mbus_code_enum *code)
 783 {
 784         struct i2c_client *client = v4l2_get_subdevdata(sd);
 785         struct mt9v022 *mt9v022 = to_mt9v022(client);
 786
 787         if (code->pad || code->index >= mt9v022->num_fmts)
 788                 return -EINVAL;
 789
 790         code->code = mt9v022->fmts[code->index].code;
 791         return 0;
 792 }
 793
 794 static int mt9v022_g_mbus_config(struct v4l2_subdev *sd,
 795                                 struct v4l2_mbus_config *cfg)
 796 {
 797         struct i2c_client *client = v4l2_get_subdevdata(sd);
 798         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 799
 800         cfg->flags = V4L2_MBUS_MASTER | V4L2_MBUS_SLAVE |
 801                 V4L2_MBUS_PCLK_SAMPLE_RISING | V4L2_MBUS_PCLK_SAMPLE_FALLING |
 802                 V4L2_MBUS_HSYNC_ACTIVE_HIGH | V4L2_MBUS_HSYNC_ACTIVE_LOW |
 803                 V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_VSYNC_ACTIVE_LOW |
 804                 V4L2_MBUS_DATA_ACTIVE_HIGH;
 805         cfg->type = V4L2_MBUS_PARALLEL;
 806         cfg->flags = soc_camera_apply_board_flags(ssdd, cfg);
 807
 808         return 0;
 809 }
 810
 811 static int mt9v022_s_mbus_config(struct v4l2_subdev *sd,
 812                                  const struct v4l2_mbus_config *cfg)
 813 {
 814         struct i2c_client *client = v4l2_get_subdevdata(sd);
 815         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 816         struct mt9v022 *mt9v022 = to_mt9v022(client);
 817         unsigned long flags = soc_camera_apply_board_flags(ssdd, cfg);
 818         unsigned int bps = soc_mbus_get_fmtdesc(mt9v022->fmt->code)->bits_per_sample;
 819         int ret;
 820         u16 pixclk = 0;
 821
 822         if (ssdd->set_bus_param) {
 823                 ret = ssdd->set_bus_param(ssdd, 1 << (bps - 1));
 824                 if (ret)
 825                         return ret;
 826         } else if (bps != 10) {
 827                 /*
 828                  * Without board specific bus width settings we only support the
 829                  * sensors native bus width
 830                  */
 831                 return -EINVAL;
 832         }
 833
 834         if (flags & V4L2_MBUS_PCLK_SAMPLE_FALLING)
 835                 pixclk |= 0x10;
 836
 837         if (!(flags & V4L2_MBUS_HSYNC_ACTIVE_HIGH))
 838                 pixclk |= 0x1;
 839
 840         if (!(flags & V4L2_MBUS_VSYNC_ACTIVE_HIGH))
 841                 pixclk |= 0x2;
 842
 843         ret = reg_write(client, mt9v022->reg->pixclk_fv_lv, pixclk);
 844         if (ret < 0)
 845                 return ret;
 846
 847         if (!(flags & V4L2_MBUS_MASTER))
 848                 mt9v022->chip_control &= ~0x8;
 849
 850         ret = reg_write(client, MT9V022_CHIP_CONTROL, mt9v022->chip_control);
 851         if (ret < 0)
 852                 return ret;
 853
 854         dev_dbg(&client->dev, "Calculated pixclk 0x%x, chip control 0x%x\n",
 855                 pixclk, mt9v022->chip_control);
 856
 857         return 0;
 858 }
 859
 860 static const struct v4l2_subdev_video_ops mt9v022_subdev_video_ops = {
 861         .s_stream       = mt9v022_s_stream,
 862         .g_mbus_config  = mt9v022_g_mbus_config,
 863         .s_mbus_config  = mt9v022_s_mbus_config,
 864 };
 865
 866 static const struct v4l2_subdev_sensor_ops mt9v022_subdev_sensor_ops = {
 867         .g_skip_top_lines       = mt9v022_g_skip_top_lines,
 868 };
 869
 870 static const struct v4l2_subdev_pad_ops mt9v022_subdev_pad_ops = {
 871         .enum_mbus_code = mt9v022_enum_mbus_code,
 872         .get_selection  = mt9v022_get_selection,
 873         .set_selection  = mt9v022_set_selection,
 874         .get_fmt        = mt9v022_get_fmt,
 875         .set_fmt        = mt9v022_set_fmt,
 876 };
 877
 878 static const struct v4l2_subdev_ops mt9v022_subdev_ops = {
 879         .core   = &mt9v022_subdev_core_ops,
 880         .video  = &mt9v022_subdev_video_ops,
 881         .sensor = &mt9v022_subdev_sensor_ops,
 882         .pad    = &mt9v022_subdev_pad_ops,
 883 };
 884
 885 static int mt9v022_probe(struct i2c_client *client,
 886                          const struct i2c_device_id *did)
 887 {
 888         struct mt9v022 *mt9v022;
 889         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 890         struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
 891         struct mt9v022_platform_data *pdata;
 892         int ret;
 893
 894         if (!ssdd) {
 895                 dev_err(&client->dev, "MT9V022 driver needs platform data\n");
 896                 return -EINVAL;
 897         }
 898
 899         if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) {
 900                 dev_warn(&adapter->dev,
 901                          "I2C-Adapter doesn't support I2C_FUNC_SMBUS_WORD\n");
 902                 return -EIO;
 903         }
 904
 905         mt9v022 = devm_kzalloc(&client->dev, sizeof(struct mt9v022), GFP_KERNEL);
 906         if (!mt9v022)
 907                 return -ENOMEM;
 908
 909         pdata = ssdd->drv_priv;
 910         v4l2_i2c_subdev_init(&mt9v022->subdev, client, &mt9v022_subdev_ops);
 911         v4l2_ctrl_handler_init(&mt9v022->hdl, 6);
 912         v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 913                         V4L2_CID_VFLIP, 0, 1, 1, 0);
 914         v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 915                         V4L2_CID_HFLIP, 0, 1, 1, 0);
 916         mt9v022->autogain = v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 917                         V4L2_CID_AUTOGAIN, 0, 1, 1, 1);
 918         mt9v022->gain = v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 919                         V4L2_CID_GAIN, 0, 127, 1, 64);
 920
 921         /*
 922          * Simulated autoexposure. If enabled, we calculate shutter width
 923          * ourselves in the driver based on vertical blanking and frame width
 924          */
 925         mt9v022->autoexposure = v4l2_ctrl_new_std_menu(&mt9v022->hdl,
 926                         &mt9v022_ctrl_ops, V4L2_CID_EXPOSURE_AUTO, 1, 0,
 927                         V4L2_EXPOSURE_AUTO);
 928         mt9v022->exposure = v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 929                         V4L2_CID_EXPOSURE, 1, 255, 1, 255);
 930
 931         mt9v022->hblank = v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 932                         V4L2_CID_HBLANK, MT9V022_HORIZONTAL_BLANKING_MIN,
 933                         MT9V022_HORIZONTAL_BLANKING_MAX, 1,
 934                         MT9V022_HORIZONTAL_BLANKING_DEF);
 935
 936         mt9v022->vblank = v4l2_ctrl_new_std(&mt9v022->hdl, &mt9v022_ctrl_ops,
 937                         V4L2_CID_VBLANK, MT9V022_VERTICAL_BLANKING_MIN,
 938                         MT9V022_VERTICAL_BLANKING_MAX, 1,
 939                         MT9V022_VERTICAL_BLANKING_DEF);
 940
 941         mt9v022->subdev.ctrl_handler = &mt9v022->hdl;
 942         if (mt9v022->hdl.error) {
 943                 int err = mt9v022->hdl.error;
 944
 945                 dev_err(&client->dev, "control initialisation err %d\n", err);
 946                 return err;
 947         }
 948         v4l2_ctrl_auto_cluster(2, &mt9v022->autoexposure,
 949                                 V4L2_EXPOSURE_MANUAL, true);
 950         v4l2_ctrl_auto_cluster(2, &mt9v022->autogain, 0, true);
 951
 952         mt9v022->chip_control = MT9V022_CHIP_CONTROL_DEFAULT;
 953
 954         /*
 955          * On some platforms the first read out line is corrupted.
 956          * Workaround it by skipping if indicated by platform data.
 957          */
 958         mt9v022->y_skip_top     = pdata ? pdata->y_skip_top : 0;
 959         mt9v022->rect.left      = MT9V022_COLUMN_SKIP;
 960         mt9v022->rect.top       = MT9V022_ROW_SKIP;
 961         mt9v022->rect.width     = MT9V022_MAX_WIDTH;
 962         mt9v022->rect.height    = MT9V022_MAX_HEIGHT;
 963
 964         mt9v022->clk = v4l2_clk_get(&client->dev, "mclk");
 965         if (IS_ERR(mt9v022->clk)) {
 966                 ret = PTR_ERR(mt9v022->clk);
 967                 goto eclkget;
 968         }
 969
 970         ret = mt9v022_video_probe(client);
 971         if (ret) {
 972                 v4l2_clk_put(mt9v022->clk);
 973 eclkget:
 974                 v4l2_ctrl_handler_free(&mt9v022->hdl);
 975         }
 976
 977         return ret;
 978 }
 979
 980 static int mt9v022_remove(struct i2c_client *client)
 981 {
 982         struct mt9v022 *mt9v022 = to_mt9v022(client);
 983         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 984
 985         v4l2_clk_put(mt9v022->clk);
 986         v4l2_device_unregister_subdev(&mt9v022->subdev);
 987         if (ssdd->free_bus)
 988                 ssdd->free_bus(ssdd);
 989         v4l2_ctrl_handler_free(&mt9v022->hdl);
 990
 991         return 0;
 992 }
 993 static const struct i2c_device_id mt9v022_id[] = {
 994         { "mt9v022", 0 },
 995         { }
 996 };
 997 MODULE_DEVICE_TABLE(i2c, mt9v022_id);
 998
 999 static struct i2c_driver mt9v022_i2c_driver = {
1000         .driver = {
1001                 .name = "mt9v022",
1002         },
1003         .probe          = mt9v022_probe,
1004         .remove         = mt9v022_remove,
1005         .id_table       = mt9v022_id,
1006 };
1007
1008 module_i2c_driver(mt9v022_i2c_driver);
1009
1010 MODULE_DESCRIPTION("Micron MT9V022 Camera driver");
1011 MODULE_AUTHOR("Guennadi Liakhovetski <kernel@pengutronix.de>");
1012 MODULE_LICENSE("GPL");