ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

NPUSim 完整入门:从零搭建昇腾 NPU 仿真环境(Web IDE 与手动安装全解析)

NPUSim 完整入门:从零搭建昇腾 NPU 仿真环境(Web IDE 与手动安装全解析) NPUSim 完整入门从零搭建昇腾 NPU 仿真环境Web IDE 与手动安装全解析【免费下载链接】npu-simulatorNPUSim全称NPU Simulator是一款面向算子开发场景的SoC级芯片仿真工具用于分析运行在AI仿真器上的AI任务在各阶段的精度和性能数据如指令执行情况等。该工具有助于用户进行深度性能调优使研发人员在无法获取或芯片资源紧缺的情况下也能获得与真实芯片几乎一致的验证效果和性能反馈。项目地址: https://gitcode.com/cann/npu-simulatorNPUSim全称 NPU Simulator是一款面向算子开发场景的昇腾 NPU 仿真工具可在没有真实芯片的情况下输出与真实硬件几乎一致的精度与性能数据。本文带你从零开始搭建昇腾 NPU 仿真环境完整覆盖 Web IDE 一键接入与服务器手动安装两条路线并附首次仿真与性能报告查看的实操步骤是新手上手的完整指南。为什么要用 NPU 仿真器芯片资源紧缺或拿不到板卡时算子开发往往卡在验证环节。NPUSim 的价值在于精度仿真输出 bit 级精度结果完成算子精度验证性能仿真输出指令流水图定位算子性能瓶颈二进制兼容同一 kernel 既可在仿真器上跑也可在 AI 处理器上跑仿真结论可直接迁移到实板支持的运行环境详见 README.md项目支持范围CPU 架构aarch64、x86_64仿真目标芯片Ascend 950 系列安装方式怎么选Web IDE vs 手动安装项目提供两种搭建昇腾环境的方式按需选择完整说明见 quick_install.md安装方式特点适用人群Web IDE一站式开发平台在线环境预装驱动固件、CANN 软件包和 NPUSim无需手动安装没有服务器设备的开发者推荐新手手动安装在自有服务器上按步骤安装 CANN 软件包有服务器、想体验完整安装流程的开发者方式一Web IDE 零配置接入昇腾仿真环境对于无昇腾设备的开发者Web IDE 是成本最低的路径打开浏览器即可获得可运行的昇腾环境环境中已装好驱动固件、软件包和依赖默认安装最新商用发布版的 CANN 软件包。启动 CANNLab 云开发环境的步骤进入 CANN 开源项目页面单击CANNLab按钮使用已认证的华为云账号登录未认证则按页面提示注册根据页面提示创建并启动云开发环境单击连接 WebIDE进入一站式开发平台源码资源默认位于/mnt/workspace目录 整个流程无需任何本地配置环境就绪后可直接跳到下面的编译安装步骤。编译并安装 NPUSim 最新代码Web IDE 已预装 CANN含 NPUSim。如需使用仓库最新代码先克隆源码git clone https://gitcode.com/cann/npu-simulator.git然后在项目根目录执行编译与覆盖安装脚本见 build_wheel.shbash ./clear.sh bash ./build_wheel.sh pip3 install dist/*.whl --upgrade -t /usr/local/Ascend/python/site-packages/方式二手动安装 CANN 环境全解析适用于自有服务器的开发者核心流程为安装 CANN 软件包 → 编译安装 NPUSim → 验证生效。安装 CANN toolkit 软件包到 CANN 官方下载页面选择最新时间版本按产品型号与环境架构下载对应包后执行安装chmod x Ascend-cann-toolkit_${cann_version}_linux-${arch}.run ./Ascend-cann-toolkit_${cann_version}_linux-${arch}.run --install --install-path${install_path}参数说明${arch}为 CPU 架构aarch64 / x86_64${install_path}为安装路径root 用户默认/usr/local/Ascend。若算子运行依赖可再按需安装 CANN ops 软件包需与 toolkit 安装到相同路径。编译安装 NPUSim 并验证CANN 包中已自带 NPUSim如需覆盖为仓库最新代码bash ./clear.sh bash ./build_wheel.sh pip3 install dist/*.whl --upgrade -t ${install_path}/python/site-packages/两种方式安装完成后统一用以下命令验证是否生效npusim --helpℹ️ NPUSim 核心功能完全基于 Python 标准库实现零第三方依赖无需额外安装 Python 库。仅当运行内置性能样例的造数脚本时才需要按需安装numpy。首次仿真3 条命令跑通 vector_add 示例环境就绪后用仓库内置的简易加法算子 vector_add 体验完整流程详细步骤见 quick_start.md# 1. 配置环境变量 source /usr/local/Ascend/cann/set_env.sh # 2. 编译算子 cmake -S tests/st -B build -DNPU_ARCHdav-3510 cmake --build build --target vector_add # 3. 执行仿真并自动生成报告 npusim record ./vector_add -s Ascend950 -g仿真完成后终端会打印Vector add completed successfully!日志与报告输出在build/Samples/0_Introduction/vector_add/npusim_*/目录中。查看性能报告指令流水图与 VF IPC 报告record模式生成的报告可进一步用 Perfetto 或 Chromechrome://tracing打开trace_core0.json查看指令流水图指令级时序一目了然若使用npusim record -s Ascend950 -g vf ./vector_add额外导出 VF 报告还能得到各 VF 的 IPC 曲线快速判断向量执行算力利用率说明见 03_vf_report_guide.md常见问题排查问题解决办法npusim: command not found未执行source set_env.sh或 whl 未安装到 CANN 的 Python 目录检查${install_path}是否一致覆盖安装后仍用旧版本确认 pip 安装目标目录为 CANN 的python/site-packages且加了--upgrade编译 whl 失败先执行bash ./clear.sh清理残留再重新bash ./build_wheel.sh下一步学习路线使用指南record / report 双模式详解01_user_guide.mdVF 性能报告完整指南03_vf_report_guide.md典型案例VF 优化、matmul 优化实战typical_cases.md快速入门与快速安装文档docs/zh/quick_start/搭建环境只是起点掌握 NPUSim 后即使没有板卡你也能在浏览器里完成算子的精度验证与性能调优。【免费下载链接】npu-simulatorNPUSim全称NPU Simulator是一款面向算子开发场景的SoC级芯片仿真工具用于分析运行在AI仿真器上的AI任务在各阶段的精度和性能数据如指令执行情况等。该工具有助于用户进行深度性能调优使研发人员在无法获取或芯片资源紧缺的情况下也能获得与真实芯片几乎一致的验证效果和性能反馈。项目地址: https://gitcode.com/cann/npu-simulator创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进