ARK-OS/arkos/kernel/Documentation/devicetree/bindings/mfd/spacemit,p1.yaml

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/spacemit,p1.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: SpacemiT P1 Power Management Integrated Circuit

maintainers:
  - Troy Mitchell <troy.mitchell@linux.spacemit.com>

description:
  P1 is an I2C-controlled PMIC produced by SpacemiT.  It implements six
  constant-on-time buck converters and twelve low-dropout regulators.
  It also contains a load switch, watchdog timer, real-time clock, eight
  12-bit ADC channels, and six GPIOs.  Additional details are available
  in the "Power Stone/P1" section at the following link.
    https://developer.spacemit.com/documentation

properties:
  compatible:
    const: spacemit,p1

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  vin-supply:
    description: Input supply phandle.

  regulators:
    type: object

    patternProperties:
      "^(buck[1-6]|aldo[1-4]|dldo[1-7])$":
        type: object
        $ref: /schemas/regulator/regulator.yaml#
        unevaluatedProperties: false

    unevaluatedProperties: false

required:
  - compatible
  - reg
  - interrupts

unevaluatedProperties: false

examples:
  - |
    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        pmic@41 {
            compatible = "spacemit,p1";
            reg = <0x41>;
            interrupts = <64>;

            regulators {
                buck1 {
                    regulator-name = "buck1";
                    regulator-min-microvolt = <500000>;
                    regulator-max-microvolt = <3450000>;
                    regulator-ramp-delay = <5000>;
                    regulator-always-on;
                };

                aldo1 {
                    regulator-name = "aldo1";
                    regulator-min-microvolt = <500000>;
                    regulator-max-microvolt = <3400000>;
                    regulator-boot-on;
                };

                dldo1 {
                    regulator-name = "dldo1";
                    regulator-min-microvolt = <500000>;
                    regulator-max-microvolt = <3400000>;
                    regulator-boot-on;
                };
            };
        };
    };