Energy Analysis User Guide

Download PDF
ID 767268
Date 3/31/2023
Public
Document Table of Contents
Document Table of Contents x
Energy Analysis User Guide
Energy Analysis User Guide x
Energy Analysis Workflows Build and Manage Energy Analysis Driver Intel® SoC Watch Command-line Tool Options Run Energy Analysis Run Energy Analysis Using Intel® System Studio Energy Analysis Metrics Reference Legal Information
Build and Manage Energy Analysis Driver x
Preparing a Target Linux* System for Energy Analysis Preparing a Target Android* System for Energy Analysis Build the Device Drivers Install the Intel® SoC Watch Collector Load the Device Drivers Preparing a Target Windows* System for Energy Analysis
Run Energy Analysis x
View Energy Analysis Data with Intel® VTune™ Profiler Interpret Energy Analysis Data with Intel® VTune™ Profiler
Run Energy Analysis Using Intel® System Studio x
View Energy Analysis Data with Intel® System Studio Import Energy Analysis Results into Intel® System Studio
Energy Analysis Metrics Reference x
Available Core Time C-State D0ix States DRAM Self Refresh Energy Consumed (mJ) Idle Wake-ups P-State S0ix States Temperature Timer Resolution Total Time in C0 State Total Time in Non-C0 States Total Time in S0 State Total Wake-up Count Wake-ups Wake-ups/sec per Core
Energy Analysis User Guide

Preparing a Target Android* System for Energy Analysis

When collecting energy data on a target Android device, make sure to:

Build the Device Drivers

Complete the following steps if the Intel® SoC Watch device drivers are not already installed on the OS image:

  1. Extract the system_studio_target.tgz package to the host system used to build the target system's Android kernel.

    By default, the package can be found in the following location:

    • On a Windows host: C:\Program Files (x86)\IntelSWTools\system_studio_<version>\Targets\system_studio_target.tgz

    • On a Linux host: /opt/intel/system_studio_<version>/targets/system_studio_target.tgz

  2. Navigate to the following location: <extract_dir>/system_studio_target/socwatch_android_<version>

  3. Run the build driver script with the following command:

    • For target systems with an Intel Atom® processor: 

      > sh ./build-drivers.sh -k <kernel-build-dir> -s <full-path-to-sign-file>

    • For target systems with an Intel® Core™ processor: 

      > sh ./build-drivers.sh -k <kernel-build-dir> -n -s <full-path-to-sign-file>

    Where the <kernel_build_dir> is the local Android lib/modules directory produced while building the Android kernel. The -k option is not required if the DEFAULT_KERNEL_BUILD_DIR is properly set in the build_driver script.

Install the Intel® SoC Watch Collector

Complete the following steps to install the Intel SoC Watch collector:

  1. Connect the host system to the target system via adb.
  2. Navigate to the following location on the host system: <exract_dir>/system_studio_target/socwatch_android_<version>

  3. Run the following file to install the Intel SoC Watch executables in the /data/socwatch directory on the target Android system.

    • On Linux: socwatch_android_install.sh

    • On Windows: socwatch_android_install.bat

Load the Device Drivers

Complete the following steps to load the device drivers on the target Android system:

  1. Connect the host system to the target system via adb.

  2. Run the following adb commands to start a shell with root privileges:

    > adb root

    > adb shell

  3. Navigate to the /lib/modules directory, which contains the drivers you installed.

  4. Load the latest version of the socperf driver using the following command:

    > insmod socperf<version>.ko

  5. Load the socwatch driver using the following command, replacing the 2_x with the appropriate Intel SoC Watch version:

    insmod socwatch2_x.ko

  6. Run the following command to confirm that the drivers loaded successfully:

    > lsmod

Parent topic: Build and Manage Energy Analysis Driver

See Also

Level Two Title