Misc AMDGPU driver information¶
GPU Product Information¶
Information about the GPU can be obtained on certain cardsvia sysfs
product_name¶
The amdgpu driver provides a sysfs API for reporting the product namefor the deviceThe file product_name is used for this and returns the product nameas returned from the FRU.NOTE: This is only available for certain server cards
product_number¶
The amdgpu driver provides a sysfs API for reporting the part numberfor the deviceThe file product_number is used for this and returns the part numberas returned from the FRU.NOTE: This is only available for certain server cards
serial_number¶
The amdgpu driver provides a sysfs API for reporting the serial numberfor the deviceThe file serial_number is used for this and returns the serial numberas returned from the FRU.NOTE: This is only available for certain server cards
fru_id¶
The amdgpu driver provides a sysfs API for reporting FRU File Idfor the device.The file fru_id is used for this and returns the File Id valueas returned from the FRU.NOTE: This is only available for certain server cards
manufacturer¶
The amdgpu driver provides a sysfs API for reporting manufacturer name fromFRU information.The file manufacturer returns the value as returned from the FRU.NOTE: This is only available for certain server cards
unique_id¶
The amdgpu driver provides a sysfs API for providing a unique ID for the GPUThe file unique_id is used for this.This will provide a Unique ID that will persist from machine to machine
NOTE: This will only work for GFX9 and newer. This file will be absenton unsupported ASICs (GFX8 and older)
board_info¶
The amdgpu driver provides a sysfs API for giving board related information.It provides the form factor information in the format
type : form factor
Possible form factor values
“cem” - PCIE CEM card
“oam” - Open Compute Accelerator Module
“unknown” - Not known
GPU Memory Usage Information¶
Various memory accounting can be accessed via sysfs
mem_info_vram_total¶
The amdgpu driver provides a sysfs API for reporting current total VRAMavailable on the deviceThe file mem_info_vram_total is used for this and returns the totalamount of VRAM in bytes
mem_info_vram_used¶
The amdgpu driver provides a sysfs API for reporting current total VRAMavailable on the deviceThe file mem_info_vram_used is used for this and returns the totalamount of currently used VRAM in bytes
mem_info_vis_vram_total¶
The amdgpu driver provides a sysfs API for reporting current totalvisible VRAM available on the deviceThe file mem_info_vis_vram_total is used for this and returns the totalamount of visible VRAM in bytes
mem_info_vis_vram_used¶
The amdgpu driver provides a sysfs API for reporting current total ofused visible VRAMThe file mem_info_vis_vram_used is used for this and returns the totalamount of currently used visible VRAM in bytes
mem_info_gtt_total¶
The amdgpu driver provides a sysfs API for reporting current total size ofthe GTT.The file mem_info_gtt_total is used for this, and returns the total size ofthe GTT block, in bytes
mem_info_gtt_used¶
The amdgpu driver provides a sysfs API for reporting current total amount ofused GTT.The file mem_info_gtt_used is used for this, and returns the current usedsize of the GTT block, in bytes
PCIe Accounting Information¶
pcie_bw¶
The amdgpu driver provides a sysfs API for estimating how much datahas been received and sent by the GPU in the last second through PCIe.The file pcie_bw is used for this.The Perf counters count the number of received and sent messages and returnthose values, as well as the maximum payload size of a PCIe packet (mps).Note that it is not possible to easily and quickly obtain the size of eachpacket transmitted, so we output the max payload size (mps) to allow forquick estimation of the PCIe bandwidth usage
pcie_replay_count¶
The amdgpu driver provides a sysfs API for reporting the total numberof PCIe replays (NAKs).The file pcie_replay_count is used for this and returns the totalnumber of replays as a sum of the NAKs generated and NAKs received.
GPU SmartShift Information¶
GPU SmartShift information via sysfs
smartshift_apu_power¶
The amdgpu driver provides a sysfs API for reporting APU powershift in percentage if platform supports smartshift. Value 0 means thatthere is no powershift and values between [1-100] means that the poweris shifted to APU, the percentage of boost is with respect to APU powerlimit on the platform.
smartshift_dgpu_power¶
The amdgpu driver provides a sysfs API for reporting dGPU powershift in percentage if platform supports smartshift. Value 0 means thatthere is no powershift and values between [1-100] means that the power isshifted to dGPU, the percentage of boost is with respect to dGPU powerlimit on the platform.
smartshift_bias¶
The amdgpu driver provides a sysfs API for reporting thesmartshift(SS2.0) bias level. The value ranges from -100 to 100and the default is 0. -100 sets maximum preference to APUand 100 sets max perference to dGPU.
UMA Carveout¶
Some versions of Atom ROM expose available options for the VRAM carveout sizes,and allow changes to the carveout size via the ATCS function code 0xA on supportedBIOS implementations.
For those platforms, users can use the following files under uma/ to set thecarveout size, in a way similar to what Windows users can do in the “Tuning”tab in AMD Adrenalin.
Note that for BIOS implementations that don’t support this, these files will notbe created at all.
uma/carveout_options¶
This is a read-only file that lists all available UMA allocationoptions and their corresponding indices. Example output:
$ cat uma/carveout_options0: Minimum (512 MB)1: (1 GB)2: (2 GB)3: (4 GB)4: (6 GB)5: (8 GB)6: (12 GB)7: Medium (16 GB)8: (24 GB)9: High (32 GB)
uma/carveout¶
This file is both readable and writable. When read, it shows theindex of the current setting. Writing a valid index to this fileallows users to change the UMA carveout size to the selected optionon the next boot.
The available options and their corresponding indices can be readfrom the uma/carveout_options file.