blob: 27d03c4f3ad4f2d4567cbf722c761f4b6171c72f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
Beignet Compiler
================
This code base contains the compiler part of the Beignet OpenCL stack. The
compiler is responsible to take a OpenCL language string and to compile it into
a binary that can be executed on Intel integrated GPUs.
Limitations
-----------
Today, the compiler is far from complete. See [[here|Software/Beignet/TODO]] for a
(incomplete) lists of things to do.
Interface with the run-time
---------------------------
Even if the compiler makes a very liberal use of C++ (templates, variadic
templates, macros), we really tried hard to make a very simple interface with
the run-time. The interface is therefore a pure C99 interface and it is defined
in `src/backend/program.h`.
The goal is to hide the complexity of the inner data structures and to enable
simple run-time implementation using straightforward C99.
Note that the data structures are fully opaque: this allows us to use both the
C++ simulator or the real Gen program in a relatively non-intrusive way.
Various environment variables
-----------------------------
Environment variables are used all over the code. Most important ones are:
- `OCL_SIMD_WIDTH` `(8 or 16)`. Change the number of lanes per hardware thread
- `OCL_OUTPUT_GEN_IR` `(0 or 1)`. Output Gen IR (scalar intermediate
representation) code
- `OCL_OUTPUT_LLVM` `(0 or 1)`. Output LLVM code after the lowering passes
- `OCL_OUTPUT_LLVM_BEFORE_EXTRA_PASS` `(0 or 1)`. Output LLVM code before the
lowering passes
- `OCL_OUTPUT_ASM` `(0 or 1)`. Output Gen ISA
- `OCL_OUTPUT_REG_ALLOC` `(0 or 1)`. Output Gen register allocations
Implementation details
----------------------
Several key decisions may use the hardware in an usual way. See the following
documents for the technical details about the compiler implementation:
- [Flat address space](doc/flat\_address\_space.html)
- [Unstructured branches](doc/unstructured\_branches.html)
- [Scalar intermediate representation](doc/gen\_ir.html)
- [Clean backend implementation](doc/compiler_backend.html)
Ben Segovia.
|
