diff --git a/README.md b/README.md index 9f377a4c50..96b20b35e9 100644 --- a/README.md +++ b/README.md @@ -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