xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/max14577.txt (revision af23369a6deaaeb612ab266eb88b8bb8d560c322)
1Maxim MAX14577/77836 Multi-Function Device
2
3MAX14577 is a Multi-Function Device with Micro-USB Interface Circuit, Li+
4Battery Charger and SFOUT LDO output for powering USB devices. It is
5interfaced to host controller using I2C.
6
7MAX77836 additionally contains PMIC (with two LDO regulators) and Fuel Gauge.
8For the description of Fuel Gauge low SOC alert interrupt see:
9../power/supply/max17040_battery.txt
10
11
12Required properties:
13- compatible : Must be "maxim,max14577" or "maxim,max77836".
14- reg : I2C slave address for the max14577 chip (0x25 for max14577/max77836)
15- interrupts : IRQ line for the chip.
16
17
18Required nodes:
19 - charger :
20	Node for configuring the charger driver.
21	Required properties:
22		- compatible : "maxim,max14577-charger"
23			or "maxim,max77836-charger"
24		- maxim,fast-charge-uamp : Current in uA for Fast Charge;
25			Valid values:
26			- for max14577: 90000 - 950000;
27			- for max77836: 45000 - 475000;
28		- maxim,eoc-uamp : Current in uA for End-Of-Charge mode;
29			Valid values:
30			- for max14577: 50000 - 200000;
31			- for max77836: 5000 - 100000;
32		- maxim,ovp-uvolt : OverVoltage Protection Threshold in uV;
33			In an overvoltage condition, INT asserts and charging
34			stops. Valid values:
35			- 6000000, 6500000, 7000000, 7500000;
36		- maxim,constant-uvolt : Battery Constant Voltage in uV;
37			Valid values:
38			- 4000000 - 4280000 (step by 20000);
39			- 4350000;
40
41
42Optional nodes:
43- max14577-muic/max77836-muic :
44	Node used only by extcon consumers.
45	Required properties:
46		- compatible : "maxim,max14577-muic" or "maxim,max77836-muic"
47
48- regulators :
49	Required properties:
50		- compatible : "maxim,max14577-regulator"
51			or "maxim,max77836-regulator"
52
53	May contain a sub-node per regulator from the list below. Each
54	sub-node should contain the constraints and initialization information
55	for that regulator. See regulator.txt for a description of standard
56	properties for these sub-nodes.
57
58	List of valid regulator names:
59	- for max14577: CHARGER, SAFEOUT.
60	- for max77836: CHARGER, SAFEOUT, LDO1, LDO2.
61
62	The SAFEOUT is a fixed voltage regulator so there is no need to specify
63	voltages for it.
64
65
66Example:
67
68#include <dt-bindings/interrupt-controller/irq.h>
69
70max14577@25 {
71	compatible = "maxim,max14577";
72	reg = <0x25>;
73	interrupt-parent = <&gpx1>;
74	interrupts = <5 IRQ_TYPE_LEVEL_LOW>;
75
76	muic: max14577-muic {
77		compatible = "maxim,max14577-muic";
78	};
79
80	regulators {
81		compatible = "maxim,max14577-regulator";
82
83		SAFEOUT {
84			regulator-name = "SAFEOUT";
85		};
86		CHARGER {
87			regulator-name = "CHARGER";
88			regulator-min-microamp = <90000>;
89			regulator-max-microamp = <950000>;
90			regulator-boot-on;
91		};
92	};
93
94	charger {
95		compatible = "maxim,max14577-charger";
96
97		maxim,constant-uvolt = <4350000>;
98		maxim,fast-charge-uamp = <450000>;
99		maxim,eoc-uamp = <50000>;
100		maxim,ovp-uvolt = <6500000>;
101	};
102};
103
104
105max77836@25 {
106	compatible = "maxim,max77836";
107	reg = <0x25>;
108	interrupt-parent = <&gpx1>;
109	interrupts = <5 IRQ_TYPE_LEVEL_LOW>;
110
111	muic: max77836-muic {
112		compatible = "maxim,max77836-muic";
113	};
114
115	regulators {
116		compatible = "maxim,max77836-regulator";
117
118		SAFEOUT {
119			regulator-name = "SAFEOUT";
120		};
121		CHARGER {
122			regulator-name = "CHARGER";
123			regulator-min-microamp = <90000>;
124			regulator-max-microamp = <950000>;
125			regulator-boot-on;
126		};
127		LDO1 {
128			regulator-name = "LDO1";
129			regulator-min-microvolt = <2700000>;
130			regulator-max-microvolt = <2700000>;
131		};
132		LDO2 {
133			regulator-name = "LDO2";
134			regulator-min-microvolt = <800000>;
135			regulator-max-microvolt = <3950000>;
136		};
137	};
138
139	charger {
140		compatible = "maxim,max77836-charger";
141
142		maxim,constant-uvolt = <4350000>;
143		maxim,fast-charge-uamp = <225000>;
144		maxim,eoc-uamp = <7500>;
145		maxim,ovp-uvolt = <6500000>;
146	};
147};
148