SuperAPI AI 工具集

external-cannbot-ops-ascendc-env-check

通用与其它

查看项目

更新于 10-15 17:19

技能介绍

用途:面向 Ascend C 算子开发,提供开发环境与 NPU 设备状态检查,帮助在算子运行失败或环境异常时快速定位问题。

主要能力:一是 NPU 设备检查,可通过 npu-smi 查询设备信息、状态与资源使用情况;二是 CANN 环境配置检查,覆盖 CANN Toolkit 路径、CANN 版本与运行时依赖基线、CANN Ops 路径、自定义算子包 op_api 库以及 msprof/cannsim 等工具。

使用方式:查询设备执行 n pu-smi info,监控资源执行 npu-smi top,综合查询 NPU 信息可运行 bash scripts/npu_info.sh。环境检查推荐运行 bash scripts/check_env.sh。确认是否有进程占用 NPU 可用 npu-smi info -t usages -i <device_id>。npu-smi 的详细参数见 npu_commands.md,不可用时的回退方案见 asys_commands.md。

环境检查项:ASCEND_HOME_PATH 为必需项;CANN 版本建议确认;ASCEND_OPP_PATH 为运行时必需;自定义算子包 op_api 库为运行自定义算子必需;CANN 工具 msprof/cannsim 为可选项。注意官方环境变量为 ASCEND_HOME_PATH,而非 ASCEND_HOME,后者属错误用法。

适用场景:Ascend C 算子开发前的环境确认、NPU 设备不可见排查、算子运行失败时的环境诊断。

限制:空闲设备仍会有少量 HBM 被驱动占用,属正常现象,不应误判为设备被占用。资料未提供安装步骤、收费与价格信息,亦未提供具体平台与性能效果说明。