fimc-is-param.h (26023B)
1/* SPDX-License-Identifier: GPL-2.0-only */ 2/* 3 * Samsung EXYNOS4x12 FIMC-IS (Imaging Subsystem) driver 4 * 5 * Copyright (C) 2011 - 2013 Samsung Electronics Co., Ltd. 6 * 7 * Authors: Younghwan Joo <yhwan.joo@samsung.com> 8 * Sylwester Nawrocki <s.nawrocki@samsung.com> 9 */ 10#ifndef FIMC_IS_PARAM_H_ 11#define FIMC_IS_PARAM_H_ 12 13#include <linux/compiler.h> 14 15#define FIMC_IS_CONFIG_TIMEOUT 3000 /* ms */ 16#define IS_DEFAULT_WIDTH 1280 17#define IS_DEFAULT_HEIGHT 720 18 19#define DEFAULT_PREVIEW_STILL_WIDTH IS_DEFAULT_WIDTH 20#define DEFAULT_PREVIEW_STILL_HEIGHT IS_DEFAULT_HEIGHT 21#define DEFAULT_CAPTURE_STILL_WIDTH IS_DEFAULT_WIDTH 22#define DEFAULT_CAPTURE_STILL_HEIGHT IS_DEFAULT_HEIGHT 23#define DEFAULT_PREVIEW_VIDEO_WIDTH IS_DEFAULT_WIDTH 24#define DEFAULT_PREVIEW_VIDEO_HEIGHT IS_DEFAULT_HEIGHT 25#define DEFAULT_CAPTURE_VIDEO_WIDTH IS_DEFAULT_WIDTH 26#define DEFAULT_CAPTURE_VIDEO_HEIGHT IS_DEFAULT_HEIGHT 27 28#define DEFAULT_PREVIEW_STILL_FRAMERATE 30 29#define DEFAULT_CAPTURE_STILL_FRAMERATE 15 30#define DEFAULT_PREVIEW_VIDEO_FRAMERATE 30 31#define DEFAULT_CAPTURE_VIDEO_FRAMERATE 30 32 33#define FIMC_IS_REGION_VER 124 /* IS REGION VERSION 1.24 */ 34#define FIMC_IS_PARAM_SIZE (FIMC_IS_REGION_SIZE + 1) 35#define FIMC_IS_MAGIC_NUMBER 0x01020304 36#define FIMC_IS_PARAM_MAX_SIZE 64 /* in bytes */ 37#define FIMC_IS_PARAM_MAX_ENTRIES (FIMC_IS_PARAM_MAX_SIZE / 4) 38 39/* The parameter bitmask bit definitions. */ 40enum is_param_bit { 41 PARAM_GLOBAL_SHOTMODE, 42 PARAM_SENSOR_CONTROL, 43 PARAM_SENSOR_OTF_OUTPUT, 44 PARAM_SENSOR_FRAME_RATE, 45 PARAM_BUFFER_CONTROL, 46 PARAM_BUFFER_OTF_INPUT, 47 PARAM_BUFFER_OTF_OUTPUT, 48 PARAM_ISP_CONTROL, 49 PARAM_ISP_OTF_INPUT, 50 PARAM_ISP_DMA1_INPUT, 51 /* 10 */ 52 PARAM_ISP_DMA2_INPUT, 53 PARAM_ISP_AA, 54 PARAM_ISP_FLASH, 55 PARAM_ISP_AWB, 56 PARAM_ISP_IMAGE_EFFECT, 57 PARAM_ISP_ISO, 58 PARAM_ISP_ADJUST, 59 PARAM_ISP_METERING, 60 PARAM_ISP_AFC, 61 PARAM_ISP_OTF_OUTPUT, 62 /* 20 */ 63 PARAM_ISP_DMA1_OUTPUT, 64 PARAM_ISP_DMA2_OUTPUT, 65 PARAM_DRC_CONTROL, 66 PARAM_DRC_OTF_INPUT, 67 PARAM_DRC_DMA_INPUT, 68 PARAM_DRC_OTF_OUTPUT, 69 PARAM_SCALERC_CONTROL, 70 PARAM_SCALERC_OTF_INPUT, 71 PARAM_SCALERC_IMAGE_EFFECT, 72 PARAM_SCALERC_INPUT_CROP, 73 /* 30 */ 74 PARAM_SCALERC_OUTPUT_CROP, 75 PARAM_SCALERC_OTF_OUTPUT, 76 PARAM_SCALERC_DMA_OUTPUT, 77 PARAM_ODC_CONTROL, 78 PARAM_ODC_OTF_INPUT, 79 PARAM_ODC_OTF_OUTPUT, 80 PARAM_DIS_CONTROL, 81 PARAM_DIS_OTF_INPUT, 82 PARAM_DIS_OTF_OUTPUT, 83 PARAM_TDNR_CONTROL, 84 /* 40 */ 85 PARAM_TDNR_OTF_INPUT, 86 PARAM_TDNR_1ST_FRAME, 87 PARAM_TDNR_OTF_OUTPUT, 88 PARAM_TDNR_DMA_OUTPUT, 89 PARAM_SCALERP_CONTROL, 90 PARAM_SCALERP_OTF_INPUT, 91 PARAM_SCALERP_IMAGE_EFFECT, 92 PARAM_SCALERP_INPUT_CROP, 93 PARAM_SCALERP_OUTPUT_CROP, 94 PARAM_SCALERP_ROTATION, 95 /* 50 */ 96 PARAM_SCALERP_FLIP, 97 PARAM_SCALERP_OTF_OUTPUT, 98 PARAM_SCALERP_DMA_OUTPUT, 99 PARAM_FD_CONTROL, 100 PARAM_FD_OTF_INPUT, 101 PARAM_FD_DMA_INPUT, 102 PARAM_FD_CONFIG, 103}; 104 105/* Interrupt map */ 106#define FIMC_IS_INT_GENERAL 0 107#define FIMC_IS_INT_FRAME_DONE_ISP 1 108 109/* Input */ 110 111#define CONTROL_COMMAND_STOP 0 112#define CONTROL_COMMAND_START 1 113 114#define CONTROL_BYPASS_DISABLE 0 115#define CONTROL_BYPASS_ENABLE 1 116 117#define CONTROL_ERROR_NONE 0 118 119/* OTF (On-The-Fly) input interface commands */ 120#define OTF_INPUT_COMMAND_DISABLE 0 121#define OTF_INPUT_COMMAND_ENABLE 1 122 123/* OTF input interface color formats */ 124enum oft_input_fmt { 125 OTF_INPUT_FORMAT_BAYER = 0, /* 1 channel */ 126 OTF_INPUT_FORMAT_YUV444 = 1, /* 3 channels */ 127 OTF_INPUT_FORMAT_YUV422 = 2, /* 3 channels */ 128 OTF_INPUT_FORMAT_YUV420 = 3, /* 3 channels */ 129 OTF_INPUT_FORMAT_STRGEN_COLORBAR_BAYER = 10, 130 OTF_INPUT_FORMAT_BAYER_DMA = 11, 131}; 132 133#define OTF_INPUT_ORDER_BAYER_GR_BG 0 134 135/* OTF input error codes */ 136#define OTF_INPUT_ERROR_NONE 0 /* Input setting is done */ 137 138/* DMA input commands */ 139#define DMA_INPUT_COMMAND_DISABLE 0 140#define DMA_INPUT_COMMAND_ENABLE 1 141 142/* DMA input color formats */ 143enum dma_input_fmt { 144 DMA_INPUT_FORMAT_BAYER = 0, 145 DMA_INPUT_FORMAT_YUV444 = 1, 146 DMA_INPUT_FORMAT_YUV422 = 2, 147 DMA_INPUT_FORMAT_YUV420 = 3, 148}; 149 150enum dma_input_order { 151 /* (for DMA_INPUT_PLANE_3) */ 152 DMA_INPUT_ORDER_NO = 0, 153 /* (only valid at DMA_INPUT_PLANE_2) */ 154 DMA_INPUT_ORDER_CBCR = 1, 155 /* (only valid at DMA_INPUT_PLANE_2) */ 156 DMA_INPUT_ORDER_CRCB = 2, 157 /* (only valid at DMA_INPUT_PLANE_1 & DMA_INPUT_FORMAT_YUV444) */ 158 DMA_INPUT_ORDER_YCBCR = 3, 159 /* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */ 160 DMA_INPUT_ORDER_YYCBCR = 4, 161 /* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */ 162 DMA_INPUT_ORDER_YCBYCR = 5, 163 /* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */ 164 DMA_INPUT_ORDER_YCRYCB = 6, 165 /* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */ 166 DMA_INPUT_ORDER_CBYCRY = 7, 167 /* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */ 168 DMA_INPUT_ORDER_CRYCBY = 8, 169 /* (only valid at DMA_INPUT_FORMAT_BAYER) */ 170 DMA_INPUT_ORDER_GR_BG = 9 171}; 172 173#define DMA_INPUT_ERROR_NONE 0 /* DMA input setting 174 is done */ 175/* 176 * Data output parameter definitions 177 */ 178#define OTF_OUTPUT_CROP_DISABLE 0 179#define OTF_OUTPUT_CROP_ENABLE 1 180 181#define OTF_OUTPUT_COMMAND_DISABLE 0 182#define OTF_OUTPUT_COMMAND_ENABLE 1 183 184enum otf_output_fmt { 185 OTF_OUTPUT_FORMAT_YUV444 = 1, 186 OTF_OUTPUT_FORMAT_YUV422 = 2, 187 OTF_OUTPUT_FORMAT_YUV420 = 3, 188 OTF_OUTPUT_FORMAT_RGB = 4, 189}; 190 191#define OTF_OUTPUT_ORDER_BAYER_GR_BG 0 192 193#define OTF_OUTPUT_ERROR_NONE 0 /* Output Setting is done */ 194 195#define DMA_OUTPUT_COMMAND_DISABLE 0 196#define DMA_OUTPUT_COMMAND_ENABLE 1 197 198enum dma_output_fmt { 199 DMA_OUTPUT_FORMAT_BAYER = 0, 200 DMA_OUTPUT_FORMAT_YUV444 = 1, 201 DMA_OUTPUT_FORMAT_YUV422 = 2, 202 DMA_OUTPUT_FORMAT_YUV420 = 3, 203 DMA_OUTPUT_FORMAT_RGB = 4, 204}; 205 206enum dma_output_order { 207 DMA_OUTPUT_ORDER_NO = 0, 208 /* for DMA_OUTPUT_PLANE_3 */ 209 DMA_OUTPUT_ORDER_CBCR = 1, 210 /* only valid at DMA_INPUT_PLANE_2) */ 211 DMA_OUTPUT_ORDER_CRCB = 2, 212 /* only valid at DMA_OUTPUT_PLANE_2) */ 213 DMA_OUTPUT_ORDER_YYCBCR = 3, 214 /* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */ 215 DMA_OUTPUT_ORDER_YCBYCR = 4, 216 /* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */ 217 DMA_OUTPUT_ORDER_YCRYCB = 5, 218 /* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */ 219 DMA_OUTPUT_ORDER_CBYCRY = 6, 220 /* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */ 221 DMA_OUTPUT_ORDER_CRYCBY = 7, 222 /* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */ 223 DMA_OUTPUT_ORDER_YCBCR = 8, 224 /* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */ 225 DMA_OUTPUT_ORDER_CRYCB = 9, 226 /* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */ 227 DMA_OUTPUT_ORDER_CRCBY = 10, 228 /* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */ 229 DMA_OUTPUT_ORDER_CBYCR = 11, 230 /* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */ 231 DMA_OUTPUT_ORDER_YCRCB = 12, 232 /* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */ 233 DMA_OUTPUT_ORDER_CBCRY = 13, 234 /* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */ 235 DMA_OUTPUT_ORDER_BGR = 14, 236 /* only valid at DMA_OUTPUT_FORMAT_RGB */ 237 DMA_OUTPUT_ORDER_GB_BG = 15 238 /* only valid at DMA_OUTPUT_FORMAT_BAYER */ 239}; 240 241/* enum dma_output_notify_dma_done */ 242#define DMA_OUTPUT_NOTIFY_DMA_DONE_DISABLE 0 243#define DMA_OUTPUT_NOTIFY_DMA_DONE_ENABLE 1 244 245/* DMA output error codes */ 246#define DMA_OUTPUT_ERROR_NONE 0 /* DMA output setting 247 is done */ 248 249/* ---------------------- Global ----------------------------------- */ 250#define GLOBAL_SHOTMODE_ERROR_NONE 0 /* shot-mode setting 251 is done */ 252/* 3A lock commands */ 253#define ISP_AA_COMMAND_START 0 254#define ISP_AA_COMMAND_STOP 1 255 256/* 3A lock target */ 257#define ISP_AA_TARGET_AF 1 258#define ISP_AA_TARGET_AE 2 259#define ISP_AA_TARGET_AWB 4 260 261enum isp_af_mode { 262 ISP_AF_MODE_MANUAL = 0, 263 ISP_AF_MODE_SINGLE = 1, 264 ISP_AF_MODE_CONTINUOUS = 2, 265 ISP_AF_MODE_TOUCH = 3, 266 ISP_AF_MODE_SLEEP = 4, 267 ISP_AF_MODE_INIT = 5, 268 ISP_AF_MODE_SET_CENTER_WINDOW = 6, 269 ISP_AF_MODE_SET_TOUCH_WINDOW = 7 270}; 271 272/* Face AF commands */ 273#define ISP_AF_FACE_DISABLE 0 274#define ISP_AF_FACE_ENABLE 1 275 276/* AF range */ 277#define ISP_AF_RANGE_NORMAL 0 278#define ISP_AF_RANGE_MACRO 1 279 280/* AF sleep */ 281#define ISP_AF_SLEEP_OFF 0 282#define ISP_AF_SLEEP_ON 1 283 284/* Continuous AF commands */ 285#define ISP_AF_CONTINUOUS_DISABLE 0 286#define ISP_AF_CONTINUOUS_ENABLE 1 287 288/* ISP AF error codes */ 289#define ISP_AF_ERROR_NONE 0 /* AF mode change is done */ 290#define ISP_AF_ERROR_NONE_LOCK_DONE 1 /* AF lock is done */ 291 292/* Flash commands */ 293#define ISP_FLASH_COMMAND_DISABLE 0 294#define ISP_FLASH_COMMAND_MANUAL_ON 1 /* (forced flash) */ 295#define ISP_FLASH_COMMAND_AUTO 2 296#define ISP_FLASH_COMMAND_TORCH 3 /* 3 sec */ 297 298/* Flash red-eye commands */ 299#define ISP_FLASH_REDEYE_DISABLE 0 300#define ISP_FLASH_REDEYE_ENABLE 1 301 302/* Flash error codes */ 303#define ISP_FLASH_ERROR_NONE 0 /* Flash setting is done */ 304 305/* -------------------------- AWB ------------------------------------ */ 306enum isp_awb_command { 307 ISP_AWB_COMMAND_AUTO = 0, 308 ISP_AWB_COMMAND_ILLUMINATION = 1, 309 ISP_AWB_COMMAND_MANUAL = 2 310}; 311 312enum isp_awb_illumination { 313 ISP_AWB_ILLUMINATION_DAYLIGHT = 0, 314 ISP_AWB_ILLUMINATION_CLOUDY = 1, 315 ISP_AWB_ILLUMINATION_TUNGSTEN = 2, 316 ISP_AWB_ILLUMINATION_FLUORESCENT = 3 317}; 318 319/* ISP AWN error codes */ 320#define ISP_AWB_ERROR_NONE 0 /* AWB setting is done */ 321 322/* -------------------------- Effect ----------------------------------- */ 323enum isp_imageeffect_command { 324 ISP_IMAGE_EFFECT_DISABLE = 0, 325 ISP_IMAGE_EFFECT_MONOCHROME = 1, 326 ISP_IMAGE_EFFECT_NEGATIVE_MONO = 2, 327 ISP_IMAGE_EFFECT_NEGATIVE_COLOR = 3, 328 ISP_IMAGE_EFFECT_SEPIA = 4 329}; 330 331/* Image effect error codes */ 332#define ISP_IMAGE_EFFECT_ERROR_NONE 0 /* Image effect setting 333 is done */ 334/* ISO commands */ 335#define ISP_ISO_COMMAND_AUTO 0 336#define ISP_ISO_COMMAND_MANUAL 1 337 338/* ISO error codes */ 339#define ISP_ISO_ERROR_NONE 0 /* ISO setting is done */ 340 341/* ISP adjust commands */ 342#define ISP_ADJUST_COMMAND_AUTO (0 << 0) 343#define ISP_ADJUST_COMMAND_MANUAL_CONTRAST (1 << 0) 344#define ISP_ADJUST_COMMAND_MANUAL_SATURATION (1 << 1) 345#define ISP_ADJUST_COMMAND_MANUAL_SHARPNESS (1 << 2) 346#define ISP_ADJUST_COMMAND_MANUAL_EXPOSURE (1 << 3) 347#define ISP_ADJUST_COMMAND_MANUAL_BRIGHTNESS (1 << 4) 348#define ISP_ADJUST_COMMAND_MANUAL_HUE (1 << 5) 349#define ISP_ADJUST_COMMAND_MANUAL_ALL 0x7f 350 351/* ISP adjustment error codes */ 352#define ISP_ADJUST_ERROR_NONE 0 /* Adjust setting is done */ 353 354/* 355 * Exposure metering 356 */ 357enum isp_metering_command { 358 ISP_METERING_COMMAND_AVERAGE = 0, 359 ISP_METERING_COMMAND_SPOT = 1, 360 ISP_METERING_COMMAND_MATRIX = 2, 361 ISP_METERING_COMMAND_CENTER = 3 362}; 363 364/* ISP metering error codes */ 365#define ISP_METERING_ERROR_NONE 0 /* Metering setting is done */ 366 367/* 368 * AFC 369 */ 370enum isp_afc_command { 371 ISP_AFC_COMMAND_DISABLE = 0, 372 ISP_AFC_COMMAND_AUTO = 1, 373 ISP_AFC_COMMAND_MANUAL = 2, 374}; 375 376#define ISP_AFC_MANUAL_50HZ 50 377#define ISP_AFC_MANUAL_60HZ 60 378 379/* ------------------------ SCENE MODE--------------------------------- */ 380enum isp_scene_mode { 381 ISP_SCENE_NONE = 0, 382 ISP_SCENE_PORTRAIT = 1, 383 ISP_SCENE_LANDSCAPE = 2, 384 ISP_SCENE_SPORTS = 3, 385 ISP_SCENE_PARTYINDOOR = 4, 386 ISP_SCENE_BEACHSNOW = 5, 387 ISP_SCENE_SUNSET = 6, 388 ISP_SCENE_DAWN = 7, 389 ISP_SCENE_FALL = 8, 390 ISP_SCENE_NIGHT = 9, 391 ISP_SCENE_AGAINSTLIGHTWLIGHT = 10, 392 ISP_SCENE_AGAINSTLIGHTWOLIGHT = 11, 393 ISP_SCENE_FIRE = 12, 394 ISP_SCENE_TEXT = 13, 395 ISP_SCENE_CANDLE = 14 396}; 397 398/* AFC error codes */ 399#define ISP_AFC_ERROR_NONE 0 /* AFC setting is done */ 400 401/* ---------------------------- FD ------------------------------------- */ 402enum fd_config_command { 403 FD_CONFIG_COMMAND_MAXIMUM_NUMBER = 0x1, 404 FD_CONFIG_COMMAND_ROLL_ANGLE = 0x2, 405 FD_CONFIG_COMMAND_YAW_ANGLE = 0x4, 406 FD_CONFIG_COMMAND_SMILE_MODE = 0x8, 407 FD_CONFIG_COMMAND_BLINK_MODE = 0x10, 408 FD_CONFIG_COMMAND_EYES_DETECT = 0x20, 409 FD_CONFIG_COMMAND_MOUTH_DETECT = 0x40, 410 FD_CONFIG_COMMAND_ORIENTATION = 0x80, 411 FD_CONFIG_COMMAND_ORIENTATION_VALUE = 0x100 412}; 413 414enum fd_config_roll_angle { 415 FD_CONFIG_ROLL_ANGLE_BASIC = 0, 416 FD_CONFIG_ROLL_ANGLE_PRECISE_BASIC = 1, 417 FD_CONFIG_ROLL_ANGLE_SIDES = 2, 418 FD_CONFIG_ROLL_ANGLE_PRECISE_SIDES = 3, 419 FD_CONFIG_ROLL_ANGLE_FULL = 4, 420 FD_CONFIG_ROLL_ANGLE_PRECISE_FULL = 5, 421}; 422 423enum fd_config_yaw_angle { 424 FD_CONFIG_YAW_ANGLE_0 = 0, 425 FD_CONFIG_YAW_ANGLE_45 = 1, 426 FD_CONFIG_YAW_ANGLE_90 = 2, 427 FD_CONFIG_YAW_ANGLE_45_90 = 3, 428}; 429 430/* Smile mode configuration */ 431#define FD_CONFIG_SMILE_MODE_DISABLE 0 432#define FD_CONFIG_SMILE_MODE_ENABLE 1 433 434/* Blink mode configuration */ 435#define FD_CONFIG_BLINK_MODE_DISABLE 0 436#define FD_CONFIG_BLINK_MODE_ENABLE 1 437 438/* Eyes detection configuration */ 439#define FD_CONFIG_EYES_DETECT_DISABLE 0 440#define FD_CONFIG_EYES_DETECT_ENABLE 1 441 442/* Mouth detection configuration */ 443#define FD_CONFIG_MOUTH_DETECT_DISABLE 0 444#define FD_CONFIG_MOUTH_DETECT_ENABLE 1 445 446#define FD_CONFIG_ORIENTATION_DISABLE 0 447#define FD_CONFIG_ORIENTATION_ENABLE 1 448 449struct param_control { 450 u32 cmd; 451 u32 bypass; 452 u32 buffer_address; 453 u32 buffer_size; 454 u32 skip_frames; /* only valid at ISP */ 455 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 6]; 456 u32 err; 457}; 458 459struct param_otf_input { 460 u32 cmd; 461 u32 width; 462 u32 height; 463 u32 format; 464 u32 bitwidth; 465 u32 order; 466 u32 crop_offset_x; 467 u32 crop_offset_y; 468 u32 crop_width; 469 u32 crop_height; 470 u32 frametime_min; 471 u32 frametime_max; 472 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 13]; 473 u32 err; 474}; 475 476struct param_dma_input { 477 u32 cmd; 478 u32 width; 479 u32 height; 480 u32 format; 481 u32 bitwidth; 482 u32 plane; 483 u32 order; 484 u32 buffer_number; 485 u32 buffer_address; 486 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 10]; 487 u32 err; 488}; 489 490struct param_otf_output { 491 u32 cmd; 492 u32 width; 493 u32 height; 494 u32 format; 495 u32 bitwidth; 496 u32 order; 497 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 7]; 498 u32 err; 499}; 500 501struct param_dma_output { 502 u32 cmd; 503 u32 width; 504 u32 height; 505 u32 format; 506 u32 bitwidth; 507 u32 plane; 508 u32 order; 509 u32 buffer_number; 510 u32 buffer_address; 511 u32 notify_dma_done; 512 u32 dma_out_mask; 513 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 12]; 514 u32 err; 515}; 516 517struct param_global_shotmode { 518 u32 cmd; 519 u32 skip_frames; 520 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3]; 521 u32 err; 522}; 523 524struct param_sensor_framerate { 525 u32 frame_rate; 526 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2]; 527 u32 err; 528}; 529 530struct param_isp_aa { 531 u32 cmd; 532 u32 target; 533 u32 mode; 534 u32 scene; 535 u32 sleep; 536 u32 face; 537 u32 touch_x; 538 u32 touch_y; 539 u32 manual_af_setting; 540 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 10]; 541 u32 err; 542}; 543 544struct param_isp_flash { 545 u32 cmd; 546 u32 redeye; 547 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3]; 548 u32 err; 549}; 550 551struct param_isp_awb { 552 u32 cmd; 553 u32 illumination; 554 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3]; 555 u32 err; 556}; 557 558struct param_isp_imageeffect { 559 u32 cmd; 560 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2]; 561 u32 err; 562}; 563 564struct param_isp_iso { 565 u32 cmd; 566 u32 value; 567 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3]; 568 u32 err; 569}; 570 571struct param_isp_adjust { 572 u32 cmd; 573 s32 contrast; 574 s32 saturation; 575 s32 sharpness; 576 s32 exposure; 577 s32 brightness; 578 s32 hue; 579 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 8]; 580 u32 err; 581}; 582 583struct param_isp_metering { 584 u32 cmd; 585 u32 win_pos_x; 586 u32 win_pos_y; 587 u32 win_width; 588 u32 win_height; 589 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 6]; 590 u32 err; 591}; 592 593struct param_isp_afc { 594 u32 cmd; 595 u32 manual; 596 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3]; 597 u32 err; 598}; 599 600struct param_scaler_imageeffect { 601 u32 cmd; 602 u32 arbitrary_cb; 603 u32 arbitrary_cr; 604 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 4]; 605 u32 err; 606}; 607 608struct param_scaler_input_crop { 609 u32 cmd; 610 u32 crop_offset_x; 611 u32 crop_offset_y; 612 u32 crop_width; 613 u32 crop_height; 614 u32 in_width; 615 u32 in_height; 616 u32 out_width; 617 u32 out_height; 618 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 10]; 619 u32 err; 620}; 621 622struct param_scaler_output_crop { 623 u32 cmd; 624 u32 crop_offset_x; 625 u32 crop_offset_y; 626 u32 crop_width; 627 u32 crop_height; 628 u32 out_format; 629 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 7]; 630 u32 err; 631}; 632 633struct param_scaler_rotation { 634 u32 cmd; 635 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2]; 636 u32 err; 637}; 638 639struct param_scaler_flip { 640 u32 cmd; 641 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2]; 642 u32 err; 643}; 644 645struct param_3dnr_1stframe { 646 u32 cmd; 647 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2]; 648 u32 err; 649}; 650 651struct param_fd_config { 652 u32 cmd; 653 u32 max_number; 654 u32 roll_angle; 655 u32 yaw_angle; 656 u32 smile_mode; 657 u32 blink_mode; 658 u32 eye_detect; 659 u32 mouth_detect; 660 u32 orientation; 661 u32 orientation_value; 662 u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 11]; 663 u32 err; 664}; 665 666struct global_param { 667 struct param_global_shotmode shotmode; 668}; 669 670struct sensor_param { 671 struct param_control control; 672 struct param_otf_output otf_output; 673 struct param_sensor_framerate frame_rate; 674} __packed; 675 676struct buffer_param { 677 struct param_control control; 678 struct param_otf_input otf_input; 679 struct param_otf_output otf_output; 680} __packed; 681 682struct isp_param { 683 struct param_control control; 684 struct param_otf_input otf_input; 685 struct param_dma_input dma1_input; 686 struct param_dma_input dma2_input; 687 struct param_isp_aa aa; 688 struct param_isp_flash flash; 689 struct param_isp_awb awb; 690 struct param_isp_imageeffect effect; 691 struct param_isp_iso iso; 692 struct param_isp_adjust adjust; 693 struct param_isp_metering metering; 694 struct param_isp_afc afc; 695 struct param_otf_output otf_output; 696 struct param_dma_output dma1_output; 697 struct param_dma_output dma2_output; 698} __packed; 699 700struct drc_param { 701 struct param_control control; 702 struct param_otf_input otf_input; 703 struct param_dma_input dma_input; 704 struct param_otf_output otf_output; 705} __packed; 706 707struct scalerc_param { 708 struct param_control control; 709 struct param_otf_input otf_input; 710 struct param_scaler_imageeffect effect; 711 struct param_scaler_input_crop input_crop; 712 struct param_scaler_output_crop output_crop; 713 struct param_otf_output otf_output; 714 struct param_dma_output dma_output; 715} __packed; 716 717struct odc_param { 718 struct param_control control; 719 struct param_otf_input otf_input; 720 struct param_otf_output otf_output; 721} __packed; 722 723struct dis_param { 724 struct param_control control; 725 struct param_otf_output otf_input; 726 struct param_otf_output otf_output; 727} __packed; 728 729struct tdnr_param { 730 struct param_control control; 731 struct param_otf_input otf_input; 732 struct param_3dnr_1stframe frame; 733 struct param_otf_output otf_output; 734 struct param_dma_output dma_output; 735} __packed; 736 737struct scalerp_param { 738 struct param_control control; 739 struct param_otf_input otf_input; 740 struct param_scaler_imageeffect effect; 741 struct param_scaler_input_crop input_crop; 742 struct param_scaler_output_crop output_crop; 743 struct param_scaler_rotation rotation; 744 struct param_scaler_flip flip; 745 struct param_otf_output otf_output; 746 struct param_dma_output dma_output; 747} __packed; 748 749struct fd_param { 750 struct param_control control; 751 struct param_otf_input otf_input; 752 struct param_dma_input dma_input; 753 struct param_fd_config config; 754} __packed; 755 756struct is_param_region { 757 struct global_param global; 758 struct sensor_param sensor; 759 struct buffer_param buf; 760 struct isp_param isp; 761 struct drc_param drc; 762 struct scalerc_param scalerc; 763 struct odc_param odc; 764 struct dis_param dis; 765 struct tdnr_param tdnr; 766 struct scalerp_param scalerp; 767 struct fd_param fd; 768} __packed; 769 770#define NUMBER_OF_GAMMA_CURVE_POINTS 32 771 772struct is_tune_sensor { 773 u32 exposure; 774 u32 analog_gain; 775 u32 frame_rate; 776 u32 actuator_position; 777}; 778 779struct is_tune_gammacurve { 780 u32 num_pts_x[NUMBER_OF_GAMMA_CURVE_POINTS]; 781 u32 num_pts_y_r[NUMBER_OF_GAMMA_CURVE_POINTS]; 782 u32 num_pts_y_g[NUMBER_OF_GAMMA_CURVE_POINTS]; 783 u32 num_pts_y_b[NUMBER_OF_GAMMA_CURVE_POINTS]; 784}; 785 786struct is_tune_isp { 787 /* Brightness level: range 0...100, default 7. */ 788 u32 brightness_level; 789 /* Contrast level: range -127...127, default 0. */ 790 s32 contrast_level; 791 /* Saturation level: range -127...127, default 0. */ 792 s32 saturation_level; 793 s32 gamma_level; 794 struct is_tune_gammacurve gamma_curve[4]; 795 /* Hue: range -127...127, default 0. */ 796 s32 hue; 797 /* Sharpness blur: range -127...127, default 0. */ 798 s32 sharpness_blur; 799 /* Despeckle : range -127~127, default : 0 */ 800 s32 despeckle; 801 /* Edge color supression: range -127...127, default 0. */ 802 s32 edge_color_supression; 803 /* Noise reduction: range -127...127, default 0. */ 804 s32 noise_reduction; 805 /* (32 * 4 + 9) * 4 = 548 bytes */ 806} __packed; 807 808struct is_tune_region { 809 struct is_tune_sensor sensor; 810 struct is_tune_isp isp; 811} __packed; 812 813struct rational { 814 u32 num; 815 u32 den; 816}; 817 818struct srational { 819 s32 num; 820 s32 den; 821}; 822 823#define FLASH_FIRED_SHIFT 0 824#define FLASH_NOT_FIRED 0 825#define FLASH_FIRED 1 826 827#define FLASH_STROBE_SHIFT 1 828#define FLASH_STROBE_NO_DETECTION 0 829#define FLASH_STROBE_RESERVED 1 830#define FLASH_STROBE_RETURN_LIGHT_NOT_DETECTED 2 831#define FLASH_STROBE_RETURN_LIGHT_DETECTED 3 832 833#define FLASH_MODE_SHIFT 3 834#define FLASH_MODE_UNKNOWN 0 835#define FLASH_MODE_COMPULSORY_FLASH_FIRING 1 836#define FLASH_MODE_COMPULSORY_FLASH_SUPPRESSION 2 837#define FLASH_MODE_AUTO_MODE 3 838 839#define FLASH_FUNCTION_SHIFT 5 840#define FLASH_FUNCTION_PRESENT 0 841#define FLASH_FUNCTION_NONE 1 842 843#define FLASH_RED_EYE_SHIFT 6 844#define FLASH_RED_EYE_DISABLED 0 845#define FLASH_RED_EYE_SUPPORTED 1 846 847enum apex_aperture_value { 848 F1_0 = 0, 849 F1_4 = 1, 850 F2_0 = 2, 851 F2_8 = 3, 852 F4_0 = 4, 853 F5_6 = 5, 854 F8_9 = 6, 855 F11_0 = 7, 856 F16_0 = 8, 857 F22_0 = 9, 858 F32_0 = 10, 859}; 860 861struct exif_attribute { 862 struct rational exposure_time; 863 struct srational shutter_speed; 864 u32 iso_speed_rating; 865 u32 flash; 866 struct srational brightness; 867} __packed; 868 869struct is_frame_header { 870 u32 valid; 871 u32 bad_mark; 872 u32 captured; 873 u32 frame_number; 874 struct exif_attribute exif; 875} __packed; 876 877struct is_fd_rect { 878 u32 offset_x; 879 u32 offset_y; 880 u32 width; 881 u32 height; 882}; 883 884struct is_face_marker { 885 u32 frame_number; 886 struct is_fd_rect face; 887 struct is_fd_rect left_eye; 888 struct is_fd_rect right_eye; 889 struct is_fd_rect mouth; 890 u32 roll_angle; 891 u32 yaw_angle; 892 u32 confidence; 893 s32 smile_level; 894 s32 blink_level; 895} __packed; 896 897#define MAX_FRAME_COUNT 8 898#define MAX_FRAME_COUNT_PREVIEW 4 899#define MAX_FRAME_COUNT_CAPTURE 1 900#define MAX_FACE_COUNT 16 901#define MAX_SHARED_COUNT 500 902 903struct is_region { 904 struct is_param_region parameter; 905 struct is_tune_region tune; 906 struct is_frame_header header[MAX_FRAME_COUNT]; 907 struct is_face_marker face[MAX_FACE_COUNT]; 908 u32 shared[MAX_SHARED_COUNT]; 909} __packed; 910 911/* Offset to the ISP DMA2 output buffer address array. */ 912#define DMA2_OUTPUT_ADDR_ARRAY_OFFS \ 913 (offsetof(struct is_region, shared) + 32 * sizeof(u32)) 914 915struct is_debug_frame_descriptor { 916 u32 sensor_frame_time; 917 u32 sensor_exposure_time; 918 s32 sensor_analog_gain; 919 /* monitor for AA */ 920 u32 req_lei; 921 922 u32 next_next_lei_exp; 923 u32 next_next_lei_a_gain; 924 u32 next_next_lei_d_gain; 925 u32 next_next_lei_statlei; 926 u32 next_next_lei_lei; 927 928 u32 dummy0; 929}; 930 931#define MAX_FRAMEDESCRIPTOR_CONTEXT_NUM (30*20) /* 600 frames */ 932#define MAX_VERSION_DISPLAY_BUF 32 933 934struct is_share_region { 935 u32 frame_time; 936 u32 exposure_time; 937 s32 analog_gain; 938 939 u32 r_gain; 940 u32 g_gain; 941 u32 b_gain; 942 943 u32 af_position; 944 u32 af_status; 945 /* 0 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_NOMESSAGE */ 946 /* 1 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_REACHED */ 947 /* 2 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_UNABLETOREACH */ 948 /* 3 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_LOST */ 949 /* default : unknown */ 950 u32 af_scene_type; 951 952 u32 frame_descp_onoff_control; 953 u32 frame_descp_update_done; 954 u32 frame_descp_idx; 955 u32 frame_descp_max_idx; 956 struct is_debug_frame_descriptor 957 dbg_frame_descp_ctx[MAX_FRAMEDESCRIPTOR_CONTEXT_NUM]; 958 959 u32 chip_id; 960 u32 chip_rev_no; 961 u8 isp_fw_ver_no[MAX_VERSION_DISPLAY_BUF]; 962 u8 isp_fw_ver_date[MAX_VERSION_DISPLAY_BUF]; 963 u8 sirc_sdk_ver_no[MAX_VERSION_DISPLAY_BUF]; 964 u8 sirc_sdk_rev_no[MAX_VERSION_DISPLAY_BUF]; 965 u8 sirc_sdk_rev_date[MAX_VERSION_DISPLAY_BUF]; 966} __packed; 967 968struct is_debug_control { 969 u32 write_point; /* 0~ 500KB boundary */ 970 u32 assert_flag; /* 0: Not invoked, 1: Invoked */ 971 u32 pabort_flag; /* 0: Not invoked, 1: Invoked */ 972 u32 dabort_flag; /* 0: Not invoked, 1: Invoked */ 973}; 974 975struct sensor_open_extended { 976 u32 actuator_type; 977 u32 mclk; 978 u32 mipi_lane_num; 979 u32 mipi_speed; 980 /* Skip setfile loading when fast_open_sensor is not 0 */ 981 u32 fast_open_sensor; 982 /* Activating sensor self calibration mode (6A3) */ 983 u32 self_calibration_mode; 984 /* This field is to adjust I2c clock based on ACLK200 */ 985 /* This value is varied in case of rev 0.2 */ 986 u32 i2c_sclk; 987}; 988 989struct fimc_is; 990 991int fimc_is_hw_get_sensor_max_framerate(struct fimc_is *is); 992int __fimc_is_hw_update_param(struct fimc_is *is, u32 offset); 993void fimc_is_set_initial_params(struct fimc_is *is); 994unsigned int __get_pending_param_count(struct fimc_is *is); 995 996int __is_hw_update_params(struct fimc_is *is); 997void __is_get_frame_size(struct fimc_is *is, struct v4l2_mbus_framefmt *mf); 998void __is_set_frame_size(struct fimc_is *is, struct v4l2_mbus_framefmt *mf); 999void __is_set_sensor(struct fimc_is *is, int fps); 1000void __is_set_isp_aa_ae(struct fimc_is *is); 1001void __is_set_isp_flash(struct fimc_is *is, u32 cmd, u32 redeye); 1002void __is_set_isp_awb(struct fimc_is *is, u32 cmd, u32 val); 1003void __is_set_isp_effect(struct fimc_is *is, u32 cmd); 1004void __is_set_isp_iso(struct fimc_is *is, u32 cmd, u32 val); 1005void __is_set_isp_adjust(struct fimc_is *is, u32 cmd, u32 val); 1006void __is_set_isp_metering(struct fimc_is *is, u32 id, u32 val); 1007void __is_set_isp_afc(struct fimc_is *is, u32 cmd, u32 val); 1008void __is_set_drc_control(struct fimc_is *is, u32 val); 1009void __is_set_fd_control(struct fimc_is *is, u32 val); 1010void __is_set_fd_config_maxface(struct fimc_is *is, u32 val); 1011void __is_set_fd_config_rollangle(struct fimc_is *is, u32 val); 1012void __is_set_fd_config_yawangle(struct fimc_is *is, u32 val); 1013void __is_set_fd_config_smilemode(struct fimc_is *is, u32 val); 1014void __is_set_fd_config_blinkmode(struct fimc_is *is, u32 val); 1015void __is_set_fd_config_eyedetect(struct fimc_is *is, u32 val); 1016void __is_set_fd_config_mouthdetect(struct fimc_is *is, u32 val); 1017void __is_set_fd_config_orientation(struct fimc_is *is, u32 val); 1018void __is_set_fd_config_orientation_val(struct fimc_is *is, u32 val); 1019void __is_set_isp_aa_af_mode(struct fimc_is *is, int cmd); 1020void __is_set_isp_aa_af_start_stop(struct fimc_is *is, int cmd); 1021 1022#endif