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