[PATCH v2 1/2] dt-bindings: leds: Add default-intensity property

From: Jonas Rebmann

Date: Fri Jun 05 2026 - 03:36:33 EST


Document the default-intensity property to set a default color on
multicolor LEDs.

Update pwm-multicolor to support it and update the example to turn the
LED red on boot.

Signed-off-by: Jonas Rebmann <jre@xxxxxxxxxxxxxx>
---
Documentation/devicetree/bindings/leds/common.yaml | 11 +++++++++++
.../devicetree/bindings/leds/leds-pwm-multicolor.yaml | 4 ++++
2 files changed, 15 insertions(+)

diff --git a/Documentation/devicetree/bindings/leds/common.yaml b/Documentation/devicetree/bindings/leds/common.yaml
index f4e44b33f56d..a34de0a34b42 100644
--- a/Documentation/devicetree/bindings/leds/common.yaml
+++ b/Documentation/devicetree/bindings/leds/common.yaml
@@ -73,6 +73,17 @@ properties:
- keep
default: off

+ default-intensity:
+ description:
+ The initial intensity of the LED color component. Used only during
+ initialization. Defaults to 0. As the intensity of each sub-LED is
+ multiplied with the overall brightness, without this property on a
+ sub-LED, the leds-pwm-multicolor-LED is effectively initialized at
+ minimum brightness regardless of its linux,default-trigger and
+ default-brightness properties.
+ $ref: /schemas/types.yaml#/definitions/uint32
+ default: 0
+
linux,default-trigger:
description:
This parameter, if present, is a string defining the trigger assigned to
diff --git a/Documentation/devicetree/bindings/leds/leds-pwm-multicolor.yaml b/Documentation/devicetree/bindings/leds/leds-pwm-multicolor.yaml
index a31a202afe5c..7bf687c89411 100644
--- a/Documentation/devicetree/bindings/leds/leds-pwm-multicolor.yaml
+++ b/Documentation/devicetree/bindings/leds/leds-pwm-multicolor.yaml
@@ -45,6 +45,8 @@ properties:

color: true

+ default-intensity: true
+
required:
- pwms
- color
@@ -63,12 +65,14 @@ examples:

multi-led {
color = <LED_COLOR_ID_RGB>;
+ linux,default-trigger = "default-on";
function = LED_FUNCTION_INDICATOR;
max-brightness = <65535>;

led-red {
pwms = <&pwm1 0 1000000>;
color = <LED_COLOR_ID_RED>;
+ default-intensity = <65535>;
};

led-green {

--
2.54.0.129.g3edf2eeba9