2018-05-30 00:39:04 +08:00
|
|
|
=========================
|
|
|
|
|
drm/amdgpu AMDgpu driver
|
|
|
|
|
=========================
|
|
|
|
|
|
|
|
|
|
The drm/amdgpu driver supports all AMD Radeon GPUs based on the Graphics Core
|
|
|
|
|
Next (GCN) architecture.
|
2018-05-30 00:33:41 +08:00
|
|
|
|
2018-06-27 03:48:34 +08:00
|
|
|
Module Parameters
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
The amdgpu driver supports the following module parameters:
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_drv.c
|
|
|
|
|
|
2018-05-30 00:33:41 +08:00
|
|
|
Core Driver Infrastructure
|
|
|
|
|
==========================
|
|
|
|
|
|
|
|
|
|
This section covers core driver infrastructure.
|
|
|
|
|
|
2018-06-01 18:10:02 +08:00
|
|
|
.. _amdgpu_memory_domains:
|
|
|
|
|
|
|
|
|
|
Memory Domains
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: include/uapi/drm/amdgpu_drm.h
|
|
|
|
|
:doc: memory domains
|
|
|
|
|
|
2018-06-01 18:30:44 +08:00
|
|
|
Buffer Objects
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_object.c
|
|
|
|
|
:doc: amdgpu_object
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_object.c
|
|
|
|
|
:internal:
|
|
|
|
|
|
2018-05-30 00:33:41 +08:00
|
|
|
PRIME Buffer Sharing
|
|
|
|
|
--------------------
|
|
|
|
|
|
2019-05-30 07:23:42 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_dma_buf.c
|
2018-05-30 00:33:41 +08:00
|
|
|
:doc: PRIME Buffer Sharing
|
|
|
|
|
|
2019-05-30 07:23:42 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_dma_buf.c
|
2018-05-30 00:33:41 +08:00
|
|
|
:internal:
|
2018-06-05 17:47:43 +08:00
|
|
|
|
|
|
|
|
MMU Notifier
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c
|
|
|
|
|
:doc: MMU Notifier
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_mn.c
|
|
|
|
|
:internal:
|
2018-06-11 23:11:24 +08:00
|
|
|
|
|
|
|
|
AMDGPU Virtual Memory
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c
|
|
|
|
|
:doc: GPUVM
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vm.c
|
2018-06-14 17:59:20 +08:00
|
|
|
:internal:
|
2018-06-08 05:27:07 +08:00
|
|
|
|
|
|
|
|
Interrupt Handling
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c
|
|
|
|
|
:doc: Interrupt Handling
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c
|
2018-06-11 23:11:24 +08:00
|
|
|
:internal:
|
2018-06-02 01:28:14 +08:00
|
|
|
|
2020-09-16 05:16:34 +08:00
|
|
|
IP Blocks
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/include/amd_shared.h
|
|
|
|
|
:doc: IP Blocks
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/include/amd_shared.h
|
|
|
|
|
:identifiers: amd_ip_block_type amd_ip_funcs
|
|
|
|
|
|
2019-05-24 21:15:17 +08:00
|
|
|
AMDGPU XGMI Support
|
|
|
|
|
===================
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c
|
|
|
|
|
|
2019-09-20 04:09:56 +08:00
|
|
|
AMDGPU RAS Support
|
|
|
|
|
==================
|
|
|
|
|
|
2019-10-31 02:40:09 +08:00
|
|
|
The AMDGPU RAS interfaces are exposed via sysfs (for informational queries) and
|
|
|
|
|
debugfs (for error injection).
|
|
|
|
|
|
2019-09-20 04:09:56 +08:00
|
|
|
RAS debugfs/sysfs Control and Error Injection Interfaces
|
|
|
|
|
--------------------------------------------------------
|
2019-05-24 21:21:54 +08:00
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
|
|
|
|
|
:doc: AMDGPU RAS debugfs control interface
|
|
|
|
|
|
2019-10-31 02:40:09 +08:00
|
|
|
RAS Reboot Behavior for Unrecoverable Errors
|
|
|
|
|
--------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
|
|
|
|
|
:doc: AMDGPU RAS Reboot Behavior for Unrecoverable Errors
|
|
|
|
|
|
2019-09-20 04:09:56 +08:00
|
|
|
RAS Error Count sysfs Interface
|
|
|
|
|
-------------------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
|
|
|
|
|
:doc: AMDGPU RAS sysfs Error Count Interface
|
|
|
|
|
|
|
|
|
|
RAS EEPROM debugfs Interface
|
|
|
|
|
----------------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
|
|
|
|
|
:doc: AMDGPU RAS debugfs EEPROM table reset interface
|
|
|
|
|
|
|
|
|
|
RAS VRAM Bad Pages sysfs Interface
|
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_ras.c
|
|
|
|
|
:doc: AMDGPU RAS sysfs gpu_vram_bad_pages Interface
|
2019-05-24 21:21:54 +08:00
|
|
|
|
2019-10-31 02:40:09 +08:00
|
|
|
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.
|
|
|
|
|
|
2019-05-24 21:21:54 +08:00
|
|
|
|
2018-06-02 01:28:14 +08:00
|
|
|
GPU Power/Thermal Controls and Monitoring
|
|
|
|
|
=========================================
|
|
|
|
|
|
|
|
|
|
This section covers hwmon and power/thermal controls.
|
|
|
|
|
|
|
|
|
|
HWMON Interfaces
|
|
|
|
|
----------------
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2018-06-02 01:28:14 +08:00
|
|
|
:doc: hwmon
|
|
|
|
|
|
|
|
|
|
GPU sysfs Power State Interfaces
|
|
|
|
|
--------------------------------
|
|
|
|
|
|
|
|
|
|
GPU power controls are exposed via sysfs files.
|
|
|
|
|
|
|
|
|
|
power_dpm_state
|
|
|
|
|
~~~~~~~~~~~~~~~
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2018-06-02 01:28:14 +08:00
|
|
|
:doc: power_dpm_state
|
|
|
|
|
|
|
|
|
|
power_dpm_force_performance_level
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2018-06-02 01:28:14 +08:00
|
|
|
:doc: power_dpm_force_performance_level
|
|
|
|
|
|
|
|
|
|
pp_table
|
|
|
|
|
~~~~~~~~
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2018-06-02 01:28:14 +08:00
|
|
|
:doc: pp_table
|
|
|
|
|
|
|
|
|
|
pp_od_clk_voltage
|
|
|
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2018-06-02 01:28:14 +08:00
|
|
|
:doc: pp_od_clk_voltage
|
|
|
|
|
|
2019-09-20 04:03:27 +08:00
|
|
|
pp_dpm_*
|
|
|
|
|
~~~~~~~~
|
2018-06-02 01:28:14 +08:00
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2019-09-20 04:03:27 +08:00
|
|
|
:doc: pp_dpm_sclk pp_dpm_mclk pp_dpm_socclk pp_dpm_fclk pp_dpm_dcefclk pp_dpm_pcie
|
2018-06-02 01:28:14 +08:00
|
|
|
|
|
|
|
|
pp_power_profile_mode
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2018-06-02 01:28:14 +08:00
|
|
|
:doc: pp_power_profile_mode
|
|
|
|
|
|
2020-10-13 19:54:20 +08:00
|
|
|
\*_busy_percent
|
|
|
|
|
~~~~~~~~~~~~~~~
|
2018-06-20 19:55:39 +08:00
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2020-06-16 04:36:49 +08:00
|
|
|
:doc: gpu_busy_percent
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2020-06-16 04:36:49 +08:00
|
|
|
:doc: mem_busy_percent
|
2020-03-13 21:21:55 +08:00
|
|
|
|
2020-07-23 18:03:35 +08:00
|
|
|
gpu_metrics
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2020-07-23 18:03:35 +08:00
|
|
|
:doc: gpu_metrics
|
|
|
|
|
|
2020-03-13 21:21:55 +08:00
|
|
|
GPU Product Information
|
|
|
|
|
=======================
|
|
|
|
|
|
|
|
|
|
Information about the GPU can be obtained on certain cards
|
|
|
|
|
via sysfs
|
|
|
|
|
|
|
|
|
|
product_name
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
|
|
|
|
|
:doc: product_name
|
|
|
|
|
|
|
|
|
|
product_number
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
|
|
|
|
|
:doc: product_name
|
|
|
|
|
|
|
|
|
|
serial_number
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
|
|
|
|
|
:doc: serial_number
|
2020-03-20 03:03:40 +08:00
|
|
|
|
2020-03-20 21:19:01 +08:00
|
|
|
unique_id
|
|
|
|
|
---------
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2020-03-20 21:19:01 +08:00
|
|
|
:doc: unique_id
|
|
|
|
|
|
2020-03-20 03:03:40 +08:00
|
|
|
GPU Memory Usage Information
|
|
|
|
|
============================
|
|
|
|
|
|
|
|
|
|
Various memory accounting can be accessed via sysfs
|
|
|
|
|
|
|
|
|
|
mem_info_vram_total
|
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
|
|
|
|
|
:doc: mem_info_vram_total
|
|
|
|
|
|
|
|
|
|
mem_info_vram_used
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
|
|
|
|
|
:doc: mem_info_vram_used
|
|
|
|
|
|
|
|
|
|
mem_info_vis_vram_total
|
|
|
|
|
-----------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
|
|
|
|
|
:doc: mem_info_vis_vram_total
|
|
|
|
|
|
|
|
|
|
mem_info_vis_vram_used
|
|
|
|
|
----------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_vram_mgr.c
|
|
|
|
|
:doc: mem_info_vis_vram_used
|
|
|
|
|
|
|
|
|
|
mem_info_gtt_total
|
2020-03-20 21:17:21 +08:00
|
|
|
------------------
|
2020-03-20 03:03:40 +08:00
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c
|
|
|
|
|
:doc: mem_info_gtt_total
|
|
|
|
|
|
|
|
|
|
mem_info_gtt_used
|
2020-03-20 21:17:21 +08:00
|
|
|
-----------------
|
2020-03-20 03:03:40 +08:00
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_gtt_mgr.c
|
|
|
|
|
:doc: mem_info_gtt_used
|
2020-03-20 21:17:21 +08:00
|
|
|
|
|
|
|
|
PCIe Accounting Information
|
|
|
|
|
===========================
|
|
|
|
|
|
|
|
|
|
pcie_bw
|
|
|
|
|
-------
|
|
|
|
|
|
2020-08-24 06:35:36 +08:00
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
2020-03-20 21:17:21 +08:00
|
|
|
:doc: pcie_bw
|
|
|
|
|
|
|
|
|
|
pcie_replay_count
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_device.c
|
|
|
|
|
:doc: pcie_replay_count
|
|
|
|
|
|
2021-09-30 01:42:08 +08:00
|
|
|
GPU SmartShift Information
|
|
|
|
|
==========================
|
2021-05-30 12:15:26 +08:00
|
|
|
|
|
|
|
|
GPU SmartShift information via sysfs
|
2020-03-20 21:17:21 +08:00
|
|
|
|
2021-05-30 12:15:26 +08:00
|
|
|
smartshift_apu_power
|
|
|
|
|
--------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
|
|
|
|
:doc: smartshift_apu_power
|
|
|
|
|
|
|
|
|
|
smartshift_dgpu_power
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
|
|
|
|
:doc: smartshift_dgpu_power
|
2021-05-30 13:17:16 +08:00
|
|
|
|
|
|
|
|
smartshift_bias
|
|
|
|
|
---------------
|
|
|
|
|
|
|
|
|
|
.. kernel-doc:: drivers/gpu/drm/amd/pm/amdgpu_pm.c
|
|
|
|
|
:doc: smartshift_bias
|
