regulator: dt-bindings: Add ADI LT8722 support

Signed-off-by: Ramon Cristopher M. Calam <[email protected]>

Author: rccalam

Documentation/devicetree/bindings/regulator/adi,lt8722-regulator.yaml

@@ -0,0 +1,148 @@
+# 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 <[email protected]>
+
+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,ilimn-microamp:
+    minimum: 637440
+    maximum: 6786000
+    description: |
+      Maximum negative output current limit in microamps.
+      Defaults to 6786000 if not specified.
+
+  adi,ilimp-microamp:
+    minimum: 637440
+    maximum: 6800000
+    description: |
+      Maximum positive output current limit in microamps.
+      Defaults to 6800000 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 = <20000000>;
+        adi,ov-clamp-microvolt = <20000000>;
+        adi,ilimn-microamp = <6786000>;
+        adi,ilimp-microamp = <6800000>;
+        adi,switch-frequency-hz = <500000>;
+        adi,switch-frequency-adjust = <0>;
+        adi,duty-cycle-range = <0>;
+        adi,vcc-vreg-millivolt = <3400>;
+        adi,peak-inductor-current-milliamp = <1620>;
+        adi,power-limit-milliwatt = <0>;
+
+        regulator-min-microvolt = <0>;
+        regulator-max-microvolt = <20000000>;
+        regulator-soft-start;
+      };
+    };