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
2023-04-25 22:31:45 -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 utils: disable "line-too-long" for pylint 2023-04-25 21:45:02 -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 match sphinx deps to fedora 38 levels 2023-04-25 22:31:02 -05:00
README.md update sub-header, reflect module function 2023-04-25 21:18:43 -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 (using Textual) that shows AMD GPU statistics

Screenshot of main screen

Screenshot of log screen

The GPU and temperature nodes (edge/junction/etc.) are discovered automatically.

Statistics are not logged; only toggling Dark/light mode and the stat names / source files.

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

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.

Installation / Usage

pip install amdgpu-stats

Once installed, run amdgpu-stats in your terminal of choice

Module

Rudimentary support as a module exists; functions / variables offered can be found in amdgpu_stats.utils

Demonstration:

In [1]: import amdgpu_stats.utils

In [2]: print(amdgpu_stats.utils.get_core_stats())
{'sclk': 0, 'mclk': 1000000000, 'voltage': 0.01, 'util_pct': 0}

In [3]: print(amdgpu_stats.utils.get_power_stats())
{'limit': 281, 'average': 35, 'capability': 323, 'default': 281}

In [4]: print(amdgpu_stats.utils.get_temp_stats())
{'edge': 33, 'junction': 36, 'mem': 42}

In [5]: print(amdgpu_stats.utils.get_fan_stats())
{'fan_rpm': 0, 'fan_rpm_target': 0}

See help('amdgpu_stats.utils') or the module source for more info