1. Manuals
  2. Brands
  3. ARM Manuals
  4. Computer Hardware
  5. DSTREAM DS-5
  6. Manual

ARM DS-5 Manual

Hide thumbs Also See for DS-5:
Table of Contents

Advertisement

Quick Links

Download this manual
ARM
DS-5
®
Version 5.13
Using ARM Streamline
Copyright © 2010-2012 ARM. All rights reserved.
ARM DUI 0482K (ID120712)

Advertisement

Table of Contents
loading

Related Manuals for ARM DS-5

Summary of Contents for ARM DS-5

  • Page 1 DS-5 ® Version 5.13 Using ARM Streamline Copyright © 2010-2012 ARM. All rights reserved. ARM DUI 0482K (ID120712)
  • Page 2 This document is intended only to assist the reader in the use of the product. ARM shall not be liable for any loss or damage arising from the use of any information in this document, or any error or omission in such information, or any incorrect use of the product.

  • Page 3: Table Of Contents

    ARM DS-5 Using ARM Streamline Chapter 1 Conventions and Feedback Chapter 2 Setting Up Your Target Setting up an ARM Linux target ................2-2 Setting up an Android target ..................2-6 Recommended compiler options ................2-10 Mali setup for Streamline ..................2-11 Chapter 3 Using the Streamline Data View The Streamline Data view ..................
  • Page 4 Opening a Streamline-enabled command prompt or shell ........13-2 13.2 The streamline command ..................13-3 Chapter 14 Troubleshooting 14.1 Target connection issues ..................14-2 14.2 Report issues ......................14-3 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 5: Conventions And Feedback

    Highlights important notes, introduces special terminology, denotes internal cross-references, and citations. bold Highlights interface elements, such as menu names. Also used for emphasis in descriptive lists, where appropriate, and for ARM ® processor signal names. Feedback on this product If you have any comments and suggestions about this product, contact your supplier and give: •...
  • Page 6 ARM also welcomes general suggestions for additions and improvements. ARM periodically provides updates and corrections to its documentation on the ARM Information Center, together with knowledge articles and Frequently Asked Questions (FAQs). Other information •...

  • Page 7: Setting Up Your Target

    Setting Up Your Target ARM Streamline Performance Analyzer is a system-wide visualizer and profiler for targets running ARM Linux or Android native applications and libraries. Combining an ARM Linux kernel driver, target daemon, and a graphical user interface, it transforms system trace and sampling data into reports that present the data in both visual and statistical forms.

  • Page 8: Setting Up An Arm Linux Target

    Setting Up Your Target Setting up an ARM Linux target These instructions are specific to targets running ARM Linux. Note You can locate all of the files provided by DS-5 by selecting Help → ARM Extras... from the main menu. 2.1.1 Prerequisites You must have the following tools on your host to build the Linux kernel and the gator driver: •...
  • Page 9 • Enter the following command in your shell to export the cross compiler: export CROSS_COMPILE=${CROSS_TOOLS}/bin/arm-linux-gnueabihf- • To specify that this build is for an ARM architecture, enter the following command in your shell: export ARCH=arm • Enter the following to build the configuration file specific to your platform:...
  • Page 10 /proc/config.gz | grep CONFIG_PROFILING 2.1.4 Build the gator module To use Streamline with your ARM target, you may build the gator driver on a Linux host or build it locally on your target. DS-5 provides a source archive. Assuming that you have unzipped the file gator-driver.tar.gz...
  • Page 11 Note requires the library. This file is usually supplied with the Linux gatord libstdc++.so.6 distribution on your target. A copy of is available in the DS-5 Linux example libstdc++.so.6 distribution. 2.1.6 See also Tasks • Setting up an Android target on page 2-6.

  • Page 12: Setting Up An Android Target

    Setting up an Android target These instructions are specific to targets running Android. Note You can locate all of the files provided by DS-5 by selecting Help → ARM Extras... from the main menu. 2.2.1 Prepare and build your kernel You must enable certain kernel configuration options to run Streamline.
  • Page 13 -C kernel_build_dir M=`pwd` ARCH=arm CROSS_COMPILE=<...> modules Note To enable kernel stack unwinding you must remove the comment hashtag from the following line in the makefile of the gator module: ARM DUI 0482K Copyright ©...
  • Page 14 Streamline collects during the capture session. Include the directory location and the file name. Lists all of the available command line options. gatord ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 15 2.2.6 Set capture options to support your Android target In the Capture Options dialog box, opened in the Streamline Data view in Eclipse for DS-5 and enter the ethernet address. If you use the ADB to forward the port, enter...

  • Page 16: Recommended Compiler Options

    2.3.1 See also Tasks • Setting up an Android target on page 2-6. Reference • Target connection issues on page 14-2 • Capture options on page 4-3. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 2-10 ID120712 Non-Confidential...

  • Page 17: Mali Setup For Streamline

    2.4.3 See also Tasks • Opening the Capture Options dialog box on page 4-2 • Setting up an ARM Linux target on page 2-2. Reference • Target connection issues on page 14-2 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved.
  • Page 18 Capture options on page 4-3 • The Streamline Data view on page 3-2 • Charts specific to Mali targets on page 6-11 • Mali-specific events on page 5-5 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 2-12 ID120712 Non-Confidential...

  • Page 19: Using The Streamline Data View

    Streamline Analysis Reports from stored capture sessions. The following topic describes how to open and use the Streamline Data view: • The Streamline Data view on page 3-2 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 20: The Streamline Data View

    Using the Streamline Data View The Streamline Data view Much of the functionality of ARM Streamline requires the Streamline Data view. To open the Streamline Data view: Select Window → Show View → Other... Expand the ARM Streamline group. Select Streamline Data.
  • Page 21 Streamline adds the parent directory of the capture to the Analysis Data Locations list if it is not already there. When the capture stops, Streamline generates an analysis report based on the settings in the Capture Options dialog box. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 22 Streamline Data view. Cancel Discards any current changes to the list of locations and exits the dialog box. Reset Returns the defined folders to the default list. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 23 Tasks • Opening the Counter Configuration dialog box on page 5-2. Reference • Capture options on page 4-3. • Using the Counters Configuration dialog box on page 5-4 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 24 The following topics describe how to open the Capture Options dialog box and describe each of the settings it contains: • Opening the Capture Options dialog box on page 4-2 • Capture options on page 4-3 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 25: Chapter 4 Setting Capture Options

    Click Change capture options, located in the upper right of the Streamline Data view. Figure 4-2 The Change capture options button 4.1.1 See also Reference • Capture options on page 4-3 • The Streamline Data view on page 3-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 26: Capture Options

    For example, enter to use port 1010 to connect to the target. Your_IP_address:1010 Note If you use the port forwarding of ADB with USB, enter in the Address localhost field. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 27 This menu has three options. Select No Energy Data Collection to turn Energy Capture off. When you enable this option, all other Energy Capture options are disabled. Select ARM Energy Probe or National Instruments DAQ to match your energy capture hardware.
  • Page 28 Use this field to define the path to the executable, necessary to use the caiman.exe ARM Energy Probe to gather power output statistics. The button to the right of this field enables you to search your file system: Figure 4-4 The Tool Path dialog box...
  • Page 29 The following buttons are included in the Program Images section of the Capture Options dialog box: 4.2.5 See also Tasks • Opening the Capture Options dialog box on page 4-2 Reference • The Streamline Data view on page 3-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 30 The following topics describe how to open the Counter Configuration dialog box and describe each of the settings it contains: • Opening the Counter Configuration dialog box on page 5-2 • Using the Counters Configuration dialog box on page 5-4 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 31: Chapter 5 Configuring Counters

    Configuring Counters Opening the Counter Configuration dialog box ARM Streamline uses a default best-fit of hardware performance counters to aid in the analysis of your applications, but you can modify them using the Counter Configuration dialog box, accessed through the Streamline Data view.
  • Page 32 Configuring Counters 5.1.1 See also Reference • Using the Counters Configuration dialog box on page 5-4 • The Streamline Data view on page 3-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 33: Using The Counters Configuration Dialog Box

    Adding new events To add events to the Events to Collect list, select and drag them from the list of available events and drop them in Events to Collect. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 34 • L2 counters report continuously because the cache is shared by the vertex and fragment processors and cannot easily be attributed to a single operation. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 35 Threshold field is 1000 samples per second, so if the peak for that event is 2000000, a good value to insert in the Threshold field is 2000. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 36 Exits the Counters Configuration dialog box without saving the defined settings. 5.2.7 See also Tasks • Opening the Counter Configuration dialog box on page 5-2 Reference • The Streamline Data view on page 3-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 37 Filtering data and other Timeline view controls on page 6-19 • Timeline view toolbar options, contextual menu options, and keyboard shortcuts on page 6-22 • Visual Annotation in the Timeline view on page 6-25 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 38: About The Timeline View

    The Timeline View About the Timeline view The Timeline view is the first view that you see when ARM Streamline opens a report. It provides you with high level information about the performance of your target during the capture session.
  • Page 39 GPU Vertex and Fragment bar charts display only activity initiated by the selected processes. This allows you to differentiate between GPU activity caused by your application and activity resulting from other applications or system services. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 40 Each color in the Processes section represents a cluster of cluster of cores. Click the X-Ray button again and the Processes section breaks thing down by core. Figure 6-6 X-Ray mode by cluster The colors in X-Ray mode are: Blue First core ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 41 Timeline view. To do so: Double click in the timeline rule. Give the new bookmark a title by entering it into the resulting field. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 42 6.1.7 The Quick Access Tooltip Hover over any of the charts in the Timeline view and gray line appears, with values and key colors specific to that chart. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 43 If you find Streamline to be slow and unresponsive, change the graphics quality by following these steps: Select Window → Preferences. Use the disclosure control to open DS-5. Select Streamline from the list under DS-5. Uncheck the Use highest quality graphics checkbox.
  • Page 44 The Energy Offset menu is located in the bottom left hand corner of the Timeline view, next to the Snippets menu. Use it offset power, current, and voltage charts in Captures that include energy data captured using the ARM Energy Probe, so that energy data lines up correctly with the other data in the Timeline view.
  • Page 45 Filtering data and other Timeline view controls on page 6-19 • Timeline view toolbar options, contextual menu options, and keyboard shortcuts on page 6-22. • Using the Counters Configuration dialog box on page 5-4 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 46: Timeline View Charts

    CPU Wait-Contention chart handle to change the coloring of the processes and show levels of contention. For more information on how to set up your Linux kernel to provide CPU wait data, see Setting up an ARM Linux target on page 2-2. CPU Wait - I/O Measures how often waiting on I/O caused a task to stop running.
  • Page 47 Customize reports using Annotate on page 10-2 • Creating custom performance counters on page 11-4. Reference • Filtering data and other Timeline view controls on page 6-19 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-11 ID120712 Non-Confidential...
  • Page 48 The Timeline View • Timeline view toolbar options, contextual menu options, and keyboard shortcuts on page 6-22. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-12 ID120712 Non-Confidential...

  • Page 49: Customizing Charts

    A is three and first value of series B is five, the first data point in the stack chart that contains these series is eight. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-13 ID120712...
  • Page 50 Percentage In a percentage style chart, values are plotted as percentages between 0 and 100 percent. The maximum value in the chart represents 100% in a percentage chart and all other values are compared to that number to calculate a percentage. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-14 ID120712 Non-Confidential...
  • Page 51 Enter a description for the series in this field. When you hover over the series title or color in the Timeline view, a tooltip appears, containing the description defined here. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-15 ID120712 Non-Confidential...
  • Page 52 Save as Snippet button in the Chart Configuration panel are all categorized in the menu, so that you can easily find them and add them to the Timeline view. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-16 ID120712...
  • Page 53 Timeline view uses in every new report. Drag and drop any snippet from the left side of the Snippets menu to the Default Snippets side to create a new default. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-17 ID120712 Non-Confidential...
  • Page 54 This option only works if the category has no subordinate snippets. If the category is empty and you select this contextual menu option, a dialog box appears, asking you to confirm the action. Click OK to delete the category. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-18 ID120712 Non-Confidential...

  • Page 55: Filtering Data And Other Timeline View Controls

    Only data relevant to this interval appears in the other views, so the Code Paths, Functions, Code, Call Graph and Stack views update when you move the calipers. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-19 ID120712...
  • Page 56 To move the Cross Section Marker, click anywhere in charts or processes. The Cross Section Marker appears where you clicked and provides data specific to the bin where you placed it. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-20 ID120712 Non-Confidential...
  • Page 57 Creating custom performance counters on page 11-4 Reference • About the Timeline view on page 6-2 • Timeline view toolbar options, contextual menu options, and keyboard shortcuts on page 6-22 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-21 ID120712 Non-Confidential...

  • Page 58: Timeline View Toolbar Options, Contextual Menu Options, And Keyboard Shortcuts

    The Timeline View Timeline view toolbar options, contextual menu options, and keyboard shortcuts ARM Streamline provides easy ways to navigate and modify the Timeline view using the toolbar and a variety of contextual menu options and keyboard shortcuts. 6.5.1 Toolbar options...
  • Page 59 Marker back after parking it, click anywhere in the charts or processes or drag the Cross Section Marker from its parked position in the far left of the divider. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-23 ID120712...
  • Page 60 Removes the bookmark from the Timeline view. 6.5.3 Keyboard shortcuts While you can navigate every report in ARM Streamline using the mouse, you can also use keyboard shortcuts. The keyboard shortcuts available for the Timeline view are: Left arrow Moves the Cross Section Marker one bin to the left.

  • Page 61: Visual Annotation In The Timeline View

    Press SPACE while hovering over an image to see a full size version of that image. • Blue markers above and below images mark images annotated with text. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-25 ID120712 Non-Confidential...
  • Page 62 The Timeline View Figure 6-35 Text with visual annotation Hover over a blue marker and the text associated with that image appears above the upper marker. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 6-26 ID120712 Non-Confidential...
  • Page 63 Call Paths view column headers on page 7-6 • Functions view column headers on page 7-7. • Stack view column headers and the Maximum Stack Depth by Thread chart on page 7-8 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 64: Chapter 7 The Table Views: Call Paths, Functions, And Stack

    Opens the Call Graph view. Any function in the current selection is selected in the Call Graph view. Select in Stack Opens the Stack view. All functions related to the selection in the current report are selected in the Stack view. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 65 7.1.3 Keyboard shortcuts While you can navigate every report in ARM Streamline using the mouse, you can also use keyboard shortcuts. The keyboard shortcuts available for the table views are: Up arrow Moves the current selection up one row.
  • Page 66 Call Paths view column headers on page 7-6 • Functions view column headers on page 7-7 • Stack view column headers and the Maximum Stack Depth by Thread chart on page 7-8. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 67: Sorting Data In The Table Reports

    Call Paths view column headers on page 7-6 • Functions view column headers on page 7-7 • Stack view column headers and the Maximum Stack Depth by Thread chart on page 7-8. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 68 Sorting data in the table reports on page 7-5 • Functions view column headers on page 7-7 • Stack view column headers and the Maximum Stack Depth by Thread chart on page 7-8. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 69: Functions View Column Headers

    Sorting data in the table reports on page 7-5 • Call Paths view column headers on page 7-6 • Stack view column headers and the Maximum Stack Depth by Thread chart on page 7-8. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 70: Stack View Column Headers And The Maximum Stack Depth By Thread Chart

    Table views toolbar options, contextual menu options and keyboard shortcuts on page 7-2 • Sorting data in the table reports on page 7-5 • Call Paths view column headers on page 7-6 • Functions view column headers on page 7-7. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 71: The Code View

    Chapter 8 The Code View Of all of the views available in ARM Streamline, the Code view provides the highest level of detail. It breaks statistics down by individual line of code and disassembly instruction. The following topics describe the use of the Code view: •...

  • Page 72: Code View Basics

    Hold down the control key if you want to select additional rows without selecting all of the rows in between. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 73 8.1.2 Locating missing source files ARM Streamline automatically locates and displays the source code in the source view. If, however, the source files are not located in the same directory location they were in during compilation, the source view is not populated.
  • Page 74 Filtering data and other Timeline view controls on page 6-19 • Code view toolbar options and keyboard shortcuts on page 8-5 • The Streamline Data view on page 3-2 • Capture options on page 4-3. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 75: Code View Toolbar Options And Keyboard Shortcuts

    8.2.2 Keyboard shortcuts While you can navigate every report in ARM Streamline using the mouse, you can also use keyboard shortcuts. The keyboard shortcuts available for the table views are: Up arrow Moves the current selection up one row.
  • Page 76 The Code View Reference • Code view basics on page 8-2 • The Streamline Data view on page 3-2. • Capture options on page 4-3. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 77 The following topics describe the Call Graph view and how to use it: • Call Graph view basics on page 9-2 • Contextual menu options on page 9-5 • Call Graph toolbar and keyboard shortcuts on page 9-6 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 78: Chapter 9 The Call Graph View

    The number contained in the bullet represents how many calling or called functions the bullet represents. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 79 Left-clicking on any function in the hierarchy selects it. In addition to coloring the rectangle dark blue, it changes the color of all of the arrows from gray to black, clearly showing you to what functions the selection function is connected. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 80 Selecting a function also changes any connected caller or callee bullets from gray to black. 9.1.6 See also Reference • Call Graph toolbar and keyboard shortcuts on page 9-6 • Contextual menu options on page 9-5. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 81: Contextual Menu Options

    Edit Source Opens the file that contains the selected function in your default code editor. 9.2.1 See also Reference • Call Graph view basics on page 9-2 • Call Graph toolbar and keyboard shortcuts on page 9-6. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...

  • Page 82: Call Graph Toolbar And Keyboard Shortcuts

    Right arrow Moves the current selection to the right. If no function is to the immediate right of the current function box, ARM Streamline chooses the closest available function in the row to the right of the currently selected function.
  • Page 83 The Call Graph View 9.3.1 See also Reference • Call Graph view basics on page 9-2 • Contextual menu options on page 9-5. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. ID120712 Non-Confidential...
  • Page 84 The following topics describe the Log view and how to use the Annotate feature: • Customize reports using Annotate on page 10-2 • Adding images to reports using Visual Annotate on page 10-7 • The Log view on page 10-9 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-1 ID120712 Non-Confidential...

  • Page 85: Chapter 10 Annotate And The Log View

    10.1 Customize reports using Annotate While ARM Streamline provides a large variety of target information, sometimes you require extra context to decipher exactly what the target is doing at certain instances. Streamline Annotate provides a facility for you to add this context to Streamline.
  • Page 86 Use this command to give an annotation group a title. Pass a group identifier to variable and a name for the group to the variable. group string ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-3 ID120712 Non-Confidential...
  • Page 87 Annotate and the Log View Note You can locate all of the files provided by DS-5 by selecting Help → ARM Extras... from the main menu. See the located here for a better understanding of how to call streamline_annotate.h each annotate macro.

  • Page 88: Adding Bookmarks Using Annotate

    You must include this header file in your source code to use them. Note You can locate all of the files provided by DS-5 by selecting Help → ARM Extras... from the main menu. Use the following functions to add bookmarks: ANNOTATE_MARKER() Use this function to add a a red bookmark to the Timeline view without a title.
  • Page 89 Annotate and the Log View Reference • About the Timeline view on page 6-2 • Filtering data and other Timeline view controls on page 6-19. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-6 ID120712 Non-Confidential...

  • Page 90: Adding Images To Reports Using Visual Annotate

    ANNOTATE_VISUAL Note You can locate all of the files provided by DS-5 by selecting Help → ARM Extras... from the main menu. To use visual annotation, you must: Include the header file located in in your streamline_annotate.h...
  • Page 91 Customize reports using Annotate on page 10-2 • Capturing data on your target on page 11-2 • Creating custom performance counters on page 11-4. Reference • About the Timeline view on page 6-2 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-8 ID120712 Non-Confidential...

  • Page 92: The Log View

    Search based on the location that triggered the annotate message. To narrow down messages to those called by a particular function, enter that function name in the Where field. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-9 ID120712 Non-Confidential...
  • Page 93 Ctrl and clicking on a second. The value in the Totals Panel Delta field updates to show you the time difference between the two selected messages. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-10 ID120712 Non-Confidential...
  • Page 94 Creating custom performance counters on page 11-4. Reference • About the Timeline view on page 6-2 • Filtering data and other Timeline view controls on page 6-19. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 10-11 ID120712 Non-Confidential...

  • Page 95: Advanced Customizations

    Chapter 11 Advanced Customizations ARM Streamline enables you to perform tasks such as creating a report and examining the data available in the report. It enables you to perform these tasks without going to the command line or modifying XML files. However, if you want to customize the data that ARM Streamline collects and change how it is presented to you, or you want to capture data and store it on your target, advanced customizations are required.

  • Page 96: Capturing Data On Your Target

    11.1 Capturing data on your target Typically, ARM Streamline uses an active network connection to send captured data from the target to the host. If this is not possible because of limitations with your target, you can save the data to local target storage for manual transfer to your host.
  • Page 97 Creating custom performance counters on page 11-4 • Using Stored Streamline Capture Data to create new Streamline Analysis Reports on page 11-9. Reference • Capture options on page 4-3. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-3 ID120712 Non-Confidential...

  • Page 98: Creating Custom Performance Counters

    This file was provided as an example of how to add custom counters. Note You can locate all of the files provided by DS-5 by selecting Help → ARM Extras... from the main menu. To familiarize yourself with the process of adding your own counters, incorporate the simulated...
  • Page 99 The makefile pulls in any file that begins with so create a xml file called events- . Re-build after you create this new xml file. events-YourCustom.xml gatord ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-5 ID120712 Non-Confidential...
  • Page 100 Every event element must have either the counter or event attribute defined. Use the counter attribute for fixed counter types, like cycle count. Use the event attribute for all other events. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-6 ID120712 Non-Confidential...
  • Page 101 #if defined(Your_Architecture) gator_events_l2c310_probe(L2C_310_Address); #endif Note Replace with the name of your architecture and with Your_Architecture L2C_310_Address the physical address of your L2C-310 in hexadecimal. Rebuild the gator driver. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-7 ID120712 Non-Confidential...
  • Page 102 Tasks • Capturing data on your target on page 11-2 • Customize reports using Annotate on page 10-2. Reference • About the Timeline view on page 6-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-8 ID120712 Non-Confidential...

  • Page 103: Using Stored Streamline Capture Data To Create New Streamline Analysis Reports

    Customize reports using Annotate on page 10-2 • Creating custom performance counters on page 11-4. Reference • Capture options on page 4-3 • The Streamline Data view on page 3-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-9 ID120712 Non-Confidential...

  • Page 104: Profiling The Linux Kernel

    Customize reports using Annotate on page 10-2 • Creating custom performance counters on page 11-4. Reference • Capture options on page 4-3 • The Streamline Data view on page 3-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 11-10 ID120712 Non-Confidential...
  • Page 105 The combination of ARM Streamline and Energy Probe enables the visualization of power metrics against the software behavior of your target hardware. It provides a better understanding of the static and dynamic behavior of your target system for the purposes of debugging, profiling, and analysis.

  • Page 106: Chapter 12 Using The Energy Probe

    The current flow through a shunt resistor of a known value on your target system • The voltage at the positive terminals of the Energy Probe. Figure 12-2 Energy Probe electrical connection example ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-2 ID120712 Non-Confidential...

  • Page 107: Energy Probe Requirements

    12.2 Energy Probe requirements The Energy Probe has the following requirements: • An installation of ARM DS-5 Basic or Professional Edition, version 5.9 or later. • A suitable DS-5 license. • A Streamline-enabled target. For Linux and Android targets, this requires the gator driver and daemon to be installed on the target.
  • Page 108 Streamline aligns the power data with the software activity by maximizing the correlation of Channel 0 with the CPU load. • The probe white wire is V+. The black wire is V-. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-4 ID120712 Non-Confidential...

  • Page 109: Energy Probe Setup

    Quickly remove the probe from the target and check you have not damaged your target. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-5 ID120712 Non-Confidential...
  • Page 110 Wait for LED to turn red, and then off. Firmware programming mode is now active. When the drive folder has opened, delete the file. This file is a placeholder. firmware.bin ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-6 ID120712 Non-Confidential...
  • Page 111 Safely remove the Energy Probe drive from the machine using the Windows Safely Remove driver icon. Unplug the Energy Probe from the machine. Wait for about one second and plug it back in. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-7 ID120712 Non-Confidential...

  • Page 112: Energy Probe Operation

    Figure 12-4 Energy Probe in the Timeline view 12.4.1 Adding the caiman application to Streamline To configure Energy Probe, select the ARM Energy Probe option from the Energy Capture drop-down menu and add the path to the application in the Streamline options panel of caiman the run configuration dialog box, under Tool Path.
  • Page 113 Timeline view. The Reset button in the middle to returns the power data to its original position. Figure 12-6 The Energy Offset menu ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-9 ID120712 Non-Confidential...
  • Page 114 NI-DAQ device. As with Energy Probe, you must configure caiman.exe in the Tool path field and configure all channel options. For more information, see Energy Capture options on page 4-4. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 12-10 ID120712 Non-Confidential...

  • Page 115: Using Streamline On The Command Line

    Chapter 13 Using Streamline on the Command Line Note The feature is only available in the full DS-5 installation. The following topic describes how to use Streamline on the command line: • Opening a Streamline-enabled command prompt or shell on page 13-2 •...

  • Page 116: Opening A Streamline-Enabled Command Prompt Or Shell

    Using Streamline on the Command Line 13.1 Opening a Streamline-enabled command prompt or shell To use Streamline on the command line, open a DS-5 command prompt. On Windows, select Start All Programs → ARM DS-5 → DS-5 Command Prompt. On Linux, add the .../bin location to your environment variable then open a UNIX bash shell.

  • Page 117: The Streamline Command

    To create a file, enter your settings and then use the Export... option session.xml in the Capture Options dialog box within DS-5 for Eclipse. For instructions on how to create a file manually, see Capturing data on your target on session.xml...
  • Page 118 Use the Export snippet configuration to a file button in the Snippet menu of the Timeline view to create a valid configuration, then use that file with the option. -template ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 13-4 ID120712 Non-Confidential...
  • Page 119 -report -timeline capture_001_001.apd > output.txt This creates a file, , if it does not already exist, and outputs the data to the new file output.txt instead of the command window. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 13-5 ID120712 Non-Confidential...
  • Page 120 Functions view column headers on page 7-7 • Stack view column headers and the Maximum Stack Depth by Thread chart on page 7-8 • The Log view on page 10-9. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 13-6 ID120712 Non-Confidential...
  • Page 121 Chapter 14 Troubleshooting The following topics describe how to troubleshoot common Streamline issues: • Target connection issues on page 14-2 • Report issues on page 14-3 ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 14-1 ID120712 Non-Confidential...

  • Page 122: Target Connection Issues

    Streamline may be running on this machine. Please close all instances of Eclipse and try again. Solution: Stop any other running Streamline session and try connecting to the target again. If you cannot find another session, try closing Eclipse for DS-5, then re-starting it. Symptom When using event-based sampling, Streamline fails to find the PMU.

  • Page 123: Report Issues

    PMU on your target might not have triggered the interrupts correctly. Test on alternate hardware or disable event-based sampling in the counter configuration dialog box. 14.2.1 See also Reference • Target connection issues on page 14-2. ARM DUI 0482K Copyright © 2010-2012 ARM. All rights reserved. 14-3 ID120712 Non-Confidential...

Table of Contents