2021-06-16 03:05:19 +08:00
<!-- -
Copyright (C) 2020-2021 Intel Corporation
SPDX-License-Identifier: MIT
-->
2020-03-06 18:09:57 +08:00
# Building Level Zero
2020-03-07 02:02:29 +08:00
These instructions have been tested on Ubuntu* and complement those existing for NEO in the top-level BUILD.md file.
2020-03-06 18:09:57 +08:00
2020-10-27 22:38:30 +08:00
1. Install/build Level Zero loader and Level Zero headers
2020-03-06 18:09:57 +08:00
2020-10-27 22:38:30 +08:00
Install Level Zero loader and headers from [https://github.com/oneapi-src/level-zero/releases ](https://github.com/oneapi-src/level-zero/releases ).
For execution, only the level-zero package is needed; for compilation, level-zero-devel package is also required.
Alternatively, build Level Zero loader from source, as indicated in [https://github.com/oneapi-src/level-zero ](https://github.com/oneapi-src/level-zero ).
2020-03-06 18:09:57 +08:00
2020-03-07 02:02:29 +08:00
Build will generate ze_loader library and symlinks, as well as those for ze_validation_layer.
2020-03-06 18:09:57 +08:00
2020-10-27 22:38:30 +08:00
2. Install/build Level Zero driver
2020-03-06 18:09:57 +08:00
2020-10-27 22:38:30 +08:00
Install Level Zero package from [https://github.com/intel/compute-runtime/releases ](https://github.com/intel/compute-runtime/releases ).
2020-03-06 18:09:57 +08:00
2020-10-27 22:38:30 +08:00
Alternatively, follow instructions in top-level BUILD.md file to build NEO. Level Zero is built by default.
2020-03-07 02:02:29 +08:00
When built, ze_intel_gpu library and symlinks are generated.
3. Build your application
Compilation needs to include the Level Zero headers and to link against the loader library:
```shell
2020-10-27 22:38:30 +08:00
g++ zello_world_gpu.cpp -o zello_world_gpu -lze_loader
2020-03-07 02:02:29 +08:00
```
If libraries not installed in system paths, include Level Zero headers and path to Level Zero loader:
2020-03-06 18:09:57 +08:00
```shell
2020-10-27 22:38:30 +08:00
g++ -I< path_to_Level_Zero_headers > zello_world_gpu.cpp -o zello_world_gpu -L< path_to_libze_loader.so > -lze_loader
2020-03-06 18:09:57 +08:00
```
4. Execute your application
2020-03-07 02:02:29 +08:00
If Level Zero loader packages have been built and installed in the system, then they will be present in system paths:
2020-03-06 18:09:57 +08:00
```shell
2020-10-27 22:38:30 +08:00
./zello_world_gpu
```
Sample output:
```shell
Device :
* name : Intel(R) Graphics Gen9 [0x5912]
* type : GPU
* vendorId : 8086
Zello World Results validation PASSED
2020-03-06 18:09:57 +08:00
```
2020-03-07 02:02:29 +08:00
If libraries not installed in system paths, add paths to ze_loader and ze_intel_gpu libraries:
```shell
2020-10-27 22:38:30 +08:00
LD_LIBRARY_PATH=< path_to_libze_loader.so > :< path_to_libze_intel_gpu.so > ./zello_world_gpu
2020-03-07 02:02:29 +08:00
```
___(*) Other names and brands may be claimed as property of others.___
