95 lines
3.3 KiB
C
95 lines
3.3 KiB
C
/* phsa-rt.h -- Data structures and functions of the PHSA device side runtime
|
|
scheduler, and HSAIL built-ins.
|
|
|
|
Copyright (C) 2015-2020 Free Software Foundation, Inc.
|
|
Contributed by Pekka Jaaskelainen <pekka.jaaskelainen@parmance.com>
|
|
for General Processor Tech.
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files
|
|
(the "Software"), to deal in the Software without restriction, including
|
|
without limitation the rights to use, copy, modify, merge, publish,
|
|
distribute, sublicense, and/or sell copies of the Software, and to
|
|
permit persons to whom the Software is furnished to do so, subject to
|
|
the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included
|
|
in all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
|
|
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
|
|
OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
|
|
USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef PHSA_RT_H
|
|
#define PHSA_RT_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include "hsa.h"
|
|
|
|
#define PHSA_MAX_WG_SIZE 1024 * 10
|
|
|
|
/* Pointer type for the public facing kernel launcher function generated
|
|
by gccbrig. This launches the actual kernel for all work groups and
|
|
work items in the grid. */
|
|
typedef void (*gccbrigKernelLauncherFunc) (void *context, void *);
|
|
|
|
/* Pointer type for kernel functions produced by gccbrig from the HSAIL.
|
|
This is private from outside the device binary and only called by
|
|
the launcher. */
|
|
typedef void (*gccbrigKernelFunc) (unsigned char *, void *, void *, uint32_t,
|
|
void *);
|
|
|
|
/* Context data that is passed to the kernel function, initialized
|
|
by the runtime to the current launch information. The data is
|
|
used by different id functions etc.
|
|
|
|
The struct is used by both the launcher and the targeted device,
|
|
thus the fields must have the same alignment/padding in both sides.
|
|
*/
|
|
typedef struct
|
|
{
|
|
/* Data set by the HSA Runtime's kernel launcher. */
|
|
hsa_kernel_dispatch_packet_t *dp;
|
|
|
|
size_t packet_id;
|
|
|
|
/* Data set by the device-side launcher. */
|
|
gccbrigKernelFunc kernel;
|
|
|
|
/* The range of a work groups this dispatch should execute. */
|
|
size_t wg_min_x;
|
|
size_t wg_min_y;
|
|
size_t wg_min_z;
|
|
|
|
size_t wg_max_x;
|
|
size_t wg_max_y;
|
|
size_t wg_max_z;
|
|
|
|
/* The barrier used to synch the work-items before executing a new WG. */
|
|
void *wg_start_barrier;
|
|
|
|
/* The barrier to wait at after executing a work-group. */
|
|
void *wg_completion_barrier;
|
|
|
|
/* The barrier used to synchronize WIs in case of the 'barrier' HSAIL
|
|
instruction. */
|
|
void *wg_sync_barrier;
|
|
|
|
/* This should be set to the flat address of the beginning of the group
|
|
segment. */
|
|
size_t group_segment_start_addr;
|
|
|
|
/* This must be set to the correct aligned flat address space location from
|
|
where the kernel can actually read its arguments. Might point to the
|
|
original global kernarg space. */
|
|
void *kernarg_addr;
|
|
} PHSAKernelLaunchData;
|
|
|
|
#endif
|