public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Thierry Reding <thierry.reding@gmail.com>
To: Lee Jones <lee.jones@linaro.org>, Rob Herring <robh+dt@kernel.org>
Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org
Subject: [PATCH 5/6] dt-bindings: regulator: tps6586x: Convert to json-schema
Date: Fri, 17 Dec 2021 18:05:06 +0100	[thread overview]
Message-ID: <20211217170507.2843568-5-thierry.reding@gmail.com> (raw)
In-Reply-To: <20211217170507.2843568-1-thierry.reding@gmail.com>

From: Thierry Reding <treding@nvidia.com>

Convert the Texas Instruments TPS6586x bindings from the free-form text
format to json-schema.

Signed-off-by: Thierry Reding <treding@nvidia.com>
---
 .../bindings/regulator/ti,tps6586x.yaml       | 184 ++++++++++++++++++
 .../bindings/regulator/tps6586x.txt           | 135 -------------
 2 files changed, 184 insertions(+), 135 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/regulator/ti,tps6586x.yaml
 delete mode 100644 Documentation/devicetree/bindings/regulator/tps6586x.txt

diff --git a/Documentation/devicetree/bindings/regulator/ti,tps6586x.yaml b/Documentation/devicetree/bindings/regulator/ti,tps6586x.yaml
new file mode 100644
index 000000000000..c5ea7012c653
--- /dev/null
+++ b/Documentation/devicetree/bindings/regulator/ti,tps6586x.yaml
@@ -0,0 +1,184 @@
+# SPDX-License-Identifier: GPL-2.0-only
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/regulator/ti,tps6586x.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments TPS6586x family of voltage regulator
+
+maintainers:
+  - Mark Brown <broonie@kernel.org>
+
+properties:
+  compatible:
+    const: ti,tps6586x
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  sys-supply:
+    description: input supply for SYS
+
+  vin-sm0-supply:
+    description: input supply for SM0
+
+  vin-sm1-supply:
+    description: input supply for SM1
+
+  vin-sm2-supply:
+    description: input supply for SM2
+
+  vinldo01-supply:
+    description: input supply for LDO0 and LDO1
+
+  vinldo23-supply:
+    description: input supply for LDO2 and LDO3
+
+  vinldo4-supply:
+    description: input supply for LDO4
+
+  vinldo678-supply:
+    description: input supply for LDO6, LDO7 and LDO8
+
+  vinldo9-supply:
+    description: input supply for LDO9
+
+  ti,system-power-controller:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description: If this property exists, it specifies that this PMIC controls the system power.
+
+  regulators:
+    type: object
+    description: |
+      A node that houses a sub-node for each regulator within the device. Each sub-node is
+      identified using the node's name (or the deprecated regulator-compatible property if
+      present), with valid values listed below. The content of each sub-node is defined by the
+      standard binding for regulators; see regulator.yaml.
+
+      Note: LDO5 and LDO_RTC is supplied by SYS regulator internally and the operating system
+        needs to take care of establishing the proper parent child relationships.
+
+    patternProperties:
+      "^sys|sm[0-2]|ldo[0-9]|ldo_rtc$":
+        $ref: regulator.yaml
+
+allOf:
+  - $ref: /schemas/gpio/gpio.yaml
+
+unevaluatedProperties: false
+
+required:
+  - compatible
+  - reg
+  - interrupts
+
+examples:
+  - |
+    i2c {
+      #address-cells = <1>;
+      #size-cells = <0>;
+
+      pmic@34 {
+        compatible = "ti,tps6586x";
+        reg = <0x34>;
+        interrupts = <0 88 0x4>;
+
+        #gpio-cells = <2>;
+        gpio-controller;
+
+        ti,system-power-controller;
+
+        sys-supply = <&dummy>;
+        vin-sm0-supply = <&dummy>;
+        vin-sm1-supply = <&dummy>;
+        vin-sm2-supply = <&dummy>;
+        vinldo01-supply = <&dummy>;
+        vinldo23-supply = <&dummy>;
+        vinldo4-supply = <&dummy>;
+        vinldo678-supply = <&dummy>;
+        vinldo9-supply = <&dummy>;
+
+        regulators {
+          sys {
+            regulator-name = "vdd_sys";
+            regulator-boot-on;
+            regulator-always-on;
+          };
+
+          sm0 {
+            regulator-min-microvolt = < 725000>;
+            regulator-max-microvolt = <1500000>;
+            regulator-boot-on;
+            regulator-always-on;
+          };
+
+          sm1 {
+            regulator-min-microvolt = < 725000>;
+            regulator-max-microvolt = <1500000>;
+            regulator-boot-on;
+            regulator-always-on;
+          };
+
+          sm2 {
+            regulator-min-microvolt = <3000000>;
+            regulator-max-microvolt = <4550000>;
+            regulator-boot-on;
+            regulator-always-on;
+          };
+
+          ldo0 {
+            regulator-name = "PCIE CLK";
+            regulator-min-microvolt = <3300000>;
+            regulator-max-microvolt = <3300000>;
+          };
+
+          ldo1 {
+            regulator-min-microvolt = < 725000>;
+            regulator-max-microvolt = <1500000>;
+          };
+
+          ldo2 {
+            regulator-min-microvolt = < 725000>;
+            regulator-max-microvolt = <1500000>;
+          };
+
+          ldo3 {
+            regulator-min-microvolt = <1250000>;
+            regulator-max-microvolt = <3300000>;
+          };
+
+          ldo4 {
+            regulator-min-microvolt = <1700000>;
+            regulator-max-microvolt = <2475000>;
+          };
+
+          ldo5 {
+            regulator-min-microvolt = <1250000>;
+            regulator-max-microvolt = <3300000>;
+          };
+
+          ldo6 {
+            regulator-min-microvolt = <1250000>;
+            regulator-max-microvolt = <3300000>;
+          };
+
+          ldo7 {
+            regulator-min-microvolt = <1250000>;
+            regulator-max-microvolt = <3300000>;
+          };
+
+          ldo8 {
+            regulator-min-microvolt = <1250000>;
+            regulator-max-microvolt = <3300000>;
+          };
+
+          ldo9 {
+            regulator-min-microvolt = <1250000>;
+            regulator-max-microvolt = <3300000>;
+          };
+        };
+      };
+    };
diff --git a/Documentation/devicetree/bindings/regulator/tps6586x.txt b/Documentation/devicetree/bindings/regulator/tps6586x.txt
deleted file mode 100644
index 8b40cac24d93..000000000000
--- a/Documentation/devicetree/bindings/regulator/tps6586x.txt
+++ /dev/null
@@ -1,135 +0,0 @@
-TPS6586x family of regulators
-
-Required properties:
-- compatible: "ti,tps6586x"
-- reg: I2C slave address
-- interrupts: the interrupt outputs of the controller
-- #gpio-cells: number of cells to describe a GPIO
-- gpio-controller: mark the device as a GPIO controller
-- regulators: A node that houses a sub-node for each regulator within the
-  device. Each sub-node is identified using the node's name (or the deprecated
-  regulator-compatible property if present), with valid values listed below.
-  The content of each sub-node is defined by the standard binding for
-  regulators; see regulator.txt.
-  sys, sm[0-2], ldo[0-9] and ldo_rtc
-- sys-supply: The input supply for SYS.
-- vin-sm0-supply: The input supply for the SM0.
-- vin-sm1-supply: The input supply for the SM1.
-- vin-sm2-supply: The input supply for the SM2.
-- vinldo01-supply: The input supply for the LDO1 and LDO2
-- vinldo23-supply: The input supply for the LDO2 and LDO3
-- vinldo4-supply: The input supply for the LDO4
-- vinldo678-supply: The input supply for the LDO6, LDO7 and LDO8
-- vinldo9-supply: The input supply for the LDO9
-
-Optional properties:
-- ti,system-power-controller: Telling whether or not this pmic is controlling
-  the system power.
-
-Each regulator is defined using the standard binding for regulators.
-
-Note: LDO5 and LDO_RTC is supplied by SYS regulator internally and driver
-      take care of making proper parent child relationship.
-
-Example:
-
-	pmu: tps6586x@34 {
-		compatible = "ti,tps6586x";
-		reg = <0x34>;
-		interrupts = <0 88 0x4>;
-
-		#gpio-cells = <2>;
-		gpio-controller;
-
-		ti,system-power-controller;
-
-		sys-supply = <&some_reg>;
-		vin-sm0-supply = <&some_reg>;
-		vin-sm1-supply = <&some_reg>;
-		vin-sm2-supply = <&some_reg>;
-		vinldo01-supply = <...>;
-		vinldo23-supply = <...>;
-		vinldo4-supply = <...>;
-		vinldo678-supply = <...>;
-		vinldo9-supply = <...>;
-
-		regulators {
-			sys_reg: sys {
-				regulator-name = "vdd_sys";
-				regulator-boot-on;
-				regulator-always-on;
-			};
-
-			sm0_reg: sm0 {
-				regulator-min-microvolt = < 725000>;
-				regulator-max-microvolt = <1500000>;
-				regulator-boot-on;
-				regulator-always-on;
-			};
-
-			sm1_reg: sm1 {
-				regulator-min-microvolt = < 725000>;
-				regulator-max-microvolt = <1500000>;
-				regulator-boot-on;
-				regulator-always-on;
-			};
-
-			sm2_reg: sm2 {
-				regulator-min-microvolt = <3000000>;
-				regulator-max-microvolt = <4550000>;
-				regulator-boot-on;
-				regulator-always-on;
-			};
-
-			ldo0_reg: ldo0 {
-				regulator-name = "PCIE CLK";
-				regulator-min-microvolt = <3300000>;
-				regulator-max-microvolt = <3300000>;
-			};
-
-			ldo1_reg: ldo1 {
-				regulator-min-microvolt = < 725000>;
-				regulator-max-microvolt = <1500000>;
-			};
-
-			ldo2_reg: ldo2 {
-				regulator-min-microvolt = < 725000>;
-				regulator-max-microvolt = <1500000>;
-			};
-
-			ldo3_reg: ldo3 {
-				regulator-min-microvolt = <1250000>;
-				regulator-max-microvolt = <3300000>;
-			};
-
-			ldo4_reg: ldo4 {
-				regulator-min-microvolt = <1700000>;
-				regulator-max-microvolt = <2475000>;
-			};
-
-			ldo5_reg: ldo5 {
-				regulator-min-microvolt = <1250000>;
-				regulator-max-microvolt = <3300000>;
-			};
-
-			ldo6_reg: ldo6 {
-				regulator-min-microvolt = <1250000>;
-				regulator-max-microvolt = <3300000>;
-			};
-
-			ldo7_reg: ldo7 {
-				regulator-min-microvolt = <1250000>;
-				regulator-max-microvolt = <3300000>;
-			};
-
-			ldo8_reg: ldo8 {
-				regulator-min-microvolt = <1250000>;
-				regulator-max-microvolt = <3300000>;
-			};
-
-			ldo9_reg: ldo9 {
-				regulator-min-microvolt = <1250000>;
-				regulator-max-microvolt = <3300000>;
-			};
-		};
-	};
-- 
2.34.1


  parent reply	other threads:[~2021-12-17 17:05 UTC|newest]

Thread overview: 15+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-12-17 17:05 [PATCH 1/6] dt-bindings: regulator: palmas: Convert to json-schema Thierry Reding
2021-12-17 17:05 ` [PATCH 2/6] dt-bindings: regulator: pwm: " Thierry Reding
2021-12-18 18:08   ` Rob Herring
2021-12-21 18:49   ` Rob Herring
2021-12-17 17:05 ` [PATCH 3/6] dt-bindings: regulator: tps51632: " Thierry Reding
2021-12-21 18:51   ` Rob Herring
2021-12-17 17:05 ` [PATCH 4/6] dt-bindings: regulator: tps62360: " Thierry Reding
2021-12-21 18:52   ` Rob Herring
2021-12-17 17:05 ` Thierry Reding [this message]
2021-12-18 18:08   ` [PATCH 5/6] dt-bindings: regulator: tps6586x: " Rob Herring
2021-12-21 18:59   ` Rob Herring
2021-12-17 17:05 ` [PATCH 6/6] dt-bindings: regulator: tps65090: " Thierry Reding
2021-12-21 19:00   ` Rob Herring
2021-12-18 18:08 ` [PATCH 1/6] dt-bindings: regulator: palmas: " Rob Herring
2021-12-21 14:15 ` Rob Herring

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20211217170507.2843568-5-thierry.reding@gmail.com \
    --to=thierry.reding@gmail.com \
    --cc=devicetree@vger.kernel.org \
    --cc=lee.jones@linaro.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=robh+dt@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox