xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/mps,mpq7920.yaml (revision 84823cc70824c8d842f503d8c2e6d7b0c2d95b61)
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/regulator/mps,mpq7920.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Monolithic Power System MPQ7920 PMIC
8
9maintainers:
10  - Saravanan Sekar <sravanhome@gmail.com>
11
12properties:
13  $nodename:
14    pattern: "pmic@[0-9a-f]{1,2}"
15  compatible:
16    enum:
17      - mps,mpq7920
18
19  reg:
20    maxItems: 1
21
22  regulators:
23    type: object
24    $ref: regulator.yaml#
25
26    description: |
27      list of regulators provided by this controller, must be named
28      after their hardware counterparts BUCK[1-4], one LDORTC, and LDO[2-5]
29
30    properties:
31      mps,switch-freq:
32        $ref: "/schemas/types.yaml#/definitions/uint8"
33        enum: [0, 1, 2, 3]
34        default: 2
35        description: |
36          switching frequency must be one of following corresponding value
37          1.1MHz, 1.65MHz, 2.2MHz, 2.75MHz
38
39      ldortc:
40        type: object
41        $ref: regulator.yaml#
42
43    patternProperties:
44      "^ldo[1-4]$":
45        type: object
46        $ref: regulator.yaml#
47
48      "^buck[1-4]$":
49        type: object
50        $ref: regulator.yaml#
51
52        properties:
53          mps,buck-softstart:
54            $ref: "/schemas/types.yaml#/definitions/uint8"
55            enum: [0, 1, 2, 3]
56            description: |
57              defines the soft start time of this buck, must be one of the following
58              corresponding values 150us, 300us, 610us, 920us
59
60          mps,buck-phase-delay:
61            $ref: "/schemas/types.yaml#/definitions/uint8"
62            enum: [0, 1, 2, 3]
63            description: |
64              defines the phase delay of this buck, must be one of the following
65              corresponding values 0deg, 90deg, 180deg, 270deg
66
67          mps,buck-ovp-disable:
68            type: boolean
69            description: |
70              disables over voltage protection of this buck
71
72        unevaluatedProperties: false
73
74    additionalProperties: false
75
76required:
77  - compatible
78  - reg
79  - regulators
80
81additionalProperties: false
82
83examples:
84  - |
85    i2c {
86        #address-cells = <1>;
87        #size-cells = <0>;
88
89        pmic@69 {
90          compatible = "mps,mpq7920";
91          reg = <0x69>;
92
93          regulators {
94            mps,switch-freq = /bits/ 8 <1>;
95
96            buck1 {
97             regulator-name = "buck1";
98             regulator-min-microvolt = <400000>;
99             regulator-max-microvolt = <3587500>;
100             regulator-min-microamp  = <460000>;
101             regulator-max-microamp  = <7600000>;
102             regulator-boot-on;
103             mps,buck-ovp-disable;
104             mps,buck-phase-delay = /bits/ 8 <2>;
105             mps,buck-softstart = /bits/ 8 <1>;
106            };
107
108            ldo2 {
109             regulator-name = "ldo2";
110             regulator-min-microvolt = <650000>;
111             regulator-max-microvolt = <3587500>;
112            };
113         };
114       };
115     };
116...
117