From 792b1588959f2d1f520328569be8efc274a17ce5 Mon Sep 17 00:00:00 2001
From: "Ramon Cristopher M. Calam" <ramoncristopher.calam@analog.com>
Date: Tue, 29 Oct 2024 10:10:49 +0800
Subject: [PATCH] regulator: dt-bindings: Add ADI LT8722 support

Signed-off-by: Ramon Cristopher M. Calam <ramoncristopher.calam@analog.com>
---
 .../regulator/adi,lt8722-regulator.yaml       | 134 ++++++++++++++++++
 1 file changed, 134 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/regulator/adi,lt8722-regulator.yaml

diff --git a/Documentation/devicetree/bindings/regulator/adi,lt8722-regulator.yaml b/Documentation/devicetree/bindings/regulator/adi,lt8722-regulator.yaml
new file mode 100644
index 00000000000000..88671f5c3e488d
--- /dev/null
+++ b/Documentation/devicetree/bindings/regulator/adi,lt8722-regulator.yaml
@@ -0,0 +1,134 @@
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+# Copyright (c) 2023 Analog Devices, Inc.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/regulator/adi,lt8722-regulator.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Analog Devices LT8722 Ultracompact Full Bridge Driver
+
+maintainers:
+  -  Ramon Cristopher Calam <ramoncristopher.calam@analog.com>
+
+description: |
+  The Analog Devices LT8722 is a high performance, high efficiency, 15V input,
+  4A monolithic full bridge DC/DC converter. This converter has 92.5% efficiency
+  with high power output of 54W for fine control TEC driving applications.
+
+allOf:
+  - $ref: regulator.yaml#
+
+properties:
+  compatible:
+    enum:
+      - adi,lt8722
+
+  reg:
+    maxItems: 1
+
+  en-gpios:
+    maxItems: 1
+    description: Active high enable GPIO pin for the regulator.
+
+  swen-gpios:
+    maxItems: 1
+    description: Active high switch enable GPIO pin for the regulator.
+
+  spi-max-frequency:
+    maximum: 10000000
+
+  spi-bits-per-word:
+    const: 8
+
+  adi,uv-clamp-microvolt:
+    minimum: 1250000
+    maximum: 20000000
+    description: |
+      Maximum negative output voltage clamp in microvolts.
+      Defaults to 20000000 if not specified.
+
+  adi,ov-clamp-microvolt:
+    minimum: 1250000
+    maximum: 20000000
+    description: |
+      Maximum positive output voltage clamp in microvolts.
+      Defaults to 20000000 if not specified.
+
+  adi,switch-frequency-hz:
+    enum: [500000, 1000000, 1500000, 2000000, 2500000, 3000000]
+    description: |
+      PWM switch frequency.
+      Defaults to 500000 if not specified.
+
+  adi,switch-frequency-adjust:
+    enum: [0, 1, 2]
+    description: |
+      PWM switch frequency adjustment, values map to:
+        -  0: 0%
+	-  1: 15%
+	-  2: -15%
+      Defaults to 0% if not specified.
+
+  adi,duty-cycle-range:
+    enum: [0, 1, 2]
+    description: |
+      PWM duty cycle, values map to:
+	-  0: 20% to 80%
+	-  1: 15% to 85%
+	-  2: 10% to 90%
+      Defaults to 20% to 80% if not specified.
+
+  adi,vcc-vreg-millivolt:
+    enum: [3100, 3400]
+    description: |
+      VCC LCO regulation voltage in millivolts.
+      Defaults to 3400 if not specified.
+
+  adi,peak-inductor-current-milliamp:
+    enum: [252, 594, 936, 1278, 1620, 1962, 2304, 2646]
+    description: |
+      Typical peak inductor current in milliamps.
+      Defaults to 1620 if not specified.
+
+  adi,power-limit-milliwatt:
+    enum: [0, 2000, 3000, 3500]
+    description: |
+      Linear power stage MOSFET power limit in milliwatts.
+      Defaults to 0 (No Limit) if not specified.
+  
+  required:
+    - compatible
+    - reg
+    - en-gpios
+    - swen-gpios
+
+examples:
+  - |
+    spi {
+      #address-cells = <1>;
+      #size-cells = <0>;
+
+      regulator@0 {
+        compatible = "adi,lt8722";
+        reg = <0>;
+	en-gpios = <&gpio 23 GPIO_ACTIVE_HIGH>;
+	swen-gpios = <&gpio 24 GPIO_ACTIVE_HIGH>;
+	spi-max-frequency = <10000000>;
+	spi-bits-per-word = <8>;
+
+	adi,uv-clamp-microvolt = <5000000>;
+	adi,ov-clamp-microvolt = <5000000>;
+	adi,switch-frequency-hz = <2000000>;
+	adi,switch-frequency-adjust = <2>;
+	adi,duty-cycle-range = <1>;
+	adi,vcc-vreg-millivolt = <3400>;
+	adi,peak-inductor-current-milliamp = <1620>;
+	adi,power-limit-milliwatt = <3500>;
+
+	regulator-min-microvolt = <0>;
+	regulator-max-microvolt = <20000000>;
+	regualtor-min-microamp = <0>;
+	regulator-max-microamp = <6800000>;
+	regulator-soft-start;
+      };
+    };