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 axp803 (X-Powers)
  10 axp806 (X-Powers)
  11 axp809 (X-Powers)
  12 axp813 (X-Powers)
  13
  14 The AXP813 is 2 chips packaged into 1. The 2 chips do not share anything
  15 other than the packaging. Pins are routed separately. As such they should
  16 be treated as separate entities. The other half is an AC100 RTC/codec
  17 combo chip. Please see ./ac100.txt for its bindings.
  18
  19 Required properties:
  20 - compatible: should be one of:
  21     * "x-powers,axp152"
  22     * "x-powers,axp202"
  23     * "x-powers,axp209"
  24     * "x-powers,axp221"
  25     * "x-powers,axp223"
  26     * "x-powers,axp803"
  27     * "x-powers,axp806"
  28     * "x-powers,axp809"
  29     * "x-powers,axp813"
  30 - reg: The I2C slave address or RSB hardware address for the AXP chip
  31 - interrupts: SoC NMI / GPIO interrupt connected to the PMIC's IRQ pin
  32 - interrupt-controller: The PMIC has its own internal IRQs
  33 - #interrupt-cells: Should be set to 1
  34
  35 Optional properties:
  36 - x-powers,dcdc-freq: defines the work frequency of DC-DC in KHz
  37                       AXP152/20X: range:  750-1875, Default: 1.5 MHz
  38                       AXP22X/8XX: range: 1800-4050, Default: 3   MHz
  39
  40 - x-powers,drive-vbus-en: boolean, set this when the N_VBUSEN pin is
  41                           used as an output pin to control an external
  42                           regulator to drive the OTG VBus, rather then
  43                           as an input pin which signals whether the
  44                           board is driving OTG VBus or not.
  45                           (axp221 / axp223 / axp803/ axp813 only)
  46
  47 - x-powers,master-mode: Boolean (axp806 only). Set this when the PMIC is
  48                         wired for master mode. The default is slave mode.
  49
  50 - <input>-supply: a phandle to the regulator supply node. May be omitted if
  51                   inputs are unregulated, such as using the IPSOUT output
  52                   from the PMIC.
  53
  54 - regulators: A node that houses a sub-node for each regulator. Regulators
  55               not used but preferred to be managed by the OS should be
  56               listed as well.
  57               See Documentation/devicetree/bindings/regulator/regulator.txt
  58               for more information on standard regulator bindings.
  59
  60 Optional properties for DCDC regulators:
  61 - x-powers,dcdc-workmode: 1 for PWM mode, 0 for AUTO (PWM/PFM) mode
  62                           Default: Current hardware setting
  63                           The DCDC regulators work in a mixed PWM/PFM mode,
  64                           using PFM under light loads and switching to PWM
  65                           for heavier loads. Forcing PWM mode trades efficiency
  66                           under light loads for lower output noise. This
  67                           probably makes sense for HiFi audio related
  68                           applications that aren't battery constrained.
  69
  70 AXP202/AXP209 regulators, type, and corresponding input supply names:
  71
  72 Regulator         Type            Supply Name             Notes
  73 ---------         ----            -----------             -----
  74 DCDC2           : DC-DC buck    : vin2-supply
  75 DCDC3           : DC-DC buck    : vin3-supply
  76 LDO1            : LDO           : acin-supply           : always on
  77 LDO2            : LDO           : ldo24in-supply        : shared supply
  78 LDO3            : LDO           : ldo3in-supply
  79 LDO4            : LDO           : ldo24in-supply        : shared supply
  80 LDO5            : LDO           : ldo5in-supply
  81
  82 AXP221/AXP223 regulators, type, and corresponding input supply names:
  83
  84 Regulator         Type            Supply Name             Notes
  85 ---------         ----            -----------             -----
  86 DCDC1           : DC-DC buck    : vin1-supply
  87 DCDC2           : DC-DC buck    : vin2-supply
  88 DCDC3           : DC-DC buck    : vin3-supply
  89 DCDC4           : DC-DC buck    : vin4-supply
  90 DCDC5           : DC-DC buck    : vin5-supply
  91 DC1SW           : On/Off Switch :                       : DCDC1 secondary output
  92 DC5LDO          : LDO           :                       : input from DCDC5
  93 ALDO1           : LDO           : aldoin-supply         : shared supply
  94 ALDO2           : LDO           : aldoin-supply         : shared supply
  95 ALDO3           : LDO           : aldoin-supply         : shared supply
  96 DLDO1           : LDO           : dldoin-supply         : shared supply
  97 DLDO2           : LDO           : dldoin-supply         : shared supply
  98 DLDO3           : LDO           : dldoin-supply         : shared supply
  99 DLDO4           : LDO           : dldoin-supply         : shared supply
 100 ELDO1           : LDO           : eldoin-supply         : shared supply
 101 ELDO2           : LDO           : eldoin-supply         : shared supply
 102 ELDO3           : LDO           : eldoin-supply         : shared supply
 103 LDO_IO0         : LDO           : ips-supply            : GPIO 0
 104 LDO_IO1         : LDO           : ips-supply            : GPIO 1
 105 RTC_LDO         : LDO           : ips-supply            : always on
 106 DRIVEVBUS       : Enable output : drivevbus-supply      : external regulator
 107
 108 AXP803 regulators, type, and corresponding input supply names:
 109
 110 Regulator         Type            Supply Name             Notes
 111 ---------         ----            -----------             -----
 112 DCDC1           : DC-DC buck    : vin1-supply
 113 DCDC2           : DC-DC buck    : vin2-supply           : poly-phase capable
 114 DCDC3           : DC-DC buck    : vin3-supply           : poly-phase capable
 115 DCDC4           : DC-DC buck    : vin4-supply
 116 DCDC5           : DC-DC buck    : vin5-supply           : poly-phase capable
 117 DCDC6           : DC-DC buck    : vin6-supply           : poly-phase capable
 118 DC1SW           : On/Off Switch :                       : DCDC1 secondary output
 119 ALDO1           : LDO           : aldoin-supply         : shared supply
 120 ALDO2           : LDO           : aldoin-supply         : shared supply
 121 ALDO3           : LDO           : aldoin-supply         : shared supply
 122 DLDO1           : LDO           : dldoin-supply         : shared supply
 123 DLDO2           : LDO           : dldoin-supply         : shared supply
 124 DLDO3           : LDO           : dldoin-supply         : shared supply
 125 DLDO4           : LDO           : dldoin-supply         : shared supply
 126 ELDO1           : LDO           : eldoin-supply         : shared supply
 127 ELDO2           : LDO           : eldoin-supply         : shared supply
 128 ELDO3           : LDO           : eldoin-supply         : shared supply
 129 FLDO1           : LDO           : fldoin-supply         : shared supply
 130 FLDO2           : LDO           : fldoin-supply         : shared supply
 131 LDO_IO0         : LDO           : ips-supply            : GPIO 0
 132 LDO_IO1         : LDO           : ips-supply            : GPIO 1
 133 RTC_LDO         : LDO           : ips-supply            : always on
 134 DRIVEVBUS       : Enable output : drivevbus-supply      : external regulator
 135
 136 AXP806 regulators, type, and corresponding input supply names:
 137
 138 Regulator         Type            Supply Name             Notes
 139 ---------         ----            -----------             -----
 140 DCDCA           : DC-DC buck    : vina-supply           : poly-phase capable
 141 DCDCB           : DC-DC buck    : vinb-supply           : poly-phase capable
 142 DCDCC           : DC-DC buck    : vinc-supply           : poly-phase capable
 143 DCDCD           : DC-DC buck    : vind-supply           : poly-phase capable
 144 DCDCE           : DC-DC buck    : vine-supply           : poly-phase capable
 145 ALDO1           : LDO           : aldoin-supply         : shared supply
 146 ALDO2           : LDO           : aldoin-supply         : shared supply
 147 ALDO3           : LDO           : aldoin-supply         : shared supply
 148 BLDO1           : LDO           : bldoin-supply         : shared supply
 149 BLDO2           : LDO           : bldoin-supply         : shared supply
 150 BLDO3           : LDO           : bldoin-supply         : shared supply
 151 BLDO4           : LDO           : bldoin-supply         : shared supply
 152 CLDO1           : LDO           : cldoin-supply         : shared supply
 153 CLDO2           : LDO           : cldoin-supply         : shared supply
 154 CLDO3           : LDO           : cldoin-supply         : shared supply
 155 SW              : On/Off Switch : swin-supply
 156
 157 Additionally, the AXP806 DC-DC regulators support poly-phase arrangements
 158 for higher output current. The possible groupings are: A+B, A+B+C, D+E.
 159
 160 AXP809 regulators, type, and corresponding input supply names:
 161
 162 Regulator         Type            Supply Name             Notes
 163 ---------         ----            -----------             -----
 164 DCDC1           : DC-DC buck    : vin1-supply
 165 DCDC2           : DC-DC buck    : vin2-supply
 166 DCDC3           : DC-DC buck    : vin3-supply
 167 DCDC4           : DC-DC buck    : vin4-supply
 168 DCDC5           : DC-DC buck    : vin5-supply
 169 DC1SW           : On/Off Switch :                       : DCDC1 secondary output
 170 DC5LDO          : LDO           :                       : input from DCDC5
 171 ALDO1           : LDO           : aldoin-supply         : shared supply
 172 ALDO2           : LDO           : aldoin-supply         : shared supply
 173 ALDO3           : LDO           : aldoin-supply         : shared supply
 174 DLDO1           : LDO           : dldoin-supply         : shared supply
 175 DLDO2           : LDO           : dldoin-supply         : shared supply
 176 ELDO1           : LDO           : eldoin-supply         : shared supply
 177 ELDO2           : LDO           : eldoin-supply         : shared supply
 178 ELDO3           : LDO           : eldoin-supply         : shared supply
 179 LDO_IO0         : LDO           : ips-supply            : GPIO 0
 180 LDO_IO1         : LDO           : ips-supply            : GPIO 1
 181 RTC_LDO         : LDO           : ips-supply            : always on
 182 SW              : On/Off Switch : swin-supply
 183
 184 AXP813 regulators, type, and corresponding input supply names:
 185
 186 Regulator         Type            Supply Name             Notes
 187 ---------         ----            -----------             -----
 188 DCDC1           : DC-DC buck    : vin1-supply
 189 DCDC2           : DC-DC buck    : vin2-supply           : poly-phase capable
 190 DCDC3           : DC-DC buck    : vin3-supply           : poly-phase capable
 191 DCDC4           : DC-DC buck    : vin4-supply
 192 DCDC5           : DC-DC buck    : vin5-supply           : poly-phase capable
 193 DCDC6           : DC-DC buck    : vin6-supply           : poly-phase capable
 194 DCDC7           : DC-DC buck    : vin7-supply
 195 ALDO1           : LDO           : aldoin-supply         : shared supply
 196 ALDO2           : LDO           : aldoin-supply         : shared supply
 197 ALDO3           : LDO           : aldoin-supply         : shared supply
 198 DLDO1           : LDO           : dldoin-supply         : shared supply
 199 DLDO2           : LDO           : dldoin-supply         : shared supply
 200 DLDO3           : LDO           : dldoin-supply         : shared supply
 201 DLDO4           : LDO           : dldoin-supply         : shared supply
 202 ELDO1           : LDO           : eldoin-supply         : shared supply
 203 ELDO2           : LDO           : eldoin-supply         : shared supply
 204 ELDO3           : LDO           : eldoin-supply         : shared supply
 205 FLDO1           : LDO           : fldoin-supply         : shared supply
 206 FLDO2           : LDO           : fldoin-supply         : shared supply
 207 FLDO3           : LDO           : fldoin-supply         : shared supply
 208 LDO_IO0         : LDO           : ips-supply            : GPIO 0
 209 LDO_IO1         : LDO           : ips-supply            : GPIO 1
 210 RTC_LDO         : LDO           : ips-supply            : always on
 211 SW              : On/Off Switch : swin-supply
 212 DRIVEVBUS       : Enable output : drivevbus-supply      : external regulator
 213
 214 Example:
 215
 216 axp209: pmic@34 {
 217         compatible = "x-powers,axp209";
 218         reg = <0x34>;
 219         interrupt-parent = <&nmi_intc>;
 220         interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
 221         interrupt-controller;
 222         #interrupt-cells = <1>;
 223
 224         regulators {
 225                 x-powers,dcdc-freq = <1500>;
 226
 227                 vdd_cpu: dcdc2 {
 228                         regulator-always-on;
 229                         regulator-min-microvolt = <1000000>;
 230                         regulator-max-microvolt = <1450000>;
 231                         regulator-name = "vdd-cpu";
 232                 };
 233
 234                 vdd_int_dll: dcdc3 {
 235                         regulator-always-on;
 236                         regulator-min-microvolt = <1000000>;
 237                         regulator-max-microvolt = <1400000>;
 238                         regulator-name = "vdd-int-dll";
 239                 };
 240
 241                 vdd_rtc: ldo1 {
 242                         regulator-always-on;
 243                         regulator-min-microvolt = <1200000>;
 244                         regulator-max-microvolt = <1400000>;
 245                         regulator-name = "vdd-rtc";
 246                 };
 247
 248                 avcc: ldo2 {
 249                         regulator-always-on;
 250                         regulator-min-microvolt = <2700000>;
 251                         regulator-max-microvolt = <3300000>;
 252                         regulator-name = "avcc";
 253                 };
 254
 255                 ldo3 {
 256                         /* unused but preferred to be managed by OS */
 257                 };
 258         };
 259 };