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