Ascend C DumpAccChkPoint调试接口

DumpAccChkPoint【免费下载链接】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 训练系列产品不支持Kirin X90支持Kirin 9030支持功能说明头文件路径为basic_api/kernel_operator_dump_tensor_intf.h。该接口Dump指定Tensor的内容。同时支持打印自定义的标签仅支持uint32_t数据类型的信息比如打印当前行号等。区别于DumpTensor使用该接口可以支持指定偏移位置的Tensor打印。在算子kernel侧实现代码中需要打印偏移后Tensor数据的地方调用DumpAccChkPoint接口打印相关内容。样例如下AscendC::DumpAccChkPoint(srcLocal, 5, 32, dataLen);[!CAUTION]注意 该接口主要用于调试分析开启后会对算子性能产生一定影响通常在调试阶段使用生产环境建议关闭。默认情况下调用该接口就会打印相关内容开发者可以参考关闭ASCENDC_DUMP说明按需关闭该接口功能。函数原型template typename T __aicore__ inline void DumpAccChkPoint(const LocalTensorT tensor, uint32_t index, uint32_t countOff, uint32_t dumpSize) template typename T __aicore__ inline void DumpAccChkPoint(const GlobalTensorT tensor, uint32_t index, uint32_t countOff, uint32_t dumpSize)参数说明表1模板参数说明参数名称描述T需要dump的Tensor的数据类型。表2参数说明参数名称输入/输出描述tensor输入需要dump的Tensor。•待dump的tensor位于Unified Buffer/L1 Buffer/L0C Buffer时使用LocalTensor类型的tensor参数输入。•待dump的tensor位于Global Memory时使用GlobalTensor类型的tensor参数输入。index输入用户自定义附加信息行号或其他自定义数字。countOff输入偏移元素个数。偏移后的Tensor地址需要满足所在物理位置的对齐约束。具体参考通用地址对齐约束。dumpSize输入需要dump的元素个数。数据类型Ascend 950PR/Ascend 950DTT支持的数据类型为bool、int8_t、uint8_t、hifloat8_t、fp8_e8m0_t、fp8_e5m2_t、fp8_e4m3fn_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。Atlas A3 训练系列产品/Atlas A3 推理系列产品T支持的数据类型为bool、int8_t、uint8_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。Atlas A2 训练系列产品/Atlas A2 推理系列产品T支持的数据类型为bool、int8_t、uint8_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。Atlas 推理系列产品AI CoreT支持的数据类型为bool、int8_t、uint8_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。Kirin X90T支持的数据类型为bool、int8_t、uint8_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。Kirin 9030T支持的数据类型为bool、int8_t、uint8_t、int16_t、uint16_t、half、bfloat16_t、int32_t、uint32_t、float、int64_t、uint64_t。返回值说明无约束说明当前仅支持打印存储位置为Unified Buffer/L1 Buffer/L0C Buffer/Global Memory的Tensor信息。针对Ascend 950PR/Ascend 950DT使用该接口打印L1 Tensor数据时HDK版本需要至少升级到25.7.0以上。操作数地址对齐要求请参见通用地址对齐约束。单次调用DumpAccChkPoint打印的数据总量不可超过30KB还包括少量框架需要的头尾信息通常可忽略。使用时应注意如果超出这个限制则数据不会被打印。调用示例constexpr uint32_t totalLength 256; // 参与搬运的元素个数 AscendC::LocalTensorhalf srcLocal; AscendC::GlobalTensorhalf srcGlobal; AscendC::DataCopy(srcLocal, srcGlobal, totalLength * sizeof(half)); uint32_t index 56; // 用户自定义附加信息此处传入DumpAccChkPoint指令的行号 uint32_t countOff 32; // 偏移元素个数从srcLocal[32]开始打印 uint32_t dumpSize 128; // dump的元素个数从srcLocal[32]开始打印128个元素个数 AscendC::DumpAccChkPoint(srcLocal, index, countOff, dumpSize);打印结果如下DumpTensor: desc56, addr0x40, data_typefloat16, positionUB, dump_size15 [4.710938, 4.707031, 4.773438, 2.271484, 4.347656, 2.359375, 1.284180, 1.073242, 1.242188, 2.298828, 0.521973, 1.099609, 1.880859, 1.226562, 3.916016]【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言原生支持C和C标准规范主要由类库和语言扩展层构成提供多层级API满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考