Intel® Time Coordinated Computing Tools (Intel® TCC Tools) 2021.2 Developer Guide

Developer Guide

  • 2021.2
  • 06/11/2021
  • Public
Contents

Setup

You can run the cache allocation sample with command-line options to see various uses of the cache allocation library. This guide provides examples of commands and outputs. Before attempting to run the sample, make sure you have completed the following prerequisites.

Prerequisites

This guide is based on a host-target setup. Confirm that you have a host system and a target system that are configured according to the Get Started Guide.
This guide shows how to run the cache allocation sample and see the benefits of L2 cache buffers. You must configure software SRAM before running the sample. If you have completed the Get Started Guide, software SRAM is already configured.

Confirm Real-Time Kernel

Confirm that the target system is running the real-time kernel.
  1. From your host system, connect to the target system:
    ssh <user>@<target>
  2. In the SSH session, run the following command to run
    tcc_rt_checker
    :
    tcc_rt_checker
  3. In the output, find the
    RT Kernel Checker
     row and confirm that it contains
    RT_READY
    .
    +-----+-------------------+--------------------------+----------------------+----------+
|  4  | RT Kernel Checker | Checks that RT kernel is | Current kernel is RT | RT_READY |
|     |                   | used                     |                      |          |
+-----+-------------------+--------------------------+----------------------+----------+
  4. If the
    RT Kernel Checker
     row does not report
    RT_READY
    , reboot the target system and make sure to select the RT kernel.

Enable RTCM

Confirm that RTCM is enabled on the target system:
  1. (Skip this step if you ran
    tcc_rt_checker
     and still have access to the output) In the SSH session, run the following command to run
    tcc_rt_checker
    :
    tcc_rt_checker
  2. In the output, find the
    RTCM Checker
     row and confirm that it contains
    RT_READY
    :
    +-----+--------------+-----------------------------+-------------------------+----------+
|  2  | RTCM Checker | Checks that RTCM is enabled | Current boot isn't RTCM | RT_READY |
+-----+--------------+-----------------------------+-------------------------+----------+
  3. If the
    RTCM Checker
     row does not report
    RT_READY
    , enable RTCM with the following commands:
    For systems running the PR1 release of the Yocto Project*-based BSP for Intel Atom® x6000E Series processors, run:
    /usr/share/tcc_tools/scripts/setup_ssram_v1/control_rtcm.sh enable
reboot
    For other systems, run:
    /usr/share/tcc_tools/scripts/setup_ssram/control_rtcm.sh enable
reboot

Build the Sample

The Intel® TCC Tools package for the target system contains a prebuilt binary of this sample. The binary is configured to run from any directory on the target system.
If you want to build the sample, use the provided makefile.
For systems running the PR1 release of the Yocto Project*-based BSP for Intel Atom® x6000E Series processors, you must take additional steps to build samples on the target system:
  1. Go to the sample directory:
    cd /usr/share/tcc_tools/samples/<sample_name>
  2. Change the library name in the Makefile to libittnotify64.a:
    sed 's/ittnotify/ittnotify64/g' -i Makefile

Run the Sample

After completing the setup, try these examples:

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.