1 /* phsa-rt.h -- Data structures and functions of the PHSA device side runtime 2 scheduler, and HSAIL built-ins. 3 4 Copyright (C) 2015-2020 Free Software Foundation, Inc. 5 Contributed by Pekka Jaaskelainen <pekka.jaaskelainen@parmance.com> 6 for General Processor Tech. 7 8 Permission is hereby granted, free of charge, to any person obtaining a 9 copy of this software and associated documentation files 10 (the "Software"), to deal in the Software without restriction, including 11 without limitation the rights to use, copy, modify, merge, publish, 12 distribute, sublicense, and/or sell copies of the Software, and to 13 permit persons to whom the Software is furnished to do so, subject to 14 the following conditions: 15 16 The above copyright notice and this permission notice shall be included 17 in all copies or substantial portions of the Software. 18 19 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 20 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 21 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 22 IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 23 DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 24 OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 25 USE OR OTHER DEALINGS IN THE SOFTWARE. 26 */ 27 28 #ifndef PHSA_RT_H 29 #define PHSA_RT_H 30 31 #include <stdbool.h> 32 #include <stdint.h> 33 #include "hsa.h" 34 35 #define PHSA_MAX_WG_SIZE 1024 * 10 36 37 /* Pointer type for the public facing kernel launcher function generated 38 by gccbrig. This launches the actual kernel for all work groups and 39 work items in the grid. */ 40 typedef void (*gccbrigKernelLauncherFunc) (void *context, void *); 41 42 /* Pointer type for kernel functions produced by gccbrig from the HSAIL. 43 This is private from outside the device binary and only called by 44 the launcher. */ 45 typedef void (*gccbrigKernelFunc) (unsigned char *, void *, void *, uint32_t, 46 void *); 47 48 /* Context data that is passed to the kernel function, initialized 49 by the runtime to the current launch information. The data is 50 used by different id functions etc. 51 52 The struct is used by both the launcher and the targeted device, 53 thus the fields must have the same alignment/padding in both sides. 54 */ 55 typedef struct 56 { 57 /* Data set by the HSA Runtime's kernel launcher. */ 58 hsa_kernel_dispatch_packet_t *dp; 59 60 size_t packet_id; 61 62 /* Data set by the device-side launcher. */ 63 gccbrigKernelFunc kernel; 64 65 /* The range of a work groups this dispatch should execute. */ 66 size_t wg_min_x; 67 size_t wg_min_y; 68 size_t wg_min_z; 69 70 size_t wg_max_x; 71 size_t wg_max_y; 72 size_t wg_max_z; 73 74 /* The barrier used to synch the work-items before executing a new WG. */ 75 void *wg_start_barrier; 76 77 /* The barrier to wait at after executing a work-group. */ 78 void *wg_completion_barrier; 79 80 /* The barrier used to synchronize WIs in case of the 'barrier' HSAIL 81 instruction. */ 82 void *wg_sync_barrier; 83 84 /* This should be set to the flat address of the beginning of the group 85 segment. */ 86 size_t group_segment_start_addr; 87 88 /* This must be set to the correct aligned flat address space location from 89 where the kernel can actually read its arguments. Might point to the 90 original global kernarg space. */ 91 void *kernarg_addr; 92 } PHSAKernelLaunchData; 93 94 #endif 95