mirror of
https://github.com/intel/compute-runtime.git
synced 2025-09-15 13:01:45 +08:00

eudebug interface is now hidden under EuDebugInterface class shared code uses generic object and param values layout of structs is guarded by static asserts eudebug support is guarded by cmake flags: - NEO_ENABLE_XE_EU_DEBUG_SUPPORT - enables eudebug in general - NEO_USE_XE_EU_DEBUG_EXP_UPSTREAM - registers exp upstream uAPI support - NEO_ENABLE_XE_PRELIM_DETECTION - registers prelim uAPI support This way we can support two different xe-eudebug interfaces within single binary. In unit tests there is mock eudebug interface enabled (even if no eudebug support is enabled by cmake flag). Related-To: NEO-13472 Signed-off-by: Mateusz Jablonski <mateusz.jablonski@intel.com>
79 lines
1.9 KiB
Markdown
79 lines
1.9 KiB
Markdown
<!---
|
|
|
|
Copyright (C) 2020-2021 Intel Corporation
|
|
|
|
SPDX-License-Identifier: MIT
|
|
|
|
-->
|
|
|
|
# Building NEO driver
|
|
|
|
Instructions have been tested on Ubuntu* and CentOS*. They assume a clean installation of a stable version.
|
|
|
|
1. Download & install required packages
|
|
|
|
Example (Ubuntu):
|
|
|
|
```shell
|
|
sudo apt-get install cmake g++ git pkg-config
|
|
```
|
|
|
|
Example (CentOS):
|
|
|
|
```shell
|
|
sudo dnf install gcc-c++ cmake git make
|
|
```
|
|
|
|
2. Install required dependencies
|
|
|
|
Neo requires:
|
|
- [Intel(R) Graphics Compiler for OpenCL(TM)](https://github.com/intel/intel-graphics-compiler)
|
|
- [Intel(R) Graphics Memory Management](https://github.com/intel/gmmlib)
|
|
|
|
Please visit their repositories for building and instalation instructions.
|
|
|
|
Use versions compatible with selected [Neo release](https://github.com/intel/compute-runtime/releases).
|
|
|
|
3. Create workspace folder and download sources:
|
|
|
|
Example:
|
|
|
|
```shell
|
|
mkdir workspace
|
|
cd workspace
|
|
git clone https://github.com/intel/compute-runtime neo
|
|
```
|
|
|
|
4. Create folder for build:
|
|
|
|
Example:
|
|
|
|
```shell
|
|
mkdir build
|
|
```
|
|
|
|
5. (Optional) Enabling additional extensions
|
|
|
|
* [cl_intel_va_api_media_sharing](https://github.com/intel/compute-runtime/blob/master/opencl/doc/cl_intel_va_api_media_sharing.md)
|
|
|
|
6. Build and install
|
|
|
|
Example:
|
|
|
|
```shell
|
|
cd build
|
|
cmake -DCMAKE_BUILD_TYPE=Release -DNEO_SKIP_UNIT_TESTS=1 ../neo
|
|
make -j`nproc`
|
|
sudo make install
|
|
```
|
|
## Optional - Building NEO with support for XeKMD EU Debugging
|
|
|
|
NEO Driver has build options to enable support for EU Debugging with XeKMD. Kernel support for this feature is currently only available via a topic branch hosted at https://gitlab.freedesktop.org/miku/kernel/-/tree/eudebug-dev
|
|
|
|
To build NEO with support for this feature follow above steps with these additional cmake options added to step 6.
|
|
|
|
` -DNEO_ENABLE_XE_EU_DEBUG_SUPPORT=1 -DNEO_USE_XE_EU_DEBUG_EXP_UPSTREAM=1`
|
|
|
|
|
|
___(*) Other names and brands may be claimed as property of others.___
|