summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/regulator/mediatek,mt6358-regulator.yaml
blob: c50402fcba72cce779f7a7997f5710c00531e88d (plain)
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
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/regulator/mediatek,mt6358-regulator.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: MediaTek MT6358 Regulator

maintainers:
  - Zhiyong Tao <zhiyong.tao@mediatek.com>

description:
  Regulator node of the PMIC. This node should under the PMIC's device node.
  All voltage regulators provided by the PMIC are described as sub-nodes of
  this node.

properties:
  compatible:
    oneOf:
      - const: mediatek,mt6358-regulator
      - items:
          - const: mediatek,mt6366-regulator
          - const: mediatek,mt6358-regulator

  vsys-ldo1-supply:
    description: Supply for LDOs vfe28, vxo22, vcn28, vaux18, vaud28, vsim1, vusb, vbif28
  vsys-ldo2-supply:
    description: Supply for LDOs vldo28 (MT6358 only), vio28, vmc, vmch, vsim2
  vsys-ldo3-supply:
    description: Supply for LDOs vcn33, vcama[12] (MT6358 only), vemc, vibr
  vsys-vcore-supply:
    description: Supply for buck regulator vcore
  vsys-vdram1-supply:
    description: Supply for buck regulator vdram1
  vsys-vgpu-supply:
    description: Supply for buck regulator vgpu
  vsys-vmodem-supply:
    description: Supply for buck regulator vmodem
  vsys-vpa-supply:
    description: Supply for buck regulator vpa
  vsys-vproc11-supply:
    description: Supply for buck regulator vproc11
  vsys-vproc12-supply:
    description: Supply for buck regulator vproc12
  vsys-vs1-supply:
    description: Supply for buck regulator vs1
  vsys-vs2-supply:
    description: Supply for buck regulator vs2
  vs1-ldo1-supply:
    description:
      Supply for LDOs vrf18, vefuse, vcn18, vcamio (MT6358 only), vio18, vm18 (MT6366 only)
  vs2-ldo1-supply:
    description: Supply for LDOs vdram2, vmddr (MT6366 only)
  vs2-ldo2-supply:
    description: Supply for LDOs vrf12, va12
  vs2-ldo3-supply:
    description:
      Supply for LDOs vsram-core (MT6366 only), vsram-gpu, vsram-others, vsram-proc11, vsram-proc12
  vs2-ldo4-supply:
    description: Supply for LDO vcamd

patternProperties:
  "^(buck_)?v(core|dram1|gpu|modem|pa|proc1[12]|s[12])$":
    description: Buck regulators
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes:
        description: |
          Buck regulatpr operating modes allowed. Valid values below.
          Users should use the macros from dt-bindings/regulator/mediatek,mt6397-regulator.h
            0 (MT6397_BUCK_MODE_AUTO): Auto PFM/PWM mode
            1 (MT6397_BUCK_MODE_FORCE_PWM): Forced PWM mode
        items:
          enum: [0, 1]
    unevaluatedProperties: false

  "^(ldo_)?v(a|rf)12$":
    description: LDOs with fixed 1.2V output and 0~100/10mV tuning
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

  "^(ldo_)?v((aux|cn|io|rf)18|camio)$":
    description:
      LDOs with fixed 1.8V output and 0~100/10mV tuning (vcn18 on MT6366 has variable output)
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

  "^(ldo_)?vxo22$":
    description: LDOs with fixed 2.2V output and 0~100/10mV tuning
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

  "^(ldo_)?v(aud|bif|cn|fe|io)28$":
    description: LDOs with fixed 2.8V output and 0~100/10mV tuning
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

  "^(ldo_)?vusb$":
    description: LDOs with fixed 3.0V output and 0~100/10mV tuning
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

  "^(ldo_)?vsram[_-](core|gpu|others|proc1[12])$":
    description: LDOs with variable output
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

  "^(ldo_)?v(cama[12]|camd|cn33|dram2|efuse|emc|ibr|ldo28|m18|mc|mch|mddr|sim[12])$":
    description: LDOs with variable output and 0~100/10mV tuning
    type: object
    $ref: regulator.yaml#
    properties:
      regulator-allowed-modes: false
    unevaluatedProperties: false

required:
  - compatible

additionalProperties: false

allOf:
  - if:
      properties:
        compatible:
          const: mediatek,mt6358-regulator
    then:
      patternProperties:
        # Old regulator node name scheme (with prefix and underscores) only
        # ([^y-] is used to avoid matching -supply
        "^(?<!buck_)(?<!ldo_)v.*[^y-](?!-supply)$": false
        "^ldo_vsram-": false
        # vsram_core regulator doesn't exist on MT6358
        "^ldo_vsram[-_]core$": false

      properties:
        # vm18 and vmddr regulators don't exist on MT6358
        ldo_vm18: false
        ldo_vmddr: false

  - if:
      properties:
        compatible:
          contains:
            const: mediatek,mt6366-regulator
    then:
      patternProperties:
        # Prefer cleaned up regulator node names
        "^(buck|ldo)_": false
        # Don't allow underscores
        "^vsram_": false
        # vcam* regulators don't exist on MT6366
        "^vcam": false

      properties:
        # vldo28 regulator doesn't exist on MT6366
        vldo28: false
        # vs2_ldo4 supply pin doesn't exist on MT6366
        vs2-ldo4-supply: false

examples:
  - |
    #include <dt-bindings/regulator/mediatek,mt6397-regulator.h>

    regulator {
        compatible = "mediatek,mt6358-regulator";

        buck_vgpu {
            regulator-name = "vgpu";
            regulator-min-microvolt = <625000>;
            regulator-max-microvolt = <900000>;
            regulator-ramp-delay = <6250>;
            regulator-enable-ramp-delay = <200>;
            regulator-allowed-modes = <MT6397_BUCK_MODE_AUTO
                                       MT6397_BUCK_MODE_FORCE_PWM>;
        };

        ldo_vsram_gpu {
            regulator-name = "vsram_gpu";
            regulator-min-microvolt = <850000>;
            regulator-max-microvolt = <1000000>;
            regulator-ramp-delay = <6250>;
            regulator-enable-ramp-delay = <240>;
        };
    };

  - |
    #include <dt-bindings/regulator/mediatek,mt6397-regulator.h>

    regulator {
        compatible = "mediatek,mt6366-regulator", "mediatek,mt6358-regulator";

        vdram1 {
            regulator-name = "pp1125_emi_vdd2";
            regulator-min-microvolt = <1125000>;
            regulator-max-microvolt = <1125000>;
            regulator-ramp-delay = <12500>;
            regulator-enable-ramp-delay = <0>;
            regulator-allowed-modes = <MT6397_BUCK_MODE_AUTO
                                       MT6397_BUCK_MODE_FORCE_PWM>;
            regulator-always-on;
        };

        vproc11 {
            regulator-name = "ppvar_dvdd_proc_bc_mt6366";
            regulator-min-microvolt = <600000>;
            regulator-max-microvolt = <1200000>;
            regulator-ramp-delay = <6250>;
            regulator-enable-ramp-delay = <200>;
            regulator-allowed-modes = <MT6397_BUCK_MODE_AUTO
                                       MT6397_BUCK_MODE_FORCE_PWM>;
            regulator-always-on;
        };

        vmddr {
            regulator-name = "pm0750_emi_vmddr";
            regulator-min-microvolt = <700000>;
            regulator-max-microvolt = <750000>;
            regulator-enable-ramp-delay = <325>;
            regulator-always-on;
        };

        vsram-proc11 {
            regulator-name = "pp0900_dvdd_sram_bc";
            regulator-min-microvolt = <850000>;
            regulator-max-microvolt = <1120000>;
            regulator-ramp-delay = <6250>;
            regulator-enable-ramp-delay = <240>;
            regulator-always-on;
        };
    };
...