Update build instructions

Change-Id: Ied80d0e7b7adecfc8abe6fc309cb69883ebfffab
This commit is contained in:
Cetnerowski, Adam
2018-02-06 15:36:39 +01:00
committed by sys_ocldev
parent 5a175cf1cf
commit 099d6e5f74

View File

@ -28,41 +28,76 @@ LibDRM - https://anongit.freedesktop.org/git/mesa/drm.git
## Building
1. Download all dependencies and create workspace folder as below:
```
workspace
|- clang_source
|- common_clang
|- llvm_patches
|- llvm_source
|- gmmlib https://github.com/intel/gmmlib
|- gmock https://github.com/google/googlemock
|- gtest https://github.com/google/googletest
|- igc https://github.com/intel/intel-graphics-compiler
|- khronos https://github.com/KhronosGroup/OpenCL-Headers
|- libdrm https://anongit.freedesktop.org/git/mesa/drm.git
|- neo https://github.com/intel/compute-runtime
*Instructions assume clean Ubuntu 16.04.3 LTS installation.*
1. Download & install required dependencies
Example:
```shell
sudo apt-get install ccache flex bison clang-4.0 cmake g++ git patch zlib1g-dev
```
2. In your workspace create folder where you will build. For example:
2. Create workspace folder and download sources:
```
workspace
|- clang_source https://github.com/llvm-mirror/clang
|- common_clang https://github.com/intel/opencl-clang
|- llvm_patches https://github.com/intel/llvm-patches
|- llvm_source https://github.com/llvm-mirror/llvm
|- gmmlib https://github.com/intel/gmmlib
|- gmock https://github.com/google/googlemock
|- gtest https://github.com/google/googletest
|- igc https://github.com/intel/intel-graphics-compiler
|- khronos https://github.com/KhronosGroup/OpenCL-Headers
|- libdrm https://anongit.freedesktop.org/git/mesa/drm.git
|- neo https://github.com/intel/compute-runtime
```
Example:
```shell
git clone -b release_40 https://github.com/llvm-mirror/clang clang_source
git clone https://github.com/intel/opencl-clang common_clang
git clone https://github.com/intel/llvm-patches llvm_patches
git clone -b release_40 https://github.com/llvm-mirror/llvm llvm_source
git clone https://github.com/intel/gmmlib gmmlib
git clone -b release-1.7.0 https://github.com/google/googlemock gmock
git clone -b release-1.7.0 https://github.com/google/googletest gtest
git clone https://github.com/intel/intel-graphics-compiler igc
git clone https://github.com/KhronosGroup/OpenCL-Headers khronos
git clone https://anongit.freedesktop.org/git/mesa/drm.git libdrm
git clone https://github.com/intel/compute-runtime neo
```
Note: Instructions for compiling *Intel Graphics Compiler* copied from https://github.com/intel/intel-graphics-compiler/blob/master/README.md
3. Create folder for build:
Example:
```shell
mkdir build
```
3. Build complete driver using commands:
```
4. Build complete driver:
```shell
cd build
cmake -DBUILD_TYPE=Release -DCMAKE_BUILD_TYPE=Release ../neo
make -j`nproc` package
```
### Install
To install OpenCL driver please use deb package generated during build
Example:
```shell
sudo dpkg -i intel-opencl-1.0-0.x86_64-igdrcl.deb
```
## Supported Platforms
Intel Core Processors with Gen8 graphics devices (formerly Broadwell) - OpenCL 2.0
@ -87,6 +122,9 @@ assumed by default. Intel will clearly designate / tag specific builds to
indicate production quality including formal compliance. Other builds should be
considered experimental.
The driver requires Khronos ICD loader to operate correctly:
https://github.com/KhronosGroup/OpenCL-ICD-Loader
The driver has the following functional delta compared to previously released drivers:
* Intel's closed source SRB5.0 driver (aka Classic)
https://software.intel.com/en-us/articles/opencl-drivers#latest_linux_driver