4 * TI OMAP3 ISP - Preview module
6 * Copyright (C) 2010 Nokia Corporation
7 * Copyright (C) 2009 Texas Instruments, Inc.
9 * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
10 * Sakari Ailus <sakari.ailus@iki.fi>
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.
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.
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
27 #ifndef OMAP3_ISP_PREVIEW_H
28 #define OMAP3_ISP_PREVIEW_H
30 #include <linux/omap3isp.h>
31 #include <linux/types.h>
32 #include <media/v4l2-ctrls.h>
36 #define ISPPRV_BRIGHT_STEP 0x1
37 #define ISPPRV_BRIGHT_DEF 0x0
38 #define ISPPRV_BRIGHT_LOW 0x0
39 #define ISPPRV_BRIGHT_HIGH 0xFF
40 #define ISPPRV_BRIGHT_UNITS 0x1
42 #define ISPPRV_CONTRAST_STEP 0x1
43 #define ISPPRV_CONTRAST_DEF 0x10
44 #define ISPPRV_CONTRAST_LOW 0x0
45 #define ISPPRV_CONTRAST_HIGH 0xFF
46 #define ISPPRV_CONTRAST_UNITS 0x1
49 #define PREV_LUMA_ENHANCE OMAP3ISP_PREV_LUMAENH
50 #define PREV_INVERSE_ALAW OMAP3ISP_PREV_INVALAW
51 #define PREV_HORZ_MEDIAN_FILTER OMAP3ISP_PREV_HRZ_MED
52 #define PREV_CFA OMAP3ISP_PREV_CFA
53 #define PREV_CHROMA_SUPPRESS OMAP3ISP_PREV_CHROMA_SUPP
54 #define PREV_WB OMAP3ISP_PREV_WB
55 #define PREV_BLKADJ OMAP3ISP_PREV_BLKADJ
56 #define PREV_RGB2RGB OMAP3ISP_PREV_RGB2RGB
57 #define PREV_COLOR_CONV OMAP3ISP_PREV_COLOR_CONV
58 #define PREV_YCLIMITS OMAP3ISP_PREV_YC_LIMIT
59 #define PREV_DEFECT_COR OMAP3ISP_PREV_DEFECT_COR
60 #define PREV_GAMMA_BYPASS OMAP3ISP_PREV_GAMMABYPASS
61 #define PREV_DARK_FRAME_CAPTURE OMAP3ISP_PREV_DRK_FRM_CAPTURE
62 #define PREV_DARK_FRAME_SUBTRACT OMAP3ISP_PREV_DRK_FRM_SUBTRACT
63 #define PREV_LENS_SHADING OMAP3ISP_PREV_LENS_SHADING
64 #define PREV_NOISE_FILTER OMAP3ISP_PREV_NF
65 #define PREV_GAMMA OMAP3ISP_PREV_GAMMA
67 #define PREV_CONTRAST (1 << 17)
68 #define PREV_BRIGHTNESS (1 << 18)
69 #define PREV_AVERAGER (1 << 19)
70 #define PREV_FEATURES_END (1 << 20)
72 enum preview_input_entity
{
78 #define PREVIEW_OUTPUT_RESIZER (1 << 1)
79 #define PREVIEW_OUTPUT_MEMORY (1 << 2)
81 /* Configure byte layout of YUV image */
82 enum preview_ycpos_mode
{
90 * struct prev_params - Structure for all configuration
91 * @features: Set of features enabled.
92 * @cfa: CFA coefficients.
93 * @csup: Chroma suppression coefficients.
94 * @luma: Luma enhancement coefficients.
95 * @nf: Noise filter coefficients.
96 * @dcor: Noise filter coefficients.
97 * @gamma: Gamma coefficients.
98 * @wbal: White Balance parameters.
99 * @blk_adj: Black adjustment parameters.
100 * @rgb2rgb: RGB blending parameters.
101 * @rgb2ycbcr: RGB to ycbcr parameters.
102 * @hmed: Horizontal median filter.
103 * @yclimit: YC limits parameters.
104 * @contrast: Contrast.
105 * @brightness: Brightness.
109 struct omap3isp_prev_cfa cfa
;
110 struct omap3isp_prev_csup csup
;
111 struct omap3isp_prev_luma luma
;
112 struct omap3isp_prev_nf nf
;
113 struct omap3isp_prev_dcor dcor
;
114 struct omap3isp_prev_gtables gamma
;
115 struct omap3isp_prev_wbal wbal
;
116 struct omap3isp_prev_blkadj blk_adj
;
117 struct omap3isp_prev_rgbtorgb rgb2rgb
;
118 struct omap3isp_prev_csc rgb2ycbcr
;
119 struct omap3isp_prev_hmed hmed
;
120 struct omap3isp_prev_yclimit yclimit
;
126 * struct isptables_update - Structure for Table Configuration.
127 * @update: Specifies which tables should be updated.
128 * @flag: Specifies which tables should be enabled.
129 * @nf: Pointer to structure for Noise Filter
130 * @lsc: Pointer to LSC gain table. (currently not used)
131 * @gamma: Pointer to gamma correction tables.
132 * @cfa: Pointer to color filter array configuration.
133 * @wbal: Pointer to colour and digital gain configuration.
135 struct isptables_update
{
138 struct omap3isp_prev_nf
*nf
;
140 struct omap3isp_prev_gtables
*gamma
;
141 struct omap3isp_prev_cfa
*cfa
;
142 struct omap3isp_prev_wbal
*wbal
;
145 /* Sink and source previewer pads */
146 #define PREV_PAD_SINK 0
147 #define PREV_PAD_SOURCE 1
148 #define PREV_PADS_NUM 2
151 * struct isp_prev_device - Structure for storing ISP Preview module information
152 * @subdev: V4L2 subdevice
153 * @pads: Media entity pads
154 * @formats: Active formats at the subdev pad
155 * @crop: Active crop rectangle
156 * @input: Module currently connected to the input pad
157 * @output: Bitmask of the active output
158 * @video_in: Input video entity
159 * @video_out: Output video entity
160 * @params: Module configuration data
161 * @shadow_update: If set, update the hardware configured in the next interrupt
162 * @underrun: Whether the preview entity has queued buffers on the output
163 * @state: Current preview pipeline state
164 * @lock: Shadow update lock
165 * @update: Bitmask of the parameters to be updated
167 * This structure is used to store the OMAP ISP Preview module Information.
169 struct isp_prev_device
{
170 struct v4l2_subdev subdev
;
171 struct media_pad pads
[PREV_PADS_NUM
];
172 struct v4l2_mbus_framefmt formats
[PREV_PADS_NUM
];
173 struct v4l2_rect crop
;
175 struct v4l2_ctrl_handler ctrls
;
177 enum preview_input_entity input
;
179 struct isp_video video_in
;
180 struct isp_video video_out
;
182 struct prev_params params
;
183 unsigned int shadow_update
:1;
184 enum isp_pipeline_stream_state state
;
185 wait_queue_head_t wait
;
193 int omap3isp_preview_init(struct isp_device
*isp
);
194 void omap3isp_preview_cleanup(struct isp_device
*isp
);
196 int omap3isp_preview_register_entities(struct isp_prev_device
*prv
,
197 struct v4l2_device
*vdev
);
198 void omap3isp_preview_unregister_entities(struct isp_prev_device
*prv
);
200 void omap3isp_preview_isr_frame_sync(struct isp_prev_device
*prev
);
201 void omap3isp_preview_isr(struct isp_prev_device
*prev
);
203 int omap3isp_preview_busy(struct isp_prev_device
*isp_prev
);
205 void omap3isp_preview_restore_context(struct isp_device
*isp
);
207 #endif /* OMAP3_ISP_PREVIEW_H */