Instrumentation APIs
Instrumentation 3-11
3.3.3 Statistics Object Manager (STS Module)
This module manages statistics objects, which store key statistics while a
program runs.
You create individual statistics objects using the Configuration Tool. Each
STS object accumulates the following statistical information about an
arbitrary 32-bit wide data series:
❏ Count. The number of values on the target in an application-supplied
data series
❏ Total. The arithmetic sum of the individual data values on the target in
this series
❏ Maximum. The largest value already encountered on the target in this
series
❏ Average. Using the count and total, the Statistics View Analysis Tool
calculates the average on the host
Calling the STS_add operation updates the statistics object of the data series
being studied. For example, you might study the pitch and gain in a software
interrupt analysis algorithm or the expected and actual error in a closed-loop
control algorithm.
DSP/BIOS statistics objects are also useful for tracking absolute CPU use of
various routines during execution. By bracketing appropriate sections of the
program with the STS_set and STS_delta operations, you can gather real-
time performance statistics about different portions of the application.
You can view these statistics in real time with the Statistics View as shown in
Figure 3-4. To access the Statistics View, select DSP/BIOS
→Statistics View.
Figure 3-4. Statistics View Panel
Comments to this Manuals