3c44c6f942
- On Windows, if one uses remote desktop to connect to their windows machine, then attempts to run compute workloads, a shadow intel graphics device is created and L0/OpenCL will report 2 devices for a single device. - This second device is not valid and if used will cause workload failures. - to ensure that only usable devices are reported by L0/OpenCL, we now check the Adapter for its Support in D3DKMT_ADAPTERTYPE which for our use must have RenderSupported. The Shadow devices only support display and not rendering/compute, so this check will avoid reporting a display only intel device for compute usage. Change-Id: Ib619c454aea2deb91135e7958efbca1cee5a05eb Signed-off-by: Spruit, Neil R <neil.r.spruit@intel.com> Signed-off-by: Mateusz Jablonski <mateusz.jablonski@intel.com>
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) | 2.1 | - |
| Intel Core Processors with Gen9 graphics devices (formerly Skylake, Kaby Lake, Coffee Lake) | 2.1 | Y |
| Intel Atom Processors with Gen9 graphics devices (formerly Apollo Lake, Gemini Lake) | 1.2 | - |
| Intel Core Processors with Gen11 graphics devices (formerly Ice Lake) | 2.1 | Y |
| Intel Core Processors with Gen12 graphics devices (formerly Tiger 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.
See also
Level Zero specific
- oneAPI Level Zero specification
- Intel(R) OneApi Level Zero Specification API C/C++ header files
- oneAPI Level Zero tests
OpenCL specific
- OpenCL on Linux guide
- Intel(R) GPU Compute Samples
- Frequently Asked Questions
- Interoperability with VTune
- OpenCL Conformance Tests
(*) Other names and brands may be claimed as property of others.