4 * TI OMAP3 ISP - Generic video node
6 * Copyright (C) 2009-2010 Nokia Corporation
8 * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
9 * Sakari Ailus <sakari.ailus@iki.fi>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License version 2 as
13 * published by the Free Software Foundation.
16 #include <asm/cacheflush.h>
17 #include <linux/clk.h>
19 #include <linux/module.h>
20 #include <linux/pagemap.h>
21 #include <linux/scatterlist.h>
22 #include <linux/sched.h>
23 #include <linux/slab.h>
24 #include <linux/vmalloc.h>
25 #include <media/v4l2-dev.h>
26 #include <media/v4l2-ioctl.h>
27 #include <media/videobuf2-dma-contig.h>
33 /* -----------------------------------------------------------------------------
38 * NOTE: When adding new media bus codes, always remember to add
39 * corresponding in-memory formats to the table below!!!
41 static struct isp_format_info formats[] = {
42 { MEDIA_BUS_FMT_Y8_1X8, MEDIA_BUS_FMT_Y8_1X8,
43 MEDIA_BUS_FMT_Y8_1X8, MEDIA_BUS_FMT_Y8_1X8,
44 V4L2_PIX_FMT_GREY, 8, 1, },
45 { MEDIA_BUS_FMT_Y10_1X10, MEDIA_BUS_FMT_Y10_1X10,
46 MEDIA_BUS_FMT_Y10_1X10, MEDIA_BUS_FMT_Y8_1X8,
47 V4L2_PIX_FMT_Y10, 10, 2, },
48 { MEDIA_BUS_FMT_Y12_1X12, MEDIA_BUS_FMT_Y10_1X10,
49 MEDIA_BUS_FMT_Y12_1X12, MEDIA_BUS_FMT_Y8_1X8,
50 V4L2_PIX_FMT_Y12, 12, 2, },
51 { MEDIA_BUS_FMT_SBGGR8_1X8, MEDIA_BUS_FMT_SBGGR8_1X8,
52 MEDIA_BUS_FMT_SBGGR8_1X8, MEDIA_BUS_FMT_SBGGR8_1X8,
53 V4L2_PIX_FMT_SBGGR8, 8, 1, },
54 { MEDIA_BUS_FMT_SGBRG8_1X8, MEDIA_BUS_FMT_SGBRG8_1X8,
55 MEDIA_BUS_FMT_SGBRG8_1X8, MEDIA_BUS_FMT_SGBRG8_1X8,
56 V4L2_PIX_FMT_SGBRG8, 8, 1, },
57 { MEDIA_BUS_FMT_SGRBG8_1X8, MEDIA_BUS_FMT_SGRBG8_1X8,
58 MEDIA_BUS_FMT_SGRBG8_1X8, MEDIA_BUS_FMT_SGRBG8_1X8,
59 V4L2_PIX_FMT_SGRBG8, 8, 1, },
60 { MEDIA_BUS_FMT_SRGGB8_1X8, MEDIA_BUS_FMT_SRGGB8_1X8,
61 MEDIA_BUS_FMT_SRGGB8_1X8, MEDIA_BUS_FMT_SRGGB8_1X8,
62 V4L2_PIX_FMT_SRGGB8, 8, 1, },
63 { MEDIA_BUS_FMT_SBGGR10_DPCM8_1X8, MEDIA_BUS_FMT_SBGGR10_DPCM8_1X8,
64 MEDIA_BUS_FMT_SBGGR10_1X10, 0,
65 V4L2_PIX_FMT_SBGGR10DPCM8, 8, 1, },
66 { MEDIA_BUS_FMT_SGBRG10_DPCM8_1X8, MEDIA_BUS_FMT_SGBRG10_DPCM8_1X8,
67 MEDIA_BUS_FMT_SGBRG10_1X10, 0,
68 V4L2_PIX_FMT_SGBRG10DPCM8, 8, 1, },
69 { MEDIA_BUS_FMT_SGRBG10_DPCM8_1X8, MEDIA_BUS_FMT_SGRBG10_DPCM8_1X8,
70 MEDIA_BUS_FMT_SGRBG10_1X10, 0,
71 V4L2_PIX_FMT_SGRBG10DPCM8, 8, 1, },
72 { MEDIA_BUS_FMT_SRGGB10_DPCM8_1X8, MEDIA_BUS_FMT_SRGGB10_DPCM8_1X8,
73 MEDIA_BUS_FMT_SRGGB10_1X10, 0,
74 V4L2_PIX_FMT_SRGGB10DPCM8, 8, 1, },
75 { MEDIA_BUS_FMT_SBGGR10_1X10, MEDIA_BUS_FMT_SBGGR10_1X10,
76 MEDIA_BUS_FMT_SBGGR10_1X10, MEDIA_BUS_FMT_SBGGR8_1X8,
77 V4L2_PIX_FMT_SBGGR10, 10, 2, },
78 { MEDIA_BUS_FMT_SGBRG10_1X10, MEDIA_BUS_FMT_SGBRG10_1X10,
79 MEDIA_BUS_FMT_SGBRG10_1X10, MEDIA_BUS_FMT_SGBRG8_1X8,
80 V4L2_PIX_FMT_SGBRG10, 10, 2, },
81 { MEDIA_BUS_FMT_SGRBG10_1X10, MEDIA_BUS_FMT_SGRBG10_1X10,
82 MEDIA_BUS_FMT_SGRBG10_1X10, MEDIA_BUS_FMT_SGRBG8_1X8,
83 V4L2_PIX_FMT_SGRBG10, 10, 2, },
84 { MEDIA_BUS_FMT_SRGGB10_1X10, MEDIA_BUS_FMT_SRGGB10_1X10,
85 MEDIA_BUS_FMT_SRGGB10_1X10, MEDIA_BUS_FMT_SRGGB8_1X8,
86 V4L2_PIX_FMT_SRGGB10, 10, 2, },
87 { MEDIA_BUS_FMT_SBGGR12_1X12, MEDIA_BUS_FMT_SBGGR10_1X10,
88 MEDIA_BUS_FMT_SBGGR12_1X12, MEDIA_BUS_FMT_SBGGR8_1X8,
89 V4L2_PIX_FMT_SBGGR12, 12, 2, },
90 { MEDIA_BUS_FMT_SGBRG12_1X12, MEDIA_BUS_FMT_SGBRG10_1X10,
91 MEDIA_BUS_FMT_SGBRG12_1X12, MEDIA_BUS_FMT_SGBRG8_1X8,
92 V4L2_PIX_FMT_SGBRG12, 12, 2, },
93 { MEDIA_BUS_FMT_SGRBG12_1X12, MEDIA_BUS_FMT_SGRBG10_1X10,
94 MEDIA_BUS_FMT_SGRBG12_1X12, MEDIA_BUS_FMT_SGRBG8_1X8,
95 V4L2_PIX_FMT_SGRBG12, 12, 2, },
96 { MEDIA_BUS_FMT_SRGGB12_1X12, MEDIA_BUS_FMT_SRGGB10_1X10,
97 MEDIA_BUS_FMT_SRGGB12_1X12, MEDIA_BUS_FMT_SRGGB8_1X8,
98 V4L2_PIX_FMT_SRGGB12, 12, 2, },
99 { MEDIA_BUS_FMT_UYVY8_1X16, MEDIA_BUS_FMT_UYVY8_1X16,
100 MEDIA_BUS_FMT_UYVY8_1X16, 0,
101 V4L2_PIX_FMT_UYVY, 16, 2, },
102 { MEDIA_BUS_FMT_YUYV8_1X16, MEDIA_BUS_FMT_YUYV8_1X16,
103 MEDIA_BUS_FMT_YUYV8_1X16, 0,
104 V4L2_PIX_FMT_YUYV, 16, 2, },
105 { MEDIA_BUS_FMT_UYVY8_2X8, MEDIA_BUS_FMT_UYVY8_2X8,
106 MEDIA_BUS_FMT_UYVY8_2X8, 0,
107 V4L2_PIX_FMT_UYVY, 8, 2, },
108 { MEDIA_BUS_FMT_YUYV8_2X8, MEDIA_BUS_FMT_YUYV8_2X8,
109 MEDIA_BUS_FMT_YUYV8_2X8, 0,
110 V4L2_PIX_FMT_YUYV, 8, 2, },
111 /* Empty entry to catch the unsupported pixel code (0) used by the CCDC
112 * module and avoid NULL pointer dereferences.
117 const struct isp_format_info *omap3isp_video_format_info(u32 code)
121 for (i = 0; i < ARRAY_SIZE(formats); ++i) {
122 if (formats[i].code == code)
130 * isp_video_mbus_to_pix - Convert v4l2_mbus_framefmt to v4l2_pix_format
131 * @video: ISP video instance
132 * @mbus: v4l2_mbus_framefmt format (input)
133 * @pix: v4l2_pix_format format (output)
135 * Fill the output pix structure with information from the input mbus format.
136 * The bytesperline and sizeimage fields are computed from the requested bytes
137 * per line value in the pix format and information from the video instance.
139 * Return the number of padding bytes at end of line.
141 static unsigned int isp_video_mbus_to_pix(const struct isp_video *video,
142 const struct v4l2_mbus_framefmt *mbus,
143 struct v4l2_pix_format *pix)
145 unsigned int bpl = pix->bytesperline;
146 unsigned int min_bpl;
149 memset(pix, 0, sizeof(*pix));
150 pix->width = mbus->width;
151 pix->height = mbus->height;
153 for (i = 0; i < ARRAY_SIZE(formats); ++i) {
154 if (formats[i].code == mbus->code)
158 if (WARN_ON(i == ARRAY_SIZE(formats)))
161 min_bpl = pix->width * formats[i].bpp;
163 /* Clamp the requested bytes per line value. If the maximum bytes per
164 * line value is zero, the module doesn't support user configurable line
165 * sizes. Override the requested value with the minimum in that case.
168 bpl = clamp(bpl, min_bpl, video->bpl_max);
172 if (!video->bpl_zero_padding || bpl != min_bpl)
173 bpl = ALIGN(bpl, video->bpl_alignment);
175 pix->pixelformat = formats[i].pixelformat;
176 pix->bytesperline = bpl;
177 pix->sizeimage = pix->bytesperline * pix->height;
178 pix->colorspace = mbus->colorspace;
179 pix->field = mbus->field;
181 return bpl - min_bpl;
184 static void isp_video_pix_to_mbus(const struct v4l2_pix_format *pix,
185 struct v4l2_mbus_framefmt *mbus)
189 memset(mbus, 0, sizeof(*mbus));
190 mbus->width = pix->width;
191 mbus->height = pix->height;
193 /* Skip the last format in the loop so that it will be selected if no
196 for (i = 0; i < ARRAY_SIZE(formats) - 1; ++i) {
197 if (formats[i].pixelformat == pix->pixelformat)
201 mbus->code = formats[i].code;
202 mbus->colorspace = pix->colorspace;
203 mbus->field = pix->field;
206 static struct v4l2_subdev *
207 isp_video_remote_subdev(struct isp_video *video, u32 *pad)
209 struct media_pad *remote;
211 remote = media_entity_remote_pad(&video->pad);
213 if (remote == NULL ||
214 media_entity_type(remote->entity) != MEDIA_ENT_T_V4L2_SUBDEV)
218 *pad = remote->index;
220 return media_entity_to_v4l2_subdev(remote->entity);
223 /* Return a pointer to the ISP video instance at the far end of the pipeline. */
224 static int isp_video_get_graph_data(struct isp_video *video,
225 struct isp_pipeline *pipe)
227 struct media_entity_graph graph;
228 struct media_entity *entity = &video->video.entity;
229 struct media_device *mdev = entity->parent;
230 struct isp_video *far_end = NULL;
232 mutex_lock(&mdev->graph_mutex);
233 media_entity_graph_walk_start(&graph, entity);
235 while ((entity = media_entity_graph_walk_next(&graph))) {
236 struct isp_video *__video;
238 pipe->entities |= 1 << entity->id;
243 if (entity == &video->video.entity)
246 if (media_entity_type(entity) != MEDIA_ENT_T_DEVNODE)
249 __video = to_isp_video(media_entity_to_video_device(entity));
250 if (__video->type != video->type)
254 mutex_unlock(&mdev->graph_mutex);
256 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE) {
257 pipe->input = far_end;
258 pipe->output = video;
264 pipe->output = far_end;
271 __isp_video_get_format(struct isp_video *video, struct v4l2_format *format)
273 struct v4l2_subdev_format fmt;
274 struct v4l2_subdev *subdev;
278 subdev = isp_video_remote_subdev(video, &pad);
283 fmt.which = V4L2_SUBDEV_FORMAT_ACTIVE;
285 mutex_lock(&video->mutex);
286 ret = v4l2_subdev_call(subdev, pad, get_fmt, NULL, &fmt);
287 mutex_unlock(&video->mutex);
292 format->type = video->type;
293 return isp_video_mbus_to_pix(video, &fmt.format, &format->fmt.pix);
297 isp_video_check_format(struct isp_video *video, struct isp_video_fh *vfh)
299 struct v4l2_format format;
302 memcpy(&format, &vfh->format, sizeof(format));
303 ret = __isp_video_get_format(video, &format);
307 if (vfh->format.fmt.pix.pixelformat != format.fmt.pix.pixelformat ||
308 vfh->format.fmt.pix.height != format.fmt.pix.height ||
309 vfh->format.fmt.pix.width != format.fmt.pix.width ||
310 vfh->format.fmt.pix.bytesperline != format.fmt.pix.bytesperline ||
311 vfh->format.fmt.pix.sizeimage != format.fmt.pix.sizeimage ||
312 vfh->format.fmt.pix.field != format.fmt.pix.field)
318 /* -----------------------------------------------------------------------------
319 * Video queue operations
322 static int isp_video_queue_setup(struct vb2_queue *queue,
323 const struct v4l2_format *fmt,
324 unsigned int *count, unsigned int *num_planes,
325 unsigned int sizes[], void *alloc_ctxs[])
327 struct isp_video_fh *vfh = vb2_get_drv_priv(queue);
328 struct isp_video *video = vfh->video;
332 sizes[0] = vfh->format.fmt.pix.sizeimage;
336 alloc_ctxs[0] = video->alloc_ctx;
338 *count = min(*count, video->capture_mem / PAGE_ALIGN(sizes[0]));
343 static int isp_video_buffer_prepare(struct vb2_buffer *buf)
345 struct isp_video_fh *vfh = vb2_get_drv_priv(buf->vb2_queue);
346 struct isp_buffer *buffer = to_isp_buffer(buf);
347 struct isp_video *video = vfh->video;
350 /* Refuse to prepare the buffer is the video node has registered an
351 * error. We don't need to take any lock here as the operation is
352 * inherently racy. The authoritative check will be performed in the
353 * queue handler, which can't return an error, this check is just a best
354 * effort to notify userspace as early as possible.
356 if (unlikely(video->error))
359 addr = vb2_dma_contig_plane_dma_addr(buf, 0);
360 if (!IS_ALIGNED(addr, 32)) {
361 dev_dbg(video->isp->dev,
362 "Buffer address must be aligned to 32 bytes boundary.\n");
366 vb2_set_plane_payload(&buffer->vb, 0, vfh->format.fmt.pix.sizeimage);
373 * isp_video_buffer_queue - Add buffer to streaming queue
376 * In memory-to-memory mode, start streaming on the pipeline if buffers are
377 * queued on both the input and the output, if the pipeline isn't already busy.
378 * If the pipeline is busy, it will be restarted in the output module interrupt
381 static void isp_video_buffer_queue(struct vb2_buffer *buf)
383 struct isp_video_fh *vfh = vb2_get_drv_priv(buf->vb2_queue);
384 struct isp_buffer *buffer = to_isp_buffer(buf);
385 struct isp_video *video = vfh->video;
386 struct isp_pipeline *pipe = to_isp_pipeline(&video->video.entity);
387 enum isp_pipeline_state state;
392 spin_lock_irqsave(&video->irqlock, flags);
394 if (unlikely(video->error)) {
395 vb2_buffer_done(&buffer->vb, VB2_BUF_STATE_ERROR);
396 spin_unlock_irqrestore(&video->irqlock, flags);
400 empty = list_empty(&video->dmaqueue);
401 list_add_tail(&buffer->irqlist, &video->dmaqueue);
403 spin_unlock_irqrestore(&video->irqlock, flags);
406 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE)
407 state = ISP_PIPELINE_QUEUE_OUTPUT;
409 state = ISP_PIPELINE_QUEUE_INPUT;
411 spin_lock_irqsave(&pipe->lock, flags);
412 pipe->state |= state;
413 video->ops->queue(video, buffer);
414 video->dmaqueue_flags |= ISP_VIDEO_DMAQUEUE_QUEUED;
416 start = isp_pipeline_ready(pipe);
418 pipe->state |= ISP_PIPELINE_STREAM;
419 spin_unlock_irqrestore(&pipe->lock, flags);
422 omap3isp_pipeline_set_stream(pipe,
423 ISP_PIPELINE_STREAM_SINGLESHOT);
427 static const struct vb2_ops isp_video_queue_ops = {
428 .queue_setup = isp_video_queue_setup,
429 .buf_prepare = isp_video_buffer_prepare,
430 .buf_queue = isp_video_buffer_queue,
434 * omap3isp_video_buffer_next - Complete the current buffer and return the next
435 * @video: ISP video object
437 * Remove the current video buffer from the DMA queue and fill its timestamp and
438 * field count before handing it back to videobuf2.
440 * For capture video nodes the buffer state is set to VB2_BUF_STATE_DONE if no
441 * error has been flagged in the pipeline, or to VB2_BUF_STATE_ERROR otherwise.
442 * For video output nodes the buffer state is always set to VB2_BUF_STATE_DONE.
444 * The DMA queue is expected to contain at least one buffer.
446 * Return a pointer to the next buffer in the DMA queue, or NULL if the queue is
449 struct isp_buffer *omap3isp_video_buffer_next(struct isp_video *video)
451 struct isp_pipeline *pipe = to_isp_pipeline(&video->video.entity);
452 enum isp_pipeline_state state;
453 struct isp_buffer *buf;
457 spin_lock_irqsave(&video->irqlock, flags);
458 if (WARN_ON(list_empty(&video->dmaqueue))) {
459 spin_unlock_irqrestore(&video->irqlock, flags);
463 buf = list_first_entry(&video->dmaqueue, struct isp_buffer,
465 list_del(&buf->irqlist);
466 spin_unlock_irqrestore(&video->irqlock, flags);
469 buf->vb.v4l2_buf.timestamp.tv_sec = ts.tv_sec;
470 buf->vb.v4l2_buf.timestamp.tv_usec = ts.tv_nsec / NSEC_PER_USEC;
472 /* Do frame number propagation only if this is the output video node.
473 * Frame number either comes from the CSI receivers or it gets
474 * incremented here if H3A is not active.
475 * Note: There is no guarantee that the output buffer will finish
476 * first, so the input number might lag behind by 1 in some cases.
478 if (video == pipe->output && !pipe->do_propagation)
479 buf->vb.v4l2_buf.sequence =
480 atomic_inc_return(&pipe->frame_number);
482 buf->vb.v4l2_buf.sequence = atomic_read(&pipe->frame_number);
484 if (pipe->field != V4L2_FIELD_NONE)
485 buf->vb.v4l2_buf.sequence /= 2;
487 buf->vb.v4l2_buf.field = pipe->field;
489 /* Report pipeline errors to userspace on the capture device side. */
490 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE && pipe->error) {
491 state = VB2_BUF_STATE_ERROR;
494 state = VB2_BUF_STATE_DONE;
497 vb2_buffer_done(&buf->vb, state);
499 spin_lock_irqsave(&video->irqlock, flags);
501 if (list_empty(&video->dmaqueue)) {
502 spin_unlock_irqrestore(&video->irqlock, flags);
504 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE)
505 state = ISP_PIPELINE_QUEUE_OUTPUT
506 | ISP_PIPELINE_STREAM;
508 state = ISP_PIPELINE_QUEUE_INPUT
509 | ISP_PIPELINE_STREAM;
511 spin_lock_irqsave(&pipe->lock, flags);
512 pipe->state &= ~state;
513 if (video->pipe.stream_state == ISP_PIPELINE_STREAM_CONTINUOUS)
514 video->dmaqueue_flags |= ISP_VIDEO_DMAQUEUE_UNDERRUN;
515 spin_unlock_irqrestore(&pipe->lock, flags);
519 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE && pipe->input != NULL) {
520 spin_lock(&pipe->lock);
521 pipe->state &= ~ISP_PIPELINE_STREAM;
522 spin_unlock(&pipe->lock);
525 buf = list_first_entry(&video->dmaqueue, struct isp_buffer,
527 buf->vb.state = VB2_BUF_STATE_ACTIVE;
529 spin_unlock_irqrestore(&video->irqlock, flags);
535 * omap3isp_video_cancel_stream - Cancel stream on a video node
536 * @video: ISP video object
538 * Cancelling a stream mark all buffers on the video node as erroneous and makes
539 * sure no new buffer can be queued.
541 void omap3isp_video_cancel_stream(struct isp_video *video)
545 spin_lock_irqsave(&video->irqlock, flags);
547 while (!list_empty(&video->dmaqueue)) {
548 struct isp_buffer *buf;
550 buf = list_first_entry(&video->dmaqueue,
551 struct isp_buffer, irqlist);
552 list_del(&buf->irqlist);
553 vb2_buffer_done(&buf->vb, VB2_BUF_STATE_ERROR);
558 spin_unlock_irqrestore(&video->irqlock, flags);
562 * omap3isp_video_resume - Perform resume operation on the buffers
563 * @video: ISP video object
564 * @continuous: Pipeline is in single shot mode if 0 or continuous mode otherwise
566 * This function is intended to be used on suspend/resume scenario. It
567 * requests video queue layer to discard buffers marked as DONE if it's in
568 * continuous mode and requests ISP modules to queue again the ACTIVE buffer
571 void omap3isp_video_resume(struct isp_video *video, int continuous)
573 struct isp_buffer *buf = NULL;
575 if (continuous && video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE) {
576 mutex_lock(&video->queue_lock);
577 vb2_discard_done(video->queue);
578 mutex_unlock(&video->queue_lock);
581 if (!list_empty(&video->dmaqueue)) {
582 buf = list_first_entry(&video->dmaqueue,
583 struct isp_buffer, irqlist);
584 video->ops->queue(video, buf);
585 video->dmaqueue_flags |= ISP_VIDEO_DMAQUEUE_QUEUED;
588 video->dmaqueue_flags |= ISP_VIDEO_DMAQUEUE_UNDERRUN;
592 /* -----------------------------------------------------------------------------
597 isp_video_querycap(struct file *file, void *fh, struct v4l2_capability *cap)
599 struct isp_video *video = video_drvdata(file);
601 strlcpy(cap->driver, ISP_VIDEO_DRIVER_NAME, sizeof(cap->driver));
602 strlcpy(cap->card, video->video.name, sizeof(cap->card));
603 strlcpy(cap->bus_info, "media", sizeof(cap->bus_info));
605 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE)
606 cap->capabilities = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;
608 cap->capabilities = V4L2_CAP_VIDEO_OUTPUT | V4L2_CAP_STREAMING;
614 isp_video_get_format(struct file *file, void *fh, struct v4l2_format *format)
616 struct isp_video_fh *vfh = to_isp_video_fh(fh);
617 struct isp_video *video = video_drvdata(file);
619 if (format->type != video->type)
622 mutex_lock(&video->mutex);
623 *format = vfh->format;
624 mutex_unlock(&video->mutex);
630 isp_video_set_format(struct file *file, void *fh, struct v4l2_format *format)
632 struct isp_video_fh *vfh = to_isp_video_fh(fh);
633 struct isp_video *video = video_drvdata(file);
634 struct v4l2_mbus_framefmt fmt;
636 if (format->type != video->type)
639 /* Replace unsupported field orders with sane defaults. */
640 switch (format->fmt.pix.field) {
641 case V4L2_FIELD_NONE:
642 /* Progressive is supported everywhere. */
644 case V4L2_FIELD_ALTERNATE:
645 /* ALTERNATE is not supported on output nodes. */
646 if (video->type == V4L2_BUF_TYPE_VIDEO_OUTPUT)
647 format->fmt.pix.field = V4L2_FIELD_NONE;
649 case V4L2_FIELD_INTERLACED:
650 /* The ISP has no concept of video standard, select the
651 * top-bottom order when the unqualified interlaced order is
654 format->fmt.pix.field = V4L2_FIELD_INTERLACED_TB;
656 case V4L2_FIELD_INTERLACED_TB:
657 case V4L2_FIELD_INTERLACED_BT:
658 /* Interlaced orders are only supported at the CCDC output. */
659 if (video != &video->isp->isp_ccdc.video_out)
660 format->fmt.pix.field = V4L2_FIELD_NONE;
663 case V4L2_FIELD_BOTTOM:
664 case V4L2_FIELD_SEQ_TB:
665 case V4L2_FIELD_SEQ_BT:
667 /* All other field orders are currently unsupported, default to
670 format->fmt.pix.field = V4L2_FIELD_NONE;
674 /* Fill the bytesperline and sizeimage fields by converting to media bus
675 * format and back to pixel format.
677 isp_video_pix_to_mbus(&format->fmt.pix, &fmt);
678 isp_video_mbus_to_pix(video, &fmt, &format->fmt.pix);
680 mutex_lock(&video->mutex);
681 vfh->format = *format;
682 mutex_unlock(&video->mutex);
688 isp_video_try_format(struct file *file, void *fh, struct v4l2_format *format)
690 struct isp_video *video = video_drvdata(file);
691 struct v4l2_subdev_format fmt;
692 struct v4l2_subdev *subdev;
696 if (format->type != video->type)
699 subdev = isp_video_remote_subdev(video, &pad);
703 isp_video_pix_to_mbus(&format->fmt.pix, &fmt.format);
706 fmt.which = V4L2_SUBDEV_FORMAT_ACTIVE;
707 ret = v4l2_subdev_call(subdev, pad, get_fmt, NULL, &fmt);
709 return ret == -ENOIOCTLCMD ? -ENOTTY : ret;
711 isp_video_mbus_to_pix(video, &fmt.format, &format->fmt.pix);
716 isp_video_cropcap(struct file *file, void *fh, struct v4l2_cropcap *cropcap)
718 struct isp_video *video = video_drvdata(file);
719 struct v4l2_subdev *subdev;
722 subdev = isp_video_remote_subdev(video, NULL);
726 mutex_lock(&video->mutex);
727 ret = v4l2_subdev_call(subdev, video, cropcap, cropcap);
728 mutex_unlock(&video->mutex);
730 return ret == -ENOIOCTLCMD ? -ENOTTY : ret;
734 isp_video_get_crop(struct file *file, void *fh, struct v4l2_crop *crop)
736 struct isp_video *video = video_drvdata(file);
737 struct v4l2_subdev_format format;
738 struct v4l2_subdev *subdev;
742 subdev = isp_video_remote_subdev(video, &pad);
746 /* Try the get crop operation first and fallback to get format if not
749 ret = v4l2_subdev_call(subdev, video, g_crop, crop);
750 if (ret != -ENOIOCTLCMD)
754 format.which = V4L2_SUBDEV_FORMAT_ACTIVE;
755 ret = v4l2_subdev_call(subdev, pad, get_fmt, NULL, &format);
757 return ret == -ENOIOCTLCMD ? -ENOTTY : ret;
761 crop->c.width = format.format.width;
762 crop->c.height = format.format.height;
768 isp_video_set_crop(struct file *file, void *fh, const struct v4l2_crop *crop)
770 struct isp_video *video = video_drvdata(file);
771 struct v4l2_subdev *subdev;
774 subdev = isp_video_remote_subdev(video, NULL);
778 mutex_lock(&video->mutex);
779 ret = v4l2_subdev_call(subdev, video, s_crop, crop);
780 mutex_unlock(&video->mutex);
782 return ret == -ENOIOCTLCMD ? -ENOTTY : ret;
786 isp_video_get_param(struct file *file, void *fh, struct v4l2_streamparm *a)
788 struct isp_video_fh *vfh = to_isp_video_fh(fh);
789 struct isp_video *video = video_drvdata(file);
791 if (video->type != V4L2_BUF_TYPE_VIDEO_OUTPUT ||
792 video->type != a->type)
795 memset(a, 0, sizeof(*a));
796 a->type = V4L2_BUF_TYPE_VIDEO_OUTPUT;
797 a->parm.output.capability = V4L2_CAP_TIMEPERFRAME;
798 a->parm.output.timeperframe = vfh->timeperframe;
804 isp_video_set_param(struct file *file, void *fh, struct v4l2_streamparm *a)
806 struct isp_video_fh *vfh = to_isp_video_fh(fh);
807 struct isp_video *video = video_drvdata(file);
809 if (video->type != V4L2_BUF_TYPE_VIDEO_OUTPUT ||
810 video->type != a->type)
813 if (a->parm.output.timeperframe.denominator == 0)
814 a->parm.output.timeperframe.denominator = 1;
816 vfh->timeperframe = a->parm.output.timeperframe;
822 isp_video_reqbufs(struct file *file, void *fh, struct v4l2_requestbuffers *rb)
824 struct isp_video_fh *vfh = to_isp_video_fh(fh);
825 struct isp_video *video = video_drvdata(file);
828 mutex_lock(&video->queue_lock);
829 ret = vb2_reqbufs(&vfh->queue, rb);
830 mutex_unlock(&video->queue_lock);
836 isp_video_querybuf(struct file *file, void *fh, struct v4l2_buffer *b)
838 struct isp_video_fh *vfh = to_isp_video_fh(fh);
839 struct isp_video *video = video_drvdata(file);
842 mutex_lock(&video->queue_lock);
843 ret = vb2_querybuf(&vfh->queue, b);
844 mutex_unlock(&video->queue_lock);
850 isp_video_qbuf(struct file *file, void *fh, struct v4l2_buffer *b)
852 struct isp_video_fh *vfh = to_isp_video_fh(fh);
853 struct isp_video *video = video_drvdata(file);
856 mutex_lock(&video->queue_lock);
857 ret = vb2_qbuf(&vfh->queue, b);
858 mutex_unlock(&video->queue_lock);
864 isp_video_dqbuf(struct file *file, void *fh, struct v4l2_buffer *b)
866 struct isp_video_fh *vfh = to_isp_video_fh(fh);
867 struct isp_video *video = video_drvdata(file);
870 mutex_lock(&video->queue_lock);
871 ret = vb2_dqbuf(&vfh->queue, b, file->f_flags & O_NONBLOCK);
872 mutex_unlock(&video->queue_lock);
877 static int isp_video_check_external_subdevs(struct isp_video *video,
878 struct isp_pipeline *pipe)
880 struct isp_device *isp = video->isp;
881 struct media_entity *ents[] = {
882 &isp->isp_csi2a.subdev.entity,
883 &isp->isp_csi2c.subdev.entity,
884 &isp->isp_ccp2.subdev.entity,
885 &isp->isp_ccdc.subdev.entity
887 struct media_pad *source_pad;
888 struct media_entity *source = NULL;
889 struct media_entity *sink;
890 struct v4l2_subdev_format fmt;
891 struct v4l2_ext_controls ctrls;
892 struct v4l2_ext_control ctrl;
896 /* Memory-to-memory pipelines have no external subdev. */
897 if (pipe->input != NULL)
900 for (i = 0; i < ARRAY_SIZE(ents); i++) {
901 /* Is the entity part of the pipeline? */
902 if (!(pipe->entities & (1 << ents[i]->id)))
905 /* ISP entities have always sink pad == 0. Find source. */
906 source_pad = media_entity_remote_pad(&ents[i]->pads[0]);
907 if (source_pad == NULL)
910 source = source_pad->entity;
916 dev_warn(isp->dev, "can't find source, failing now\n");
920 if (media_entity_type(source) != MEDIA_ENT_T_V4L2_SUBDEV)
923 pipe->external = media_entity_to_v4l2_subdev(source);
925 fmt.pad = source_pad->index;
926 fmt.which = V4L2_SUBDEV_FORMAT_ACTIVE;
927 ret = v4l2_subdev_call(media_entity_to_v4l2_subdev(sink),
928 pad, get_fmt, NULL, &fmt);
929 if (unlikely(ret < 0)) {
930 dev_warn(isp->dev, "get_fmt returned null!\n");
934 pipe->external_width =
935 omap3isp_video_format_info(fmt.format.code)->width;
937 memset(&ctrls, 0, sizeof(ctrls));
938 memset(&ctrl, 0, sizeof(ctrl));
940 ctrl.id = V4L2_CID_PIXEL_RATE;
943 ctrls.controls = &ctrl;
945 ret = v4l2_g_ext_ctrls(pipe->external->ctrl_handler, &ctrls);
947 dev_warn(isp->dev, "no pixel rate control in subdev %s\n",
948 pipe->external->name);
952 pipe->external_rate = ctrl.value64;
954 if (pipe->entities & (1 << isp->isp_ccdc.subdev.entity.id)) {
955 unsigned int rate = UINT_MAX;
957 * Check that maximum allowed CCDC pixel rate isn't
958 * exceeded by the pixel rate.
960 omap3isp_ccdc_max_rate(&isp->isp_ccdc, &rate);
961 if (pipe->external_rate > rate)
971 * Every ISP pipeline has a single input and a single output. The input can be
972 * either a sensor or a video node. The output is always a video node.
974 * As every pipeline has an output video node, the ISP video objects at the
975 * pipeline output stores the pipeline state. It tracks the streaming state of
976 * both the input and output, as well as the availability of buffers.
978 * In sensor-to-memory mode, frames are always available at the pipeline input.
979 * Starting the sensor usually requires I2C transfers and must be done in
980 * interruptible context. The pipeline is started and stopped synchronously
981 * to the stream on/off commands. All modules in the pipeline will get their
982 * subdev set stream handler called. The module at the end of the pipeline must
983 * delay starting the hardware until buffers are available at its output.
985 * In memory-to-memory mode, starting/stopping the stream requires
986 * synchronization between the input and output. ISP modules can't be stopped
987 * in the middle of a frame, and at least some of the modules seem to become
988 * busy as soon as they're started, even if they don't receive a frame start
989 * event. For that reason frames need to be processed in single-shot mode. The
990 * driver needs to wait until a frame is completely processed and written to
991 * memory before restarting the pipeline for the next frame. Pipelined
992 * processing might be possible but requires more testing.
994 * Stream start must be delayed until buffers are available at both the input
995 * and output. The pipeline must be started in the videobuf queue callback with
996 * the buffers queue spinlock held. The modules subdev set stream operation must
1000 isp_video_streamon(struct file *file, void *fh, enum v4l2_buf_type type)
1002 struct isp_video_fh *vfh = to_isp_video_fh(fh);
1003 struct isp_video *video = video_drvdata(file);
1004 enum isp_pipeline_state state;
1005 struct isp_pipeline *pipe;
1006 unsigned long flags;
1009 if (type != video->type)
1012 mutex_lock(&video->stream_lock);
1014 /* Start streaming on the pipeline. No link touching an entity in the
1015 * pipeline can be activated or deactivated once streaming is started.
1017 pipe = video->video.entity.pipe
1018 ? to_isp_pipeline(&video->video.entity) : &video->pipe;
1022 if (video->isp->pdata->set_constraints)
1023 video->isp->pdata->set_constraints(video->isp, true);
1024 pipe->l3_ick = clk_get_rate(video->isp->clock[ISP_CLK_L3_ICK]);
1025 pipe->max_rate = pipe->l3_ick;
1027 ret = media_entity_pipeline_start(&video->video.entity, &pipe->pipe);
1029 goto err_pipeline_start;
1031 /* Verify that the currently configured format matches the output of
1032 * the connected subdev.
1034 ret = isp_video_check_format(video, vfh);
1036 goto err_check_format;
1038 video->bpl_padding = ret;
1039 video->bpl_value = vfh->format.fmt.pix.bytesperline;
1041 ret = isp_video_get_graph_data(video, pipe);
1043 goto err_check_format;
1045 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE)
1046 state = ISP_PIPELINE_STREAM_OUTPUT | ISP_PIPELINE_IDLE_OUTPUT;
1048 state = ISP_PIPELINE_STREAM_INPUT | ISP_PIPELINE_IDLE_INPUT;
1050 ret = isp_video_check_external_subdevs(video, pipe);
1052 goto err_check_format;
1054 pipe->error = false;
1056 spin_lock_irqsave(&pipe->lock, flags);
1057 pipe->state &= ~ISP_PIPELINE_STREAM;
1058 pipe->state |= state;
1059 spin_unlock_irqrestore(&pipe->lock, flags);
1061 /* Set the maximum time per frame as the value requested by userspace.
1062 * This is a soft limit that can be overridden if the hardware doesn't
1063 * support the request limit.
1065 if (video->type == V4L2_BUF_TYPE_VIDEO_OUTPUT)
1066 pipe->max_timeperframe = vfh->timeperframe;
1068 video->queue = &vfh->queue;
1069 INIT_LIST_HEAD(&video->dmaqueue);
1070 atomic_set(&pipe->frame_number, -1);
1071 pipe->field = vfh->format.fmt.pix.field;
1073 mutex_lock(&video->queue_lock);
1074 ret = vb2_streamon(&vfh->queue, type);
1075 mutex_unlock(&video->queue_lock);
1077 goto err_check_format;
1079 /* In sensor-to-memory mode, the stream can be started synchronously
1080 * to the stream on command. In memory-to-memory mode, it will be
1081 * started when buffers are queued on both the input and output.
1083 if (pipe->input == NULL) {
1084 ret = omap3isp_pipeline_set_stream(pipe,
1085 ISP_PIPELINE_STREAM_CONTINUOUS);
1087 goto err_set_stream;
1088 spin_lock_irqsave(&video->irqlock, flags);
1089 if (list_empty(&video->dmaqueue))
1090 video->dmaqueue_flags |= ISP_VIDEO_DMAQUEUE_UNDERRUN;
1091 spin_unlock_irqrestore(&video->irqlock, flags);
1094 mutex_unlock(&video->stream_lock);
1098 mutex_lock(&video->queue_lock);
1099 vb2_streamoff(&vfh->queue, type);
1100 mutex_unlock(&video->queue_lock);
1102 media_entity_pipeline_stop(&video->video.entity);
1104 if (video->isp->pdata->set_constraints)
1105 video->isp->pdata->set_constraints(video->isp, false);
1106 /* The DMA queue must be emptied here, otherwise CCDC interrupts that
1107 * will get triggered the next time the CCDC is powered up will try to
1108 * access buffers that might have been freed but still present in the
1109 * DMA queue. This can easily get triggered if the above
1110 * omap3isp_pipeline_set_stream() call fails on a system with a
1111 * free-running sensor.
1113 INIT_LIST_HEAD(&video->dmaqueue);
1114 video->queue = NULL;
1116 mutex_unlock(&video->stream_lock);
1121 isp_video_streamoff(struct file *file, void *fh, enum v4l2_buf_type type)
1123 struct isp_video_fh *vfh = to_isp_video_fh(fh);
1124 struct isp_video *video = video_drvdata(file);
1125 struct isp_pipeline *pipe = to_isp_pipeline(&video->video.entity);
1126 enum isp_pipeline_state state;
1127 unsigned int streaming;
1128 unsigned long flags;
1130 if (type != video->type)
1133 mutex_lock(&video->stream_lock);
1135 /* Make sure we're not streaming yet. */
1136 mutex_lock(&video->queue_lock);
1137 streaming = vb2_is_streaming(&vfh->queue);
1138 mutex_unlock(&video->queue_lock);
1143 /* Update the pipeline state. */
1144 if (video->type == V4L2_BUF_TYPE_VIDEO_CAPTURE)
1145 state = ISP_PIPELINE_STREAM_OUTPUT
1146 | ISP_PIPELINE_QUEUE_OUTPUT;
1148 state = ISP_PIPELINE_STREAM_INPUT
1149 | ISP_PIPELINE_QUEUE_INPUT;
1151 spin_lock_irqsave(&pipe->lock, flags);
1152 pipe->state &= ~state;
1153 spin_unlock_irqrestore(&pipe->lock, flags);
1155 /* Stop the stream. */
1156 omap3isp_pipeline_set_stream(pipe, ISP_PIPELINE_STREAM_STOPPED);
1157 omap3isp_video_cancel_stream(video);
1159 mutex_lock(&video->queue_lock);
1160 vb2_streamoff(&vfh->queue, type);
1161 mutex_unlock(&video->queue_lock);
1162 video->queue = NULL;
1163 video->error = false;
1165 if (video->isp->pdata->set_constraints)
1166 video->isp->pdata->set_constraints(video->isp, false);
1167 media_entity_pipeline_stop(&video->video.entity);
1170 mutex_unlock(&video->stream_lock);
1175 isp_video_enum_input(struct file *file, void *fh, struct v4l2_input *input)
1177 if (input->index > 0)
1180 strlcpy(input->name, "camera", sizeof(input->name));
1181 input->type = V4L2_INPUT_TYPE_CAMERA;
1187 isp_video_g_input(struct file *file, void *fh, unsigned int *input)
1195 isp_video_s_input(struct file *file, void *fh, unsigned int input)
1197 return input == 0 ? 0 : -EINVAL;
1200 static const struct v4l2_ioctl_ops isp_video_ioctl_ops = {
1201 .vidioc_querycap = isp_video_querycap,
1202 .vidioc_g_fmt_vid_cap = isp_video_get_format,
1203 .vidioc_s_fmt_vid_cap = isp_video_set_format,
1204 .vidioc_try_fmt_vid_cap = isp_video_try_format,
1205 .vidioc_g_fmt_vid_out = isp_video_get_format,
1206 .vidioc_s_fmt_vid_out = isp_video_set_format,
1207 .vidioc_try_fmt_vid_out = isp_video_try_format,
1208 .vidioc_cropcap = isp_video_cropcap,
1209 .vidioc_g_crop = isp_video_get_crop,
1210 .vidioc_s_crop = isp_video_set_crop,
1211 .vidioc_g_parm = isp_video_get_param,
1212 .vidioc_s_parm = isp_video_set_param,
1213 .vidioc_reqbufs = isp_video_reqbufs,
1214 .vidioc_querybuf = isp_video_querybuf,
1215 .vidioc_qbuf = isp_video_qbuf,
1216 .vidioc_dqbuf = isp_video_dqbuf,
1217 .vidioc_streamon = isp_video_streamon,
1218 .vidioc_streamoff = isp_video_streamoff,
1219 .vidioc_enum_input = isp_video_enum_input,
1220 .vidioc_g_input = isp_video_g_input,
1221 .vidioc_s_input = isp_video_s_input,
1224 /* -----------------------------------------------------------------------------
1225 * V4L2 file operations
1228 static int isp_video_open(struct file *file)
1230 struct isp_video *video = video_drvdata(file);
1231 struct isp_video_fh *handle;
1232 struct vb2_queue *queue;
1235 handle = kzalloc(sizeof(*handle), GFP_KERNEL);
1239 v4l2_fh_init(&handle->vfh, &video->video);
1240 v4l2_fh_add(&handle->vfh);
1242 /* If this is the first user, initialise the pipeline. */
1243 if (omap3isp_get(video->isp) == NULL) {
1248 ret = omap3isp_pipeline_pm_use(&video->video.entity, 1);
1250 omap3isp_put(video->isp);
1254 queue = &handle->queue;
1255 queue->type = video->type;
1256 queue->io_modes = VB2_MMAP | VB2_USERPTR;
1257 queue->drv_priv = handle;
1258 queue->ops = &isp_video_queue_ops;
1259 queue->mem_ops = &vb2_dma_contig_memops;
1260 queue->buf_struct_size = sizeof(struct isp_buffer);
1261 queue->timestamp_flags = V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC;
1263 ret = vb2_queue_init(&handle->queue);
1265 omap3isp_put(video->isp);
1269 memset(&handle->format, 0, sizeof(handle->format));
1270 handle->format.type = video->type;
1271 handle->timeperframe.denominator = 1;
1273 handle->video = video;
1274 file->private_data = &handle->vfh;
1278 v4l2_fh_del(&handle->vfh);
1285 static int isp_video_release(struct file *file)
1287 struct isp_video *video = video_drvdata(file);
1288 struct v4l2_fh *vfh = file->private_data;
1289 struct isp_video_fh *handle = to_isp_video_fh(vfh);
1291 /* Disable streaming and free the buffers queue resources. */
1292 isp_video_streamoff(file, vfh, video->type);
1294 mutex_lock(&video->queue_lock);
1295 vb2_queue_release(&handle->queue);
1296 mutex_unlock(&video->queue_lock);
1298 omap3isp_pipeline_pm_use(&video->video.entity, 0);
1300 /* Release the file handle. */
1303 file->private_data = NULL;
1305 omap3isp_put(video->isp);
1310 static unsigned int isp_video_poll(struct file *file, poll_table *wait)
1312 struct isp_video_fh *vfh = to_isp_video_fh(file->private_data);
1313 struct isp_video *video = video_drvdata(file);
1316 mutex_lock(&video->queue_lock);
1317 ret = vb2_poll(&vfh->queue, file, wait);
1318 mutex_unlock(&video->queue_lock);
1323 static int isp_video_mmap(struct file *file, struct vm_area_struct *vma)
1325 struct isp_video_fh *vfh = to_isp_video_fh(file->private_data);
1326 struct isp_video *video = video_drvdata(file);
1329 mutex_lock(&video->queue_lock);
1330 ret = vb2_mmap(&vfh->queue, vma);
1331 mutex_unlock(&video->queue_lock);
1336 static struct v4l2_file_operations isp_video_fops = {
1337 .owner = THIS_MODULE,
1338 .unlocked_ioctl = video_ioctl2,
1339 .open = isp_video_open,
1340 .release = isp_video_release,
1341 .poll = isp_video_poll,
1342 .mmap = isp_video_mmap,
1345 /* -----------------------------------------------------------------------------
1349 static const struct isp_video_operations isp_video_dummy_ops = {
1352 int omap3isp_video_init(struct isp_video *video, const char *name)
1354 const char *direction;
1357 switch (video->type) {
1358 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1359 direction = "output";
1360 video->pad.flags = MEDIA_PAD_FL_SINK
1361 | MEDIA_PAD_FL_MUST_CONNECT;
1363 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1364 direction = "input";
1365 video->pad.flags = MEDIA_PAD_FL_SOURCE
1366 | MEDIA_PAD_FL_MUST_CONNECT;
1367 video->video.vfl_dir = VFL_DIR_TX;
1374 video->alloc_ctx = vb2_dma_contig_init_ctx(video->isp->dev);
1375 if (IS_ERR(video->alloc_ctx))
1376 return PTR_ERR(video->alloc_ctx);
1378 ret = media_entity_init(&video->video.entity, 1, &video->pad, 0);
1380 vb2_dma_contig_cleanup_ctx(video->alloc_ctx);
1384 mutex_init(&video->mutex);
1385 atomic_set(&video->active, 0);
1387 spin_lock_init(&video->pipe.lock);
1388 mutex_init(&video->stream_lock);
1389 mutex_init(&video->queue_lock);
1390 spin_lock_init(&video->irqlock);
1392 /* Initialize the video device. */
1393 if (video->ops == NULL)
1394 video->ops = &isp_video_dummy_ops;
1396 video->video.fops = &isp_video_fops;
1397 snprintf(video->video.name, sizeof(video->video.name),
1398 "OMAP3 ISP %s %s", name, direction);
1399 video->video.vfl_type = VFL_TYPE_GRABBER;
1400 video->video.release = video_device_release_empty;
1401 video->video.ioctl_ops = &isp_video_ioctl_ops;
1402 video->pipe.stream_state = ISP_PIPELINE_STREAM_STOPPED;
1404 video_set_drvdata(&video->video, video);
1409 void omap3isp_video_cleanup(struct isp_video *video)
1411 vb2_dma_contig_cleanup_ctx(video->alloc_ctx);
1412 media_entity_cleanup(&video->video.entity);
1413 mutex_destroy(&video->queue_lock);
1414 mutex_destroy(&video->stream_lock);
1415 mutex_destroy(&video->mutex);
1418 int omap3isp_video_register(struct isp_video *video, struct v4l2_device *vdev)
1422 video->video.v4l2_dev = vdev;
1424 ret = video_register_device(&video->video, VFL_TYPE_GRABBER, -1);
1426 dev_err(video->isp->dev,
1427 "%s: could not register video device (%d)\n",
1433 void omap3isp_video_unregister(struct isp_video *video)
1435 if (video_is_registered(&video->video))
1436 video_unregister_device(&video->video);