Developer Guide

  • 2021.2
  • 06/11/2021
  • Public
Contents

Step 1: MRL Setup

The MRL workload requires the following setup steps.

Set Up the Hardware

Acquire the following recommended hardware configuration:
Units Needed
Equipment Specifications
1
Host system configured according to the Get Started Guide
1
Target board: Target system configured according to the Get Started Guide
1
Integrated Time-Sensitive Networking (TSN) Ethernet controller, or network interface card with Intel® Ethernet Controller I225 series
To set up the hardware:
  1. Install an Intel® Ethernet Controller I225 on the target board to be tuned or use integrated Time-Sensitive Networking (TSN) Ethernet controller.
  2. Make sure the host system can connect to the target board via SSH and static IP address. Use a different network adapter, not the Intel® Ethernet Controller I225 (Time-Sensitive Networking (TSN) Ethernet controller).

(Optional) Set Up a Sequential Network Between Host and Target

You can connect an Ubuntu 20.04 LTS machine (host) and target board with a sequential network connection with Ethernet cable (i.e., without a common network switch or router). You must set a static IP address on each machine (host and target).
  1. [Ubuntu host]
    Set up the host system:
    1. On the Ubuntu host, run
      ifconfig
      to get the interface name of the Ethernet network between the host system and target board (for example,
      enp0s31f6
      ). Make a note of the interface name for later reference.
      ifconfig
    2. Go to the following directory:
      cd /etc/netplan/
    3. Create a file named
      00-installer-config.yaml
      .
      sudo nano 00-installer-config.yaml
    4. Insert the following text in the file. Replace
      enp0s31f6
      with your interface. Use the address value shown below.
      network: ethernets: enp0s31f6: addresses: [192.168.1.3/24] version: 2
    5. Save and close the file.
    6. Reboot the system.
      reboot
    7. Run ifconfig to make sure there is now an interface with the address 192.168.1.3.
  2. [Target board]
    Set up the target board:
    1. In a terminal window, run
      ifconfig
      to get the interface name of the Ethernet network between host system and target board (for example, enp0s20f0u3u2). Make a note of the interface name for later reference.
      ifconfig
    2. Go to the following directory:
      cd /etc/systemd/network/
    3. Create a file named
      host_wired.network
      .
      vi host_wired.network
    4. Insert the following text in the file. Replace
      enp0s31f6
      with your interface name that is used for direct connection to the host system. Use the address value shown below.
      [Match] Name=enp0s31f6 [Network] Address=192.168.1.1/24
    5. Save and close the file.
    6. Open
      80-wired.network
      in the
      /lib/systemd/network/
      directory and change the name field to the name of your external card interface, that is NOT used for direct wired connection to the host (example:
      enp0u4
      ). You can use the
      ifconfig
      command to check the name.
      vi /lib/systemd/network/80-wired.network
      Change the name to
      null
      if you do not have any interfaces to external networks.
      Example before changes:
      [Match] Name=en eth KernelCommandLine=!nfsroot [Network] DHCP=yes [DHCP] RouteMetric=10 ClientIdentifier=mac
      Example after changes:
      [Match] Name=enp0u4 KernelCommandLine=!nfsroot [Network] DHCP=yes [DHCP] RouteMetric=10 ClientIdentifier=mac
      Save and close the file.
    7. Reboot the system.
  3. Confirm that the host system can connect to the target board via SSH.
    ssh root@192.168.1.1

Confirm Real-Time Kernel

Confirm that the target system is running the real-time kernel.
  1. From your host system, connect to the target system:
    ssh <user>@<target>
  2. In the SSH session, run the following command to run
    tcc_rt_checker
    :
    tcc_rt_checker
  3. In the output, find the
    RT Kernel Checker
    row and confirm that it contains
    RT_READY
    .
    +-----+-------------------+--------------------------+----------------------+----------+ | 4 | RT Kernel Checker | Checks that RT kernel is | Current kernel is RT | RT_READY | | | | used | | | +-----+-------------------+--------------------------+----------------------+----------+
  4. If the
    RT Kernel Checker
    row does not report
    RT_READY
    , reboot the target system and make sure to select the RT kernel.

Product and Performance Information

1

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