xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/da9063.txt (revision b197d4b893974c9eb4d7b38704c6d5c486235d6f)
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. 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
72Example:
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
112