xref: /linux/Documentation/devicetree/bindings/interconnect/mediatek,cci.yaml (revision 115e74a29b530d121891238e9551c4bcdf7b04b5) 
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    oneOf:
21      - enum:
22          - mediatek,mt8183-cci
23          - mediatek,mt8186-cci
24      - items:
25          - enum:
26              - mediatek,mt7988-cci
27          - const: mediatek,mt8183-cci
28
29  clocks:
30    items:
31      - description:
32          The multiplexer for clock input of the bus.
33      - description:
34          A parent of "bus" clock which is used as an intermediate clock source
35          when the original clock source (PLL) is under transition and not
36          stable yet.
37
38  clock-names:
39    items:
40      - const: cci
41      - const: intermediate
42
43  operating-points-v2: true
44  opp-table:
45    type: object
46
47  proc-supply:
48    description:
49      Phandle of the regulator for CCI that provides the supply voltage.
50
51  sram-supply:
52    description:
53      Phandle of the regulator for sram of CCI that provides the supply
54      voltage. When it is present, the implementation needs to do
55      "voltage tracking" to step by step scale up/down Vproc and Vsram to fit
56      SoC specific needs. When absent, the voltage scaling flow is handled by
57      hardware, hence no software "voltage tracking" is needed.
58
59required:
60  - compatible
61  - clocks
62  - clock-names
63  - operating-points-v2
64  - proc-supply
65
66additionalProperties: false
67
68examples:
69  - |
70    #include <dt-bindings/clock/mt8183-clk.h>
71    cci: cci {
72        compatible = "mediatek,mt8183-cci";
73        clocks = <&mcucfg CLK_MCU_BUS_SEL>,
74                 <&topckgen CLK_TOP_ARMPLL_DIV_PLL1>;
75        clock-names = "cci", "intermediate";
76        operating-points-v2 = <&cci_opp>;
77        proc-supply = <&mt6358_vproc12_reg>;
78    };
79
80    cci_opp: opp-table-cci {
81        compatible = "operating-points-v2";
82        opp-shared;
83        opp2_00: opp-273000000 {
84            opp-hz = /bits/ 64 <273000000>;
85            opp-microvolt = <650000>;
86        };
87        opp2_01: opp-338000000 {
88            opp-hz = /bits/ 64 <338000000>;
89            opp-microvolt = <687500>;
90        };
91        opp2_02: opp-403000000 {
92            opp-hz = /bits/ 64 <403000000>;
93            opp-microvolt = <718750>;
94        };
95        opp2_03: opp-463000000 {
96            opp-hz = /bits/ 64 <463000000>;
97            opp-microvolt = <756250>;
98        };
99        opp2_04: opp-546000000 {
100            opp-hz = /bits/ 64 <546000000>;
101            opp-microvolt = <800000>;
102        };
103        opp2_05: opp-624000000 {
104            opp-hz = /bits/ 64 <624000000>;
105            opp-microvolt = <818750>;
106        };
107        opp2_06: opp-689000000 {
108            opp-hz = /bits/ 64 <689000000>;
109            opp-microvolt = <850000>;
110        };
111        opp2_07: opp-767000000 {
112            opp-hz = /bits/ 64 <767000000>;
113            opp-microvolt = <868750>;
114        };
115        opp2_08: opp-845000000 {
116            opp-hz = /bits/ 64 <845000000>;
117            opp-microvolt = <893750>;
118        };
119        opp2_09: opp-871000000 {
120            opp-hz = /bits/ 64 <871000000>;
121            opp-microvolt = <906250>;
122        };
123        opp2_10: opp-923000000 {
124            opp-hz = /bits/ 64 <923000000>;
125            opp-microvolt = <931250>;
126        };
127        opp2_11: opp-962000000 {
128            opp-hz = /bits/ 64 <962000000>;
129            opp-microvolt = <943750>;
130        };
131        opp2_12: opp-1027000000 {
132            opp-hz = /bits/ 64 <1027000000>;
133            opp-microvolt = <975000>;
134        };
135        opp2_13: opp-1092000000 {
136            opp-hz = /bits/ 64 <1092000000>;
137            opp-microvolt = <1000000>;
138        };
139        opp2_14: opp-1144000000 {
140            opp-hz = /bits/ 64 <1144000000>;
141            opp-microvolt = <1025000>;
142        };
143        opp2_15: opp-1196000000 {
144            opp-hz = /bits/ 64 <1196000000>;
145            opp-microvolt = <1050000>;
146        };
147    };
148