summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorYang Rong <rong.r.yang@intel.com>2017-01-20 17:33:08 +0800
committerYang Rong <rong.r.yang@intel.com>2017-01-20 18:35:38 +0800
commitbf15ed438ff255ed4cd56cc9c585f1a2afbcc018 (patch)
tree249407848fa55c96c6f5ebd20f7f850c6392319c /docs
parent1d481e00b5cf0fd362b1b54ac05924461b9cf1b0 (diff)
downloadbeignet-bf15ed438ff255ed4cd56cc9c585f1a2afbcc018.tar.gz
Doc: add OpenCL 2.0 section to readme.
Signed-off-by: Yang Rong <rong.r.yang@intel.com> Reviewed-by: Ruiling Song <ruiling.song@intel.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/Beignet.mdwn12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/Beignet.mdwn b/docs/Beignet.mdwn
index 64d33dc2..aafdcb49 100644
--- a/docs/Beignet.mdwn
+++ b/docs/Beignet.mdwn
@@ -158,6 +158,18 @@ Supported Targets
* 6th Generation Intel Core Processors "Skylake" and "Kabylake".
* 5th Generation Intel Atom Processors "Broxten" or "Apollolake".
+OpenCL 2.0
+----------
+From release v1.3.0, beignet support OpenCL 2.0. By default, OpenCL 2.0 support is disabled, you can enable it when cmake with option
+-DENABLE_OPENCL_20=1. Please remember that to enable OpenCL 2.0, there are some dependencies. First, OpenCL 2.0 only support the targets
+from Skylake, include Skylake, Kabylake and Apollolake. Then, clang supports all OpenCL 2.0 feature from 3.9. So to enable OpenCL 2.0,
+you must update LLVM/clang to 3.9 or later. And also requeires libdrm at least 2.4.66.
+After enable OpenCL 2.0, beignet complies with OpenCL 2.0 spec, but some OpenCL 2.0 features are simulated by software, there is no performance
+gain, such as pipe and device queues, especially device queues.
+If you build beignet with OpenCL 2.0 enabled and your kernel don't use the OpenCL 2.0 features, please pass a build option -cl-std=CL1.2 for
+performance, the OpenCL 2.0 uses more registers and has lots of int64 operations, which may hurt performance, and beignet will continue to improve
+OpenCL 2.0 performance.
+
Known Issues
------------