NAME¶

amdgpu-pac - program and control compatible AMD GPUs

SYNOPSIS¶

amdgpu-pac [--help | --about]
amdgpu-pac [--execute_pac] [--no_fan] [--force_write] [--debug]

CONFIGURATION¶

All amdgpu-utils require that compatible GPU cards and drivers are installed and that the feature to access them is enabled. This can be accomplished by adding amdgpu.ppfeaturemask=0xfffd7fff to the GRUB_CMDLINE_LINUX_DEFAULT value in /etc/default/grub and executing update-grub.

DESCRIPTION¶

amdgpu-pac will present the user with a gui to modify the operating conditions of compatible AMD GPUs. With this utility, the user can change GPU power limit, S-Clk and M-Clk P-state/Curve definitions, P-state masks, fan speed, and power performance mode. By default, the commands to program and control a GPU are written to a bash file for the user to inspect and run with root permissions.

OPTIONS¶

--about

Will display details about amdgpu-pac.

--execute_pac

Will execute a bash file created with commands written to the AMD driver files to modify the operating conditions of the selected GPU/GPUs. The default behavior is to only create the bash files for the user to execute.

--no_fan

Will exclude fan information from the display and will not include fans in writing or resetting GPU operating conditions.

--force_write

Will result in all parameters being writen to the selected GPU/GPUs instead of the default behavior of only writing changes.

--debug

Will display additional details useful in troubleshooting.

-h, --help

Display help text and exit.

EXAMPLES¶

amdgpu-pac

Will open a Gtk based user interface which will display current or default values for modifiable GPU operating parameters. The interface supports entry of new values for all compatible AMD GPUs. The user can select to save or reset values for individual or all GPUs. It is suggested that amdgpu-monitor be used to make sure the changes are made as expected.

amdgpu-pac --execute_pac

To simplify this process, the --execute_pac option can be specified to automate execution of the bash files. A message in the user interface will indicate if credentials are required in the original terminal window.

amdgpu-pac --force_write

With this option, all parameters will be written to the bash file, even if they are unchanged. This is useful in creating bash files used to put GPU's into a known state which is convenient for use in start up routines.

FILES¶

/usr/share/misc/pci.ids

The system list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It can be updated with the update-pciids command.

~/.amdgpu-utils/amd_pci_id.txt

A locally updated list of all known AMD PCI ID's (vendors, devices, classes and subclasses). It is preferred to use the system PCI ID file. If the local file exists, it will be used instead of the system file and can be removed with --remove_local option.

/sys/class/drm/card*/device/pp_od_clk_voltage

Special driver file for each GPU required for amdgpu-utils.

/etc/default/grub

The grub defaults file where amdgpu.ppfeaturemask needs to be set.

BUGS¶

Known to not work well with Fiji ProDuo cards and will issue warning messages for Fiji Nano cards. The display of P-state masks is always the defaults, not the actual values. Please report any additional bugs/issues at https://github.com/Ricks-Lab/amdgpu-utils

SEE ALSO¶

amdgpu-monitor(1), amdgpu(4), update-grub(8), update-pciids(8), lspci(8)

AVAILABILITY¶

The amdgpu-pac command is part of the amdgpu-utils package and is available from https://github.com/Ricks-Lab/amdgpu-utils