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