1  /* SPDX-License-Identifier: GPL-2.0-only */
2  /*
3   * Samsung EXYNOS4x12 FIMC-IS (Imaging Subsystem) driver
4   *
5   * Copyright (C) 2011 - 2013 Samsung Electronics Co., Ltd.
6   *
7   * Authors: Younghwan Joo <yhwan.joo@samsung.com>
8   *	    Sylwester Nawrocki <s.nawrocki@samsung.com>
9   */
10  #ifndef FIMC_IS_PARAM_H_
11  #define FIMC_IS_PARAM_H_
12  
13  #include <linux/compiler.h>
14  
15  #define FIMC_IS_CONFIG_TIMEOUT		3000 /* ms */
16  #define IS_DEFAULT_WIDTH		1280
17  #define IS_DEFAULT_HEIGHT		720
18  
19  #define DEFAULT_PREVIEW_STILL_WIDTH	IS_DEFAULT_WIDTH
20  #define DEFAULT_PREVIEW_STILL_HEIGHT	IS_DEFAULT_HEIGHT
21  #define DEFAULT_CAPTURE_STILL_WIDTH	IS_DEFAULT_WIDTH
22  #define DEFAULT_CAPTURE_STILL_HEIGHT	IS_DEFAULT_HEIGHT
23  #define DEFAULT_PREVIEW_VIDEO_WIDTH	IS_DEFAULT_WIDTH
24  #define DEFAULT_PREVIEW_VIDEO_HEIGHT	IS_DEFAULT_HEIGHT
25  #define DEFAULT_CAPTURE_VIDEO_WIDTH	IS_DEFAULT_WIDTH
26  #define DEFAULT_CAPTURE_VIDEO_HEIGHT	IS_DEFAULT_HEIGHT
27  
28  #define DEFAULT_PREVIEW_STILL_FRAMERATE	30
29  #define DEFAULT_CAPTURE_STILL_FRAMERATE	15
30  #define DEFAULT_PREVIEW_VIDEO_FRAMERATE	30
31  #define DEFAULT_CAPTURE_VIDEO_FRAMERATE	30
32  
33  #define FIMC_IS_REGION_VER		124 /* IS REGION VERSION 1.24 */
34  #define FIMC_IS_PARAM_SIZE		(FIMC_IS_REGION_SIZE + 1)
35  #define FIMC_IS_MAGIC_NUMBER		0x01020304
36  #define FIMC_IS_PARAM_MAX_SIZE		64 /* in bytes */
37  #define FIMC_IS_PARAM_MAX_ENTRIES	(FIMC_IS_PARAM_MAX_SIZE / 4)
38  
39  /* The parameter bitmask bit definitions. */
40  enum is_param_bit {
41  	PARAM_GLOBAL_SHOTMODE,
42  	PARAM_SENSOR_CONTROL,
43  	PARAM_SENSOR_OTF_OUTPUT,
44  	PARAM_SENSOR_FRAME_RATE,
45  	PARAM_BUFFER_CONTROL,
46  	PARAM_BUFFER_OTF_INPUT,
47  	PARAM_BUFFER_OTF_OUTPUT,
48  	PARAM_ISP_CONTROL,
49  	PARAM_ISP_OTF_INPUT,
50  	PARAM_ISP_DMA1_INPUT,
51  	/* 10 */
52  	PARAM_ISP_DMA2_INPUT,
53  	PARAM_ISP_AA,
54  	PARAM_ISP_FLASH,
55  	PARAM_ISP_AWB,
56  	PARAM_ISP_IMAGE_EFFECT,
57  	PARAM_ISP_ISO,
58  	PARAM_ISP_ADJUST,
59  	PARAM_ISP_METERING,
60  	PARAM_ISP_AFC,
61  	PARAM_ISP_OTF_OUTPUT,
62  	/* 20 */
63  	PARAM_ISP_DMA1_OUTPUT,
64  	PARAM_ISP_DMA2_OUTPUT,
65  	PARAM_DRC_CONTROL,
66  	PARAM_DRC_OTF_INPUT,
67  	PARAM_DRC_DMA_INPUT,
68  	PARAM_DRC_OTF_OUTPUT,
69  	PARAM_SCALERC_CONTROL,
70  	PARAM_SCALERC_OTF_INPUT,
71  	PARAM_SCALERC_IMAGE_EFFECT,
72  	PARAM_SCALERC_INPUT_CROP,
73  	/* 30 */
74  	PARAM_SCALERC_OUTPUT_CROP,
75  	PARAM_SCALERC_OTF_OUTPUT,
76  	PARAM_SCALERC_DMA_OUTPUT,
77  	PARAM_ODC_CONTROL,
78  	PARAM_ODC_OTF_INPUT,
79  	PARAM_ODC_OTF_OUTPUT,
80  	PARAM_DIS_CONTROL,
81  	PARAM_DIS_OTF_INPUT,
82  	PARAM_DIS_OTF_OUTPUT,
83  	PARAM_TDNR_CONTROL,
84  	/* 40 */
85  	PARAM_TDNR_OTF_INPUT,
86  	PARAM_TDNR_1ST_FRAME,
87  	PARAM_TDNR_OTF_OUTPUT,
88  	PARAM_TDNR_DMA_OUTPUT,
89  	PARAM_SCALERP_CONTROL,
90  	PARAM_SCALERP_OTF_INPUT,
91  	PARAM_SCALERP_IMAGE_EFFECT,
92  	PARAM_SCALERP_INPUT_CROP,
93  	PARAM_SCALERP_OUTPUT_CROP,
94  	PARAM_SCALERP_ROTATION,
95  	/* 50 */
96  	PARAM_SCALERP_FLIP,
97  	PARAM_SCALERP_OTF_OUTPUT,
98  	PARAM_SCALERP_DMA_OUTPUT,
99  	PARAM_FD_CONTROL,
100  	PARAM_FD_OTF_INPUT,
101  	PARAM_FD_DMA_INPUT,
102  	PARAM_FD_CONFIG,
103  };
104  
105  /* Interrupt map */
106  #define	FIMC_IS_INT_GENERAL			0
107  #define	FIMC_IS_INT_FRAME_DONE_ISP		1
108  
109  /* Input */
110  
111  #define CONTROL_COMMAND_STOP			0
112  #define CONTROL_COMMAND_START			1
113  
114  #define CONTROL_BYPASS_DISABLE			0
115  #define CONTROL_BYPASS_ENABLE			1
116  
117  #define CONTROL_ERROR_NONE			0
118  
119  /* OTF (On-The-Fly) input interface commands */
120  #define OTF_INPUT_COMMAND_DISABLE		0
121  #define OTF_INPUT_COMMAND_ENABLE		1
122  
123  /* OTF input interface color formats */
124  enum oft_input_fmt {
125  	OTF_INPUT_FORMAT_BAYER			= 0, /* 1 channel */
126  	OTF_INPUT_FORMAT_YUV444			= 1, /* 3 channels */
127  	OTF_INPUT_FORMAT_YUV422			= 2, /* 3 channels */
128  	OTF_INPUT_FORMAT_YUV420			= 3, /* 3 channels */
129  	OTF_INPUT_FORMAT_STRGEN_COLORBAR_BAYER	= 10,
130  	OTF_INPUT_FORMAT_BAYER_DMA		= 11,
131  };
132  
133  #define OTF_INPUT_ORDER_BAYER_GR_BG		0
134  
135  /* OTF input error codes */
136  #define OTF_INPUT_ERROR_NONE			0 /* Input setting is done */
137  
138  /* DMA input commands */
139  #define DMA_INPUT_COMMAND_DISABLE		0
140  #define DMA_INPUT_COMMAND_ENABLE		1
141  
142  /* DMA input color formats */
143  enum dma_input_fmt {
144  	DMA_INPUT_FORMAT_BAYER			= 0,
145  	DMA_INPUT_FORMAT_YUV444			= 1,
146  	DMA_INPUT_FORMAT_YUV422			= 2,
147  	DMA_INPUT_FORMAT_YUV420			= 3,
148  };
149  
150  enum dma_input_order {
151  	/* (for DMA_INPUT_PLANE_3) */
152  	DMA_INPUT_ORDER_NO	= 0,
153  	/* (only valid at DMA_INPUT_PLANE_2) */
154  	DMA_INPUT_ORDER_CBCR	= 1,
155  	/* (only valid at DMA_INPUT_PLANE_2) */
156  	DMA_INPUT_ORDER_CRCB	= 2,
157  	/* (only valid at DMA_INPUT_PLANE_1 & DMA_INPUT_FORMAT_YUV444) */
158  	DMA_INPUT_ORDER_YCBCR	= 3,
159  	/* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */
160  	DMA_INPUT_ORDER_YYCBCR	= 4,
161  	/* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */
162  	DMA_INPUT_ORDER_YCBYCR	= 5,
163  	/* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */
164  	DMA_INPUT_ORDER_YCRYCB	= 6,
165  	/* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */
166  	DMA_INPUT_ORDER_CBYCRY	= 7,
167  	/* (only valid at DMA_INPUT_FORMAT_YUV422 & DMA_INPUT_PLANE_1) */
168  	DMA_INPUT_ORDER_CRYCBY	= 8,
169  	/* (only valid at DMA_INPUT_FORMAT_BAYER) */
170  	DMA_INPUT_ORDER_GR_BG	= 9
171  };
172  
173  #define DMA_INPUT_ERROR_NONE			0 /* DMA input setting
174  						     is done */
175  /*
176   * Data output parameter definitions
177   */
178  #define OTF_OUTPUT_CROP_DISABLE			0
179  #define OTF_OUTPUT_CROP_ENABLE			1
180  
181  #define OTF_OUTPUT_COMMAND_DISABLE		0
182  #define OTF_OUTPUT_COMMAND_ENABLE		1
183  
184  enum otf_output_fmt {
185  	OTF_OUTPUT_FORMAT_YUV444		= 1,
186  	OTF_OUTPUT_FORMAT_YUV422		= 2,
187  	OTF_OUTPUT_FORMAT_YUV420		= 3,
188  	OTF_OUTPUT_FORMAT_RGB			= 4,
189  };
190  
191  #define OTF_OUTPUT_ORDER_BAYER_GR_BG		0
192  
193  #define OTF_OUTPUT_ERROR_NONE			0 /* Output Setting is done */
194  
195  #define DMA_OUTPUT_COMMAND_DISABLE		0
196  #define DMA_OUTPUT_COMMAND_ENABLE		1
197  
198  enum dma_output_fmt {
199  	DMA_OUTPUT_FORMAT_BAYER			= 0,
200  	DMA_OUTPUT_FORMAT_YUV444		= 1,
201  	DMA_OUTPUT_FORMAT_YUV422		= 2,
202  	DMA_OUTPUT_FORMAT_YUV420		= 3,
203  	DMA_OUTPUT_FORMAT_RGB			= 4,
204  };
205  
206  enum dma_output_order {
207  	DMA_OUTPUT_ORDER_NO		= 0,
208  	/* for DMA_OUTPUT_PLANE_3 */
209  	DMA_OUTPUT_ORDER_CBCR		= 1,
210  	/* only valid at DMA_INPUT_PLANE_2) */
211  	DMA_OUTPUT_ORDER_CRCB		= 2,
212  	/* only valid at DMA_OUTPUT_PLANE_2) */
213  	DMA_OUTPUT_ORDER_YYCBCR		= 3,
214  	/* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */
215  	DMA_OUTPUT_ORDER_YCBYCR		= 4,
216  	/* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */
217  	DMA_OUTPUT_ORDER_YCRYCB		= 5,
218  	/* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */
219  	DMA_OUTPUT_ORDER_CBYCRY		= 6,
220  	/* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */
221  	DMA_OUTPUT_ORDER_CRYCBY		= 7,
222  	/* only valid at DMA_OUTPUT_FORMAT_YUV422 & DMA_OUTPUT_PLANE_1 */
223  	DMA_OUTPUT_ORDER_YCBCR		= 8,
224  	/* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */
225  	DMA_OUTPUT_ORDER_CRYCB		= 9,
226  	/* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */
227  	DMA_OUTPUT_ORDER_CRCBY		= 10,
228  	/* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */
229  	DMA_OUTPUT_ORDER_CBYCR		= 11,
230  	/* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */
231  	DMA_OUTPUT_ORDER_YCRCB		= 12,
232  	/* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */
233  	DMA_OUTPUT_ORDER_CBCRY		= 13,
234  	/* only valid at DMA_OUTPUT_FORMAT_YUV444 & DMA_OUPUT_PLANE_1 */
235  	DMA_OUTPUT_ORDER_BGR		= 14,
236  	/* only valid at DMA_OUTPUT_FORMAT_RGB */
237  	DMA_OUTPUT_ORDER_GB_BG		= 15
238  	/* only valid at DMA_OUTPUT_FORMAT_BAYER */
239  };
240  
241  /* enum dma_output_notify_dma_done */
242  #define DMA_OUTPUT_NOTIFY_DMA_DONE_DISABLE	0
243  #define DMA_OUTPUT_NOTIFY_DMA_DONE_ENABLE	1
244  
245  /* DMA output error codes */
246  #define DMA_OUTPUT_ERROR_NONE			0 /* DMA output setting
247  						     is done */
248  
249  /* ----------------------  Global  ----------------------------------- */
250  #define GLOBAL_SHOTMODE_ERROR_NONE		0 /* shot-mode setting
251  						     is done */
252  /* 3A lock commands */
253  #define ISP_AA_COMMAND_START			0
254  #define ISP_AA_COMMAND_STOP			1
255  
256  /* 3A lock target */
257  #define ISP_AA_TARGET_AF			1
258  #define ISP_AA_TARGET_AE			2
259  #define ISP_AA_TARGET_AWB			4
260  
261  enum isp_af_mode {
262  	ISP_AF_MODE_MANUAL			= 0,
263  	ISP_AF_MODE_SINGLE			= 1,
264  	ISP_AF_MODE_CONTINUOUS			= 2,
265  	ISP_AF_MODE_TOUCH			= 3,
266  	ISP_AF_MODE_SLEEP			= 4,
267  	ISP_AF_MODE_INIT			= 5,
268  	ISP_AF_MODE_SET_CENTER_WINDOW		= 6,
269  	ISP_AF_MODE_SET_TOUCH_WINDOW		= 7
270  };
271  
272  /* Face AF commands */
273  #define ISP_AF_FACE_DISABLE			0
274  #define ISP_AF_FACE_ENABLE			1
275  
276  /* AF range */
277  #define ISP_AF_RANGE_NORMAL			0
278  #define ISP_AF_RANGE_MACRO			1
279  
280  /* AF sleep */
281  #define ISP_AF_SLEEP_OFF			0
282  #define ISP_AF_SLEEP_ON				1
283  
284  /* Continuous AF commands */
285  #define ISP_AF_CONTINUOUS_DISABLE		0
286  #define ISP_AF_CONTINUOUS_ENABLE		1
287  
288  /* ISP AF error codes */
289  #define ISP_AF_ERROR_NONE			0 /* AF mode change is done */
290  #define ISP_AF_ERROR_NONE_LOCK_DONE		1 /* AF lock is done */
291  
292  /* Flash commands */
293  #define ISP_FLASH_COMMAND_DISABLE		0
294  #define ISP_FLASH_COMMAND_MANUAL_ON		1 /* (forced flash) */
295  #define ISP_FLASH_COMMAND_AUTO			2
296  #define ISP_FLASH_COMMAND_TORCH			3 /* 3 sec */
297  
298  /* Flash red-eye commands */
299  #define ISP_FLASH_REDEYE_DISABLE		0
300  #define ISP_FLASH_REDEYE_ENABLE			1
301  
302  /* Flash error codes */
303  #define ISP_FLASH_ERROR_NONE			0 /* Flash setting is done */
304  
305  /* --------------------------  AWB  ------------------------------------ */
306  enum isp_awb_command {
307  	ISP_AWB_COMMAND_AUTO			= 0,
308  	ISP_AWB_COMMAND_ILLUMINATION		= 1,
309  	ISP_AWB_COMMAND_MANUAL			= 2
310  };
311  
312  enum isp_awb_illumination {
313  	ISP_AWB_ILLUMINATION_DAYLIGHT		= 0,
314  	ISP_AWB_ILLUMINATION_CLOUDY		= 1,
315  	ISP_AWB_ILLUMINATION_TUNGSTEN		= 2,
316  	ISP_AWB_ILLUMINATION_FLUORESCENT	= 3
317  };
318  
319  /* ISP AWN error codes */
320  #define ISP_AWB_ERROR_NONE			0 /* AWB setting is done */
321  
322  /* --------------------------  Effect  ----------------------------------- */
323  enum isp_imageeffect_command {
324  	ISP_IMAGE_EFFECT_DISABLE		= 0,
325  	ISP_IMAGE_EFFECT_MONOCHROME		= 1,
326  	ISP_IMAGE_EFFECT_NEGATIVE_MONO		= 2,
327  	ISP_IMAGE_EFFECT_NEGATIVE_COLOR		= 3,
328  	ISP_IMAGE_EFFECT_SEPIA			= 4
329  };
330  
331  /* Image effect error codes */
332  #define ISP_IMAGE_EFFECT_ERROR_NONE		0 /* Image effect setting
333  						     is done */
334  /* ISO commands */
335  #define ISP_ISO_COMMAND_AUTO			0
336  #define ISP_ISO_COMMAND_MANUAL			1
337  
338  /* ISO error codes */
339  #define ISP_ISO_ERROR_NONE			0 /* ISO setting is done */
340  
341  /* ISP adjust commands */
342  #define ISP_ADJUST_COMMAND_AUTO			(0 << 0)
343  #define ISP_ADJUST_COMMAND_MANUAL_CONTRAST	(1 << 0)
344  #define ISP_ADJUST_COMMAND_MANUAL_SATURATION	(1 << 1)
345  #define ISP_ADJUST_COMMAND_MANUAL_SHARPNESS	(1 << 2)
346  #define ISP_ADJUST_COMMAND_MANUAL_EXPOSURE	(1 << 3)
347  #define ISP_ADJUST_COMMAND_MANUAL_BRIGHTNESS	(1 << 4)
348  #define ISP_ADJUST_COMMAND_MANUAL_HUE		(1 << 5)
349  #define ISP_ADJUST_COMMAND_MANUAL_ALL		0x7f
350  
351  /* ISP adjustment error codes */
352  #define ISP_ADJUST_ERROR_NONE			0 /* Adjust setting is done */
353  
354  /*
355   *  Exposure metering
356   */
357  enum isp_metering_command {
358  	ISP_METERING_COMMAND_AVERAGE	= 0,
359  	ISP_METERING_COMMAND_SPOT	= 1,
360  	ISP_METERING_COMMAND_MATRIX	= 2,
361  	ISP_METERING_COMMAND_CENTER	= 3
362  };
363  
364  /* ISP metering error codes */
365  #define ISP_METERING_ERROR_NONE		0 /* Metering setting is done */
366  
367  /*
368   * AFC
369   */
370  enum isp_afc_command {
371  	ISP_AFC_COMMAND_DISABLE		= 0,
372  	ISP_AFC_COMMAND_AUTO		= 1,
373  	ISP_AFC_COMMAND_MANUAL		= 2,
374  };
375  
376  #define ISP_AFC_MANUAL_50HZ		50
377  #define ISP_AFC_MANUAL_60HZ		60
378  
379  /* ------------------------  SCENE MODE--------------------------------- */
380  enum isp_scene_mode {
381  	ISP_SCENE_NONE			= 0,
382  	ISP_SCENE_PORTRAIT		= 1,
383  	ISP_SCENE_LANDSCAPE		= 2,
384  	ISP_SCENE_SPORTS		= 3,
385  	ISP_SCENE_PARTYINDOOR		= 4,
386  	ISP_SCENE_BEACHSNOW		= 5,
387  	ISP_SCENE_SUNSET		= 6,
388  	ISP_SCENE_DAWN			= 7,
389  	ISP_SCENE_FALL			= 8,
390  	ISP_SCENE_NIGHT			= 9,
391  	ISP_SCENE_AGAINSTLIGHTWLIGHT	= 10,
392  	ISP_SCENE_AGAINSTLIGHTWOLIGHT	= 11,
393  	ISP_SCENE_FIRE			= 12,
394  	ISP_SCENE_TEXT			= 13,
395  	ISP_SCENE_CANDLE		= 14
396  };
397  
398  /* AFC error codes */
399  #define ISP_AFC_ERROR_NONE		0 /* AFC setting is done */
400  
401  /* ----------------------------  FD  ------------------------------------- */
402  enum fd_config_command {
403  	FD_CONFIG_COMMAND_MAXIMUM_NUMBER	= 0x1,
404  	FD_CONFIG_COMMAND_ROLL_ANGLE		= 0x2,
405  	FD_CONFIG_COMMAND_YAW_ANGLE		= 0x4,
406  	FD_CONFIG_COMMAND_SMILE_MODE		= 0x8,
407  	FD_CONFIG_COMMAND_BLINK_MODE		= 0x10,
408  	FD_CONFIG_COMMAND_EYES_DETECT		= 0x20,
409  	FD_CONFIG_COMMAND_MOUTH_DETECT		= 0x40,
410  	FD_CONFIG_COMMAND_ORIENTATION		= 0x80,
411  	FD_CONFIG_COMMAND_ORIENTATION_VALUE	= 0x100
412  };
413  
414  enum fd_config_roll_angle {
415  	FD_CONFIG_ROLL_ANGLE_BASIC		= 0,
416  	FD_CONFIG_ROLL_ANGLE_PRECISE_BASIC	= 1,
417  	FD_CONFIG_ROLL_ANGLE_SIDES		= 2,
418  	FD_CONFIG_ROLL_ANGLE_PRECISE_SIDES	= 3,
419  	FD_CONFIG_ROLL_ANGLE_FULL		= 4,
420  	FD_CONFIG_ROLL_ANGLE_PRECISE_FULL	= 5,
421  };
422  
423  enum fd_config_yaw_angle {
424  	FD_CONFIG_YAW_ANGLE_0			= 0,
425  	FD_CONFIG_YAW_ANGLE_45			= 1,
426  	FD_CONFIG_YAW_ANGLE_90			= 2,
427  	FD_CONFIG_YAW_ANGLE_45_90		= 3,
428  };
429  
430  /* Smile mode configuration */
431  #define FD_CONFIG_SMILE_MODE_DISABLE		0
432  #define FD_CONFIG_SMILE_MODE_ENABLE		1
433  
434  /* Blink mode configuration */
435  #define FD_CONFIG_BLINK_MODE_DISABLE		0
436  #define FD_CONFIG_BLINK_MODE_ENABLE		1
437  
438  /* Eyes detection configuration */
439  #define FD_CONFIG_EYES_DETECT_DISABLE		0
440  #define FD_CONFIG_EYES_DETECT_ENABLE		1
441  
442  /* Mouth detection configuration */
443  #define FD_CONFIG_MOUTH_DETECT_DISABLE		0
444  #define FD_CONFIG_MOUTH_DETECT_ENABLE		1
445  
446  #define FD_CONFIG_ORIENTATION_DISABLE		0
447  #define FD_CONFIG_ORIENTATION_ENABLE		1
448  
449  struct param_control {
450  	u32 cmd;
451  	u32 bypass;
452  	u32 buffer_address;
453  	u32 buffer_size;
454  	u32 skip_frames; /* only valid at ISP */
455  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 6];
456  	u32 err;
457  };
458  
459  struct param_otf_input {
460  	u32 cmd;
461  	u32 width;
462  	u32 height;
463  	u32 format;
464  	u32 bitwidth;
465  	u32 order;
466  	u32 crop_offset_x;
467  	u32 crop_offset_y;
468  	u32 crop_width;
469  	u32 crop_height;
470  	u32 frametime_min;
471  	u32 frametime_max;
472  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 13];
473  	u32 err;
474  };
475  
476  struct param_dma_input {
477  	u32 cmd;
478  	u32 width;
479  	u32 height;
480  	u32 format;
481  	u32 bitwidth;
482  	u32 plane;
483  	u32 order;
484  	u32 buffer_number;
485  	u32 buffer_address;
486  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 10];
487  	u32 err;
488  };
489  
490  struct param_otf_output {
491  	u32 cmd;
492  	u32 width;
493  	u32 height;
494  	u32 format;
495  	u32 bitwidth;
496  	u32 order;
497  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 7];
498  	u32 err;
499  };
500  
501  struct param_dma_output {
502  	u32 cmd;
503  	u32 width;
504  	u32 height;
505  	u32 format;
506  	u32 bitwidth;
507  	u32 plane;
508  	u32 order;
509  	u32 buffer_number;
510  	u32 buffer_address;
511  	u32 notify_dma_done;
512  	u32 dma_out_mask;
513  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 12];
514  	u32 err;
515  };
516  
517  struct param_global_shotmode {
518  	u32 cmd;
519  	u32 skip_frames;
520  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3];
521  	u32 err;
522  };
523  
524  struct param_sensor_framerate {
525  	u32 frame_rate;
526  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2];
527  	u32 err;
528  };
529  
530  struct param_isp_aa {
531  	u32 cmd;
532  	u32 target;
533  	u32 mode;
534  	u32 scene;
535  	u32 sleep;
536  	u32 face;
537  	u32 touch_x;
538  	u32 touch_y;
539  	u32 manual_af_setting;
540  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 10];
541  	u32 err;
542  };
543  
544  struct param_isp_flash {
545  	u32 cmd;
546  	u32 redeye;
547  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3];
548  	u32 err;
549  };
550  
551  struct param_isp_awb {
552  	u32 cmd;
553  	u32 illumination;
554  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3];
555  	u32 err;
556  };
557  
558  struct param_isp_imageeffect {
559  	u32 cmd;
560  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2];
561  	u32 err;
562  };
563  
564  struct param_isp_iso {
565  	u32 cmd;
566  	u32 value;
567  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3];
568  	u32 err;
569  };
570  
571  struct param_isp_adjust {
572  	u32 cmd;
573  	s32 contrast;
574  	s32 saturation;
575  	s32 sharpness;
576  	s32 exposure;
577  	s32 brightness;
578  	s32 hue;
579  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 8];
580  	u32 err;
581  };
582  
583  struct param_isp_metering {
584  	u32 cmd;
585  	u32 win_pos_x;
586  	u32 win_pos_y;
587  	u32 win_width;
588  	u32 win_height;
589  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 6];
590  	u32 err;
591  };
592  
593  struct param_isp_afc {
594  	u32 cmd;
595  	u32 manual;
596  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 3];
597  	u32 err;
598  };
599  
600  struct param_scaler_imageeffect {
601  	u32 cmd;
602  	u32 arbitrary_cb;
603  	u32 arbitrary_cr;
604  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 4];
605  	u32 err;
606  };
607  
608  struct param_scaler_input_crop {
609  	u32 cmd;
610  	u32 crop_offset_x;
611  	u32 crop_offset_y;
612  	u32 crop_width;
613  	u32 crop_height;
614  	u32 in_width;
615  	u32 in_height;
616  	u32 out_width;
617  	u32 out_height;
618  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 10];
619  	u32 err;
620  };
621  
622  struct param_scaler_output_crop {
623  	u32 cmd;
624  	u32 crop_offset_x;
625  	u32 crop_offset_y;
626  	u32 crop_width;
627  	u32 crop_height;
628  	u32 out_format;
629  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 7];
630  	u32 err;
631  };
632  
633  struct param_scaler_rotation {
634  	u32 cmd;
635  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2];
636  	u32 err;
637  };
638  
639  struct param_scaler_flip {
640  	u32 cmd;
641  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2];
642  	u32 err;
643  };
644  
645  struct param_3dnr_1stframe {
646  	u32 cmd;
647  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 2];
648  	u32 err;
649  };
650  
651  struct param_fd_config {
652  	u32 cmd;
653  	u32 max_number;
654  	u32 roll_angle;
655  	u32 yaw_angle;
656  	u32 smile_mode;
657  	u32 blink_mode;
658  	u32 eye_detect;
659  	u32 mouth_detect;
660  	u32 orientation;
661  	u32 orientation_value;
662  	u32 reserved[FIMC_IS_PARAM_MAX_ENTRIES - 11];
663  	u32 err;
664  };
665  
666  struct global_param {
667  	struct param_global_shotmode	shotmode;
668  };
669  
670  struct sensor_param {
671  	struct param_control		control;
672  	struct param_otf_output		otf_output;
673  	struct param_sensor_framerate	frame_rate;
674  } __packed;
675  
676  struct buffer_param {
677  	struct param_control		control;
678  	struct param_otf_input		otf_input;
679  	struct param_otf_output		otf_output;
680  } __packed;
681  
682  struct isp_param {
683  	struct param_control		control;
684  	struct param_otf_input		otf_input;
685  	struct param_dma_input		dma1_input;
686  	struct param_dma_input		dma2_input;
687  	struct param_isp_aa		aa;
688  	struct param_isp_flash		flash;
689  	struct param_isp_awb		awb;
690  	struct param_isp_imageeffect	effect;
691  	struct param_isp_iso		iso;
692  	struct param_isp_adjust		adjust;
693  	struct param_isp_metering	metering;
694  	struct param_isp_afc		afc;
695  	struct param_otf_output		otf_output;
696  	struct param_dma_output		dma1_output;
697  	struct param_dma_output		dma2_output;
698  } __packed;
699  
700  struct drc_param {
701  	struct param_control		control;
702  	struct param_otf_input		otf_input;
703  	struct param_dma_input		dma_input;
704  	struct param_otf_output		otf_output;
705  } __packed;
706  
707  struct scalerc_param {
708  	struct param_control		control;
709  	struct param_otf_input		otf_input;
710  	struct param_scaler_imageeffect	effect;
711  	struct param_scaler_input_crop	input_crop;
712  	struct param_scaler_output_crop	output_crop;
713  	struct param_otf_output		otf_output;
714  	struct param_dma_output		dma_output;
715  } __packed;
716  
717  struct odc_param {
718  	struct param_control		control;
719  	struct param_otf_input		otf_input;
720  	struct param_otf_output		otf_output;
721  } __packed;
722  
723  struct dis_param {
724  	struct param_control		control;
725  	struct param_otf_output		otf_input;
726  	struct param_otf_output		otf_output;
727  } __packed;
728  
729  struct tdnr_param {
730  	struct param_control		control;
731  	struct param_otf_input		otf_input;
732  	struct param_3dnr_1stframe	frame;
733  	struct param_otf_output		otf_output;
734  	struct param_dma_output		dma_output;
735  } __packed;
736  
737  struct scalerp_param {
738  	struct param_control		control;
739  	struct param_otf_input		otf_input;
740  	struct param_scaler_imageeffect	effect;
741  	struct param_scaler_input_crop	input_crop;
742  	struct param_scaler_output_crop	output_crop;
743  	struct param_scaler_rotation	rotation;
744  	struct param_scaler_flip	flip;
745  	struct param_otf_output		otf_output;
746  	struct param_dma_output		dma_output;
747  } __packed;
748  
749  struct fd_param {
750  	struct param_control		control;
751  	struct param_otf_input		otf_input;
752  	struct param_dma_input		dma_input;
753  	struct param_fd_config		config;
754  } __packed;
755  
756  struct is_param_region {
757  	struct global_param		global;
758  	struct sensor_param		sensor;
759  	struct buffer_param		buf;
760  	struct isp_param		isp;
761  	struct drc_param		drc;
762  	struct scalerc_param		scalerc;
763  	struct odc_param		odc;
764  	struct dis_param		dis;
765  	struct tdnr_param		tdnr;
766  	struct scalerp_param		scalerp;
767  	struct fd_param			fd;
768  } __packed;
769  
770  #define NUMBER_OF_GAMMA_CURVE_POINTS	32
771  
772  struct is_tune_sensor {
773  	u32 exposure;
774  	u32 analog_gain;
775  	u32 frame_rate;
776  	u32 actuator_position;
777  };
778  
779  struct is_tune_gammacurve {
780  	u32 num_pts_x[NUMBER_OF_GAMMA_CURVE_POINTS];
781  	u32 num_pts_y_r[NUMBER_OF_GAMMA_CURVE_POINTS];
782  	u32 num_pts_y_g[NUMBER_OF_GAMMA_CURVE_POINTS];
783  	u32 num_pts_y_b[NUMBER_OF_GAMMA_CURVE_POINTS];
784  };
785  
786  struct is_tune_isp {
787  	/* Brightness level: range 0...100, default 7. */
788  	u32 brightness_level;
789  	/* Contrast level: range -127...127, default 0. */
790  	s32 contrast_level;
791  	/* Saturation level: range -127...127, default 0. */
792  	s32 saturation_level;
793  	s32 gamma_level;
794  	struct is_tune_gammacurve gamma_curve[4];
795  	/* Hue: range -127...127, default 0. */
796  	s32 hue;
797  	/* Sharpness blur: range -127...127, default 0. */
798  	s32 sharpness_blur;
799  	/* Despeckle : range -127~127, default : 0 */
800  	s32 despeckle;
801  	/* Edge color supression: range -127...127, default 0. */
802  	s32 edge_color_supression;
803  	/* Noise reduction: range -127...127, default 0. */
804  	s32 noise_reduction;
805  	/* (32 * 4 + 9) * 4 = 548 bytes */
806  } __packed;
807  
808  struct is_tune_region {
809  	struct is_tune_sensor sensor;
810  	struct is_tune_isp isp;
811  } __packed;
812  
813  struct rational {
814  	u32 num;
815  	u32 den;
816  };
817  
818  struct srational {
819  	s32 num;
820  	s32 den;
821  };
822  
823  #define FLASH_FIRED_SHIFT			0
824  #define FLASH_NOT_FIRED				0
825  #define FLASH_FIRED				1
826  
827  #define FLASH_STROBE_SHIFT			1
828  #define FLASH_STROBE_NO_DETECTION		0
829  #define FLASH_STROBE_RESERVED			1
830  #define FLASH_STROBE_RETURN_LIGHT_NOT_DETECTED	2
831  #define FLASH_STROBE_RETURN_LIGHT_DETECTED	3
832  
833  #define FLASH_MODE_SHIFT			3
834  #define FLASH_MODE_UNKNOWN			0
835  #define FLASH_MODE_COMPULSORY_FLASH_FIRING	1
836  #define FLASH_MODE_COMPULSORY_FLASH_SUPPRESSION	2
837  #define FLASH_MODE_AUTO_MODE			3
838  
839  #define FLASH_FUNCTION_SHIFT			5
840  #define FLASH_FUNCTION_PRESENT			0
841  #define FLASH_FUNCTION_NONE			1
842  
843  #define FLASH_RED_EYE_SHIFT			6
844  #define FLASH_RED_EYE_DISABLED			0
845  #define FLASH_RED_EYE_SUPPORTED			1
846  
847  enum apex_aperture_value {
848  	F1_0	= 0,
849  	F1_4	= 1,
850  	F2_0	= 2,
851  	F2_8	= 3,
852  	F4_0	= 4,
853  	F5_6	= 5,
854  	F8_9	= 6,
855  	F11_0	= 7,
856  	F16_0	= 8,
857  	F22_0	= 9,
858  	F32_0	= 10,
859  };
860  
861  struct exif_attribute {
862  	struct rational exposure_time;
863  	struct srational shutter_speed;
864  	u32 iso_speed_rating;
865  	u32 flash;
866  	struct srational brightness;
867  } __packed;
868  
869  struct is_frame_header {
870  	u32 valid;
871  	u32 bad_mark;
872  	u32 captured;
873  	u32 frame_number;
874  	struct exif_attribute exif;
875  } __packed;
876  
877  struct is_fd_rect {
878  	u32 offset_x;
879  	u32 offset_y;
880  	u32 width;
881  	u32 height;
882  };
883  
884  struct is_face_marker {
885  	u32 frame_number;
886  	struct is_fd_rect face;
887  	struct is_fd_rect left_eye;
888  	struct is_fd_rect right_eye;
889  	struct is_fd_rect mouth;
890  	u32 roll_angle;
891  	u32 yaw_angle;
892  	u32 confidence;
893  	s32 smile_level;
894  	s32 blink_level;
895  } __packed;
896  
897  #define MAX_FRAME_COUNT				8
898  #define MAX_FRAME_COUNT_PREVIEW			4
899  #define MAX_FRAME_COUNT_CAPTURE			1
900  #define MAX_FACE_COUNT				16
901  #define MAX_SHARED_COUNT			500
902  
903  struct is_region {
904  	struct is_param_region parameter;
905  	struct is_tune_region tune;
906  	struct is_frame_header header[MAX_FRAME_COUNT];
907  	struct is_face_marker face[MAX_FACE_COUNT];
908  	u32 shared[MAX_SHARED_COUNT];
909  } __packed;
910  
911  /* Offset to the ISP DMA2 output buffer address array. */
912  #define DMA2_OUTPUT_ADDR_ARRAY_OFFS \
913  	(offsetof(struct is_region, shared) + 32 * sizeof(u32))
914  
915  struct is_debug_frame_descriptor {
916  	u32 sensor_frame_time;
917  	u32 sensor_exposure_time;
918  	s32 sensor_analog_gain;
919  	/* monitor for AA */
920  	u32 req_lei;
921  
922  	u32 next_next_lei_exp;
923  	u32 next_next_lei_a_gain;
924  	u32 next_next_lei_d_gain;
925  	u32 next_next_lei_statlei;
926  	u32 next_next_lei_lei;
927  
928  	u32 dummy0;
929  };
930  
931  #define MAX_FRAMEDESCRIPTOR_CONTEXT_NUM	(30*20)	/* 600 frames */
932  #define MAX_VERSION_DISPLAY_BUF	32
933  
934  struct is_share_region {
935  	u32 frame_time;
936  	u32 exposure_time;
937  	s32 analog_gain;
938  
939  	u32 r_gain;
940  	u32 g_gain;
941  	u32 b_gain;
942  
943  	u32 af_position;
944  	u32 af_status;
945  	/* 0 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_NOMESSAGE */
946  	/* 1 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_REACHED */
947  	/* 2 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_UNABLETOREACH */
948  	/* 3 : SIRC_ISP_CAMERA_AUTOFOCUSMESSAGE_LOST */
949  	/* default : unknown */
950  	u32 af_scene_type;
951  
952  	u32 frame_descp_onoff_control;
953  	u32 frame_descp_update_done;
954  	u32 frame_descp_idx;
955  	u32 frame_descp_max_idx;
956  	struct is_debug_frame_descriptor
957  		dbg_frame_descp_ctx[MAX_FRAMEDESCRIPTOR_CONTEXT_NUM];
958  
959  	u32 chip_id;
960  	u32 chip_rev_no;
961  	u8 isp_fw_ver_no[MAX_VERSION_DISPLAY_BUF];
962  	u8 isp_fw_ver_date[MAX_VERSION_DISPLAY_BUF];
963  	u8 sirc_sdk_ver_no[MAX_VERSION_DISPLAY_BUF];
964  	u8 sirc_sdk_rev_no[MAX_VERSION_DISPLAY_BUF];
965  	u8 sirc_sdk_rev_date[MAX_VERSION_DISPLAY_BUF];
966  } __packed;
967  
968  struct is_debug_control {
969  	u32 write_point;	/* 0~ 500KB boundary */
970  	u32 assert_flag;	/* 0: Not invoked, 1: Invoked */
971  	u32 pabort_flag;	/* 0: Not invoked, 1: Invoked */
972  	u32 dabort_flag;	/* 0: Not invoked, 1: Invoked */
973  };
974  
975  struct sensor_open_extended {
976  	u32 actuator_type;
977  	u32 mclk;
978  	u32 mipi_lane_num;
979  	u32 mipi_speed;
980  	/* Skip setfile loading when fast_open_sensor is not 0 */
981  	u32 fast_open_sensor;
982  	/* Activating sensor self calibration mode (6A3) */
983  	u32 self_calibration_mode;
984  	/* This field is to adjust I2c clock based on ACLK200 */
985  	/* This value is varied in case of rev 0.2 */
986  	u32 i2c_sclk;
987  };
988  
989  struct fimc_is;
990  
991  int fimc_is_hw_get_sensor_max_framerate(struct fimc_is *is);
992  int __fimc_is_hw_update_param(struct fimc_is *is, u32 offset);
993  void fimc_is_set_initial_params(struct fimc_is *is);
994  unsigned int __get_pending_param_count(struct fimc_is *is);
995  
996  int  __is_hw_update_params(struct fimc_is *is);
997  void __is_get_frame_size(struct fimc_is *is, struct v4l2_mbus_framefmt *mf);
998  void __is_set_frame_size(struct fimc_is *is, struct v4l2_mbus_framefmt *mf);
999  void __is_set_sensor(struct fimc_is *is, int fps);
1000  void __is_set_isp_aa_ae(struct fimc_is *is);
1001  void __is_set_isp_flash(struct fimc_is *is, u32 cmd, u32 redeye);
1002  void __is_set_isp_awb(struct fimc_is *is, u32 cmd, u32 val);
1003  void __is_set_isp_effect(struct fimc_is *is, u32 cmd);
1004  void __is_set_isp_iso(struct fimc_is *is, u32 cmd, u32 val);
1005  void __is_set_isp_adjust(struct fimc_is *is, u32 cmd, u32 val);
1006  void __is_set_isp_metering(struct fimc_is *is, u32 id, u32 val);
1007  void __is_set_isp_afc(struct fimc_is *is, u32 cmd, u32 val);
1008  void __is_set_drc_control(struct fimc_is *is, u32 val);
1009  void __is_set_fd_control(struct fimc_is *is, u32 val);
1010  void __is_set_fd_config_maxface(struct fimc_is *is, u32 val);
1011  void __is_set_fd_config_rollangle(struct fimc_is *is, u32 val);
1012  void __is_set_fd_config_yawangle(struct fimc_is *is, u32 val);
1013  void __is_set_fd_config_smilemode(struct fimc_is *is, u32 val);
1014  void __is_set_fd_config_blinkmode(struct fimc_is *is, u32 val);
1015  void __is_set_fd_config_eyedetect(struct fimc_is *is, u32 val);
1016  void __is_set_fd_config_mouthdetect(struct fimc_is *is, u32 val);
1017  void __is_set_fd_config_orientation(struct fimc_is *is, u32 val);
1018  void __is_set_fd_config_orientation_val(struct fimc_is *is, u32 val);
1019  void __is_set_isp_aa_af_mode(struct fimc_is *is, int cmd);
1020  void __is_set_isp_aa_af_start_stop(struct fimc_is *is, int cmd);
1021  
1022  #endif
1023