使用前准备

环境准备

请参考环境准备，完成相关环境变量的配置。

使用约束

• 若要使能msDebug工具，安装驱动时需要指定--debug参数，具体安装方法请参考环境准备。
• 单Device仅支持使用单个msDebug工具进行调试，且不推荐同时运行其他算子程序。
• 当被调试程序调用多个算子时，msDebug仅支持对指定的单个算子进行调试。
• 调试算子时，溢出检测功能会关闭。

启动工具

msDebug工具支持以下两种启动方式：

若工具弹出Cannot read termcap database; using dumb terminal settings. 的提示信息，可以通过配置export TERMINFO=xx消除提示，xx为本地TERMINFO路径：

export TERMINFO=xx    //xx信息可通过infocmp -D命令查询，可以选择符合当前终端配置的路径做为TERMINFO值

• 加载可执行文件application。
  1. 算子编译后可获取NPU侧可执行文件application。
     

     基于Ascend C算子的kernel侧框架执行一键式编译运行，可生成NPU侧可执行文件application，具体操作可参考Kernel直调。

  2. 输入如下命令，使用msDebug工具加载可执行文件。

     $ msdebug application
     (msdebug) target create "application"
     Current executable set to '${INSTALL_DIR}/projects/application' (aarch64).
     (msdebug)

     

     若可执行文件有其他入参，则按照如下形式传入入参：

     msdebug application parameter1 parameter2 ...

• 加载调用算子的python脚本
  1. 完成了PyTorch框架的适配插件开发后，即可实现从PyTorch框架调用Ascend C自定义算子，可以通过自定义python脚本test_ops_custom.py调用算子。
     

     通过PyTorch框架进行单算子调用的场景，详细信息可参考单算子适配OpPlugin插件开发。

  2. 输入如下命令，使用msDebug工具加载python脚本。

     1 2 3 4 5 6 7 8

     $ msdebug python3 test_ops_custom.py msdebug(MindStudio Debugger) is part of MindStudio Operator-dev Tools. The tool provides developers with a mechanism for debugging Ascend kernels running on actual hardware. This enables developers to debug Ascend kernels without being affected by potential changes brought by simulation and emulation environments. (msdebug) target create "application" Current executable set to ''${INSTALL_DIR}/projects/application' (aarch64). (msdebug) settings set -- target.run-args "test_ops_custom.py" (msdebug)

调试退出

(msdebug) q
[localhost add_ascendc_sample]$ 

该调试通道无法单独关闭，若要关闭调试通道，需要通过覆盖安装方式，具体请参见对应的NPU驱动和固件安装文档。