ARM® DS-5 Using ARM Streamline

Version 5.10


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
The ARM Streamline Data view
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 Chart Configuration View
Opening the Counter Configuration dialog box
Chart Configuration view toolbar options
Chart Configuration view options
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. The compact data view
3. The Edit Locations... button
4. From working Streamline Capture Data to Streamline Analysis Report
5. The ARM Streamline data view
6. The Change capture options button
7. Configuration options
8. Naming the capture options
9. The Energy Capture Dialog
10. Program images toolbar
11. The ARM Streamline data view
12. The Counter Configuration button
13. The Counters Configuration dialog box
14. Add counter to the Events to Collect list
15. Setting events-based sampling
16. The Chart Configuration view
17. The Chart Configuration toolbar
18. The Save Template dialog box
19. The Interrupt chart control
20. The Interrupts chart
21. Data from series A obstructed by data from series B
22. A stack chart example
23. A percentage chart example
24. The Color dialog box
25. The Timeline view
26. The chart expansion control
27. A bar chart with an active selection in the processes section
28. Process bars
29. CPU contention dots in the Timeline view
30. Timeline Detail Bar
31. X-Ray mode
32. Adding a bookmark
33. Choosing a color
34. The bookmark in the timeline overview
35. A value pin
36. The Processes Focus button
37. The Timeline view with the Use highest quality graphics option disabled
38. The Events-based sampling tag
39. Using the calipers to filter
40. Moving a chart using the handle control
41. The cross-section marker
42. The zoom level drop-down menu
43. Visual annotation in the Timeline view
44. Hovering over an image in the Timeline view
45. Text with visual annotation
46. A multi-level sort
47. Maximum Stack Depth by Thread chart
48. The Code view
49. The Totals panel
50. The More indicator
51. Missing source file
52. Locate source dialog box
53. The Find field
54. A Simple Call Hierarchy
55. A Call Hierarchy with Multiple Call
56. Caller Bullets
57. The Call Graph Mini-map
58. A Selected Function
59. Annotate overlays
60. Automatically adding bookmarks during capture
61. Visual Annotation in the Timeline view
62. Visual annotation with optional text
63. The Log view
64. Visual annotation in the Log view
65. The custom Sine counter in the Timeline view
66. The Analyze dialog box
67. Energy Probe schematic
68. Energy Probe electrical connection example
69. Connection to target
70. Energy Probe in the Timeline view
71. The offset arrows in the Timeline view
72. A functions report generated using report mode
73. The call paths report on the command line
74. 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
Revision HMay 2012Update for DS-5 version 5.10
Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0482H
Non-ConfidentialID050312