1 /*
2  * drivers/media/video/tcm825x.h
3  *
4  * Register definitions for the TCM825X CameraChip.
5  *
6  * Author: David Cohen (david.cohen@indt.org.br)
7  *
8  * This file is licensed under the terms of the GNU General Public License
9  * version 2. This program is licensed "as is" without any warranty of any
10  * kind, whether express or implied.
11  *
12  * This file was based on ov9640.h from MontaVista
13  */
14 
15 #ifndef TCM825X_H
16 #define TCM825X_H
17 
18 #include <linux/videodev2.h>
19 
20 #include <media/v4l2-int-device.h>
21 
22 #define TCM825X_NAME "tcm825x"
23 
24 #define TCM825X_MASK(x)  x & 0x00ff
25 #define TCM825X_ADDR(x) (x & 0xff00) >> 8
26 
27 /* The TCM825X I2C sensor chip has a fixed slave address of 0x3d. */
28 #define TCM825X_I2C_ADDR	0x3d
29 
30 /*
31  * define register offsets for the TCM825X sensor chip
32  * OFFSET(8 bits) + MASK(8 bits)
33  * MASK bit 4 and 3 are used when the register uses more than one address
34  */
35 #define TCM825X_FPS		0x0280
36 #define TCM825X_ACF		0x0240
37 #define TCM825X_DOUTBUF		0x020C
38 #define TCM825X_DCLKP		0x0202
39 #define TCM825X_ACFDET		0x0201
40 #define TCM825X_DOUTSW		0x0380
41 #define TCM825X_DATAHZ		0x0340
42 #define TCM825X_PICSIZ		0x033c
43 #define TCM825X_PICFMT		0x0302
44 #define TCM825X_V_INV		0x0480
45 #define TCM825X_H_INV		0x0440
46 #define TCM825X_ESRLSW		0x0430
47 #define TCM825X_V_LENGTH	0x040F
48 #define TCM825X_ALCSW		0x0580
49 #define TCM825X_ESRLIM		0x0560
50 #define TCM825X_ESRSPD_U        0x051F
51 #define TCM825X_ESRSPD_L        0x06FF
52 #define TCM825X_AG		0x07FF
53 #define TCM825X_ESRSPD2         0x06FF
54 #define TCM825X_ALCMODE         0x0830
55 #define TCM825X_ALCH            0x080F
56 #define TCM825X_ALCL            0x09FF
57 #define TCM825X_AWBSW           0x0A80
58 #define TCM825X_MRG             0x0BFF
59 #define TCM825X_MBG             0x0CFF
60 #define TCM825X_GAMSW           0x0D80
61 #define TCM825X_HDTG            0x0EFF
62 #define TCM825X_VDTG            0x0FFF
63 #define TCM825X_HDTCORE         0x10F0
64 #define TCM825X_VDTCORE         0x100F
65 #define TCM825X_CONT            0x11FF
66 #define TCM825X_BRIGHT          0x12FF
67 #define TCM825X_VHUE            0x137F
68 #define TCM825X_UHUE            0x147F
69 #define TCM825X_VGAIN           0x153F
70 #define TCM825X_UGAIN           0x163F
71 #define TCM825X_UVCORE          0x170F
72 #define TCM825X_SATU            0x187F
73 #define TCM825X_MHMODE          0x1980
74 #define TCM825X_MHLPFSEL        0x1940
75 #define TCM825X_YMODE           0x1930
76 #define TCM825X_MIXHG           0x1907
77 #define TCM825X_LENS            0x1A3F
78 #define TCM825X_AGLIM           0x1BE0
79 #define TCM825X_LENSRPOL        0x1B10
80 #define TCM825X_LENSRGAIN       0x1B0F
81 #define TCM825X_ES100S          0x1CFF
82 #define TCM825X_ES120S          0x1DFF
83 #define TCM825X_DMASK           0x1EC0
84 #define TCM825X_CODESW          0x1E20
85 #define TCM825X_CODESEL         0x1E10
86 #define TCM825X_TESPIC          0x1E04
87 #define TCM825X_PICSEL          0x1E03
88 #define TCM825X_HNUM            0x20FF
89 #define TCM825X_VOUTPH          0x287F
90 #define TCM825X_ESROUT          0x327F
91 #define TCM825X_ESROUT2         0x33FF
92 #define TCM825X_AGOUT           0x34FF
93 #define TCM825X_DGOUT           0x353F
94 #define TCM825X_AGSLOW1         0x39C0
95 #define TCM825X_FLLSMODE        0x3930
96 #define TCM825X_FLLSLIM         0x390F
97 #define TCM825X_DETSEL          0x3AF0
98 #define TCM825X_ACDETNC         0x3A0F
99 #define TCM825X_AGSLOW2         0x3BC0
100 #define TCM825X_DG              0x3B3F
101 #define TCM825X_REJHLEV         0x3CFF
102 #define TCM825X_ALCLOCK         0x3D80
103 #define TCM825X_FPSLNKSW        0x3D40
104 #define TCM825X_ALCSPD          0x3D30
105 #define TCM825X_REJH            0x3D03
106 #define TCM825X_SHESRSW         0x3E80
107 #define TCM825X_ESLIMSEL        0x3E40
108 #define TCM825X_SHESRSPD        0x3E30
109 #define TCM825X_ELSTEP          0x3E0C
110 #define TCM825X_ELSTART         0x3E03
111 #define TCM825X_AGMIN           0x3FFF
112 #define TCM825X_PREGRG          0x423F
113 #define TCM825X_PREGBG          0x433F
114 #define TCM825X_PRERG           0x443F
115 #define TCM825X_PREBG           0x453F
116 #define TCM825X_MSKBR           0x477F
117 #define TCM825X_MSKGR           0x487F
118 #define TCM825X_MSKRB           0x497F
119 #define TCM825X_MSKGB           0x4A7F
120 #define TCM825X_MSKRG           0x4B7F
121 #define TCM825X_MSKBG           0x4C7F
122 #define TCM825X_HDTCSW          0x4D80
123 #define TCM825X_VDTCSW          0x4D40
124 #define TCM825X_DTCYL           0x4D3F
125 #define TCM825X_HDTPSW          0x4E80
126 #define TCM825X_VDTPSW          0x4E40
127 #define TCM825X_DTCGAIN         0x4E3F
128 #define TCM825X_DTLLIMSW        0x4F10
129 #define TCM825X_DTLYLIM         0x4F0F
130 #define TCM825X_YLCUTLMSK       0x5080
131 #define TCM825X_YLCUTL          0x503F
132 #define TCM825X_YLCUTHMSK       0x5180
133 #define TCM825X_YLCUTH          0x513F
134 #define TCM825X_UVSKNC          0x527F
135 #define TCM825X_UVLJ            0x537F
136 #define TCM825X_WBGMIN          0x54FF
137 #define TCM825X_WBGMAX          0x55FF
138 #define TCM825X_WBSPDUP         0x5603
139 #define TCM825X_ALLAREA         0x5820
140 #define TCM825X_WBLOCK          0x5810
141 #define TCM825X_WB2SP           0x580F
142 #define TCM825X_KIZUSW          0x5920
143 #define TCM825X_PBRSW           0x5910
144 #define TCM825X_ABCSW           0x5903
145 #define TCM825X_PBDLV           0x5AFF
146 #define TCM825X_PBC1LV          0x5BFF
147 
148 #define TCM825X_NUM_REGS	(TCM825X_ADDR(TCM825X_PBC1LV) + 1)
149 
150 #define TCM825X_BYTES_PER_PIXEL 2
151 
152 #define TCM825X_REG_TERM 0xff		/* terminating list entry for reg */
153 #define TCM825X_VAL_TERM 0xff		/* terminating list entry for val */
154 
155 /* define a structure for tcm825x register initialization values */
156 struct tcm825x_reg {
157 	u8 val;
158 	u16 reg;
159 };
160 
161 enum image_size { subQCIF = 0, QQVGA, QCIF, QVGA, CIF, VGA };
162 enum pixel_format { YUV422 = 0, RGB565 };
163 #define NUM_IMAGE_SIZES 6
164 #define NUM_PIXEL_FORMATS 2
165 
166 #define TCM825X_XCLK_MIN	11900000
167 #define TCM825X_XCLK_MAX	25000000
168 
169 struct capture_size {
170 	unsigned long width;
171 	unsigned long height;
172 };
173 
174 struct tcm825x_platform_data {
175 	/* Is the sensor usable? Doesn't yet mean it's there, but you
176 	 * can try! */
177 	int (*is_okay)(void);
178 	/* Set power state, zero is off, non-zero is on. */
179 	int (*power_set)(int power);
180 	/* Default registers written after power-on or reset. */
181 	const struct tcm825x_reg *(*default_regs)(void);
182 	int (*needs_reset)(struct v4l2_int_device *s, void *buf,
183 			   struct v4l2_pix_format *fmt);
184 	int (*ifparm)(struct v4l2_ifparm *p);
185 	int (*is_upside_down)(void);
186 };
187 
188 /* Array of image sizes supported by TCM825X.  These must be ordered from
189  * smallest image size to largest.
190  */
191 static const struct capture_size tcm825x_sizes[] = {
192 	{ 128,  96 }, /* subQCIF */
193 	{ 160, 120 }, /* QQVGA */
194 	{ 176, 144 }, /* QCIF */
195 	{ 320, 240 }, /* QVGA */
196 	{ 352, 288 }, /* CIF */
197 	{ 640, 480 }, /* VGA */
198 };
199 
200 #endif /* ifndef TCM825X_H */
201