]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - drivers/media/i2c/m5mols/m5mols_reg.h
Merge branch 'timers-urgent-for-linus' of git://git.kernel.org/pub/scm/linux/kernel...
[mirror_ubuntu-jammy-kernel.git] / drivers / media / i2c / m5mols / m5mols_reg.h
CommitLineData
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 */