Developer Guide

  • 2021.3
  • 11/18/2021
  • Public
Contents

Configure Software SRAM on Yocto Project* Target

If you did not configure your target with the
./tcc_setup_ssram.sh
script, follow these steps 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. Extra steps for
      Intel® Xeon® W-11000E Series Processors MR1 release only
      with Slim Bootloader (SBL):
      1. Enter
        C
        to continue configuration
      2. Enter
        A
        to add cache allocation
      3. Enter
        C
        for choosing cache level
      4. Enter
        2
        for choosing L2 cache level
      5. Enter
        3
        for choosing CPU core 3
      6. Enter
        262144
        buffer size
    8. Enter
      Y
      to apply the configuration and go to the reboot screen.
    9. 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.