About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / devicetree / bindings / mfd / s2mps11.txt


Based on kernel version 4.3. Page generated on 2015-11-02 12:46 EST.

1	
2	* Samsung S2MPS11, S2MPS13, S2MPS14 and S2MPU02 Voltage and Current Regulator
3	
4	The Samsung S2MPS11 is a multi-function device which includes voltage and
5	current regulators, RTC, charger controller and other sub-blocks. It is
6	interfaced to the host controller using an I2C interface. Each sub-block is
7	addressed by the host system using different I2C slave addresses.
8	
9	Required properties:
10	- compatible: Should be "samsung,s2mps11-pmic" or "samsung,s2mps13-pmic"
11		      or "samsung,s2mps14-pmic" or "samsung,s2mpu02-pmic".
12	- reg: Specifies the I2C slave address of the pmic block. It should be 0x66.
13	
14	Optional properties:
15	- interrupt-parent: Specifies the phandle of the interrupt controller to which
16	  the interrupts from s2mps11 are delivered to.
17	- interrupts: Interrupt specifiers for interrupt sources.
18	
19	Optional nodes:
20	- clocks: s2mps11, s2mps13 and s5m8767 provide three(AP/CP/BT) buffered 32.768
21	  KHz outputs, so to register these as clocks with common clock framework
22	  instantiate a sub-node named "clocks". It uses the common clock binding
23	  documented in :
24	  [Documentation/devicetree/bindings/clock/clock-bindings.txt]
25	  The s2mps14 provides two (AP/BT) buffered 32.768 KHz outputs.
26	  - #clock-cells: should be 1.
27	
28	  - The following is the list of clocks generated by the controller. Each clock
29	    is assigned an identifier and client nodes use this identifier to specify
30	    the clock which they consume.
31	    Clock               ID           Devices
32	    ----------------------------------------------------------
33	    32KhzAP		0            S2MPS11, S2MPS13, S2MPS14, S5M8767
34	    32KhzCP		1            S2MPS11, S2MPS13, S5M8767
35	    32KhzBT		2            S2MPS11, S2MPS13, S2MPS14, S5M8767
36	
37	  - compatible: Should be one of: "samsung,s2mps11-clk", "samsung,s2mps13-clk",
38			"samsung,s2mps14-clk", "samsung,s5m8767-clk"
39	
40	- regulators: The regulators of s2mps11 that have to be instantiated should be
41	included in a sub-node named 'regulators'. Regulator nodes included in this
42	sub-node should be of the format as listed below.
43	
44		regulator_name {
45			[standard regulator constraints....];
46		};
47	
48	 regulator-ramp-delay for BUCKs = [6250/12500/25000(default)/50000] uV/us
49	
50	 BUCK[2/3/4/6] supports disabling ramp delay on hardware, so explicitly
51	 regulator-ramp-delay = <0> can be used for them to disable ramp delay.
52	 In the absence of the regulator-ramp-delay property, the default ramp
53	 delay will be used.
54	
55	NOTE: Some BUCKs share the ramp rate setting i.e. same ramp value will be set
56	for a particular group of BUCKs. So provide same regulator-ramp-delay<value>.
57	Grouping of BUCKs sharing ramp rate setting is as follow : BUCK[1, 6],
58	BUCK[3, 4], and BUCK[7, 8, 10]
59	
60	On S2MPS14 the LDO10, LDO11 and LDO12 can be configured to external control
61	over GPIO. To turn this feature on this property must be added to the regulator
62	sub-node:
63		- samsung,ext-control-gpios: GPIO specifier for one GPIO
64			controlling this regulator (enable/disable);
65	Example:
66		LDO12 {
67			regulator-name = "V_EMMC_2.8V";
68			regulator-min-microvolt = <2800000>;
69			regulator-max-microvolt = <2800000>;
70			samsung,ext-control-gpios = <&gpk0 2 0>;
71		};
72	
73	
74	The regulator constraints inside the regulator nodes use the standard regulator
75	bindings which are documented elsewhere.
76	
77	The following are the names of the regulators that the s2mps11 pmic block
78	supports. Note: The 'n' in LDOn and BUCKn represents the LDO or BUCK number
79	as per the datasheet of s2mps11.
80	
81		- LDOn
82			  - valid values for n are:
83				- S2MPS11: 1 to 38
84				- S2MPS13: 1 to 40
85				- S2MPS14: 1 to 25
86				- S2MPU02: 1 to 28
87			  - Example: LDO1, LDO2, LDO28
88		- BUCKn
89			  - valid values for n are:
90				- S2MPS11: 1 to 10
91				- S2MPS13: 1 to 10
92				- S2MPS14: 1 to 5
93				- S2MPU02: 1 to 7
94			  - Example: BUCK1, BUCK2, BUCK9
95	
96	Example:
97	
98		s2mps11_pmic@66 {
99			compatible = "samsung,s2mps11-pmic";
100			reg = <0x66>;
101	
102			s2m_osc: clocks {
103				compatible = "samsung,s2mps11-clk";
104				#clock-cells = <1>;
105				clock-output-names = "xx", "yy", "zz";
106			};
107	
108			regulators {
109				ldo1_reg: LDO1 {
110					regulator-name = "VDD_ABB_3.3V";
111					regulator-min-microvolt = <3300000>;
112					regulator-max-microvolt = <3300000>;
113				};
114	
115				ldo2_reg: LDO2 {
116					regulator-name = "VDD_ALIVE_1.1V";
117					regulator-min-microvolt = <1100000>;
118					regulator-max-microvolt = <1100000>;
119					regulator-always-on;
120				};
121	
122				buck1_reg: BUCK1 {
123					regulator-name = "vdd_mif";
124					regulator-min-microvolt = <950000>;
125					regulator-max-microvolt = <1350000>;
126					regulator-always-on;
127					regulator-boot-on;
128				};
129	
130				buck2_reg: BUCK2 {
131					regulator-name = "vdd_arm";
132					regulator-min-microvolt = <950000>;
133					regulator-max-microvolt = <1350000>;
134					regulator-always-on;
135					regulator-boot-on;
136					regulator-ramp-delay = <50000>;
137				};
138			};
139		};
Hide Line Numbers


About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog