Instrumentation APIs
3-28
Note: Updating Task Statistics
If TSK_deltatime is not called by a task, its statistics will never be updated
in the Statistics Data tool, even if TSK accumulators are enabled in the RTA
Control Panel.
TSK statistics are handled differently than other statistics because TSK
functions typically run an infinite loop that blocks while waiting for other
threads. In contrast, HWI and SWI functions run to completion without
blocking. Because of this difference, DSP/BIOS allows programs to identify
the "beginning" of a TSK function's processing loop by calling TSK_settime
and the "end" of the loop by calling TSK_deltatime.
You can enable and disable these trace bits in the following ways:
❏ From the host, choose Tools > RTA > RTA Control Panel from the
CCStudio menu bar. This panel allows you to adjust the balance between
information gathering and time intrusion at run time. By disabling various
implicit instrumentation types, you lose information but reduce the over-
head of processing.
❏ From the target code, enable and disable trace bits using the
TRC_enable and TRC_disable operations, respectively. For example,
the following C code disables tracing of log information for software
interrupts and periodic functions:
TRC_disable(TRC_LOGSWI | TRC_LOGPRD);
For example, in an overnight run you might be looking for a specific
circumstance. When it occurs, your program can perform the following
statement to turn off all tracing so that the current instrumentation
information is preserved:
TRC_disable(TRC_GBLTARG);
Any changes made by the target program to the trace bits are reflected in the
RTA Control Panel. For example, you could cause the target program to
disable the tracing of information when an event occurs. On the host, you can
simply wait for the global target enable check box to be cleared and then
examine the log.
To Next Page
Loading...
Need help?
General
