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.
22 * ARM Mali Midgard OPP
24 * OPP Table Node
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
35   reference an OPP.
37 * OPP Node
39 This defines voltage-current-frequency combinations along with other related
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
53   then all shader cores will be used for this OPP.
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
60   used for this OPP.
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
77   provided for the same OPP. At runtime, the platform can pick a <name> and
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.
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
99   nanoseconds) for switching to this OPP from any other OPP.
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
107   the table should have this.
109 - opp-mali-errata-1485982: Marks the OPP to be selected for suspend clock.
111   enabled. It needs to be placed in any OPP that has proper suspend clock for
114 - opp-supported-hw: This enables us to select only a subset of OPPs from the
115   larger OPP table, based on what version of the hardware we are running on. We
116   still can't have multiple nodes with the same opp-hz value in OPP table.
119   supported by the OPP. For example: a platform with hierarchy of three levels
126   value of 0xFFFFFFFF will enable the OPP for all versions for that hierarchy
127   level. And a value of 0x00000000 will disable the OPP completely, and so we
134 - status: Marks the node enabled/disabled.
139 	compatible = "operating-points-v2", "operating-points-v2-mali";
141 	opp@112500000 {
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;
149 	opp@225000000 {
150 		opp-hz = /bits/ 64 <225000000>;
151 		opp-hz-real = /bits/ 64 <450000000>;
152 		opp-microvolt = <820000>;
153 		opp-core-count = <2>;
155 	opp@450000000 {
156 		opp-hz = /bits/ 64 <450000000>;
157 		opp-hz-real = /bits/ 64 <450000000>;
158 		opp-microvolt = <820000>;
159 		opp-core-mask = /bits/ 64 <0xf>;
161 	opp@487500000 {
162 		opp-hz = /bits/ 64 <487500000>;
163 		opp-microvolt = <825000>;
165 	opp@525000000 {
166 		opp-hz = /bits/ 64 <525000000>;
167 		opp-microvolt = <850000>;
169 	opp@562500000 {
170 		opp-hz = /bits/ 64 <562500000>;
171 		opp-microvolt = <875000>;
173 	opp@600000000 {
174 		opp-hz = /bits/ 64 <600000000>;
175 		opp-microvolt = <900000>;
182 	compatible = "operating-points-v2", "operating-points-v2-mali";
184 	opp@0 {
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>;
190 	opp@1 {
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>;
196 	opp@2 {
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>;