CANN/opbase快速入门指南

快速入门【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase快速体验项目前请参考本项目README完成环境准备和源码下载此处不再赘述。注意全量命令参数通过bash build.sh --help查看参数含义详见build参数说明。源码构建安装构建工具说明对于WebIDE或Docker环境默认已安装源码编译所需的构建工具无需手动安装可跳过本章操作。请先确保编译环境的基础库依赖已安装注意满足版本号要求。python 3.7.0gcc 7.3.0g 7.3.0cmake 3.16.0pigz可选安装后可提升打包速度建议版本 2.4patch 2.7用于给第三方源码打补丁如protobufdos2unixgit上述依赖可通过项目根目录install_deps.sh一键安装命令如下若遇到不支持系统请参考该文件自行适配。bash install_deps.sh安装完上述依赖后可通过项目根目录requirements.txt继续安装python三方库依赖命令如下。pip3 install -r requirements.txt安装第三方依赖说明对于WebIDE或Docker环境默认联网编译过程中会自动下载第三方依赖无需手动安装可跳过本章操作。本项目编译过程依赖的第三方开源软件列表如下开源软件版本下载地址json3.11.3include.zipmakeself2.5.0makeself-release-2.5.0-patch1.tar.gzeigen5.0.0eigen-5.0.0.tar.gzprotobuf25.1.0protobuf-25.1.tar.gzabseil-cpp20230802.1abseil-cpp-20230802.1.tar.gz若您的编译环境可以访问网络请参考联网编译编译脚本会自动联网下载第三方软件。否则请参考未联网编译手动下载第三方软件。联网编译若在有互联网的环境下编译编译过程中会自动安装第三方依赖无需手动安装。具体过程如下编译opbase包进入项目根目录执行如下编译命令bash build.sh若提示如下信息则说明编译成功。Self-extractable archive cann-opbase_${cann_version}_linux-${arch}.run successfully created.编译成功后run包存储于build_out目录下。安装opbase包./cann-opbase_${cann_version}_linux-${arch}.run --full --install-path${install_path}${install_path}表示指定安装路径若不指定默认安装路径为/usr/local/Ascend若指定一般安装在${install_path}目录下。可选卸载opbase包# 卸载命令 ./${install_path}/cann/share/info/opbase/script/uninstall.sh未联网编译若在没有连接互联网的环境下编译需要提前准备好依赖的第三方软件再进行源码编译。具体过程如下下载第三方依赖在联网环境中提前下载第三方软件目前有如下方式请按需选择方式1根据第三方软件依赖提供的表格手动下载若从其他地址下载注意版本号一致。方式2通过third_lib_download.py脚本一键下载该脚本在本项目scripts/tools/目录下载该脚本并执行如下命令python ${scripts_dir}/third_lib_download.py${scripts_dir}表示脚本存放路径下载的第三方软件包默认存放在当前脚本所在目录。编译算子包将下载好的第三方软件上传至离线环境可存放在third_party目录或自定义目录下。推荐前者其编译命令与联网编译场景下的命令一致。third_party目录推荐请在本项目根目录创建third_party目录若有则无需创建将第三方软件拷贝到该指定目录。此时编译命令与联网编译命令一致bash build.sh自定义目录在离线环境的任意位置新建${cann_3rd_lib_path}目录将第三方软件拷贝到该目录请确保该目录有权限访问。mkdir -p ${cann_3rd_lib_path}此时在联网编译命令基础上额外增加--cann_3rd_lib_path${cann_3rd_lib_path}用于指定第三方软件路径。假设路径为/path/cann_3rd_lib_path编译命令如下bash build.sh --cann_3rd_lib_path${cann_3rd_lib_path} # bash build.sh --cann_3rd_lib_path/path/cann_3rd_lib_path安装/卸载算子包未联网和联网场景下编译得到算子包结果一样默认存放于项目根目录build_out目录下并且安装和卸载的操作命令也一样具体参见联网编译。本地验证源码包部署后可通过项目根目录build.sh执行UT/ST用例验证项目功能是否正常。说明执行UT用例依赖googletest单元测试框架详细介绍参见googletest官网。执行UT# 方式1: 编译并执行所有的UT测试用例 bash build.sh -u # 方式2: 编译所有的UT测试用例但不执行 bash build.sh -u --noexec # 方式3执行UT并查看覆盖率 bash build.sh -u --cov以编译并执行所有的UT测试为例执行上述命令后出现如下内容表示执行成功bash build.sh -u执行完成后出现如下内容表示执行成功。Global Global test environment tear-down [] ${n} tests from ${m} test suites ran. (${x} ms total) [ PASSED ] ${n} tests. Execute ops_base_ut successful.执行ST# 方式1: 编译并执行所有的ST测试用例 bash build.sh -s # 方式2: 编译所有的ST测试用例但不执行 bash build.sh -s --noexec # 方式3执行ST并查看覆盖率 bash build.sh -s --cov以编译并执行所有的UT测试为例执行上述命令后出现如下内容表示执行成功bash build.sh -s执行完成后出现如下内容表示执行成功。Global Global test environment tear-down [] ${n} tests from ${m} test suites ran. (${x} ms total) [ PASSED ] ${n} tests. Execute ops_base_st successful.其中${n}表示执行了n个用例${m}表示m项测试${x}表示执行用例消耗的时间单位为毫秒。【免费下载链接】opbase本项目是CANN算子库的基础框架库为算子提供公共依赖文件和基础调度能力。项目地址: https://gitcode.com/cann/opbase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考