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