amdgpu.rst 6.61 KB

drm/amdgpu AMDgpu driver

The drm/amdgpu driver supports all AMD Radeon GPUs based on the Graphics Core Next (GCN) architecture.

Module Parameters

The amdgpu driver supports the following module parameters:

Core Driver Infrastructure

This section covers core driver infrastructure.

Memory Domains

Buffer Objects

PRIME Buffer Sharing

MMU Notifier

AMDGPU Virtual Memory

Interrupt Handling

IP Blocks

AMDGPU XGMI Support

AMDGPU RAS Support

The AMDGPU RAS interfaces are exposed via sysfs (for informational queries) and debugfs (for error injection).

RAS debugfs/sysfs Control and Error Injection Interfaces

RAS Reboot Behavior for Unrecoverable Errors

RAS Error Count sysfs Interface

RAS EEPROM debugfs Interface

RAS VRAM Bad Pages sysfs Interface

Sample Code

Sample code for testing error injection can be found here: https://cgit.freedesktop.org/mesa/drm/tree/tests/amdgpu/ras_tests.c

This is part of the libdrm amdgpu unit tests which cover several areas of the GPU. There are four sets of tests:

RAS Basic Test

The test verifies the RAS feature enabled status and makes sure the necessary sysfs and debugfs files are present.

RAS Query Test

This test checks the RAS availability and enablement status for each supported IP block as well as the error counts.

RAS Inject Test

This test injects errors for each IP.

RAS Disable Test

This test tests disabling of RAS features for each IP block.

GPU Power/Thermal Controls and Monitoring

This section covers hwmon and power/thermal controls.

HWMON Interfaces

GPU sysfs Power State Interfaces

GPU power controls are exposed via sysfs files.

power_dpm_state

power_dpm_force_performance_level

pp_table

pp_od_clk_voltage

pp_dpm_*

pp_power_profile_mode

*_busy_percent

gpu_metrics

GPU Product Information

Information about the GPU can be obtained on certain cards via sysfs

product_name

product_number

serial_number

unique_id

GPU Memory Usage Information

Various memory accounting can be accessed via sysfs

mem_info_vram_total

mem_info_vram_used

mem_info_vis_vram_total

mem_info_vis_vram_used

mem_info_gtt_total

mem_info_gtt_used

PCIe Accounting Information

pcie_bw

pcie_replay_count