1AXP family PMIC device tree bindings
2
3The axp20x family current members :
4axp152 (X-Powers)
5axp202 (X-Powers)
6axp209 (X-Powers)
7axp221 (X-Powers)
8
9Required properties:
10- compatible: "x-powers,axp152", "x-powers,axp202", "x-powers,axp209",
11	      "x-powers,axp221"
12- reg: The I2C slave address for the AXP chip
13- interrupt-parent: The parent interrupt controller
14- interrupts: SoC NMI / GPIO interrupt connected to the PMIC's IRQ pin
15- interrupt-controller: The PMIC has its own internal IRQs
16- #interrupt-cells: Should be set to 1
17
18Optional properties:
19- x-powers,dcdc-freq: defines the work frequency of DC-DC in KHz
20		      (range: 750-1875). Default: 1.5MHz
21- <input>-supply: a phandle to the regulator supply node. May be omitted if
22		  inputs are unregulated, such as using the IPSOUT output
23		  from the PMIC.
24
25- regulators: A node that houses a sub-node for each regulator. Regulators
26	      not used but preferred to be managed by the OS should be
27	      listed as well.
28	      See Documentation/devicetree/bindings/regulator/regulator.txt
29	      for more information on standard regulator bindings.
30
31Optional properties for DCDC regulators:
32- x-powers,dcdc-workmode: 1 for PWM mode, 0 for AUTO (PWM/PFM) mode
33			  Default: Current hardware setting
34			  The DCDC regulators work in a mixed PWM/PFM mode,
35			  using PFM under light loads and switching to PWM
36			  for heavier loads. Forcing PWM mode trades efficiency
37			  under light loads for lower output noise. This
38			  probably makes sense for HiFi audio related
39			  applications that aren't battery constrained.
40
41
42AXP202/AXP209 regulators, type, and corresponding input supply names:
43
44Regulator	  Type		  Supply Name		  Notes
45---------	  ----		  -----------		  -----
46DCDC2		: DC-DC buck	: vin2-supply
47DCDC3		: DC-DC	buck	: vin3-supply
48LDO1		: LDO		: acin-supply		: always on
49LDO2		: LDO		: ldo24in-supply	: shared supply
50LDO3		: LDO		: ldo3in-supply
51LDO4		: LDO		: ldo24in-supply	: shared supply
52LDO5		: LDO		: ldo5in-supply
53
54AXP221 regulators, type, and corresponding input supply names:
55
56Regulator	  Type		  Supply Name		  Notes
57---------	  ----		  -----------		  -----
58DCDC1		: DC-DC buck	: vin1-supply
59DCDC2		: DC-DC buck	: vin2-supply
60DCDC3		: DC-DC	buck	: vin3-supply
61DCDC4		: DC-DC	buck	: vin4-supply
62DCDC5		: DC-DC	buck	: vin5-supply
63DC1SW		: On/Off Switch	:			: DCDC1 secondary output
64DC5LDO		: LDO		:			: input from DCDC5
65ALDO1		: LDO		: aldoin-supply		: shared supply
66ALDO2		: LDO		: aldoin-supply		: shared supply
67ALDO3		: LDO		: aldoin-supply		: shared supply
68DLDO1		: LDO		: dldoin-supply		: shared supply
69DLDO2		: LDO		: dldoin-supply		: shared supply
70DLDO3		: LDO		: dldoin-supply		: shared supply
71DLDO4		: LDO		: dldoin-supply		: shared supply
72ELDO1		: LDO		: eldoin-supply		: shared supply
73ELDO2		: LDO		: eldoin-supply		: shared supply
74ELDO3		: LDO		: eldoin-supply		: shared supply
75LDO_IO0		: LDO		: ips-supply		: GPIO 0
76LDO_IO1		: LDO		: ips-supply		: GPIO 1
77RTC_LDO		: LDO		: ips-supply		: always on
78
79Example:
80
81axp209: pmic@34 {
82	compatible = "x-powers,axp209";
83	reg = <0x34>;
84	interrupt-parent = <&nmi_intc>;
85	interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
86	interrupt-controller;
87	#interrupt-cells = <1>;
88
89	regulators {
90		x-powers,dcdc-freq = <1500>;
91
92		vdd_cpu: dcdc2 {
93			regulator-always-on;
94			regulator-min-microvolt = <1000000>;
95			regulator-max-microvolt = <1450000>;
96			regulator-name = "vdd-cpu";
97		};
98
99		vdd_int_dll: dcdc3 {
100			regulator-always-on;
101			regulator-min-microvolt = <1000000>;
102			regulator-max-microvolt = <1400000>;
103			regulator-name = "vdd-int-dll";
104		};
105
106		vdd_rtc: ldo1 {
107			regulator-always-on;
108			regulator-min-microvolt = <1200000>;
109			regulator-max-microvolt = <1400000>;
110			regulator-name = "vdd-rtc";
111		};
112
113		avcc: ldo2 {
114			regulator-always-on;
115			regulator-min-microvolt = <2700000>;
116			regulator-max-microvolt = <3300000>;
117			regulator-name = "avcc";
118		};
119
120		ldo3 {
121			/* unused but preferred to be managed by OS */
122		};
123	};
124};
125