drivers/media/usb/gspca/m5602/m5602_mt9m111.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Driver for the mt9m111 sensor
   4  *
   5  * Copyright (C) 2008 Erik Andrén
   6  * Copyright (C) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project.
   7  * Copyright (C) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br>
   8  *
   9  * Portions of code to USB interface and ALi driver software,
  10  * Copyright (c) 2006 Willem Duinker
  11  * v4l2 interface modeled after the V4L2 driver
  12  * for SN9C10x PC Camera Controllers
  13  *
  14  * Some defines taken from the mt9m111 sensor driver
  15  * Copyright (C) 2008, Robert Jarzmik <robert.jarzmik@free.fr>
  16  */
  17
  18 #ifndef M5602_MT9M111_H_
  19 #define M5602_MT9M111_H_
  20
  21 #include "m5602_sensor.h"
  22
  23 /*****************************************************************************/
  24
  25 #define MT9M111_SC_CHIPVER                      0x00
  26 #define MT9M111_SC_ROWSTART                     0x01
  27 #define MT9M111_SC_COLSTART                     0x02
  28 #define MT9M111_SC_WINDOW_HEIGHT                0x03
  29 #define MT9M111_SC_WINDOW_WIDTH                 0x04
  30 #define MT9M111_SC_HBLANK_CONTEXT_B             0x05
  31 #define MT9M111_SC_VBLANK_CONTEXT_B             0x06
  32 #define MT9M111_SC_HBLANK_CONTEXT_A             0x07
  33 #define MT9M111_SC_VBLANK_CONTEXT_A             0x08
  34 #define MT9M111_SC_SHUTTER_WIDTH                0x09
  35 #define MT9M111_SC_ROW_SPEED                    0x0a
  36 #define MT9M111_SC_EXTRA_DELAY                  0x0b
  37 #define MT9M111_SC_SHUTTER_DELAY                0x0c
  38 #define MT9M111_SC_RESET                        0x0d
  39 #define MT9M111_SC_R_MODE_CONTEXT_B             0x20
  40 #define MT9M111_SC_R_MODE_CONTEXT_A             0x21
  41 #define MT9M111_SC_FLASH_CONTROL                0x23
  42 #define MT9M111_SC_GREEN_1_GAIN                 0x2b
  43 #define MT9M111_SC_BLUE_GAIN                    0x2c
  44 #define MT9M111_SC_RED_GAIN                     0x2d
  45 #define MT9M111_SC_GREEN_2_GAIN                 0x2e
  46 #define MT9M111_SC_GLOBAL_GAIN                  0x2f
  47
  48 #define MT9M111_CONTEXT_CONTROL                 0xc8
  49 #define MT9M111_PAGE_MAP                        0xf0
  50 #define MT9M111_BYTEWISE_ADDRESS                0xf1
  51
  52 #define MT9M111_CP_OPERATING_MODE_CTL           0x06
  53 #define MT9M111_CP_LUMA_OFFSET                  0x34
  54 #define MT9M111_CP_LUMA_CLIP                    0x35
  55 #define MT9M111_CP_OUTPUT_FORMAT_CTL2_CONTEXT_A 0x3a
  56 #define MT9M111_CP_LENS_CORRECTION_1            0x3b
  57 #define MT9M111_CP_DEFECT_CORR_CONTEXT_A        0x4c
  58 #define MT9M111_CP_DEFECT_CORR_CONTEXT_B        0x4d
  59 #define MT9M111_CP_OUTPUT_FORMAT_CTL2_CONTEXT_B 0x9b
  60 #define MT9M111_CP_GLOBAL_CLK_CONTROL           0xb3
  61
  62 #define MT9M111_CC_AUTO_EXPOSURE_PARAMETER_18   0x65
  63 #define MT9M111_CC_AWB_PARAMETER_7              0x28
  64
  65 #define MT9M111_SENSOR_CORE                     0x00
  66 #define MT9M111_COLORPIPE                       0x01
  67 #define MT9M111_CAMERA_CONTROL                  0x02
  68
  69 #define MT9M111_RESET                           (1 << 0)
  70 #define MT9M111_RESTART                         (1 << 1)
  71 #define MT9M111_ANALOG_STANDBY                  (1 << 2)
  72 #define MT9M111_CHIP_ENABLE                     (1 << 3)
  73 #define MT9M111_CHIP_DISABLE                    (0 << 3)
  74 #define MT9M111_OUTPUT_DISABLE                  (1 << 4)
  75 #define MT9M111_SHOW_BAD_FRAMES                 (1 << 0)
  76 #define MT9M111_RESTART_BAD_FRAMES              (1 << 1)
  77 #define MT9M111_SYNCHRONIZE_CHANGES             (1 << 7)
  78
  79 #define MT9M111_RMB_OVER_SIZED                  (1 << 0)
  80 #define MT9M111_RMB_MIRROR_ROWS                 (1 << 0)
  81 #define MT9M111_RMB_MIRROR_COLS                 (1 << 1)
  82 #define MT9M111_RMB_ROW_SKIP_2X                 (1 << 2)
  83 #define MT9M111_RMB_COLUMN_SKIP_2X              (1 << 3)
  84 #define MT9M111_RMB_ROW_SKIP_4X                 (1 << 4)
  85 #define MT9M111_RMB_COLUMN_SKIP_4X              (1 << 5)
  86
  87 #define MT9M111_COLOR_MATRIX_BYPASS             (1 << 4)
  88 #define MT9M111_SEL_CONTEXT_B                   (1 << 3)
  89
  90 #define MT9M111_TRISTATE_PIN_IN_STANDBY         (1 << 1)
  91 #define MT9M111_SOC_SOFT_STANDBY                (1 << 0)
  92
  93 #define MT9M111_2D_DEFECT_CORRECTION_ENABLE     (1 << 0)
  94
  95 #define INITIAL_MAX_GAIN                        64
  96 #define MT9M111_DEFAULT_GAIN                    283
  97 #define MT9M111_GREEN_GAIN_DEFAULT              0x20
  98 #define MT9M111_BLUE_GAIN_DEFAULT               0x20
  99 #define MT9M111_RED_GAIN_DEFAULT                0x20
 100
 101 /*****************************************************************************/
 102
 103 /* Kernel module parameters */
 104 extern int force_sensor;
 105 extern bool dump_sensor;
 106
 107 int mt9m111_probe(struct sd *sd);
 108 int mt9m111_init(struct sd *sd);
 109 int mt9m111_init_controls(struct sd *sd);
 110 int mt9m111_start(struct sd *sd);
 111 void mt9m111_disconnect(struct sd *sd);
 112
 113 static const struct m5602_sensor mt9m111 = {
 114         .name = "MT9M111",
 115
 116         .i2c_slave_id = 0xba,
 117         .i2c_regW = 2,
 118
 119         .probe = mt9m111_probe,
 120         .init = mt9m111_init,
 121         .init_controls = mt9m111_init_controls,
 122         .disconnect = mt9m111_disconnect,
 123         .start = mt9m111_start,
 124 };
 125 #endif