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:

- Install an Intel® Ethernet Controller I225 on the target board to be tuned or use integrated Time-Sensitive Networking (TSN) Ethernet controller.
- 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).
- Option A: Set up a sequential network connection with Ethernet cable (i.e., without a common network switch or router) as described in (Optional) Set Up a Sequential Network Between Host and Target.
- Option B: Use your choice of network setup. After setting up your network and confirming that the host can connect to the target board via SSH, go to Confirm Real-Time Kernel.
(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).

- [Ubuntu host]Set up the host system:
- On the Ubuntu host, runifconfigto 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
- Go to the following directory:cd /etc/netplan/
- Create a file named00-installer-config.yaml.sudo nano 00-installer-config.yaml
- Insert the following text in the file. Replaceenp0s31f6with your interface. Use the address value shown below.network: ethernets: enp0s31f6: addresses: [192.168.1.3/24] version: 2
- Save and close the file.
- Reboot the system.reboot
- Run ifconfig to make sure there is now an interface with the address 192.168.1.3.
- [Target board]Set up the target board:
- In a terminal window, runifconfigto 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
- Go to the following directory:cd /etc/systemd/network/
- Create a file namedhost_wired.network.vi host_wired.network
- Insert the following text in the file. Replaceenp0s31f6with 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
- Save and close the file.
- Open80-wired.networkin 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 theifconfigcommand to check the name.vi /lib/systemd/network/80-wired.networkChange the name tonullif 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=macExample after changes:[Match] Name=enp0u4 KernelCommandLine=!nfsroot [Network] DHCP=yes [DHCP] RouteMetric=10 ClientIdentifier=macSave and close the file.
- Reboot the system.
- 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.
- From your host system, connect to the target system:ssh <user>@<target>
- In the SSH session, run the following command to runtcc_rt_checker:tcc_rt_checker
- In the output, find theRT Kernel Checkerrow and confirm that it containsRT_READY.+-----+-------------------+--------------------------+----------------------+----------+ | 4 | RT Kernel Checker | Checks that RT kernel is | Current kernel is RT | RT_READY | | | | used | | | +-----+-------------------+--------------------------+----------------------+----------+
- If theRT Kernel Checkerrow does not reportRT_READY, reboot the target system and make sure to select the RT kernel.