upp

UPP: Uplift Power Play

一个用于解析、导出和修改 Radeon PowerPlay 表数据的工具

简介

UPP 能够解析和修改某些 AMD Radeon GPU 上常见的 PowerPlay 表的二进制数据结构。最新的 AMD GPU 驱动程序允许在运行时动态修改 PowerPlay 表，这可能被称为"软"PowerPlay 表。在 Linux 上，PowerPlay 表默认位于：/sys/class/drm/card0/device/pp_table。

该工具对实际 PowerPlay 表值的解释非常有限。根据设计，这主要由用户自行完成。

另外，可以通过以下方式使用此工具获取 PowerPlay 数据：

从显卡 ROM 镜像中提取 PowerPlay 表（参见 extract 命令）
直接从离线 Windows/System32/config/SYSTEM 文件导入 Windows 注册表中的"软 PowerPlay"表，因此它可以在能够访问已挂载 Windows 分区的 Linux 发行版上工作（使用 --from-registry 选项指定 SYSTEM 注册表文件的路径）
从"More Power Tool" MPT 文件导入"软 PowerPlay"表（使用 --from-mpt 选项指定 MPT 文件的路径）

此工具目前支持解析和修改以下 AMD GPU 系列上的 PowerPlay 表：

Polaris
Vega
Radeon VII
Navi 10
Arcturus (MI100)
Navi 12 (PRO V520)
Navi 14
Navi 21 (Sienna Cichlid)
Navi 22 (Navy Flounder)
Navi 23 (Dimgrey Cavefish)
Navi 3x

注意：

许多最新 AMD APU 中的集成 GPU 使用完全不同的 PowerPlay 控制方法，此工具不支持它们。
内核驱动程序尚未完全实现在 Navi 3x 卡上运行时修改 PowerPlay 表

警告：如果您选择修改显卡电压、功率限制或任何其他 PowerPlay 参数，本工具的作者对您昂贵的显卡可能发生的任何损坏不承担任何责任。请始终记住，您完全自行承担风险！

如果您有 bug 报告或功能请求，请在以下地址创建 issue： https://github.com/sibradzic/upp

要求

Python 3.7+，click 库。可选地，用于从 Windows 注册表读取"软"PowerPlay 表：python-registry。应该也可以在 Windows 上工作（需要测试人员）。

安装

可以通过 pip 获取：

pip install upp

或直接从源代码树中使用：

cd src
python3 -m upp.upp --help

使用方法

目前这是一个仅命令行界面的工具。获取帮助：

upp --help

或

upp <command> --help

Upp 只有在指定一个命令时才会工作，该命令告诉它对 Radeon PowerPlay 表数据做什么。当前可用的命令有：

dump - 将所有 PowerPlay 数据导出到控制台
extract - 从完整的 VBIOS ROM 镜像中提取 PowerPlay 数据
inject - 将文件中的 PowerPlay 数据注入 VBIOS ROM 镜像
get - 获取一个或多个 PowerPlay 参数的当前值
set - 设置一个或多个 PowerPlay 参数的值
undump - 将所有 PowerPlay 参数设置到 pp 文件或注册表
version - 显示 UPP 版本

因此，使用模式如下：

upp [OPTIONS] COMMAND [ARGS]...

可以使用一些适用于所有命令的通用选项，但请注意，它们必须在实际命令之前指定：

-p, --pp-file <filename>        输入/输出 PP 表二进制文件。
-f, --from-registry <filename>  从 Windows 注册表导入 PP_PhmSoftPowerPlayTable
                                （覆盖 -p / --pp-file 选项）。
-m, --from-mpt <filename>       从 More Power Tool 导入 PowerPlay 表
                                （覆盖 --pp-file 和 --from-registry 选项）。
-d, --debug / --no-debug        调试模式。
-h, --help                      显示此消息并退出。

导出所有数据：

dump 命令将 PowerPlay 二进制数据反序列化为人类可读的文本输出。例如：

upp dump

在标准模式下，所有数据将被导出到控制台，数据树层次结构由缩进表示。在原始模式下，将导出一个显示所有十六进制和二进制数据以及变量名称和值的表格。

从显卡 ROM 镜像中提取 PowerPlay 表：

使用 extract 命令来完成此操作。必须使用 -r/--video-rom 参数指定源视频 ROM 二进制文件，提取的 PowerPlay 表将保存到通用 -p/--pp-file 选项指定的文件中。例如：

upp --pp-file=extracted.pp_table extract -r VIDEO.rom

默认输出文件名将是原始 ROM 文件名加上 .pp_table 扩展名。

将 PowerPlay 数据从文件注入 VBIOS ROM 镜像：

使用 inject 命令来完成此操作。必须使用 -i/--input-rom 参数指定输入视频 ROM 二进制文件，输出 ROM 可以用可选的 -o/--output-rom 参数指定。例如：

upp -p modded.pp_table inject -i original.rom -o modded.rom

警告：由于最近的 Radeon 卡上的 ROM 签名检查，如果将修改后的 vROM 镜像直接刷写到您的显卡上，可能无法正常工作。本工具的作者对您选择刷写修改后的视频 ROM 而可能对您昂贵的显卡造成的任何损坏不承担任何责任，您完全自行承担风险。

获取 PowerPlay 表参数值：

get 命令获取一个或多个 PowerPlay 表参数的当前值。必须使用 /<param> 表示法指定参数变量路径，例如：

upp get smc_pptable/FreqTableGfx/1 smc_pptable/FreqTableGfx/2
1850
1400

输出值的顺序将与指定的参数变量路径顺序匹配。

设置 PowerPlay 表参数值：

set 命令设置一个或多个 PowerPlay 表参数的值。必须使用 /<param>=<value> 表示法指定参数路径和值，例如：

upp -p /tmp/custom-pp_table set --write  \
  smc_pptable/SocketPowerLimitAc/0=100   \
  smc_pptable/SocketPowerLimitDc/0=100   \
  smc_pptable/FanStartTemp=100           \
  smc_pptable/FreqTableGfx/1=1550

注意 --write 参数，必须指定它才能实际将更改提交到 PowerPlay 表文件。

将所有 PowerPlay 参数恢复：

undump 命令将先前导出的 PowerPlay 表参数的所有值设置回 pp_table 或注册表。它允许您在导出的文本文件中进行更改，并一次性写回所有更改。基本上，这是一种方便设置多个值的方法。例如：

# 从 vbios 提取 pp_table
upp --pp-file=vbios.pp_table extract -r vbios.rom
# 将 powerplay 表导出到文本文件
upp --pp-file=vbios.pp_table dump > vbios.pp_table.dump
# 在 vbios.pp_table.dump 中进行更改
# 将所有更改恢复回 pp_table
upp --pp-file=vbios.pp_table undump -d vbios.pp_table.dump -w

注意 --write 参数，必须指定它才能实际将更改提交到 PowerPlay 表文件。