Heterogeneous Compilation

Compilation Options

Common compilation options are described as follows:

Product options are described as follows:

Heterogeneous Compilation

The BiSheng Compiler supports heterogeneous compilation. To compile heterogeneous programs, perform the following steps:

1. Obtain the path of the BiSheng Compiler program (bisheng) from the CANN release package, and set environment variables.

   # Set environment variables of the compiler. For example:
   $export PATH=${INSTALL_DIR}/compiler/ccec_compiler/bin:$PATH

2. Develop code. The basic procedure of compiling a heterogeneous program is as follows:
   1. Include the required AscendCL runtime management header files.
   2. Create the device and stream by calling the Runtime API.
   3. Allocate device memory, and copy the input data to the device memory as required.
   4. Compile the kernel function of the device.
   5. Run the kernel function of the device through the <<<>>> kernel launch symbol.
   6. Copy the output data to the host memory as required, and release the device memory.
3. Obtain the dynamic link library and the header file location of Runtime. In this example, compilation dependencies and their locations are as follows.

   Compilation Dependency	Location	Short For
   Runtime dynamic link library	${INSTALL_DIR}/lib64/	$RT_LIB
   Runtime header file	${INSTALL_DIR}/include	$RT_INC

4. Compile and execute compilation commands, and generate executable files in one step. In the following example, the development environment and the runtime environment are the same.

   // Simplified writing. These commands are used as a demo and cannot be run in meaningless scenarios.
   #ifdef ASCENDC_CPU_DEBUG
   #define __aicore__
   #else
   #define __aicore__ [aicore]
   #endif
   
   __global__ __aicore__ void foo(__gm__ int* buf)
   {
       *buf = 1;
   }
   
   int main(int argc, char* argv[])
   {
     int a[100];
     // nullptr - No L2 usage here
     foo<<<5, nullptr, nullptr>>>(a);
   
     return 0;
   }
   

   The compilation command is as follows:

   # Function: Compile the host and device code together, and generate the executable file axpy.
   # Compilation command:
   $bisheng --cce-soc-version=AscendXXXYY --cce-soc-core-type=VecCore -O2 axpy.cce -o axpy -I$RT_INC -L$RT_LIB

5. Run the executable file.

    # Execute:
    $export LD_LIBRARY_PATH=$RT_LIB:$LD_LIBRARY_PATH
    $./axpy