amdgpu_stats/README.md

amdgpu_stats

A Python module/TUI for AMD GPU statistics. Tested only on RX6000 series cards and (less so) with Ryzen CPU iGPUs.

Please file an issue if finding incompatibility!

Screenshots

Main screen / stats

Usage graphs

Logs

Installation

pip install amdgpu-stats

To use the TUI, run amdgpu-stats in your terminal of choice. For the module, see below!

Module

Introduction:

In [1]: import amdgpu_stats.utils

In [2]: amdgpu_stats.utils.AMDGPU_CARDS
Out[2]: {'card0': '/sys/class/drm/card0/device/hwmon/hwmon9'}

In [3]: amdgpu_stats.utils.get_core_stats('card0')
Out[3]: {'sclk': 640000000, 'mclk': 1000000000, 'voltage': 0.79, 'util_pct': 65}

In [4]: amdgpu_stats.utils.get_clock('core', format_freq=True)
Out[4]: '659 MHz' 

For more information on what the module provides, please see:

• ReadTheDocs
• help('amdgpu_stats.utils') in your interpreter
• The module source

Feature requests are encouraged 😀

Requirements

Only Linux is supported. Information is completely sourced from interfaces in sysfs.

It may be necessary to update the amdgpu.ppfeaturemask parameter to enable metrics.

This is assumed present for control over the elements being monitored. Untested without.

See this Arch Wiki entry for context.