xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/da9063.txt (revision 95eb4b873b6a8b527c5bd78d7191975dfca38998)
1* Dialog DA9063/DA9063L Power Management Integrated Circuit (PMIC)
2
3DA9063 consists of a large and varied group of sub-devices (I2C Only):
4
5Device                   Supply Names    Description
6------                   ------------    -----------
7da9063-regulator        :               : LDOs & BUCKs
8da9063-onkey            :               : On Key
9da9063-rtc              :               : Real-Time Clock (DA9063 only)
10da9063-watchdog         :               : Watchdog
11
12======
13
14Required 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
22Sub-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
75Example:
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
115