ASC-STL环境搭建指南:CANN 9.2.0、毕昇编译器与昇腾950的5项必备组件完整清单

原创2026-11-05 21:27:111,742 阅读
文章标签:标准库并发编程高性能计算Ascend

ASC-STL环境搭建指南:CANN 9.2.0、毕昇编译器与昇腾950的5项必备组件完整清单

ASC-STL 是武汉理工大学熊盛武课题组与华为 CANN 团队联合开发的面向昇腾 NPU 的 C/C++ 标准库(纯头文件实现)。搭建 ASC-STL 环境只需准备 CANN 9.2.0、毕昇编译器(基于 Clang 15.0.5)、g++(C++17)、CMake ≥ 3.20 与昇腾 950PR/950DT 处理器共 5 项组件。本文给出一份可直接照做的完整环境搭建清单与验证步骤。

ASC-STL环境搭建架构图:CANN Ascend C、毕昇编译器、CANN Runtime与NPU驱动的三层依赖关系

从架构可以看出,ASC-STL 的设备侧编程能力基于 CANN Ascend C,代码由毕昇编译器编译,运行于昇腾 950 系列处理器;运行时依赖 CANN Runtime(AscendCL Runtime API)与 NPU 驱动。这也正是环境搭建需要逐项确认的原因。

📋 5项必备组件清单:ASC-STL 环境要求一览

# 组件 版本 / 说明 备注
1 CANN 9.2.0 及以上 编译需 Toolkit,执行另需匹配的驱动和 Runtime
2 毕昇 CCE / clang 15.0.5 随 CANN 提供,无需单独安装
3 g++ 支持 C++17 完整 Host 门禁测试同时需 C++20 支持
4 CMake ≥ 3.20 用于集成纯头文件库与运行测试
5 处理器 昇腾 950PR / 950DT 系列 CPU 架构需为 aarch64 或 x86_64,操作系统为受支持的 Linux

💡 一个关键点:ASC-STL 是纯头文件库,不产出任何动态库或静态库。Host 侧只需把 include/ 目录加入包含路径即可使用;只有调用依赖 AscendCL 的 Runtime 接口时,才需要额外链接 ascendcl。

📥 第一步:获取 asc-stl 代码

克隆仓库即可获得全部头文件、示例工程与验证脚本:

git clone https://gitcode.com/cann/asc-stl.git
cd asc-stl

公共头文件集中在 include/asc/ 目录下:include/asc/std/ 下以 <asc/std/...> 提供 C++ 标准库接口,其余以 <asc/...> 提供昇腾扩展与 Runtime 接口。

🚀 第二步:激活 CANN 9.2.0 与毕昇编译器环境

Kernel 侧编译与真机运行前,必须先激活 CANN 环境脚本:

source /usr/local/Ascend/ascend-toolkit/set_env.sh   # 换成你的实际安装路径

激活后,毕昇 CCE / clang(15.0.5)与 AscendCL 环境变量即进入当前 shell。仓库提供的 scripts/cann-env.sh 会自动检测 ASCEND_HOME_PATH 与 bisheng 命令是否可用,若检测失败会提示"BiSheng compiler is unavailable",此时先确认 set_env.sh 是否执行成功、Toolkit 是否完整安装。

✅ 第三步:Host 侧快速验证(无需 NPU)

Host 侧使用只需 g++ 与头文件路径,一个最小示例即可验证环境是否就绪:

// sample.cpp —— 仅依赖头文件,无需链接库
#include <asc/std/optional>
#include <asc/std/type_traits>

int main() {
    asc::std::optional<int> value = 42;
    return *value == 42 ? 0 : 1;
}
g++ -std=c++17 -Wall -Wextra -I asc-stl/include sample.cpp -o sample && ./sample

若能编译运行成功,说明 g++ 的 C++17 支持与 ASC-STL 头文件路径均配置正确。

⚡ 第四步:编译并运行昇腾 950 快速入门工程

examples/quick_start/ 提供了完整的 Host + Kernel 入门工程(融合算子 z = ReLU(x + y))。从克隆后的仓库根目录执行:

source /usr/local/Ascend/ascend-toolkit/set_env.sh
cmake -S examples/quick_start -B build/quick-start-17 \
  -DASC_STL_EXAMPLE_STANDARD=17 -DSOC_VERSION=Ascend950PR_9599 \
  -DCMAKE_BUILD_TYPE=Release
cmake --build build/quick-start-17 -j2
timeout --signal=TERM --kill-after=10s 60s build/quick-start-17/asc_stl_quick_start

注意 SOC_VERSION 必须匹配你实际受支持的 950 设备型号。运行成功会返回 0 并输出 ASC_STL_QUICK_START_PASS;没有 NPU 时可以完成构建,但设备运行需要真实可用的昇腾 950 卡。

🧪 第五步:运行本地验证与自检脚本

clone 后即可用仓库自带的验证入口做环境体检:

验证场景 命令 是否需要 CANN / NPU
Host 门禁 bash scripts/ci-quick-check.sh 否(需 Python 3)
CMake + CTest cmake -B build -DBUILD_TESTING=ON && cmake --build build -j && cd build && ctest 否
设备编译门 bash build.sh --device-compile -p <CANN 路径> 需要 CANN
真机回归 bash scripts/ci-hardware-check.sh 需要昇腾设备

构建与测试的详细说明见 docs/zh/guide/building_and_testing.md,完整的 Host / Kernel 使用方式与本地验证流程见 docs/zh/quick_start.md。

🛠️ 常见环境问题速查

现象 排查建议
找不到 bisheng 命令 未激活 CANN 环境,重新执行 set_env.sh 并确认 Toolkit 安装完整
SOC_VERSION 不匹配 检查实际 950 设备型号,修正 -DSOC_VERSION 参数
C++20 头文件编译失败 g++ 版本过旧或系统 glibc 低于 2.36;Ubuntu 24.04 的 GCC 13 可满足完整 Host 门禁
编译成功但设备无法运行 驱动与 Runtime 版本未匹配 CANN 9.2.0,或 /dev/davinciN 设备不可用

ASC-STL设计架构图:C++标准库接口、昇腾扩展接口与Runtime接口三类对外接口

📚 延伸文档

按以上 5 步完成环境搭建与验证后,你已获得一个可编译 Kernel、可运行示例、可通过门禁检查的 ASC-STL 开发环境。

登录后查看全文
asc-stl