User's Manual

SPRAA56

DSP/BIOS Real-Time Analysis (RTA) and Debugging Applied to a Video Application 19

The benchmarking routines send out selected benchmark data at a prescribed interval: every

frame, every I (Intracoded) frame, or only on a dropped frame. The interval can be selected

by controlling the .rtaMode variable within the control structure.

Benchmark data is transmitted to the CCStudio on the host PC via RTDX (Real-Time Data

eXchange), which is used behind the scenes by the DSP/BIOS RTA tools. RTDX allows Code

Composer Studio to read from or write to target buffers in DSP addressable memory at run-time.

For example, the UTL_logDebug2 API command use RTDX to move two variables and a

message to the Message Log window available from the DSP/BIOS menu in CCStudio.

Although the channel used in this example is the standard debugging connection, data could be

sent over any channel with sufficient bandwidth to an endpoint where you can view the data. For

example, the benchVideoProcRta data structure could be sent over Ethernet in a networked

encoder or decoder application to provide statistics to a third-party receiving application.

The current size of the debug structure is small (defined in Appendix A), so sending the structure

once every 30 frames would introduce a negligible load on the system and the network, yet

could still provide useful information at that rate.

4.10 Application-Specific Control via GEL Scripts in CCStudio

As mentioned earlier, run-time control is provided by the h263rateControl.gel script. The menu

item controls in the script allow you to manipulate the global benchVideoProcRta structure from

the host PC.

menuitem "Rate Control --bitrate-framerate";

slider setFrameRate(0, 30, 1, 1, framerate)

{

controlVideoProc.frameRateChanged = 1;

controlVideoProc.frameRateTarget = framerate;

}

For details on the GEL language and its functions, see the “Using the Integrated Development

Environment” section of the Code Composer Studio online help.

5 Viewing Benchmarks in the Instrumented Application

Now that we have described the available benchmarks, this section tells how to measure those

benchmarks while running the application.

5.1 Requirements

To run the application supplied with this note, you need the following components:

• DM642 EVM and Board Support Package

• CCStudio v2.21 or greater

• JTAG emulator

• Input video source – composite or S-Video

• Video display – composite or S-Video