2017-12-21 07:45:38 +08:00
|
|
|
# Intel(R) Graphics Compute Runtime for OpenCL(TM)
|
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
2019-03-21 00:17:49 +08:00
|
|
|
The Intel(R) Graphics Compute Runtime for OpenCL(TM) is an open source project to
|
2017-12-21 07:45:38 +08:00
|
|
|
converge Intel's development efforts on OpenCL(TM) compute stacks supporting the
|
|
|
|
|
GEN graphics hardware architecture.
|
|
|
|
|
|
|
|
|
|
Please refer to http://01.org/compute-runtime for additional details regarding Intel's
|
2020-02-28 16:30:11 +08:00
|
|
|
motivation and intentions wrt OpenCL support in open source.
|
2017-12-21 07:45:38 +08:00
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
2018-02-15 03:50:30 +08:00
|
|
|
The Intel(R) Graphics Compute Runtime for OpenCL(TM) is distributed under the MIT License.
|
2017-12-21 07:45:38 +08:00
|
|
|
|
2018-04-18 22:27:52 +08:00
|
|
|
You may obtain a copy of the License at: https://opensource.org/licenses/MIT
|
2017-12-21 07:45:38 +08:00
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
## Supported Platforms
|
|
|
|
|
|
|
|
|
|
* Intel Core Processors with Gen8 graphics devices (formerly Broadwell) - OpenCL 2.1
|
|
|
|
|
* Intel Core Processors with Gen9 graphics devices (formerly Skylake, Kaby Lake, Coffee Lake) - OpenCL 2.1
|
|
|
|
|
* Intel Atom Processors with Gen9 graphics devices (formerly Apollo Lake, Gemini Lake) - OpenCL 1.2
|
|
|
|
|
* Intel Core Processors with Gen11 graphics devices (formerly Ice Lake) - OpenCL 2.1
|
|
|
|
|
* Intel Core Processors with Gen12 graphics devices (formerly Tiger Lake) - OpenCL 2.1
|
|
|
|
|
|
|
|
|
|
## Release cadence
|
|
|
|
|
|
|
|
|
|
* Once a week, we run extended validation cycle on a selected driver.
|
|
|
|
|
* When the extended validation cycle tests pass, the corresponding commit on github is tagged using
|
|
|
|
|
the format yy.ww.bbbb (yy - year, ww - work week, bbbb - incremental build number).
|
|
|
|
|
* Typically for weekly tags we will post a binary release (e.g. deb).
|
|
|
|
|
* Quality level of the driver (per platform) will be provided in the Release Notes.
|
|
|
|
|
|
2019-12-16 20:03:25 +08:00
|
|
|
## Installation Options
|
|
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
To allow NEO accessing GPU device make sure user has permissions to files /dev/dri/renderD*.
|
2019-12-16 20:03:25 +08:00
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
Under Ubuntu* or Centos* user must be in video group.
|
|
|
|
|
In Fedora* all users by default have access to /dev/dri/renderD* files.
|
2019-12-16 20:03:25 +08:00
|
|
|
|
|
|
|
|
### Via system package manager
|
|
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
NEO is available for installation on a variety of Linux distributions
|
|
|
|
|
and can be installed via the distro's package manager.
|
2019-12-16 20:03:25 +08:00
|
|
|
|
|
|
|
|
For example on Ubuntu* 19.04, 19.10:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
apt-get install intel-opencl-icd
|
|
|
|
|
```
|
|
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
Procedures for other
|
2020-03-04 17:26:34 +08:00
|
|
|
[distributions](https://github.com/intel/compute-runtime/blob/master/DISTRIBUTIONS.md).
|
2020-02-28 16:30:11 +08:00
|
|
|
|
|
|
|
|
## Linking applications
|
|
|
|
|
|
|
|
|
|
When building applications, they should link with ICD loader library (ocl-icd).
|
|
|
|
|
Directly linking to the runtime library (igdrcl) is not supported.
|
2019-12-16 20:03:25 +08:00
|
|
|
|
|
|
|
|
### Manual download
|
|
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
.deb packages for Ubuntu are provided along with installation instructions and
|
|
|
|
|
Release Notes on the [release page](https://github.com/intel/compute-runtime/releases)
|
2019-04-18 22:26:03 +08:00
|
|
|
|
2018-01-16 23:14:44 +08:00
|
|
|
## Dependencies
|
|
|
|
|
|
2018-07-13 19:29:58 +08:00
|
|
|
* GmmLib - https://github.com/intel/gmmlib
|
|
|
|
|
* Intel Graphics Compiler - https://github.com/intel/intel-graphics-compiler
|
2018-04-18 22:27:52 +08:00
|
|
|
|
|
|
|
|
## Optional dependencies
|
|
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
To enable
|
|
|
|
|
[cl_intel_va_api_media_sharing](https://www.khronos.org/registry/OpenCL/extensions/intel/cl_intel_va_api_media_sharing.txt)
|
|
|
|
|
extension, the following packages are required:
|
2018-04-18 22:27:52 +08:00
|
|
|
|
2018-07-13 19:29:58 +08:00
|
|
|
* libdrm - https://anongit.freedesktop.org/git/mesa/drm.git
|
|
|
|
|
* libva - https://github.com/intel/libva.git
|
2018-01-16 23:14:44 +08:00
|
|
|
|
2017-12-21 07:45:38 +08:00
|
|
|
## How to provide feedback
|
|
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
By default, please submit an issue using native github.com [interface](https://github.com/intel/compute-runtime/issues).
|
2017-12-21 07:45:38 +08:00
|
|
|
|
|
|
|
|
## How to contribute
|
|
|
|
|
|
|
|
|
|
Create a pull request on github.com with your patch. Make sure your change is cleanly building and passing ULTs.
|
|
|
|
|
A maintainer will contact you if there are questions or concerns.
|
2020-02-28 16:30:11 +08:00
|
|
|
See
|
|
|
|
|
[contribution guidelines](https://github.com/intel/compute-runtime/blob/master/documentation/CONTRIBUTING.md)
|
|
|
|
|
for more details.
|
2017-12-21 07:45:38 +08:00
|
|
|
|
2018-02-19 20:53:48 +08:00
|
|
|
## See also
|
2019-05-24 22:46:27 +08:00
|
|
|
|
2020-02-27 19:00:57 +08:00
|
|
|
* [Contribution guidelines](https://github.com/intel/compute-runtime/blob/master/documentation/CONTRIBUTING.md)
|
|
|
|
|
* [Frequently Asked Questions](https://github.com/intel/compute-runtime/blob/master/FAQ.md)
|
2017-12-21 07:45:38 +08:00
|
|
|
|
2020-02-28 16:30:11 +08:00
|
|
|
### OpenCL specific
|
|
|
|
|
|
|
|
|
|
* [OpenCL on Linux guide](https://github.com/bashbaug/OpenCLPapers/blob/markdown/OpenCLOnLinux.md)
|
|
|
|
|
* [Intel(R) GPU Compute Samples](https://github.com/intel/compute-samples)
|
|
|
|
|
* [Frequently Asked Questions](https://github.com/intel/compute-runtime/blob/master/opencl/doc/FAQ.md)
|
|
|
|
|
* [Interoperability with VTune](https://github.com/intel/compute-runtime/blob/master/opencl/doc/VTUNE.md)
|
|
|
|
|
* [OpenCL Conformance Tests](https://github.com/KhronosGroup/OpenCL-CTS/)
|
|
|
|
|
|
|
|
|
|
___(*) Other names and brands may be claimed as property of others.___
|
