Introduction
Code Composer provides a rich debugging environment that allows you to step through your code, set breakpoints, andexamine registers as your code executes. This document provides a brief introduction to some of these debuggingfeatures.
Debugging code
Controlling program flow
Breakpoints are points in the code where execution is stopped and control of the DSP is returned to the debugger,allowing you to view the contents of registers and memory. Breakpoints can be activated or deactivated bydouble-clicking on any line of code in the disassembly window.
You may also want to step through your program code, executing one line at a time, to follow branches and watchmemory change with the results of calculations. This can be done by choosing the "Step Into" or "Step Over" menu optionsfrom the "Debug" pull-down menu. (Unlike "Step Over," "Step Into" traces subroutine calls caused by "call" opcodes.)
Like most DSPs, the DSP we are using is a pipelined
processor, which means that instructions execute in severalstages over several clock cycles. Unfortunately, our
debugger does not "flush" the pipeline of all currentinstructions when it halts your program; i.e., the DSP does
not execute all remaining stages of instructions. As aconsequence, when a program halts, the register values shown
in the register and memory windows may not actually the lastvalues written. Often, the values shown correspond to
values written several cycles before the currentinstruction. If it is necessary to know the exact contents
of the registers at any particular point in the programflow, simply insert three or more
nop
(no
operation) instructions into your program after theinstruction in question. Then, to debug, execute the
instruction in question and the
nop
instructions that follow; this will flush the pipeline.
You can choose the "Run Free" option from the "Debug" pull-down menu to allow the your code to run freely,ignoring any breakpoints. The code will continue running until explicitly halted with the "Halt" command.
Note that stopping and restarting execution sometimes confuses the A/D and D/A converters on the six-channelsurround-sound board. If this happens, the output will generally go to zero or become completely unrelated to theinput signal. This can be fixed by simply resetting the DSP and starting your code from the beginning.
The bar on the left-hand side of the Code Composer Studio window contains shortcuts for many of the commands in theDebug menu.
WAITDATA
call and tracing through the program
flow for several iterations of the FIR filter code. Whatcode does the
WAITDATA
call correspond to in
the disassembly window?Troubleshooting
The DSP boards can behave unexpectedly. If there is no output, try the following (from less to more drastic):
- Use the Debug menu to halt and reset the DSP, verify
that the
PMST
is set to0xFFE0
, reload the code, reset the DSP, and restart the code. - Press the "Reset" button on the DSP evaluation board,
then use the Code Composer Studio menus to halt, reset theDSP, verify the
PMST
, reload, reset the DSP again, and restart your code. - Close Code Composer Studio, then
power-cycle the DSP by unplugging power to
the DSP board, waiting five seconds, and plugging it backin. Then restart Code Composer Studio. You will need to
reset the
PMST
to0xFFE0
, then reload, reset the DSP, and execute your code.
If problems persist after power-cycling the DSP, ensure that
the DSP board is functioning properly by executing previouslyverified code. Do not forget to set the
PMST
and
to reset the DSP from the Code Composer Studio menu.
If you try all of these steps and still see problems, ask ateaching assistant for help.