Ascend C调试接口asc_dump详解

📅 2026/7/18 10:05:17
Ascend C调试接口asc_dump详解
asc_dump【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit产品支持情况Ascend 950PR/Ascend 950DT支持Atlas A3 训练系列产品/Atlas A3 推理系列产品支持Atlas A2 训练系列产品/Atlas A2 推理系列产品支持Atlas 200I/500 A2 推理产品不支持Atlas 推理系列产品AI Core不支持Atlas 推理系列产品Vector Core不支持Atlas 训练系列产品不支持功能说明将对应内存上的数据打印出来同时支持打印自定义的附加信息仅支持uint32_t类型的信息比如打印当前行号等。使用该接口需要包含utils/debug/asc_dump.h头文件。[!CAUTION]注意 该功能主要用于调试和性能分析通常在调测阶段使用会对算子性能产生一定影响生产环境建议关闭。 默认情况下该功能开启。函数原型// GM内存上的数据打印 templatetypename T __aicore__ inline void asc_dump_gm(__gm__ T* input, uint32_t desc, uint32_t dump_size) // UB内存上的数据打印 templatetypename T __aicore__ inline void asc_dump_ubuf(__ubuf__ T* input, uint32_t desc, uint32_t dump_size) // L1内存上的数据打印 templatetypename T __aicore__ inline void asc_dump_l1buf(__cbuf__ T* input, uint32_t desc, uint32_t dump_size) // L0C内存上的数据打印 templatetypename T __aicore__ inline void asc_dump_cbuf(__cc__ T* input, uint32_t desc, uint32_t dump_size) // GM内存上的数据打印 templatetypename T __aicore__ inline void asc_dump(__gm__ T* input, uint32_t desc, uint32_t dump_size) // UB内存上的数据打印 templatetypename T __aicore__ inline void asc_dump(__ubuf__ T* input, uint32_t desc, uint32_t dump_size) // L1内存上的数据打印 templatetypename T __aicore__ inline void asc_dump(__cbuf__ T* input, uint32_t desc, uint32_t dump_size) // L0C内存上的数据打印 templatetypename T __aicore__ inline void asc_dump(__cc__ T* input, uint32_t desc, uint32_t dump_size)以下接口为simd_vf中所使用的asc_dump接口仅支持Ascend 950PR/Ascend 950DT。// 寄存器上的数据打印 template typename T, typename U __simd_callee__ inline void asc_dump_reg(U input, uint32_t desc, uint32_t dump_size) // 寄存器上的数据打印 template typename T, typename U __simd_callee__ inline void asc_dump(U input, uint32_t desc, uint32_t dump_size) // UB内存上的数据打印 template typename T __simd_callee__ inline void asc_dump_ubuf(__ubuf__ T* input, uint32_t desc, uint32_t dump_size) // UB内存上的数据打印 template typename T __simd_callee__ inline void asc_dump(__ubuf__ T* input, uint32_t desc, uint32_t dump_size)参数说明参数名输入/输出描述T输入待dump的数据类型。U输入待dump的寄存器数据类型。input输入所需打印的内存块的起始地址。desc输入自定义信息。uint32_t类型支持的数据范围是[0, 2^32 - 1]。dump_size输入所需要打印的元素数量。返回值说明无约束说明针对Ascend 950PR/Ascend 950DT在使用该接口打印L1 Tensor数据时HDK版本需要至少升级到25.7.0以上。使用该接口时在每个核上dump的数据总量不能超过1M请开发者自行控制打印的内容数据量超出则不会打印。在计算数据量时若dump的总长度未对齐需要考虑padding数据的影响。当进行非对齐dump时如果实际dump的元素长度不满足32字节对齐系统会自动在其末尾补充一定数量的padding数据以满足对齐要求。调用示例__gm__ half* src; uint32_t desc 1; uint32_t dump_size 32; asc_dump_gmhalf(src, desc, dump_size);SIMD VF调用示例__simd_vf__ inline void SimdVfDumpReg() { AscendC::Reg::RegTensorfloat src_reg; uint32_t desc 1; uint32_t dump_size 32; asc_dumpfloat(src_reg, desc, dump_size); }【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考