* [PATCH] dt-bindings: leds: as3645: Convert to DT schema
@ 2025-09-09 8:50 Harrison Carter
2025-09-10 15:05 ` Rob Herring
0 siblings, 1 reply; 3+ messages in thread
From: Harrison Carter @ 2025-09-09 8:50 UTC (permalink / raw)
To: Lee Jones, Pavel Machek, Rob Herring, Krzysztof Kozlowski,
Conor Dooley, Sakari Ailus
Cc: linux-leds, devicetree, linux-kernel, Harrison Carter
Convert the ams,as3645a.txt to DT Schema format.
maintainer: set to what I found in MAINTAINERS
Signed-off-by: Harrison Carter <hcarter@thegoodpenguin.co.uk>
---
.../devicetree/bindings/leds/ams,as3645a.txt | 85 --------------
.../devicetree/bindings/leds/ams,as3645a.yaml | 130 +++++++++++++++++++++
2 files changed, 130 insertions(+), 85 deletions(-)
diff --git a/Documentation/devicetree/bindings/leds/ams,as3645a.txt b/Documentation/devicetree/bindings/leds/ams,as3645a.txt
deleted file mode 100644
index 4af2987b25e92394ebd46456e30002d3ae3a6101..0000000000000000000000000000000000000000
--- a/Documentation/devicetree/bindings/leds/ams,as3645a.txt
+++ /dev/null
@@ -1,85 +0,0 @@
-Analog devices AS3645A device tree bindings
-
-The AS3645A flash LED controller can drive two LEDs, one high current
-flash LED and one indicator LED. The high current flash LED can be
-used in torch mode as well.
-
-Ranges below noted as [a, b] are closed ranges between a and b, i.e. a
-and b are included in the range.
-
-Please also see common.txt in the same directory.
-
-
-Required properties
-===================
-
-compatible : Must be "ams,as3645a".
-reg : The I2C address of the device. Typically 0x30.
-#address-cells : 1
-#size-cells : 0
-
-
-Required properties of the flash child node (0)
-===============================================
-
-reg: 0
-flash-timeout-us: Flash timeout in microseconds. The value must be in
- the range [100000, 850000] and divisible by 50000.
-flash-max-microamp: Maximum flash current in microamperes. Has to be
- in the range between [200000, 500000] and
- divisible by 20000.
-led-max-microamp: Maximum torch (assist) current in microamperes. The
- value must be in the range between [20000, 160000] and
- divisible by 20000.
-ams,input-max-microamp: Maximum flash controller input current. The
- value must be in the range [1250000, 2000000]
- and divisible by 50000.
-
-
-Optional properties of the flash child node
-===========================================
-
-function : See Documentation/devicetree/bindings/leds/common.txt.
-color : See Documentation/devicetree/bindings/leds/common.txt.
-label : See Documentation/devicetree/bindings/leds/common.txt (deprecated).
-
-
-Required properties of the indicator child node (1)
-===================================================
-
-reg: 1
-led-max-microamp: Maximum indicator current. The allowed values are
- 2500, 5000, 7500 and 10000.
-
-Optional properties of the indicator child node
-===============================================
-
-function : See Documentation/devicetree/bindings/leds/common.txt.
-color : See Documentation/devicetree/bindings/leds/common.txt.
-label : See Documentation/devicetree/bindings/leds/common.txt (deprecated).
-
-
-Example
-=======
-
-#include <dt-bindings/leds/common.h>
-
- as3645a@30 {
- #address-cells = <1>;
- #size-cells = <0>;
- reg = <0x30>;
- compatible = "ams,as3645a";
- led@0 {
- reg = <0x0>;
- flash-timeout-us = <150000>;
- flash-max-microamp = <320000>;
- led-max-microamp = <60000>;
- ams,input-max-microamp = <1750000>;
- function = LED_FUNCTION_FLASH;
- };
- led@1 {
- reg = <0x1>;
- led-max-microamp = <10000>;
- function = LED_FUNCTION_INDICATOR;
- };
- };
diff --git a/Documentation/devicetree/bindings/leds/ams,as3645a.yaml b/Documentation/devicetree/bindings/leds/ams,as3645a.yaml
new file mode 100644
index 0000000000000000000000000000000000000000..f956c20cc8fb379f370ad785a3d75f27d0cfa032
--- /dev/null
+++ b/Documentation/devicetree/bindings/leds/ams,as3645a.yaml
@@ -0,0 +1,130 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/leds/ams,as3645a.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Analog Devices AS3645A LED Controller
+
+maintainers:
+ - Sakari Ailus <sakari.ailus@iki.fi>
+
+description: |
+ The AS3645A flash LED controller can drive two LEDs, one high current
+ flash LED and one indicator LED. The high current flash LED can be
+ used in torch mode as well.
+
+properties:
+ compatible:
+ const: ams,as3645a
+
+ "#address-cells":
+ const: 1
+
+ "#size-cells":
+ const: 0
+
+ reg:
+ maxItems: 1
+
+ led@0:
+ type: object
+ $ref: common.yaml#
+ unevaluatedProperties: false
+
+ properties:
+ reg:
+ const: 0
+
+ flash-timeout-us:
+ minimum: 100000
+ maximum: 850000
+ description: |
+ Flash timeout in microseconds. Must be divisible by 50000
+
+ flash-max-microamp:
+ minimum: 200000
+ maximum: 500000
+ description: |
+ Maximum flash current in microamperes. Must be divisible by 20000
+
+ led-max-microamp:
+ minimum: 20000
+ maximum: 160000
+ description: |
+ Maximum torch (assist) current in microamperes Must be divisible by 20000
+
+ ams,input-max-microamp:
+ minimum: 1250000
+ maximum: 2000000
+ description: |
+ Maximum flash controller input current. Must be divisible by 50000
+
+ required:
+ - reg
+ - flash-timeout-us
+ - flash-max-microamp
+ - led-max-microamp
+ - ams,input-max-microamp
+
+ led@1:
+ type: object
+ $ref: common.yaml#
+ unevaluatedProperties: false
+
+ properties:
+ reg:
+ const: 1
+
+ led-max-microamp:
+ enum:
+ - 2500
+ - 5000
+ - 7500
+ - 10000
+ description: |
+ Maximum indicator current. The allowed values are 2500, 5000, 7500 and 10000.
+
+ required:
+ - reg
+ - led-max-microamp
+
+required:
+ - compatible
+ - reg
+ - "#size-cells"
+ - "#address-cells"
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/leds/common.h>
+
+ i2c{
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ as3645a@30 {
+ compatible = "ams,as3645a";
+ #address-cells = <1>;
+ #size-cells = <0>;
+ reg = <0x30>;
+
+ led@0 {
+ reg = <0>;
+ flash-timeout-us = <150000>;
+ flash-max-microamp = <320000>;
+ led-max-microamp = <60000>;
+ ams,input-max-microamp = <1750000>;
+ function = LED_FUNCTION_FLASH;
+ };
+
+ led@1 {
+ reg = <1>;
+ led-max-microamp = <10000>;
+ function = LED_FUNCTION_INDICATOR;
+ };
+ };
+ };
+...
---
base-commit: c17b750b3ad9f45f2b6f7e6f7f4679844244f0b9
change-id: 20250906-ams-txt-to-dt-schema-a821e0e03c46
Best regards,
--
Harrison Carter <hcarter@thegoodpenguin.co.uk>
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH] dt-bindings: leds: as3645: Convert to DT schema
2025-09-09 8:50 [PATCH] dt-bindings: leds: as3645: Convert to DT schema Harrison Carter
@ 2025-09-10 15:05 ` Rob Herring
2025-09-10 17:07 ` Harrison Carter
0 siblings, 1 reply; 3+ messages in thread
From: Rob Herring @ 2025-09-10 15:05 UTC (permalink / raw)
To: Harrison Carter
Cc: Lee Jones, Pavel Machek, Krzysztof Kozlowski, Conor Dooley,
Sakari Ailus, linux-leds, devicetree, linux-kernel
On Tue, Sep 09, 2025 at 09:50:04AM +0100, Harrison Carter wrote:
> Convert the ams,as3645a.txt to DT Schema format.
>
> maintainer: set to what I found in MAINTAINERS
>
> Signed-off-by: Harrison Carter <hcarter@thegoodpenguin.co.uk>
> ---
> .../devicetree/bindings/leds/ams,as3645a.txt | 85 --------------
> .../devicetree/bindings/leds/ams,as3645a.yaml | 130 +++++++++++++++++++++
> 2 files changed, 130 insertions(+), 85 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/leds/ams,as3645a.txt b/Documentation/devicetree/bindings/leds/ams,as3645a.txt
> deleted file mode 100644
> index 4af2987b25e92394ebd46456e30002d3ae3a6101..0000000000000000000000000000000000000000
> --- a/Documentation/devicetree/bindings/leds/ams,as3645a.txt
> +++ /dev/null
> @@ -1,85 +0,0 @@
> -Analog devices AS3645A device tree bindings
> -
> -The AS3645A flash LED controller can drive two LEDs, one high current
> -flash LED and one indicator LED. The high current flash LED can be
> -used in torch mode as well.
> -
> -Ranges below noted as [a, b] are closed ranges between a and b, i.e. a
> -and b are included in the range.
> -
> -Please also see common.txt in the same directory.
> -
> -
> -Required properties
> -===================
> -
> -compatible : Must be "ams,as3645a".
> -reg : The I2C address of the device. Typically 0x30.
> -#address-cells : 1
> -#size-cells : 0
> -
> -
> -Required properties of the flash child node (0)
> -===============================================
> -
> -reg: 0
> -flash-timeout-us: Flash timeout in microseconds. The value must be in
> - the range [100000, 850000] and divisible by 50000.
> -flash-max-microamp: Maximum flash current in microamperes. Has to be
> - in the range between [200000, 500000] and
> - divisible by 20000.
> -led-max-microamp: Maximum torch (assist) current in microamperes. The
> - value must be in the range between [20000, 160000] and
> - divisible by 20000.
> -ams,input-max-microamp: Maximum flash controller input current. The
> - value must be in the range [1250000, 2000000]
> - and divisible by 50000.
> -
> -
> -Optional properties of the flash child node
> -===========================================
> -
> -function : See Documentation/devicetree/bindings/leds/common.txt.
> -color : See Documentation/devicetree/bindings/leds/common.txt.
> -label : See Documentation/devicetree/bindings/leds/common.txt (deprecated).
> -
> -
> -Required properties of the indicator child node (1)
> -===================================================
> -
> -reg: 1
> -led-max-microamp: Maximum indicator current. The allowed values are
> - 2500, 5000, 7500 and 10000.
> -
> -Optional properties of the indicator child node
> -===============================================
> -
> -function : See Documentation/devicetree/bindings/leds/common.txt.
> -color : See Documentation/devicetree/bindings/leds/common.txt.
> -label : See Documentation/devicetree/bindings/leds/common.txt (deprecated).
> -
> -
> -Example
> -=======
> -
> -#include <dt-bindings/leds/common.h>
> -
> - as3645a@30 {
> - #address-cells = <1>;
> - #size-cells = <0>;
> - reg = <0x30>;
> - compatible = "ams,as3645a";
> - led@0 {
> - reg = <0x0>;
> - flash-timeout-us = <150000>;
> - flash-max-microamp = <320000>;
> - led-max-microamp = <60000>;
> - ams,input-max-microamp = <1750000>;
> - function = LED_FUNCTION_FLASH;
> - };
> - led@1 {
> - reg = <0x1>;
> - led-max-microamp = <10000>;
> - function = LED_FUNCTION_INDICATOR;
> - };
> - };
> diff --git a/Documentation/devicetree/bindings/leds/ams,as3645a.yaml b/Documentation/devicetree/bindings/leds/ams,as3645a.yaml
> new file mode 100644
> index 0000000000000000000000000000000000000000..f956c20cc8fb379f370ad785a3d75f27d0cfa032
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/leds/ams,as3645a.yaml
> @@ -0,0 +1,130 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/leds/ams,as3645a.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Analog Devices AS3645A LED Controller
> +
> +maintainers:
> + - Sakari Ailus <sakari.ailus@iki.fi>
> +
> +description: |
Don't need '|'.
> + The AS3645A flash LED controller can drive two LEDs, one high current
> + flash LED and one indicator LED. The high current flash LED can be
> + used in torch mode as well.
> +
> +properties:
> + compatible:
> + const: ams,as3645a
> +
> + "#address-cells":
> + const: 1
> +
> + "#size-cells":
> + const: 0
> +
> + reg:
> + maxItems: 1
> +
> + led@0:
> + type: object
> + $ref: common.yaml#
> + unevaluatedProperties: false
> +
> + properties:
> + reg:
> + const: 0
> +
> + flash-timeout-us:
> + minimum: 100000
> + maximum: 850000
multipleOf: 50000
> + description: |
> + Flash timeout in microseconds. Must be divisible by 50000
Drop description.
> +
> + flash-max-microamp:
> + minimum: 200000
> + maximum: 500000
> + description: |
> + Maximum flash current in microamperes. Must be divisible by 20000
> +
> + led-max-microamp:
> + minimum: 20000
> + maximum: 160000
> + description: |
> + Maximum torch (assist) current in microamperes Must be divisible by 20000
Same on these 2.
> +
> + ams,input-max-microamp:
> + minimum: 1250000
> + maximum: 2000000
> + description: |
Don't need '|'.
> + Maximum flash controller input current. Must be divisible by 50000
> +
> + required:
> + - reg
> + - flash-timeout-us
> + - flash-max-microamp
> + - led-max-microamp
> + - ams,input-max-microamp
> +
> + led@1:
> + type: object
> + $ref: common.yaml#
> + unevaluatedProperties: false
> +
> + properties:
> + reg:
> + const: 1
> +
> + led-max-microamp:
> + enum:
> + - 2500
> + - 5000
> + - 7500
> + - 10000
> + description: |
> + Maximum indicator current. The allowed values are 2500, 5000, 7500 and 10000.
No need to repeat constraints in free-form text. Drop the description
here, but I would add description under the nodes to say they are for
flash and indicator.
> +
> + required:
> + - reg
> + - led-max-microamp
> +
> +required:
> + - compatible
> + - reg
> + - "#size-cells"
> + - "#address-cells"
> +
> +additionalProperties: false
> +
> +examples:
> + - |
> + #include <dt-bindings/leds/common.h>
> +
> + i2c{
> + #address-cells = <1>;
> + #size-cells = <0>;
> +
> + as3645a@30 {
led-controller@30
> + compatible = "ams,as3645a";
> + #address-cells = <1>;
> + #size-cells = <0>;
> + reg = <0x30>;
> +
> + led@0 {
> + reg = <0>;
> + flash-timeout-us = <150000>;
> + flash-max-microamp = <320000>;
> + led-max-microamp = <60000>;
> + ams,input-max-microamp = <1750000>;
> + function = LED_FUNCTION_FLASH;
> + };
> +
> + led@1 {
> + reg = <1>;
> + led-max-microamp = <10000>;
> + function = LED_FUNCTION_INDICATOR;
> + };
> + };
> + };
> +...
>
> ---
> base-commit: c17b750b3ad9f45f2b6f7e6f7f4679844244f0b9
> change-id: 20250906-ams-txt-to-dt-schema-a821e0e03c46
>
> Best regards,
> --
> Harrison Carter <hcarter@thegoodpenguin.co.uk>
>
^ permalink raw reply [flat|nested] 3+ messages in thread
* (no subject)
2025-09-10 15:05 ` Rob Herring
@ 2025-09-10 17:07 ` Harrison Carter
0 siblings, 0 replies; 3+ messages in thread
From: Harrison Carter @ 2025-09-10 17:07 UTC (permalink / raw)
To: robh
Cc: conor+dt, devicetree, hcarter, krzk+dt, lee, linux-kernel,
linux-leds, pavel, sakari.ailus
Subject: Quick clarification
Hi Rob,
Thanks for looking it over. Just to clarify on your
comments:
1. Is this to stop duplicating things that are clearly
described in the variable names?
2. Should I keep the "Must be dvisible by X" parts of the
description?
Cheers,
HarryC
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2025-09-10 17:07 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-09-09 8:50 [PATCH] dt-bindings: leds: as3645: Convert to DT schema Harrison Carter
2025-09-10 15:05 ` Rob Herring
2025-09-10 17:07 ` Harrison Carter
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).