Intel® Time Coordinated Computing Tools (Intel® TCC Tools) 2021.3 Developer Guide

Developer Guide

  • 2021.3
  • 11/18/2021
  • Public
Contents

Setup

You can run the Ethernet timestamps sample with command-line options. This guide provides examples of commands and outputs. Before running the sample, make sure you have completed the following setup.

Prerequisites

This guide is based on a host-target setup. Confirm that you have a host system and a target system that are configured according to the Get Started Guide for UEFI BIOS or Get Started Guide for Slim Bootloader.

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.

Additional steps for systems with Intel Atom® x6000E Series Processors

Configure PSE GBE1 in BIOS:
  1. Open the BIOS.
  2. Go to
    Intel Advanced Menu
     >
    PCH-IO Configuration
     >
    PSE Configuration
    .
  3. Set
    GBE1
     to
    Host owned with pin muxed
    .
  4. Save your changes and exit the BIOS. The system reboots.
If you are using a system with Slim Bootloader (SBL) instead of UEFI BIOS, no manual BIOS configuration is required because all configuration is done during the SBL build.
Configure the network device:
  1. Go to /etc/udev/rules.d.
  2. Open 99-pci-gbe-sleep.rules with text editor.
  3. Replace all “echo auto” with “echo on”.
  4. Reboot the system.

Build the Sample

The Intel® TCC Tools package for the target system contains a prebuilt binary of this sample. The binary is configured to run from any directory on the target system.
If you want to build the sample, use the provided makefile.

Run the Sample

After completing the setup, run the sample:

Product and Performance Information

1

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