Intel® SDK for OpenCL™ Applications 2014 Beta Release Notes

Download PDF

Contents

Introduction

The Intel® SDK for OpenCL™ Applications 2014 Beta provides a comprehensive development environment on Intel® processors for Windows*, Ubuntu*, and Android* operating systems.
This document contains information about new features, system requirements, installation instructions, fixed bugs, limitations and known issues.

What's New

In this release (Intel® SDK for OpenCL™ Applications 2014 Beta):

  • Support for Android* OS 4.4 (KitKat) as target platform running on Intel® Atom™ processors with Intel HD Graphics, formerly codenamed Bay Trail.
  • Introduction of the Code Builder - a single toolset, bundled with the SDK, that includes all SDK 2013 features and the following new capabilities:
    • Remote OpenCL Kernel development on supported Android devices and emulator
    • Integration with Eclipse* IDE
    • Integration with Microsoft Visual Studio* IDE 2013.
    • OpenCL API level debugging with command tracing, queue and memory views
    • OpenCL kernel performance analysis (deep kernel analysis)
    • Automatic generation of OpenCL host code with predefined kernels
    • Saving and Restoring sessions in the Kernel Builder
  • Support for Ubuntu* OS 12.4 as the host system for application development.
  • Microsoft Visual Studio 2013 support in the OpenCL samples that are available online >

NOTE:
OpenCL 1.2 support on Android* OS with Intel® Atom™ Processors is based on a published Khronos* specification, and is expected to pass the Khronos Conformance Testing Process. Current conformance status can be found at www.khronos.org/conformance.

System Requirements

The following sections provide information about supported hardware and operating systems.

Target Environment
(the system where your application runs)

Development Environment
(where you develop your application)

Windows* 7/8/8.1 OS running on Intel® Core™ Processors Family

Windows 7/8/8.1 OS running on Intel® Processors

Windows* 7/8/8.1 OS running on Intel® Atom™ Processor Family formerly codenamed Bay Trail

Android* 4.4 running on Intel® Atom™ Processor Family formerly codenamed Bay Trail

Android* 4.4 running on Intel® Atom™ Processor Family formerly codenamed Bay Trail

Ubuntu* OS 12.4 (LTS) running on Intel® Processors

Note:
Intel® SDK for OpenCL™ Applications 2014 Beta provide Android* OS support on rooted Intel devices only.

Supported Hardware

See the Intel* Processors Support Matrix below.

Intel® Platform

SDK Platform

Target Application Platform

Windows* 7/8

Ubuntu*12.4

Windows* 7/8/8.1

Ubuntu* 12.4

Android* JellyBean 4.2.2

   

CPU

Intel Graphics

CPU

Intel Graphics

CPU

Intel Graphics

Intel® Atom™ Processor Z3000 Series with Intel® HD Graphics

 

 

4th Generation Intel® Core™ Processors with:

  • Intel® HD Graphics 4200/ 4400/4600/5000
  • Intel® Iris™ Graphics 5100
  • Intel® Iris™ Pro graphics 5200

     

3rd Generation Intel® Core™ Processors with Intel® HD Graphics 4000/2500

 

   

1st and 2nd Generation Intel® Core™ Processors

 

 

   

Intel® Celeron® Processor J1000/N2000 Series and
Intel Pentium Processor J2000/N3000 Series with Intel® HD Graphics

 

 

 

 

Intel Xeon Processor E3 Family with:

  • Intel HD Graphics P4000
  • Intel HD Graphics P4600/P4700

 

 

 

To run and use Intel® SDK for OpenCL™ Applications 2014 Beta you must have a PC based on an IA-32 or Intel 64 architecture processor.

For Windows* and Linux* operating systems support on Intel® Xeon® Processors without Intel® Processor Graphics, go to the Intel® SDK for OpenCL™ Applications XE 2013 web site at: http://software.intel.com/en-us/vcsource/tools/opencl-sdk-xe.

Note:
Incompatible or proprietary instructions in non-Intel processors may cause the analysis capabilities of this product to function incorrectly. Any attempt to analyze code not supported by Intel processors may lead to failures in this product.

Supported Operating Systems

Intel® SDK for OpenCL™ Applications 2014 Beta supports development on the following operating systems:

  • Microsoft Windows* 8.1 OS 32-bit and 64-bit versions
  • Microsoft Windows* 8 OS 32-bit and 64-bit versions
  • Microsoft Windows* 7 Service Pack 1 32-bit version and 64-bit versions
  • Ubuntu* OS 12.4 (LTS) 64-bit versions

Note:
You must have administrator privileges to install and use the SDK on Microsoft Windows operating systems.

Installation Notes

For OpenCL™ support on the following Intel® Graphics devices you must have the Intel Graphics Driver (version 15.33.3 or higher) installed:

  • Intel® HD Graphics 4000/2500
  • Intel® HD Graphics 4200/4400/4600/5000
  • Intel® Iris™ Graphics 5100
  • Intel® Iris™ Pro Graphics 5200

You can obtain the latest driver version using the Intel® Driver Update Utility.

Installation on Microsoft Windows* OS

Before starting the installation, make sure the following software components are installed on your machine:

  • Microsoft Windows* Installer 3.1
  • Microsoft Visual C++* 2010 runtime libraries x86 and x64

If one of the components is not installed, the SDK installer will prompt you to install them.

To install the Intel® SDK for OpenCL™ Applications 2014 Beta on Windows operating systems,

  1. Upgrade the Intel® Graphics Driver using the Intel Driver Update Utility.
  2. (For 1st and 2nd generations Intel Core processors only) download and install the Intel SDK for OpenCL™ – CPU only runtime package for the target operating system (32- or 64-bit version).
  3. Download and install the Intel® SDK for OpenCL™ Applications 2014 Beta.

The Intel® SDK for OpenCL™ Applications 2014 Beta installation includes the following components:

  • OpenCL C header files and libraries
  • Intel OpenCL™ Code Builder:
    • Kernel Building  32- and 64-bit version
    • Offline Compilation command-line utility 32- and 64-bit version
    • Offline Compilation plug-in for Microsoft Visual Studio* 2010 and higher
    • Offline Compilation plug-in for Eclipse 4.2
    • Debugging plug-in for Microsoft Visual Studio* IDE

Uninstalling Intel® SDK for OpenCL™ Applications 2014 Beta

To remove SDK components, use the Control Panel > Programs and Features > Intel® SDK for OpenCL™ Applications 2014 Beta > Uninstall.

The uninstaller removes all originally installed files, leaving any temporary or newly created files. To ensure a clean uninstallation, verify that the INTELOCLSDKROOT, INTELOCLSAMPLESROOT, and PATH environment variables are in their preinstall state.

Setting Environment Variables on Microsoft Windows* OS Manually

Intel® SDK for OpenCL™ Applications 2014 Beta installation process makes a few system environment modifications. When the environment variables become corrupted on the installed system, ensure that the environment variables are defined as follows.

The INTELOCLSDKROOT variable must be set to the target installation directory. The default installation directories are:

  • C:\Program Files\Intel\OpenCL SDK\4.0 for 32-bit operating systems
  • C:\Program Files (x86)\Intel\OpenCL SDK\4.0 for 64-bit operating systems

Also make sure that the installation folder is in the system PATH environment variable.

OpenCL Installable Client Driver (ICD) Modification

The OpenCL™ Installable Client Driver (ICD) requires the OpenCL™ vendor runtime DLL file registration in the system registry. This enables the ICD to load the DLL file and use its implemented platforms. The installation affects the registry keys listed below:

For 64-bit operating systems:

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Khronos\OpenCL\Vendors]

The key should include a DWORD registry value set to 0. The value name should be the name of the runtime DLL file: IntelOpenCL32.dll

[HKEY_LOCAL_MACHINE\SOFTWARE\Khronos\OpenCL\Vendors]

The key should include a DWORD registry value set to 0. The value name should be IntelOpencl64.dll

For 32-bit operating systems:

[HKEY_LOCAL_MACHINE\SOFTWARE\Khronos\OpenCL\Vendors]

The key should include a DWORD registry value set to 0. The value name should be IntelOpenCL32.dll

If the system PATH does not include the folder where the Intel® SDK for OpenCL™ Applications 2014 Beta binaries reside, then the value names on these keys should be the full path to the runtime DLL file.

Installation on Ubuntu* OS

Intel® SDK for OpenCL™ Applications 2014 Beta for Ubuntu* OS installation packaged are delivered in the form of archives containing DEB packages with wrappers for installation/uninstallation procedures. You can use any of the approaches (use wrappers or DEB packages directly).

Installing the Product Using Shell Scripts

  1. Extract the TGZ archive contents:
  2. # tar xzf intel_sdk_for_ocl_applications_2014_beta2_sdk_4.0.*_x64.tgz
    # cd intel_sdk_for_ocl_applications_2014_beta2_sdk_4.0.*_x64
    
  3. Run the following command:
  4. # ./install.sh

Uninstalling from Ubuntu* OS

To uninstall the product using the uninstallation script, do the following:

  1. Go to the folder to which you extracted the TGZ archive content.
  2. Run the following command:
  3. # ./uninstall.sh

Installing OpenCL™ on the Android* Device or Emulator

To install the Intel OpenCL™ runtime on the Android* Emulator using script, do the following:

  1. Go to the android-preinstall subfolder of the Intel® SDK for OpenCL™ Applications installation folder.
  2. Use the OpenCL_Android_Install script to configure the emulator or Android* device or use the following options to start the emulator manually:
    • On Ubuntu OS ./OpenCL_Android_Install –h
      The script requests root password.
    • On Windows OS OpenCL_Android_Install –d <your device/emulator>

Notes:

  • Root permissions are required on Android devices and emulator.
  • Note that on Windows only one device can be running at installation time.

To configure the emulator manually,

  1. Copy the following files from the SDK installation folder to /system/vendor/lib using the Android* Debug Bridge:

    • __ocl_svml_g9.so
    • __ocl_svml_n8.so
    • __ocl_svml_s9.so
    • __ocl_svml_v8.so
    • clbltfng9.rtl
    • clbltfng9_img_cbk.o
    • clbltfng9_img_cbk.rtl
    • clbltfnn8.rtl
    • clbltfnn8_img_cbk.o
    • clbltfnn8_img_cbk.rtl
    • clbltfns9.rtl
    • clbltfns9_img_cbk.o
    • clbltfns9_img_cbk.rtl
    • clbltfnv8.rtl
    • clbltfnv8_img_cbk.o
    • clbltfnv8_img_cbk.rtl
    • libcl_logger.so
    • libclang_compiler.so
    • libcpu_device.so
    • libgnustl_shared.so
    • libintelocl.so
    • libOclCpuBackEnd.so
    • libOclCpuDebugging.so
    • libOpenCL.so.1.2
    • libtask_executor.so
    • libtbb_preview.so
    • libtbbmalloc.so
    • opencl_.pch

    Use the following command to copy the files:

    adb -s <Emulator-Name> push <file1> /system/lib
  2. In the /system/lib folder on the Android* device create two links:
    adb -s <Emulator-Name> shell ‘cd /system/vendor/lib; ln –s libOpenCL.so.1 libOpenCL.so; ln –s libOpenCL.so.1.2 libOpenCL.so.1’
  3. Copy the intel.icd file to /system/vendor/Khronos/OpenCL/vendors folder. Use the following command:
  4. adb -s <Emulator-Name> push intel.icd /system/vendor/Khronos/OpenCL/vendors

    The file content is libintelocl.so

    Note:
    If you close the emulator you must reinstall the OpenCL™ runtime after you run it again.

Limitations and Known Issues

Tools Limitations and Known Issues

  • To work with the Intel® SDK for OpenCL™ Applications 2014 Beta - Offline Compiler plug-in for Microsoft Visual Studio* IDE on 64-bit OS, configure the Visual Studio for 64-bit applications (64-bit compiler and tools).
  • LLVM view for Intel Processor Graphics device in the Offline Compiler plug-in for Visual Studio IDE is not supported on “Compile” and “Link” options. To see the Intel Processor Graphics LLVM code, use the “Build” option.
  • Intel® VTune™ Amplifier XE source-level profiling is not supported with the OpenCL™ 1.2 new feature “separate compiling and linking support”.
  • Intel® SDK for OpenCL™ Applications 2014 Beta supports the Intel VTune Amplifier XE 2011 update 3 or higher.
  • Intel® SDK for OpenCL™ Applications 2014 Beta - Debugger for Visual Studio IDE does not support:
    • Disassembly view
    • Edit and continue capability
    • Multithreaded debugging
    • Two instances of visual studio running simultaneously
  • Syntax highlighting for OpenCL™ in the Eclipse* IDE might not work if spell check is enabled.
  • Adding the Android* Debug Bridge (or setting ALL) in /etc/sudoers is required for using the Remote development on Android devices.
  • To work with the Android* NDK, the path to the SDK installation should not contain spaces.
  • Intel® SDK for OpenCL™ Applications – Kernel Builder and Offline Compiler command-line interface do not support building\compiling kernels for Supplemental Streaming SIMD Extensions 3.
  • Concurrent debug sessions with “API Debugger” are not supported. This includes attaching the VS debugger to more than one process, or opening multiple instances of VS and debugging processes concurrently.

Known Installation and Configuration Issues

  • You may encounter the following error message while installing the software required for the Intel® SDK for OpenCL™ Applications 2014 Beta functionality:
    "Setup has detected that the publisher of file cannot be verified".
    To fix the problem, download and install the latest update for Root Certificates from the Microsoft website (windowsupdate.microsoft.com), then try to install the SDK again.
    To manually update security certificates, as of March 2011 you can install the Microsoft patch residing in the Microsoft website.
  •  Intel® SDK for OpenCL™ Applications 2014 Beta - CPU only runtime package installer adds the target installation folder of the CPU runtime to the end of the system PATH environment variable. If the variable is too long, the application might not be able to load the CPU runtime DLL files. To solve the problem, move the folders to the beginning of the PATH variable or delete unnecessary folders from the PATH.
  • In case of uninstallation though Control panel > Uninstall a program you may face the "Error opening installation log file. Verify that the specified log file location exists and is writable" error. It is known issue in the Microsoft* data base at http://support.microsoft.com/kb/2564571. Use uninstallation icon in the Start menu or reboot the machine to proceed with the uninstallation.
  • In case the PATH environment variable exceeds 260 character length upon installation, you might encounter issues related to System32 directory use.

Intel Processor Graphics Device Limitations

  • For details on known issues with the OpenCL™ standard on the Intel Processor Graphics, refer to the relevant driver release notes.
  • TDRs may be observed when running OpenCL™ benchmarks including Kishonti CLBenchmark, Kishonti CompuBench CL, and SiSoftware Sandra (GP (GPU/CPU/APU) Processing OpenCL™ benchmarks). Also some OpenCL™ workloads may cause TDRs, especially workloads with complex, time-consuming kernels and large local work size or workloads that use profiling feature. Increase the TDR delay to avoid the TDRs. For details, refer to the article at http://msdn.microsoft.com/en-us/library/windows/hardware/gg487368.aspx
  • OpenCL™ usage availability on systems with Intel® Processor Graphics and discrete graphics cards (Windows* OS only):
    • 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.
    • Capabilities of a discrete card only are available if display is connected to:
      • Discrete graphics card display port.
      • Integrated graphics card, and a discrete graphics card has no display ports.
  • The printf function has a limit of 1024 characters per single % conversion.
Para obtener información más completa sobre las optimizaciones del compilador, consulte nuestro Aviso de optimización.