# cann_op_contrib **Repository Path**: littezheng/cann_op_contrib ## Basic Information - **Project Name**: cann_op_contrib - **Description**: No description available - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 11 - **Created**: 2023-06-15 - **Last Updated**: 2023-06-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # cann_op_contrib [View English](./README.md) - [生态算子仓介绍](#生态算子仓介绍) - [目录结构简介](#目录结构简介) - [开发环境要求](#开发环境要求) - [算子编译打包](#算子编译打包) - [算子包部署](#算子包部署) - [算子开发文档](#算子开发文档) - [贡献](#贡献) - [许可证](#许可证) ## 生态算子仓介绍 生态算子仓提供生态算子供开发者参考使用，开发者可基于该代码仓进行算子开发，编译构建生态算子包并部署使用。 ## 目录结构简介 源码目录结构如下所示。
cann_op_contrib
cmake
external
存放依赖的第三方库编译文件
util
存放工具类编译文件
dependencies.cmake
community
common
inc
主要存放算子原型工具类头文件
src
主要存放算子原型工具类实现
utils
主要存放算子实现工具类
ops
add(以add算子为例)
ai_core
impl
add.py DSL/TIK方式算子实现代码
add.cpp TIK2方式算子实现代码
op_info_cfg
ascend310
add.ini 算子信息配置文件
ascend310p
add.ini 算子信息配置文件
ascend910
add.ini 算子信息配置文件
ascend910b
add.ini 算子信息配置文件
op_tiling
add_tiling.cc 算子tiling文件
ai_cpu
impl
add.cc 算子实现代码
add.h 算子实现头文件
op_info_cfg
add.ini 算子信息配置文件
framework
onnx
add_plugin.cc 算子适配onnx框架插件代码
tf
add_plugin.cc 算子适配tf框架插件代码
caffe
add_plugin.cc 算子适配caffe框架插件代码
op_proto
inc
add_op.h 算子原型IR注册文件
add_proto.cc 算子原型实现文件
add_tik2(Ascend C方式开发tbe算子)
ai_core
op_host
add_tik2_tiling.h Tiling注册
add_tik2.cpp Tiling实现及算子信息库配置和算子原型注册推导
op_kernel
add_tik2.cpp 算子实现逻辑代码
framework
onnx
add_tik2_plugin.cc 算子适配onnx框架插件代码
tf
add_tik2_plugin.cc 算子适配tf框架插件代码
caffe
add_tik2_plugin.cc 算子适配caffe框架插件代码
tests
add(以add算子为例)
ut
aicpu
test_add_gen_data.py 测试数据生成脚本，文件名需要以gen_data.py结尾
add_utest.cc AICPU算子实现UT
op_proto
test_add_proto.cc 算子原型UT
tbe
test_add_gen_data.py 测试数据生成脚本，文件名需要以gen_data.py结尾
test_add_impl.py DSL/TIK方式算子UT用例
tik2
add_ut.cc TIK2方式算子实现代码UT用例
tiling
add_tiling_ut.cc Tiling代码UT用例
scripts
ai_core_parse_ini.py tbe算子信息配置解析脚本
CANN_OP_CONTRIB_install.sh 生态仓算子部署脚本
gen_ops_filter.sh Ascend C方式开发算子时，算子信息库文件生成脚本
gen_test_data.py UT测试数据生成脚本
gen_tik2_code.py Ascend C算子实现代码生成对应python文件脚本
install_run.sh 生态仓run包安装脚本
parse_ini.py aicpu算子信息配置解析脚本
run_aicpu_ut.sh aicpu算子实现UT测试脚本
run_op_proto_ut.sh 算子原型UT测试脚本
run_tbe_ut_all.py DSL/TIK方式开发的tbe算子UT测试脚本
run_tik2_ut.sh TIK2方式开发的tbe算子UT测试脚本
run_tiling_ut.sh Tiling代码UT测试脚本
CMakeLists.txt 生态仓cmake编译脚本
build.sh 编译脚本，用于触发生态仓代码编译及编译出的文件路径变更
pack.sh 生态仓run包打包脚本
## 开发环境要求 使用源码进行编译构建之前，需安装社区版本的对应平台开发套件软件包(toolkit)及配套版本的算子开发工具包(communitysdk) [软件包下载地址及用户手册](#https://www.hiascend.com/software/cann/community) 其中communitysdk包需解压到toolkit安装路径(如~/Ascend/ascend-toolkit/latest/) 环境变量配置可参考(https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/63RC1alpha001/softwareinstall/instg/instg_000040.html) 此外还需配置 ``` export SOC_VERSION=Ascend910A ``` > **说明**: SOC_VERSION为可选配置的环境变量，如果不配置，编译和测试时默认按照Ascend910，开发者应设置为自己使用的芯片型号，常用为Ascend910、Ascend310等，普通用户可以在默认安装路径~/Ascend/ascend-toolkit/latest/toolkit/tools/simulator目录下查看目录获取更多可配置的值 ## 算子编译打包 算子开发指导请参见[算子开发指南](#https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/63RC1alpha001/operatordevelopment/opdevg/atlasopdev_10_0001.html)，完成所需交付件的实现，存放要求请参见[目录结构简介](#目录结构简介) 命令行下执行编译打包脚本。 **注：环境需要配置ASCEND_AICPU_PATH环境变量，否则aicpu算子会编译失败。** ``` ./pack.sh ``` 若只希望执行编译选项，可单独执行编译脚本 ``` ./build.sh ``` > **说明**：build.sh还可执行UT测试功能，具体方法可执行帮助命令进行查看。 ``` ./build.sh -h ``` ## 算子包部署 执行算子包安装命令进行安装。 **注：安装前需保证环境存在ASCEND_OPP_PATH环境变量，否则会安装失败。** ``` ./CANN_OP_CONTRIB_linux-x86_64.run --install ``` > **说明** ：安装包支持参数可通过-h查看 ``` ./CANN_OP_CONTRIB_linux-x86_64.run -h ``` ## 算子开发文档 有关开发指南、教程和API的更多详细信息，请参阅[学习向导](#https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/63RC1alpha001/operatordevelopment/opdevg/atlasopdev_10_0001.html)。 ## 贡献 欢迎参与贡献。更多详情，请参阅我们的[贡献者Wiki](#https://gitee.com/ascend/cann_op_contrib/blob/master/CONTRIBUTING_CN.md)。 ## 许可证 [Apache License 2.0](https://gitee.com/ascend/cann_op_contrib/blob/master/LICENSE)