1Binding for Samsung S2M family regulator block
2==============================================
3
4This is a part of device tree bindings for S2M family multi-function devices.
5More information can be found in bindings/mfd/sec-core.txt file.
6
7The S2MPS11/13/14/15 and S2MPU02 devices provide buck and LDO regulators.
8
9To register these with regulator framework instantiate under main device node
10a sub-node named "regulators" with more sub-nodes for each regulator using the
11common regulator binding documented in:
12 - Documentation/devicetree/bindings/regulator/regulator.txt
13
14
15Names of regulators supported by different devices:
16	- LDOn
17		  - valid values for n are:
18			- S2MPS11: 1 to 38
19			- S2MPS13: 1 to 40
20			- S2MPS14: 1 to 25
21			- S2MPS15: 1 to 27
22			- S2MPU02: 1 to 28
23		  - Example: LDO1, LDO2, LDO28
24	- BUCKn
25		  - valid values for n are:
26			- S2MPS11: 1 to 10
27			- S2MPS13: 1 to 10
28			- S2MPS14: 1 to 5
29			- S2MPS15: 1 to 10
30			- S2MPU02: 1 to 7
31		  - Example: BUCK1, BUCK2, BUCK9
32Note: The 'n' in LDOn and BUCKn represents the LDO or BUCK number
33as per the datasheet of device.
34
35
36Optional properties of the nodes under "regulators" sub-node:
37 - regulator-ramp-delay: ramp delay in uV/us. May be 6250, 12500,
38   25000 (default) or 50000.
39
40   Additionally S2MPS11 supports disabling ramp delay for BUCK{2,3,4,6}
41   by setting it to <0>.
42
43   Note: On S2MPS11 some bucks share the ramp rate setting i.e. same ramp value
44   will be set for a particular group of bucks so provide the same
45   regulator-ramp-delay value for them.
46   Groups sharing ramp rate:
47    - buck{1,6},
48    - buck{3,4},
49    - buck{7,8,10}.
50
51 - samsung,ext-control-gpios: On S2MPS14 the LDO10, LDO11 and LDO12 can be
52   configured to external control over GPIO. To turn this feature on this
53   property must be added to the regulator sub-node:
54    - samsung,ext-control-gpios: GPIO specifier for one GPIO
55                                 controlling this regulator (enable/disable)
56  Example:
57	LDO12 {
58		regulator-name = "V_EMMC_2.8V";
59		regulator-min-microvolt = <2800000>;
60		regulator-max-microvolt = <2800000>;
61		samsung,ext-control-gpios = <&gpk0 2 0>;
62	};
63
64
65Example:
66
67	s2mps11_pmic@66 {
68		compatible = "samsung,s2mps11-pmic";
69		reg = <0x66>;
70
71		regulators {
72			ldo1_reg: LDO1 {
73				regulator-name = "VDD_ABB_3.3V";
74				regulator-min-microvolt = <3300000>;
75				regulator-max-microvolt = <3300000>;
76			};
77
78			ldo2_reg: LDO2 {
79				regulator-name = "VDD_ALIVE_1.1V";
80				regulator-min-microvolt = <1100000>;
81				regulator-max-microvolt = <1100000>;
82				regulator-always-on;
83			};
84
85			buck1_reg: BUCK1 {
86				regulator-name = "vdd_mif";
87				regulator-min-microvolt = <950000>;
88				regulator-max-microvolt = <1350000>;
89				regulator-always-on;
90				regulator-boot-on;
91			};
92
93			buck2_reg: BUCK2 {
94				regulator-name = "vdd_arm";
95				regulator-min-microvolt = <950000>;
96				regulator-max-microvolt = <1350000>;
97				regulator-always-on;
98				regulator-boot-on;
99				regulator-ramp-delay = <50000>;
100			};
101		};
102	};
103