mfd: axp20x: Add bindings for AXP806 PMIC
[deliverable/linux.git] / Documentation / devicetree / bindings / mfd / axp20x.txt
CommitLineData
768a87c8 1AXP family PMIC device tree bindings
cf1d5439
CC
2
3The axp20x family current members :
13e72a49 4axp152 (X-Powers)
cf1d5439
CC
5axp202 (X-Powers)
6axp209 (X-Powers)
768a87c8 7axp221 (X-Powers)
6f89fa9e 8axp223 (X-Powers)
bd425113 9axp809 (X-Powers)
cf1d5439
CC
10
11Required properties:
13e72a49 12- compatible: "x-powers,axp152", "x-powers,axp202", "x-powers,axp209",
f7b12b26
CYT
13 "x-powers,axp221", "x-powers,axp223", "x-powers,axp806",
14 "x-powers,axp809"
6f89fa9e 15- reg: The I2C slave address or RSB hardware address for the AXP chip
cf1d5439
CC
16- interrupt-parent: The parent interrupt controller
17- interrupts: SoC NMI / GPIO interrupt connected to the PMIC's IRQ pin
768a87c8 18- interrupt-controller: The PMIC has its own internal IRQs
cf1d5439
CC
19- #interrupt-cells: Should be set to 1
20
21Optional properties:
22- x-powers,dcdc-freq: defines the work frequency of DC-DC in KHz
bd425113
CYT
23 AXP152/20X: range: 750-1875, Default: 1.5 MHz
24 AXP22X/80X: range: 1800-4050, Default: 3 MHz
25
636e2a39
HG
26- x-powers,drive-vbus-en: axp221 / axp223 only boolean, set this when the
27 N_VBUSEN pin is used as an output pin to control an external
28 regulator to drive the OTG VBus, rather then as an input pin
29 which signals whether the board is driving OTG VBus or not.
30
cf1d5439
CC
31- <input>-supply: a phandle to the regulator supply node. May be omitted if
32 inputs are unregulated, such as using the IPSOUT output
33 from the PMIC.
34
35- regulators: A node that houses a sub-node for each regulator. Regulators
36 not used but preferred to be managed by the OS should be
37 listed as well.
38 See Documentation/devicetree/bindings/regulator/regulator.txt
39 for more information on standard regulator bindings.
40
41Optional properties for DCDC regulators:
42- x-powers,dcdc-workmode: 1 for PWM mode, 0 for AUTO (PWM/PFM) mode
43 Default: Current hardware setting
44 The DCDC regulators work in a mixed PWM/PFM mode,
45 using PFM under light loads and switching to PWM
46 for heavier loads. Forcing PWM mode trades efficiency
47 under light loads for lower output noise. This
48 probably makes sense for HiFi audio related
49 applications that aren't battery constrained.
50
cf1d5439
CC
51AXP202/AXP209 regulators, type, and corresponding input supply names:
52
53Regulator Type Supply Name Notes
54--------- ---- ----------- -----
55DCDC2 : DC-DC buck : vin2-supply
56DCDC3 : DC-DC buck : vin3-supply
57LDO1 : LDO : acin-supply : always on
58LDO2 : LDO : ldo24in-supply : shared supply
59LDO3 : LDO : ldo3in-supply
60LDO4 : LDO : ldo24in-supply : shared supply
61LDO5 : LDO : ldo5in-supply
62
6f89fa9e 63AXP221/AXP223 regulators, type, and corresponding input supply names:
97ba5ac1
CYT
64
65Regulator Type Supply Name Notes
66--------- ---- ----------- -----
67DCDC1 : DC-DC buck : vin1-supply
68DCDC2 : DC-DC buck : vin2-supply
69DCDC3 : DC-DC buck : vin3-supply
70DCDC4 : DC-DC buck : vin4-supply
71DCDC5 : DC-DC buck : vin5-supply
8a29f6c3
CYT
72DC1SW : On/Off Switch : : DCDC1 secondary output
73DC5LDO : LDO : : input from DCDC5
97ba5ac1
CYT
74ALDO1 : LDO : aldoin-supply : shared supply
75ALDO2 : LDO : aldoin-supply : shared supply
76ALDO3 : LDO : aldoin-supply : shared supply
77DLDO1 : LDO : dldoin-supply : shared supply
78DLDO2 : LDO : dldoin-supply : shared supply
79DLDO3 : LDO : dldoin-supply : shared supply
80DLDO4 : LDO : dldoin-supply : shared supply
81ELDO1 : LDO : eldoin-supply : shared supply
82ELDO2 : LDO : eldoin-supply : shared supply
83ELDO3 : LDO : eldoin-supply : shared supply
84LDO_IO0 : LDO : ips-supply : GPIO 0
85LDO_IO1 : LDO : ips-supply : GPIO 1
86RTC_LDO : LDO : ips-supply : always on
636e2a39 87DRIVEVBUS : Enable output : drivevbus-supply : external regulator
97ba5ac1 88
f7b12b26
CYT
89AXP806 regulators, type, and corresponding input supply names:
90
91Regulator Type Supply Name Notes
92--------- ---- ----------- -----
93DCDCA : DC-DC buck : vina-supply : poly-phase capable
94DCDCB : DC-DC buck : vinb-supply : poly-phase capable
95DCDCC : DC-DC buck : vinc-supply : poly-phase capable
96DCDCD : DC-DC buck : vind-supply : poly-phase capable
97DCDCE : DC-DC buck : vine-supply : poly-phase capable
98ALDO1 : LDO : aldoin-supply : shared supply
99ALDO2 : LDO : aldoin-supply : shared supply
100ALDO3 : LDO : aldoin-supply : shared supply
101BLDO1 : LDO : bldoin-supply : shared supply
102BLDO2 : LDO : bldoin-supply : shared supply
103BLDO3 : LDO : bldoin-supply : shared supply
104BLDO4 : LDO : bldoin-supply : shared supply
105CLDO1 : LDO : cldoin-supply : shared supply
106CLDO2 : LDO : cldoin-supply : shared supply
107CLDO3 : LDO : cldoin-supply : shared supply
108SW : On/Off Switch : swin-supply
109
110Additionally, the AXP806 DC-DC regulators support poly-phase arrangements
111for higher output current. The possible groupings are: A+B, A+B+C, D+E.
112
bd425113
CYT
113AXP809 regulators, type, and corresponding input supply names:
114
115Regulator Type Supply Name Notes
116--------- ---- ----------- -----
117DCDC1 : DC-DC buck : vin1-supply
118DCDC2 : DC-DC buck : vin2-supply
119DCDC3 : DC-DC buck : vin3-supply
120DCDC4 : DC-DC buck : vin4-supply
121DCDC5 : DC-DC buck : vin5-supply
122DC1SW : On/Off Switch : : DCDC1 secondary output
123DC5LDO : LDO : : input from DCDC5
124ALDO1 : LDO : aldoin-supply : shared supply
125ALDO2 : LDO : aldoin-supply : shared supply
126ALDO3 : LDO : aldoin-supply : shared supply
127DLDO1 : LDO : dldoin-supply : shared supply
128DLDO2 : LDO : dldoin-supply : shared supply
129ELDO1 : LDO : eldoin-supply : shared supply
130ELDO2 : LDO : eldoin-supply : shared supply
131ELDO3 : LDO : eldoin-supply : shared supply
132LDO_IO0 : LDO : ips-supply : GPIO 0
133LDO_IO1 : LDO : ips-supply : GPIO 1
134RTC_LDO : LDO : ips-supply : always on
135SW : On/Off Switch : swin-supply
136
cf1d5439
CC
137Example:
138
139axp209: pmic@34 {
140 compatible = "x-powers,axp209";
141 reg = <0x34>;
142 interrupt-parent = <&nmi_intc>;
143 interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
144 interrupt-controller;
145 #interrupt-cells = <1>;
146
147 regulators {
148 x-powers,dcdc-freq = <1500>;
149
150 vdd_cpu: dcdc2 {
151 regulator-always-on;
152 regulator-min-microvolt = <1000000>;
153 regulator-max-microvolt = <1450000>;
154 regulator-name = "vdd-cpu";
155 };
156
157 vdd_int_dll: dcdc3 {
158 regulator-always-on;
159 regulator-min-microvolt = <1000000>;
160 regulator-max-microvolt = <1400000>;
161 regulator-name = "vdd-int-dll";
162 };
163
164 vdd_rtc: ldo1 {
165 regulator-always-on;
166 regulator-min-microvolt = <1200000>;
167 regulator-max-microvolt = <1400000>;
168 regulator-name = "vdd-rtc";
169 };
170
171 avcc: ldo2 {
172 regulator-always-on;
173 regulator-min-microvolt = <2700000>;
174 regulator-max-microvolt = <3300000>;
175 regulator-name = "avcc";
176 };
177
178 ldo3 {
179 /* unused but preferred to be managed by OS */
180 };
181 };
182};
This page took 0.073847 seconds and 5 git commands to generate.