The computation algorithm of an operator is implemented through Ascend C APIs, and the loading and call of the operator are implemented through runtime APIs. This section describes the common runtime APIs used for running Ascend C operators in the CANN software stack based on kernel function call. For more information about runtime APIs, see Runtime API Reference.

Code Loading and Running

When loading and running operators, you need to use runtime APIs for runtime management and configuration. The main process and involved APIs are as follows:

Use aclInit for initialization.
Use aclrtSetDevice and aclrtCreateStream to allocate runtime resources for the device and stream, respectively.
Use aclrtMallocHost to allocate host memory and initialize data.
Use aclrtMalloc to allocate device memory and use aclrtMemcpy to copy data from the host to the device for kernel function computation.
Use <<<>>> to call the operator kernel function.
After the kernel function is executed, copy the computation result on the device back to the host.
Use aclrtSynchronizeStream to asynchronously wait for the kernel function execution to complete.
Call aclrtDestroyStream and aclrtResetDevice to release the stream and device runtime resources, respectively.
Use aclFinalize for deinitialization.

More Methods for Kernel Loading and Execution

Kernel loading and execution can also be implemented through binary loading, which is the bottom-layer API implementation. The kernel launch symbol <<<...>>> encapsulates the bottom-layer APIs. To use an operator, you need to compile the operator source file into a binary .o file using BiSheng command lines, and then call the kernel loading and execution APIs such as aclrtLaunchKernelWithConfig to call the operator.

For details about the kernel loading and execution APIs, see " Kernel Loading and Execution".
For details about how to use more BiSheng command line compilation options, see Common Compilation Options in the SIMD programming and SIMD+SIMT programming scenarios or Common Compilation Options in the SIMT programming scenario.
For details about the complete example, see sample of loading and executing a kernel (loading a binary file) in the SIMD programming and SIMD+SIMT programming scenarios or LINK in the SIMT programming scenario.

The kernel function is called asynchronously. After the kernel function is called, the control right is returned to the host immediately. You can call aclrtSynchronizeStream to force the host program to wait until all kernel functions are executed.

        
             aclError aclrtSynchronizeStream(aclrtStream stream);

Operator Execution

Code Loading and Running

More Methods for Kernel Loading and Execution