[PATCH 2/2] backlight: lm3630a: Allow setting the full-scale current per bank

From: Michiel van Beers via B4 Relay

Date: Sat Nov 07 2026 - 07:15:07 EST


From: Michiel van Beers <michielvanbeers@xxxxxxxxx>

The driver always programs the full-scale current of both control banks
to the maximum of 28.25 mA (code 0x1F). Boards whose LED strings are
rated for less have no way to lower it.

Read the optional led-max-microamp property of each led@ node and
program the full-scale current register of that bank with the matching
code, I_FS = 5 mA + code * 0.75 mA (datasheet SNVS974B, 7.3.1.11). The
code is rounded down, so the current never exceeds the requested value.
Values outside 5000 to 28250 uA are rejected with -EINVAL.

Without the property the driver still programs 0x1F, so existing boards
are unaffected.

Signed-off-by: Michiel van Beers <michielvanbeers@xxxxxxxxx>
---
checkpatch --strict reports errors on the two new kernel-doc lines in
lm3630a_bl.h; the hunk does not include the comment delimiters. With
-U15 it is clean.
---
drivers/video/backlight/lm3630a_bl.c | 40 ++++++++++++++++++++++++++++----
include/linux/platform_data/lm3630a_bl.h | 4 ++++
2 files changed, 40 insertions(+), 4 deletions(-)

diff --git a/drivers/video/backlight/lm3630a_bl.c b/drivers/video/backlight/lm3630a_bl.c
index 8ef8163c7fef..1189011bb89d 100644
--- a/drivers/video/backlight/lm3630a_bl.c
+++ b/drivers/video/backlight/lm3630a_bl.c
@@ -80,6 +80,25 @@ static int lm3630a_update(struct lm3630a_chip *pchip,
return regmap_update_bits(pchip->regmap, reg, mask, data);
}

+/*
+ * Full-scale current register code: I = 5 mA + code * 0.75 mA, code 0..31
+ * (datasheet SNVS974B, 7.3.1.11). Rounds down, so the result never exceeds
+ * the requested current. 0 means "not set" and keeps the chip default 0x1F.
+ */
+#define LM3630A_FS_CURRENT_MIN_UA 5000
+#define LM3630A_FS_CURRENT_STEP_UA 750
+#define LM3630A_FS_CURRENT_MAX_UA 28250
+#define LM3630A_FS_CURRENT_MAX_CODE 0x1F
+
+static unsigned int lm3630a_fs_current_code(unsigned int microamp)
+{
+ if (!microamp)
+ return LM3630A_FS_CURRENT_MAX_CODE;
+
+ return (microamp - LM3630A_FS_CURRENT_MIN_UA) /
+ LM3630A_FS_CURRENT_STEP_UA;
+}
+
/* initialize chip */
static int lm3630a_chip_init(struct lm3630a_chip *pchip)
{
@@ -93,10 +112,12 @@ static int lm3630a_chip_init(struct lm3630a_chip *pchip)
rval |= lm3630a_update(pchip, REG_CONFIG, 0x07, pdata->pwm_ctrl);
/* set boost control */
rval |= lm3630a_write(pchip, REG_BOOST, 0x38);
- /* set current A */
- rval |= lm3630a_update(pchip, REG_I_A, 0x1F, 0x1F);
- /* set current B */
- rval |= lm3630a_write(pchip, REG_I_B, 0x1F);
+ /* set full-scale current A */
+ rval |= lm3630a_update(pchip, REG_I_A, 0x1F,
+ lm3630a_fs_current_code(pdata->leda_max_microamp));
+ /* set full-scale current B */
+ rval |= lm3630a_write(pchip, REG_I_B,
+ lm3630a_fs_current_code(pdata->ledb_max_microamp));
/* set control */
rval |= lm3630a_update(pchip, REG_CTRL, 0x14, pdata->leda_ctrl);
rval |= lm3630a_update(pchip, REG_CTRL, 0x0B, pdata->ledb_ctrl);
@@ -472,6 +493,17 @@ static int lm3630a_parse_bank(struct lm3630a_platform_data *pdata,
pdata->leda_max_brt = val;
}

+ ret = fwnode_property_read_u32(node, "led-max-microamp", &val);
+ if (!ret) {
+ if (val < LM3630A_FS_CURRENT_MIN_UA ||
+ val > LM3630A_FS_CURRENT_MAX_UA)
+ return -EINVAL;
+ if (bank)
+ pdata->ledb_max_microamp = val;
+ else
+ pdata->leda_max_microamp = val;
+ }
+
return 0;
}

diff --git a/include/linux/platform_data/lm3630a_bl.h b/include/linux/platform_data/lm3630a_bl.h
index 530be9318711..43383c476c09 100644
--- a/include/linux/platform_data/lm3630a_bl.h
+++ b/include/linux/platform_data/lm3630a_bl.h
@@ -37,10 +37,12 @@ enum lm3630a_ledb_ctrl {
*@leda_label : optional led a label.
*@leda_init_brt : led a init brightness. 4~255
*@leda_max_brt : led a max brightness. 4~255
+ *@leda_max_microamp : led a full-scale current, 5000~28250 uA (0: default)
*@leda_ctrl : led a disable, enable linear, enable exponential
*@ledb_label : optional led b label.
*@ledb_init_brt : led b init brightness. 4~255
*@ledb_max_brt : led b max brightness. 4~255
+ *@ledb_max_microamp : led b full-scale current, 5000~28250 uA (0: default)
*@ledb_ctrl : led b disable, enable linear, enable exponential
*@pwm_period : pwm period
*@pwm_ctrl : pwm disable, bank a or b, active high or low
@@ -51,11 +53,13 @@ struct lm3630a_platform_data {
const char *leda_label;
int leda_init_brt;
int leda_max_brt;
+ unsigned int leda_max_microamp;
enum lm3630a_leda_ctrl leda_ctrl;
/* led b config. */
const char *ledb_label;
int ledb_init_brt;
int ledb_max_brt;
+ unsigned int ledb_max_microamp;
enum lm3630a_ledb_ctrl ledb_ctrl;
/* pwm config. */
unsigned int pwm_period;

--
2.43.0