kernel/drivers/media/i2c/soc_camera/mt9t031.c

   1 /*
   2  * Driver for MT9T031 CMOS Image Sensor from Micron
   3  *
   4  * Copyright (C) 2008, Guennadi Liakhovetski, DENX Software Engineering <lg@denx.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/device.h>
  12 #include <linux/i2c.h>
  13 #include <linux/log2.h>
  14 #include <linux/pm.h>
  15 #include <linux/slab.h>
  16 #include <linux/v4l2-mediabus.h>
  17 #include <linux/videodev2.h>
  18 #include <linux/module.h>
  19
  20 #include <media/soc_camera.h>
  21 #include <media/v4l2-clk.h>
  22 #include <media/v4l2-subdev.h>
  23 #include <media/v4l2-ctrls.h>
  24
  25 /*
  26  * ATTENTION: this driver still cannot be used outside of the soc-camera
  27  * framework because of its PM implementation, using the video_device node.
  28  * If hardware becomes available for testing, alternative PM approaches shall
  29  * be considered and tested.
  30  */
  31
  32 /*
  33  * mt9t031 i2c address 0x5d
  34  * The platform has to define struct i2c_board_info objects and link to them
  35  * from struct soc_camera_host_desc
  36  */
  37
  38 /* mt9t031 selected register addresses */
  39 #define MT9T031_CHIP_VERSION            0x00
  40 #define MT9T031_ROW_START               0x01
  41 #define MT9T031_COLUMN_START            0x02
  42 #define MT9T031_WINDOW_HEIGHT           0x03
  43 #define MT9T031_WINDOW_WIDTH            0x04
  44 #define MT9T031_HORIZONTAL_BLANKING     0x05
  45 #define MT9T031_VERTICAL_BLANKING       0x06
  46 #define MT9T031_OUTPUT_CONTROL          0x07
  47 #define MT9T031_SHUTTER_WIDTH_UPPER     0x08
  48 #define MT9T031_SHUTTER_WIDTH           0x09
  49 #define MT9T031_PIXEL_CLOCK_CONTROL     0x0a
  50 #define MT9T031_FRAME_RESTART           0x0b
  51 #define MT9T031_SHUTTER_DELAY           0x0c
  52 #define MT9T031_RESET                   0x0d
  53 #define MT9T031_READ_MODE_1             0x1e
  54 #define MT9T031_READ_MODE_2             0x20
  55 #define MT9T031_READ_MODE_3             0x21
  56 #define MT9T031_ROW_ADDRESS_MODE        0x22
  57 #define MT9T031_COLUMN_ADDRESS_MODE     0x23
  58 #define MT9T031_GLOBAL_GAIN             0x35
  59 #define MT9T031_CHIP_ENABLE             0xF8
  60
  61 #define MT9T031_MAX_HEIGHT              1536
  62 #define MT9T031_MAX_WIDTH               2048
  63 #define MT9T031_MIN_HEIGHT              2
  64 #define MT9T031_MIN_WIDTH               18
  65 #define MT9T031_HORIZONTAL_BLANK        142
  66 #define MT9T031_VERTICAL_BLANK          25
  67 #define MT9T031_COLUMN_SKIP             32
  68 #define MT9T031_ROW_SKIP                20
  69
  70 struct mt9t031 {
  71         struct v4l2_subdev subdev;
  72         struct v4l2_ctrl_handler hdl;
  73         struct {
  74                 /* exposure/auto-exposure cluster */
  75                 struct v4l2_ctrl *autoexposure;
  76                 struct v4l2_ctrl *exposure;
  77         };
  78         struct v4l2_rect rect;  /* Sensor window */
  79         struct v4l2_clk *clk;
  80         u16 xskip;
  81         u16 yskip;
  82         unsigned int total_h;
  83         unsigned short y_skip_top;      /* Lines to skip at the top */
  84 };
  85
  86 static struct mt9t031 *to_mt9t031(const struct i2c_client *client)
  87 {
  88         return container_of(i2c_get_clientdata(client), struct mt9t031, subdev);
  89 }
  90
  91 static int reg_read(struct i2c_client *client, const u8 reg)
  92 {
  93         return i2c_smbus_read_word_swapped(client, reg);
  94 }
  95
  96 static int reg_write(struct i2c_client *client, const u8 reg,
  97                      const u16 data)
  98 {
  99         return i2c_smbus_write_word_swapped(client, reg, data);
 100 }
 101
 102 static int reg_set(struct i2c_client *client, const u8 reg,
 103                    const u16 data)
 104 {
 105         int ret;
 106
 107         ret = reg_read(client, reg);
 108         if (ret < 0)
 109                 return ret;
 110         return reg_write(client, reg, ret | data);
 111 }
 112
 113 static int reg_clear(struct i2c_client *client, const u8 reg,
 114                      const u16 data)
 115 {
 116         int ret;
 117
 118         ret = reg_read(client, reg);
 119         if (ret < 0)
 120                 return ret;
 121         return reg_write(client, reg, ret & ~data);
 122 }
 123
 124 static int set_shutter(struct i2c_client *client, const u32 data)
 125 {
 126         int ret;
 127
 128         ret = reg_write(client, MT9T031_SHUTTER_WIDTH_UPPER, data >> 16);
 129
 130         if (ret >= 0)
 131                 ret = reg_write(client, MT9T031_SHUTTER_WIDTH, data & 0xffff);
 132
 133         return ret;
 134 }
 135
 136 static int get_shutter(struct i2c_client *client, u32 *data)
 137 {
 138         int ret;
 139
 140         ret = reg_read(client, MT9T031_SHUTTER_WIDTH_UPPER);
 141         *data = ret << 16;
 142
 143         if (ret >= 0)
 144                 ret = reg_read(client, MT9T031_SHUTTER_WIDTH);
 145         *data |= ret & 0xffff;
 146
 147         return ret < 0 ? ret : 0;
 148 }
 149
 150 static int mt9t031_idle(struct i2c_client *client)
 151 {
 152         int ret;
 153
 154         /* Disable chip output, synchronous option update */
 155         ret = reg_write(client, MT9T031_RESET, 1);
 156         if (ret >= 0)
 157                 ret = reg_write(client, MT9T031_RESET, 0);
 158         if (ret >= 0)
 159                 ret = reg_clear(client, MT9T031_OUTPUT_CONTROL, 2);
 160
 161         return ret >= 0 ? 0 : -EIO;
 162 }
 163
 164 static int mt9t031_s_stream(struct v4l2_subdev *sd, int enable)
 165 {
 166         struct i2c_client *client = v4l2_get_subdevdata(sd);
 167         int ret;
 168
 169         if (enable)
 170                 /* Switch to master "normal" mode */
 171                 ret = reg_set(client, MT9T031_OUTPUT_CONTROL, 2);
 172         else
 173                 /* Stop sensor readout */
 174                 ret = reg_clear(client, MT9T031_OUTPUT_CONTROL, 2);
 175
 176         if (ret < 0)
 177                 return -EIO;
 178
 179         return 0;
 180 }
 181
 182 /* target must be _even_ */
 183 static u16 mt9t031_skip(s32 *source, s32 target, s32 max)
 184 {
 185         unsigned int skip;
 186
 187         if (*source < target + target / 2) {
 188                 *source = target;
 189                 return 1;
 190         }
 191
 192         skip = min(max, *source + target / 2) / target;
 193         if (skip > 8)
 194                 skip = 8;
 195         *source = target * skip;
 196
 197         return skip;
 198 }
 199
 200 /* rect is the sensor rectangle, the caller guarantees parameter validity */
 201 static int mt9t031_set_params(struct i2c_client *client,
 202                               struct v4l2_rect *rect, u16 xskip, u16 yskip)
 203 {
 204         struct mt9t031 *mt9t031 = to_mt9t031(client);
 205         int ret;
 206         u16 xbin, ybin;
 207         const u16 hblank = MT9T031_HORIZONTAL_BLANK,
 208                 vblank = MT9T031_VERTICAL_BLANK;
 209
 210         xbin = min(xskip, (u16)3);
 211         ybin = min(yskip, (u16)3);
 212
 213         /*
 214          * Could just do roundup(rect->left, [xy]bin * 2); but this is cheaper.
 215          * There is always a valid suitably aligned value. The worst case is
 216          * xbin = 3, width = 2048. Then we will start at 36, the last read out
 217          * pixel will be 2083, which is < 2085 - first black pixel.
 218          *
 219          * MT9T031 datasheet imposes window left border alignment, depending on
 220          * the selected xskip. Failing to conform to this requirement produces
 221          * dark horizontal stripes in the image. However, even obeying to this
 222          * requirement doesn't eliminate the stripes in all configurations. They
 223          * appear "locally reproducibly," but can differ between tests under
 224          * different lighting conditions.
 225          */
 226         switch (xbin) {
 227         case 1:
 228                 rect->left &= ~1;
 229                 break;
 230         case 2:
 231                 rect->left &= ~3;
 232                 break;
 233         case 3:
 234                 rect->left = rect->left > roundup(MT9T031_COLUMN_SKIP, 6) ?
 235                         (rect->left / 6) * 6 : roundup(MT9T031_COLUMN_SKIP, 6);
 236         }
 237
 238         rect->top &= ~1;
 239
 240         dev_dbg(&client->dev, "skip %u:%u, rect %ux%u@%u:%u\n",
 241                 xskip, yskip, rect->width, rect->height, rect->left, rect->top);
 242
 243         /* Disable register update, reconfigure atomically */
 244         ret = reg_set(client, MT9T031_OUTPUT_CONTROL, 1);
 245         if (ret < 0)
 246                 return ret;
 247
 248         /* Blanking and start values - default... */
 249         ret = reg_write(client, MT9T031_HORIZONTAL_BLANKING, hblank);
 250         if (ret >= 0)
 251                 ret = reg_write(client, MT9T031_VERTICAL_BLANKING, vblank);
 252
 253         if (yskip != mt9t031->yskip || xskip != mt9t031->xskip) {
 254                 /* Binning, skipping */
 255                 if (ret >= 0)
 256                         ret = reg_write(client, MT9T031_COLUMN_ADDRESS_MODE,
 257                                         ((xbin - 1) << 4) | (xskip - 1));
 258                 if (ret >= 0)
 259                         ret = reg_write(client, MT9T031_ROW_ADDRESS_MODE,
 260                                         ((ybin - 1) << 4) | (yskip - 1));
 261         }
 262         dev_dbg(&client->dev, "new physical left %u, top %u\n",
 263                 rect->left, rect->top);
 264
 265         /*
 266          * The caller provides a supported format, as guaranteed by
 267          * .try_mbus_fmt(), soc_camera_s_crop() and soc_camera_cropcap()
 268          */
 269         if (ret >= 0)
 270                 ret = reg_write(client, MT9T031_COLUMN_START, rect->left);
 271         if (ret >= 0)
 272                 ret = reg_write(client, MT9T031_ROW_START, rect->top);
 273         if (ret >= 0)
 274                 ret = reg_write(client, MT9T031_WINDOW_WIDTH, rect->width - 1);
 275         if (ret >= 0)
 276                 ret = reg_write(client, MT9T031_WINDOW_HEIGHT,
 277                                 rect->height + mt9t031->y_skip_top - 1);
 278         if (ret >= 0 && v4l2_ctrl_g_ctrl(mt9t031->autoexposure) == V4L2_EXPOSURE_AUTO) {
 279                 mt9t031->total_h = rect->height + mt9t031->y_skip_top + vblank;
 280
 281                 ret = set_shutter(client, mt9t031->total_h);
 282         }
 283
 284         /* Re-enable register update, commit all changes */
 285         if (ret >= 0)
 286                 ret = reg_clear(client, MT9T031_OUTPUT_CONTROL, 1);
 287
 288         if (ret >= 0) {
 289                 mt9t031->rect = *rect;
 290                 mt9t031->xskip = xskip;
 291                 mt9t031->yskip = yskip;
 292         }
 293
 294         return ret < 0 ? ret : 0;
 295 }
 296
 297 static int mt9t031_s_crop(struct v4l2_subdev *sd, const struct v4l2_crop *a)
 298 {
 299         struct v4l2_rect rect = a->c;
 300         struct i2c_client *client = v4l2_get_subdevdata(sd);
 301         struct mt9t031 *mt9t031 = to_mt9t031(client);
 302
 303         rect.width = ALIGN(rect.width, 2);
 304         rect.height = ALIGN(rect.height, 2);
 305
 306         soc_camera_limit_side(&rect.left, &rect.width,
 307                      MT9T031_COLUMN_SKIP, MT9T031_MIN_WIDTH, MT9T031_MAX_WIDTH);
 308
 309         soc_camera_limit_side(&rect.top, &rect.height,
 310                      MT9T031_ROW_SKIP, MT9T031_MIN_HEIGHT, MT9T031_MAX_HEIGHT);
 311
 312         return mt9t031_set_params(client, &rect, mt9t031->xskip, mt9t031->yskip);
 313 }
 314
 315 static int mt9t031_g_crop(struct v4l2_subdev *sd, struct v4l2_crop *a)
 316 {
 317         struct i2c_client *client = v4l2_get_subdevdata(sd);
 318         struct mt9t031 *mt9t031 = to_mt9t031(client);
 319
 320         a->c    = mt9t031->rect;
 321         a->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 322
 323         return 0;
 324 }
 325
 326 static int mt9t031_cropcap(struct v4l2_subdev *sd, struct v4l2_cropcap *a)
 327 {
 328         a->bounds.left                  = MT9T031_COLUMN_SKIP;
 329         a->bounds.top                   = MT9T031_ROW_SKIP;
 330         a->bounds.width                 = MT9T031_MAX_WIDTH;
 331         a->bounds.height                = MT9T031_MAX_HEIGHT;
 332         a->defrect                      = a->bounds;
 333         a->type                         = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 334         a->pixelaspect.numerator        = 1;
 335         a->pixelaspect.denominator      = 1;
 336
 337         return 0;
 338 }
 339
 340 static int mt9t031_g_fmt(struct v4l2_subdev *sd,
 341                          struct v4l2_mbus_framefmt *mf)
 342 {
 343         struct i2c_client *client = v4l2_get_subdevdata(sd);
 344         struct mt9t031 *mt9t031 = to_mt9t031(client);
 345
 346         mf->width       = mt9t031->rect.width / mt9t031->xskip;
 347         mf->height      = mt9t031->rect.height / mt9t031->yskip;
 348         mf->code        = MEDIA_BUS_FMT_SBGGR10_1X10;
 349         mf->colorspace  = V4L2_COLORSPACE_SRGB;
 350         mf->field       = V4L2_FIELD_NONE;
 351
 352         return 0;
 353 }
 354
 355 static int mt9t031_s_fmt(struct v4l2_subdev *sd,
 356                          struct v4l2_mbus_framefmt *mf)
 357 {
 358         struct i2c_client *client = v4l2_get_subdevdata(sd);
 359         struct mt9t031 *mt9t031 = to_mt9t031(client);
 360         u16 xskip, yskip;
 361         struct v4l2_rect rect = mt9t031->rect;
 362
 363         /*
 364          * try_fmt has put width and height within limits.
 365          * S_FMT: use binning and skipping for scaling
 366          */
 367         xskip = mt9t031_skip(&rect.width, mf->width, MT9T031_MAX_WIDTH);
 368         yskip = mt9t031_skip(&rect.height, mf->height, MT9T031_MAX_HEIGHT);
 369
 370         mf->code        = MEDIA_BUS_FMT_SBGGR10_1X10;
 371         mf->colorspace  = V4L2_COLORSPACE_SRGB;
 372
 373         /* mt9t031_set_params() doesn't change width and height */
 374         return mt9t031_set_params(client, &rect, xskip, yskip);
 375 }
 376
 377 /*
 378  * If a user window larger than sensor window is requested, we'll increase the
 379  * sensor window.
 380  */
 381 static int mt9t031_try_fmt(struct v4l2_subdev *sd,
 382                            struct v4l2_mbus_framefmt *mf)
 383 {
 384         v4l_bound_align_image(
 385                 &mf->width, MT9T031_MIN_WIDTH, MT9T031_MAX_WIDTH, 1,
 386                 &mf->height, MT9T031_MIN_HEIGHT, MT9T031_MAX_HEIGHT, 1, 0);
 387
 388         mf->code        = MEDIA_BUS_FMT_SBGGR10_1X10;
 389         mf->colorspace  = V4L2_COLORSPACE_SRGB;
 390
 391         return 0;
 392 }
 393
 394 #ifdef CONFIG_VIDEO_ADV_DEBUG
 395 static int mt9t031_g_register(struct v4l2_subdev *sd,
 396                               struct v4l2_dbg_register *reg)
 397 {
 398         struct i2c_client *client = v4l2_get_subdevdata(sd);
 399
 400         if (reg->reg > 0xff)
 401                 return -EINVAL;
 402
 403         reg->size = 1;
 404         reg->val = reg_read(client, reg->reg);
 405
 406         if (reg->val > 0xffff)
 407                 return -EIO;
 408
 409         return 0;
 410 }
 411
 412 static int mt9t031_s_register(struct v4l2_subdev *sd,
 413                               const struct v4l2_dbg_register *reg)
 414 {
 415         struct i2c_client *client = v4l2_get_subdevdata(sd);
 416
 417         if (reg->reg > 0xff)
 418                 return -EINVAL;
 419
 420         if (reg_write(client, reg->reg, reg->val) < 0)
 421                 return -EIO;
 422
 423         return 0;
 424 }
 425 #endif
 426
 427 static int mt9t031_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
 428 {
 429         struct mt9t031 *mt9t031 = container_of(ctrl->handler,
 430                                                struct mt9t031, hdl);
 431         const u32 shutter_max = MT9T031_MAX_HEIGHT + MT9T031_VERTICAL_BLANK;
 432         s32 min, max;
 433
 434         switch (ctrl->id) {
 435         case V4L2_CID_EXPOSURE_AUTO:
 436                 min = mt9t031->exposure->minimum;
 437                 max = mt9t031->exposure->maximum;
 438                 mt9t031->exposure->val =
 439                         (shutter_max / 2 + (mt9t031->total_h - 1) * (max - min))
 440                                 / shutter_max + min;
 441                 break;
 442         }
 443         return 0;
 444 }
 445
 446 static int mt9t031_s_ctrl(struct v4l2_ctrl *ctrl)
 447 {
 448         struct mt9t031 *mt9t031 = container_of(ctrl->handler,
 449                                                struct mt9t031, hdl);
 450         struct v4l2_subdev *sd = &mt9t031->subdev;
 451         struct i2c_client *client = v4l2_get_subdevdata(sd);
 452         struct v4l2_ctrl *exp = mt9t031->exposure;
 453         int data;
 454
 455         switch (ctrl->id) {
 456         case V4L2_CID_VFLIP:
 457                 if (ctrl->val)
 458                         data = reg_set(client, MT9T031_READ_MODE_2, 0x8000);
 459                 else
 460                         data = reg_clear(client, MT9T031_READ_MODE_2, 0x8000);
 461                 if (data < 0)
 462                         return -EIO;
 463                 return 0;
 464         case V4L2_CID_HFLIP:
 465                 if (ctrl->val)
 466                         data = reg_set(client, MT9T031_READ_MODE_2, 0x4000);
 467                 else
 468                         data = reg_clear(client, MT9T031_READ_MODE_2, 0x4000);
 469                 if (data < 0)
 470                         return -EIO;
 471                 return 0;
 472         case V4L2_CID_GAIN:
 473                 /* See Datasheet Table 7, Gain settings. */
 474                 if (ctrl->val <= ctrl->default_value) {
 475                         /* Pack it into 0..1 step 0.125, register values 0..8 */
 476                         unsigned long range = ctrl->default_value - ctrl->minimum;
 477                         data = ((ctrl->val - (s32)ctrl->minimum) * 8 + range / 2) / range;
 478
 479                         dev_dbg(&client->dev, "Setting gain %d\n", data);
 480                         data = reg_write(client, MT9T031_GLOBAL_GAIN, data);
 481                         if (data < 0)
 482                                 return -EIO;
 483                 } else {
 484                         /* Pack it into 1.125..128 variable step, register values 9..0x7860 */
 485                         /* We assume qctrl->maximum - qctrl->default_value - 1 > 0 */
 486                         unsigned long range = ctrl->maximum - ctrl->default_value - 1;
 487                         /* calculated gain: map 65..127 to 9..1024 step 0.125 */
 488                         unsigned long gain = ((ctrl->val - (s32)ctrl->default_value - 1) *
 489                                                1015 + range / 2) / range + 9;
 490
 491                         if (gain <= 32)         /* calculated gain 9..32 -> 9..32 */
 492                                 data = gain;
 493                         else if (gain <= 64)    /* calculated gain 33..64 -> 0x51..0x60 */
 494                                 data = ((gain - 32) * 16 + 16) / 32 + 80;
 495                         else
 496                                 /* calculated gain 65..1024 -> (1..120) << 8 + 0x60 */
 497                                 data = (((gain - 64 + 7) * 32) & 0xff00) | 0x60;
 498
 499                         dev_dbg(&client->dev, "Set gain from 0x%x to 0x%x\n",
 500                                 reg_read(client, MT9T031_GLOBAL_GAIN), data);
 501                         data = reg_write(client, MT9T031_GLOBAL_GAIN, data);
 502                         if (data < 0)
 503                                 return -EIO;
 504                 }
 505                 return 0;
 506
 507         case V4L2_CID_EXPOSURE_AUTO:
 508                 if (ctrl->val == V4L2_EXPOSURE_MANUAL) {
 509                         unsigned int range = exp->maximum - exp->minimum;
 510                         unsigned int shutter = ((exp->val - (s32)exp->minimum) * 1048 +
 511                                                  range / 2) / range + 1;
 512                         u32 old;
 513
 514                         get_shutter(client, &old);
 515                         dev_dbg(&client->dev, "Set shutter from %u to %u\n",
 516                                 old, shutter);
 517                         if (set_shutter(client, shutter) < 0)
 518                                 return -EIO;
 519                 } else {
 520                         const u16 vblank = MT9T031_VERTICAL_BLANK;
 521                         mt9t031->total_h = mt9t031->rect.height +
 522                                 mt9t031->y_skip_top + vblank;
 523
 524                         if (set_shutter(client, mt9t031->total_h) < 0)
 525                                 return -EIO;
 526                 }
 527                 return 0;
 528         default:
 529                 return -EINVAL;
 530         }
 531         return 0;
 532 }
 533
 534 /*
 535  * Power Management:
 536  * This function does nothing for now but must be present for pm to work
 537  */
 538 static int mt9t031_runtime_suspend(struct device *dev)
 539 {
 540         return 0;
 541 }
 542
 543 /*
 544  * Power Management:
 545  * COLUMN_ADDRESS_MODE and ROW_ADDRESS_MODE are not rewritten if unchanged
 546  * they are however changed at reset if the platform hook is present
 547  * thus we rewrite them with the values stored by the driver
 548  */
 549 static int mt9t031_runtime_resume(struct device *dev)
 550 {
 551         struct video_device *vdev = to_video_device(dev);
 552         struct v4l2_subdev *sd = soc_camera_vdev_to_subdev(vdev);
 553         struct i2c_client *client = v4l2_get_subdevdata(sd);
 554         struct mt9t031 *mt9t031 = to_mt9t031(client);
 555
 556         int ret;
 557         u16 xbin, ybin;
 558
 559         xbin = min(mt9t031->xskip, (u16)3);
 560         ybin = min(mt9t031->yskip, (u16)3);
 561
 562         ret = reg_write(client, MT9T031_COLUMN_ADDRESS_MODE,
 563                 ((xbin - 1) << 4) | (mt9t031->xskip - 1));
 564         if (ret < 0)
 565                 return ret;
 566
 567         ret = reg_write(client, MT9T031_ROW_ADDRESS_MODE,
 568                 ((ybin - 1) << 4) | (mt9t031->yskip - 1));
 569         if (ret < 0)
 570                 return ret;
 571
 572         return 0;
 573 }
 574
 575 static const struct dev_pm_ops mt9t031_dev_pm_ops = {
 576         .runtime_suspend        = mt9t031_runtime_suspend,
 577         .runtime_resume         = mt9t031_runtime_resume,
 578 };
 579
 580 static struct device_type mt9t031_dev_type = {
 581         .name   = "MT9T031",
 582         .pm     = &mt9t031_dev_pm_ops,
 583 };
 584
 585 static int mt9t031_s_power(struct v4l2_subdev *sd, int on)
 586 {
 587         struct i2c_client *client = v4l2_get_subdevdata(sd);
 588         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 589         struct video_device *vdev = soc_camera_i2c_to_vdev(client);
 590         struct mt9t031 *mt9t031 = to_mt9t031(client);
 591         int ret;
 592
 593         if (on) {
 594                 ret = soc_camera_power_on(&client->dev, ssdd, mt9t031->clk);
 595                 if (ret < 0)
 596                         return ret;
 597                 if (vdev)
 598                         /* Not needed during probing, when vdev isn't available yet */
 599                         vdev->dev.type = &mt9t031_dev_type;
 600         } else {
 601                 if (vdev)
 602                         vdev->dev.type = NULL;
 603                 soc_camera_power_off(&client->dev, ssdd, mt9t031->clk);
 604         }
 605
 606         return 0;
 607 }
 608
 609 /*
 610  * Interface active, can use i2c. If it fails, it can indeed mean, that
 611  * this wasn't our capture interface, so, we wait for the right one
 612  */
 613 static int mt9t031_video_probe(struct i2c_client *client)
 614 {
 615         struct mt9t031 *mt9t031 = to_mt9t031(client);
 616         s32 data;
 617         int ret;
 618
 619         ret = mt9t031_s_power(&mt9t031->subdev, 1);
 620         if (ret < 0)
 621                 return ret;
 622
 623         ret = mt9t031_idle(client);
 624         if (ret < 0) {
 625                 dev_err(&client->dev, "Failed to initialise the camera\n");
 626                 goto done;
 627         }
 628
 629         /* Read out the chip version register */
 630         data = reg_read(client, MT9T031_CHIP_VERSION);
 631
 632         switch (data) {
 633         case 0x1621:
 634                 break;
 635         default:
 636                 dev_err(&client->dev,
 637                         "No MT9T031 chip detected, register read %x\n", data);
 638                 ret = -ENODEV;
 639                 goto done;
 640         }
 641
 642         dev_info(&client->dev, "Detected a MT9T031 chip ID %x\n", data);
 643
 644         ret = v4l2_ctrl_handler_setup(&mt9t031->hdl);
 645
 646 done:
 647         mt9t031_s_power(&mt9t031->subdev, 0);
 648
 649         return ret;
 650 }
 651
 652 static int mt9t031_g_skip_top_lines(struct v4l2_subdev *sd, u32 *lines)
 653 {
 654         struct i2c_client *client = v4l2_get_subdevdata(sd);
 655         struct mt9t031 *mt9t031 = to_mt9t031(client);
 656
 657         *lines = mt9t031->y_skip_top;
 658
 659         return 0;
 660 }
 661
 662 static const struct v4l2_ctrl_ops mt9t031_ctrl_ops = {
 663         .g_volatile_ctrl = mt9t031_g_volatile_ctrl,
 664         .s_ctrl = mt9t031_s_ctrl,
 665 };
 666
 667 static struct v4l2_subdev_core_ops mt9t031_subdev_core_ops = {
 668         .s_power        = mt9t031_s_power,
 669 #ifdef CONFIG_VIDEO_ADV_DEBUG
 670         .g_register     = mt9t031_g_register,
 671         .s_register     = mt9t031_s_register,
 672 #endif
 673 };
 674
 675 static int mt9t031_enum_fmt(struct v4l2_subdev *sd, unsigned int index,
 676                             u32 *code)
 677 {
 678         if (index)
 679                 return -EINVAL;
 680
 681         *code = MEDIA_BUS_FMT_SBGGR10_1X10;
 682         return 0;
 683 }
 684
 685 static int mt9t031_g_mbus_config(struct v4l2_subdev *sd,
 686                                 struct v4l2_mbus_config *cfg)
 687 {
 688         struct i2c_client *client = v4l2_get_subdevdata(sd);
 689         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 690
 691         cfg->flags = V4L2_MBUS_MASTER | V4L2_MBUS_PCLK_SAMPLE_RISING |
 692                 V4L2_MBUS_PCLK_SAMPLE_FALLING | V4L2_MBUS_HSYNC_ACTIVE_HIGH |
 693                 V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_DATA_ACTIVE_HIGH;
 694         cfg->type = V4L2_MBUS_PARALLEL;
 695         cfg->flags = soc_camera_apply_board_flags(ssdd, cfg);
 696
 697         return 0;
 698 }
 699
 700 static int mt9t031_s_mbus_config(struct v4l2_subdev *sd,
 701                                 const struct v4l2_mbus_config *cfg)
 702 {
 703         struct i2c_client *client = v4l2_get_subdevdata(sd);
 704         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 705
 706         if (soc_camera_apply_board_flags(ssdd, cfg) &
 707             V4L2_MBUS_PCLK_SAMPLE_FALLING)
 708                 return reg_clear(client, MT9T031_PIXEL_CLOCK_CONTROL, 0x8000);
 709         else
 710                 return reg_set(client, MT9T031_PIXEL_CLOCK_CONTROL, 0x8000);
 711 }
 712
 713 static struct v4l2_subdev_video_ops mt9t031_subdev_video_ops = {
 714         .s_stream       = mt9t031_s_stream,
 715         .s_mbus_fmt     = mt9t031_s_fmt,
 716         .g_mbus_fmt     = mt9t031_g_fmt,
 717         .try_mbus_fmt   = mt9t031_try_fmt,
 718         .s_crop         = mt9t031_s_crop,
 719         .g_crop         = mt9t031_g_crop,
 720         .cropcap        = mt9t031_cropcap,
 721         .enum_mbus_fmt  = mt9t031_enum_fmt,
 722         .g_mbus_config  = mt9t031_g_mbus_config,
 723         .s_mbus_config  = mt9t031_s_mbus_config,
 724 };
 725
 726 static struct v4l2_subdev_sensor_ops mt9t031_subdev_sensor_ops = {
 727         .g_skip_top_lines       = mt9t031_g_skip_top_lines,
 728 };
 729
 730 static struct v4l2_subdev_ops mt9t031_subdev_ops = {
 731         .core   = &mt9t031_subdev_core_ops,
 732         .video  = &mt9t031_subdev_video_ops,
 733         .sensor = &mt9t031_subdev_sensor_ops,
 734 };
 735
 736 static int mt9t031_probe(struct i2c_client *client,
 737                          const struct i2c_device_id *did)
 738 {
 739         struct mt9t031 *mt9t031;
 740         struct soc_camera_subdev_desc *ssdd = soc_camera_i2c_to_desc(client);
 741         struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
 742         int ret;
 743
 744         if (!ssdd) {
 745                 dev_err(&client->dev, "MT9T031 driver needs platform data\n");
 746                 return -EINVAL;
 747         }
 748
 749         if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) {
 750                 dev_warn(&adapter->dev,
 751                          "I2C-Adapter doesn't support I2C_FUNC_SMBUS_WORD\n");
 752                 return -EIO;
 753         }
 754
 755         mt9t031 = devm_kzalloc(&client->dev, sizeof(struct mt9t031), GFP_KERNEL);
 756         if (!mt9t031)
 757                 return -ENOMEM;
 758
 759         v4l2_i2c_subdev_init(&mt9t031->subdev, client, &mt9t031_subdev_ops);
 760         v4l2_ctrl_handler_init(&mt9t031->hdl, 5);
 761         v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
 762                         V4L2_CID_VFLIP, 0, 1, 1, 0);
 763         v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
 764                         V4L2_CID_HFLIP, 0, 1, 1, 0);
 765         v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
 766                         V4L2_CID_GAIN, 0, 127, 1, 64);
 767
 768         /*
 769          * Simulated autoexposure. If enabled, we calculate shutter width
 770          * ourselves in the driver based on vertical blanking and frame width
 771          */
 772         mt9t031->autoexposure = v4l2_ctrl_new_std_menu(&mt9t031->hdl,
 773                         &mt9t031_ctrl_ops, V4L2_CID_EXPOSURE_AUTO, 1, 0,
 774                         V4L2_EXPOSURE_AUTO);
 775         mt9t031->exposure = v4l2_ctrl_new_std(&mt9t031->hdl, &mt9t031_ctrl_ops,
 776                         V4L2_CID_EXPOSURE, 1, 255, 1, 255);
 777
 778         mt9t031->subdev.ctrl_handler = &mt9t031->hdl;
 779         if (mt9t031->hdl.error)
 780                 return mt9t031->hdl.error;
 781
 782         v4l2_ctrl_auto_cluster(2, &mt9t031->autoexposure,
 783                                 V4L2_EXPOSURE_MANUAL, true);
 784
 785         mt9t031->y_skip_top     = 0;
 786         mt9t031->rect.left      = MT9T031_COLUMN_SKIP;
 787         mt9t031->rect.top       = MT9T031_ROW_SKIP;
 788         mt9t031->rect.width     = MT9T031_MAX_WIDTH;
 789         mt9t031->rect.height    = MT9T031_MAX_HEIGHT;
 790
 791         mt9t031->xskip = 1;
 792         mt9t031->yskip = 1;
 793
 794         mt9t031->clk = v4l2_clk_get(&client->dev, "mclk");
 795         if (IS_ERR(mt9t031->clk)) {
 796                 ret = PTR_ERR(mt9t031->clk);
 797                 goto eclkget;
 798         }
 799
 800         ret = mt9t031_video_probe(client);
 801         if (ret) {
 802                 v4l2_clk_put(mt9t031->clk);
 803 eclkget:
 804                 v4l2_ctrl_handler_free(&mt9t031->hdl);
 805         }
 806
 807         return ret;
 808 }
 809
 810 static int mt9t031_remove(struct i2c_client *client)
 811 {
 812         struct mt9t031 *mt9t031 = to_mt9t031(client);
 813
 814         v4l2_clk_put(mt9t031->clk);
 815         v4l2_device_unregister_subdev(&mt9t031->subdev);
 816         v4l2_ctrl_handler_free(&mt9t031->hdl);
 817
 818         return 0;
 819 }
 820
 821 static const struct i2c_device_id mt9t031_id[] = {
 822         { "mt9t031", 0 },
 823         { }
 824 };
 825 MODULE_DEVICE_TABLE(i2c, mt9t031_id);
 826
 827 static struct i2c_driver mt9t031_i2c_driver = {
 828         .driver = {
 829                 .name = "mt9t031",
 830         },
 831         .probe          = mt9t031_probe,
 832         .remove         = mt9t031_remove,
 833         .id_table       = mt9t031_id,
 834 };
 835
 836 module_i2c_driver(mt9t031_i2c_driver);
 837
 838 MODULE_DESCRIPTION("Micron MT9T031 Camera driver");
 839 MODULE_AUTHOR("Guennadi Liakhovetski <lg@denx.de>");
 840 MODULE_LICENSE("GPL v2");