Intel® VTune™ Amplifier XE and Intel® VTune™ Amplifier for Systems Help

Configuring Yocto Project* and Intel® VTune™ Amplifier with the Linux* Target Package

Intel® VTune™ Amplifier for Systems can collect and analyze performance data on embedded Linux* devices running Yocto Project*. This topic provides an example of setting up Intel VTune Amplifier for Systems to collect performance data on an embedded device using the Linux* target installation files provided in the VTune Amplifier installation directories. The process manually adds the VTune Amplifier collectors and drivers to the embedded device. Root access to the kernel is required if you need to build the drivers.

Copy and Extract Target Linux Package

Prerequisite: Install Intel VTune Amplifier for Systems on the host system.

  1. Copy the target package archive to the target device. The following target packages are available from <install-dir>/target/linux32[64]:

    • linux32/vtune_amplifier_target_sep_x86.tgz - provides hardware event-based sampling collector only (SEP) for x86 systems

    • linux32/vtune_amplifier_target_x86.tgz - provides all VTune Amplifier collectors for x86 systems

    • linux64/vtune_amplifier_target_sep_x86_64.tgz - provides hardware event-based sampling collector only (SEP) for 64-bit systems

    • linux64/vtune_amplifier_target_x86_64.tgz - provides all VTune Amplifier collectors for 64-bit systems

    For example, the following command copies the vtune_amplifier_target_x86_64.tgz package to the embedded device using SCP:

    > scp -r vtune_amplifier_target_x86_64.tgz root@123.45.67.89:/opt/intel/
  2. Extract the file on the target system. For example:

    > tar -xvsf vtune_amplifier_target_x86_64.tgz
  3. Make sure the sampling driver is available on the target system. The installation output should inform you if building the sampling driver is required. If it is not, you will need to build the sampling driver and install in on the target system.

    If the compiler toolchain is available on the target embedded system, build the driver on the target device using the following steps:

    1. Open a command prompt and navigate to the <install-dir>/sepdk/src directory. For example:

      > cd /opt/intel/vtune_amplifier_201_for_systems.0.0.0/sepdk/src
    2. Build the driver using the ./build-driver command. For example:

      > ./build-driver -ni \ --kernel-src-dir=/usr/src/kernel/ \ --kernel-version=4.4.3-yocto-standard \ --make-args="PLATFORM=x64 ARITY=smp"
    3. Load the driver into the kernel using the ./insmod-sep command.

    If the compiler toolchain is not available on the target embedded system, build the driver on the host system and install it on the target device using the following steps:

    1. Open a command prompt and navigate to the <install-dir>/sepdk/src directory. For example:

      > cd /opt/intel/vtune_amplifier_2017_for_systems.0.0.0/sepdk/src
    2. Cross-build the driver using the using the ./build-driver command. Provide the cross-compiler (if necessary) and the target kernel source tree for the build. For example:

      > mkdir drivers
      >./build-driver -ni \
      --c-compiler=i586-i586-xxx-linux-gcc \
      --kernel-version=4.4.3-yocto-standard \
      --kernel-src-dir=/usr/src/kernel/ \
      --make-args="PLATFORM=x32 ARITY=smp" \
      --install-dir=./drivers
      
    3. Copy the sepdk/src/drivers folder to the target system.
    4. Load the driver into the kernel using the ./insmod-sep command.

    For more information, see Building and Managing the Sampling Driver.

Configure and Run Remote Analysis

Use the following steps on the host system to set up and launch the analysis on the embedded device:

  1. Set up a password-less SSH access to the target using RSA keys.

  2. Create a new project.

  3. Select the remote Linux (SSH) analysis target and specify the collection details.

  4. Configure the analysis type.

  5. Start the analysis.

For more information, see Collecting data remotely from the VTune Amplifier GUI.

See Also