Developer Guide

  • 2021.1
  • 11/03/2021
  • Public


You can run the cache allocation sample with command-line options to see various uses of the cache allocation library. This guide provides example commands and outputs. Before attempting to run the sample, make sure you have completed the following 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. It is essential to 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 get the name of the current kernel:
    uname -r
  3. Confirm that the output contains
    . Example output:
  4. If the output does not contain
    , reboot the target system and make sure to select the RT kernel.

Enable RTCM

Currently, cache allocation library and data streams optimizer cannot be used together. This is because RTCM, an underlying component of cache allocation library, must be disabled before using the data streams optimizer for the first time and must remain disabled afterward. For more details, see Real-Time Configuration Manager (RTCM). If you combine RTCM and data streams optimizer, you may experience system hang and various errors due to offline cores. To resolve the errors, you may need to reflash the BIOS. For more details, see Troubleshooting.
If RTCM is not already enabled, you can enable it with the following commands:
/usr/share/tcc_tools/scripts/setup_ssram/ 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.

Run the Sample

After completing the setup, try these examples:

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at