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:
- From your host system, connect to the target system:ssh <user>@<target>
- In the SSH session, disable the real-time configuration manager (RTCM) before using the cache configurator. You can disable RTCM with the following commands:For UEFI BIOS:/usr/share/tcc_tools/scripts/setup_ssram/control_rtcm_uefi.sh disable rebootFor SBL:/usr/share/tcc_tools/scripts/setup_ssram/control_rtcm_sbl.sh disable reboot
- On the host system, source the environment file to set up environment variables:source ~/intel/tcc_tools/latest/env/vars.sh
- Go to thetoolsdirectory:cd ${TCC_TOOLS_PATH}
- Review the target connection settings file:
- Open the target connection settings file. This command example uses nano, but you can use any text editor.nano ./host_scripts/target_connection_settings.sh
- Modify the following fields (see example file below):Field NameDescriptionHOSTNAMEReplacehostnamewith the IP address or hostname of the target system.USERReplaceuserwithroot.SSH_EXTRAAdd any additional SSH command line options.This file contains the hostname and username to connect to the target board via SSH.Target connection settings file example:HOSTNAME='hostname' USER='user' SSH_EXTRA=''
- Save and close the file.
- Run the tool, where--environmentis the path to your environment file.Note:If you decide to copy the environment file to another location on your host system, be sure to change the relative paths in the environment file or replace them with full paths../tcc_cache_configurator.py --environment ./demo/environment/sample_environment_uefi.jsonIf you are using a system with Slim Bootloader, you must choose the SBL environment file:./tcc_cache_configurator.py --environment ./demo/environment/sample_environment_sbl.json
First, the tool displays the current software SRAM allocation. On the tool’s first execution, you may see an already allocated software SRAM. This is because the
tcc_setup_ssram.sh
script executed in the Get Started Guide for UEFI BIOS or Get Started Guide for Slim Bootloader, 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 or press (U) to cancel current operation and return to the main screen
********************************************************************************
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.