aclnnInit

函数功能

单算子API执行框架中aclnnXxx接口的初始化函数，在调用该类算子接口前必须先进行aclnn相关资源的初始化（如读取环境变量、配置文件、加载资源库等），否则会导致系统内部出错，影响业务正常运行。

调用aclnnInit或aclInit接口，均能实现资源初始化，二者区别在于aclnnInit仅完成aclnn相关资源初始化，而aclInit完成AscendCL中各种资源（包含aclnn）的初始化。因此aclnnInit相对于aclInit更轻量一些。若两个接口都调用，也不返回失败。

函数原型

aclnnStatus aclnnInit(const char *configPath)

参数说明

1
2
3
4
5

{
   "op_debug_config":{
           "enable_debug_kernel":"on",
    }
}

返回值说明

返回0表示成功，返回其他值表示失败，返回码列表参见公共接口返回码。

约束与限制

• 本接口需与aclnnFinalize接口配套使用，分别完成aclnn资源初始化与去初始化。
• 一个进程内只允许调用一次aclnnInit接口，不支持重复调用。

调用示例

关键代码示例如下，仅供参考，不支持直接拷贝运行。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

// 资源初始化
auto ret = aclnnInit("/home/acl.json");
...
// 创建算子接口参数对象
ret = aclCreate***(...);
...
// 调用算子两段式接口
ret = aclnnXxxGetWorkspaceSize(...);
ret = aclnnXxx(...);
...
// 销毁算子接口参数对象
ret = aclDestroy***();
...
// 资源去初始化
ret = aclnnFinalize();