Texas Instruments SPRAA56 appendix Running the Application, Load the h263loopbackrta.out program

Page 20

SPRAA56

The application supplied with this note references board support software and libraries installed with the DM642 EVM. The project options assume this software is installed in $TI_DIR$\boards\evmdm642.

The project also references the H.263 encoder algorithm, which is provided as object code with the DM642 EVM’s Board Support Package. Therefore, that package and all its associated components must be installed before running or building the supplied example as delivered.

Tconf scripts have been provided to configure the application provided with this application note. A batch file (makeConfig.bat) is provided to execute tconf on the provided configuration script. Note: The TI_DIR environment variable must be defined and tconf.exe must be in your PATH. These are defined in the DosRun.bat file provided in the CCStudio installation.

While the techniques used in this application are targeted at video applications, several techniques can be used in any embedded DSP application, such as programmatic CPU load measurement and scheduling latency measurement. Further, all the techniques are implemented in C code or in APIs available for multiple TI DSP targets supported by DSP/BIOS, so the concepts presented here are portable to targets other than the platform specified in the requirements list.

5.2Running the Application

1.Copy the h263loopback_rta.zip file to a working directory and extract its contents.

2.Open CCStudio, and open the h263loopback_rta.pjt project.

The project file references all source and object files required to build the executable. Source filenames with “_rta” at the end have been modified for this note. Source filenames without that addition are unchanged from the base H.263 loopback example.

3.Choose the GEL→Reset command to clear any breakpoints and prepare the EMIF and memory map for loading a program.

This command ensures that the DM642 EVM target is in a known stable condition for loading code. The GEL reset command clears up the DSP memory map, initializes the external memory interface, and clears any breakpoints previously set. You can review or change the source code for the GEL reset file if necessary.

4.Load the h263loopback_rta.out program.

5.Start the video input and output devices.

6.Run the application. (Press F5, or choose Debug→Run from the menus.)

A looped back redisplay of the video input should appear on the video output display.

7.Choose File→Load GEL and load the h263RateControl.gel file from the same directory that contains the .pjt file.

This application-specific GEL script allows you to control of the frame rate, bitrate, and other parameters discussed earlier in this application note.

8.Open the following DSP/BIOS RTA tools from the DSP/BIOS menu in CCStudio. Figure 6 shows CCStudio with the following windows open.

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

Page 19 Page 21
Image 20
Page 19 Page 21
Contents Modifications to the Base Example RTA Techniques for Performance MeasurementViewing Benchmarks in the Instrumented Application References Appendix A. Performance ImpactImportant Benchmarks for Video Applications FiguresBase Application Overview SPRAA56TskInput DSP/BIOS and RF5 Components Used 1 LOG4 UTL 2 STS3 TRC Modifications to the Base Example Requirements for Viewing RTA BenchmarksSplitting the Encode and Decode CELLs Adding the Control TSK and MBX CommunicationTskO utput Querying the H.263 Encoder for StatusTskInput Controlling the Frame Rate RTA Techniques for Performance Measurement Measuring Function Execution Time with the UTL ModuleMeasuring Task Scheduling Latencies Measuring End-to-End LatenciesMeasuring the Frame Rate Programmatic Measurement of Total CPU Load Memory Bus Utilization 720*480 = 345,600 B 86,400 B14,400 B External memoryBitrate and Frame Type Methods for Transmitting Measured Performance Data Requirements Viewing Benchmarks in the Instrumented ApplicationApplication-Specific Control via GEL Scripts in CCStudio Running the Application Load the h263loopbackrta.out programSPRAA56 Interpreting the Benchmarks Expected Values for the STS Objects Expected and Measured STS Benchmarks Debug Mode Expected Values Delivered to the Message LogControlling the Run-Time Parameters Dynamically Expected and Measured Logged BenchmarksReferences Capture and Display Task BenchmarkingAppendix A. Performance Impact Overhead of Performance Measurement TechniquesRTA Effects on CPU Load Measured Performance of Benchmarking TechniquesMemory Footprint Memory Footprint DetailsImportant Notice
Top Page Image Contents