xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/mt6397.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
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
24	"mediatek,mt6397" for PMIC MT6397
25
26Optional subnodes:
27
28- rtc
29	Required properties: Should be one of follows
30		- compatible: "mediatek,mt6323-rtc"
31		- compatible: "mediatek,mt6358-rtc"
32		- compatible: "mediatek,mt6397-rtc"
33	For details, see ../rtc/rtc-mt6397.txt
34- regulators
35	Required properties:
36		- compatible: "mediatek,mt6323-regulator"
37	see ../regulator/mt6323-regulator.txt
38		- compatible: "mediatek,mt6358-regulator"
39	see ../regulator/mt6358-regulator.txt
40		- compatible: "mediatek,mt6397-regulator"
41	see ../regulator/mt6397-regulator.txt
42- codec
43	Required properties:
44		- compatible: "mediatek,mt6397-codec" or "mediatek,mt6358-sound"
45- clk
46	Required properties:
47		- compatible: "mediatek,mt6397-clk"
48- led
49	Required properties:
50		- compatible: "mediatek,mt6323-led"
51	see ../leds/leds-mt6323.txt
52
53- keys
54	Required properties:
55		- compatible: "mediatek,mt6397-keys" or "mediatek,mt6323-keys"
56	see ../input/mtk-pmic-keys.txt
57
58- power-controller
59	Required properties:
60		- compatible: "mediatek,mt6323-pwrc"
61	For details, see ../power/reset/mt6323-poweroff.txt
62
63- pin-controller
64	Required properties:
65		- compatible: "mediatek,mt6397-pinctrl"
66	For details, see ../pinctrl/pinctrl-mt65xx.txt
67
68Example:
69	pwrap: pwrap@1000f000 {
70		compatible = "mediatek,mt8135-pwrap";
71
72		...
73
74		pmic {
75			compatible = "mediatek,mt6397";
76
77			codec: mt6397codec {
78				compatible = "mediatek,mt6397-codec";
79			};
80
81			regulators {
82				compatible = "mediatek,mt6397-regulator";
83
84				mt6397_vpca15_reg: buck_vpca15 {
85					regulator-compatible = "buck_vpca15";
86					regulator-name = "vpca15";
87					regulator-min-microvolt = <850000>;
88					regulator-max-microvolt = <1400000>;
89					regulator-ramp-delay = <12500>;
90					regulator-always-on;
91				};
92
93				mt6397_vgp4_reg: ldo_vgp4 {
94					regulator-compatible = "ldo_vgp4";
95					regulator-name = "vgp4";
96					regulator-min-microvolt = <1200000>;
97					regulator-max-microvolt = <3300000>;
98					regulator-enable-ramp-delay = <218>;
99				};
100			};
101		};
102	};
103