[PATCH 1/2] dt-bindings: regulator: mps,mp8899: Add binding for MP8899 PMIC

[Vignesh Viswanathan]

Add devicetree binding documentation for the Monolithic Power Systems
MP8899 PMIC, which provides four synchronous buck converters controlled
over I2C.

Signed-off-by: Vignesh Viswanathan <vignesh.viswanathan@xxxxxxxxxxxxxxxx>
---
 .../devicetree/bindings/regulator/mps,mp8899.yaml  | 66 ++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/Documentation/devicetree/bindings/regulator/mps,mp8899.yaml b/Documentation/devicetree/bindings/regulator/mps,mp8899.yaml
new file mode 100644
index 000000000000..3225c92db2c8
--- /dev/null
+++ b/Documentation/devicetree/bindings/regulator/mps,mp8899.yaml
@@ -0,0 +1,66 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/regulator/mps,mp8899.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Monolithic Power System MP8899 PMIC
+
+maintainers:
+  - Vignesh Viswanathan <vignesh.viswanathan@xxxxxxxxxxxxxxxx>
+
+properties:
+  $nodename:
+    pattern: "^pmic@[0-9a-f]{1,2}$"
+  compatible:
+    enum:
+      - mps,mp8899
+
+  reg:
+    maxItems: 1
+
+  regulators:
+    type: object
+
+    description: |
+      list of regulators provided by this controller, must be named
+      after their hardware counterparts BUCK[1-4]
+
+    patternProperties:
+      "^buck[1-4]$":
+        type: object
+        $ref: regulator.yaml#
+
+        unevaluatedProperties: false
+
+    additionalProperties: false
+
+required:
+  - compatible
+  - reg
+  - regulators
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        pmic@68 {
+            compatible = "mps,mp8899";
+            reg = <0x68>;
+
+            regulators {
+                buck1 {
+                    regulator-name = "buck1";
+                    regulator-min-microvolt = <550000>;
+                    regulator-max-microvolt = <960000>;
+                    regulator-always-on;
+                    regulator-boot-on;
+                };
+            };
+        };
+    };
+...

-- 
2.43.0