gpu-aux 1.2.0

Direct Python bindings for AMD, NVIDIA, and Intel DisplayPort AUX access

gpu_aux

Windows x64 纯 Python GPU AUX 包。Python 使用 ctypes 直接加载系统 AMD atiadlxx.dll、NVIDIA nvapi64.dll 或 Intel IGCL ControlLib.dll，不包含或依赖 C/C++ 中间 DLL

完整接口说明见 API.md。

安装

通过 PyPI 安装：

python -m pip install gpu-aux

从本地源码目录安装：

python -m pip install .

支持：

• 按 PCI 地址合并 ADL 重复项，枚举物理 AMD GPU 和每个已连接 DP/eDP 端口
• 枚举 NVIDIA 物理 GPU 和已连接 DP 端口
• 枚举 Intel IGCL GPU 和已连接 DP/eDP 端口
• AMD DPCD 读写：ADL_Display_NativeAUXChannel_Access
• AMD I2C-over-AUX 读写：ADL_Display_DDCBlockAccess_Get
• NVIDIA DPCD/I2C-over-AUX 读写：NvAPI_Disp_DpAuxChannelControl
• Intel DPCD/I2C-over-AUX 读写：ctlAUXAccess
• 以 backend、GPU index 和显示目标 ID 区分多个 DP/eDP 端口

公开 GPU API 参考：

• AMD ADL SDK：AMD Display Library； DDC/I2C 入口见 I2C, DDC and EDID APIs。
• Intel IGCL：Programming Guide 和 Control API。
• NVIDIA NVAPI：NVAPI Reference Documentation。 本项目使用的 DP AUX 入口不在公开 nvapi.h 中声明，属于逆向确认的私有接口。

直接构造一个端口对象：

from gpu_aux import AuxPort

with AuxPort("DP", index=0, gpu_index=0, backend="NVIDIA") as dp:
    print(dp.read_dpcd(0x00000, 16).hex(" "))
    edid = dp.i2c_read(0x50, 0, 128)

GPU 与端口枚举是两个独立的模块级函数，不需要先创建 AuxPort：

from gpu_aux import enumerate_gpus, enumerate_ports

for gpu_index, gpu in enumerate(enumerate_gpus("NVIDIA")):
    print(gpu_index, gpu.backend, gpu.name)
    for port in enumerate_ports("NVIDIA", gpu_index):
        print(port.kind, port.identity, port.name)

index 是同一 GPU、同一端口类型内的序号，例如第二个外接 DP 使用AuxPort("DP", index=1, gpu_index=0, backend="NVIDIA")。

多个同后端 AuxPort对象共享同一 context，并在最后一个对象关闭时释放。后端必须由调用方显式指定，不会自动选择。

测试

从项目根目录运行只读测试：

python .\tests\smoke_test.py NVIDIA
python .\tests\smoke_test.py INTEL

读写硬件测试会向 DPCD 0x00102 写入 C0、回读并恢复原值，同时通过 I2C 地址 0x30/0x50 读取 EDID：

python .\tests\hardware_aux_test_nvidia.py

AMD 写测试使用独立入口：

python .\tests\hardware_aux_test_amd.py

Intel 写测试也使用独立入口：

python .\tests\hardware_aux_test_intel.py

私有 ADL/NVAPI AUX 接口可能随显卡驱动变化；Intel 路径使用公开 IGCL ctlAUXAccess。当前实现要求 Windows x64、64 位 Python、AMD/NVIDIA/Intel DP/eDP 链路；包内会串行化 AUX 事务。