Ascend C Tools

🚀概述

Ascend C Tools是CANN （Compute Architecture for Neural Networks）基于Ascend C编程语言推出的配套调试工具。借助Ascend C Tools，开发者可以进行CPU域孪生调试、解析算子调测信息以及文件信息，从而快速定位算子实现中可能存在的问题。

• cpu debug

  cpu debug工具本质上是提供了CPU调试库文件，使得Ascend C源码可以通过通用GCC编译器编译得到在CPU上运行、调测的算子二进制文件。该工具辅助开发者在CPU上完成功能和精度的基本验证，并提供了gdb调试、printf打印等调试手段。

• npu check

  npu check工具，用于检查Kernel源码实现逻辑，功能包含：内存检查、多线程检查、内存生命周期管理、内存地址依赖管理、同步事件管理等。

• msobjdump

  msobjdump针对Kernel直调算子开发与工程化算子开发编译生成的算子ELF文件（Executable and Linkable Format）提供解析和解压功能，并将结果信息以可读形式呈现，方便开发者直观获得Kernel文件信息。

• show_kernel_debug_data

  show_kernel_debug_data工具用于离线解析通过AscendC::DumpTensor/AscendC::print接口保存的Kernel侧算子调试信息。

🔍目录结构说明

本代码仓目录结构如下:

├── cmake                               // Ascend C Tools构建源代码
├── cpudebug                            // Ascend C Tools cpu debug工具实现源代码
│   ├── cmake                           // Ascend C Tools cpu debug 构建源代码
│   ├── include                         // Ascend C Tools cpu debug工具实现源代码
│   ├── utils                           // Ascend C Tools cpu debug工具实现源代码
│   └── src                             // Ascend C Tools cpu debug工具实现源代码
├── docs                                // Ascend C Tools使用说明
├── examples                            // Ascend C Tools样例工程
├── libraries                           // Ascend C Tools依赖的库文件
├── npuchk                              // Ascend C Tools npu check检查工具
├── scripts                             // Ascend C Tools打包脚本
├── tests                                // Ascend C Tools的UT用例
├── third_party                         // Ascend C Tools依赖的第三方库文件
├── utils
│   ├── msobjdump                       // Ascend C Tools msobjdump实现源代码
└── └── show_kernel_debug_data          // Ascend C Tools show_kernel_debug_data实现源代码

📖文档介绍

文档	说明
快速入门	快速体验项目的简易教程。包括环境搭建、编译执行、本地验证等操作。
使用说明	各工具使用说明。
相关文档	Ascend C算子编程指南，同时该文档中提供了孪生调试cpu_debug、msobjdump、show_kernel_debug_data工具的详细介绍。

📝相关信息

• 贡献指南
• 安全声明
• 许可证