Closed
[Documentation|文档反馈]: aclnnAsinh 支持面两份文档互相矛盾(310b 支持性相反、README 与接口资料 dtype 表互斥),BF16 在 A2 实测放行 #4116
liuhanwen8Add on 22 days agoClosed at 5 days ago
22 days ago Added label: documentation
xujiachen8
21 days ago Comments:
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。


21 days ago Assign yangjinwen as responsible person
21 days ago Added label: pending-confirmation
21 days ago Removed label: pending-confirmation
21 days ago Assign yefeicoding as responsible person
21 days ago Removed responsible person yangjinwen
5 days ago Close issue
5 days ago changed custom state from 进行中 to 已完成
5 days ago Added label: resolved
一、文档链接 (必填)
二、问题文档片段 (必填)
片段 1:
README.md:49/56/63,x / y / selfRef 三行的「数据类型」列完全相同:片段 2:
README.md:13产品支持表:片段 3:
docs/aclnnAsinh&aclnnInplaceAsinh.md:14-15同一产品写的是不支持:片段 5:
docs/...md:140-141:💡 存在的问题(选填)
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)三方都对不上:
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):
5. 建议:以真机/实现为准统一两份文档——README 的 dtype 列补齐 DOUBLE 与整型;接口资料里「A3 额外支持 BFLOAT16/COMPLEX」按实测产品分列;310b 支持性两份文档取同一结论。