Documentation/devicetree/bindings/mfd/axp20x.txt

   1 AXP family PMIC device tree bindings
   2
   3 The axp20x family current members :
   4 axp152 (X-Powers)
   5 axp202 (X-Powers)
   6 axp209 (X-Powers)
   7 axp221 (X-Powers)
   8 axp223 (X-Powers)
   9 axp809 (X-Powers)
  10
  11 Required properties:
  12 - compatible: "x-powers,axp152", "x-powers,axp202", "x-powers,axp209",
  13               "x-powers,axp221", "x-powers,axp223", "x-powers,axp809"
  14 - reg: The I2C slave address or RSB hardware address for the AXP chip
  15 - interrupt-parent: The parent interrupt controller
  16 - interrupts: SoC NMI / GPIO interrupt connected to the PMIC's IRQ pin
  17 - interrupt-controller: The PMIC has its own internal IRQs
  18 - #interrupt-cells: Should be set to 1
  19
  20 Optional properties:
  21 - x-powers,dcdc-freq: defines the work frequency of DC-DC in KHz
  22                       AXP152/20X: range:  750-1875, Default: 1.5 MHz
  23                       AXP22X/80X: range: 1800-4050, Default: 3   MHz
  24
  25 - <input>-supply: a phandle to the regulator supply node. May be omitted if
  26                   inputs are unregulated, such as using the IPSOUT output
  27                   from the PMIC.
  28
  29 - regulators: A node that houses a sub-node for each regulator. Regulators
  30               not used but preferred to be managed by the OS should be
  31               listed as well.
  32               See Documentation/devicetree/bindings/regulator/regulator.txt
  33               for more information on standard regulator bindings.
  34
  35 Optional properties for DCDC regulators:
  36 - x-powers,dcdc-workmode: 1 for PWM mode, 0 for AUTO (PWM/PFM) mode
  37                           Default: Current hardware setting
  38                           The DCDC regulators work in a mixed PWM/PFM mode,
  39                           using PFM under light loads and switching to PWM
  40                           for heavier loads. Forcing PWM mode trades efficiency
  41                           under light loads for lower output noise. This
  42                           probably makes sense for HiFi audio related
  43                           applications that aren't battery constrained.
  44
  45
  46 AXP202/AXP209 regulators, type, and corresponding input supply names:
  47
  48 Regulator         Type            Supply Name             Notes
  49 ---------         ----            -----------             -----
  50 DCDC2           : DC-DC buck    : vin2-supply
  51 DCDC3           : DC-DC buck    : vin3-supply
  52 LDO1            : LDO           : acin-supply           : always on
  53 LDO2            : LDO           : ldo24in-supply        : shared supply
  54 LDO3            : LDO           : ldo3in-supply
  55 LDO4            : LDO           : ldo24in-supply        : shared supply
  56 LDO5            : LDO           : ldo5in-supply
  57
  58 AXP221/AXP223 regulators, type, and corresponding input supply names:
  59
  60 Regulator         Type            Supply Name             Notes
  61 ---------         ----            -----------             -----
  62 DCDC1           : DC-DC buck    : vin1-supply
  63 DCDC2           : DC-DC buck    : vin2-supply
  64 DCDC3           : DC-DC buck    : vin3-supply
  65 DCDC4           : DC-DC buck    : vin4-supply
  66 DCDC5           : DC-DC buck    : vin5-supply
  67 DC1SW           : On/Off Switch :                       : DCDC1 secondary output
  68 DC5LDO          : LDO           :                       : input from DCDC5
  69 ALDO1           : LDO           : aldoin-supply         : shared supply
  70 ALDO2           : LDO           : aldoin-supply         : shared supply
  71 ALDO3           : LDO           : aldoin-supply         : shared supply
  72 DLDO1           : LDO           : dldoin-supply         : shared supply
  73 DLDO2           : LDO           : dldoin-supply         : shared supply
  74 DLDO3           : LDO           : dldoin-supply         : shared supply
  75 DLDO4           : LDO           : dldoin-supply         : shared supply
  76 ELDO1           : LDO           : eldoin-supply         : shared supply
  77 ELDO2           : LDO           : eldoin-supply         : shared supply
  78 ELDO3           : LDO           : eldoin-supply         : shared supply
  79 LDO_IO0         : LDO           : ips-supply            : GPIO 0
  80 LDO_IO1         : LDO           : ips-supply            : GPIO 1
  81 RTC_LDO         : LDO           : ips-supply            : always on
  82
  83 AXP809 regulators, type, and corresponding input supply names:
  84
  85 Regulator         Type            Supply Name             Notes
  86 ---------         ----            -----------             -----
  87 DCDC1           : DC-DC buck    : vin1-supply
  88 DCDC2           : DC-DC buck    : vin2-supply
  89 DCDC3           : DC-DC buck    : vin3-supply
  90 DCDC4           : DC-DC buck    : vin4-supply
  91 DCDC5           : DC-DC buck    : vin5-supply
  92 DC1SW           : On/Off Switch :                       : DCDC1 secondary output
  93 DC5LDO          : LDO           :                       : input from DCDC5
  94 ALDO1           : LDO           : aldoin-supply         : shared supply
  95 ALDO2           : LDO           : aldoin-supply         : shared supply
  96 ALDO3           : LDO           : aldoin-supply         : shared supply
  97 DLDO1           : LDO           : dldoin-supply         : shared supply
  98 DLDO2           : LDO           : dldoin-supply         : shared supply
  99 ELDO1           : LDO           : eldoin-supply         : shared supply
 100 ELDO2           : LDO           : eldoin-supply         : shared supply
 101 ELDO3           : LDO           : eldoin-supply         : shared supply
 102 LDO_IO0         : LDO           : ips-supply            : GPIO 0
 103 LDO_IO1         : LDO           : ips-supply            : GPIO 1
 104 RTC_LDO         : LDO           : ips-supply            : always on
 105 SW              : On/Off Switch : swin-supply
 106
 107 Example:
 108
 109 axp209: pmic@34 {
 110         compatible = "x-powers,axp209";
 111         reg = <0x34>;
 112         interrupt-parent = <&nmi_intc>;
 113         interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
 114         interrupt-controller;
 115         #interrupt-cells = <1>;
 116
 117         regulators {
 118                 x-powers,dcdc-freq = <1500>;
 119
 120                 vdd_cpu: dcdc2 {
 121                         regulator-always-on;
 122                         regulator-min-microvolt = <1000000>;
 123                         regulator-max-microvolt = <1450000>;
 124                         regulator-name = "vdd-cpu";
 125                 };
 126
 127                 vdd_int_dll: dcdc3 {
 128                         regulator-always-on;
 129                         regulator-min-microvolt = <1000000>;
 130                         regulator-max-microvolt = <1400000>;
 131                         regulator-name = "vdd-int-dll";
 132                 };
 133
 134                 vdd_rtc: ldo1 {
 135                         regulator-always-on;
 136                         regulator-min-microvolt = <1200000>;
 137                         regulator-max-microvolt = <1400000>;
 138                         regulator-name = "vdd-rtc";
 139                 };
 140
 141                 avcc: ldo2 {
 142                         regulator-always-on;
 143                         regulator-min-microvolt = <2700000>;
 144                         regulator-max-microvolt = <3300000>;
 145                         regulator-name = "avcc";
 146                 };
 147
 148                 ldo3 {
 149                         /* unused but preferred to be managed by OS */
 150                 };
 151         };
 152 };