Intel® Graphics Compute Runtime for oneAPI Level Zero and OpenCL™ Driver

compute gpgpu gpu intel intel-hd-graphics opencl

Go to file

Mateusz Hoppe 10e4b54986 Copy ISA before making it resident Signed-off-by: Mateusz Hoppe <mateusz.hoppe@intel.com>		2021-10-12 21:51:06 +02:00
.github	configure repo to create draft PR by default	2021-09-17 07:22:19 +02:00
cmake	Dont compile aux translation builtin on not supported platforms	2021-10-12 07:40:05 +02:00
level_zero	Copy ISA before making it resident	2021-10-12 21:51:06 +02:00
manifests	Do not force RELEASE_WITH_REGKEYS flag	2021-10-12 16:36:55 +02:00
opencl	Move some mocks to shared	2021-10-12 21:46:53 +02:00
scripts	Do not force RELEASE_WITH_REGKEYS flag	2021-10-12 16:36:55 +02:00
shared	Move some mocks to shared	2021-10-12 21:46:53 +02:00
target_aub_tests	Fix run_aub_tests target properties	2021-08-02 16:25:33 +02:00
target_unit_tests	Correct branch_dir_suffix in cmake	2021-09-14 16:00:20 +02:00
third_party	Enable xe_hp_sdv i915 config	2021-10-12 14:24:21 +02:00
.branch	cmake: refactor BRANCH_TYPE evaluation	2020-06-19 16:24:35 +02:00
.clang-format	Initial support for oneAPI Level Zero	2020-03-06 14:53:29 +01:00
.clang-tidy	Correct HeaderFilterRegex	2020-07-14 18:46:37 +02:00
.ctags	…
.gitattributes	…
.gitignore	infra update	2021-03-18 17:52:15 +01:00
.lint-revision	lint revision update	2021-10-12 15:27:24 +02:00
.travis.yml	ci: split L0 builds on Ubuntu 18.04	2020-09-03 12:06:34 +02:00
BUILD.md	Add copyright headers to markdown files	2021-06-28 16:31:27 +02:00
CMakeLists.txt	Enable xe_hp_sdv i915 config	2021-10-12 14:24:21 +02:00
CONTRIBUTING.md	Add copyright headers to markdown files	2021-06-28 16:31:27 +02:00
DISTRIBUTIONS.md	Add copyright headers to markdown files	2021-06-28 16:31:27 +02:00
FAQ.md	Describe WSL environment	2021-07-30 14:06:49 +02:00
GUIDELINES.md	Add copyright headers to markdown files	2021-06-28 16:31:27 +02:00
Jenkinsfile	dependencies update	2021-09-30 15:22:06 +02:00
LICENSE.md	Add copyright headers to markdown files	2021-06-28 16:31:27 +02:00
README.md	Documentation: Update supported platforms	2021-08-11 13:22:46 +02:00
WSL.md	Describe WSL environment	2021-07-30 14:06:49 +02:00
config.h.in	Copyright header update	2021-05-17 20:38:19 +02:00
driver_version.h.in	Add interface to extract versioning info	2021-06-29 13:17:15 +02:00
igc.opencl.h.in	…
lib_names.h.in	…
os_release_info.cmake	Cmake format script	2020-08-19 16:36:30 +02:00
package.cmake	Copyright header update	2021-05-17 20:38:19 +02:00
package_config.cmake	…
platforms.cmake	Dont compile aux translation builtin on not supported platforms	2021-10-12 07:40:05 +02:00
ubsan.supp	…
version.cmake	refactor NEO_VERSION calculation	2021-09-16 13:49:00 +02:00

README.md

Intel(R) Graphics Compute Runtime for oneAPI Level Zero and OpenCL(TM) Driver

Introduction

The Intel(R) Graphics Compute Runtime for oneAPI Level Zero and OpenCL(TM) Driver is an open source project providing compute API support (Level Zero, OpenCL) for Intel graphics hardware architectures (HD Graphics, Xe).

What is NEO?

NEO is the shorthand name for Compute Runtime contained within this repository. It is also a development mindset that we adopted when we first started the implementation effort for OpenCL.

The project evolved beyond a single API and NEO no longer implies a specific API. When talking about a specific API, we will mention it by name (e.g. Level Zero, OpenCL).

License

The Intel(R) Graphics Compute Runtime for oneAPI Level Zero and OpenCL(TM) Driver is distributed under the MIT License.

You may obtain a copy of the License at: https://opensource.org/licenses/MIT

Supported Platforms

Platform	OpenCL	Level Zero
Intel Core Processors with Gen8 graphics devices (formerly Broadwell)	3.0	-
Intel Core Processors with Gen9 graphics devices (formerly Skylake, Kaby Lake, Coffee Lake)	3.0	Y
Intel Atom Processors with Gen9 graphics devices (formerly Apollo Lake, Gemini Lake)	3.0	-
Intel Core Processors with Gen11 graphics devices (formerly Ice Lake)	3.0	Y
Intel Atom Processors with Gen11 graphics devices (formerly Elkhart Lake)	3.0	-
Intel Core Processors with Gen12 graphics devices (formerly Tiger Lake, Rocket Lake)	3.0	Y

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.

Installation Options

To allow NEO access to GPU device make sure user has permissions to files /dev/dri/renderD*.

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* 20.04:

apt-get install intel-opencl-icd

Procedures for other distributions.

Manual download

.deb packages for Ubuntu are provided along with installation instructions and Release Notes on the release page

Linking applications

Directly linking to the runtime library is not supported:

Level Zero applications should link with Level Zero loader
OpenCL applications should link with ICD loader library (ocl-icd)

Dependencies

GmmLib - https://github.com/intel/gmmlib
Intel Graphics Compiler - https://github.com/intel/intel-graphics-compiler

In addition, to enable performance counters support, the following packages are needed:

Intel Metrics Discovery - https://github.com/intel/metrics-discovery
Intel Metrics Library for MDAPI - https://github.com/intel/metrics-library

How to provide feedback

By default, please submit an issue using native github.com interface.

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. See contribution guidelines for more details.