RE: [PATCH v3] [media] at91: add Atmel Image Sensor Interface (ISI) support

From: Wu, Josh
Date: Tue Jun 07 2011 - 03:05:50 EST


Hi, Guennadi

On Friday, June 03, 2011, Guennadi Liakhovetski wrote

> On Fri, 3 Jun 2011, Josh Wu wrote:

>> This patch is to enable Atmel Image Sensor Interface (ISI) driver support.
>> - Using soc-camera framework with videobuf2 dma-contig allocator
>> - Supporting video streaming of YUV packed format
>> - Tested on AT91SAM9M10G45-EK with OV2640
>>
>> Signed-off-by: Josh Wu <josh.wu@xxxxxxxxx>
>> ---
>> base on branch staging/for_v3.0
>> Modified in V3:
>> refined the interrupt handling code.
>> added a list to manage the allocated descriptors.
>> removed redundant code in isi_camera_set_bus_param().
>> return error when platform data is not provided.
>>
>> drivers/media/video/Kconfig | 8 +
>> drivers/media/video/Makefile | 1 +
>> drivers/media/video/atmel-isi.c | 1074 +++++++++++++++++++++++++++++++++++++++
>> include/media/atmel-isi.h | 119 +++++
>> 4 files changed, 1202 insertions(+), 0 deletions(-)
>> create mode 100644 drivers/media/video/atmel-isi.c
>> create mode 100644 include/media/atmel-isi.h
>>
>> diff --git a/drivers/media/video/Kconfig b/drivers/media/video/Kconfig
>> index bb53de7..93d1098 100644
>> --- a/drivers/media/video/Kconfig
>> +++ b/drivers/media/video/Kconfig
>> @@ -952,6 +952,14 @@ config VIDEO_SAMSUNG_S5P_FIMC
>> To compile this driver as a module, choose M here: the
>> module will be called s5p-fimc.
>>
>> +config VIDEO_ATMEL_ISI
>> + tristate "ATMEL Image Sensor Interface (ISI) support"
>> + depends on VIDEO_DEV && SOC_CAMERA && ARCH_AT91
>> + select VIDEOBUF2_DMA_CONTIG
>> + ---help---
>> + This module makes the ATMEL Image Sensor Interface available
>> + as a v4l2 device.
>> +
>> config VIDEO_S5P_MIPI_CSIS
>> tristate "Samsung S5P and EXYNOS4 MIPI CSI receiver driver"
>> depends on VIDEO_V4L2 && PM_RUNTIME && PLAT_S5P && VIDEO_V4L2_SUBDEV_API
>> diff --git a/drivers/media/video/Makefile b/drivers/media/video/Makefile
>> index f0fecd6..d9833f4 100644
>> --- a/drivers/media/video/Makefile
>> +++ b/drivers/media/video/Makefile
>> @@ -166,6 +166,7 @@ obj-$(CONFIG_VIDEO_PXA27x) += pxa_camera.o
>> obj-$(CONFIG_VIDEO_SH_MOBILE_CSI2) += sh_mobile_csi2.o
>> obj-$(CONFIG_VIDEO_SH_MOBILE_CEU) += sh_mobile_ceu_camera.o
>> obj-$(CONFIG_VIDEO_OMAP1) += omap1_camera.o
>> +obj-$(CONFIG_VIDEO_ATMEL_ISI) += atmel-isi.o
>>
>> obj-$(CONFIG_VIDEO_SAMSUNG_S5P_FIMC) += s5p-fimc/
>>
>> diff --git a/drivers/media/video/atmel-isi.c b/drivers/media/video/atmel-isi.c
>> new file mode 100644
>> index 0000000..a020bd3
>> --- /dev/null
>> +++ b/drivers/media/video/atmel-isi.c
>> @@ -0,0 +1,1074 @@
>> +/*
>> + * Copyright (c) 2011 Atmel Corporation
>> + * Josh Wu, <josh.wu@xxxxxxxxx>
>> + *
>> + * Based on previous work by Lars Haring, <lars.haring@xxxxxxxxx>
>> + * and Sedji Gaouaou
>> + * Based on the bttv driver for Bt848 with respective copyright holders
>> + *
>> + * This program is free software; you can redistribute it and/or modify
>> + * it under the terms of the GNU General Public License version 2 as
>> + * published by the Free Software Foundation.
>> + */
>> +
>> +#include <linux/clk.h>
>> +#include <linux/completion.h>
>> +#include <linux/delay.h>
>> +#include <linux/fs.h>
>> +#include <linux/init.h>
>> +#include <linux/interrupt.h>
>> +#include <linux/kernel.h>
>> +#include <linux/module.h>
>> +#include <linux/platform_device.h>
>> +#include <linux/slab.h>
>> +
>> +#include <media/atmel-isi.h>
>> +#include <media/soc_camera.h>
>> +#include <media/soc_mediabus.h>
>> +#include <media/videobuf2-dma-contig.h>
>> +
>> +#define MAX_BUFFER_NUM 32
>> +#define MAX_SUPPORT_WIDTH 2048
>> +#define MAX_SUPPORT_HEIGHT 2048
>> +#define VID_LIMIT_BYTES (16 * 1024 * 1024)
>> +#define MIN_FRAME_RATE 15
>> +#define FRAME_INTERVAL_MILLI_SEC (1000 / MIN_FRAME_RATE)
>> +
>> +/* ISI states */
>> +enum {
>> + ISI_STATE_IDLE = 0,
>> + ISI_STATE_READY,
>> + ISI_STATE_WAIT_SOF,
>> +};
>> +
>> +/* Frame buffer descriptor */
>> +struct fbd {
>> + /* Physical address of the frame buffer */
>> + u32 fb_address;
>> + /* DMA Control Register(only in HISI2) */
>> + u32 dma_ctrl;
>> + /* Physical address of the next fbd */
>> + u32 next_fbd_address;
>> +};
>> +
>> +static void set_dma_ctrl(struct fbd *fb_desc, u32 ctrl)
>> +{
>> + fb_desc->dma_ctrl = ctrl;
>> +}
>> +
>> +struct isi_dma_desc {
>> + struct list_head list;
>> + struct fbd *p_fbd;
>> + u32 fbd_phys;
>> +};
>> +
>> +/* Frame buffer data */
>> +struct frame_buffer {
>> + struct vb2_buffer vb;
>> + struct fbd *p_fb_desc;
>> + u32 fb_desc_phys;

> Why don't you replace the above two members with "struct isi_dma_desc *"?
> Then you also don't need to scan the DMA descriptor array in
> .buf_cleanup().

Will fix in v4. This change makes code simpler.

>> + struct list_head list;
>> +};
>> +
>> +struct atmel_isi {
>> + /* Protects the access of variables shared with the ISR */
>> + spinlock_t lock;
>> + void __iomem *regs;
>> +
>> + int sequence;
>> + /* State of the ISI module in capturing mode */
>> + int state;
>> +
>> + /* Wait queue for waiting for SOF */
>> + wait_queue_head_t vsync_wq;
>> +
>> + struct vb2_alloc_ctx *alloc_ctx;
>> +
>> + /* Allocate descriptors for dma buffer use */
>> + struct fbd *p_fb_descriptors;
>> + u32 fb_descriptors_phys;
>> + struct list_head dma_desc_head;
>> + struct isi_dma_desc dma_desc[MAX_BUFFER_NUM];
>> +
>> + struct completion complete;
>> + struct clk *pclk;
>> + unsigned int irq;
>> +
>> + struct isi_platform_data *pdata;
>> +
>> + struct list_head video_buffer_list;
>> + struct frame_buffer *active;
>> +
>> + struct soc_camera_device *icd;
>> + struct soc_camera_host soc_host;
>> +};
>> +
>> +static void isi_writel(struct atmel_isi *isi, u32 reg, u32 val)
>> +{
>> + writel(val, isi->regs + reg);
>> +}
>> +static u32 isi_readl(struct atmel_isi *isi, u32 reg)
>> +{
>> + return readl(isi->regs + reg);
>> +}
>> +
>> +static int configure_geometry(struct atmel_isi *isi, u32 width,
>> + u32 height, enum v4l2_mbus_pixelcode code)
>> +{
>> + u32 cfg2, cr;
>> +
>> + switch (code) {
>> + /* YUV, including grey */
>> + case V4L2_MBUS_FMT_Y8_1X8:
>> + cr = ISI_CFG2_GRAYSCALE;
>> + break;
>> + case V4L2_MBUS_FMT_UYVY8_2X8:
>> + cr = ISI_CFG2_YCC_SWAP_MODE_3;
>> + break;
>> + case V4L2_MBUS_FMT_VYUY8_2X8:
>> + cr = ISI_CFG2_YCC_SWAP_MODE_2;
>> + break;
>> + case V4L2_MBUS_FMT_YUYV8_2X8:
>> + cr = ISI_CFG2_YCC_SWAP_MODE_1;
>> + break;
>> + case V4L2_MBUS_FMT_YVYU8_2X8:
>> + cr = ISI_CFG2_YCC_SWAP_DEFAULT;
>> + break;
>> + /* RGB, TODO */
>> + default:
>> + return -EINVAL;
>> + }
>> +
>> + isi_writel(isi, ISI_CTRL, ISI_CTRL_DIS);
>> +
>> + cfg2 = isi_readl(isi, ISI_CFG2);
>> + cfg2 |= cr;
>> + /* Set width */
>> + cfg2 &= ~(ISI_CFG2_IM_HSIZE_MASK);
>> + cfg2 |= ((width - 1) << ISI_CFG2_IM_HSIZE_OFFSET) &
>> + ISI_CFG2_IM_HSIZE_MASK;
>> + /* Set height */
>> + cfg2 &= ~(ISI_CFG2_IM_VSIZE_MASK);
>> + cfg2 |= ((height - 1) << ISI_CFG2_IM_VSIZE_OFFSET)
>> + & ISI_CFG2_IM_VSIZE_MASK;
>> + isi_writel(isi, ISI_CFG2, cfg2);
>> +
>> + return 0;
>> +}
>> +
>> +static irqreturn_t atmel_isi_handle_streaming(struct atmel_isi *isi)
>> +{
>> + if (isi->active) {
>> + struct vb2_buffer *vb = &isi->active->vb;
>> + struct frame_buffer *buf = isi->active;
>> +
>> + list_del_init(&buf->list);
>> + do_gettimeofday(&vb->v4l2_buf.timestamp);
>> + vb->v4l2_buf.sequence = isi->sequence++;
>> + vb2_buffer_done(vb, VB2_BUF_STATE_DONE);
>> + }
>> +
>> + if (list_empty(&isi->video_buffer_list)) {
>> + isi->active = NULL;
>> + } else {
>> + /* start next dma frame. */
>> + isi->active = list_entry(isi->video_buffer_list.next,
>> + struct frame_buffer, list);
>> + isi_writel(isi, ISI_DMA_C_DSCR, isi->active->fb_desc_phys);
>> + isi_writel(isi, ISI_DMA_C_CTRL,
>> + ISI_DMA_CTRL_FETCH | ISI_DMA_CTRL_DONE);
>> + isi_writel(isi, ISI_DMA_CHER, ISI_DMA_CHSR_C_CH);
>> + }
>> + return IRQ_HANDLED;
>> +}
>> +
>> +/* ISI interrupt service routine */
>> +static irqreturn_t isi_interrupt(int irq, void *dev_id)
>> +{
>> + struct atmel_isi *isi = dev_id;
>> + u32 status, mask, pending;
>> + irqreturn_t ret = IRQ_NONE;
>> +
>> + spin_lock(&isi->lock);
>> +
>> + status = isi_readl(isi, ISI_STATUS);
>> + mask = isi_readl(isi, ISI_INTMASK);
>> + pending = status & mask;
>> +
>> + if (pending & ISI_CTRL_SRST) {
>> + complete(&isi->complete);
>> + isi_writel(isi, ISI_INTDIS, ISI_CTRL_SRST);
>> + ret = IRQ_HANDLED;
>> + } else if (pending & ISI_CTRL_DIS) {
>> + complete(&isi->complete);
>> + isi_writel(isi, ISI_INTDIS, ISI_CTRL_DIS);
>> + ret = IRQ_HANDLED;
>> + } else {
>> + if ((pending & ISI_SR_VSYNC) &&
>> + (isi->state == ISI_STATE_IDLE)) {

> Superfluous second pair of parenthesis

I think using both pair of parenthesis will make code clearer. Can you accept this?

>> + isi->state = ISI_STATE_READY;
>> + wake_up_interruptible(&isi->vsync_wq);
>> + ret = IRQ_HANDLED;
>> + }
>> + if (likely(pending & ISI_SR_CXFR_DONE))
>> + ret = atmel_isi_handle_streaming(isi);
>> + }
>> +
>> + spin_unlock(&isi->lock);
>> + return ret;
>> +}
>> +
>> +#define WAIT_ISI_RESET 1
>> +#define WAIT_ISI_DISABLE 0
>> +static int atmel_isi_wait_status(struct atmel_isi *isi, int wait_reset)
>> +{
>> + unsigned long timeout;
>> + /*
>> + * The reset or disable will only succeed if we have a
>> + * pixel clock from the camera.
>> + */
>> + init_completion(&isi->complete);
>> +
>> + if (wait_reset) {
>> + isi_writel(isi, ISI_INTEN, ISI_CTRL_SRST);
>> + isi_writel(isi, ISI_CTRL, ISI_CTRL_SRST);
>> + } else {
>> + isi_writel(isi, ISI_INTEN, ISI_CTRL_DIS);
>> + isi_writel(isi, ISI_CTRL, ISI_CTRL_DIS);
>> + }
>> +
>> + timeout = wait_for_completion_timeout(&isi->complete,
>> + msecs_to_jiffies(100));
>> + if (timeout == 0)
>> + return -ETIMEDOUT;
>> +
>> + return 0;
>> +}
>> +
>> +/* ------------------------------------------------------------------
>> + Videobuf operations
>> + ------------------------------------------------------------------*/
>> +static int queue_setup(struct vb2_queue *vq, unsigned int *nbuffers,
>> + unsigned int *nplanes, unsigned long sizes[],
>> + void *alloc_ctxs[])
>> +{
>> + struct soc_camera_device *icd = soc_camera_from_vb2q(vq);
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + unsigned long size;
>> + int ret, bytes_per_line;
>> +
>> + /* Reset ISI */
>> + ret = atmel_isi_wait_status(isi, WAIT_ISI_RESET);
>> + if (ret < 0) {
>> + dev_err(icd->dev.parent, "Reset ISI timed out\n");
>> + return ret;
>> + }
>> + /* Disable all interrupts */
>> + isi_writel(isi, ISI_INTDIS, ~0UL);
>> +
>> + bytes_per_line = soc_mbus_bytes_per_line(icd->user_width,
>> + icd->current_fmt->host_fmt);
>> +
>> + if (bytes_per_line < 0)
>> + return bytes_per_line;
>> +
>> + size = bytes_per_line * icd->user_height;
>> +
>> + if (*nbuffers == 0)
>> + *nbuffers = MAX_BUFFER_NUM;
>> + else if (*nbuffers > MAX_BUFFER_NUM)
>> + *nbuffers = MAX_BUFFER_NUM;

> /me wondering, why not just
>
> if (!*nbuffers || *nbuffers > MAX_BUFFER_NUM)
> *nbuffers = MAX_BUFFER_NUM;

Will fixed in v4.

>> +
>> + if (size * *nbuffers > VID_LIMIT_BYTES)
>> + *nbuffers = VID_LIMIT_BYTES / size;
>> +
>> + *nplanes = 1;
>> + sizes[0] = size;
>> + alloc_ctxs[0] = isi->alloc_ctx;
>> +
>> + isi->sequence = 0;
>> + isi->active = NULL;
>> +
>> + dev_dbg(icd->dev.parent, "%s, count=%d, size=%ld\n", __func__,
>> + *nbuffers, size);
>> +
>> + return 0;
>> +}
>> +
>> +static int buffer_init(struct vb2_buffer *vb)
>> +{
>> + struct frame_buffer *buf = container_of(vb, struct frame_buffer, vb);
>> +
>> + buf->p_fb_desc = NULL;
>> + memset(&buf->fb_desc_phys, 0, sizeof(buf->fb_desc_phys));

> I don't think this is what the reviewer meant - here you're using memset
> to nullify a u32 field. He probably was asking you to clean the whole
> struct frame_buffer, which I actually don't necessarily agree with. So,
> unless there's an evidence, why that memest is needed, I'd just keep your
> original "->fb_desc_phys = 0". Notice, none of the soc-camera drivers
> nullifies anything in .buf_init(), it cannot also be mandatory, because
> the actual method is optional.

Well, in the v4 version, only following code are needed in this function.
buf->p_dma_desc = NULL;
INIT_LIST_HEAD(&buf->list);

>> + INIT_LIST_HEAD(&buf->list);
>> +
>> + return 0;
>> +}
>> +
>> +static int buffer_prepare(struct vb2_buffer *vb)
>> +{
>> + struct soc_camera_device *icd = soc_camera_from_vb2q(vb->vb2_queue);
>> + struct frame_buffer *buf = container_of(vb, struct frame_buffer, vb);
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + unsigned long size;
>> + struct isi_dma_desc *desc;
>> + int bytes_per_line = soc_mbus_bytes_per_line(icd->user_width,
>> + icd->current_fmt->host_fmt);
>> +
>> + if (bytes_per_line < 0)
>> + return bytes_per_line;
>> +
>> + size = bytes_per_line * icd->user_height;
>> +
>> + if (vb2_plane_size(vb, 0) < size) {
>> + dev_err(icd->dev.parent, "%s data will not fit into plane (%lu < %lu)\n",
>> + __func__, vb2_plane_size(vb, 0), size);
>> + return -EINVAL;
>> + }
>> +
>> + vb2_set_plane_payload(&buf->vb, 0, size);
>> +
>> + if (!buf->p_fb_desc) {
>> + if (list_empty(&isi->dma_desc_head)) {
>> + dev_err(icd->dev.parent, "Not enough dma descriptors.\n");
>> + return -EINVAL;
>> + } else {
>> + /* Get an available descriptor */
>> + desc = list_entry(isi->dma_desc_head.next,
>> + struct isi_dma_desc, list);
>> + buf->p_fb_desc = desc->p_fbd;
>> + buf->fb_desc_phys = desc->fbd_phys;
>> +
>> + /* Initialize the dma descriptor */
>> + buf->p_fb_desc->fb_address =
>> + vb2_dma_contig_plane_paddr(vb, 0);
>> + buf->p_fb_desc->next_fbd_address = 0;
>> + set_dma_ctrl(buf->p_fb_desc, ISI_DMA_CTRL_WB);
>> +
>> + /* Delete the descriptor since now it is used */
>> + list_del_init(&desc->list);

> It probably doesn't matter here, if there were a race, you'd need to
> protect anyway, but stylistically you usually first grab ownership of an
> object, and only then you modify it, so, it would be more logical to first
> list_del(init) the buffer. As for locking as such - we just rely on v4l2
> file-operation mutex locking for now.

I will fix it in v4.

>> + }
>> + }
>> + return 0;
>> +}
>> +
>> +static void buffer_cleanup(struct vb2_buffer *vb)
>> +{
>> + struct soc_camera_device *icd = soc_camera_from_vb2q(vb->vb2_queue);
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + struct frame_buffer *buf = container_of(vb, struct frame_buffer, vb);
>> + unsigned long flags;
>> + int i;
>> +
>> + spin_lock_irqsave(&isi->lock, flags);

> You say, this lock protects data, shared with the ISR, these are the
> buffer list and the ->state, none of them is accessed below.

I think I can remove the spin_lock here.

>> + if (buf->p_fb_desc) {
>> + /* This descriptor is available now and we add to head list */
>> + for (i = 0; i < MAX_BUFFER_NUM; i++)
>> + if (isi->dma_desc[i].p_fbd == buf->p_fb_desc) {
>> + list_add(&isi->dma_desc[i].list,
>> + &isi->dma_desc_head);
>> + break;
>> + }

> With modified struct frame_buffer the above loop will go.

sure.

>> +
>> + buf->p_fb_desc = NULL;
>> + memset(&buf->fb_desc_phys, 0, sizeof(buf->fb_desc_phys));

> You really need to do clean up in .buf_cleanup() and in .buf_init()? I
> think, one of them should be enough. And memset is bogus here too.

This initialization code is only needed in buffer_init(). I will remove such code in buffer_cleanup().

>> + }
>> + spin_unlock_irqrestore(&isi->lock, flags);
>> +}
>> +
>> +static void start_dma(struct atmel_isi *isi, struct frame_buffer *buffer)
>> +{
>> + u32 ctrl, cfg1;
>> +
>> + cfg1 = isi_readl(isi, ISI_CFG1);
>> + /* Enable irq: cxfr for the codec path, pxfr for the preview path */
>> + isi_writel(isi, ISI_INTEN,
>> + ISI_SR_CXFR_DONE | ISI_SR_PXFR_DONE);
>> +
>> + /* Check if already in a frame */
>> + if (isi_readl(isi, ISI_STATUS) & ISI_CTRL_CDC) {
>> + dev_err(isi->icd->dev.parent, "Already in frame handling.\n");
>> + return;
>> + }
>> +
>> + isi_writel(isi, ISI_DMA_C_DSCR, buffer->fb_desc_phys);
>> + isi_writel(isi, ISI_DMA_C_CTRL, ISI_DMA_CTRL_FETCH | ISI_DMA_CTRL_DONE);
>> + isi_writel(isi, ISI_DMA_CHER, ISI_DMA_CHSR_C_CH);
>> +
>> + /* Enable linked list */
>> + cfg1 |= isi->pdata->frate | ISI_CFG1_DISCR;
>> +
>> + /* Enable codec path and ISI */
>> + ctrl = ISI_CTRL_CDC | ISI_CTRL_EN;
>> + isi_writel(isi, ISI_CTRL, ctrl);
>> + isi_writel(isi, ISI_CFG1, cfg1);
>> +}
>> +
>> +static void buffer_queue(struct vb2_buffer *vb)
>> +{
>> + struct soc_camera_device *icd = soc_camera_from_vb2q(vb->vb2_queue);
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + struct frame_buffer *buf = container_of(vb, struct frame_buffer, vb);
>> + unsigned long flags = 0;
>> +
>> + spin_lock_irqsave(&isi->lock, flags);
>> + list_add_tail(&buf->list, &isi->video_buffer_list);
>> +
>> + if (isi->active == NULL) {
>> + isi->active = buf;
>> + start_dma(isi, buf);
>> + }
>> + spin_unlock_irqrestore(&isi->lock, flags);
>> +}
>> +
>> +static int start_streaming(struct vb2_queue *vq)
>> +{
>> + struct soc_camera_device *icd = soc_camera_from_vb2q(vq);
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> +
>> + u32 sr = 0;
>> + int ret;
>> +
>> + spin_lock_irq(&isi->lock);
>> + isi->state = ISI_STATE_IDLE;
>> +
>> + /* Clear any pending SOF interrupt */
>> + sr = isi_readl(isi, ISI_STATUS);
>> + /* Enable VSYNC interrupt for SOF */
>> + isi_writel(isi, ISI_INTEN, ISI_SR_VSYNC);
>> + isi_writel(isi, ISI_CTRL, ISI_CTRL_EN);
>> +
>> + spin_unlock_irq(&isi->lock);
>> + dev_dbg(icd->dev.parent, "Waiting for SOF\n");
>> + ret = wait_event_interruptible(isi->vsync_wq,
>> + isi->state != ISI_STATE_IDLE);
>> + if (ret)
>> + return ret;
>> +
>> + if (isi->state != ISI_STATE_READY)
>> + return -EIO;
>> +
>> + spin_lock_irq(&isi->lock);
>> + isi->state = ISI_STATE_WAIT_SOF;
>> + isi_writel(isi, ISI_INTDIS, ISI_SR_VSYNC);
>> + spin_unlock_irq(&isi->lock);
>> +
>> + return 0;
>> +}
>> +
>> +/* abort streaming and wait for last buffer */
>> +static int stop_streaming(struct vb2_queue *vq)
>> +{
>> + struct soc_camera_device *icd = soc_camera_from_vb2q(vq);
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + struct frame_buffer *buf, *node;
>> + int ret = 0;
>> + unsigned long timeout;
>> +
>> + spin_lock_irq(&isi->lock);
>> + isi->active = NULL;
>> + /* Release all active buffers */
>> + list_for_each_entry_safe(buf, node, &isi->video_buffer_list, list) {
>> + list_del_init(&buf->list);
>> + vb2_buffer_done(&buf->vb, VB2_BUF_STATE_ERROR);
>> + }
>> + spin_unlock_irq(&isi->lock);
>> +
>> + timeout = jiffies + FRAME_INTERVAL_MILLI_SEC * HZ;
>> + /* Wait until the end of the current frame. */
>> + while ((isi_readl(isi, ISI_STATUS) & ISI_CTRL_CDC) &&
>> + time_before(jiffies, timeout))
>> + msleep(1);
>> +
>> + if (time_after(jiffies, timeout)) {
>> + dev_err(icd->dev.parent,
>> + "Timeout waiting for finishing codec request\n");
>> + return -ETIMEDOUT;
>> + }
>> +
>> + /* Disable interrupts */
>> + isi_writel(isi, ISI_INTDIS,
>> + ISI_SR_CXFR_DONE | ISI_SR_PXFR_DONE);
>> +
>> + /* Disable ISI and wait for it is done */
>> + ret = atmel_isi_wait_status(isi, WAIT_ISI_DISABLE);
>> + if (ret < 0)
>> + dev_err(icd->dev.parent, "Disable ISI timed out\n");
>> +
>> + return ret;
>> +}
>> +
>> +static struct vb2_ops isi_video_qops = {
>> + .queue_setup = queue_setup,
>> + .buf_init = buffer_init,
>> + .buf_prepare = buffer_prepare,
>> + .buf_cleanup = buffer_cleanup,
>> + .buf_queue = buffer_queue,
>> + .start_streaming = start_streaming,
>> + .stop_streaming = stop_streaming,
>> + .wait_prepare = soc_camera_unlock,
>> + .wait_finish = soc_camera_lock,
>> +};
>> +
>> +/* ------------------------------------------------------------------
>> + SOC camera operations for the device
>> + ------------------------------------------------------------------*/
>> +static int isi_camera_init_videobuf(struct vb2_queue *q,
>> + struct soc_camera_device *icd)
>> +{
>> + q->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
>> + q->io_modes = VB2_MMAP;
>> + q->drv_priv = icd;
>> + q->buf_struct_size = sizeof(struct frame_buffer);
>> + q->ops = &isi_video_qops;
>> + q->mem_ops = &vb2_dma_contig_memops;
>> +
>> + return vb2_queue_init(q);
>> +}
>> +
>> +static int isi_camera_set_fmt(struct soc_camera_device *icd,
>> + struct v4l2_format *f)
>> +{
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
>> + const struct soc_camera_format_xlate *xlate;
>> + struct v4l2_pix_format *pix = &f->fmt.pix;
>> + struct v4l2_mbus_framefmt mf;
>> + int ret;
>> +
>> + xlate = soc_camera_xlate_by_fourcc(icd, pix->pixelformat);
>> + if (!xlate) {
>> + dev_warn(icd->dev.parent, "Format %x not found\n",
>> + pix->pixelformat);
>> + return -EINVAL;
>> + }
>> +
>> + dev_dbg(icd->dev.parent, "Plan to set format %dx%d\n",
>> + pix->width, pix->height);
>> +
>> + mf.width = pix->width;
>> + mf.height = pix->height;
>> + mf.field = pix->field;
>> + mf.colorspace = pix->colorspace;
>> + mf.code = xlate->code;
>> +
>> + ret = v4l2_subdev_call(sd, video, s_mbus_fmt, &mf);
>> + if (ret < 0)
>> + return ret;
>> +
>> + if (mf.code != xlate->code)
>> + return -EINVAL;
>> +
>> + ret = configure_geometry(isi, pix->width, pix->height, xlate->code);
>> + if (ret < 0)
>> + return ret;
>> +
>> + pix->width = mf.width;
>> + pix->height = mf.height;
>> + pix->field = mf.field;
>> + pix->colorspace = mf.colorspace;
>> + icd->current_fmt = xlate;
>> +
>> + dev_dbg(icd->dev.parent, "Finally set format %dx%d\n",
>> + pix->width, pix->height);
>> +
>> + return ret;
>> +}
>> +
>> +static int isi_camera_try_fmt(struct soc_camera_device *icd,
>> + struct v4l2_format *f)
>> +{
>> + struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
>> + const struct soc_camera_format_xlate *xlate;
>> + struct v4l2_pix_format *pix = &f->fmt.pix;
>> + struct v4l2_mbus_framefmt mf;
>> + u32 pixfmt = pix->pixelformat;
>> + int ret;
>> +
>> + xlate = soc_camera_xlate_by_fourcc(icd, pixfmt);
>> + if (pixfmt && !xlate) {
>> + dev_warn(icd->dev.parent, "Format %x not found\n", pixfmt);
>> + return -EINVAL;
>> + }
>> +
>> + /* limit to Atmel ISI hardware capabilities */
>> + if (pix->height > MAX_SUPPORT_HEIGHT)
>> + pix->height = MAX_SUPPORT_HEIGHT;
>> + if (pix->width > MAX_SUPPORT_WIDTH)
>> + pix->width = MAX_SUPPORT_WIDTH;
>> +
>> + /* limit to sensor capabilities */
>> + mf.width = pix->width;
>> + mf.height = pix->height;
>> + mf.field = pix->field;
>> + mf.colorspace = pix->colorspace;
>> + mf.code = xlate->code;
>> +
>> + ret = v4l2_subdev_call(sd, video, try_mbus_fmt, &mf);
>> + if (ret < 0)
>> + return ret;
>> +
>> + pix->width = mf.width;
>> + pix->height = mf.height;
>> + pix->colorspace = mf.colorspace;
>> +
>> + switch (mf.field) {
>> + case V4L2_FIELD_ANY:
>> + pix->field = V4L2_FIELD_NONE;
>> + break;
>> + case V4L2_FIELD_NONE:
>> + break;
>> + default:
>> + dev_err(icd->dev.parent, "Field type %d unsupported.\n",
>> + mf.field);
>> + ret = -EINVAL;
>> + }
>> +
>> + return ret;
>> +}
>> +
>> +static const struct soc_mbus_pixelfmt isi_camera_formats[] = {
>> + {
>> + .fourcc = V4L2_PIX_FMT_YUYV,
>> + .name = "Packed YUV422 16 bit",
>> + .bits_per_sample = 8,
>> + .packing = SOC_MBUS_PACKING_2X8_PADHI,
>> + .order = SOC_MBUS_ORDER_LE,
>> + },
>> +};
>> +
>> +/* This will be corrected as we get more formats */
>> +static bool isi_camera_packing_supported(const struct soc_mbus_pixelfmt *fmt)
>> +{
>> + return fmt->packing == SOC_MBUS_PACKING_NONE ||
>> + (fmt->bits_per_sample == 8 &&
>> + fmt->packing == SOC_MBUS_PACKING_2X8_PADHI) ||
>> + (fmt->bits_per_sample > 8 &&
>> + fmt->packing == SOC_MBUS_PACKING_EXTEND16);
>> +}
>> +
>> +static unsigned long make_bus_param(struct atmel_isi *isi)
>> +{
>> + unsigned long flags;
>> + /*
>> + * Platform specified synchronization and pixel clock polarities are
>> + * only a recommendation and are only used during probing. Atmel ISI
>> + * camera interface only works in master mode, i.e., uses HSYNC and
>> + * VSYNC signals from the sensor
>> + */
>> + flags = SOCAM_MASTER |
>> + SOCAM_HSYNC_ACTIVE_HIGH |
>> + SOCAM_HSYNC_ACTIVE_LOW |
>> + SOCAM_VSYNC_ACTIVE_HIGH |
>> + SOCAM_VSYNC_ACTIVE_LOW |
>> + SOCAM_PCLK_SAMPLE_RISING |
>> + SOCAM_PCLK_SAMPLE_FALLING |
>> + SOCAM_DATA_ACTIVE_HIGH;
>> +
>> + if (isi->pdata->data_width_flags & ISI_DATAWIDTH_10)
>> + flags |= SOCAM_DATAWIDTH_10;
>> +
>> + if (isi->pdata->data_width_flags & ISI_DATAWIDTH_8)
>> + flags |= SOCAM_DATAWIDTH_8;
>> +
>> + if (flags & SOCAM_DATAWIDTH_MASK)
>> + return flags;
>> +
>> + return 0;
>> +}
>> +
>> +static int isi_camera_try_bus_param(struct soc_camera_device *icd,
>> + unsigned char buswidth)
>> +{
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + unsigned long camera_flags;
>> + int ret;
>> +
>> + camera_flags = icd->ops->query_bus_param(icd);
>> + ret = soc_camera_bus_param_compatible(camera_flags,
>> + make_bus_param(isi));
>> + if (!ret)
>> + return -EINVAL;
>> + return 0;
>> +}
>> +
>> +
>> +static int isi_camera_get_formats(struct soc_camera_device *icd,
>> + unsigned int idx,
>> + struct soc_camera_format_xlate *xlate)
>> +{
>> + struct v4l2_subdev *sd = soc_camera_to_subdev(icd);
>> + int formats = 0, ret;
>> + /* sensor format */
>> + enum v4l2_mbus_pixelcode code;
>> + /* soc camera host format */
>> + const struct soc_mbus_pixelfmt *fmt;
>> +
>> + ret = v4l2_subdev_call(sd, video, enum_mbus_fmt, idx, &code);
>> + if (ret < 0)
>> + /* No more formats */
>> + return 0;
>> +
>> + fmt = soc_mbus_get_fmtdesc(code);
>> + if (!fmt) {
>> + dev_err(icd->dev.parent,
>> + "Invalid format code #%u: %d\n", idx, code);
>> + return 0;
>> + }
>> +
>> + /* This also checks support for the requested bits-per-sample */
>> + ret = isi_camera_try_bus_param(icd, fmt->bits_per_sample);
>> + if (ret < 0) {
>> + dev_err(icd->dev.parent,
>> + "Fail to try the bus parameters.\n");
>> + return 0;
>> + }
>> +
>> + switch (code) {
>> + case V4L2_MBUS_FMT_UYVY8_2X8:
>> + case V4L2_MBUS_FMT_VYUY8_2X8:
>> + case V4L2_MBUS_FMT_YUYV8_2X8:
>> + case V4L2_MBUS_FMT_YVYU8_2X8:
>> + formats++;
>> + if (xlate) {
>> + xlate->host_fmt = &isi_camera_formats[0];
>> + xlate->code = code;
>> + xlate++;
>> + dev_dbg(icd->dev.parent, "Providing format %s using code %d\n",
>> + isi_camera_formats[0].name, code);
>> + }
>> + break;
>> + default:
>> + if (!isi_camera_packing_supported(fmt))
>> + return 0;
>> + if (xlate)
>> + dev_dbg(icd->dev.parent,
>> + "Providing format %s in pass-through mode\n",
>> + fmt->name);
>> + }
>> +
>> + /* Generic pass-through */
>> + formats++;
>> + if (xlate) {
>> + xlate->host_fmt = fmt;
>> + xlate->code = code;
>> + xlate++;
>> + }
>> +
>> + return formats;
>> +}
>> +
>> +/* Called with .video_lock held */
>> +static int isi_camera_add_device(struct soc_camera_device *icd)
>> +{
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + int ret;
>> +
>> + if (isi->icd)
>> + return -EBUSY;
>> +
>> + ret = clk_enable(isi->pclk);
>> + if (ret)
>> + return ret;
>> +
>> + isi->icd = icd;
>> + dev_dbg(icd->dev.parent, "Atmel ISI Camera driver attached to camera %d\n",
>> + icd->devnum);
>> + return 0;
>> +}
>> +/* Called with .video_lock held */
>> +static void isi_camera_remove_device(struct soc_camera_device *icd)
>> +{
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> +
>> + BUG_ON(icd != isi->icd);
>> +
>> + clk_disable(isi->pclk);
>> + isi->icd = NULL;
>> +
>> + dev_dbg(icd->dev.parent, "Atmel ISI Camera driver detached from camera %d\n",
>> + icd->devnum);
>> +}
>> +
>> +static unsigned int isi_camera_poll(struct file *file, poll_table *pt)
>> +{
>> + struct soc_camera_device *icd = file->private_data;
>> +
>> + return vb2_poll(&icd->vb2_vidq, file, pt);
>> +}
>> +
>> +static int isi_camera_querycap(struct soc_camera_host *ici,
>> + struct v4l2_capability *cap)
>> +{
>> + strcpy(cap->driver, "atmel-isi");
>> + strcpy(cap->card, "Atmel Image Sensor Interface");
>> + cap->capabilities = (V4L2_CAP_VIDEO_CAPTURE |
>> + V4L2_CAP_STREAMING);
>> + return 0;
>> +}
>> +
>> +static int isi_camera_set_bus_param(struct soc_camera_device *icd, u32 pixfmt)
>> +{
>> + struct soc_camera_host *ici = to_soc_camera_host(icd->dev.parent);
>> + struct atmel_isi *isi = ici->priv;
>> + unsigned long bus_flags, camera_flags, common_flags;
>> + int ret;
>> + u32 cfg1 = 0;
>> +
>> + camera_flags = icd->ops->query_bus_param(icd);
>> +
>> + bus_flags = make_bus_param(isi);
>> + common_flags = soc_camera_bus_param_compatible(camera_flags, bus_flags);
>> + dev_dbg(icd->dev.parent, "Flags cam: 0x%lx host: 0x%lx common: 0x%lx\n",
>> + camera_flags, bus_flags, common_flags);
>> + if (!common_flags)
>> + return -EINVAL;
>> +
>> + /* Make choises, based on platform preferences */
>> + if ((common_flags & SOCAM_HSYNC_ACTIVE_HIGH) &&
>> + (common_flags & SOCAM_HSYNC_ACTIVE_LOW)) {
>> + if (isi->pdata->hsync_act_low)
>> + common_flags &= ~SOCAM_HSYNC_ACTIVE_HIGH;
>> + else
>> + common_flags &= ~SOCAM_HSYNC_ACTIVE_LOW;
>> + }
>> +
>> + if ((common_flags & SOCAM_VSYNC_ACTIVE_HIGH) &&
>> + (common_flags & SOCAM_VSYNC_ACTIVE_LOW)) {
>> + if (isi->pdata->vsync_act_low)
>> + common_flags &= ~SOCAM_VSYNC_ACTIVE_HIGH;
>> + else
>> + common_flags &= ~SOCAM_VSYNC_ACTIVE_LOW;
>> + }
>> +
>> + if ((common_flags & SOCAM_PCLK_SAMPLE_RISING) &&
>> + (common_flags & SOCAM_PCLK_SAMPLE_FALLING)) {
>> + if (isi->pdata->pclk_act_falling)
>> + common_flags &= ~SOCAM_PCLK_SAMPLE_RISING;
>> + else
>> + common_flags &= ~SOCAM_PCLK_SAMPLE_FALLING;
>> + }
>> +
>> + ret = icd->ops->set_bus_param(icd, common_flags);
>> + if (ret < 0) {
>> + dev_dbg(icd->dev.parent, "Camera set_bus_param(%lx) returned %d\n",
>> + common_flags, ret);
>> + return ret;
>> + }
>> +
>> + /* set bus param for ISI */
>> + if (common_flags & SOCAM_HSYNC_ACTIVE_LOW)
>> + cfg1 |= ISI_CFG1_HSYNC_POL_ACTIVE_LOW;
>> + if (common_flags & SOCAM_VSYNC_ACTIVE_LOW)
>> + cfg1 |= ISI_CFG1_VSYNC_POL_ACTIVE_LOW;
>> + if (common_flags & SOCAM_PCLK_SAMPLE_FALLING)
>> + cfg1 |= ISI_CFG1_PIXCLK_POL_ACTIVE_FALLING;
>> +
>> + if (isi->pdata->has_emb_sync)
>> + cfg1 |= ISI_CFG1_EMB_SYNC;
>> + if (isi->pdata->isi_full_mode)
>> + cfg1 |= ISI_CFG1_FULL_MODE;
>> +
>> + isi_writel(isi, ISI_CTRL, ISI_CTRL_DIS);
>> + isi_writel(isi, ISI_CFG1, cfg1);
>> +
>> + return 0;
>> +}
>> +
>> +static struct soc_camera_host_ops isi_soc_camera_host_ops = {
>> + .owner = THIS_MODULE,
>> + .add = isi_camera_add_device,
>> + .remove = isi_camera_remove_device,
>> + .set_fmt = isi_camera_set_fmt,
>> + .try_fmt = isi_camera_try_fmt,
>> + .get_formats = isi_camera_get_formats,
>> + .init_videobuf2 = isi_camera_init_videobuf,
>> + .poll = isi_camera_poll,
>> + .querycap = isi_camera_querycap,
>> + .set_bus_param = isi_camera_set_bus_param,
>> +};
>> +
>> +/* -----------------------------------------------------------------------*/
>> +static int __devexit atmel_isi_remove(struct platform_device *pdev)
>> +{
>> + struct soc_camera_host *soc_host = to_soc_camera_host(&pdev->dev);
>> + struct atmel_isi *isi = container_of(soc_host,
>> + struct atmel_isi, soc_host);
>> +

> Wouldn't it be better to first free IRQs to prevent any possible
> interrupts?

I'll move it ahead.

>> + soc_camera_host_unregister(soc_host);
>> + vb2_dma_contig_cleanup_ctx(isi->alloc_ctx);
>> + dma_free_coherent(&pdev->dev,
>> + sizeof(struct fbd) * MAX_BUFFER_NUM,
>> + isi->p_fb_descriptors,
>> + isi->fb_descriptors_phys);
>> +
>> + free_irq(isi->irq, isi);
>> + iounmap(isi->regs);
>> + clk_put(isi->pclk);
>> + kfree(isi);
>> +
>> + return 0;
>> +}
>> +
>> +static int __devinit atmel_isi_probe(struct platform_device *pdev)
>> +{
>> + unsigned int irq;
>> + struct atmel_isi *isi;
>> + struct clk *pclk;
>> + struct resource *regs;
>> + int ret, i;
>> + struct device *dev = &pdev->dev;
>> + struct soc_camera_host *soc_host;
>> +
>> + regs = platform_get_resource(pdev, IORESOURCE_MEM, 0);
>> + if (!regs)
>> + return -ENXIO;
>> +
>> + pclk = clk_get(&pdev->dev, "isi_clk");
>> + if (IS_ERR(pclk))
>> + return PTR_ERR(pclk);
>> +
>> + isi = kzalloc(sizeof(struct atmel_isi), GFP_KERNEL);
>> + if (!isi) {
>> + ret = -ENOMEM;
>> + dev_err(&pdev->dev, "Can't allocate interface!\n");
>> + goto err_alloc_isi;
>> + }
>> +
>> + isi->pclk = pclk;
>> +
>> + spin_lock_init(&isi->lock);
>> + init_waitqueue_head(&isi->vsync_wq);
>> +
>> + isi->p_fb_descriptors = dma_alloc_coherent(&pdev->dev,
>> + sizeof(struct fbd) * MAX_BUFFER_NUM,
>> + &isi->fb_descriptors_phys,
>> + GFP_KERNEL);
>> + if (!isi->p_fb_descriptors) {
>> + ret = -ENOMEM;
>> + dev_err(&pdev->dev, "Can't allocate descriptors!\n");
>> + goto err_alloc_descriptors;
>> + }
>> +
>> + INIT_LIST_HEAD(&isi->dma_desc_head);
>> + for (i = 0; i < MAX_BUFFER_NUM; i++) {
>> + isi->dma_desc[i].p_fbd = isi->p_fb_descriptors + i;
>> + isi->dma_desc[i].fbd_phys = isi->fb_descriptors_phys +
>> + i * sizeof(struct fbd);
>> + list_add(&isi->dma_desc[i].list, &isi->dma_desc_head);
>> + }
>> +
>> + isi->alloc_ctx = vb2_dma_contig_init_ctx(&pdev->dev);
>> + if (IS_ERR(isi->alloc_ctx)) {
>> + ret = PTR_ERR(isi->alloc_ctx);
>> + goto err_alloc_ctx;
>> + }
>> +
>> + isi->regs = ioremap(regs->start, resource_size(regs));
>> + if (!isi->regs) {
>> + ret = -ENOMEM;
>> + goto err_ioremap;
>> + }
>> +
>> + if (!dev->platform_data) {

> I would do this check right in the beginning of this function to simplify
> error handling.

yes, indeed simplify the error handling code a lot. I'll change it.

>> + dev_err(&pdev->dev,
>> + "No config available for Atmel ISI\n");
>> + ret = -EINVAL;
>> + goto err_req_irq;
>> + }
>> +
>> + isi->pdata = dev->platform_data;
>> + if (isi->pdata->data_width_flags == 0) {

> And this check too. You can even unite them into one like

>+ if (!dev->platform_data || !dev->platform_data->data_width_flags) {
>+ ...
>+ }

I will change this.

> Thanks
> Guennadi

Thank you.

>> [snip]

Best Regards,
Josh Wu
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/