1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/regulator/pfuze100.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: PFUZE100 family of regulators
8
9maintainers:
10  - Robin Gong <yibin.gong@nxp.com>
11
12description: |
13  The valid names for regulators are:
14  --PFUZE100
15  sw1ab,sw1c,sw2,sw3a,sw3b,sw4,swbst,vsnvs,vrefddr,vgen1~vgen6
16  --PFUZE200
17  sw1ab,sw2,sw3a,sw3b,swbst,vsnvs,vrefddr,vgen1~vgen6,coin
18  --PFUZE3000
19  sw1a,sw1b,sw2,sw3,swbst,vsnvs,vrefddr,vldo1,vldo2,vccsd,v33,vldo3,vldo4
20  --PFUZE3001
21  sw1,sw2,sw3,vsnvs,vldo1,vldo2,vccsd,v33,vldo3,vldo4
22
23  Each regulator is defined using the standard binding for regulators.
24
25properties:
26  $nodename:
27    pattern: "^pmic@[0-9]$"
28
29  compatible:
30    enum:
31      - fsl,pfuze100
32      - fsl,pfuze200
33      - fsl,pfuze3000
34      - fsl,pfuze3001
35
36  reg:
37    maxItems: 1
38
39  fsl,pfuze-support-disable-sw:
40    $ref: /schemas/types.yaml#/definitions/flag
41    description: |
42      Boolean, if present disable all unused switch regulators to save power
43      consumption. Attention, ensure that all important regulators
44      (e.g. DDR ref, DDR supply) has set the "regulator-always-on" property.
45      If not present, the switched regulators are always on and can't be
46      disabled. This binding is a workaround to keep backward compatibility
47      with old dtb's which rely on the fact that the switched regulators are
48      always on and don't mark them explicit as "regulator-always-on".
49
50  fsl,pmic-stby-poweroff:
51    $ref: /schemas/types.yaml#/definitions/flag
52    description: |
53      if present, configure the PMIC to shutdown all
54      power rails when PMIC_STBY_REQ line is asserted during the power off sequence.
55      Use this option if the SoC should be powered off by external power management
56      IC (PMIC) on PMIC_STBY_REQ signal.
57      As opposite to PMIC_STBY_REQ boards can implement PMIC_ON_REQ signal.
58
59  regulators:
60    type: object
61    description: |
62      list of regulators provided by this controller.
63
64    patternProperties:
65      "^sw([1-4]|[1-4][a-c]|[1-4][a-c][a-c])$":
66        $ref: "regulator.yaml#"
67        type: object
68
69      "^vgen[1-6]$":
70        $ref: "regulator.yaml#"
71        type: object
72
73      "^(vsnvs|vref|vrefddr|swbst|coin)$":
74        $ref: "regulator.yaml#"
75        type: object
76
77    additionalProperties: false
78
79required:
80  - compatible
81  - reg
82
83examples:
84  - |
85    i2c {
86        #address-cells = <1>;
87        #size-cells = <0>;
88
89        pmic@8 {
90            compatible = "fsl,pfuze100";
91            reg = <0x08>;
92
93            regulators {
94                sw1a_reg: sw1ab {
95                    regulator-min-microvolt = <300000>;
96                    regulator-max-microvolt = <1875000>;
97                    regulator-boot-on;
98                    regulator-always-on;
99                    regulator-ramp-delay = <6250>;
100                };
101
102                sw1c_reg: sw1c {
103                    regulator-min-microvolt = <300000>;
104                    regulator-max-microvolt = <1875000>;
105                    regulator-boot-on;
106                    regulator-always-on;
107                };
108
109                sw2_reg: sw2 {
110                    regulator-min-microvolt = <800000>;
111                    regulator-max-microvolt = <3300000>;
112                    regulator-boot-on;
113                    regulator-always-on;
114                };
115
116                sw3a_reg: sw3a {
117                    regulator-min-microvolt = <400000>;
118                    regulator-max-microvolt = <1975000>;
119                    regulator-boot-on;
120                    regulator-always-on;
121                };
122
123                sw3b_reg: sw3b {
124                    regulator-min-microvolt = <400000>;
125                    regulator-max-microvolt = <1975000>;
126                    regulator-boot-on;
127                    regulator-always-on;
128                };
129
130                sw4_reg: sw4 {
131                    regulator-min-microvolt = <800000>;
132                    regulator-max-microvolt = <3300000>;
133                };
134
135                swbst_reg: swbst {
136                    regulator-min-microvolt = <5000000>;
137                    regulator-max-microvolt = <5150000>;
138                };
139
140                snvs_reg: vsnvs {
141                    regulator-min-microvolt = <1000000>;
142                    regulator-max-microvolt = <3000000>;
143                    regulator-boot-on;
144                    regulator-always-on;
145                };
146
147                vref_reg: vrefddr {
148                    regulator-boot-on;
149                    regulator-always-on;
150                };
151
152                vgen1_reg: vgen1 {
153                    regulator-min-microvolt = <800000>;
154                    regulator-max-microvolt = <1550000>;
155                };
156
157                vgen2_reg: vgen2 {
158                    regulator-min-microvolt = <800000>;
159                    regulator-max-microvolt = <1550000>;
160                };
161
162                vgen3_reg: vgen3 {
163                    regulator-min-microvolt = <1800000>;
164                    regulator-max-microvolt = <3300000>;
165                };
166
167                vgen4_reg: vgen4 {
168                    regulator-min-microvolt = <1800000>;
169                    regulator-max-microvolt = <3300000>;
170                    regulator-always-on;
171                };
172
173                vgen5_reg: vgen5 {
174                    regulator-min-microvolt = <1800000>;
175                    regulator-max-microvolt = <3300000>;
176                    regulator-always-on;
177                };
178
179                vgen6_reg: vgen6 {
180                    regulator-min-microvolt = <1800000>;
181                    regulator-max-microvolt = <3300000>;
182                    regulator-always-on;
183                };
184            };
185        };
186    };
187