Developer Guide

  • 2021.1
  • 11/03/2021
  • Public

Launch the Cache Configurator

When you launch the cache configurator, it reads the current cache configuration and displays it on the console.
The following steps assume a host-target setup.
To launch the cache configurator:
  1. From your host system, connect to the target system:
    ssh <user>@<target>
  2. In the SSH session
    , disable the real-time configuration manager (RTCM) before using the cache configurator. You can disable RTCM with the following commands:
    /usr/share/tcc_tools/scripts/setup_ssram/ disable reboot
  3. On the host system
    , source the environment file to set up environment variables:
    source ~/intel/oneapi/
  4. Go to the
    cd ${TCC_TOOLS_PATH}
  5. If you have not done so already, modify the sample environment file to enable the host to SSH to the target system when running the cache configurator. This example command uses nano, but you can use any text editor.
    nano demo/environment/sample_environment.json
    Modify the following fields:
    Field Name
    with the IP address or host name of the target system.
    for customer reference boards.
    The field should look like this:
    "username": "root"
    This field contains the username to connect to the target system by SSH.
    with the password to connect to the target system by SSH.
    If the SSH connection is expected to be passwordless or you have created an SSH key and installed an SSH key on a target system, leave the password field empty as shown below:
    "password": ""
    All other fields
    Leave all other fields as is. These fields enable you to further customize the behavior of the tool.
  6. Save and close the file.
  7. Run the tool, where
    is the path to your environment file.
    ./ --environment ./demo/environment/sample_environment.json
First, the tool displays the current software SRAM allocation. On the first tool execution, you may see already allocated software SRAM. This is because the
script executed in the Get Started Guide applies a preset configuration. The configuration may vary by platform.
In the following example, the system has one software SRAM buffer. The maximum access latency of the buffer is 159 nanoseconds, the buffer is in L3 cache, the buffer is available to applications running on CPU cores 0, 1, 2 and 3, and the buffer size is 1,048,576 bytes.
You can choose to add a buffer, delete a buffer, or change the way the cache is partitioned among caching agents.
Checking the platform's current real-time configuration for maximum tolerable buffer access latency, buffer size, etc. For more information on these parameters see the Intel® TCC Tools Developer Guide At any time, you can press (Ctrl + C) to exit the application press (U) to cancel current operation and return to the main screen Connected. ******************************************************************************** Here is an initial configuration you currently have on the system CURRENT BUFFERS ALLOCATED: 1 BUFFER 0 LATENCY(ns): 159 CACHE LEVEL: 3 CPU CORE: [0, 1, 2, 3] BUFFER SIZE(bytes): 1048576 Would you like to add (A) or delete (D) a cache allocation? Or would you like to change the way the configuration is partitioned? (P)
Intel recommends starting with Select a Cache Partitioning Preset.

Product and Performance Information


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