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