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
  37 Optional properties:
  38
  39 - gpio-controller : Marks the device as a gpio controller.
  40 - #gpio-cells     : Should be two. The first cell is the pin number and the
  41                     second cell is used to specify the gpio polarity.
  42
  43 See Documentation/devicetree/bindings/gpio/gpio.txt for further information on
  44 GPIO bindings.
  45
  46 - interrupts : IRQ line information.
  47 - interrupt-controller
  48
  49 See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt for
  50 further information on IRQ bindings.
  51
  52 Sub-nodes:
  53
  54 - regulators : This node defines the settings for the LDOs and BUCKs.
  55   The DA9062 regulators are bound using their names listed below:
  56
  57     buck1    : BUCK_1
  58     buck2    : BUCK_2
  59     buck3    : BUCK_3
  60     buck4    : BUCK_4
  61     ldo1     : LDO_1
  62     ldo2     : LDO_2
  63     ldo3     : LDO_3
  64     ldo4     : LDO_4
  65
  66   The DA9061 regulators are bound using their names listed below:
  67
  68     buck1    : BUCK_1
  69     buck2    : BUCK_2
  70     buck3    : BUCK_3
  71     ldo1     : LDO_1
  72     ldo2     : LDO_2
  73     ldo3     : LDO_3
  74     ldo4     : LDO_4
  75
  76   The component follows the standard regulator framework and the bindings
  77   details of individual regulator device can be found in:
  78   Documentation/devicetree/bindings/regulator/regulator.txt
  79
  80   regulator-initial-mode may be specified for buck regulators using mode values
  81   from include/dt-bindings/regulator/dlg,da9063-regulator.h.
  82
  83 - rtc : This node defines settings required for the Real-Time Clock associated
  84   with the DA9062. There are currently no entries in this binding, however
  85   compatible = "dlg,da9062-rtc" should be added if a node is created.
  86
  87 - onkey : See ../input/da9062-onkey.txt
  88
  89 - watchdog: See ../watchdog/da9062-wdt.txt
  90
  91 - thermal : See ../thermal/da9062-thermal.txt
  92
  93 Example:
  94
  95         pmic0: da9062@58 {
  96                 compatible = "dlg,da9062";
  97                 reg = <0x58>;
  98                 interrupt-parent = <&gpio6>;
  99                 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
 100                 interrupt-controller;
 101
 102                 rtc {
 103                         compatible = "dlg,da9062-rtc";
 104                 };
 105
 106                 regulators {
 107                         DA9062_BUCK1: buck1 {
 108                                 regulator-name = "BUCK1";
 109                                 regulator-min-microvolt = <300000>;
 110                                 regulator-max-microvolt = <1570000>;
 111                                 regulator-min-microamp = <500000>;
 112                                 regulator-max-microamp = <2000000>;
 113                                 regulator-initial-mode = <DA9063_BUCK_MODE_SYNC>;
 114                                 regulator-boot-on;
 115                         };
 116                         DA9062_LDO1: ldo1 {
 117                                 regulator-name = "LDO_1";
 118                                 regulator-min-microvolt = <900000>;
 119                                 regulator-max-microvolt = <3600000>;
 120                                 regulator-boot-on;
 121                         };
 122                 };
 123         };
 124