mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-27 06:34:11 +08:00
8d70d68d7a
Add document describing device tree bindings for MAX14577 MFD drivers: MFD core, extcon, regulator and charger. Both MAX14577 and MAX77836 chipsets are documented. Signed-off-by: Krzysztof Kozlowski <k.kozlowski@samsung.com> Reviewed-by: Tomasz Figa <t.figa@samsung.com> Acked-by: Andrew Morton <akpm@linux-foundation.org> Signed-off-by: Lee Jones <lee.jones@linaro.org>
147 lines
3.6 KiB
Plaintext
147 lines
3.6 KiB
Plaintext
Maxim MAX14577/77836 Multi-Function Device
|
|
|
|
MAX14577 is a Multi-Function Device with Micro-USB Interface Circuit, Li+
|
|
Battery Charger and SFOUT LDO output for powering USB devices. It is
|
|
interfaced to host controller using I2C.
|
|
|
|
MAX77836 additionally contains PMIC (with two LDO regulators) and Fuel Gauge.
|
|
|
|
|
|
Required properties:
|
|
- compatible : Must be "maxim,max14577" or "maxim,max77836".
|
|
- reg : I2C slave address for the max14577 chip (0x25 for max14577/max77836)
|
|
- interrupts : IRQ line for the chip.
|
|
- interrupt-parent : The parent interrupt controller.
|
|
|
|
|
|
Required nodes:
|
|
- charger :
|
|
Node for configuring the charger driver.
|
|
Required properties:
|
|
- compatible : "maxim,max14577-charger"
|
|
or "maxim,max77836-charger"
|
|
- maxim,fast-charge-uamp : Current in uA for Fast Charge;
|
|
Valid values:
|
|
- for max14577: 90000 - 950000;
|
|
- for max77836: 45000 - 475000;
|
|
- maxim,eoc-uamp : Current in uA for End-Of-Charge mode;
|
|
Valid values:
|
|
- for max14577: 50000 - 200000;
|
|
- for max77836: 5000 - 100000;
|
|
- maxim,ovp-uvolt : OverVoltage Protection Threshold in uV;
|
|
In an overvoltage condition, INT asserts and charging
|
|
stops. Valid values:
|
|
- 6000000, 6500000, 7000000, 7500000;
|
|
- maxim,constant-uvolt : Battery Constant Voltage in uV;
|
|
Valid values:
|
|
- 4000000 - 4280000 (step by 20000);
|
|
- 4350000;
|
|
|
|
|
|
Optional nodes:
|
|
- max14577-muic/max77836-muic :
|
|
Node used only by extcon consumers.
|
|
Required properties:
|
|
- compatible : "maxim,max14577-muic" or "maxim,max77836-muic"
|
|
|
|
- regulators :
|
|
Required properties:
|
|
- compatible : "maxim,max14577-regulator"
|
|
or "maxim,max77836-regulator"
|
|
|
|
May contain a sub-node per regulator from the list below. Each
|
|
sub-node should contain the constraints and initialization information
|
|
for that regulator. See regulator.txt for a description of standard
|
|
properties for these sub-nodes.
|
|
|
|
List of valid regulator names:
|
|
- for max14577: CHARGER, SAFEOUT.
|
|
- for max77836: CHARGER, SAFEOUT, LDO1, LDO2.
|
|
|
|
The SAFEOUT is a fixed voltage regulator so there is no need to specify
|
|
voltages for it.
|
|
|
|
|
|
Example:
|
|
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
|
|
|
max14577@25 {
|
|
compatible = "maxim,max14577";
|
|
reg = <0x25>;
|
|
interrupt-parent = <&gpx1>;
|
|
interrupts = <5 IRQ_TYPE_NONE>;
|
|
|
|
muic: max14577-muic {
|
|
compatible = "maxim,max14577-muic";
|
|
};
|
|
|
|
regulators {
|
|
compatible = "maxim,max14577-regulator";
|
|
|
|
SAFEOUT {
|
|
regulator-name = "SAFEOUT";
|
|
};
|
|
CHARGER {
|
|
regulator-name = "CHARGER";
|
|
regulator-min-microamp = <90000>;
|
|
regulator-max-microamp = <950000>;
|
|
regulator-boot-on;
|
|
};
|
|
};
|
|
|
|
charger {
|
|
compatible = "maxim,max14577-charger";
|
|
|
|
maxim,constant-uvolt = <4350000>;
|
|
maxim,fast-charge-uamp = <450000>;
|
|
maxim,eoc-uamp = <50000>;
|
|
maxim,ovp-uvolt = <6500000>;
|
|
};
|
|
};
|
|
|
|
|
|
max77836@25 {
|
|
compatible = "maxim,max77836";
|
|
reg = <0x25>;
|
|
interrupt-parent = <&gpx1>;
|
|
interrupts = <5 IRQ_TYPE_NONE>;
|
|
|
|
muic: max77836-muic {
|
|
compatible = "maxim,max77836-muic";
|
|
};
|
|
|
|
regulators {
|
|
compatible = "maxim,max77836-regulator";
|
|
|
|
SAFEOUT {
|
|
regulator-name = "SAFEOUT";
|
|
};
|
|
CHARGER {
|
|
regulator-name = "CHARGER";
|
|
regulator-min-microamp = <90000>;
|
|
regulator-max-microamp = <950000>;
|
|
regulator-boot-on;
|
|
};
|
|
LDO1 {
|
|
regulator-name = "LDO1";
|
|
regulator-min-microvolt = <2700000>;
|
|
regulator-max-microvolt = <2700000>;
|
|
};
|
|
LDO2 {
|
|
regulator-name = "LDO2";
|
|
regulator-min-microvolt = <800000>;
|
|
regulator-max-microvolt = <3950000>;
|
|
};
|
|
};
|
|
|
|
charger {
|
|
compatible = "maxim,max77836-charger";
|
|
|
|
maxim,constant-uvolt = <4350000>;
|
|
maxim,fast-charge-uamp = <225000>;
|
|
maxim,eoc-uamp = <7500>;
|
|
maxim,ovp-uvolt = <6500000>;
|
|
};
|
|
};
|