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