8163fbd971
Interrupt line can be configured on different hardware in different way, even inverted. Therefore driver should not enforce specific trigger type - edge falling - but instead rely on Devicetree to configure it. The Maxim 14577/77836 datasheets describe the interrupt line as active low with a requirement of acknowledge from the CPU therefore the edge falling is not correct. The interrupt line is shared between PMIC and charger driver, so using level sensitive interrupt is here especially important to avoid races. With an edge configuration in case if first PMIC signals interrupt followed shortly after by the RTC, the interrupt might not be yet cleared/acked thus the second one would not be noticed. Signed-off-by: Krzysztof Kozlowski <krzk@kernel.org> Acked-by: Rob Herring <robh@kernel.org> Signed-off-by: Lee Jones <lee.jones@linaro.org> Link: https://lore.kernel.org/r/20210602110445.33536-4-krzysztof.kozlowski@canonical.com
148 lines
3.6 KiB
Plaintext
148 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.
|
|
For the description of Fuel Gauge low SOC alert interrupt see:
|
|
../power/supply/max17040_battery.txt
|
|
|
|
|
|
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.
|
|
|
|
|
|
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_LEVEL_LOW>;
|
|
|
|
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_LEVEL_LOW>;
|
|
|
|
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>;
|
|
};
|
|
};
|