Source the provided environment setup scripts. These are unaltered from the original TI distribution.
Building and running the examples only requires the development environment provided in the TI SDK.
Directory minimal contains a minimal example containing just the OAM
boilerplate that can be copied to implement additional test applications.
An example use from command line is provided in every example subdirectory
in <example name>.run.
Calculates clock frequency deviations between host and target. Provided to reveal suspected misconfiguration at platform-level of the DSP system.
Synopsis
Evaluates task cancelation latency from a series of target tasks, reports min/max/mean/sdev.
Target tasks are launched and cancelled asynchronously using C++11 launch policies. Interleaving output from host and target code demonstrate parallel execution.
The comm_async application implements a non-trivial use
case and should yield the most realistic measurements in this application
collection for this purpose.
Executable: comm_async.bin
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Example usage:
$ ./comm_async.bin -b 102400 -hr 200 -tr 10000 -pi 1 -c
Synopsis
Evaluates concurrent execution of two target tasks executed using C++11 asynchronous launch policies.
This test application is supposed to fail as only one target task is allowed for execution on DSP at any time. It has been added to learn the effects and behavior of the OMPACC subsystem in this defect scenario.
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Synopsis
Evaluation of offload overhead (latency, memory, time to completion) depending on work load and image size.
Heavy-load, comparably complex target tasks on actual image data, aimed at a more realistig simulation of work loads and interaction (like memory offloading) of a productive application.
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Synopsis
Evaluation of the target timeout features provided by extension developed by TI as a recent addition to the OMPACC runtime interface.
Executable: poll_cancel.bin
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Synopsis
Demonstrates calling static declared functions and variables local to the target code compilation unit in host code and in target regions.
Executable: static_vars.bin
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Synopsis
Demonstrates combination of global declaration variants such as accessing extern symbols declared in host code from target regions, and vice versa.
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Synopsis
Demonstrates combination of declaration variants such as accessing static symbols declared in host code from target regions, external linkage, accessing symbols in nested declarations etc.
Executable: declare.bin
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Synopsis
Calling a target task implemented in an external library.
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Initialization and resetting symmetric heap after every task iteration. Evaluates performance and stability of reallocating the symmetric heap after every task instead of re-using and only clearing its contents.
Options
-b <buffer size> Bytes to allocate per repetition
-hr <num rep> Number of repetitions at host
-tr <num rep> Number of repetitions at target
-to <ms> Timeout duration of target task in ms
-pi <ms> Polling interval at target task in ms
-c Cancel request after host task completion
Build setup example for building a hybrid OMPAC library (clacl).
Build setup example for building target code in a separate external library.