Developer Guide

  • 2022.1
  • 09/08/2022
  • Public
Contents

Configure Software SRAM on Yocto Project* Target

The
./tcc_setup_ssram.sh
script is usually used for initial configuration of your target. See Setup Software SRAM Script for more information about this script. If you did not configure your target system properly or would like to reconfigure the target, follow the steps below to complete the target system configuration.
  1. On the host system
    , go to the
    tools
    directory:
    cd ${TCC_TOOLS_PATH}
  2. Run the Cache Configurator tool to reserve a portion of the L2 and L3 cache:
    1. Open the target connection script. This example uses the nano text editor, but you can use any text editor.
      nano ./host_scripts/target_connection_settings.sh
    2. Modify the following fields (example below):
      Field Name
      Description
      HOSTNAME
      Replace
      hostname
      with the IP address or host name of the target system.
      USER
      Replace
      user
      with
      root
      .
      SSH_EXTRA
      Add any additional SSH command-line options.
      This file contains the hostname and username to connect to the target board through SSH.
      Target connection settings file example:
      HOSTNAME='hostname' USER='user' SSH_EXTRA=''
    3. Save and close the file.
    4. Run the cache configurator tool.
      If you are using a system with UEFI BIOS:
      ./tcc_cache_configurator.py --environment demo/environment/sample_environment_uefi.json
      If you are using a system with Slim Bootloader (SBL):
      ./tcc_cache_configurator.py --environment demo/environment/sample_environment_sbl.json
    5. In the cache configurator tool, enter
      P
      .
    6. Select preset number 4.
    7. Enter
      Y
      to apply the configuration and go to the reboot screen.
    8. After the target system reboots, enter
      Y
      to confirm.
  3. Connect to the target system via SSH. Replace
    <target>
    with the IP address or host name of the target system.
    ssh root@<target>
  4. In the SSH session
    , go to this directory:
    cd /usr/share/tcc_tools/scripts/setup_ssram/
  5. Enable
    RTCM
    in the boot options and set it to the first boot priority on the target system. Real-time configuration manager (RTCM) is an application that makes it possible to use software SRAM technology on non-virtualized systems.
    If you are using a system with UEFI BIOS:
    ./control_rtcm_uefi.sh enable
    If you are using a system with Slim Bootloader (SBL):
    ./control_rtcm_sbl.sh enable
  6. Reboot the target system.
    reboot
Now the system is configured. The software SRAM buffers can be allocated with the cache allocation library.

Product and Performance Information

1

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