2 * camera image capture (abstract) bus driver
4 * Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
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.
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.
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/mutex.h>
25 #include <linux/module.h>
26 #include <linux/platform_device.h>
27 #include <linux/vmalloc.h>
29 #include <media/soc_camera.h>
30 #include <media/v4l2-common.h>
31 #include <media/v4l2-ioctl.h>
32 #include <media/v4l2-dev.h>
33 #include <media/videobuf-core.h>
35 /* Default to VGA resolution */
36 #define DEFAULT_WIDTH 640
37 #define DEFAULT_HEIGHT 480
39 static LIST_HEAD(hosts);
40 static LIST_HEAD(devices);
41 static DEFINE_MUTEX(list_lock); /* Protects the list of hosts */
43 const struct soc_camera_data_format *soc_camera_format_by_fourcc(
44 struct soc_camera_device *icd, unsigned int fourcc)
48 for (i = 0; i < icd->num_formats; i++)
49 if (icd->formats[i].fourcc == fourcc)
50 return icd->formats + i;
53 EXPORT_SYMBOL(soc_camera_format_by_fourcc);
55 const struct soc_camera_format_xlate *soc_camera_xlate_by_fourcc(
56 struct soc_camera_device *icd, unsigned int fourcc)
60 for (i = 0; i < icd->num_user_formats; i++)
61 if (icd->user_formats[i].host_fmt->fourcc == fourcc)
62 return icd->user_formats + i;
65 EXPORT_SYMBOL(soc_camera_xlate_by_fourcc);
68 * soc_camera_apply_sensor_flags() - apply platform SOCAM_SENSOR_INVERT_* flags
69 * @icl: camera platform parameters
70 * @flags: flags to be inverted according to platform configuration
71 * @return: resulting flags
73 unsigned long soc_camera_apply_sensor_flags(struct soc_camera_link *icl,
78 /* If only one of the two polarities is supported, switch to the opposite */
79 if (icl->flags & SOCAM_SENSOR_INVERT_HSYNC) {
80 f = flags & (SOCAM_HSYNC_ACTIVE_HIGH | SOCAM_HSYNC_ACTIVE_LOW);
81 if (f == SOCAM_HSYNC_ACTIVE_HIGH || f == SOCAM_HSYNC_ACTIVE_LOW)
82 flags ^= SOCAM_HSYNC_ACTIVE_HIGH | SOCAM_HSYNC_ACTIVE_LOW;
85 if (icl->flags & SOCAM_SENSOR_INVERT_VSYNC) {
86 f = flags & (SOCAM_VSYNC_ACTIVE_HIGH | SOCAM_VSYNC_ACTIVE_LOW);
87 if (f == SOCAM_VSYNC_ACTIVE_HIGH || f == SOCAM_VSYNC_ACTIVE_LOW)
88 flags ^= SOCAM_VSYNC_ACTIVE_HIGH | SOCAM_VSYNC_ACTIVE_LOW;
91 if (icl->flags & SOCAM_SENSOR_INVERT_PCLK) {
92 f = flags & (SOCAM_PCLK_SAMPLE_RISING | SOCAM_PCLK_SAMPLE_FALLING);
93 if (f == SOCAM_PCLK_SAMPLE_RISING || f == SOCAM_PCLK_SAMPLE_FALLING)
94 flags ^= SOCAM_PCLK_SAMPLE_RISING | SOCAM_PCLK_SAMPLE_FALLING;
99 EXPORT_SYMBOL(soc_camera_apply_sensor_flags);
101 static int soc_camera_try_fmt_vid_cap(struct file *file, void *priv,
102 struct v4l2_format *f)
104 struct soc_camera_file *icf = file->private_data;
105 struct soc_camera_device *icd = icf->icd;
106 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
108 WARN_ON(priv != file->private_data);
110 /* limit format to hardware capabilities */
111 return ici->ops->try_fmt(icd, f);
114 static int soc_camera_enum_input(struct file *file, void *priv,
115 struct v4l2_input *inp)
117 struct soc_camera_file *icf = file->private_data;
118 struct soc_camera_device *icd = icf->icd;
124 if (icd->ops->enum_input)
125 ret = icd->ops->enum_input(icd, inp);
127 /* default is camera */
128 inp->type = V4L2_INPUT_TYPE_CAMERA;
129 inp->std = V4L2_STD_UNKNOWN;
130 strcpy(inp->name, "Camera");
136 static int soc_camera_g_input(struct file *file, void *priv, unsigned int *i)
143 static int soc_camera_s_input(struct file *file, void *priv, unsigned int i)
151 static int soc_camera_s_std(struct file *file, void *priv, v4l2_std_id *a)
153 struct soc_camera_file *icf = file->private_data;
154 struct soc_camera_device *icd = icf->icd;
155 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
157 return v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, core, s_std, *a);
160 static int soc_camera_reqbufs(struct file *file, void *priv,
161 struct v4l2_requestbuffers *p)
164 struct soc_camera_file *icf = file->private_data;
165 struct soc_camera_device *icd = icf->icd;
166 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
168 WARN_ON(priv != file->private_data);
170 ret = videobuf_reqbufs(&icf->vb_vidq, p);
174 return ici->ops->reqbufs(icf, p);
177 static int soc_camera_querybuf(struct file *file, void *priv,
178 struct v4l2_buffer *p)
180 struct soc_camera_file *icf = file->private_data;
182 WARN_ON(priv != file->private_data);
184 return videobuf_querybuf(&icf->vb_vidq, p);
187 static int soc_camera_qbuf(struct file *file, void *priv,
188 struct v4l2_buffer *p)
190 struct soc_camera_file *icf = file->private_data;
192 WARN_ON(priv != file->private_data);
194 return videobuf_qbuf(&icf->vb_vidq, p);
197 static int soc_camera_dqbuf(struct file *file, void *priv,
198 struct v4l2_buffer *p)
200 struct soc_camera_file *icf = file->private_data;
202 WARN_ON(priv != file->private_data);
204 return videobuf_dqbuf(&icf->vb_vidq, p, file->f_flags & O_NONBLOCK);
207 /* Always entered with .video_lock held */
208 static int soc_camera_init_user_formats(struct soc_camera_device *icd)
210 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
211 int i, fmts = 0, ret;
213 if (!ici->ops->get_formats)
215 * Fallback mode - the host will have to serve all
216 * sensor-provided formats one-to-one to the user
218 fmts = icd->num_formats;
221 * First pass - only count formats this host-sensor
222 * configuration can provide
224 for (i = 0; i < icd->num_formats; i++) {
225 ret = ici->ops->get_formats(icd, i, NULL);
235 vmalloc(fmts * sizeof(struct soc_camera_format_xlate));
236 if (!icd->user_formats)
239 icd->num_user_formats = fmts;
241 dev_dbg(&icd->dev, "Found %d supported formats.\n", fmts);
243 /* Second pass - actually fill data formats */
245 for (i = 0; i < icd->num_formats; i++)
246 if (!ici->ops->get_formats) {
247 icd->user_formats[i].host_fmt = icd->formats + i;
248 icd->user_formats[i].cam_fmt = icd->formats + i;
249 icd->user_formats[i].buswidth = icd->formats[i].depth;
251 ret = ici->ops->get_formats(icd, i,
252 &icd->user_formats[fmts]);
258 icd->current_fmt = icd->user_formats[0].host_fmt;
263 icd->num_user_formats = 0;
264 vfree(icd->user_formats);
268 /* Always entered with .video_lock held */
269 static void soc_camera_free_user_formats(struct soc_camera_device *icd)
271 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
273 if (ici->ops->put_formats)
274 ici->ops->put_formats(icd);
275 icd->current_fmt = NULL;
276 icd->num_user_formats = 0;
277 vfree(icd->user_formats);
278 icd->user_formats = NULL;
281 /* Called with .vb_lock held */
282 static int soc_camera_set_fmt(struct soc_camera_file *icf,
283 struct v4l2_format *f)
285 struct soc_camera_device *icd = icf->icd;
286 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
287 struct v4l2_pix_format *pix = &f->fmt.pix;
290 /* We always call try_fmt() before set_fmt() or set_crop() */
291 ret = ici->ops->try_fmt(icd, f);
295 ret = ici->ops->set_fmt(icd, f);
298 } else if (!icd->current_fmt ||
299 icd->current_fmt->fourcc != pix->pixelformat) {
300 dev_err(ici->v4l2_dev.dev,
301 "Host driver hasn't set up current format correctly!\n");
305 icd->rect_current.width = pix->width;
306 icd->rect_current.height = pix->height;
308 icd->field = pix->field;
310 if (f->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
311 dev_warn(&icd->dev, "Attention! Wrong buf-type %d\n",
314 dev_dbg(&icd->dev, "set width: %d height: %d\n",
315 icd->rect_current.width, icd->rect_current.height);
317 /* set physical bus parameters */
318 return ici->ops->set_bus_param(icd, pix->pixelformat);
321 static int soc_camera_open(struct file *file)
323 struct video_device *vdev = video_devdata(file);
324 struct soc_camera_device *icd = container_of(vdev->parent, struct soc_camera_device, dev);
325 struct soc_camera_link *icl = to_soc_camera_link(icd);
326 struct soc_camera_host *ici;
327 struct soc_camera_file *icf;
331 /* No device driver attached */
334 ici = to_soc_camera_host(icd->dev.parent);
336 icf = vmalloc(sizeof(*icf));
340 if (!try_module_get(ici->ops->owner)) {
341 dev_err(&icd->dev, "Couldn't lock capture bus driver.\n");
346 /* Protect against icd->ops->remove() until we module_get() both drivers. */
347 mutex_lock(&icd->video_lock);
352 /* Now we really have to activate the camera */
353 if (icd->use_count == 1) {
354 /* Restore parameters before the last close() per V4L2 API */
355 struct v4l2_format f = {
356 .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
358 .width = icd->rect_current.width,
359 .height = icd->rect_current.height,
361 .pixelformat = icd->current_fmt->fourcc,
362 .colorspace = icd->current_fmt->colorspace,
367 ret = icl->power(icd->pdev, 1);
372 /* The camera could have been already on, try to reset */
374 icl->reset(icd->pdev);
376 ret = ici->ops->add(icd);
378 dev_err(&icd->dev, "Couldn't activate the camera: %d\n", ret);
382 if (icd->ops->init) {
383 ret = icd->ops->init(icd);
388 /* Try to configure with default parameters */
389 ret = soc_camera_set_fmt(icf, &f);
394 file->private_data = icf;
395 dev_dbg(&icd->dev, "camera device open\n");
397 ici->ops->init_videobuf(&icf->vb_vidq, icd);
399 mutex_unlock(&icd->video_lock);
404 * First five errors are entered with the .video_lock held
408 if (icd->ops->release)
409 icd->ops->release(icd);
411 ici->ops->remove(icd);
414 icl->power(icd->pdev, 0);
417 mutex_unlock(&icd->video_lock);
418 module_put(ici->ops->owner);
424 static int soc_camera_close(struct file *file)
426 struct soc_camera_file *icf = file->private_data;
427 struct soc_camera_device *icd = icf->icd;
428 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
429 struct video_device *vdev = icd->vdev;
431 mutex_lock(&icd->video_lock);
433 if (!icd->use_count) {
434 struct soc_camera_link *icl = to_soc_camera_link(icd);
436 if (icd->ops->release)
437 icd->ops->release(icd);
438 ici->ops->remove(icd);
440 icl->power(icd->pdev, 0);
443 mutex_unlock(&icd->video_lock);
445 module_put(ici->ops->owner);
449 dev_dbg(vdev->parent, "camera device close\n");
454 static ssize_t soc_camera_read(struct file *file, char __user *buf,
455 size_t count, loff_t *ppos)
457 struct soc_camera_file *icf = file->private_data;
458 struct soc_camera_device *icd = icf->icd;
459 struct video_device *vdev = icd->vdev;
462 dev_err(vdev->parent, "camera device read not implemented\n");
467 static int soc_camera_mmap(struct file *file, struct vm_area_struct *vma)
469 struct soc_camera_file *icf = file->private_data;
470 struct soc_camera_device *icd = icf->icd;
473 dev_dbg(&icd->dev, "mmap called, vma=0x%08lx\n", (unsigned long)vma);
475 err = videobuf_mmap_mapper(&icf->vb_vidq, vma);
477 dev_dbg(&icd->dev, "vma start=0x%08lx, size=%ld, ret=%d\n",
478 (unsigned long)vma->vm_start,
479 (unsigned long)vma->vm_end - (unsigned long)vma->vm_start,
485 static unsigned int soc_camera_poll(struct file *file, poll_table *pt)
487 struct soc_camera_file *icf = file->private_data;
488 struct soc_camera_device *icd = icf->icd;
489 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
491 if (list_empty(&icf->vb_vidq.stream)) {
492 dev_err(&icd->dev, "Trying to poll with no queued buffers!\n");
496 return ici->ops->poll(file, pt);
499 static struct v4l2_file_operations soc_camera_fops = {
500 .owner = THIS_MODULE,
501 .open = soc_camera_open,
502 .release = soc_camera_close,
503 .ioctl = video_ioctl2,
504 .read = soc_camera_read,
505 .mmap = soc_camera_mmap,
506 .poll = soc_camera_poll,
509 static int soc_camera_s_fmt_vid_cap(struct file *file, void *priv,
510 struct v4l2_format *f)
512 struct soc_camera_file *icf = file->private_data;
513 struct soc_camera_device *icd = icf->icd;
516 WARN_ON(priv != file->private_data);
518 mutex_lock(&icf->vb_vidq.vb_lock);
520 if (videobuf_queue_is_busy(&icf->vb_vidq)) {
521 dev_err(&icd->dev, "S_FMT denied: queue busy\n");
526 ret = soc_camera_set_fmt(icf, f);
529 mutex_unlock(&icf->vb_vidq.vb_lock);
534 static int soc_camera_enum_fmt_vid_cap(struct file *file, void *priv,
535 struct v4l2_fmtdesc *f)
537 struct soc_camera_file *icf = file->private_data;
538 struct soc_camera_device *icd = icf->icd;
539 const struct soc_camera_data_format *format;
541 WARN_ON(priv != file->private_data);
543 if (f->index >= icd->num_user_formats)
546 format = icd->user_formats[f->index].host_fmt;
548 strlcpy(f->description, format->name, sizeof(f->description));
549 f->pixelformat = format->fourcc;
553 static int soc_camera_g_fmt_vid_cap(struct file *file, void *priv,
554 struct v4l2_format *f)
556 struct soc_camera_file *icf = file->private_data;
557 struct soc_camera_device *icd = icf->icd;
558 struct v4l2_pix_format *pix = &f->fmt.pix;
560 WARN_ON(priv != file->private_data);
562 pix->width = icd->rect_current.width;
563 pix->height = icd->rect_current.height;
564 pix->field = icf->vb_vidq.field;
565 pix->pixelformat = icd->current_fmt->fourcc;
566 pix->bytesperline = pix->width *
567 DIV_ROUND_UP(icd->current_fmt->depth, 8);
568 pix->sizeimage = pix->height * pix->bytesperline;
569 dev_dbg(&icd->dev, "current_fmt->fourcc: 0x%08x\n",
570 icd->current_fmt->fourcc);
574 static int soc_camera_querycap(struct file *file, void *priv,
575 struct v4l2_capability *cap)
577 struct soc_camera_file *icf = file->private_data;
578 struct soc_camera_device *icd = icf->icd;
579 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
581 WARN_ON(priv != file->private_data);
583 strlcpy(cap->driver, ici->drv_name, sizeof(cap->driver));
584 return ici->ops->querycap(ici, cap);
587 static int soc_camera_streamon(struct file *file, void *priv,
588 enum v4l2_buf_type i)
590 struct soc_camera_file *icf = file->private_data;
591 struct soc_camera_device *icd = icf->icd;
592 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
595 WARN_ON(priv != file->private_data);
597 if (i != V4L2_BUF_TYPE_VIDEO_CAPTURE)
600 mutex_lock(&icd->video_lock);
602 v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, video, s_stream, 1);
604 /* This calls buf_queue from host driver's videobuf_queue_ops */
605 ret = videobuf_streamon(&icf->vb_vidq);
607 mutex_unlock(&icd->video_lock);
612 static int soc_camera_streamoff(struct file *file, void *priv,
613 enum v4l2_buf_type i)
615 struct soc_camera_file *icf = file->private_data;
616 struct soc_camera_device *icd = icf->icd;
617 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
619 WARN_ON(priv != file->private_data);
621 if (i != V4L2_BUF_TYPE_VIDEO_CAPTURE)
624 mutex_lock(&icd->video_lock);
626 /* This calls buf_release from host driver's videobuf_queue_ops for all
627 * remaining buffers. When the last buffer is freed, stop capture */
628 videobuf_streamoff(&icf->vb_vidq);
630 v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, video, s_stream, 0);
632 mutex_unlock(&icd->video_lock);
637 static int soc_camera_queryctrl(struct file *file, void *priv,
638 struct v4l2_queryctrl *qc)
640 struct soc_camera_file *icf = file->private_data;
641 struct soc_camera_device *icd = icf->icd;
642 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
645 WARN_ON(priv != file->private_data);
650 /* First check host controls */
651 for (i = 0; i < ici->ops->num_controls; i++)
652 if (qc->id == ici->ops->controls[i].id) {
653 memcpy(qc, &(ici->ops->controls[i]),
658 /* Then device controls */
659 for (i = 0; i < icd->ops->num_controls; i++)
660 if (qc->id == icd->ops->controls[i].id) {
661 memcpy(qc, &(icd->ops->controls[i]),
669 static int soc_camera_g_ctrl(struct file *file, void *priv,
670 struct v4l2_control *ctrl)
672 struct soc_camera_file *icf = file->private_data;
673 struct soc_camera_device *icd = icf->icd;
674 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
677 WARN_ON(priv != file->private_data);
681 if (icd->gain == (unsigned short)~0)
683 ctrl->value = icd->gain;
685 case V4L2_CID_EXPOSURE:
686 if (icd->exposure == (unsigned short)~0)
688 ctrl->value = icd->exposure;
692 if (ici->ops->get_ctrl) {
693 ret = ici->ops->get_ctrl(icd, ctrl);
694 if (ret != -ENOIOCTLCMD)
698 return v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, core, g_ctrl, ctrl);
701 static int soc_camera_s_ctrl(struct file *file, void *priv,
702 struct v4l2_control *ctrl)
704 struct soc_camera_file *icf = file->private_data;
705 struct soc_camera_device *icd = icf->icd;
706 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
709 WARN_ON(priv != file->private_data);
711 if (ici->ops->set_ctrl) {
712 ret = ici->ops->set_ctrl(icd, ctrl);
713 if (ret != -ENOIOCTLCMD)
717 return v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, core, s_ctrl, ctrl);
720 static int soc_camera_cropcap(struct file *file, void *fh,
721 struct v4l2_cropcap *a)
723 struct soc_camera_file *icf = file->private_data;
724 struct soc_camera_device *icd = icf->icd;
726 a->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
727 a->bounds = icd->rect_max;
728 a->defrect.left = icd->rect_max.left;
729 a->defrect.top = icd->rect_max.top;
730 a->defrect.width = DEFAULT_WIDTH;
731 a->defrect.height = DEFAULT_HEIGHT;
732 a->pixelaspect.numerator = 1;
733 a->pixelaspect.denominator = 1;
738 static int soc_camera_g_crop(struct file *file, void *fh,
741 struct soc_camera_file *icf = file->private_data;
742 struct soc_camera_device *icd = icf->icd;
744 a->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
745 a->c = icd->rect_current;
750 static int soc_camera_s_crop(struct file *file, void *fh,
753 struct soc_camera_file *icf = file->private_data;
754 struct soc_camera_device *icd = icf->icd;
755 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
758 if (a->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
761 /* Cropping is allowed during a running capture, guard consistency */
762 mutex_lock(&icf->vb_vidq.vb_lock);
764 if (a->c.width > icd->rect_max.width)
765 a->c.width = icd->rect_max.width;
767 if (a->c.width < icd->width_min)
768 a->c.width = icd->width_min;
770 if (a->c.height > icd->rect_max.height)
771 a->c.height = icd->rect_max.height;
773 if (a->c.height < icd->height_min)
774 a->c.height = icd->height_min;
776 if (a->c.width + a->c.left > icd->rect_max.width + icd->rect_max.left)
777 a->c.left = icd->rect_max.width + icd->rect_max.left -
780 if (a->c.height + a->c.top > icd->rect_max.height + icd->rect_max.top)
781 a->c.top = icd->rect_max.height + icd->rect_max.top -
784 ret = ici->ops->set_crop(icd, &a->c);
786 icd->rect_current = a->c;
788 mutex_unlock(&icf->vb_vidq.vb_lock);
793 static int soc_camera_g_chip_ident(struct file *file, void *fh,
794 struct v4l2_dbg_chip_ident *id)
796 struct soc_camera_file *icf = file->private_data;
797 struct soc_camera_device *icd = icf->icd;
798 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
800 return v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, core, g_chip_ident, id);
803 #ifdef CONFIG_VIDEO_ADV_DEBUG
804 static int soc_camera_g_register(struct file *file, void *fh,
805 struct v4l2_dbg_register *reg)
807 struct soc_camera_file *icf = file->private_data;
808 struct soc_camera_device *icd = icf->icd;
809 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
811 return v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, core, g_register, reg);
814 static int soc_camera_s_register(struct file *file, void *fh,
815 struct v4l2_dbg_register *reg)
817 struct soc_camera_file *icf = file->private_data;
818 struct soc_camera_device *icd = icf->icd;
819 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
821 return v4l2_device_call_until_err(&ici->v4l2_dev, (__u32)icd, core, s_register, reg);
825 /* So far this function cannot fail */
826 static void scan_add_host(struct soc_camera_host *ici)
828 struct soc_camera_device *icd;
830 mutex_lock(&list_lock);
832 list_for_each_entry(icd, &devices, list) {
833 if (icd->iface == ici->nr) {
835 icd->dev.parent = ici->v4l2_dev.dev;
836 dev_set_name(&icd->dev, "%u-%u", icd->iface,
838 ret = device_register(&icd->dev);
840 icd->dev.parent = NULL;
842 "Cannot register device: %d\n", ret);
847 mutex_unlock(&list_lock);
850 #ifdef CONFIG_I2C_BOARDINFO
851 static int soc_camera_init_i2c(struct soc_camera_device *icd,
852 struct soc_camera_link *icl)
854 struct i2c_client *client;
855 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
856 struct i2c_adapter *adap = i2c_get_adapter(icl->i2c_adapter_id);
857 struct v4l2_subdev *subdev;
862 dev_err(&icd->dev, "Cannot get I2C adapter #%d. No driver?\n",
863 icl->i2c_adapter_id);
867 icl->board_info->platform_data = icd;
869 subdev = v4l2_i2c_new_subdev_board(&ici->v4l2_dev, adap,
870 icl->module_name, icl->board_info, NULL);
876 subdev->grp_id = (__u32)icd;
877 client = subdev->priv;
879 /* Use to_i2c_client(dev) to recover the i2c client */
880 dev_set_drvdata(&icd->dev, &client->dev);
884 i2c_put_adapter(adap);
889 static void soc_camera_free_i2c(struct soc_camera_device *icd)
891 struct i2c_client *client =
892 to_i2c_client(to_soc_camera_control(icd));
893 dev_set_drvdata(&icd->dev, NULL);
894 v4l2_device_unregister_subdev(i2c_get_clientdata(client));
895 i2c_unregister_device(client);
896 i2c_put_adapter(client->adapter);
899 #define soc_camera_init_i2c(icd, icl) (-ENODEV)
900 #define soc_camera_free_i2c(icd) do {} while (0)
903 static int soc_camera_video_start(struct soc_camera_device *icd);
904 static int video_dev_create(struct soc_camera_device *icd);
905 /* Called during host-driver probe */
906 static int soc_camera_probe(struct device *dev)
908 struct soc_camera_device *icd = to_soc_camera_dev(dev);
909 struct soc_camera_host *ici = to_soc_camera_host(dev->parent);
910 struct soc_camera_link *icl = to_soc_camera_link(icd);
911 struct device *control = NULL;
914 dev_info(dev, "Probing %s\n", dev_name(dev));
917 ret = icl->power(icd->pdev, 1);
920 "Platform failed to power-on the camera.\n");
925 /* The camera could have been already on, try to reset */
927 icl->reset(icd->pdev);
929 ret = ici->ops->add(icd);
933 /* Must have icd->vdev before registering the device */
934 ret = video_dev_create(icd);
938 /* Non-i2c cameras, e.g., soc_camera_platform, have no board_info */
939 if (icl->board_info) {
940 ret = soc_camera_init_i2c(icd, icl);
943 } else if (!icl->add_device || !icl->del_device) {
947 if (icl->module_name)
948 ret = request_module(icl->module_name);
950 ret = icl->add_device(icl, &icd->dev);
954 /* FIXME: this is racy, have to use driver-binding notification */
955 control = to_soc_camera_control(icd);
956 if (!control || !control->driver ||
957 !try_module_get(control->driver->owner)) {
958 icl->del_device(icl);
963 /* At this point client .probe() should have run already */
964 ret = soc_camera_init_user_formats(icd);
968 icd->rect_current = icd->rect_max;
969 icd->field = V4L2_FIELD_ANY;
971 /* ..._video_start() will create a device node, so we have to protect */
972 mutex_lock(&icd->video_lock);
974 ret = soc_camera_video_start(icd);
978 /* Do we have to sysfs_remove_link() before device_unregister()? */
979 if (to_soc_camera_control(icd) &&
980 sysfs_create_link(&icd->dev.kobj, &to_soc_camera_control(icd)->kobj,
982 dev_warn(&icd->dev, "Failed creating the control symlink\n");
984 ici->ops->remove(icd);
987 icl->power(icd->pdev, 0);
989 mutex_unlock(&icd->video_lock);
994 mutex_unlock(&icd->video_lock);
995 soc_camera_free_user_formats(icd);
997 if (icl->board_info) {
998 soc_camera_free_i2c(icd);
1000 icl->del_device(icl);
1001 module_put(control->driver->owner);
1005 video_device_release(icd->vdev);
1007 ici->ops->remove(icd);
1010 icl->power(icd->pdev, 0);
1015 /* This is called on device_unregister, which only means we have to disconnect
1016 * from the host, but not remove ourselves from the device list */
1017 static int soc_camera_remove(struct device *dev)
1019 struct soc_camera_device *icd = to_soc_camera_dev(dev);
1020 struct soc_camera_link *icl = to_soc_camera_link(icd);
1021 struct video_device *vdev = icd->vdev;
1023 BUG_ON(!dev->parent);
1026 mutex_lock(&icd->video_lock);
1027 video_unregister_device(vdev);
1029 mutex_unlock(&icd->video_lock);
1032 if (icl->board_info) {
1033 soc_camera_free_i2c(icd);
1035 struct device_driver *drv = to_soc_camera_control(icd) ?
1036 to_soc_camera_control(icd)->driver : NULL;
1038 icl->del_device(icl);
1039 module_put(drv->owner);
1042 soc_camera_free_user_formats(icd);
1047 static int soc_camera_suspend(struct device *dev, pm_message_t state)
1049 struct soc_camera_device *icd = to_soc_camera_dev(dev);
1050 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
1053 if (ici->ops->suspend)
1054 ret = ici->ops->suspend(icd, state);
1059 static int soc_camera_resume(struct device *dev)
1061 struct soc_camera_device *icd = to_soc_camera_dev(dev);
1062 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
1065 if (ici->ops->resume)
1066 ret = ici->ops->resume(icd);
1071 static struct bus_type soc_camera_bus_type = {
1072 .name = "soc-camera",
1073 .probe = soc_camera_probe,
1074 .remove = soc_camera_remove,
1075 .suspend = soc_camera_suspend,
1076 .resume = soc_camera_resume,
1079 static struct device_driver ic_drv = {
1081 .bus = &soc_camera_bus_type,
1082 .owner = THIS_MODULE,
1085 static void dummy_release(struct device *dev)
1089 int soc_camera_host_register(struct soc_camera_host *ici)
1091 struct soc_camera_host *ix;
1094 if (!ici || !ici->ops ||
1095 !ici->ops->try_fmt ||
1096 !ici->ops->set_fmt ||
1097 !ici->ops->set_crop ||
1098 !ici->ops->set_bus_param ||
1099 !ici->ops->querycap ||
1100 !ici->ops->init_videobuf ||
1101 !ici->ops->reqbufs ||
1103 !ici->ops->remove ||
1108 mutex_lock(&list_lock);
1109 list_for_each_entry(ix, &hosts, list) {
1110 if (ix->nr == ici->nr) {
1116 ret = v4l2_device_register(ici->v4l2_dev.dev, &ici->v4l2_dev);
1120 list_add_tail(&ici->list, &hosts);
1121 mutex_unlock(&list_lock);
1128 mutex_unlock(&list_lock);
1131 EXPORT_SYMBOL(soc_camera_host_register);
1133 /* Unregister all clients! */
1134 void soc_camera_host_unregister(struct soc_camera_host *ici)
1136 struct soc_camera_device *icd;
1138 mutex_lock(&list_lock);
1140 list_del(&ici->list);
1142 list_for_each_entry(icd, &devices, list) {
1143 if (icd->iface == ici->nr) {
1144 /* The bus->remove will be called */
1145 device_unregister(&icd->dev);
1146 /* Not before device_unregister(), .remove
1147 * needs parent to call ici->ops->remove() */
1148 icd->dev.parent = NULL;
1150 /* If the host module is loaded again, device_register()
1151 * would complain "already initialised" */
1152 memset(&icd->dev.kobj, 0, sizeof(icd->dev.kobj));
1156 mutex_unlock(&list_lock);
1158 v4l2_device_unregister(&ici->v4l2_dev);
1160 EXPORT_SYMBOL(soc_camera_host_unregister);
1162 /* Image capture device */
1163 static int soc_camera_device_register(struct soc_camera_device *icd)
1165 struct soc_camera_device *ix;
1168 for (i = 0; i < 256 && num < 0; i++) {
1170 /* Check if this index is available on this interface */
1171 list_for_each_entry(ix, &devices, list) {
1172 if (ix->iface == icd->iface && ix->devnum == i) {
1180 /* ok, we have 256 cameras on this host...
1181 * man, stay reasonable... */
1185 icd->dev.bus = &soc_camera_bus_type;
1187 icd->dev.release = dummy_release;
1189 icd->host_priv = NULL;
1190 mutex_init(&icd->video_lock);
1192 list_add_tail(&icd->list, &devices);
1197 static void soc_camera_device_unregister(struct soc_camera_device *icd)
1199 list_del(&icd->list);
1202 static const struct v4l2_ioctl_ops soc_camera_ioctl_ops = {
1203 .vidioc_querycap = soc_camera_querycap,
1204 .vidioc_g_fmt_vid_cap = soc_camera_g_fmt_vid_cap,
1205 .vidioc_enum_fmt_vid_cap = soc_camera_enum_fmt_vid_cap,
1206 .vidioc_s_fmt_vid_cap = soc_camera_s_fmt_vid_cap,
1207 .vidioc_enum_input = soc_camera_enum_input,
1208 .vidioc_g_input = soc_camera_g_input,
1209 .vidioc_s_input = soc_camera_s_input,
1210 .vidioc_s_std = soc_camera_s_std,
1211 .vidioc_reqbufs = soc_camera_reqbufs,
1212 .vidioc_try_fmt_vid_cap = soc_camera_try_fmt_vid_cap,
1213 .vidioc_querybuf = soc_camera_querybuf,
1214 .vidioc_qbuf = soc_camera_qbuf,
1215 .vidioc_dqbuf = soc_camera_dqbuf,
1216 .vidioc_streamon = soc_camera_streamon,
1217 .vidioc_streamoff = soc_camera_streamoff,
1218 .vidioc_queryctrl = soc_camera_queryctrl,
1219 .vidioc_g_ctrl = soc_camera_g_ctrl,
1220 .vidioc_s_ctrl = soc_camera_s_ctrl,
1221 .vidioc_cropcap = soc_camera_cropcap,
1222 .vidioc_g_crop = soc_camera_g_crop,
1223 .vidioc_s_crop = soc_camera_s_crop,
1224 .vidioc_g_chip_ident = soc_camera_g_chip_ident,
1225 #ifdef CONFIG_VIDEO_ADV_DEBUG
1226 .vidioc_g_register = soc_camera_g_register,
1227 .vidioc_s_register = soc_camera_s_register,
1231 static int video_dev_create(struct soc_camera_device *icd)
1233 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
1234 struct video_device *vdev = video_device_alloc();
1239 strlcpy(vdev->name, ici->drv_name, sizeof(vdev->name));
1241 vdev->parent = &icd->dev;
1242 vdev->current_norm = V4L2_STD_UNKNOWN;
1243 vdev->fops = &soc_camera_fops;
1244 vdev->ioctl_ops = &soc_camera_ioctl_ops;
1245 vdev->release = video_device_release;
1247 vdev->tvnorms = V4L2_STD_UNKNOWN;
1255 * Called from soc_camera_probe() above (with .video_lock held???)
1257 static int soc_camera_video_start(struct soc_camera_device *icd)
1259 const struct v4l2_queryctrl *qctrl;
1262 if (!icd->dev.parent)
1266 !icd->ops->query_bus_param ||
1267 !icd->ops->set_bus_param)
1270 ret = video_register_device(icd->vdev, VFL_TYPE_GRABBER,
1273 dev_err(&icd->dev, "video_register_device failed: %d\n", ret);
1277 qctrl = soc_camera_find_qctrl(icd->ops, V4L2_CID_GAIN);
1278 icd->gain = qctrl ? qctrl->default_value : (unsigned short)~0;
1279 qctrl = soc_camera_find_qctrl(icd->ops, V4L2_CID_EXPOSURE);
1280 icd->exposure = qctrl ? qctrl->default_value : (unsigned short)~0;
1285 static int __devinit soc_camera_pdrv_probe(struct platform_device *pdev)
1287 struct soc_camera_link *icl = pdev->dev.platform_data;
1288 struct soc_camera_device *icd;
1294 icd = kzalloc(sizeof(*icd), GFP_KERNEL);
1298 icd->iface = icl->bus_id;
1299 icd->pdev = &pdev->dev;
1300 platform_set_drvdata(pdev, icd);
1301 icd->dev.platform_data = icl;
1303 ret = soc_camera_device_register(icd);
1315 /* Only called on rmmod for each platform device, since they are not
1316 * hot-pluggable. Now we know, that all our users - hosts and devices have
1317 * been unloaded already */
1318 static int __devexit soc_camera_pdrv_remove(struct platform_device *pdev)
1320 struct soc_camera_device *icd = platform_get_drvdata(pdev);
1325 soc_camera_device_unregister(icd);
1332 static struct platform_driver __refdata soc_camera_pdrv = {
1333 .remove = __devexit_p(soc_camera_pdrv_remove),
1335 .name = "soc-camera-pdrv",
1336 .owner = THIS_MODULE,
1340 static int __init soc_camera_init(void)
1342 int ret = bus_register(&soc_camera_bus_type);
1345 ret = driver_register(&ic_drv);
1349 ret = platform_driver_probe(&soc_camera_pdrv, soc_camera_pdrv_probe);
1356 driver_unregister(&ic_drv);
1358 bus_unregister(&soc_camera_bus_type);
1362 static void __exit soc_camera_exit(void)
1364 platform_driver_unregister(&soc_camera_pdrv);
1365 driver_unregister(&ic_drv);
1366 bus_unregister(&soc_camera_bus_type);
1369 module_init(soc_camera_init);
1370 module_exit(soc_camera_exit);
1372 MODULE_DESCRIPTION("Image capture bus driver");
1373 MODULE_AUTHOR("Guennadi Liakhovetski <kernel@pengutronix.de>");
1374 MODULE_LICENSE("GPL");
1375 MODULE_ALIAS("platform:soc-camera-pdrv");