Introduction This is a brief tutorial over Code Composer Studio which is a programming environment used to implement various algorithms and load code onto a DSP. If you would like a more in-depth tutorial, please feel free to click on Help -->Tutorial in Code Composer.

Starting Code Composer Studio Before starting, it would be a good idea to create a folder where you will be saving your project files. Label the folder ELEC424_Tutorial. To open Code Composer Studio in a Windows 2000 system, click on Start and select Programs --> Texas Instruments --> Code Composer Studio DSK Tools 2 (‘C2000) --> Code Composer Studio.

You should see the following screen:

Creating a File To create a new source code file, click on File --> Source File. A window titled ‘Untitled1’ will appear within the Composer environment:

You can double-click on the ‘Untitled1’ window to make it larger. To save your file, click on File --> Save. The following prompt will appear:

There are several Save as type… options. Choose the appropriate one for your code. It will give your file the proper file extension. It is also lets the linker know when you compile your code what kind of language the file is written in. When you are done, click Save.

Creating a New Project After you have finished creating the files you need to run on the DSP, you will now want to create a project that will include all the files. Select Project --> New… The following prompt will appear:

Fill in the project name in Project Name. Browse to the folder you created for the project in Location. Make sure you select Executable (.out) in Project Type, and select TMS320C28XX in Target. When you are done, click Finish. Example.pjt will appear in the left-hand side of the Composer environment. Click on the ‘+’ to expand the project:

Before expanding project After expanding project

Adding New Files to the Project In order to add new files, select Project --> Add Files to Project… The following prompt will appear:

Select the file you want to add. To make it easier, you can narrow your search of a particular file by choosing which type of file you want in the Files of type… When you are done, click Open. You should now see the file after clicking on the ‘+’ in the left-hand window:

Compiling Files and Building Projects Once you have added all the files you want to be included in your project, you will now need to build your project. Select Project --> Rebuild All. You should see the following window at the bottom of the Code Composer Studio Environment:

If there are errors in your code, they will be listed with the corresponding line numbers. Correct them and rebuild your project.

Loading/Reloading Programs After your code has been successfully compiled and built, you must now load your program onto the DSP. Select File --> Load Program… You will see the following prompt dialog:

When you rebuild your project, Code Composer Studio is set at default to create a new folder in your directory called Debug. This is where the executable file is created. Double-click on the Debug folder and you should see your *.out file:

After you select your file, click Open.

Executing, Halting, or Stopping Your Program To execute your program, select Debug --> Run or press the F5 key:

Your program will then begin to run. You will see the following at the bottom left-hand corner of the Code Composer Studio environment:

To stop running your code, select Debug --> Halt:

You should then see the following at the bottom left-hand corner of the work environment:

To resume running your code, press the F5 button.

Debugging Your Code Since there are few of us that can get our code working right the first time, you will probably have to debug your code. To figure out what could be wrong, there are several methods you can use to break the problem down.

Setting Breakpoints To execute your code a little at a time or to stop it after a certain point, you can place breakpoints. You can do this by placing the cursor on the line you want to set the breakpoint on, highlighting it by clicking once, and double-click. You should see a solid red circle on the left:

You can set as many as you like. Rebuild and reload the program. Execute it. The DSP will stop at the first breakpoint. To get to the next breakpoint, press the F5 button to run the DSP again. To remove the breakpoint(s), place the cursor on the line, highlight it by clicking once, and double-click. The solid red circle should disappear:

Watching Variables To see what values your variables, constants, and/or registers are getting, you can view them in a watch window. Select View --> Watch Window. You should see the following appear in the Code Composer Studio environment:

Click on the ‘Watch 1’ tab:

To add a variable, double-click on the row under the ‘Name’ column:

Type in the name of the variable and press the Enter key:

You can change the base of the value by clicking on the ‘Radix’ column and selecting how you want to view the value.

Profiling Sessions You can benchmark your code by profiling a session. To do this, you can set one breakpoint at the line where you want the counter to start counting and another breakpoint at where to stop. Select Profiler --> Start New Session… You will see the following dialog:

Type in a name for your profile session and click OK. A window will appear at the bottom:

To profile a function, you need to add it to the profile session you just created. Double-click on the file you want to do this in, and place the cursor on any line inside the function and right click. Choose Profile Function --> in (session-name) Session. Execute the code. When the CPU stops, click on the ‘Functions’ tab to see the result of the profiling.

Counting Clock Cycles If you just want to count the cycles and do not need all the stats from profiling, you can just view the clock. SelectProfiler --> View Clock:

The following window should appear at the bottom:

After setting up your breakpoints, reset the PC to start at the beginning of your code by selecting Debug --> Reset. Run your code. Clear the clock by double-clicking on it, and then run it again. The number of clock cycles will appear in the clock window.

Troubleshooting If you are having any trouble, sometimes it is best to reset the CPU. You can do this by selecting Debug --> Restart CPU. You will have to reload the program. Another option is to simply quit Code Composer Studio by selecting File --> Quit and restart the application.