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
motivation and intentions wrt OpenCL support in the open source.
## 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
2019-12-16 20:03:25 +08:00
## Installation Options
2020-02-25 17:25:51 +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-25 17:25:51 +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
NEO is available for installation on a variety of Linux distributions and can be installed via the distro's package manager.
For example on Ubuntu* 19.04, 19.10:
```
apt-get install intel-opencl-icd
```
2020-02-27 19:00:57 +08:00
Procedures for other [distributions ](https://github.com/intel/compute-runtime/blob/master/documentation/DISTRIBUTIONS.md ).
2019-12-16 20:03:25 +08:00
### Manual download
.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-27 19:00:57 +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
## Supported Platforms
2018-07-13 19:29:58 +08:00
* 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
2019-04-06 01:23:05 +08:00
* Intel Core Processors with Gen11 graphics devices (formerly Ice Lake) - OpenCL 2.1
2019-09-27 16:56:38 +08:00
* Intel Core Processors with Gen12 graphics devices (formerly Tiger Lake) - OpenCL 2.1
2019-04-06 01:23:05 +08:00
2020-02-27 19:00:57 +08:00
## 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.
2018-04-10 15:35:25 +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
## Tutorial applications
The [Intel(R) GPU Compute Samples repository ](https://github.com/intel/compute-samples/blob/master/compute_samples/applications/usm_hello_world/README.md )
has sample source code to demonstrate features of Intel(R) Graphics Compute Runtime for OpenCL(TM) Driver.
2017-12-21 07:45:38 +08:00
## How to provide feedback
2018-07-13 19:29:58 +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-27 19:00:57 +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
2019-02-14 18:24:16 +08:00
* [OpenCL on Linux guide ](https://github.com/bashbaug/OpenCLPapers/blob/markdown/OpenCLOnLinux.md )
2020-02-27 19:00:57 +08:00
* [Interoperability with VTune ](https://github.com/intel/compute-runtime/blob/master/opencl/doc/VTUNE.md )
* [Contribution guidelines ](https://github.com/intel/compute-runtime/blob/master/documentation/CONTRIBUTING.md )
* [Known issues and limitations ](https://github.com/intel/compute-runtime/blob/master/opencl/doc/LIMITATIONS.md )
* [Frequently Asked Questions ](https://github.com/intel/compute-runtime/blob/master/FAQ.md )
2017-12-21 07:45:38 +08:00
2019-03-21 00:17:49 +08:00
___(*) Other names and brands may be claimed as property of others.___
