xref: /linux/drivers/media/usb/gspca/zc3xx-reg.h (revision da1d9caf95def6f0320819cf941c9fd1069ba9e1)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * zc030x registers
4  *
5  * Copyright (c) 2008 Mauro Carvalho Chehab <mchehab@kernel.org>
6  *
7  * The register aliases used here came from this driver:
8  *	http://zc0302.sourceforge.net/zc0302.php
9  */
10 
11 /* Define the register map */
12 #define ZC3XX_R000_SYSTEMCONTROL       0x0000
13 #define ZC3XX_R001_SYSTEMOPERATING     0x0001
14 
15 /* Picture size */
16 #define ZC3XX_R002_CLOCKSELECT         0x0002
17 #define ZC3XX_R003_FRAMEWIDTHHIGH      0x0003
18 #define ZC3XX_R004_FRAMEWIDTHLOW       0x0004
19 #define ZC3XX_R005_FRAMEHEIGHTHIGH     0x0005
20 #define ZC3XX_R006_FRAMEHEIGHTLOW      0x0006
21 
22 /* JPEG control */
23 #define ZC3XX_R008_CLOCKSETTING        0x0008
24 
25 /* Test mode */
26 #define ZC3XX_R00B_TESTMODECONTROL     0x000b
27 
28 /* Frame retrieving */
29 #define ZC3XX_R00C_LASTACQTIME         0x000c
30 #define ZC3XX_R00D_MONITORRES          0x000d
31 #define ZC3XX_R00E_TIMESTAMPHIGH       0x000e
32 #define ZC3XX_R00F_TIMESTAMPLOW        0x000f
33 #define ZC3XX_R018_FRAMELOST           0x0018
34 #define ZC3XX_R019_AUTOADJUSTFPS       0x0019
35 #define ZC3XX_R01A_LASTFRAMESTATE      0x001a
36 #define ZC3XX_R025_DATACOUNTER         0x0025
37 
38 /* Stream and sensor specific */
39 #define ZC3XX_R010_CMOSSENSORSELECT    0x0010
40 #define ZC3XX_R011_VIDEOSTATUS         0x0011
41 #define ZC3XX_R012_VIDEOCONTROLFUNC    0x0012
42 
43 /* Horizontal and vertical synchros */
44 #define ZC3XX_R01D_HSYNC_0             0x001d
45 #define ZC3XX_R01E_HSYNC_1             0x001e
46 #define ZC3XX_R01F_HSYNC_2             0x001f
47 #define ZC3XX_R020_HSYNC_3             0x0020
48 
49 /* Target picture size in byte */
50 #define ZC3XX_R022_TARGETPICTSIZE_0    0x0022
51 #define ZC3XX_R023_TARGETPICTSIZE_1    0x0023
52 #define ZC3XX_R024_TARGETPICTSIZE_2    0x0024
53 
54 /* Audio registers */
55 #define ZC3XX_R030_AUDIOADC            0x0030
56 #define ZC3XX_R031_AUDIOSTREAMSTATUS   0x0031
57 #define ZC3XX_R032_AUDIOSTATUS         0x0032
58 
59 /* Sensor interface */
60 #define ZC3XX_R080_HBLANKHIGH          0x0080
61 #define ZC3XX_R081_HBLANKLOW           0x0081
62 #define ZC3XX_R082_RESETLEVELADDR      0x0082
63 #define ZC3XX_R083_RGAINADDR           0x0083
64 #define ZC3XX_R084_GGAINADDR           0x0084
65 #define ZC3XX_R085_BGAINADDR           0x0085
66 #define ZC3XX_R086_EXPTIMEHIGH         0x0086
67 #define ZC3XX_R087_EXPTIMEMID          0x0087
68 #define ZC3XX_R088_EXPTIMELOW          0x0088
69 #define ZC3XX_R089_RESETBLACKHIGH      0x0089
70 #define ZC3XX_R08A_RESETWHITEHIGH      0x008a
71 #define ZC3XX_R08B_I2CDEVICEADDR       0x008b
72 #define ZC3XX_R08C_I2CIDLEANDNACK      0x008c
73 #define ZC3XX_R08D_COMPABILITYMODE     0x008d
74 #define ZC3XX_R08E_COMPABILITYMODE2    0x008e
75 
76 /* I2C control */
77 #define ZC3XX_R090_I2CCOMMAND          0x0090
78 #define ZC3XX_R091_I2CSTATUS           0x0091
79 #define ZC3XX_R092_I2CADDRESSSELECT    0x0092
80 #define ZC3XX_R093_I2CSETVALUE         0x0093
81 #define ZC3XX_R094_I2CWRITEACK         0x0094
82 #define ZC3XX_R095_I2CREAD             0x0095
83 #define ZC3XX_R096_I2CREADACK          0x0096
84 
85 /* Window inside the sensor array */
86 #define ZC3XX_R097_WINYSTARTHIGH       0x0097
87 #define ZC3XX_R098_WINYSTARTLOW        0x0098
88 #define ZC3XX_R099_WINXSTARTHIGH       0x0099
89 #define ZC3XX_R09A_WINXSTARTLOW        0x009a
90 #define ZC3XX_R09B_WINHEIGHTHIGH       0x009b
91 #define ZC3XX_R09C_WINHEIGHTLOW        0x009c
92 #define ZC3XX_R09D_WINWIDTHHIGH        0x009d
93 #define ZC3XX_R09E_WINWIDTHLOW         0x009e
94 #define ZC3XX_R119_FIRSTYHIGH          0x0119
95 #define ZC3XX_R11A_FIRSTYLOW           0x011a
96 #define ZC3XX_R11B_FIRSTXHIGH          0x011b
97 #define ZC3XX_R11C_FIRSTXLOW           0x011c
98 
99 /* Max sensor array size */
100 #define ZC3XX_R09F_MAXXHIGH            0x009f
101 #define ZC3XX_R0A0_MAXXLOW             0x00a0
102 #define ZC3XX_R0A1_MAXYHIGH            0x00a1
103 #define ZC3XX_R0A2_MAXYLOW             0x00a2
104 #define ZC3XX_R0A3_EXPOSURETIMEHIGH    0x00a3
105 #define ZC3XX_R0A4_EXPOSURETIMELOW     0x00a4
106 #define ZC3XX_R0A5_EXPOSUREGAIN        0x00a5
107 #define ZC3XX_R0A6_EXPOSUREBLACKLVL    0x00a6
108 
109 /* Other registers */
110 #define ZC3XX_R100_OPERATIONMODE       0x0100
111 #define ZC3XX_R101_SENSORCORRECTION    0x0101
112 
113 /* Gains */
114 #define ZC3XX_R116_RGAIN               0x0116
115 #define ZC3XX_R117_GGAIN               0x0117
116 #define ZC3XX_R118_BGAIN               0x0118
117 #define ZC3XX_R11D_GLOBALGAIN          0x011d
118 #define ZC3XX_R1A8_DIGITALGAIN         0x01a8
119 #define ZC3XX_R1A9_DIGITALLIMITDIFF    0x01a9
120 #define ZC3XX_R1AA_DIGITALGAINSTEP     0x01aa
121 
122 /* Auto correction */
123 #define ZC3XX_R180_AUTOCORRECTENABLE   0x0180
124 #define ZC3XX_R181_WINXSTART           0x0181
125 #define ZC3XX_R182_WINXWIDTH           0x0182
126 #define ZC3XX_R183_WINXCENTER          0x0183
127 #define ZC3XX_R184_WINYSTART           0x0184
128 #define ZC3XX_R185_WINYWIDTH           0x0185
129 #define ZC3XX_R186_WINYCENTER          0x0186
130 
131 /* Gain range */
132 #define ZC3XX_R187_MAXGAIN             0x0187
133 #define ZC3XX_R188_MINGAIN             0x0188
134 
135 /* Auto exposure and white balance */
136 #define ZC3XX_R189_AWBSTATUS           0x0189
137 #define ZC3XX_R18A_AWBFREEZE           0x018a
138 #define ZC3XX_R18B_AESTATUS            0x018b
139 #define ZC3XX_R18C_AEFREEZE            0x018c
140 #define ZC3XX_R18F_AEUNFREEZE          0x018f
141 #define ZC3XX_R190_EXPOSURELIMITHIGH   0x0190
142 #define ZC3XX_R191_EXPOSURELIMITMID    0x0191
143 #define ZC3XX_R192_EXPOSURELIMITLOW    0x0192
144 #define ZC3XX_R195_ANTIFLICKERHIGH     0x0195
145 #define ZC3XX_R196_ANTIFLICKERMID      0x0196
146 #define ZC3XX_R197_ANTIFLICKERLOW      0x0197
147 
148 /* What is this ? */
149 #define ZC3XX_R18D_YTARGET             0x018d
150 #define ZC3XX_R18E_RESETLVL            0x018e
151 
152 /* Color */
153 #define ZC3XX_R1A0_REDMEANAFTERAGC     0x01a0
154 #define ZC3XX_R1A1_GREENMEANAFTERAGC   0x01a1
155 #define ZC3XX_R1A2_BLUEMEANAFTERAGC    0x01a2
156 #define ZC3XX_R1A3_REDMEANAFTERAWB     0x01a3
157 #define ZC3XX_R1A4_GREENMEANAFTERAWB   0x01a4
158 #define ZC3XX_R1A5_BLUEMEANAFTERAWB    0x01a5
159 #define ZC3XX_R1A6_YMEANAFTERAE        0x01a6
160 #define ZC3XX_R1A7_CALCGLOBALMEAN      0x01a7
161 
162 /* Matrixes */
163 
164 /* Color matrix is like :
165    R' = R * RGB00 + G * RGB01 + B * RGB02 + RGB03
166    G' = R * RGB10 + G * RGB11 + B * RGB22 + RGB13
167    B' = R * RGB20 + G * RGB21 + B * RGB12 + RGB23
168  */
169 #define ZC3XX_R10A_RGB00               0x010a
170 #define ZC3XX_R10B_RGB01               0x010b
171 #define ZC3XX_R10C_RGB02               0x010c
172 #define ZC3XX_R113_RGB03               0x0113
173 #define ZC3XX_R10D_RGB10               0x010d
174 #define ZC3XX_R10E_RGB11               0x010e
175 #define ZC3XX_R10F_RGB12               0x010f
176 #define ZC3XX_R114_RGB13               0x0114
177 #define ZC3XX_R110_RGB20               0x0110
178 #define ZC3XX_R111_RGB21               0x0111
179 #define ZC3XX_R112_RGB22               0x0112
180 #define ZC3XX_R115_RGB23               0x0115
181 
182 /* Gamma matrix */
183 #define ZC3XX_R120_GAMMA00             0x0120
184 #define ZC3XX_R121_GAMMA01             0x0121
185 #define ZC3XX_R122_GAMMA02             0x0122
186 #define ZC3XX_R123_GAMMA03             0x0123
187 #define ZC3XX_R124_GAMMA04             0x0124
188 #define ZC3XX_R125_GAMMA05             0x0125
189 #define ZC3XX_R126_GAMMA06             0x0126
190 #define ZC3XX_R127_GAMMA07             0x0127
191 #define ZC3XX_R128_GAMMA08             0x0128
192 #define ZC3XX_R129_GAMMA09             0x0129
193 #define ZC3XX_R12A_GAMMA0A             0x012a
194 #define ZC3XX_R12B_GAMMA0B             0x012b
195 #define ZC3XX_R12C_GAMMA0C             0x012c
196 #define ZC3XX_R12D_GAMMA0D             0x012d
197 #define ZC3XX_R12E_GAMMA0E             0x012e
198 #define ZC3XX_R12F_GAMMA0F             0x012f
199 #define ZC3XX_R130_GAMMA10             0x0130
200 #define ZC3XX_R131_GAMMA11             0x0131
201 #define ZC3XX_R132_GAMMA12             0x0132
202 #define ZC3XX_R133_GAMMA13             0x0133
203 #define ZC3XX_R134_GAMMA14             0x0134
204 #define ZC3XX_R135_GAMMA15             0x0135
205 #define ZC3XX_R136_GAMMA16             0x0136
206 #define ZC3XX_R137_GAMMA17             0x0137
207 #define ZC3XX_R138_GAMMA18             0x0138
208 #define ZC3XX_R139_GAMMA19             0x0139
209 #define ZC3XX_R13A_GAMMA1A             0x013a
210 #define ZC3XX_R13B_GAMMA1B             0x013b
211 #define ZC3XX_R13C_GAMMA1C             0x013c
212 #define ZC3XX_R13D_GAMMA1D             0x013d
213 #define ZC3XX_R13E_GAMMA1E             0x013e
214 #define ZC3XX_R13F_GAMMA1F             0x013f
215 
216 /* Luminance gamma */
217 #define ZC3XX_R140_YGAMMA00            0x0140
218 #define ZC3XX_R141_YGAMMA01            0x0141
219 #define ZC3XX_R142_YGAMMA02            0x0142
220 #define ZC3XX_R143_YGAMMA03            0x0143
221 #define ZC3XX_R144_YGAMMA04            0x0144
222 #define ZC3XX_R145_YGAMMA05            0x0145
223 #define ZC3XX_R146_YGAMMA06            0x0146
224 #define ZC3XX_R147_YGAMMA07            0x0147
225 #define ZC3XX_R148_YGAMMA08            0x0148
226 #define ZC3XX_R149_YGAMMA09            0x0149
227 #define ZC3XX_R14A_YGAMMA0A            0x014a
228 #define ZC3XX_R14B_YGAMMA0B            0x014b
229 #define ZC3XX_R14C_YGAMMA0C            0x014c
230 #define ZC3XX_R14D_YGAMMA0D            0x014d
231 #define ZC3XX_R14E_YGAMMA0E            0x014e
232 #define ZC3XX_R14F_YGAMMA0F            0x014f
233 #define ZC3XX_R150_YGAMMA10            0x0150
234 #define ZC3XX_R151_YGAMMA11            0x0151
235 
236 #define ZC3XX_R1C5_SHARPNESSMODE       0x01c5
237 #define ZC3XX_R1C6_SHARPNESS00         0x01c6
238 #define ZC3XX_R1C7_SHARPNESS01         0x01c7
239 #define ZC3XX_R1C8_SHARPNESS02         0x01c8
240 #define ZC3XX_R1C9_SHARPNESS03         0x01c9
241 #define ZC3XX_R1CA_SHARPNESS04         0x01ca
242 #define ZC3XX_R1CB_SHARPNESS05         0x01cb
243 
244 /* Dead pixels */
245 #define ZC3XX_R250_DEADPIXELSMODE      0x0250
246 
247 /* EEPROM */
248 #define ZC3XX_R300_EEPROMCONFIG        0x0300
249 #define ZC3XX_R301_EEPROMACCESS        0x0301
250 #define ZC3XX_R302_EEPROMSTATUS        0x0302
251