drivers/media/platform/soc_camera/soc_camera.c

   1 /*
   2  * camera image capture (abstract) bus driver
   3  *
   4  * Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
   5  *
   6  * This driver provides an interface between platform-specific camera
   7  * busses and camera devices. It should be used if the camera is
   8  * connected not over a "proper" bus like PCI or USB, but over a
   9  * special bus, like, for example, the Quick Capture interface on PXA270
  10  * SoCs. Later it should also be used for i.MX31 SoCs from Freescale.
  11  * It can handle multiple cameras and / or multiple busses, which can
  12  * be used, e.g., in stereo-vision applications.
  13  *
  14  * This program is free software; you can redistribute it and/or modify
  15  * it under the terms of the GNU General Public License version 2 as
  16  * published by the Free Software Foundation.
  17  */
  18
  19 #include <linux/device.h>
  20 #include <linux/err.h>
  21 #include <linux/i2c.h>
  22 #include <linux/init.h>
  23 #include <linux/list.h>
  24 #include <linux/module.h>
  25 #include <linux/mutex.h>
  26 #include <linux/of_graph.h>
  27 #include <linux/platform_device.h>
  28 #include <linux/pm_runtime.h>
  29 #include <linux/regulator/consumer.h>
  30 #include <linux/slab.h>
  31 #include <linux/vmalloc.h>
  32
  33 #include <media/soc_camera.h>
  34 #include <media/drv-intf/soc_mediabus.h>
  35 #include <media/v4l2-async.h>
  36 #include <media/v4l2-clk.h>
  37 #include <media/v4l2-common.h>
  38 #include <media/v4l2-ioctl.h>
  39 #include <media/v4l2-dev.h>
  40 #include <media/v4l2-fwnode.h>
  41 #include <media/videobuf2-v4l2.h>
  42
  43 /* Default to VGA resolution */
  44 #define DEFAULT_WIDTH   640
  45 #define DEFAULT_HEIGHT  480
  46
  47 #define MAP_MAX_NUM 32
  48 static DECLARE_BITMAP(device_map, MAP_MAX_NUM);
  49 static LIST_HEAD(hosts);
  50 static LIST_HEAD(devices);
  51 /*
  52  * Protects lists and bitmaps of hosts and devices.
  53  * Lock nesting: Ok to take ->host_lock under list_lock.
  54  */
  55 static DEFINE_MUTEX(list_lock);
  56
  57 struct soc_camera_async_client {
  58         struct v4l2_async_subdev *sensor;
  59         struct v4l2_async_notifier notifier;
  60         struct platform_device *pdev;
  61         struct list_head list;          /* needed for clean up */
  62 };
  63
  64 static int soc_camera_video_start(struct soc_camera_device *icd);
  65 static int video_dev_create(struct soc_camera_device *icd);
  66
  67 int soc_camera_power_on(struct device *dev, struct soc_camera_subdev_desc *ssdd,
  68                         struct v4l2_clk *clk)
  69 {
  70         int ret;
  71         bool clock_toggle;
  72
  73         if (clk && (!ssdd->unbalanced_power ||
  74                     !test_and_set_bit(0, &ssdd->clock_state))) {
  75                 ret = v4l2_clk_enable(clk);
  76                 if (ret < 0) {
  77                         dev_err(dev, "Cannot enable clock: %d\n", ret);
  78                         return ret;
  79                 }
  80                 clock_toggle = true;
  81         } else {
  82                 clock_toggle = false;
  83         }
  84
  85         ret = regulator_bulk_enable(ssdd->sd_pdata.num_regulators,
  86                                     ssdd->sd_pdata.regulators);
  87         if (ret < 0) {
  88                 dev_err(dev, "Cannot enable regulators\n");
  89                 goto eregenable;
  90         }
  91
  92         if (ssdd->power) {
  93                 ret = ssdd->power(dev, 1);
  94                 if (ret < 0) {
  95                         dev_err(dev,
  96                                 "Platform failed to power-on the camera.\n");
  97                         goto epwron;
  98                 }
  99         }
 100
 101         return 0;
 102
 103 epwron:
 104         regulator_bulk_disable(ssdd->sd_pdata.num_regulators,
 105                                ssdd->sd_pdata.regulators);
 106 eregenable:
 107         if (clock_toggle)
 108                 v4l2_clk_disable(clk);
 109
 110         return ret;
 111 }
 112 EXPORT_SYMBOL(soc_camera_power_on);
 113
 114 int soc_camera_power_off(struct device *dev, struct soc_camera_subdev_desc *ssdd,
 115                          struct v4l2_clk *clk)
 116 {
 117         int ret = 0;
 118         int err;
 119
 120         if (ssdd->power) {
 121                 err = ssdd->power(dev, 0);
 122                 if (err < 0) {
 123                         dev_err(dev,
 124                                 "Platform failed to power-off the camera.\n");
 125                         ret = err;
 126                 }
 127         }
 128
 129         err = regulator_bulk_disable(ssdd->sd_pdata.num_regulators,
 130                                      ssdd->sd_pdata.regulators);
 131         if (err < 0) {
 132                 dev_err(dev, "Cannot disable regulators\n");
 133                 ret = ret ? : err;
 134         }
 135
 136         if (clk && (!ssdd->unbalanced_power || test_and_clear_bit(0, &ssdd->clock_state)))
 137                 v4l2_clk_disable(clk);
 138
 139         return ret;
 140 }
 141 EXPORT_SYMBOL(soc_camera_power_off);
 142
 143 int soc_camera_power_init(struct device *dev, struct soc_camera_subdev_desc *ssdd)
 144 {
 145         /* Should not have any effect in synchronous case */
 146         return devm_regulator_bulk_get(dev, ssdd->sd_pdata.num_regulators,
 147                                        ssdd->sd_pdata.regulators);
 148 }
 149 EXPORT_SYMBOL(soc_camera_power_init);
 150
 151 static int __soc_camera_power_on(struct soc_camera_device *icd)
 152 {
 153         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 154         int ret;
 155
 156         ret = v4l2_subdev_call(sd, core, s_power, 1);
 157         if (ret < 0 && ret != -ENOIOCTLCMD && ret != -ENODEV)
 158                 return ret;
 159
 160         return 0;
 161 }
 162
 163 static int __soc_camera_power_off(struct soc_camera_device *icd)
 164 {
 165         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 166         int ret;
 167
 168         ret = v4l2_subdev_call(sd, core, s_power, 0);
 169         if (ret < 0 && ret != -ENOIOCTLCMD && ret != -ENODEV)
 170                 return ret;
 171
 172         return 0;
 173 }
 174
 175 static int soc_camera_clock_start(struct soc_camera_host *ici)
 176 {
 177         int ret;
 178
 179         if (!ici->ops->clock_start)
 180                 return 0;
 181
 182         mutex_lock(&ici->clk_lock);
 183         ret = ici->ops->clock_start(ici);
 184         mutex_unlock(&ici->clk_lock);
 185
 186         return ret;
 187 }
 188
 189 static void soc_camera_clock_stop(struct soc_camera_host *ici)
 190 {
 191         if (!ici->ops->clock_stop)
 192                 return;
 193
 194         mutex_lock(&ici->clk_lock);
 195         ici->ops->clock_stop(ici);
 196         mutex_unlock(&ici->clk_lock);
 197 }
 198
 199 const struct soc_camera_format_xlate *soc_camera_xlate_by_fourcc(
 200         struct soc_camera_device *icd, unsigned int fourcc)
 201 {
 202         unsigned int i;
 203
 204         for (i = 0; i < icd->num_user_formats; i++)
 205                 if (icd->user_formats[i].host_fmt->fourcc == fourcc)
 206                         return icd->user_formats + i;
 207         return NULL;
 208 }
 209 EXPORT_SYMBOL(soc_camera_xlate_by_fourcc);
 210
 211 /**
 212  * soc_camera_apply_board_flags() - apply platform SOCAM_SENSOR_INVERT_* flags
 213  * @ssdd:       camera platform parameters
 214  * @cfg:        media bus configuration
 215  * @return:     resulting flags
 216  */
 217 unsigned long soc_camera_apply_board_flags(struct soc_camera_subdev_desc *ssdd,
 218                                            const struct v4l2_mbus_config *cfg)
 219 {
 220         unsigned long f, flags = cfg->flags;
 221
 222         /* If only one of the two polarities is supported, switch to the opposite */
 223         if (ssdd->flags & SOCAM_SENSOR_INVERT_HSYNC) {
 224                 f = flags & (V4L2_MBUS_HSYNC_ACTIVE_HIGH | V4L2_MBUS_HSYNC_ACTIVE_LOW);
 225                 if (f == V4L2_MBUS_HSYNC_ACTIVE_HIGH || f == V4L2_MBUS_HSYNC_ACTIVE_LOW)
 226                         flags ^= V4L2_MBUS_HSYNC_ACTIVE_HIGH | V4L2_MBUS_HSYNC_ACTIVE_LOW;
 227         }
 228
 229         if (ssdd->flags & SOCAM_SENSOR_INVERT_VSYNC) {
 230                 f = flags & (V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_VSYNC_ACTIVE_LOW);
 231                 if (f == V4L2_MBUS_VSYNC_ACTIVE_HIGH || f == V4L2_MBUS_VSYNC_ACTIVE_LOW)
 232                         flags ^= V4L2_MBUS_VSYNC_ACTIVE_HIGH | V4L2_MBUS_VSYNC_ACTIVE_LOW;
 233         }
 234
 235         if (ssdd->flags & SOCAM_SENSOR_INVERT_PCLK) {
 236                 f = flags & (V4L2_MBUS_PCLK_SAMPLE_RISING | V4L2_MBUS_PCLK_SAMPLE_FALLING);
 237                 if (f == V4L2_MBUS_PCLK_SAMPLE_RISING || f == V4L2_MBUS_PCLK_SAMPLE_FALLING)
 238                         flags ^= V4L2_MBUS_PCLK_SAMPLE_RISING | V4L2_MBUS_PCLK_SAMPLE_FALLING;
 239         }
 240
 241         return flags;
 242 }
 243 EXPORT_SYMBOL(soc_camera_apply_board_flags);
 244
 245 #define pixfmtstr(x) (x) & 0xff, ((x) >> 8) & 0xff, ((x) >> 16) & 0xff, \
 246         ((x) >> 24) & 0xff
 247
 248 static int soc_camera_try_fmt(struct soc_camera_device *icd,
 249                               struct v4l2_format *f)
 250 {
 251         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 252         const struct soc_camera_format_xlate *xlate;
 253         struct v4l2_pix_format *pix = &f->fmt.pix;
 254         int ret;
 255
 256         dev_dbg(icd->pdev, "TRY_FMT(%c%c%c%c, %ux%u)\n",
 257                 pixfmtstr(pix->pixelformat), pix->width, pix->height);
 258
 259         if (pix->pixelformat != V4L2_PIX_FMT_JPEG &&
 260             !(ici->capabilities & SOCAM_HOST_CAP_STRIDE)) {
 261                 pix->bytesperline = 0;
 262                 pix->sizeimage = 0;
 263         }
 264
 265         ret = ici->ops->try_fmt(icd, f);
 266         if (ret < 0)
 267                 return ret;
 268
 269         xlate = soc_camera_xlate_by_fourcc(icd, pix->pixelformat);
 270         if (!xlate)
 271                 return -EINVAL;
 272
 273         ret = soc_mbus_bytes_per_line(pix->width, xlate->host_fmt);
 274         if (ret < 0)
 275                 return ret;
 276
 277         pix->bytesperline = max_t(u32, pix->bytesperline, ret);
 278
 279         ret = soc_mbus_image_size(xlate->host_fmt, pix->bytesperline,
 280                                   pix->height);
 281         if (ret < 0)
 282                 return ret;
 283
 284         pix->sizeimage = max_t(u32, pix->sizeimage, ret);
 285
 286         return 0;
 287 }
 288
 289 static int soc_camera_try_fmt_vid_cap(struct file *file, void *priv,
 290                                       struct v4l2_format *f)
 291 {
 292         struct soc_camera_device *icd = file->private_data;
 293
 294         WARN_ON(priv != file->private_data);
 295
 296         /* Only single-plane capture is supported so far */
 297         if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 298                 return -EINVAL;
 299
 300         /* limit format to hardware capabilities */
 301         return soc_camera_try_fmt(icd, f);
 302 }
 303
 304 static int soc_camera_enum_input(struct file *file, void *priv,
 305                                  struct v4l2_input *inp)
 306 {
 307         struct soc_camera_device *icd = file->private_data;
 308
 309         if (inp->index != 0)
 310                 return -EINVAL;
 311
 312         /* default is camera */
 313         inp->type = V4L2_INPUT_TYPE_CAMERA;
 314         inp->std = icd->vdev->tvnorms;
 315         strcpy(inp->name, "Camera");
 316
 317         return 0;
 318 }
 319
 320 static int soc_camera_g_input(struct file *file, void *priv, unsigned int *i)
 321 {
 322         *i = 0;
 323
 324         return 0;
 325 }
 326
 327 static int soc_camera_s_input(struct file *file, void *priv, unsigned int i)
 328 {
 329         if (i > 0)
 330                 return -EINVAL;
 331
 332         return 0;
 333 }
 334
 335 static int soc_camera_s_std(struct file *file, void *priv, v4l2_std_id a)
 336 {
 337         struct soc_camera_device *icd = file->private_data;
 338         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 339
 340         return v4l2_subdev_call(sd, video, s_std, a);
 341 }
 342
 343 static int soc_camera_g_std(struct file *file, void *priv, v4l2_std_id *a)
 344 {
 345         struct soc_camera_device *icd = file->private_data;
 346         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 347
 348         return v4l2_subdev_call(sd, video, g_std, a);
 349 }
 350
 351 static int soc_camera_enum_framesizes(struct file *file, void *fh,
 352                                          struct v4l2_frmsizeenum *fsize)
 353 {
 354         struct soc_camera_device *icd = file->private_data;
 355         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 356
 357         return ici->ops->enum_framesizes(icd, fsize);
 358 }
 359
 360 static int soc_camera_reqbufs(struct file *file, void *priv,
 361                               struct v4l2_requestbuffers *p)
 362 {
 363         int ret;
 364         struct soc_camera_device *icd = file->private_data;
 365
 366         WARN_ON(priv != file->private_data);
 367
 368         if (icd->streamer && icd->streamer != file)
 369                 return -EBUSY;
 370
 371         ret = vb2_reqbufs(&icd->vb2_vidq, p);
 372         if (!ret)
 373                 icd->streamer = p->count ? file : NULL;
 374         return ret;
 375 }
 376
 377 static int soc_camera_querybuf(struct file *file, void *priv,
 378                                struct v4l2_buffer *p)
 379 {
 380         struct soc_camera_device *icd = file->private_data;
 381
 382         WARN_ON(priv != file->private_data);
 383
 384         return vb2_querybuf(&icd->vb2_vidq, p);
 385 }
 386
 387 static int soc_camera_qbuf(struct file *file, void *priv,
 388                            struct v4l2_buffer *p)
 389 {
 390         struct soc_camera_device *icd = file->private_data;
 391
 392         WARN_ON(priv != file->private_data);
 393
 394         if (icd->streamer != file)
 395                 return -EBUSY;
 396
 397         return vb2_qbuf(&icd->vb2_vidq, p);
 398 }
 399
 400 static int soc_camera_dqbuf(struct file *file, void *priv,
 401                             struct v4l2_buffer *p)
 402 {
 403         struct soc_camera_device *icd = file->private_data;
 404
 405         WARN_ON(priv != file->private_data);
 406
 407         if (icd->streamer != file)
 408                 return -EBUSY;
 409
 410         return vb2_dqbuf(&icd->vb2_vidq, p, file->f_flags & O_NONBLOCK);
 411 }
 412
 413 static int soc_camera_create_bufs(struct file *file, void *priv,
 414                             struct v4l2_create_buffers *create)
 415 {
 416         struct soc_camera_device *icd = file->private_data;
 417         int ret;
 418
 419         if (icd->streamer && icd->streamer != file)
 420                 return -EBUSY;
 421
 422         ret = vb2_create_bufs(&icd->vb2_vidq, create);
 423         if (!ret)
 424                 icd->streamer = file;
 425         return ret;
 426 }
 427
 428 static int soc_camera_prepare_buf(struct file *file, void *priv,
 429                                   struct v4l2_buffer *b)
 430 {
 431         struct soc_camera_device *icd = file->private_data;
 432
 433         return vb2_prepare_buf(&icd->vb2_vidq, b);
 434 }
 435
 436 static int soc_camera_expbuf(struct file *file, void *priv,
 437                              struct v4l2_exportbuffer *p)
 438 {
 439         struct soc_camera_device *icd = file->private_data;
 440
 441         if (icd->streamer && icd->streamer != file)
 442                 return -EBUSY;
 443         return vb2_expbuf(&icd->vb2_vidq, p);
 444 }
 445
 446 /* Always entered with .host_lock held */
 447 static int soc_camera_init_user_formats(struct soc_camera_device *icd)
 448 {
 449         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 450         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 451         unsigned int i, fmts = 0, raw_fmts = 0;
 452         int ret;
 453         struct v4l2_subdev_mbus_code_enum code = {
 454                 .which = V4L2_SUBDEV_FORMAT_ACTIVE,
 455         };
 456
 457         while (!v4l2_subdev_call(sd, pad, enum_mbus_code, NULL, &code)) {
 458                 raw_fmts++;
 459                 code.index++;
 460         }
 461
 462         if (!ici->ops->get_formats)
 463                 /*
 464                  * Fallback mode - the host will have to serve all
 465                  * sensor-provided formats one-to-one to the user
 466                  */
 467                 fmts = raw_fmts;
 468         else
 469                 /*
 470                  * First pass - only count formats this host-sensor
 471                  * configuration can provide
 472                  */
 473                 for (i = 0; i < raw_fmts; i++) {
 474                         ret = ici->ops->get_formats(icd, i, NULL);
 475                         if (ret < 0)
 476                                 return ret;
 477                         fmts += ret;
 478                 }
 479
 480         if (!fmts)
 481                 return -ENXIO;
 482
 483         icd->user_formats =
 484                 vmalloc(fmts * sizeof(struct soc_camera_format_xlate));
 485         if (!icd->user_formats)
 486                 return -ENOMEM;
 487
 488         dev_dbg(icd->pdev, "Found %d supported formats.\n", fmts);
 489
 490         /* Second pass - actually fill data formats */
 491         fmts = 0;
 492         for (i = 0; i < raw_fmts; i++)
 493                 if (!ici->ops->get_formats) {
 494                         code.index = i;
 495                         v4l2_subdev_call(sd, pad, enum_mbus_code, NULL, &code);
 496                         icd->user_formats[fmts].host_fmt =
 497                                 soc_mbus_get_fmtdesc(code.code);
 498                         if (icd->user_formats[fmts].host_fmt)
 499                                 icd->user_formats[fmts++].code = code.code;
 500                 } else {
 501                         ret = ici->ops->get_formats(icd, i,
 502                                                     &icd->user_formats[fmts]);
 503                         if (ret < 0)
 504                                 goto egfmt;
 505                         fmts += ret;
 506                 }
 507
 508         icd->num_user_formats = fmts;
 509         icd->current_fmt = &icd->user_formats[0];
 510
 511         return 0;
 512
 513 egfmt:
 514         vfree(icd->user_formats);
 515         return ret;
 516 }
 517
 518 /* Always entered with .host_lock held */
 519 static void soc_camera_free_user_formats(struct soc_camera_device *icd)
 520 {
 521         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 522
 523         if (ici->ops->put_formats)
 524                 ici->ops->put_formats(icd);
 525         icd->current_fmt = NULL;
 526         icd->num_user_formats = 0;
 527         vfree(icd->user_formats);
 528         icd->user_formats = NULL;
 529 }
 530
 531 /* Called with .vb_lock held, or from the first open(2), see comment there */
 532 static int soc_camera_set_fmt(struct soc_camera_device *icd,
 533                               struct v4l2_format *f)
 534 {
 535         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 536         struct v4l2_pix_format *pix = &f->fmt.pix;
 537         int ret;
 538
 539         dev_dbg(icd->pdev, "S_FMT(%c%c%c%c, %ux%u)\n",
 540                 pixfmtstr(pix->pixelformat), pix->width, pix->height);
 541
 542         /* We always call try_fmt() before set_fmt() or set_selection() */
 543         ret = soc_camera_try_fmt(icd, f);
 544         if (ret < 0)
 545                 return ret;
 546
 547         ret = ici->ops->set_fmt(icd, f);
 548         if (ret < 0) {
 549                 return ret;
 550         } else if (!icd->current_fmt ||
 551                    icd->current_fmt->host_fmt->fourcc != pix->pixelformat) {
 552                 dev_err(icd->pdev,
 553                         "Host driver hasn't set up current format correctly!\n");
 554                 return -EINVAL;
 555         }
 556
 557         icd->user_width         = pix->width;
 558         icd->user_height        = pix->height;
 559         icd->bytesperline       = pix->bytesperline;
 560         icd->sizeimage          = pix->sizeimage;
 561         icd->colorspace         = pix->colorspace;
 562         icd->field              = pix->field;
 563
 564         dev_dbg(icd->pdev, "set width: %d height: %d\n",
 565                 icd->user_width, icd->user_height);
 566
 567         /* set physical bus parameters */
 568         return ici->ops->set_bus_param(icd);
 569 }
 570
 571 static int soc_camera_add_device(struct soc_camera_device *icd)
 572 {
 573         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 574         int ret;
 575
 576         if (ici->icd)
 577                 return -EBUSY;
 578
 579         if (!icd->clk) {
 580                 ret = soc_camera_clock_start(ici);
 581                 if (ret < 0)
 582                         return ret;
 583         }
 584
 585         if (ici->ops->add) {
 586                 ret = ici->ops->add(icd);
 587                 if (ret < 0)
 588                         goto eadd;
 589         }
 590
 591         ici->icd = icd;
 592
 593         return 0;
 594
 595 eadd:
 596         if (!icd->clk)
 597                 soc_camera_clock_stop(ici);
 598         return ret;
 599 }
 600
 601 static void soc_camera_remove_device(struct soc_camera_device *icd)
 602 {
 603         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 604
 605         if (WARN_ON(icd != ici->icd))
 606                 return;
 607
 608         if (ici->ops->remove)
 609                 ici->ops->remove(icd);
 610         if (!icd->clk)
 611                 soc_camera_clock_stop(ici);
 612         ici->icd = NULL;
 613 }
 614
 615 static int soc_camera_open(struct file *file)
 616 {
 617         struct video_device *vdev = video_devdata(file);
 618         struct soc_camera_device *icd;
 619         struct soc_camera_host *ici;
 620         int ret;
 621
 622         /*
 623          * Don't mess with the host during probe: wait until the loop in
 624          * scan_add_host() completes. Also protect against a race with
 625          * soc_camera_host_unregister().
 626          */
 627         if (mutex_lock_interruptible(&list_lock))
 628                 return -ERESTARTSYS;
 629
 630         if (!vdev || !video_is_registered(vdev)) {
 631                 mutex_unlock(&list_lock);
 632                 return -ENODEV;
 633         }
 634
 635         icd = video_get_drvdata(vdev);
 636         ici = to_soc_camera_host(icd->parent);
 637
 638         ret = try_module_get(ici->ops->owner) ? 0 : -ENODEV;
 639         mutex_unlock(&list_lock);
 640
 641         if (ret < 0) {
 642                 dev_err(icd->pdev, "Couldn't lock capture bus driver.\n");
 643                 return ret;
 644         }
 645
 646         if (!to_soc_camera_control(icd)) {
 647                 /* No device driver attached */
 648                 ret = -ENODEV;
 649                 goto econtrol;
 650         }
 651
 652         if (mutex_lock_interruptible(&ici->host_lock)) {
 653                 ret = -ERESTARTSYS;
 654                 goto elockhost;
 655         }
 656         icd->use_count++;
 657
 658         /* Now we really have to activate the camera */
 659         if (icd->use_count == 1) {
 660                 struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
 661                 /* Restore parameters before the last close() per V4L2 API */
 662                 struct v4l2_format f = {
 663                         .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
 664                         .fmt.pix = {
 665                                 .width          = icd->user_width,
 666                                 .height         = icd->user_height,
 667                                 .field          = icd->field,
 668                                 .colorspace     = icd->colorspace,
 669                                 .pixelformat    =
 670                                         icd->current_fmt->host_fmt->fourcc,
 671                         },
 672                 };
 673
 674                 /* The camera could have been already on, try to reset */
 675                 if (sdesc->subdev_desc.reset)
 676                         if (icd->control)
 677                                 sdesc->subdev_desc.reset(icd->control);
 678
 679                 ret = soc_camera_add_device(icd);
 680                 if (ret < 0) {
 681                         dev_err(icd->pdev, "Couldn't activate the camera: %d\n", ret);
 682                         goto eiciadd;
 683                 }
 684
 685                 ret = __soc_camera_power_on(icd);
 686                 if (ret < 0)
 687                         goto epower;
 688
 689                 pm_runtime_enable(&icd->vdev->dev);
 690                 ret = pm_runtime_resume(&icd->vdev->dev);
 691                 if (ret < 0 && ret != -ENOSYS)
 692                         goto eresume;
 693
 694                 /*
 695                  * Try to configure with default parameters. Notice: this is the
 696                  * very first open, so, we cannot race against other calls,
 697                  * apart from someone else calling open() simultaneously, but
 698                  * .host_lock is protecting us against it.
 699                  */
 700                 ret = soc_camera_set_fmt(icd, &f);
 701                 if (ret < 0)
 702                         goto esfmt;
 703
 704                 ret = ici->ops->init_videobuf2(&icd->vb2_vidq, icd);
 705                 if (ret < 0)
 706                         goto einitvb;
 707                 v4l2_ctrl_handler_setup(&icd->ctrl_handler);
 708         }
 709         mutex_unlock(&ici->host_lock);
 710
 711         file->private_data = icd;
 712         dev_dbg(icd->pdev, "camera device open\n");
 713
 714         return 0;
 715
 716         /*
 717          * All errors are entered with the .host_lock held, first four also
 718          * with use_count == 1
 719          */
 720 einitvb:
 721 esfmt:
 722         pm_runtime_disable(&icd->vdev->dev);
 723 eresume:
 724         __soc_camera_power_off(icd);
 725 epower:
 726         soc_camera_remove_device(icd);
 727 eiciadd:
 728         icd->use_count--;
 729         mutex_unlock(&ici->host_lock);
 730 elockhost:
 731 econtrol:
 732         module_put(ici->ops->owner);
 733
 734         return ret;
 735 }
 736
 737 static int soc_camera_close(struct file *file)
 738 {
 739         struct soc_camera_device *icd = file->private_data;
 740         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 741
 742         mutex_lock(&ici->host_lock);
 743         if (icd->streamer == file) {
 744                 if (ici->ops->init_videobuf2)
 745                         vb2_queue_release(&icd->vb2_vidq);
 746                 icd->streamer = NULL;
 747         }
 748         icd->use_count--;
 749         if (!icd->use_count) {
 750                 pm_runtime_suspend(&icd->vdev->dev);
 751                 pm_runtime_disable(&icd->vdev->dev);
 752
 753                 __soc_camera_power_off(icd);
 754
 755                 soc_camera_remove_device(icd);
 756         }
 757
 758         mutex_unlock(&ici->host_lock);
 759
 760         module_put(ici->ops->owner);
 761
 762         dev_dbg(icd->pdev, "camera device close\n");
 763
 764         return 0;
 765 }
 766
 767 static ssize_t soc_camera_read(struct file *file, char __user *buf,
 768                                size_t count, loff_t *ppos)
 769 {
 770         struct soc_camera_device *icd = file->private_data;
 771         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 772
 773         dev_dbg(icd->pdev, "read called, buf %p\n", buf);
 774
 775         if (ici->ops->init_videobuf2 && icd->vb2_vidq.io_modes & VB2_READ)
 776                 return vb2_read(&icd->vb2_vidq, buf, count, ppos,
 777                                 file->f_flags & O_NONBLOCK);
 778
 779         dev_err(icd->pdev, "camera device read not implemented\n");
 780
 781         return -EINVAL;
 782 }
 783
 784 static int soc_camera_mmap(struct file *file, struct vm_area_struct *vma)
 785 {
 786         struct soc_camera_device *icd = file->private_data;
 787         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 788         int err;
 789
 790         dev_dbg(icd->pdev, "mmap called, vma=0x%08lx\n", (unsigned long)vma);
 791
 792         if (icd->streamer != file)
 793                 return -EBUSY;
 794
 795         if (mutex_lock_interruptible(&ici->host_lock))
 796                 return -ERESTARTSYS;
 797         err = vb2_mmap(&icd->vb2_vidq, vma);
 798         mutex_unlock(&ici->host_lock);
 799
 800         dev_dbg(icd->pdev, "vma start=0x%08lx, size=%ld, ret=%d\n",
 801                 (unsigned long)vma->vm_start,
 802                 (unsigned long)vma->vm_end - (unsigned long)vma->vm_start,
 803                 err);
 804
 805         return err;
 806 }
 807
 808 static unsigned int soc_camera_poll(struct file *file, poll_table *pt)
 809 {
 810         struct soc_camera_device *icd = file->private_data;
 811         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 812         unsigned res = POLLERR;
 813
 814         if (icd->streamer != file)
 815                 return POLLERR;
 816
 817         mutex_lock(&ici->host_lock);
 818         res = ici->ops->poll(file, pt);
 819         mutex_unlock(&ici->host_lock);
 820         return res;
 821 }
 822
 823 static const struct v4l2_file_operations soc_camera_fops = {
 824         .owner          = THIS_MODULE,
 825         .open           = soc_camera_open,
 826         .release        = soc_camera_close,
 827         .unlocked_ioctl = video_ioctl2,
 828         .read           = soc_camera_read,
 829         .mmap           = soc_camera_mmap,
 830         .poll           = soc_camera_poll,
 831 };
 832
 833 static int soc_camera_s_fmt_vid_cap(struct file *file, void *priv,
 834                                     struct v4l2_format *f)
 835 {
 836         struct soc_camera_device *icd = file->private_data;
 837         int ret;
 838
 839         WARN_ON(priv != file->private_data);
 840
 841         if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) {
 842                 dev_warn(icd->pdev, "Wrong buf-type %d\n", f->type);
 843                 return -EINVAL;
 844         }
 845
 846         if (icd->streamer && icd->streamer != file)
 847                 return -EBUSY;
 848
 849         if (vb2_is_streaming(&icd->vb2_vidq)) {
 850                 dev_err(icd->pdev, "S_FMT denied: queue initialised\n");
 851                 return -EBUSY;
 852         }
 853
 854         ret = soc_camera_set_fmt(icd, f);
 855
 856         if (!ret && !icd->streamer)
 857                 icd->streamer = file;
 858
 859         return ret;
 860 }
 861
 862 static int soc_camera_enum_fmt_vid_cap(struct file *file, void  *priv,
 863                                        struct v4l2_fmtdesc *f)
 864 {
 865         struct soc_camera_device *icd = file->private_data;
 866         const struct soc_mbus_pixelfmt *format;
 867
 868         WARN_ON(priv != file->private_data);
 869
 870         if (f->index >= icd->num_user_formats)
 871                 return -EINVAL;
 872
 873         format = icd->user_formats[f->index].host_fmt;
 874
 875         if (format->name)
 876                 strlcpy(f->description, format->name, sizeof(f->description));
 877         f->pixelformat = format->fourcc;
 878         return 0;
 879 }
 880
 881 static int soc_camera_g_fmt_vid_cap(struct file *file, void *priv,
 882                                     struct v4l2_format *f)
 883 {
 884         struct soc_camera_device *icd = file->private_data;
 885         struct v4l2_pix_format *pix = &f->fmt.pix;
 886
 887         WARN_ON(priv != file->private_data);
 888
 889         if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 890                 return -EINVAL;
 891
 892         pix->width              = icd->user_width;
 893         pix->height             = icd->user_height;
 894         pix->bytesperline       = icd->bytesperline;
 895         pix->sizeimage          = icd->sizeimage;
 896         pix->field              = icd->field;
 897         pix->pixelformat        = icd->current_fmt->host_fmt->fourcc;
 898         pix->colorspace         = icd->colorspace;
 899         dev_dbg(icd->pdev, "current_fmt->fourcc: 0x%08x\n",
 900                 icd->current_fmt->host_fmt->fourcc);
 901         return 0;
 902 }
 903
 904 static int soc_camera_querycap(struct file *file, void  *priv,
 905                                struct v4l2_capability *cap)
 906 {
 907         struct soc_camera_device *icd = file->private_data;
 908         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 909
 910         WARN_ON(priv != file->private_data);
 911
 912         strlcpy(cap->driver, ici->drv_name, sizeof(cap->driver));
 913         return ici->ops->querycap(ici, cap);
 914 }
 915
 916 static int soc_camera_streamon(struct file *file, void *priv,
 917                                enum v4l2_buf_type i)
 918 {
 919         struct soc_camera_device *icd = file->private_data;
 920         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 921         int ret;
 922
 923         WARN_ON(priv != file->private_data);
 924
 925         if (i != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 926                 return -EINVAL;
 927
 928         if (icd->streamer != file)
 929                 return -EBUSY;
 930
 931         /* This calls buf_queue from host driver's videobuf2_queue_ops */
 932         ret = vb2_streamon(&icd->vb2_vidq, i);
 933         if (!ret)
 934                 v4l2_subdev_call(sd, video, s_stream, 1);
 935
 936         return ret;
 937 }
 938
 939 static int soc_camera_streamoff(struct file *file, void *priv,
 940                                 enum v4l2_buf_type i)
 941 {
 942         struct soc_camera_device *icd = file->private_data;
 943         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
 944         int ret;
 945
 946         WARN_ON(priv != file->private_data);
 947
 948         if (i != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 949                 return -EINVAL;
 950
 951         if (icd->streamer != file)
 952                 return -EBUSY;
 953
 954         /*
 955          * This calls buf_release from host driver's videobuf2_queue_ops for all
 956          * remaining buffers. When the last buffer is freed, stop capture
 957          */
 958         ret = vb2_streamoff(&icd->vb2_vidq, i);
 959
 960         v4l2_subdev_call(sd, video, s_stream, 0);
 961
 962         return ret;
 963 }
 964
 965 static int soc_camera_g_selection(struct file *file, void *fh,
 966                                   struct v4l2_selection *s)
 967 {
 968         struct soc_camera_device *icd = file->private_data;
 969         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 970
 971         /* With a wrong type no need to try to fall back to cropping */
 972         if (s->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 973                 return -EINVAL;
 974
 975         return ici->ops->get_selection(icd, s);
 976 }
 977
 978 static int soc_camera_s_selection(struct file *file, void *fh,
 979                                   struct v4l2_selection *s)
 980 {
 981         struct soc_camera_device *icd = file->private_data;
 982         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
 983         int ret;
 984
 985         /* In all these cases cropping emulation will not help */
 986         if (s->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
 987             (s->target != V4L2_SEL_TGT_COMPOSE &&
 988              s->target != V4L2_SEL_TGT_CROP))
 989                 return -EINVAL;
 990
 991         if (s->target == V4L2_SEL_TGT_COMPOSE) {
 992                 /* No output size change during a running capture! */
 993                 if (vb2_is_streaming(&icd->vb2_vidq) &&
 994                     (icd->user_width != s->r.width ||
 995                      icd->user_height != s->r.height))
 996                         return -EBUSY;
 997
 998                 /*
 999                  * Only one user is allowed to change the output format, touch
1000                  * buffers, start / stop streaming, poll for data
1001                  */
1002                 if (icd->streamer && icd->streamer != file)
1003                         return -EBUSY;
1004         }
1005
1006         if (s->target == V4L2_SEL_TGT_CROP &&
1007             vb2_is_streaming(&icd->vb2_vidq) &&
1008             ici->ops->set_liveselection)
1009                 ret = ici->ops->set_liveselection(icd, s);
1010         else
1011                 ret = ici->ops->set_selection(icd, s);
1012         if (!ret &&
1013             s->target == V4L2_SEL_TGT_COMPOSE) {
1014                 icd->user_width = s->r.width;
1015                 icd->user_height = s->r.height;
1016                 if (!icd->streamer)
1017                         icd->streamer = file;
1018         }
1019
1020         return ret;
1021 }
1022
1023 static int soc_camera_g_parm(struct file *file, void *fh,
1024                              struct v4l2_streamparm *a)
1025 {
1026         struct soc_camera_device *icd = file->private_data;
1027         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
1028
1029         if (ici->ops->get_parm)
1030                 return ici->ops->get_parm(icd, a);
1031
1032         return -ENOIOCTLCMD;
1033 }
1034
1035 static int soc_camera_s_parm(struct file *file, void *fh,
1036                              struct v4l2_streamparm *a)
1037 {
1038         struct soc_camera_device *icd = file->private_data;
1039         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
1040
1041         if (ici->ops->set_parm)
1042                 return ici->ops->set_parm(icd, a);
1043
1044         return -ENOIOCTLCMD;
1045 }
1046
1047 static int soc_camera_probe(struct soc_camera_host *ici,
1048                             struct soc_camera_device *icd);
1049
1050 /* So far this function cannot fail */
1051 static void scan_add_host(struct soc_camera_host *ici)
1052 {
1053         struct soc_camera_device *icd;
1054
1055         mutex_lock(&list_lock);
1056
1057         list_for_each_entry(icd, &devices, list)
1058                 if (icd->iface == ici->nr) {
1059                         struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1060                         struct soc_camera_subdev_desc *ssdd = &sdesc->subdev_desc;
1061
1062                         /* The camera could have been already on, try to reset */
1063                         if (ssdd->reset)
1064                                 if (icd->control)
1065                                         ssdd->reset(icd->control);
1066
1067                         icd->parent = ici->v4l2_dev.dev;
1068
1069                         /* Ignore errors */
1070                         soc_camera_probe(ici, icd);
1071                 }
1072
1073         mutex_unlock(&list_lock);
1074 }
1075
1076 /*
1077  * It is invalid to call v4l2_clk_enable() after a successful probing
1078  * asynchronously outside of V4L2 operations, i.e. with .host_lock not held.
1079  */
1080 static int soc_camera_clk_enable(struct v4l2_clk *clk)
1081 {
1082         struct soc_camera_device *icd = clk->priv;
1083         struct soc_camera_host *ici;
1084
1085         if (!icd || !icd->parent)
1086                 return -ENODEV;
1087
1088         ici = to_soc_camera_host(icd->parent);
1089
1090         if (!try_module_get(ici->ops->owner))
1091                 return -ENODEV;
1092
1093         /*
1094          * If a different client is currently being probed, the host will tell
1095          * you to go
1096          */
1097         return soc_camera_clock_start(ici);
1098 }
1099
1100 static void soc_camera_clk_disable(struct v4l2_clk *clk)
1101 {
1102         struct soc_camera_device *icd = clk->priv;
1103         struct soc_camera_host *ici;
1104
1105         if (!icd || !icd->parent)
1106                 return;
1107
1108         ici = to_soc_camera_host(icd->parent);
1109
1110         soc_camera_clock_stop(ici);
1111
1112         module_put(ici->ops->owner);
1113 }
1114
1115 /*
1116  * Eventually, it would be more logical to make the respective host the clock
1117  * owner, but then we would have to copy this struct for each ici. Besides, it
1118  * would introduce the circular dependency problem, unless we port all client
1119  * drivers to release the clock, when not in use.
1120  */
1121 static const struct v4l2_clk_ops soc_camera_clk_ops = {
1122         .owner = THIS_MODULE,
1123         .enable = soc_camera_clk_enable,
1124         .disable = soc_camera_clk_disable,
1125 };
1126
1127 static int soc_camera_dyn_pdev(struct soc_camera_desc *sdesc,
1128                                struct soc_camera_async_client *sasc)
1129 {
1130         struct platform_device *pdev;
1131         int ret, i;
1132
1133         mutex_lock(&list_lock);
1134         i = find_first_zero_bit(device_map, MAP_MAX_NUM);
1135         if (i < MAP_MAX_NUM)
1136                 set_bit(i, device_map);
1137         mutex_unlock(&list_lock);
1138         if (i >= MAP_MAX_NUM)
1139                 return -ENOMEM;
1140
1141         pdev = platform_device_alloc("soc-camera-pdrv", i);
1142         if (!pdev)
1143                 return -ENOMEM;
1144
1145         ret = platform_device_add_data(pdev, sdesc, sizeof(*sdesc));
1146         if (ret < 0) {
1147                 platform_device_put(pdev);
1148                 return ret;
1149         }
1150
1151         sasc->pdev = pdev;
1152
1153         return 0;
1154 }
1155
1156 static struct soc_camera_device *soc_camera_add_pdev(struct soc_camera_async_client *sasc)
1157 {
1158         struct platform_device *pdev = sasc->pdev;
1159         int ret;
1160
1161         ret = platform_device_add(pdev);
1162         if (ret < 0 || !pdev->dev.driver)
1163                 return NULL;
1164
1165         return platform_get_drvdata(pdev);
1166 }
1167
1168 /* Locking: called with .host_lock held */
1169 static int soc_camera_probe_finish(struct soc_camera_device *icd)
1170 {
1171         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1172         struct v4l2_subdev_format fmt = {
1173                 .which = V4L2_SUBDEV_FORMAT_ACTIVE,
1174         };
1175         struct v4l2_mbus_framefmt *mf = &fmt.format;
1176         int ret;
1177
1178         sd->grp_id = soc_camera_grp_id(icd);
1179         v4l2_set_subdev_hostdata(sd, icd);
1180
1181         v4l2_subdev_call(sd, video, g_tvnorms, &icd->vdev->tvnorms);
1182
1183         ret = v4l2_ctrl_add_handler(&icd->ctrl_handler, sd->ctrl_handler, NULL);
1184         if (ret < 0)
1185                 return ret;
1186
1187         ret = soc_camera_add_device(icd);
1188         if (ret < 0) {
1189                 dev_err(icd->pdev, "Couldn't activate the camera: %d\n", ret);
1190                 return ret;
1191         }
1192
1193         /* At this point client .probe() should have run already */
1194         ret = soc_camera_init_user_formats(icd);
1195         if (ret < 0)
1196                 goto eusrfmt;
1197
1198         icd->field = V4L2_FIELD_ANY;
1199
1200         ret = soc_camera_video_start(icd);
1201         if (ret < 0)
1202                 goto evidstart;
1203
1204         /* Try to improve our guess of a reasonable window format */
1205         if (!v4l2_subdev_call(sd, pad, get_fmt, NULL, &fmt)) {
1206                 icd->user_width         = mf->width;
1207                 icd->user_height        = mf->height;
1208                 icd->colorspace         = mf->colorspace;
1209                 icd->field              = mf->field;
1210         }
1211         soc_camera_remove_device(icd);
1212
1213         return 0;
1214
1215 evidstart:
1216         soc_camera_free_user_formats(icd);
1217 eusrfmt:
1218         soc_camera_remove_device(icd);
1219
1220         return ret;
1221 }
1222
1223 #ifdef CONFIG_I2C_BOARDINFO
1224 static int soc_camera_i2c_init(struct soc_camera_device *icd,
1225                                struct soc_camera_desc *sdesc)
1226 {
1227         struct soc_camera_subdev_desc *ssdd;
1228         struct i2c_client *client;
1229         struct soc_camera_host *ici;
1230         struct soc_camera_host_desc *shd = &sdesc->host_desc;
1231         struct i2c_adapter *adap;
1232         struct v4l2_subdev *subdev;
1233         char clk_name[V4L2_CLK_NAME_SIZE];
1234         int ret;
1235
1236         /* First find out how we link the main client */
1237         if (icd->sasc) {
1238                 /* Async non-OF probing handled by the subdevice list */
1239                 return -EPROBE_DEFER;
1240         }
1241
1242         ici = to_soc_camera_host(icd->parent);
1243         adap = i2c_get_adapter(shd->i2c_adapter_id);
1244         if (!adap) {
1245                 dev_err(icd->pdev, "Cannot get I2C adapter #%d. No driver?\n",
1246                         shd->i2c_adapter_id);
1247                 return -ENODEV;
1248         }
1249
1250         ssdd = kmemdup(&sdesc->subdev_desc, sizeof(*ssdd), GFP_KERNEL);
1251         if (!ssdd) {
1252                 ret = -ENOMEM;
1253                 goto ealloc;
1254         }
1255         /*
1256          * In synchronous case we request regulators ourselves in
1257          * soc_camera_pdrv_probe(), make sure the subdevice driver doesn't try
1258          * to allocate them again.
1259          */
1260         ssdd->sd_pdata.num_regulators = 0;
1261         ssdd->sd_pdata.regulators = NULL;
1262         shd->board_info->platform_data = ssdd;
1263
1264         v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
1265                           shd->i2c_adapter_id, shd->board_info->addr);
1266
1267         icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, icd);
1268         if (IS_ERR(icd->clk)) {
1269                 ret = PTR_ERR(icd->clk);
1270                 goto eclkreg;
1271         }
1272
1273         subdev = v4l2_i2c_new_subdev_board(&ici->v4l2_dev, adap,
1274                                 shd->board_info, NULL);
1275         if (!subdev) {
1276                 ret = -ENODEV;
1277                 goto ei2cnd;
1278         }
1279
1280         client = v4l2_get_subdevdata(subdev);
1281
1282         /* Use to_i2c_client(dev) to recover the i2c client */
1283         icd->control = &client->dev;
1284
1285         return 0;
1286 ei2cnd:
1287         v4l2_clk_unregister(icd->clk);
1288         icd->clk = NULL;
1289 eclkreg:
1290         kfree(ssdd);
1291 ealloc:
1292         i2c_put_adapter(adap);
1293         return ret;
1294 }
1295
1296 static void soc_camera_i2c_free(struct soc_camera_device *icd)
1297 {
1298         struct i2c_client *client =
1299                 to_i2c_client(to_soc_camera_control(icd));
1300         struct i2c_adapter *adap;
1301         struct soc_camera_subdev_desc *ssdd;
1302
1303         icd->control = NULL;
1304         if (icd->sasc)
1305                 return;
1306
1307         adap = client->adapter;
1308         ssdd = client->dev.platform_data;
1309         v4l2_device_unregister_subdev(i2c_get_clientdata(client));
1310         i2c_unregister_device(client);
1311         i2c_put_adapter(adap);
1312         kfree(ssdd);
1313         v4l2_clk_unregister(icd->clk);
1314         icd->clk = NULL;
1315 }
1316
1317 /*
1318  * V4L2 asynchronous notifier callbacks. They are all called under a v4l2-async
1319  * internal global mutex, therefore cannot race against other asynchronous
1320  * events. Until notifier->complete() (soc_camera_async_complete()) is called,
1321  * the video device node is not registered and no V4L fops can occur. Unloading
1322  * of the host driver also calls a v4l2-async function, so also there we're
1323  * protected.
1324  */
1325 static int soc_camera_async_bound(struct v4l2_async_notifier *notifier,
1326                                   struct v4l2_subdev *sd,
1327                                   struct v4l2_async_subdev *asd)
1328 {
1329         struct soc_camera_async_client *sasc = container_of(notifier,
1330                                         struct soc_camera_async_client, notifier);
1331         struct soc_camera_device *icd = platform_get_drvdata(sasc->pdev);
1332
1333         if (asd == sasc->sensor && !WARN_ON(icd->control)) {
1334                 struct i2c_client *client = v4l2_get_subdevdata(sd);
1335
1336                 /*
1337                  * Only now we get subdevice-specific information like
1338                  * regulators, flags, callbacks, etc.
1339                  */
1340                 if (client) {
1341                         struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1342                         struct soc_camera_subdev_desc *ssdd =
1343                                 soc_camera_i2c_to_desc(client);
1344                         if (ssdd) {
1345                                 memcpy(&sdesc->subdev_desc, ssdd,
1346                                        sizeof(sdesc->subdev_desc));
1347                                 if (ssdd->reset)
1348                                         ssdd->reset(&client->dev);
1349                         }
1350
1351                         icd->control = &client->dev;
1352                 }
1353         }
1354
1355         return 0;
1356 }
1357
1358 static void soc_camera_async_unbind(struct v4l2_async_notifier *notifier,
1359                                     struct v4l2_subdev *sd,
1360                                     struct v4l2_async_subdev *asd)
1361 {
1362         struct soc_camera_async_client *sasc = container_of(notifier,
1363                                         struct soc_camera_async_client, notifier);
1364         struct soc_camera_device *icd = platform_get_drvdata(sasc->pdev);
1365
1366         icd->control = NULL;
1367
1368         if (icd->clk) {
1369                 v4l2_clk_unregister(icd->clk);
1370                 icd->clk = NULL;
1371         }
1372 }
1373
1374 static int soc_camera_async_complete(struct v4l2_async_notifier *notifier)
1375 {
1376         struct soc_camera_async_client *sasc = container_of(notifier,
1377                                         struct soc_camera_async_client, notifier);
1378         struct soc_camera_device *icd = platform_get_drvdata(sasc->pdev);
1379
1380         if (to_soc_camera_control(icd)) {
1381                 struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
1382                 int ret;
1383
1384                 mutex_lock(&list_lock);
1385                 ret = soc_camera_probe(ici, icd);
1386                 mutex_unlock(&list_lock);
1387                 if (ret < 0)
1388                         return ret;
1389         }
1390
1391         return 0;
1392 }
1393
1394 static int scan_async_group(struct soc_camera_host *ici,
1395                             struct v4l2_async_subdev **asd, unsigned int size)
1396 {
1397         struct soc_camera_async_subdev *sasd;
1398         struct soc_camera_async_client *sasc;
1399         struct soc_camera_device *icd;
1400         struct soc_camera_desc sdesc = {.host_desc.bus_id = ici->nr,};
1401         char clk_name[V4L2_CLK_NAME_SIZE];
1402         unsigned int i;
1403         int ret;
1404
1405         /* First look for a sensor */
1406         for (i = 0; i < size; i++) {
1407                 sasd = container_of(asd[i], struct soc_camera_async_subdev, asd);
1408                 if (sasd->role == SOCAM_SUBDEV_DATA_SOURCE)
1409                         break;
1410         }
1411
1412         if (i >= size || asd[i]->match_type != V4L2_ASYNC_MATCH_I2C) {
1413                 /* All useless */
1414                 dev_err(ici->v4l2_dev.dev, "No I2C data source found!\n");
1415                 return -ENODEV;
1416         }
1417
1418         /* Or shall this be managed by the soc-camera device? */
1419         sasc = devm_kzalloc(ici->v4l2_dev.dev, sizeof(*sasc), GFP_KERNEL);
1420         if (!sasc)
1421                 return -ENOMEM;
1422
1423         /* HACK: just need a != NULL */
1424         sdesc.host_desc.board_info = ERR_PTR(-ENODATA);
1425
1426         ret = soc_camera_dyn_pdev(&sdesc, sasc);
1427         if (ret < 0)
1428                 goto eallocpdev;
1429
1430         sasc->sensor = &sasd->asd;
1431
1432         icd = soc_camera_add_pdev(sasc);
1433         if (!icd) {
1434                 ret = -ENOMEM;
1435                 goto eaddpdev;
1436         }
1437
1438         sasc->notifier.subdevs = asd;
1439         sasc->notifier.num_subdevs = size;
1440         sasc->notifier.bound = soc_camera_async_bound;
1441         sasc->notifier.unbind = soc_camera_async_unbind;
1442         sasc->notifier.complete = soc_camera_async_complete;
1443
1444         icd->sasc = sasc;
1445         icd->parent = ici->v4l2_dev.dev;
1446
1447         v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
1448                           sasd->asd.match.i2c.adapter_id,
1449                           sasd->asd.match.i2c.address);
1450
1451         icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, icd);
1452         if (IS_ERR(icd->clk)) {
1453                 ret = PTR_ERR(icd->clk);
1454                 goto eclkreg;
1455         }
1456
1457         ret = v4l2_async_notifier_register(&ici->v4l2_dev, &sasc->notifier);
1458         if (!ret)
1459                 return 0;
1460
1461         v4l2_clk_unregister(icd->clk);
1462 eclkreg:
1463         icd->clk = NULL;
1464         platform_device_del(sasc->pdev);
1465 eaddpdev:
1466         platform_device_put(sasc->pdev);
1467 eallocpdev:
1468         devm_kfree(ici->v4l2_dev.dev, sasc);
1469         dev_err(ici->v4l2_dev.dev, "group probe failed: %d\n", ret);
1470
1471         return ret;
1472 }
1473
1474 static void scan_async_host(struct soc_camera_host *ici)
1475 {
1476         struct v4l2_async_subdev **asd;
1477         int j;
1478
1479         for (j = 0, asd = ici->asd; ici->asd_sizes[j]; j++) {
1480                 scan_async_group(ici, asd, ici->asd_sizes[j]);
1481                 asd += ici->asd_sizes[j];
1482         }
1483 }
1484 #else
1485 #define soc_camera_i2c_init(icd, sdesc) (-ENODEV)
1486 #define soc_camera_i2c_free(icd)        do {} while (0)
1487 #define scan_async_host(ici)            do {} while (0)
1488 #endif
1489
1490 #ifdef CONFIG_OF
1491
1492 struct soc_of_info {
1493         struct soc_camera_async_subdev  sasd;
1494         struct soc_camera_async_client  sasc;
1495         struct v4l2_async_subdev        *subdev;
1496 };
1497
1498 static int soc_of_bind(struct soc_camera_host *ici,
1499                        struct device_node *ep,
1500                        struct device_node *remote)
1501 {
1502         struct soc_camera_device *icd;
1503         struct soc_camera_desc sdesc = {.host_desc.bus_id = ici->nr,};
1504         struct soc_camera_async_client *sasc;
1505         struct soc_of_info *info;
1506         struct i2c_client *client;
1507         char clk_name[V4L2_CLK_NAME_SIZE];
1508         int ret;
1509
1510         /* allocate a new subdev and add match info to it */
1511         info = devm_kzalloc(ici->v4l2_dev.dev, sizeof(struct soc_of_info),
1512                             GFP_KERNEL);
1513         if (!info)
1514                 return -ENOMEM;
1515
1516         info->sasd.asd.match.fwnode.fwnode = of_fwnode_handle(remote);
1517         info->sasd.asd.match_type = V4L2_ASYNC_MATCH_FWNODE;
1518         info->subdev = &info->sasd.asd;
1519
1520         /* Or shall this be managed by the soc-camera device? */
1521         sasc = &info->sasc;
1522
1523         /* HACK: just need a != NULL */
1524         sdesc.host_desc.board_info = ERR_PTR(-ENODATA);
1525
1526         ret = soc_camera_dyn_pdev(&sdesc, sasc);
1527         if (ret < 0)
1528                 goto eallocpdev;
1529
1530         sasc->sensor = &info->sasd.asd;
1531
1532         icd = soc_camera_add_pdev(sasc);
1533         if (!icd) {
1534                 ret = -ENOMEM;
1535                 goto eaddpdev;
1536         }
1537
1538         sasc->notifier.subdevs = &info->subdev;
1539         sasc->notifier.num_subdevs = 1;
1540         sasc->notifier.bound = soc_camera_async_bound;
1541         sasc->notifier.unbind = soc_camera_async_unbind;
1542         sasc->notifier.complete = soc_camera_async_complete;
1543
1544         icd->sasc = sasc;
1545         icd->parent = ici->v4l2_dev.dev;
1546
1547         client = of_find_i2c_device_by_node(remote);
1548
1549         if (client)
1550                 v4l2_clk_name_i2c(clk_name, sizeof(clk_name),
1551                                   client->adapter->nr, client->addr);
1552         else
1553                 v4l2_clk_name_of(clk_name, sizeof(clk_name), remote);
1554
1555         icd->clk = v4l2_clk_register(&soc_camera_clk_ops, clk_name, icd);
1556         if (IS_ERR(icd->clk)) {
1557                 ret = PTR_ERR(icd->clk);
1558                 goto eclkreg;
1559         }
1560
1561         ret = v4l2_async_notifier_register(&ici->v4l2_dev, &sasc->notifier);
1562         if (!ret)
1563                 return 0;
1564
1565         v4l2_clk_unregister(icd->clk);
1566 eclkreg:
1567         icd->clk = NULL;
1568         platform_device_del(sasc->pdev);
1569 eaddpdev:
1570         platform_device_put(sasc->pdev);
1571 eallocpdev:
1572         devm_kfree(ici->v4l2_dev.dev, info);
1573         dev_err(ici->v4l2_dev.dev, "group probe failed: %d\n", ret);
1574
1575         return ret;
1576 }
1577
1578 static void scan_of_host(struct soc_camera_host *ici)
1579 {
1580         struct device *dev = ici->v4l2_dev.dev;
1581         struct device_node *np = dev->of_node;
1582         struct device_node *epn = NULL, *ren;
1583         unsigned int i;
1584
1585         for (i = 0; ; i++) {
1586                 epn = of_graph_get_next_endpoint(np, epn);
1587                 if (!epn)
1588                         break;
1589
1590                 ren = of_graph_get_remote_port(epn);
1591                 if (!ren) {
1592                         dev_notice(dev, "no remote for %pOF\n", epn);
1593                         continue;
1594                 }
1595
1596                 /* so we now have a remote node to connect */
1597                 if (!i)
1598                         soc_of_bind(ici, epn, ren->parent);
1599
1600                 of_node_put(ren);
1601
1602                 if (i) {
1603                         dev_err(dev, "multiple subdevices aren't supported yet!\n");
1604                         break;
1605                 }
1606         }
1607
1608         of_node_put(epn);
1609 }
1610
1611 #else
1612 static inline void scan_of_host(struct soc_camera_host *ici) { }
1613 #endif
1614
1615 /* Called during host-driver probe */
1616 static int soc_camera_probe(struct soc_camera_host *ici,
1617                             struct soc_camera_device *icd)
1618 {
1619         struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1620         struct soc_camera_host_desc *shd = &sdesc->host_desc;
1621         struct device *control = NULL;
1622         int ret;
1623
1624         dev_info(icd->pdev, "Probing %s\n", dev_name(icd->pdev));
1625
1626         /*
1627          * Currently the subdev with the largest number of controls (13) is
1628          * ov6550. So let's pick 16 as a hint for the control handler. Note
1629          * that this is a hint only: too large and you waste some memory, too
1630          * small and there is a (very) small performance hit when looking up
1631          * controls in the internal hash.
1632          */
1633         ret = v4l2_ctrl_handler_init(&icd->ctrl_handler, 16);
1634         if (ret < 0)
1635                 return ret;
1636
1637         /* Must have icd->vdev before registering the device */
1638         ret = video_dev_create(icd);
1639         if (ret < 0)
1640                 goto evdc;
1641
1642         /*
1643          * ..._video_start() will create a device node, video_register_device()
1644          * itself is protected against concurrent open() calls, but we also have
1645          * to protect our data also during client probing.
1646          */
1647
1648         /* Non-i2c cameras, e.g., soc_camera_platform, have no board_info */
1649         if (shd->board_info) {
1650                 ret = soc_camera_i2c_init(icd, sdesc);
1651                 if (ret < 0 && ret != -EPROBE_DEFER)
1652                         goto eadd;
1653         } else if (!shd->add_device || !shd->del_device) {
1654                 ret = -EINVAL;
1655                 goto eadd;
1656         } else {
1657                 ret = soc_camera_clock_start(ici);
1658                 if (ret < 0)
1659                         goto eadd;
1660
1661                 if (shd->module_name)
1662                         ret = request_module(shd->module_name);
1663
1664                 ret = shd->add_device(icd);
1665                 if (ret < 0)
1666                         goto eadddev;
1667
1668                 /*
1669                  * FIXME: this is racy, have to use driver-binding notification,
1670                  * when it is available
1671                  */
1672                 control = to_soc_camera_control(icd);
1673                 if (!control || !control->driver || !dev_get_drvdata(control) ||
1674                     !try_module_get(control->driver->owner)) {
1675                         shd->del_device(icd);
1676                         ret = -ENODEV;
1677                         goto enodrv;
1678                 }
1679         }
1680
1681         mutex_lock(&ici->host_lock);
1682         ret = soc_camera_probe_finish(icd);
1683         mutex_unlock(&ici->host_lock);
1684         if (ret < 0)
1685                 goto efinish;
1686
1687         return 0;
1688
1689 efinish:
1690         if (shd->board_info) {
1691                 soc_camera_i2c_free(icd);
1692         } else {
1693                 shd->del_device(icd);
1694                 module_put(control->driver->owner);
1695 enodrv:
1696 eadddev:
1697                 soc_camera_clock_stop(ici);
1698         }
1699 eadd:
1700         if (icd->vdev) {
1701                 video_device_release(icd->vdev);
1702                 icd->vdev = NULL;
1703         }
1704 evdc:
1705         v4l2_ctrl_handler_free(&icd->ctrl_handler);
1706         return ret;
1707 }
1708
1709 /*
1710  * This is called on device_unregister, which only means we have to disconnect
1711  * from the host, but not remove ourselves from the device list. With
1712  * asynchronous client probing this can also be called without
1713  * soc_camera_probe_finish() having run. Careful with clean up.
1714  */
1715 static int soc_camera_remove(struct soc_camera_device *icd)
1716 {
1717         struct soc_camera_desc *sdesc = to_soc_camera_desc(icd);
1718         struct video_device *vdev = icd->vdev;
1719
1720         v4l2_ctrl_handler_free(&icd->ctrl_handler);
1721         if (vdev) {
1722                 video_unregister_device(vdev);
1723                 icd->vdev = NULL;
1724         }
1725
1726         if (sdesc->host_desc.board_info) {
1727                 soc_camera_i2c_free(icd);
1728         } else {
1729                 struct device *dev = to_soc_camera_control(icd);
1730                 struct device_driver *drv = dev ? dev->driver : NULL;
1731                 if (drv) {
1732                         sdesc->host_desc.del_device(icd);
1733                         module_put(drv->owner);
1734                 }
1735         }
1736
1737         if (icd->num_user_formats)
1738                 soc_camera_free_user_formats(icd);
1739
1740         if (icd->clk) {
1741                 /* For the synchronous case */
1742                 v4l2_clk_unregister(icd->clk);
1743                 icd->clk = NULL;
1744         }
1745
1746         if (icd->sasc)
1747                 platform_device_unregister(icd->sasc->pdev);
1748
1749         return 0;
1750 }
1751
1752 static int default_g_selection(struct soc_camera_device *icd,
1753                                struct v4l2_selection *sel)
1754 {
1755         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1756         struct v4l2_subdev_selection sdsel = {
1757                 .which = V4L2_SUBDEV_FORMAT_ACTIVE,
1758                 .target = sel->target,
1759         };
1760         int ret;
1761
1762         ret = v4l2_subdev_call(sd, pad, get_selection, NULL, &sdsel);
1763         if (ret)
1764                 return ret;
1765         sel->r = sdsel.r;
1766         return 0;
1767 }
1768
1769 static int default_s_selection(struct soc_camera_device *icd,
1770                                struct v4l2_selection *sel)
1771 {
1772         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1773         struct v4l2_subdev_selection sdsel = {
1774                 .which = V4L2_SUBDEV_FORMAT_ACTIVE,
1775                 .target = sel->target,
1776                 .flags = sel->flags,
1777                 .r = sel->r,
1778         };
1779         int ret;
1780
1781         ret = v4l2_subdev_call(sd, pad, set_selection, NULL, &sdsel);
1782         if (ret)
1783                 return ret;
1784         sel->r = sdsel.r;
1785         return 0;
1786 }
1787
1788 static int default_g_parm(struct soc_camera_device *icd,
1789                           struct v4l2_streamparm *parm)
1790 {
1791         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1792         return v4l2_subdev_call(sd, video, g_parm, parm);
1793 }
1794
1795 static int default_s_parm(struct soc_camera_device *icd,
1796                           struct v4l2_streamparm *parm)
1797 {
1798         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1799         return v4l2_subdev_call(sd, video, s_parm, parm);
1800 }
1801
1802 static int default_enum_framesizes(struct soc_camera_device *icd,
1803                                    struct v4l2_frmsizeenum *fsize)
1804 {
1805         int ret;
1806         struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
1807         const struct soc_camera_format_xlate *xlate;
1808         struct v4l2_subdev_frame_size_enum fse = {
1809                 .index = fsize->index,
1810                 .which = V4L2_SUBDEV_FORMAT_ACTIVE,
1811         };
1812
1813         xlate = soc_camera_xlate_by_fourcc(icd, fsize->pixel_format);
1814         if (!xlate)
1815                 return -EINVAL;
1816         fse.code = xlate->code;
1817
1818         ret = v4l2_subdev_call(sd, pad, enum_frame_size, NULL, &fse);
1819         if (ret < 0)
1820                 return ret;
1821
1822         if (fse.min_width == fse.max_width &&
1823             fse.min_height == fse.max_height) {
1824                 fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
1825                 fsize->discrete.width = fse.min_width;
1826                 fsize->discrete.height = fse.min_height;
1827                 return 0;
1828         }
1829         fsize->type = V4L2_FRMSIZE_TYPE_CONTINUOUS;
1830         fsize->stepwise.min_width = fse.min_width;
1831         fsize->stepwise.max_width = fse.max_width;
1832         fsize->stepwise.min_height = fse.min_height;
1833         fsize->stepwise.max_height = fse.max_height;
1834         fsize->stepwise.step_width = 1;
1835         fsize->stepwise.step_height = 1;
1836         return 0;
1837 }
1838
1839 int soc_camera_host_register(struct soc_camera_host *ici)
1840 {
1841         struct soc_camera_host *ix;
1842         int ret;
1843
1844         if (!ici || !ici->ops ||
1845             !ici->ops->try_fmt ||
1846             !ici->ops->set_fmt ||
1847             !ici->ops->set_bus_param ||
1848             !ici->ops->querycap ||
1849             !ici->ops->init_videobuf2 ||
1850             !ici->ops->poll ||
1851             !ici->v4l2_dev.dev)
1852                 return -EINVAL;
1853
1854         if (!ici->ops->set_selection)
1855                 ici->ops->set_selection = default_s_selection;
1856         if (!ici->ops->get_selection)
1857                 ici->ops->get_selection = default_g_selection;
1858         if (!ici->ops->set_parm)
1859                 ici->ops->set_parm = default_s_parm;
1860         if (!ici->ops->get_parm)
1861                 ici->ops->get_parm = default_g_parm;
1862         if (!ici->ops->enum_framesizes)
1863                 ici->ops->enum_framesizes = default_enum_framesizes;
1864
1865         mutex_lock(&list_lock);
1866         list_for_each_entry(ix, &hosts, list) {
1867                 if (ix->nr == ici->nr) {
1868                         ret = -EBUSY;
1869                         goto edevreg;
1870                 }
1871         }
1872
1873         ret = v4l2_device_register(ici->v4l2_dev.dev, &ici->v4l2_dev);
1874         if (ret < 0)
1875                 goto edevreg;
1876
1877         list_add_tail(&ici->list, &hosts);
1878         mutex_unlock(&list_lock);
1879
1880         mutex_init(&ici->host_lock);
1881         mutex_init(&ici->clk_lock);
1882
1883         if (ici->v4l2_dev.dev->of_node)
1884                 scan_of_host(ici);
1885         else if (ici->asd_sizes)
1886                 /*
1887                  * No OF, host with a list of subdevices. Don't try to mix
1888                  * modes by initialising some groups statically and some
1889                  * dynamically!
1890                  */
1891                 scan_async_host(ici);
1892         else
1893                 /* Legacy: static platform devices from board data */
1894                 scan_add_host(ici);
1895
1896         return 0;
1897
1898 edevreg:
1899         mutex_unlock(&list_lock);
1900         return ret;
1901 }
1902 EXPORT_SYMBOL(soc_camera_host_register);
1903
1904 /* Unregister all clients! */
1905 void soc_camera_host_unregister(struct soc_camera_host *ici)
1906 {
1907         struct soc_camera_device *icd, *tmp;
1908         struct soc_camera_async_client *sasc;
1909         LIST_HEAD(notifiers);
1910
1911         mutex_lock(&list_lock);
1912         list_del(&ici->list);
1913         list_for_each_entry(icd, &devices, list)
1914                 if (icd->iface == ici->nr && icd->sasc) {
1915                         /* as long as we hold the device, sasc won't be freed */
1916                         get_device(icd->pdev);
1917                         list_add(&icd->sasc->list, &notifiers);
1918                 }
1919         mutex_unlock(&list_lock);
1920
1921         list_for_each_entry(sasc, &notifiers, list) {
1922                 /* Must call unlocked to avoid AB-BA dead-lock */
1923                 v4l2_async_notifier_unregister(&sasc->notifier);
1924                 put_device(&sasc->pdev->dev);
1925         }
1926
1927         mutex_lock(&list_lock);
1928
1929         list_for_each_entry_safe(icd, tmp, &devices, list)
1930                 if (icd->iface == ici->nr)
1931                         soc_camera_remove(icd);
1932
1933         mutex_unlock(&list_lock);
1934
1935         v4l2_device_unregister(&ici->v4l2_dev);
1936 }
1937 EXPORT_SYMBOL(soc_camera_host_unregister);
1938
1939 /* Image capture device */
1940 static int soc_camera_device_register(struct soc_camera_device *icd)
1941 {
1942         struct soc_camera_device *ix;
1943         int num = -1, i;
1944
1945         mutex_lock(&list_lock);
1946         for (i = 0; i < 256 && num < 0; i++) {
1947                 num = i;
1948                 /* Check if this index is available on this interface */
1949                 list_for_each_entry(ix, &devices, list) {
1950                         if (ix->iface == icd->iface && ix->devnum == i) {
1951                                 num = -1;
1952                                 break;
1953                         }
1954                 }
1955         }
1956
1957         if (num < 0) {
1958                 /*
1959                  * ok, we have 256 cameras on this host...
1960                  * man, stay reasonable...
1961                  */
1962                 mutex_unlock(&list_lock);
1963                 return -ENOMEM;
1964         }
1965
1966         icd->devnum             = num;
1967         icd->use_count          = 0;
1968         icd->host_priv          = NULL;
1969
1970         /*
1971          * Dynamically allocated devices set the bit earlier, but it doesn't hurt setting
1972          * it again
1973          */
1974         i = to_platform_device(icd->pdev)->id;
1975         if (i < 0)
1976                 /* One static (legacy) soc-camera platform device */
1977                 i = 0;
1978         if (i >= MAP_MAX_NUM) {
1979                 mutex_unlock(&list_lock);
1980                 return -EBUSY;
1981         }
1982         set_bit(i, device_map);
1983         list_add_tail(&icd->list, &devices);
1984         mutex_unlock(&list_lock);
1985
1986         return 0;
1987 }
1988
1989 static const struct v4l2_ioctl_ops soc_camera_ioctl_ops = {
1990         .vidioc_querycap         = soc_camera_querycap,
1991         .vidioc_try_fmt_vid_cap  = soc_camera_try_fmt_vid_cap,
1992         .vidioc_g_fmt_vid_cap    = soc_camera_g_fmt_vid_cap,
1993         .vidioc_s_fmt_vid_cap    = soc_camera_s_fmt_vid_cap,
1994         .vidioc_enum_fmt_vid_cap = soc_camera_enum_fmt_vid_cap,
1995         .vidioc_enum_input       = soc_camera_enum_input,
1996         .vidioc_g_input          = soc_camera_g_input,
1997         .vidioc_s_input          = soc_camera_s_input,
1998         .vidioc_s_std            = soc_camera_s_std,
1999         .vidioc_g_std            = soc_camera_g_std,
2000         .vidioc_enum_framesizes  = soc_camera_enum_framesizes,
2001         .vidioc_reqbufs          = soc_camera_reqbufs,
2002         .vidioc_querybuf         = soc_camera_querybuf,
2003         .vidioc_qbuf             = soc_camera_qbuf,
2004         .vidioc_dqbuf            = soc_camera_dqbuf,
2005         .vidioc_create_bufs      = soc_camera_create_bufs,
2006         .vidioc_prepare_buf      = soc_camera_prepare_buf,
2007         .vidioc_expbuf           = soc_camera_expbuf,
2008         .vidioc_streamon         = soc_camera_streamon,
2009         .vidioc_streamoff        = soc_camera_streamoff,
2010         .vidioc_g_selection      = soc_camera_g_selection,
2011         .vidioc_s_selection      = soc_camera_s_selection,
2012         .vidioc_g_parm           = soc_camera_g_parm,
2013         .vidioc_s_parm           = soc_camera_s_parm,
2014 };
2015
2016 static int video_dev_create(struct soc_camera_device *icd)
2017 {
2018         struct soc_camera_host *ici = to_soc_camera_host(icd->parent);
2019         struct video_device *vdev = video_device_alloc();
2020
2021         if (!vdev)
2022                 return -ENOMEM;
2023
2024         strlcpy(vdev->name, ici->drv_name, sizeof(vdev->name));
2025
2026         vdev->v4l2_dev          = &ici->v4l2_dev;
2027         vdev->fops              = &soc_camera_fops;
2028         vdev->ioctl_ops         = &soc_camera_ioctl_ops;
2029         vdev->release           = video_device_release;
2030         vdev->ctrl_handler      = &icd->ctrl_handler;
2031         vdev->lock              = &ici->host_lock;
2032
2033         icd->vdev = vdev;
2034
2035         return 0;
2036 }
2037
2038 /*
2039  * Called from soc_camera_probe() above with .host_lock held
2040  */
2041 static int soc_camera_video_start(struct soc_camera_device *icd)
2042 {
2043         const struct device_type *type = icd->vdev->dev.type;
2044         int ret;
2045
2046         if (!icd->parent)
2047                 return -ENODEV;
2048
2049         video_set_drvdata(icd->vdev, icd);
2050         if (icd->vdev->tvnorms == 0) {
2051                 /* disable the STD API if there are no tvnorms defined */
2052                 v4l2_disable_ioctl(icd->vdev, VIDIOC_G_STD);
2053                 v4l2_disable_ioctl(icd->vdev, VIDIOC_S_STD);
2054                 v4l2_disable_ioctl(icd->vdev, VIDIOC_ENUMSTD);
2055         }
2056         ret = video_register_device(icd->vdev, VFL_TYPE_GRABBER, -1);
2057         if (ret < 0) {
2058                 dev_err(icd->pdev, "video_register_device failed: %d\n", ret);
2059                 return ret;
2060         }
2061
2062         /* Restore device type, possibly set by the subdevice driver */
2063         icd->vdev->dev.type = type;
2064
2065         return 0;
2066 }
2067
2068 static int soc_camera_pdrv_probe(struct platform_device *pdev)
2069 {
2070         struct soc_camera_desc *sdesc = pdev->dev.platform_data;
2071         struct soc_camera_subdev_desc *ssdd = &sdesc->subdev_desc;
2072         struct soc_camera_device *icd;
2073         int ret;
2074
2075         if (!sdesc)
2076                 return -EINVAL;
2077
2078         icd = devm_kzalloc(&pdev->dev, sizeof(*icd), GFP_KERNEL);
2079         if (!icd)
2080                 return -ENOMEM;
2081
2082         /*
2083          * In the asynchronous case ssdd->num_regulators == 0 yet, so, the below
2084          * regulator allocation is a dummy. They are actually requested by the
2085          * subdevice driver, using soc_camera_power_init(). Also note, that in
2086          * that case regulators are attached to the I2C device and not to the
2087          * camera platform device.
2088          */
2089         ret = devm_regulator_bulk_get(&pdev->dev, ssdd->sd_pdata.num_regulators,
2090                                       ssdd->sd_pdata.regulators);
2091         if (ret < 0)
2092                 return ret;
2093
2094         icd->iface = sdesc->host_desc.bus_id;
2095         icd->sdesc = sdesc;
2096         icd->pdev = &pdev->dev;
2097         platform_set_drvdata(pdev, icd);
2098
2099         icd->user_width         = DEFAULT_WIDTH;
2100         icd->user_height        = DEFAULT_HEIGHT;
2101
2102         return soc_camera_device_register(icd);
2103 }
2104
2105 /*
2106  * Only called on rmmod for each platform device, since they are not
2107  * hot-pluggable. Now we know, that all our users - hosts and devices have
2108  * been unloaded already
2109  */
2110 static int soc_camera_pdrv_remove(struct platform_device *pdev)
2111 {
2112         struct soc_camera_device *icd = platform_get_drvdata(pdev);
2113         int i;
2114
2115         if (!icd)
2116                 return -EINVAL;
2117
2118         i = pdev->id;
2119         if (i < 0)
2120                 i = 0;
2121
2122         /*
2123          * In synchronous mode with static platform devices this is called in a
2124          * loop from drivers/base/dd.c::driver_detach(), no parallel execution,
2125          * no need to lock. In asynchronous case the caller -
2126          * soc_camera_host_unregister() - already holds the lock
2127          */
2128         if (test_bit(i, device_map)) {
2129                 clear_bit(i, device_map);
2130                 list_del(&icd->list);
2131         }
2132
2133         return 0;
2134 }
2135
2136 static struct platform_driver __refdata soc_camera_pdrv = {
2137         .probe = soc_camera_pdrv_probe,
2138         .remove  = soc_camera_pdrv_remove,
2139         .driver  = {
2140                 .name   = "soc-camera-pdrv",
2141         },
2142 };
2143
2144 module_platform_driver(soc_camera_pdrv);
2145
2146 MODULE_DESCRIPTION("Image capture bus driver");
2147 MODULE_AUTHOR("Guennadi Liakhovetski <kernel@pengutronix.de>");
2148 MODULE_LICENSE("GPL");
2149 MODULE_ALIAS("platform:soc-camera-pdrv");