2.13.3. V4L2_META_FMT_IPU3_PARAMS (‘ip3p’), V4L2_META_FMT_IPU3_3A (‘ip3s’)¶
2.13.3.1. 3A statistics¶
The IPU3 ImgU 3A statistics accelerators collect different statistics over
an input Bayer frame. Those statistics are obtained from the “ipu3-imgu [01] 3a
stat” metadata capture video nodes, using the v4l2_meta_format
interface. They are formatted as described by the ipu3_uapi_stats_3a
structure.
The statistics collected are AWB (Auto-white balance) RGBS (Red, Green, Blue and Saturation measure) cells, AWB filter response, AF (Auto-focus) filter response, and AE (Auto-exposure) histogram.
The struct ipu3_uapi_4a_config saves all configurable parameters.
struct ipu3_uapi_stats_3a {
struct ipu3_uapi_awb_raw_buffer awb_raw_buffer;
struct ipu3_uapi_ae_raw_buffer_aligned ae_raw_buffer[IPU3_UAPI_MAX_STRIPES];
struct ipu3_uapi_af_raw_buffer af_raw_buffer;
struct ipu3_uapi_awb_fr_raw_buffer awb_fr_raw_buffer;
struct ipu3_uapi_4a_config stats_4a_config;
__u32 ae_join_buffers;
__u8 padding[28];
struct ipu3_uapi_stats_3a_bubble_info_per_stripe stats_3a_bubble_per_stripe;
struct ipu3_uapi_ff_status stats_3a_status;
};
2.13.3.2. Pipeline parameters¶
The pipeline parameters are passed to the “ipu3-imgu [01] parameters” metadata
output video nodes, using the v4l2_meta_format interface. They are
formatted as described by the ipu3_uapi_params structure.
Both 3A statistics and pipeline parameters described here are closely tied to the underlying camera sub-system (CSS) APIs. They are usually consumed and produced by dedicated user space libraries that comprise the important tuning tools, thus freeing the developers from being bothered with the low level hardware and algorithm details.
struct ipu3_uapi_params {
/* Flags which of the settings below are to be applied */
struct ipu3_uapi_flags use;
/* Accelerator cluster parameters */
struct ipu3_uapi_acc_param acc_param;
/* ISP vector address space parameters */
struct ipu3_uapi_isp_lin_vmem_params lin_vmem_params;
struct ipu3_uapi_isp_tnr3_vmem_params tnr3_vmem_params;
struct ipu3_uapi_isp_xnr3_vmem_params xnr3_vmem_params;
/* ISP data memory (DMEM) parameters */
struct ipu3_uapi_isp_tnr3_params tnr3_dmem_params;
struct ipu3_uapi_isp_xnr3_params xnr3_dmem_params;
/* Optical black level compensation */
struct ipu3_uapi_obgrid_param obgrid_param;
};
2.13.3.3. Intel IPU3 ImgU uAPI data types¶
-
struct ipu3_uapi_grid_config¶
Grid plane config
Definition:
struct ipu3_uapi_grid_config {
__u8 width;
__u8 height;
__u16 block_width_log2:3;
__u16 block_height_log2:3;
__u16 height_per_slice:8;
__u16 x_start;
__u16 y_start;
__u16 x_end;
__u16 y_end;
};
Members
widthGrid horizontal dimensions, in number of grid blocks(cells). For AWB, the range is (16, 80). For AF/AE, the range is (16, 32).
heightGrid vertical dimensions, in number of grid cells. For AWB, the range is (16, 60). For AF/AE, the range is (16, 24).
block_width_log2Log2 of the width of each cell in pixels. For AWB, the range is [3, 6]. For AF/AE, the range is [3, 7].
block_height_log2Log2 of the height of each cell in pixels. For AWB, the range is [3, 6]. For AF/AE, the range is [3, 7].
height_per_sliceThe number of blocks in vertical axis per slice. Default 2.
x_startX value of top left corner of Region of Interest(ROI).
y_startY value of top left corner of ROI
x_endX value of bottom right corner of ROI
y_endY value of bottom right corner of ROI
Description
Due to the size of total amount of collected data, most statistics create a grid-based output, and the data is then divided into “slices”.
-
struct ipu3_uapi_awb_set_item¶
Memory layout for each cell in AWB
Definition:
struct ipu3_uapi_awb_set_item {
__u8 Gr_avg;
__u8 R_avg;
__u8 B_avg;
__u8 Gb_avg;
__u8 sat_ratio;
__u8 padding0;
__u8 padding1;
__u8 padding2;
};
Members
Gr_avgGreen average for red lines in the cell.
R_avgRed average in the cell.
B_avgBlue average in the cell.
Gb_avgGreen average for blue lines in the cell.
sat_ratioPercentage of pixels over the thresholds specified in ipu3_uapi_awb_config_s, coded from 0 to 255.
padding0Unused byte for padding.
padding1Unused byte for padding.
padding2Unused byte for padding.
-
struct ipu3_uapi_awb_raw_buffer¶
AWB raw buffer
Definition:
struct ipu3_uapi_awb_raw_buffer {
struct ipu3_uapi_awb_set_item meta_data[IPU3_UAPI_AWB_MAX_BUFFER_SIZE] ;
};
Members
meta_databuffer to hold auto white balance meta data which is the average values for each color channel.
-
struct ipu3_uapi_awb_config_s¶
AWB config
Definition:
struct ipu3_uapi_awb_config_s {
__u16 rgbs_thr_gr;
__u16 rgbs_thr_r;
__u16 rgbs_thr_gb;
__u16 rgbs_thr_b;
struct ipu3_uapi_grid_config grid;
};
Members
rgbs_thr_grgr threshold value.
rgbs_thr_rRed threshold value.
rgbs_thr_gbgb threshold value.
rgbs_thr_bBlue threshold value.
gridipu3_uapi_grid_config, the default grid resolution is 16x16 cells.
Description
The threshold is a saturation measure range [0, 8191], 8191 is default. Values over threshold may be optionally rejected for averaging.
-
struct ipu3_uapi_awb_config¶
AWB config wrapper
Definition:
struct ipu3_uapi_awb_config {
struct ipu3_uapi_awb_config_s config ;
};
Members
configconfig for auto white balance as defined by
ipu3_uapi_awb_config_s
-
struct ipu3_uapi_ae_raw_buffer¶
AE global weighted histogram
Definition:
struct ipu3_uapi_ae_raw_buffer {
__u32 vals[IPU3_UAPI_AE_BINS * IPU3_UAPI_AE_COLORS];
};
Members
valsSum of IPU3_UAPI_AE_COLORS in cell
Description
Each histogram contains IPU3_UAPI_AE_BINS bins. Each bin has 24 bit unsigned for counting the number of the pixel.
-
struct ipu3_uapi_ae_raw_buffer_aligned¶
AE raw buffer
Definition:
struct ipu3_uapi_ae_raw_buffer_aligned {
struct ipu3_uapi_ae_raw_buffer buff ;
};
Members
buffipu3_uapi_ae_raw_bufferto hold full frame meta data.
-
struct ipu3_uapi_ae_grid_config¶
AE weight grid
Definition:
struct ipu3_uapi_ae_grid_config {
__u8 width;
__u8 height;
__u8 block_width_log2:4;
__u8 block_height_log2:4;
__u8 reserved0:5;
__u8 ae_en:1;
__u8 rst_hist_array:1;
__u8 done_rst_hist_array:1;
__u16 x_start;
__u16 y_start;
__u16 x_end;
__u16 y_end;
};
Members
widthGrid horizontal dimensions. Value: [16, 32], default 16.
heightGrid vertical dimensions. Value: [16, 24], default 16.
block_width_log2Log2 of the width of the grid cell, value: [3, 7].
block_height_log2Log2 of the height of the grid cell, value: [3, 7]. default is 3 (cell size 8x8), 4 cell per grid.
reserved0reserved
ae_en0: does not write to
ipu3_uapi_ae_raw_buffer_alignedarray, 1: write normally.rst_hist_arraywrite 1 to trigger histogram array reset.
done_rst_hist_arrayflag for histogram array reset done.
x_startX value of top left corner of ROI, default 0.
y_startY value of top left corner of ROI, default 0.
x_endX value of bottom right corner of ROI
y_endY value of bottom right corner of ROI
Description
The AE block accumulates 4 global weighted histograms(R, G, B, Y) over
a defined ROI within the frame. The contribution of each pixel into the
histogram, defined by ipu3_uapi_ae_weight_elem LUT, is indexed by a grid.
-
struct ipu3_uapi_ae_weight_elem¶
AE weights LUT
Definition:
struct ipu3_uapi_ae_weight_elem {
__u32 cell0:4;
__u32 cell1:4;
__u32 cell2:4;
__u32 cell3:4;
__u32 cell4:4;
__u32 cell5:4;
__u32 cell6:4;
__u32 cell7:4;
};
Members
cell0weighted histogram grid value.
cell1weighted histogram grid value.
cell2weighted histogram grid value.
cell3weighted histogram grid value.
cell4weighted histogram grid value.
cell5weighted histogram grid value.
cell6weighted histogram grid value.
cell7weighted histogram grid value.
Description
Use weighted grid value to give a different contribution factor to each cell. Precision u4, range [0, 15].
-
struct ipu3_uapi_ae_ccm¶
AE coefficients for WB and CCM
Definition:
struct ipu3_uapi_ae_ccm {
__u16 gain_gr;
__u16 gain_r;
__u16 gain_b;
__u16 gain_gb;
__s16 mat[16];
};
Members
gain_grWB gain factor for the gr channels. Default 256.
gain_rWB gain factor for the r channel. Default 256.
gain_bWB gain factor for the b channel. Default 256.
gain_gbWB gain factor for the gb channels. Default 256.
mat4x4 matrix that transforms Bayer quad output from WB to RGB+Y.
Description
- Default:
128, 0, 0, 0, 0, 128, 0, 0, 0, 0, 128, 0, 0, 0, 0, 128,
As part of the raw frame pre-process stage, the WB and color conversion need to be applied to expose the impact of these gain operations.
-
struct ipu3_uapi_ae_config¶
AE config
Definition:
struct ipu3_uapi_ae_config {
struct ipu3_uapi_ae_grid_config grid_cfg ;
struct ipu3_uapi_ae_weight_elem weights[IPU3_UAPI_AE_WEIGHTS] ;
struct ipu3_uapi_ae_ccm ae_ccm ;
};
Members
grid_cfgconfig for auto exposure statistics grid. See struct
ipu3_uapi_ae_grid_config, as Imgu did not support output auto exposure statistics, so user can ignore this configuration and use the RGB table in auto-whitebalance statistics instead.weightsIPU3_UAPI_AE_WEIGHTSis based on 32x24 blocks in the grid. Each grid cell has a corresponding value in weights LUT called grid value, global histogram is updated based on grid value and pixel value.ae_ccmColor convert matrix pre-processing block.
Description
Calculate AE grid from image resolution, resample ae weights.
-
struct ipu3_uapi_af_filter_config¶
AF 2D filter for contrast measurements
Definition:
struct ipu3_uapi_af_filter_config {
struct {
__u8 a1;
__u8 a2;
__u8 a3;
__u8 a4;
} y1_coeff_0;
struct {
__u8 a5;
__u8 a6;
__u8 a7;
__u8 a8;
} y1_coeff_1;
struct {
__u8 a9;
__u8 a10;
__u8 a11;
__u8 a12;
} y1_coeff_2;
__u32 y1_sign_vec;
struct {
__u8 a1;
__u8 a2;
__u8 a3;
__u8 a4;
} y2_coeff_0;
struct {
__u8 a5;
__u8 a6;
__u8 a7;
__u8 a8;
} y2_coeff_1;
struct {
__u8 a9;
__u8 a10;
__u8 a11;
__u8 a12;
} y2_coeff_2;
__u32 y2_sign_vec;
struct {
__u8 y_gen_rate_gr;
__u8 y_gen_rate_r;
__u8 y_gen_rate_b;
__u8 y_gen_rate_gb;
} y_calc;
struct {
__u32 reserved0:8;
__u32 y1_nf:4;
__u32 reserved1:4;
__u32 y2_nf:4;
__u32 reserved2:12;
} nf;
};
Members
y1_coeff_0filter Y1, structure: 3x11, support both symmetry and anti-symmetry type. A12 is center, A1-A11 are neighbours. for analyzing low frequency content, used to calculate sum of gradients in x direction.
y1_coeff_0.a1filter1 coefficients A1, u8, default 0.
y1_coeff_0.a2filter1 coefficients A2, u8, default 0.
y1_coeff_0.a3filter1 coefficients A3, u8, default 0.
y1_coeff_0.a4filter1 coefficients A4, u8, default 0.
y1_coeff_1Struct
y1_coeff_1.a5filter1 coefficients A5, u8, default 0.
y1_coeff_1.a6filter1 coefficients A6, u8, default 0.
y1_coeff_1.a7filter1 coefficients A7, u8, default 0.
y1_coeff_1.a8filter1 coefficients A8, u8, default 0.
y1_coeff_2Struct
y1_coeff_2.a9filter1 coefficients A9, u8, default 0.
y1_coeff_2.a10filter1 coefficients A10, u8, default 0.
y1_coeff_2.a11filter1 coefficients A11, u8, default 0.
y1_coeff_2.a12filter1 coefficients A12, u8, default 128.
y1_sign_vecEach bit corresponds to one coefficient sign bit, 0: positive, 1: negative, default 0.
y2_coeff_0Y2, same structure as Y1. For analyzing high frequency content.
y2_coeff_0.a1filter2 coefficients A1, u8, default 0.
y2_coeff_0.a2filter2 coefficients A2, u8, default 0.
y2_coeff_0.a3filter2 coefficients A3, u8, default 0.
y2_coeff_0.a4filter2 coefficients A4, u8, default 0.
y2_coeff_1Struct
y2_coeff_1.a5filter2 coefficients A5, u8, default 0.
y2_coeff_1.a6filter2 coefficients A6, u8, default 0.
y2_coeff_1.a7filter2 coefficients A7, u8, default 0.
y2_coeff_1.a8filter2 coefficients A8, u8, default 0.
y2_coeff_2Struct
y2_coeff_2.a9filter1 coefficients A9, u8, default 0.
y2_coeff_2.a10filter1 coefficients A10, u8, default 0.
y2_coeff_2.a11filter1 coefficients A11, u8, default 0.
y2_coeff_2.a12filter1 coefficients A12, u8, default 128.
y2_sign_vecEach bit corresponds to one coefficient sign bit, 0: positive, 1: negative, default 0.
y_calcPre-processing that converts Bayer quad to RGB+Y values to be used for building histogram. Range [0, 32], default 8. Rule: y_gen_rate_gr + y_gen_rate_r + y_gen_rate_b + y_gen_rate_gb = 32 A single Y is calculated based on sum of Gr/R/B/Gb based on their contribution ratio.
y_calc.y_gen_rate_grContribution ratio Gr for Y
y_calc.y_gen_rate_rContribution ratio R for Y
y_calc.y_gen_rate_bContribution ratio B for Y
y_calc.y_gen_rate_gbContribution ratio Gb for Y
nfThe shift right value that should be applied during the Y1/Y2 filter to make sure the total memory needed is 2 bytes per grid cell.
nf.reserved0reserved
nf.y1_nfNormalization factor for the convolution coeffs of y1, should be log2 of the sum of the abs values of the filter coeffs, default 7 (2^7 = 128).
nf.reserved1reserved
nf.y2_nfNormalization factor for y2, should be log2 of the sum of the abs values of the filter coeffs.
nf.reserved2reserved
-
struct ipu3_uapi_af_raw_buffer¶
AF meta data
Definition:
struct ipu3_uapi_af_raw_buffer {
__u8 y_table[IPU3_UAPI_AF_Y_TABLE_MAX_SIZE] ;
};
Members
y_tableEach color component will be convolved separately with filter1 and filter2 and the result will be summed out and averaged for each cell.
-
struct ipu3_uapi_af_config_s¶
AF config
Definition:
struct ipu3_uapi_af_config_s {
struct ipu3_uapi_af_filter_config filter_config ;
__u8 padding[4];
struct ipu3_uapi_grid_config grid_cfg ;
};
Members
filter_configAF uses Y1 and Y2 filters as configured in
ipu3_uapi_af_filter_configpaddingpaddings
grid_cfgSee
ipu3_uapi_grid_config, default resolution 16x16. Use large grid size for large image and vice versa.
-
struct ipu3_uapi_awb_fr_raw_buffer¶
AWB filter response meta data
Definition:
struct ipu3_uapi_awb_fr_raw_buffer {
__u8 meta_data[IPU3_UAPI_AWB_FR_BAYER_TABLE_MAX_SIZE] ;
};
Members
meta_dataStatistics output on the grid after convolving with 1D filter.
-
struct ipu3_uapi_awb_fr_config_s¶
AWB filter response config
Definition:
struct ipu3_uapi_awb_fr_config_s {
struct ipu3_uapi_grid_config grid_cfg;
__u8 bayer_coeff[6];
__u16 reserved1;
__u32 bayer_sign;
__u8 bayer_nf;
__u8 reserved2[7];
};
Members
grid_cfggrid config, default 16x16.
bayer_coeff1D Filter 1x11 center symmetry/anti-symmetry. coefficients defaults { 0, 0, 0, 0, 0, 128 }. Applied on whole image for each Bayer channel separately by a weighted sum of its 11x1 neighbors.
reserved1reserved
bayer_signsign of filter coefficients, default 0.
bayer_nfnormalization factor for the convolution coeffs, to make sure total memory needed is within pre-determined range. NF should be the log2 of the sum of the abs values of the filter coeffs, range [7, 14], default 7.
reserved2reserved
-
struct ipu3_uapi_4a_config¶
4A config
Definition:
struct ipu3_uapi_4a_config {
struct ipu3_uapi_awb_config_s awb_config ;
struct ipu3_uapi_ae_grid_config ae_grd_config;
__u8 padding[20];
struct ipu3_uapi_af_config_s af_config;
struct ipu3_uapi_awb_fr_config_s awb_fr_config ;
};
Members
awb_configipu3_uapi_awb_config_s, default resolution 16x16ae_grd_configauto exposure statistics
ipu3_uapi_ae_grid_configpaddingpaddings
af_configauto focus config
ipu3_uapi_af_config_sawb_fr_configipu3_uapi_awb_fr_config_s, default resolution 16x16
-
struct ipu3_uapi_bubble_info¶
Bubble info for host side debugging
Definition:
struct ipu3_uapi_bubble_info {
__u32 num_of_stripes ;
__u8 padding[28];
__u32 num_sets;
__u8 padding1[28];
__u32 size_of_set;
__u8 padding2[28];
__u32 bubble_size;
__u8 padding3[28];
};
Members
num_of_stripesA single frame is divided into several parts called stripes due to limitation on line buffer memory. The separation between the stripes is vertical. Each such stripe is processed as a single frame by the ISP pipe.
paddingpadding bytes.
num_setsnumber of sets.
padding1padding bytes.
size_of_setset size.
padding2padding bytes.
bubble_sizeis the amount of padding in the bubble expressed in “sets”.
padding3padding bytes.
-
struct ipu3_uapi_ff_status¶
Enable bits for each 3A fixed function
Definition:
struct ipu3_uapi_ff_status {
__u32 awb_en ;
__u8 padding[28];
__u32 ae_en;
__u8 padding1[28];
__u32 af_en;
__u8 padding2[28];
__u32 awb_fr_en;
__u8 padding3[28];
};
Members
awb_enauto white balance enable
paddingpadding config
ae_enauto exposure enable
padding1padding config
af_enauto focus enable
padding2padding config
awb_fr_enawb filter response enable bit
padding3padding config
-
struct ipu3_uapi_stats_3a¶
3A statistics
Definition:
struct ipu3_uapi_stats_3a {
struct ipu3_uapi_awb_raw_buffer awb_raw_buffer;
struct ipu3_uapi_ae_raw_buffer_aligned ae_raw_buffer[IPU3_UAPI_MAX_STRIPES];
struct ipu3_uapi_af_raw_buffer af_raw_buffer;
struct ipu3_uapi_awb_fr_raw_buffer awb_fr_raw_buffer;
struct ipu3_uapi_4a_config stats_4a_config;
__u32 ae_join_buffers;
__u8 padding[28];
struct ipu3_uapi_stats_3a_bubble_info_per_stripe stats_3a_bubble_per_stripe;
struct ipu3_uapi_ff_status stats_3a_status;
};
Members
awb_raw_bufferauto white balance meta data
ipu3_uapi_awb_raw_bufferae_raw_bufferauto exposure raw data
ipu3_uapi_ae_raw_buffer_alignedcurrent Imgu does not output the auto exposure statistics to ae_raw_buffer, the user such as 3A algorithm can use the RGB table inipu3_uapi_awb_raw_bufferto do auto-exposure.af_raw_bufferipu3_uapi_af_raw_bufferfor auto focus meta dataawb_fr_raw_buffervalue as specified by
ipu3_uapi_awb_fr_raw_bufferstats_4a_config4a statistics config as defined by
ipu3_uapi_4a_config.ae_join_buffers1 to use ae_raw_buffer.
paddingpadding config
stats_3a_bubble_per_stripea
ipu3_uapi_stats_3a_bubble_info_per_stripestats_3a_status3a statistics status set in
ipu3_uapi_ff_status
-
struct ipu3_uapi_bnr_static_config_wb_gains_config¶
White balance gains
Definition:
struct ipu3_uapi_bnr_static_config_wb_gains_config {
__u16 gr;
__u16 r;
__u16 b;
__u16 gb;
};
Members
grwhite balance gain for Gr channel.
rwhite balance gain for R channel.
bwhite balance gain for B channel.
gbwhite balance gain for Gb channel.
Description
For BNR parameters WB gain factor for the three channels [Ggr, Ggb, Gb, Gr]. Their precision is U3.13 and the range is (0, 8) and the actual gain is Gx + 1, it is typically Gx = 1.
Pout = {Pin * (1 + Gx)}.
-
struct ipu3_uapi_bnr_static_config_wb_gains_thr_config¶
Threshold config
Definition:
struct ipu3_uapi_bnr_static_config_wb_gains_thr_config {
__u8 gr;
__u8 r;
__u8 b;
__u8 gb;
};
Members
grwhite balance threshold gain for Gr channel.
rwhite balance threshold gain for R channel.
bwhite balance threshold gain for B channel.
gbwhite balance threshold gain for Gb channel.
Description
Defines the threshold that specifies how different a defect pixel can be from its neighbors.(used by dynamic defect pixel correction sub block) Precision u4.4 range [0, 8].
-
struct ipu3_uapi_bnr_static_config_thr_coeffs_config¶
Noise model coefficients that controls noise threshold
Definition:
struct ipu3_uapi_bnr_static_config_thr_coeffs_config {
__u32 cf:13;
__u32 reserved0:3;
__u32 cg:5;
__u32 ci:5;
__u32 reserved1:1;
__u32 r_nf:5;
};
Members
cfFree coefficient for threshold calculation, range [0, 8191], default 0.
reserved0reserved
cgGain coefficient for threshold calculation, [0, 31], default 8.
ciIntensity coefficient for threshold calculation. range [0, 0x1f] default 6. format: u3.2 (3 most significant bits represent whole number, 2 least significant bits represent the fractional part with each count representing 0.25) e.g. 6 in binary format is 00110, that translates to 1.5
reserved1reserved
r_nfNormalization shift value for r^2 calculation, range [12, 20] where r is a radius of pixel [row, col] from centor of sensor. default 14.
Description
Threshold used to distinguish between noise and details.
-
struct ipu3_uapi_bnr_static_config_thr_ctrl_shd_config¶
Shading config
Definition:
struct ipu3_uapi_bnr_static_config_thr_ctrl_shd_config {
__u8 gr;
__u8 r;
__u8 b;
__u8 gb;
};
Members
grCoefficient defines lens shading gain approximation for gr channel
rCoefficient defines lens shading gain approximation for r channel
bCoefficient defines lens shading gain approximation for b channel
gbCoefficient defines lens shading gain approximation for gb channel
Description
Parameters for noise model (NM) adaptation of BNR due to shading correction. All above have precision of u3.3, default to 0.
-
struct ipu3_uapi_bnr_static_config_opt_center_config¶
Optical center config
Definition:
struct ipu3_uapi_bnr_static_config_opt_center_config {
__s32 x_reset:13;
__u32 reserved0:3;
__s32 y_reset:13;
__u32 reserved2:3;
};
Members
x_resetReset value of X (col start - X center). Precision s12.0.
reserved0reserved
y_resetReset value of Y (row start - Y center). Precision s12.0.
reserved2reserved
Description
Distance from corner to optical center for NM adaptation due to shading correction (should be calculated based on shading tables)
-
struct ipu3_uapi_bnr_static_config_lut_config¶
BNR square root lookup table
Definition:
struct ipu3_uapi_bnr_static_config_lut_config {
__u8 values[IPU3_UAPI_BNR_LUT_SIZE];
};
Members
valuespre-calculated values of square root function.
Description
LUT implementation of square root operation.
-
struct ipu3_uapi_bnr_static_config_bp_ctrl_config¶
Detect bad pixels (bp)
Definition:
struct ipu3_uapi_bnr_static_config_bp_ctrl_config {
__u32 bp_thr_gain:5;
__u32 reserved0:2;
__u32 defect_mode:1;
__u32 bp_gain:6;
__u32 reserved1:18;
__u32 w0_coeff:4;
__u32 reserved2:4;
__u32 w1_coeff:4;
__u32 reserved3:20;
};
Members
bp_thr_gainDefines the threshold that specifies how different a defect pixel can be from its neighbors. Threshold is dependent on de-noise threshold calculated by algorithm. Range [4, 31], default 4.
reserved0reserved
defect_modeMode of addressed defect pixels, 0 - single defect pixel is expected, 1 - 2 adjacent defect pixels are expected, default 1.
bp_gainDefines how 2nd derivation that passes through a defect pixel is different from 2nd derivations that pass through neighbor pixels. u4.2, range [0, 256], default 8.
reserved1reserved
w0_coeffBlending coefficient of defect pixel correction. Precision u4, range [0, 8], default 8.
reserved2reserved
w1_coeffEnable influence of incorrect defect pixel correction to be avoided. Precision u4, range [1, 8], default 8.
reserved3reserved
-
struct ipu3_uapi_bnr_static_config_dn_detect_ctrl_config¶
Denoising config
Definition:
struct ipu3_uapi_bnr_static_config_dn_detect_ctrl_config {
__u32 alpha:4;
__u32 beta:4;
__u32 gamma:4;
__u32 reserved0:4;
__u32 max_inf:4;
__u32 reserved1:7;
__u32 gd_enable:1;
__u32 bpc_enable:1;
__u32 bnr_enable:1;
__u32 ff_enable:1;
__u32 reserved2:1;
};
Members
alphaWeight of central element of smoothing filter.
betaWeight of peripheral elements of smoothing filter, default 4.
gammaWeight of diagonal elements of smoothing filter, default 4.
reserved0reserved
max_infMaximum increase of peripheral or diagonal element influence relative to the pre-defined value range: [0x5, 0xa]
reserved1reserved
gd_enableGreen disparity enable control, 0 - disable, 1 - enable.
bpc_enableBad pixel correction enable control, 0 - disable, 1 - enable.
bnr_enableBayer noise removal enable control, 0 - disable, 1 - enable.
ff_enableFixed function enable, 0 - disable, 1 - enable.
reserved2reserved
Description
- beta and gamma parameter define the strength of the noise removal filter.
All above has precision u0.4, range [0, 0xf] format: u0.4 (no / zero bits represent whole number, 4 bits represent the fractional part with each count representing 0.0625) e.g. 0xf translates to 0.0625x15 = 0.9375
-
struct ipu3_uapi_bnr_static_config_opt_center_sqr_config¶
BNR optical square
Definition:
struct ipu3_uapi_bnr_static_config_opt_center_sqr_config {
__u32 x_sqr_reset;
__u32 y_sqr_reset;
};
Members
x_sqr_resetReset value of X^2.
y_sqr_resetReset value of Y^2.
Description
Please note:
X and Y ref to
ipu3_uapi_bnr_static_config_opt_center_configBoth structs are used in threshold formula to calculate r^2, where r is a radius of pixel [row, col] from centor of sensor.
-
struct ipu3_uapi_bnr_static_config¶
BNR static config
Definition:
struct ipu3_uapi_bnr_static_config {
struct ipu3_uapi_bnr_static_config_wb_gains_config wb_gains;
struct ipu3_uapi_bnr_static_config_wb_gains_thr_config wb_gains_thr;
struct ipu3_uapi_bnr_static_config_thr_coeffs_config thr_coeffs;
struct ipu3_uapi_bnr_static_config_thr_ctrl_shd_config thr_ctrl_shd;
struct ipu3_uapi_bnr_static_config_opt_center_config opt_center;
struct ipu3_uapi_bnr_static_config_lut_config lut;
struct ipu3_uapi_bnr_static_config_bp_ctrl_config bp_ctrl;
struct ipu3_uapi_bnr_static_config_dn_detect_ctrl_config dn_detect_ctrl;
__u32 column_size;
struct ipu3_uapi_bnr_static_config_opt_center_sqr_config opt_center_sqr;
};
Members
wb_gainswhite balance gains
ipu3_uapi_bnr_static_config_wb_gains_configwb_gains_thrwhite balance gains threshold as defined by
ipu3_uapi_bnr_static_config_wb_gains_thr_configthr_coeffscoefficients of threshold
ipu3_uapi_bnr_static_config_thr_coeffs_configthr_ctrl_shdcontrol of shading threshold
ipu3_uapi_bnr_static_config_thr_ctrl_shd_configopt_centeroptical center
ipu3_uapi_bnr_static_config_opt_center_configlutlookup table
ipu3_uapi_bnr_static_config_lut_configbp_ctrldetect and remove bad pixels as defined in struct
ipu3_uapi_bnr_static_config_bp_ctrl_configdn_detect_ctrldetect and remove noise.
ipu3_uapi_bnr_static_config_dn_detect_ctrl_configcolumn_sizeThe number of pixels in column.
opt_center_sqrReset value of r^2 to optical center, see
ipu3_uapi_bnr_static_config_opt_center_sqr_config.
Description
Above parameters and opt_center_sqr are used for white balance and shading.
-
struct ipu3_uapi_bnr_static_config_green_disparity¶
Correct green disparity
Definition:
struct ipu3_uapi_bnr_static_config_green_disparity {
__u32 gd_red:6;
__u32 reserved0:2;
__u32 gd_green:6;
__u32 reserved1:2;
__u32 gd_blue:6;
__u32 reserved2:10;
__u32 gd_black:14;
__u32 reserved3:2;
__u32 gd_shading:7;
__u32 reserved4:1;
__u32 gd_support:2;
__u32 reserved5:1;
__u32 gd_clip:1;
__u32 gd_central_weight:4;
};
Members
gd_redShading gain coeff for gr disparity level in bright red region. Precision u0.6, default 4(0.0625).
reserved0reserved
gd_greenShading gain coeff for gr disparity level in bright green region. Precision u0.6, default 4(0.0625).
reserved1reserved
gd_blueShading gain coeff for gr disparity level in bright blue region. Precision u0.6, default 4(0.0625).
reserved2reserved
gd_blackMaximal green disparity level in dark region (stronger disparity assumed to be image detail). Precision u14, default 80.
reserved3reserved
gd_shadingChange maximal green disparity level according to square distance from image center.
reserved4reserved
gd_supportLower bound for the number of second green color pixels in current pixel neighborhood with less than threshold difference from it.
reserved5reserved
gd_clipTurn green disparity clip on/off, [0, 1], default 1.
gd_central_weightCentral pixel weight in 9 pixels weighted sum.
Description
The shading gain coeff of red, green, blue and black are used to calculate threshold given a pixel’s color value and its coordinates in the image.
-
struct ipu3_uapi_dm_config¶
De-mosaic parameters
Definition:
struct ipu3_uapi_dm_config {
__u32 dm_en:1;
__u32 ch_ar_en:1;
__u32 fcc_en:1;
__u32 reserved0:13;
__u32 frame_width:16;
__u32 gamma_sc:5;
__u32 reserved1:3;
__u32 lc_ctrl:5;
__u32 reserved2:3;
__u32 cr_param1:5;
__u32 reserved3:3;
__u32 cr_param2:5;
__u32 reserved4:3;
__u32 coring_param:5;
__u32 reserved5:27;
};
Members
dm_ende-mosaic enable.
ch_ar_enChecker artifacts removal enable flag. Default 0.
fcc_enFalse color correction (FCC) enable flag. Default 0.
reserved0reserved
frame_widthdo not care
gamma_scSharpening coefficient (coefficient of 2-d derivation of complementary color in Hamilton-Adams interpolation). u5, range [0, 31], default 8.
reserved1reserved
lc_ctrlParameter that controls weights of Chroma Homogeneity metric in calculation of final homogeneity metric. u5, range [0, 31], default 7.
reserved2reserved
cr_param1First parameter that defines Checker artifact removal feature gain. Precision u5, range [0, 31], default 8.
reserved3reserved
cr_param2Second parameter that defines Checker artifact removal feature gain. Precision u5, range [0, 31], default 8.
reserved4reserved
coring_paramDefines power of false color correction operation. low for preserving edge colors, high for preserving gray edge artifacts. Precision u1.4, range [0, 1.9375], default 4 (0.25).
reserved5reserved
Description
The demosaic fixed function block is responsible to covert Bayer(mosaiced) images into color images based on demosaicing algorithm.
-
struct ipu3_uapi_ccm_mat_config¶
Color correction matrix
Definition:
struct ipu3_uapi_ccm_mat_config {
__s16 coeff_m11;
__s16 coeff_m12;
__s16 coeff_m13;
__s16 coeff_o_r;
__s16 coeff_m21;
__s16 coeff_m22;
__s16 coeff_m23;
__s16 coeff_o_g;
__s16 coeff_m31;
__s16 coeff_m32;
__s16 coeff_m33;
__s16 coeff_o_b;
};
Members
coeff_m11CCM 3x3 coefficient, range [-65536, 65535]
coeff_m12CCM 3x3 coefficient, range [-8192, 8191]
coeff_m13CCM 3x3 coefficient, range [-32768, 32767]
coeff_o_rBias 3x1 coefficient, range [-8191, 8181]
coeff_m21CCM 3x3 coefficient, range [-32767, 32767]
coeff_m22CCM 3x3 coefficient, range [-8192, 8191]
coeff_m23CCM 3x3 coefficient, range [-32768, 32767]
coeff_o_gBias 3x1 coefficient, range [-8191, 8181]
coeff_m31CCM 3x3 coefficient, range [-32768, 32767]
coeff_m32CCM 3x3 coefficient, range [-8192, 8191]
coeff_m33CCM 3x3 coefficient, range [-32768, 32767]
coeff_o_bBias 3x1 coefficient, range [-8191, 8181]
Description
Transform sensor specific color space to standard sRGB by applying 3x3 matrix and adding a bias vector O. The transformation is basically a rotation and translation in the 3-dimensional color spaces. Here are the defaults:
9775, -2671, 1087, 0 -1071, 8303, 815, 0 -23, -7887, 16103, 0
-
struct ipu3_uapi_gamma_corr_ctrl¶
Gamma correction
Definition:
struct ipu3_uapi_gamma_corr_ctrl {
__u32 enable:1;
__u32 reserved:31;
};
Members
enablegamma correction enable.
reservedreserved
-
struct ipu3_uapi_gamma_corr_lut¶
Per-pixel tone mapping implemented as LUT.
Definition:
struct ipu3_uapi_gamma_corr_lut {
__u16 lut[IPU3_UAPI_GAMMA_CORR_LUT_ENTRIES];
};
Members
lut256 tabulated values of the gamma function. LUT[1].. LUT[256] format u13.0, range [0, 8191].
Description
The tone mapping operation is done by a Piece wise linear graph that is implemented as a lookup table(LUT). The pixel component input intensity is the X-axis of the graph which is the table entry.
-
struct ipu3_uapi_gamma_config¶
Gamma config
Definition:
struct ipu3_uapi_gamma_config {
struct ipu3_uapi_gamma_corr_ctrl gc_ctrl ;
struct ipu3_uapi_gamma_corr_lut gc_lut ;
};
Members
gc_ctrlcontrol of gamma correction
ipu3_uapi_gamma_corr_ctrlgc_lutlookup table of gamma correction
ipu3_uapi_gamma_corr_lut
-
struct ipu3_uapi_csc_mat_config¶
Color space conversion matrix config
Definition:
struct ipu3_uapi_csc_mat_config {
__s16 coeff_c11;
__s16 coeff_c12;
__s16 coeff_c13;
__s16 coeff_b1;
__s16 coeff_c21;
__s16 coeff_c22;
__s16 coeff_c23;
__s16 coeff_b2;
__s16 coeff_c31;
__s16 coeff_c32;
__s16 coeff_c33;
__s16 coeff_b3;
};
Members
coeff_c11Conversion matrix value, format s0.14, range [-16384, 16383].
coeff_c12Conversion matrix value, format s0.14, range [-8192, 8191].
coeff_c13Conversion matrix value, format s0.14, range [-16384, 16383].
coeff_b1Bias 3x1 coefficient, s13.0 range [-8192, 8191].
coeff_c21Conversion matrix value, format s0.14, range [-16384, 16383].
coeff_c22Conversion matrix value, format s0.14, range [-8192, 8191].
coeff_c23Conversion matrix value, format s0.14, range [-16384, 16383].
coeff_b2Bias 3x1 coefficient, s13.0 range [-8192, 8191].
coeff_c31Conversion matrix value, format s0.14, range [-16384, 16383].
coeff_c32Conversion matrix value, format s0.14, range [-8192, 8191].
coeff_c33Conversion matrix value, format s0.14, range [-16384, 16383].
coeff_b3Bias 3x1 coefficient, s13.0 range [-8192, 8191].
Description
To transform each pixel from RGB to YUV (Y - brightness/luminance, UV -chroma) by applying the pixel’s values by a 3x3 matrix and adding an optional bias 3x1 vector. Here are the default values for the matrix:
4898, 9617, 1867, 0, -2410, -4732, 7143, 0, 10076, -8437, -1638, 0,
(i.e. for real number 0.299, 0.299 * 2^14 becomes 4898.)
-
struct ipu3_uapi_cds_params¶
Chroma down-scaling
Definition:
struct ipu3_uapi_cds_params {
__u32 ds_c00:2;
__u32 ds_c01:2;
__u32 ds_c02:2;
__u32 ds_c03:2;
__u32 ds_c10:2;
__u32 ds_c11:2;
__u32 ds_c12:2;
__u32 ds_c13:2;
__u32 ds_nf:5;
__u32 reserved0:3;
__u32 csc_en:1;
__u32 uv_bin_output:1;
__u32 reserved1:6;
};
Members
ds_c00range [0, 3]
ds_c01range [0, 3]
ds_c02range [0, 3]
ds_c03range [0, 3]
ds_c10range [0, 3]
ds_c11range [0, 3]
ds_c12range [0, 3]
ds_c13range [0, 3]
ds_nfNormalization factor for Chroma output downscaling filter, range 0,4, default 2.
reserved0reserved
csc_enColor space conversion enable
uv_bin_output0: output YUV 4.2.0, 1: output YUV 4.2.2(default).
reserved1reserved
Description
- In case user does not provide, above 4x2 filter will use following defaults:
1, 3, 3, 1, 1, 3, 3, 1,
-
struct ipu3_uapi_shd_grid_config¶
Bayer shading(darkening) correction
Definition:
struct ipu3_uapi_shd_grid_config {
__u8 width;
__u8 height;
__u8 block_width_log2:3;
__u8 reserved0:1;
__u8 block_height_log2:3;
__u8 reserved1:1;
__u8 grid_height_per_slice;
__s16 x_start;
__s16 y_start;
};
Members
widthGrid horizontal dimensions, u8, [8, 128], default 73
heightGrid vertical dimensions, u8, [8, 128], default 56
block_width_log2Log2 of the width of the grid cell in pixel count u4, [0, 15], default value 5.
reserved0reserved
block_height_log2Log2 of the height of the grid cell in pixel count u4, [0, 15], default value 6.
reserved1reserved
grid_height_per_sliceSHD_MAX_CELLS_PER_SET/width. (with SHD_MAX_CELLS_PER_SET = 146).
x_startX value of top left corner of sensor relative to ROI s13, [-4096, 0], default 0, only negative values.
y_startY value of top left corner of sensor relative to ROI s13, [-4096, 0], default 0, only negative values.
-
struct ipu3_uapi_shd_general_config¶
Shading general config
Definition:
struct ipu3_uapi_shd_general_config {
__u32 init_set_vrt_offst_ul:8;
__u32 shd_enable:1;
__u32 gain_factor:2;
__u32 reserved:21;
};
Members
init_set_vrt_offst_ulset vertical offset, y_start >> block_height_log2 % grid_height_per_slice.
shd_enableshading enable.
gain_factorGain factor. Shift calculated anti shading value. Precision u2. 0x0 - gain factor [1, 5], means no shift interpolated value. 0x1 - gain factor [1, 9], means shift interpolated by 1. 0x2 - gain factor [1, 17], means shift interpolated by 2.
reservedreserved
Description
Correction is performed by multiplying a gain factor for each of the 4 Bayer channels as a function of the pixel location in the sensor.
-
struct ipu3_uapi_shd_black_level_config¶
Black level correction
Definition:
struct ipu3_uapi_shd_black_level_config {
__s16 bl_r;
__s16 bl_gr;
__s16 bl_gb;
__s16 bl_b;
};
Members
bl_rBios values for green red. s11 range [-2048, 2047].
bl_grBios values for green blue. s11 range [-2048, 2047].
bl_gbBios values for red. s11 range [-2048, 2047].
bl_bBios values for blue. s11 range [-2048, 2047].
-
struct ipu3_uapi_shd_config_static¶
Shading config static
Definition:
struct ipu3_uapi_shd_config_static {
struct ipu3_uapi_shd_grid_config grid;
struct ipu3_uapi_shd_general_config general;
struct ipu3_uapi_shd_black_level_config black_level;
};
Members
gridshading grid config
ipu3_uapi_shd_grid_configgeneralshading general config
ipu3_uapi_shd_general_configblack_levelblack level config for shading correction as defined by
ipu3_uapi_shd_black_level_config
-
struct ipu3_uapi_shd_lut¶
Shading gain factor lookup table.
Definition:
struct ipu3_uapi_shd_lut {
struct {
struct {
__u16 r;
__u16 gr;
} r_and_gr[IPU3_UAPI_SHD_MAX_CELLS_PER_SET];
__u8 reserved1[24];
struct {
__u16 gb;
__u16 b;
} gb_and_b[IPU3_UAPI_SHD_MAX_CELLS_PER_SET];
__u8 reserved2[24];
} sets[IPU3_UAPI_SHD_MAX_CFG_SETS];
};
Members
setsarray
sets.r_and_grRed and GreenR Lookup table.
sets.r_and_gr.rRed shading factor.
sets.r_and_gr.grGreenR shading factor.
sets.reserved1reserved
sets.gb_and_bGreenB and Blue Lookup table.
sets.gb_and_b.gbGreenB shading factor.
sets.gb_and_b.bBlue shading factor.
sets.reserved2reserved
Description
Map to shading correction LUT register set.
-
struct ipu3_uapi_shd_config¶
Shading config
Definition:
struct ipu3_uapi_shd_config {
struct ipu3_uapi_shd_config_static shd ;
struct ipu3_uapi_shd_lut shd_lut ;
};
Members
shdshading static config, see
ipu3_uapi_shd_config_staticshd_lutshading lookup table
ipu3_uapi_shd_lut
-
struct ipu3_uapi_iefd_cux2¶
IEFd Config Unit 2 parameters
Definition:
struct ipu3_uapi_iefd_cux2 {
__u32 x0:9;
__u32 x1:9;
__u32 a01:9;
__u32 b01:5;
};
Members
x0X0 point of Config Unit, u9.0, default 0.
x1X1 point of Config Unit, u9.0, default 0.
a01Slope A of Config Unit, s4.4, default 0.
b01Slope B, always 0.
Description
Calculate weight for blending directed and non-directed denoise elements
All CU inputs are unsigned, they will be converted to signed when written
to register, i.e. a01 will be written to 9 bit register in s4.4 format.
The data precision s4.4 means 4 bits for integer parts and 4 bits for the
fractional part, the first bit indicates positive or negative value.
For userspace software (commonly the imaging library), the computation for
the CU slope values should be based on the slope resolution 1/16 (binary
0.0001 - the minimal interval value), the slope value range is [-256, +255].
This applies to ipu3_uapi_iefd_cux6_ed, ipu3_uapi_iefd_cux2_1,
ipu3_uapi_iefd_cux2_1, ipu3_uapi_iefd_cux4 and ipu3_uapi_iefd_cux6_rad.
Note
Each instance of Config Unit needs X coordinate of n points and slope A factor between points calculated by driver based on calibration parameters.
-
struct ipu3_uapi_iefd_cux6_ed¶
Calculate power of non-directed sharpening element, Config Unit 6 for edge detail (ED).
Definition:
struct ipu3_uapi_iefd_cux6_ed {
__u32 x0:9;
__u32 x1:9;
__u32 x2:9;
__u32 reserved0:5;
__u32 x3:9;
__u32 x4:9;
__u32 x5:9;
__u32 reserved1:5;
__u32 a01:9;
__u32 a12:9;
__u32 a23:9;
__u32 reserved2:5;
__u32 a34:9;
__u32 a45:9;
__u32 reserved3:14;
__u32 b01:9;
__u32 b12:9;
__u32 b23:9;
__u32 reserved4:5;
__u32 b34:9;
__u32 b45:9;
__u32 reserved5:14;
};
Members
x0X coordinate of point 0, u9.0, default 0.
x1X coordinate of point 1, u9.0, default 0.
x2X coordinate of point 2, u9.0, default 0.
reserved0reserved
x3X coordinate of point 3, u9.0, default 0.
x4X coordinate of point 4, u9.0, default 0.
x5X coordinate of point 5, u9.0, default 0.
reserved1reserved
a01slope A points 01, s4.4, default 0.
a12slope A points 12, s4.4, default 0.
a23slope A points 23, s4.4, default 0.
reserved2reserved
a34slope A points 34, s4.4, default 0.
a45slope A points 45, s4.4, default 0.
reserved3reserved
b01slope B points 01, s4.4, default 0.
b12slope B points 12, s4.4, default 0.
b23slope B points 23, s4.4, default 0.
reserved4reserved
b34slope B points 34, s4.4, default 0.
b45slope B points 45, s4.4, default 0.
reserved5reserved.
-
struct ipu3_uapi_iefd_cux2_1¶
Calculate power of non-directed denoise element apply.
Definition:
struct ipu3_uapi_iefd_cux2_1 {
__u32 x0:9;
__u32 x1:9;
__u32 a01:9;
__u32 reserved1:5;
__u32 b01:8;
__u32 reserved2:24;
};
Members
x0X0 point of Config Unit, u9.0, default 0.
x1X1 point of Config Unit, u9.0, default 0.
a01Slope A of Config Unit, s4.4, default 0.
reserved1reserved
b01offset B0 of Config Unit, u7.0, default 0.
reserved2reserved
-
struct ipu3_uapi_iefd_cux4¶
Calculate power of non-directed sharpening element.
Definition:
struct ipu3_uapi_iefd_cux4 {
__u32 x0:9;
__u32 x1:9;
__u32 x2:9;
__u32 reserved0:5;
__u32 x3:9;
__u32 a01:9;
__u32 a12:9;
__u32 reserved1:5;
__u32 a23:9;
__u32 b01:8;
__u32 b12:8;
__u32 reserved2:7;
__u32 b23:8;
__u32 reserved3:24;
};
Members
x0X0 point of Config Unit, u9.0, default 0.
x1X1 point of Config Unit, u9.0, default 0.
x2X2 point of Config Unit, u9.0, default 0.
reserved0reserved
x3X3 point of Config Unit, u9.0, default 0.
a01Slope A0 of Config Unit, s4.4, default 0.
a12Slope A1 of Config Unit, s4.4, default 0.
reserved1reserved
a23Slope A2 of Config Unit, s4.4, default 0.
b01Offset B0 of Config Unit, s7.0, default 0.
b12Offset B1 of Config Unit, s7.0, default 0.
reserved2reserved
b23Offset B2 of Config Unit, s7.0, default 0.
reserved3reserved
-
struct ipu3_uapi_iefd_cux6_rad¶
Radial Config Unit (CU)
Definition:
struct ipu3_uapi_iefd_cux6_rad {
__u32 x0:8;
__u32 x1:8;
__u32 x2:8;
__u32 x3:8;
__u32 x4:8;
__u32 x5:8;
__u32 reserved1:16;
__u32 a01:16;
__u32 a12:16;
__u32 a23:16;
__u32 a34:16;
__u32 a45:16;
__u32 reserved2:16;
__u32 b01:10;
__u32 b12:10;
__u32 b23:10;
__u32 reserved4:2;
__u32 b34:10;
__u32 b45:10;
__u32 reserved5:12;
};
Members
x0x0 points of Config Unit radial, u8.0
x1x1 points of Config Unit radial, u8.0
x2x2 points of Config Unit radial, u8.0
x3x3 points of Config Unit radial, u8.0
x4x4 points of Config Unit radial, u8.0
x5x5 points of Config Unit radial, u8.0
reserved1reserved
a01Slope A of Config Unit radial, s7.8
a12Slope A of Config Unit radial, s7.8
a23Slope A of Config Unit radial, s7.8
a34Slope A of Config Unit radial, s7.8
a45Slope A of Config Unit radial, s7.8
reserved2reserved
b01Slope B of Config Unit radial, s9.0
b12Slope B of Config Unit radial, s9.0
b23Slope B of Config Unit radial, s9.0
reserved4reserved
b34Slope B of Config Unit radial, s9.0
b45Slope B of Config Unit radial, s9.0
reserved5reserved
-
struct ipu3_uapi_yuvp1_iefd_cfg_units¶
IEFd Config Units parameters
Definition:
struct ipu3_uapi_yuvp1_iefd_cfg_units {
struct ipu3_uapi_iefd_cux2 cu_1;
struct ipu3_uapi_iefd_cux6_ed cu_ed;
struct ipu3_uapi_iefd_cux2 cu_3;
struct ipu3_uapi_iefd_cux2_1 cu_5;
struct ipu3_uapi_iefd_cux4 cu_6;
struct ipu3_uapi_iefd_cux2 cu_7;
struct ipu3_uapi_iefd_cux4 cu_unsharp;
struct ipu3_uapi_iefd_cux6_rad cu_radial;
struct ipu3_uapi_iefd_cux2 cu_vssnlm;
};
Members
cu_1calculate weight for blending directed and non-directed denoise elements. See
ipu3_uapi_iefd_cux2cu_edcalculate power of non-directed sharpening element, see
ipu3_uapi_iefd_cux6_edcu_3calculate weight for blending directed and non-directed denoise elements. A
ipu3_uapi_iefd_cux2cu_5calculate power of non-directed denoise element apply, use
ipu3_uapi_iefd_cux2_1cu_6calculate power of non-directed sharpening element. See
ipu3_uapi_iefd_cux4cu_7calculate weight for blending directed and non-directed denoise elements. Use
ipu3_uapi_iefd_cux2cu_unsharpConfig Unit of unsharp
ipu3_uapi_iefd_cux4cu_radialConfig Unit of radial
ipu3_uapi_iefd_cux6_radcu_vssnlmConfig Unit of vssnlm
ipu3_uapi_iefd_cux2
-
struct ipu3_uapi_yuvp1_iefd_config_s¶
IEFd config
Definition:
struct ipu3_uapi_yuvp1_iefd_config_s {
__u32 horver_diag_coeff:7;
__u32 reserved0:1;
__u32 clamp_stitch:6;
__u32 reserved1:2;
__u32 direct_metric_update:5;
__u32 reserved2:3;
__u32 ed_horver_diag_coeff:7;
__u32 reserved3:1;
};
Members
horver_diag_coeffGradient compensation. Compared with vertical / horizontal (0 / 90 degree), coefficient of diagonal (45 / 135 degree) direction should be corrected by approx. 1/sqrt(2).
reserved0reserved
clamp_stitchSlope to stitch between clamped and unclamped edge values
reserved1reserved
direct_metric_updateUpdate coeff for direction metric
reserved2reserved
ed_horver_diag_coeffRadial Coefficient that compensates for different distance for vertical/horizontal and diagonal gradient calculation (approx. 1/sqrt(2))
reserved3reserved
-
struct ipu3_uapi_yuvp1_iefd_control¶
IEFd control
Definition:
struct ipu3_uapi_yuvp1_iefd_control {
__u32 iefd_en:1;
__u32 denoise_en:1;
__u32 direct_smooth_en:1;
__u32 rad_en:1;
__u32 vssnlm_en:1;
__u32 reserved:27;
};
Members
iefd_enEnable IEFd
denoise_enEnable denoise
direct_smooth_enEnable directional smooth
rad_enEnable radial update
vssnlm_enEnable VSSNLM output filter
reservedreserved
-
struct ipu3_uapi_sharp_cfg¶
Sharpening config
Definition:
struct ipu3_uapi_sharp_cfg {
__u32 nega_lmt_txt:13;
__u32 reserved0:19;
__u32 posi_lmt_txt:13;
__u32 reserved1:19;
__u32 nega_lmt_dir:13;
__u32 reserved2:19;
__u32 posi_lmt_dir:13;
__u32 reserved3:19;
};
Members
nega_lmt_txtSharpening limit for negative overshoots for texture.
reserved0reserved
posi_lmt_txtSharpening limit for positive overshoots for texture.
reserved1reserved
nega_lmt_dirSharpening limit for negative overshoots for direction (edge).
reserved2reserved
posi_lmt_dirSharpening limit for positive overshoots for direction (edge).
reserved3reserved
Description
Fixed point type u13.0, range [0, 8191].
-
struct ipu3_uapi_far_w¶
Sharpening config for far sub-group
Definition:
struct ipu3_uapi_far_w {
__u32 dir_shrp:7;
__u32 reserved0:1;
__u32 dir_dns:7;
__u32 reserved1:1;
__u32 ndir_dns_powr:7;
__u32 reserved2:9;
};
Members
dir_shrpWeight of wide direct sharpening, u1.6, range [0, 64], default 64.
reserved0reserved
dir_dnsWeight of wide direct denoising, u1.6, range [0, 64], default 0.
reserved1reserved
ndir_dns_powrPower of non-direct denoising, Precision u1.6, range [0, 64], default 64.
reserved2reserved
-
struct ipu3_uapi_unsharp_cfg¶
Unsharp config
Definition:
struct ipu3_uapi_unsharp_cfg {
__u32 unsharp_weight:7;
__u32 reserved0:1;
__u32 unsharp_amount:9;
__u32 reserved1:15;
};
Members
unsharp_weightUnsharp mask blending weight. u1.6, range [0, 64], default 16. 0 - disabled, 64 - use only unsharp.
reserved0reserved
unsharp_amountUnsharp mask amount, u4.5, range [0, 511], default 0.
reserved1reserved
-
struct ipu3_uapi_yuvp1_iefd_shrp_cfg¶
IEFd sharpness config
Definition:
struct ipu3_uapi_yuvp1_iefd_shrp_cfg {
struct ipu3_uapi_sharp_cfg cfg;
struct ipu3_uapi_far_w far_w;
struct ipu3_uapi_unsharp_cfg unshrp_cfg;
};
Members
cfgsharpness config
ipu3_uapi_sharp_cfgfar_wwide range config, value as specified by
ipu3_uapi_far_w: The 5x5 environment is separated into 2 sub-groups, the 3x3 nearest neighbors (8 pixels called Near), and the second order neighborhood around them (16 pixels called Far).unshrp_cfgunsharpness config.
ipu3_uapi_unsharp_cfg
-
struct ipu3_uapi_unsharp_coef0¶
Unsharp mask coefficients
Definition:
struct ipu3_uapi_unsharp_coef0 {
__u32 c00:9;
__u32 c01:9;
__u32 c02:9;
__u32 reserved:5;
};
Members
c00Coeff11, s0.8, range [-255, 255], default 1.
c01Coeff12, s0.8, range [-255, 255], default 5.
c02Coeff13, s0.8, range [-255, 255], default 9.
reservedreserved
Description
Configurable registers for common sharpening support.
-
struct ipu3_uapi_unsharp_coef1¶
Unsharp mask coefficients
Definition:
struct ipu3_uapi_unsharp_coef1 {
__u32 c11:9;
__u32 c12:9;
__u32 c22:9;
__u32 reserved:5;
};
Members
c11Coeff22, s0.8, range [-255, 255], default 29.
c12Coeff23, s0.8, range [-255, 255], default 55.
c22Coeff33, s0.8, range [-255, 255], default 96.
reservedreserved
-
struct ipu3_uapi_yuvp1_iefd_unshrp_cfg¶
Unsharp mask config
Definition:
struct ipu3_uapi_yuvp1_iefd_unshrp_cfg {
struct ipu3_uapi_unsharp_coef0 unsharp_coef0;
struct ipu3_uapi_unsharp_coef1 unsharp_coef1;
};
Members
unsharp_coef0unsharp coefficient 0 config. See
ipu3_uapi_unsharp_coef0unsharp_coef1unsharp coefficient 1 config. See
ipu3_uapi_unsharp_coef1
-
struct ipu3_uapi_radial_reset_xy¶
Radial coordinate reset
Definition:
struct ipu3_uapi_radial_reset_xy {
__s32 x:13;
__u32 reserved0:3;
__s32 y:13;
__u32 reserved1:3;
};
Members
xRadial reset of x coordinate. Precision s12, [-4095, 4095], default 0.
reserved0reserved
yRadial center y coordinate. Precision s12, [-4095, 4095], default 0.
reserved1reserved
-
struct ipu3_uapi_radial_reset_x2¶
Radial X^2 reset
Definition:
struct ipu3_uapi_radial_reset_x2 {
__u32 x2:24;
__u32 reserved:8;
};
Members
x2Radial reset of x^2 coordinate. Precision u24, default 0.
reservedreserved
-
struct ipu3_uapi_radial_reset_y2¶
Radial Y^2 reset
Definition:
struct ipu3_uapi_radial_reset_y2 {
__u32 y2:24;
__u32 reserved:8;
};
Members
y2Radial reset of y^2 coordinate. Precision u24, default 0.
reservedreserved
-
struct ipu3_uapi_radial_cfg¶
Radial config
Definition:
struct ipu3_uapi_radial_cfg {
__u32 rad_nf:4;
__u32 reserved0:4;
__u32 rad_inv_r2:7;
__u32 reserved1:17;
};
Members
rad_nfRadial. R^2 normalization factor is scale down by 2^ - (15 + scale)
reserved0reserved
rad_inv_r2Radial R^-2 normelized to (0.5..1). Precision u7, range [0, 127].
reserved1reserved
-
struct ipu3_uapi_rad_far_w¶
Radial FAR sub-group
Definition:
struct ipu3_uapi_rad_far_w {
__u32 rad_dir_far_sharp_w:8;
__u32 rad_dir_far_dns_w:8;
__u32 rad_ndir_far_dns_power:8;
__u32 reserved:8;
};
Members
rad_dir_far_sharp_wWeight of wide direct sharpening, u1.6, range [0, 64], default 64.
rad_dir_far_dns_wWeight of wide direct denoising, u1.6, range [0, 64], default 0.
rad_ndir_far_dns_powerpower of non-direct sharpening, u1.6, range [0, 64], default 0.
reservedreserved
-
struct ipu3_uapi_cu_cfg0¶
Radius Config Unit cfg0 register
Definition:
struct ipu3_uapi_cu_cfg0 {
__u32 cu6_pow:7;
__u32 reserved0:1;
__u32 cu_unsharp_pow:7;
__u32 reserved1:1;
__u32 rad_cu6_pow:7;
__u32 reserved2:1;
__u32 rad_cu_unsharp_pow:6;
__u32 reserved3:2;
};
Members
cu6_powPower of CU6. Power of non-direct sharpening, u3.4.
reserved0reserved
cu_unsharp_powPower of unsharp mask, u2.4.
reserved1reserved
rad_cu6_powRadial/corner CU6. Directed sharpening power, u3.4.
reserved2reserved
rad_cu_unsharp_powRadial power of unsharp mask, u2.4.
reserved3reserved
-
struct ipu3_uapi_cu_cfg1¶
Radius Config Unit cfg1 register
Definition:
struct ipu3_uapi_cu_cfg1 {
__u32 rad_cu6_x1:9;
__u32 reserved0:1;
__u32 rad_cu_unsharp_x1:9;
__u32 reserved1:13;
};
Members
rad_cu6_x1X1 point of Config Unit 6, precision u9.0.
reserved0reserved
rad_cu_unsharp_x1X1 point for Config Unit unsharp for radial/corner point precision u9.0.
reserved1reserved
-
struct ipu3_uapi_yuvp1_iefd_rad_cfg¶
IEFd parameters changed radially over the picture plane.
Definition:
struct ipu3_uapi_yuvp1_iefd_rad_cfg {
struct ipu3_uapi_radial_reset_xy reset_xy;
struct ipu3_uapi_radial_reset_x2 reset_x2;
struct ipu3_uapi_radial_reset_y2 reset_y2;
struct ipu3_uapi_radial_cfg cfg;
struct ipu3_uapi_rad_far_w rad_far_w;
struct ipu3_uapi_cu_cfg0 cu_cfg0;
struct ipu3_uapi_cu_cfg1 cu_cfg1;
};
Members
reset_xyreset xy value in radial calculation.
ipu3_uapi_radial_reset_xyreset_x2reset x square value in radial calculation. See struct
ipu3_uapi_radial_reset_x2reset_y2reset y square value in radial calculation. See struct
ipu3_uapi_radial_reset_y2cfgradial config defined in
ipu3_uapi_radial_cfgrad_far_wweight for wide range radial.
ipu3_uapi_rad_far_wcu_cfg0configuration unit 0. See
ipu3_uapi_cu_cfg0cu_cfg1configuration unit 1. See
ipu3_uapi_cu_cfg1
-
struct ipu3_uapi_vss_lut_x¶
Vssnlm LUT x0/x1/x2
Definition:
struct ipu3_uapi_vss_lut_x {
__u32 vs_x0:8;
__u32 vs_x1:8;
__u32 vs_x2:8;
__u32 reserved2:8;
};
Members
vs_x0Vssnlm LUT x0, precision u8, range [0, 255], default 16.
vs_x1Vssnlm LUT x1, precision u8, range [0, 255], default 32.
vs_x2Vssnlm LUT x2, precision u8, range [0, 255], default 64.
reserved2reserved
-
struct ipu3_uapi_vss_lut_y¶
Vssnlm LUT y0/y1/y2
Definition:
struct ipu3_uapi_vss_lut_y {
__u32 vs_y1:4;
__u32 reserved0:4;
__u32 vs_y2:4;
__u32 reserved1:4;
__u32 vs_y3:4;
__u32 reserved2:12;
};
Members
vs_y1Vssnlm LUT y1, precision u4, range [0, 8], default 1.
reserved0reserved
vs_y2Vssnlm LUT y2, precision u4, range [0, 8], default 3.
reserved1reserved
vs_y3Vssnlm LUT y3, precision u4, range [0, 8], default 8.
reserved2reserved
-
struct ipu3_uapi_yuvp1_iefd_vssnlm_cfg¶
IEFd Vssnlm Lookup table
Definition:
struct ipu3_uapi_yuvp1_iefd_vssnlm_cfg {
struct ipu3_uapi_vss_lut_x vss_lut_x;
struct ipu3_uapi_vss_lut_y vss_lut_y;
};
Members
vss_lut_xvss lookup table. See
ipu3_uapi_vss_lut_xdescriptionvss_lut_yvss lookup table. See
ipu3_uapi_vss_lut_ydescription
-
struct ipu3_uapi_yuvp1_iefd_config¶
IEFd config
Definition:
struct ipu3_uapi_yuvp1_iefd_config {
struct ipu3_uapi_yuvp1_iefd_cfg_units units;
struct ipu3_uapi_yuvp1_iefd_config_s config;
struct ipu3_uapi_yuvp1_iefd_control control;
struct ipu3_uapi_yuvp1_iefd_shrp_cfg sharp;
struct ipu3_uapi_yuvp1_iefd_unshrp_cfg unsharp;
struct ipu3_uapi_yuvp1_iefd_rad_cfg rad;
struct ipu3_uapi_yuvp1_iefd_vssnlm_cfg vsslnm;
};
Members
unitsconfiguration unit setting,
ipu3_uapi_yuvp1_iefd_cfg_unitsconfigconfiguration, as defined by
ipu3_uapi_yuvp1_iefd_config_scontrolcontrol setting, as defined by
ipu3_uapi_yuvp1_iefd_controlsharpsharpness setting, as defined by
ipu3_uapi_yuvp1_iefd_shrp_cfgunsharpunsharpness setting, as defined by
ipu3_uapi_yuvp1_iefd_unshrp_cfgradradial setting, as defined by
ipu3_uapi_yuvp1_iefd_rad_cfgvsslnmvsslnm setting, as defined by
ipu3_uapi_yuvp1_iefd_vssnlm_cfg
-
struct ipu3_uapi_yuvp1_yds_config¶
Y Down-Sampling config
Definition:
struct ipu3_uapi_yuvp1_yds_config {
__u32 c00:2;
__u32 c01:2;
__u32 c02:2;
__u32 c03:2;
__u32 c10:2;
__u32 c11:2;
__u32 c12:2;
__u32 c13:2;
__u32 norm_factor:5;
__u32 reserved0:4;
__u32 bin_output:1;
__u32 reserved1:6;
};
Members
c00range [0, 3], default 0x0
c01range [0, 3], default 0x1
c02range [0, 3], default 0x1
c03range [0, 3], default 0x0
c10range [0, 3], default 0x0
c11range [0, 3], default 0x1
c12range [0, 3], default 0x1
c13range [0, 3], default 0x0
norm_factorNormalization factor, range [0, 4], default 2 0 - divide by 1 1 - divide by 2 2 - divide by 4 3 - divide by 8 4 - divide by 16
reserved0reserved
bin_outputDown sampling on Luma channel in two optional modes 0 - Bin output 4.2.0 (default), 1 output 4.2.2.
reserved1reserved
Description
Above are 4x2 filter coefficients for chroma output downscaling.
-
struct ipu3_uapi_yuvp1_chnr_enable_config¶
Chroma noise reduction enable
Definition:
struct ipu3_uapi_yuvp1_chnr_enable_config {
__u32 enable:1;
__u32 yuv_mode:1;
__u32 reserved0:14;
__u32 col_size:12;
__u32 reserved1:4;
};
Members
enableenable/disable chroma noise reduction
yuv_mode0 - YUV420, 1 - YUV422
reserved0reserved
col_sizenumber of columns in the frame, max width is 2560
reserved1reserved
-
struct ipu3_uapi_yuvp1_chnr_coring_config¶
Coring thresholds for UV
Definition:
struct ipu3_uapi_yuvp1_chnr_coring_config {
__u32 u:13;
__u32 reserved0:3;
__u32 v:13;
__u32 reserved1:3;
};
Members
uU coring level, u0.13, range [0.0, 1.0], default 0.0
reserved0reserved
vV coring level, u0.13, range [0.0, 1.0], default 0.0
reserved1reserved
-
struct ipu3_uapi_yuvp1_chnr_sense_gain_config¶
Chroma noise reduction gains
Definition:
struct ipu3_uapi_yuvp1_chnr_sense_gain_config {
__u32 vy:8;
__u32 vu:8;
__u32 vv:8;
__u32 reserved0:8;
__u32 hy:8;
__u32 hu:8;
__u32 hv:8;
__u32 reserved1:8;
};
Members
vySensitivity of horizontal edge of Y, default 100
vuSensitivity of horizontal edge of U, default 100
vvSensitivity of horizontal edge of V, default 100
reserved0reserved
hySensitivity of vertical edge of Y, default 50
huSensitivity of vertical edge of U, default 50
hvSensitivity of vertical edge of V, default 50
reserved1reserved
Description
All sensitivity gain parameters have precision u13.0, range [0, 8191].
-
struct ipu3_uapi_yuvp1_chnr_iir_fir_config¶
Chroma IIR/FIR filter config
Definition:
struct ipu3_uapi_yuvp1_chnr_iir_fir_config {
__u32 fir_0h:6;
__u32 reserved0:2;
__u32 fir_1h:6;
__u32 reserved1:2;
__u32 fir_2h:6;
__u32 dalpha_clip_val:9;
__u32 reserved2:1;
};
Members
fir_0hValue of center tap in horizontal FIR, range [0, 32], default 8.
reserved0reserved
fir_1hValue of distance 1 in horizontal FIR, range [0, 32], default 12.
reserved1reserved
fir_2hValue of distance 2 tap in horizontal FIR, range [0, 32], default 0.
dalpha_clip_valweight for previous row in IIR, range [1, 256], default 0.
reserved2reserved
-
struct ipu3_uapi_yuvp1_chnr_config¶
Chroma noise reduction config
Definition:
struct ipu3_uapi_yuvp1_chnr_config {
struct ipu3_uapi_yuvp1_chnr_enable_config enable;
struct ipu3_uapi_yuvp1_chnr_coring_config coring;
struct ipu3_uapi_yuvp1_chnr_sense_gain_config sense_gain;
struct ipu3_uapi_yuvp1_chnr_iir_fir_config iir_fir;
};
Members
enablechroma noise reduction enable, see
ipu3_uapi_yuvp1_chnr_enable_configcoringcoring config for chroma noise reduction, see
ipu3_uapi_yuvp1_chnr_coring_configsense_gainsensitivity config for chroma noise reduction, see ipu3_uapi_yuvp1_chnr_sense_gain_config
iir_firiir and fir config for chroma noise reduction, see ipu3_uapi_yuvp1_chnr_iir_fir_config
-
struct ipu3_uapi_yuvp1_y_ee_nr_lpf_config¶
Luma(Y) edge enhancement low-pass filter coefficients
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_lpf_config {
__u32 a_diag:5;
__u32 reserved0:3;
__u32 a_periph:5;
__u32 reserved1:3;
__u32 a_cent:5;
__u32 reserved2:9;
__u32 enable:1;
};
Members
a_diagSmoothing diagonal coefficient, u5.0.
reserved0reserved
a_periphImage smoothing perpherial, u5.0.
reserved1reserved
a_centImage Smoothing center coefficient, u5.0.
reserved2reserved
enable0: Y_EE_NR disabled, output = input; 1: Y_EE_NR enabled.
-
struct ipu3_uapi_yuvp1_y_ee_nr_sense_config¶
Luma(Y) edge enhancement noise reduction sensitivity gains
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_sense_config {
__u32 edge_sense_0:13;
__u32 reserved0:3;
__u32 delta_edge_sense:13;
__u32 reserved1:3;
__u32 corner_sense_0:13;
__u32 reserved2:3;
__u32 delta_corner_sense:13;
__u32 reserved3:3;
};
Members
edge_sense_0Sensitivity of edge in dark area. u13.0, default 8191.
reserved0reserved
delta_edge_senseDifference in the sensitivity of edges between the bright and dark areas. u13.0, default 0.
reserved1reserved
corner_sense_0Sensitivity of corner in dark area. u13.0, default 0.
reserved2reserved
delta_corner_senseDifference in the sensitivity of corners between the bright and dark areas. u13.0, default 8191.
reserved3reserved
-
struct ipu3_uapi_yuvp1_y_ee_nr_gain_config¶
Luma(Y) edge enhancement noise reduction gain config
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_gain_config {
__u32 gain_pos_0:5;
__u32 reserved0:3;
__u32 delta_gain_posi:5;
__u32 reserved1:3;
__u32 gain_neg_0:5;
__u32 reserved2:3;
__u32 delta_gain_neg:5;
__u32 reserved3:3;
};
Members
gain_pos_0Gain for positive edge in dark area. u5.0, [0, 16], default 2.
reserved0reserved
delta_gain_posiDifference in the gain of edges between the bright and dark areas for positive edges. u5.0, [0, 16], default 0.
reserved1reserved
gain_neg_0Gain for negative edge in dark area. u5.0, [0, 16], default 8.
reserved2reserved
delta_gain_negDifference in the gain of edges between the bright and dark areas for negative edges. u5.0, [0, 16], default 0.
reserved3reserved
-
struct ipu3_uapi_yuvp1_y_ee_nr_clip_config¶
Luma(Y) edge enhancement noise reduction clipping config
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_clip_config {
__u32 clip_pos_0:5;
__u32 reserved0:3;
__u32 delta_clip_posi:5;
__u32 reserved1:3;
__u32 clip_neg_0:5;
__u32 reserved2:3;
__u32 delta_clip_neg:5;
__u32 reserved3:3;
};
Members
clip_pos_0Limit of positive edge in dark area u5, value [0, 16], default 8.
reserved0reserved
delta_clip_posiDifference in the limit of edges between the bright and dark areas for positive edges. u5, value [0, 16], default 8.
reserved1reserved
clip_neg_0Limit of negative edge in dark area u5, value [0, 16], default 8.
reserved2reserved
delta_clip_negDifference in the limit of edges between the bright and dark areas for negative edges. u5, value [0, 16], default 8.
reserved3reserved
-
struct ipu3_uapi_yuvp1_y_ee_nr_frng_config¶
Luma(Y) edge enhancement noise reduction fringe config
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_frng_config {
__u32 gain_exp:4;
__u32 reserved0:28;
__u32 min_edge:13;
__u32 reserved1:3;
__u32 lin_seg_param:4;
__u32 reserved2:4;
__u32 t1:1;
__u32 t2:1;
__u32 reserved3:6;
};
Members
gain_expCommon exponent of gains, u4, [0, 8], default 2.
reserved0reserved
min_edgeThreshold for edge and smooth stitching, u13.
reserved1reserved
lin_seg_paramPower of LinSeg, u4.
reserved2reserved
t1Parameter for enabling/disabling the edge enhancement, u1.0, [0, 1], default 1.
t2Parameter for enabling/disabling the smoothing, u1.0, [0, 1], default 1.
reserved3reserved
-
struct ipu3_uapi_yuvp1_y_ee_nr_diag_config¶
Luma(Y) edge enhancement noise reduction diagonal config
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_diag_config {
__u32 diag_disc_g:4;
__u32 reserved0:4;
__u32 hvw_hor:4;
__u32 dw_hor:4;
__u32 hvw_diag:4;
__u32 dw_diag:4;
__u32 reserved1:8;
};
Members
diag_disc_gCoefficient that prioritize diagonal edge direction on horizontal or vertical for final enhancement. u4.0, [1, 15], default 1.
reserved0reserved
hvw_horWeight of horizontal/vertical edge enhancement for hv edge. u2.2, [1, 15], default 4.
dw_horWeight of diagonal edge enhancement for hv edge. u2.2, [1, 15], default 1.
hvw_diagWeight of horizontal/vertical edge enhancement for diagonal edge. u2.2, [1, 15], default 1.
dw_diagWeight of diagonal edge enhancement for diagonal edge. u2.2, [1, 15], default 4.
reserved1reserved
-
struct ipu3_uapi_yuvp1_y_ee_nr_fc_coring_config¶
Luma(Y) edge enhancement noise reduction false color correction (FCC) coring config
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_fc_coring_config {
__u32 pos_0:13;
__u32 reserved0:3;
__u32 pos_delta:13;
__u32 reserved1:3;
__u32 neg_0:13;
__u32 reserved2:3;
__u32 neg_delta:13;
__u32 reserved3:3;
};
Members
pos_0Gain for positive edge in dark, u13.0, [0, 16], default 0.
reserved0reserved
pos_deltaGain for positive edge in bright, value: pos_0 + pos_delta <=16 u13.0, default 0.
reserved1reserved
neg_0Gain for negative edge in dark area, u13.0, range [0, 16], default 0.
reserved2reserved
neg_deltaGain for negative edge in bright area. neg_0 + neg_delta <=16 u13.0, default 0.
reserved3reserved
Description
Coring is a simple soft thresholding technique.
-
struct ipu3_uapi_yuvp1_y_ee_nr_config¶
Edge enhancement and noise reduction
Definition:
struct ipu3_uapi_yuvp1_y_ee_nr_config {
struct ipu3_uapi_yuvp1_y_ee_nr_lpf_config lpf;
struct ipu3_uapi_yuvp1_y_ee_nr_sense_config sense;
struct ipu3_uapi_yuvp1_y_ee_nr_gain_config gain;
struct ipu3_uapi_yuvp1_y_ee_nr_clip_config clip;
struct ipu3_uapi_yuvp1_y_ee_nr_frng_config frng;
struct ipu3_uapi_yuvp1_y_ee_nr_diag_config diag;
struct ipu3_uapi_yuvp1_y_ee_nr_fc_coring_config fc_coring;
};
Members
lpflow-pass filter config. See
ipu3_uapi_yuvp1_y_ee_nr_lpf_configsensesensitivity config. See
ipu3_uapi_yuvp1_y_ee_nr_sense_configgaingain config as defined in
ipu3_uapi_yuvp1_y_ee_nr_gain_configclipclip config as defined in
ipu3_uapi_yuvp1_y_ee_nr_clip_configfrngfringe config as defined in
ipu3_uapi_yuvp1_y_ee_nr_frng_configdiagdiagonal edge config. See
ipu3_uapi_yuvp1_y_ee_nr_diag_configfc_coringcoring config for fringe control. See
ipu3_uapi_yuvp1_y_ee_nr_fc_coring_config
-
struct ipu3_uapi_yuvp2_tcc_gen_control_static_config¶
Total color correction general control config
Definition:
struct ipu3_uapi_yuvp2_tcc_gen_control_static_config {
__u32 en:1;
__u32 blend_shift:3;
__u32 gain_according_to_y_only:1;
__u32 reserved0:11;
__s32 gamma:5;
__u32 reserved1:3;
__s32 delta:5;
__u32 reserved2:3;
};
Members
en0 - TCC disabled. Output = input 1 - TCC enabled.
blend_shiftblend shift, Range[3, 4], default NA.
gain_according_to_y_only0: Gain is calculated according to YUV, 1: Gain is calculated according to Y only
reserved0reserved
gammaFinal blending coefficients. Values[-16, 16], default NA.
reserved1reserved
deltaFinal blending coefficients. Values[-16, 16], default NA.
reserved2reserved
-
struct ipu3_uapi_yuvp2_tcc_macc_elem_static_config¶
Total color correction multi-axis color control (MACC) config
Definition:
struct ipu3_uapi_yuvp2_tcc_macc_elem_static_config {
__s32 a:12;
__u32 reserved0:4;
__s32 b:12;
__u32 reserved1:4;
__s32 c:12;
__u32 reserved2:4;
__s32 d:12;
__u32 reserved3:4;
};
Members
aa coefficient for 2x2 MACC conversion matrix.
reserved0reserved
bb coefficient 2x2 MACC conversion matrix.
reserved1reserved
cc coefficient for 2x2 MACC conversion matrix.
reserved2reserved
dd coefficient for 2x2 MACC conversion matrix.
reserved3reserved
-
struct ipu3_uapi_yuvp2_tcc_macc_table_static_config¶
Total color correction multi-axis color control (MACC) table array
Definition:
struct ipu3_uapi_yuvp2_tcc_macc_table_static_config {
struct ipu3_uapi_yuvp2_tcc_macc_elem_static_config entries[IPU3_UAPI_YUVP2_TCC_MACC_TABLE_ELEMENTS];
};
Members
entriesconfig for multi axis color correction, as specified by
ipu3_uapi_yuvp2_tcc_macc_elem_static_config
-
struct ipu3_uapi_yuvp2_tcc_inv_y_lut_static_config¶
Total color correction inverse y lookup table
Definition:
struct ipu3_uapi_yuvp2_tcc_inv_y_lut_static_config {
__u16 entries[IPU3_UAPI_YUVP2_TCC_INV_Y_LUT_ELEMENTS];
};
Members
entrieslookup table for inverse y estimation, and use it to estimate the ratio between luma and chroma. Chroma by approximate the absolute value of the radius on the chroma plane (R = sqrt(u^2+v^2) ) and luma by approximate by 1/Y.
-
struct ipu3_uapi_yuvp2_tcc_gain_pcwl_lut_static_config¶
Total color correction lookup table for PCWL
Definition:
struct ipu3_uapi_yuvp2_tcc_gain_pcwl_lut_static_config {
__u16 entries[IPU3_UAPI_YUVP2_TCC_GAIN_PCWL_LUT_ELEMENTS];
};
Members
entrieslookup table for gain piece wise linear transformation (PCWL)
-
struct ipu3_uapi_yuvp2_tcc_r_sqr_lut_static_config¶
Total color correction lookup table for r square root
Definition:
struct ipu3_uapi_yuvp2_tcc_r_sqr_lut_static_config {
__s16 entries[IPU3_UAPI_YUVP2_TCC_R_SQR_LUT_ELEMENTS];
};
Members
entrieslookup table for r square root estimation
-
struct ipu3_uapi_yuvp2_tcc_static_config¶
Total color correction static
Definition:
struct ipu3_uapi_yuvp2_tcc_static_config {
struct ipu3_uapi_yuvp2_tcc_gen_control_static_config gen_control;
struct ipu3_uapi_yuvp2_tcc_macc_table_static_config macc_table;
struct ipu3_uapi_yuvp2_tcc_inv_y_lut_static_config inv_y_lut;
struct ipu3_uapi_yuvp2_tcc_gain_pcwl_lut_static_config gain_pcwl;
struct ipu3_uapi_yuvp2_tcc_r_sqr_lut_static_config r_sqr_lut;
};
Members
gen_controlgeneral config for Total Color Correction
macc_tableconfig for multi axis color correction
inv_y_lutlookup table for inverse y estimation
gain_pcwllookup table for gain PCWL
r_sqr_lutlookup table for r square root estimation.
-
struct ipu3_uapi_anr_transform_config¶
Advanced noise reduction transform
Definition:
struct ipu3_uapi_anr_transform_config {
__u32 enable:1;
__u32 adaptive_treshhold_en:1;
__u32 reserved1:30;
__u8 reserved2[44];
struct ipu3_uapi_anr_alpha alpha[3];
struct ipu3_uapi_anr_beta beta[3];
struct ipu3_uapi_anr_plane_color color[3];
__u16 sqrt_lut[IPU3_UAPI_ANR_LUT_SIZE];
__s16 xreset:13;
__u16 reserved3:3;
__s16 yreset:13;
__u16 reserved4:3;
__u32 x_sqr_reset:24;
__u32 r_normfactor:5;
__u32 reserved5:3;
__u32 y_sqr_reset:24;
__u32 gain_scale:8;
};
Members
enableadvanced noise reduction enabled.
adaptive_treshhold_enOn IPU3, adaptive threshold is always enabled.
reserved1reserved
reserved2reserved
alphausing following defaults: 13, 13, 13, 13, 0, 0, 0, 0 11, 11, 11, 11, 0, 0, 0, 0 14, 14, 14, 14, 0, 0, 0, 0
betause following defaults: 24, 24, 24, 24 21, 20, 20, 21 25, 25, 25, 25
coloruse defaults defined in driver/media/pci/intel/ipu3-tables.c
sqrt_lut11 bits per element, values = [724 768 810 849 887 923 958 991 1024 1056 1116 1145 1173 1201 1086 1228 1254 1280 1305 1330 1355 1379 1402 1425 1448]
xresetReset value of X for r^2 calculation Value: col_start-X_center Constraint: Xreset + FrameWdith=4095 Xreset= -4095, default -1632.
reserved3reserved
yresetReset value of Y for r^2 calculation Value: row_start-Y_center Constraint: Yreset + FrameHeight=4095 Yreset= -4095, default -1224.
reserved4reserved
x_sqr_resetReset value of X^2 for r^2 calculation Value = (Xreset)^2
r_normfactorNormalization factor for R. Default 14.
reserved5reserved
y_sqr_resetReset value of Y^2 for r^2 calculation Value = (Yreset)^2
gain_scaleParameter describing shading gain as a function of distance from the image center. A single value per frame, loaded by the driver. Default 115.
-
struct ipu3_uapi_anr_stitch_pyramid¶
ANR stitch pyramid
Definition:
struct ipu3_uapi_anr_stitch_pyramid {
__u32 entry0:6;
__u32 entry1:6;
__u32 entry2:6;
__u32 reserved:14;
};
Members
entry0pyramid LUT entry0, range [0x0, 0x3f]
entry1pyramid LUT entry1, range [0x0, 0x3f]
entry2pyramid LUT entry2, range [0x0, 0x3f]
reservedreserved
-
struct ipu3_uapi_anr_stitch_config¶
ANR stitch config
Definition:
struct ipu3_uapi_anr_stitch_config {
__u32 anr_stitch_en;
__u8 reserved[44];
struct ipu3_uapi_anr_stitch_pyramid pyramid[IPU3_UAPI_ANR_PYRAMID_SIZE];
};
Members
anr_stitch_enenable stitch. Enabled with 1.
reservedreserved
pyramidpyramid table as defined by
ipu3_uapi_anr_stitch_pyramiddefault values: { 1, 3, 5 }, { 7, 7, 5 }, { 3, 1, 3 }, { 9, 15, 21 }, { 21, 15, 9 }, { 3, 5, 15 }, { 25, 35, 35 }, { 25, 15, 5 }, { 7, 21, 35 }, { 49, 49, 35 }, { 21, 7, 7 }, { 21, 35, 49 }, { 49, 35, 21 }, { 7, 5, 15 }, { 25, 35, 35 }, { 25, 15, 5 }, { 3, 9, 15 }, { 21, 21, 15 }, { 9, 3, 1 }, { 3, 5, 7 }, { 7, 5, 3}, { 1 }
-
struct ipu3_uapi_anr_config¶
ANR config
Definition:
struct ipu3_uapi_anr_config {
struct ipu3_uapi_anr_transform_config transform ;
struct ipu3_uapi_anr_stitch_config stitch ;
};
Members
transformadvanced noise reduction transform config as specified by
ipu3_uapi_anr_transform_configstitchcreate 4x4 patch from 4 surrounding 8x8 patches.
-
struct ipu3_uapi_acc_param¶
Accelerator cluster parameters
Definition:
struct ipu3_uapi_acc_param {
struct ipu3_uapi_bnr_static_config bnr;
struct ipu3_uapi_bnr_static_config_green_disparity green_disparity ;
struct ipu3_uapi_dm_config dm ;
struct ipu3_uapi_ccm_mat_config ccm ;
struct ipu3_uapi_gamma_config gamma ;
struct ipu3_uapi_csc_mat_config csc ;
struct ipu3_uapi_cds_params cds ;
struct ipu3_uapi_shd_config shd ;
struct ipu3_uapi_yuvp1_iefd_config iefd ;
struct ipu3_uapi_yuvp1_yds_config yds_c0 ;
struct ipu3_uapi_yuvp1_chnr_config chnr_c0 ;
struct ipu3_uapi_yuvp1_y_ee_nr_config y_ee_nr ;
struct ipu3_uapi_yuvp1_yds_config yds ;
struct ipu3_uapi_yuvp1_chnr_config chnr ;
struct ipu3_uapi_yuvp1_yds_config yds2 ;
struct ipu3_uapi_yuvp2_tcc_static_config tcc ;
struct ipu3_uapi_anr_config anr;
struct ipu3_uapi_awb_fr_config_s awb_fr;
struct ipu3_uapi_ae_config ae;
struct ipu3_uapi_af_config_s af;
struct ipu3_uapi_awb_config awb;
};
Members
bnrparameters for bayer noise reduction static config. See
ipu3_uapi_bnr_static_configgreen_disparitydisparity static config between gr and gb channel. See
ipu3_uapi_bnr_static_config_green_disparitydmde-mosaic config. See
ipu3_uapi_dm_configccmcolor correction matrix. See
ipu3_uapi_ccm_mat_configgammagamma correction config. See
ipu3_uapi_gamma_configcsccolor space conversion matrix. See
ipu3_uapi_csc_mat_configcdscolor down sample config. See
ipu3_uapi_cds_paramsshdlens shading correction config. See
ipu3_uapi_shd_configiefdImage enhancement filter and denoise config.
ipu3_uapi_yuvp1_iefd_configyds_c0y down scaler config.
ipu3_uapi_yuvp1_yds_configchnr_c0chroma noise reduction config.
ipu3_uapi_yuvp1_chnr_configy_ee_nry edge enhancement and noise reduction config.
ipu3_uapi_yuvp1_y_ee_nr_configydsy down scaler config. See
ipu3_uapi_yuvp1_yds_configchnrchroma noise reduction config. See
ipu3_uapi_yuvp1_chnr_configyds2y channel down scaler config. See
ipu3_uapi_yuvp1_yds_configtcctotal color correction config as defined in struct
ipu3_uapi_yuvp2_tcc_static_configanradvanced noise reduction config.See
ipu3_uapi_anr_configawb_frAWB filter response config. See ipu3_uapi_awb_fr_config
aeauto exposure config As specified by
ipu3_uapi_ae_configafauto focus config. As specified by
ipu3_uapi_af_configawbauto white balance config. As specified by
ipu3_uapi_awb_config
Description
ACC refers to the HW cluster containing all Fixed Functions (FFs). Each FF implements a specific algorithm.
-
struct ipu3_uapi_isp_lin_vmem_params¶
Linearization parameters
Definition:
struct ipu3_uapi_isp_lin_vmem_params {
__s16 lin_lutlow_gr[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutlow_r[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutlow_b[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutlow_gb[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutdif_gr[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutdif_r[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutdif_b[IPU3_UAPI_LIN_LUT_SIZE];
__s16 lin_lutdif_gb[IPU3_UAPI_LIN_LUT_SIZE];
};
Members
lin_lutlow_grlinearization look-up table for GR channel interpolation.
lin_lutlow_rlinearization look-up table for R channel interpolation.
lin_lutlow_blinearization look-up table for B channel interpolation.
lin_lutlow_gblinearization look-up table for GB channel interpolation. lin_lutlow_gr / lin_lutlow_r / lin_lutlow_b / lin_lutlow_gb <= LIN_MAX_VALUE - 1.
lin_lutdif_grlin_lutlow_gr[i+1] - lin_lutlow_gr[i].
lin_lutdif_rlin_lutlow_r[i+1] - lin_lutlow_r[i].
lin_lutdif_blin_lutlow_b[i+1] - lin_lutlow_b[i].
lin_lutdif_gblin_lutlow_gb[i+1] - lin_lutlow_gb[i].
-
struct ipu3_uapi_isp_tnr3_vmem_params¶
Temporal noise reduction vector memory parameters
Definition:
struct ipu3_uapi_isp_tnr3_vmem_params {
__u16 slope[IPU3_UAPI_ISP_TNR3_VMEM_LEN];
__u16 reserved1[IPU3_UAPI_ISP_VEC_ELEMS - IPU3_UAPI_ISP_TNR3_VMEM_LEN];
__u16 sigma[IPU3_UAPI_ISP_TNR3_VMEM_LEN];
__u16 reserved2[IPU3_UAPI_ISP_VEC_ELEMS - IPU3_UAPI_ISP_TNR3_VMEM_LEN];
};
Members
slopeslope setting in interpolation curve for temporal noise reduction.
reserved1reserved
sigmaknee point setting in interpolation curve for temporal noise reduction.
reserved2reserved
-
struct ipu3_uapi_isp_tnr3_params¶
Temporal noise reduction v3 parameters
Definition:
struct ipu3_uapi_isp_tnr3_params {
__u32 knee_y1;
__u32 knee_y2;
__u32 maxfb_y;
__u32 maxfb_u;
__u32 maxfb_v;
__u32 round_adj_y;
__u32 round_adj_u;
__u32 round_adj_v;
__u32 ref_buf_select;
};
Members
knee_y1Knee point TNR3 assumes standard deviation of Y,U and V at Y1 are TnrY1_Sigma_Y, U and V.
knee_y2Knee point TNR3 assumes standard deviation of Y,U and V at Y2 are TnrY2_Sigma_Y, U and V.
maxfb_yMax feedback gain for Y
maxfb_uMax feedback gain for U
maxfb_vMax feedback gain for V
round_adj_yrounding Adjust for Y
round_adj_urounding Adjust for U
round_adj_vrounding Adjust for V
ref_buf_selectselection of the reference frame buffer to be used.
-
struct ipu3_uapi_isp_xnr3_vmem_params¶
Extreme noise reduction v3 vector memory parameters
Definition:
struct ipu3_uapi_isp_xnr3_vmem_params {
__u16 x[IPU3_UAPI_ISP_VEC_ELEMS];
__u16 a[IPU3_UAPI_ISP_VEC_ELEMS];
__u16 b[IPU3_UAPI_ISP_VEC_ELEMS];
__u16 c[IPU3_UAPI_ISP_VEC_ELEMS];
};
Members
xxnr3 parameters.
axnr3 parameters.
bxnr3 parameters.
cxnr3 parameters.
-
struct ipu3_uapi_xnr3_alpha_params¶
Extreme noise reduction v3 alpha tuning parameters
Definition:
struct ipu3_uapi_xnr3_alpha_params {
__u32 y0;
__u32 u0;
__u32 v0;
__u32 ydiff;
__u32 udiff;
__u32 vdiff;
};
Members
y0Sigma for Y range similarity in dark area.
u0Sigma for U range similarity in dark area.
v0Sigma for V range similarity in dark area.
ydiffSigma difference for Y between bright area and dark area.
udiffSigma difference for U between bright area and dark area.
vdiffSigma difference for V between bright area and dark area.
-
struct ipu3_uapi_xnr3_coring_params¶
Extreme noise reduction v3 coring parameters
Definition:
struct ipu3_uapi_xnr3_coring_params {
__u32 u0;
__u32 v0;
__u32 udiff;
__u32 vdiff;
};
Members
u0Coring Threshold of U channel in dark area.
v0Coring Threshold of V channel in dark area.
udiffThreshold difference of U channel between bright and dark area.
vdiffThreshold difference of V channel between bright and dark area.
-
struct ipu3_uapi_xnr3_blending_params¶
Blending factor
Definition:
struct ipu3_uapi_xnr3_blending_params {
__u32 strength;
};
Members
strengthThe factor for blending output with input. This is tuning parameterHigher values lead to more aggressive XNR operation.
-
struct ipu3_uapi_isp_xnr3_params¶
Extreme noise reduction v3 parameters
Definition:
struct ipu3_uapi_isp_xnr3_params {
struct ipu3_uapi_xnr3_alpha_params alpha;
struct ipu3_uapi_xnr3_coring_params coring;
struct ipu3_uapi_xnr3_blending_params blending;
};
Members
alphaparameters for xnr3 alpha. See
ipu3_uapi_xnr3_alpha_paramscoringparameters for xnr3 coring. See
ipu3_uapi_xnr3_coring_paramsblendingparameters for xnr3 blending. See
ipu3_uapi_xnr3_blending_params
-
struct ipu3_uapi_obgrid_param¶
Optical black level compensation parameters
Definition:
struct ipu3_uapi_obgrid_param {
__u16 gr;
__u16 r;
__u16 b;
__u16 gb;
};
Members
grGrid table values for color GR
rGrid table values for color R
bGrid table values for color B
gbGrid table values for color GB
Description
Black level is different for red, green, and blue channels. So black level compensation is different per channel.
-
struct ipu3_uapi_flags¶
bits to indicate which pipeline needs update
Definition:
struct ipu3_uapi_flags {
__u32 gdc:1;
__u32 obgrid:1;
__u32 reserved1:30;
__u32 acc_bnr:1;
__u32 acc_green_disparity:1;
__u32 acc_dm:1;
__u32 acc_ccm:1;
__u32 acc_gamma:1;
__u32 acc_csc:1;
__u32 acc_cds:1;
__u32 acc_shd:1;
__u32 reserved2:2;
__u32 acc_iefd:1;
__u32 acc_yds_c0:1;
__u32 acc_chnr_c0:1;
__u32 acc_y_ee_nr:1;
__u32 acc_yds:1;
__u32 acc_chnr:1;
__u32 acc_ytm:1;
__u32 acc_yds2:1;
__u32 acc_tcc:1;
__u32 acc_dpc:1;
__u32 acc_bds:1;
__u32 acc_anr:1;
__u32 acc_awb_fr:1;
__u32 acc_ae:1;
__u32 acc_af:1;
__u32 acc_awb:1;
__u32 reserved3:4;
__u32 lin_vmem_params:1;
__u32 tnr3_vmem_params:1;
__u32 xnr3_vmem_params:1;
__u32 tnr3_dmem_params:1;
__u32 xnr3_dmem_params:1;
__u32 reserved4:1;
__u32 obgrid_param:1;
__u32 reserved5:25;
};
Members
gdc0 = no update, 1 = update.
obgrid0 = no update, 1 = update.
reserved1Not used.
acc_bnr0 = no update, 1 = update.
acc_green_disparity0 = no update, 1 = update.
acc_dm0 = no update, 1 = update.
acc_ccm0 = no update, 1 = update.
acc_gamma0 = no update, 1 = update.
acc_csc0 = no update, 1 = update.
acc_cds0 = no update, 1 = update.
acc_shd0 = no update, 1 = update.
reserved2Not used.
acc_iefd0 = no update, 1 = update.
acc_yds_c00 = no update, 1 = update.
acc_chnr_c00 = no update, 1 = update.
acc_y_ee_nr0 = no update, 1 = update.
acc_yds0 = no update, 1 = update.
acc_chnr0 = no update, 1 = update.
acc_ytm0 = no update, 1 = update.
acc_yds20 = no update, 1 = update.
acc_tcc0 = no update, 1 = update.
acc_dpc0 = no update, 1 = update.
acc_bds0 = no update, 1 = update.
acc_anr0 = no update, 1 = update.
acc_awb_fr0 = no update, 1 = update.
acc_ae0 = no update, 1 = update.
acc_af0 = no update, 1 = update.
acc_awb0 = no update, 1 = update.
reserved3Not used.
lin_vmem_params0 = no update, 1 = update.
tnr3_vmem_params0 = no update, 1 = update.
xnr3_vmem_params0 = no update, 1 = update.
tnr3_dmem_params0 = no update, 1 = update.
xnr3_dmem_params0 = no update, 1 = update.
reserved4Not used.
obgrid_param0 = no update, 1 = update.
reserved5Not used.
-
struct ipu3_uapi_params¶
V4L2_META_FMT_IPU3_PARAMS
Definition:
struct ipu3_uapi_params {
struct ipu3_uapi_flags use ;
struct ipu3_uapi_acc_param acc_param;
struct ipu3_uapi_isp_lin_vmem_params lin_vmem_params;
struct ipu3_uapi_isp_tnr3_vmem_params tnr3_vmem_params;
struct ipu3_uapi_isp_xnr3_vmem_params xnr3_vmem_params;
struct ipu3_uapi_isp_tnr3_params tnr3_dmem_params;
struct ipu3_uapi_isp_xnr3_params xnr3_dmem_params;
struct ipu3_uapi_obgrid_param obgrid_param;
};
Members
useselect which parameters to apply, see
ipu3_uapi_flagsacc_paramACC parameters, as specified by
ipu3_uapi_acc_paramlin_vmem_paramslinearization VMEM, as specified by
ipu3_uapi_isp_lin_vmem_paramstnr3_vmem_paramstnr3 VMEM as specified by
ipu3_uapi_isp_tnr3_vmem_paramsxnr3_vmem_paramsxnr3 VMEM as specified by
ipu3_uapi_isp_xnr3_vmem_paramstnr3_dmem_paramstnr3 DMEM as specified by
ipu3_uapi_isp_tnr3_paramsxnr3_dmem_paramsxnr3 DMEM as specified by
ipu3_uapi_isp_xnr3_paramsobgrid_paramobgrid parameters as specified by
ipu3_uapi_obgrid_param
Description
The video queue “parameters” is of format V4L2_META_FMT_IPU3_PARAMS. This is a “single plane” v4l2_meta_format using V4L2_BUF_TYPE_META_OUTPUT.
struct ipu3_uapi_params as defined below contains a lot of parameters and
ipu3_uapi_flags selects which parameters to apply.