1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
|
/*
* Support for Intel Camera Imaging ISP subsystem.
* Copyright (c) 2015, Intel Corporation.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms and conditions of the GNU General Public License,
* version 2, as published by the Free Software Foundation.
*
* This program is distributed in the hope it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*/
#ifndef __IA_CSS_S3A_TYPES_H
#define __IA_CSS_S3A_TYPES_H
/* @file
* CSS-API header file for 3A statistics parameters.
*/
#include <ia_css_frac.h>
#if (defined(SYSTEM_css_skycam_c0_system)) && (!defined(PIPE_GENERATION))
#include "../../../../components/stats_3a/src/stats_3a_public.h"
#endif
/* 3A configuration. This configures the 3A statistics collection
* module.
*/
/* 3A statistics grid
*
* ISP block: S3A1 (3A Support for 3A ver.1 (Histogram is not used for AE))
* S3A2 (3A Support for 3A ver.2 (Histogram is used for AE))
* ISP1: S3A1 is used.
* ISP2: S3A2 is used.
*/
struct ia_css_3a_grid_info {
#if defined(SYSTEM_css_skycam_c0_system)
u32 ae_enable; /** ae enabled in binary,
0:disabled, 1:enabled */
struct ae_public_config_grid_config
ae_grd_info; /** see description in ae_public.h*/
u32 awb_enable; /** awb enabled in binary,
0:disabled, 1:enabled */
struct awb_public_config_grid_config
awb_grd_info; /** see description in awb_public.h*/
u32 af_enable; /** af enabled in binary,
0:disabled, 1:enabled */
struct af_public_grid_config af_grd_info; /** see description in af_public.h*/
u32 awb_fr_enable; /** awb_fr enabled in binary,
0:disabled, 1:enabled */
struct awb_fr_public_grid_config
awb_fr_grd_info;/** see description in awb_fr_public.h*/
u32 elem_bit_depth; /** TODO:Taken from BYT - need input from AIQ
if needed for SKC
Bit depth of element used
to calculate 3A statistics.
This is 13, which is the normalized
bayer bit depth in DSP. */
#else
u32 enable; /** 3A statistics enabled.
0:disabled, 1:enabled */
u32 use_dmem; /** DMEM or VMEM determines layout.
0:3A statistics are stored to VMEM,
1:3A statistics are stored to DMEM */
u32 has_histogram; /** Statistics include histogram.
0:no histogram, 1:has histogram */
u32 width; /** Width of 3A grid table.
(= Horizontal number of grid cells
in table, which cells have effective
statistics.) */
u32 height; /** Height of 3A grid table.
(= Vertical number of grid cells
in table, which cells have effective
statistics.) */
u32 aligned_width; /** Horizontal stride (for alloc).
(= Horizontal number of grid cells
in table, which means
the allocated width.) */
u32 aligned_height; /** Vertical stride (for alloc).
(= Vertical number of grid cells
in table, which means
the allocated height.) */
u32 bqs_per_grid_cell; /** Grid cell size in BQ(Bayer Quad) unit.
(1BQ means {Gr,R,B,Gb}(2x2 pixels).)
Valid values are 8,16,32,64. */
u32 deci_factor_log2; /** log2 of bqs_per_grid_cell. */
u32 elem_bit_depth; /** Bit depth of element used
to calculate 3A statistics.
This is 13, which is the normalized
bayer bit depth in DSP. */
#endif
};
/* This struct should be split into 3, for AE, AWB and AF.
* However, that will require driver/ 3A lib modifications.
*/
/* 3A configuration. This configures the 3A statistics collection
* module.
*
* ae_y_*: Coefficients to calculate luminance from bayer.
* awb_lg_*: Thresholds to check the saturated bayer pixels for AWB.
* Condition of effective pixel for AWB level gate check:
* bayer(sensor) <= awb_lg_high_raw &&
* bayer(when AWB statisitcs is calculated) >= awb_lg_low &&
* bayer(when AWB statisitcs is calculated) <= awb_lg_high
* af_fir*: Coefficients of high pass filter to calculate AF statistics.
*
* ISP block: S3A1(ae_y_* for AE/AF, awb_lg_* for AWB)
* S3A2(ae_y_* for AF, awb_lg_* for AWB)
* SDVS1(ae_y_*)
* SDVS2(ae_y_*)
* ISP1: S3A1 and SDVS1 are used.
* ISP2: S3A2 and SDVS2 are used.
*/
struct ia_css_3a_config {
ia_css_u0_16 ae_y_coef_r; /** Weight of R for Y.
u0.16, [0,65535],
default/ineffective 25559 */
ia_css_u0_16 ae_y_coef_g; /** Weight of G for Y.
u0.16, [0,65535],
default/ineffective 32768 */
ia_css_u0_16 ae_y_coef_b; /** Weight of B for Y.
u0.16, [0,65535],
default/ineffective 7209 */
ia_css_u0_16 awb_lg_high_raw; /** AWB level gate high for raw.
u0.16, [0,65535],
default 65472(=1023*64),
ineffective 65535 */
ia_css_u0_16 awb_lg_low; /** AWB level gate low.
u0.16, [0,65535],
default 64(=1*64),
ineffective 0 */
ia_css_u0_16 awb_lg_high; /** AWB level gate high.
u0.16, [0,65535],
default 65535,
ineffective 65535 */
ia_css_s0_15 af_fir1_coef[7]; /** AF FIR coefficients of fir1.
s0.15, [-32768,32767],
default/ineffective
-6689,-12207,-32768,32767,12207,6689,0 */
ia_css_s0_15 af_fir2_coef[7]; /** AF FIR coefficients of fir2.
s0.15, [-32768,32767],
default/ineffective
2053,0,-18437,32767,-18437,2053,0 */
};
/* 3A statistics. This structure describes the data stored
* in each 3A grid point.
*
* ISP block: S3A1 (3A Support for 3A ver.1) (Histogram is not used for AE)
* S3A2 (3A Support for 3A ver.2) (Histogram is used for AE)
* - ae_y is used only for S3A1.
* - awb_* and af_* are used both for S3A1 and S3A2.
* ISP1: S3A1 is used.
* ISP2: S3A2 is used.
*/
struct ia_css_3a_output {
s32 ae_y; /** Sum of Y in a statistics window, for AE.
(u19.13) */
s32 awb_cnt; /** Number of effective pixels
in a statistics window.
Pixels passed by the AWB level gate check are
judged as "effective". (u32) */
s32 awb_gr; /** Sum of Gr in a statistics window, for AWB.
All Gr pixels (not only for effective pixels)
are summed. (u19.13) */
s32 awb_r; /** Sum of R in a statistics window, for AWB.
All R pixels (not only for effective pixels)
are summed. (u19.13) */
s32 awb_b; /** Sum of B in a statistics window, for AWB.
All B pixels (not only for effective pixels)
are summed. (u19.13) */
s32 awb_gb; /** Sum of Gb in a statistics window, for AWB.
All Gb pixels (not only for effective pixels)
are summed. (u19.13) */
s32 af_hpf1; /** Sum of |Y| following high pass filter af_fir1
within a statistics window, for AF. (u19.13) */
s32 af_hpf2; /** Sum of |Y| following high pass filter af_fir2
within a statistics window, for AF. (u19.13) */
};
/* 3A Statistics. This structure describes the statistics that are generated
* using the provided configuration (ia_css_3a_config).
*/
struct ia_css_3a_statistics {
struct ia_css_3a_grid_info
grid; /** grid info contains the dimensions of the 3A grid */
struct ia_css_3a_output
*data; /** the pointer to 3a_output[grid.width * grid.height]
containing the 3A statistics */
struct ia_css_3a_rgby_output *rgby_data;/** the pointer to 3a_rgby_output[256]
containing the histogram */
};
/* Histogram (Statistics for AE).
*
* 4 histograms(r,g,b,y),
* 256 bins for each histogram, unsigned 24bit value for each bin.
* struct ia_css_3a_rgby_output data[256];
* ISP block: HIST2
* (ISP1: HIST2 is not used.)
* ISP2: HIST2 is used.
*/
struct ia_css_3a_rgby_output {
u32 r; /** Number of R of one bin of the histogram R. (u24) */
u32 g; /** Number of G of one bin of the histogram G. (u24) */
u32 b; /** Number of B of one bin of the histogram B. (u24) */
u32 y; /** Number of Y of one bin of the histogram Y. (u24) */
};
#endif /* __IA_CSS_S3A_TYPES_H */
|
