xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/da9062.txt (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1* Dialog DA9062 Power Management Integrated Circuit (PMIC)
2
3Product information for the DA9062 and DA9061 devices can be found here:
4- https://www.dialog-semiconductor.com/products/da9062
5- https://www.dialog-semiconductor.com/products/da9061
6
7The DA9062 PMIC consists of:
8
9Device                   Supply Names    Description
10------                   ------------    -----------
11da9062-regulator        :               : LDOs & BUCKs
12da9062-rtc              :               : Real-Time Clock
13da9062-onkey            :               : On Key
14da9062-watchdog         :               : Watchdog Timer
15da9062-thermal          :               : Thermal
16da9062-gpio             :               : GPIOs
17
18The DA9061 PMIC consists of:
19
20Device                   Supply Names    Description
21------                   ------------    -----------
22da9062-regulator        :               : LDOs & BUCKs
23da9062-onkey            :               : On Key
24da9062-watchdog         :               : Watchdog Timer
25da9062-thermal          :               : Thermal
26
27======
28
29Required 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
37Optional properties:
38
39- gpio-controller : Marks the device as a gpio controller.
40- #gpio-cells     : Should be two. The first cell is the pin number and the
41                    second cell is used to specify the gpio polarity.
42
43See Documentation/devicetree/bindings/gpio/gpio.txt for further information on
44GPIO bindings.
45
46- interrupts : IRQ line information.
47- interrupt-controller
48
49See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt for
50further information on IRQ bindings.
51
52Sub-nodes:
53
54- regulators : This node defines the settings for the LDOs and BUCKs.
55  The DA9062 regulators are bound using their names listed below:
56
57    buck1    : BUCK_1
58    buck2    : BUCK_2
59    buck3    : BUCK_3
60    buck4    : BUCK_4
61    ldo1     : LDO_1
62    ldo2     : LDO_2
63    ldo3     : LDO_3
64    ldo4     : LDO_4
65
66  The DA9061 regulators are bound using their names listed below:
67
68    buck1    : BUCK_1
69    buck2    : BUCK_2
70    buck3    : BUCK_3
71    ldo1     : LDO_1
72    ldo2     : LDO_2
73    ldo3     : LDO_3
74    ldo4     : LDO_4
75
76  The component follows the standard regulator framework and the bindings
77  details of individual regulator device can be found in:
78  Documentation/devicetree/bindings/regulator/regulator.txt
79
80  regulator-initial-mode may be specified for buck regulators using mode values
81  from include/dt-bindings/regulator/dlg,da9063-regulator.h.
82
83- rtc : This node defines settings required for the Real-Time Clock associated
84  with the DA9062. There are currently no entries in this binding, however
85  compatible = "dlg,da9062-rtc" should be added if a node is created.
86
87- onkey : See ../input/da9062-onkey.txt
88
89- watchdog: See ../watchdog/da9062-wdt.txt
90
91- thermal : See ../thermal/da9062-thermal.txt
92
93Example:
94
95	pmic0: da9062@58 {
96		compatible = "dlg,da9062";
97		reg = <0x58>;
98		interrupt-parent = <&gpio6>;
99		interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
100		interrupt-controller;
101
102		rtc {
103			compatible = "dlg,da9062-rtc";
104		};
105
106		regulators {
107			DA9062_BUCK1: buck1 {
108				regulator-name = "BUCK1";
109				regulator-min-microvolt = <300000>;
110				regulator-max-microvolt = <1570000>;
111				regulator-min-microamp = <500000>;
112				regulator-max-microamp = <2000000>;
113				regulator-initial-mode = <DA9063_BUCK_MODE_SYNC>;
114				regulator-boot-on;
115			};
116			DA9062_LDO1: ldo1 {
117				regulator-name = "LDO_1";
118				regulator-min-microvolt = <900000>;
119				regulator-max-microvolt = <3600000>;
120				regulator-boot-on;
121			};
122		};
123	};
124
125