drivers/staging/media/atomisp/pci/atomisp2/css2400/ia_css_types.h

   1 /* Release Version: irci_stable_candrpv_0415_20150521_0458 */
   2 /*
   3  * Support for Intel Camera Imaging ISP subsystem.
   4  * Copyright (c) 2015, Intel Corporation.
   5  *
   6  * This program is free software; you can redistribute it and/or modify it
   7  * under the terms and conditions of the GNU General Public License,
   8  * version 2, as published by the Free Software Foundation.
   9  *
  10  * This program is distributed in the hope it will be useful, but WITHOUT
  11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  13  * more details.
  14  */
  15
  16 #ifndef _IA_CSS_TYPES_H
  17 #define _IA_CSS_TYPES_H
  18
  19 /* @file
  20  * This file contains types used for the ia_css parameters.
  21  * These types are in a separate file because they are expected
  22  * to be used in software layers that do not access the CSS API
  23  * directly but still need to forward parameters for it.
  24  */
  25
  26 #include <type_support.h>
  27
  28 #include "ia_css_frac.h"
  29
  30 #include "isp/kernels/aa/aa_2/ia_css_aa2_types.h"
  31 #include "isp/kernels/anr/anr_1.0/ia_css_anr_types.h"
  32 #include "isp/kernels/anr/anr_2/ia_css_anr2_types.h"
  33 #include "isp/kernels/cnr/cnr_2/ia_css_cnr2_types.h"
  34 #include "isp/kernels/csc/csc_1.0/ia_css_csc_types.h"
  35 #include "isp/kernels/ctc/ctc_1.0/ia_css_ctc_types.h"
  36 #include "isp/kernels/dp/dp_1.0/ia_css_dp_types.h"
  37 #include "isp/kernels/de/de_1.0/ia_css_de_types.h"
  38 #include "isp/kernels/de/de_2/ia_css_de2_types.h"
  39 #include "isp/kernels/fc/fc_1.0/ia_css_formats_types.h"
  40 #include "isp/kernels/fpn/fpn_1.0/ia_css_fpn_types.h"
  41 #include "isp/kernels/gc/gc_1.0/ia_css_gc_types.h"
  42 #include "isp/kernels/gc/gc_2/ia_css_gc2_types.h"
  43 #include "isp/kernels/macc/macc_1.0/ia_css_macc_types.h"
  44 #include "isp/kernels/ob/ob_1.0/ia_css_ob_types.h"
  45 #include "isp/kernels/s3a/s3a_1.0/ia_css_s3a_types.h"
  46 #include "isp/kernels/sc/sc_1.0/ia_css_sc_types.h"
  47 #include "isp/kernels/sdis/sdis_1.0/ia_css_sdis_types.h"
  48 #include "isp/kernels/sdis/sdis_2/ia_css_sdis2_types.h"
  49 #include "isp/kernels/tnr/tnr_1.0/ia_css_tnr_types.h"
  50 #include "isp/kernels/wb/wb_1.0/ia_css_wb_types.h"
  51 #include "isp/kernels/xnr/xnr_1.0/ia_css_xnr_types.h"
  52 #include "isp/kernels/xnr/xnr_3.0/ia_css_xnr3_types.h"
  53 #ifdef ISP2401
  54 #include "isp/kernels/tnr/tnr3/ia_css_tnr3_types.h"
  55 #endif
  56 #include "isp/kernels/ynr/ynr_1.0/ia_css_ynr_types.h"
  57 #include "isp/kernels/ynr/ynr_2/ia_css_ynr2_types.h"
  58 #include "isp/kernels/output/output_1.0/ia_css_output_types.h"
  59
  60 #define IA_CSS_DVS_STAT_GRID_INFO_SUPPORTED
  61 /** Should be removed after Driver adaptation will be done */
  62
  63 #define IA_CSS_VERSION_MAJOR    2
  64 #define IA_CSS_VERSION_MINOR    0
  65 #define IA_CSS_VERSION_REVISION 2
  66
  67 #define IA_CSS_MORPH_TABLE_NUM_PLANES  6
  68
  69 /* Min and max exposure IDs. These macros are here to allow
  70  * the drivers to get this information. Changing these macros
  71  * constitutes a CSS API change. */
  72 #define IA_CSS_ISYS_MIN_EXPOSURE_ID 1   /** Minimum exposure ID */
  73 #define IA_CSS_ISYS_MAX_EXPOSURE_ID 250 /** Maximum exposure ID */
  74
  75 /* opaque types */
  76 struct ia_css_isp_parameters;
  77 struct ia_css_pipe;
  78 struct ia_css_memory_offsets;
  79 struct ia_css_config_memory_offsets;
  80 struct ia_css_state_memory_offsets;
  81
  82 /* Virtual address within the CSS address space. */
  83 typedef uint32_t ia_css_ptr;
  84
  85 /* Generic resolution structure.
  86  */
  87 struct ia_css_resolution {
  88         uint32_t width;  /** Width */
  89         uint32_t height; /** Height */
  90 };
  91
  92 /* Generic coordinate structure.
  93  */
  94 struct ia_css_coordinate {
  95         int32_t x;      /** Value of a coordinate on the horizontal axis */
  96         int32_t y;      /** Value of a coordinate on the vertical axis */
  97 };
  98
  99 /* Vector with signed values. This is used to indicate motion for
 100  * Digital Image Stabilization.
 101  */
 102 struct ia_css_vector {
 103         int32_t x; /** horizontal motion (in pixels) */
 104         int32_t y; /** vertical motion (in pixels) */
 105 };
 106
 107 /* Short hands */
 108 #define IA_CSS_ISP_DMEM IA_CSS_ISP_DMEM0
 109 #define IA_CSS_ISP_VMEM IA_CSS_ISP_VMEM0
 110
 111 /* CSS data descriptor */
 112 struct ia_css_data {
 113         ia_css_ptr address; /** CSS virtual address */
 114         uint32_t   size;    /** Disabled if 0 */
 115 };
 116
 117 /* Host data descriptor */
 118 struct ia_css_host_data {
 119         char      *address; /** Host address */
 120         uint32_t   size;    /** Disabled if 0 */
 121 };
 122
 123 /* ISP data descriptor */
 124 struct ia_css_isp_data {
 125         uint32_t   address; /** ISP address */
 126         uint32_t   size;    /** Disabled if 0 */
 127 };
 128
 129 /* Shading Correction types. */
 130 enum ia_css_shading_correction_type {
 131 #ifndef ISP2401
 132         IA_CSS_SHADING_CORRECTION_TYPE_1 /** Shading Correction 1.0 (pipe 1.0 on ISP2300, pipe 2.2 on ISP2400) */
 133 #else
 134         IA_CSS_SHADING_CORRECTION_NONE,  /** Shading Correction is not processed in the pipe. */
 135         IA_CSS_SHADING_CORRECTION_TYPE_1 /** Shading Correction 1.0 (pipe 1.0 on ISP2300, pipe 2.2 on ISP2400/2401) */
 136 #endif
 137
 138         /** More shading correction types can be added in the future. */
 139 };
 140
 141 /* Shading Correction information. */
 142 struct ia_css_shading_info {
 143         enum ia_css_shading_correction_type type; /** Shading Correction type. */
 144
 145         union { /* Shading Correction information of each Shading Correction types. */
 146
 147                 /* Shading Correction information of IA_CSS_SHADING_CORRECTION_TYPE_1.
 148                  *
 149                  *  This structure contains the information necessary to generate
 150                  *  the shading table required in the isp.
 151                  *  This structure is filled in the css,
 152                  *  and the driver needs to get it to generate the shading table.
 153                  *
 154                  *  Before the shading correction is applied, NxN-filter and/or scaling
 155                  *  are applied in the isp, depending on the isp binaries.
 156                  *  Then, these should be considered in generating the shading table.
 157                  *    - Bad pixels on left/top sides generated by NxN-filter
 158                  *      (Bad pixels are NOT considered currently,
 159                  *      because they are subtle.)
 160                  *    - Down-scaling/Up-scaling factor
 161                  *
 162                  *  Shading correction is applied to the area
 163                  *  which has real sensor data and margin.
 164                  *  Then, the shading table should cover the area including margin.
 165                  *  This structure has this information.
 166                  *    - Origin coordinate of bayer (real sensor data)
 167                  *      on the shading table
 168                  *
 169                  * ------------------------ISP 2401-----------------------
 170                  *
 171                  *  the shading table directly required from ISP.
 172                  *  This structure is filled in CSS, and the driver needs to get it to generate the shading table.
 173                  *
 174                  *  The shading correction is applied to the bayer area which contains sensor data and padding data.
 175                  *  The shading table should cover this bayer area.
 176                  *
 177                  *  The shading table size directly required from ISP is expressed by these parameters.
 178                  *    1. uint32_t num_hor_grids;
 179                  *    2. uint32_t num_ver_grids;
 180                  *    3. uint32_t bqs_per_grid_cell;
 181                  *
 182                  *  In some isp binaries, the bayer scaling is applied before the shading correction is applied.
 183                  *  Then, this scaling factor should be considered in generating the shading table.
 184                  *  The scaling factor is expressed by these parameters.
 185                  *    4. uint32_t bayer_scale_hor_ratio_in;
 186                  *    5. uint32_t bayer_scale_hor_ratio_out;
 187                  *    6. uint32_t bayer_scale_ver_ratio_in;
 188                  *    7. uint32_t bayer_scale_ver_ratio_out;
 189                  *
 190                  *  The sensor data size inputted to ISP is expressed by this parameter.
 191                  *  This is the size BEFORE the bayer scaling is applied.
 192                  *    8. struct ia_css_resolution isp_input_sensor_data_res_bqs;
 193                  *
 194                  *  The origin of the sensor data area positioned on the shading table at the shading correction
 195                  *  is expressed by this parameter.
 196                  *  The size of this area assumes the size AFTER the bayer scaling is applied
 197                  *  to the isp_input_sensor_data_resolution_bqs.
 198                  *    9. struct ia_css_coordinate sensor_data_origin_bqs_on_sctbl;
 199                  *
 200                  *  ****** Definitions of the shading table and the sensor data at the shading correction ******
 201                  *
 202                  * (0,0)--------------------- TW -------------------------------
 203                  *   |                                            shading table |
 204                  *   |      (ox,oy)---------- W --------------------------      |
 205                  *   |        |                               sensor data |     |
 206                  *   |        |                                           |     |
 207                  *  TH        H             sensor data center            |     |
 208                  *   |        |                  (cx,cy)                  |     |
 209                  *   |        |                                           |     |
 210                  *   |        |                                           |     |
 211                  *   |        |                                           |     |
 212                  *   |         -------------------------------------------      |
 213                  *   |                                                          |
 214                  *    ----------------------------------------------------------
 215                  *
 216                  *    Example of still mode for output 1080p:
 217                  *
 218                  *    num_hor_grids = 66
 219                  *    num_ver_grids = 37
 220                  *    bqs_per_grid_cell = 16
 221                  *    bayer_scale_hor_ratio_in = 1
 222                  *    bayer_scale_hor_ratio_out = 1
 223                  *    bayer_scale_ver_ratio_in = 1
 224                  *    bayer_scale_ver_ratio_out = 1
 225                  *    isp_input_sensor_data_resolution_bqs = {966, 546}
 226                  *    sensor_data_origin_bqs_on_sctbl = {61, 15}
 227                  *
 228                  *    TW, TH [bqs]: width and height of shading table
 229                  *        TW = (num_hor_grids - 1) * bqs_per_grid_cell = (66 - 1) * 16 = 1040
 230                  *        TH = (num_ver_grids - 1) * bqs_per_grid_cell = (37 - 1) * 16 = 576
 231                  *
 232                  *    W, H [bqs]: width and height of sensor data at shading correction
 233                  *        W = sensor_data_res_bqs.width
 234                  *          = isp_input_sensor_data_res_bqs.width
 235                  *              * bayer_scale_hor_ratio_out / bayer_scale_hor_ratio_in + 0.5 = 966
 236                  *        H = sensor_data_res_bqs.height
 237                  *          = isp_input_sensor_data_res_bqs.height
 238                  *               * bayer_scale_ver_ratio_out / bayer_scale_ver_ratio_in + 0.5 = 546
 239                  *
 240                  *    (ox, oy) [bqs]: origin of sensor data positioned on shading table at shading correction
 241                  *        ox = sensor_data_origin_bqs_on_sctbl.x = 61
 242                  *        oy = sensor_data_origin_bqs_on_sctbl.y = 15
 243                  *
 244                  *    (cx, cy) [bqs]: center of sensor data positioned on shading table at shading correction
 245                  *        cx = ox + W/2 = 61 + 966/2 = 544
 246                  *        cy = oy + H/2 = 15 + 546/2 = 288
 247                  *
 248                  *  ****** Relation between the shading table and the sensor data ******
 249                  *
 250                  *    The origin of the sensor data should be on the shading table.
 251                  *        0 <= ox < TW,  0 <= oy < TH
 252                  *
 253                  *  ****** How to center the shading table on the sensor data ******
 254                  *
 255                  *    To center the shading table on the sensor data,
 256                  *    CSS decides the shading table size so that a certain grid point is positioned
 257                  *    on the center of the sensor data at the shading correction.
 258                  *    CSS expects the shading center is set on this grid point
 259                  *    when the shading table data is calculated in AIC.
 260                  *
 261                  *    W, H [bqs]: width and height of sensor data at shading correction
 262                  *      W = sensor_data_res_bqs.width
 263                  *      H = sensor_data_res_bqs.height
 264                  *
 265                  *    (cx, cy) [bqs]: center of sensor data positioned on shading table at shading correction
 266                  *      cx = sensor_data_origin_bqs_on_sctbl.x + W/2
 267                  *      cy = sensor_data_origin_bqs_on_sctbl.y + H/2
 268                  *
 269                  *    CSS decides the shading table size and the sensor data position
 270                  *    so that the (cx, cy) satisfies this condition.
 271                  *      mod(cx, bqs_per_grid_cell) = 0
 272                  *      mod(cy, bqs_per_grid_cell) = 0
 273                  *
 274                  *  ****** How to change the sensor data size by processes in the driver and ISP ******
 275                  *
 276                  *    1. sensor data size: Physical sensor size
 277                  *                         (The struct ia_css_shading_info does not have this information.)
 278                  *    2. process:          Driver applies the sensor cropping/binning/scaling to physical sensor size.
 279                  *    3. sensor data size: ISP input size (== shading_info.isp_input_sensor_data_res_bqs)
 280                  *                         (ISP assumes the ISP input sensor data is centered on the physical sensor.)
 281                  *    4. process:          ISP applies the bayer scaling by the factor of shading_info.bayer_scale_*.
 282                  *    5. sensor data size: Scaling factor * ISP input size (== shading_info.sensor_data_res_bqs)
 283                  *    6. process:          ISP applies the shading correction.
 284                  *
 285                  *  ISP block: SC1
 286                  *  ISP1: SC1 is used.
 287                  *  ISP2: SC1 is used.
 288                  */
 289                 struct {
 290 #ifndef ISP2401
 291                         uint32_t enable;        /** Shading correction enabled.
 292                                                      0:disabled, 1:enabled */
 293                         uint32_t num_hor_grids; /** Number of data points per line
 294                                                      per color on shading table. */
 295                         uint32_t num_ver_grids; /** Number of lines of data points
 296                                                      per color on shading table. */
 297                         uint32_t bqs_per_grid_cell; /** Grid cell size
 298                                                 in BQ(Bayer Quad) unit.
 299                                                 (1BQ means {Gr,R,B,Gb}(2x2 pixels).)
 300                                                 Valid values are 8,16,32,64. */
 301 #else
 302                         uint32_t num_hor_grids; /** Number of data points per line per color on shading table. */
 303                         uint32_t num_ver_grids; /** Number of lines of data points per color on shading table. */
 304                         uint32_t bqs_per_grid_cell; /** Grid cell size in BQ unit.
 305                                                          NOTE: bqs = size in BQ(Bayer Quad) unit.
 306                                                                1BQ means {Gr,R,B,Gb} (2x2 pixels).
 307                                                                Horizontal 1 bqs corresponds to horizontal 2 pixels.
 308                                                                Vertical 1 bqs corresponds to vertical 2 pixels. */
 309 #endif
 310                         uint32_t bayer_scale_hor_ratio_in;
 311                         uint32_t bayer_scale_hor_ratio_out;
 312 #ifndef ISP2401
 313                         /** Horizontal ratio of bayer scaling
 314                         between input width and output width, for the scaling
 315                         which should be done before shading correction.
 316                           output_width = input_width * bayer_scale_hor_ratio_out
 317                                                 / bayer_scale_hor_ratio_in */
 318 #else
 319                                 /** Horizontal ratio of bayer scaling between input width and output width,
 320                                      for the scaling which should be done before shading correction.
 321                                         output_width = input_width * bayer_scale_hor_ratio_out
 322                                                                         / bayer_scale_hor_ratio_in + 0.5 */
 323 #endif
 324                         uint32_t bayer_scale_ver_ratio_in;
 325                         uint32_t bayer_scale_ver_ratio_out;
 326 #ifndef ISP2401
 327                         /** Vertical ratio of bayer scaling
 328                         between input height and output height, for the scaling
 329                         which should be done before shading correction.
 330                           output_height = input_height * bayer_scale_ver_ratio_out
 331                                                 / bayer_scale_ver_ratio_in */
 332                         uint32_t sc_bayer_origin_x_bqs_on_shading_table;
 333                         /** X coordinate (in bqs) of bayer origin on shading table.
 334                         This indicates the left-most pixel of bayer
 335                         (not include margin) inputted to the shading correction.
 336                         This corresponds to the left-most pixel of bayer
 337                         inputted to isp from sensor. */
 338                         uint32_t sc_bayer_origin_y_bqs_on_shading_table;
 339                         /** Y coordinate (in bqs) of bayer origin on shading table.
 340                         This indicates the top pixel of bayer
 341                         (not include margin) inputted to the shading correction.
 342                         This corresponds to the top pixel of bayer
 343                         inputted to isp from sensor. */
 344 #else
 345                                 /** Vertical ratio of bayer scaling between input height and output height,
 346                                      for the scaling which should be done before shading correction.
 347                                         output_height = input_height * bayer_scale_ver_ratio_out
 348                                                                         / bayer_scale_ver_ratio_in + 0.5 */
 349                         struct ia_css_resolution isp_input_sensor_data_res_bqs;
 350                                 /** Sensor data size (in bqs) inputted to ISP. This is the size BEFORE bayer scaling.
 351                                      NOTE: This is NOT the size of the physical sensor size.
 352                                            CSS requests the driver that ISP inputs sensor data
 353                                            by the size of isp_input_sensor_data_res_bqs.
 354                                            The driver sends the sensor data to ISP,
 355                                            after the adequate cropping/binning/scaling
 356                                            are applied to the physical sensor data area.
 357                                            ISP assumes the area of isp_input_sensor_data_res_bqs
 358                                            is centered on the physical sensor. */
 359                         struct ia_css_resolution sensor_data_res_bqs;
 360                                 /** Sensor data size (in bqs) at shading correction.
 361                                      This is the size AFTER bayer scaling. */
 362                         struct ia_css_coordinate sensor_data_origin_bqs_on_sctbl;
 363                                 /** Origin of sensor data area positioned on shading table at shading correction.
 364                                      The coordinate x,y should be positive values. */
 365 #endif
 366                 } type_1;
 367
 368                 /** More structures can be added here when more shading correction types will be added
 369                      in the future. */
 370         } info;
 371 };
 372
 373 #ifndef ISP2401
 374
 375 /* Default Shading Correction information of Shading Correction Type 1. */
 376 #define DEFAULT_SHADING_INFO_TYPE_1 \
 377 { \
 378         IA_CSS_SHADING_CORRECTION_TYPE_1,       /* type */ \
 379         {                                       /* info */ \
 380                 { \
 381                         0,      /* enable */ \
 382                         0,      /* num_hor_grids */ \
 383                         0,      /* num_ver_grids */ \
 384                         0,      /* bqs_per_grid_cell */ \
 385                         1,      /* bayer_scale_hor_ratio_in */ \
 386                         1,      /* bayer_scale_hor_ratio_out */ \
 387                         1,      /* bayer_scale_ver_ratio_in */ \
 388                         1,      /* bayer_scale_ver_ratio_out */ \
 389                         0,      /* sc_bayer_origin_x_bqs_on_shading_table */ \
 390                         0       /* sc_bayer_origin_y_bqs_on_shading_table */ \
 391                 } \
 392         } \
 393 }
 394
 395 #else
 396
 397 /* Default Shading Correction information of Shading Correction Type 1. */
 398 #define DEFAULT_SHADING_INFO_TYPE_1 \
 399 { \
 400         IA_CSS_SHADING_CORRECTION_TYPE_1,       /* type */ \
 401         {                                       /* info */ \
 402                 { \
 403                         0,                      /* num_hor_grids */ \
 404                         0,                      /* num_ver_grids */ \
 405                         0,                      /* bqs_per_grid_cell */ \
 406                         1,                      /* bayer_scale_hor_ratio_in */ \
 407                         1,                      /* bayer_scale_hor_ratio_out */ \
 408                         1,                      /* bayer_scale_ver_ratio_in */ \
 409                         1,                      /* bayer_scale_ver_ratio_out */ \
 410                         {0, 0},                 /* isp_input_sensor_data_res_bqs */ \
 411                         {0, 0},                 /* sensor_data_res_bqs */ \
 412                         {0, 0}                  /* sensor_data_origin_bqs_on_sctbl */ \
 413                 } \
 414         } \
 415 }
 416
 417 #endif
 418
 419 /* Default Shading Correction information. */
 420 #define DEFAULT_SHADING_INFO    DEFAULT_SHADING_INFO_TYPE_1
 421
 422 /* structure that describes the 3A and DIS grids */
 423 struct ia_css_grid_info {
 424         /* \name ISP input size
 425           * that is visible for user
 426           * @{
 427           */
 428         uint32_t isp_in_width;
 429         uint32_t isp_in_height;
 430         /* @}*/
 431
 432         struct ia_css_3a_grid_info  s3a_grid; /** 3A grid info */
 433         union ia_css_dvs_grid_u dvs_grid;
 434                 /** All types of DVS statistics grid info union */
 435
 436         enum ia_css_vamem_type vamem_type;
 437 };
 438
 439 /* defaults for ia_css_grid_info structs */
 440 #define DEFAULT_GRID_INFO \
 441 { \
 442         0,                              /* isp_in_width */ \
 443         0,                              /* isp_in_height */ \
 444         DEFAULT_3A_GRID_INFO,           /* s3a_grid */ \
 445         DEFAULT_DVS_GRID_INFO,          /* dvs_grid */ \
 446         IA_CSS_VAMEM_TYPE_1             /* vamem_type */ \
 447 }
 448
 449 /* Morphing table, used for geometric distortion and chromatic abberration
 450  *  correction (GDCAC, also called GDC).
 451  *  This table describes the imperfections introduced by the lens, the
 452  *  advanced ISP can correct for these imperfections using this table.
 453  */
 454 struct ia_css_morph_table {
 455         uint32_t enable; /** To disable GDC, set this field to false. The
 456                           coordinates fields can be set to NULL in this case. */
 457         uint32_t height; /** Table height */
 458         uint32_t width;  /** Table width */
 459         uint16_t *coordinates_x[IA_CSS_MORPH_TABLE_NUM_PLANES];
 460         /** X coordinates that describe the sensor imperfection */
 461         uint16_t *coordinates_y[IA_CSS_MORPH_TABLE_NUM_PLANES];
 462         /** Y coordinates that describe the sensor imperfection */
 463 };
 464
 465 struct ia_css_dvs_6axis_config {
 466         unsigned int exp_id;
 467         /** Exposure ID, see ia_css_event_public.h for more detail */
 468         uint32_t width_y;
 469         uint32_t height_y;
 470         uint32_t width_uv;
 471         uint32_t height_uv;
 472         uint32_t *xcoords_y;
 473         uint32_t *ycoords_y;
 474         uint32_t *xcoords_uv;
 475         uint32_t *ycoords_uv;
 476 };
 477
 478 /**
 479  * This specifies the coordinates (x,y)
 480  */
 481 struct ia_css_point {
 482         int32_t x; /** x coordinate */
 483         int32_t y; /** y coordinate */
 484 };
 485
 486 /**
 487  * This specifies the region
 488  */
 489 struct ia_css_region {
 490         struct ia_css_point origin; /** Starting point coordinates for the region */
 491         struct ia_css_resolution resolution; /** Region resolution */
 492 };
 493
 494 /**
 495  * Digital zoom:
 496  * This feature is currently available only for video, but will become
 497  * available for preview and capture as well.
 498  * Set the digital zoom factor, this is a logarithmic scale. The actual zoom
 499  * factor will be 64/x.
 500  * Setting dx or dy to 0 disables digital zoom for that direction.
 501  * New API change for Digital zoom:(added struct ia_css_region zoom_region)
 502  * zoom_region specifies the origin of the zoom region and width and
 503  * height of that region.
 504  * origin : This is the coordinate (x,y) within the effective input resolution
 505  * of the stream. where, x >= 0 and y >= 0. (0,0) maps to the upper left of the
 506  * effective input resolution.
 507  * resolution : This is resolution of zoom region.
 508  * where, x + width <= effective input width
 509  * y + height <= effective input height
 510  */
 511 struct ia_css_dz_config {
 512         uint32_t dx; /** Horizontal zoom factor */
 513         uint32_t dy; /** Vertical zoom factor */
 514         struct ia_css_region zoom_region; /** region for zoom */
 515 };
 516
 517 /* The still capture mode, this can be RAW (simply copy sensor input to DDR),
 518  *  Primary ISP, the Advanced ISP (GDC) or the low-light ISP (ANR).
 519  */
 520 enum ia_css_capture_mode {
 521         IA_CSS_CAPTURE_MODE_RAW,      /** no processing, copy data only */
 522         IA_CSS_CAPTURE_MODE_BAYER,    /** bayer processing, up to demosaic */
 523         IA_CSS_CAPTURE_MODE_PRIMARY,  /** primary ISP */
 524         IA_CSS_CAPTURE_MODE_ADVANCED, /** advanced ISP (GDC) */
 525         IA_CSS_CAPTURE_MODE_LOW_LIGHT /** low light ISP (ANR) */
 526 };
 527
 528 struct ia_css_capture_config {
 529         enum ia_css_capture_mode mode; /** Still capture mode */
 530         uint32_t enable_xnr;           /** Enable/disable XNR */
 531         uint32_t enable_raw_output;
 532         bool enable_capture_pp_bli;    /** Enable capture_pp_bli mode */
 533 };
 534
 535 /* default settings for ia_css_capture_config structs */
 536 #define DEFAULT_CAPTURE_CONFIG \
 537 { \
 538         IA_CSS_CAPTURE_MODE_PRIMARY,    /* mode (capture) */ \
 539         false,                          /* enable_xnr */ \
 540         false,                          /* enable_raw_output */ \
 541         false                           /* enable_capture_pp_bli */ \
 542 }
 543
 544
 545 /* ISP filter configuration. This is a collection of configurations
 546  *  for each of the ISP filters (modules).
 547  *
 548  *  NOTE! The contents of all pointers is copied when get or set with the
 549  *  exception of the shading and morph tables. For these we only copy the
 550  *  pointer, so the caller must make sure the memory contents of these pointers
 551  *  remain valid as long as they are used by the CSS. This will be fixed in the
 552  *  future by copying the contents instead of just the pointer.
 553  *
 554  *  Comment:
 555  *    ["ISP block", 1&2]   : ISP block is used both for ISP1 and ISP2.
 556  *    ["ISP block", 1only] : ISP block is used only for ISP1.
 557  *    ["ISP block", 2only] : ISP block is used only for ISP2.
 558  */
 559 struct ia_css_isp_config {
 560         struct ia_css_wb_config   *wb_config;   /** White Balance
 561                                                         [WB1, 1&2] */
 562         struct ia_css_cc_config   *cc_config;   /** Color Correction
 563                                                         [CSC1, 1only] */
 564         struct ia_css_tnr_config  *tnr_config;  /** Temporal Noise Reduction
 565                                                         [TNR1, 1&2] */
 566         struct ia_css_ecd_config  *ecd_config;  /** Eigen Color Demosaicing
 567                                                         [DE2, 2only] */
 568         struct ia_css_ynr_config  *ynr_config;  /** Y(Luma) Noise Reduction
 569                                                         [YNR2&YEE2, 2only] */
 570         struct ia_css_fc_config   *fc_config;   /** Fringe Control
 571                                                         [FC2, 2only] */
 572         struct ia_css_formats_config   *formats_config; /** Formats Control for main output
 573                                                         [FORMATS, 1&2] */
 574         struct ia_css_cnr_config  *cnr_config;  /** Chroma Noise Reduction
 575                                                         [CNR2, 2only] */
 576         struct ia_css_macc_config *macc_config; /** MACC
 577                                                         [MACC2, 2only] */
 578         struct ia_css_ctc_config  *ctc_config;  /** Chroma Tone Control
 579                                                         [CTC2, 2only] */
 580         struct ia_css_aa_config   *aa_config;   /** YUV Anti-Aliasing
 581                                                         [AA2, 2only]
 582                                                         (not used currently) */
 583         struct ia_css_aa_config   *baa_config;  /** Bayer Anti-Aliasing
 584                                                         [BAA2, 1&2] */
 585         struct ia_css_ce_config   *ce_config;   /** Chroma Enhancement
 586                                                         [CE1, 1only] */
 587         struct ia_css_dvs_6axis_config *dvs_6axis_config;
 588         struct ia_css_ob_config   *ob_config;  /** Objective Black
 589                                                         [OB1, 1&2] */
 590         struct ia_css_dp_config   *dp_config;  /** Defect Pixel Correction
 591                                                         [DPC1/DPC2, 1&2] */
 592         struct ia_css_nr_config   *nr_config;  /** Noise Reduction
 593                                                         [BNR1&YNR1&CNR1, 1&2]*/
 594         struct ia_css_ee_config   *ee_config;  /** Edge Enhancement
 595                                                         [YEE1, 1&2] */
 596         struct ia_css_de_config   *de_config;  /** Demosaic
 597                                                         [DE1, 1only] */
 598         struct ia_css_gc_config   *gc_config;  /** Gamma Correction (for YUV)
 599                                                         [GC1, 1only] */
 600         struct ia_css_anr_config  *anr_config; /** Advanced Noise Reduction */
 601         struct ia_css_3a_config   *s3a_config; /** 3A Statistics config */
 602         struct ia_css_xnr_config  *xnr_config; /** eXtra Noise Reduction */
 603         struct ia_css_dz_config   *dz_config;  /** Digital Zoom */
 604         struct ia_css_cc_config *yuv2rgb_cc_config; /** Color Correction
 605                                                         [CCM2, 2only] */
 606         struct ia_css_cc_config *rgb2yuv_cc_config; /** Color Correction
 607                                                         [CSC2, 2only] */
 608         struct ia_css_macc_table  *macc_table;  /** MACC
 609                                                         [MACC1/MACC2, 1&2]*/
 610         struct ia_css_gamma_table *gamma_table; /** Gamma Correction (for YUV)
 611                                                         [GC1, 1only] */
 612         struct ia_css_ctc_table   *ctc_table;   /** Chroma Tone Control
 613                                                         [CTC1, 1only] */
 614
 615         /* \deprecated */
 616         struct ia_css_xnr_table   *xnr_table;   /** eXtra Noise Reduction
 617                                                         [XNR1, 1&2] */
 618         struct ia_css_rgb_gamma_table *r_gamma_table;/** sRGB Gamma Correction
 619                                                         [GC2, 2only] */
 620         struct ia_css_rgb_gamma_table *g_gamma_table;/** sRGB Gamma Correction
 621                                                         [GC2, 2only] */
 622         struct ia_css_rgb_gamma_table *b_gamma_table;/** sRGB Gamma Correction
 623                                                         [GC2, 2only] */
 624         struct ia_css_vector      *motion_vector; /** For 2-axis DVS */
 625         struct ia_css_shading_table *shading_table;
 626         struct ia_css_morph_table   *morph_table;
 627         struct ia_css_dvs_coefficients *dvs_coefs; /** DVS 1.0 coefficients */
 628         struct ia_css_dvs2_coefficients *dvs2_coefs; /** DVS 2.0 coefficients */
 629         struct ia_css_capture_config   *capture_config;
 630         struct ia_css_anr_thres   *anr_thres;
 631         /* @deprecated{Old shading settings, see bugzilla bz675 for details} */
 632         struct ia_css_shading_settings *shading_settings;
 633         struct ia_css_xnr3_config *xnr3_config; /** eXtreme Noise Reduction v3 */
 634         /* comment from Lasse: Be aware how this feature will affect coordinate
 635          *  normalization in different parts of the system. (e.g. face detection,
 636          *  touch focus, 3A statistics and windows of interest, shading correction,
 637          *  DVS, GDC) from IQ tool level and application level down-to ISP FW level.
 638          *  the risk for regression is not in the individual blocks, but how they
 639          *  integrate together. */
 640         struct ia_css_output_config   *output_config;   /** Main Output Mirroring, flipping */
 641
 642 #ifdef ISP2401
 643         struct ia_css_tnr3_kernel_config         *tnr3_config;           /** TNR3 config */
 644 #endif
 645         struct ia_css_scaler_config              *scaler_config;         /** Skylake: scaler config (optional) */
 646         struct ia_css_formats_config             *formats_config_display;/** Formats control for viewfinder/display output (optional)
 647                                                                                 [OSYS, n/a] */
 648         struct ia_css_output_config              *output_config_display; /** Viewfinder/display output mirroring, flipping (optional) */
 649
 650         struct ia_css_frame                      *output_frame;          /** Output frame the config is to be applied to (optional) */
 651         uint32_t                        isp_config_id;  /** Unique ID to track which config was actually applied to a particular frame */
 652 };
 653
 654 #endif /* _IA_CSS_TYPES_H */