HAW Hamburg

Fakultt TI
Technik und Informatik

Praktikum Digitale Signalverarbeitung

Digital Signal Processing Lab

Department Informations- und Elektrotechnik

Labor fr Signalverarbeitung

Create and Debug a CCSv5 Project

for DSK6713- or DUETT-Board1
1 Start CCSv5 and create a project
Start CCS 5 by double clicking the corresponding icon on the Desktop.
If CCS does not start with the CCS Edit Perspective (see Fig. 1), open this via Window
Open Perspective

Other and doubleclick on CCS Edit (Fig. 2).

Fig. 1: CCS Edit Perspective

Fig. 2: Open Perspective Dialog

Create a new project in D:\ti_work5 with Project

New CCS Project. Fill in the New CCS Project window as shown
in figure 3 and click Finish.
Hint: In the following, c-sourcecode and directory is called
get_started.c and get started.
Note that the folder get_started will be automatically created.
Three project files in this directory contain all project and build
information in ASCII format (comparable to Windows INI-files).
DSK6713.ccxml (Target Configuration File) contains information
about the hardware.
Copy the following files to your project directory .\get_started
from D:\ti_work5\DSK6713\Lab_support_DSK6713:
1. get_started.c (C-Source Code)
2. C6713dsk_AIC23.cmd (Link command file)
3. DSK_vectors_AIC23.asm
4. c6713dskinit.h
for DUETT: from D:\ti_work5\DSK6713\Lab_support_duett:
1. get_started_duett.c
2. C6713_DSK_DUETT.cmd
3. DSK_vectors_DUETT.ASM
4. c6713dsk_DUETT_init.c
Fig. 3: New CCS Project
By refreshing the perspective via <F5> the files appear in the CCS
Project Explorer. Remove via right mouseclick the automatically inserted file main.c from the project. The view should
correspond approximately to Fig. 4.

Note the colored labeling: in case of differences, description is blue for DSK6713, green for DUETT.

Kup 09.13

Digital Signal Processing Lab

Now, two Build Options has to be set. After right mouseclick on the project in CCS Edit Perspective, choose
Properties, in section Build, subsection C6000 Compiler:
I. at Predefined Symbols and via the red encircled button on the right, add: CHIP_6713:

II. at Runtime Model Options choose far for the Data access model:

2 Compile, link and load the project

Connect the DSK6713- and DUETT-Board respectively via USB. Select now Run
Debug (<F11>).
By this command
the inserted files will be compiled,
linked, while the linker is interpreting the file C6713dsk_AIC23.cmd
and an executable file will be created.
The target hardware (DSK6713, DUETT) will be initialised and connected,
the executable file ..\get_started\Debug\get_started.out will be loaded to the board.
The program will be started and stopped at the row main().
The Problems window should not show any error or warning and should not be opened respectively.
After that, youre automatically switched to the Debug Perspective. You can return to the CCS Edit-Perspective via the
buttons on the right top (Fig. 4, encircled in red).

Fig. 4: View after Debug
Run

02.09.2013
2/5

Digital Signal Processing Lab

Run
Resume or <F8> or the corresponding button (Fig. 4, left green arrow in the blue encircled area) starts the
program on the DSP. Youll be asked for input in the Console window.

3 Example program get_started with signal input and output

Using a simple demo program get_started.c and get_started_duett.c respectively you will now program the DSP for
reading an audio signal via the CODEC and output the signal directly. The configuration of CODEC and McBSP is
carried out in the given file c6713dskinit.h / c6713dsk_DUETT_init.h and in the system files dsk6713_aic23.h and
dsk6713.h. The listed functions are implemented in the Board-System Library dsk6713bsl.lib, which will be added
automatically while linking the project.
Usually its not needed to change one of these files!
The desired samplerate has to be set in the variable fs. The following values can be set (Samplerate at the end of the
strings): DSK6713_AIC23_FREQ_8KHZ
DSK6713_AIC23_FREQ_32KHZ
DSK6713_AIC23_FREQ_16KHZ
DSK6713_AIC23_FREQ_24KHZ

DSK6713_AIC23_FREQ_44KHZ
DSK6713_AIC23_FREQ_48KHZ

In fact, DSK6713_AIC23_FREQ_44KHZ workes with Fs=44,1 kHz.

The samplerate has to be set by dividers for 36621 Hz. The default case, div_TIMER0 = 1 and div_TIMER1 = 1 let
work both McBSP at 36,621 kHz. This allocation has to be carried out previous to:
fs_act = SampleRates_DUETT(fs, div_TIMER0, div_TIMER1);
The function MCBSP_read reads 32 bit integer from the ADC, so both channels together. These are buffered in an
union.
Via union_name.both you have access to the whole 32 Bit. An access to each single channel is delivered in
union_name.channel[]. union_name.channel[1] contains the left channel data, the data from the right channel
are stored in union_name.channel[0]. Correspondingly, function MCBSP_write outputs 32 bit integer to the DAC
of the Codec.
The DUETT version contains two interrupt service routines for
both CODECs of PCM3003.

4 The CCS debugging tool

Run
Restart restarts the program and waits at the first row
main().
Run
Resume executes the program, with the Single Stepfunctions stepwise.
Run
Step Over or <F6> executes the program line by line.
View further functions of the Run menu in Fig. 5.
However, this will not produce internal DSP-register changes. If
you wish to reinitialise the internal CPU and peripheral registers,
you must execute Run
Reset
Reset CPU (before reloading
via Run
Debug).
CCS offers excellent debugging possibilities, which will be
introduced step by step. Among others you can:
set and remove breakpoints in the source code
run the program in single-step mode
view mixed source and assembler code
monitor variables
view the content of the DSP register (DSP core
registers, peripheral registers)
view the content of any memory location

Fig. 5: Debug functions (Run menu)

02.09.2013
3/5

Digital Signal Processing Lab

Set a breakpoint right before the line you want to stop the program: place the cursor in front of the line number and
double-click (or mark the line , right mouseclick, Breakpoint
Breakpoint). A blue dot shows the breakpoint. The
program in Fig. 6 run up to the breakpoint. View
Breakpoints shows all breakpoints in a window.
Right mouseclick on the breakpoint, then Breakpoint Properties opens a new window. You can choose as Action,
whether the program should stop (Remain Halted) or e.g. run to the breakpoint again and again and refresh the windows
choosing Update View or Refresh All Windows. This application is needed for graphical displays.
You can set any number of breakpoints in all C or assembler code. Remember that the current position is marked with a
blue arrow. In this way you can run the program piecewise. Individual breakpoints can be removed by double-clicking
on the blue dot. Toggle Breakpoint in the menu (open with right mouseclick), sets or removes the breakpoint,
Disable/Enable Breakpoint can be useful, setting a breakpoint always in the same line.

Fig. 6: Halt at a breakpoint

You can see the Disassembly window (View
Disassembly) in the lower right part of Fig. 6. In this window you can
observe assembly single steps. One or more (in case of parallel processing of statements) blue arrows show the current
position of the program counter.

Fig. 7: Monitoring variables

Fig. 8: View memory in the Memory Browser

To monitor a variable, mark it, right mouseclick, then Add Watch Expression. Alternatively call
View
Expressions, add the variable in the opening window, see. Fig. 7.
You have to suspend the program, if you want to change the variables content.
Right mouseclick on Type allows changing the Number Format, e.g. to hex.
You can also check the value of a variable without using the Expressions window: simply place the mouse arrow on the
variable, and its value (and the start address respectively, if it is a function) is displayed.
View the content of a memory location with View Memory Browser. The Memory Browser opens. Here you can
enter the address like &a in the example in figure 8, click on <Go> and choose the data format, e.g. Hex 32 Bit C
Style.

02.09.2013
4/5

Digital Signal Processing Lab

View Registers opens a new window to observe the registers. Choosing
Core Registers (interne CPU-Register), you can monitor and change the
content of the 32 A and B registers and program counters PC. Further
important registers are the interrupt registers ISTP, IFR, IER and IRP and
the interrupt flag GIE (bit #0 in the CSR, see Fig. 9). Currently changed
register content is highlighted in yellow; to change register content, select
it with a mouseclick.

Further registers can be monitored directly in this window:

Peripheral Registers (for Timer, Interrupt and EMIF) as well as registers
of the serial interfaces McBSP0 and McBSP1, controlling the CODEC.

Fig. 9: View
Registers

Hint (arrange windows in CCS):
A click on the right mousebutton to e.g. the register-tab, then choose Detached, releases the window, so you can move it
freely and group it. Removing the checkmark in front of Detached implants the window in the CCS surface again. You
can drag the subwindows easily to other parts of the CCS surface with the mouse.

02.09.2013
5/5