Developer Guide

  • 2021.1
  • 11/03/2021
  • Public
Contents

Samples

Sample applications are examples of working code that you can run and repurpose for your applications. Samples demonstrate how to use libraries, APIs, and tools.
After installing the Intel® TCC Tools package, you can find sample sources and binaries in the following directories:
Target system:
  • Sample sources:
    /usr/share/tcc_tools/samples
  • Sample binaries:
    /usr/bin
Host system:
  • Sample sources:
    ${TCC_ROOT}/samples/

Samples Documentation

You can find samples documentation in the following locations:
  • This guide:
    • Complete description of the sample
    • How to run the sample (steps for all examples and complete descriptions)
    • Example output
    • Command-line options
  • API Reference:
    • Copy of the sample source
    • Functions in the sample source are linked to function descriptions in the API Reference
  • README in each sample directory on the target system:
    • Short description of the sample
    • How to run the sample (steps for primary examples)
    • Example output
    • Command-line options

Samples List

The following table lists all samples with links to documentation in this guide.
Sample
Description
Language
Demonstrates use of the cache allocation library. Run the sample and see improvements in latency reduction. Copy and modify source code to add the APIs to your real-time application.
C
Sample input files for the data streams optimizer, including a synthetic real-time application and validation script. Use the files to learn how the tool works and see improvements in latency reduction. Copy and modify for your real-time application.
C for real-time application, Python for validation script
Demonstrates how to use the measurement library to instrument one part of an application, such as the entire real-time cycle. Run the sample to see library capabilities, such as collecting execution time (min, max, average, jitter) and deadline monitoring. Copy and modify source code to add the APIs to your real-time application.
C
Demonstrates how to use the measurement library to instrument multiple parts of an application, such as the entire cycle and various parts of it to pinpoint latency sources more precisely. Intended to be run with the measurement analysis sample. Copy and modify source code to add the APIs to your real-time application.
C
Example of a monitoring application that runs on a non-real-time core and analyzes data collected from a real-time application instrumented with measurement library APIs. Run the sample at the same time as the single measurement sample and see it print collected latency measurements and flag deadline violations. Copy and modify source code to tailor the monitoring sample to your real-time application.
C
Profiling application that can analyze data collected from any real-time application instrumented with measurement library APIs. Run the sample to create histograms, monitor measurements, and track deadlines. Ready to use with any instrumented application, or modify it for your needs.
Python
Demonstrates how to start working with TGPIO. Run the info sample to get a report of the TGPIO capabilities of the target system. Run the input and output samples to compare the enhanced precision of hardware-assisted time synchronization vs. normal software-controlled GPIO. Copy and modify source code for your real-time application.
C
Demonstrates more advanced TGPIO input and output scenarios with a logic analyzer, such as input jitter, period jitter, and two-signal synchronization. Run the samples to compare the enhanced precision of hardware-assisted time synchronization vs. normal software-controlled GPIO. Copy and modify source code to add hardware-assisted time synchronization to your real-time application.
C
Demonstrates how to use TGPIO to achieve a desired frequency. Run the sample with a logic analyzer to see how phase error is kept close to zero. Copy and modify source code for your real-time application.
C

Product and Performance Information

1

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