AMDGPU_TOP

amdgpu_top is tool that display AMD GPU utilization, like umr or clbr/radeontop or intelgputop.
The tool displays information gathered from performance counters (GRBM, GRBM2), sensors, fdinfo, and AMDGPU driver.

| TUI | GUI | | :-------------------------------------: | :--------------------------------------------------: | | |

Usage

cargo run -- [options ..]

Option

``` FLAGS: -d, --dump Dump AMDGPU info (Specifications, VRAM, PCI, ResizableBAR, VBIOS, Video caps) --list Display a list of AMDGPU devices -J Output JSON formatted data for simple process trace (require "proc_trace" feature) --gui Launch GUI mode (require "egui" feature) -h, --help Print help information

OPTIONS: -i Select GPU instance --pci Specifying PCI path (domain:bus:dev.func) -u , --update-process-index Update interval in seconds of the process index for fdinfo (default: 5s) -s , --ms Refresh period in milliseconds for simple process trace (require "proctrace" feature) -p , --pid Specification of PID, used for -J option (require "proctrace" feature) ```

Command

| key | | | :-- | :---------------------------------: | | g | toggle GRBM | | r | toggle GRBM2 | | p | toggle PCI | | v | toggle VRAM/GTT Usage | | f | toggle fdinfo | | n | toggle Sensors | | m | toggle GPU Metrics | | h | change update interval (high = 100ms, low = 1000ms) | | q | Quit | | P | sort fdinfo by pid | | M | sort fdinfo by VRAM usage | | G | sort fdinfo by GFX usage | | M | sort fdinfo by MediaEngine usage | | R | reverse sort |

Installation

Packages

• Releases
  • .deb (generated by cargo-deb)
  • .AppImage (generated by cargo-appimage)
• AUR
• OpenMandriva to install run sudo dnf install amdgpu_top

  Build from source

Dependencies: * libdrm2 * libdrm-amdgpu1

git clone https://github.com/Umio-Yasuno/amdgpu_top cd amdgpu_top cargo install --locked --path .

Used library

• Cursive
• egui
• libdrm-amdgpu-sys-rs

Reference

• Tom St Denis / umr · GitLab
• Mesa3D
  • src/gallium/drivers/radeonsi/sigpuload.c · main · Mesa / mesa · GitLab
• AMD Documentation
  • R6xxR7xx3D.pdf
  • CIK3Dregisters_v2.pdf
  • MI200 Performance Counters: Listing
  • MI200 Performance Counters: Abbreviations
• https://github.com/AMDResearch/omniperf/tree/v1.0.4/src/perfmon_pub
• https://github.com/freedesktop/mesa-r600_demo
• radeonhd:r6xxErrata
• Linux Kernel AMDGPU Driver
  • libdrm_amdgpu API
    • /drivers/gpu/drm/amd/amdgpu/amdgpu_kms.c
  • amdgpu_allowed_register_entry
    • /drivers/gpu/drm/amd/amdgpu/{cik,nv,vi,si,soc15,soc21}.c

Alternatives

If amdgpu_top is not enough for you or you don't like it, try the following applications.

• clbr/radeontop
  • View your GPU utilization, both for the total activity percent and individual blocks.
• Syllo/nvtop
  • GPUs process monitoring for AMD, Intel and NVIDIA
• Tom St Denis / umr · GitLab
  • User Mode Register Debugger for AMDGPU Hardware
• GPUOpen-Tools/radeongpuprofiler
  • for developer
  • Radeon GPU Profiler (RGP) is a tool from AMD that allows for deep inspection of GPU workloads.