已关闭
[Documentation|文档反馈]: [AI 识别] QUICKSTART 缺少 SoC 版本检测方法,用户无法从 npu-smi 输出确定 soc_version #694
StoneChan_创建于  8月4日关闭于  8月5日
StoneChan_
StoneChan_成员
8月4日 创建

Issue 模板: documentation
来源: Scene 1 文档可操作性评估(batch_id: 20260803_103134)
优先级: P0
关联 KEP: perception_learning(KEI: doc_coverage_missing_rate)


Document Link(文档链接)

https://gitcode.com/cann/ops-cv/blob/master/docs/QUICKSTART.md (第 2 节"编译 AddExample 算子",第 54-58 行)

Issues Section(问题文档片段)

产品名对应的${soc_version}取值如下,请按实际场景传参。

- Atlas A2 训练系列产品/Atlas A2 推理系列产品:取值为ascend910b
- Atlas A3 训练系列产品/Atlas A3 推理系列产品:取值为ascend910_93
- 950系列产品:取值为ascend950

Existing Issues(存在的问题)

文档提供了产品名到 soc_version 的映射表,但未描述如何检测当前硬件的产品名。用户面对 npu-smi info 输出时,无法确定自己的设备属于"Atlas A2"还是"950系列产品",从而无法选择正确的 soc_version 参数值。

建议补充以下内容之一:

  1. 说明如何从 npu-smi info 输出识别产品系列(如通过 Chip Name 或 Product Name 字段判断)
  2. 提供常见的 npu-smi info 输出与 soc_version 的对照表
  3. 或引用 CANN 官方文档中关于 SoC 版本检测的说明

评估环境 npu-smi info 输出示例

$ npu-smi info
Device Information (from sysfs):
================================
NPU 0:
  MAJOR=236
  MINOR=0
  DEVNAME=davinci0
  Status: Available

用户从上述输出无法直接判断产品系列(无明确的"Atlas A2"或"950系列"标识),需要额外的检测方法或对照表。

likedislike
StoneChan_StoneChan_成员
8月4日 添加了label:documentation
Mmajiajian_hw成员
8月4日 将 liu-wei 设为负责人
liu-wei
liu-wei成员
8月4日 评论:

您好,npu-smi info这种方式获取的内容会误导用户。当前建议直接从文档里按照实际环境获取(用户安装包的时候是知道自己是属于哪一个点,不然基础包都安装不了):
https://gitcode.com/cann/ops-cv/blob/master/docs/QUICKSTART.md

产品名对应的${soc_version}取值如下,请按实际场景传参。

  • Atlas A2 训练系列产品/Atlas A2 推理系列产品:取值为ascend910b
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品:取值为ascend910_93
  • 950系列产品:取值为ascend950
likedislike
liu-weiliu-wei成员
8月5日 issue状态由 进行中 改变为 已完成
liu-weiliu-wei成员
8月5日 关闭了 issue