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

Developer Guide

  • 2022.1
  • 09/08/2022
  • 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 for UEFI BIOS (Public Document) or the Get Started Guide for Slim Bootloader (Public Document).
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. In the SSH session, run the following command to check RTCM:
    For systems with UEFI BIOS:
    /usr/share/tcc_tools/scripts/setup_ssram/control_rtcm_uefi.sh status
    For systems with Slim Bootloader:
    /usr/share/tcc_tools/scripts/setup_ssram/control_rtcm_sbl.sh status
  2. Check that the output contains the following text:
    [ENABLED ] RTCM
  3. If the output does not report that RTCM is enabled, enable RTCM:
    For systems with UEFI BIOS:
    /usr/share/tcc_tools/scripts/setup_ssram/control_rtcm_uefi.sh enable
    For systems with Slim Bootloader:
    /usr/share/tcc_tools/scripts/setup_ssram/control_rtcm_sbl.sh enable

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.
To build the sample, use the provided 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.