ROCm 7.14 Radeon GPU 兼容性矩阵全解析：架构、LLVM Target、操作系统与驱动支持速查

ROCm 7.14 Radeon GPU 兼容性矩阵全解析：架构、LLVM Target、操作系统与驱动支持速查

【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build

在 legacy-rocm-build 仓库的 ROCm 官方文档中，docs/compatibility/include/system-radeon.rst 是面向AMD Radeon™ 显卡用户的权威兼容性清单：它精确回答了"你的 Radeon 显卡能否运行当前版本 ROCm、对应哪个架构与 LLVM target、支持哪些操作系统、配套哪个版本的 amdgpu/Adrenalin 驱动"等安装前必须确认的问题。读完本文，你将能够对照该矩阵快速核对自己的 Radeon 硬件与系统环境，并借助仓库中安装文档给出的命令完成从驱动到 ROCm 核心包的部署。

本文以该矩阵为主体展开，并结合作答其在仓库中的渲染机制（matrix 指令实现）与配套安装文档（gpu-selector.rst、os-selector.rst、200-install.rst）进行纵深补充。

兼容性矩阵在文档体系中的位置

system-radeon.rst并非独立页面，而是被嵌入到总览页面 docs/compatibility/compatibility-matrix.rst 的 "System requirements and information" 一节中。该页面顶部提供一个设备族选择器（Device family），可选 AMD Instinct™、AMD Radeon™、AMD Ryzen™，随后通过.. include::分别引入：

• system-instinct.rst（fam=instinct）
• system-radeon.rst（fam=radeon，本文主体）
• system-ryzen.rst（fam=ryzen）

也就是说，只有在选择 "AMD Radeon™" 设备族时，本文描述的矩阵才会被渲染显示。矩阵内部还进一步依赖gpu=...与os=...条件，只有同时匹配用户所选 GPU 与操作系统时，对应单元格才出现——这是一个高度定制化的条件表格。

从源码结构看，这套矩阵由仓库自定义的 Sphinx 指令实现：docs/extension/rocm_docs_custom/matrix/init.py 中注册了matrix、matrix-row、matrix-cell等指令。其中show-cond选项（如:show-cond: fam=radeon、:show-cond: gpu=ai-r9700s gpu=ai-r9700）会被解析为data-show-cond属性写到生成的<table>/<tr>/<td>标签上，再由前端选择器（selector 扩展）根据用户交互动态显示或隐藏行列。因此文档中看到的"表格"本质是前端实时过滤后的视图，理解这一点有助于你正确阅读矩阵。

支持的 Radeon GPU 系列与架构

矩阵第一行按"AMD GPU series"列出当前 ROCm 版本（文档流对应 ROCm 7.14.0，见 docs/release/versions.rst）支持的 Radeon 显卡系列，第二行给出对应 GPU 架构：

几点关键观察：

• 消费级与工作站/专业级统一支持：矩阵同时覆盖 Radeon RX（消费桌面卡）与 Radeon PRO / AI PRO（工作站与 AI 计算卡）两条产品线，说明当前 ROCm 对 Radeon 的定位是"计算工作负载（w=compute）与图形工作负载（w=graphics）兼顾"。
• RDNA 2/3/4 三代同堂：从 RDNA 2（W6800、V620）到最新的 RDNA 4（AI PRO R9000、RX 9000）均受支持，但不支持更老的 RDNA 1 及更早架构，升级老显卡前务必核对这一行。
• 上述系列分类与 GPU 下拉选择器 docs/install/include/gpu-selector.rst 中的 Radeon GPU 选项一一对应（每个选项还携带gfx=...标记），安装环境选择器正是以这些取值为联动依据。

LLVM target（gfx）对照表

矩阵第三行给出每个 GPU 对应的LLVM target（即 HIP/编译器后端使用的 gfx 代号）。这是安装-gfxXXX专用元包、编译 HIP 代码时最关键的参数：

细节解读：

• gfx1201 与 gfx1200 同属 RDNA 4：RX 9070 系（gfx1201）与 RX 9060 系（gfx1200）虽然都是 RDNA 4，但 LLVM target 不同，编译与安装时需区分。AI PRO R9000 系列统一为 gfx1201。
• RDNA 3 拆成 gfx1100 / gfx1101 / gfx1102 三个 target：RX 7900 系与 PRO W7000 高端卡为 gfx1100，RX 7800 XT / 7700 系与 W7700 / V710 为 gfx1101，RX 7600 为 gfx1102。
• gfx 代号与 system-instinct.rst 中的 CDNA 系（gfx950/gfx942/gfx90a/gfx908）编号体系一致，均来自 LLVM 对 AMDGPU 后端的命名。

在安装层面，这一列直接决定了你要装的 ROCm 元包：例如 docs/install/include/200-install.rst 中，Ubuntu/Debian 上安装amdrocm7.14-gfx1201或amdrocm7.14-gfx1100等针对具体 gfx 的元包，而不是通用的amdrocm7.14。选择与你显卡 gfx target 一致的元包，可以避免安装无用组件并减少潜在冲突。

操作系统支持矩阵

矩阵按操作系统分别列出支持版本，并标注了对应的内核（kernel）：

Ubuntu（os=ubuntu）

RHEL（os=rhel）

Windows（os=windows）

• Windows 11 25H2

需要结合 docs/install/include/os-selector.rst 才能正确理解上述版本矩阵的适用范围——并非所有 Radeon 显卡都支持全部操作系统，选择器对每类 gfx 做了进一步裁剪：

• gfx1201 / gfx1200（RDNA 4）：AI PRO R9700 系与 RX 9070 / RX 9060 支持 Ubuntu、RHEL、Windows，其中 R9700S / R9700 / RX 9070 系还可选WSL2；而 AI PRO R9600D、RX 9060 XT LP 仅支持 Ubuntu / RHEL / Windows（无 WSL2）。
• gfx1100（RDNA 3 高端）：支持 Ubuntu、RHEL、Windows、WSL2。
• gfx1102（RX 7600）：支持 Ubuntu、RHEL、Windows（无 WSL2）。
• gfx1101：PRO V710 仅支持 Ubuntu / RHEL；PRO W7700 与 RX 7800 XT 支持 Ubuntu / RHEL / Windows / WSL2；RX 7700 XT / RX 7700 支持 Ubuntu / RHEL / Windows。
• gfx1030（PRO W6800 / V620）：仅支持 Ubuntu / RHEL 两个 Linux 发行版，不支持 Windows。

同时注意，Ubuntu 26.04 / 24.04.4 / 22.04.5 与 RHEL 10.2 / 9.8 均指 GA（General Availability）内核；如果发行版后续更新了 HWE 或升级内核，需以矩阵标注的版本为对齐基准。对于 Ryzen APU（Radeon 核显）场景，docs/install/include/100-prerequisites.rst 还特别要求 Ubuntu 24.04 上安装 OEM 内核 6.14（sudo apt install linux-oem-24.04c），这是 Radeon 独显矩阵之外的重要补充。

驱动版本支持

矩阵对 Linux 与 Windows 分别列出配套驱动：

Linux：AMD GPU Driver（amdgpu）版本（Ubuntu / RHEL 共用）

支持以下 amdgpu 驱动版本（数字越小越旧，列表按新到旧排列）：

31.40.1、31.40.0、31.30.0、31.20.0、31.10.0、30.30.3、30.30.2、30.30.1、30.30.0、30.20.1、30.20.0、30.10.2、30.10.1、30.10.0

• 矩阵同时覆盖Instinct 与 Radeon（system-instinct.rst 中给出完全相同的 amdgpu 版本清单），说明 Radeon 与 Instinct 在 Linux 上共用 amdgpu 内核驱动栈。
• 当前文档流对应的 amdgpu 版本为31.40.1：在 docs/install/include/200-install.rst 中，Ubuntu/RHEL 下载amdgpu-install脚本均指向 31.40.1（如 Ubuntu 24.04 的amdgpu-install_31.40.1.314001-1_all.deb、RHEL 9 的amdgpu-install-31.40.1.314001-1.el9.noarch.rpm）。

Windows：Adrenalin 与 OEM 驱动

• AMD Software: Adrenalin Edition：26.6.4（Radeon 独显与 Ryzen APU 矩阵均引用同一版本）。
• Windows OEM 驱动：26.10.28（OEM 预装或厂商定制渠道）。

条件渲染机制：矩阵是如何"动起来"的

system-radeon.rst中的每一行、每一格都带有:show-cond:条件，例如架构行的:show-cond: gpu=ai-r9700s gpu=ai-r9700 gpu=ai-r9600d ...，其含义是"当选择器状态满足其中任意一个 GPU 取值时显示 RDNA 4 单元格"。这套机制的底层实现在 docs/extension/rocm_docs_custom/matrix/init.py：

• .. matrix::指令生成一个带rocm-docs-table table类的<table>，并把:show-cond:转成data-show-cond属性（kv_to_data_attr负责键值解析）。
• .. matrix-row::支持show-cond/disable-cond，.. matrix-cell::支持header、colspan、rowspan、show-cond，渲染为<tr>与<th>/<td>。
• 行级:header:标记会把该行所有单元格提升为表头（<th>），这就是矩阵左侧 "AMD GPU series / Architecture / LLVM target / Supported Ubuntu versions ..." 的由来。
• 最终的显隐过滤由前端 selector 扩展 配合 selector.js 完成：用户在下拉框中选择 GPU 与操作系统后，页面按data-show-cond匹配并展示对应子集。

从源码结构可以推断：同一份 RST 源文件同时服务多种环境组合（六类 GPU × 三类操作系统），无需为每种组合维护单独页面，这正是指令化文档的优势，也意味着阅读时务必确认当前选择器状态，避免把"某型号在某 OS 下的支持"误读为全局支持。

用矩阵指导安装：从查表到落地

兼容性矩阵是安装前的"第一道检查"，确认你的 Radeon 显卡与系统组合在矩阵内之后，可按 docs/install/include/200-install.rst 完成部署。安装方式共四种（详见 docs/install/include/050-install-methods.rst）：包管理器（apt/dnf/zypper）、pip、tarball、runfile。下面以最常见的 Linux 包管理器路径为例：

1. 确认兼容性：对照 docs/compatibility/compatibility-matrix.rst（GPU 系列、LLVM target、OS、驱动版本四列逐一核对）。
2. 安装内核驱动：Radeon 设备需安装 AMD GPU Driver（amdgpu），例如 Ubuntu 上先安装amdgpu-install脚本（31.40.1），再按官方 amdgpu 文档完成驱动安装；runfile 方式则直接bash rocm-installer-7.14.0-7.run deps=install amdgpu，安装驱动后需重启。
3. 配置 GPU 访问权限（docs/install/include/100-prerequisites.rst 提供两种方式）：
   • 用户组方式：sudo usermod -a -G render,video $LOGNAME
   • udev 规则方式（系统级、无需管理用户组）：

     sudo tee /etc/udev/rules.d/70-amdgpu.rules << EOF KERNEL=="kfd", GROUP="render", MODE="0666" SUBSYSTEM=="drm", KERNEL=="renderD*", GROUP="render", MODE="0666" EOF sudo udevadm control --reload-rules sudo udevadm trigger

   配置后重启系统生效。

4. 注册 ROCm 仓库并安装元包：Ubuntu 示例为写入/etc/apt/sources.list.d/rocm.list并sudo apt install amdrocm7.14-gfx1201（请替换为你显卡对应的 gfx target，参见上文 LLVM target 表）；RHEL 系则写入/etc/yum.repos.d/rocm.repo并sudo dnf install amdrocm7.14-gfx1100等。

边界与注意事项

• 版本对齐是硬约束：ROCm 依赖固件、内核驱动、用户态组件三者协同（见 compatibility-matrix.rst 对 "coordinated stack" 的说明），尤其对数据中心产品，层间版本错位可能导致 GPU 行为异常或性能不达预期。Radeon 独显同样建议驱动与 ROCm 版本保持矩阵内的组合。
• gfx target 不可混用：编译 HIP 代码与安装元包时使用错误 gfx 代号会导致运行时找不到匹配的设备库；本矩阵是权威对照来源。
• WSL2 支持仅限部分型号：RDNA 4 高端卡与 gfx1100、部分 gfx1101 型号支持 WSL2，老型号（gfx1030 等）与部分 RDNA 4 型号不支持，需在 os-selector.rst 中逐型号确认。
• Windows 生态独立：Windows 下驱动体系是 Adrenalin 26.6.4 / OEM 26.10.28，与 Linux 的 amdgpu 版本号互不通用；安装前需按 100-prerequisites.rst 先卸载旧 HIP SDK、关闭 WDAG 与 SAC 等安全特性。
• 若需查询显卡硬件规格（显存、计算单元、带宽等），可继续参考 docs/reference/gpu-specs.rst；该矩阵仅负责"支持性"确认。

【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build