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