这里关注 amdgpu 的 lib 库实现把lib/amdgpu这一整套 AMD GPU 测试基础库讲清楚它解决什么问题、如何分层、模块之间怎么依赖。读完本篇你应该能在脑子里画出「一条 GPU 命令从测试用例出发一路走到硬件」的完整链路并知道每一段代码住在哪个文件里。一、lib/amdgpu是什么在哪一层IGTigt-gpu-tools是 DRM 内核驱动的用户态测试套件。AMD 相关的测试代码分两处tests/amdgpu/放具体的测试用例subtestslib/amdgpu/放这些用例共享的基础设施。二者的关系以及它们与更底层库、内核的关系是这样一条分层链tests/amdgpu/*.c 测试用例定义 igt_subtest断言行为是否正确 │ 调用 lib/amdgpu/*.c 本篇主角BO 管理、PM4 组装、命令提交、compute dispatch、ASIC 抽象 │ 调用 libdrm (libdrm_amdgpu) amdgpu_device_handle / amdgpu_bo_alloc / amdgpu_cs_submit 等 uAPI 封装 │ ioctl kernel amdgpu / DRM 真正的驱动最终驱动硬件一句话概括每层的职责tests决定「测什么、断言什么」lib决定「怎么把一个 GPU 操作正确地构造并提交出去」libdrm是内核 ioctl 的薄封装内核驱动才真正接触硬件。本篇只聚焦lib/amdgpu——它是理解 AMD IGT 的关键因为几乎所有测试用例的「重活」都在这里完成。二、为什么需要这样一个 lib三个绕不开的难题直接用 libdrm 写一个 GPU 测试会立刻撞上三个问题而lib/amdgpu的模块划分正是对这三个问题的回答。难题 1GPU 命令是二进制 packet不是函数调用。要让 GPU 干活你得往一段内存里按 PM4Programmable Machine 4AMD 的命令流格式或 SDMA 格式逐个 32-bit dword 拼出 packet再把这段内存作为「IBIndirect Buffer」提交。手拼 packet 极易错。→ 对应amd_PM4.hcmd_base。难题 2寄存器布局、dispatch 细节随 ASIC 变化。GFX9、GFX10、GFX11、GFX12 的 SH 寄存器偏移、dispatch initiator、compute pipeline 编程方式各不相同。如果每个测试都写死某代硬件的魔数加一款新 ASIC 就要改一大片。→ 对应amd_ip_blocks.*这套 ASIC 无关抽象。难题 3一次提交有大量固定样板。分配 IB BO、建 BO list、创建 context、submit、等 fence、清理——每次都一样。→ 对应amd_command_submission.*的提交框架。三、主线一次 GPU 命令提交都经过谁把这三块串起来一次典型的「用 compute shader 把一个 DWORD 从 src 拷到 dst」大致要走这些步骤。这条主线贯穿本篇提到的各模块。1.拿 ASIC 操作表get_ip_block(device,AMD_IP_COMPUTE)amd_ip_blocks2.分配内存/BOamdgpu_bo_alloc_and_map(...)amd_memory3.组装 PM4 base-emit(...)/dispatch_init/write2hw amd_PM4/compute_utils4.提交并等待amdgpu_test_exec_cs_helper(...)command_submission5.校验结果 读回 dst断言值正确 tests 层其中第 3 步的「compute pipeline 怎么编程」是compute_utils/的领域shader 本身的二进制从哪来是shaders/的领域。四、模块地图按职责把lib/amdgpu下的文件分成六组外加专项测试与 SVM。核心基础设施文件职责amd_ip_blocks.{c,h}ASIC 无关抽象核心get_ip_block、amdgpu_ip_funcs操作表、amdgpu_ring_contextamd_ip_blocks_ex.c各 familygfx9/10/11/12的funcs具体实现按family_id挂载amd_gfx_v8_0.c/amd_gfx_v9_0.cget_reg_offset()SH 寄存器偏移表amd_PM4.h/amd_sdma.h/amd_registers.h/amd_family.hpacket 宏、寄存器枚举、family 判定宏内存文件职责amd_memory.{c,h}BO 分配/映射/释放、BO list、dmabuf、内存信息查询amd_mem_leak.{c,h}基于 kmemleak 的内核内存泄漏检测命令提交文件职责amd_command_submission.{c,h}amdgpu_test_exec_cs_helper、cmd_context_tAPI、write/copy/fill helperamd_compute.c/amd_gfx.cNOP / IB 提交类场景测试Compute Dispatchcompute_utils/文件职责amd_dispatch_helpers.{c,h}amdgpu_dispatch_init/write_cumask/write2hw、execute_compute_dispatchamd_dispatch.c/amd_gca.c面向 test 的高层 dispatch 用例含 hang 测试Shadershaders/文件职责amd_shaders.c/amd_llvm_asm*.h运行时 LLVM 汇编 ISA、family_id → mcpu映射、预编译 shader专项测试文件职责amd_cp_dma.*CP DMA 拷贝与 P2Pamd_deadlock_helpers.*死锁/队列 resetamd_pci_unplug.*PCI 热插拔amd_shared_process.*/amd_cs_radv.*多进程共享 / RADV 风格提交amd_vcn_shared.*/amd_jpeg_shared.*/amd_mmd_shared.*多媒体引擎VCN/JPEG测试脚手架amd_utils.*/xalloc.h计时日志、分配包装等杂项SVM文件职责amd_svm.{c,h}GEM_SVM ioctl 包装 svm_compute_copy_dispatch五、依赖关系图模块不是平级的存在清晰的自底向上依赖。理解这张图就能判断「一个功能该复用谁、不该重造谁」。tests/amdgpu/*command_submissioncompute_utils专项测试模块amd_svmamd_ip_blocks核心抽象amd_memory / shaderslibdrm (libdrm_amdgpu)kernel amdgpu关键观察amd_ip_blocks和amd_memory是几乎所有上层模块的公共底座command_submission与compute_utils是「提交」和「compute 组包」两条相对独立的支线测试用例按需组合它们。