xref: /libCEED/backends/hip/ceed-hip-compile.cpp (revision a4bfdec2fbbaf1320f707b4acef5a9f16daff0b4)
1 // Copyright (c) 2017-2022, Lawrence Livermore National Security, LLC and other CEED contributors.
2 // All Rights Reserved. See the top-level LICENSE and NOTICE files for details.
3 //
4 // SPDX-License-Identifier: BSD-2-Clause
5 //
6 // This file is part of CEED:  http://github.com/ceed
7 
8 #include "ceed-hip-compile.h"
9 
10 #include <ceed.h>
11 #include <ceed/backend.h>
12 #include <ceed/jit-tools.h>
13 #include <stdarg.h>
14 #include <string.h>
15 #include <hip/hiprtc.h>
16 
17 #include <sstream>
18 
19 #include "ceed-hip-common.h"
20 
21 #define CeedChk_hiprtc(ceed, x)                                                                               \
22   do {                                                                                                        \
23     hiprtcResult result = static_cast<hiprtcResult>(x);                                                       \
24     if (result != HIPRTC_SUCCESS) return CeedError((ceed), CEED_ERROR_BACKEND, hiprtcGetErrorString(result)); \
25   } while (0)
26 
27 #define CeedCallHiprtc(ceed, ...)  \
28   do {                             \
29     int ierr_q_ = __VA_ARGS__;     \
30     CeedChk_hiprtc(ceed, ierr_q_); \
31   } while (0)
32 
33 //------------------------------------------------------------------------------
34 // Compile HIP kernel
35 //------------------------------------------------------------------------------
36 int CeedCompile_Hip(Ceed ceed, const char *source, hipModule_t *module, const CeedInt num_defines, ...) {
37   size_t                 ptx_size;
38   char                  *jit_defs_source, *ptx;
39   const char            *jit_defs_path;
40   const int              num_opts = 3;
41   const char            *opts[num_opts];
42   int                    runtime_version;
43   hiprtcProgram          prog;
44   struct hipDeviceProp_t prop;
45   Ceed_Hip              *ceed_data;
46 
47   hipFree(0);  // Make sure a Context exists for hiprtc
48 
49   std::ostringstream code;
50 
51   // Add hip runtime include statement for generation if runtime < 40400000 (implies ROCm < 4.5)
52   CeedCallHip(ceed, hipRuntimeGetVersion(&runtime_version));
53   if (runtime_version < 40400000) {
54     code << "\n#include <hip/hip_runtime.h>\n";
55   }
56   // With ROCm 4.5, need to include these definitions specifically for hiprtc (but cannot include the runtime header)
57   else {
58     code << "#include <stddef.h>\n";
59     code << "#define __forceinline__ inline __attribute__((always_inline))\n";
60     code << "#define HIP_DYNAMIC_SHARED(type, var) extern __shared__ type var[];\n";
61   }
62 
63   // Kernel specific options, such as kernel constants
64   if (num_defines > 0) {
65     va_list args;
66     va_start(args, num_defines);
67     char *name;
68     int   val;
69 
70     for (int i = 0; i < num_defines; i++) {
71       name = va_arg(args, char *);
72       val  = va_arg(args, int);
73       code << "#define " << name << " " << val << "\n";
74     }
75     va_end(args);
76   }
77 
78   // Standard libCEED definitions for HIP backends
79   CeedCallBackend(CeedGetJitAbsolutePath(ceed, "ceed/jit-source/hip/hip-jit.h", &jit_defs_path));
80   CeedCallBackend(CeedLoadSourceToBuffer(ceed, jit_defs_path, &jit_defs_source));
81   code << jit_defs_source;
82   code << "\n\n";
83 
84   // Non-macro options
85   opts[0] = "-default-device";
86   CeedCallBackend(CeedGetData(ceed, (void **)&ceed_data));
87   CeedCallHip(ceed, hipGetDeviceProperties(&prop, ceed_data->device_id));
88   std::string arch_arg = "--gpu-architecture=" + std::string(prop.gcnArchName);
89   opts[1]              = arch_arg.c_str();
90   opts[2]              = "-munsafe-fp-atomics";
91 
92   // Add string source argument provided in call
93   code << source;
94 
95   // Create Program
96   CeedCallHiprtc(ceed, hiprtcCreateProgram(&prog, code.str().c_str(), NULL, 0, NULL, NULL));
97 
98   // Compile kernel
99   hiprtcResult result = hiprtcCompileProgram(prog, num_opts, opts);
100 
101   if (result != HIPRTC_SUCCESS) {
102     size_t log_size;
103     char  *log;
104 
105     CeedDebug256(ceed, CEED_DEBUG_COLOR_ERROR, "---------- CEED JIT SOURCE FAILED TO COMPILE ----------\n");
106     CeedDebug(ceed, "File: %s\n", jit_defs_path);
107     CeedDebug(ceed, "Source:\n%s\n", jit_defs_source);
108     CeedDebug256(ceed, CEED_DEBUG_COLOR_ERROR, "---------- CEED JIT SOURCE FAILED TO COMPILE ----------\n");
109     CeedCallBackend(CeedFree(&jit_defs_path));
110     CeedCallBackend(CeedFree(&jit_defs_source));
111     CeedChk_hiprtc(ceed, hiprtcGetProgramLogSize(prog, &log_size));
112     CeedCallBackend(CeedMalloc(log_size, &log));
113     CeedCallHiprtc(ceed, hiprtcGetProgramLog(prog, log));
114     return CeedError(ceed, CEED_ERROR_BACKEND, "%s\n%s", hiprtcGetErrorString(result), log);
115   }
116   CeedCallBackend(CeedFree(&jit_defs_path));
117   CeedCallBackend(CeedFree(&jit_defs_source));
118 
119   CeedCallHiprtc(ceed, hiprtcGetCodeSize(prog, &ptx_size));
120   CeedCallBackend(CeedMalloc(ptx_size, &ptx));
121   CeedCallHiprtc(ceed, hiprtcGetCode(prog, ptx));
122   CeedCallHiprtc(ceed, hiprtcDestroyProgram(&prog));
123 
124   CeedCallHip(ceed, hipModuleLoadData(module, ptx));
125   CeedCallBackend(CeedFree(&ptx));
126   return CEED_ERROR_SUCCESS;
127 }
128 
129 //------------------------------------------------------------------------------
130 // Get HIP kernel
131 //------------------------------------------------------------------------------
132 int CeedGetKernel_Hip(Ceed ceed, hipModule_t module, const char *name, hipFunction_t *kernel) {
133   CeedCallHip(ceed, hipModuleGetFunction(kernel, module, name));
134   return CEED_ERROR_SUCCESS;
135 }
136 
137 //------------------------------------------------------------------------------
138 // Run HIP kernel
139 //------------------------------------------------------------------------------
140 int CeedRunKernel_Hip(Ceed ceed, hipFunction_t kernel, const int grid_size, const int block_size, void **args) {
141   CeedCallHip(ceed, hipModuleLaunchKernel(kernel, grid_size, 1, 1, block_size, 1, 1, 0, NULL, args, NULL));
142   return CEED_ERROR_SUCCESS;
143 }
144 
145 //------------------------------------------------------------------------------
146 // Run HIP kernel for spatial dimension
147 //------------------------------------------------------------------------------
148 int CeedRunKernelDim_Hip(Ceed ceed, hipFunction_t kernel, const int grid_size, const int block_size_x, const int block_size_y, const int block_size_z,
149                          void **args) {
150   CeedCallHip(ceed, hipModuleLaunchKernel(kernel, grid_size, 1, 1, block_size_x, block_size_y, block_size_z, 0, NULL, args, NULL));
151   return CEED_ERROR_SUCCESS;
152 }
153 
154 //------------------------------------------------------------------------------
155 // Run HIP kernel for spatial dimension with shared memory
156 //------------------------------------------------------------------------------
157 int CeedRunKernelDimShared_Hip(Ceed ceed, hipFunction_t kernel, const int grid_size, const int block_size_x, const int block_size_y,
158                                const int block_size_z, const int shared_mem_size, void **args) {
159   CeedCallHip(ceed, hipModuleLaunchKernel(kernel, grid_size, 1, 1, block_size_x, block_size_y, block_size_z, shared_mem_size, NULL, args, NULL));
160   return CEED_ERROR_SUCCESS;
161 }
162 
163 //------------------------------------------------------------------------------
164