ROCm 安装向导中的 GPU Selector 深度解析Instinct / Radeon / Ryzen 显卡与 gfx 架构映射全指南【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build本文聚焦 AMD ROCm 官方文档legacy-rocm-build 仓库中负责选择硬件的核心交互组件——gpu-selector.rst。它是一份把 AMD Instinct 数据中心 GPU、Radeon 显卡与 Ryzen AI APU 逐一映射到对应 gfx 微架构代号如 gfx950、gfx942、gfx90a的声明式配置直接驱动安装页面的显卡下拉菜单、兼容性矩阵的按卡筛选以及架构专属安装包如amdrocm7.14-gfx950的命令生成。读完本文你将掌握ROCm 文档选择器的层级结构与取值语义、三大显卡家族Instinct / Radeon / Ryzen的完整 gfx 映射表、这些绑定如何在安装流程与兼容性表格中被消费以及底层选择器引擎Python Sphinx 扩展 前端 JavaScript 状态机的实现原理。一、背景为什么需要 GPU 选择器ROCm 软件栈覆盖的硬件跨度极大——从数据中心级的 AMD Instinct 加速卡到消费级 Radeon 显卡再到集成 GPU 的 Ryzen AI APU。不同硬件对应不同的驱动、固件、支持矩阵甚至不同的安装包。如果让读者在数百行表格中自行定位体验和准确性都无法保证。为此docs/install/rocm.rstROCm 安装总入口在安装方法介绍之后串联了如下一组选择器组件第 3456 行的 include 顺序即级联顺序.. include:: ./include/fam-multi-arch-selector.rst ; 设备家族 用途 .. include:: ./include/gpu-selector.rst ; 具体 GPU / APU 型号 .. include:: ./include/os-selector.rst ; 操作系统 .. include:: ./include/ror-gpu-selector.rst ; Windows 图形用途的 GPU .. include:: ./include/ubuntu-ver-selector.rst ; 发行版版本 .. include:: ./include/install-method-selector.rst ; 安装方式同一份gpu-selector.rst还被复用到了 docs/compatibility/compatibility-matrix.rst兼容性矩阵页和 docs/components/hpc-sdk/install.rstHPC SDK 安装页。也就是说这是一份一次编写、多处复用的硬件目录。二、gpu-selector.rst 的结构与取值语义完整源文件位于 docs/install/include/gpu-selector.rst。其顶层结构分为两个嵌套的selected条件块与三个selector-dropdown下拉组.. selected:: wcompute .. selected:: faminstinct famradeon famryzen .. selector-dropdown:: Instinct GPU :key: gpu :show-cond: faminstinct :sort: desc ...10 个 selector-option .. selector-dropdown:: Radeon GPU :key: gpu :show-cond: famradeon :sort: desc ...23 个 selector-option .. selector-dropdown:: Ryzen APU :key: gpu :show-cond: famryzen :sort: desc ...56 个 selector-option2.1 嵌套条件何时显示外层.. selected:: wcompute整个 GPU 选择器只在用途 compute计算时渲染。当用户选择Mixed graphics and compute时安装页改用 docs/install/include/ror-gpu-selector.rstRadeon 与 Ryzen 的 Windows 图形用途变体不包含 Instinct。内层.. selected:: faminstinct famradeon famryzen设备家族限定为三类famall全部时同样不显示具体型号下拉因为跨家族混选没有单一 gfx 架构可言。每个下拉还带:show-cond:Instinct GPU 下拉要求faminstinctRadeon GPU 下拉要求famradeonRyzen APU 下拉要求famryzen——实现选择家族后只出现对应下拉的联动。2.2 下拉组选项选项说明:key: gpu该下拉组对应的选择器主键。所有选项共享gpu键页面全局同时只保留一个gpu取值:show-cond: faminstinct满足fam键为对应值时才显示该下拉:sort: desc对选项按显示名称做降序排序实现见下文_SelectorGroupBase.run2.3 选项 value 的一值两用语法每个selector-option的:value:是最核心的语法例如.. selector-option:: AMD Instinct MI355X (gfx950) :value: mi355x gfxgfx950:value:接受一个裸值 若干keyvalue额外绑定。从 docs/extension/rocm_docs_custom/selector/init.py 的SelectorOptionDirective.run约第 357373 行可以看到精确解析规则:value:允许一个可选的裸值后跟额外的 keyvalue 绑定例如:value: mi355x gfxgfx950 archcdna3。第一个不含的 token 是选项自身的取值其余 token 在选中该选项时设置额外的选择器键。mi355x写入gpu主键的值经过normalize_key归一化转小写、空格变下划线、去首尾空白见 docs/extension/rocm_docs_custom/utils.pygfxgfx950额外绑定extra binding选中该选项后自动把gfx键设为gfx950。额外绑定会被序列化为 JSON 存进data-selector-extra-bindings属性见SelectorOption.visit_html中json.dumps(extra_bindings)的渲染逻辑。正是这条gfxgfx950绑定把用户选了哪张卡直接翻译成底层 gfx 架构进而驱动安装命令与兼容性内容——这是整个文件最有价值的设计。三、完整支持清单三大家族的 gfx 架构映射以下三张表完整继承自gpu-selector.rst排序与原文一致sort: desc仅影响页面展示顺序。gpu 值即:value:中的裸值gfx 绑定即gfxgfxXXXX额外绑定。3.1 AMD Instinctfaminstinct仅计算用途gfx 架构产品型号gpu 值gfx950AMD Instinct MI355Xmi355xgfx950AMD Instinct MI350Xmi350xgfx950AMD Instinct MI350Pmi350pgfx942AMD Instinct MI325Xmi325xgfx942AMD Instinct MI300Xmi300xgfx942AMD Instinct MI300Ami300agfx90aAMD Instinct MI250Xmi250xgfx90aAMD Instinct MI250mi250gfx90aAMD Instinct MI210mi210gfx908AMD Instinct MI100mi1003.2 AMD Radeonfamradeongfx 架构产品型号gpu 值gfx1201AMD Radeon AI PRO R9700Sai-r9700sgfx1201AMD Radeon AI PRO R9700ai-r9700gfx1201AMD Radeon AI PRO R9600Dai-r9600dgfx1201AMD Radeon RX 9070 XTrx-9070-xtgfx1201AMD Radeon RX 9070 GRErx-9070-gregfx1201AMD Radeon RX 9070rx-9070gfx1200AMD Radeon RX 9060 XT LPrx-9060-xt-lpgfx1200AMD Radeon RX 9060 XTrx-9060-xtgfx1200AMD Radeon RX 9060rx-9060gfx1100AMD Radeon PRO W7900 Dual Slotw7900-dual-slotgfx1100AMD Radeon PRO W7900w7900gfx1100AMD Radeon PRO W7800 48GBw7800-48gbgfx1100AMD Radeon PRO W7800w7800gfx1100AMD Radeon RX 7900 XTXrx-7900-xtxgfx1100AMD Radeon RX 7900 XTrx-7900-xtgfx1100AMD Radeon RX 7900 GRErx-7900-gregfx1101AMD Radeon PRO W7700w7700gfx1101AMD Radeon RX 7800 XTrx-7800-xtgfx1101AMD Radeon RX 7700 XTrx-7700-xtgfx1101AMD Radeon RX 7700rx-7700gfx1101AMD Radeon PRO V710v710gfx1102AMD Radeon RX 7600rx-7600gfx1030AMD Radeon PRO W6800w6800gfx1030AMD Radeon PRO V620v6203.3 AMD Ryzen APUfamryzengfx 架构产品型号gpu 值gfx1151AMD Ryzen AI Max PRO 495max-plus-pro-495gfx1151AMD Ryzen AI Max PRO 490max-pro-490gfx1151AMD Ryzen AI Max PRO 485max-pro-485gfx1151AMD Ryzen AI Max PRO 395max-pro-395gfx1151AMD Ryzen AI Max PRO 390max-pro-390gfx1151AMD Ryzen AI Max PRO 385max-pro-385gfx1151AMD Ryzen AI Max PRO 380max-pro-380gfx1151AMD Ryzen AI Max 395max-395gfx1151AMD Ryzen AI Max 392max-392gfx1151AMD Ryzen AI Max 388max-388gfx1151AMD Ryzen AI Max 390max-390gfx1151AMD Ryzen AI Max 385max-385gfx1150AMD Ryzen AI 9 HX PRO 475ai-9-hx-pro-475gfx1150AMD Ryzen AI 9 HX PRO 470ai-9-hx-pro-470gfx1150AMD Ryzen AI 9 PRO 465ai-9-pro-465gfx1150AMD Ryzen AI 7 PRO 450ai-7-pro-450gfx1150AMD Ryzen AI 5 PRO 440ai-5-pro-440gfx1150AMD Ryzen AI 5 PRO 435ai-5-pro-435gfx1150AMD Ryzen AI 9 HX 475ai-9-hx-475gfx1150AMD Ryzen AI 9 HX 470ai-9-hx-470gfx1150AMD Ryzen AI 9 465ai-9-465gfx1150AMD Ryzen AI 7 450ai-7-450gfx1150AMD Ryzen AI 9 HX PRO 3759-hx-pro-375gfx1150AMD Ryzen AI 9 HX PRO 3709-hx-pro-370gfx1150AMD Ryzen AI 7 PRO 350ai-7-pro-350gfx1150AMD Ryzen AI 5 PRO 340ai-5-pro-340gfx1150AMD Ryzen AI 9 HX 3759-hx-375gfx1150AMD Ryzen AI 9 HX 3709-hx-370gfx1150AMD Ryzen AI 9 3659-365gfx1150AMD Ryzen AI 7 350ai-7-350gfx1150AMD Ryzen AI 7 345ai-7-345gfx1150AMD Ryzen AI 5 435ai-5-435gfx1150AMD Ryzen AI 5 430ai-5-430gfx1150AMD Ryzen AI 7 445ai-7-445gfx1150AMD Ryzen AI 5 340ai-5-340gfx1150AMD Ryzen AI 5 330ai-5-330gfx1103AMD Ryzen 7 PRO 2507-pro-250gfx1103AMD Ryzen 5 PRO 2305-pro-230gfx1103AMD Ryzen 5 PRO 2205-pro-220gfx1103AMD Ryzen 5 PRO 2155-pro-215gfx1103AMD Ryzen 3 PRO 2103-pro-210gfx1103AMD Ryzen 9 2709-270gfx1103AMD Ryzen 7 2607-260gfx1103AMD Ryzen 7 2507-250gfx1103AMD Ryzen 5 2405-240gfx1103AMD Ryzen 5 2305-230gfx1103AMD Ryzen 5 2205-220gfx1103AMD Ryzen 3 2103-210上表按源文件顺序整理。gfx1152 与 gfx1153 的条目在源文件中分散出现此处按 gfx 分组展示以便阅读。值得注意的细节gpu值命名并不完全一致——gfx1151 全部带max前缀、gfx1150 早期条目带ai-前缀而后期条目如9-hx-375、9-365省略前缀、gfx1103 条目直接以数字开头。这表明gpu值是纯文档内部的标识符唯一约束是全局唯一读者不应依赖前缀命名规律。四、gfx 绑定如何驱动安装与兼容性内容gpu-selector.rst本身不写任何安装命令它的价值在于把选择结果广播给同页其他消费方。4.1 生成架构专属安装包命令在 docs/install/include/200-install.rst 中安装命令按gfx键分派约第 807 行起.. selected:: gfxgfx950 .. code-block:: bash sudo apt install amdrocm7.14-gfx950 .. selected:: gfxgfx942 .. code-block:: bash sudo apt install amdrocm7.14-gfx942文件中共出现 15 组gfxgfxXXXX条件块覆盖gfx950 / gfx942 / gfx90a / gfx908 / gfx1201 / gfx1200 / gfx1100 / gfx1101 / gfx1102 / gfx1103 / gfx1030 / gfx1151 / gfx1150 / gfx1152 / gfx1153。也就是说用户在下拉框里选中 AMD Instinct MI355Xgpumi355x触发gfxgfx950绑定页面随即只显示sudo apt install amdrocm7.14-gfx950——选择一张卡得到正确架构的安装命令。这正是 docs/install/rocm.rst 第 2024 行所说的用选择器选择你的安装方法、受支持的 AMD GPU/APU 与操作系统的落地实现。4.2 过滤兼容性矩阵同一份选择器被 include 进 docs/compatibility/compatibility-matrix.rst第 33 行矩阵中的系统要求表格则用gpu条件做精确过滤例如 docs/compatibility/include/system-instinct.rst:show-cond: gpumi355x gpumi350x gpumi350p :show-cond: gpumi325x gpumi300x gpumi300adocs/compatibility/include/system-radeon.rst 与 docs/compatibility/include/system-ryzen.rst 同理docs/compatibility/include/core-sdk-components-linux.rst 则用长串gpu列表界定支持核心 SDK 组件的硬件范围。这里的条件键是gpu而非gfx说明消费方可以根据需要选择不同粒度gpu精确到型号gfx精确到架构代系。五、选择器引擎实现原理gpu-selector.rst依赖的指令与前端逻辑全部位于仓库内可以逐层验证。5.1 Sphinx 指令层Python核心实现在 docs/extension/rocm_docs_custom/selector/init.pySelectorDropdownDirective.. selector-dropdown::继承_SelectorGroupBase声明key、show-cond、heading-width、sort四个选项_is_dropdown True使其渲染为select classform-select rocm-docs-selector-dropdown-input并通过roleradiogroup/roleradio保持无障碍语义。排序run()中当sort为asc/desc时按选项 label 排序并原地重排子节点非法值直接raise self.error。默认值若某组没有任何:default:选项自动把第一个选项设为默认option_nodes[0][default] True保证状态机永远有合法选中项。SelectorOptionDirective.. selector-option::解析:value:的裸值 额外绑定width经_parse_width校验支持 112 栅格列或 0~100% 百分比非法值回退默认 6。SelectedContentDirective.. selected::渲染条件内容容器把祖先链上的所有show-cond用合并为combined-show-cond如wcomputefaminstinct便于前端一次性判定嵌套条件。setup()注册全部指令并接入env-purge-doc/env-updated/html-page-context等 Sphinx 事件用于注入静态资源tom-select 下拉组件、selector.js、selector.css与侧边栏 TOC 组件。5.2 前端状态机层JavaScript前端逻辑在 docs/extension/rocm_docs_custom/selector/static/selector.js约 628 行全局状态state对象保存所有键值setState/deleteStateKeys负责更新。三重持久化syncStateToURL用history.replaceState把状态写入 URL query如?faminstinctwcomputegpumi300xgfxgfx942可直接分享/书签syncStateToLocalStorage以rocm-docs-selector-state为键持久化另有一个isBatchingState批量标志保证每次交互只同步一次。条件判定matchesConditions逐键比对支持字符串与数组两种期望值状态键未定义即视为不匹配。data-show-cond控制显示/隐藏data-disable-cond控制禁用。额外绑定生命周期reapplyAllExtraBindings从所有已选中且可见的选项收集额外绑定并写回 state同时通过extraBindingKeys集合清理过期绑定特别用primarySelectorKeys保护主键不被误删源码注释举了例子Instinct 选项把wcompute作为额外绑定切换家族到 Radeon 时不得因此删除w键因为可见的 Use case 选择器仍拥有w主键。可见性协调reconcileGroupSelections保证每组始终有合法选中项——若当前选中项因上级选择器变化而失效自动挑选替代项隐藏组的键会从 state 与 URL 中清除。MAX_VISIBILITY_CYCLES 5用于防御循环依赖导致的无限协调。5.3 与上游选择器的衔接gpu-selector.rst依赖的fam与w两个前置键来自 docs/install/include/fam-multi-arch-selector.rstDevice familykey: fam选项 All / AMD Instinct / AMD Radeon / AMD Ryzen与Use casekey: w选项 Mixed graphics and compute / Compute。注意 Instinct 选项的:value: instinct wcompute——选中 Instinct 家族时通过额外绑定强制把用途设为 Compute因为数据中心卡只有计算用途而wgraphics场景则由 Windows 图形专用的 ror-gpu-selector.rst 承接仅 Radeon 与 Ryzen 两个下拉。六、维护视角如何读懂与扩展这份清单从文档维护的角度gpu-selector.rst是硬件目录的唯一事实来源新增一款受支持 GPU 时需要在如下层面保持同步仓库为只读以下仅为理解文档结构的方法论本文件在对应家族的下拉中新增selector-option给出唯一gpu裸值与正确的gfxgfxXXXX绑定安装命令层docs/install/include/200-install.rst 中新增对应的.. selected:: gfxgfxXXXX分派块前提是该架构需要独立安装包兼容性层docs/compatibility/include/system-*.rst 的系统要求行、core-sdk-components-linux.rst 的组件支持行需把新gpu值加入对应:show-cond:未收录硬件gpu-selector.rst只收录官方支持的型号。若某 GPU 不在列表中docs/install/rocm.rst 第 2632 行明确说明它可能通过 TheRock 社区 nightly 构建获得支持相关迁移说明见 docs/about/transition-guide-TheRock.md。七、总结gpu-selector.rst是一个教科书式的声明式文档联动案例用约 90 行 reStructuredText 把 89 款 AMD 产品组织成三族多级下拉每款产品通过:value: gpu gfxarch的紧凑语法同时写入型号级与架构级两个状态键上游由fam/w决定可见性下游由gpu/gfx驱动安装包命令、兼容性矩阵与系统要求表格。理解这份文件等于同时理解了 ROCm 的硬件支持边界gfx950→gfx908 的 Instinct 四代、gfx1201→gfx1030 的 Radeon 五代、gfx1151→gfx1103 的 Ryzen APU 六代以及这套选择器机制从 Python 指令解析到前端状态同步的完整链路。若你的 GPU 不在清单内请先查阅 兼容性矩阵 与 TheRock 迁移指南 再决定安装路径。【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ROCm 安装向导中的 GPU Selector 深度解析：Instinct / Radeon / Ryzen 显卡与 gfx 架构映射全指南
ROCm 安装向导中的 GPU Selector 深度解析Instinct / Radeon / Ryzen 显卡与 gfx 架构映射全指南【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build本文聚焦 AMD ROCm 官方文档legacy-rocm-build 仓库中负责选择硬件的核心交互组件——gpu-selector.rst。它是一份把 AMD Instinct 数据中心 GPU、Radeon 显卡与 Ryzen AI APU 逐一映射到对应 gfx 微架构代号如 gfx950、gfx942、gfx90a的声明式配置直接驱动安装页面的显卡下拉菜单、兼容性矩阵的按卡筛选以及架构专属安装包如amdrocm7.14-gfx950的命令生成。读完本文你将掌握ROCm 文档选择器的层级结构与取值语义、三大显卡家族Instinct / Radeon / Ryzen的完整 gfx 映射表、这些绑定如何在安装流程与兼容性表格中被消费以及底层选择器引擎Python Sphinx 扩展 前端 JavaScript 状态机的实现原理。一、背景为什么需要 GPU 选择器ROCm 软件栈覆盖的硬件跨度极大——从数据中心级的 AMD Instinct 加速卡到消费级 Radeon 显卡再到集成 GPU 的 Ryzen AI APU。不同硬件对应不同的驱动、固件、支持矩阵甚至不同的安装包。如果让读者在数百行表格中自行定位体验和准确性都无法保证。为此docs/install/rocm.rstROCm 安装总入口在安装方法介绍之后串联了如下一组选择器组件第 3456 行的 include 顺序即级联顺序.. include:: ./include/fam-multi-arch-selector.rst ; 设备家族 用途 .. include:: ./include/gpu-selector.rst ; 具体 GPU / APU 型号 .. include:: ./include/os-selector.rst ; 操作系统 .. include:: ./include/ror-gpu-selector.rst ; Windows 图形用途的 GPU .. include:: ./include/ubuntu-ver-selector.rst ; 发行版版本 .. include:: ./include/install-method-selector.rst ; 安装方式同一份gpu-selector.rst还被复用到了 docs/compatibility/compatibility-matrix.rst兼容性矩阵页和 docs/components/hpc-sdk/install.rstHPC SDK 安装页。也就是说这是一份一次编写、多处复用的硬件目录。二、gpu-selector.rst 的结构与取值语义完整源文件位于 docs/install/include/gpu-selector.rst。其顶层结构分为两个嵌套的selected条件块与三个selector-dropdown下拉组.. selected:: wcompute .. selected:: faminstinct famradeon famryzen .. selector-dropdown:: Instinct GPU :key: gpu :show-cond: faminstinct :sort: desc ...10 个 selector-option .. selector-dropdown:: Radeon GPU :key: gpu :show-cond: famradeon :sort: desc ...23 个 selector-option .. selector-dropdown:: Ryzen APU :key: gpu :show-cond: famryzen :sort: desc ...56 个 selector-option2.1 嵌套条件何时显示外层.. selected:: wcompute整个 GPU 选择器只在用途 compute计算时渲染。当用户选择Mixed graphics and compute时安装页改用 docs/install/include/ror-gpu-selector.rstRadeon 与 Ryzen 的 Windows 图形用途变体不包含 Instinct。内层.. selected:: faminstinct famradeon famryzen设备家族限定为三类famall全部时同样不显示具体型号下拉因为跨家族混选没有单一 gfx 架构可言。每个下拉还带:show-cond:Instinct GPU 下拉要求faminstinctRadeon GPU 下拉要求famradeonRyzen APU 下拉要求famryzen——实现选择家族后只出现对应下拉的联动。2.2 下拉组选项选项说明:key: gpu该下拉组对应的选择器主键。所有选项共享gpu键页面全局同时只保留一个gpu取值:show-cond: faminstinct满足fam键为对应值时才显示该下拉:sort: desc对选项按显示名称做降序排序实现见下文_SelectorGroupBase.run2.3 选项 value 的一值两用语法每个selector-option的:value:是最核心的语法例如.. selector-option:: AMD Instinct MI355X (gfx950) :value: mi355x gfxgfx950:value:接受一个裸值 若干keyvalue额外绑定。从 docs/extension/rocm_docs_custom/selector/init.py 的SelectorOptionDirective.run约第 357373 行可以看到精确解析规则:value:允许一个可选的裸值后跟额外的 keyvalue 绑定例如:value: mi355x gfxgfx950 archcdna3。第一个不含的 token 是选项自身的取值其余 token 在选中该选项时设置额外的选择器键。mi355x写入gpu主键的值经过normalize_key归一化转小写、空格变下划线、去首尾空白见 docs/extension/rocm_docs_custom/utils.pygfxgfx950额外绑定extra binding选中该选项后自动把gfx键设为gfx950。额外绑定会被序列化为 JSON 存进data-selector-extra-bindings属性见SelectorOption.visit_html中json.dumps(extra_bindings)的渲染逻辑。正是这条gfxgfx950绑定把用户选了哪张卡直接翻译成底层 gfx 架构进而驱动安装命令与兼容性内容——这是整个文件最有价值的设计。三、完整支持清单三大家族的 gfx 架构映射以下三张表完整继承自gpu-selector.rst排序与原文一致sort: desc仅影响页面展示顺序。gpu 值即:value:中的裸值gfx 绑定即gfxgfxXXXX额外绑定。3.1 AMD Instinctfaminstinct仅计算用途gfx 架构产品型号gpu 值gfx950AMD Instinct MI355Xmi355xgfx950AMD Instinct MI350Xmi350xgfx950AMD Instinct MI350Pmi350pgfx942AMD Instinct MI325Xmi325xgfx942AMD Instinct MI300Xmi300xgfx942AMD Instinct MI300Ami300agfx90aAMD Instinct MI250Xmi250xgfx90aAMD Instinct MI250mi250gfx90aAMD Instinct MI210mi210gfx908AMD Instinct MI100mi1003.2 AMD Radeonfamradeongfx 架构产品型号gpu 值gfx1201AMD Radeon AI PRO R9700Sai-r9700sgfx1201AMD Radeon AI PRO R9700ai-r9700gfx1201AMD Radeon AI PRO R9600Dai-r9600dgfx1201AMD Radeon RX 9070 XTrx-9070-xtgfx1201AMD Radeon RX 9070 GRErx-9070-gregfx1201AMD Radeon RX 9070rx-9070gfx1200AMD Radeon RX 9060 XT LPrx-9060-xt-lpgfx1200AMD Radeon RX 9060 XTrx-9060-xtgfx1200AMD Radeon RX 9060rx-9060gfx1100AMD Radeon PRO W7900 Dual Slotw7900-dual-slotgfx1100AMD Radeon PRO W7900w7900gfx1100AMD Radeon PRO W7800 48GBw7800-48gbgfx1100AMD Radeon PRO W7800w7800gfx1100AMD Radeon RX 7900 XTXrx-7900-xtxgfx1100AMD Radeon RX 7900 XTrx-7900-xtgfx1100AMD Radeon RX 7900 GRErx-7900-gregfx1101AMD Radeon PRO W7700w7700gfx1101AMD Radeon RX 7800 XTrx-7800-xtgfx1101AMD Radeon RX 7700 XTrx-7700-xtgfx1101AMD Radeon RX 7700rx-7700gfx1101AMD Radeon PRO V710v710gfx1102AMD Radeon RX 7600rx-7600gfx1030AMD Radeon PRO W6800w6800gfx1030AMD Radeon PRO V620v6203.3 AMD Ryzen APUfamryzengfx 架构产品型号gpu 值gfx1151AMD Ryzen AI Max PRO 495max-plus-pro-495gfx1151AMD Ryzen AI Max PRO 490max-pro-490gfx1151AMD Ryzen AI Max PRO 485max-pro-485gfx1151AMD Ryzen AI Max PRO 395max-pro-395gfx1151AMD Ryzen AI Max PRO 390max-pro-390gfx1151AMD Ryzen AI Max PRO 385max-pro-385gfx1151AMD Ryzen AI Max PRO 380max-pro-380gfx1151AMD Ryzen AI Max 395max-395gfx1151AMD Ryzen AI Max 392max-392gfx1151AMD Ryzen AI Max 388max-388gfx1151AMD Ryzen AI Max 390max-390gfx1151AMD Ryzen AI Max 385max-385gfx1150AMD Ryzen AI 9 HX PRO 475ai-9-hx-pro-475gfx1150AMD Ryzen AI 9 HX PRO 470ai-9-hx-pro-470gfx1150AMD Ryzen AI 9 PRO 465ai-9-pro-465gfx1150AMD Ryzen AI 7 PRO 450ai-7-pro-450gfx1150AMD Ryzen AI 5 PRO 440ai-5-pro-440gfx1150AMD Ryzen AI 5 PRO 435ai-5-pro-435gfx1150AMD Ryzen AI 9 HX 475ai-9-hx-475gfx1150AMD Ryzen AI 9 HX 470ai-9-hx-470gfx1150AMD Ryzen AI 9 465ai-9-465gfx1150AMD Ryzen AI 7 450ai-7-450gfx1150AMD Ryzen AI 9 HX PRO 3759-hx-pro-375gfx1150AMD Ryzen AI 9 HX PRO 3709-hx-pro-370gfx1150AMD Ryzen AI 7 PRO 350ai-7-pro-350gfx1150AMD Ryzen AI 5 PRO 340ai-5-pro-340gfx1150AMD Ryzen AI 9 HX 3759-hx-375gfx1150AMD Ryzen AI 9 HX 3709-hx-370gfx1150AMD Ryzen AI 9 3659-365gfx1150AMD Ryzen AI 7 350ai-7-350gfx1150AMD Ryzen AI 7 345ai-7-345gfx1150AMD Ryzen AI 5 435ai-5-435gfx1150AMD Ryzen AI 5 430ai-5-430gfx1150AMD Ryzen AI 7 445ai-7-445gfx1150AMD Ryzen AI 5 340ai-5-340gfx1150AMD Ryzen AI 5 330ai-5-330gfx1103AMD Ryzen 7 PRO 2507-pro-250gfx1103AMD Ryzen 5 PRO 2305-pro-230gfx1103AMD Ryzen 5 PRO 2205-pro-220gfx1103AMD Ryzen 5 PRO 2155-pro-215gfx1103AMD Ryzen 3 PRO 2103-pro-210gfx1103AMD Ryzen 9 2709-270gfx1103AMD Ryzen 7 2607-260gfx1103AMD Ryzen 7 2507-250gfx1103AMD Ryzen 5 2405-240gfx1103AMD Ryzen 5 2305-230gfx1103AMD Ryzen 5 2205-220gfx1103AMD Ryzen 3 2103-210上表按源文件顺序整理。gfx1152 与 gfx1153 的条目在源文件中分散出现此处按 gfx 分组展示以便阅读。值得注意的细节gpu值命名并不完全一致——gfx1151 全部带max前缀、gfx1150 早期条目带ai-前缀而后期条目如9-hx-375、9-365省略前缀、gfx1103 条目直接以数字开头。这表明gpu值是纯文档内部的标识符唯一约束是全局唯一读者不应依赖前缀命名规律。四、gfx 绑定如何驱动安装与兼容性内容gpu-selector.rst本身不写任何安装命令它的价值在于把选择结果广播给同页其他消费方。4.1 生成架构专属安装包命令在 docs/install/include/200-install.rst 中安装命令按gfx键分派约第 807 行起.. selected:: gfxgfx950 .. code-block:: bash sudo apt install amdrocm7.14-gfx950 .. selected:: gfxgfx942 .. code-block:: bash sudo apt install amdrocm7.14-gfx942文件中共出现 15 组gfxgfxXXXX条件块覆盖gfx950 / gfx942 / gfx90a / gfx908 / gfx1201 / gfx1200 / gfx1100 / gfx1101 / gfx1102 / gfx1103 / gfx1030 / gfx1151 / gfx1150 / gfx1152 / gfx1153。也就是说用户在下拉框里选中 AMD Instinct MI355Xgpumi355x触发gfxgfx950绑定页面随即只显示sudo apt install amdrocm7.14-gfx950——选择一张卡得到正确架构的安装命令。这正是 docs/install/rocm.rst 第 2024 行所说的用选择器选择你的安装方法、受支持的 AMD GPU/APU 与操作系统的落地实现。4.2 过滤兼容性矩阵同一份选择器被 include 进 docs/compatibility/compatibility-matrix.rst第 33 行矩阵中的系统要求表格则用gpu条件做精确过滤例如 docs/compatibility/include/system-instinct.rst:show-cond: gpumi355x gpumi350x gpumi350p :show-cond: gpumi325x gpumi300x gpumi300adocs/compatibility/include/system-radeon.rst 与 docs/compatibility/include/system-ryzen.rst 同理docs/compatibility/include/core-sdk-components-linux.rst 则用长串gpu列表界定支持核心 SDK 组件的硬件范围。这里的条件键是gpu而非gfx说明消费方可以根据需要选择不同粒度gpu精确到型号gfx精确到架构代系。五、选择器引擎实现原理gpu-selector.rst依赖的指令与前端逻辑全部位于仓库内可以逐层验证。5.1 Sphinx 指令层Python核心实现在 docs/extension/rocm_docs_custom/selector/init.pySelectorDropdownDirective.. selector-dropdown::继承_SelectorGroupBase声明key、show-cond、heading-width、sort四个选项_is_dropdown True使其渲染为select classform-select rocm-docs-selector-dropdown-input并通过roleradiogroup/roleradio保持无障碍语义。排序run()中当sort为asc/desc时按选项 label 排序并原地重排子节点非法值直接raise self.error。默认值若某组没有任何:default:选项自动把第一个选项设为默认option_nodes[0][default] True保证状态机永远有合法选中项。SelectorOptionDirective.. selector-option::解析:value:的裸值 额外绑定width经_parse_width校验支持 112 栅格列或 0~100% 百分比非法值回退默认 6。SelectedContentDirective.. selected::渲染条件内容容器把祖先链上的所有show-cond用合并为combined-show-cond如wcomputefaminstinct便于前端一次性判定嵌套条件。setup()注册全部指令并接入env-purge-doc/env-updated/html-page-context等 Sphinx 事件用于注入静态资源tom-select 下拉组件、selector.js、selector.css与侧边栏 TOC 组件。5.2 前端状态机层JavaScript前端逻辑在 docs/extension/rocm_docs_custom/selector/static/selector.js约 628 行全局状态state对象保存所有键值setState/deleteStateKeys负责更新。三重持久化syncStateToURL用history.replaceState把状态写入 URL query如?faminstinctwcomputegpumi300xgfxgfx942可直接分享/书签syncStateToLocalStorage以rocm-docs-selector-state为键持久化另有一个isBatchingState批量标志保证每次交互只同步一次。条件判定matchesConditions逐键比对支持字符串与数组两种期望值状态键未定义即视为不匹配。data-show-cond控制显示/隐藏data-disable-cond控制禁用。额外绑定生命周期reapplyAllExtraBindings从所有已选中且可见的选项收集额外绑定并写回 state同时通过extraBindingKeys集合清理过期绑定特别用primarySelectorKeys保护主键不被误删源码注释举了例子Instinct 选项把wcompute作为额外绑定切换家族到 Radeon 时不得因此删除w键因为可见的 Use case 选择器仍拥有w主键。可见性协调reconcileGroupSelections保证每组始终有合法选中项——若当前选中项因上级选择器变化而失效自动挑选替代项隐藏组的键会从 state 与 URL 中清除。MAX_VISIBILITY_CYCLES 5用于防御循环依赖导致的无限协调。5.3 与上游选择器的衔接gpu-selector.rst依赖的fam与w两个前置键来自 docs/install/include/fam-multi-arch-selector.rstDevice familykey: fam选项 All / AMD Instinct / AMD Radeon / AMD Ryzen与Use casekey: w选项 Mixed graphics and compute / Compute。注意 Instinct 选项的:value: instinct wcompute——选中 Instinct 家族时通过额外绑定强制把用途设为 Compute因为数据中心卡只有计算用途而wgraphics场景则由 Windows 图形专用的 ror-gpu-selector.rst 承接仅 Radeon 与 Ryzen 两个下拉。六、维护视角如何读懂与扩展这份清单从文档维护的角度gpu-selector.rst是硬件目录的唯一事实来源新增一款受支持 GPU 时需要在如下层面保持同步仓库为只读以下仅为理解文档结构的方法论本文件在对应家族的下拉中新增selector-option给出唯一gpu裸值与正确的gfxgfxXXXX绑定安装命令层docs/install/include/200-install.rst 中新增对应的.. selected:: gfxgfxXXXX分派块前提是该架构需要独立安装包兼容性层docs/compatibility/include/system-*.rst 的系统要求行、core-sdk-components-linux.rst 的组件支持行需把新gpu值加入对应:show-cond:未收录硬件gpu-selector.rst只收录官方支持的型号。若某 GPU 不在列表中docs/install/rocm.rst 第 2632 行明确说明它可能通过 TheRock 社区 nightly 构建获得支持相关迁移说明见 docs/about/transition-guide-TheRock.md。七、总结gpu-selector.rst是一个教科书式的声明式文档联动案例用约 90 行 reStructuredText 把 89 款 AMD 产品组织成三族多级下拉每款产品通过:value: gpu gfxarch的紧凑语法同时写入型号级与架构级两个状态键上游由fam/w决定可见性下游由gpu/gfx驱动安装包命令、兼容性矩阵与系统要求表格。理解这份文件等于同时理解了 ROCm 的硬件支持边界gfx950→gfx908 的 Instinct 四代、gfx1201→gfx1030 的 Radeon 五代、gfx1151→gfx1103 的 Ryzen APU 六代以及这套选择器机制从 Python 指令解析到前端状态同步的完整链路。若你的 GPU 不在清单内请先查阅 兼容性矩阵 与 TheRock 迁移指南 再决定安装路径。【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考