1Binding for Maxim MAX77802 regulators
2
3This is a part of device tree bindings of MAX77802 multi-function device.
4More information can be found in bindings/mfd/max77802.txt file.
5
6The MAX77802 PMIC has 10 high-efficiency Buck and 32 Low-dropout (LDO)
7regulators that can be controlled over I2C.
8
9Following properties should be present in main device node of the MFD chip.
10
11Optional node:
12- regulators : The regulators of max77802 have to be instantiated
13  under subnode named "regulators" using the following format.
14
15	regulator-name {
16		standard regulator constraints....
17	};
18	refer Documentation/devicetree/bindings/regulator/regulator.txt
19
20The regulator node name should be initialized with a string to get matched
21with their hardware counterparts as follow. The valid names are:
22
23	-LDOn 	:	for LDOs, where n can lie in ranges 1-15, 17-21, 23-30
24			and 32-35.
25			example: LDO1, LDO2, LDO35.
26	-BUCKn 	:	for BUCKs, where n can lie in range 1 to 10.
27			example: BUCK1, BUCK5, BUCK10.
28
29The max77802 regulator supports two different operating modes: Normal and Low
30Power Mode. Some regulators support the modes to be changed at startup or by
31the consumers during normal operation while others only support to change the
32mode during system suspend. The standard regulator suspend states binding can
33be used to configure the regulator operating mode.
34
35The regulators that support the standard "regulator-initial-mode" property,
36changing their mode during normal operation are: LDOs 1, 3, 20 and 21.
37
38The possible values for "regulator-initial-mode" and "regulator-mode" are:
39	1: Normal regulator voltage output mode.
40	3: Low Power which reduces the quiescent current down to only 1uA
41
42The list of valid modes are defined in the dt-bindings/clock/maxim,max77802.h
43header and can be included by device tree source files.
44
45The standard "regulator-mode" property can only be used for regulators that
46support changing their mode to Low Power Mode during suspend. These regulators
47are: BUCKs 2-4 and LDOs 1-35. Also, it only takes effect if the regulator has
48been enabled for the given suspend state using "regulator-on-in-suspend" and
49has not been disabled for that state using "regulator-off-in-suspend".
50
51Example:
52
53	max77802@09 {
54		compatible = "maxim,max77802";
55		interrupt-parent = <&wakeup_eint>;
56		interrupts = <26 0>;
57		reg = <0x09>;
58		#address-cells = <1>;
59		#size-cells = <0>;
60
61		regulators {
62			ldo1_reg: LDO1 {
63				regulator-name = "vdd_1v0";
64				regulator-min-microvolt = <1000000>;
65				regulator-max-microvolt = <1000000>;
66				regulator-always-on;
67				regulator-initial-mode = <MAX77802_OPMODE_LP>;
68			};
69
70			ldo11_reg: LDO11 {
71				regulator-name = "vdd_ldo11";
72				regulator-min-microvolt = <1900000>;
73				regulator-max-microvolt = <1900000>;
74				regulator-always-on;
75				regulator-state-mem {
76					regulator-on-in-suspend;
77					regulator-mode = <MAX77802_OPMODE_LP>;
78				};
79			};
80
81			buck1_reg: BUCK1 {
82				regulator-name = "vdd_mif";
83				regulator-min-microvolt = <950000>;
84				regulator-max-microvolt = <1300000>;
85				regulator-always-on;
86				regulator-boot-on;
87			};
88	};
89