xref: /linux/drivers/media/usb/gspca/m5602/m5602_mt9m111.h (revision 48dea9a700c8728cc31a1dd44588b97578de86ee)
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
126