| name | toolchain |
| description | Hidden stage for magnetar. Ensure Pulsar2 and the chip-specific C++ BSP/cross-compilation toolchain are available for compile and SDK validation. |
TOOLCHAIN
目标:确认 Pulsar2 可用,并根据 TARGET_HARDWARE 准备 C++ SDK 所需的 BSP 或交叉编译工具链。
Pulsar2
- 按优先级检查
PULSAR2_BIN > PULSAR2_IMAGE > PATH 中的 pulsar2 > Docker 镜像。
- 若均不可用,从 HuggingFace
AXERA-TECH/Pulsar2 拉取镜像(使用 hf-mirror)。
- 将可用的 Pulsar2 命令记录为
pulsar2_command。
C++ BSP / 交叉编译工具链
根据 TARGET_HARDWARE 选择 BSP 下载地址和 AX runtime 路径:
| 芯片 | BSP 来源 | 内容 |
|---|
| AX650 | AX650 BSP SDK V3.10.2 | 含 aarch64 交叉编译器 + AX runtime (include/ lib/) |
| AX620E | Arm GNU 裸工具链(待更新为BSP) | 仅交叉编译器,AX runtime 需另行提供 |
AX650 BSP SDK
下载:
https://hf-mirror.com/AXERA-TECH/AX650-Community-Hub/resolve/main/sdk/edge-computing-AX650_SDK_V3.10.2/02.%20SDK/AX650_SDK_V3.10.2/AX650_SDK_V3.10.2_20260513151335.tgz
HF 页面:
https://hf-mirror.com/AXERA-TECH/AX650-Community-Hub/tree/main/sdk/edge-computing-AX650_SDK_V3.10.2/02.%20SDK/AX650_SDK_V3.10.2
步骤:
- 若已下载,检查
TASK_DIR/cache/toolchain/AX650_SDK_V3.10.2/ 是否完整。
- 若未下载:
mkdir -p TASK_DIR/cache/toolchain
wget -O TASK_DIR/cache/toolchain/AX650_SDK_V3.10.2.tgz <URL>
tar xzf TASK_DIR/cache/toolchain/AX650_SDK_V3.10.2.tgz -C TASK_DIR/cache/toolchain/
- 探索 BSP 目录结构,定位:
- 交叉编译器路径(如
arm-linux-gnueabihf-g++ 或 aarch64-none-linux-gnu-g++ 所在目录)。
- AX runtime 路径:包含
include/ 和 lib/(如 libax_engine.so 或 libaxengine.so)。
- 记录路径:
CXX_COMPILER_PATH: 交叉编译器 bin 目录
AX_RUNTIME_ROOT: AX runtime 根目录(含 include/ 和 lib/)
- 生成
sdk/cpp/toolchain-aarch64.cmake,配置:
CMAKE_C_COMPILER / CMAKE_CXX_COMPILER 指向交叉编译器。
AX_RUNTIME_ROOT 变量指向 AX runtime 路径。
AX620E(暂用 Arm GNU 裸工具链)
- 检查
aarch64-none-linux-gnu-g++ 或 aarch64-linux-gnu-g++。
- 如不存在,下载默认 URL:
https://developer.arm.com/-/media/Files/downloads/gnu-a/9.2-2019.12/binrel/gcc-arm-9.2-2019.12-x86_64-aarch64-none-linux-gnu.tar.xz
- 解压到
TASK_DIR/cache/toolchain/gcc-arm-9.2-2019.12/。
- 生成
sdk/cpp/toolchain-aarch64.cmake。
- AX620E 的
AX_RUNTIME_ROOT 需由用户另行提供,不可用 BSP 路径。
验证
- Pulsar2 可用(可执行
pulsar2 或 docker run 成功)。
- 若 TARGET_HARDWARE=AX650:BSP 已下载并解压,
CXX_COMPILER_PATH 和 AX_RUNTIME_ROOT 已定位。
- 若 TARGET_HARDWARE=AX620E:交叉编译器可用或已下载。
sdk/cpp/toolchain-aarch64.cmake 已生成。
STOP
- Pulsar2 不可用且无法从任意来源获取。
- AX650 BSP 下载失败,且无法从备用 URL 获取。
- AX620E 交叉编译器下载失败,且用户未提供替代。