1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ 2 /* 3 * omap3isp.h 4 * 5 * TI OMAP3 ISP - User-space API 6 * 7 * Copyright (C) 2010 Nokia Corporation 8 * Copyright (C) 2009 Texas Instruments, Inc. 9 * 10 * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com> 11 * Sakari Ailus <sakari.ailus@iki.fi> 12 * 13 * This program is free software; you can redistribute it and/or modify 14 * it under the terms of the GNU General Public License version 2 as 15 * published by the Free Software Foundation. 16 * 17 * This program is distributed in the hope that it will be useful, but 18 * WITHOUT ANY WARRANTY; without even the implied warranty of 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 20 * General Public License for more details. 21 * 22 * You should have received a copy of the GNU General Public License 23 * along with this program; if not, write to the Free Software 24 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 25 * 02110-1301 USA 26 */ 27 28 #ifndef OMAP3_ISP_USER_H 29 #define OMAP3_ISP_USER_H 30 31 #include <linux/types.h> 32 #include <linux/videodev2.h> 33 34 /* 35 * Private IOCTLs 36 * 37 * VIDIOC_OMAP3ISP_CCDC_CFG: Set CCDC configuration 38 * VIDIOC_OMAP3ISP_PRV_CFG: Set preview engine configuration 39 * VIDIOC_OMAP3ISP_AEWB_CFG: Set AEWB module configuration 40 * VIDIOC_OMAP3ISP_HIST_CFG: Set histogram module configuration 41 * VIDIOC_OMAP3ISP_AF_CFG: Set auto-focus module configuration 42 * VIDIOC_OMAP3ISP_STAT_REQ: Read statistics (AEWB/AF/histogram) data 43 * VIDIOC_OMAP3ISP_STAT_EN: Enable/disable a statistics module 44 */ 45 46 #define VIDIOC_OMAP3ISP_CCDC_CFG \ 47 _IOWR('V', BASE_VIDIOC_PRIVATE + 1, struct omap3isp_ccdc_update_config) 48 #define VIDIOC_OMAP3ISP_PRV_CFG \ 49 _IOWR('V', BASE_VIDIOC_PRIVATE + 2, struct omap3isp_prev_update_config) 50 #define VIDIOC_OMAP3ISP_AEWB_CFG \ 51 _IOWR('V', BASE_VIDIOC_PRIVATE + 3, struct omap3isp_h3a_aewb_config) 52 #define VIDIOC_OMAP3ISP_HIST_CFG \ 53 _IOWR('V', BASE_VIDIOC_PRIVATE + 4, struct omap3isp_hist_config) 54 #define VIDIOC_OMAP3ISP_AF_CFG \ 55 _IOWR('V', BASE_VIDIOC_PRIVATE + 5, struct omap3isp_h3a_af_config) 56 #define VIDIOC_OMAP3ISP_STAT_REQ \ 57 _IOWR('V', BASE_VIDIOC_PRIVATE + 6, struct omap3isp_stat_data) 58 #define VIDIOC_OMAP3ISP_STAT_REQ_TIME32 \ 59 _IOWR('V', BASE_VIDIOC_PRIVATE + 6, struct omap3isp_stat_data_time32) 60 #define VIDIOC_OMAP3ISP_STAT_EN \ 61 _IOWR('V', BASE_VIDIOC_PRIVATE + 7, unsigned long) 62 63 /* 64 * Events 65 * 66 * V4L2_EVENT_OMAP3ISP_AEWB: AEWB statistics data ready 67 * V4L2_EVENT_OMAP3ISP_AF: AF statistics data ready 68 * V4L2_EVENT_OMAP3ISP_HIST: Histogram statistics data ready 69 */ 70 71 #define V4L2_EVENT_OMAP3ISP_CLASS (V4L2_EVENT_PRIVATE_START | 0x100) 72 #define V4L2_EVENT_OMAP3ISP_AEWB (V4L2_EVENT_OMAP3ISP_CLASS | 0x1) 73 #define V4L2_EVENT_OMAP3ISP_AF (V4L2_EVENT_OMAP3ISP_CLASS | 0x2) 74 #define V4L2_EVENT_OMAP3ISP_HIST (V4L2_EVENT_OMAP3ISP_CLASS | 0x3) 75 76 struct omap3isp_stat_event_status { 77 uint32_t frame_number; 78 uint16_t config_counter; 79 uint8_t buf_err; 80 }; 81 82 /* AE/AWB related structures and flags*/ 83 84 /* H3A Range Constants */ 85 #define OMAP3ISP_AEWB_MAX_SATURATION_LIM 1023 86 #define OMAP3ISP_AEWB_MIN_WIN_H 2 87 #define OMAP3ISP_AEWB_MAX_WIN_H 256 88 #define OMAP3ISP_AEWB_MIN_WIN_W 6 89 #define OMAP3ISP_AEWB_MAX_WIN_W 256 90 #define OMAP3ISP_AEWB_MIN_WINVC 1 91 #define OMAP3ISP_AEWB_MIN_WINHC 1 92 #define OMAP3ISP_AEWB_MAX_WINVC 128 93 #define OMAP3ISP_AEWB_MAX_WINHC 36 94 #define OMAP3ISP_AEWB_MAX_WINSTART 4095 95 #define OMAP3ISP_AEWB_MIN_SUB_INC 2 96 #define OMAP3ISP_AEWB_MAX_SUB_INC 32 97 #define OMAP3ISP_AEWB_MAX_BUF_SIZE 83600 98 99 #define OMAP3ISP_AF_IIRSH_MIN 0 100 #define OMAP3ISP_AF_IIRSH_MAX 4095 101 #define OMAP3ISP_AF_PAXEL_HORIZONTAL_COUNT_MIN 1 102 #define OMAP3ISP_AF_PAXEL_HORIZONTAL_COUNT_MAX 36 103 #define OMAP3ISP_AF_PAXEL_VERTICAL_COUNT_MIN 1 104 #define OMAP3ISP_AF_PAXEL_VERTICAL_COUNT_MAX 128 105 #define OMAP3ISP_AF_PAXEL_INCREMENT_MIN 2 106 #define OMAP3ISP_AF_PAXEL_INCREMENT_MAX 32 107 #define OMAP3ISP_AF_PAXEL_HEIGHT_MIN 2 108 #define OMAP3ISP_AF_PAXEL_HEIGHT_MAX 256 109 #define OMAP3ISP_AF_PAXEL_WIDTH_MIN 16 110 #define OMAP3ISP_AF_PAXEL_WIDTH_MAX 256 111 #define OMAP3ISP_AF_PAXEL_HZSTART_MIN 1 112 #define OMAP3ISP_AF_PAXEL_HZSTART_MAX 4095 113 #define OMAP3ISP_AF_PAXEL_VTSTART_MIN 0 114 #define OMAP3ISP_AF_PAXEL_VTSTART_MAX 4095 115 #define OMAP3ISP_AF_THRESHOLD_MAX 255 116 #define OMAP3ISP_AF_COEF_MAX 4095 117 #define OMAP3ISP_AF_PAXEL_SIZE 48 118 #define OMAP3ISP_AF_MAX_BUF_SIZE 221184 119 120 /** 121 * struct omap3isp_h3a_aewb_config - AE AWB configuration reset values 122 * saturation_limit: Saturation limit. 123 * @win_height: Window Height. Range 2 - 256, even values only. 124 * @win_width: Window Width. Range 6 - 256, even values only. 125 * @ver_win_count: Vertical Window Count. Range 1 - 128. 126 * @hor_win_count: Horizontal Window Count. Range 1 - 36. 127 * @ver_win_start: Vertical Window Start. Range 0 - 4095. 128 * @hor_win_start: Horizontal Window Start. Range 0 - 4095. 129 * @blk_ver_win_start: Black Vertical Windows Start. Range 0 - 4095. 130 * @blk_win_height: Black Window Height. Range 2 - 256, even values only. 131 * @subsample_ver_inc: Subsample Vertical points increment Range 2 - 32, even 132 * values only. 133 * @subsample_hor_inc: Subsample Horizontal points increment Range 2 - 32, even 134 * values only. 135 * @alaw_enable: AEW ALAW EN flag. 136 */ 137 struct omap3isp_h3a_aewb_config { 138 /* 139 * Common fields. 140 * They should be the first ones and must be in the same order as in 141 * ispstat_generic_config struct. 142 */ 143 uint32_t buf_size; 144 uint16_t config_counter; 145 146 /* Private fields */ 147 uint16_t saturation_limit; 148 uint16_t win_height; 149 uint16_t win_width; 150 uint16_t ver_win_count; 151 uint16_t hor_win_count; 152 uint16_t ver_win_start; 153 uint16_t hor_win_start; 154 uint16_t blk_ver_win_start; 155 uint16_t blk_win_height; 156 uint16_t subsample_ver_inc; 157 uint16_t subsample_hor_inc; 158 uint8_t alaw_enable; 159 }; 160 161 /** 162 * struct omap3isp_stat_data - Statistic data sent to or received from user 163 * @ts: Timestamp of returned framestats. 164 * @buf: Pointer to pass to user. 165 * @frame_number: Frame number of requested stats. 166 * @cur_frame: Current frame number being processed. 167 * @config_counter: Number of the configuration associated with the data. 168 */ 169 struct omap3isp_stat_data { 170 #ifdef __KERNEL__ 171 struct { 172 int64_t tv_sec; 173 int64_t tv_usec; 174 } ts; 175 #else 176 struct timeval ts; 177 #endif 178 void *buf; 179 uint32_t buf_size; 180 uint16_t frame_number; 181 uint16_t cur_frame; 182 uint16_t config_counter; 183 }; 184 185 #ifdef __KERNEL__ 186 struct omap3isp_stat_data_time32 { 187 struct { 188 int32_t tv_sec; 189 int32_t tv_usec; 190 } ts; 191 uint32_t buf; 192 uint32_t buf_size; 193 uint16_t frame_number; 194 uint16_t cur_frame; 195 uint16_t config_counter; 196 }; 197 #endif 198 199 /* Histogram related structs */ 200 201 /* Flags for number of bins */ 202 #define OMAP3ISP_HIST_BINS_32 0 203 #define OMAP3ISP_HIST_BINS_64 1 204 #define OMAP3ISP_HIST_BINS_128 2 205 #define OMAP3ISP_HIST_BINS_256 3 206 207 /* Number of bins * 4 colors * 4-bytes word */ 208 #define OMAP3ISP_HIST_MEM_SIZE_BINS(n) ((1 << ((n)+5))*4*4) 209 210 #define OMAP3ISP_HIST_MEM_SIZE 1024 211 #define OMAP3ISP_HIST_MIN_REGIONS 1 212 #define OMAP3ISP_HIST_MAX_REGIONS 4 213 #define OMAP3ISP_HIST_MAX_WB_GAIN 255 214 #define OMAP3ISP_HIST_MIN_WB_GAIN 0 215 #define OMAP3ISP_HIST_MAX_BIT_WIDTH 14 216 #define OMAP3ISP_HIST_MIN_BIT_WIDTH 8 217 #define OMAP3ISP_HIST_MAX_WG 4 218 #define OMAP3ISP_HIST_MAX_BUF_SIZE 4096 219 220 /* Source */ 221 #define OMAP3ISP_HIST_SOURCE_CCDC 0 222 #define OMAP3ISP_HIST_SOURCE_MEM 1 223 224 /* CFA pattern */ 225 #define OMAP3ISP_HIST_CFA_BAYER 0 226 #define OMAP3ISP_HIST_CFA_FOVEONX3 1 227 228 struct omap3isp_hist_region { 229 uint16_t h_start; 230 uint16_t h_end; 231 uint16_t v_start; 232 uint16_t v_end; 233 }; 234 235 struct omap3isp_hist_config { 236 /* 237 * Common fields. 238 * They should be the first ones and must be in the same order as in 239 * ispstat_generic_config struct. 240 */ 241 uint32_t buf_size; 242 uint16_t config_counter; 243 244 uint8_t num_acc_frames; /* Num of image frames to be processed and 245 accumulated for each histogram frame */ 246 uint16_t hist_bins; /* number of bins: 32, 64, 128, or 256 */ 247 uint8_t cfa; /* BAYER or FOVEON X3 */ 248 uint8_t wg[OMAP3ISP_HIST_MAX_WG]; /* White Balance Gain */ 249 uint8_t num_regions; /* number of regions to be configured */ 250 struct omap3isp_hist_region region[OMAP3ISP_HIST_MAX_REGIONS]; 251 }; 252 253 /* Auto Focus related structs */ 254 255 #define OMAP3ISP_AF_NUM_COEF 11 256 257 enum omap3isp_h3a_af_fvmode { 258 OMAP3ISP_AF_MODE_SUMMED = 0, 259 OMAP3ISP_AF_MODE_PEAK = 1 260 }; 261 262 /* Red, Green, and blue pixel location in the AF windows */ 263 enum omap3isp_h3a_af_rgbpos { 264 OMAP3ISP_AF_GR_GB_BAYER = 0, /* GR and GB as Bayer pattern */ 265 OMAP3ISP_AF_RG_GB_BAYER = 1, /* RG and GB as Bayer pattern */ 266 OMAP3ISP_AF_GR_BG_BAYER = 2, /* GR and BG as Bayer pattern */ 267 OMAP3ISP_AF_RG_BG_BAYER = 3, /* RG and BG as Bayer pattern */ 268 OMAP3ISP_AF_GG_RB_CUSTOM = 4, /* GG and RB as custom pattern */ 269 OMAP3ISP_AF_RB_GG_CUSTOM = 5 /* RB and GG as custom pattern */ 270 }; 271 272 /* Contains the information regarding the Horizontal Median Filter */ 273 struct omap3isp_h3a_af_hmf { 274 uint8_t enable; /* Status of Horizontal Median Filter */ 275 uint8_t threshold; /* Threshold Value for Horizontal Median Filter */ 276 }; 277 278 /* Contains the information regarding the IIR Filters */ 279 struct omap3isp_h3a_af_iir { 280 uint16_t h_start; /* IIR horizontal start */ 281 uint16_t coeff_set0[OMAP3ISP_AF_NUM_COEF]; /* Filter coefficient, set 0 */ 282 uint16_t coeff_set1[OMAP3ISP_AF_NUM_COEF]; /* Filter coefficient, set 1 */ 283 }; 284 285 /* Contains the information regarding the Paxels Structure in AF Engine */ 286 struct omap3isp_h3a_af_paxel { 287 uint16_t h_start; /* Horizontal Start Position */ 288 uint16_t v_start; /* Vertical Start Position */ 289 uint8_t width; /* Width of the Paxel */ 290 uint8_t height; /* Height of the Paxel */ 291 uint8_t h_cnt; /* Horizontal Count */ 292 uint8_t v_cnt; /* vertical Count */ 293 uint8_t line_inc; /* Line Increment */ 294 }; 295 296 /* Contains the parameters required for hardware set up of AF Engine */ 297 struct omap3isp_h3a_af_config { 298 /* 299 * Common fields. 300 * They should be the first ones and must be in the same order as in 301 * ispstat_generic_config struct. 302 */ 303 uint32_t buf_size; 304 uint16_t config_counter; 305 306 struct omap3isp_h3a_af_hmf hmf; /* HMF configurations */ 307 struct omap3isp_h3a_af_iir iir; /* IIR filter configurations */ 308 struct omap3isp_h3a_af_paxel paxel; /* Paxel parameters */ 309 enum omap3isp_h3a_af_rgbpos rgb_pos; /* RGB Positions */ 310 enum omap3isp_h3a_af_fvmode fvmode; /* Accumulator mode */ 311 uint8_t alaw_enable; /* AF ALAW status */ 312 }; 313 314 /* ISP CCDC structs */ 315 316 /* Abstraction layer CCDC configurations */ 317 #define OMAP3ISP_CCDC_ALAW (1 << 0) 318 #define OMAP3ISP_CCDC_LPF (1 << 1) 319 #define OMAP3ISP_CCDC_BLCLAMP (1 << 2) 320 #define OMAP3ISP_CCDC_BCOMP (1 << 3) 321 #define OMAP3ISP_CCDC_FPC (1 << 4) 322 #define OMAP3ISP_CCDC_CULL (1 << 5) 323 #define OMAP3ISP_CCDC_CONFIG_LSC (1 << 7) 324 #define OMAP3ISP_CCDC_TBL_LSC (1 << 8) 325 326 #define OMAP3ISP_RGB_MAX 3 327 328 /* Enumeration constants for Alaw input width */ 329 enum omap3isp_alaw_ipwidth { 330 OMAP3ISP_ALAW_BIT12_3 = 0x3, 331 OMAP3ISP_ALAW_BIT11_2 = 0x4, 332 OMAP3ISP_ALAW_BIT10_1 = 0x5, 333 OMAP3ISP_ALAW_BIT9_0 = 0x6 334 }; 335 336 /** 337 * struct omap3isp_ccdc_lsc_config - LSC configuration 338 * @offset: Table Offset of the gain table. 339 * @gain_mode_n: Vertical dimension of a paxel in LSC configuration. 340 * @gain_mode_m: Horizontal dimension of a paxel in LSC configuration. 341 * @gain_format: Gain table format. 342 * @fmtsph: Start pixel horizontal from start of the HS sync pulse. 343 * @fmtlnh: Number of pixels in horizontal direction to use for the data 344 * reformatter. 345 * @fmtslv: Start line from start of VS sync pulse for the data reformatter. 346 * @fmtlnv: Number of lines in vertical direction for the data reformatter. 347 * @initial_x: X position, in pixels, of the first active pixel in reference 348 * to the first active paxel. Must be an even number. 349 * @initial_y: Y position, in pixels, of the first active pixel in reference 350 * to the first active paxel. Must be an even number. 351 * @size: Size of LSC gain table. Filled when loaded from userspace. 352 */ 353 struct omap3isp_ccdc_lsc_config { 354 uint16_t offset; 355 uint8_t gain_mode_n; 356 uint8_t gain_mode_m; 357 uint8_t gain_format; 358 uint16_t fmtsph; 359 uint16_t fmtlnh; 360 uint16_t fmtslv; 361 uint16_t fmtlnv; 362 uint8_t initial_x; 363 uint8_t initial_y; 364 uint32_t size; 365 }; 366 367 /** 368 * struct omap3isp_ccdc_bclamp - Optical & Digital black clamp subtract 369 * @obgain: Optical black average gain. 370 * @obstpixel: Start Pixel w.r.t. HS pulse in Optical black sample. 371 * @oblines: Optical Black Sample lines. 372 * @oblen: Optical Black Sample Length. 373 * @dcsubval: Digital Black Clamp subtract value. 374 */ 375 struct omap3isp_ccdc_bclamp { 376 uint8_t obgain; 377 uint8_t obstpixel; 378 uint8_t oblines; 379 uint8_t oblen; 380 uint16_t dcsubval; 381 }; 382 383 /** 384 * struct omap3isp_ccdc_fpc - Faulty Pixels Correction 385 * @fpnum: Number of faulty pixels to be corrected in the frame. 386 * @fpcaddr: Memory address of the FPC Table 387 */ 388 struct omap3isp_ccdc_fpc { 389 uint16_t fpnum; 390 uint32_t fpcaddr; 391 }; 392 393 /** 394 * struct omap3isp_ccdc_blcomp - Black Level Compensation parameters 395 * @b_mg: B/Mg pixels. 2's complement. -128 to +127. 396 * @gb_g: Gb/G pixels. 2's complement. -128 to +127. 397 * @gr_cy: Gr/Cy pixels. 2's complement. -128 to +127. 398 * @r_ye: R/Ye pixels. 2's complement. -128 to +127. 399 */ 400 struct omap3isp_ccdc_blcomp { 401 uint8_t b_mg; 402 uint8_t gb_g; 403 uint8_t gr_cy; 404 uint8_t r_ye; 405 }; 406 407 /** 408 * omap3isp_ccdc_culling - Culling parameters 409 * @v_pattern: Vertical culling pattern. 410 * @h_odd: Horizontal Culling pattern for odd lines. 411 * @h_even: Horizontal Culling pattern for even lines. 412 */ 413 struct omap3isp_ccdc_culling { 414 uint8_t v_pattern; 415 uint16_t h_odd; 416 uint16_t h_even; 417 }; 418 419 /** 420 * omap3isp_ccdc_update_config - CCDC configuration 421 * @update: Specifies which CCDC registers should be updated. 422 * @flag: Specifies which CCDC functions should be enabled. 423 * @alawip: Enable/Disable A-Law compression. 424 * @bclamp: Black clamp control register. 425 * @blcomp: Black level compensation value for RGrGbB Pixels. 2's complement. 426 * @fpc: Number of faulty pixels corrected in the frame, address of FPC table. 427 * @cull: Cull control register. 428 * @lsc: Pointer to LSC gain table. 429 */ 430 struct omap3isp_ccdc_update_config { 431 uint16_t update; 432 uint16_t flag; 433 enum omap3isp_alaw_ipwidth alawip; 434 struct omap3isp_ccdc_bclamp *bclamp; 435 struct omap3isp_ccdc_blcomp *blcomp; 436 struct omap3isp_ccdc_fpc *fpc; 437 struct omap3isp_ccdc_lsc_config *lsc_cfg; 438 struct omap3isp_ccdc_culling *cull; 439 uint8_t *lsc; 440 }; 441 442 /* Preview configurations */ 443 #define OMAP3ISP_PREV_LUMAENH (1 << 0) 444 #define OMAP3ISP_PREV_INVALAW (1 << 1) 445 #define OMAP3ISP_PREV_HRZ_MED (1 << 2) 446 #define OMAP3ISP_PREV_CFA (1 << 3) 447 #define OMAP3ISP_PREV_CHROMA_SUPP (1 << 4) 448 #define OMAP3ISP_PREV_WB (1 << 5) 449 #define OMAP3ISP_PREV_BLKADJ (1 << 6) 450 #define OMAP3ISP_PREV_RGB2RGB (1 << 7) 451 #define OMAP3ISP_PREV_COLOR_CONV (1 << 8) 452 #define OMAP3ISP_PREV_YC_LIMIT (1 << 9) 453 #define OMAP3ISP_PREV_DEFECT_COR (1 << 10) 454 /* Bit 11 was OMAP3ISP_PREV_GAMMABYPASS, now merged with OMAP3ISP_PREV_GAMMA */ 455 #define OMAP3ISP_PREV_DRK_FRM_CAPTURE (1 << 12) 456 #define OMAP3ISP_PREV_DRK_FRM_SUBTRACT (1 << 13) 457 #define OMAP3ISP_PREV_LENS_SHADING (1 << 14) 458 #define OMAP3ISP_PREV_NF (1 << 15) 459 #define OMAP3ISP_PREV_GAMMA (1 << 16) 460 461 #define OMAP3ISP_PREV_NF_TBL_SIZE 64 462 #define OMAP3ISP_PREV_CFA_TBL_SIZE 576 463 #define OMAP3ISP_PREV_CFA_BLK_SIZE (OMAP3ISP_PREV_CFA_TBL_SIZE / 4) 464 #define OMAP3ISP_PREV_GAMMA_TBL_SIZE 1024 465 #define OMAP3ISP_PREV_YENH_TBL_SIZE 128 466 467 #define OMAP3ISP_PREV_DETECT_CORRECT_CHANNELS 4 468 469 /** 470 * struct omap3isp_prev_hmed - Horizontal Median Filter 471 * @odddist: Distance between consecutive pixels of same color in the odd line. 472 * @evendist: Distance between consecutive pixels of same color in the even 473 * line. 474 * @thres: Horizontal median filter threshold. 475 */ 476 struct omap3isp_prev_hmed { 477 uint8_t odddist; 478 uint8_t evendist; 479 uint8_t thres; 480 }; 481 482 /* 483 * Enumeration for CFA Formats supported by preview 484 */ 485 enum omap3isp_cfa_fmt { 486 OMAP3ISP_CFAFMT_BAYER, 487 OMAP3ISP_CFAFMT_SONYVGA, 488 OMAP3ISP_CFAFMT_RGBFOVEON, 489 OMAP3ISP_CFAFMT_DNSPL, 490 OMAP3ISP_CFAFMT_HONEYCOMB, 491 OMAP3ISP_CFAFMT_RRGGBBFOVEON 492 }; 493 494 /** 495 * struct omap3isp_prev_cfa - CFA Interpolation 496 * @format: CFA Format Enum value supported by preview. 497 * @gradthrs_vert: CFA Gradient Threshold - Vertical. 498 * @gradthrs_horz: CFA Gradient Threshold - Horizontal. 499 * @table: Pointer to the CFA table. 500 */ 501 struct omap3isp_prev_cfa { 502 enum omap3isp_cfa_fmt format; 503 uint8_t gradthrs_vert; 504 uint8_t gradthrs_horz; 505 uint32_t table[4][OMAP3ISP_PREV_CFA_BLK_SIZE]; 506 }; 507 508 /** 509 * struct omap3isp_prev_csup - Chrominance Suppression 510 * @gain: Gain. 511 * @thres: Threshold. 512 * @hypf_en: Flag to enable/disable the High Pass Filter. 513 */ 514 struct omap3isp_prev_csup { 515 uint8_t gain; 516 uint8_t thres; 517 uint8_t hypf_en; 518 }; 519 520 /** 521 * struct omap3isp_prev_wbal - White Balance 522 * @dgain: Digital gain (U10Q8). 523 * @coef3: White balance gain - COEF 3 (U8Q5). 524 * @coef2: White balance gain - COEF 2 (U8Q5). 525 * @coef1: White balance gain - COEF 1 (U8Q5). 526 * @coef0: White balance gain - COEF 0 (U8Q5). 527 */ 528 struct omap3isp_prev_wbal { 529 uint16_t dgain; 530 uint8_t coef3; 531 uint8_t coef2; 532 uint8_t coef1; 533 uint8_t coef0; 534 }; 535 536 /** 537 * struct omap3isp_prev_blkadj - Black Level Adjustment 538 * @red: Black level offset adjustment for Red in 2's complement format 539 * @green: Black level offset adjustment for Green in 2's complement format 540 * @blue: Black level offset adjustment for Blue in 2's complement format 541 */ 542 struct omap3isp_prev_blkadj { 543 /*Black level offset adjustment for Red in 2's complement format */ 544 uint8_t red; 545 /*Black level offset adjustment for Green in 2's complement format */ 546 uint8_t green; 547 /* Black level offset adjustment for Blue in 2's complement format */ 548 uint8_t blue; 549 }; 550 551 /** 552 * struct omap3isp_prev_rgbtorgb - RGB to RGB Blending 553 * @matrix: Blending values(S12Q8 format) 554 * [RR] [GR] [BR] 555 * [RG] [GG] [BG] 556 * [RB] [GB] [BB] 557 * @offset: Blending offset value for R,G,B in 2's complement integer format. 558 */ 559 struct omap3isp_prev_rgbtorgb { 560 uint16_t matrix[OMAP3ISP_RGB_MAX][OMAP3ISP_RGB_MAX]; 561 uint16_t offset[OMAP3ISP_RGB_MAX]; 562 }; 563 564 /** 565 * struct omap3isp_prev_csc - Color Space Conversion from RGB-YCbYCr 566 * @matrix: Color space conversion coefficients(S10Q8) 567 * [CSCRY] [CSCGY] [CSCBY] 568 * [CSCRCB] [CSCGCB] [CSCBCB] 569 * [CSCRCR] [CSCGCR] [CSCBCR] 570 * @offset: CSC offset values for Y offset, CB offset and CR offset respectively 571 */ 572 struct omap3isp_prev_csc { 573 uint16_t matrix[OMAP3ISP_RGB_MAX][OMAP3ISP_RGB_MAX]; 574 int16_t offset[OMAP3ISP_RGB_MAX]; 575 }; 576 577 /** 578 * struct omap3isp_prev_yclimit - Y, C Value Limit 579 * @minC: Minimum C value 580 * @maxC: Maximum C value 581 * @minY: Minimum Y value 582 * @maxY: Maximum Y value 583 */ 584 struct omap3isp_prev_yclimit { 585 uint8_t minC; 586 uint8_t maxC; 587 uint8_t minY; 588 uint8_t maxY; 589 }; 590 591 /** 592 * struct omap3isp_prev_dcor - Defect correction 593 * @couplet_mode_en: Flag to enable or disable the couplet dc Correction in NF 594 * @detect_correct: Thresholds for correction bit 0:10 detect 16:25 correct 595 */ 596 struct omap3isp_prev_dcor { 597 uint8_t couplet_mode_en; 598 uint32_t detect_correct[OMAP3ISP_PREV_DETECT_CORRECT_CHANNELS]; 599 }; 600 601 /** 602 * struct omap3isp_prev_nf - Noise Filter 603 * @spread: Spread value to be used in Noise Filter 604 * @table: Pointer to the Noise Filter table 605 */ 606 struct omap3isp_prev_nf { 607 uint8_t spread; 608 uint32_t table[OMAP3ISP_PREV_NF_TBL_SIZE]; 609 }; 610 611 /** 612 * struct omap3isp_prev_gtables - Gamma correction tables 613 * @red: Array for red gamma table. 614 * @green: Array for green gamma table. 615 * @blue: Array for blue gamma table. 616 */ 617 struct omap3isp_prev_gtables { 618 uint32_t red[OMAP3ISP_PREV_GAMMA_TBL_SIZE]; 619 uint32_t green[OMAP3ISP_PREV_GAMMA_TBL_SIZE]; 620 uint32_t blue[OMAP3ISP_PREV_GAMMA_TBL_SIZE]; 621 }; 622 623 /** 624 * struct omap3isp_prev_luma - Luma enhancement 625 * @table: Array for luma enhancement table. 626 */ 627 struct omap3isp_prev_luma { 628 uint32_t table[OMAP3ISP_PREV_YENH_TBL_SIZE]; 629 }; 630 631 /** 632 * struct omap3isp_prev_update_config - Preview engine configuration (user) 633 * @update: Specifies which ISP Preview registers should be updated. 634 * @flag: Specifies which ISP Preview functions should be enabled. 635 * @shading_shift: 3bit value of shift used in shading compensation. 636 * @luma: Pointer to luma enhancement structure. 637 * @hmed: Pointer to structure containing the odd and even distance. 638 * between the pixels in the image along with the filter threshold. 639 * @cfa: Pointer to structure containing the CFA interpolation table, CFA. 640 * format in the image, vertical and horizontal gradient threshold. 641 * @csup: Pointer to Structure for Chrominance Suppression coefficients. 642 * @wbal: Pointer to structure for White Balance. 643 * @blkadj: Pointer to structure for Black Adjustment. 644 * @rgb2rgb: Pointer to structure for RGB to RGB Blending. 645 * @csc: Pointer to structure for Color Space Conversion from RGB-YCbYCr. 646 * @yclimit: Pointer to structure for Y, C Value Limit. 647 * @dcor: Pointer to structure for defect correction. 648 * @nf: Pointer to structure for Noise Filter 649 * @gamma: Pointer to gamma structure. 650 */ 651 struct omap3isp_prev_update_config { 652 uint32_t update; 653 uint32_t flag; 654 uint32_t shading_shift; 655 struct omap3isp_prev_luma *luma; 656 struct omap3isp_prev_hmed *hmed; 657 struct omap3isp_prev_cfa *cfa; 658 struct omap3isp_prev_csup *csup; 659 struct omap3isp_prev_wbal *wbal; 660 struct omap3isp_prev_blkadj *blkadj; 661 struct omap3isp_prev_rgbtorgb *rgb2rgb; 662 struct omap3isp_prev_csc *csc; 663 struct omap3isp_prev_yclimit *yclimit; 664 struct omap3isp_prev_dcor *dcor; 665 struct omap3isp_prev_nf *nf; 666 struct omap3isp_prev_gtables *gamma; 667 }; 668 669 #endif /* OMAP3_ISP_USER_H */ 670