linux/drivers/media/video/m5mols/m5mols_reg.h
<<
>>
Prefs
   1/*
   2 * Register map for M-5MOLS 8M Pixel camera sensor with ISP
   3 *
   4 * Copyright (C) 2011 Samsung Electronics Co., Ltd.
   5 * Author: HeungJun Kim <riverful.kim@samsung.com>
   6 *
   7 * Copyright (C) 2009 Samsung Electronics Co., Ltd.
   8 * Author: Dongsoo Nathaniel Kim <dongsoo45.kim@samsung.com>
   9 *
  10 * This program is free software; you can redistribute it and/or modify
  11 * it under the terms of the GNU General Public License as published by
  12 * the Free Software Foundation; either version 2 of the License, or
  13 * (at your option) any later version.
  14 */
  15
  16#ifndef M5MOLS_REG_H
  17#define M5MOLS_REG_H
  18
  19#define M5MOLS_I2C_MAX_SIZE     4
  20#define M5MOLS_BYTE_READ        0x01
  21#define M5MOLS_BYTE_WRITE       0x02
  22
  23#define I2C_CATEGORY(__cat)             ((__cat >> 16) & 0xff)
  24#define I2C_COMMAND(__comm)             ((__comm >> 8) & 0xff)
  25#define I2C_SIZE(__reg_s)               ((__reg_s) & 0xff)
  26#define I2C_REG(__cat, __cmd, __reg_s)  ((__cat << 16) | (__cmd << 8) | __reg_s)
  27
  28/*
  29 * Category section register
  30 *
  31 * The category means set including relevant command of M-5MOLS.
  32 */
  33#define CAT_SYSTEM              0x00
  34#define CAT_PARAM               0x01
  35#define CAT_MONITOR             0x02
  36#define CAT_AE                  0x03
  37#define CAT_WB                  0x06
  38#define CAT_EXIF                0x07
  39#define CAT_FD                  0x09
  40#define CAT_LENS                0x0a
  41#define CAT_CAPT_PARM           0x0b
  42#define CAT_CAPT_CTRL           0x0c
  43#define CAT_FLASH               0x0f    /* related to FW, revisions, booting */
  44
  45/*
  46 * Category 0 - SYSTEM mode
  47 *
  48 * The SYSTEM mode in the M-5MOLS means area available to handle with the whole
  49 * & all-round system of sensor. It deals with version/interrupt/setting mode &
  50 * even sensor's status. Especially, the M-5MOLS sensor with ISP varies by
  51 * packaging & manufacturer, even the customer and project code. And the
  52 * function details may vary among them. The version information helps to
  53 * determine what methods shall be used in the driver.
  54 *
  55 * There is many registers between customer version address and awb one. For
  56 * more specific contents, see definition if file m5mols.h.
  57 */
  58#define CAT0_VER_CUSTOMER       0x00    /* customer version */
  59#define CAT0_VER_PROJECT        0x01    /* project version */
  60#define CAT0_VER_FIRMWARE       0x02    /* Firmware version */
  61#define CAT0_VER_HARDWARE       0x04    /* Hardware version */
  62#define CAT0_VER_PARAMETER      0x06    /* Parameter version */
  63#define CAT0_VER_AWB            0x08    /* Auto WB version */
  64#define CAT0_VER_STRING         0x0a    /* string including M-5MOLS */
  65#define CAT0_SYSMODE            0x0b    /* SYSTEM mode register */
  66#define CAT0_STATUS             0x0c    /* SYSTEM mode status register */
  67#define CAT0_INT_FACTOR         0x10    /* interrupt pending register */
  68#define CAT0_INT_ENABLE         0x11    /* interrupt enable register */
  69
  70#define SYSTEM_VER_CUSTOMER     I2C_REG(CAT_SYSTEM, CAT0_VER_CUSTOMER, 1)
  71#define SYSTEM_VER_PROJECT      I2C_REG(CAT_SYSTEM, CAT0_VER_PROJECT, 1)
  72#define SYSTEM_VER_FIRMWARE     I2C_REG(CAT_SYSTEM, CAT0_VER_FIRMWARE, 2)
  73#define SYSTEM_VER_HARDWARE     I2C_REG(CAT_SYSTEM, CAT0_VER_HARDWARE, 2)
  74#define SYSTEM_VER_PARAMETER    I2C_REG(CAT_SYSTEM, CAT0_VER_PARAMETER, 2)
  75#define SYSTEM_VER_AWB          I2C_REG(CAT_SYSTEM, CAT0_VER_AWB, 2)
  76
  77#define SYSTEM_SYSMODE          I2C_REG(CAT_SYSTEM, CAT0_SYSMODE, 1)
  78#define REG_SYSINIT             0x00    /* SYSTEM mode */
  79#define REG_PARAMETER           0x01    /* PARAMETER mode */
  80#define REG_MONITOR             0x02    /* MONITOR mode */
  81#define REG_CAPTURE             0x03    /* CAPTURE mode */
  82
  83#define SYSTEM_CMD(__cmd)       I2C_REG(CAT_SYSTEM, cmd, 1)
  84#define SYSTEM_VER_STRING       I2C_REG(CAT_SYSTEM, CAT0_VER_STRING, 1)
  85#define REG_SAMSUNG_ELECTRO     "SE"    /* Samsung Electro-Mechanics */
  86#define REG_SAMSUNG_OPTICS      "OP"    /* Samsung Fiber-Optics */
  87#define REG_SAMSUNG_TECHWIN     "TB"    /* Samsung Techwin */
  88
  89#define SYSTEM_INT_FACTOR       I2C_REG(CAT_SYSTEM, CAT0_INT_FACTOR, 1)
  90#define SYSTEM_INT_ENABLE       I2C_REG(CAT_SYSTEM, CAT0_INT_ENABLE, 1)
  91#define REG_INT_MODE            (1 << 0)
  92#define REG_INT_AF              (1 << 1)
  93#define REG_INT_ZOOM            (1 << 2)
  94#define REG_INT_CAPTURE         (1 << 3)
  95#define REG_INT_FRAMESYNC       (1 << 4)
  96#define REG_INT_FD              (1 << 5)
  97#define REG_INT_LENS_INIT       (1 << 6)
  98#define REG_INT_SOUND           (1 << 7)
  99#define REG_INT_MASK            0x0f
 100
 101/*
 102 * category 1 - PARAMETER mode
 103 *
 104 * This category supports function of camera features of M-5MOLS. It means we
 105 * can handle with preview(MONITOR) resolution size/frame per second/interface
 106 * between the sensor and the Application Processor/even the image effect.
 107 */
 108#define CAT1_DATA_INTERFACE     0x00    /* interface between sensor and AP */
 109#define CAT1_MONITOR_SIZE       0x01    /* resolution at the MONITOR mode */
 110#define CAT1_MONITOR_FPS        0x02    /* frame per second at this mode */
 111#define CAT1_EFFECT             0x0b    /* image effects */
 112
 113#define PARM_MON_SIZE           I2C_REG(CAT_PARAM, CAT1_MONITOR_SIZE, 1)
 114
 115#define PARM_MON_FPS            I2C_REG(CAT_PARAM, CAT1_MONITOR_FPS, 1)
 116#define REG_FPS_30              0x02
 117
 118#define PARM_INTERFACE          I2C_REG(CAT_PARAM, CAT1_DATA_INTERFACE, 1)
 119#define REG_INTERFACE_MIPI      0x02
 120
 121#define PARM_EFFECT             I2C_REG(CAT_PARAM, CAT1_EFFECT, 1)
 122#define REG_EFFECT_OFF          0x00
 123#define REG_EFFECT_NEGA         0x01
 124#define REG_EFFECT_EMBOSS       0x06
 125#define REG_EFFECT_OUTLINE      0x07
 126#define REG_EFFECT_WATERCOLOR   0x08
 127
 128/*
 129 * Category 2 - MONITOR mode
 130 *
 131 * The MONITOR mode is same as preview mode as we said. The M-5MOLS has another
 132 * mode named "Preview", but this preview mode is used at the case specific
 133 * vider-recording mode. This mmode supports only YUYV format. On the other
 134 * hand, the JPEG & RAW formats is supports by CAPTURE mode. And, there are
 135 * another options like zoom/color effect(different with effect in PARAMETER
 136 * mode)/anti hand shaking algorithm.
 137 */
 138#define CAT2_ZOOM               0x01    /* set the zoom position & execute */
 139#define CAT2_ZOOM_STEP          0x03    /* set the zoom step */
 140#define CAT2_CFIXB              0x09    /* CB value for color effect */
 141#define CAT2_CFIXR              0x0a    /* CR value for color effect */
 142#define CAT2_COLOR_EFFECT       0x0b    /* set on/off of color effect */
 143#define CAT2_CHROMA_LVL         0x0f    /* set chroma level */
 144#define CAT2_CHROMA_EN          0x10    /* set on/off of choroma */
 145#define CAT2_EDGE_LVL           0x11    /* set sharpness level */
 146#define CAT2_EDGE_EN            0x12    /* set on/off sharpness */
 147#define CAT2_TONE_CTL           0x25    /* set tone color(contrast) */
 148
 149#define MON_ZOOM                I2C_REG(CAT_MONITOR, CAT2_ZOOM, 1)
 150
 151#define MON_CFIXR               I2C_REG(CAT_MONITOR, CAT2_CFIXR, 1)
 152#define MON_CFIXB               I2C_REG(CAT_MONITOR, CAT2_CFIXB, 1)
 153#define REG_CFIXB_SEPIA         0xd8
 154#define REG_CFIXR_SEPIA         0x18
 155
 156#define MON_EFFECT              I2C_REG(CAT_MONITOR, CAT2_COLOR_EFFECT, 1)
 157#define REG_COLOR_EFFECT_OFF    0x00
 158#define REG_COLOR_EFFECT_ON     0x01
 159
 160#define MON_CHROMA_EN           I2C_REG(CAT_MONITOR, CAT2_CHROMA_EN, 1)
 161#define MON_CHROMA_LVL          I2C_REG(CAT_MONITOR, CAT2_CHROMA_LVL, 1)
 162#define REG_CHROMA_OFF          0x00
 163#define REG_CHROMA_ON           0x01
 164
 165#define MON_EDGE_EN             I2C_REG(CAT_MONITOR, CAT2_EDGE_EN, 1)
 166#define MON_EDGE_LVL            I2C_REG(CAT_MONITOR, CAT2_EDGE_LVL, 1)
 167#define REG_EDGE_OFF            0x00
 168#define REG_EDGE_ON             0x01
 169
 170#define MON_TONE_CTL            I2C_REG(CAT_MONITOR, CAT2_TONE_CTL, 1)
 171
 172/*
 173 * Category 3 - Auto Exposure
 174 *
 175 * The M-5MOLS exposure capbility is detailed as which is similar to digital
 176 * camera. This category supports AE locking/various AE mode(range of exposure)
 177 * /ISO/flickering/EV bias/shutter/meteoring, and anything else. And the
 178 * maximum/minimum exposure gain value depending on M-5MOLS firmware, may be
 179 * different. So, this category also provide getting the max/min values. And,
 180 * each MONITOR and CAPTURE mode has each gain/shutter/max exposure values.
 181 */
 182#define CAT3_AE_LOCK            0x00    /* locking Auto exposure */
 183#define CAT3_AE_MODE            0x01    /* set AE mode, mode means range */
 184#define CAT3_ISO                0x05    /* set ISO */
 185#define CAT3_EV_PRESET_MONITOR  0x0a    /* EV(scenemode) preset for MONITOR */
 186#define CAT3_EV_PRESET_CAPTURE  0x0b    /* EV(scenemode) preset for CAPTURE */
 187#define CAT3_MANUAL_GAIN_MON    0x12    /* meteoring value for the MONITOR */
 188#define CAT3_MAX_GAIN_MON       0x1a    /* max gain value for the MONITOR */
 189#define CAT3_MANUAL_GAIN_CAP    0x26    /* meteoring value for the CAPTURE */
 190#define CAT3_AE_INDEX           0x38    /* AE index */
 191
 192#define AE_LOCK                 I2C_REG(CAT_AE, CAT3_AE_LOCK, 1)
 193#define REG_AE_UNLOCK           0x00
 194#define REG_AE_LOCK             0x01
 195
 196#define AE_MODE                 I2C_REG(CAT_AE, CAT3_AE_MODE, 1)
 197#define REG_AE_OFF              0x00    /* AE off */
 198#define REG_AE_ALL              0x01    /* calc AE in all block integral */
 199#define REG_AE_CENTER           0x03    /* calc AE in center weighted */
 200#define REG_AE_SPOT             0x06    /* calc AE in specific spot */
 201
 202#define AE_ISO                  I2C_REG(CAT_AE, CAT3_ISO, 1)
 203#define REG_ISO_AUTO            0x00
 204#define REG_ISO_50              0x01
 205#define REG_ISO_100             0x02
 206#define REG_ISO_200             0x03
 207#define REG_ISO_400             0x04
 208#define REG_ISO_800             0x05
 209
 210#define AE_EV_PRESET_MONITOR    I2C_REG(CAT_AE, CAT3_EV_PRESET_MONITOR, 1)
 211#define AE_EV_PRESET_CAPTURE    I2C_REG(CAT_AE, CAT3_EV_PRESET_CAPTURE, 1)
 212#define REG_SCENE_NORMAL        0x00
 213#define REG_SCENE_PORTRAIT      0x01
 214#define REG_SCENE_LANDSCAPE     0x02
 215#define REG_SCENE_SPORTS        0x03
 216#define REG_SCENE_PARTY_INDOOR  0x04
 217#define REG_SCENE_BEACH_SNOW    0x05
 218#define REG_SCENE_SUNSET        0x06
 219#define REG_SCENE_DAWN_DUSK     0x07
 220#define REG_SCENE_FALL          0x08
 221#define REG_SCENE_NIGHT         0x09
 222#define REG_SCENE_AGAINST_LIGHT 0x0a
 223#define REG_SCENE_FIRE          0x0b
 224#define REG_SCENE_TEXT          0x0c
 225#define REG_SCENE_CANDLE        0x0d
 226
 227#define AE_MAN_GAIN_MON         I2C_REG(CAT_AE, CAT3_MANUAL_GAIN_MON, 2)
 228#define AE_MAX_GAIN_MON         I2C_REG(CAT_AE, CAT3_MAX_GAIN_MON, 2)
 229#define AE_MAN_GAIN_CAP         I2C_REG(CAT_AE, CAT3_MANUAL_GAIN_CAP, 2)
 230
 231#define AE_INDEX                I2C_REG(CAT_AE, CAT3_AE_INDEX, 1)
 232#define REG_AE_INDEX_20_NEG     0x00
 233#define REG_AE_INDEX_15_NEG     0x01
 234#define REG_AE_INDEX_10_NEG     0x02
 235#define REG_AE_INDEX_05_NEG     0x03
 236#define REG_AE_INDEX_00         0x04
 237#define REG_AE_INDEX_05_POS     0x05
 238#define REG_AE_INDEX_10_POS     0x06
 239#define REG_AE_INDEX_15_POS     0x07
 240#define REG_AE_INDEX_20_POS     0x08
 241
 242/*
 243 * Category 6 - White Balance
 244 *
 245 * This category provide AWB locking/mode/preset/speed/gain bias, etc.
 246 */
 247#define CAT6_AWB_LOCK           0x00    /* locking Auto Whitebalance */
 248#define CAT6_AWB_MODE           0x02    /* set Auto or Manual */
 249#define CAT6_AWB_MANUAL         0x03    /* set Manual(preset) value */
 250
 251#define AWB_LOCK                I2C_REG(CAT_WB, CAT6_AWB_LOCK, 1)
 252#define REG_AWB_UNLOCK          0x00
 253#define REG_AWB_LOCK            0x01
 254
 255#define AWB_MODE                I2C_REG(CAT_WB, CAT6_AWB_MODE, 1)
 256#define REG_AWB_AUTO            0x01    /* AWB off */
 257#define REG_AWB_PRESET          0x02    /* AWB preset */
 258
 259#define AWB_MANUAL              I2C_REG(CAT_WB, CAT6_AWB_MANUAL, 1)
 260#define REG_AWB_INCANDESCENT    0x01
 261#define REG_AWB_FLUORESCENT_1   0x02
 262#define REG_AWB_FLUORESCENT_2   0x03
 263#define REG_AWB_DAYLIGHT        0x04
 264#define REG_AWB_CLOUDY          0x05
 265#define REG_AWB_SHADE           0x06
 266#define REG_AWB_HORIZON         0x07
 267#define REG_AWB_LEDLIGHT        0x09
 268
 269/*
 270 * Category 7 - EXIF information
 271 */
 272#define CAT7_INFO_EXPTIME_NU    0x00
 273#define CAT7_INFO_EXPTIME_DE    0x04
 274#define CAT7_INFO_TV_NU         0x08
 275#define CAT7_INFO_TV_DE         0x0c
 276#define CAT7_INFO_AV_NU         0x10
 277#define CAT7_INFO_AV_DE         0x14
 278#define CAT7_INFO_BV_NU         0x18
 279#define CAT7_INFO_BV_DE         0x1c
 280#define CAT7_INFO_EBV_NU        0x20
 281#define CAT7_INFO_EBV_DE        0x24
 282#define CAT7_INFO_ISO           0x28
 283#define CAT7_INFO_FLASH         0x2a
 284#define CAT7_INFO_SDR           0x2c
 285#define CAT7_INFO_QVAL          0x2e
 286
 287#define EXIF_INFO_EXPTIME_NU    I2C_REG(CAT_EXIF, CAT7_INFO_EXPTIME_NU, 4)
 288#define EXIF_INFO_EXPTIME_DE    I2C_REG(CAT_EXIF, CAT7_INFO_EXPTIME_DE, 4)
 289#define EXIF_INFO_TV_NU         I2C_REG(CAT_EXIF, CAT7_INFO_TV_NU, 4)
 290#define EXIF_INFO_TV_DE         I2C_REG(CAT_EXIF, CAT7_INFO_TV_DE, 4)
 291#define EXIF_INFO_AV_NU         I2C_REG(CAT_EXIF, CAT7_INFO_AV_NU, 4)
 292#define EXIF_INFO_AV_DE         I2C_REG(CAT_EXIF, CAT7_INFO_AV_DE, 4)
 293#define EXIF_INFO_BV_NU         I2C_REG(CAT_EXIF, CAT7_INFO_BV_NU, 4)
 294#define EXIF_INFO_BV_DE         I2C_REG(CAT_EXIF, CAT7_INFO_BV_DE, 4)
 295#define EXIF_INFO_EBV_NU        I2C_REG(CAT_EXIF, CAT7_INFO_EBV_NU, 4)
 296#define EXIF_INFO_EBV_DE        I2C_REG(CAT_EXIF, CAT7_INFO_EBV_DE, 4)
 297#define EXIF_INFO_ISO           I2C_REG(CAT_EXIF, CAT7_INFO_ISO, 2)
 298#define EXIF_INFO_FLASH         I2C_REG(CAT_EXIF, CAT7_INFO_FLASH, 2)
 299#define EXIF_INFO_SDR           I2C_REG(CAT_EXIF, CAT7_INFO_SDR, 2)
 300#define EXIF_INFO_QVAL          I2C_REG(CAT_EXIF, CAT7_INFO_QVAL, 2)
 301
 302/*
 303 * Category 9 - Face Detection
 304 */
 305#define CAT9_FD_CTL             0x00
 306
 307#define FD_CTL                  I2C_REG(CAT_FD, CAT9_FD_CTL, 1)
 308#define BIT_FD_EN               0
 309#define BIT_FD_DRAW_FACE_FRAME  4
 310#define BIT_FD_DRAW_SMILE_LVL   6
 311#define REG_FD(shift)           (1 << shift)
 312#define REG_FD_OFF              0x0
 313
 314/*
 315 * Category A - Lens Parameter
 316 */
 317#define CATA_AF_MODE            0x01
 318#define CATA_AF_EXECUTE         0x02
 319#define CATA_AF_STATUS          0x03
 320#define CATA_AF_VERSION         0x0a
 321
 322#define AF_MODE                 I2C_REG(CAT_LENS, CATA_AF_MODE, 1)
 323#define REG_AF_NORMAL           0x00    /* Normal AF, one time */
 324#define REG_AF_MACRO            0x01    /* Macro AF, one time */
 325#define REG_AF_POWEROFF         0x07
 326
 327#define AF_EXECUTE              I2C_REG(CAT_LENS, CATA_AF_EXECUTE, 1)
 328#define REG_AF_STOP             0x00
 329#define REG_AF_EXE_AUTO         0x01
 330#define REG_AF_EXE_CAF          0x02
 331
 332#define AF_STATUS               I2C_REG(CAT_LENS, CATA_AF_STATUS, 1)
 333#define REG_AF_FAIL             0x00
 334#define REG_AF_SUCCESS          0x02
 335#define REG_AF_IDLE             0x04
 336#define REG_AF_BUSY             0x05
 337
 338#define AF_VERSION              I2C_REG(CAT_LENS, CATA_AF_VERSION, 1)
 339
 340/*
 341 * Category B - CAPTURE Parameter
 342 */
 343#define CATB_YUVOUT_MAIN        0x00
 344#define CATB_MAIN_IMAGE_SIZE    0x01
 345#define CATB_MCC_MODE           0x1d
 346#define CATB_WDR_EN             0x2c
 347#define CATB_LIGHT_CTRL         0x40
 348#define CATB_FLASH_CTRL         0x41
 349
 350#define CAPP_YUVOUT_MAIN        I2C_REG(CAT_CAPT_PARM, CATB_YUVOUT_MAIN, 1)
 351#define REG_YUV422              0x00
 352#define REG_BAYER10             0x05
 353#define REG_BAYER8              0x06
 354#define REG_JPEG                0x10
 355
 356#define CAPP_MAIN_IMAGE_SIZE    I2C_REG(CAT_CAPT_PARM, CATB_MAIN_IMAGE_SIZE, 1)
 357
 358#define CAPP_MCC_MODE           I2C_REG(CAT_CAPT_PARM, CATB_MCC_MODE, 1)
 359#define REG_MCC_OFF             0x00
 360#define REG_MCC_NORMAL          0x01
 361
 362#define CAPP_WDR_EN             I2C_REG(CAT_CAPT_PARM, CATB_WDR_EN, 1)
 363#define REG_WDR_OFF             0x00
 364#define REG_WDR_ON              0x01
 365#define REG_WDR_AUTO            0x02
 366
 367#define CAPP_LIGHT_CTRL         I2C_REG(CAT_CAPT_PARM, CATB_LIGHT_CTRL, 1)
 368#define REG_LIGHT_OFF           0x00
 369#define REG_LIGHT_ON            0x01
 370#define REG_LIGHT_AUTO          0x02
 371
 372#define CAPP_FLASH_CTRL         I2C_REG(CAT_CAPT_PARM, CATB_FLASH_CTRL, 1)
 373#define REG_FLASH_OFF           0x00
 374#define REG_FLASH_ON            0x01
 375#define REG_FLASH_AUTO          0x02
 376
 377/*
 378 * Category C - CAPTURE Control
 379 */
 380#define CATC_CAP_MODE           0x00
 381#define CATC_CAP_SEL_FRAME      0x06    /* It determines Single or Multi */
 382#define CATC_CAP_START          0x09
 383#define CATC_CAP_IMAGE_SIZE     0x0d
 384#define CATC_CAP_THUMB_SIZE     0x11
 385
 386#define CAPC_MODE               I2C_REG(CAT_CAPT_CTRL, CATC_CAP_MODE, 1)
 387#define REG_CAP_NONE            0x00
 388#define REG_CAP_ANTI_SHAKE      0x02
 389
 390#define CAPC_SEL_FRAME          I2C_REG(CAT_CAPT_CTRL, CATC_CAP_SEL_FRAME, 1)
 391
 392#define CAPC_START              I2C_REG(CAT_CAPT_CTRL, CATC_CAP_START, 1)
 393#define REG_CAP_START_MAIN      0x01
 394#define REG_CAP_START_THUMB     0x03
 395
 396#define CAPC_IMAGE_SIZE         I2C_REG(CAT_CAPT_CTRL, CATC_CAP_IMAGE_SIZE, 4)
 397#define CAPC_THUMB_SIZE         I2C_REG(CAT_CAPT_CTRL, CATC_CAP_THUMB_SIZE, 4)
 398
 399/*
 400 * Category F - Flash
 401 *
 402 * This mode provides functions about internal flash stuff and system startup.
 403 */
 404#define CATF_CAM_START          0x12    /* It starts internal ARM core booting
 405                                         * after power-up */
 406
 407#define FLASH_CAM_START         I2C_REG(CAT_FLASH, CATF_CAM_START, 1)
 408#define REG_START_ARM_BOOT      0x01
 409
 410#endif  /* M5MOLS_REG_H */
 411