Closed
[Documentation|文档反馈]: 快速入门缺少硬件查询及 SoC 参数选择步骤 #7191
周云飞Add on  3 days agoClosed at  3 days ago
周云飞
周云飞Collaborators
3 days ago Create

Document Link(文档链接)

https://gitcode.com/cann/ops-transformer/blob/master/docs/QUICKSTART.md

Issues Section(问题文档片段)

编译 AddExample 的命令使用 --soc=${soc_version},随后仅列出 Atlas A2、Atlas A3、950 系列与 SoC 参数的映射表。

Existing Issues(存在的问题)

文档未说明如何查询硬件并确认产品系列。对于不熟悉设备型号的用户,只有产品名到编译参数的映射,仍无法确定应使用哪个参数,尤其在设备信息未直接显示 A2/A3 产品名称时。

Suggested Resolution(建议)

在现有映射表前补充官网查询步骤:访问 CANN 下载中心,复制页面提供的硬件查询命令;在当前环境执行获取芯片 ID;将 ID 回填官网获取产品名,再按现有映射表选择 ${soc_version}。

仅补充快速入门查询指引,不修改设备识别工具和编译逻辑。

关联 PR

https://gitcode.com/cann/ops-transformer/pull/15438

likedislike
周云飞
周云飞Collaborators
3 days ago Comments:

问题说明

按您描述的文档内容,现有映射表只能帮助已知产品系列的用户选择 ${soc_version},缺少从设备信息确认产品系列的前置步骤。这属于快速入门指引的完整性问题,不能据此判断设备识别工具或编译逻辑有误。

处理建议

可以在映射表前补充:进入 CANN 下载中心,复制官网提供的硬件查询命令,在设备环境执行后,将芯片 ID 回填官网查询产品名,再按映射表选择参数。补充时重点确认官网入口、查询结果与表中产品名称能够对应,不改动识别工具和编译逻辑。

关联 PR #15438 的具体改动及合入状态尚未确认。

likedislike
周云飞
周云飞Collaborators
3 days ago Comments:

按本次维护意见,保持与 NN、Math 当前文档一致,不恢复外部硬件查询链接和步骤。PR #15438 新增内容已全部撤回,相对原基线无剩余文件差异,本次不作代码或文档变更。关闭 PR 的 API 请求返回 403,尚未完成关闭。

likedislike
周云飞
周云飞Collaborators
3 days ago Comments:

补充最新处理范围:按维护意见,将 transformer 原有的 SoC 映射表改为与 NN、Math 当前一致的三项列表,保留原跳转锚点,不新增外部链接和查询步骤。PR #15438 已更新并保留,前一条“无剩余改动、无需合入”的说明已不适用于当前版本。

likedislike
CANN-robotCANN-robotCollaborators
3 days ago Close issue
CANN-robotCANN-robotCollaborators
3 days ago Added label: resolved