[PATCH v6 07/12] media: rppx1: Add support for Black Level Subtraction

From: Niklas Söderlund

Date: Sat Mar 14 2026 - 18:15:35 EST


Extend the RPPX1 driver to allow setting the Black Level Subtraction
(BLS) configuration using the RkISP1 parameter buffer format. It uses
the RPPX1 framework for parameters and its writer abstraction to allow
the user to control how (and when) configuration is applied to the
RPPX1.

As the RkISP1 parameters buffer have lower precision then the RPPX1
hardware the values needs to be scaled. The behavior matches the RkISP1
hardware.

Signed-off-by: Niklas Söderlund <niklas.soderlund+renesas@xxxxxxxxxxxx>
Tested-by: Marek Vasut <marek.vasut+renesas@xxxxxxxxxxx>
---
.../platform/dreamchip/rppx1/rpp_params.c | 4 +
.../platform/dreamchip/rppx1/rpp_stats.c | 5 +-
.../platform/dreamchip/rppx1/rppx1_bls.c | 116 ++++++++++++++++++
3 files changed, 124 insertions(+), 1 deletion(-)

diff --git a/drivers/media/platform/dreamchip/rppx1/rpp_params.c b/drivers/media/platform/dreamchip/rppx1/rpp_params.c
index d8dd783110c6..c1917585e19b 100644
--- a/drivers/media/platform/dreamchip/rppx1/rpp_params.c
+++ b/drivers/media/platform/dreamchip/rppx1/rpp_params.c
@@ -16,6 +16,7 @@

static const struct v4l2_isp_params_block_type_info
rkisp1_ext_params_blocks_info[] = {
+ RKISP1_PARAMS_BLOCK_INFO(BLS, bls),
RKISP1_PARAMS_BLOCK_INFO(AWB_GAIN, awb_gain),
RKISP1_PARAMS_BLOCK_INFO(AWB_MEAS, awb_meas),
RKISP1_PARAMS_BLOCK_INFO(HST_MEAS, hst),
@@ -54,6 +55,9 @@ int rppx1_params(struct rppx1 *rpp, struct vb2_buffer *vb, size_t max_size,
block_offset += block->header.size;

switch (block->header.type) {
+ case RKISP1_EXT_PARAMS_BLOCK_TYPE_BLS:
+ module = &rpp->pre1.bls;
+ break;
case RKISP1_EXT_PARAMS_BLOCK_TYPE_AWB_GAIN:
module = &rpp->pre1.awbg;
break;
diff --git a/drivers/media/platform/dreamchip/rppx1/rpp_stats.c b/drivers/media/platform/dreamchip/rppx1/rpp_stats.c
index 059bd76ecf64..1bffa6dd35f8 100644
--- a/drivers/media/platform/dreamchip/rppx1/rpp_stats.c
+++ b/drivers/media/platform/dreamchip/rppx1/rpp_stats.c
@@ -20,8 +20,11 @@ void rppx1_stats_fill_isr(struct rppx1 *rpp, u32 isc, void *buf)
if (!rpp_module_call(&rpp->post.hist, stats_rkisp1, &stats->params))
stats->meas_type |= RKISP1_CIF_ISP_STAT_HIST;

- if (isc & RPPX1_IRQ_ID_PRE1_EXM)
+ if (isc & RPPX1_IRQ_ID_PRE1_EXM) {
if (!rpp_module_call(&rpp->pre1.exm, stats_rkisp1, &stats->params))
stats->meas_type |= RKISP1_CIF_ISP_STAT_AUTOEXP;
+
+ rpp_module_call(&rpp->pre1.bls, stats_rkisp1, &stats->params);
+ }
}
EXPORT_SYMBOL_GPL(rppx1_stats_fill_isr);
diff --git a/drivers/media/platform/dreamchip/rppx1/rppx1_bls.c b/drivers/media/platform/dreamchip/rppx1/rppx1_bls.c
index de7008befd8e..164bc4a63c23 100644
--- a/drivers/media/platform/dreamchip/rppx1/rppx1_bls.c
+++ b/drivers/media/platform/dreamchip/rppx1/rppx1_bls.c
@@ -5,6 +5,7 @@
*/

#include "rpp_module.h"
+#include "rppx1.h"

#define BLS_VERSION_REG 0x0000

@@ -54,6 +55,121 @@ static int rppx1_bls_probe(struct rpp_module *mod)
return 0;
}

+static void
+rppx1_bls_swap_regs(struct rpp_module *mod, const u32 input[4], u32 output[4])
+{
+ static const unsigned int swap[4][4] = {
+ [RPP_RGGB] = { 0, 1, 2, 3 },
+ [RPP_GRBG] = { 1, 0, 3, 2 },
+ [RPP_GBRG] = { 2, 3, 0, 1 },
+ [RPP_BGGR] = { 3, 2, 1, 0 },
+ };
+
+ /* Swap to pattern used in our path, PRE1 or PRE2. */
+ struct rpp_module *acq = mod == &mod->rpp->pre1.bls ?
+ &mod->rpp->pre1.acq : &mod->rpp->pre2.bls;
+ enum rpp_raw_pattern pattern = acq->info.acq.raw_pattern;
+
+ for (unsigned int i = 0; i < 4; ++i)
+ output[i] = input[swap[pattern][i]];
+}
+
+static int
+rppx1_bls_param_rkisp1(struct rpp_module *mod,
+ const union rppx1_params_rkisp1_config *block,
+ rppx1_reg_write write, void *priv)
+{
+ const struct rkisp1_ext_params_bls_config *cfg = &block->bls;
+
+ /* If the modules is disabled, simply bypass it. */
+ if (cfg->header.flags & RKISP1_EXT_PARAMS_FL_BLOCK_DISABLE) {
+ write(priv, mod->base + BLS_CTRL_REG, 0);
+ return 0;
+ }
+
+ u32 ctrl = BLS_CTRL_BLS_EN;
+
+ if (!cfg->config.enable_auto) {
+ static const u32 regs[] = {
+ BLS_A_FIXED_REG,
+ BLS_B_FIXED_REG,
+ BLS_C_FIXED_REG,
+ BLS_D_FIXED_REG,
+ };
+ u32 swapped[4];
+
+ rppx1_bls_swap_regs(mod, regs, swapped);
+
+ /*
+ * The RkISP params are 12-bit + 1 signed bit, while the RPP can
+ * be 12, 20 or 24 bit + 1 signed bit. Figure out how much we
+ * need to adjust the input parameters.
+ */
+ const unsigned int shift = mod->info.bls.colorbits - 12;
+
+ write(priv, mod->base + swapped[0], cfg->config.fixed_val.r << shift);
+ write(priv, mod->base + swapped[1], cfg->config.fixed_val.gr << shift);
+ write(priv, mod->base + swapped[2], cfg->config.fixed_val.gb << shift);
+ write(priv, mod->base + swapped[3], cfg->config.fixed_val.b << shift);
+ } else {
+ write(priv, mod->base + BLS_SAMPLES_REG, cfg->config.bls_samples);
+
+ if (cfg->config.en_windows & BIT(0)) {
+ write(priv, mod->base + BLS_H1_START_REG, cfg->config.bls_window1.h_offs);
+ write(priv, mod->base + BLS_H1_STOP_REG, cfg->config.bls_window1.h_size);
+ write(priv, mod->base + BLS_V1_START_REG, cfg->config.bls_window1.v_offs);
+ write(priv, mod->base + BLS_V1_STOP_REG, cfg->config.bls_window1.v_size);
+ ctrl |= BLS_CTRL_BLS_WIN1;
+ }
+
+ if (cfg->config.en_windows & BIT(1)) {
+ write(priv, mod->base + BLS_H2_START_REG, cfg->config.bls_window2.h_offs);
+ write(priv, mod->base + BLS_H2_STOP_REG, cfg->config.bls_window2.h_size);
+ write(priv, mod->base + BLS_V2_START_REG, cfg->config.bls_window2.v_offs);
+ write(priv, mod->base + BLS_V2_STOP_REG, cfg->config.bls_window2.v_size);
+ ctrl |= BLS_CTRL_BLS_WIN2;
+ }
+
+ ctrl |= BLS_CTRL_BLS_MODE_MEASURED;
+ }
+
+ write(priv, mod->base + BLS_CTRL_REG, ctrl);
+
+ return 0;
+}
+
+static int rppx1_bls_stats_rkisp1(struct rpp_module *mod,
+ struct rkisp1_cif_isp_stat *stats)
+{
+ struct rkisp1_cif_isp_bls_meas_val *bls = &stats->ae.bls_val;
+
+ static const u32 regs[] = {
+ BLS_A_MEASURED_REG,
+ BLS_B_MEASURED_REG,
+ BLS_C_MEASURED_REG,
+ BLS_D_MEASURED_REG,
+ };
+ u32 swapped[4];
+
+ rppx1_bls_swap_regs(mod, regs, swapped);
+
+ /*
+ * The RkISP BLS stats are 12-bit while the RPP can be 8, 20
+ * or 24 bit. Figure out how much we need to adjust the output
+ * statistics.
+ */
+ const unsigned int shift = mod->info.bls.colorbits - 12;
+
+ bls->meas_r = rpp_module_read(mod, swapped[0]) >> shift;
+ bls->meas_gr = rpp_module_read(mod, swapped[1]) >> shift;
+ bls->meas_gb = rpp_module_read(mod, swapped[2]) >> shift;
+ bls->meas_b = rpp_module_read(mod, swapped[3]) >> shift;
+
+ return 0;
+}
+
const struct rpp_module_ops rppx1_bls_ops = {
.probe = rppx1_bls_probe,
+ .param_rkisp1 = rppx1_bls_param_rkisp1,
+ .stats_rkisp1 = rppx1_bls_stats_rkisp1
};
--
2.53.0