2.1 C programming lab

Skills

This laboratory deals with compiling and running a C program on the TMS320C6713 DSP using Code Composer Studio. By the end of the laboratory you will be able to:

• Compile and build a C language program
• Run a C language program on the TMS320C6713 DSP
• Link multiple files with functions into one project

Reading

• SPRU 187: Optimizing C Compiler
• C programming reference card

Description

If you have forgotten how to program in C/C++ you should review C programming on the many tutorials on the internet or look through your favorite textbook or reference book. This document will not give you a tutorial on how to program in C/C++.

You must remember that when programming the TI DSP you are loading your program into a system that has its own DSP and memory and is apart from your computer. In order for you to print anything, the data must be sent from the DSP board to CCS and then displayed in the stdio display. This can be very slow so you will want to use the debugging tools to view variables.

In this lab you will be writing very simple C programs. If you want to print something you will obviously need to include the stdio.h file.

Your main program should look like:

Be sure to use good programming style.

Pre-laboratory

Write a C program that performs a dot product of the following vectors. The data for a and b should be stored in integer arrays. Use a for loop.

a = [1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30]

b = [30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1]

Laboratory

Part 1

• In this part you will create a project that performs the array multiply and sum within the main function of the program. In order to be able to accurately count clock cycles, use the C6713 simulator.
• Create a new project, call it clab.
• Create your C file. Call it main.c . Add this file to your project.
• You should use the following options for the project (Project->Build Options):
• After the project has been loaded, record the values in the variables at each step as you single step through the program. Count the number of clock cycles and compare to the assembly program completed in a previous lab. Be sure to zero the counter before stepping through your code.

Part 2

• In this part you are going to write a function that performs an array multiply and sum algorithm and returns the sum. This function will be located in another file and you will also make a header file.
• Create a C file called multsum.c . In this file make a function called multsum . The function should have as inputs:

• pointer to integer array a
• pointer to integer array b
• number of elements in the arrays
• The output of the function should be the integer sum. The function should perform the multiply and sum algorithm.

• Create a header file for the multsum function and call it multsum.h . In the header include the following code:

This uses some compiler directives to determine if the current header file has already been included by another include file. The macro _MULTSUM_H_ is not defined the first time it is encountered so the macro is defined and the definition is included. The extern keyword tells the compiler that the function is defined in another file.

• In main.c :

• include the multsum.h file

• declare the a and b arrays
• call the multsum function with the sum returned to a variable

• Include the multsum.c file in your project.
• Run the program and verify that the sum that is returned is correct.