Merge commit '81fd23e2b3ccf71c807e671444e8accaba98ca53' of https://git.pengutronix...
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / mfd / mt6397.txt
1 MediaTek MT6397/MT6323 Multifunction Device Driver
2
3 MT6397/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
13 It is interfaced to host controller using SPI interface by a proprietary hardware
14 called PMIC wrapper or pwrap. MT6397/MT6323 MFD is a child device of pwrap.
15 See the following for pwarp node definitions:
16 ../soc/mediatek/pwrap.txt
17
18 This document describes the binding for MFD device and its sub module.
19
20 Required properties:
21 compatible:
22         "mediatek,mt6323" for PMIC MT6323
23         "mediatek,mt6358" for PMIC MT6358
24         "mediatek,mt6359" for PMIC MT6359
25         "mediatek,mt6397" for PMIC MT6397
26
27 Optional subnodes:
28
29 - rtc
30         Required properties: Should be one of follows
31                 - compatible: "mediatek,mt6323-rtc"
32                 - compatible: "mediatek,mt6358-rtc"
33                 - compatible: "mediatek,mt6397-rtc"
34         For details, see ../rtc/rtc-mt6397.txt
35 - regulators
36         Required properties:
37                 - compatible: "mediatek,mt6323-regulator"
38         see ../regulator/mt6323-regulator.txt
39                 - compatible: "mediatek,mt6358-regulator"
40         see ../regulator/mt6358-regulator.txt
41                 - compatible: "mediatek,mt6397-regulator"
42         see ../regulator/mt6397-regulator.txt
43 - codec
44         Required properties:
45                 - compatible: "mediatek,mt6397-codec" or "mediatek,mt6358-sound"
46 - clk
47         Required properties:
48                 - compatible: "mediatek,mt6397-clk"
49 - led
50         Required properties:
51                 - compatible: "mediatek,mt6323-led"
52         see ../leds/leds-mt6323.txt
53
54 - keys
55         Required properties:
56                 - compatible: "mediatek,mt6397-keys" or "mediatek,mt6323-keys"
57         see ../input/mtk-pmic-keys.txt
58
59 - power-controller
60         Required properties:
61                 - compatible: "mediatek,mt6323-pwrc"
62         For details, see ../power/reset/mt6323-poweroff.txt
63
64 - pin-controller
65         Required properties:
66                 - compatible: "mediatek,mt6397-pinctrl"
67         For details, see ../pinctrl/pinctrl-mt65xx.txt
68
69 Example:
70         pwrap: pwrap@1000f000 {
71                 compatible = "mediatek,mt8135-pwrap";
72
73                 ...
74
75                 pmic {
76                         compatible = "mediatek,mt6397";
77
78                         codec: mt6397codec {
79                                 compatible = "mediatek,mt6397-codec";
80                         };
81
82                         regulators {
83                                 compatible = "mediatek,mt6397-regulator";
84
85                                 mt6397_vpca15_reg: buck_vpca15 {
86                                         regulator-compatible = "buck_vpca15";
87                                         regulator-name = "vpca15";
88                                         regulator-min-microvolt = <850000>;
89                                         regulator-max-microvolt = <1400000>;
90                                         regulator-ramp-delay = <12500>;
91                                         regulator-always-on;
92                                 };
93
94                                 mt6397_vgp4_reg: ldo_vgp4 {
95                                         regulator-compatible = "ldo_vgp4";
96                                         regulator-name = "vgp4";
97                                         regulator-min-microvolt = <1200000>;
98                                         regulator-max-microvolt = <3300000>;
99                                         regulator-enable-ramp-delay = <218>;
100                                 };
101                         };
102                 };
103         };