开发者可以基于鸿蒙CANN社区recipe仓提供的工程模板创建算子开发工程,工程中包括算子host侧代码实现文件、算子kernel侧实现文件以及工程编译配置文件等。
简要说明:
创建算子工程之前,需要参考环境准备章节安装驱动固件和CANN软件包,完成开发环境和运行环境的准备。
同时需要配置CANN工具包环境变量,示例如下。
source ${install_path}/cann-${cann_version}/set_env.sh 创建算子开发工程的步骤如下。
获取工程模板。
从鸿蒙CANN社区recipe仓获取算子工程模板,将仓内的样例单算子工程(如AddCustom算子,位于仓内"ops/ascendc/src/add_custom"目录下)拷贝到本地作为算子开发工程。
git clone https://gitcode.com/cann/cann-recipes-harmony-infer.git cp -r ./cann-recipes-harmony-infer/ops/ascendc/src/add_custom ./AddCustom
以AddCustom算子为例,拷贝得到的算子工程目录结构如下所示:
AddCustom ├── CMakeLists.txt // 算子工程的CMakeLists.txt ├── CMakePresets.json // 编译配置项 ├── framework // 算子插件实现文件目录,单算子模型文件的生成不依赖算子适配插件,无需关注 ├── op_host // host侧实现文件 │ ├── **add_custom_tiling.h** // 算子tiling定义文件 │ ├── **add_custom.cpp** // 算子原型注册、shape推导、信息库、tiling实现等内容文件 │ ├── CMakeLists.txt ├── op_kernel // kernel侧实现文件 │ ├── CMakeLists.txt │ ├── **add_custom.cpp** // 算子代码实现文件 └── scripts // 自定义算子工程打包相关脚本所在目录
工程目录中的op_kernel和op_host包含了算子的核心实现文件。op_kernel下存放Kernel侧算子实现。op_host下存放host侧代码实现,包括算子原型定义实现、Host侧Tiling实现。其中kernel侧算子实现和host侧tiling实现在算子实现章节已经介绍了其核心的实现方法,在该章节会侧重于介绍接入DDK框架后的编程模式和API的使用。工程目录中的CMakePresets.json,用于开发者完成工程编译相关配置,之后即可进行编译部署。