xref: /aosp_15_r20/external/igt-gpu-tools/man/intel_gpu_frequency.rst (revision d83cc019efdc2edc6c4b16e9034a3ceb8d35d77c)
1*d83cc019SAndroid Build Coastguard Worker===================
2*d83cc019SAndroid Build Coastguard Workerintel_gpu_frequency
3*d83cc019SAndroid Build Coastguard Worker===================
4*d83cc019SAndroid Build Coastguard Worker
5*d83cc019SAndroid Build Coastguard Worker--------------------------------
6*d83cc019SAndroid Build Coastguard WorkerManipulate Intel GPU frequencies
7*d83cc019SAndroid Build Coastguard Worker--------------------------------
8*d83cc019SAndroid Build Coastguard Worker.. include:: defs.rst
9*d83cc019SAndroid Build Coastguard Worker:Author: IGT Developers <[email protected]>
10*d83cc019SAndroid Build Coastguard Worker:Date: 2016-03-01
11*d83cc019SAndroid Build Coastguard Worker:Version: |PACKAGE_STRING|
12*d83cc019SAndroid Build Coastguard Worker:Copyright: 2015-2016 Intel Corporation
13*d83cc019SAndroid Build Coastguard Worker:Manual section: |MANUAL_SECTION|
14*d83cc019SAndroid Build Coastguard Worker:Manual group: |MANUAL_GROUP|
15*d83cc019SAndroid Build Coastguard Worker
16*d83cc019SAndroid Build Coastguard WorkerSYNOPSIS
17*d83cc019SAndroid Build Coastguard Worker========
18*d83cc019SAndroid Build Coastguard Worker
19*d83cc019SAndroid Build Coastguard Worker**intel_gpu_frequency** [*OPTIONS*]
20*d83cc019SAndroid Build Coastguard Worker
21*d83cc019SAndroid Build Coastguard WorkerDESCRIPTION
22*d83cc019SAndroid Build Coastguard Worker===========
23*d83cc019SAndroid Build Coastguard Worker
24*d83cc019SAndroid Build Coastguard WorkerA program to manipulate Intel GPU frequencies. Intel GPUs will automatically
25*d83cc019SAndroid Build Coastguard Workerthrottle the frequencies based on system demands, up when needed, down when
26*d83cc019SAndroid Build Coastguard Workernot. This tool should only be used for debugging performance problems, or trying
27*d83cc019SAndroid Build Coastguard Workerto get a stable frequency while benchmarking.
28*d83cc019SAndroid Build Coastguard Worker
29*d83cc019SAndroid Build Coastguard WorkerIntel GPUs only accept specific frequencies. The tool may, or may not attempt to
30*d83cc019SAndroid Build Coastguard Workeradjust requests to the proper frequency if they aren't correct. This may lead to
31*d83cc019SAndroid Build Coastguard Workernon-obvious failures when setting frequency. Multiples of 50MHz is usually a
32*d83cc019SAndroid Build Coastguard Workersafe bet.
33*d83cc019SAndroid Build Coastguard Worker
34*d83cc019SAndroid Build Coastguard WorkerOPTIONS
35*d83cc019SAndroid Build Coastguard Worker=======
36*d83cc019SAndroid Build Coastguard Worker
37*d83cc019SAndroid Build Coastguard Worker-e
38*d83cc019SAndroid Build Coastguard Worker    Lock frequency to the most efficient frequency.
39*d83cc019SAndroid Build Coastguard Worker
40*d83cc019SAndroid Build Coastguard Worker-g, --get
41*d83cc019SAndroid Build Coastguard Worker    Get all the current frequency settings.
42*d83cc019SAndroid Build Coastguard Worker
43*d83cc019SAndroid Build Coastguard Worker-s FREQUENCY, --set=FREQUENCY
44*d83cc019SAndroid Build Coastguard Worker    Lock frequency to an absolute value (MHz).
45*d83cc019SAndroid Build Coastguard Worker
46*d83cc019SAndroid Build Coastguard Worker-c, --custom
47*d83cc019SAndroid Build Coastguard Worker    Set a min, or max frequency "min=X | max=Y".
48*d83cc019SAndroid Build Coastguard Worker
49*d83cc019SAndroid Build Coastguard Worker-m, --max
50*d83cc019SAndroid Build Coastguard Worker    Lock frequency to max frequency.
51*d83cc019SAndroid Build Coastguard Worker
52*d83cc019SAndroid Build Coastguard Worker-i, --min
53*d83cc019SAndroid Build Coastguard Worker    Lock frequency to min (never a good idea, DEBUG ONLY).
54*d83cc019SAndroid Build Coastguard Worker
55*d83cc019SAndroid Build Coastguard Worker-d, --defaults
56*d83cc019SAndroid Build Coastguard Worker    Return the system to hardware defaults.
57*d83cc019SAndroid Build Coastguard Worker
58*d83cc019SAndroid Build Coastguard Worker-h, --help
59*d83cc019SAndroid Build Coastguard Worker    Show help.
60*d83cc019SAndroid Build Coastguard Worker
61*d83cc019SAndroid Build Coastguard Worker-v, --version
62*d83cc019SAndroid Build Coastguard Worker    Show version.
63*d83cc019SAndroid Build Coastguard Worker
64*d83cc019SAndroid Build Coastguard WorkerEXAMPLES
65*d83cc019SAndroid Build Coastguard Worker========
66*d83cc019SAndroid Build Coastguard Worker
67*d83cc019SAndroid Build Coastguard Workerintel_gpu_frequency -gmin,cur
68*d83cc019SAndroid Build Coastguard Worker    Get the current and minimum frequency.
69*d83cc019SAndroid Build Coastguard Worker
70*d83cc019SAndroid Build Coastguard Workerintel_gpu_frequency -s 400
71*d83cc019SAndroid Build Coastguard Worker    Lock frequency to 400Mhz.
72*d83cc019SAndroid Build Coastguard Worker
73*d83cc019SAndroid Build Coastguard Workerintel_gpu_frequency -c max=750
74*d83cc019SAndroid Build Coastguard Worker    Set the max frequency to 750MHz
75*d83cc019SAndroid Build Coastguard Worker
76*d83cc019SAndroid Build Coastguard WorkerREPORTING BUGS
77*d83cc019SAndroid Build Coastguard Worker==============
78*d83cc019SAndroid Build Coastguard Worker
79*d83cc019SAndroid Build Coastguard WorkerReport bugs to https://bugs.freedesktop.org.
80