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/mutex.h>
33 #include <linux/videodev2.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 static DEFINE_MUTEX(camera_lock);
79 /* per video frame buffer */
80 struct sh_mobile_ceu_buffer {
81 struct videobuf_buffer vb; /* v4l buffer must be first */
82 const struct soc_camera_data_format *fmt;
85 struct sh_mobile_ceu_dev {
87 struct soc_camera_host ici;
88 struct soc_camera_device *icd;
92 unsigned long video_limit;
94 /* lock used to protect videobuf */
96 struct list_head capture;
97 struct videobuf_buffer *active;
99 struct sh_mobile_ceu_info *pdata;
102 static void ceu_write(struct sh_mobile_ceu_dev *priv,
103 unsigned long reg_offs, unsigned long data)
105 iowrite32(data, priv->base + reg_offs);
108 static unsigned long ceu_read(struct sh_mobile_ceu_dev *priv,
109 unsigned long reg_offs)
111 return ioread32(priv->base + reg_offs);
115 * Videobuf operations
117 static int sh_mobile_ceu_videobuf_setup(struct videobuf_queue *vq,
121 struct soc_camera_device *icd = vq->priv_data;
122 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
123 struct sh_mobile_ceu_dev *pcdev = ici->priv;
124 int bytes_per_pixel = (icd->current_fmt->depth + 7) >> 3;
126 *size = PAGE_ALIGN(icd->width * icd->height * bytes_per_pixel);
131 if (pcdev->video_limit) {
132 while (*size * *count > pcdev->video_limit)
136 dev_dbg(&icd->dev, "count=%d, size=%d\n", *count, *size);
141 static void free_buffer(struct videobuf_queue *vq,
142 struct sh_mobile_ceu_buffer *buf)
144 struct soc_camera_device *icd = vq->priv_data;
146 dev_dbg(&icd->dev, "%s (vb=0x%p) 0x%08lx %zd\n", __func__,
147 &buf->vb, buf->vb.baddr, buf->vb.bsize);
152 videobuf_dma_contig_free(vq, &buf->vb);
153 dev_dbg(&icd->dev, "%s freed\n", __func__);
154 buf->vb.state = VIDEOBUF_NEEDS_INIT;
157 static void sh_mobile_ceu_capture(struct sh_mobile_ceu_dev *pcdev)
159 ceu_write(pcdev, CEIER, ceu_read(pcdev, CEIER) & ~1);
160 ceu_write(pcdev, CETCR, ~ceu_read(pcdev, CETCR) & 0x0317f313);
161 ceu_write(pcdev, CEIER, ceu_read(pcdev, CEIER) | 1);
163 ceu_write(pcdev, CAPCR, ceu_read(pcdev, CAPCR) & ~0x10000);
165 ceu_write(pcdev, CETCR, 0x0317f313 ^ 0x10);
168 pcdev->active->state = VIDEOBUF_ACTIVE;
169 ceu_write(pcdev, CDAYR, videobuf_to_dma_contig(pcdev->active));
170 ceu_write(pcdev, CAPSR, 0x1); /* start capture */
174 static int sh_mobile_ceu_videobuf_prepare(struct videobuf_queue *vq,
175 struct videobuf_buffer *vb,
176 enum v4l2_field field)
178 struct soc_camera_device *icd = vq->priv_data;
179 struct sh_mobile_ceu_buffer *buf;
182 buf = container_of(vb, struct sh_mobile_ceu_buffer, vb);
184 dev_dbg(&icd->dev, "%s (vb=0x%p) 0x%08lx %zd\n", __func__,
185 vb, vb->baddr, vb->bsize);
187 /* Added list head initialization on alloc */
188 WARN_ON(!list_empty(&vb->queue));
191 /* This can be useful if you want to see if we actually fill
192 * the buffer with something */
193 memset((void *)vb->baddr, 0xaa, vb->bsize);
196 BUG_ON(NULL == icd->current_fmt);
198 if (buf->fmt != icd->current_fmt ||
199 vb->width != icd->width ||
200 vb->height != icd->height ||
201 vb->field != field) {
202 buf->fmt = icd->current_fmt;
203 vb->width = icd->width;
204 vb->height = icd->height;
206 vb->state = VIDEOBUF_NEEDS_INIT;
209 vb->size = vb->width * vb->height * ((buf->fmt->depth + 7) >> 3);
210 if (0 != vb->baddr && vb->bsize < vb->size) {
215 if (vb->state == VIDEOBUF_NEEDS_INIT) {
216 ret = videobuf_iolock(vq, vb, NULL);
219 vb->state = VIDEOBUF_PREPARED;
224 free_buffer(vq, buf);
229 static void sh_mobile_ceu_videobuf_queue(struct videobuf_queue *vq,
230 struct videobuf_buffer *vb)
232 struct soc_camera_device *icd = vq->priv_data;
233 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
234 struct sh_mobile_ceu_dev *pcdev = ici->priv;
237 dev_dbg(&icd->dev, "%s (vb=0x%p) 0x%08lx %zd\n", __func__,
238 vb, vb->baddr, vb->bsize);
240 vb->state = VIDEOBUF_QUEUED;
241 spin_lock_irqsave(&pcdev->lock, flags);
242 list_add_tail(&vb->queue, &pcdev->capture);
244 if (!pcdev->active) {
246 sh_mobile_ceu_capture(pcdev);
249 spin_unlock_irqrestore(&pcdev->lock, flags);
252 static void sh_mobile_ceu_videobuf_release(struct videobuf_queue *vq,
253 struct videobuf_buffer *vb)
255 free_buffer(vq, container_of(vb, struct sh_mobile_ceu_buffer, vb));
258 static struct videobuf_queue_ops sh_mobile_ceu_videobuf_ops = {
259 .buf_setup = sh_mobile_ceu_videobuf_setup,
260 .buf_prepare = sh_mobile_ceu_videobuf_prepare,
261 .buf_queue = sh_mobile_ceu_videobuf_queue,
262 .buf_release = sh_mobile_ceu_videobuf_release,
265 static irqreturn_t sh_mobile_ceu_irq(int irq, void *data)
267 struct sh_mobile_ceu_dev *pcdev = data;
268 struct videobuf_buffer *vb;
271 spin_lock_irqsave(&pcdev->lock, flags);
274 list_del_init(&vb->queue);
276 if (!list_empty(&pcdev->capture))
277 pcdev->active = list_entry(pcdev->capture.next,
278 struct videobuf_buffer, queue);
280 pcdev->active = NULL;
282 sh_mobile_ceu_capture(pcdev);
284 vb->state = VIDEOBUF_DONE;
285 do_gettimeofday(&vb->ts);
288 spin_unlock_irqrestore(&pcdev->lock, flags);
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;
299 mutex_lock(&camera_lock);
305 "SuperH Mobile CEU driver attached to camera %d\n",
308 ret = icd->ops->init(icd);
312 ceu_write(pcdev, CAPSR, 1 << 16); /* reset */
313 while (ceu_read(pcdev, CSTSR) & 1)
318 mutex_unlock(&camera_lock);
323 static void sh_mobile_ceu_remove_device(struct soc_camera_device *icd)
325 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
326 struct sh_mobile_ceu_dev *pcdev = ici->priv;
329 BUG_ON(icd != pcdev->icd);
331 /* disable capture, disable interrupts */
332 ceu_write(pcdev, CEIER, 0);
333 ceu_write(pcdev, CAPSR, 1 << 16); /* reset */
335 /* make sure active buffer is canceled */
336 spin_lock_irqsave(&pcdev->lock, flags);
338 list_del(&pcdev->active->queue);
339 pcdev->active->state = VIDEOBUF_ERROR;
340 wake_up_all(&pcdev->active->done);
341 pcdev->active = NULL;
343 spin_unlock_irqrestore(&pcdev->lock, flags);
345 icd->ops->release(icd);
348 "SuperH Mobile CEU driver detached from camera %d\n",
354 static int sh_mobile_ceu_set_bus_param(struct soc_camera_device *icd,
357 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
358 struct sh_mobile_ceu_dev *pcdev = ici->priv;
359 int ret, buswidth, width, cfszr_width, cdwdr_width;
360 unsigned long camera_flags, common_flags, value;
362 camera_flags = icd->ops->query_bus_param(icd);
363 common_flags = soc_camera_bus_param_compatible(camera_flags,
364 pcdev->pdata->flags);
368 ret = icd->ops->set_bus_param(icd, common_flags);
372 switch (common_flags & SOCAM_DATAWIDTH_MASK) {
373 case SOCAM_DATAWIDTH_8:
376 case SOCAM_DATAWIDTH_16:
383 ceu_write(pcdev, CRCNTR, 0);
384 ceu_write(pcdev, CRCMPR, 0);
387 value |= (common_flags & SOCAM_VSYNC_ACTIVE_LOW) ? (1 << 1) : 0;
388 value |= (common_flags & SOCAM_HSYNC_ACTIVE_LOW) ? (1 << 0) : 0;
389 value |= (buswidth == 16) ? (1 << 12) : 0;
390 ceu_write(pcdev, CAMCR, value);
392 ceu_write(pcdev, CAPCR, 0x00300000);
393 ceu_write(pcdev, CAIFR, 0);
397 width = icd->width * (icd->current_fmt->depth / 8);
398 width = (buswidth == 16) ? width / 2 : width;
399 cfszr_width = (buswidth == 8) ? width / 2 : width;
400 cdwdr_width = (buswidth == 16) ? width * 2 : width;
402 ceu_write(pcdev, CAMOR, 0);
403 ceu_write(pcdev, CAPWR, (icd->height << 16) | width);
404 ceu_write(pcdev, CFLCR, 0); /* data fetch mode - no scaling */
405 ceu_write(pcdev, CFSZR, (icd->height << 16) | cfszr_width);
406 ceu_write(pcdev, CLFCR, 0); /* data fetch mode - no lowpass filter */
408 /* A few words about byte order (observed in Big Endian mode)
410 * In data fetch mode bytes are received in chunks of 8 bytes.
411 * D0, D1, D2, D3, D4, D5, D6, D7 (D0 received first)
413 * The data is however by default written to memory in reverse order:
414 * D7, D6, D5, D4, D3, D2, D1, D0 (D7 written to lowest byte)
416 * The lowest three bits of CDOCR allows us to do swapping,
417 * using 7 we swap the data bytes to match the incoming order:
418 * D0, D1, D2, D3, D4, D5, D6, D7
420 ceu_write(pcdev, CDOCR, 0x00000017);
422 ceu_write(pcdev, CDWDR, cdwdr_width);
423 ceu_write(pcdev, CFWCR, 0); /* keep "datafetch firewall" disabled */
425 /* not in bundle mode: skip CBDSR, CDAYR2, CDACR2, CDBYR2, CDBCR2 */
426 /* in data fetch mode: no need for CDACR, CDBYR, CDBCR */
431 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_set_fmt_cap(struct soc_camera_device *icd,
448 __u32 pixfmt, struct v4l2_rect *rect)
450 return icd->ops->set_fmt_cap(icd, pixfmt, rect);
453 static int sh_mobile_ceu_try_fmt_cap(struct soc_camera_device *icd,
454 struct v4l2_format *f)
456 /* FIXME: calculate using depth and bus width */
458 if (f->fmt.pix.height < 4)
459 f->fmt.pix.height = 4;
460 if (f->fmt.pix.height > 1920)
461 f->fmt.pix.height = 1920;
462 if (f->fmt.pix.width < 2)
463 f->fmt.pix.width = 2;
464 if (f->fmt.pix.width > 2560)
465 f->fmt.pix.width = 2560;
466 f->fmt.pix.width &= ~0x01;
467 f->fmt.pix.height &= ~0x03;
469 /* limit to sensor capabilities */
470 return icd->ops->try_fmt_cap(icd, f);
473 static int sh_mobile_ceu_reqbufs(struct soc_camera_file *icf,
474 struct v4l2_requestbuffers *p)
478 /* This is for locking debugging only. I removed spinlocks and now I
479 * check whether .prepare is ever called on a linked buffer, or whether
480 * a dma IRQ can occur for an in-work or unlinked buffer. Until now
481 * it hadn't triggered */
482 for (i = 0; i < p->count; i++) {
483 struct sh_mobile_ceu_buffer *buf;
485 buf = container_of(icf->vb_vidq.bufs[i],
486 struct sh_mobile_ceu_buffer, vb);
487 INIT_LIST_HEAD(&buf->vb.queue);
493 static unsigned int sh_mobile_ceu_poll(struct file *file, poll_table *pt)
495 struct soc_camera_file *icf = file->private_data;
496 struct sh_mobile_ceu_buffer *buf;
498 buf = list_entry(icf->vb_vidq.stream.next,
499 struct sh_mobile_ceu_buffer, vb.stream);
501 poll_wait(file, &buf->vb.done, pt);
503 if (buf->vb.state == VIDEOBUF_DONE ||
504 buf->vb.state == VIDEOBUF_ERROR)
505 return POLLIN|POLLRDNORM;
510 static int sh_mobile_ceu_querycap(struct soc_camera_host *ici,
511 struct v4l2_capability *cap)
513 strlcpy(cap->card, "SuperH_Mobile_CEU", sizeof(cap->card));
514 cap->version = KERNEL_VERSION(0, 0, 5);
515 cap->capabilities = V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_STREAMING;
519 static void sh_mobile_ceu_init_videobuf(struct videobuf_queue *q,
520 struct soc_camera_device *icd)
522 struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
523 struct sh_mobile_ceu_dev *pcdev = ici->priv;
525 videobuf_queue_dma_contig_init(q,
526 &sh_mobile_ceu_videobuf_ops,
527 &ici->dev, &pcdev->lock,
528 V4L2_BUF_TYPE_VIDEO_CAPTURE,
530 sizeof(struct sh_mobile_ceu_buffer),
534 static struct soc_camera_host_ops sh_mobile_ceu_host_ops = {
535 .owner = THIS_MODULE,
536 .add = sh_mobile_ceu_add_device,
537 .remove = sh_mobile_ceu_remove_device,
538 .set_fmt_cap = sh_mobile_ceu_set_fmt_cap,
539 .try_fmt_cap = sh_mobile_ceu_try_fmt_cap,
540 .reqbufs = sh_mobile_ceu_reqbufs,
541 .poll = sh_mobile_ceu_poll,
542 .querycap = sh_mobile_ceu_querycap,
543 .try_bus_param = sh_mobile_ceu_try_bus_param,
544 .set_bus_param = sh_mobile_ceu_set_bus_param,
545 .init_videobuf = sh_mobile_ceu_init_videobuf,
548 static int sh_mobile_ceu_probe(struct platform_device *pdev)
550 struct sh_mobile_ceu_dev *pcdev;
551 struct resource *res;
556 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
557 irq = platform_get_irq(pdev, 0);
559 dev_err(&pdev->dev, "Not enough CEU platform resources.\n");
564 pcdev = kzalloc(sizeof(*pcdev), GFP_KERNEL);
566 dev_err(&pdev->dev, "Could not allocate pcdev\n");
571 platform_set_drvdata(pdev, pcdev);
572 INIT_LIST_HEAD(&pcdev->capture);
573 spin_lock_init(&pcdev->lock);
575 pcdev->pdata = pdev->dev.platform_data;
578 dev_err(&pdev->dev, "CEU platform data not set.\n");
582 base = ioremap_nocache(res->start, res->end - res->start + 1);
585 dev_err(&pdev->dev, "Unable to ioremap CEU registers.\n");
591 pcdev->video_limit = 0; /* only enabled if second resource exists */
592 pcdev->dev = &pdev->dev;
594 res = platform_get_resource(pdev, IORESOURCE_MEM, 1);
596 err = dma_declare_coherent_memory(&pdev->dev, res->start,
598 (res->end - res->start) + 1,
600 DMA_MEMORY_EXCLUSIVE);
602 dev_err(&pdev->dev, "Unable to declare CEU memory.\n");
607 pcdev->video_limit = (res->end - res->start) + 1;
611 err = request_irq(pcdev->irq, sh_mobile_ceu_irq, IRQF_DISABLED,
612 pdev->dev.bus_id, pcdev);
614 dev_err(&pdev->dev, "Unable to register CEU interrupt.\n");
615 goto exit_release_mem;
618 pcdev->ici.priv = pcdev;
619 pcdev->ici.dev.parent = &pdev->dev;
620 pcdev->ici.nr = pdev->id;
621 pcdev->ici.drv_name = pdev->dev.bus_id,
622 pcdev->ici.ops = &sh_mobile_ceu_host_ops,
624 err = soc_camera_host_register(&pcdev->ici);
631 free_irq(pcdev->irq, pcdev);
633 if (platform_get_resource(pdev, IORESOURCE_MEM, 1))
634 dma_release_declared_memory(&pdev->dev);
643 static int sh_mobile_ceu_remove(struct platform_device *pdev)
645 struct sh_mobile_ceu_dev *pcdev = platform_get_drvdata(pdev);
647 soc_camera_host_unregister(&pcdev->ici);
648 free_irq(pcdev->irq, pcdev);
649 if (platform_get_resource(pdev, IORESOURCE_MEM, 1))
650 dma_release_declared_memory(&pdev->dev);
651 iounmap(pcdev->base);
656 static struct platform_driver sh_mobile_ceu_driver = {
658 .name = "sh_mobile_ceu",
660 .probe = sh_mobile_ceu_probe,
661 .remove = sh_mobile_ceu_remove,
664 static int __init sh_mobile_ceu_init(void)
666 return platform_driver_register(&sh_mobile_ceu_driver);
669 static void __exit sh_mobile_ceu_exit(void)
671 platform_driver_unregister(&sh_mobile_ceu_driver);
674 module_init(sh_mobile_ceu_init);
675 module_exit(sh_mobile_ceu_exit);
677 MODULE_DESCRIPTION("SuperH Mobile CEU driver");
678 MODULE_AUTHOR("Magnus Damm");
679 MODULE_LICENSE("GPL");