Received-SPF: pass (google.com: domain of linux-kernel+bounces-160461-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99;
From: Nathan Morrisson <nmorrisson@phytec.com>
To: lee@kernel.org,
	robh@kernel.org,
	krzk+dt@kernel.org,
	conor+dt@kernel.org,
	nm@ti.com,
	vigneshr@ti.com,
	kristo@kernel.org,
	j-keerthy@ti.com
Cc: devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org,
	upstream@lists.phytec.de,
	w.egorov@phytec.de
Subject: [PATCH 1/2] dt-bindings: Convert lp873x.txt to json-schema
Date: Fri, 26 Apr 2024 10:21:54 -0700
Message-Id: <20240426172155.10860-1-nmorrisson@phytec.com>
Content-Transfer-Encoding: 8bit
Content-Type: text/plain
Precedence: bulk
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0:
	=?us-ascii?Q?IfbxfZOZYqfCzwXWgSytx6e8v5irJzL1ulYcyyMhD2wLygIbtPgUkkj6hs2q?=
 =?us-ascii?Q?7YL8QwYmTzv93mES+NHqy0rWCAuLZNx32g5Sdgw9L+PC3+EE8X+2uLsfr05Z?=
 =?us-ascii?Q?a+qtntgP7Cqse0w+riP/onS0iKje0s0KscgP/cDzTim4Z5/eTQYoPsBp4fKi?=
 =?us-ascii?Q?d8Mg2MHGwuLp/xVYG8j1j047T0wjAdQFzbqLfk9nBMW1Huoh8U3przGUYnqs?=
 =?us-ascii?Q?5R8cwV25ix5BLCOWVL119rWHr1S8OXwDzU5B3ia4B6VYYW1F8vqVezWqL1ag?=
 =?us-ascii?Q?S9N8XtBgXt9ct7XoAN7MQ+M0Nwwd3BkKGmYRfK/DxYDnUGsrWuFcjlSCpjh7?=
 =?us-ascii?Q?9dQBvfj2mAYGuqWuMlCxiiLXLyL1SIbgFz4T19v93FbEanqDaRR4bYRqqQG1?=
 =?us-ascii?Q?4ZfsCfEKTwE9MyjsHh3ed0xThlk76cMA0uh542QCDyATuS5HRCCWane+yFdv?=
 =?us-ascii?Q?bb6q3CmuSGFbVDLb4kLAdDxiCICRVADlKxcDtXX29LFcahlqYMpmFmnhVAZ0?=
 =?us-ascii?Q?gAiN83fB8r+q6xFtdgIzj0ZiTo2H5bJChgLxS9BQw8dfKDvfl+XFbO0pMR33?=
 =?us-ascii?Q?pH53IFWRB8vfXleUe90AcqWmsi5fINaAFexqVngvb6X60QljaC9BwFSG7sJ/?=
 =?us-ascii?Q?Y2OfbTbkNbqzP2bhIqfXc5ZwZS1uYa0A3AVgoVECBQn/qYbrmIPEfGXieK9d?=
 =?us-ascii?Q?A52fv0javkGdZC6epJhZ4iWtrOiaZcU/321AaZY/pOK7SVAyLSOiN7HYWgha?=
 =?us-ascii?Q?tXxyTL4psUA4+wvBey23bGG4fewgYJBIlmVUlYL6XHVyH572aGpzzpvLe1gx?=
 =?us-ascii?Q?BVOMkl/Om5lsWl0LeUOE0T4+7a6tk/t7JuJvpxZMaw86Z1KNWQvuG8Q3i0n2?=
 =?us-ascii?Q?Ve7Yr099i2GH4ckKLnyzW88DhMziia1UKrHuuiz9LGFxzqNXY2pq4uGNXnaz?=
 =?us-ascii?Q?lEVchksWBg46ZKiYlqEU8Qmi9RsizEQYeqThe2Xvz6fHNyTW/PiplDItlzq+?=
 =?us-ascii?Q?UJ2wTgCa8zflCPqanv1qP4N0ZQo4YSpaTOFmSX3Egpj0jfgKGh2/E/rVJGiC?=
 =?us-ascii?Q?J5i6PuInM/2ylApWmaGd/1JS46cP0/OzwUjn/KpjRMibFSkYHnqJhrMdZiXq?=
 =?us-ascii?Q?wIARmP5vVuicEdkHKSvFUtMsw7omITE2w88/2LIxidEugL3Cy3G7K1Sybr3b?=
 =?us-ascii?Q?TLPRYbpNMsHord+hCmIKEwjTg3DcWU+XQg0ac+4GSccMuqaCFriVGFmNR1uC?=
 =?us-ascii?Q?HPORPVUVtKGB/3UqUCmPZ3XJkvli+Z4M2lk7UExBkObWoTZscwYaJg/aAMsS?=
 =?us-ascii?Q?aaIfaQagTEOS60JjsBx/OfgU7hoJfofnZjOZseIbPZMBz8dmOCP9tI7KxSzD?=
 =?us-ascii?Q?ACXT1aQS0OadiMHol7tCoBzuPTG9jYVG0n/aliuSwoL/zxwPLPLEEPkaBrKu?=
 =?us-ascii?Q?HsDnpa4eAeivfGAhYW1LbQV0f/88gXlNmscj/JaG0NZIdLD8650lxgb4K2pG?=
 =?us-ascii?Q?aeOo51DkCifV/kxiko+QIs2/t6v73bZnCOEvFeMTGQALxMt+9nmoGGkSCi9J?=
 =?us-ascii?Q?gwnkYSEwlFV3d2sDKHiJsPOg3oTzTNGGcTEa7uWl?=
X-OriginatorOrg: phytec.com
X-MS-Exchange-CrossTenant-Network-Message-Id: af5e4389-849a-4998-26b9-08dc6615653e
X-MS-Exchange-CrossTenant-AuthSource: SA1PR22MB5636.namprd22.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 26 Apr 2024 17:22:06.0417
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 67bcab1a-5db0-4ee8-86f4-1533d0b4b5c7
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: oQ5xxyuG8g3P4CbAfNU0yBUOFjxZJBcdJna9/l2pV1KOPmstkfXdQCR8g+UjzJFMITtqsadiu4NXEHArkT5EuA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN7PR22MB3786

Convert the lp873x binding to DT schema format. Converted with
minimal corrections.

Signed-off-by: Nathan Morrisson <nmorrisson@phytec.com>
---
 .../devicetree/bindings/mfd/lp873x.txt        |  67 ----------
 .../devicetree/bindings/mfd/lp873x.yaml       | 114 ++++++++++++++++++
 2 files changed, 114 insertions(+), 67 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/mfd/lp873x.txt
 create mode 100644 Documentation/devicetree/bindings/mfd/lp873x.yaml

diff --git a/Documentation/devicetree/bindings/mfd/lp873x.txt b/Documentation/devicetree/bindings/mfd/lp873x.txt
deleted file mode 100644
index ae9cf39bd101..000000000000
--- a/Documentation/devicetree/bindings/mfd/lp873x.txt
+++ /dev/null
@@ -1,67 +0,0 @@
-TI LP873X PMIC MFD driver
-
-Required properties:
-  - compatible:	"ti,lp8732", "ti,lp8733"
-  - reg:		I2C slave address.
-  - gpio-controller:	Marks the device node as a GPIO Controller.
-  - #gpio-cells:	Should be two.  The first cell is the pin number and
-			the second cell is used to specify flags.
-			See ../gpio/gpio.txt for more information.
-  - xxx-in-supply:	Phandle to parent supply node of each regulator
-			populated under regulators node. xxx can be
-			buck0, buck1, ldo0 or ldo1.
-  - regulators:	List of child nodes that specify the regulator
-			initialization data.
-Example:
-
-pmic: lp8733@60 {
-	compatible = "ti,lp8733";
-	reg = <0x60>;
-	gpio-controller;
-	#gpio-cells = <2>;
-
-	buck0-in-supply = <&vsys_3v3>;
-	buck1-in-supply = <&vsys_3v3>;
-	ldo0-in-supply = <&vsys_3v3>;
-	ldo1-in-supply = <&vsys_3v3>;
-
-	regulators {
-		lp8733_buck0: buck0 {
-			regulator-name = "lp8733-buck0";
-			regulator-min-microvolt = <800000>;
-			regulator-max-microvolt = <1400000>;
-			regulator-min-microamp = <1500000>;
-			regulator-max-microamp = <4000000>;
-			regulator-ramp-delay = <10000>;
-			regulator-always-on;
-			regulator-boot-on;
-		};
-
-		lp8733_buck1: buck1 {
-			regulator-name = "lp8733-buck1";
-			regulator-min-microvolt = <800000>;
-			regulator-max-microvolt = <1400000>;
-			regulator-min-microamp = <1500000>;
-			regulator-max-microamp = <4000000>;
-			regulator-ramp-delay = <10000>;
-			regulator-boot-on;
-			regulator-always-on;
-		};
-
-		lp8733_ldo0: ldo0 {
-			regulator-name = "lp8733-ldo0";
-			regulator-min-microvolt = <800000>;
-			regulator-max-microvolt = <3000000>;
-			regulator-boot-on;
-			regulator-always-on;
-		};
-
-		lp8733_ldo1: ldo1 {
-			regulator-name = "lp8733-ldo1";
-			regulator-min-microvolt = <800000>;
-			regulator-max-microvolt = <3000000>;
-			regulator-always-on;
-			regulator-boot-on;
-		};
-	};
-};
diff --git a/Documentation/devicetree/bindings/mfd/lp873x.yaml b/Documentation/devicetree/bindings/mfd/lp873x.yaml
new file mode 100644
index 000000000000..87fefdc3126b
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/lp873x.yaml
@@ -0,0 +1,114 @@
+# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mfd/lp873x.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: TI LP873X PMIC MFD drivers
+
+maintainers:
+  - J Keerthy <j-keerthy@ti.com>
+
+description: |
+  PMIC with two high-current buck converters and two linear regulators.
+
+properties:
+  compatible:
+    enum:
+      - ti,lp8732
+      - ti,lp8733
+
+  reg:
+    maxItems: 1
+
+  gpio-controller: true
+
+  '#gpio-cells':
+    const: 2
+
+  regulators:
+    description:
+      List of child nodes that specify the regulator initialization data.
+    type: object
+    patternProperties:
+      "^buck[01]|ldo[01]$":
+        type: object
+        $ref: /schemas/regulator/regulator.yaml#
+        unevaluatedProperties: false
+    additionalProperties: false
+
+patternProperties:
+  '^(buck[01]|ldo[01])-in-supply$':
+    description: Phandle to parent supply of each regulator populated under regulators node.
+
+required:
+  - compatible
+  - reg
+  - regulators
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        i2c@0 {
+            #address-cells = <1>;
+            #size-cells = <0>;
+            reg = <0>;
+
+            pmic: lp8733@60 {
+                compatible = "ti,lp8733";
+                reg = <0x60>;
+                gpio-controller;
+                #gpio-cells = <2>;
+
+                buck0-in-supply = <&vsys_3v3>;
+                buck1-in-supply = <&vsys_3v3>;
+                ldo0-in-supply = <&vsys_3v3>;
+                ldo1-in-supply = <&vsys_3v3>;
+
+                regulators {
+                    lp8733_buck0: buck0 {
+                        regulator-name = "lp8733-buck0";
+                        regulator-min-microvolt = <800000>;
+                        regulator-max-microvolt = <1400000>;
+                        regulator-min-microamp = <1500000>;
+                        regulator-max-microamp = <4000000>;
+                        regulator-ramp-delay = <10000>;
+                        regulator-always-on;
+                        regulator-boot-on;
+                    };
+
+                    lp8733_buck1: buck1 {
+                        regulator-name = "lp8733-buck1";
+                        regulator-min-microvolt = <800000>;
+                        regulator-max-microvolt = <1400000>;
+                        regulator-min-microamp = <1500000>;
+                        regulator-max-microamp = <4000000>;
+                        regulator-ramp-delay = <10000>;
+                        regulator-boot-on;
+                        regulator-always-on;
+                    };
+
+                    lp8733_ldo0: ldo0 {
+                        regulator-name = "lp8733-ldo0";
+                        regulator-min-microvolt = <800000>;
+                        regulator-max-microvolt = <3000000>;
+                        regulator-boot-on;
+                        regulator-always-on;
+                    };
+
+                    lp8733_ldo1: ldo1 {
+                        regulator-name = "lp8733-ldo1";
+                        regulator-min-microvolt = <800000>;
+                        regulator-max-microvolt = <3000000>;
+                        regulator-always-on;
+                        regulator-boot-on;
+                    };
+                };
+            };
+        };
+    };
-- 
2.25.1