Step 2: Build Yocto Project*-Based Image
Intel recommends setting up the target OS by building a Yocto Project*-based image using the board support package (BSP) with Intel® TCC Tools dependencies and then deploying Intel® TCC Tools on top of it. In addition, you may want to add the VTune™ Profiler layer to your image to experience the full capabilities of VTune™ Profiler when profiling applications on your target system.
Building an image is time-consuming and requires substantial compute resources. You should ensure your build host system is capable of doing it. The host system used for building the image can be different from the host system for development with Intel® TCC Tools. Consider using a dedicated server system to build the image and then share the image among developers.
NOTE:
To build this image, your system will take anywhere from one half-hour (assuming your system is a large server) to several hours (assuming your system is a typical laptop).
Select one of the following options:
NOTE:
If you do not plan on doing deep analysis of platform performance counters and events, choose Option A.
Option A: Build the image with Intel® TCC Tools dependencies
Integrates all OS level dependencies for Intel® TCC Tools into a Yocto Project image.
Is sufficient if you already have knowledge about the cache-related bottlenecks in your application and do not plan to invest in a deeper analysis, or want to use your own profiling tools.
Option B: Build the image with Intel® TCC Tools dependencies and VTune™ Profiler layer
Contains Option A components, plus support for VTune™ Profiler.
VTune™ Profiler offers deep analysis of platform performance counters and events.
VTune™ Profiler will need to be installed on your host system before building the image.
Option A: Intel® TCC Tools Dependencies
For this option, you will go to the appropriate BSP Get Started Guide for the target processor and complete the prerequisites and steps required to build the image.
Go to the appropriate BSP Get Started Guide:
Follow the steps in the BSP Get Started Guide to prepare and set up the host system. In this context, the “host system” is your build host. Certain steps will prompt you to choose an option or decide whether you need a component. Make sure to complete all steps that are marked as required for Intel® TCC Tools.
After completing the BSP instructions, return to this guide.
(Optional) The BSP addresses OS latency via a real-time kernel and optimized drivers. After installing the BSP, run your real-time application to check whether your requirements are met. If your requirements are not met, proceed to the next step to enable Intel® TCC Mode.
After generating and booting the BSP in the OS successfully, verify the OS dependencies as follows:
To verify that the system boots into the real-time kernel:
uname -ar
The resulting kernel name must have the text “rt” in it.
If you are using UEFI IFWI, to verify that the BSP is installed with meta-ptcm binaries (meta-ptcm binaries consist of the rtcm_boot.efi and rtcm_rtdrv.efi files):
ls -al /boot/efi/EFI/BOOT/rtcm*efi
If you are using SBL IFWI, to verify that the BSP is installed with meta-ptcm binaries (meta-ptcm binaries consist of the sbl_rtcm file):
ls -la /boot/sbl_rtcm*
NOTE:If you are using the VTune™ Profiler, you can use either the command for UEFI IFWI or the command for SBL IFWI to verify that the BSP is installed with meta-ptcm binaries.
Option B: Intel® TCC Tools Dependencies and VTune™ Profiler Layer
NOTE:
Note that VTune™ Profiler layer integration into the BSP is not present in the available VTune™ Profiler releases. Therefore only Option A is applicable.
You can use an image containing the VTune™ Profiler layer to experience the full capabilities of VTune™ Profiler when profiling applications on your target system. This option is covered in the tutorial Profile Applications with VTune™ Profiler.