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 * This program is distributed in the hope that it will be useful, but 17 * WITHOUT ANY WARRANTY; without even the implied warranty of 18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 19 * General Public License for more details. 20 * 21 * You should have received a copy of the GNU General Public License 22 * along with this program; if not, write to the Free Software 23 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 24 * 02110-1301 USA 25 */ 26 27 #ifndef OMAP3_ISP_CCDC_H 28 #define OMAP3_ISP_CCDC_H 29 30 #include <linux/omap3isp.h> 31 #include <linux/workqueue.h> 32 33 #include "ispvideo.h" 34 35 enum ccdc_input_entity { 36 CCDC_INPUT_NONE, 37 CCDC_INPUT_PARALLEL, 38 CCDC_INPUT_CSI2A, 39 CCDC_INPUT_CCP2B, 40 CCDC_INPUT_CSI2C 41 }; 42 43 #define CCDC_OUTPUT_MEMORY (1 << 0) 44 #define CCDC_OUTPUT_PREVIEW (1 << 1) 45 #define CCDC_OUTPUT_RESIZER (1 << 2) 46 47 #define OMAP3ISP_CCDC_NEVENTS 16 48 49 /* 50 * struct ispccdc_syncif - Structure for Sync Interface between sensor and CCDC 51 * @ccdc_mastermode: Master mode. 1 - Master, 0 - Slave. 52 * @fldstat: Field state. 0 - Odd Field, 1 - Even Field. 53 * @datsz: Data size. 54 * @fldmode: 0 - Progressive, 1 - Interlaced. 55 * @datapol: 0 - Positive, 1 - Negative. 56 * @fldpol: 0 - Positive, 1 - Negative. 57 * @hdpol: 0 - Positive, 1 - Negative. 58 * @vdpol: 0 - Positive, 1 - Negative. 59 * @fldout: 0 - Input, 1 - Output. 60 * @hs_width: Width of the Horizontal Sync pulse, used for HS/VS Output. 61 * @vs_width: Width of the Vertical Sync pulse, used for HS/VS Output. 62 * @ppln: Number of pixels per line, used for HS/VS Output. 63 * @hlprf: Number of half lines per frame, used for HS/VS Output. 64 * @bt_r656_en: 1 - Enable ITU-R BT656 mode, 0 - Sync mode. 65 */ 66 struct ispccdc_syncif { 67 u8 ccdc_mastermode; 68 u8 fldstat; 69 u8 datsz; 70 u8 fldmode; 71 u8 datapol; 72 u8 fldpol; 73 u8 hdpol; 74 u8 vdpol; 75 u8 fldout; 76 u8 hs_width; 77 u8 vs_width; 78 u8 ppln; 79 u8 hlprf; 80 u8 bt_r656_en; 81 }; 82 83 /* 84 * struct ispccdc_vp - Structure for Video Port parameters 85 * @pixelclk: Input pixel clock in Hz 86 */ 87 struct ispccdc_vp { 88 unsigned int pixelclk; 89 }; 90 91 enum ispccdc_lsc_state { 92 LSC_STATE_STOPPED = 0, 93 LSC_STATE_STOPPING = 1, 94 LSC_STATE_RUNNING = 2, 95 LSC_STATE_RECONFIG = 3, 96 }; 97 98 struct ispccdc_lsc_config_req { 99 struct list_head list; 100 struct omap3isp_ccdc_lsc_config config; 101 unsigned char enable; 102 u32 table; 103 struct iovm_struct *iovm; 104 }; 105 106 /* 107 * ispccdc_lsc - CCDC LSC parameters 108 * @update_config: Set when user changes config 109 * @request_enable: Whether LSC is requested to be enabled 110 * @config: LSC config set by user 111 * @update_table: Set when user provides a new LSC table to table_new 112 * @table_new: LSC table set by user, ISP address 113 * @table_inuse: LSC table currently in use, ISP address 114 */ 115 struct ispccdc_lsc { 116 enum ispccdc_lsc_state state; 117 struct work_struct table_work; 118 119 /* LSC queue of configurations */ 120 spinlock_t req_lock; 121 struct ispccdc_lsc_config_req *request; /* requested configuration */ 122 struct ispccdc_lsc_config_req *active; /* active configuration */ 123 struct list_head free_queue; /* configurations for freeing */ 124 }; 125 126 #define CCDC_STOP_NOT_REQUESTED 0x00 127 #define CCDC_STOP_REQUEST 0x01 128 #define CCDC_STOP_EXECUTED (0x02 | CCDC_STOP_REQUEST) 129 #define CCDC_STOP_CCDC_FINISHED 0x04 130 #define CCDC_STOP_LSC_FINISHED 0x08 131 #define CCDC_STOP_FINISHED \ 132 (CCDC_STOP_EXECUTED | CCDC_STOP_CCDC_FINISHED | CCDC_STOP_LSC_FINISHED) 133 134 #define CCDC_EVENT_VD1 0x10 135 #define CCDC_EVENT_VD0 0x20 136 #define CCDC_EVENT_LSC_DONE 0x40 137 138 /* Sink and source CCDC pads */ 139 #define CCDC_PAD_SINK 0 140 #define CCDC_PAD_SOURCE_OF 1 141 #define CCDC_PAD_SOURCE_VP 2 142 #define CCDC_PADS_NUM 3 143 144 /* 145 * struct isp_ccdc_device - Structure for the CCDC module to store its own 146 * information 147 * @subdev: V4L2 subdevice 148 * @pads: Sink and source media entity pads 149 * @formats: Active video formats 150 * @input: Active input 151 * @output: Active outputs 152 * @video_out: Output video node 153 * @alaw: A-law compression enabled (1) or disabled (0) 154 * @lpf: Low pass filter enabled (1) or disabled (0) 155 * @obclamp: Optical-black clamp enabled (1) or disabled (0) 156 * @fpc_en: Faulty pixels correction enabled (1) or disabled (0) 157 * @blcomp: Black level compensation configuration 158 * @clamp: Optical-black or digital clamp configuration 159 * @fpc: Faulty pixels correction configuration 160 * @lsc: Lens shading compensation configuration 161 * @update: Bitmask of controls to update during the next interrupt 162 * @shadow_update: Controls update in progress by userspace 163 * @syncif: Interface synchronization configuration 164 * @vpcfg: Video port configuration 165 * @underrun: A buffer underrun occurred and a new buffer has been queued 166 * @state: Streaming state 167 * @lock: Serializes shadow_update with interrupt handler 168 * @wait: Wait queue used to stop the module 169 * @stopping: Stopping state 170 * @ioctl_lock: Serializes ioctl calls and LSC requests freeing 171 */ 172 struct isp_ccdc_device { 173 struct v4l2_subdev subdev; 174 struct media_pad pads[CCDC_PADS_NUM]; 175 struct v4l2_mbus_framefmt formats[CCDC_PADS_NUM]; 176 177 enum ccdc_input_entity input; 178 unsigned int output; 179 struct isp_video video_out; 180 181 unsigned int alaw:1, 182 lpf:1, 183 obclamp:1, 184 fpc_en:1; 185 struct omap3isp_ccdc_blcomp blcomp; 186 struct omap3isp_ccdc_bclamp clamp; 187 struct omap3isp_ccdc_fpc fpc; 188 struct ispccdc_lsc lsc; 189 unsigned int update; 190 unsigned int shadow_update; 191 192 struct ispccdc_syncif syncif; 193 struct ispccdc_vp vpcfg; 194 195 unsigned int underrun:1; 196 enum isp_pipeline_stream_state state; 197 spinlock_t lock; 198 wait_queue_head_t wait; 199 unsigned int stopping; 200 struct mutex ioctl_lock; 201 }; 202 203 struct isp_device; 204 205 int omap3isp_ccdc_init(struct isp_device *isp); 206 void omap3isp_ccdc_cleanup(struct isp_device *isp); 207 int omap3isp_ccdc_register_entities(struct isp_ccdc_device *ccdc, 208 struct v4l2_device *vdev); 209 void omap3isp_ccdc_unregister_entities(struct isp_ccdc_device *ccdc); 210 211 int omap3isp_ccdc_busy(struct isp_ccdc_device *isp_ccdc); 212 int omap3isp_ccdc_isr(struct isp_ccdc_device *isp_ccdc, u32 events); 213 void omap3isp_ccdc_restore_context(struct isp_device *isp); 214 void omap3isp_ccdc_max_rate(struct isp_ccdc_device *ccdc, 215 unsigned int *max_rate); 216 217 #endif /* OMAP3_ISP_CCDC_H */ 218