[PATCH v2 04/10] dt-bindings: mfd: ROHM BD73800 PMIC

--V3KWYXZ6ZW6L29no
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

=46rom: Matti Vaittinen <[email protected]>

The ROHM BD73800 is a power management IC which integrates 8 BUCKs and 4
LDOs. There is also an ADC and operation amplifier intended for current
/ temperature measurement and accumulation. RTC and 32.768 kHz clock
gate are also included. The PMIC can be customized via OTP and it has
options for operating as a main PMIC in multi-PMIC installation. Some
of the pins can also be used for GPO or GPI (including interrupt support).

There are also ROHM BD71851 and BD71885 PMICs out there. These are, from
the SW-perspective, similar to the BD73800. There is only some different
default values and OTP settings. The driver should be able to handle them
just fine.

Signed-off-by: Matti Vaittinen <[email protected]>

---
Revision history:
v1 =3D> v2:
 - Reference commonly used ROHM bindings from a common binding file
 - Simplify compatible list
 - Move relevant comments to description so they can be shown in
   generated human-readable doc.
 - Allow other clock-output-names besides "bd73800-32k-out"
---
 .../bindings/mfd/rohm,bd73800-pmic.yaml       | 218 ++++++++++++++++++
 1 file changed, 218 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mfd/rohm,bd73800-pmic=
=2Eyaml

diff --git a/Documentation/devicetree/bindings/mfd/rohm,bd73800-pmic.yaml b=
/Documentation/devicetree/bindings/mfd/rohm,bd73800-pmic.yaml
new file mode 100644
index 000000000000..8371e7f2ab84
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/rohm,bd73800-pmic.yaml
@@ -0,0 +1,218 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/mfd/rohm,bd73800-pmic.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: ROHM BD73800 Power Management Integrated Circuit
+
+maintainers:
+  - Matti Vaittinen <[email protected]>
+
+description:
+  BD73800GW is a single-chip power management IC for battery-powered
+  portable devices. It integrates 8 buck converters, 4 LDOs and a current
+  sense amplifier with ADC. Also included is a Real Time Clock (RTC) and a
+  32.768 kHz clock gate. Depending on the OTP configuration the BD73800
+  may also have interrupt controller and GPIOs.
+
+  There are also different variants called BD71851 and BD71885 which are
+  almost identical from the software point of view.
+
+allOf:
+  - $ref: rohm,pmic-pins.yaml#
+
+properties:
+  compatible:
+    oneOf:
+      - const: rohm,bd73800
+
+      - items:
+          - enum:
+              - rohm,bd71851
+              - rohm,bd71885
+          - const: rohm,bd73800
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+
+  # The GPIO1, CLKOUT (GPIO2), FAULT_B and EXTEN_OUT pins can be
+  # configured to interrupt pins by OTP.
+  interrupt-controller: true
+
+  "#interrupt-cells":
+    const: 1
+    description:
+      The IRQ number. 0 is GPIO1, 1 CLKOUT (GPIO2), 2 FAULT_B and 3 EXTEN_=
OUT.
+      NOTE, A pin can operate as IRQ source only when the OTP
+      configuration for it has been set to GPI.
+
+  gpio-controller: true
+
+  "#gpio-cells":
+    const: 2
+
+  rohm,pin-gpio1:
+    $ref: /schemas/types.yaml#/definitions/string
+    description:
+      Indicate if the GPIO1 pin has been set to GPI or GPO at manufacturin=
g.
+      The GPIO1, CLKOUT, FAULT_B and EXTEN_OUT pins may be configured for a
+      specific purpose (like ADC input, 32.768 clk output, fault indicator=
 or
+      delivering power sequence to a companion PMIC when multiple PMICs are
+      used) - but also to be either a GPO or GPI. (When used as a GPI the =
pin
+      can also be used as an IRQ source). The pin purpose is determined by
+      OTP (One Time Programmable memory), typically during device
+      manufacturing. The OTP can't be read at runtime so device-tree should
+      describe the GPIO pins.
+    enum: [gpi, gpo]
+
+  rohm,pin-clkout:
+    enum: [gpi, gpo]
+
+  rohm,pin-fault_b:
+    enum: [gpi, gpo]
+
+  rohm,pin-exten:
+    enum: [gpi, gpo]
+
+  clocks:
+    description:
+      The CLKOUT pin may have its purpose overridden by OTP configuration.=
 It
+      is possible the BD73800 does not output a clock signal. Hence the clk
+      properties are optional.
+    maxItems: 1
+
+  "#clock-cells":
+    const: 0
+
+  clock-output-names:
+    maxItems: 1
+
+  rohm,clkout-open-drain: true
+
+  regulators:
+    $ref: /schemas/regulator/rohm,bd73800-regulator.yaml
+    description:
+      List of child nodes that specify the regulators.
+
+required:
+  - compatible
+  - reg
+  - interrupts
+  - regulators
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    #include <dt-bindings/leds/common.h>
+    i2c {
+        #address-cells =3D <1>;
+        #size-cells =3D <0>;
+        pmic: pmic@4b {
+            compatible =3D "rohm,bd73800";
+            reg =3D <0x4b>;
+
+            interrupt-parent =3D <&gpio1>;
+            interrupts =3D <29 IRQ_TYPE_LEVEL_LOW>;
+
+            clocks =3D <&osc 0>;
+            #clock-cells =3D <0>;
+            clock-output-names =3D "bd73800-32k-out";
+
+            gpio-controller;
+            #gpio-cells =3D <2>;
+
+            rohm,pin-gpio1 =3D "gpo";
+            rohm,pin-exten =3D "gpi";
+
+            regulators {
+                buck1: buck1 {
+                    regulator-name =3D "buck1";
+                    regulator-min-microvolt =3D <800000>;
+                    regulator-max-microvolt =3D <2000000>;
+                    regulator-always-on;
+                    regulator-ramp-delay =3D <1250>;
+                    rohm,dvs-run-voltage =3D <1150000>;
+                    rohm,dvs-suspend-voltage =3D <950000>;
+                };
+                buck2: buck2 {
+                    regulator-name =3D "buck2";
+                    regulator-min-microvolt =3D <800000>;
+                    regulator-max-microvolt =3D <2000000>;
+                    regulator-always-on;
+                    regulator-ramp-delay =3D <1250>;
+                    rohm,dvs-run-voltage =3D <1150000>;
+                    rohm,dvs-suspend-voltage =3D <950000>;
+                };
+                buck3: buck3 {
+                    regulator-name =3D "buck3";
+                    regulator-min-microvolt =3D <1200000>;
+                    regulator-max-microvolt =3D <2700000>;
+                    rohm,dvs-run-voltage =3D <1150000>;
+                    rohm,dvs-idle-voltage =3D <1100000>;
+                    rohm,dvs-suspend-voltage =3D <950000>;
+                    regulator-always-on;
+                };
+                buck4: buck4 {
+                    regulator-name =3D "buck4";
+                    regulator-min-microvolt =3D <1100000>;
+                    regulator-max-microvolt =3D <1850000>;
+                    regulator-always-on;
+                };
+                buck5: buck5 {
+                    regulator-name =3D "buck5";
+                    regulator-min-microvolt =3D <1800000>;
+                    regulator-max-microvolt =3D <3300000>;
+                    regulator-always-on;
+                };
+                buck6: buck6 {
+                    regulator-name =3D "buck6";
+                    regulator-min-microvolt =3D <1800000>;
+                    regulator-max-microvolt =3D <3300000>;
+                    regulator-always-on;
+                };
+                buck7: buck7 {
+                    regulator-name =3D "buck7";
+                    regulator-min-microvolt =3D <1800000>;
+                    regulator-max-microvolt =3D <3300000>;
+                    regulator-always-on;
+                };
+                buck8: buck8 {
+                    regulator-name =3D "buck8";
+                    regulator-min-microvolt =3D <500000>;
+                    regulator-max-microvolt =3D <1300000>;
+                    regulator-always-on;
+                };
+                ldo1: ldo1 {
+                    regulator-name =3D "ldo1";
+                    rohm,ldo-range-high;
+                    regulator-min-microvolt =3D <800000>;
+                    regulator-max-microvolt =3D <3300000>;
+                    regulator-always-on;
+                };
+                ldo2: ldo2 {
+                    regulator-name =3D "ldo2";
+                    regulator-min-microvolt =3D <800000>;
+                    regulator-max-microvolt =3D <3300000>;
+                    regulator-always-on;
+                };
+                ldo3: ldo3 {
+                    regulator-name =3D "ldo3";
+                    regulator-min-microvolt =3D <800000>;
+                    regulator-max-microvolt =3D <3300000>;
+                    regulator-always-on;
+                };
+                ldo4: ldo4 {
+                    regulator-name =3D "ldo4";
+                    regulator-min-microvolt =3D <650000>;
+                    regulator-max-microvolt =3D <1750000>;
+                    regulator-always-on;
+                };
+            };
+        };
+    };
--=20
2.55.0


--V3KWYXZ6ZW6L29no
Content-Type: application/pgp-signature; name=signature.asc

-----BEGIN PGP SIGNATURE-----

iQEzBAEBCgAdFiEEIx+f8wZb28fLKEhTeFA3/03aocUFAmpxvSwACgkQeFA3/03a
ocULcggAg7Mp/7yCkcZS7WQh754HVAQdVnqCtSZgkgOvsSQ25KIMm48xwifvz3Hz
vSpn9jrTEhfZ16CjO0UQyL5x2LTwVX6Cfie3BPsKtsnF3X1RP9fixJX3bwoAxBtL
PN9DSOwSPMWPgx+f8gljfnOPHG0rH7kxOo/aRHTJ3saV5V4ddH2t650QA9lO4a9W
ic86gBq6KlUrN2KfPithNQ0BDTlShlMvENx1ow5RyHbvvYRpEO3He8wCuOWrKMdk
jAO2poZ9gRWacJwBdjINlPpLAR99vdVVvPZ1NWnV7+msUprqzTjwtEbsukJIXVXu
k2iAtEA+382Khl9FTyJh+URUnk5VUA==
=/cj3
-----END PGP SIGNATURE-----

--V3KWYXZ6ZW6L29no--