1 /* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */
2 /*
3 * PiSP Back End configuration definitions.
4 *
5 * Copyright (C) 2021 - Raspberry Pi Ltd
6 *
7 */
8 #ifndef _UAPI_PISP_BE_CONFIG_H_
9 #define _UAPI_PISP_BE_CONFIG_H_
10
11 #include <linux/types.h>
12
13 #include "pisp_common.h"
14
15 /* byte alignment for inputs */
16 #define PISP_BACK_END_INPUT_ALIGN 4u
17 /* alignment for compressed inputs */
18 #define PISP_BACK_END_COMPRESSED_ALIGN 8u
19 /* minimum required byte alignment for outputs */
20 #define PISP_BACK_END_OUTPUT_MIN_ALIGN 16u
21 /* preferred byte alignment for outputs */
22 #define PISP_BACK_END_OUTPUT_MAX_ALIGN 64u
23
24 /* minimum allowed tile width anywhere in the pipeline */
25 #define PISP_BACK_END_MIN_TILE_WIDTH 16u
26 /* minimum allowed tile width anywhere in the pipeline */
27 #define PISP_BACK_END_MIN_TILE_HEIGHT 16u
28
29 #define PISP_BACK_END_NUM_OUTPUTS 2
30 #define PISP_BACK_END_HOG_OUTPUT 1
31
32 #define PISP_BACK_END_NUM_TILES 64
33
34 enum pisp_be_bayer_enable {
35 PISP_BE_BAYER_ENABLE_INPUT = 0x000001,
36 PISP_BE_BAYER_ENABLE_DECOMPRESS = 0x000002,
37 PISP_BE_BAYER_ENABLE_DPC = 0x000004,
38 PISP_BE_BAYER_ENABLE_GEQ = 0x000008,
39 PISP_BE_BAYER_ENABLE_TDN_INPUT = 0x000010,
40 PISP_BE_BAYER_ENABLE_TDN_DECOMPRESS = 0x000020,
41 PISP_BE_BAYER_ENABLE_TDN = 0x000040,
42 PISP_BE_BAYER_ENABLE_TDN_COMPRESS = 0x000080,
43 PISP_BE_BAYER_ENABLE_TDN_OUTPUT = 0x000100,
44 PISP_BE_BAYER_ENABLE_SDN = 0x000200,
45 PISP_BE_BAYER_ENABLE_BLC = 0x000400,
46 PISP_BE_BAYER_ENABLE_STITCH_INPUT = 0x000800,
47 PISP_BE_BAYER_ENABLE_STITCH_DECOMPRESS = 0x001000,
48 PISP_BE_BAYER_ENABLE_STITCH = 0x002000,
49 PISP_BE_BAYER_ENABLE_STITCH_COMPRESS = 0x004000,
50 PISP_BE_BAYER_ENABLE_STITCH_OUTPUT = 0x008000,
51 PISP_BE_BAYER_ENABLE_WBG = 0x010000,
52 PISP_BE_BAYER_ENABLE_CDN = 0x020000,
53 PISP_BE_BAYER_ENABLE_LSC = 0x040000,
54 PISP_BE_BAYER_ENABLE_TONEMAP = 0x080000,
55 PISP_BE_BAYER_ENABLE_CAC = 0x100000,
56 PISP_BE_BAYER_ENABLE_DEBIN = 0x200000,
57 PISP_BE_BAYER_ENABLE_DEMOSAIC = 0x400000,
58 };
59
60 enum pisp_be_rgb_enable {
61 PISP_BE_RGB_ENABLE_INPUT = 0x000001,
62 PISP_BE_RGB_ENABLE_CCM = 0x000002,
63 PISP_BE_RGB_ENABLE_SAT_CONTROL = 0x000004,
64 PISP_BE_RGB_ENABLE_YCBCR = 0x000008,
65 PISP_BE_RGB_ENABLE_FALSE_COLOUR = 0x000010,
66 PISP_BE_RGB_ENABLE_SHARPEN = 0x000020,
67 /* Preferred colours would occupy 0x000040 */
68 PISP_BE_RGB_ENABLE_YCBCR_INVERSE = 0x000080,
69 PISP_BE_RGB_ENABLE_GAMMA = 0x000100,
70 PISP_BE_RGB_ENABLE_CSC0 = 0x000200,
71 PISP_BE_RGB_ENABLE_CSC1 = 0x000400,
72 PISP_BE_RGB_ENABLE_DOWNSCALE0 = 0x001000,
73 PISP_BE_RGB_ENABLE_DOWNSCALE1 = 0x002000,
74 PISP_BE_RGB_ENABLE_RESAMPLE0 = 0x008000,
75 PISP_BE_RGB_ENABLE_RESAMPLE1 = 0x010000,
76 PISP_BE_RGB_ENABLE_OUTPUT0 = 0x040000,
77 PISP_BE_RGB_ENABLE_OUTPUT1 = 0x080000,
78 PISP_BE_RGB_ENABLE_HOG = 0x200000
79 };
80
81 #define PISP_BE_RGB_ENABLE_CSC(i) (PISP_BE_RGB_ENABLE_CSC0 << (i))
82 #define PISP_BE_RGB_ENABLE_DOWNSCALE(i) (PISP_BE_RGB_ENABLE_DOWNSCALE0 << (i))
83 #define PISP_BE_RGB_ENABLE_RESAMPLE(i) (PISP_BE_RGB_ENABLE_RESAMPLE0 << (i))
84 #define PISP_BE_RGB_ENABLE_OUTPUT(i) (PISP_BE_RGB_ENABLE_OUTPUT0 << (i))
85
86 /*
87 * We use the enable flags to show when blocks are "dirty", but we need some
88 * extra ones too.
89 */
90 enum pisp_be_dirty {
91 PISP_BE_DIRTY_GLOBAL = 0x0001,
92 PISP_BE_DIRTY_SH_FC_COMBINE = 0x0002,
93 PISP_BE_DIRTY_CROP = 0x0004
94 };
95
96 /**
97 * struct pisp_be_global_config - PiSP global enable bitmaps
98 * @bayer_enables: Bayer input enable flags
99 * @rgb_enables: RGB output enable flags
100 * @bayer_order: Bayer input format ordering
101 * @pad: Padding bytes
102 */
103 struct pisp_be_global_config {
104 __u32 bayer_enables;
105 __u32 rgb_enables;
106 __u8 bayer_order;
107 __u8 pad[3];
108 } __attribute__((packed));
109
110 /**
111 * struct pisp_be_input_buffer_config - PiSP Back End input buffer
112 * @addr: Input buffer address
113 */
114 struct pisp_be_input_buffer_config {
115 /* low 32 bits followed by high 32 bits (for each of up to 3 planes) */
116 __u32 addr[3][2];
117 } __attribute__((packed));
118
119 /**
120 * struct pisp_be_dpc_config - PiSP Back End DPC config
121 *
122 * Defective Pixel Correction configuration
123 *
124 * @coeff_level: Coefficient for the darkest neighbouring pixel value
125 * @coeff_range: Coefficient for the range of pixels for this Bayer channel
126 * @pad: Padding byte
127 * @flags: DPC configuration flags
128 */
129 struct pisp_be_dpc_config {
130 __u8 coeff_level;
131 __u8 coeff_range;
132 __u8 pad;
133 #define PISP_BE_DPC_FLAG_FOLDBACK 1
134 __u8 flags;
135 } __attribute__((packed));
136
137 /**
138 * struct pisp_be_geq_config - PiSP Back End GEQ config
139 *
140 * Green Equalisation configuration
141 *
142 * @offset: Offset value for threshold calculation
143 * @slope_sharper: Slope/Sharper configuration
144 * @min: Minimum value the threshold may have
145 * @max: Maximum value the threshold may have
146 */
147 struct pisp_be_geq_config {
148 __u16 offset;
149 #define PISP_BE_GEQ_SHARPER (1U << 15)
150 #define PISP_BE_GEQ_SLOPE ((1 << 10) - 1)
151 /* top bit is the "sharper" flag, slope value is bottom 10 bits */
152 __u16 slope_sharper;
153 __u16 min;
154 __u16 max;
155 } __attribute__((packed));
156
157 /**
158 * struct pisp_be_tdn_input_buffer_config - PiSP Back End TDN input buffer
159 * @addr: TDN input buffer address
160 */
161 struct pisp_be_tdn_input_buffer_config {
162 /* low 32 bits followed by high 32 bits */
163 __u32 addr[2];
164 } __attribute__((packed));
165
166 /**
167 * struct pisp_be_tdn_config - PiSP Back End TDN config
168 *
169 * Temporal Denoise configuration
170 *
171 * @black_level: Black level value subtracted from pixels
172 * @ratio: Multiplier for the LTA input frame
173 * @noise_constant: Constant offset value used in noise estimation
174 * @noise_slope: Noise estimation multiplier
175 * @threshold: Threshold for TDN operations
176 * @reset: Disable TDN operations
177 * @pad: Padding byte
178 */
179 struct pisp_be_tdn_config {
180 __u16 black_level;
181 __u16 ratio;
182 __u16 noise_constant;
183 __u16 noise_slope;
184 __u16 threshold;
185 __u8 reset;
186 __u8 pad;
187 } __attribute__((packed));
188
189 /**
190 * struct pisp_be_tdn_output_buffer_config - PiSP Back End TDN output buffer
191 * @addr: TDN output buffer address
192 */
193 struct pisp_be_tdn_output_buffer_config {
194 /* low 32 bits followed by high 32 bits */
195 __u32 addr[2];
196 } __attribute__((packed));
197
198 /**
199 * struct pisp_be_sdn_config - PiSP Back End SDN config
200 *
201 * Spatial Denoise configuration
202 *
203 * @black_level: Black level subtracted from pixel for noise estimation
204 * @leakage: Proportion of the original undenoised value to mix in
205 * denoised output
206 * @pad: Padding byte
207 * @noise_constant: Noise constant used for noise estimation
208 * @noise_slope: Noise slope value used for noise estimation
209 * @noise_constant2: Second noise constant used for noise estimation
210 * @noise_slope2: Second slope value used for noise estimation
211 */
212 struct pisp_be_sdn_config {
213 __u16 black_level;
214 __u8 leakage;
215 __u8 pad;
216 __u16 noise_constant;
217 __u16 noise_slope;
218 __u16 noise_constant2;
219 __u16 noise_slope2;
220 } __attribute__((packed));
221
222 /**
223 * struct pisp_be_stitch_input_buffer_config - PiSP Back End Stitch input
224 * @addr: Stitch input buffer address
225 */
226 struct pisp_be_stitch_input_buffer_config {
227 /* low 32 bits followed by high 32 bits */
228 __u32 addr[2];
229 } __attribute__((packed));
230
231 #define PISP_BE_STITCH_STREAMING_LONG 0x8000
232 #define PISP_BE_STITCH_EXPOSURE_RATIO_MASK 0x7fff
233
234 /**
235 * struct pisp_be_stitch_config - PiSP Back End Stitch config
236 *
237 * Stitch block configuration
238 *
239 * @threshold_lo: Low threshold value
240 * @threshold_diff_power: Low and high threshold difference
241 * @pad: Padding bytes
242 * @exposure_ratio: Multiplier to convert long exposure pixels into
243 * short exposure pixels
244 * @motion_threshold_256: Motion threshold above which short exposure
245 * pixels are used
246 * @motion_threshold_recip: Reciprocal of motion_threshold_256 value
247 */
248 struct pisp_be_stitch_config {
249 __u16 threshold_lo;
250 __u8 threshold_diff_power;
251 __u8 pad;
252
253 /* top bit indicates whether streaming input is the long exposure */
254 __u16 exposure_ratio;
255
256 __u8 motion_threshold_256;
257 __u8 motion_threshold_recip;
258 } __attribute__((packed));
259
260 /**
261 * struct pisp_be_stitch_output_buffer_config - PiSP Back End Stitch output
262 * @addr: Stitch input buffer address
263 */
264 struct pisp_be_stitch_output_buffer_config {
265 /* low 32 bits followed by high 32 bits */
266 __u32 addr[2];
267 } __attribute__((packed));
268
269 /**
270 * struct pisp_be_cdn_config - PiSP Back End CDN config
271 *
272 * Colour Denoise configuration
273 *
274 * @thresh: Constant for noise estimation
275 * @iir_strength: Relative strength of the IIR part of the filter
276 * @g_adjust: Proportion of the change assigned to the G channel
277 */
278 struct pisp_be_cdn_config {
279 __u16 thresh;
280 __u8 iir_strength;
281 __u8 g_adjust;
282 } __attribute__((packed));
283
284 #define PISP_BE_LSC_LOG_GRID_SIZE 5
285 #define PISP_BE_LSC_GRID_SIZE (1 << PISP_BE_LSC_LOG_GRID_SIZE)
286 #define PISP_BE_LSC_STEP_PRECISION 18
287
288 /**
289 * struct pisp_be_lsc_config - PiSP Back End LSC config
290 *
291 * Lens Shading Correction configuration
292 *
293 * @grid_step_x: Reciprocal of cell size width
294 * @grid_step_y: Reciprocal of cell size height
295 * @lut_packed: Jointly-coded RGB gains for each LSC grid
296 */
297 struct pisp_be_lsc_config {
298 /* (1<<18) / grid_cell_width */
299 __u16 grid_step_x;
300 /* (1<<18) / grid_cell_height */
301 __u16 grid_step_y;
302 /* RGB gains jointly encoded in 32 bits */
303 #define PISP_BE_LSC_LUT_SIZE (PISP_BE_LSC_GRID_SIZE + 1)
304 __u32 lut_packed[PISP_BE_LSC_LUT_SIZE][PISP_BE_LSC_LUT_SIZE];
305 } __attribute__((packed));
306
307 /**
308 * struct pisp_be_lsc_extra - PiSP Back End LSC Extra config
309 * @offset_x: Horizontal offset into the LSC table of this tile
310 * @offset_y: Vertical offset into the LSC table of this tile
311 */
312 struct pisp_be_lsc_extra {
313 __u16 offset_x;
314 __u16 offset_y;
315 } __attribute__((packed));
316
317 #define PISP_BE_CAC_LOG_GRID_SIZE 3
318 #define PISP_BE_CAC_GRID_SIZE (1 << PISP_BE_CAC_LOG_GRID_SIZE)
319 #define PISP_BE_CAC_STEP_PRECISION 20
320
321 /**
322 * struct pisp_be_cac_config - PiSP Back End CAC config
323 *
324 * Chromatic Aberration Correction config
325 *
326 * @grid_step_x: Reciprocal of cell size width
327 * @grid_step_y: Reciprocal of cell size height
328 * @lut: Pixel shift for the CAC grid
329 */
330 struct pisp_be_cac_config {
331 /* (1<<20) / grid_cell_width */
332 __u16 grid_step_x;
333 /* (1<<20) / grid_cell_height */
334 __u16 grid_step_y;
335 /* [gridy][gridx][rb][xy] */
336 #define PISP_BE_CAC_LUT_SIZE (PISP_BE_CAC_GRID_SIZE + 1)
337 __s8 lut[PISP_BE_CAC_LUT_SIZE][PISP_BE_CAC_LUT_SIZE][2][2];
338 } __attribute__((packed));
339
340 /**
341 * struct pisp_be_cac_extra - PiSP Back End CAC extra config
342 * @offset_x: Horizontal offset into the CAC table of this tile
343 * @offset_y: Horizontal offset into the CAC table of this tile
344 */
345 struct pisp_be_cac_extra {
346 __u16 offset_x;
347 __u16 offset_y;
348 } __attribute__((packed));
349
350 #define PISP_BE_DEBIN_NUM_COEFFS 4
351
352 /**
353 * struct pisp_be_debin_config - PiSP Back End Debin config
354 *
355 * Debinning configuration
356 *
357 * @coeffs: Filter coefficients for debinning
358 * @h_enable: Horizontal debinning enable
359 * @v_enable: Vertical debinning enable
360 * @pad: Padding bytes
361 */
362 struct pisp_be_debin_config {
363 __s8 coeffs[PISP_BE_DEBIN_NUM_COEFFS];
364 __s8 h_enable;
365 __s8 v_enable;
366 __s8 pad[2];
367 } __attribute__((packed));
368
369 #define PISP_BE_TONEMAP_LUT_SIZE 64
370
371 /**
372 * struct pisp_be_tonemap_config - PiSP Back End Tonemap config
373 *
374 * Tonemapping configuration
375 *
376 * @detail_constant: Constant value for threshold calculation
377 * @detail_slope: Slope value for threshold calculation
378 * @iir_strength: Relative strength of the IIR fiter
379 * @strength: Strength factor
380 * @lut: Look-up table for tonemap curve
381 */
382 struct pisp_be_tonemap_config {
383 __u16 detail_constant;
384 __u16 detail_slope;
385 __u16 iir_strength;
386 __u16 strength;
387 __u32 lut[PISP_BE_TONEMAP_LUT_SIZE];
388 } __attribute__((packed));
389
390 /**
391 * struct pisp_be_demosaic_config - PiSP Back End Demosaic config
392 *
393 * Demosaic configuration
394 *
395 * @sharper: Use other Bayer channels to increase sharpness
396 * @fc_mode: Built-in false colour suppression mode
397 * @pad: Padding bytes
398 */
399 struct pisp_be_demosaic_config {
400 __u8 sharper;
401 __u8 fc_mode;
402 __u8 pad[2];
403 } __attribute__((packed));
404
405 /**
406 * struct pisp_be_ccm_config - PiSP Back End CCM config
407 *
408 * Colour Correction Matrix configuration
409 *
410 * @coeffs: Matrix coefficients
411 * @pad: Padding bytes
412 * @offsets: Offsets triplet
413 */
414 struct pisp_be_ccm_config {
415 __s16 coeffs[9];
416 __u8 pad[2];
417 __s32 offsets[3];
418 } __attribute__((packed));
419
420 /**
421 * struct pisp_be_sat_control_config - PiSP Back End SAT config
422 *
423 * Saturation Control configuration
424 *
425 * @shift_r: Left shift for Red colour channel
426 * @shift_g: Left shift for Green colour channel
427 * @shift_b: Left shift for Blue colour channel
428 * @pad: Padding byte
429 */
430 struct pisp_be_sat_control_config {
431 __u8 shift_r;
432 __u8 shift_g;
433 __u8 shift_b;
434 __u8 pad;
435 } __attribute__((packed));
436
437 /**
438 * struct pisp_be_false_colour_config - PiSP Back End False Colour config
439 *
440 * False Colour configuration
441 *
442 * @distance: Distance of neighbouring pixels, either 1 or 2
443 * @pad: Padding bytes
444 */
445 struct pisp_be_false_colour_config {
446 __u8 distance;
447 __u8 pad[3];
448 } __attribute__((packed));
449
450 #define PISP_BE_SHARPEN_SIZE 5
451 #define PISP_BE_SHARPEN_FUNC_NUM_POINTS 9
452
453 /**
454 * struct pisp_be_sharpen_config - PiSP Back End Sharpening config
455 *
456 * Sharpening configuration
457 *
458 * @kernel0: Coefficient for filter 0
459 * @pad0: Padding byte
460 * @kernel1: Coefficient for filter 1
461 * @pad1: Padding byte
462 * @kernel2: Coefficient for filter 2
463 * @pad2: Padding byte
464 * @kernel3: Coefficient for filter 3
465 * @pad3: Padding byte
466 * @kernel4: Coefficient for filter 4
467 * @pad4: Padding byte
468 * @threshold_offset0: Offset for filter 0 response calculation
469 * @threshold_slope0: Slope multiplier for the filter 0 response calculation
470 * @scale0: Scale factor for filter 0 response calculation
471 * @pad5: Padding byte
472 * @threshold_offset1: Offset for filter 0 response calculation
473 * @threshold_slope1: Slope multiplier for the filter 0 response calculation
474 * @scale1: Scale factor for filter 0 response calculation
475 * @pad6: Padding byte
476 * @threshold_offset2: Offset for filter 0 response calculation
477 * @threshold_slope2: Slope multiplier for the filter 0 response calculation
478 * @scale2: Scale factor for filter 0 response calculation
479 * @pad7: Padding byte
480 * @threshold_offset3: Offset for filter 0 response calculation
481 * @threshold_slope3: Slope multiplier for the filter 0 response calculation
482 * @scale3: Scale factor for filter 0 response calculation
483 * @pad8: Padding byte
484 * @threshold_offset4: Offset for filter 0 response calculation
485 * @threshold_slope4: Slope multiplier for the filter 0 response calculation
486 * @scale4: Scale factor for filter 0 response calculation
487 * @pad9: Padding byte
488 * @positive_strength: Factor to scale the positive sharpening strength
489 * @positive_pre_limit: Maximum allowed possible positive sharpening value
490 * @positive_func: Gain factor applied to positive sharpening response
491 * @positive_limit: Final gain factor applied to positive sharpening
492 * @negative_strength: Factor to scale the negative sharpening strength
493 * @negative_pre_limit: Maximum allowed possible negative sharpening value
494 * @negative_func: Gain factor applied to negative sharpening response
495 * @negative_limit: Final gain factor applied to negative sharpening
496 * @enables: Filter enable mask
497 * @white: White output pixel filter mask
498 * @black: Black output pixel filter mask
499 * @grey: Grey output pixel filter mask
500 */
501 struct pisp_be_sharpen_config {
502 __s8 kernel0[PISP_BE_SHARPEN_SIZE * PISP_BE_SHARPEN_SIZE];
503 __s8 pad0[3];
504 __s8 kernel1[PISP_BE_SHARPEN_SIZE * PISP_BE_SHARPEN_SIZE];
505 __s8 pad1[3];
506 __s8 kernel2[PISP_BE_SHARPEN_SIZE * PISP_BE_SHARPEN_SIZE];
507 __s8 pad2[3];
508 __s8 kernel3[PISP_BE_SHARPEN_SIZE * PISP_BE_SHARPEN_SIZE];
509 __s8 pad3[3];
510 __s8 kernel4[PISP_BE_SHARPEN_SIZE * PISP_BE_SHARPEN_SIZE];
511 __s8 pad4[3];
512 __u16 threshold_offset0;
513 __u16 threshold_slope0;
514 __u16 scale0;
515 __u16 pad5;
516 __u16 threshold_offset1;
517 __u16 threshold_slope1;
518 __u16 scale1;
519 __u16 pad6;
520 __u16 threshold_offset2;
521 __u16 threshold_slope2;
522 __u16 scale2;
523 __u16 pad7;
524 __u16 threshold_offset3;
525 __u16 threshold_slope3;
526 __u16 scale3;
527 __u16 pad8;
528 __u16 threshold_offset4;
529 __u16 threshold_slope4;
530 __u16 scale4;
531 __u16 pad9;
532 __u16 positive_strength;
533 __u16 positive_pre_limit;
534 __u16 positive_func[PISP_BE_SHARPEN_FUNC_NUM_POINTS];
535 __u16 positive_limit;
536 __u16 negative_strength;
537 __u16 negative_pre_limit;
538 __u16 negative_func[PISP_BE_SHARPEN_FUNC_NUM_POINTS];
539 __u16 negative_limit;
540 __u8 enables;
541 __u8 white;
542 __u8 black;
543 __u8 grey;
544 } __attribute__((packed));
545
546 /**
547 * struct pisp_be_sh_fc_combine_config - PiSP Back End Sharpening and
548 * False Colour config
549 *
550 * Sharpening and False Colour configuration
551 *
552 * @y_factor: Control amount of desaturation of pixels being darkened
553 * @c1_factor: Control amount of brightening of a pixel for the Cb
554 * channel
555 * @c2_factor: Control amount of brightening of a pixel for the Cr
556 * channel
557 * @pad: Padding byte
558 */
559 struct pisp_be_sh_fc_combine_config {
560 __u8 y_factor;
561 __u8 c1_factor;
562 __u8 c2_factor;
563 __u8 pad;
564 } __attribute__((packed));
565
566 #define PISP_BE_GAMMA_LUT_SIZE 64
567
568 /**
569 * struct pisp_be_gamma_config - PiSP Back End Gamma configuration
570 * @lut: Gamma curve look-up table
571 */
572 struct pisp_be_gamma_config {
573 __u32 lut[PISP_BE_GAMMA_LUT_SIZE];
574 } __attribute__((packed));
575
576 /**
577 * struct pisp_be_crop_config - PiSP Back End Crop config
578 *
579 * Crop configuration
580 *
581 * @offset_x: Number of pixels cropped from the left of the tile
582 * @offset_y: Number of pixels cropped from the top of the tile
583 * @width: Width of the cropped tile output
584 * @height: Height of the cropped tile output
585 */
586 struct pisp_be_crop_config {
587 __u16 offset_x, offset_y;
588 __u16 width, height;
589 } __attribute__((packed));
590
591 #define PISP_BE_RESAMPLE_FILTER_SIZE 96
592
593 /**
594 * struct pisp_be_resample_config - PiSP Back End Resampling config
595 *
596 * Resample configuration
597 *
598 * @scale_factor_h: Horizontal scale factor
599 * @scale_factor_v: Vertical scale factor
600 * @coef: Resample coefficients
601 */
602 struct pisp_be_resample_config {
603 __u16 scale_factor_h, scale_factor_v;
604 __s16 coef[PISP_BE_RESAMPLE_FILTER_SIZE];
605 } __attribute__((packed));
606
607 /**
608 * struct pisp_be_resample_extra - PiSP Back End Resample config
609 *
610 * Resample configuration
611 *
612 * @scaled_width: Width in pixels of the scaled output
613 * @scaled_height: Height in pixels of the scaled output
614 * @initial_phase_h: Initial horizontal phase
615 * @initial_phase_v: Initial vertical phase
616 */
617 struct pisp_be_resample_extra {
618 __u16 scaled_width;
619 __u16 scaled_height;
620 __s16 initial_phase_h[3];
621 __s16 initial_phase_v[3];
622 } __attribute__((packed));
623
624 /**
625 * struct pisp_be_downscale_config - PiSP Back End Downscale config
626 *
627 * Downscale configuration
628 *
629 * @scale_factor_h: Horizontal scale factor
630 * @scale_factor_v: Vertical scale factor
631 * @scale_recip_h: Horizontal reciprocal factor
632 * @scale_recip_v: Vertical reciprocal factor
633 */
634 struct pisp_be_downscale_config {
635 __u16 scale_factor_h;
636 __u16 scale_factor_v;
637 __u16 scale_recip_h;
638 __u16 scale_recip_v;
639 } __attribute__((packed));
640
641 /**
642 * struct pisp_be_downscale_extra - PiSP Back End Downscale Extra config
643 * @scaled_width: Scaled image width
644 * @scaled_height: Scaled image height
645 */
646 struct pisp_be_downscale_extra {
647 __u16 scaled_width;
648 __u16 scaled_height;
649 } __attribute__((packed));
650
651 /**
652 * struct pisp_be_hog_config - PiSP Back End HOG config
653 *
654 * Histogram of Oriented Gradients configuration
655 *
656 * @compute_signed: Set 0 for unsigned gradients, 1 for signed
657 * @channel_mix: Channels proportions to use
658 * @stride: Stride in bytes between blocks directly below
659 */
660 struct pisp_be_hog_config {
661 __u8 compute_signed;
662 __u8 channel_mix[3];
663 __u32 stride;
664 } __attribute__((packed));
665
666 struct pisp_be_axi_config {
667 __u8 r_qos; /* Read QoS */
668 __u8 r_cache_prot; /* Read { prot[2:0], cache[3:0] } */
669 __u8 w_qos; /* Write QoS */
670 __u8 w_cache_prot; /* Write { prot[2:0], cache[3:0] } */
671 } __attribute__((packed));
672
673 /**
674 * enum pisp_be_transform - PiSP Back End Transform flags
675 * @PISP_BE_TRANSFORM_NONE: No transform
676 * @PISP_BE_TRANSFORM_HFLIP: Horizontal flip
677 * @PISP_BE_TRANSFORM_VFLIP: Vertical flip
678 * @PISP_BE_TRANSFORM_ROT180: 180 degress rotation
679 */
680 enum pisp_be_transform {
681 PISP_BE_TRANSFORM_NONE = 0x0,
682 PISP_BE_TRANSFORM_HFLIP = 0x1,
683 PISP_BE_TRANSFORM_VFLIP = 0x2,
684 PISP_BE_TRANSFORM_ROT180 =
685 (PISP_BE_TRANSFORM_HFLIP | PISP_BE_TRANSFORM_VFLIP)
686 };
687
688 struct pisp_be_output_format_config {
689 struct pisp_image_format_config image;
690 __u8 transform;
691 __u8 pad[3];
692 __u16 lo;
693 __u16 hi;
694 __u16 lo2;
695 __u16 hi2;
696 } __attribute__((packed));
697
698 /**
699 * struct pisp_be_output_buffer_config - PiSP Back End Output buffer
700 * @addr: Output buffer address
701 */
702 struct pisp_be_output_buffer_config {
703 /* low 32 bits followed by high 32 bits (for each of 3 planes) */
704 __u32 addr[3][2];
705 } __attribute__((packed));
706
707 /**
708 * struct pisp_be_hog_buffer_config - PiSP Back End HOG buffer
709 * @addr: HOG buffer address
710 */
711 struct pisp_be_hog_buffer_config {
712 /* low 32 bits followed by high 32 bits */
713 __u32 addr[2];
714 } __attribute__((packed));
715
716 /**
717 * struct pisp_be_config - RaspberryPi PiSP Back End Processing configuration
718 *
719 * @input_buffer: Input buffer addresses
720 * @tdn_input_buffer: TDN input buffer addresses
721 * @stitch_input_buffer: Stitch input buffer addresses
722 * @tdn_output_buffer: TDN output buffer addresses
723 * @stitch_output_buffer: Stitch output buffer addresses
724 * @output_buffer: Output buffers addresses
725 * @hog_buffer: HOG buffer addresses
726 * @global: Global PiSP configuration
727 * @input_format: Input image format
728 * @decompress: Decompress configuration
729 * @dpc: Defective Pixel Correction configuration
730 * @geq: Green Equalisation configuration
731 * @tdn_input_format: Temporal Denoise input format
732 * @tdn_decompress: Temporal Denoise decompress configuration
733 * @tdn: Temporal Denoise configuration
734 * @tdn_compress: Temporal Denoise compress configuration
735 * @tdn_output_format: Temporal Denoise output format
736 * @sdn: Spatial Denoise configuration
737 * @blc: Black Level Correction configuration
738 * @stitch_compress: Stitch compress configuration
739 * @stitch_output_format: Stitch output format
740 * @stitch_input_format: Stitch input format
741 * @stitch_decompress: Stitch decompress configuration
742 * @stitch: Stitch configuration
743 * @lsc: Lens Shading Correction configuration
744 * @wbg: White Balance Gain configuration
745 * @cdn: Colour Denoise configuration
746 * @cac: Colour Aberration Correction configuration
747 * @debin: Debinning configuration
748 * @tonemap: Tonemapping configuration
749 * @demosaic: Demosaicing configuration
750 * @ccm: Colour Correction Matrix configuration
751 * @sat_control: Saturation Control configuration
752 * @ycbcr: YCbCr colour correction configuration
753 * @sharpen: Sharpening configuration
754 * @false_colour: False colour correction
755 * @sh_fc_combine: Sharpening and False Colour correction
756 * @ycbcr_inverse: Inverse YCbCr colour correction
757 * @gamma: Gamma curve configuration
758 * @csc: Color Space Conversion configuration
759 * @downscale: Downscale configuration
760 * @resample: Resampling configuration
761 * @output_format: Output format configuration
762 * @hog: HOG configuration
763 * @axi: AXI bus configuration
764 * @lsc_extra: LSC extra info
765 * @cac_extra: CAC extra info
766 * @downscale_extra: Downscaler extra info
767 * @resample_extra: Resample extra info
768 * @crop: Crop configuration
769 * @hog_format: HOG format info
770 * @dirty_flags_bayer: Bayer enable dirty flags
771 * (:c:type:`pisp_be_bayer_enable`)
772 * @dirty_flags_rgb: RGB enable dirty flags
773 * (:c:type:`pisp_be_rgb_enable`)
774 * @dirty_flags_extra: Extra dirty flags
775 */
776 struct pisp_be_config {
777 /* I/O configuration: */
778 struct pisp_be_input_buffer_config input_buffer;
779 struct pisp_be_tdn_input_buffer_config tdn_input_buffer;
780 struct pisp_be_stitch_input_buffer_config stitch_input_buffer;
781 struct pisp_be_tdn_output_buffer_config tdn_output_buffer;
782 struct pisp_be_stitch_output_buffer_config stitch_output_buffer;
783 struct pisp_be_output_buffer_config
784 output_buffer[PISP_BACK_END_NUM_OUTPUTS];
785 struct pisp_be_hog_buffer_config hog_buffer;
786 /* Processing configuration: */
787 struct pisp_be_global_config global;
788 struct pisp_image_format_config input_format;
789 struct pisp_decompress_config decompress;
790 struct pisp_be_dpc_config dpc;
791 struct pisp_be_geq_config geq;
792 struct pisp_image_format_config tdn_input_format;
793 struct pisp_decompress_config tdn_decompress;
794 struct pisp_be_tdn_config tdn;
795 struct pisp_compress_config tdn_compress;
796 struct pisp_image_format_config tdn_output_format;
797 struct pisp_be_sdn_config sdn;
798 struct pisp_bla_config blc;
799 struct pisp_compress_config stitch_compress;
800 struct pisp_image_format_config stitch_output_format;
801 struct pisp_image_format_config stitch_input_format;
802 struct pisp_decompress_config stitch_decompress;
803 struct pisp_be_stitch_config stitch;
804 struct pisp_be_lsc_config lsc;
805 struct pisp_wbg_config wbg;
806 struct pisp_be_cdn_config cdn;
807 struct pisp_be_cac_config cac;
808 struct pisp_be_debin_config debin;
809 struct pisp_be_tonemap_config tonemap;
810 struct pisp_be_demosaic_config demosaic;
811 struct pisp_be_ccm_config ccm;
812 struct pisp_be_sat_control_config sat_control;
813 struct pisp_be_ccm_config ycbcr;
814 struct pisp_be_sharpen_config sharpen;
815 struct pisp_be_false_colour_config false_colour;
816 struct pisp_be_sh_fc_combine_config sh_fc_combine;
817 struct pisp_be_ccm_config ycbcr_inverse;
818 struct pisp_be_gamma_config gamma;
819 struct pisp_be_ccm_config csc[PISP_BACK_END_NUM_OUTPUTS];
820 struct pisp_be_downscale_config downscale[PISP_BACK_END_NUM_OUTPUTS];
821 struct pisp_be_resample_config resample[PISP_BACK_END_NUM_OUTPUTS];
822 struct pisp_be_output_format_config
823 output_format[PISP_BACK_END_NUM_OUTPUTS];
824 struct pisp_be_hog_config hog;
825 struct pisp_be_axi_config axi;
826 /* Non-register fields: */
827 struct pisp_be_lsc_extra lsc_extra;
828 struct pisp_be_cac_extra cac_extra;
829 struct pisp_be_downscale_extra
830 downscale_extra[PISP_BACK_END_NUM_OUTPUTS];
831 struct pisp_be_resample_extra resample_extra[PISP_BACK_END_NUM_OUTPUTS];
832 struct pisp_be_crop_config crop;
833 struct pisp_image_format_config hog_format;
834 __u32 dirty_flags_bayer; /* these use pisp_be_bayer_enable */
835 __u32 dirty_flags_rgb; /* use pisp_be_rgb_enable */
836 __u32 dirty_flags_extra; /* these use pisp_be_dirty_t */
837 } __attribute__((packed));
838
839 /**
840 * enum pisp_tile_edge - PiSP Back End Tile position
841 * @PISP_LEFT_EDGE: Left edge tile
842 * @PISP_RIGHT_EDGE: Right edge tile
843 * @PISP_TOP_EDGE: Top edge tile
844 * @PISP_BOTTOM_EDGE: Bottom edge tile
845 */
846 enum pisp_tile_edge {
847 PISP_LEFT_EDGE = (1 << 0),
848 PISP_RIGHT_EDGE = (1 << 1),
849 PISP_TOP_EDGE = (1 << 2),
850 PISP_BOTTOM_EDGE = (1 << 3)
851 };
852
853 /**
854 * struct pisp_tile - Raspberry Pi PiSP Back End tile configuration
855 *
856 * Tile parameters: each set of tile parameters is a 160-bytes block of data
857 * which contains the tile processing parameters.
858 *
859 * @edge: Edge tile flag
860 * @pad0: Padding bytes
861 * @input_addr_offset: Top-left pixel offset, in bytes
862 * @input_addr_offset2: Top-left pixel offset, in bytes for the second/
863 * third image planes
864 * @input_offset_x: Horizontal offset in pixels of this tile in the
865 * input image
866 * @input_offset_y: Vertical offset in pixels of this tile in the
867 * input image
868 * @input_width: Width in pixels of this tile
869 * @input_height: Height in pixels of the this tile
870 * @tdn_input_addr_offset: TDN input image offset, in bytes
871 * @tdn_output_addr_offset: TDN output image offset, in bytes
872 * @stitch_input_addr_offset: Stitch input image offset, in bytes
873 * @stitch_output_addr_offset: Stitch output image offset, in bytes
874 * @lsc_grid_offset_x: Horizontal offset in the LSC table for this tile
875 * @lsc_grid_offset_y: Vertical offset in the LSC table for this tile
876 * @cac_grid_offset_x: Horizontal offset in the CAC table for this tile
877 * @cac_grid_offset_y: Horizontal offset in the CAC table for this tile
878 * @crop_x_start: Number of pixels cropped from the left of the
879 * tile
880 * @crop_x_end: Number of pixels cropped from the right of the
881 * tile
882 * @crop_y_start: Number of pixels cropped from the top of the
883 * tile
884 * @crop_y_end: Number of pixels cropped from the bottom of the
885 * tile
886 * @downscale_phase_x: Initial horizontal phase in pixels
887 * @downscale_phase_y: Initial vertical phase in pixels
888 * @resample_in_width: Width in pixels of the tile entering the
889 * Resample block
890 * @resample_in_height: Height in pixels of the tile entering the
891 * Resample block
892 * @resample_phase_x: Initial horizontal phase for the Resample block
893 * @resample_phase_y: Initial vertical phase for the Resample block
894 * @output_offset_x: Horizontal offset in pixels where the tile will
895 * be written into the output image
896 * @output_offset_y: Vertical offset in pixels where the tile will be
897 * written into the output image
898 * @output_width: Width in pixels in the output image of this tile
899 * @output_height: Height in pixels in the output image of this tile
900 * @output_addr_offset: Offset in bytes into the output buffer
901 * @output_addr_offset2: Offset in bytes into the output buffer for the
902 * second and third plane
903 * @output_hog_addr_offset: Offset in bytes into the HOG buffer where
904 * results of this tile are to be written
905 */
906 struct pisp_tile {
907 __u8 edge; /* enum pisp_tile_edge */
908 __u8 pad0[3];
909 /* 4 bytes */
910 __u32 input_addr_offset;
911 __u32 input_addr_offset2;
912 __u16 input_offset_x;
913 __u16 input_offset_y;
914 __u16 input_width;
915 __u16 input_height;
916 /* 20 bytes */
917 __u32 tdn_input_addr_offset;
918 __u32 tdn_output_addr_offset;
919 __u32 stitch_input_addr_offset;
920 __u32 stitch_output_addr_offset;
921 /* 36 bytes */
922 __u32 lsc_grid_offset_x;
923 __u32 lsc_grid_offset_y;
924 /* 44 bytes */
925 __u32 cac_grid_offset_x;
926 __u32 cac_grid_offset_y;
927 /* 52 bytes */
928 __u16 crop_x_start[PISP_BACK_END_NUM_OUTPUTS];
929 __u16 crop_x_end[PISP_BACK_END_NUM_OUTPUTS];
930 __u16 crop_y_start[PISP_BACK_END_NUM_OUTPUTS];
931 __u16 crop_y_end[PISP_BACK_END_NUM_OUTPUTS];
932 /* 68 bytes */
933 /* Ordering is planes then branches */
934 __u16 downscale_phase_x[3 * PISP_BACK_END_NUM_OUTPUTS];
935 __u16 downscale_phase_y[3 * PISP_BACK_END_NUM_OUTPUTS];
936 /* 92 bytes */
937 __u16 resample_in_width[PISP_BACK_END_NUM_OUTPUTS];
938 __u16 resample_in_height[PISP_BACK_END_NUM_OUTPUTS];
939 /* 100 bytes */
940 /* Ordering is planes then branches */
941 __u16 resample_phase_x[3 * PISP_BACK_END_NUM_OUTPUTS];
942 __u16 resample_phase_y[3 * PISP_BACK_END_NUM_OUTPUTS];
943 /* 124 bytes */
944 __u16 output_offset_x[PISP_BACK_END_NUM_OUTPUTS];
945 __u16 output_offset_y[PISP_BACK_END_NUM_OUTPUTS];
946 __u16 output_width[PISP_BACK_END_NUM_OUTPUTS];
947 __u16 output_height[PISP_BACK_END_NUM_OUTPUTS];
948 /* 140 bytes */
949 __u32 output_addr_offset[PISP_BACK_END_NUM_OUTPUTS];
950 __u32 output_addr_offset2[PISP_BACK_END_NUM_OUTPUTS];
951 /* 156 bytes */
952 __u32 output_hog_addr_offset;
953 /* 160 bytes */
954 } __attribute__((packed));
955
956 /**
957 * struct pisp_be_tiles_config - Raspberry Pi PiSP Back End configuration
958 * @tiles: Tile descriptors
959 * @num_tiles: Number of tiles
960 * @config: PiSP Back End configuration
961 */
962 struct pisp_be_tiles_config {
963 struct pisp_be_config config;
964 struct pisp_tile tiles[PISP_BACK_END_NUM_TILES];
965 __u32 num_tiles;
966 } __attribute__((packed));
967
968 #endif /* _UAPI_PISP_BE_CONFIG_H_ */
969
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.