Zhouyi Compass Integration-技术圈

Arm China(安谋科技) “周易”NPU开源项目 - Compass_Integration

本项目用于构建可发布的软件包，软件内容来自 Compass_Unified_Parser 仓库 Compass_OpportunePostTrainingTools 仓库和 Compass_MiniPkg 。

准备事项

你需要 clone 以下 repositories 至仓库根目录。

git clone https://github.com/Arm-China/Compass_Unified_Parser.git
git clone https://github.com/Arm-China/Compass_OpportunePostTrainingTools.git

你需要下载 minpackage 至仓库根目录，下载步骤请参考文章 https://aijishu.com/a/1060000000215443 。

minpackage 是一个文件名为 Compass_MiniPkg-x.x.x-Linux.tar.gz 的 tarball 文件。

依赖项

硬件

Compass Integration 项目只能在 Linux x86_64 上构建。

软件

python = 3.8
pip
setuptools
wheel

更详细的 Python 依赖请查看 ./setup.py。

构建

./build.sh

脚本 build.sh 会在 ./dist 目录构建一个 python wheel 文件。

安装

pip3 install dist/AIPUBuilder-*-cp38-cp38-linux_x86_64.whl
# 提示: 如果没有 root 权限，请使用 `pip3 install --user` 或者 `pip3 install --target /YOUR_PATH` 命令

# 如果使用了 --user 选项，不要忘了:
export PATH="/home/${USER}/.local/bin":$PATH

# 设置环境变量
MINIPKG_PATH=`realpath ./Compass_MiniPkg-Release-*-Linux`
export PATH=${MINIPKG_PATH}/simulator/bin:${PATH}
export LD_LIBRARY_PATH=${MINIPKG_PATH}/simulator/lib:${LD_LIBRARY_PATH}
export PATH=${MINIPKG_PATH}/tool-chain/compiler/bin:${PATH}
export PATH=${MINIPKG_PATH}/tool-chain/debugger/bin:${PATH}

测试

安装成功之后, 执行./test.sh 脚本可以检查所有模块是否正常工作。这个脚本仅仅测试了aipucc, aipu_simulator 和 aipubuild 工具的可用性。如果需要使用其他独立模块 (IDE, simulator, toolchain) 的完整功能，请根据对应的文档进行配置。例如，aipucc 依赖以下运行环境:

libpthread.so.0
libz.so.1
libtinfo.so.5
... (完整的环境依赖见文档：minipkg/aipu-toolchain)

./test.sh

文档

文档放在 Compass_MiniPkg 的 /doc 目录下。