xref: /freebsd/sys/contrib/device-tree/Bindings/regulator/mediatek,mt6363-regulator.yaml (revision 96fb1ebd28756790597f73ad25306f58f558be97)
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/regulator/mediatek,mt6363-regulator.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MediaTek MT6363 PMIC Regulators
8
9maintainers:
10  - AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>
11
12description:
13  The MT6363 SPMI PMIC provides 10 BUCK and 25 LDO (Low DropOut) regulators
14  and can optionally provide overcurrent warnings with one ocp interrupt
15  for each voltage regulator.
16
17properties:
18  compatible:
19    const: mediatek,mt6363-regulator
20
21  reg:
22    maxItems: 1
23
24  vsys-vbuck1-supply:
25    description: Input supply for vbuck1
26
27  vsys-vbuck2-supply:
28    description: Input supply for vbuck2
29
30  vsys-vbuck3-supply:
31    description: Input supply for vbuck3
32
33  vsys-vbuck4-supply:
34    description: Input supply for vbuck4
35
36  vsys-vbuck5-supply:
37    description: Input supply for vbuck5
38
39  vsys-vbuck6-supply:
40    description: Input supply for vbuck6
41
42  vsys-vbuck7-supply:
43    description: Input supply for vbuck7
44
45  vsys-vs1-supply:
46    description: Input supply for vs1
47
48  vsys-vs2-supply:
49    description: Input supply for vs2
50
51  vsys-vs3-supply:
52    description: Input supply for vs3
53
54  vs1-ldo1-supply:
55    description: Input supply for va15, vio0p75, vm18, vrf18, vrf-io18
56
57  vs1-ldo2-supply:
58    description: Input supply for vcn15, vio18, vufs18
59
60  vs2-ldo1-supply:
61    description: Input supply for vsram-cpub, vsram-cpum, vrf12, vrf13, vufs12
62
63  vs2-ldo2-supply:
64    description: Input supply for va12-1, va12-2, vcn13, vsram-cpul
65
66  vs3-ldo1-supply:
67    description: Input supply for vsram-apu, vsram-digrf, vsram-mdfe
68
69  vs3-ldo2-supply:
70    description: Input supply for vsram-modem, vrf0p9
71
72  vsys-ldo1-supply:
73    description: Input supply for vaux18, vemc, vtref18
74
75patternProperties:
76  "^v(buck[1-7]|s[1-3])$":
77    description: Buck regulators
78    type: object
79    $ref: regulator.yaml#
80    unevaluatedProperties: false
81    properties:
82      regulator-allowed-modes:
83        description: |
84          Allowed Buck regulator operating modes allowed. Valid values below.
85            0 - Normal mode with automatic power saving, reducing the switching
86                frequency when light load conditions are detected
87            1 - Forced Continuous Conduction mode (FCCM) for improved voltage
88                regulation accuracy with constant switching frequency but lower
89                regulator efficiency
90            2 - Forced Low Power mode for improved regulator efficiency, used
91                when no heavy load is expected, does not limit the maximum out
92                current but unless only a light load is applied, there will be
93                regulation accuracy and efficiency losses.
94            3 - Forced Ultra Low Power mode for ultra low load, this greatly
95                reduces the maximum output power, makes the regulator to be
96                efficient only for ultra light load, and greatly reduces the
97                quiescent current (Iq) of the buck.
98        maxItems: 3
99        items:
100          enum: [ 0, 1, 2, 3 ]
101
102  "^va(12-1|12-2|15)$":
103    $ref: "#/$defs/ldo-common"
104
105  "^v(aux|m|rf-io|tref)18$":
106    $ref: "#/$defs/ldo-common"
107
108  "^v(cn13|cn15|emc)$":
109    $ref: "#/$defs/ldo-common"
110
111  "^vio(0p75|18)$":
112    $ref: "#/$defs/ldo-common"
113
114  "^vrf(0p9|12|13|18)$":
115    $ref: "#/$defs/ldo-common"
116
117  "^vsram-(apu|cpub|cpum|cpul|digrf|mdfe|modem)$":
118    $ref: "#/$defs/ldo-common"
119
120  "^vufs(12|18)$":
121    $ref: "#/$defs/ldo-common"
122
123$defs:
124  ldo-common:
125    type: object
126    $ref: regulator.yaml#
127    unevaluatedProperties: false
128    properties:
129      regulator-allowed-modes:
130        description: |
131          Allowed LDO regulator operating modes allowed. Valid values below.
132            0 - Normal mode with automatic power saving, reducing the switching
133                frequency when light load conditions are detected
134            2 - Forced Low Power mode for improved regulator efficiency, used
135                when no heavy load is expected, does not limit the maximum out
136                current but unless only a light load is applied, there will be
137                regulation accuracy and efficiency losses.
138        maxItems: 2
139        items:
140          enum: [ 0, 2 ]
141
142required:
143  - compatible
144  - reg
145
146additionalProperties: false
147