Merge tag 'clang-format-for-linus-v4.19' of git://github.com/ojeda/linux
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mfd / da9063.txt
1 * Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC)
2
3 DA9093 consists of a large and varied group of sub-devices (I2C Only):
4
5 Device                   Supply Names    Description
6 ------                   ------------    -----------
7 da9063-regulator        :               : LDOs & BUCKs
8 da9063-onkey            :               : On Key
9 da9063-rtc              :               : Real-Time Clock (DA9063 only)
10 da9063-watchdog         :               : Watchdog
11
12 ======
13
14 Required properties:
15
16 - compatible : Should be "dlg,da9063" or "dlg,da9063l"
17 - reg : Specifies the I2C slave address (this defaults to 0x58 but it can be
18   modified to match the chip's OTP settings).
19 - interrupts : IRQ line information.
20 - interrupt-controller
21
22 Sub-nodes:
23
24 - regulators : This node defines the settings for the LDOs and BUCKs.
25   The DA9063(L) regulators are bound using their names listed below:
26
27     bcore1    : BUCK CORE1
28     bcore2    : BUCK CORE2
29     bpro      : BUCK PRO
30     bmem      : BUCK MEM
31     bio       : BUCK IO
32     bperi     : BUCK PERI
33     ldo1      : LDO_1   (DA9063 only)
34     ldo2      : LDO_2   (DA9063 only)
35     ldo3      : LDO_3
36     ldo4      : LDO_4   (DA9063 only)
37     ldo5      : LDO_5   (DA9063 only)
38     ldo6      : LDO_6   (DA9063 only)
39     ldo7      : LDO_7
40     ldo8      : LDO_8
41     ldo9      : LDO_9
42     ldo10     : LDO_10  (DA9063 only)
43     ldo11     : LDO_11
44
45   The component follows the standard regulator framework and the bindings
46   details of individual regulator device can be found in:
47   Documentation/devicetree/bindings/regulator/regulator.txt
48
49 - rtc : This node defines settings for the Real-Time Clock associated with
50   the DA9063 only. The RTC is not present in DA9063L. There are currently
51   no entries in this binding, however compatible = "dlg,da9063-rtc" should
52   be added if a node is created.
53
54 - onkey : This node defines the OnKey settings for controlling the key
55   functionality of the device. The node should contain the compatible property
56   with the value "dlg,da9063-onkey".
57
58   Optional onkey properties:
59
60   - dlg,disable-key-power : Disable power-down using a long key-press. If this
61     entry exists the OnKey driver will remove support for the KEY_POWER key
62     press. If this entry does not exist then by default the key-press
63     triggered power down is enabled and the OnKey will support both KEY_POWER
64     and KEY_SLEEP.
65
66 - watchdog : This node defines settings for the Watchdog timer associated
67   with the DA9063 and DA9063L. There are currently no entries in this
68   binding, however compatible = "dlg,da9063-watchdog" should be added
69   if a node is created.
70
71
72 Example:
73
74         pmic0: da9063@58 {
75                 compatible = "dlg,da9063"
76                 reg = <0x58>;
77                 interrupt-parent = <&gpio6>;
78                 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
79                 interrupt-controller;
80
81                 rtc {
82                         compatible = "dlg,da9063-rtc";
83                 };
84
85                 wdt {
86                         compatible = "dlg,da9063-watchdog";
87                 };
88
89                 onkey {
90                         compatible = "dlg,da9063-onkey";
91                         dlg,disable-key-power;
92                 };
93
94                 regulators {
95                         DA9063_BCORE1: bcore1 {
96                                 regulator-name = "BCORE1";
97                                 regulator-min-microvolt = <300000>;
98                                 regulator-max-microvolt = <1570000>;
99                                 regulator-min-microamp = <500000>;
100                                 regulator-max-microamp = <2000000>;
101                                 regulator-boot-on;
102                         };
103                         DA9063_LDO11: ldo11 {
104                                 regulator-name = "LDO_11";
105                                 regulator-min-microvolt = <900000>;
106                                 regulator-max-microvolt = <3600000>;
107                                 regulator-boot-on;
108                         };
109                 };
110         };
111