drivers/media/video/omap3isp/isppreview.h

   1 /*
   2  * isppreview.h
   3  *
   4  * TI OMAP3 ISP - Preview module
   5  *
   6  * Copyright (C) 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_PREVIEW_H
  28 #define OMAP3_ISP_PREVIEW_H
  29
  30 #include <linux/omap3isp.h>
  31 #include <linux/types.h>
  32 #include <media/v4l2-ctrls.h>
  33
  34 #include "ispvideo.h"
  35
  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
  41
  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
  47
  48 #define NO_AVE                          0x0
  49 #define AVE_2_PIX                       0x1
  50 #define AVE_4_PIX                       0x2
  51 #define AVE_8_PIX                       0x3
  52
  53 /* Features list */
  54 #define PREV_LUMA_ENHANCE               OMAP3ISP_PREV_LUMAENH
  55 #define PREV_INVERSE_ALAW               OMAP3ISP_PREV_INVALAW
  56 #define PREV_HORZ_MEDIAN_FILTER         OMAP3ISP_PREV_HRZ_MED
  57 #define PREV_CFA                        OMAP3ISP_PREV_CFA
  58 #define PREV_CHROMA_SUPPRESS            OMAP3ISP_PREV_CHROMA_SUPP
  59 #define PREV_WB                         OMAP3ISP_PREV_WB
  60 #define PREV_BLKADJ                     OMAP3ISP_PREV_BLKADJ
  61 #define PREV_RGB2RGB                    OMAP3ISP_PREV_RGB2RGB
  62 #define PREV_COLOR_CONV                 OMAP3ISP_PREV_COLOR_CONV
  63 #define PREV_YCLIMITS                   OMAP3ISP_PREV_YC_LIMIT
  64 #define PREV_DEFECT_COR                 OMAP3ISP_PREV_DEFECT_COR
  65 #define PREV_GAMMA_BYPASS               OMAP3ISP_PREV_GAMMABYPASS
  66 #define PREV_DARK_FRAME_CAPTURE         OMAP3ISP_PREV_DRK_FRM_CAPTURE
  67 #define PREV_DARK_FRAME_SUBTRACT        OMAP3ISP_PREV_DRK_FRM_SUBTRACT
  68 #define PREV_LENS_SHADING               OMAP3ISP_PREV_LENS_SHADING
  69 #define PREV_NOISE_FILTER               OMAP3ISP_PREV_NF
  70 #define PREV_GAMMA                      OMAP3ISP_PREV_GAMMA
  71
  72 #define PREV_CONTRAST                   (1 << 17)
  73 #define PREV_BRIGHTNESS                 (1 << 18)
  74 #define PREV_AVERAGER                   (1 << 19)
  75 #define PREV_FEATURES_END               (1 << 20)
  76
  77 enum preview_input_entity {
  78         PREVIEW_INPUT_NONE,
  79         PREVIEW_INPUT_CCDC,
  80         PREVIEW_INPUT_MEMORY,
  81 };
  82
  83 #define PREVIEW_OUTPUT_RESIZER          (1 << 1)
  84 #define PREVIEW_OUTPUT_MEMORY           (1 << 2)
  85
  86 /* Configure byte layout of YUV image */
  87 enum preview_ycpos_mode {
  88         YCPOS_YCrYCb = 0,
  89         YCPOS_YCbYCr = 1,
  90         YCPOS_CbYCrY = 2,
  91         YCPOS_CrYCbY = 3
  92 };
  93
  94 /*
  95  * struct prev_params - Structure for all configuration
  96  * @features: Set of features enabled.
  97  * @cfa: CFA coefficients.
  98  * @csup: Chroma suppression coefficients.
  99  * @luma: Luma enhancement coefficients.
 100  * @nf: Noise filter coefficients.
 101  * @dcor: Noise filter coefficients.
 102  * @gamma: Gamma coefficients.
 103  * @wbal: White Balance parameters.
 104  * @blk_adj: Black adjustment parameters.
 105  * @rgb2rgb: RGB blending parameters.
 106  * @rgb2ycbcr: RGB to ycbcr parameters.
 107  * @hmed: Horizontal median filter.
 108  * @yclimit: YC limits parameters.
 109  * @average: Downsampling rate for averager.
 110  * @contrast: Contrast.
 111  * @brightness: Brightness.
 112  */
 113 struct prev_params {
 114         u32 features;
 115         struct omap3isp_prev_cfa cfa;
 116         struct omap3isp_prev_csup csup;
 117         struct omap3isp_prev_luma luma;
 118         struct omap3isp_prev_nf nf;
 119         struct omap3isp_prev_dcor dcor;
 120         struct omap3isp_prev_gtables gamma;
 121         struct omap3isp_prev_wbal wbal;
 122         struct omap3isp_prev_blkadj blk_adj;
 123         struct omap3isp_prev_rgbtorgb rgb2rgb;
 124         struct omap3isp_prev_csc rgb2ycbcr;
 125         struct omap3isp_prev_hmed hmed;
 126         struct omap3isp_prev_yclimit yclimit;
 127         u8 average;
 128         u8 contrast;
 129         u8 brightness;
 130 };
 131
 132 /*
 133  * struct isptables_update - Structure for Table Configuration.
 134  * @update: Specifies which tables should be updated.
 135  * @flag: Specifies which tables should be enabled.
 136  * @nf: Pointer to structure for Noise Filter
 137  * @lsc: Pointer to LSC gain table. (currently not used)
 138  * @gamma: Pointer to gamma correction tables.
 139  * @cfa: Pointer to color filter array configuration.
 140  * @wbal: Pointer to colour and digital gain configuration.
 141  */
 142 struct isptables_update {
 143         u32 update;
 144         u32 flag;
 145         struct omap3isp_prev_nf *nf;
 146         u32 *lsc;
 147         struct omap3isp_prev_gtables *gamma;
 148         struct omap3isp_prev_cfa *cfa;
 149         struct omap3isp_prev_wbal *wbal;
 150 };
 151
 152 /* Sink and source previewer pads */
 153 #define PREV_PAD_SINK                   0
 154 #define PREV_PAD_SOURCE                 1
 155 #define PREV_PADS_NUM                   2
 156
 157 /*
 158  * struct isp_prev_device - Structure for storing ISP Preview module information
 159  * @subdev: V4L2 subdevice
 160  * @pads: Media entity pads
 161  * @formats: Active formats at the subdev pad
 162  * @input: Module currently connected to the input pad
 163  * @output: Bitmask of the active output
 164  * @video_in: Input video entity
 165  * @video_out: Output video entity
 166  * @error: A hardware error occured during capture
 167  * @params: Module configuration data
 168  * @shadow_update: If set, update the hardware configured in the next interrupt
 169  * @underrun: Whether the preview entity has queued buffers on the output
 170  * @state: Current preview pipeline state
 171  * @lock: Shadow update lock
 172  * @update: Bitmask of the parameters to be updated
 173  *
 174  * This structure is used to store the OMAP ISP Preview module Information.
 175  */
 176 struct isp_prev_device {
 177         struct v4l2_subdev subdev;
 178         struct media_pad pads[PREV_PADS_NUM];
 179         struct v4l2_mbus_framefmt formats[PREV_PADS_NUM];
 180
 181         struct v4l2_ctrl_handler ctrls;
 182
 183         enum preview_input_entity input;
 184         unsigned int output;
 185         struct isp_video video_in;
 186         struct isp_video video_out;
 187         unsigned int error;
 188
 189         struct prev_params params;
 190         unsigned int shadow_update:1;
 191         enum isp_pipeline_stream_state state;
 192         wait_queue_head_t wait;
 193         atomic_t stopping;
 194         spinlock_t lock;
 195         u32 update;
 196 };
 197
 198 struct isp_device;
 199
 200 int omap3isp_preview_init(struct isp_device *isp);
 201 void omap3isp_preview_cleanup(struct isp_device *isp);
 202
 203 int omap3isp_preview_register_entities(struct isp_prev_device *prv,
 204                                        struct v4l2_device *vdev);
 205 void omap3isp_preview_unregister_entities(struct isp_prev_device *prv);
 206
 207 void omap3isp_preview_isr_frame_sync(struct isp_prev_device *prev);
 208 void omap3isp_preview_isr(struct isp_prev_device *prev);
 209
 210 int omap3isp_preview_busy(struct isp_prev_device *isp_prev);
 211
 212 void omap3isp_preview_restore_context(struct isp_device *isp);
 213
 214 #endif  /* OMAP3_ISP_PREVIEW_H */