ARM® DS-5 Using ARM Streamline

Version 5.13


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
Support for National Instruments Multifunction Data Acquisition devices (NI DAQ)
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 Tool Path dialog box
10. The Streamline data view
11. The Counter Configuration button
12. The Counters Configuration dialog box
13. Add counter to the Events to Collect list
14. Setting events-based sampling
15. The Timeline view
16. Process bars
17. CPU contention dots in the Timeline view
18. A bar chart with an active selection in the processes section
19. Timeline Detail Bar
20. X-Ray mode by cluster
21. X-Ray mode with two cores
22. Adding a bookmark
23. Choosing a color
24. The bookmark in the timeline overview
25. The Quick Access tooltip
26. The Processes Focus button
27. The Timeline view with the Use highest quality graphics option disabled
28. The Events-based sampling tag
29. Energy Offset menu
30. Mali charts in the Timeline
31. The Chart Configuration button
32. The Chart Configuration panel and Cache chart
33. The Chart Configuration panel toolbar
34. A stack chart example
35. Data from series A obstructed by data from series B
36. A bar chart example
37.
38. The Color dialog box on Windows
39. The Snippets menu
40. Changing categories
41. Re-sizing a chart
42. Using the calipers to filter
43. Using the chart disclosure control to show per cluster data
44. Moving a chart using the handle control
45. The Cross Section Marker
46. The zoom level drop-down menu
47. Visual annotation in the Timeline view
48. Hovering over an image in the Timeline view
49. Text with visual annotation
50. A multi-level sort
51. Maximum Stack Depth by Thread chart
52. The Code View
53. The Totals panel
54. The More indicator
55. Missing source file
56. Locate source dialog box
57. The Find field
58. A Simple Call Hierarchy
59. A Call Hierarchy with Multiple Call
60. Caller Bullets
61. The Call Graph Mini-map
62. A Selected Function
63. Annotate overlays
64. Automatically adding bookmarks during capture
65. Visual Annotation in the Timeline view
66. Visual annotation with optional text
67. The Log view
68. Visual annotation in the Log view
69. The Sine counter in the Timeline view
70. The Analyze dialog box
71. Energy Probe schematic
72. Energy Probe electrical connection example
73. Connection to target
74. Energy Probe in the Timeline view
75. The populated Tool Path field
76. The Energy Offset menu
77. A functions report generated using report mode
78. The call paths report on the command line
79. 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 2011‘Version 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
Revision JOctober 2012Version 5.12
Revision KDecember 2012Version 5.13
Copyright © 2010-2012 ARM. All rights reserved.ARM DUI 0482K
Non-ConfidentialID120712