Debugging and troubleshooting in code composer

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.

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 to 0xFFE0 , 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 to 0xFFE0 , 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.