[PATCH v7 02/18] media: uapi: Add extensible param and stats blocks for RPPX1
From: Jai Luthra
Date: Fri Apr 10 2026 - 05:08:25 EST
Define the userspace API for the Dreamchip RPP-X1 ISP extensible
parameters and statistics. The RPP-X1 is functionally similar to the
RkISP1 already supported upstream, but operates at higher bit depths (up
to 24-bit precision in many blocks) and exposes additional configuration
options. This warrants a dedicated uAPI rather than reusing the RkISP1
definitions.
The parameter blocks follow the V4L2 extensible parameters framework
using struct v4l2_isp_params_block_header, with each ISP functional
block represented as a tagged configuration structure. The statistics
buffer provides AWB, auto-exposure and histogram measurement results at
native RPP-X1 precision.
Not all functional blocks present on the RPP-X1 hardware are included
yet, but the format is extensible and new blocks can be added without
breaking existing userspace.
Signed-off-by: Jai Luthra <jai.luthra+renesas@xxxxxxxxxxxxxxxx>
---
include/uapi/linux/media/dreamchip/rppx1-config.h | 728 ++++++++++++++++++++++
1 file changed, 728 insertions(+)
diff --git a/include/uapi/linux/media/dreamchip/rppx1-config.h b/include/uapi/linux/media/dreamchip/rppx1-config.h
new file mode 100644
index 0000000000000000000000000000000000000000..b9083e6f32b15329333eb13491b50c0aea8d1a32
--- /dev/null
+++ b/include/uapi/linux/media/dreamchip/rppx1-config.h
@@ -0,0 +1,728 @@
+/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
+/*
+ * Dreamchip RPP-X1 ISP Driver - Userspace API
+ *
+ * Copyright (C) 2026 Renesas Electronics Corp.
+ * Copyright (C) 2026 Ideas on Board Oy
+ * Copyright (C) 2026 Ragnatech AB
+ */
+
+#ifndef __UAPI_RPP_X1_CONFIG_H
+#define __UAPI_RPP_X1_CONFIG_H
+
+#include <linux/types.h>
+#include <linux/media/v4l2-isp.h>
+
+/*
+ * Defect Pixel Cluster Correction
+ */
+#define RPPX1_DPCC_METHODS_MAX 3
+
+/* Linearization (Sensor De-gamma) */
+#define RPPX1_LIN_SAMPLES_NUM 17
+
+/* Gamma Out */
+#define RPPX1_GAMMA_OUT_MAX_SAMPLES 17
+
+/* Lens Shade Correction */
+#define RPPX1_LSC_SECTORS_TBL_SIZE 8
+#define RPPX1_LSC_SAMPLES_MAX 17
+
+/* Histogram */
+#define RPPX1_HIST_BIN_N_MAX 32
+
+/* Exposure Measurement */
+#define RPPX1_EXM_MEAN_MAX 25
+
+/* AWB Measurement */
+#define RPPX1_AWB_MAX_GRID 1
+
+/* Color Correction Matrix */
+#define RPPX1_CTK_COEFF_MAX 0x8000
+#define RPPX1_CTK_OFFSET_MAX 0x800000
+
+/* Filter */
+#define RPPX1_BDM_MAX_TH 0xffff
+
+/**
+ * enum rppx1_params_block_type - RPP-X1 extensible params block types
+ *
+ * @RPPX1_PARAMS_BLOCK_TYPE_BLS: Black Level Subtraction
+ * @RPPX1_PARAMS_BLOCK_TYPE_DPCC: Defect Pixel Cluster Correction
+ * @RPPX1_PARAMS_BLOCK_TYPE_LIN: Linearization (Sensor De-gamma)
+ * @RPPX1_PARAMS_BLOCK_TYPE_AWB_GAIN: Auto White Balance Gains
+ * @RPPX1_PARAMS_BLOCK_TYPE_FLT: ISP Filtering
+ * @RPPX1_PARAMS_BLOCK_TYPE_BDM: Bayer Demosaic
+ * @RPPX1_PARAMS_BLOCK_TYPE_CTK: Color Correction (Cross-Talk)
+ * @RPPX1_PARAMS_BLOCK_TYPE_GOC: Gamma Out Correction
+ * @RPPX1_PARAMS_BLOCK_TYPE_DPF: De-noise Pre-Filter
+ * @RPPX1_PARAMS_BLOCK_TYPE_DPF_STRENGTH: De-noise Pre-Filter Strength
+ * @RPPX1_PARAMS_BLOCK_TYPE_LSC: Lens Shading Correction
+ * @RPPX1_PARAMS_BLOCK_TYPE_AWB_MEAS: AWB Measurement Configuration
+ * @RPPX1_PARAMS_BLOCK_TYPE_HST_MEAS: Histogram Measurement Configuration
+ * @RPPX1_PARAMS_BLOCK_TYPE_AEC_MEAS: Auto Exposure Measurement Configuration
+ */
+enum rppx1_params_block_type {
+ RPPX1_PARAMS_BLOCK_TYPE_BLS,
+ RPPX1_PARAMS_BLOCK_TYPE_DPCC,
+ RPPX1_PARAMS_BLOCK_TYPE_LIN,
+ RPPX1_PARAMS_BLOCK_TYPE_AWB_GAIN,
+ RPPX1_PARAMS_BLOCK_TYPE_FLT,
+ RPPX1_PARAMS_BLOCK_TYPE_BDM,
+ RPPX1_PARAMS_BLOCK_TYPE_CTK,
+ RPPX1_PARAMS_BLOCK_TYPE_GOC,
+ RPPX1_PARAMS_BLOCK_TYPE_DPF,
+ RPPX1_PARAMS_BLOCK_TYPE_DPF_STRENGTH,
+ RPPX1_PARAMS_BLOCK_TYPE_LSC,
+ RPPX1_PARAMS_BLOCK_TYPE_AWB_MEAS,
+ RPPX1_PARAMS_BLOCK_TYPE_HST_MEAS,
+ RPPX1_PARAMS_BLOCK_TYPE_AEC_MEAS,
+};
+
+/**
+ * struct rppx1_window - Measurement window
+ *
+ * @h_offs: horizontal offset from the left of the frame in pixels
+ * @v_offs: vertical offset from the top of the frame in pixels
+ * @h_size: horizontal size of the window in pixels
+ * @v_size: vertical size of the window in pixels
+ */
+struct rppx1_window {
+ __u16 h_offs;
+ __u16 v_offs;
+ __u16 h_size;
+ __u16 v_size;
+};
+
+/**
+ * struct rppx1_bls_fixed_val - BLS fixed subtraction values
+ *
+ * Fixed black level values subtracted from sensor data per Bayer channel.
+ * Negative values result in addition. Each value is a 24-bit + sign
+ * (25-bit signed) fixed-point number stored in a __s32.
+ *
+ * RPP-X1 supports 12/20/24-bit + sign depending on hardware version.
+ * Userspace should provide values at full 24-bit precision; the driver
+ * truncates to match the hardware.
+ *
+ * @r: subtraction value for Bayer pattern R
+ * @gr: subtraction value for Bayer pattern Gr
+ * @gb: subtraction value for Bayer pattern Gb
+ * @b: subtraction value for Bayer pattern B
+ */
+struct rppx1_bls_fixed_val {
+ __s32 r;
+ __s32 gr;
+ __s32 gb;
+ __s32 b;
+};
+
+/**
+ * struct rppx1_params_bls_config - Black Level Subtraction configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_BLS)
+ * @enable_auto: 1 = use measured values, 0 = use fixed_val
+ * @en_windows: enabled measurement windows bitmask
+ * @bls_window1: measurement window 1
+ * @bls_window2: measurement window 2
+ * @bls_samples: log2 of the number of measured pixels per Bayer position
+ * @fixed_val: fixed subtraction values (24-bit + sign)
+ */
+struct rppx1_params_bls_config {
+ struct v4l2_isp_params_block_header header;
+ __u8 enable_auto;
+ __u8 en_windows;
+ struct rppx1_window bls_window1;
+ struct rppx1_window bls_window2;
+ __u8 bls_samples;
+ struct rppx1_bls_fixed_val fixed_val;
+};
+
+/**
+ * struct rppx1_dpcc_methods_config - DPCC methods set configuration
+ *
+ * This structure stores the configuration of one set of methods for the DPCC
+ * algorithm. Multiple methods can be selected in each set (independently for
+ * the Green and Red/Blue components) through the @method field, the result is
+ * the logical AND of all enabled methods. The remaining fields set thresholds
+ * and factors for each method.
+ *
+ * @method: method enable bits (RPPX1_DPCC_METHODS_SET_*)
+ * @line_thresh: line threshold (RPPX1_DPCC_LINE_THRESH_*)
+ * @line_mad_fac: line MAD factor (RPPX1_DPCC_LINE_MAD_FAC_*)
+ * @pg_fac: peak gradient factor (RPPX1_DPCC_PG_FAC_*)
+ * @rnd_thresh: rank neighbor difference threshold (RPPX1_DPCC_RND_THRESH_*)
+ * @rg_fac: rank gradient factor (RPPX1_DPCC_RG_FAC_*)
+ */
+struct rppx1_dpcc_methods_config {
+ __u32 method;
+ __u32 line_thresh;
+ __u32 line_mad_fac;
+ __u32 pg_fac;
+ __u32 rnd_thresh;
+ __u32 rg_fac;
+};
+
+/**
+ * struct rppx1_params_dpcc_config - Defect Pixel Cluster Correction configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_DPCC)
+ * @mode: DPCC mode (RPPX1_DPCC_MODE_*)
+ * @output_mode: interpolation output mode (RPPX1_DPCC_OUTPUT_MODE_*)
+ * @set_use: methods sets selection (RPPX1_DPCC_SET_USE_*)
+ * @methods: methods sets configuration
+ * @ro_limits: rank order limits (RPPX1_DPCC_RO_LIMITS_*)
+ * @rnd_offs: differential rank offsets (RPPX1_DPCC_RND_OFFS_*)
+ */
+struct rppx1_params_dpcc_config {
+ struct v4l2_isp_params_block_header header;
+ __u32 mode;
+ __u32 output_mode;
+ __u32 set_use;
+ struct rppx1_dpcc_methods_config methods[RPPX1_DPCC_METHODS_MAX];
+ __u32 ro_limits;
+ __u32 rnd_offs;
+};
+
+/**
+ * struct rppx1_lin_curve - Linearization curve for one color channel
+ *
+ * The RPP-X1 linearization module supports 12/20/24-bit precision depending
+ * on hardware version. Values are provided at 24-bit precision; the driver
+ * truncates to the hardware capability.
+ *
+ * @gamma_y: curve y-axis values, each up to 24 bits
+ */
+struct rppx1_lin_curve {
+ __u32 gamma_y[RPPX1_LIN_SAMPLES_NUM];
+};
+
+/**
+ * struct rppx1_lin_curve_dx - Linearization curve x-axis (sampling points)
+ * increments.
+ *
+ * gamma_dx[0] is for the lower samples, so Bits 0:3 for sample 1, ... Bits
+ * 28:31 for sample 8
+ * gamma_dx[1] is for the higher samples, so Bits 0:3 for sample 9, ... Bits
+ * 28:31 for sample 16
+ *
+ * The reset values for both fields is 0xcccccccc. This means that each sample
+ * is 12 units away from the previous one on the x-axis.
+ *
+ * @gamma_dx: curve x-axis increments in 4-bit precision
+ */
+struct rppx1_lin_curve_dx {
+ __u32 gamma_dx[2];
+};
+
+/**
+ * struct rppx1_params_lin_config - Linearization (Sensor De-gamma) configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_LIN)
+ * @curve_r: linearization curve for red channel
+ * @curve_g: linearization curve for green channel
+ * @curve_b: linearization curve for blue channel
+ * @xa_pnts: x axis increment definitions
+ */
+struct rppx1_params_lin_config {
+ struct v4l2_isp_params_block_header header;
+ struct rppx1_lin_curve curve_r;
+ struct rppx1_lin_curve curve_g;
+ struct rppx1_lin_curve curve_b;
+ struct rppx1_lin_curve_dx xa_pnts;
+};
+
+/**
+ * struct rppx1_params_lsc_config - Lens Shading Correction configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_LSC)
+ * @r_data_tbl: sample table red
+ * @gr_data_tbl: sample table green (red)
+ * @gb_data_tbl: sample table green (blue)
+ * @b_data_tbl: sample table blue
+ * @x_grad_tbl: gradient table x
+ * @y_grad_tbl: gradient table y
+ * @x_size_tbl: size table x
+ * @y_size_tbl: size table y
+ * @config_width: reserved
+ * @config_height: reserved
+ */
+struct rppx1_params_lsc_config {
+ struct v4l2_isp_params_block_header header;
+ __u16 r_data_tbl[RPPX1_LSC_SAMPLES_MAX][RPPX1_LSC_SAMPLES_MAX];
+ __u16 gr_data_tbl[RPPX1_LSC_SAMPLES_MAX][RPPX1_LSC_SAMPLES_MAX];
+ __u16 gb_data_tbl[RPPX1_LSC_SAMPLES_MAX][RPPX1_LSC_SAMPLES_MAX];
+ __u16 b_data_tbl[RPPX1_LSC_SAMPLES_MAX][RPPX1_LSC_SAMPLES_MAX];
+ __u16 x_grad_tbl[RPPX1_LSC_SECTORS_TBL_SIZE];
+ __u16 y_grad_tbl[RPPX1_LSC_SECTORS_TBL_SIZE];
+ __u16 x_size_tbl[RPPX1_LSC_SECTORS_TBL_SIZE];
+ __u16 y_size_tbl[RPPX1_LSC_SECTORS_TBL_SIZE];
+ __u16 config_width;
+ __u16 config_height;
+};
+
+/**
+ * struct rppx1_params_awb_gain_config - AWB gain configuration
+ *
+ * RPP-X1 AWB gains are 18-bit with 12-bit fractional part (0x1000 = 1.0),
+ * giving a range of 0.0 to 64.0.
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_AWB_GAIN)
+ * @gain_red: gain for red component, 18-bit (Q6.12)
+ * @gain_green_r: gain for green-in-red component, 18-bit (Q6.12)
+ * @gain_blue: gain for blue component, 18-bit (Q6.12)
+ * @gain_green_b: gain for green-in-blue component, 18-bit (Q6.12)
+ */
+struct rppx1_params_awb_gain_config {
+ struct v4l2_isp_params_block_header header;
+ __u32 gain_red;
+ __u32 gain_green_r;
+ __u32 gain_blue;
+ __u32 gain_green_b;
+};
+
+/**
+ * struct rppx1_params_flt_config - Filter (demosaic/denoise) configuration
+ *
+ * RPP-X1 thresholds are 18-bit and factors are 8-bit.
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_FLT)
+ * @mode: filter mode
+ * @grn_stage1: green filter stage 1 select (range 0x0...0x8)
+ * @chr_h_mode: chroma filter horizontal mode
+ * @chr_v_mode: chroma filter vertical mode
+ * @thresh_bl0: If thresh_bl1 < sum_grad < thresh_bl0 then fac_bl0 is selected (blurring th)
+ * @thresh_bl1: If sum_grad < thresh_bl1 then fac_bl1 is selected (blurring th)
+ * @thresh_sh0: If thresh_sh0 < sum_grad < thresh_sh1 then thresh_sh0 is selected (sharpening th)
+ * @thresh_sh1: If thresh_sh1 < sum_grad then thresh_sh1 is selected (sharpening th)
+ * @lum_weight: luminance weight, min (bits 0:11), kink (bits 12:23), gain (bits 28:30)
+ * @fac_sh1: filter factor for sharp1 level
+ * @fac_sh0: filter factor for sharp0 level
+ * @fac_mid: filter factor for mid level and for static filter mode
+ * @fac_bl0: filter factor for blur0 level
+ * @fac_bl1: filter factor for blur1 level (max blur)
+ */
+struct rppx1_params_flt_config {
+ struct v4l2_isp_params_block_header header;
+ __u32 mode;
+ __u8 grn_stage1;
+ __u8 chr_h_mode;
+ __u8 chr_v_mode;
+ __u32 thresh_bl0;
+ __u32 thresh_bl1;
+ __u32 thresh_sh0;
+ __u32 thresh_sh1;
+ __u32 lum_weight;
+ __u32 fac_sh1;
+ __u32 fac_sh0;
+ __u32 fac_mid;
+ __u32 fac_bl0;
+ __u32 fac_bl1;
+};
+
+/**
+ * struct rppx1_params_bdm_config - Bayer Demosaic configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_BDM)
+ * @demosaic_th: threshold for texture detection, 16-bit
+ */
+struct rppx1_params_bdm_config {
+ struct v4l2_isp_params_block_header header;
+ __u16 demosaic_th;
+};
+
+/**
+ * struct rppx1_params_ctk_config - Color Correction (Cross-Talk) configuration
+ *
+ * RPP-X1 coefficients are 16-bit signed fixed-point (Q4.12).
+ * Range: -8.0 (0x8000) to +7.9996 (0x7FFF), 1.0 = 0x1000.
+ *
+ * RPP-X1 offsets are up to 24-bit + sign depending on hardware version.
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_CTK)
+ * @coeff: 3x3 color correction matrix, Q4.12 signed
+ * @ct_offset: R, G, B offsets, up to 25-bit signed
+ */
+struct rppx1_params_ctk_config {
+ struct v4l2_isp_params_block_header header;
+ __u16 coeff[3][3];
+ __u32 ct_offset[3];
+};
+
+/**
+ * struct rppx1_params_goc_config - Gamma Out Correction configuration
+ *
+ * RPP-X1 gamma output values are up to 24-bit depending on hardware version.
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_GOC)
+ * @mode: gamma curve mode (0 = logarithmic, 1 = equidistant)
+ * @gamma_y: gamma out curve y-axis values, up to 24-bit
+ */
+struct rppx1_params_goc_config {
+ struct v4l2_isp_params_block_header header;
+ __u32 mode;
+ __u32 gamma_y[RPPX1_GAMMA_OUT_MAX_SAMPLES];
+};
+
+/**
+ * enum rppx1_dpf_gain_usage - DPF noise function gain usage mode
+ * @RPPX1_DPF_GAIN_USAGE_DISABLED: gain not used
+ * @RPPX1_DPF_GAIN_USAGE_NF_GAINS: use noise function gains
+ * @RPPX1_DPF_GAIN_USAGE_LSC_GAINS: use LSC gains
+ * @RPPX1_DPF_GAIN_USAGE_NF_LSC_GAINS: use noise function and LSC gains
+ * @RPPX1_DPF_GAIN_USAGE_AWB_GAINS: use AWB gains
+ * @RPPX1_DPF_GAIN_USAGE_AWB_LSC_GAINS: use AWB and LSC gains
+ */
+enum rppx1_dpf_gain_usage {
+ RPPX1_DPF_GAIN_USAGE_DISABLED,
+ RPPX1_DPF_GAIN_USAGE_NF_GAINS,
+ RPPX1_DPF_GAIN_USAGE_LSC_GAINS,
+ RPPX1_DPF_GAIN_USAGE_NF_LSC_GAINS,
+ RPPX1_DPF_GAIN_USAGE_AWB_GAINS,
+ RPPX1_DPF_GAIN_USAGE_AWB_LSC_GAINS,
+};
+
+/**
+ * enum rppx1_nll_scale_mode - DPF noise level lookup scale mode
+ * @RPPX1_NLL_SCALE_LINEAR: linear scaling
+ * @RPPX1_NLL_SCALE_LOGARITHMIC: logarithmic scaling
+ */
+enum rppx1_nll_scale_mode {
+ RPPX1_NLL_SCALE_LINEAR,
+ RPPX1_NLL_SCALE_LOGARITHMIC,
+};
+
+/**
+ * enum rppx1_dpf_rb_filtersize - DPF red/blue filter kernel size
+ * @RPPX1_DPF_RB_FILTERSIZE_13x9: 13x9 filter size
+ * @RPPX1_DPF_RB_FILTERSIZE_9x9: 9x9 filter size
+ */
+enum rppx1_dpf_rb_filtersize {
+ RPPX1_DPF_RB_FILTERSIZE_13x9,
+ RPPX1_DPF_RB_FILTERSIZE_9x9,
+};
+
+/**
+ * struct rppx1_dpf_gain - DPF noise function gain configuration
+ *
+ * @mode: gain usage mode
+ * @nf_r_gain: noise function gain replacing AWB gain for red
+ * @nf_b_gain: noise function gain replacing AWB gain for blue
+ * @nf_gr_gain: noise function gain replacing AWB gain for green-in-red
+ * @nf_gb_gain: noise function gain replacing AWB gain for green-in-blue
+ */
+struct rppx1_dpf_gain {
+ __u32 mode;
+ __u16 nf_r_gain;
+ __u16 nf_b_gain;
+ __u16 nf_gr_gain;
+ __u16 nf_gb_gain;
+};
+
+#define RPPX1_DPF_MAX_NLF_COEFFS 17
+#define RPPX1_DPF_MAX_SPATIAL_COEFFS 6
+
+/**
+ * struct rppx1_dpf_nll - DPF noise level lookup
+ *
+ * @coeff: noise level lookup coefficients
+ * @scale_mode: 0 = linear, 1 = logarithmic
+ */
+struct rppx1_dpf_nll {
+ __u16 coeff[RPPX1_DPF_MAX_NLF_COEFFS];
+ __u32 scale_mode;
+};
+
+/**
+ * struct rppx1_dpf_rb_flt - DPF red/blue filter configuration
+ *
+ * @fltsize: filter kernel size (0 = 13x9, 1 = 9x9)
+ * @spatial_coeff: spatial weight coefficients
+ * @r_enable: enable filter for red pixels
+ * @b_enable: enable filter for blue pixels
+ */
+struct rppx1_dpf_rb_flt {
+ __u32 fltsize;
+ __u8 spatial_coeff[RPPX1_DPF_MAX_SPATIAL_COEFFS];
+ __u8 r_enable;
+ __u8 b_enable;
+};
+
+/**
+ * struct rppx1_dpf_g_flt - DPF green filter configuration
+ *
+ * @spatial_coeff: spatial weight coefficients
+ * @gr_enable: enable filter for green-in-red pixels
+ * @gb_enable: enable filter for green-in-blue pixels
+ */
+struct rppx1_dpf_g_flt {
+ __u8 spatial_coeff[RPPX1_DPF_MAX_SPATIAL_COEFFS];
+ __u8 gr_enable;
+ __u8 gb_enable;
+};
+
+/**
+ * struct rppx1_params_dpf_config - De-noising Pre-Filter configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_DPF)
+ * @gain: noise function gain
+ * @g_flt: green filter configuration
+ * @rb_flt: red/blue filter configuration
+ * @nll: noise level lookup
+ */
+struct rppx1_params_dpf_config {
+ struct v4l2_isp_params_block_header header;
+ struct rppx1_dpf_gain gain;
+ struct rppx1_dpf_g_flt g_flt;
+ struct rppx1_dpf_rb_flt rb_flt;
+ struct rppx1_dpf_nll nll;
+};
+
+/**
+ * struct rppx1_params_dpf_strength_config - DPF strength configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_DPF_STRENGTH)
+ * @r: filter strength for RED
+ * @g: filter strength for GREEN
+ * @b: filter strength for BLUE
+ */
+struct rppx1_params_dpf_strength_config {
+ struct v4l2_isp_params_block_header header;
+ __u8 r;
+ __u8 g;
+ __u8 b;
+};
+
+/**
+ * enum rppx1_awb_mode_type - AWB measurement mode
+ * @RPPX1_AWB_MODE_MANUAL: manual white balance
+ * @RPPX1_AWB_MODE_RGB: RGB measurement mode
+ * @RPPX1_AWB_MODE_YCBCR: YCbCr measurement mode
+ */
+enum rppx1_awb_mode_type {
+ RPPX1_AWB_MODE_MANUAL,
+ RPPX1_AWB_MODE_RGB,
+ RPPX1_AWB_MODE_YCBCR,
+};
+
+/**
+ * struct rppx1_params_awb_meas_config - AWB measurement configuration
+ *
+ * RPP-X1 min_y, max_y, min_c, max_csum, awb_ref_cr, awb_ref_cb are up to
+ * 24-bit depending on hardware version (8/20/24-bit).
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_AWB_MEAS)
+ * @awb_wnd: measurement window
+ * @awb_mode: measurement mode (from enum rppx1_awb_mode_type)
+ * @max_y: upper pixel value limit, up to 24-bit
+ * @min_y: lower pixel value limit, up to 24-bit
+ * @max_csum: chrominance sum maximum, up to 24-bit
+ * @min_c: chrominance minimum, up to 24-bit
+ * @frames: number of frames for mean value calculation (0 = 1 frame)
+ * @awb_ref_cr: reference Cr for AWB regulation, up to 24-bit
+ * @awb_ref_cb: reference Cb for AWB regulation, up to 24-bit
+ * @enable_ymax_cmp: enable Y_MAX compare
+ */
+struct rppx1_params_awb_meas_config {
+ struct v4l2_isp_params_block_header header;
+ struct rppx1_window awb_wnd;
+ __u32 awb_mode;
+ __u32 max_y;
+ __u32 min_y;
+ __u32 max_csum;
+ __u32 min_c;
+ __u8 frames;
+ __u32 awb_ref_cr;
+ __u32 awb_ref_cb;
+ __u8 enable_ymax_cmp;
+};
+
+/**
+ * enum rppx1_histogram_mode - Histogram measurement mode
+ * @RPPX1_HISTOGRAM_MODE_DISABLE: histogram disabled
+ * @RPPX1_HISTOGRAM_MODE_RGB_COMBINED: combined RGB histogram
+ * @RPPX1_HISTOGRAM_MODE_R_HISTOGRAM: red channel histogram
+ * @RPPX1_HISTOGRAM_MODE_G_HISTOGRAM: green channel histogram
+ * @RPPX1_HISTOGRAM_MODE_B_HISTOGRAM: blue channel histogram
+ * @RPPX1_HISTOGRAM_MODE_Y_HISTOGRAM: luminance histogram
+ */
+enum rppx1_histogram_mode {
+ RPPX1_HISTOGRAM_MODE_DISABLE,
+ RPPX1_HISTOGRAM_MODE_RGB_COMBINED,
+ RPPX1_HISTOGRAM_MODE_R_HISTOGRAM,
+ RPPX1_HISTOGRAM_MODE_G_HISTOGRAM,
+ RPPX1_HISTOGRAM_MODE_B_HISTOGRAM,
+ RPPX1_HISTOGRAM_MODE_Y_HISTOGRAM,
+};
+
+#define RPPX1_HISTOGRAM_WEIGHT_GRIDS_SIZE 25
+
+/**
+ * struct rppx1_params_hst_config - Histogram measurement configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_HST_MEAS)
+ * @mode: histogram mode (from enum rppx1_histogram_mode)
+ * @histogram_predivider: process every Nth pixel
+ * @meas_window: measurement window coordinates
+ * @hist_weight: weighting factors for sub-windows (5x5 grid)
+ */
+struct rppx1_params_hst_config {
+ struct v4l2_isp_params_block_header header;
+ __u32 mode;
+ __u8 histogram_predivider;
+ struct rppx1_window meas_window;
+ __u8 hist_weight[RPPX1_HISTOGRAM_WEIGHT_GRIDS_SIZE];
+};
+
+/**
+ * enum rppx1_exp_meas_mode - Exposure measurement mode
+ * @RPPX1_EXP_MEASURING_MODE_0: Y = 16 + 0.25R + 0.5G + 0.1094B
+ * @RPPX1_EXP_MEASURING_MODE_1: Y = (R + G + B) x (85/256)
+ */
+enum rppx1_exp_meas_mode {
+ RPPX1_EXP_MEASURING_MODE_0,
+ RPPX1_EXP_MEASURING_MODE_1,
+};
+
+/**
+ * struct rppx1_params_aec_config - Auto Exposure measurement configuration
+ *
+ * @header: block header (type = RPPX1_PARAMS_BLOCK_TYPE_AEC_MEAS)
+ * @mode: exposure measure mode (from enum rppx1_exp_meas_mode)
+ * @autostop: 0 = continuous, 1 = stop after one frame
+ * @meas_window: measurement window coordinates
+ */
+struct rppx1_params_aec_config {
+ struct v4l2_isp_params_block_header header;
+ __u32 mode;
+ __u32 autostop;
+ struct rppx1_window meas_window;
+};
+
+/**
+ * RPPX1_PARAMS_MAX_SIZE - Maximum size of all RPP-X1 parameter blocks
+ */
+#define RPPX1_PARAMS_MAX_SIZE \
+ (sizeof(struct rppx1_params_bls_config) + \
+ sizeof(struct rppx1_params_dpcc_config) + \
+ sizeof(struct rppx1_params_lin_config) + \
+ sizeof(struct rppx1_params_awb_gain_config) + \
+ sizeof(struct rppx1_params_flt_config) + \
+ sizeof(struct rppx1_params_bdm_config) + \
+ sizeof(struct rppx1_params_ctk_config) + \
+ sizeof(struct rppx1_params_goc_config) + \
+ sizeof(struct rppx1_params_dpf_config) + \
+ sizeof(struct rppx1_params_dpf_strength_config) + \
+ sizeof(struct rppx1_params_lsc_config) + \
+ sizeof(struct rppx1_params_awb_meas_config) + \
+ sizeof(struct rppx1_params_hst_config) + \
+ sizeof(struct rppx1_params_aec_config))
+
+/* ---------------------------------------------------------------------------
+ * Statistics Structures
+ *
+ * Native RPP-X1 precision. Fields use __u32 where the hardware provides
+ * wider-than-8-bit results.
+ */
+
+/**
+ * struct rppx1_awb_meas - AWB measured values
+ *
+ * @cnt: white pixel count
+ * @mean_y_or_g: mean Y (or G in RGB mode), up to 24-bit
+ * @mean_cb_or_b: mean Cb (or B in RGB mode), up to 24-bit
+ * @mean_cr_or_r: mean Cr (or R in RGB mode), up to 24-bit
+ */
+struct rppx1_awb_meas {
+ __u32 cnt;
+ __u32 mean_y_or_g;
+ __u32 mean_cb_or_b;
+ __u32 mean_cr_or_r;
+};
+
+/**
+ * struct rppx1_awb_stat - AWB statistics
+ *
+ * @awb_mean: measured AWB data
+ */
+struct rppx1_awb_stat {
+ struct rppx1_awb_meas awb_mean[RPPX1_AWB_MAX_GRID];
+};
+
+/**
+ * struct rppx1_bls_meas_val - BLS measured values
+ *
+ * RPP-X1 BLS statistics can be 8/20/24-bit depending on version.
+ *
+ * @meas_r: mean measured value for Bayer pattern R
+ * @meas_gr: mean measured value for Bayer pattern Gr
+ * @meas_gb: mean measured value for Bayer pattern Gb
+ * @meas_b: mean measured value for Bayer pattern B
+ */
+struct rppx1_bls_meas_val {
+ __u32 meas_r;
+ __u32 meas_gr;
+ __u32 meas_gb;
+ __u32 meas_b;
+};
+
+/**
+ * struct rppx1_ae_stat - Auto Exposure statistics
+ *
+ * RPP-X1 exposure mean values are up to 20-bit depending on version.
+ * The image is divided into a 5x5 grid (25 blocks).
+ *
+ * @exp_mean: mean luminance values per block, up to 20-bit
+ * @bls_val: BLS measured values
+ */
+struct rppx1_ae_stat {
+ __u32 exp_mean[RPPX1_EXM_MEAN_MAX];
+ struct rppx1_bls_meas_val bls_val;
+};
+
+/**
+ * struct rppx1_hist_stat - Histogram statistics
+ *
+ * @hist_bins: 32 histogram bin counters, each 20-bit unsigned fixed point
+ * (bits 0-4 fractional, bits 5-19 integer)
+ */
+struct rppx1_hist_stat {
+ __u32 hist_bins[RPPX1_HIST_BIN_N_MAX];
+};
+
+/**
+ * struct rppx1_stat - RPP-X1 3A statistics
+ *
+ * @awb: auto white balance statistics
+ * @ae: auto exposure statistics
+ * @hist: histogram statistics
+ */
+struct rppx1_stat {
+ struct rppx1_awb_stat awb;
+ struct rppx1_ae_stat ae;
+ struct rppx1_hist_stat hist;
+};
+
+/**
+ * RPPX1_STAT_AWB - AWB measurement data available
+ * RPPX1_STAT_AUTOEXP - Auto exposure measurement data available
+ * RPPX1_STAT_HIST - Histogram measurement data available
+ */
+#define RPPX1_STAT_AWB (1U << 0)
+#define RPPX1_STAT_AUTOEXP (1U << 1)
+#define RPPX1_STAT_HIST (1U << 2)
+
+/**
+ * struct rppx1_stat_buffer - RPP-X1 statistics metadata buffer
+ *
+ * @meas_type: bitmask of available measurements (RPPX1_STAT_*)
+ * @frame_id: frame identifier for synchronization
+ * @params: statistics data
+ */
+struct rppx1_stat_buffer {
+ __u32 meas_type;
+ __u32 frame_id;
+ struct rppx1_stat params;
+};
+
+#endif /* __UAPI_RPP_X1_CONFIG_H */
--
2.53.0