[<prev] [next>] [day] [month] [year] [list]
Message-Id: <20250930-brcm6358-to-dt-v1-1-ba833ceb1575@thegoodpenguin.co.uk>
Date: Tue, 30 Sep 2025 11:27:26 +0100
From: Harrison Carter <hcarter@...goodpenguin.co.uk>
To: Lee Jones <lee@...nel.org>, Pavel Machek <pavel@...nel.org>,
Rob Herring <robh@...nel.org>, Krzysztof Kozlowski <krzk+dt@...nel.org>,
Conor Dooley <conor+dt@...nel.org>, Jonas Gorski <jonas.gorski@...il.com>
Cc: linux-leds@...r.kernel.org, devicetree@...r.kernel.org,
linux-kernel@...r.kernel.org,
Harrison Carter <hcarter@...goodpenguin.co.uk>
Subject: [PATCH] dt-bindings: leds: bcm6358: Convert to DT Schema
Convert the brcm,bcm6358 LEDs to DT Schema format
Signed-off-by: Harrison Carter <hcarter@...goodpenguin.co.uk>
---
.../bindings/leds/brcm,bcm6358-leds.yaml | 187 +++++++++++++++++++++
.../devicetree/bindings/leds/leds-bcm6358.txt | 143 ----------------
2 files changed, 187 insertions(+), 143 deletions(-)
diff --git a/Documentation/devicetree/bindings/leds/brcm,bcm6358-leds.yaml b/Documentation/devicetree/bindings/leds/brcm,bcm6358-leds.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..a9052a29aa7bd6ddc252258bfe4982325499713f
--- /dev/null
+++ b/Documentation/devicetree/bindings/leds/brcm,bcm6358-leds.yaml
@@ -0,0 +1,187 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/leds/brcm,bcm6358-leds.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: LEDs connected to Broadcom BCM6358 controller
+
+description: This controller is present on BCM6358 and
+ BCM6368. In these SoCs there are Serial LEDs (LEDs
+ connected to a 74x164 controller), which can either be
+ controlled by software (exporting the 74x164 as spi-gpio)
+ or by hardware using this driver. See example at
+ Documentation/devicetree/bindings/gpio/fairchild,74hc595.yaml.
+
+maintainers:
+ - Jonas Gorski <jonas.gorski@...il.com>
+
+properties:
+ compatible:
+ const: brcm,bcm6358-leds
+
+ reg:
+ maxItems: 1
+
+ '#address-cells':
+ const: 1
+
+ '#size-cells':
+ const: 0
+
+ brcm,clk-div:
+ description: SCK signal Divider. Default 1
+ $ref: /schemas/types.yaml#/definitions/uint32
+ enum: [1, 2, 4, 8]
+
+ brcm,clk-dat-low:
+ description: Makes clock and data signals active low.
+ Default false.
+ type: boolean
+
+patternProperties:
+ "^led@[0,1]?([0-9]|[a-z])$":
+ type: object
+ $ref: common.yaml
+ description: Each LED is represented as a sub-node of
+ this device.
+
+ properties:
+ reg:
+ description: LED pin number
+ maximum: 31
+ minimum: 0
+
+ required:
+ - reg
+
+required:
+ - compatible
+ - reg
+ - "#address-cells"
+ - "#size-cells"
+
+additionalProperties: true
+
+examples:
+ - |
+ #include <dt-bindings/leds/common.h>
+
+ /* The bcm6358 SOC */
+ soc {
+ #address-cells = <1>;
+ #size-cells = <1>;
+
+ led-controller@...e00d0 {
+ compatible = "brcm,bcm6358-leds";
+ #address-cells = <1>;
+ #size-cells = <0>;
+ reg = <0xfffe00d0 0x8>;
+
+ alarm_white@0 {
+ reg = <0>;
+ active-low;
+ label = "white:alarm";
+ };
+ tv_white@2 {
+ reg = <2>;
+ active-low;
+ label = "white:tv";
+ };
+ tel_white@3 {
+ reg = <3>;
+ active-low;
+ label = "white:tel";
+ };
+ adsl_white@4 {
+ reg = <4>;
+ active-low;
+ label = "white:adsl";
+ };
+ };
+ };
+ - |
+ /* The bcm6368 SOC */
+ led-controller@...000d0 {
+ compatible = "brcm,bcm6358-leds";
+ #address-cells = <1>;
+ #size-cells = <0>;
+ reg = <0x100000d0 0x8>;
+
+ brcm,pol-low;
+ brcm,clk-div = <4>;
+
+ power_red@0 {
+ reg = <0>;
+ active-low;
+ label = "red:power";
+ };
+ power_green@1 {
+ reg = <1>;
+ active-low;
+ label = "green:power";
+ default-state = "on";
+ };
+ power_blue@2 {
+ reg = <2>;
+ label = "blue:power";
+ };
+ broadband_red@3 {
+ reg = <3>;
+ active-low;
+ label = "red:broadband";
+ };
+ broadband_green@4 {
+ reg = <4>;
+ label = "green:broadband";
+ };
+ broadband_blue@5 {
+ reg = <5>;
+ active-low;
+ label = "blue:broadband";
+ };
+ wireless_red@6 {
+ reg = <6>;
+ active-low;
+ label = "red:wireless";
+ };
+ wireless_green@7 {
+ reg = <7>;
+ active-low;
+ label = "green:wireless";
+ };
+ wireless_blue@8 {
+ reg = <8>;
+ label = "blue:wireless";
+ };
+ phone_red@9 {
+ reg = <9>;
+ active-low;
+ label = "red:phone";
+ };
+ phone_green@10 {
+ reg = <10>;
+ active-low;
+ label = "green:phone";
+ };
+ phone_blue@11 {
+ reg = <11>;
+ label = "blue:phone";
+ };
+ upgrading_red@12 {
+ reg = <12>;
+ active-low;
+ label = "red:upgrading";
+ };
+ upgrading_green@13 {
+ reg = <13>;
+ active-low;
+ label = "green:upgrading";
+ };
+ upgrading_blue@14 {
+ reg = <14>;
+ label = "blue:upgrading";
+ };
+ };
+...
+
diff --git a/Documentation/devicetree/bindings/leds/leds-bcm6358.txt b/Documentation/devicetree/bindings/leds/leds-bcm6358.txt
deleted file mode 100644
index 211ffc3c4a201235e8d242b0230747b5dfe2a417..0000000000000000000000000000000000000000
--- a/Documentation/devicetree/bindings/leds/leds-bcm6358.txt
+++ /dev/null
@@ -1,143 +0,0 @@
-LEDs connected to Broadcom BCM6358 controller
-
-This controller is present on BCM6358 and BCM6368.
-In these SoCs there are Serial LEDs (LEDs connected to a 74x164 controller),
-which can either be controlled by software (exporting the 74x164 as spi-gpio.
-See Documentation/devicetree/bindings/gpio/fairchild,74hc595.yaml), or
-by hardware using this driver.
-
-Required properties:
- - compatible : should be "brcm,bcm6358-leds".
- - #address-cells : must be 1.
- - #size-cells : must be 0.
- - reg : BCM6358 LED controller address and size.
-
-Optional properties:
- - brcm,clk-div : SCK signal divider. Possible values are 1, 2, 4 and 8.
- Default : 1
- - brcm,clk-dat-low : Boolean, makes clock and data signals active low.
- Default : false
-
-Each LED is represented as a sub-node of the brcm,bcm6358-leds device.
-
-LED sub-node required properties:
- - reg : LED pin number (only LEDs 0 to 31 are valid).
-
-LED sub-node optional properties:
- - label : see Documentation/devicetree/bindings/leds/common.txt
- - default-state : see
- Documentation/devicetree/bindings/leds/common.txt
- - linux,default-trigger : see
- Documentation/devicetree/bindings/leds/common.txt
-
-Examples:
-Scenario 1 : BCM6358
- leds0: led-controller@...e00d0 {
- compatible = "brcm,bcm6358-leds";
- #address-cells = <1>;
- #size-cells = <0>;
- reg = <0xfffe00d0 0x8>;
-
- alarm_white {
- reg = <0>;
- active-low;
- label = "white:alarm";
- };
- tv_white {
- reg = <2>;
- active-low;
- label = "white:tv";
- };
- tel_white {
- reg = <3>;
- active-low;
- label = "white:tel";
- };
- adsl_white {
- reg = <4>;
- active-low;
- label = "white:adsl";
- };
- };
-
-Scenario 2 : BCM6368
- leds0: led-controller@...000d0 {
- compatible = "brcm,bcm6358-leds";
- #address-cells = <1>;
- #size-cells = <0>;
- reg = <0x100000d0 0x8>;
- brcm,pol-low;
- brcm,clk-div = <4>;
-
- power_red {
- reg = <0>;
- active-low;
- label = "red:power";
- };
- power_green {
- reg = <1>;
- active-low;
- label = "green:power";
- default-state = "on";
- };
- power_blue {
- reg = <2>;
- label = "blue:power";
- };
- broadband_red {
- reg = <3>;
- active-low;
- label = "red:broadband";
- };
- broadband_green {
- reg = <4>;
- label = "green:broadband";
- };
- broadband_blue {
- reg = <5>;
- active-low;
- label = "blue:broadband";
- };
- wireless_red {
- reg = <6>;
- active-low;
- label = "red:wireless";
- };
- wireless_green {
- reg = <7>;
- active-low;
- label = "green:wireless";
- };
- wireless_blue {
- reg = <8>;
- label = "blue:wireless";
- };
- phone_red {
- reg = <9>;
- active-low;
- label = "red:phone";
- };
- phone_green {
- reg = <10>;
- active-low;
- label = "green:phone";
- };
- phone_blue {
- reg = <11>;
- label = "blue:phone";
- };
- upgrading_red {
- reg = <12>;
- active-low;
- label = "red:upgrading";
- };
- upgrading_green {
- reg = <13>;
- active-low;
- label = "green:upgrading";
- };
- upgrading_blue {
- reg = <14>;
- label = "blue:upgrading";
- };
- };
---
base-commit: 76eeb9b8de9880ca38696b2fb56ac45ac0a25c6c
change-id: 20250923-brcm6358-to-dt-a69fa1228512
Best regards,
--
Harrison Carter <hcarter@...goodpenguin.co.uk>
Powered by blists - more mailing lists