Qualcomm is a trademark of QUALCOMM Incorporated, registered in the United States and other countries. All
QUALCOMM Incorporated trademarks are used with permission. Other product and brand names may be
trademarks or registered trademarks of their respective owners.
This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion
contrary to U.S. and international law is strictly prohibited.
© 2010-2013 Qualcomm Technologies, Inc.
All rights reserved.
Trepn™ Profiler Starter Edition
User Guide
80-N2762-1 G
April 24, 2013
Submit technical questions at:
https://support.cdmatech.com/
80-N2762-1 G 2
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
Contents
1 Introduction ...................................................................................................... 5
1.1 Trepn™ Profiler ............................................................................................................ 5
1.1.1 Snapdragon MDP............................................................................................... 5
1.2 Conventions .................................................................................................................. 6
1.3 Updates to this version .................................................................................................. 6
1.4 Trepn Profiler download ............................................................................................... 6
2 Getting Started ................................................................................................. 7
2.1 Profiling your application ............................................................................................. 7
2.2 Graph ............................................................................................................................ 8
2.3 Stats ............................................................................................................................... 9
3 Using Trepn Profiler ...................................................................................... 10
3.1 Launching the application ........................................................................................... 10
3.2 Trepn Profiler navigation ............................................................................................ 10
3.3 Start Profiling .............................................................................................................. 11
3.4 Profile an App ............................................................................................................. 12
3.5 Stop Profiling .............................................................................................................. 13
3.6 Analyze a Run ............................................................................................................. 14
3.7 Using the Graph .......................................................................................................... 14
3.7.1 Viewing the legend .......................................................................................... 15
3.7.2 Changing the Y-axis ........................................................................................ 16
3.7.3 Zooming and scrolling in the graph ................................................................. 18
3.7.4 Understanding the Graph ................................................................................. 19
3.8 Using the Stats ............................................................................................................ 20
3.8.1 Understanding the Stats ................................................................................... 23
3.9 Preferences .................................................................................................................. 24
3.9.1 General preferences ......................................................................................... 25
3.9.2 Using Overlays ................................................................................................ 26
3.10 Trepn Profiler Help ................................................................................................... 26
3.11 Exporting .csv ........................................................................................................... 27
3.12 Using status bar controls ........................................................................................... 27
3.12.1 Notification controls ...................................................................................... 28
3.13 Upgrading Trepn Profiler .......................................................................................... 28
3.14 Profiling Battery Power ............................................................................................ 29
3.14.1 Graphing Battery Power ................................................................................ 30
4 Using Application States .............................................................................. 31
4.1 Using Android Intents to identify Application State changes in Trepn Log ............... 31
Contents
80-N2762-1 G 3
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
4.1.1 Manipulating Application State in your app .................................................... 31
4.1.2 Code for changing Application State ............................................................... 32
4.1.3 Application State example ............................................................................... 33
5 Using Intents for Automated Testing ........................................................... 34
5.1 Automated testing with Trepn Profiler ....................................................................... 34
5.1.1 Commands for sending Intents from an external .bat script ............................ 34
5.1.2 Code for sending Intents from another application.......................................... 35
5.1.3 Intents example using an external .bat script ................................................... 37
6 Using Trepn Profiler Efficiently .................................................................... 38
6.1 Managing Trepn Profiler’s Impact .............................................................................. 38
7 Troubleshooting ............................................................................................ 40
7.1 No SD card detected in Database Storage mode ......................................................... 40
7.2 SD card full in Database Storage mode ...................................................................... 41
7.3 Graphing data is too sparse ......................................................................................... 41
A What the Tool Profiles/Captures .................................................................. 42
A.1 Data Points ................................................................................................................. 42
A.1.1 Power Stats ..................................................................................................... 42
A.1.2 CPU Stats ........................................................................................................ 42
A.1.3 Network Stats .................................................................................................. 44
A.1.4 Other Stats ...................................................................................................... 45
A.2 Normalized CPU load ................................................................................................ 45
80-N2762-1 G 4
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
Revision history
Revision Date Description
A Nov 2010 Initial release
B Jun 2011 Updated for Ver 1.2 and to incorporate Snapdragon™ MDP
MSM8660™ devices
C Sep 2011 Updated for Ver 2.0; substantial changes to UI made with this
revision
D Dec 2012 Updated for Ver 3.4
E Jan 2013 Updated for Ver 3.5
F Mar 2013 Updated for Ver 3.6
G Apr 2013 Updated feature set for Ver 3.6
80-N2762-1 G 5
MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION
1 Introduction 1
1.1 Trepn™ Profiler 2
As devices become more advanced and more capable, application developers need to have greater 3
control of the various hardware components. Since battery power is still limited, it is becoming 4
increasingly important to ensure that applications are optimized for minimal power consumption. 5
The Trepn Profiler included with the Snapdragon™ MDP is a diagnostic tool for providing 6
visibility into the power impact of applications running on top of the OS. It provides the ability to 7
analyze CPU usage, network data, and other items. 8
The Trepn Profiler features the ability visualize data in a real-time graph, and provide statistical 9
information on the values collected. In addition, overlays allow you to view power and other 10
values dynamically while using the app being profiled. Files can also be exported for offline 11
analysis. 12
1.1.1 Snapdragon MDP 13
The Snapdragon MDP is Qualcomm’s development platform, providing access to cutting-edge 14
hardware in a commercial-like form factor 15
16
For more information on the Snapdragon MDP, see 17
http://developer.qualcomm.com/dev/development-devices/snapdragon-mdp. 18
- 1
- 2
前往页