Closed
[Documentation|文档反馈]: aclnnInplaceErfc 的 selfRef dtype 表把 BFLOAT16 限定在 950/A3,Atlas A2 实测同样支持且结果正确 #4283
liuhanwen8Add on  19 days agoClosed at  1 day ago
liuhanwen8
liuhanwen8
19 days ago Create

一、文档链接 (必填)

cann/ops-math:math/erfc/docs/aclnnErfc&aclnnInplaceErfc.md
(https://gitcode.com/cann/ops-math/blob/master/math/erfc/docs/aclnnErfc%26aclnnInplaceErfc.md )

  • 涉及章节:## aclnnInplaceErfcGetWorkspaceSize 的参数表(第 259 行附近)与表后产品差异说明(第 287 行)
  • 证据等级:E1(真机实测,可复现)
  • 级别:P2

二、问题文档片段 (必填)

第 253-261 行(参数表 selfRef 行):

  <tbody>
    <tr>
      <td>selfRef(aclTensor*)</td>
      <td>输入/输出</td>
      <td>输入输出Tensor。</td>
      <td>-</td>
      <td>DOUBLE、FLOAT32、FLOAT16</td>
      <td>ND</td>
      <td>不超过8维</td>
      <td>√</td>

第 285-287 行(表后说明):

  <!-- npu="950,A3" id8 -->
  - <term>Ascend 950PR&950DT系列产品</term>、<term>Atlas A3系列产品</term>:selfRef额外支持BFLOAT16。
  <!-- end id8 -->

💡 存在的问题(选填)

aclnnInplaceErfc 的 BFLOAT16 支持面写窄了:资料只把它算在 Ascend 950PR&950DT 与 Atlas A3 上,而 Atlas A2(910B)上也支持,且结果正确。

  1. 按资料,Atlas A2 上 selfRef 传 BF16 属于「数据类型不在支持的范围之内」,应当在第一段返回 161002;实测 Atlas A2(910B2 / CANN 9.2.0)上返回 ret1=0 ret2=0,16 个元素与 std::erfc 全部一致(wrong=0/16)。
  2. 仓内实现在 math/erfc/op_api/aclnn_erfc.cpp 的 ASCEND910B_DTYPE_SELFREF_LIST 里已经包含 op::DataType::DT_BF16,与本条实测一致;也就是说支持面本来就是全平台,只有资料把 A2 排除了。
  3. 同一份资料里 aclnnErfc 的 self 列(第 104 行)写的是 DOUBLE、FLOAT32、FLOAT16、BOOL、INT64,与实现一致;只有 aclnnInplaceErfc 的 BF16 平台说明与实现不一致,会影响 A2 用户的选型(误以为只能用 FP16/FP32)以及 A2 侧测试覆盖(漏测 BF16)。

复现(自包含 C++ 探针,Atlas A2 / 910B 单卡,直调 aclnnInplaceErfc):

// 关键片段:建 1x16 BF16 tensor → aclnnInplaceErfcGetWorkspaceSize → aclnnInplaceErfc
// 同时跑 fp32(对照,必须 ret=0 且数值正确)与 int32(对照,必须 161002)
[fp32]  ret1=0 ret2=0 wrong=0/16
[bf16]  ret1=0 ret2=0 wrong=0/16
[int32] ret1=161002 ret2=-999

两条对照都成立(fp32 能跑通、int32 按资料被拒),说明 bf16 ret=0 不是"探针一律放行"造成的。

建议改法(二选一,按产品意图定)

  • 若 A2 确实支持 BF16(与实现一致):把第 287 行改成覆盖 Atlas A2,或直接在第 259 行的 dtype 列补 BFLOAT16;
  • 若 A2 不应支持 BF16:则应改实现(ASCEND910B_DTYPE_SELFREF_LIST 去掉 DT_BF16),而不是保留资料与实现不一致的现状。
likedislike
liuhanwen8liuhanwen8
19 days ago Added label: documentation
陈思
陈思Collaborators
19 days ago Comments:

您好,感谢反馈!

问题分析

本次读取版本中,inplace 接口通过 GetDtypeSupportListV2 选择 selfRef 白名单,910B 组明确包含 BF16;文档的基础列表只有 DOUBLE/FLOAT32/FLOAT16,额外 BFLOAT16 说明却只标记 950/A3。结合您在 Atlas A2/910B2、CANN 9.2.0 上给出的成功返回和数值对照,该处 A2 支持范围遗漏有明确依据。这里的结论限于相应产品分组,不应扩大成所有平台都支持 BF16。

核查源码与资料为 cann/ops-math@8c1f633e3679f83b55a237c552f842cdcf80462f:math/erfc/op_api/aclnn_erfc.cpp、math/erfc/docs/aclnnErfc&aclnnInplaceErfc.md、common/inc/op_api/level2_base_math.h。

处理方向

可在 BFLOAT16 的产品差异说明中补充 Atlas A2,并同步文档产品条件标记,保留原有 910 组白名单与 950/A3 支持说明。建议由产品契约和对应发布包验证共同确定最终表述,避免改变已支持的 A2 使用方式。

likedislike
陈思陈思Collaborators
19 days ago Assign chen_0715 as responsible person
陈思陈思Collaborators
19 days ago Added label: pending-confirmation
CchenyifengCollaborators
18 days ago Assign sakuraqqz as responsible person
CchenyifengCollaborators
18 days ago Removed responsible person chen_0715
SsakuraqqzCollaborators
16 days ago Associated pull request
CANN-robotCANN-robotCollaborators
1 day ago Close issue
CANN-robotCANN-robotCollaborators
1 day ago changed custom state from 进行中 to 已完成
CANN-robotCANN-robotCollaborators
1 day ago Added label: resolved