Texas Instruments TMS320 User Manual page 83

3.5.3 Statistics Object Manager (STS Module)
This module manages statistics objects, which store key statistics while a
program runs.
You configure individual statistics objects statically. 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 Data 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 Data tool. To
access the Statistics Data tool, choose Tools > RTA > Statistics Data from
the CCStudio menu bar.
Instrumentation APIs
Instrumentation 3-21