]>
Commit | Line | Data |
---|---|---|
2874c5fd | 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
bc125106 HK |
2 | /* |
3 | * Register map for M-5MOLS 8M Pixel camera sensor with ISP | |
4 | * | |
5 | * Copyright (C) 2011 Samsung Electronics Co., Ltd. | |
c3070113 | 6 | * Author: HeungJun Kim <riverful.kim@samsung.com> |
bc125106 HK |
7 | * |
8 | * Copyright (C) 2009 Samsung Electronics Co., Ltd. | |
c3070113 | 9 | * Author: Dongsoo Nathaniel Kim <dongsoo45.kim@samsung.com> |
bc125106 HK |
10 | */ |
11 | ||
12 | #ifndef M5MOLS_REG_H | |
13 | #define M5MOLS_REG_H | |
14 | ||
15 | #define M5MOLS_I2C_MAX_SIZE 4 | |
16 | #define M5MOLS_BYTE_READ 0x01 | |
17 | #define M5MOLS_BYTE_WRITE 0x02 | |
18 | ||
19 | #define I2C_CATEGORY(__cat) ((__cat >> 16) & 0xff) | |
20 | #define I2C_COMMAND(__comm) ((__comm >> 8) & 0xff) | |
21 | #define I2C_SIZE(__reg_s) ((__reg_s) & 0xff) | |
22 | #define I2C_REG(__cat, __cmd, __reg_s) ((__cat << 16) | (__cmd << 8) | __reg_s) | |
23 | ||
24 | /* | |
25 | * Category section register | |
26 | * | |
27 | * The category means set including relevant command of M-5MOLS. | |
28 | */ | |
29 | #define CAT_SYSTEM 0x00 | |
30 | #define CAT_PARAM 0x01 | |
31 | #define CAT_MONITOR 0x02 | |
32 | #define CAT_AE 0x03 | |
33 | #define CAT_WB 0x06 | |
34 | #define CAT_EXIF 0x07 | |
35 | #define CAT_FD 0x09 | |
36 | #define CAT_LENS 0x0a | |
37 | #define CAT_CAPT_PARM 0x0b | |
38 | #define CAT_CAPT_CTRL 0x0c | |
39 | #define CAT_FLASH 0x0f /* related to FW, revisions, booting */ | |
40 | ||
41 | /* | |
42 | * Category 0 - SYSTEM mode | |
43 | * | |
44 | * The SYSTEM mode in the M-5MOLS means area available to handle with the whole | |
45 | * & all-round system of sensor. It deals with version/interrupt/setting mode & | |
46 | * even sensor's status. Especially, the M-5MOLS sensor with ISP varies by | |
47 | * packaging & manufacturer, even the customer and project code. And the | |
48 | * function details may vary among them. The version information helps to | |
49 | * determine what methods shall be used in the driver. | |
50 | * | |
51 | * There is many registers between customer version address and awb one. For | |
52 | * more specific contents, see definition if file m5mols.h. | |
53 | */ | |
69eb1803 SN |
54 | #define SYSTEM_VER_CUSTOMER I2C_REG(CAT_SYSTEM, 0x00, 1) |
55 | #define SYSTEM_VER_PROJECT I2C_REG(CAT_SYSTEM, 0x01, 1) | |
56 | #define SYSTEM_VER_FIRMWARE I2C_REG(CAT_SYSTEM, 0x02, 2) | |
57 | #define SYSTEM_VER_HARDWARE I2C_REG(CAT_SYSTEM, 0x04, 2) | |
58 | #define SYSTEM_VER_PARAMETER I2C_REG(CAT_SYSTEM, 0x06, 2) | |
59 | #define SYSTEM_VER_AWB I2C_REG(CAT_SYSTEM, 0x08, 2) | |
60 | ||
61 | #define SYSTEM_SYSMODE I2C_REG(CAT_SYSTEM, 0x0b, 1) | |
bc125106 HK |
62 | #define REG_SYSINIT 0x00 /* SYSTEM mode */ |
63 | #define REG_PARAMETER 0x01 /* PARAMETER mode */ | |
64 | #define REG_MONITOR 0x02 /* MONITOR mode */ | |
65 | #define REG_CAPTURE 0x03 /* CAPTURE mode */ | |
66 | ||
67 | #define SYSTEM_CMD(__cmd) I2C_REG(CAT_SYSTEM, cmd, 1) | |
69eb1803 | 68 | #define SYSTEM_VER_STRING I2C_REG(CAT_SYSTEM, 0x0a, 1) |
bc125106 HK |
69 | #define REG_SAMSUNG_ELECTRO "SE" /* Samsung Electro-Mechanics */ |
70 | #define REG_SAMSUNG_OPTICS "OP" /* Samsung Fiber-Optics */ | |
71 | #define REG_SAMSUNG_TECHWIN "TB" /* Samsung Techwin */ | |
69eb1803 SN |
72 | /* SYSTEM mode status */ |
73 | #define SYSTEM_STATUS I2C_REG(CAT_SYSTEM, 0x0c, 1) | |
bc125106 | 74 | |
69eb1803 SN |
75 | /* Interrupt pending register */ |
76 | #define SYSTEM_INT_FACTOR I2C_REG(CAT_SYSTEM, 0x10, 1) | |
77 | /* interrupt enable register */ | |
78 | #define SYSTEM_INT_ENABLE I2C_REG(CAT_SYSTEM, 0x11, 1) | |
bc125106 HK |
79 | #define REG_INT_MODE (1 << 0) |
80 | #define REG_INT_AF (1 << 1) | |
81 | #define REG_INT_ZOOM (1 << 2) | |
82 | #define REG_INT_CAPTURE (1 << 3) | |
83 | #define REG_INT_FRAMESYNC (1 << 4) | |
84 | #define REG_INT_FD (1 << 5) | |
85 | #define REG_INT_LENS_INIT (1 << 6) | |
86 | #define REG_INT_SOUND (1 << 7) | |
87 | #define REG_INT_MASK 0x0f | |
88 | ||
89 | /* | |
90 | * category 1 - PARAMETER mode | |
91 | * | |
92 | * This category supports function of camera features of M-5MOLS. It means we | |
93 | * can handle with preview(MONITOR) resolution size/frame per second/interface | |
94 | * between the sensor and the Application Processor/even the image effect. | |
95 | */ | |
bc125106 | 96 | |
69eb1803 SN |
97 | /* Resolution in the MONITOR mode */ |
98 | #define PARM_MON_SIZE I2C_REG(CAT_PARAM, 0x01, 1) | |
bc125106 | 99 | |
69eb1803 SN |
100 | /* Frame rate */ |
101 | #define PARM_MON_FPS I2C_REG(CAT_PARAM, 0x02, 1) | |
bc125106 HK |
102 | #define REG_FPS_30 0x02 |
103 | ||
69eb1803 SN |
104 | /* Video bus between the sensor and a host processor */ |
105 | #define PARM_INTERFACE I2C_REG(CAT_PARAM, 0x00, 1) | |
bc125106 HK |
106 | #define REG_INTERFACE_MIPI 0x02 |
107 | ||
69eb1803 SN |
108 | /* Image effects */ |
109 | #define PARM_EFFECT I2C_REG(CAT_PARAM, 0x0b, 1) | |
bc125106 HK |
110 | #define REG_EFFECT_OFF 0x00 |
111 | #define REG_EFFECT_NEGA 0x01 | |
112 | #define REG_EFFECT_EMBOSS 0x06 | |
113 | #define REG_EFFECT_OUTLINE 0x07 | |
114 | #define REG_EFFECT_WATERCOLOR 0x08 | |
115 | ||
116 | /* | |
117 | * Category 2 - MONITOR mode | |
118 | * | |
119 | * The MONITOR mode is same as preview mode as we said. The M-5MOLS has another | |
120 | * mode named "Preview", but this preview mode is used at the case specific | |
121 | * vider-recording mode. This mmode supports only YUYV format. On the other | |
122 | * hand, the JPEG & RAW formats is supports by CAPTURE mode. And, there are | |
123 | * another options like zoom/color effect(different with effect in PARAMETER | |
124 | * mode)/anti hand shaking algorithm. | |
125 | */ | |
69eb1803 SN |
126 | |
127 | /* Target digital zoom position */ | |
128 | #define MON_ZOOM I2C_REG(CAT_MONITOR, 0x01, 1) | |
129 | ||
130 | /* CR value for color effect */ | |
131 | #define MON_CFIXR I2C_REG(CAT_MONITOR, 0x0a, 1) | |
132 | /* CB value for color effect */ | |
133 | #define MON_CFIXB I2C_REG(CAT_MONITOR, 0x09, 1) | |
bc125106 HK |
134 | #define REG_CFIXB_SEPIA 0xd8 |
135 | #define REG_CFIXR_SEPIA 0x18 | |
136 | ||
69eb1803 | 137 | #define MON_EFFECT I2C_REG(CAT_MONITOR, 0x0b, 1) |
bc125106 HK |
138 | #define REG_COLOR_EFFECT_OFF 0x00 |
139 | #define REG_COLOR_EFFECT_ON 0x01 | |
140 | ||
69eb1803 SN |
141 | /* Chroma enable */ |
142 | #define MON_CHROMA_EN I2C_REG(CAT_MONITOR, 0x10, 1) | |
143 | /* Chroma level */ | |
144 | #define MON_CHROMA_LVL I2C_REG(CAT_MONITOR, 0x0f, 1) | |
bc125106 HK |
145 | #define REG_CHROMA_OFF 0x00 |
146 | #define REG_CHROMA_ON 0x01 | |
147 | ||
69eb1803 SN |
148 | /* Sharpness on/off */ |
149 | #define MON_EDGE_EN I2C_REG(CAT_MONITOR, 0x12, 1) | |
150 | /* Sharpness level */ | |
151 | #define MON_EDGE_LVL I2C_REG(CAT_MONITOR, 0x11, 1) | |
bc125106 HK |
152 | #define REG_EDGE_OFF 0x00 |
153 | #define REG_EDGE_ON 0x01 | |
154 | ||
69eb1803 SN |
155 | /* Set color tone (contrast) */ |
156 | #define MON_TONE_CTL I2C_REG(CAT_MONITOR, 0x25, 1) | |
bc125106 HK |
157 | |
158 | /* | |
159 | * Category 3 - Auto Exposure | |
160 | * | |
161 | * The M-5MOLS exposure capbility is detailed as which is similar to digital | |
162 | * camera. This category supports AE locking/various AE mode(range of exposure) | |
163 | * /ISO/flickering/EV bias/shutter/meteoring, and anything else. And the | |
164 | * maximum/minimum exposure gain value depending on M-5MOLS firmware, may be | |
165 | * different. So, this category also provide getting the max/min values. And, | |
166 | * each MONITOR and CAPTURE mode has each gain/shutter/max exposure values. | |
167 | */ | |
69eb1803 SN |
168 | |
169 | /* Auto Exposure locking */ | |
170 | #define AE_LOCK I2C_REG(CAT_AE, 0x00, 1) | |
bc125106 HK |
171 | #define REG_AE_UNLOCK 0x00 |
172 | #define REG_AE_LOCK 0x01 | |
173 | ||
69eb1803 SN |
174 | /* Auto Exposure algorithm mode */ |
175 | #define AE_MODE I2C_REG(CAT_AE, 0x01, 1) | |
bc125106 HK |
176 | #define REG_AE_OFF 0x00 /* AE off */ |
177 | #define REG_AE_ALL 0x01 /* calc AE in all block integral */ | |
178 | #define REG_AE_CENTER 0x03 /* calc AE in center weighted */ | |
179 | #define REG_AE_SPOT 0x06 /* calc AE in specific spot */ | |
180 | ||
69eb1803 | 181 | #define AE_ISO I2C_REG(CAT_AE, 0x05, 1) |
bc125106 HK |
182 | #define REG_ISO_AUTO 0x00 |
183 | #define REG_ISO_50 0x01 | |
184 | #define REG_ISO_100 0x02 | |
185 | #define REG_ISO_200 0x03 | |
186 | #define REG_ISO_400 0x04 | |
187 | #define REG_ISO_800 0x05 | |
188 | ||
69eb1803 SN |
189 | /* EV (scenemode) preset for MONITOR */ |
190 | #define AE_EV_PRESET_MONITOR I2C_REG(CAT_AE, 0x0a, 1) | |
191 | /* EV (scenemode) preset for CAPTURE */ | |
192 | #define AE_EV_PRESET_CAPTURE I2C_REG(CAT_AE, 0x0b, 1) | |
bc125106 HK |
193 | #define REG_SCENE_NORMAL 0x00 |
194 | #define REG_SCENE_PORTRAIT 0x01 | |
195 | #define REG_SCENE_LANDSCAPE 0x02 | |
196 | #define REG_SCENE_SPORTS 0x03 | |
197 | #define REG_SCENE_PARTY_INDOOR 0x04 | |
198 | #define REG_SCENE_BEACH_SNOW 0x05 | |
199 | #define REG_SCENE_SUNSET 0x06 | |
200 | #define REG_SCENE_DAWN_DUSK 0x07 | |
201 | #define REG_SCENE_FALL 0x08 | |
202 | #define REG_SCENE_NIGHT 0x09 | |
203 | #define REG_SCENE_AGAINST_LIGHT 0x0a | |
204 | #define REG_SCENE_FIRE 0x0b | |
205 | #define REG_SCENE_TEXT 0x0c | |
206 | #define REG_SCENE_CANDLE 0x0d | |
207 | ||
69eb1803 SN |
208 | /* Manual gain in MONITOR mode */ |
209 | #define AE_MAN_GAIN_MON I2C_REG(CAT_AE, 0x12, 2) | |
210 | /* Maximum gain in MONITOR mode */ | |
211 | #define AE_MAX_GAIN_MON I2C_REG(CAT_AE, 0x1a, 2) | |
212 | /* Manual gain in CAPTURE mode */ | |
213 | #define AE_MAN_GAIN_CAP I2C_REG(CAT_AE, 0x26, 2) | |
bc125106 | 214 | |
69eb1803 | 215 | #define AE_INDEX I2C_REG(CAT_AE, 0x38, 1) |
bc125106 HK |
216 | #define REG_AE_INDEX_20_NEG 0x00 |
217 | #define REG_AE_INDEX_15_NEG 0x01 | |
218 | #define REG_AE_INDEX_10_NEG 0x02 | |
219 | #define REG_AE_INDEX_05_NEG 0x03 | |
220 | #define REG_AE_INDEX_00 0x04 | |
221 | #define REG_AE_INDEX_05_POS 0x05 | |
222 | #define REG_AE_INDEX_10_POS 0x06 | |
223 | #define REG_AE_INDEX_15_POS 0x07 | |
224 | #define REG_AE_INDEX_20_POS 0x08 | |
225 | ||
226 | /* | |
227 | * Category 6 - White Balance | |
bc125106 | 228 | */ |
bc125106 | 229 | |
69eb1803 SN |
230 | /* Auto Whitebalance locking */ |
231 | #define AWB_LOCK I2C_REG(CAT_WB, 0x00, 1) | |
bc125106 HK |
232 | #define REG_AWB_UNLOCK 0x00 |
233 | #define REG_AWB_LOCK 0x01 | |
234 | ||
69eb1803 | 235 | #define AWB_MODE I2C_REG(CAT_WB, 0x02, 1) |
bc125106 HK |
236 | #define REG_AWB_AUTO 0x01 /* AWB off */ |
237 | #define REG_AWB_PRESET 0x02 /* AWB preset */ | |
238 | ||
69eb1803 SN |
239 | /* Manual WB (preset) */ |
240 | #define AWB_MANUAL I2C_REG(CAT_WB, 0x03, 1) | |
bc125106 HK |
241 | #define REG_AWB_INCANDESCENT 0x01 |
242 | #define REG_AWB_FLUORESCENT_1 0x02 | |
243 | #define REG_AWB_FLUORESCENT_2 0x03 | |
244 | #define REG_AWB_DAYLIGHT 0x04 | |
245 | #define REG_AWB_CLOUDY 0x05 | |
246 | #define REG_AWB_SHADE 0x06 | |
247 | #define REG_AWB_HORIZON 0x07 | |
248 | #define REG_AWB_LEDLIGHT 0x09 | |
249 | ||
250 | /* | |
251 | * Category 7 - EXIF information | |
252 | */ | |
69eb1803 SN |
253 | #define EXIF_INFO_EXPTIME_NU I2C_REG(CAT_EXIF, 0x00, 4) |
254 | #define EXIF_INFO_EXPTIME_DE I2C_REG(CAT_EXIF, 0x04, 4) | |
255 | #define EXIF_INFO_TV_NU I2C_REG(CAT_EXIF, 0x08, 4) | |
256 | #define EXIF_INFO_TV_DE I2C_REG(CAT_EXIF, 0x0c, 4) | |
257 | #define EXIF_INFO_AV_NU I2C_REG(CAT_EXIF, 0x10, 4) | |
258 | #define EXIF_INFO_AV_DE I2C_REG(CAT_EXIF, 0x14, 4) | |
259 | #define EXIF_INFO_BV_NU I2C_REG(CAT_EXIF, 0x18, 4) | |
260 | #define EXIF_INFO_BV_DE I2C_REG(CAT_EXIF, 0x1c, 4) | |
261 | #define EXIF_INFO_EBV_NU I2C_REG(CAT_EXIF, 0x20, 4) | |
262 | #define EXIF_INFO_EBV_DE I2C_REG(CAT_EXIF, 0x24, 4) | |
263 | #define EXIF_INFO_ISO I2C_REG(CAT_EXIF, 0x28, 2) | |
264 | #define EXIF_INFO_FLASH I2C_REG(CAT_EXIF, 0x2a, 2) | |
265 | #define EXIF_INFO_SDR I2C_REG(CAT_EXIF, 0x2c, 2) | |
266 | #define EXIF_INFO_QVAL I2C_REG(CAT_EXIF, 0x2e, 2) | |
bc125106 HK |
267 | |
268 | /* | |
269 | * Category 9 - Face Detection | |
270 | */ | |
69eb1803 | 271 | #define FD_CTL I2C_REG(CAT_FD, 0x00, 1) |
bc125106 HK |
272 | #define BIT_FD_EN 0 |
273 | #define BIT_FD_DRAW_FACE_FRAME 4 | |
274 | #define BIT_FD_DRAW_SMILE_LVL 6 | |
275 | #define REG_FD(shift) (1 << shift) | |
276 | #define REG_FD_OFF 0x0 | |
277 | ||
278 | /* | |
279 | * Category A - Lens Parameter | |
280 | */ | |
69eb1803 | 281 | #define AF_MODE I2C_REG(CAT_LENS, 0x01, 1) |
bc125106 HK |
282 | #define REG_AF_NORMAL 0x00 /* Normal AF, one time */ |
283 | #define REG_AF_MACRO 0x01 /* Macro AF, one time */ | |
284 | #define REG_AF_POWEROFF 0x07 | |
285 | ||
69eb1803 | 286 | #define AF_EXECUTE I2C_REG(CAT_LENS, 0x02, 1) |
bc125106 HK |
287 | #define REG_AF_STOP 0x00 |
288 | #define REG_AF_EXE_AUTO 0x01 | |
289 | #define REG_AF_EXE_CAF 0x02 | |
290 | ||
69eb1803 | 291 | #define AF_STATUS I2C_REG(CAT_LENS, 0x03, 1) |
bc125106 HK |
292 | #define REG_AF_FAIL 0x00 |
293 | #define REG_AF_SUCCESS 0x02 | |
294 | #define REG_AF_IDLE 0x04 | |
295 | #define REG_AF_BUSY 0x05 | |
296 | ||
69eb1803 | 297 | #define AF_VERSION I2C_REG(CAT_LENS, 0x0a, 1) |
bc125106 HK |
298 | |
299 | /* | |
300 | * Category B - CAPTURE Parameter | |
301 | */ | |
69eb1803 | 302 | #define CAPP_YUVOUT_MAIN I2C_REG(CAT_CAPT_PARM, 0x00, 1) |
bc125106 HK |
303 | #define REG_YUV422 0x00 |
304 | #define REG_BAYER10 0x05 | |
305 | #define REG_BAYER8 0x06 | |
306 | #define REG_JPEG 0x10 | |
307 | ||
69eb1803 | 308 | #define CAPP_MAIN_IMAGE_SIZE I2C_REG(CAT_CAPT_PARM, 0x01, 1) |
ab7ef224 | 309 | #define CAPP_JPEG_SIZE_MAX I2C_REG(CAT_CAPT_PARM, 0x0f, 4) |
dd9c471d | 310 | #define CAPP_JPEG_RATIO I2C_REG(CAT_CAPT_PARM, 0x17, 1) |
bc125106 | 311 | |
69eb1803 | 312 | #define CAPP_MCC_MODE I2C_REG(CAT_CAPT_PARM, 0x1d, 1) |
bc125106 HK |
313 | #define REG_MCC_OFF 0x00 |
314 | #define REG_MCC_NORMAL 0x01 | |
315 | ||
69eb1803 | 316 | #define CAPP_WDR_EN I2C_REG(CAT_CAPT_PARM, 0x2c, 1) |
bc125106 HK |
317 | #define REG_WDR_OFF 0x00 |
318 | #define REG_WDR_ON 0x01 | |
319 | #define REG_WDR_AUTO 0x02 | |
320 | ||
69eb1803 | 321 | #define CAPP_LIGHT_CTRL I2C_REG(CAT_CAPT_PARM, 0x40, 1) |
bc125106 HK |
322 | #define REG_LIGHT_OFF 0x00 |
323 | #define REG_LIGHT_ON 0x01 | |
324 | #define REG_LIGHT_AUTO 0x02 | |
325 | ||
69eb1803 | 326 | #define CAPP_FLASH_CTRL I2C_REG(CAT_CAPT_PARM, 0x41, 1) |
bc125106 HK |
327 | #define REG_FLASH_OFF 0x00 |
328 | #define REG_FLASH_ON 0x01 | |
329 | #define REG_FLASH_AUTO 0x02 | |
330 | ||
331 | /* | |
332 | * Category C - CAPTURE Control | |
333 | */ | |
69eb1803 | 334 | #define CAPC_MODE I2C_REG(CAT_CAPT_CTRL, 0x00, 1) |
bc125106 HK |
335 | #define REG_CAP_NONE 0x00 |
336 | #define REG_CAP_ANTI_SHAKE 0x02 | |
337 | ||
69eb1803 SN |
338 | /* Select single- or multi-shot capture */ |
339 | #define CAPC_SEL_FRAME I2C_REG(CAT_CAPT_CTRL, 0x06, 1) | |
bc125106 | 340 | |
69eb1803 | 341 | #define CAPC_START I2C_REG(CAT_CAPT_CTRL, 0x09, 1) |
bc125106 HK |
342 | #define REG_CAP_START_MAIN 0x01 |
343 | #define REG_CAP_START_THUMB 0x03 | |
344 | ||
69eb1803 SN |
345 | #define CAPC_IMAGE_SIZE I2C_REG(CAT_CAPT_CTRL, 0x0d, 4) |
346 | #define CAPC_THUMB_SIZE I2C_REG(CAT_CAPT_CTRL, 0x11, 4) | |
bc125106 HK |
347 | |
348 | /* | |
349 | * Category F - Flash | |
350 | * | |
351 | * This mode provides functions about internal flash stuff and system startup. | |
352 | */ | |
bc125106 | 353 | |
69eb1803 SN |
354 | /* Starts internal ARM core booting after power-up */ |
355 | #define FLASH_CAM_START I2C_REG(CAT_FLASH, 0x12, 1) | |
0f2ee1dd HK |
356 | #define REG_START_ARM_BOOT 0x01 /* write value */ |
357 | #define REG_IN_FLASH_MODE 0x00 /* read value */ | |
bc125106 HK |
358 | |
359 | #endif /* M5MOLS_REG_H */ |