2 * V4L2 Driver for SuperH Mobile CEU interface
4 * Copyright (C) 2008 Magnus Damm
6 * Based on V4L2 Driver for PXA camera host - "pxa_camera.c",
8 * Copyright (C) 2006, Sascha Hauer, Pengutronix
9 * Copyright (C) 2008, Guennadi Liakhovetski <kernel@pengutronix.de>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
17 #include <linux/init.h>
18 #include <linux/module.h>
20 #include <linux/delay.h>
21 #include <linux/dma-mapping.h>
22 #include <linux/errno.h>
24 #include <linux/interrupt.h>
25 #include <linux/kernel.h>
27 #include <linux/moduleparam.h>
28 #include <linux/time.h>
29 #include <linux/version.h>
30 #include <linux/device.h>
31 #include <linux/platform_device.h>
32 #include <linux/videodev2.h>
33 #include <linux/clk.h>
35 #include <media/v4l2-common.h>
36 #include <media/v4l2-dev.h>
37 #include <media/soc_camera.h>
38 #include <media/sh_mobile_ceu.h>
39 #include <media/videobuf-dma-contig.h>
41 /* register offsets for sh7722 / sh7723 */
43 #define CAPSR 0x00 /* Capture start register */
44 #define CAPCR 0x04 /* Capture control register */
45 #define CAMCR 0x08 /* Capture interface control register */
46 #define CMCYR 0x0c /* Capture interface cycle register */
47 #define CAMOR 0x10 /* Capture interface offset register */
48 #define CAPWR 0x14 /* Capture interface width register */
49 #define CAIFR 0x18 /* Capture interface input format register */
50 #define CSTCR 0x20 /* Camera strobe control register (<= sh7722) */
51 #define CSECR 0x24 /* Camera strobe emission count register (<= sh7722) */
52 #define CRCNTR 0x28 /* CEU register control register */
53 #define CRCMPR 0x2c /* CEU register forcible control register */
54 #define CFLCR 0x30 /* Capture filter control register */
55 #define CFSZR 0x34 /* Capture filter size clip register */
56 #define CDWDR 0x38 /* Capture destination width register */
57 #define CDAYR 0x3c /* Capture data address Y register */
58 #define CDACR 0x40 /* Capture data address C register */
59 #define CDBYR 0x44 /* Capture data bottom-field address Y register */
60 #define CDBCR 0x48 /* Capture data bottom-field address C register */
61 #define CBDSR 0x4c /* Capture bundle destination size register */
62 #define CFWCR 0x5c /* Firewall operation control register */
63 #define CLFCR 0x60 /* Capture low-pass filter control register */
64 #define CDOCR 0x64 /* Capture data output control register */
65 #define CDDCR 0x68 /* Capture data complexity level register */
66 #define CDDAR 0x6c /* Capture data complexity level address register */
67 #define CEIER 0x70 /* Capture event interrupt enable register */
68 #define CETCR 0x74 /* Capture event flag clear register */
69 #define CSTSR 0x7c /* Capture status register */
70 #define CSRTR 0x80 /* Capture software reset register */
71 #define CDSSR 0x84 /* Capture data size register */
72 #define CDAYR2 0x90 /* Capture data address Y register 2 */
73 #define CDACR2 0x94 /* Capture data address C register 2 */
74 #define CDBYR2 0x98 /* Capture data bottom-field address Y register 2 */
75 #define CDBCR2 0x9c /* Capture data bottom-field address C register 2 */
77 /* per video frame buffer */
78 struct sh_mobile_ceu_buffer {
79 struct videobuf_buffer vb; /* v4l buffer must be first */
80 const struct soc_camera_data_format *fmt;
83 struct sh_mobile_ceu_dev {
85 struct soc_camera_host ici;
86 struct soc_camera_device *icd;
91 unsigned long video_limit;
93 /* lock used to protect videobuf */
95 struct list_head capture;
96 struct videobuf_buffer *active;
98 struct sh_mobile_ceu_info *pdata;
101 static void ceu_write(struct sh_mobile_ceu_dev *priv,
102 unsigned long reg_offs, unsigned long data)
104 iowrite32(data, priv->base + reg_offs);
107 static unsigned long ceu_read(struct sh_mobile_ceu_dev *priv,
108 unsigned long reg_offs)
110 return ioread32(priv->base + reg_offs);
114 * Videobuf operations
116 static int sh_mobile_ceu_videobuf_setup(struct videobuf_queue *vq,
120 struct soc_camera_device *icd = vq->priv_data;
121 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
122 struct sh_mobile_ceu_dev *pcdev = ici->priv;
123 int bytes_per_pixel = (icd->current_fmt->depth + 7) >> 3;
125 *size = PAGE_ALIGN(icd->width * icd->height * bytes_per_pixel);
130 if (pcdev->video_limit) {
131 while (*size * *count > pcdev->video_limit)
135 dev_dbg(&icd->dev, "count=%d, size=%d\n", *count, *size);
140 static void free_buffer(struct videobuf_queue *vq,
141 struct sh_mobile_ceu_buffer *buf)
143 struct soc_camera_device *icd = vq->priv_data;
145 dev_dbg(&icd->dev, "%s (vb=0x%p) 0x%08lx %zd\n", __func__,
146 &buf->vb, buf->vb.baddr, buf->vb.bsize);
151 videobuf_dma_contig_free(vq, &buf->vb);
152 dev_dbg(&icd->dev, "%s freed\n", __func__);
153 buf->vb.state = VIDEOBUF_NEEDS_INIT;
156 static void sh_mobile_ceu_capture(struct sh_mobile_ceu_dev *pcdev)
158 ceu_write(pcdev, CEIER, ceu_read(pcdev, CEIER) & ~1);
159 ceu_write(pcdev, CETCR, ~ceu_read(pcdev, CETCR) & 0x0317f313);
160 ceu_write(pcdev, CEIER, ceu_read(pcdev, CEIER) | 1);
162 ceu_write(pcdev, CAPCR, ceu_read(pcdev, CAPCR) & ~0x10000);
164 ceu_write(pcdev, CETCR, 0x0317f313 ^ 0x10);
167 pcdev->active->state = VIDEOBUF_ACTIVE;
168 ceu_write(pcdev, CDAYR, videobuf_to_dma_contig(pcdev->active));
169 ceu_write(pcdev, CAPSR, 0x1); /* start capture */
173 static int sh_mobile_ceu_videobuf_prepare(struct videobuf_queue *vq,
174 struct videobuf_buffer *vb,
175 enum v4l2_field field)
177 struct soc_camera_device *icd = vq->priv_data;
178 struct sh_mobile_ceu_buffer *buf;
181 buf = container_of(vb, struct sh_mobile_ceu_buffer, vb);
183 dev_dbg(&icd->dev, "%s (vb=0x%p) 0x%08lx %zd\n", __func__,
184 vb, vb->baddr, vb->bsize);
186 /* Added list head initialization on alloc */
187 WARN_ON(!list_empty(&vb->queue));
190 /* This can be useful if you want to see if we actually fill
191 * the buffer with something */
192 memset((void *)vb->baddr, 0xaa, vb->bsize);
195 BUG_ON(NULL == icd->current_fmt);
197 if (buf->fmt != icd->current_fmt ||
198 vb->width != icd->width ||
199 vb->height != icd->height ||
200 vb->field != field) {
201 buf->fmt = icd->current_fmt;
202 vb->width = icd->width;
203 vb->height = icd->height;
205 vb->state = VIDEOBUF_NEEDS_INIT;
208 vb->size = vb->width * vb->height * ((buf->fmt->depth + 7) >> 3);
209 if (0 != vb->baddr && vb->bsize < vb->size) {
214 if (vb->state == VIDEOBUF_NEEDS_INIT) {
215 ret = videobuf_iolock(vq, vb, NULL);
218 vb->state = VIDEOBUF_PREPARED;
223 free_buffer(vq, buf);
228 static void sh_mobile_ceu_videobuf_queue(struct videobuf_queue *vq,
229 struct videobuf_buffer *vb)
231 struct soc_camera_device *icd = vq->priv_data;
232 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
233 struct sh_mobile_ceu_dev *pcdev = ici->priv;
236 dev_dbg(&icd->dev, "%s (vb=0x%p) 0x%08lx %zd\n", __func__,
237 vb, vb->baddr, vb->bsize);
239 vb->state = VIDEOBUF_QUEUED;
240 spin_lock_irqsave(&pcdev->lock, flags);
241 list_add_tail(&vb->queue, &pcdev->capture);
243 if (!pcdev->active) {
245 sh_mobile_ceu_capture(pcdev);
248 spin_unlock_irqrestore(&pcdev->lock, flags);
251 static void sh_mobile_ceu_videobuf_release(struct videobuf_queue *vq,
252 struct videobuf_buffer *vb)
254 free_buffer(vq, container_of(vb, struct sh_mobile_ceu_buffer, vb));
257 static struct videobuf_queue_ops sh_mobile_ceu_videobuf_ops = {
258 .buf_setup = sh_mobile_ceu_videobuf_setup,
259 .buf_prepare = sh_mobile_ceu_videobuf_prepare,
260 .buf_queue = sh_mobile_ceu_videobuf_queue,
261 .buf_release = sh_mobile_ceu_videobuf_release,
264 static irqreturn_t sh_mobile_ceu_irq(int irq, void *data)
266 struct sh_mobile_ceu_dev *pcdev = data;
267 struct videobuf_buffer *vb;
270 spin_lock_irqsave(&pcdev->lock, flags);
273 list_del_init(&vb->queue);
275 if (!list_empty(&pcdev->capture))
276 pcdev->active = list_entry(pcdev->capture.next,
277 struct videobuf_buffer, queue);
279 pcdev->active = NULL;
281 sh_mobile_ceu_capture(pcdev);
283 vb->state = VIDEOBUF_DONE;
284 do_gettimeofday(&vb->ts);
287 spin_unlock_irqrestore(&pcdev->lock, flags);
292 /* Called with .video_lock held */
293 static int sh_mobile_ceu_add_device(struct soc_camera_device *icd)
295 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
296 struct sh_mobile_ceu_dev *pcdev = ici->priv;
303 "SuperH Mobile CEU driver attached to camera %d\n",
306 ret = icd->ops->init(icd);
310 clk_enable(pcdev->clk);
312 ceu_write(pcdev, CAPSR, 1 << 16); /* reset */
313 while (ceu_read(pcdev, CSTSR) & 1)
321 /* Called with .video_lock held */
322 static void sh_mobile_ceu_remove_device(struct soc_camera_device *icd)
324 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
325 struct sh_mobile_ceu_dev *pcdev = ici->priv;
328 BUG_ON(icd != pcdev->icd);
330 /* disable capture, disable interrupts */
331 ceu_write(pcdev, CEIER, 0);
332 ceu_write(pcdev, CAPSR, 1 << 16); /* reset */
334 /* make sure active buffer is canceled */
335 spin_lock_irqsave(&pcdev->lock, flags);
337 list_del(&pcdev->active->queue);
338 pcdev->active->state = VIDEOBUF_ERROR;
339 wake_up_all(&pcdev->active->done);
340 pcdev->active = NULL;
342 spin_unlock_irqrestore(&pcdev->lock, flags);
344 clk_disable(pcdev->clk);
346 icd->ops->release(icd);
349 "SuperH Mobile CEU driver detached from camera %d\n",
355 static int sh_mobile_ceu_set_bus_param(struct soc_camera_device *icd,
358 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
359 struct sh_mobile_ceu_dev *pcdev = ici->priv;
360 int ret, buswidth, width, cfszr_width, cdwdr_width;
361 unsigned long camera_flags, common_flags, value;
363 camera_flags = icd->ops->query_bus_param(icd);
364 common_flags = soc_camera_bus_param_compatible(camera_flags,
365 pcdev->pdata->flags);
369 ret = icd->ops->set_bus_param(icd, common_flags);
373 switch (common_flags & SOCAM_DATAWIDTH_MASK) {
374 case SOCAM_DATAWIDTH_8:
377 case SOCAM_DATAWIDTH_16:
384 ceu_write(pcdev, CRCNTR, 0);
385 ceu_write(pcdev, CRCMPR, 0);
388 value |= (common_flags & SOCAM_VSYNC_ACTIVE_LOW) ? (1 << 1) : 0;
389 value |= (common_flags & SOCAM_HSYNC_ACTIVE_LOW) ? (1 << 0) : 0;
390 value |= (buswidth == 16) ? (1 << 12) : 0;
391 ceu_write(pcdev, CAMCR, value);
393 ceu_write(pcdev, CAPCR, 0x00300000);
394 ceu_write(pcdev, CAIFR, 0);
398 width = icd->width * (icd->current_fmt->depth / 8);
399 width = (buswidth == 16) ? width / 2 : width;
400 cfszr_width = (buswidth == 8) ? width / 2 : width;
401 cdwdr_width = (buswidth == 16) ? width * 2 : width;
403 ceu_write(pcdev, CAMOR, 0);
404 ceu_write(pcdev, CAPWR, (icd->height << 16) | width);
405 ceu_write(pcdev, CFLCR, 0); /* data fetch mode - no scaling */
406 ceu_write(pcdev, CFSZR, (icd->height << 16) | cfszr_width);
407 ceu_write(pcdev, CLFCR, 0); /* data fetch mode - no lowpass filter */
409 /* A few words about byte order (observed in Big Endian mode)
411 * In data fetch mode bytes are received in chunks of 8 bytes.
412 * D0, D1, D2, D3, D4, D5, D6, D7 (D0 received first)
414 * The data is however by default written to memory in reverse order:
415 * D7, D6, D5, D4, D3, D2, D1, D0 (D7 written to lowest byte)
417 * The lowest three bits of CDOCR allows us to do swapping,
418 * using 7 we swap the data bytes to match the incoming order:
419 * D0, D1, D2, D3, D4, D5, D6, D7
421 ceu_write(pcdev, CDOCR, 0x00000017);
423 ceu_write(pcdev, CDWDR, cdwdr_width);
424 ceu_write(pcdev, CFWCR, 0); /* keep "datafetch firewall" disabled */
426 /* not in bundle mode: skip CBDSR, CDAYR2, CDACR2, CDBYR2, CDBCR2 */
427 /* in data fetch mode: no need for CDACR, CDBYR, CDBCR */
432 static int sh_mobile_ceu_try_bus_param(struct soc_camera_device *icd)
434 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
435 struct sh_mobile_ceu_dev *pcdev = ici->priv;
436 unsigned long camera_flags, common_flags;
438 camera_flags = icd->ops->query_bus_param(icd);
439 common_flags = soc_camera_bus_param_compatible(camera_flags,
440 pcdev->pdata->flags);
447 static int sh_mobile_ceu_get_formats(struct soc_camera_device *icd, int idx,
448 struct soc_camera_format_xlate *xlate)
450 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
454 ret = sh_mobile_ceu_try_bus_param(icd);
458 switch (icd->formats[idx].fourcc) {
460 /* Generic pass-through */
463 xlate->host_fmt = icd->formats + idx;
464 xlate->cam_fmt = icd->formats + idx;
465 xlate->buswidth = icd->formats[idx].depth;
468 "Providing format %s in pass-through mode\n",
469 icd->formats[idx].name);
476 static int sh_mobile_ceu_set_fmt(struct soc_camera_device *icd,
477 __u32 pixfmt, struct v4l2_rect *rect)
479 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
480 const struct soc_camera_format_xlate *xlate;
483 xlate = soc_camera_xlate_by_fourcc(icd, pixfmt);
485 dev_warn(&ici->dev, "Format %x not found\n", pixfmt);
490 case 0: /* Only geometry change */
491 ret = icd->ops->set_fmt(icd, pixfmt, rect);
494 ret = icd->ops->set_fmt(icd, xlate->cam_fmt->fourcc, rect);
497 if (pixfmt && !ret) {
498 icd->buswidth = xlate->buswidth;
499 icd->current_fmt = xlate->host_fmt;
505 static int sh_mobile_ceu_try_fmt(struct soc_camera_device *icd,
506 struct v4l2_format *f)
508 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
509 const struct soc_camera_format_xlate *xlate;
510 __u32 pixfmt = f->fmt.pix.pixelformat;
512 xlate = soc_camera_xlate_by_fourcc(icd, pixfmt);
514 dev_warn(&ici->dev, "Format %x not found\n", pixfmt);
518 /* FIXME: calculate using depth and bus width */
520 if (f->fmt.pix.height < 4)
521 f->fmt.pix.height = 4;
522 if (f->fmt.pix.height > 1920)
523 f->fmt.pix.height = 1920;
524 if (f->fmt.pix.width < 2)
525 f->fmt.pix.width = 2;
526 if (f->fmt.pix.width > 2560)
527 f->fmt.pix.width = 2560;
528 f->fmt.pix.width &= ~0x01;
529 f->fmt.pix.height &= ~0x03;
531 f->fmt.pix.bytesperline = f->fmt.pix.width *
532 DIV_ROUND_UP(xlate->host_fmt->depth, 8);
533 f->fmt.pix.sizeimage = f->fmt.pix.height * f->fmt.pix.bytesperline;
535 /* limit to sensor capabilities */
536 return icd->ops->try_fmt(icd, f);
539 static int sh_mobile_ceu_reqbufs(struct soc_camera_file *icf,
540 struct v4l2_requestbuffers *p)
544 /* This is for locking debugging only. I removed spinlocks and now I
545 * check whether .prepare is ever called on a linked buffer, or whether
546 * a dma IRQ can occur for an in-work or unlinked buffer. Until now
547 * it hadn't triggered */
548 for (i = 0; i < p->count; i++) {
549 struct sh_mobile_ceu_buffer *buf;
551 buf = container_of(icf->vb_vidq.bufs[i],
552 struct sh_mobile_ceu_buffer, vb);
553 INIT_LIST_HEAD(&buf->vb.queue);
559 static unsigned int sh_mobile_ceu_poll(struct file *file, poll_table *pt)
561 struct soc_camera_file *icf = file->private_data;
562 struct sh_mobile_ceu_buffer *buf;
564 buf = list_entry(icf->vb_vidq.stream.next,
565 struct sh_mobile_ceu_buffer, vb.stream);
567 poll_wait(file, &buf->vb.done, pt);
569 if (buf->vb.state == VIDEOBUF_DONE ||
570 buf->vb.state == VIDEOBUF_ERROR)
571 return POLLIN|POLLRDNORM;
576 static int sh_mobile_ceu_querycap(struct soc_camera_host *ici,
577 struct v4l2_capability *cap)
579 strlcpy(cap->card, "SuperH_Mobile_CEU", sizeof(cap->card));
580 cap->version = KERNEL_VERSION(0, 0, 5);
581 cap->capabilities = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;
585 static void sh_mobile_ceu_init_videobuf(struct videobuf_queue *q,
586 struct soc_camera_device *icd)
588 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
589 struct sh_mobile_ceu_dev *pcdev = ici->priv;
591 videobuf_queue_dma_contig_init(q,
592 &sh_mobile_ceu_videobuf_ops,
593 &ici->dev, &pcdev->lock,
594 V4L2_BUF_TYPE_VIDEO_CAPTURE,
596 sizeof(struct sh_mobile_ceu_buffer),
600 static struct soc_camera_host_ops sh_mobile_ceu_host_ops = {
601 .owner = THIS_MODULE,
602 .add = sh_mobile_ceu_add_device,
603 .remove = sh_mobile_ceu_remove_device,
604 .get_formats = sh_mobile_ceu_get_formats,
605 .set_fmt = sh_mobile_ceu_set_fmt,
606 .try_fmt = sh_mobile_ceu_try_fmt,
607 .reqbufs = sh_mobile_ceu_reqbufs,
608 .poll = sh_mobile_ceu_poll,
609 .querycap = sh_mobile_ceu_querycap,
610 .set_bus_param = sh_mobile_ceu_set_bus_param,
611 .init_videobuf = sh_mobile_ceu_init_videobuf,
614 static int sh_mobile_ceu_probe(struct platform_device *pdev)
616 struct sh_mobile_ceu_dev *pcdev;
617 struct resource *res;
623 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
624 irq = platform_get_irq(pdev, 0);
626 dev_err(&pdev->dev, "Not enough CEU platform resources.\n");
631 pcdev = kzalloc(sizeof(*pcdev), GFP_KERNEL);
633 dev_err(&pdev->dev, "Could not allocate pcdev\n");
638 platform_set_drvdata(pdev, pcdev);
639 INIT_LIST_HEAD(&pcdev->capture);
640 spin_lock_init(&pcdev->lock);
642 pcdev->pdata = pdev->dev.platform_data;
645 dev_err(&pdev->dev, "CEU platform data not set.\n");
649 base = ioremap_nocache(res->start, res->end - res->start + 1);
652 dev_err(&pdev->dev, "Unable to ioremap CEU registers.\n");
658 pcdev->video_limit = 0; /* only enabled if second resource exists */
659 pcdev->dev = &pdev->dev;
661 res = platform_get_resource(pdev, IORESOURCE_MEM, 1);
663 err = dma_declare_coherent_memory(&pdev->dev, res->start,
665 (res->end - res->start) + 1,
667 DMA_MEMORY_EXCLUSIVE);
669 dev_err(&pdev->dev, "Unable to declare CEU memory.\n");
674 pcdev->video_limit = (res->end - res->start) + 1;
678 err = request_irq(pcdev->irq, sh_mobile_ceu_irq, IRQF_DISABLED,
679 dev_name(&pdev->dev), pcdev);
681 dev_err(&pdev->dev, "Unable to register CEU interrupt.\n");
682 goto exit_release_mem;
685 snprintf(clk_name, sizeof(clk_name), "ceu%d", pdev->id);
686 pcdev->clk = clk_get(&pdev->dev, clk_name);
687 if (IS_ERR(pcdev->clk)) {
688 dev_err(&pdev->dev, "cannot get clock \"%s\"\n", clk_name);
689 err = PTR_ERR(pcdev->clk);
693 pcdev->ici.priv = pcdev;
694 pcdev->ici.dev.parent = &pdev->dev;
695 pcdev->ici.nr = pdev->id;
696 pcdev->ici.drv_name = dev_name(&pdev->dev);
697 pcdev->ici.ops = &sh_mobile_ceu_host_ops;
699 err = soc_camera_host_register(&pcdev->ici);
708 free_irq(pcdev->irq, pcdev);
710 if (platform_get_resource(pdev, IORESOURCE_MEM, 1))
711 dma_release_declared_memory(&pdev->dev);
720 static int sh_mobile_ceu_remove(struct platform_device *pdev)
722 struct sh_mobile_ceu_dev *pcdev = platform_get_drvdata(pdev);
724 soc_camera_host_unregister(&pcdev->ici);
726 free_irq(pcdev->irq, pcdev);
727 if (platform_get_resource(pdev, IORESOURCE_MEM, 1))
728 dma_release_declared_memory(&pdev->dev);
729 iounmap(pcdev->base);
734 static struct platform_driver sh_mobile_ceu_driver = {
736 .name = "sh_mobile_ceu",
738 .probe = sh_mobile_ceu_probe,
739 .remove = sh_mobile_ceu_remove,
742 static int __init sh_mobile_ceu_init(void)
744 return platform_driver_register(&sh_mobile_ceu_driver);
747 static void __exit sh_mobile_ceu_exit(void)
749 platform_driver_unregister(&sh_mobile_ceu_driver);
752 module_init(sh_mobile_ceu_init);
753 module_exit(sh_mobile_ceu_exit);
755 MODULE_DESCRIPTION("SuperH Mobile CEU driver");
756 MODULE_AUTHOR("Magnus Damm");
757 MODULE_LICENSE("GPL");