Hi all,
This patch extends the gpio-backlight driver and its Device Tree
bindings to support multiple GPIOs for controlling a single
backlight device.
Some panels require more than one GPIO to enable or disable the
backlight, and previously the driver only supported a single GPIO.
With this change:
- The driver now handles an array of GPIOs and updates all of them
based on brightness state.
- The Device Tree binding has been updated to allow specifying one
or more GPIOs for a gpio-backlight node.
This approach avoids describing multiple backlight devices in DT for a
single panel.
Changes in v2:
- Used devm_gpiod_get_array() and struct gpio_descs
- Replaced per-index GPIO handling with descriptor array access
- Moved the bitmap allocation to probe using devm_kcalloc().
- Updated commit messages.
Thanks,
Anusha
Sudarshan Shetty (2):
dt-bindings: backlight: gpio-backlight: allow multiple GPIOs
backlight: gpio: add support for multiple GPIOs for backlight control
.../leds/backlight/gpio-backlight.yaml | 24 ++++++-
drivers/video/backlight/gpio_backlight.c | 66 +++++++++++++------
2 files changed, 67 insertions(+), 23 deletions(-)
--
2.34.1
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Signed-off-by: Sudarshan Shetty <redacted>
---
.../leds/backlight/gpio-backlight.yaml | 24 +++++++++++++++++--
1 file changed, 22 insertions(+), 2 deletions(-)
@@ -16,8 +16,18 @@ properties:const:gpio-backlightgpios:-description:The gpio that is used for enabling/disabling the backlight.-maxItems:1+description:|+The gpio that is used for enabling/disabling the backlight.+Multiple GPIOs can be specified for panels that require several+enable signals. All GPIOs are controlled together.+type:array+minItems:1+items:+type:array+minItems:3+maxItems:3+items:+type:integerdefault-on:description:enable the backlight at boot.
The gpio-backlight driver currently supports only a single GPIO to
enable or disable a backlight device. Some panels require multiple
enable GPIOs to be asserted together.
Extend the driver to support an array of GPIOs for a single backlight
instance. All configured GPIOs are toggled together based on the
backlight state.
Existing single-GPIO Device Tree users remain unaffected.
Signed-off-by: Sudarshan Shetty <redacted>
---
drivers/video/backlight/gpio_backlight.c | 66 ++++++++++++++++--------
1 file changed, 45 insertions(+), 21 deletions(-)
@@ -48,26 +60,43 @@ static int gpio_backlight_probe(struct platform_device *pdev)structdevice*dev=&pdev->dev;structgpio_backlight_platform_data*pdata=dev_get_platdata(dev);structdevice_node*of_node=dev->of_node;-structbacklight_propertiesprops;+structbacklight_propertiesprops={};structbacklight_device*bl;structgpio_backlight*gbl;-intret,init_brightness,def_value;+booldef_value;+enumgpiod_flagsflags;+unsignedintn;+intwords;-gbl=devm_kzalloc(dev,sizeof(*gbl),GFP_KERNEL);-if(gbl==NULL)+gbl=devm_kcalloc(dev,1,sizeof(*gbl),GFP_KERNEL);+if(!gbl)return-ENOMEM;if(pdata)gbl->dev=pdata->dev;def_value=device_property_read_bool(dev,"default-on");+flags=def_value?GPIOD_OUT_HIGH:GPIOD_OUT_LOW;++gbl->gpiods=devm_gpiod_get_array(dev,NULL,flags);+if(IS_ERR(gbl->gpiods)){+if(PTR_ERR(gbl->gpiods)==-ENODEV)+returndev_err_probe(dev,-EINVAL,+"The gpios parameter is missing or invalid\n");+returnPTR_ERR(gbl->gpiods);+}-gbl->gpiod=devm_gpiod_get(dev,NULL,GPIOD_ASIS);-if(IS_ERR(gbl->gpiod))-returndev_err_probe(dev,PTR_ERR(gbl->gpiod),-"The gpios parameter is missing or invalid\n");+n=gbl->gpiods->ndescs;+if(!n)+returndev_err_probe(dev,-EINVAL,+"No GPIOs provided\n");++words=BITS_TO_LONGS(n);+gbl->bitmap=devm_kcalloc(dev,words,sizeof(unsignedlong),+GFP_KERNEL);+if(!gbl->bitmap)+return-ENOMEM;-memset(&props,0,sizeof(props));props.type=BACKLIGHT_RAW;props.max_brightness=1;bl=devm_backlight_device_register(dev,dev_name(dev),dev,gbl,
@@ -81,21 +110,16 @@ static int gpio_backlight_probe(struct platform_device *pdev)if(!of_node||!of_node->phandle)/* Not booted with device tree or no phandle link to the node */bl->props.power=def_value?BACKLIGHT_POWER_ON-:BACKLIGHT_POWER_OFF;-elseif(gpiod_get_value_cansleep(gbl->gpiod)==0)+:BACKLIGHT_POWER_OFF;+elseif(gpiod_get_value_cansleep(gbl->gpiods->desc[0])==0)bl->props.power=BACKLIGHT_POWER_OFF;elsebl->props.power=BACKLIGHT_POWER_ON;-bl->props.brightness=1;--init_brightness=backlight_get_brightness(bl);-ret=gpiod_direction_output(gbl->gpiod,init_brightness);-if(ret){-dev_err(dev,"failed to set initial brightness\n");-returnret;-}+bl->props.brightness=def_value?1:0;+gpio_backlight_update_status(bl);+platform_set_drvdata(pdev,bl);return0;}
From: Krzysztof Kozlowski <krzk@kernel.org> Date: 2026-01-20 14:31:17
On 20/01/2026 13:50, Sudarshan Shetty wrote:
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
@@ -16,8 +16,18 @@ properties:const:gpio-backlightgpios:-description:The gpio that is used for enabling/disabling the backlight.-maxItems:1+description:|+The gpio that is used for enabling/disabling the backlight.+Multiple GPIOs can be specified for panels that require several+enable signals. All GPIOs are controlled together.+type:array
There is no such syntax in the bindings, from where did you get it? Type
is already defined.
items:
minItems: 1
maxItems: 3
All this is some odd stuff - just to be clear, don't send us LLM output.
I don't want to waste my time to review microslop.
Was it done with help of Microslop?
Best regards,
Krzysztof
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
@@ -16,8 +16,18 @@ properties:const:gpio-backlightgpios:-description:The gpio that is used for enabling/disabling the backlight.-maxItems:1+description:|+The gpio that is used for enabling/disabling the backlight.+Multiple GPIOs can be specified for panels that require several+enable signals. All GPIOs are controlled together.+type:array
There is no such syntax in the bindings, from where did you get it? Type
is already defined.
items:
minItems: 1
maxItems: 3
All this is some odd stuff - just to be clear, don't send us LLM output.
I don't want to waste my time to review microslop.
Was it done with help of Microslop?
I understand now that the schema changes I proposed were not correct,
and I will address this in the next patch series. My intention was to
check whether the gpio-backlight binding could support more than one
enable-type GPIO.
Could you please advise what would be an appropriate maximum number of
GPIOs for gpio-backlight in such a scenario? For example, would allowing
2 GPIOs be acceptable, or should this case be handled in a different way?
On 23-01-2026 16:41, tessolveupstream@gmail.com wrote:
On 20-01-2026 20:01, Krzysztof Kozlowski wrote:
quoted
On 20/01/2026 13:50, Sudarshan Shetty wrote:
quoted
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
@@ -16,8 +16,18 @@ properties:const:gpio-backlightgpios:-description:The gpio that is used for enabling/disabling the backlight.-maxItems:1+description:|+The gpio that is used for enabling/disabling the backlight.+Multiple GPIOs can be specified for panels that require several+enable signals. All GPIOs are controlled together.+type:array
There is no such syntax in the bindings, from where did you get it? Type
is already defined.
items:
minItems: 1
maxItems: 3
All this is some odd stuff - just to be clear, don't send us LLM output.
I don't want to waste my time to review microslop.
Was it done with help of Microslop?
I understand now that the schema changes I proposed were not correct,
and I will address this in the next patch series. My intention was to
check whether the gpio-backlight binding could support more than one
enable-type GPIO.
Could you please advise what would be an appropriate maximum number of
GPIOs for gpio-backlight in such a scenario? For example, would allowing
2 GPIOs be acceptable, or should this case be handled in a different way?
In line with Daniel’s suggestion, I am planning to adopt a fixed upper
limit for the number of backlight GPIOs. The current hardware only
requires two GPIOs, so the maxItems can be set to 2.
If future platforms or customers require support for a higher number
of GPIOs, this limit can be increased and the driver can be
updated accordingly.
Kindly advise if this solution aligns with your expectations, or if
you prefer an alternative maximum value.
From: Krzysztof Kozlowski <krzk@kernel.org> Date: 2026-01-28 10:11:38
On 23/01/2026 12:11, tessolveupstream@gmail.com wrote:
On 20-01-2026 20:01, Krzysztof Kozlowski wrote:
quoted
On 20/01/2026 13:50, Sudarshan Shetty wrote:
quoted
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
@@ -16,8 +16,18 @@ properties:const:gpio-backlightgpios:-description:The gpio that is used for enabling/disabling the backlight.-maxItems:1+description:|+The gpio that is used for enabling/disabling the backlight.+Multiple GPIOs can be specified for panels that require several+enable signals. All GPIOs are controlled together.+type:array
There is no such syntax in the bindings, from where did you get it? Type
is already defined.
items:
minItems: 1
maxItems: 3
All this is some odd stuff - just to be clear, don't send us LLM output.
I don't want to waste my time to review microslop.
Was it done with help of Microslop?
I understand now that the schema changes I proposed were not correct,
How such code could be even created... Just in case, do you understand
that Microslop and LLM is waste of our time?
and I will address this in the next patch series. My intention was to
check whether the gpio-backlight binding could support more than one
enable-type GPIO.
Could you please advise what would be an appropriate maximum number of
GPIOs for gpio-backlight in such a scenario? For example, would allowing
2 GPIOs be acceptable, or should this case be handled in a different way?
We have plenty of examples for this, but anyway you won't need it
because this is not an enable GPIO.
Best regards,
Krzysztof
From: Krzysztof Kozlowski <krzk@kernel.org> Date: 2026-01-28 10:14:26
On 27/01/2026 13:46, tessolveupstream@gmail.com wrote:
On 23-01-2026 16:41, tessolveupstream@gmail.com wrote:
quoted
On 20-01-2026 20:01, Krzysztof Kozlowski wrote:
quoted
On 20/01/2026 13:50, Sudarshan Shetty wrote:
quoted
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
@@ -16,8 +16,18 @@ properties:const:gpio-backlightgpios:-description:The gpio that is used for enabling/disabling the backlight.-maxItems:1+description:|+The gpio that is used for enabling/disabling the backlight.+Multiple GPIOs can be specified for panels that require several+enable signals. All GPIOs are controlled together.+type:array
There is no such syntax in the bindings, from where did you get it? Type
is already defined.
items:
minItems: 1
maxItems: 3
All this is some odd stuff - just to be clear, don't send us LLM output.
I don't want to waste my time to review microslop.
Was it done with help of Microslop?
I understand now that the schema changes I proposed were not correct,
and I will address this in the next patch series. My intention was to
check whether the gpio-backlight binding could support more than one
enable-type GPIO.
Could you please advise what would be an appropriate maximum number of
GPIOs for gpio-backlight in such a scenario? For example, would allowing
2 GPIOs be acceptable, or should this case be handled in a different way?
In line with Daniel’s suggestion, I am planning to adopt a fixed upper
limit for the number of backlight GPIOs. The current hardware only
requires two GPIOs, so the maxItems can be set to 2.
If future platforms or customers require support for a higher number
of GPIOs, this limit can be increased and the driver can be
updated accordingly.
Kindly advise if this solution aligns with your expectations, or if
you prefer an alternative maximum value.
You have entire commit msg to explain the hardware and explain WHY you
are doing this. In a concise and readable way. I will not be going
through 2 different email threads with 20 messages to figure that out.
Best regards,
Krzysztof
From: Daniel Thompson <hidden> Date: 2026-01-28 10:58:04
On Tue, Jan 20, 2026 at 06:20:36PM +0530, Sudarshan Shetty wrote:
quoted hunk
The gpio-backlight driver currently supports only a single GPIO to
enable or disable a backlight device. Some panels require multiple
enable GPIOs to be asserted together.
Extend the driver to support an array of GPIOs for a single backlight
instance. All configured GPIOs are toggled together based on the
backlight state.
Existing single-GPIO Device Tree users remain unaffected.
Signed-off-by: Sudarshan Shetty <redacted>
---
drivers/video/backlight/gpio_backlight.c | 66 ++++++++++++++++--------
1 file changed, 45 insertions(+), 21 deletions(-)
@@ -48,26 +60,43 @@ static int gpio_backlight_probe(struct platform_device *pdev)structdevice*dev=&pdev->dev;structgpio_backlight_platform_data*pdata=dev_get_platdata(dev);structdevice_node*of_node=dev->of_node;-structbacklight_propertiesprops;+structbacklight_propertiesprops={};
This change is unrelated to the patch description. Do not "hide"
changes like this. It you want to replace the memset() it's better to
send a separate patch.
struct backlight_device *bl;
struct gpio_backlight *gbl;
- int ret, init_brightness, def_value;
+ bool def_value;
+ enum gpiod_flags flags;
+ unsigned int n;
+ int words;
- gbl = devm_kzalloc(dev, sizeof(*gbl), GFP_KERNEL);
- if (gbl == NULL)
+ gbl = devm_kcalloc(dev, 1, sizeof(*gbl), GFP_KERNEL);
+ if (!gbl)
Again, this change is unrelated to the patch description. Do not include
changes that are not described in the patch description.
How is it safe to transition from GPIOD_ASIS to GPIOD_OUT_LOW
here?
Forcing the backlight off if the default-on property is not present
will prevent the backlight state being properly inherited from the
bootloader.
quoted hunk
+ if (IS_ERR(gbl->gpiods)) {
+ if (PTR_ERR(gbl->gpiods) == -ENODEV)
+ return dev_err_probe(dev, -EINVAL,
+ "The gpios parameter is missing or invalid\n");
+ return PTR_ERR(gbl->gpiods);
+ }
- gbl->gpiod = devm_gpiod_get(dev, NULL, GPIOD_ASIS);
- if (IS_ERR(gbl->gpiod))
- return dev_err_probe(dev, PTR_ERR(gbl->gpiod),
- "The gpios parameter is missing or invalid\n");
+ n = gbl->gpiods->ndescs;
+ if (!n)
+ return dev_err_probe(dev, -EINVAL,
+ "No GPIOs provided\n");
+
+ words = BITS_TO_LONGS(n);
+ gbl->bitmap = devm_kcalloc(dev, words, sizeof(unsigned long),
+ GFP_KERNEL);
+ if (!gbl->bitmap)
+ return -ENOMEM;
- memset(&props, 0, sizeof(props));
props.type = BACKLIGHT_RAW;
props.max_brightness = 1;
bl = devm_backlight_device_register(dev, dev_name(dev), dev, gbl,
@@ -81,21 +110,16 @@ static int gpio_backlight_probe(struct platform_device *pdev) if (!of_node || !of_node->phandle) /* Not booted with device tree or no phandle link to the node */ bl->props.power = def_value ? BACKLIGHT_POWER_ON- : BACKLIGHT_POWER_OFF;- else if (gpiod_get_value_cansleep(gbl->gpiod) == 0)+ : BACKLIGHT_POWER_OFF;+ else if (gpiod_get_value_cansleep(gbl->gpiods->desc[0]) == 0)
This logic is broken. This code path needs to be taken is *any* GPIO is
low (and, as mentioned, the initial GPIO state must be GPIOD_ASIS).
From: Daniel Thompson <hidden> Date: 2026-01-28 11:21:01
On Wed, Jan 28, 2026 at 11:11:33AM +0100, Krzysztof Kozlowski wrote:
On 23/01/2026 12:11, tessolveupstream@gmail.com wrote:
quoted
On 20-01-2026 20:01, Krzysztof Kozlowski wrote:
quoted
On 20/01/2026 13:50, Sudarshan Shetty wrote:
quoted
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
That's not an enable gpio, but PWM.
You write bindings for this device, not for something else - like your
board.
Sudarshan: I believe at one point the intent was to model this hardware
as a pwm-backlight (using enables GPIOs to drive the enable pin)
attached to a pwm-gpio (to drive the PWM pin). Did this approach work?
Daniel.
On Wed, Jan 28, 2026 at 11:11:33AM +0100, Krzysztof Kozlowski wrote:
quoted
On 23/01/2026 12:11, tessolveupstream@gmail.com wrote:
quoted
On 20-01-2026 20:01, Krzysztof Kozlowski wrote:
quoted
On 20/01/2026 13:50, Sudarshan Shetty wrote:
quoted
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
That's not an enable gpio, but PWM.
You write bindings for this device, not for something else - like your
board.
Sudarshan: I believe at one point the intent was to model this hardware
as a pwm-backlight (using enables GPIOs to drive the enable pin)
attached to a pwm-gpio (to drive the PWM pin). Did this approach work?
Yes, the original plan was to model this using pwm‑gpio, and that
setup worked. But on the SOC there’s no actual PWM controller available
for this path— the LED_PWM line is just tied to a GPIO that’s driven
high (effectively a fixed 100% duty cycle). Because of that, describing
it as a PWM in DT was flagged as incorrect.
As pointed out during the SoC DTS review, the correct path forward is
to extend gpio‑backlight to handle multiple GPIOs, rather than
representing them as multiple separate backlight devices.
From: Daniel Thompson <hidden> Date: 2026-02-02 10:28:44
On Thu, Jan 29, 2026 at 11:11:34AM +0530, tessolveupstream@gmail.com wrote:
On 28-01-2026 16:50, Daniel Thompson wrote:
quoted
On Wed, Jan 28, 2026 at 11:11:33AM +0100, Krzysztof Kozlowski wrote:
quoted
On 23/01/2026 12:11, tessolveupstream@gmail.com wrote:
quoted
On 20-01-2026 20:01, Krzysztof Kozlowski wrote:
quoted
On 20/01/2026 13:50, Sudarshan Shetty wrote:
quoted
Update the gpio-backlight binding to support configurations that require
more than one GPIO for enabling/disabling the backlight.
Why? Which devices need it? How a backlight would have three enable
GPIOs? I really do not believe, so you need to write proper hardware
justification.
That's not an enable gpio, but PWM.
You write bindings for this device, not for something else - like your
board.
Sudarshan: I believe at one point the intent was to model this hardware
as a pwm-backlight (using enables GPIOs to drive the enable pin)
attached to a pwm-gpio (to drive the PWM pin). Did this approach work?
Yes, the original plan was to model this using pwm‑gpio, and that
setup worked. But on the SOC there’s no actual PWM controller available
for this path— the LED_PWM line is just tied to a GPIO that’s driven
high (effectively a fixed 100% duty cycle). Because of that, describing
it as a PWM in DT was flagged as incorrect.
As pointed out during the SoC DTS review, the correct path forward is
to extend gpio‑backlight to handle multiple GPIOs, rather than
representing them as multiple separate backlight devices.
That not quite what I got from the link above. There is a suggestion to
use gpio-backlight, but the reason it was flagged is because pwm-gpio
was unused... it was not referenced by a pwm-backlight.
Having said that I suspect it is better to model this backlight controller
on this board as a gpio-backlight because from a backlight controller
point of this that is physically what the controller is composed of
(assuming there is not sufficient capacitance on the signal for a
software PWM to work at anything other than 0% and 100%). Even if those
GPIO signals are connected to the panel's PWM input I'm not sure that's
relevant because none of the backlight controller bindings model the
panel anyway.
Whatever route you select, you do need to make it clear in the patch
description *why* it is correct to model the system as a gpio-backlight.
Deferring to (potentially ambiguous) review comments is not sufficient
to explain why changing the gpio-backlight bindings are an improvement.
Daniel.