111
|
1 /* phsa-rt.h -- Data structures and functions of the PHSA device side runtime
|
|
2 scheduler, and HSAIL built-ins.
|
|
3
|
131
|
4 Copyright (C) 2015-2018 Free Software Foundation, Inc.
|
111
|
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
|