Documentation/devicetree/bindings/mfd/da9062.txt

   1 * Dialog DA9062 Power Management Integrated Circuit (PMIC)
   2
   3 Product information for the DA9062 and DA9061 devices can be found here:
   4 - https://www.dialog-semiconductor.com/products/da9062
   5 - https://www.dialog-semiconductor.com/products/da9061
   6
   7 The DA9062 PMIC consists of:
   8
   9 Device                   Supply Names    Description
  10 ------                   ------------    -----------
  11 da9062-regulator        :               : LDOs & BUCKs
  12 da9062-rtc              :               : Real-Time Clock
  13 da9062-onkey            :               : On Key
  14 da9062-watchdog         :               : Watchdog Timer
  15 da9062-thermal          :               : Thermal
  16 da9062-gpio             :               : GPIOs
  17
  18 The DA9061 PMIC consists of:
  19
  20 Device                   Supply Names    Description
  21 ------                   ------------    -----------
  22 da9062-regulator        :               : LDOs & BUCKs
  23 da9062-onkey            :               : On Key
  24 da9062-watchdog         :               : Watchdog Timer
  25 da9062-thermal          :               : Thermal
  26
  27 ======
  28
  29 Required properties:
  30
  31 - compatible : Should be
  32     "dlg,da9062" for DA9062
  33     "dlg,da9061" for DA9061
  34 - reg : Specifies the I2C slave address (this defaults to 0x58 but it can be
  35   modified to match the chip's OTP settings).
  36 - interrupts : IRQ line information.
  37 - interrupt-controller
  38
  39 See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt for
  40 further information on IRQ bindings.
  41
  42 Optional properties:
  43
  44 - gpio-controller : Marks the device as a gpio controller.
  45 - #gpio-cells     : Should be two. The first cell is the pin number and the
  46                     second cell is used to specify the gpio polarity.
  47
  48 See Documentation/devicetree/bindings/gpio/gpio.txt for further information on
  49 GPIO bindings.
  50
  51 Sub-nodes:
  52
  53 - regulators : This node defines the settings for the LDOs and BUCKs.
  54   The DA9062 regulators are bound using their names listed below:
  55
  56     buck1    : BUCK_1
  57     buck2    : BUCK_2
  58     buck3    : BUCK_3
  59     buck4    : BUCK_4
  60     ldo1     : LDO_1
  61     ldo2     : LDO_2
  62     ldo3     : LDO_3
  63     ldo4     : LDO_4
  64
  65   The DA9061 regulators are bound using their names listed below:
  66
  67     buck1    : BUCK_1
  68     buck2    : BUCK_2
  69     buck3    : BUCK_3
  70     ldo1     : LDO_1
  71     ldo2     : LDO_2
  72     ldo3     : LDO_3
  73     ldo4     : LDO_4
  74
  75   The component follows the standard regulator framework and the bindings
  76   details of individual regulator device can be found in:
  77   Documentation/devicetree/bindings/regulator/regulator.txt
  78
  79   regulator-initial-mode may be specified for buck regulators using mode values
  80   from include/dt-bindings/regulator/dlg,da9063-regulator.h.
  81
  82 - rtc : This node defines settings required for the Real-Time Clock associated
  83   with the DA9062. There are currently no entries in this binding, however
  84   compatible = "dlg,da9062-rtc" should be added if a node is created.
  85
  86 - onkey : See ../input/da9062-onkey.txt
  87
  88 - watchdog: See ../watchdog/da9062-watchdog.txt
  89
  90 - thermal : See ../thermal/da9062-thermal.txt
  91
  92 Example:
  93
  94         pmic0: da9062@58 {
  95                 compatible = "dlg,da9062";
  96                 reg = <0x58>;
  97                 interrupt-parent = <&gpio6>;
  98                 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
  99                 interrupt-controller;
 100
 101                 rtc {
 102                         compatible = "dlg,da9062-rtc";
 103                 };
 104
 105                 regulators {
 106                         DA9062_BUCK1: buck1 {
 107                                 regulator-name = "BUCK1";
 108                                 regulator-min-microvolt = <300000>;
 109                                 regulator-max-microvolt = <1570000>;
 110                                 regulator-min-microamp = <500000>;
 111                                 regulator-max-microamp = <2000000>;
 112                                 regulator-initial-mode = <DA9063_BUCK_MODE_SYNC>;
 113                                 regulator-boot-on;
 114                         };
 115                         DA9062_LDO1: ldo1 {
 116                                 regulator-name = "LDO_1";
 117                                 regulator-min-microvolt = <900000>;
 118                                 regulator-max-microvolt = <3600000>;
 119                                 regulator-boot-on;
 120                         };
 121                 };
 122         };
 123