include/media/davinci/isif.h

   1 /*
   2  * Copyright (C) 2008-2009 Texas Instruments Inc
   3  *
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * isif header file
  15  */
  16 #ifndef _ISIF_H
  17 #define _ISIF_H
  18
  19 #include <media/davinci/ccdc_types.h>
  20 #include <media/davinci/vpfe_types.h>
  21
  22 /* isif float type S8Q8/U8Q8 */
  23 struct isif_float_8 {
  24         /* 8 bit integer part */
  25         __u8 integer;
  26         /* 8 bit decimal part */
  27         __u8 decimal;
  28 };
  29
  30 /* isif float type U16Q16/S16Q16 */
  31 struct isif_float_16 {
  32         /* 16 bit integer part */
  33         __u16 integer;
  34         /* 16 bit decimal part */
  35         __u16 decimal;
  36 };
  37
  38 /************************************************************************
  39  *   Vertical Defect Correction parameters
  40  ***********************************************************************/
  41 /* Defect Correction (DFC) table entry */
  42 struct isif_vdfc_entry {
  43         /* vertical position of defect */
  44         __u16 pos_vert;
  45         /* horizontal position of defect */
  46         __u16 pos_horz;
  47         /*
  48          * Defect level of Vertical line defect position. This is subtracted
  49          * from the data at the defect position
  50          */
  51         __u8 level_at_pos;
  52         /*
  53          * Defect level of the pixels upper than the vertical line defect.
  54          * This is subtracted from the data
  55          */
  56         __u8 level_up_pixels;
  57         /*
  58          * Defect level of the pixels lower than the vertical line defect.
  59          * This is subtracted from the data
  60          */
  61         __u8 level_low_pixels;
  62 };
  63
  64 #define ISIF_VDFC_TABLE_SIZE            8
  65 struct isif_dfc {
  66         /* enable vertical defect correction */
  67         __u8 en;
  68         /* Defect level subtraction. Just fed through if saturating */
  69 #define ISIF_VDFC_NORMAL                0
  70         /*
  71          * Defect level subtraction. Horizontal interpolation ((i-2)+(i+2))/2
  72          * if data saturating
  73          */
  74 #define ISIF_VDFC_HORZ_INTERPOL_IF_SAT  1
  75         /* Horizontal interpolation (((i-2)+(i+2))/2) */
  76 #define ISIF_VDFC_HORZ_INTERPOL         2
  77         /* one of the vertical defect correction modes above */
  78         __u8 corr_mode;
  79         /* 0 - whole line corrected, 1 - not pixels upper than the defect */
  80         __u8 corr_whole_line;
  81 #define ISIF_VDFC_NO_SHIFT              0
  82 #define ISIF_VDFC_SHIFT_1               1
  83 #define ISIF_VDFC_SHIFT_2               2
  84 #define ISIF_VDFC_SHIFT_3               3
  85 #define ISIF_VDFC_SHIFT_4               4
  86         /*
  87          * defect level shift value. level_at_pos, level_upper_pos,
  88          * and level_lower_pos can be shifted up by this value. Choose
  89          * one of the values above
  90          */
  91         __u8 def_level_shift;
  92         /* defect saturation level */
  93         __u16 def_sat_level;
  94         /* number of vertical defects. Max is ISIF_VDFC_TABLE_SIZE */
  95         __u16 num_vdefects;
  96         /* VDFC table ptr */
  97         struct isif_vdfc_entry table[ISIF_VDFC_TABLE_SIZE];
  98 };
  99
 100 struct isif_horz_bclamp {
 101
 102         /* Horizontal clamp disabled. Only vertical clamp value is subtracted */
 103 #define ISIF_HORZ_BC_DISABLE            0
 104         /*
 105          * Horizontal clamp value is calculated and subtracted from image data
 106          * along with vertical clamp value
 107          */
 108 #define ISIF_HORZ_BC_CLAMP_CALC_ENABLED 1
 109         /*
 110          * Horizontal clamp value calculated from previous image is subtracted
 111          * from image data along with vertical clamp value.
 112          */
 113 #define ISIF_HORZ_BC_CLAMP_NOT_UPDATED  2
 114         /* horizontal clamp mode. One of the values above */
 115         __u8 mode;
 116         /*
 117          * pixel value limit enable.
 118          *  0 - limit disabled
 119          *  1 - pixel value limited to 1023
 120          */
 121         __u8 clamp_pix_limit;
 122         /* Select Most left window for bc calculation */
 123 #define ISIF_SEL_MOST_LEFT_WIN          0
 124         /* Select Most right window for bc calculation */
 125 #define ISIF_SEL_MOST_RIGHT_WIN         1
 126         /* Select most left or right window for clamp val calculation */
 127         __u8 base_win_sel_calc;
 128         /* Window count per color for calculation. range 1-32 */
 129         __u8 win_count_calc;
 130         /* Window start position - horizontal for calculation. 0 - 8191 */
 131         __u16 win_start_h_calc;
 132         /* Window start position - vertical for calculation 0 - 8191 */
 133         __u16 win_start_v_calc;
 134 #define ISIF_HORZ_BC_SZ_H_2PIXELS       0
 135 #define ISIF_HORZ_BC_SZ_H_4PIXELS       1
 136 #define ISIF_HORZ_BC_SZ_H_8PIXELS       2
 137 #define ISIF_HORZ_BC_SZ_H_16PIXELS      3
 138         /* Width of the sample window in pixels for calculation */
 139         __u8 win_h_sz_calc;
 140 #define ISIF_HORZ_BC_SZ_V_32PIXELS      0
 141 #define ISIF_HORZ_BC_SZ_V_64PIXELS      1
 142 #define ISIF_HORZ_BC_SZ_V_128PIXELS     2
 143 #define ISIF_HORZ_BC_SZ_V_256PIXELS     3
 144         /* Height of the sample window in pixels for calculation */
 145         __u8 win_v_sz_calc;
 146 };
 147
 148 /************************************************************************
 149  *  Black Clamp parameters
 150  ***********************************************************************/
 151 struct isif_vert_bclamp {
 152         /* Reset value used is the clamp value calculated */
 153 #define ISIF_VERT_BC_USE_HORZ_CLAMP_VAL         0
 154         /* Reset value used is reset_clamp_val configured */
 155 #define ISIF_VERT_BC_USE_CONFIG_CLAMP_VAL       1
 156         /* No update, previous image value is used */
 157 #define ISIF_VERT_BC_NO_UPDATE                  2
 158         /*
 159          * Reset value selector for vertical clamp calculation. Use one of
 160          * the above values
 161          */
 162         __u8 reset_val_sel;
 163         /* U8Q8. Line average coefficient used in vertical clamp calculation */
 164         __u8 line_ave_coef;
 165         /* Height of the optical black region for calculation */
 166         __u16 ob_v_sz_calc;
 167         /* Optical black region start position - horizontal. 0 - 8191 */
 168         __u16 ob_start_h;
 169         /* Optical black region start position - vertical 0 - 8191 */
 170         __u16 ob_start_v;
 171 };
 172
 173 struct isif_black_clamp {
 174         /*
 175          * This offset value is added irrespective of the clamp enable status.
 176          * S13
 177          */
 178         __u16 dc_offset;
 179         /*
 180          * Enable black/digital clamp value to be subtracted from the image data
 181          */
 182         __u8 en;
 183         /*
 184          * black clamp mode. same/separate clamp for 4 colors
 185          * 0 - disable - same clamp value for all colors
 186          * 1 - clamp value calculated separately for all colors
 187          */
 188         __u8 bc_mode_color;
 189         /* Vrtical start position for bc subtraction */
 190         __u16 vert_start_sub;
 191         /* Black clamp for horizontal direction */
 192         struct isif_horz_bclamp horz;
 193         /* Black clamp for vertical direction */
 194         struct isif_vert_bclamp vert;
 195 };
 196
 197 /*************************************************************************
 198 ** Color Space Conversion (CSC)
 199 *************************************************************************/
 200 #define ISIF_CSC_NUM_COEFF      16
 201 struct isif_color_space_conv {
 202         /* Enable color space conversion */
 203         __u8 en;
 204         /*
 205          * csc coeffient table. S8Q5, M00 at index 0, M01 at index 1, and
 206          * so forth
 207          */
 208         struct isif_float_8 coeff[ISIF_CSC_NUM_COEFF];
 209 };
 210
 211
 212 /*************************************************************************
 213 **  Black  Compensation parameters
 214 *************************************************************************/
 215 struct isif_black_comp {
 216         /* Comp for Red */
 217         __s8 r_comp;
 218         /* Comp for Gr */
 219         __s8 gr_comp;
 220         /* Comp for Blue */
 221         __s8 b_comp;
 222         /* Comp for Gb */
 223         __s8 gb_comp;
 224 };
 225
 226 /*************************************************************************
 227 **  Gain parameters
 228 *************************************************************************/
 229 struct isif_gain {
 230         /* Gain for Red or ye */
 231         struct isif_float_16 r_ye;
 232         /* Gain for Gr or cy */
 233         struct isif_float_16 gr_cy;
 234         /* Gain for Gb or g */
 235         struct isif_float_16 gb_g;
 236         /* Gain for Blue or mg */
 237         struct isif_float_16 b_mg;
 238 };
 239
 240 #define ISIF_LINEAR_TAB_SIZE    192
 241 /*************************************************************************
 242 **  Linearization parameters
 243 *************************************************************************/
 244 struct isif_linearize {
 245         /* Enable or Disable linearization of data */
 246         __u8 en;
 247         /* Shift value applied */
 248         __u8 corr_shft;
 249         /* scale factor applied U11Q10 */
 250         struct isif_float_16 scale_fact;
 251         /* Size of the linear table */
 252         __u16 table[ISIF_LINEAR_TAB_SIZE];
 253 };
 254
 255 /* Color patterns */
 256 #define ISIF_RED        0
 257 #define ISIF_GREEN_RED  1
 258 #define ISIF_GREEN_BLUE 2
 259 #define ISIF_BLUE       3
 260 struct isif_col_pat {
 261         __u8 olop;
 262         __u8 olep;
 263         __u8 elop;
 264         __u8 elep;
 265 };
 266
 267 /*************************************************************************
 268 **  Data formatter parameters
 269 *************************************************************************/
 270 struct isif_fmtplen {
 271         /*
 272          * number of program entries for SET0, range 1 - 16
 273          * when fmtmode is ISIF_SPLIT, 1 - 8 when fmtmode is
 274          * ISIF_COMBINE
 275          */
 276         __u16 plen0;
 277         /*
 278          * number of program entries for SET1, range 1 - 16
 279          * when fmtmode is ISIF_SPLIT, 1 - 8 when fmtmode is
 280          * ISIF_COMBINE
 281          */
 282         __u16 plen1;
 283         /**
 284          * number of program entries for SET2, range 1 - 16
 285          * when fmtmode is ISIF_SPLIT, 1 - 8 when fmtmode is
 286          * ISIF_COMBINE
 287          */
 288         __u16 plen2;
 289         /**
 290          * number of program entries for SET3, range 1 - 16
 291          * when fmtmode is ISIF_SPLIT, 1 - 8 when fmtmode is
 292          * ISIF_COMBINE
 293          */
 294         __u16 plen3;
 295 };
 296
 297 struct isif_fmt_cfg {
 298 #define ISIF_SPLIT              0
 299 #define ISIF_COMBINE            1
 300         /* Split or combine or line alternate */
 301         __u8 fmtmode;
 302         /* enable or disable line alternating mode */
 303         __u8 ln_alter_en;
 304 #define ISIF_1LINE              0
 305 #define ISIF_2LINES             1
 306 #define ISIF_3LINES             2
 307 #define ISIF_4LINES             3
 308         /* Split/combine line number */
 309         __u8 lnum;
 310         /* Address increment Range 1 - 16 */
 311         __u8 addrinc;
 312 };
 313
 314 struct isif_fmt_addr_ptr {
 315         /* Initial address */
 316         __u32 init_addr;
 317         /* output line number */
 318 #define ISIF_1STLINE            0
 319 #define ISIF_2NDLINE            1
 320 #define ISIF_3RDLINE            2
 321 #define ISIF_4THLINE            3
 322         __u8 out_line;
 323 };
 324
 325 struct isif_fmtpgm_ap {
 326         /* program address pointer */
 327         __u8 pgm_aptr;
 328         /* program address increment or decrement */
 329         __u8 pgmupdt;
 330 };
 331
 332 struct isif_data_formatter {
 333         /* Enable/Disable data formatter */
 334         __u8 en;
 335         /* data formatter configuration */
 336         struct isif_fmt_cfg cfg;
 337         /* Formatter program entries length */
 338         struct isif_fmtplen plen;
 339         /* first pixel in a line fed to formatter */
 340         __u16 fmtrlen;
 341         /* HD interval for output line. Only valid when split line */
 342         __u16 fmthcnt;
 343         /* formatter address pointers */
 344         struct isif_fmt_addr_ptr fmtaddr_ptr[16];
 345         /* program enable/disable */
 346         __u8 pgm_en[32];
 347         /* program address pointers */
 348         struct isif_fmtpgm_ap fmtpgm_ap[32];
 349 };
 350
 351 struct isif_df_csc {
 352         /* Color Space Conversion confguration, 0 - csc, 1 - df */
 353         __u8 df_or_csc;
 354         /* csc configuration valid if df_or_csc is 0 */
 355         struct isif_color_space_conv csc;
 356         /* data formatter configuration valid if df_or_csc is 1 */
 357         struct isif_data_formatter df;
 358         /* start pixel in a line at the input */
 359         __u32 start_pix;
 360         /* number of pixels in input line */
 361         __u32 num_pixels;
 362         /* start line at the input */
 363         __u32 start_line;
 364         /* number of lines at the input */
 365         __u32 num_lines;
 366 };
 367
 368 struct isif_gain_offsets_adj {
 369         /* Gain adjustment per color */
 370         struct isif_gain gain;
 371         /* Offset adjustment */
 372         __u16 offset;
 373         /* Enable or Disable Gain adjustment for SDRAM data */
 374         __u8 gain_sdram_en;
 375         /* Enable or Disable Gain adjustment for IPIPE data */
 376         __u8 gain_ipipe_en;
 377         /* Enable or Disable Gain adjustment for H3A data */
 378         __u8 gain_h3a_en;
 379         /* Enable or Disable Gain adjustment for SDRAM data */
 380         __u8 offset_sdram_en;
 381         /* Enable or Disable Gain adjustment for IPIPE data */
 382         __u8 offset_ipipe_en;
 383         /* Enable or Disable Gain adjustment for H3A data */
 384         __u8 offset_h3a_en;
 385 };
 386
 387 struct isif_cul {
 388         /* Horizontal Cull pattern for odd lines */
 389         __u8 hcpat_odd;
 390         /* Horizontal Cull pattern for even lines */
 391         __u8 hcpat_even;
 392         /* Vertical Cull pattern */
 393         __u8 vcpat;
 394         /* Enable or disable lpf. Apply when cull is enabled */
 395         __u8 en_lpf;
 396 };
 397
 398 struct isif_compress {
 399 #define ISIF_ALAW               0
 400 #define ISIF_DPCM               1
 401 #define ISIF_NO_COMPRESSION     2
 402         /* Compression Algorithm used */
 403         __u8 alg;
 404         /* Choose Predictor1 for DPCM compression */
 405 #define ISIF_DPCM_PRED1         0
 406         /* Choose Predictor2 for DPCM compression */
 407 #define ISIF_DPCM_PRED2         1
 408         /* Predictor for DPCM compression */
 409         __u8 pred;
 410 };
 411
 412 /* all the stuff in this struct will be provided by userland */
 413 struct isif_config_params_raw {
 414         /* Linearization parameters for image sensor data input */
 415         struct isif_linearize linearize;
 416         /* Data formatter or CSC */
 417         struct isif_df_csc df_csc;
 418         /* Defect Pixel Correction (DFC) confguration */
 419         struct isif_dfc dfc;
 420         /* Black/Digital Clamp configuration */
 421         struct isif_black_clamp bclamp;
 422         /* Gain, offset adjustments */
 423         struct isif_gain_offsets_adj gain_offset;
 424         /* Culling */
 425         struct isif_cul culling;
 426         /* A-Law and DPCM compression options */
 427         struct isif_compress compress;
 428         /* horizontal offset for Gain/LSC/DFC */
 429         __u16 horz_offset;
 430         /* vertical offset for Gain/LSC/DFC */
 431         __u16 vert_offset;
 432         /* color pattern for field 0 */
 433         struct isif_col_pat col_pat_field0;
 434         /* color pattern for field 1 */
 435         struct isif_col_pat col_pat_field1;
 436 #define ISIF_NO_SHIFT           0
 437 #define ISIF_1BIT_SHIFT         1
 438 #define ISIF_2BIT_SHIFT         2
 439 #define ISIF_3BIT_SHIFT         3
 440 #define ISIF_4BIT_SHIFT         4
 441 #define ISIF_5BIT_SHIFT         5
 442 #define ISIF_6BIT_SHIFT         6
 443         /* Data shift applied before storing to SDRAM */
 444         __u8 data_shift;
 445         /* enable input test pattern generation */
 446         __u8 test_pat_gen;
 447 };
 448
 449 #ifdef __KERNEL__
 450 struct isif_ycbcr_config {
 451         /* isif pixel format */
 452         enum ccdc_pixfmt pix_fmt;
 453         /* isif frame format */
 454         enum ccdc_frmfmt frm_fmt;
 455         /* ISIF crop window */
 456         struct v4l2_rect win;
 457         /* field polarity */
 458         enum vpfe_pin_pol fid_pol;
 459         /* interface VD polarity */
 460         enum vpfe_pin_pol vd_pol;
 461         /* interface HD polarity */
 462         enum vpfe_pin_pol hd_pol;
 463         /* isif pix order. Only used for ycbcr capture */
 464         enum ccdc_pixorder pix_order;
 465         /* isif buffer type. Only used for ycbcr capture */
 466         enum ccdc_buftype buf_type;
 467 };
 468
 469 /* MSB of image data connected to sensor port */
 470 enum isif_data_msb {
 471         ISIF_BIT_MSB_15,
 472         ISIF_BIT_MSB_14,
 473         ISIF_BIT_MSB_13,
 474         ISIF_BIT_MSB_12,
 475         ISIF_BIT_MSB_11,
 476         ISIF_BIT_MSB_10,
 477         ISIF_BIT_MSB_9,
 478         ISIF_BIT_MSB_8,
 479         ISIF_BIT_MSB_7
 480 };
 481
 482 enum isif_cfa_pattern {
 483         ISIF_CFA_PAT_MOSAIC,
 484         ISIF_CFA_PAT_STRIPE
 485 };
 486
 487 struct isif_params_raw {
 488         /* isif pixel format */
 489         enum ccdc_pixfmt pix_fmt;
 490         /* isif frame format */
 491         enum ccdc_frmfmt frm_fmt;
 492         /* video window */
 493         struct v4l2_rect win;
 494         /* field polarity */
 495         enum vpfe_pin_pol fid_pol;
 496         /* interface VD polarity */
 497         enum vpfe_pin_pol vd_pol;
 498         /* interface HD polarity */
 499         enum vpfe_pin_pol hd_pol;
 500         /* buffer type. Applicable for interlaced mode */
 501         enum ccdc_buftype buf_type;
 502         /* Gain values */
 503         struct isif_gain gain;
 504         /* cfa pattern */
 505         enum isif_cfa_pattern cfa_pat;
 506         /* Data MSB position */
 507         enum isif_data_msb data_msb;
 508         /* Enable horizontal flip */
 509         unsigned char horz_flip_en;
 510         /* Enable image invert vertically */
 511         unsigned char image_invert_en;
 512
 513         /* all the userland defined stuff*/
 514         struct isif_config_params_raw config_params;
 515 };
 516
 517 enum isif_data_pack {
 518         ISIF_PACK_16BIT,
 519         ISIF_PACK_12BIT,
 520         ISIF_PACK_8BIT
 521 };
 522
 523 #define ISIF_WIN_NTSC                           {0, 0, 720, 480}
 524 #define ISIF_WIN_VGA                            {0, 0, 640, 480}
 525
 526 #endif
 527 #endif