mirror of
https://github.com/torvalds/linux.git
synced 2024-12-28 13:51:44 +00:00
eb51c6eb97
In the past, there have been words on various lists that if LDO3 is disabled in u-boot, but enabled in the DTS, the axp209 driver would fail to continue/hang. Several enable/disable patches have been issues to devicetree's in both the kernel and u-boot to address this issue. What really happened however, was that the AXP209 shuts down without a notice and without setting an interrupt. This is caused when LDO3 gets overloaded, for example with large capacitors on the LDO3 output. Normally, we would expect that AXP209 would source 200 mA as per datasheet and set and trigger an interrupt when being overloaded. For some reason however, this does not happen. As a work-around, implement software-based 'regulator-soft-start' property for AXP209 LDO3 regulator, which is used to first bring up the LDO3 to the lowest possible voltage and then enable the LDO. After that, we can set the requested voltage as usual. Combining this setting with the regulator-ramp-delay allows LDO3 to come up slowly and staggered, potentially reducing overall inrush current. Signed-off-by: Olliver Schinagl <oliver@schinagl.nl> Signed-off-by: Priit Laes <plaes@plaes.org> Signed-off-by: Mark Brown <broonie@kernel.org>
272 lines
9.8 KiB
Plaintext
272 lines
9.8 KiB
Plaintext
AXP family PMIC device tree bindings
|
|
|
|
The axp20x family current members :
|
|
axp152 (X-Powers)
|
|
axp202 (X-Powers)
|
|
axp209 (X-Powers)
|
|
axp221 (X-Powers)
|
|
axp223 (X-Powers)
|
|
axp803 (X-Powers)
|
|
axp806 (X-Powers)
|
|
axp809 (X-Powers)
|
|
axp813 (X-Powers)
|
|
|
|
The AXP813 is 2 chips packaged into 1. The 2 chips do not share anything
|
|
other than the packaging. Pins are routed separately. As such they should
|
|
be treated as separate entities. The other half is an AC100 RTC/codec
|
|
combo chip. Please see ./ac100.txt for its bindings.
|
|
|
|
Required properties:
|
|
- compatible: should be one of:
|
|
* "x-powers,axp152"
|
|
* "x-powers,axp202"
|
|
* "x-powers,axp209"
|
|
* "x-powers,axp221"
|
|
* "x-powers,axp223"
|
|
* "x-powers,axp803"
|
|
* "x-powers,axp806"
|
|
* "x-powers,axp809"
|
|
* "x-powers,axp813"
|
|
- reg: The I2C slave address or RSB hardware address for the AXP chip
|
|
- interrupts: SoC NMI / GPIO interrupt connected to the PMIC's IRQ pin
|
|
- interrupt-controller: The PMIC has its own internal IRQs
|
|
- #interrupt-cells: Should be set to 1
|
|
|
|
Supported common regulator properties, see ../regulator/regulator.txt for
|
|
more information:
|
|
- regulator-ramp-delay: sets the ramp up delay in uV/us
|
|
AXP20x/DCDC2: 1600, 800
|
|
AXP20x/LDO3: 1600, 800
|
|
- regulator-soft-start: enable the output at the lowest possible voltage and
|
|
only then set the desired voltage
|
|
AXP20x/LDO3: software-based implementation
|
|
|
|
Optional properties:
|
|
- x-powers,dcdc-freq: defines the work frequency of DC-DC in KHz
|
|
AXP152/20X: range: 750-1875, Default: 1.5 MHz
|
|
AXP22X/8XX: range: 1800-4050, Default: 3 MHz
|
|
|
|
- x-powers,drive-vbus-en: boolean, set this when the N_VBUSEN pin is
|
|
used as an output pin to control an external
|
|
regulator to drive the OTG VBus, rather then
|
|
as an input pin which signals whether the
|
|
board is driving OTG VBus or not.
|
|
(axp221 / axp223 / axp803/ axp813 only)
|
|
|
|
- x-powers,self-working-mode and
|
|
x-powers,master-mode: Boolean (axp806 only). Set either of these when the
|
|
PMIC is wired for self-working mode or master mode.
|
|
If neither is set then slave mode is assumed.
|
|
This corresponds to how the MODESET pin is wired.
|
|
|
|
- <input>-supply: a phandle to the regulator supply node. May be omitted if
|
|
inputs are unregulated, such as using the IPSOUT output
|
|
from the PMIC.
|
|
|
|
- regulators: A node that houses a sub-node for each regulator. Regulators
|
|
not used but preferred to be managed by the OS should be
|
|
listed as well.
|
|
See Documentation/devicetree/bindings/regulator/regulator.txt
|
|
for more information on standard regulator bindings.
|
|
|
|
Optional properties for DCDC regulators:
|
|
- x-powers,dcdc-workmode: 1 for PWM mode, 0 for AUTO (PWM/PFM) mode
|
|
Default: Current hardware setting
|
|
The DCDC regulators work in a mixed PWM/PFM mode,
|
|
using PFM under light loads and switching to PWM
|
|
for heavier loads. Forcing PWM mode trades efficiency
|
|
under light loads for lower output noise. This
|
|
probably makes sense for HiFi audio related
|
|
applications that aren't battery constrained.
|
|
|
|
AXP202/AXP209 regulators, type, and corresponding input supply names:
|
|
|
|
Regulator Type Supply Name Notes
|
|
--------- ---- ----------- -----
|
|
DCDC2 : DC-DC buck : vin2-supply
|
|
DCDC3 : DC-DC buck : vin3-supply
|
|
LDO1 : LDO : acin-supply : always on
|
|
LDO2 : LDO : ldo24in-supply : shared supply
|
|
LDO3 : LDO : ldo3in-supply
|
|
LDO4 : LDO : ldo24in-supply : shared supply
|
|
LDO5 : LDO : ldo5in-supply
|
|
|
|
AXP221/AXP223 regulators, type, and corresponding input supply names:
|
|
|
|
Regulator Type Supply Name Notes
|
|
--------- ---- ----------- -----
|
|
DCDC1 : DC-DC buck : vin1-supply
|
|
DCDC2 : DC-DC buck : vin2-supply
|
|
DCDC3 : DC-DC buck : vin3-supply
|
|
DCDC4 : DC-DC buck : vin4-supply
|
|
DCDC5 : DC-DC buck : vin5-supply
|
|
DC1SW : On/Off Switch : : DCDC1 secondary output
|
|
DC5LDO : LDO : : input from DCDC5
|
|
ALDO1 : LDO : aldoin-supply : shared supply
|
|
ALDO2 : LDO : aldoin-supply : shared supply
|
|
ALDO3 : LDO : aldoin-supply : shared supply
|
|
DLDO1 : LDO : dldoin-supply : shared supply
|
|
DLDO2 : LDO : dldoin-supply : shared supply
|
|
DLDO3 : LDO : dldoin-supply : shared supply
|
|
DLDO4 : LDO : dldoin-supply : shared supply
|
|
ELDO1 : LDO : eldoin-supply : shared supply
|
|
ELDO2 : LDO : eldoin-supply : shared supply
|
|
ELDO3 : LDO : eldoin-supply : shared supply
|
|
LDO_IO0 : LDO : ips-supply : GPIO 0
|
|
LDO_IO1 : LDO : ips-supply : GPIO 1
|
|
RTC_LDO : LDO : ips-supply : always on
|
|
DRIVEVBUS : Enable output : drivevbus-supply : external regulator
|
|
|
|
AXP803 regulators, type, and corresponding input supply names:
|
|
|
|
Regulator Type Supply Name Notes
|
|
--------- ---- ----------- -----
|
|
DCDC1 : DC-DC buck : vin1-supply
|
|
DCDC2 : DC-DC buck : vin2-supply : poly-phase capable
|
|
DCDC3 : DC-DC buck : vin3-supply : poly-phase capable
|
|
DCDC4 : DC-DC buck : vin4-supply
|
|
DCDC5 : DC-DC buck : vin5-supply : poly-phase capable
|
|
DCDC6 : DC-DC buck : vin6-supply : poly-phase capable
|
|
DC1SW : On/Off Switch : : DCDC1 secondary output
|
|
ALDO1 : LDO : aldoin-supply : shared supply
|
|
ALDO2 : LDO : aldoin-supply : shared supply
|
|
ALDO3 : LDO : aldoin-supply : shared supply
|
|
DLDO1 : LDO : dldoin-supply : shared supply
|
|
DLDO2 : LDO : dldoin-supply : shared supply
|
|
DLDO3 : LDO : dldoin-supply : shared supply
|
|
DLDO4 : LDO : dldoin-supply : shared supply
|
|
ELDO1 : LDO : eldoin-supply : shared supply
|
|
ELDO2 : LDO : eldoin-supply : shared supply
|
|
ELDO3 : LDO : eldoin-supply : shared supply
|
|
FLDO1 : LDO : fldoin-supply : shared supply
|
|
FLDO2 : LDO : fldoin-supply : shared supply
|
|
LDO_IO0 : LDO : ips-supply : GPIO 0
|
|
LDO_IO1 : LDO : ips-supply : GPIO 1
|
|
RTC_LDO : LDO : ips-supply : always on
|
|
DRIVEVBUS : Enable output : drivevbus-supply : external regulator
|
|
|
|
AXP806 regulators, type, and corresponding input supply names:
|
|
|
|
Regulator Type Supply Name Notes
|
|
--------- ---- ----------- -----
|
|
DCDCA : DC-DC buck : vina-supply : poly-phase capable
|
|
DCDCB : DC-DC buck : vinb-supply : poly-phase capable
|
|
DCDCC : DC-DC buck : vinc-supply : poly-phase capable
|
|
DCDCD : DC-DC buck : vind-supply : poly-phase capable
|
|
DCDCE : DC-DC buck : vine-supply : poly-phase capable
|
|
ALDO1 : LDO : aldoin-supply : shared supply
|
|
ALDO2 : LDO : aldoin-supply : shared supply
|
|
ALDO3 : LDO : aldoin-supply : shared supply
|
|
BLDO1 : LDO : bldoin-supply : shared supply
|
|
BLDO2 : LDO : bldoin-supply : shared supply
|
|
BLDO3 : LDO : bldoin-supply : shared supply
|
|
BLDO4 : LDO : bldoin-supply : shared supply
|
|
CLDO1 : LDO : cldoin-supply : shared supply
|
|
CLDO2 : LDO : cldoin-supply : shared supply
|
|
CLDO3 : LDO : cldoin-supply : shared supply
|
|
SW : On/Off Switch : swin-supply
|
|
|
|
Additionally, the AXP806 DC-DC regulators support poly-phase arrangements
|
|
for higher output current. The possible groupings are: A+B, A+B+C, D+E.
|
|
|
|
AXP809 regulators, type, and corresponding input supply names:
|
|
|
|
Regulator Type Supply Name Notes
|
|
--------- ---- ----------- -----
|
|
DCDC1 : DC-DC buck : vin1-supply
|
|
DCDC2 : DC-DC buck : vin2-supply
|
|
DCDC3 : DC-DC buck : vin3-supply
|
|
DCDC4 : DC-DC buck : vin4-supply
|
|
DCDC5 : DC-DC buck : vin5-supply
|
|
DC1SW : On/Off Switch : : DCDC1 secondary output
|
|
DC5LDO : LDO : : input from DCDC5
|
|
ALDO1 : LDO : aldoin-supply : shared supply
|
|
ALDO2 : LDO : aldoin-supply : shared supply
|
|
ALDO3 : LDO : aldoin-supply : shared supply
|
|
DLDO1 : LDO : dldoin-supply : shared supply
|
|
DLDO2 : LDO : dldoin-supply : shared supply
|
|
ELDO1 : LDO : eldoin-supply : shared supply
|
|
ELDO2 : LDO : eldoin-supply : shared supply
|
|
ELDO3 : LDO : eldoin-supply : shared supply
|
|
LDO_IO0 : LDO : ips-supply : GPIO 0
|
|
LDO_IO1 : LDO : ips-supply : GPIO 1
|
|
RTC_LDO : LDO : ips-supply : always on
|
|
SW : On/Off Switch : swin-supply
|
|
|
|
AXP813 regulators, type, and corresponding input supply names:
|
|
|
|
Regulator Type Supply Name Notes
|
|
--------- ---- ----------- -----
|
|
DCDC1 : DC-DC buck : vin1-supply
|
|
DCDC2 : DC-DC buck : vin2-supply : poly-phase capable
|
|
DCDC3 : DC-DC buck : vin3-supply : poly-phase capable
|
|
DCDC4 : DC-DC buck : vin4-supply
|
|
DCDC5 : DC-DC buck : vin5-supply : poly-phase capable
|
|
DCDC6 : DC-DC buck : vin6-supply : poly-phase capable
|
|
DCDC7 : DC-DC buck : vin7-supply
|
|
ALDO1 : LDO : aldoin-supply : shared supply
|
|
ALDO2 : LDO : aldoin-supply : shared supply
|
|
ALDO3 : LDO : aldoin-supply : shared supply
|
|
DLDO1 : LDO : dldoin-supply : shared supply
|
|
DLDO2 : LDO : dldoin-supply : shared supply
|
|
DLDO3 : LDO : dldoin-supply : shared supply
|
|
DLDO4 : LDO : dldoin-supply : shared supply
|
|
ELDO1 : LDO : eldoin-supply : shared supply
|
|
ELDO2 : LDO : eldoin-supply : shared supply
|
|
ELDO3 : LDO : eldoin-supply : shared supply
|
|
FLDO1 : LDO : fldoin-supply : shared supply
|
|
FLDO2 : LDO : fldoin-supply : shared supply
|
|
FLDO3 : LDO : fldoin-supply : shared supply
|
|
LDO_IO0 : LDO : ips-supply : GPIO 0
|
|
LDO_IO1 : LDO : ips-supply : GPIO 1
|
|
RTC_LDO : LDO : ips-supply : always on
|
|
SW : On/Off Switch : swin-supply
|
|
DRIVEVBUS : Enable output : drivevbus-supply : external regulator
|
|
|
|
Example:
|
|
|
|
axp209: pmic@34 {
|
|
compatible = "x-powers,axp209";
|
|
reg = <0x34>;
|
|
interrupt-parent = <&nmi_intc>;
|
|
interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
|
|
interrupt-controller;
|
|
#interrupt-cells = <1>;
|
|
|
|
regulators {
|
|
x-powers,dcdc-freq = <1500>;
|
|
|
|
vdd_cpu: dcdc2 {
|
|
regulator-always-on;
|
|
regulator-min-microvolt = <1000000>;
|
|
regulator-max-microvolt = <1450000>;
|
|
regulator-name = "vdd-cpu";
|
|
};
|
|
|
|
vdd_int_dll: dcdc3 {
|
|
regulator-always-on;
|
|
regulator-min-microvolt = <1000000>;
|
|
regulator-max-microvolt = <1400000>;
|
|
regulator-name = "vdd-int-dll";
|
|
};
|
|
|
|
vdd_rtc: ldo1 {
|
|
regulator-always-on;
|
|
regulator-min-microvolt = <1200000>;
|
|
regulator-max-microvolt = <1400000>;
|
|
regulator-name = "vdd-rtc";
|
|
};
|
|
|
|
avcc: ldo2 {
|
|
regulator-always-on;
|
|
regulator-min-microvolt = <2700000>;
|
|
regulator-max-microvolt = <3300000>;
|
|
regulator-name = "avcc";
|
|
};
|
|
|
|
ldo3 {
|
|
/* unused but preferred to be managed by OS */
|
|
};
|
|
};
|
|
};
|