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