ARM® DS-5 Using ARM Streamline

Version 5.9


List of Topics

Conventions and Feedback
Setting Up Your Target
Setting up an ARM Linux target
Setting up an Android target
Recommended compiler options
Mali setup for Streamline
Using the ARM Streamline Data View
ARM Streamline Data view basics
ARM Streamline Data view toolbar options
The Analysis Data Locations dialog box
Setting Capture Options
Opening the Capture Options dialog box
Capture options
Configuring Counters
Opening the Counter Configuration dialog box
Using the Counters Configuration dialog box
The Timeline View
About the Timeline view
Timeline view charts
Filtering data and other Timeline view controls
Timeline view toolbar options, contextual menu options, and keyboard shortcuts
Visual Annotation in the Timeline view
The Table Views: Call Paths, Functions, and Stack
Table views toolbar options, contextual menu options and keyboard shortcuts
Sorting data in the table reports
Call Paths view column headers
Functions view column headers
Stack view column headers and the Maximum Stack Depth by Thread chart
The Code View
Code view basics
Code view toolbar options and keyboard shortcuts
The Call Graph View
Call Graph view basics
Contextual menu options
The toolbar and keyboard shortcuts
Annotate and the Log View
Customize reports using Annotate
Adding bookmarks using Annotate
Adding images to reports using Visual Annotate
The Log view
Advanced Customizations
Capturing data on your target
Creating custom performance counters
Using Stored Streamline Capture Data to create new Streamline Analysis Reports
Profiling the Linux kernel
Using the Energy Probe
Energy Probe overview
Energy Probe requirements
Energy Probe setup
Energy Probe operation
Using Streamline on the Command Line
Opening a Streamline-enabled command prompt or shell
The streamline command
Troubleshooting
Target connection issues
Report issues

List of Figures

1. The ARM Streamline Data view
2. From working Streamline Capture Data to Streamline Analysis Report
3. The Edit Locations... button
4. The ARM Streamline data view
5. The Change capture options button
6. Configuration options
7. Naming the capture options
8. Program images toolbar
9. The ARM Streamline data view
10. The Counter Configuration button
11. The Counters Configuration dialog box
12. Add counter to an existing category
13. Add counter to a new category
14. The Change Counter Name dialog box
15. The Color dialog box
16. Setting events-based sampling
17. The Timeline view
18. The chart expansion control
19. A bar chart with an active selection in the processes section
20. Process bars
21. Timeline Detail Bar
22. X-Ray mode
23. Adding a bookmark
24. Choosing a color
25. The bookmark in the timeline overview
26. A value pin
27. The Processes Focus button
28. The Timeline view with the Use highest quality graphics option disabled
29. Using the calipers to filter
30. Moving a chart using the handle control
31. The cross-section marker
32. Visual annotation in the Timeline view
33. Hovering over an image in the Timeline view
34. Text with visual annotation
35. A multi-level sort
36. Maximum Stack Depth by Thread chart
37. The Code view
38. The Totals panel
39. The More indicator
40. Missing source file
41. Locate source dialog box
42. The Find field
43. A Simple Call Hierarchy
44. A Call Hierarchy with Multiple Call
45. Caller Bullets
46. The Call Graph Mini-map
47. A Selected Function
48. Annotate overlays
49. Automatically adding bookmarks during capture
50. Visual Annotation in the Timeline view
51. Visual annotation with optional text
52. The Log view
53. Visual annotation in the Log view
54. The custom Sine counter in the Timeline view
55. The Analyze dialog box
56. Energy Probe schematic
57. Energy Probe electrical connection example
58. Connection to target
59. Energy Probe in the Timeline view
60. A functions report generated using report mode
61. The call paths report on the command line
62. The Timeline view in a text file

Proprietary Notice

Words and logos marked with a ® or ™ are registered trademarks or trademarks of ARM in the EU and other countries, except as otherwise stated below in this proprietary notice. Other brands and names mentioned herein may be the trademarks of their respective owners.

Neither the whole nor any part of the information contained in, or the product described in, this document may be adapted or reproduced in any material form except with the prior written permission of the copyright holder.

The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given by ARM in good faith. However, all warranties implied or expressed, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.

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.

Where the term ARM is used it means “ARM or any of its subsidiaries as appropriate”.

The Visual Annotation screenshots in the documentation feature the DOOM software from the PrBoom project and contributors (http://www.crowproductions.de/repos/prboom).

Confidentiality Status

This document is Non-Confidential. The right to use, copy and disclose this document may be subject to license restrictions in accordance with the terms of the agreement entered into by ARM and the party that ARM delivered this document to.

Product Status

The information in this document is final, that is for a developed product.

Revision History
Revision ASeptember 2010ARM Streamline Performance Analyzer 1.0
Revision BJanuary 2011Update for DS-5 version 5.4
Revision CApril 2011Update for DS-5 version 5.5
Revision DJuly 2011Update for DS-5 version 5.6
Revision ESeptember 2011Update for DS-5 version 5.7
Revision FNovember 2011Update for DS-5 version 5.8
Revision GFebruary 2012Update for DS-5 version 5.9
Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0482G
Non-ConfidentialID021712