AMD CodeXL Quick Start Guide AMD Developer Tools Team Advanced Micro Devices, Inc. Version 1.6 Revision 1 Table of Contents INTRODUCTION ......................................................................................................................... 3 LATEST VERSION OF THIS DOCUMENT ............................................................................. 3 PREREQUISITES ......................................................................................................................... 3 DOWNLOAD AND INSTALL CODEXL ................................................................................... 4 Validate Installation .......................................................................................................................... 5 Installing the VC++ Redistributable Package ..................................................................................... 6 CODEXL HELP ............................................................................................................................. 7 SYSTEM INFORMATION .......................................................................................................... 8 TEAPOT SAMPLE PROJECT .................................................................................................... 9 Debug the Teapot Sample Application ............................................................................................ 10 Basic Debugging .............................................................................................................................. 11 Source Code View ........................................................................................................................... 12 Breakpoint View ............................................................................................................................. 13 Watch and Locals Views .................................................................................................................. 14 Explorer View .................................................................................................................................. 15 Call Stack View ................................................................................................................................ 17 Function Calls History View ............................................................................................................. 18 Debugged Process Events View ....................................................................................................... 18 Memory View ................................................................................................................................. 18 Statistics View ................................................................................................................................. 18 PROFILE MODE ....................................................................................................................... 19 CPU Profiling ................................................................................................................................... 19 Overview Tab ................................................................................................................................. 20 Modules Tab ................................................................................................................................... 21 Call Graph Tab ................................................................................................................................ 22 Functions Tab ................................................................................................................................. 23 GPU Profiling ................................................................................................................................... 24 Summary Tab ................................................................................................................................. 25 Performance Counters View .......................................................................................................... 26 CodeXL Explorer Tree ..................................................................................................................... 27 Power Profiling ............................................................................................................................... 28 Switching to Power Profiling mode ................................................................................................ 28 Starting a new Power Profiling session .......................................................................................... 28 Setting the Sampling Interval ......................................................................................................... 29 Stopping a Power Profiling session ................................................................................................ 29 Power Profiling Real-Time Values .................................................................................................. 29 Power Profiling Timeline View ....................................................................................................... 30 Power Profiling Summary View ...................................................................................................... 31 Configuring Power Profiler Sessions .............................................................................................. 32 Static Kernel Analysis ...................................................................................................................... 32 Switching to Analysis mode ............................................................................................................ 32 Creating a new project for Kernel Analysis .................................................................................... 33 Adding OpenCL files to an existing project .................................................................................... 34 Analyze Mode Options ................................................................................................................... 35 Getting Started with CodeXL Build Options- Defining kernel compilation options ...................................................................... 37 Building and Analyzing an OpenCL File .......................................................................................... 39 Output Tab ..................................................................................................................................... 39 Overview Tab ................................................................................................................................. 40 Statistics Tab .................................................................................................................................. 40 The Analysis Tab ............................................................................................................................. 41 Viewing compilation output: IL and ISA ......................................................................................... 42 KNOWN ISSUES ....................................................................................................................... 43 SUPPORT ................................................................................................................................... 43 2 © 2014 Advanced Micro Devices, Inc. Getting Started with CodeXL Introduction AMD CodeXL™ is a tool suite with a unified user interface that lets you harness the benefits of AMD CPUs, GPUs, and APUs. It has powerful capabilities for APU/GPU debugging, CPU and GPU profiling, and static OpenCL™ kernel analysis. These features let you find bugs, optimize application performance, and easily access heterogeneous computing. AMD CodeXL is available as a stand-alone application for Windows ® and Linux ®, as well as a Microsoft ® Visual Studio ® extension for Windows. Getting the most out of the AMD CodeXL tool suite requires a relatively recent AMD APU, a recent version of Catalyst, and the OpenCL APP SDK. This document describes how to • get started using CodeXL • find information about known CodeXL issues • contact AMD for support Latest Version of This Document • For the latest and greatest version of the documentation, go to the CodeXL Website. Prerequisites Operating Systems • Microsoft Windows 7 64-bit • Microsoft Windows 8.1 64-bit • Linux 64-bit (Red Hat, Ubuntu) For detailed system requirements see the CodeXL Release Notes in the CodeXL installation folder or on the Documentation section of the CodeXL web page . CodeXL Visual Studio Extension • [Optional] Microsoft Visual Studio 2010 (Standard/Professional/Team System Edition) • [Optional] Microsoft Visual Studio 2012 (Professional/Premium/Ultimate Edition) • [Optional] Microsoft Visual Studio 2013 (Professional/Premium/Ultimate Edition) Profiling OpenCL™ Applications • [GPU device] AMD Catalyst driver with OpenCL™ GPU support • [GPU device] AMD Radeon™ HD 5000 series or newer 3 © 2014 Advanced Micro Devices, Inc. Getting Started with CodeXL • AMD APP SDK ( requirements ) For detailed system requirements see the CodeXL Release Notes in the CodeXL installation folder or on the Documentation section of the CodeXL web page . Download and Install CodeXL Installation is system-specific (Windows or Linux); but once installed and started, the CodeXL operation is system-independent. Download the AMD CodeXL