Documentation/devicetree/bindings/mfd/spacemit,p1.yaml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

# 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

  vin1-supply:
    description:
      Power supply for BUCK1. Required if BUCK1 is defined.

  vin2-supply:
    description:
      Power supply for BUCK2. Required if BUCK2 is defined.

  vin3-supply:
    description:
      Power supply for BUCK3. Required if BUCK3 is defined.

  vin4-supply:
    description:
      Power supply for BUCK4. Required if BUCK4 is defined.

  vin5-supply:
    description:
      Power supply for BUCK5. Required if BUCK5 is defined.

  vin6-supply:
    description:
      Power supply for BUCK6. Required if BUCK6 is defined.

  aldoin-supply:
    description:
      Power supply for ALDO1-4. Required if any are defined.

  dldoin1-supply:
    description:
      Power supply for DLDO1-4. Required if any are defined.

  dldoin2-supply:
    description:
      Power supply for DLDO5-7. Required if any are defined.

  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>;
            vin1-supply = <&reg_vcc_5v>;
            vin5-supply = <&reg_vcc_5v>;
            aldoin-supply = <&reg_vcc_5v>;
            dldoin1-supply = <&buck5>;

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

                buck5: buck5 {
                    regulator-name = "buck5";
                    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;
                };
            };
        };
    };