User Guide

  • 2020
  • 06/18/2020
  • Public Content
Contents

Window: Wakelocks - Platform Power Analysis

To access this window:
Select the Platform Power Analysis viewpoint and click the
Wakelocks
sub-tab in the result tab. The
Wakelocks
window is available for platform power analysis on Android* target systems only.
Use the
Wakelocks
window to:
  • View lock duration and locking/unlocking reasons.
  • Review kernel, or system, wakelocks and understand how they change over time.
  • Understand which applications cause locks, the user locking process, and the user wakelock tag.
  • Analyze user and application wakelock changes over time.
Platform Power Analysis
viewpoint is available as part of energy analysis. Collecting energy analysis with Intel® SoC Watch is available for target Android*, Windows*, or Linux* devices and provided only with the Intel System Studio. Import and viewing of the Intel SoC Watch results is supported with any version of the VTune
Profiler
.

Wakelock Pane

The Wakelock pane shows the list of wakelock objects for the user/application or kernel, depending on the grouping selected. Change the grouping selection to view data about either kernel or application/user wakelocks and the process that caused the lock or unlock. The following grouping levels and combinations of these grouping levels are available from the
Grouping
drop-down menu:
  • Kernel wakelock
  • Locking processes
  • Application name
  • User locking process
  • User wakelock tag
The grid displays the sample counts for each object. Click the expand /collapse buttons in the data columns to expand the column and show data for different wakelock objects. By default, the table is sorted by the
Kernel Wakelock/Locking Process/Locking Thread
grouping in ascending order, which provides the objects with the highest total lock duration first. You can change the unit displayed by right-clicking a data cell and selecting the
Show Data As
option to select an alternate unit.
The following columns are available for kernel wakelocks.
Total Lock Duration
Duration of the lock in seconds.
Kernel Wakelock Count
Number of kernel wakelocks that occurred.
Wakelock Lock Count by Lock Reason
Number of wakelocks for the following reasons: Process, Existing Lock, Unknown. An Existing Lock was already started when the collection began.
Wakelock Unlock Count by Unlock Reason
The number of wakelock unlocks for the following reasons: Process, Timeout, Overwritten, Unknown. An Unknown wakelock unlock reason may mean that the wakelock continued after the collection ended.
Locking PID
Identifier of the process that caused the wakelock lock.
Locking TID
Identifier of the thread that caused the wakelock lock.
In the following example, the PowerManagerService.Wakelocks kernel wakelock had already started before the collection began and continued after the collection ended.
Application/user wakelocks show information for the APK name rather than the wakelock name like kernel wakelocks. The following columns are available for application/user wakelocks:
Total Lock Duration
Duration of the lock in seconds.
User Wakelock Count
Number of user wakelocks that occurred.
User Wakelock Flag
The type of wakelock.
User UID
Identifier of the application that caused the wakelock lock or unlock.
User Locking/Unlocking PID
Identifier of the application that caused the wakelock lock or unlock.
In the following example, two wakelocks originated from the com.intel.wakelockapp APK.

Timeline Pane

Toolbar
Navigation control to zoom in/out on the view on areas of interest. For more details on the Timeline control, see Managing Timeline View .
Legend
Types of data presented on the timeline. Filter in/out any type of data presented on the timeline by selecting/deselecting corresponding check boxes. For example, you may only be interested in the application/user wakelock data and want to remove the kernel wakelock timelines for an expanded view of the application/user wakelock data.
Application Name
Graphical representation of the wakelock duration for each application APK.
Wakelock
Graphical representation of the kernel wakelock duration through the collection time.
Wakelock Details
Hover over the timeline of an application to view tooltips with details such as the wakelock type, start time, duration, locking and unlocking process name, and application name.
Hover over the timeline of a kernel wakelock to view tooltips with details such as the wakelock type, start time, duration, locking and unlocking reasons, and locking process.
Zoom in on the timeline to view the exact time when the wakelock started and when it was released. It is possible for one wakelock to begin before another ends, causing an overlap.
Filters applied on a timeline in one window are applied on all other windows within the viewpoint. This is useful if you identify an issue on one tab and want to see how the issue impacts the metrics shown on a different tab. For more details on the timeline control, see Managing Timeline View .

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804