算子工程编译

编译步骤

1. 完成工程编译相关配置。
   • 修改工程目录下的CMakePresets.json cacheVariables的配置项。CMakePresets.json文件内容如下：

     {
         "version": 1,
         "cmakeMinimumRequired": {
             "major": 3,
             "minor": 19,
             "patch": 0
         },
         "configurePresets": [
             {
                 "name": "default",
                 "displayName": "Default Config",
                 "description": "Default build using Unix Makefiles generator",
                 "generator": "Unix Makefiles",
                 "binaryDir": "${sourceDir}/build_out",
                 "cacheVariables": {
                     "CMAKE_BUILD_TYPE": {
                         "type": "STRING",
                         "value": "Release"
                     },
                     "ENABLE_SOURCE_PACKAGE": {
                         "type": "BOOL",
                         "value": "True"
                     },
                     "ENABLE_BINARY_PACKAGE": {
                         "type": "BOOL",
                         "value": "True"
                     },
                     "ASCEND_COMPUTE_UNIT": {
                         "type": "STRING",
                         "value": "ascendxxx"
                     },
                     "ENABLE_TEST": {
                         "type": "BOOL",
                         "value": "True"
                     },
                     "vendor_name": {
                         "type": "STRING",
                         "value": "customize"
                     },
                     "ASCEND_CANN_PACKAGE_PATH": {
                         "type": "PATH",
                         "value": "/usr/local/Ascend/latest"
                     },
                     "ASCEND_PYTHON_EXECUTABLE": {
                         "type": "STRING",
                         "value": "python3"
                     },
                     "CMAKE_INSTALL_PREFIX": {
                         "type": "PATH",
                         "value": "${sourceDir}/build_out"
                     },
                     "ENABLE_CROSS_COMPILE": {
                         "type": "BOOL",
                         "value": "False"
                     },
                     "CMAKE_CROSS_PLATFORM_COMPILER": {
                         "type": "PATH",
                         "value": "/usr/bin/aarch64-linux-gnu-g++"
                     }
                 }
             }
         ]
     }

     表1 需要开发者配置的常用参数列表

     参数名称	参数描述	默认值
     ASCEND_CANN_PACKAGE_PATH	CANN软件的安装目录，请根据实际情况进行修改，例如：/usr/local/Ascend/ascend-toolkit/latest。	“/usr/local/Ascend/latest”
     CMAKE_BUILD_TYPE	编译模式选项，可配置为： “Release”，Release版本，不包含调试信息，编译最终发布的版本。 “Debug”，“Debug”版本，包含调试信息，便于开发者开发和调试。	“Release”
     ENABLE_SOURCE_PACKAGE	是否开启源码编译	“True”
     ENABLE_BINARY_PACKAGE	是否开启二进制编译	“True”
     vendor_name	标识自定义算子所属厂商的名称。建议开发者自行指定所属厂商名称，避免和其他厂商提供的算子包冲突。	“customize”

   • 配置编译相关环境变量（可选）

     表2 环境变量说明

     环境变量	配置说明
     CMAKE_CXX_COMPILER_LAUNCHER	用于配置C++语言编译器（如g++）、毕昇编译器的启动器程序为ccache，配置后即可开启cache缓存编译，加速重复编译并提高构建效率。用法如下，在对应的CMakeLists.txt进行设置： set(CMAKE_CXX_COMPILER_LAUNCHER <launcher_program>) 其中<launcher_program>是ccache的安装路径，比如ccache的安装路径为/usr/bin/ccache，示例如下： set(CMAKE_CXX_COMPILER_LAUNCHER /usr/bin/ccache)

2. 在算子工程目录下执行如下命令，进行算子工程编译。

   ./build.sh

   编译成功后，会在当前目录下创建build_out目录，并在build_out目录下生成自定义算子安装包custom_opp_<target os>_<target architecture>.run。

   用户如果需要编译过程日志存盘，可以使用环境变量ASCENDC_BUILD_LOG_DIR来控制存储路径。用户设置该选项之后，如果编译过程中无错误产生，则对应的log文件后缀会添加"_success"，若编译过程有错误产生，则会在屏幕打印对应的报错信息，以及指示用户log文件的具体路径与文件名，同时，对应log文件后缀会添加“_error”。

   # 如希望编译日志存储在/home/build_log/，则可以按照如下设置，默认不打开日志存储
   export ASCENDC_BUILD_LOG_DIR=/home/build_log/

算子包交叉编译

完成算子代码实现后，如果当前平台架构和运行环境一致则参考上一节的内容进行编译即可，如果需要实现算子包的交叉编译，您可以参考如下流程。

1. 交叉编译工具下载，下表以Ubuntu系列操作系统为例，展示了编译工具下载命令的样例。其他操作系统，请替换为实际的下载命令。

   表3 Ubuntu系列操作系统交叉编译工具下载命令样例

   当前平台架构	运行环境平台架构	编译工具下载命令
   x86_64	aarch64	sudo apt-get install -y g++-aarch64-linux-gnu
   aarch64	x86_64	sudo apt-get install g++-x86-64-linux-gnu

2. 自定义算子工程交叉编译，构建生成自定义算子包。
   

   1. 完成交叉编译前，需要修改CMakePresets.json中ASCEND_CANN_PACKAGE_PATH为CANN软件包安装路径。
   2. 二进制包编译不支持交叉编译，需要修改CMakePresets.json中ENABLE_BINARY_PACKAGE为False。
   1. 修改CMakePresets.json中ENABLE_CROSS_COMPILE为True，使能交叉编译。

      "ENABLE_CROSS_COMPILE": {
          "type": "BOOL",
          "value": "True"
       }

   2. 修改CMakePresets.json中CMAKE_CROSS_PLATFORM_COMPILER为安装后的交叉编译工具路径。

      "CMAKE_CROSS_PLATFORM_COMPILER": {
          "type": "PATH",
          "value": "/usr/bin/aarch64-linux-gnu-g++"
      }

   3. 在算子工程目录下执行如下命令，进行算子工程交叉编译。

      ./build.sh

      编译成功后，会在当前目录下创建build_out目录，并在build_out目录下生成自定义算子安装包custom_opp_<target os>_<target architecture>.run

支持自定义编译选项

在算子工程中，如果开发者想对算子kernel侧代码增加一些自定义的编译选项，可以参考如下内容进行编译选项的定制。

修改算子工程op_kernel目录下的CMakeLists.txt，使用add_ops_compile_options来增加编译选项，方法如下：

add_ops_compile_options(OpType COMPUTE_UNIT soc_version1 soc_version2 ... OPTIONS option1 option2 ...)

具体参数的介绍如下：