kernel/drivers/media/platform/omap3isp/ispccdc.h

   1 /*
   2  * ispccdc.h
   3  *
   4  * TI OMAP3 ISP - CCDC module
   5  *
   6  * Copyright (C) 2009-2010 Nokia Corporation
   7  * Copyright (C) 2009 Texas Instruments, Inc.
   8  *
   9  * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
  10  *           Sakari Ailus <sakari.ailus@iki.fi>
  11  *
  12  * This program is free software; you can redistribute it and/or modify
  13  * it under the terms of the GNU General Public License version 2 as
  14  * published by the Free Software Foundation.
  15  */
  16
  17 #ifndef OMAP3_ISP_CCDC_H
  18 #define OMAP3_ISP_CCDC_H
  19
  20 #include <linux/omap3isp.h>
  21 #include <linux/workqueue.h>
  22
  23 #include "ispvideo.h"
  24
  25 enum ccdc_input_entity {
  26         CCDC_INPUT_NONE,
  27         CCDC_INPUT_PARALLEL,
  28         CCDC_INPUT_CSI2A,
  29         CCDC_INPUT_CCP2B,
  30         CCDC_INPUT_CSI2C
  31 };
  32
  33 #define CCDC_OUTPUT_MEMORY      (1 << 0)
  34 #define CCDC_OUTPUT_PREVIEW     (1 << 1)
  35 #define CCDC_OUTPUT_RESIZER     (1 << 2)
  36
  37 #define OMAP3ISP_CCDC_NEVENTS   16
  38
  39 struct ispccdc_fpc {
  40         void *addr;
  41         dma_addr_t dma;
  42         unsigned int fpnum;
  43 };
  44
  45 enum ispccdc_lsc_state {
  46         LSC_STATE_STOPPED = 0,
  47         LSC_STATE_STOPPING = 1,
  48         LSC_STATE_RUNNING = 2,
  49         LSC_STATE_RECONFIG = 3,
  50 };
  51
  52 struct ispccdc_lsc_config_req {
  53         struct list_head list;
  54         struct omap3isp_ccdc_lsc_config config;
  55         unsigned char enable;
  56
  57         struct {
  58                 void *addr;
  59                 dma_addr_t dma;
  60                 struct sg_table sgt;
  61         } table;
  62 };
  63
  64 /*
  65  * ispccdc_lsc - CCDC LSC parameters
  66  */
  67 struct ispccdc_lsc {
  68         enum ispccdc_lsc_state state;
  69         struct work_struct table_work;
  70
  71         /* LSC queue of configurations */
  72         spinlock_t req_lock;
  73         struct ispccdc_lsc_config_req *request; /* requested configuration */
  74         struct ispccdc_lsc_config_req *active;  /* active configuration */
  75         struct list_head free_queue;    /* configurations for freeing */
  76 };
  77
  78 #define CCDC_STOP_NOT_REQUESTED         0x00
  79 #define CCDC_STOP_REQUEST               0x01
  80 #define CCDC_STOP_EXECUTED              (0x02 | CCDC_STOP_REQUEST)
  81 #define CCDC_STOP_CCDC_FINISHED         0x04
  82 #define CCDC_STOP_LSC_FINISHED          0x08
  83 #define CCDC_STOP_FINISHED              \
  84         (CCDC_STOP_EXECUTED | CCDC_STOP_CCDC_FINISHED | CCDC_STOP_LSC_FINISHED)
  85
  86 #define CCDC_EVENT_VD1                  0x10
  87 #define CCDC_EVENT_VD0                  0x20
  88 #define CCDC_EVENT_LSC_DONE             0x40
  89
  90 /* Sink and source CCDC pads */
  91 #define CCDC_PAD_SINK                   0
  92 #define CCDC_PAD_SOURCE_OF              1
  93 #define CCDC_PAD_SOURCE_VP              2
  94 #define CCDC_PADS_NUM                   3
  95
  96 #define CCDC_FIELD_TOP                  1
  97 #define CCDC_FIELD_BOTTOM               2
  98 #define CCDC_FIELD_BOTH                 3
  99
 100 /*
 101  * struct isp_ccdc_device - Structure for the CCDC module to store its own
 102  *                          information
 103  * @subdev: V4L2 subdevice
 104  * @pads: Sink and source media entity pads
 105  * @formats: Active video formats
 106  * @crop: Active crop rectangle on the OF source pad
 107  * @input: Active input
 108  * @output: Active outputs
 109  * @video_out: Output video node
 110  * @alaw: A-law compression enabled (1) or disabled (0)
 111  * @lpf: Low pass filter enabled (1) or disabled (0)
 112  * @obclamp: Optical-black clamp enabled (1) or disabled (0)
 113  * @fpc_en: Faulty pixels correction enabled (1) or disabled (0)
 114  * @blcomp: Black level compensation configuration
 115  * @clamp: Optical-black or digital clamp configuration
 116  * @fpc: Faulty pixels correction configuration
 117  * @lsc: Lens shading compensation configuration
 118  * @update: Bitmask of controls to update during the next interrupt
 119  * @shadow_update: Controls update in progress by userspace
 120  * @bt656: Whether the input interface uses BT.656 synchronization
 121  * @fields: The fields (CCDC_FIELD_*) stored in the current buffer
 122  * @underrun: A buffer underrun occurred and a new buffer has been queued
 123  * @state: Streaming state
 124  * @lock: Serializes shadow_update with interrupt handler
 125  * @wait: Wait queue used to stop the module
 126  * @stopping: Stopping state
 127  * @running: Is the CCDC hardware running
 128  * @ioctl_lock: Serializes ioctl calls and LSC requests freeing
 129  */
 130 struct isp_ccdc_device {
 131         struct v4l2_subdev subdev;
 132         struct media_pad pads[CCDC_PADS_NUM];
 133         struct v4l2_mbus_framefmt formats[CCDC_PADS_NUM];
 134         struct v4l2_rect crop;
 135
 136         enum ccdc_input_entity input;
 137         unsigned int output;
 138         struct isp_video video_out;
 139
 140         unsigned int alaw:1,
 141                      lpf:1,
 142                      obclamp:1,
 143                      fpc_en:1;
 144         struct omap3isp_ccdc_blcomp blcomp;
 145         struct omap3isp_ccdc_bclamp clamp;
 146         struct ispccdc_fpc fpc;
 147         struct ispccdc_lsc lsc;
 148         unsigned int update;
 149         unsigned int shadow_update;
 150
 151         bool bt656;
 152         unsigned int fields;
 153
 154         unsigned int underrun:1;
 155         enum isp_pipeline_stream_state state;
 156         spinlock_t lock;
 157         wait_queue_head_t wait;
 158         unsigned int stopping;
 159         bool running;
 160         struct mutex ioctl_lock;
 161 };
 162
 163 struct isp_device;
 164
 165 int omap3isp_ccdc_init(struct isp_device *isp);
 166 void omap3isp_ccdc_cleanup(struct isp_device *isp);
 167 int omap3isp_ccdc_register_entities(struct isp_ccdc_device *ccdc,
 168         struct v4l2_device *vdev);
 169 void omap3isp_ccdc_unregister_entities(struct isp_ccdc_device *ccdc);
 170
 171 int omap3isp_ccdc_busy(struct isp_ccdc_device *isp_ccdc);
 172 int omap3isp_ccdc_isr(struct isp_ccdc_device *isp_ccdc, u32 events);
 173 void omap3isp_ccdc_restore_context(struct isp_device *isp);
 174 void omap3isp_ccdc_max_rate(struct isp_ccdc_device *ccdc,
 175         unsigned int *max_rate);
 176
 177 #endif  /* OMAP3_ISP_CCDC_H */