Closed
[Documentation|文档反馈]: aclnnAsinh 支持面两份文档互相矛盾(310b 支持性相反、README 与接口资料 dtype 表互斥),BF16 在 A2 实测放行 #4116
liuhanwen8Add on  22 days agoClosed at  5 days ago
liuhanwen8
liuhanwen8
22 days ago Create

一、文档链接 (必填)

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

片段 1:README.md:49/56/63,x / y / selfRef 三行的「数据类型」列完全相同:

FLOAT、FLOAT16、BFLOAT16

片段 2:README.md:13 产品支持表:

| <term>Atlas 200I/500 A2推理产品</term>             |    √    |

片段 3:docs/aclnnAsinh&aclnnInplaceAsinh.md:14-15 同一产品写的是不支持:

<!-- npu="310b" id4 -->
- <term>Atlas 200I/500 A2推理产品</term>:不支持

片段 5:docs/...md:140-141:

- <term>Atlas A3系列产品</term>:input和out数据类型额外支持BFLOAT16、COMPLEX64、COMPLEX128。

💡 存在的问题(选填)

1. 同一产品(Atlas 200I/500 A2 推理 / 310b)的支持性两份文档结论相反:README 打 √、接口资料写「不支持」,读者无法判断该不该用。

2. dtype 支持面互斥:README 只列 FLOAT/FLOAT16/BFLOAT16(无 DOUBLE、无整型),接口资料列 FLOAT/FLOAT16/DOUBLE/INT8/INT16/INT32/INT64/UINT8/BOOL(A2 无 BFLOAT16,且把 BFLOAT16/COMPLEX 归为 A3 专属)。两份文档没有任何一份与实现一致:math/asinh/op_api/aclnn_asinh.cpp:38-46 的 910B 白名单同时含 BF16、COMPLEX64/128 与整型。

3. 真机实测(A2 / 910B3 / CANN 9.2.0)三方都对不上:

用例 第一段 第二段 资料口径 README 口径
bf16 → bf16 0 0 仅 A3 支持 支持
fp64 → fp64 0 0 支持 未列出
int32 → fp32 0 0 支持(转 FLOAT32) 未列出

bf16 在 A2 上不仅放行,结果也与 CPU 参考一致(asinh(2)=1.4436);结合同一算子 op_host/asinh_def.cpp:34/40 已声明 {FLOAT, FLOAT16, BFLOAT16}、以及 issue #3801 已把该文件注释改成「FP32、FP16、BF16 均已实现」,可以判断接口资料里「BF16/COMPLEX 仅 A3」这一句已过期。

4. 复现(自包含,A2 单卡可直接编译运行):

// aclnnAsinh 支持面探针:A2(910B3) 上 bf16 与「整数入参 + fp16 出参」是否被放行
// 编译:g++ -O2 -std=c++17 probe.cpp -o probe -I/usr/local/Ascend/ascend-toolkit/latest/include \
//   -L/usr/local/Ascend/ascend-toolkit/latest/lib64 -lascendcl -lnnopbase -lopapi
#include <cstdio>
#include <vector>
#include "acl/acl.h"
#include "aclnnop/aclnn_asinh.h"

static void run(const char* tag, aclDataType inD, size_t inE, aclDataType outD, size_t outE,
                aclrtStream s)
{
    std::vector<int64_t> shp{2, 8};
    std::vector<int64_t> st{8, 1};
    void* a = nullptr;
    void* b = nullptr;
    aclrtMalloc(&a, 16 * inE, ACL_MEM_MALLOC_HUGE_FIRST);
    aclrtMalloc(&b, 16 * outE, ACL_MEM_MALLOC_HUGE_FIRST);
    std::vector<unsigned char> h(inE > outE ? 16 * inE : 16 * outE, 0);
    aclrtMemcpy(a, 16 * inE, h.data(), 16 * inE, ACL_MEMCPY_HOST_TO_DEVICE);
    aclrtMemcpy(b, 16 * outE, h.data(), 16 * outE, ACL_MEMCPY_HOST_TO_DEVICE);
    aclTensor* ta = aclCreateTensor(shp.data(), 2, inD, st.data(), 0, ACL_FORMAT_ND, shp.data(), 2, a);
    aclTensor* tb = aclCreateTensor(shp.data(), 2, outD, st.data(), 0, ACL_FORMAT_ND, shp.data(), 2, b);
    uint64_t ws = 0;
    aclOpExecutor* ex = nullptr;
    int r1 = aclnnAsinhGetWorkspaceSize(ta, tb, &ws, &ex);
    int r2 = -1;
    void* wsp = nullptr;
    if (r1 == 0) {
        if (ws > 0) aclrtMalloc(&wsp, ws, ACL_MEM_MALLOC_HUGE_FIRST);
        r2 = aclnnAsinh(wsp, ws, ex, s);
        if (r2 == 0) aclrtSynchronizeStream(s);
        if (wsp) aclrtFree(wsp);
    }
    printf("%-24s GetWorkspaceSize=%d Execute=%d\n", tag, r1, r2);
    aclDestroyTensor(ta);
    aclDestroyTensor(tb);
    aclrtFree(a);
    aclrtFree(b);
}

int main()
{
    aclInit(nullptr);
    aclrtSetDevice(1);
    aclrtStream s = nullptr;
    aclrtCreateStream(&s);
    run("fp32 -> fp32", ACL_FLOAT, 4, ACL_FLOAT, 4, s);
    run("bf16 -> bf16", ACL_BF16, 2, ACL_BF16, 2, s);
    run("int32 -> fp16", ACL_INT32, 4, ACL_FLOAT16, 2, s);
    run("int64 -> fp16", ACL_INT64, 8, ACL_FLOAT16, 2, s);
    aclrtDestroyStream(s);
    aclrtResetDevice(1);
    aclFinalize();
    return 0;
}

实测输出(910B3,CANN 9.2.0):

fp32 -> fp32             GetWorkspaceSize=0 Execute=0
bf16 -> bf16             GetWorkspaceSize=0 Execute=0
int32 -> fp16            GetWorkspaceSize=0 Execute=0
int64 -> fp16            GetWorkspaceSize=0 Execute=0

5. 建议:以真机/实现为准统一两份文档——README 的 dtype 列补齐 DOUBLE 与整型;接口资料里「A3 额外支持 BFLOAT16/COMPLEX」按实测产品分列;310b 支持性两份文档取同一结论。

关联:#3801(dtype 范围注释修正)、#3780 / #3789(error 场景 core,已修复)。

likedislike
liuhanwen8liuhanwen8
22 days ago Added label: documentation
xujiachen8Collaborators
21 days ago Comments:

您好,感谢三方对照!核对 master b08e885e7fac370203a51904fd0680523b9a9205,README 的 Atlas 200I/500 A2 推理支持标记与接口资料“不支持”仍相反;两处 dtype 列表的差异也仍存在。当前 A2 的 aclnn 入口白名单包含 BFLOAT16、复数及整数/BOOL,整型/BOOL 会转换为 FLOAT 参与计算;所以仅将 BF16/复数补充归为 A3,并不能完整描述这条入口。

修订时需要分别说明 aclnn 接口支持、输入转换规则与具体 kernel 的原生类型范围,避免把 README 中的 kernel 类型列表直接扩为所有产品的 API 支持承诺。310b 是否正式支持,不能由 910B 的放行结果或通用 L2 白名单单独确定,还应核对目标产品的构建、后端能力和交付验证,再将两份资料统一。

您提供的 A2 bf16/fp64/int32 结果可作为该安装版本的测试证据;本轮尚未独立上板复测,也没有据此宣称 310b 或所有类型组合可用。一个可行方向是按产品和接口层次分别列明类型、转换与限制,保留已验证范围。

核对依据:README.md;aclnnAsinh、aclnnInplaceAsinh.md;aclnn_asinh.cpp。

likedislike
Xxujiachen8Collaborators
21 days ago Assign yangjinwen as responsible person
Xxujiachen8Collaborators
21 days ago Added label: pending-confirmation
陈思陈思Collaborators
21 days ago Removed label: pending-confirmation
YyangjinwenCollaborators
21 days ago Assign yefeicoding as responsible person
YyangjinwenCollaborators
21 days ago Removed responsible person yangjinwen
CANN-robotCANN-robotCollaborators
5 days ago Close issue
CANN-robotCANN-robotCollaborators
5 days ago changed custom state from 进行中 to 已完成
CANN-robotCANN-robotCollaborators
5 days ago Added label: resolved