Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
regulator: dt-bindings: microchip,mcp16502: convert to YAML
Convert devicetree binding mcp16502-regulator.txt to YAML format.
Signed-off-by: Andrei Simion <andrei.simion@microchip.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://msgid.link/r/20240201161517.492162-1-andrei.simion@microchip.com
Signed-off-by: Mark Brown <broonie@kernel.org>
authored by
Andrei Simion
and committed by
Mark Brown
64db3e8d
4c716711
+180
-144
-144
Documentation/devicetree/bindings/regulator/mcp16502-regulator.txt
-144
Documentation/devicetree/bindings/regulator/mcp16502-regulator.txt
···
1
-
MCP16502 PMIC
2
-
3
-
Required properties:
4
-
- compatible: "microchip,mcp16502"
5
-
- reg: I2C slave address
6
-
- lpm-gpios: GPIO for LPM pin. Note that this GPIO *must* remain high during
7
-
suspend-to-ram, keeping the PMIC into HIBERNATE mode; this
8
-
property is optional;
9
-
- regulators: A node that houses a sub-node for each regulator within
10
-
the device. Each sub-node is identified using the node's
11
-
name. The content of each sub-node is defined by the
12
-
standard binding for regulators; see regulator.txt.
13
-
14
-
Regulators of MCP16502 PMIC:
15
-
1) VDD_IO - Buck (1.2 - 3.7 V)
16
-
2) VDD_DDR - Buck (0.6 - 1.85 V)
17
-
3) VDD_CORE - Buck (0.6 - 1.85 V)
18
-
4) VDD_OTHER - BUCK (0.6 - 1.85 V)
19
-
5) LDO1 - LDO (1.2 - 3.7 V)
20
-
6) LDO2 - LDO (1.2 - 3.7 V)
21
-
22
-
Regulator modes:
23
-
2 - FPWM: higher precision, higher consumption
24
-
4 - AutoPFM: lower precision, lower consumption
25
-
26
-
Each regulator is defined using the standard binding for regulators.
27
-
28
-
Example:
29
-
30
-
mcp16502@5b {
31
-
compatible = "microchip,mcp16502";
32
-
reg = <0x5b>;
33
-
status = "okay";
34
-
lpm-gpios = <&pioBU 7 GPIO_ACTIVE_HIGH>;
35
-
36
-
regulators {
37
-
VDD_IO {
38
-
regulator-name = "VDD_IO";
39
-
regulator-min-microvolt = <1200000>;
40
-
regulator-max-microvolt = <3700000>;
41
-
regulator-initial-mode = <2>;
42
-
regulator-allowed-modes = <2>, <4>;
43
-
regulator-always-on;
44
-
45
-
regulator-state-standby {
46
-
regulator-on-in-suspend;
47
-
regulator-mode = <4>;
48
-
};
49
-
50
-
regulator-state-mem {
51
-
regulator-off-in-suspend;
52
-
regulator-mode = <4>;
53
-
};
54
-
};
55
-
56
-
VDD_DDR {
57
-
regulator-name = "VDD_DDR";
58
-
regulator-min-microvolt = <600000>;
59
-
regulator-max-microvolt = <1850000>;
60
-
regulator-initial-mode = <2>;
61
-
regulator-allowed-modes = <2>, <4>;
62
-
regulator-always-on;
63
-
64
-
regulator-state-standby {
65
-
regulator-on-in-suspend;
66
-
regulator-mode = <4>;
67
-
};
68
-
69
-
regulator-state-mem {
70
-
regulator-on-in-suspend;
71
-
regulator-mode = <4>;
72
-
};
73
-
};
74
-
75
-
VDD_CORE {
76
-
regulator-name = "VDD_CORE";
77
-
regulator-min-microvolt = <600000>;
78
-
regulator-max-microvolt = <1850000>;
79
-
regulator-initial-mode = <2>;
80
-
regulator-allowed-modes = <2>, <4>;
81
-
regulator-always-on;
82
-
83
-
regulator-state-standby {
84
-
regulator-on-in-suspend;
85
-
regulator-mode = <4>;
86
-
};
87
-
88
-
regulator-state-mem {
89
-
regulator-off-in-suspend;
90
-
regulator-mode = <4>;
91
-
};
92
-
};
93
-
94
-
VDD_OTHER {
95
-
regulator-name = "VDD_OTHER";
96
-
regulator-min-microvolt = <600000>;
97
-
regulator-max-microvolt = <1850000>;
98
-
regulator-initial-mode = <2>;
99
-
regulator-allowed-modes = <2>, <4>;
100
-
regulator-always-on;
101
-
102
-
regulator-state-standby {
103
-
regulator-on-in-suspend;
104
-
regulator-mode = <4>;
105
-
};
106
-
107
-
regulator-state-mem {
108
-
regulator-off-in-suspend;
109
-
regulator-mode = <4>;
110
-
};
111
-
};
112
-
113
-
LDO1 {
114
-
regulator-name = "LDO1";
115
-
regulator-min-microvolt = <1200000>;
116
-
regulator-max-microvolt = <3700000>;
117
-
regulator-always-on;
118
-
119
-
regulator-state-standby {
120
-
regulator-on-in-suspend;
121
-
};
122
-
123
-
regulator-state-mem {
124
-
regulator-off-in-suspend;
125
-
};
126
-
};
127
-
128
-
LDO2 {
129
-
regulator-name = "LDO2";
130
-
regulator-min-microvolt = <1200000>;
131
-
regulator-max-microvolt = <3700000>;
132
-
regulator-always-on;
133
-
134
-
regulator-state-standby {
135
-
regulator-on-in-suspend;
136
-
};
137
-
138
-
regulator-state-mem {
139
-
regulator-off-in-suspend;
140
-
};
141
-
};
142
-
143
-
};
144
-
};
+180
Documentation/devicetree/bindings/regulator/microchip,mcp16502.yaml
+180
Documentation/devicetree/bindings/regulator/microchip,mcp16502.yaml
···
1
+
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/regulator/microchip,mcp16502.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: MCP16502 - High-Performance PMIC
8
+
9
+
maintainers:
10
+
- Andrei Simion <andrei.simion@microchip.com>
11
+
12
+
description:
13
+
The MCP16502 is an optimally integrated PMIC compatible
14
+
with Microchip's eMPUs(Embedded Microprocessor Units),
15
+
requiring Dynamic Voltage Scaling (DVS) with the use
16
+
of High-Performance mode (HPM).
17
+
18
+
properties:
19
+
compatible:
20
+
const: microchip,mcp16502
21
+
22
+
lpm-gpios:
23
+
maxItems: 1
24
+
description: GPIO for LPM pin.
25
+
Note that this GPIO must remain high during
26
+
suspend-to-ram, keeping the PMIC into HIBERNATE mode.
27
+
28
+
reg:
29
+
maxItems: 1
30
+
31
+
regulators:
32
+
type: object
33
+
additionalProperties: false
34
+
description: List of regulators and its properties.
35
+
36
+
patternProperties:
37
+
"^(VDD_(IO|CORE|DDR|OTHER)|LDO[1-2])$":
38
+
type: object
39
+
$ref: regulator.yaml#
40
+
unevaluatedProperties: false
41
+
42
+
properties:
43
+
regulator-initial-mode:
44
+
enum: [2, 4]
45
+
default: 2
46
+
description: Initial operating mode
47
+
48
+
regulator-allowed-modes:
49
+
items:
50
+
enum: [2, 4]
51
+
description: Supported modes
52
+
2 - FPWM higher precision, higher consumption
53
+
4 - AutoPFM lower precision, lower consumption
54
+
55
+
required:
56
+
- compatible
57
+
- reg
58
+
- regulators
59
+
60
+
additionalProperties: false
61
+
62
+
examples:
63
+
- |
64
+
i2c {
65
+
#address-cells = <1>;
66
+
#size-cells = <0>;
67
+
68
+
pmic@5b {
69
+
compatible = "microchip,mcp16502";
70
+
reg = <0x5b>;
71
+
72
+
regulators {
73
+
VDD_IO {
74
+
regulator-name = "VDD_IO";
75
+
regulator-min-microvolt = <3300000>;
76
+
regulator-max-microvolt = <3300000>;
77
+
regulator-initial-mode = <2>;
78
+
regulator-allowed-modes = <2>, <4>;
79
+
regulator-always-on;
80
+
81
+
regulator-state-standby {
82
+
regulator-on-in-suspend;
83
+
regulator-mode = <4>;
84
+
};
85
+
86
+
regulator-state-mem {
87
+
regulator-off-in-suspend;
88
+
regulator-mode = <4>;
89
+
};
90
+
};
91
+
92
+
VDD_DDR {
93
+
regulator-name = "VDD_DDR";
94
+
regulator-min-microvolt = <1350000>;
95
+
regulator-max-microvolt = <1350000>;
96
+
regulator-initial-mode = <2>;
97
+
regulator-allowed-modes = <2>, <4>;
98
+
regulator-always-on;
99
+
100
+
regulator-state-standby {
101
+
regulator-on-in-suspend;
102
+
regulator-mode = <4>;
103
+
};
104
+
105
+
regulator-state-mem {
106
+
regulator-on-in-suspend;
107
+
regulator-mode = <4>;
108
+
};
109
+
};
110
+
111
+
VDD_CORE {
112
+
regulator-name = "VDD_CORE";
113
+
regulator-min-microvolt = <1150000>;
114
+
regulator-max-microvolt = <1150000>;
115
+
regulator-initial-mode = <2>;
116
+
regulator-allowed-modes = <2>, <4>;
117
+
regulator-always-on;
118
+
119
+
regulator-state-standby {
120
+
regulator-on-in-suspend;
121
+
regulator-mode = <4>;
122
+
};
123
+
124
+
regulator-state-mem {
125
+
regulator-off-in-suspend;
126
+
regulator-mode = <4>;
127
+
};
128
+
};
129
+
130
+
VDD_OTHER {
131
+
regulator-name = "VDD_OTHER";
132
+
regulator-min-microvolt = <1050000>;
133
+
regulator-max-microvolt = <1250000>;
134
+
regulator-initial-mode = <2>;
135
+
regulator-allowed-modes = <2>, <4>;
136
+
regulator-always-on;
137
+
138
+
regulator-state-standby {
139
+
regulator-on-in-suspend;
140
+
regulator-mode = <4>;
141
+
};
142
+
143
+
regulator-state-mem {
144
+
regulator-off-in-suspend;
145
+
regulator-mode = <4>;
146
+
};
147
+
};
148
+
149
+
LDO1 {
150
+
regulator-name = "LDO1";
151
+
regulator-min-microvolt = <1800000>;
152
+
regulator-max-microvolt = <1800000>;
153
+
regulator-always-on;
154
+
155
+
regulator-state-standby {
156
+
regulator-on-in-suspend;
157
+
};
158
+
159
+
regulator-state-mem {
160
+
regulator-off-in-suspend;
161
+
};
162
+
};
163
+
164
+
LDO2 {
165
+
regulator-name = "LDO2";
166
+
regulator-min-microvolt = <1200000>;
167
+
regulator-max-microvolt = <3700000>;
168
+
regulator-always-on;
169
+
170
+
regulator-state-standby {
171
+
regulator-on-in-suspend;
172
+
};
173
+
174
+
regulator-state-mem {
175
+
regulator-off-in-suspend;
176
+
};
177
+
};
178
+
};
179
+
};
180
+
};