Get Started

  • 2022.1
  • 09/08/2022
  • Public

Step 7: Complete the Target System Setup

To complete the target system setup, you will enable the cache allocation capabilities of Intel® TCC Tools. You will run a script that reserves a portion of the L2 and L3 cache. A reserved portion of cache is called
software static random-access memory (software SRAM)
.
Software SRAM enables the cache allocation library to provide low-latency memory buffers to your real-time applications. At the same time, part of the cache will be removed from general use, potentially reducing the performance of non-real-time applications.
This step reserves the recommended amount of cache for running the cache allocation sample. You can choose a different amount later via the
cache configurator
tool, based on the memory requirements of your real-time application.
If you are unable to disable TCC Authentication in the BIOS or unable to use pre-signed capsules for some reason, refer to Configure Software SRAM to generate capsules with your own keys. For details about keys management, refer to UEFI Security Signing Process and Requirementsand SBL Security Signing Process and Requirements.
To complete and verify setup:
  1. Wait for the target system to boot.
  2. On the development host system
    , connect to the target via SSH. Replace
    <target>
    with the IP address or hostname of the target system.
    ssh root@<target>
  3. In the SSH session
    , go to the following directory:
    cd /usr/share/tcc_tools/scripts/setup_ssram/
  4. Run the following command to set up the target system to be used with the cache allocation library. If the script is unable to detect the CPU automatically, it will list possible supported CPUs, and you can specify the CPU model name by passing the
    --cpu
    option. The target system will reboot after executing the script.
    ./tcc_setup_ssram.sh enable
    This script:
    • Enables cache allocation capabilities on the target system, by configuring a component called real-time configuration manager (RTCM).
    • Adds the real-time configuration driver (RTCD) to auto load.
    • Reserves a portion of cache (software SRAM) sufficent to run the provided samples. Refer to the Select a Cache Partitioning Preset (Public Document) section in the Developer Guide (Public Document) for more information on the preset applied for different Intel® platforms.
    Now the system is configured and software SRAM buffers can be allocated with the cache allocation library.
  5. Wait for the target system to boot.
  6. On the host system
    , connect to the target via SSH. Replace
    <target>
    with the IP address or hostname of the target system.
    ssh root@<target>
  7. In the SSH session
    , run the following commands to verify that the system is configured:
    1. Go to the following directory:
      cd /usr/share/tcc_tools/scripts/setup_ssram/
    2. Verify that the system is configured:
      ./tcc_setup_ssram.sh enable --verify
    3. If the system is configured, you will see the following message:
      [ENABLED ] RTCM [ENABLED ] Driver [ENABLED ] Driver auto-load [VALID ] Cache configuration (from RTCT) SYSTEM CONFIGURATION IS CORRECT
      If you do not see this message, run step 4 again.

Product and Performance Information

1

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