Documentation/devicetree/bindings/mfd/max14577.txt

   1 Maxim MAX14577/77836 Multi-Function Device
   2
   3 MAX14577 is a Multi-Function Device with Micro-USB Interface Circuit, Li+
   4 Battery Charger and SFOUT LDO output for powering USB devices. It is
   5 interfaced to host controller using I2C.
   6
   7 MAX77836 additionally contains PMIC (with two LDO regulators) and Fuel Gauge.
   8 For the description of Fuel Gauge low SOC alert interrupt see:
   9 ../power/supply/max17040_battery.txt
  10
  11
  12 Required 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
  18 Required 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
  42 Optional 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
  66 Example:
  67
  68 #include <dt-bindings/interrupt-controller/irq.h>
  69
  70 max14577@25 {
  71         compatible = "maxim,max14577";
  72         reg = <0x25>;
  73         interrupt-parent = <&gpx1>;
  74         interrupts = <5 IRQ_TYPE_NONE>;
  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
 105 max77836@25 {
 106         compatible = "maxim,max77836";
 107         reg = <0x25>;
 108         interrupt-parent = <&gpx1>;
 109         interrupts = <5 IRQ_TYPE_NONE>;
 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 };