Merge tag 'for_linus-4.16' of git://git.kernel.org/pub/scm/linux/kernel/git/jwessel...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / soc / mediatek / scpsys.txt
1 MediaTek SCPSYS
2 ===============
3
4 The System Control Processor System (SCPSYS) has several power management
5 related tasks in the system. The tasks include thermal measurement, dynamic
6 voltage frequency scaling (DVFS), interrupt filter and lowlevel sleep control.
7 The System Power Manager (SPM) inside the SCPSYS is for the MTCMOS power
8 domain control.
9
10 The driver implements the Generic PM domain bindings described in
11 power/power_domain.txt. It provides the power domains defined in
12 - include/dt-bindings/power/mt8173-power.h
13 - include/dt-bindings/power/mt6797-power.h
14 - include/dt-bindings/power/mt2701-power.h
15 - include/dt-bindings/power/mt2712-power.h
16 - include/dt-bindings/power/mt7622-power.h
17
18 Required properties:
19 - compatible: Should be one of:
20         - "mediatek,mt2701-scpsys"
21         - "mediatek,mt2712-scpsys"
22         - "mediatek,mt6797-scpsys"
23         - "mediatek,mt7622-scpsys"
24         - "mediatek,mt7623-scpsys", "mediatek,mt2701-scpsys": For MT7623 SoC
25         - "mediatek,mt7623a-scpsys": For MT7623A SoC
26         - "mediatek,mt8173-scpsys"
27 - #power-domain-cells: Must be 1
28 - reg: Address range of the SCPSYS unit
29 - infracfg: must contain a phandle to the infracfg controller
30 - clock, clock-names: clocks according to the common clock binding.
31                       These are clocks which hardware needs to be
32                       enabled before enabling certain power domains.
33         Required clocks for MT2701 or MT7623: "mm", "mfg", "ethif"
34         Required clocks for MT2712: "mm", "mfg", "venc", "jpgdec", "audio", "vdec"
35         Required clocks for MT6797: "mm", "mfg", "vdec"
36         Required clocks for MT7622: "hif_sel"
37         Required clocks for MT7622A: "ethif"
38         Required clocks for MT8173: "mm", "mfg", "venc", "venc_lt"
39
40 Optional properties:
41 - vdec-supply: Power supply for the vdec power domain
42 - venc-supply: Power supply for the venc power domain
43 - isp-supply: Power supply for the isp power domain
44 - mm-supply: Power supply for the mm power domain
45 - venc_lt-supply: Power supply for the venc_lt power domain
46 - audio-supply: Power supply for the audio power domain
47 - usb-supply: Power supply for the usb power domain
48 - mfg_async-supply: Power supply for the mfg_async power domain
49 - mfg_2d-supply: Power supply for the mfg_2d power domain
50 - mfg-supply: Power supply for the mfg power domain
51
52 Example:
53
54         scpsys: scpsys@10006000 {
55                 #power-domain-cells = <1>;
56                 compatible = "mediatek,mt8173-scpsys";
57                 reg = <0 0x10006000 0 0x1000>;
58                 infracfg = <&infracfg>;
59                 clocks = <&clk26m>,
60                          <&topckgen CLK_TOP_MM_SEL>;
61                          <&topckgen CLK_TOP_VENC_SEL>,
62                          <&topckgen CLK_TOP_VENC_LT_SEL>;
63                 clock-names = "mfg", "mm", "venc", "venc_lt";
64         };
65
66 Example consumer:
67
68         afe: mt8173-afe-pcm@11220000 {
69                 compatible = "mediatek,mt8173-afe-pcm";
70                 power-domains = <&scpsys MT8173_POWER_DOMAIN_AUDIO>;
71         };