xref: /freebsd/sys/contrib/device-tree/Bindings/interconnect/mediatek,cci.yaml (revision 7ef62cebc2f965b0f640263e179276928885e33d) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/interconnect/mediatek,cci.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MediaTek Cache Coherent Interconnect (CCI) frequency and voltage scaling
8
9maintainers:
10  - Jia-Wei Chang <jia-wei.chang@mediatek.com>
11  - Johnson Wang <johnson.wang@mediatek.com>
12
13description: |
14  MediaTek Cache Coherent Interconnect (CCI) is a hardware engine used by
15  MT8183 and MT8186 SoCs to scale the frequency and adjust the voltage in
16  hardware. It can also optimize the voltage to reduce the power consumption.
17
18properties:
19  compatible:
20    enum:
21      - mediatek,mt8183-cci
22      - mediatek,mt8186-cci
23
24  clocks:
25    items:
26      - description:
27          The multiplexer for clock input of the bus.
28      - description:
29          A parent of "bus" clock which is used as an intermediate clock source
30          when the original clock source (PLL) is under transition and not
31          stable yet.
32
33  clock-names:
34    items:
35      - const: cci
36      - const: intermediate
37
38  operating-points-v2: true
39  opp-table:
40    type: object
41
42  proc-supply:
43    description:
44      Phandle of the regulator for CCI that provides the supply voltage.
45
46  sram-supply:
47    description:
48      Phandle of the regulator for sram of CCI that provides the supply
49      voltage. When it is present, the implementation needs to do
50      "voltage tracking" to step by step scale up/down Vproc and Vsram to fit
51      SoC specific needs. When absent, the voltage scaling flow is handled by
52      hardware, hence no software "voltage tracking" is needed.
53
54required:
55  - compatible
56  - clocks
57  - clock-names
58  - operating-points-v2
59  - proc-supply
60
61additionalProperties: false
62
63examples:
64  - |
65    #include <dt-bindings/clock/mt8183-clk.h>
66    cci: cci {
67        compatible = "mediatek,mt8183-cci";
68        clocks = <&mcucfg CLK_MCU_BUS_SEL>,
69                 <&topckgen CLK_TOP_ARMPLL_DIV_PLL1>;
70        clock-names = "cci", "intermediate";
71        operating-points-v2 = <&cci_opp>;
72        proc-supply = <&mt6358_vproc12_reg>;
73    };
74
75    cci_opp: opp-table-cci {
76        compatible = "operating-points-v2";
77        opp-shared;
78        opp2_00: opp-273000000 {
79            opp-hz = /bits/ 64 <273000000>;
80            opp-microvolt = <650000>;
81        };
82        opp2_01: opp-338000000 {
83            opp-hz = /bits/ 64 <338000000>;
84            opp-microvolt = <687500>;
85        };
86        opp2_02: opp-403000000 {
87            opp-hz = /bits/ 64 <403000000>;
88            opp-microvolt = <718750>;
89        };
90        opp2_03: opp-463000000 {
91            opp-hz = /bits/ 64 <463000000>;
92            opp-microvolt = <756250>;
93        };
94        opp2_04: opp-546000000 {
95            opp-hz = /bits/ 64 <546000000>;
96            opp-microvolt = <800000>;
97        };
98        opp2_05: opp-624000000 {
99            opp-hz = /bits/ 64 <624000000>;
100            opp-microvolt = <818750>;
101        };
102        opp2_06: opp-689000000 {
103            opp-hz = /bits/ 64 <689000000>;
104            opp-microvolt = <850000>;
105        };
106        opp2_07: opp-767000000 {
107            opp-hz = /bits/ 64 <767000000>;
108            opp-microvolt = <868750>;
109        };
110        opp2_08: opp-845000000 {
111            opp-hz = /bits/ 64 <845000000>;
112            opp-microvolt = <893750>;
113        };
114        opp2_09: opp-871000000 {
115            opp-hz = /bits/ 64 <871000000>;
116            opp-microvolt = <906250>;
117        };
118        opp2_10: opp-923000000 {
119            opp-hz = /bits/ 64 <923000000>;
120            opp-microvolt = <931250>;
121        };
122        opp2_11: opp-962000000 {
123            opp-hz = /bits/ 64 <962000000>;
124            opp-microvolt = <943750>;
125        };
126        opp2_12: opp-1027000000 {
127            opp-hz = /bits/ 64 <1027000000>;
128            opp-microvolt = <975000>;
129        };
130        opp2_13: opp-1092000000 {
131            opp-hz = /bits/ 64 <1092000000>;
132            opp-microvolt = <1000000>;
133        };
134        opp2_14: opp-1144000000 {
135            opp-hz = /bits/ 64 <1144000000>;
136            opp-microvolt = <1025000>;
137        };
138        opp2_15: opp-1196000000 {
139            opp-hz = /bits/ 64 <1196000000>;
140            opp-microvolt = <1050000>;
141        };
142    };
143