Archived
1
1
Fork 0
A Python module/TUI that provides AMD GPU statistics
This repository has been archived on 2024-03-02. You can view files and clone it, but cannot push or open issues or pull requests.
Find a file
Josh Lay 9cbe6ab8cf
v0.1.10: add card validating/selecting function
add card validating/selecting function
2023-04-27 23:56:30 -05:00
.github/workflows Create pylint.yml 2023-04-23 17:02:45 -05:00
docs move doc files where RTD can hopefully find them 2023-04-25 22:09:52 -05:00
screens recommit 0.1.2 bits, merging to master 2023-04-23 17:45:36 -05:00
src/amdgpu_stats add card validating/selecting function, make card optional 2023-04-27 23:23:48 -05:00
.gitignore start packaging 2023-04-23 13:39:03 -05:00
.readthedocs.yaml rtd: add config 2023-04-25 22:31:45 -05:00
LICENSE.md Create LICENSE.md 2023-04-23 13:40:45 -05:00
pyproject.toml bump ver: v0.1.10 2023-04-27 23:49:22 -05:00
README.md reorganization 2023-04-27 23:48:50 -05:00
requirements.txt add requirements.txt w/ tested versions 2023-04-21 11:57:37 -05:00
todo.md vram note 2023-04-24 22:14:38 -05:00

amdgpu_stats

A simple Python module/TUI for AMD GPU statistics

Screenshot of main screen

Supported GPUs and temperature nodes (edge/junction/etc.) are discovered automatically.

Tested only on RX6000 series cards; APUs and more may be supported. Please file an issue if finding incompatibility!

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:

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.