GNU Linux-libre 5.19-rc6-gnu
[releases.git] / Documentation / devicetree / bindings / mfd / da9063.txt
1 * Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC)
2
3 DA9063 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. The node should contain the compatible property
68   with the value "dlg,da9063-watchdog".
69
70   Optional watchdog properties:
71   - dlg,use-sw-pm: Add this property to disable the watchdog during suspend.
72   Only use this option if you can't use the watchdog automatic suspend
73   function during a suspend (see register CONTROL_B).
74
75 Example:
76
77         pmic0: da9063@58 {
78                 compatible = "dlg,da9063"
79                 reg = <0x58>;
80                 interrupt-parent = <&gpio6>;
81                 interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
82                 interrupt-controller;
83
84                 rtc {
85                         compatible = "dlg,da9063-rtc";
86                 };
87
88                 wdt {
89                         compatible = "dlg,da9063-watchdog";
90                 };
91
92                 onkey {
93                         compatible = "dlg,da9063-onkey";
94                         dlg,disable-key-power;
95                 };
96
97                 regulators {
98                         DA9063_BCORE1: bcore1 {
99                                 regulator-name = "BCORE1";
100                                 regulator-min-microvolt = <300000>;
101                                 regulator-max-microvolt = <1570000>;
102                                 regulator-min-microamp = <500000>;
103                                 regulator-max-microamp = <2000000>;
104                                 regulator-boot-on;
105                         };
106                         DA9063_LDO11: ldo11 {
107                                 regulator-name = "LDO_11";
108                                 regulator-min-microvolt = <900000>;
109                                 regulator-max-microvolt = <3600000>;
110                                 regulator-boot-on;
111                         };
112                 };
113         };
114