Merge tag 'for-linus-5.6-1' of https://github.com/cminyard/linux-ipmi
[sfrench/cifs-2.6.git] / 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 - http://www.dialog-semiconductor.com/products/da9062
5 - http://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