dts: bindings: led: introduce led-node.yaml

This patch moves the label and color-mapping LED property definitions
from led-controller.yaml into led-node.yaml.

This allows to use these properties from a LED node which is not a
child node of a LED controller. This is preparatory work for adding
the leds-group-multicolor binding.

In addition this patch also removes the redundant "label" property
definitions in gpio-leds.yaml and pwm-leds.yaml. It is now included
from led-node.yaml.

Signed-off-by: Simon Guinot <simon.guinot@seagate.com>

Author: simonguinot

dts/bindings/led/gpio-leds.yaml

@@ -36,13 +36,13 @@ compatible: "gpio-leds"
 
 child-binding:
   description: GPIO LED child node
+
+  include:
+    - name: led-node.yaml
+      property-allowlist:
+        - label
+
   properties:
     gpios:
       type: phandle-array
       required: true
-    label:
-      type: string
-      description: |
-        Human readable string describing the LED. It can be used by an
-        application to identify this LED or to retrieve its number/index
-        (i.e. child node number) on the parent device.

dts/bindings/led/led-controller.yaml

@@ -5,10 +5,10 @@
 
 child-binding:
   description: LED child node
+
+  include: led-node.yaml
+
   properties:
-    label:
-      type: string
-      description: Human readable string describing the LED
     index:
       type: int
       description: |
@@ -17,16 +17,3 @@ child-binding:
         controller. For example, this allows to handle boards where the
         LEDs in an array/strip are not wired following the LED order of
         the controller.
-    color-mapping:
-      type: array
-      description: |
-        Channel to color mapping of a multicolor LED. If a LED supports
-        several colors, then the color-mapping property can be used to
-        describe how the hardware channels and the colors are mapped.
-
-        For example the channel to color mapping of RGB LEDs would be
-
-           color-mapping =
-                <LED_COLOR_ID_RED>,
-                <LED_COLOR_ID_GREEN>,
-                <LED_COLOR_ID_BLUE>;

dts/bindings/led/led-node.yaml

@@ -0,0 +1,25 @@
+# Copyright (c) 2025 Seagate Technology LLC
+# SPDX-License-Identifier: Apache-2.0
+
+# Common fields for LED nodes
+
+properties:
+  label:
+    type: string
+    description: |
+      Human readable string describing the LED. It can be used by an
+      application to identify this LED or to retrieve its number/index
+      (i.e. child node number) on the parent device.
+  color-mapping:
+    type: array
+    description: |
+      Channel to color mapping of a multicolor LED. If a LED supports
+      several colors, then the color-mapping property can be used to
+      describe how the hardware channels and the colors are mapped.
+
+      For example the channel to color mapping of RGB LEDs would be
+
+         color-mapping =
+              <LED_COLOR_ID_RED>,
+              <LED_COLOR_ID_GREEN>,
+              <LED_COLOR_ID_BLUE>;

dts/bindings/led/pwm-leds.yaml

@@ -10,6 +10,12 @@ compatible: "pwm-leds"
 
 child-binding:
   description: PWM LED child node
+
+  include:
+    - name: led-node.yaml
+      property-allowlist:
+        - label
+
   properties:
     pwms:
       required: true
@@ -22,10 +28,3 @@ child-binding:
         brigtness granularity) and lesser than 50 milliseconds (average visual
         persistence time of the human eye). Typical values for the PWM period
         are 10 or 20 milliseconds.
-
-    label:
-      type: string
-      description: |
-        Human readable string describing the LED. It can be used by an
-        application to identify this LED or to retrieve its number/index
-        (i.e. child node number) on the parent device.