ARM® DS-5 Using ARM Streamline

Version 5.11


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 Streamline Data View
The 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 Timeline View
About the Timeline view
Timeline view charts
Customizing 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
Call Graph 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 Streamline Data view
2. The compact data view
3. Naming your Capture
4. The Edit Locations... button
5. A working Streamline Capture
6. The Streamline data view
7. The Change capture options button
8. Configuration options
9. The Energy Capture Dialog
10. Program images toolbar
11. The 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 Timeline view
17. The chart expansion control
18. A bar chart with an active selection in the processes section
19. Process bars
20. CPU contention dots in the Timeline view
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. The Events-based sampling tag
30. The Chart Configuration button
31. The Chart Configuration panel and Cache chart
32. The Chart Configuration panel toolbar
33. Data from series A obstructed by data from series B
34. A stack chart example
35. A bar chart example
36.
37. The Color dialog box
38. The Snippets menu
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 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 populated Energy Capture field
72. The offset arrows in the Timeline view
73. A functions report generated using report mode
74. The call paths report on the command line
75. 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 2011Version 5.4
Revision CApril 2011Version 5.5
Revision DJuly 2011Version 5.6
Revision ESeptember 2011Version 5.7
Revision FNovember 2011Version 5.8
Revision GFebruary 2012Version 5.9
Revision HMay 2012Version 5.10
Revision IJuly 2012Version 5.11
Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0482I
Non-ConfidentialID072412