* [PATCH v2 1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format
@ 2026-07-14 16:01 Frank.Li
2026-07-20 21:13 ` Rob Herring (Arm)
2026-07-21 23:16 ` Mark Brown
0 siblings, 2 replies; 3+ messages in thread
From: Frank.Li @ 2026-07-14 16:01 UTC (permalink / raw)
To: Liam Girdwood, Mark Brown, Rob Herring, Krzysztof Kozlowski,
Conor Dooley, Frank Li,
open list:VOLTAGE AND CURRENT REGULATOR FRAMEWORK,
open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS
Cc: imx, Frank Li
From: Frank Li <Frank.Li@nxp.com>
Convert ltc3589.txt to yaml format.
Additional changes:
- Add interrupts to match driver code
- Require lltc,fb-voltage-divider property ^(sw1|sw2|sw3|bb-out|ldo1|ldo2)$
Signed-off-by: Frank Li <Frank.Li@nxp.com>
---
change in v2
- Add interrupts to match driver code (report by sashiko)
- Require lltc,fb-voltage-divider property ^(sw1|sw2|sw3|bb-out|ldo1|ldo2)$
(report by sashiko)
---
.../bindings/regulator/lltc,ltc3589.yaml | 149 ++++++++++++++++++
.../devicetree/bindings/regulator/ltc3589.txt | 99 ------------
2 files changed, 149 insertions(+), 99 deletions(-)
create mode 100644 Documentation/devicetree/bindings/regulator/lltc,ltc3589.yaml
delete mode 100644 Documentation/devicetree/bindings/regulator/ltc3589.txt
diff --git a/Documentation/devicetree/bindings/regulator/lltc,ltc3589.yaml b/Documentation/devicetree/bindings/regulator/lltc,ltc3589.yaml
new file mode 100644
index 0000000000000..2c2755bb84ebd
--- /dev/null
+++ b/Documentation/devicetree/bindings/regulator/lltc,ltc3589.yaml
@@ -0,0 +1,149 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/regulator/lltc,ltc3589.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Linear Technology LTC3589 PMIC
+
+maintainers:
+ - Frank Li <Frank.li@kernel.org>
+
+description:
+ Linear Technology LTC3589, LTC3589-1 and LTC3589-2 are PMICs
+ containing three buck regulators, one boost regulator and four
+ LDO regulators.
+
+properties:
+ compatible:
+ enum:
+ - lltc,ltc3589
+ - lltc,ltc3589-1
+ - lltc,ltc3589-2
+
+ reg:
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ regulators:
+ type: object
+ additionalProperties: false
+
+ patternProperties:
+ "^(sw1|sw2|sw3|bb-out|ldo1|ldo2)$":
+ type: object
+ unevaluatedProperties: false
+ $ref: regulator.yaml#
+
+ properties:
+ lltc,fb-voltage-divider:
+ description:
+ Feedback voltage divider resistor values (R1, R2) in ohms.
+ Regulators sw1, sw2, sw3, and ldo2 can regulate the feedback
+ reference from 0.3625 V to 0.75 V in 12.5 mV steps. The output
+ voltage thus ranges between 0.3625 * (1 + R1/R2) V and
+ 0.75 * (1 + R1/R2) V. Regulators bb-out and ldo1 have a fixed
+ 0.8 V reference and thus output 0.8 * (1 + R1/R2) V. The ldo3
+ regulator is fixed to 1.8 V on LTC3589 and to 2.8 V on
+ LTC3589-1,2. The ldo4 regulator can output between 1.8 V and
+ 3.3 V on LTC3589 and between 1.2 V and 3.2 V on LTC3589-1,2 in
+ four steps. The ldo1 standby regulator can not be disabled and
+ thus should have the regulator-always-on property set.
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+ items:
+ - description: R1 in ohms
+ - description: R2 in ohms.
+
+ required:
+ - lltc,fb-voltage-divider
+
+ "^(ldo3|ldo4)$":
+ type: object
+ unevaluatedProperties: false
+ $ref: regulator.yaml#
+
+required:
+ - compatible
+ - reg
+ - regulators
+
+additionalProperties: false
+
+examples:
+ - |
+ i2c {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ pmic@34 {
+ compatible = "lltc,ltc3589-1";
+ reg = <0x34>;
+
+ regulators {
+ sw1 {
+ regulator-min-microvolt = <591930>;
+ regulator-max-microvolt = <1224671>;
+ lltc,fb-voltage-divider = <100000 158000>;
+ regulator-ramp-delay = <7000>;
+ regulator-boot-on;
+ regulator-always-on;
+ };
+
+ sw2 {
+ regulator-min-microvolt = <704123>;
+ regulator-max-microvolt = <1456803>;
+ lltc,fb-voltage-divider = <180000 191000>;
+ regulator-ramp-delay = <7000>;
+ regulator-boot-on;
+ regulator-always-on;
+ };
+
+ sw3 {
+ regulator-min-microvolt = <1341250>;
+ regulator-max-microvolt = <2775000>;
+ lltc,fb-voltage-divider = <270000 100000>;
+ regulator-ramp-delay = <7000>;
+ regulator-boot-on;
+ regulator-always-on;
+ };
+
+ bb-out {
+ regulator-min-microvolt = <3387341>;
+ regulator-max-microvolt = <3387341>;
+ lltc,fb-voltage-divider = <511000 158000>;
+ regulator-boot-on;
+ regulator-always-on;
+ };
+
+ ldo1 {
+ regulator-min-microvolt = <1306329>;
+ regulator-max-microvolt = <1306329>;
+ lltc,fb-voltage-divider = <100000 158000>;
+ regulator-boot-on;
+ regulator-always-on;
+ };
+
+ ldo2 {
+ regulator-min-microvolt = <704123>;
+ regulator-max-microvolt = <1456806>;
+ lltc,fb-voltage-divider = <180000 191000>;
+ regulator-ramp-delay = <7000>;
+ regulator-boot-on;
+ regulator-always-on;
+ };
+
+ ldo3 {
+ regulator-min-microvolt = <2800000>;
+ regulator-max-microvolt = <2800000>;
+ regulator-boot-on;
+ };
+
+ ldo4 {
+ regulator-min-microvolt = <1200000>;
+ regulator-max-microvolt = <3200000>;
+ };
+ };
+ };
+ };
diff --git a/Documentation/devicetree/bindings/regulator/ltc3589.txt b/Documentation/devicetree/bindings/regulator/ltc3589.txt
deleted file mode 100644
index 8010530361465..0000000000000
--- a/Documentation/devicetree/bindings/regulator/ltc3589.txt
+++ /dev/null
@@ -1,99 +0,0 @@
-Linear Technology LTC3589, LTC3589-1, and LTC3589-2 8-output regulators
-
-Required properties:
-- compatible: "lltc,ltc3589", "lltc,ltc3589-1" or "lltc,ltc3589-2"
-- reg: I2C slave address
-
-Required child node:
-- regulators: Contains eight regulator child nodes sw1, sw2, sw3, bb-out,
- ldo1, ldo2, ldo3, and ldo4, specifying the initialization data as
- documented in Documentation/devicetree/bindings/regulator/regulator.txt.
-
-Each regulator is defined using the standard binding for regulators. The
-nodes for sw1, sw2, sw3, bb-out, ldo1, and ldo2 additionally need to specify
-the resistor values of their external feedback voltage dividers:
-
-Required properties (not on ldo3, ldo4):
-- lltc,fb-voltage-divider: An array of two integers containing the resistor
- values R1 and R2 of the feedback voltage divider in ohms.
-
-Regulators sw1, sw2, sw3, and ldo2 can regulate the feedback reference from
-0.3625 V to 0.75 V in 12.5 mV steps. The output voltage thus ranges between
-0.3625 * (1 + R1/R2) V and 0.75 * (1 + R1/R2) V. Regulators bb-out and ldo1
-have a fixed 0.8 V reference and thus output 0.8 * (1 + R1/R2) V. The ldo3
-regulator is fixed to 1.8 V on LTC3589 and to 2.8 V on LTC3589-1,2. The ldo4
-regulator can output between 1.8 V and 3.3 V on LTC3589 and between 1.2 V
-and 3.2 V on LTC3589-1,2 in four steps. The ldo1 standby regulator can not
-be disabled and thus should have the regulator-always-on property set.
-
-Example:
-
- ltc3589: pmic@34 {
- compatible = "lltc,ltc3589-1";
- reg = <0x34>;
-
- regulators {
- sw1_reg: sw1 {
- regulator-min-microvolt = <591930>;
- regulator-max-microvolt = <1224671>;
- lltc,fb-voltage-divider = <100000 158000>;
- regulator-ramp-delay = <7000>;
- regulator-boot-on;
- regulator-always-on;
- };
-
- sw2_reg: sw2 {
- regulator-min-microvolt = <704123>;
- regulator-max-microvolt = <1456803>;
- lltc,fb-voltage-divider = <180000 191000>;
- regulator-ramp-delay = <7000>;
- regulator-boot-on;
- regulator-always-on;
- };
-
- sw3_reg: sw3 {
- regulator-min-microvolt = <1341250>;
- regulator-max-microvolt = <2775000>;
- lltc,fb-voltage-divider = <270000 100000>;
- regulator-ramp-delay = <7000>;
- regulator-boot-on;
- regulator-always-on;
- };
-
- bb_out_reg: bb-out {
- regulator-min-microvolt = <3387341>;
- regulator-max-microvolt = <3387341>;
- lltc,fb-voltage-divider = <511000 158000>;
- regulator-boot-on;
- regulator-always-on;
- };
-
- ldo1_reg: ldo1 {
- regulator-min-microvolt = <1306329>;
- regulator-max-microvolt = <1306329>;
- lltc,fb-voltage-divider = <100000 158000>;
- regulator-boot-on;
- regulator-always-on;
- };
-
- ldo2_reg: ldo2 {
- regulator-min-microvolt = <704123>;
- regulator-max-microvolt = <1456806>;
- lltc,fb-voltage-divider = <180000 191000>;
- regulator-ramp-delay = <7000>;
- regulator-boot-on;
- regulator-always-on;
- };
-
- ldo3_reg: ldo3 {
- regulator-min-microvolt = <2800000>;
- regulator-max-microvolt = <2800000>;
- regulator-boot-on;
- };
-
- ldo4_reg: ldo4 {
- regulator-min-microvolt = <1200000>;
- regulator-max-microvolt = <3200000>;
- };
- };
- };
--
2.43.0
^ permalink raw reply [flat|nested] 3+ messages in thread* Re: [PATCH v2 1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format
2026-07-14 16:01 [PATCH v2 1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format Frank.Li
@ 2026-07-20 21:13 ` Rob Herring (Arm)
2026-07-21 23:16 ` Mark Brown
1 sibling, 0 replies; 3+ messages in thread
From: Rob Herring (Arm) @ 2026-07-20 21:13 UTC (permalink / raw)
To: Frank.Li
Cc: Krzysztof Kozlowski, devicetree, Conor Dooley, imx, Mark Brown,
Frank Li, Frank Li, Liam Girdwood, linux-kernel
On Tue, 14 Jul 2026 12:01:45 -0400, Frank.Li@oss.nxp.com wrote:
> From: Frank Li <Frank.Li@nxp.com>
>
> Convert ltc3589.txt to yaml format.
>
> Additional changes:
> - Add interrupts to match driver code
> - Require lltc,fb-voltage-divider property ^(sw1|sw2|sw3|bb-out|ldo1|ldo2)$
>
> Signed-off-by: Frank Li <Frank.Li@nxp.com>
> ---
> change in v2
> - Add interrupts to match driver code (report by sashiko)
> - Require lltc,fb-voltage-divider property ^(sw1|sw2|sw3|bb-out|ldo1|ldo2)$
> (report by sashiko)
> ---
> .../bindings/regulator/lltc,ltc3589.yaml | 149 ++++++++++++++++++
> .../devicetree/bindings/regulator/ltc3589.txt | 99 ------------
> 2 files changed, 149 insertions(+), 99 deletions(-)
> create mode 100644 Documentation/devicetree/bindings/regulator/lltc,ltc3589.yaml
> delete mode 100644 Documentation/devicetree/bindings/regulator/ltc3589.txt
>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
^ permalink raw reply [flat|nested] 3+ messages in thread
* Re: [PATCH v2 1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format
2026-07-14 16:01 [PATCH v2 1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format Frank.Li
2026-07-20 21:13 ` Rob Herring (Arm)
@ 2026-07-21 23:16 ` Mark Brown
1 sibling, 0 replies; 3+ messages in thread
From: Mark Brown @ 2026-07-21 23:16 UTC (permalink / raw)
To: Liam Girdwood, Rob Herring, Krzysztof Kozlowski, Conor Dooley,
Frank Li, linux-kernel, devicetree, Frank.Li
Cc: imx, Frank Li
On Tue, 14 Jul 2026 12:01:45 -0400, Frank.Li@oss.nxp.com wrote:
> regulator: dt-bindings: Convert ltc3589.txt to yaml format
Applied to
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/regulator.git for-7.3
Thanks!
[1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format
https://git.kernel.org/broonie/regulator/c/64f3d6f26652
All being well this means that it will be integrated into the linux-next
tree (usually sometime in the next 24 hours) and sent to Linus during
the next merge window (or sooner if it is a bug fix), however if
problems are discovered then the patch may be dropped or reverted.
You may get further e-mails resulting from automated or manual testing
and review of the tree, please engage with people reporting problems and
send followup patches addressing any issues that are reported if needed.
If any updates are required or you are submitting further changes they
should be sent as incremental updates against current git, existing
patches will not be replaced.
Please add any relevant lists and maintainers to the CCs when replying
to this mail.
Thanks,
Mark
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2026-07-22 13:33 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2026-07-14 16:01 [PATCH v2 1/1] regulator: dt-bindings: Convert ltc3589.txt to yaml format Frank.Li
2026-07-20 21:13 ` Rob Herring (Arm)
2026-07-21 23:16 ` Mark Brown
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®