Building and Managing Energy Analysis Driver

Installing Drivers on a Linux* System

Intel® VTune™ Amplifier for Systems uses the kernel driver to enable the energy analysis. The energy analysis driver, or Intel SoC Watch driver, is typically installed by default during the product installation. If the kernel on your Linux* system is not one of the supported kernels listed in the Release Notes, you need to build and load the driver manually as follows:

1. Configure the basic software environment.

2. Build and (re)load the energy analysis driver.

Configuring the Basic Software Environment

To compile the energy analysis driver, the target system must have the following software installed:

• C compiler that was used to build the kernel and that is capable of compiling programs with anonymous structs/unions, for example, GCC* 2.96 or later.

• Tools needed to build a C-based program, for example, GNU* make tool, native assembler, linker.

• System headers, for example, /usr/include/.

In addition, the kernel version must be 2.6.32 or later and must be configured with the following options enabled:

• CONFIG_MODULES=y
• CONFIG_MODULE_UNLOAD=y
• CONFIG_TRACEPOINTS=y
• CONFIG_TIMER_STATS=y

• CONFIG_X86_ACPI_CPUFREQ=m (or CONFIG_X86_ACPI_CPUFREQ=y)

• CONFIG_INTEL_IDLE=y

Building and (Re)Loading the Driver

If the drivers are not installed or if Intel SoC Watch executable requires a more recent version of the drivers then you will need to compile the drivers from source. To compile drivers from source, the kernel-headers package for the kernel running on the target machine must be installed. For instance, if your target device is running kernel version 3.9.10-100.fc17.x86_64 then the package kernel-headers-3.9.10-100.fc17.x86_64 must be installed.

• For target systems with an Intel Atom™ processor:

  1. Navigate to the soc_perf_driver/src directory and compile the socperf driver:

     > cd ./soc_perf_driver/src> sh ./build-driver -ni

  2. Navigate to the socwatch_linux_vx.x change to the socwatch_driver directory, and compile the Intel SoC Watch driver:

     > cd ../../socwatch_driver> sh ./build_driver

• For target systems with an Intel Core™ processor, change to the socwatch_driver directory and compile the Intel SoC Watch driver:

  > cd ./socwatch_driver> sh ./build_driver -l -n

Installing the Energy Analysis Collector on the Target Android System

1. On the host, unzip the remote target package, system_studio_target.tgz, located, by default, in the Targets subdirectory of the Intel System Studio installation directory.

2. Depending on the target operating system or Intel architecture, run the required install script:

   • socwatch_android_vx.x.x/socwatch_android_install.bat on a Windows host.

   • socwatch_android_vx.x.x/socwatch_android_install.sh script on a Linux host or a Cygwin window on a Windows host.

   By default, the script installs the collector executables to the /data/socwatch directory on the Android target system. Use the -d option to select a different install directory and the -s option to define a specific target device if multiple devices are connected to the host.