Intel_SDK_for_OpenCL_2017_r2_release_notes
Intel_SDK_for_OpenCL_2017_r2_release_notes
2017
Release Notes
15 March 2018
Intel® SDK for OpenCL™ Applications 2017
Customer Support
For technical support, including answers to questions not addressed in this product, visit the technical support
forum, FAQs, and other support information at: Intel OpenCL Support or
http://www.intel.com/software/products/support/.
To provide feedback and suggestions or submit an issue, go to the Intel OpenCL Forum.
2
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
Contents:
1 Introduction 4
2 New in This Release 5
3 Known Issues 6
4 Related Documentation 9
5 Where to Find the Release 10
6 System Requirements 11
7 Installation Notes 14
8 Attributions 17
9 Legal Information 22
3
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
1 Introduction
Intel® SDK for OpenCL™ applications assists with creating, building, debugging, and analyzing PC and mobile
applications developed with OpenCL™ API on Windows* and Linux* OSes.
Please note: a driver/runtime package must also be installed to run applications developed with the SDK.
This document contains information about new features, system requirements, installation instructions, fixed
bugs, limitations and known issues.
New features listed in the New in This Release section below, or in the help
Reference documentation listed in the Related Documentation section below
Installation instructions at Installation Notes
4
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
Intel® SDK for OpenCL™ Applications 2017 includes all the features for OpenCL development for
Windows* previously available in Intel® SDK for OpenCL™ Application 2016 R3 and all features for Linux*
development which available in Code Builder for Intel® Media Server Studio.
For a full list of features, refer to the Intel® SDK for OpenCL™ Applications Developer Guide.
5
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
3 Known Issues
3.1 General Limitations
When working with the default Intel OpenCL™ Platform together with OpenCL 2.1 experimental
platform there may be performance issues.
If you are using the Eclipse* Mars IDE on the Linux* Ubuntu x64 system, set the SWT_GTK3
environment prior running the IDE:
SWT_GTK3 = 0
6
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
o Kernel analysis features are not supported on Intel® processors older than 4th Generation Intel®
Core™ Processors
o Latency and occupancy reports cannot be generated for built-in kernels which are generated
with clCreateProgramWithBuiltInKernels
o Calling the API clCreateProgramWithBuiltInKernels or clCreateAcceleratorINTEL
generates additional OpenCL APIs in the API Analyze report, these APIs do not appear in the
code.
o Occupancy analysis is not supported on an application that includes a call to Microsoft D3D11
API GetData(). Running Occupancy analysis on such an application leads to application crash
with an exception.
o Kernel analysis, HW counters and some of the hints are available only for kernels that run on
GPU (shared context is not supported)
o Host and kernel level analysis are not supported on an application that uses the motion
estimation extension
workloads that use profiling feature. Increase the TDR delay to avoid the TDRs. For details, refer to the
article at https://msdn.microsoft.com/en-us/library/windows/hardware/ff570087(v=vs.85).aspx
The OpenCL™ Driver is available on systems with Intel® Processor Graphics and discrete graphics
cards (Microsoft Windows* OS only):
o Capabilities of both discrete and integrated graphics are available if display is connected to:
Integrated graphics card display port.
Discrete and integrated graphics cards simultaneously.
o Capabilities of a discrete card only are available if the display is connected to:
Discrete graphics card display port.
Integrated graphics card, and a discrete graphics card without display ports.
8
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
4 Related Documentation
Here is the documentation related to Intel® SDK for OpenCL™ applications:
9
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
For more info on how to choose which driver/runtime package you need and how to download it, please see
https://software.intel.com/en-us/articles/opencl-drivers.
10
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
6 System Requirements
6.1 Supported Architectures and Terminology
For an explanation of architecture names, see http://software.intel.com/en-us/articles/intel-architecture-
platform-terminology/.
The following matrix determines Intel processors support on Microsoft Windows*, Linux* and Android*
operating systems.
11
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
For more information on the supported runtime and drivers, go to OpenCL™ Drivers and Runtimes
for Intel® Architecture https://software.intel.com/en-us/articles/opencl-drivers.
12
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
Intel® SDK for OpenCL™ Applications plugin for the Eclipse* IDE requires Java Runtime Environment
1.8 installed on your Microsoft Windows* or Linux* machine.
https://software.intel.com/en-us/articles/driver-support-matrix-for-media-sdk-and-opencl
For more information on supported runtimes and drivers for Linux* go to OpenCL™ Drivers and Runtimes
for Intel® Architecture at https://software.intel.com/en-us/articles/opencl-drivers.
The Linux Eclipse* plug-in requires the libicu52 (Unicode support) runtimes installed.
Could not load required libraries; please make sure to set the correct
path under the CodeBuilder for OpenCL preference page.
$dpkg -i libicu52_52.1-8_amd64.deb
13
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
7 Installation Notes
7.1 Installation on Microsoft Windows* OS
For OpenCL™ support on Intel® processors with Intel® Processor Graphics you must have the Intel®
Graphics Driver (version 15.40 or higher) installed.
You can obtain the latest driver version using the Intel® Driver Update Utility, or manually here
You can obtain Intel® SDK for OpenCL™ Applications installer from the SDK web page:
https://software.intel.com/en-us/intel-opencl
You must have administrator privileges to install and use the SDK on Microsoft Windows* operating systems.
Before installing the Intel® SDK for OpenCL™ Applications for Windows operating systems it is recommended
to remove any previous version of the SDK from your computer.
To install the Intel® SDK for OpenCL™ Applications on Windows operating systems, run the installation
package and follow the installer prompts.
NOTE: Intel graphics driver includes OpenCL support for both CPU and Intel® Processor Graphics.
The INTELOCLSDKROOT variable must be set to the target installation directory. The default installation directory is
C:\Intel\OpenCL\
Also make sure that the installation folder is in the system PATH environment variable.
14
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
C:\Intel\OpenCL
You can use the install scripts here for automated install: https://software.intel.com/en-us/articles/sdk-for-
opencl-gsg.
Intel® SDK for OpenCL™ applications 2017 for Linux* installation package is delivered in the form of archives
containing RPM packages with installer scripts for easy installation/uninstallation procedures. Installer provides
both common-line and graphical user interface modes. You can use any of the approaches (use command-line
or graphical user interface directly).
Please note: SDK install on other Linux distros like RHEL 7.2* and SLES 12.1* may also be possible but this
does not imply driver support.
All RPM packages of the Intel® SDK for OpenCL™ applications are digitally signed.
# cd intel_sdk_for_opencl_2017_7.0.0.<VERSION>
2. Run the following command (for command-line interface) and follow the installer prompts:
# ./install.sh
3. Alternatively (for installation with graphical user interface) run the following command:
# ./install_GUI.sh
$dpkg -i libicu52_52.1-8_amd64.deb
15
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
Could not load required libraries; please make sure to set the correct
path under the CodeBuilder for OpenCL preference page.
3. Remove previous versions of the plugin from the Eclipse* dropins folder.
NOTE: All RPM packages of the Intel SDK for OpenCL Applications are digitally signed.
After downloading, you can verify the signature of the RPM package:
# /etc/alternatives/opencl-intel-tools/uninstall.sh
4. Alternatively (for uninstallation with graphical user interface), run the following command from the
installed product location and select uninstall option:
# /etc/alternatives/opencl-intel-tools/uninstall_GUI.sh
16
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
8 Attributions
Boost
Boost is used, from boost distribution:
Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software
and accompanying documentation covered by this license (the "Software") to use, reproduce, display,
distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit
third-parties to whom the Software is furnished to do so, all subject to the following: The copyright notices in
the Software and this entire statement, including the above license grant, this restriction and the following
disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the
Software, unless such copies or derivative works are solely in the form of machine-executable object code
generated by a source language processor.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT
HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER
LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
MIT License
The following components are used and have MIT license:
Codrops Stapel,Unspecified
DataTables,1.10.3
Eclipse IDE Auto-generated Code,Unspecified
Eclipse Public License 1.0,Unspecified
JsLib,Unspecified
Modernizr,Unspecified
flot,0.8.3
flot,Unspecified
jQuery UI - jquery/jquery-ui on GitHub,Unspecified
modernizer,Unspecified
syntaxhighlighter,Unspecified
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to the following conditions: The above
copyright notice and this permission notice shall be included in all copies or substantial portions of the
Software.
17
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Apache License
Windows Ook Language Integration is used. It has Apache license. From Apache License 2.0:
Copyright [APPACHE] [name of copyright owner] Licensed under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance with the License. You may obtain a copy of the
License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed
on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.
Zlib License
tinyxml2 is used. From Zlib license:
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held
liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and
to alter it and redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original
software. If you use this software in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the
original software.
3. This notice may not be removed or altered from any source distribution.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
disclaimer.
18
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
OF SUCH DAMAGE.
• updates,
• supplements,
• support services
for this software, unless other terms accompany those items. If so, those terms apply.
BY USING THE SOFTWARE, YOU ACCEPT THESE TERMS. IF YOU DO NOT ACCEPT THEM, DO NOT USE
THE SOFTWARE.
If you comply with these license terms, you have the rights below.
a. Installation and Use. You may install and use any number of copies of the software on your devices.
b. Included Microsoft Programs. The software contains other Microsoft programs. The license terms with those
programs apply to your use of them.
a. Media Elements and Templates. You may copy and use images, clip art, animations, sounds, music, shapes,
video clips and templates provided with the software and identified for such use in documents and projects that you
create. You may distribute those documents and projects non-commercially. If you wish to use these media
elements or templates for any other purpose, go to www.microsoft.com/permission to learn whether that use is
allowed.
19
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
b. Distributable Code.
Sometimes the reciprocal license is incorrectly interpreted to also apply to bundles, packages, custom actions
built using the WiX toolset. The Outercurve Foundation has provided this statement to clarify:
The WiX toolset (WiX) is licensed under the Microsoft Reciprocal License (MS-RL). The MS-RL governs the
distribution of the software licensed under it, as well as derivative works, and incorporates the definition of a
derivative work provided in U.S. copyright law. OuterCurve Foundation does not view the installer packages
generated by WiX as falling within the definition of a derivative work, merely because they are produced using WiX.
Thus, the installer packages generated by WiX will normally fall outside the scope of the MS-RL, and any of your
source code, binaries, libraries, routines or other software components that are incorporated in installer packages
generated by WiX can be governed by other licensing terms.
The full text of the MS-RL license is reproduced below. It can also be found in the LICENSE.TXT file included
with the source code.
1. Definitions
The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same
meaning here as under U.S. copyright law.
A "contributor" is any person that distributes its contribution under this license.
"Licensed patents" are a contributor's patent claims that read directly on its contribution.
2. Grant of Rights
20
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
(A) Copyright Grant- Subject to the terms of this license, including the license conditions and
limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free
copyright license to reproduce its contribution, prepare derivative works of its contribution, and
distribute its contribution or any derivative works that you create.
(B) Patent Grant- Subject to the terms of this license, including the license conditions and
limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free
license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or
otherwise dispose of its contribution in the software or derivative works of the contribution in the
software.
(A) Reciprocal Grants- For any file you distribute that contains code from the software (in source
code or binary format), you must provide recipients the source code to that file along with a copy
of this license, which license will govern that file. You may license other files that are entirely your
own work and do not contain code from the software under any terms you choose.
(B) No Trademark License- This license does not grant you rights to use any contributors' name,
logo, or trademarks.
(C) If you bring a patent claim against any contributor over patents that you claim are infringed by
the software, your patent license from such contributor to the software ends automatically.
(D) If you distribute any portion of the software, you must retain all copyright, patent, trademark,
and attribution notices that are present in the software.
(E) If you distribute any portion of the software in source code form, you may do so only under this
license by including a complete copy of this license with your distribution. If you distribute any
portion of the software in compiled or object code form, you may only do so under a license that
complies with this license.
(F) The software is licensed "as-is." You bear the risk of using it. The contributors give no express
warranties, guarantees or conditions. You may have additional consumer rights under your local
laws which this license cannot change. To the extent permitted under your local laws, the
contributors exclude the implied warranties of merchantability, fitness for a particular purpose and
non-infringement.
21
Intel® SDK for OpenCL™ Applications 2017 Release Notes
Intel® SDK for OpenCL™ Applications 2017
9 Legal Information
No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this
document.
Intel disclaims all express and implied warranties, including without limitation, the implied warranties of
merchantability, fitness for a particular purpose, and non-infringement, as well as any warranty arising from
course of performance, course of dealing, or usage in trade.
This document contains information on products, services and/or processes in development. All information
provided here is subject to change without notice. Contact your Intel representative to obtain the latest
forecast, schedule, specifications and roadmaps.
The products and services described may contain defects or errors known as errata which may cause
deviations from published specifications. Current characterized errata are available on request.
Copies of documents which have an order number and are referenced in this document may be obtained by
calling 1-800-548-4725 or by visiting www.intel.com/design/literature.htm.
Intel, the Intel logo, Intel Atom, Intel Atom Inside, Intel Core, Intel vPro, Intel Xeon Phi, Itanium, Pentium,
Celeron, Ultrabook, VTune, Xeon, are trademarks of Intel Corporation in the U.S. and/or other countries.
OpenCL and the OpenCL logo are trademarks of Apple Inc. used by permission from Khronos.
Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation
in the United States and/or other countries.
22
Intel® SDK for OpenCL™ Applications 2017 Release Notes