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