Getting Started

ATI Stream SDK v2.2

1 Overview
For Microsoft® Windows® platforms, the ATI Stream SDK installer installs the following packages
on your system by default (unless you choose to customize the install):

1. ATI Stream SDK Developer package. This includes:

– the OpenCL™ compiler and runtime,
– ATI CAL header files and compile-time libraries (the dynamic libraries for CAL are now
part of the ATI display driver; not included in this package), and
– developer documentation.
2. ATI Stream SDK Samples package. This includes:
– sample applications,
– sample documentation.
3. ATI Stream Profiler package.
4. Stream KernelAnalyzer package.

For Linux® platforms, the ATI Stream SDK consists of one package. To ensure proper installation,
be sure to follow the instructions provided in the ATI Stream SDK Installation Notes.

The ATI Stream SDK Developer installation includes the following folders:

• bin - This includes tools for compiling OpenCL applications, as well as the OpenCL dynamic
library for running them.
• lib - This contains the base OpenCL runtime library to which the applications link on
Windows systems, as well as import libraries to author CAL applications.
• include - This contains the header files for the OpenCL and CAL runtimes.
• docs - This contains developer documentation for the ATI Stream SDK. Additional developer
documentation is available online at:
http://developer.amd.com/gpu/ATIStreamSDK/pages/Documentation.aspx

The ATI Stream SDK Developer installation for Windows adds the variable ATISTREAMSDKROOT to
your environment. This points to the location where you have installed the SDK development
package. The Windows installer also adds the locations of the OpenCL dynamic libraries to your
system PATH variable, so applications know where to find it. For Linux, you must set up the paths
and environment manually. This is explained in Section 2.2, “On Linux.”

The ATI Stream SDK Samples installation includes the following folders:

• bin - This includes pre-built binaries and dynamic libraries for running ATI Stream samples.

ATI Stream SDK v2.2 1 of 6

 • lib - This contains ATI Stream SDK utility libraries to which sample applications link.
• include - This contains the header files for utilities and tools used by the samples.
• samples - This contains OpenCL and CAL sample applications.
• make - This is only on Linux. It contains the definitions and rules for make.

The ATI Stream SDK Samples installer for Windows adds the variable
ATISTREAMSDKSAMPLESROOT to your environment. This points to the location where you have
installed the SDK Samples package.

The ATI Stream SDK Samples installation includes the following folders:

• tools - This contains the ATI Stream Profile and ancillary programs.

2 How to Build a Sample

Ensure that the ATI Stream SDK Samples package has been installed before proceeding.

2.1 On Windows

2.1.1 OpenCL

The samples installation contains a Microsoft Visual Studio 2008 solution file, called
OpenCLSamples.sln, located at $(ATISTREAMSDKSAMPLESROOT)\samples\opencl\. This solution
file contains the entire sample project. To build a sample:

1. Open the OpenCLSamples.sln file with Microsoft Visual Studio 2008 Professional Edition.
2. Select Build > Build Solution to build all solutions.
3. Select the individual project file in the Solutions Explorer.
4. Right-click on the project file, and select Build to build a particular sample.

2.1.2 CAL

The samples installation contains a Microsoft Visual Studio 2008 solution file, called
samples.sln, located at $(ATISTREAMSDKSAMPLESROOT)\samples\cal\. This solution file
contains the entire sample project. To build a sample:

1. Open the samples.sln file with Microsoft Visual Studio 2008 Professional Edition.
2. Select Build > Build Solution to build all solutions.
3. Select the individual project file in the Solutions Explorer.
4. Right-click on the project file, and select Build to build a particular sample.

2 of 6 ATI Stream SDK v2.2

2.2 On Linux

2.2.1 OpenCL

This samples installation contains makefiles to build samples. To build a sample:

1. Ensure the library path is set to find libOpenCL.so. If it is not set, follow the instructions in
the ATI Stream SDK Installation Notes, section 2.2, step 4.
2. Go to the samples directory if you want to build all the samples, or go to a particular sample
directory, and type make. If no options are specified, make builds for the native platform in
debug configuration. To select release configuration, add the option release = 1. To force
a 32-bit build on a 64-bit platform, add the option bitness=32
3. Executables are generated in the bin directory at the samples installation root, as well as
inside the bin directory of the samples (ATISTREAMSDKSAMPLESROOT/samples/opencl/bin).

2.2.2 CAL

This samples installation contains makefiles to build samples. To build a sample:

1. Ensure the library path is set to find libaticalrt.so and libaticalcl.so (these are
shipped as part of the display driver). If it is not set, use export (in bash shells) to set it.
2. Go to the samples directory if you want to build all the samples, or go to a particular sample
directory, and type make.
3. Executables are generated in the bin directory of the samples
(ATISTREAMSDKSAMPLESROOT/samples/cal/bin).

3 How to Run the Application

This section describes how to run the application that was just built.

3.1 On Windows

3.1.1 OpenCL

There are two ways to run the application: by using Microsoft Visual Studio 2008 Professional
Edition, or by using the command line.

Using Visual Studio

1. Open the solution file OpenCLSamples.sln, and build it.

2. Select the desired project file in the Solutions Explorer.
3. Right-click on it, and select Set as StartUp Project. To run the application, press Ctrl+F5. To
run the application in debug mode, simply press F5.

Using the Command Line

1. Open a command prompt.

2. Go to the $(ATISTREAMSDKSAMPLESROOT)/samples/opencl/bin.
3. Go into the appropriate architecture directory (x86 or x86_64).

ATI Stream SDK v2.2 3 of 6

 4. Run the samples by typing the name of their executables. See the individual sample
documents for their respective command line arguments.

3.1.2 CAL

There are two ways to run the application: by using Microsoft Visual Studio 2008 Professional
Edition, or by using the command line.

Using Visual Studio

1. Open the solution file samples.sln, and build it.

2. Select the desired project file in the Solutions Explorer.
3. Right-click on it, and select Set as StartUp Project. To run the application, press Ctrl+F5. To
run the application in debug mode, simply press F5.

Using the Command Line

1. Open a command prompt.

2. Go to the $(ATISTREAMSDKSAMPLESROOT)/samples/cal/bin.
3. Run the samples by typing the name of their executables. See the individual sample
documents for their respective command line arguments.

3.2 On Linux

3.2.1 OpenCL
1. Ensure the path is set to include the location of libOpenCL.so.
2. Open a terminal window.
3. Go to the $(ATISTREAMSDKSAMPLESROOT)/samples/opencl/bin/ directory.
4. Go into the appropriate architecture directory (x86 or x86_64).
5. Run the samples by typing the name of their executables. You may have to prepend the
executable name with ./ . See the individual sample documents for their respective
command line arguments.

3.2.2 CAL
1. Ensure the path is set to include the location of libaticalrt.so and libaticalcl.so (these
are shipped as part of the display driver).
2. Open a terminal window.
3. Go to the $(ATISTREAMSDKSAMPLESROOT)/samples/cal/bin/ directory.
4. Go into the appropriate architecture directory (x86 or x86_64).
5. Run the samples by typing the name of their executables. You may have to prepend the
executable name with ./ . See the individual sample documents for their respective
command line arguments.

4 of 6 ATI Stream SDK v2.2

3.3 Sample Code

3.3.1 OpenCL

The simplest OpenCL sample in the SDK is the Template sample. It is for developers that are
new to OpenCL programming. See the Template sample documentation (in
$(ATISTREAMSDKSAMPLESROOT)/samples/opencl/cl/app/Template/docs), which explains the
workflow for setting up a basic ATI Stream application using OpenCL. The Template sample is
included for instructional purposes.

There are two kinds of OpenCL samples in the ATI Stream SDK. One is written using native
OpenCL calls (in $(ATISTREAMSDKSAMPLESROOT)/samples/opencl/cl); the other is written using
the AMD C++ bindings to OpenCL (in $(ATISTREAMSDKSAMPLESROOT)/samples/opencl/cpp_cl).

Most of the OpenCL samples make use of a utility library called the ATI Stream SDK Utility
Library (SDKUtil). This library provides commonly used routines, such as parsing command line
options, loading and writing bitmap images, printing formatted output, comparing results, and
reading files. This is an object-oriented library that is structured as a set of classes. The SDKUtil
cpp files are available in the $(ATISTREAMSDKSAMPLESROOT)\samples\opencl\SDKUtil folder.
The headers are available in the $(ATISTREAMSDKSAMPLESROOT)\include\SDKUtil folder.

3.3.2 CAL

To learn more about the CAL samples, see the HelloCAL and Tutorial samples.

4 Supported Devices
The following table shows the devices supported by the current version of the ATI Stream SDK,
as well as the computing features they support.

Double- Global Compute Kernel

Product Line Card Precision Buffer (Shader)
ATI Radeon™ HD 5970 Yes Yes Yes
5870 Yes Yes Yes
5850 Yes Yes Yes
5830 Yes Yes Yes
5770 No Yes Yes
5750 No Yes Yes
5670 Yes Yes Yes
5570 Yes Yes Yes
5470 Yes Yes Yes
4890 * Yes Yes Yes
4870 X2 * Yes Yes Yes
4870 * Yes Yes Yes
4850 X2 * Yes Yes Yes
4850 * Yes Yes Yes
4830 * Yes Yes Yes
4770 * Yes Yes Yes
4670 * No Yes Yes
4650 * No Yes Yes
4550 * No Yes Yes
4350 * No Yes Yes

ATI Stream SDK v2.2 5 of 6

 Double- Global Compute Kernel
Product Line Card Precision Buffer (Shader)
ATI FirePro™ V8800 Yes Yes Yes
V8750 * Yes Yes Yes
V8700 * Yes Yes Yes
V7800 Yes Yes Yes
V7750 * No Yes Yes
V5800 Yes Yes Yes
V5700 * No Yes Yes
V4800 Yes Yes Yes
V3800 Yes Yes Yes
V3750 * No Yes Yes
AMD FireStream™ 9270 * Yes Yes Yes
9250 * Yes Yes Yes
ATI Mobility Radeon™ HD 5870 Yes Yes Yes
5850 Yes Yes Yes
5830 Yes Yes Yes
5770 Yes Yes Yes
5750 Yes Yes Yes
5730 Yes Yes Yes
5650 Yes Yes Yes
5470 Yes Yes Yes
5450 Yes Yes Yes
5430 Yes Yes Yes
4870 * Yes Yes Yes
4860 * Yes Yes Yes
4850X2 * Yes Yes Yes
4850 * Yes Yes Yes
4830 * Yes Yes Yes
4670 * No Yes Yes
4650 * No Yes Yes
4500 Series * No Yes Yes
4300 Series * No Yes Yes
ATI Mobility FirePro™ M7820 Yes Yes Yes
M7740 * No Yes Yes
M5800 Yes Yes Yes
ATI Radeon™ Embedded E4690 Discrete No Yes Yes
GPU *

* = beta only.

We are constantly qualifying additional devices. For an up-to-date list of supported devices,
please visit: http://developer.amd.com/stream

Contact Advanced Micro Devices, Inc. For Stream Computing:

One AMD Place URL: www.amd.com/stream
P.O. Box 3453 Questions: [email protected]
Sunnyvale, CA, 94088-3453 Developing: ATI_Stream_SDK_Help_Request
Phone: +1.408.749.4000 Forum: www.amd.com/streamdevforum

The contents of this document are provided in connection with Advanced AMD’s products are not designed, intended, authorized or warranted for use as
Micro Devices, Inc. (“AMD”) products. AMD makes no representations or components in systems intended for surgical implant into the body, or in other
warranties with respect to the accuracy or completeness of the contents of applications intended to support or sustain life, or in any other application in
this publication and reserves the right to make changes to specifications and which the failure of AMD’s product could create a situation where personal injury,
product descriptions at any time without notice. The information contained death, or severe property or environmental damage may occur. AMD reserves
herein may be of a preliminary or advance nature and is subject to change the right to discontinue or make changes to its products at any time without
without notice. No license, whether express, implied, arising by estoppel or notice.
otherwise, to any intellectual property rights is granted by this publication. Copyright and Trademarks
Except as set forth in AMD’s Standard Terms and Conditions of Sale, AMD © 2010 Advanced Micro Devices, Inc. All rights reserved. AMD, the AMD Arrow
assumes no liability whatsoever, and disclaims any express or implied war- logo, ATI, the ATI logo, Radeon, FireStream, and combinations thereof are trade-
ranty, relating to its products including, but not limited to, the implied war- marks of Advanced Micro Devices, Inc. OpenCL and the OpenCL logo are trade-
ranty of merchantability, fitness for a particular purpose, or infringement of marks of Apple Inc. used by permission by Khronos.Other names are for infor-
any intellectual property right. mational purposes only and may be trademarks of their respective owners.

6 of 6 ATI Stream SDK v2.2