xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/mt6397.txt (revision b197d4b893974c9eb4d7b38704c6d5c486235d6f)
1MediaTek MT6397/MT6323 Multifunction Device Driver
2
3MT6397/MT6323 is a multifunction device with the following sub modules:
4- Regulator
5- RTC
6- Audio codec
7- GPIO
8- Clock
9- LED
10- Keys
11- Power controller
12
13It is interfaced to host controller using SPI interface by a proprietary hardware
14called PMIC wrapper or pwrap. MT6397/MT6323 MFD is a child device of pwrap.
15See the following for pwarp node definitions:
16../soc/mediatek/pwrap.txt
17
18This document describes the binding for MFD device and its sub module.
19
20Required properties:
21compatible:
22	"mediatek,mt6323" for PMIC MT6323
23	"mediatek,mt6358" for PMIC MT6358 and MT6366
24	"mediatek,mt6359" for PMIC MT6359
25	"mediatek,mt6397" for PMIC MT6397
26
27Optional subnodes:
28
29- rtc
30	Required properties: Should be one of follows
31		- compatible: "mediatek,mt6323-rtc"
32		- compatible: "mediatek,mt6358-rtc"
33		- compatible: "mediatek,mt6397-rtc"
34	For details, see ../rtc/rtc-mt6397.txt
35- regulators
36	Required properties:
37		- compatible: "mediatek,mt6323-regulator"
38	see ../regulator/mt6323-regulator.txt
39		- compatible: "mediatek,mt6358-regulator"
40	see ../regulator/mt6358-regulator.txt
41		- compatible: "mediatek,mt6397-regulator"
42	see ../regulator/mt6397-regulator.txt
43- codec
44	Required properties:
45		- compatible: "mediatek,mt6397-codec" or "mediatek,mt6358-sound"
46- clk
47	Required properties:
48		- compatible: "mediatek,mt6397-clk"
49- led
50	Required properties:
51		- compatible: "mediatek,mt6323-led"
52	see ../leds/leds-mt6323.txt
53
54- keys
55	Required properties:
56		- compatible: "mediatek,mt6397-keys" or "mediatek,mt6323-keys"
57	see ../input/mtk-pmic-keys.txt
58
59- power-controller
60	Required properties:
61		- compatible: "mediatek,mt6323-pwrc"
62	For details, see ../power/reset/mt6323-poweroff.txt
63
64- pin-controller
65	Required properties:
66		- compatible: "mediatek,mt6397-pinctrl"
67	For details, see ../pinctrl/pinctrl-mt65xx.txt
68
69Example:
70	pwrap: pwrap@1000f000 {
71		compatible = "mediatek,mt8135-pwrap";
72
73		...
74
75		pmic {
76			compatible = "mediatek,mt6397";
77
78			codec: mt6397codec {
79				compatible = "mediatek,mt6397-codec";
80			};
81
82			regulators {
83				compatible = "mediatek,mt6397-regulator";
84
85				mt6397_vpca15_reg: buck_vpca15 {
86					regulator-compatible = "buck_vpca15";
87					regulator-name = "vpca15";
88					regulator-min-microvolt = <850000>;
89					regulator-max-microvolt = <1400000>;
90					regulator-ramp-delay = <12500>;
91					regulator-always-on;
92				};
93
94				mt6397_vgp4_reg: ldo_vgp4 {
95					regulator-compatible = "ldo_vgp4";
96					regulator-name = "vgp4";
97					regulator-min-microvolt = <1200000>;
98					regulator-max-microvolt = <3300000>;
99					regulator-enable-ramp-delay = <218>;
100				};
101			};
102		};
103	};
104