bindings/power/mali-opp.txt

1 # SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note
3 # (C) COPYRIGHT 2017, 2019-2021 ARM Limited. All rights reserved.
17 # http://www.gnu.org/licenses/gpl-2.0.html.
26 This describes the OPPs belonging to a device. This node can have following
29 Required properties:
30 - compatible: Allow OPPs to express their compatibility. It should be:
31   "operating-points-v2", "operating-points-v2-mali".
33 - OPP nodes: One or more OPP nodes describing voltage-current-frequency
39 This defines voltage-current-frequency combinations along with other related
42 Required properties:
43 - opp-hz: Nominal frequency in Hz, expressed as a 64-bit big-endian integer.
48 - opp-hz-real: List of one or two real frequencies in Hz, expressed as 64-bit
49   big-endian integers. They shall correspond to the clocks declared under
52 - opp-core-mask: Shader core mask. If neither this or opp-core-count are present
55 - opp-core-count: Number of cores to use for this OPP. If this is present then
57   the GPU hardware. An opp-core-count value of 0 is not permitted.
59   If neither this nor opp-core-mask are present then all shader cores will be
62   If both this and opp-core-mask are present then opp-core-mask is ignored.
64 - opp-microvolt: List of one or two voltages in micro Volts. They shall correspond
75 - opp-microvolt-<name>: Named opp-microvolt property. This is exactly similar to
76   the above opp-microvolt property, but allows multiple voltage ranges to be
78   matching opp-microvolt-<name> property will be enabled for all OPPs. If the
80   opp-microvolt-<name> properties, then opp-microvolt property shall be used, if
83 - opp-microamp: The maximum current drawn by the device in microamperes
88   Should only be set if opp-microvolt is set for the OPP.
91   regulators are specified in device's DT node. If this property isn't required
93   required for any regulator, then this property need not be present.
95 - opp-microamp-<name>: Named opp-microamp property. Similar to
96   opp-microvolt-<name> property, but for microamp instead.
98 - clock-latency-ns: Specifies the maximum possible transition latency (in
101 - turbo-mode: Marks the OPP to be used only for turbo modes. Turbo mode is
106 - opp-suspend: Marks the OPP to be used during device suspend. Only one OPP in
109 - opp-mali-errata-1485982: Marks the OPP to be selected for suspend clock.
114 - opp-supported-hw: This enables us to select only a subset of OPPs from the
116   still can't have multiple nodes with the same opp-hz value in OPP table.
134 - status: Marks the node enabled/disabled.
139 	compatible = "operating-points-v2", "operating-points-v2-mali";
142 		opp-hz = /bits/ 64 <112500000>;
143 		opp-hz-real = /bits/ 64 <450000000>;
144 		opp-microvolt = <820000>;
145 		opp-core-mask = /bits/ 64 <0x1>;
146 		opp-suspend;
147 		opp-mali-errata-1485982;
150 		opp-hz = /bits/ 64 <225000000>;
151 		opp-hz-real = /bits/ 64 <450000000>;
152 		opp-microvolt = <820000>;
153 		opp-core-count = <2>;
156 		opp-hz = /bits/ 64 <450000000>;
157 		opp-hz-real = /bits/ 64 <450000000>;
158 		opp-microvolt = <820000>;
159 		opp-core-mask = /bits/ 64 <0xf>;
162 		opp-hz = /bits/ 64 <487500000>;
163 		opp-microvolt = <825000>;
166 		opp-hz = /bits/ 64 <525000000>;
167 		opp-microvolt = <850000>;
170 		opp-hz = /bits/ 64 <562500000>;
171 		opp-microvolt = <875000>;
174 		opp-hz = /bits/ 64 <600000000>;
175 		opp-microvolt = <900000>;
182 	compatible = "operating-points-v2", "operating-points-v2-mali";
185 		opp-hz = /bits/ 64 <50000000>;
186 		opp-hz-real = /bits/ 64 <50000000>, /bits/ 64 <45000000>;
187 		opp-microvolt = <820000>, <800000>;
188 		opp-core-mask = /bits/ 64 <0xf>;
191 		opp-hz = /bits/ 64 <40000000>;
192 		opp-hz-real = /bits/ 64 <40000000>, /bits/ 64 <35000000>;
193 		opp-microvolt = <720000>, <700000>;
194 		opp-core-mask = /bits/ 64 <0x7>;
197 		opp-hz = /bits/ 64 <30000000>;
198 		opp-hz-real = /bits/ 64 <30000000>, /bits/ 64 <25000000>;
199 		opp-microvolt = <620000>, <700000>;
200 		opp-core-mask = /bits/ 64 <0x3>;