TMS320VC33 DSP STARTER KIT (DSK) QUICK START GUIDE

Version 2.02

SOFTWARE INSTALLATION
1) Go to step 3 if installing from the CD

2) If installing from the web, download DSK3Vxxx.ZIP where xxx is the version (where 202=ver 2.02) to a
directory of your choosing and unzip its contents. Normally there will be a self-expanding executable and a
README file with any last minute information.

3) Please refer to the README file for the latest information.

4) Run DSK3Vxxx.EXE and follow the prompts. The DSK3 tools are nominally installed to the root of a
drive. For example, if you install to drive F: you would enter F:\ for the destination. The resulting directory
structure will then put the DSK3 executables in F:\DSK3\DSK3

5) Modify AUTOEXEC.BAT for the COFF C/ASM Code Generation Tools as shown. This will set the
appropriate environment variables and path statements to the DSK3 and TI-COFF Code Generation tools.
Otherwise you will need to run everything from the main DSK3 tools directory.

rem Contents of SETENV.BAT

rem
rem The default DSK3 executable directory is X:\DSK3\DSK3
rem where X: is the drive you installed to
rem
set C_DIR=.;C:\tic3x4x\include;C:\tic3x4x\lib;
set A_DIR=.;C:\tic3x4x\include;C:\tic3x4x\lib;
PATH=%PATH%;C:\TIC3X4X\BIN;C:\DSK3\DSK3;

Additional information for the TI-COFF C/ASM code generation tools can be found in.
TMS320C3x/C4x Optimizing C Compiler Users Guide , SPRU034
TMS320C3x/C4x Assembly Language Tools Users Guide, SPRU035

6) If you are installing to a Windows NT/2000/XP operating system (Win9x users can skip this step), install
one of the following two drivers.

DLPORTIO.DLL
Install using PORT95NT.EXE from Scientific Software Tools website
http://www.driverlinx.com

INPOUT32.DLL
Install from Lakeview Research (Parallel Port Complete) web site.
http://www.lvr.com

THESE DRIVERS ARE INSTALLED AT THE KERNEL LEVEL. THEREFORE YOU MUST HAVE
ADMINISTRATIVE PRIVILEGES TO PROPERLY INSTALL THEM

Note: These drivers are not written by or licensed to Texas Instruments but can be downloaded free of
charge. You are obligated to abide by the rules and conditions set forth by the respective authors or
companies

7) You can run BUIDASM.BAT in the main DSK3 directory at any time to recopy and build the TI supplied
example code. This will overwrite any modifications you may have made.

8) If you wish, you can also copy the files from the directory images on the CD. However, the attributes of
these files will be marked as read only.

9) Use Windows Explorer (or equivalent) to open the DSK help file DSK3HELP.HLP. This help file contains
this installation information, plus a huge library of DSK hardware and software information and applications.
HARDWARE INSTALLATION
1) Connect the DSK to your PC's parallel printer port using the supplied printer cable

2) Connect the supplied power jack to the TMS320VC33 DSK.For the TMS320VC33 DSK, you MUST
connect a 5V power supply (supplied) to the DSK's input power jack. An over voltage condition can damage
this board! The TMS320C33 DSK does not include on board full wave rectification or 5V regulation.

The LED should light up but could be red or green (this is explained later, but it depends on the state of the
DSP's timer output pins).

Verifying the Host Port Interface Works

Use Windows Explorer, command prompt or other means to select one of the DSK3 applications. You will
probably want to use DSK3DW.EXE for the first application.

If you have everything connected, the simplest way to verify the setup is to execute DSK3DW.EXE (or one
of the other applications). If the correct port has been selected and the correct power source applied to the
board you should see the LED cycling RED-YELLOW-GREEN-YELLOW-RED, followed by the application
startup.

Does DSK3DW.EXE start - Yes -> you are done

DSK3DW does not start
DSK3DW is intermittent
Do the LED colors cycle
- Try another port
- Check supply for low voltage
- Check supply for low voltage
- Yes -> comm/debug kernel has loaded
- No -> pick another port

Selecting a Printer Port Mode

This DSK will work with either standard (8 xmit/4 recv) or bi-directional (8 xmit/4 recv) printer ports making
the initial setup very easy. Simply make sure the printer port is enabled in BIOS. Note: Some
manufacturers label their ports opposite to the industry standard. The important part is that the printer port
addresses match.

You will also find that almost any printer port setup will be backward compatible to the standard 8/4 modes.
For 8/8 bi-directional mode you will need to set your PC's Printer Port setup to either bi-directional, or in
some cases ECP or EPP (this varies somewhat between manufacturers).

Quick Tour
Initial Command File CMDBUF.TXT
The first time you bring up DSK3DW, the default command file CMDBUF.TXT will contain most of the
commands needed to run the getting started examples. You may want to familiarize yourself with these
before changing the content of that file. When you are confident you understand how the command window
works, use the menu pull down File->Save or the command 'CSAVE' to save the file.

RAND.DSK and RAND.ASM Example

The first two commands, 'RESET' and 'CB' (clear breakpoints) clear out any previous states that the DSK
may be in and can be skipped. Next, use the command 'LOAD RAND' in the command window to load the
file.

RAND.ASM is a very simple program written using the DSK assembler. This program is a simple random
number generator within two nested loops. This code shows stack and data page initialization, loop
counters and other simple features that will help you move on to your own DSK programs.

SAMPLE2.OUT C/HLL Example

Use the command 'LOAD SAMPLE2.OUT' in the command window to load the file. This will load the file
with the program counter pointing to c_int00. c_int00 is an assembly routine that initializes the C
environment and not the beginning of the function "void main(void)".

To step over c_int00, use the command 'GO main'. The GO command argument 'main' is then cross
referenced in the symbol table to find the address of the function 'main'. You could also enter the address,
but this is probably unknown. Here are some ways to look up the value of main.

Create a linker map file, and look there

Execute the command '?main' in the command window
Use the "Options"->"Show Symbols" pulldown to view the loaded symbols

Open two new windows from the Windows pulldown. One for .bss global variables and one for local frame
variables. The windows that are opened are memory windows whose display settings are configured to
track the .bss and stack areas of memory. The local and global variable display windows are useful in
seeing how the C compiler allocates and passes variables to and from functions. Note also that if you
highlight and right click on a variable in the call stack you can modify that value, affecting functions higher up
in the call stack. You should see something like this

FFT_RR5.ASM/DSK Graphical Example

Use the command 'LOAD FFT_RR5' in the command window to load the file. You will get a dialog box
telling you that some information embedded in the executable has been found. After this the source should
pop up.

Use the window pulldown to open a graphical display window. A dialog box will pop up asking you to accept
some settings. For now, just push the enter key to accept them.

Use the 'F5' key to run up to the first embedded graphical breakpoint. You should now see a sine wave. As
you hit the run key global variables that control the display are being updated by the application, causing the
sine wave display to change. The data itself is not changing. After 8 runs the FFT result pops up. You can
use the L/R and shift+L/R to move around and expand the display.

Use the Debug->Animate BP pulldown to update in a continuous loop

Notes:
The graphical display properties, where the data is, how many data points there are, what kind of data it is
and scaling are being controlled by global variables (memory locations) within the applications data space
on the DSK. In this case, these locations are being read back by the graph window each time a new paint is
requested. The locations are identified by the symbol name and their locations are being extracted by
DSK3DW through the symbol table.

A vertical bar will also be present in the graphical window. The data in the banner will be what is being
selected by this bar. Use the left mouse button to move the bar around, or if the application is being
animated, you can use the left/right arrow keys on the keyboard.

If you right click the graph you will be prompted for the start address and length to plot. Values can be
entered in numeric or symbolic fashion (discussed later). If you got here by accident, the defaults will be for
the present display (so simply accept the defaults).

PAR_EQ.OUT C/HLL and Host Control Example

NOTE: This example works with the PCM3003 stereo codec. The application comes pre-built for the
TMS320VC33 DSK but it will also work with the C31 DSK and PCM3003 Analog Interface Board (AIB) after
you make a few small changes in the source file. If you don't have either configuration, you will not be able
to hear anything and running the code will eventually result in a hung process. You can however run up to
main and step into the code a bit, but more importantly you can test the controls.

Use the command 'LOAD PAR_EQ.OUT' in the command window to load the file. You can do a 'go main' at
this point.

Use the window pulldown to open two host control windows. One is for the left channel, and the other the
right channel.

Open a .bss memory window, which is where the control values are located.
Connect a line level input (+/-3Vpp max) to the input jack and pair of headphones to the output jack and click
on the RUN/STOP button. The headphone level may be low but still audible (if needed add an external
headphone amplifier). Also, if you do not have a line level signal handy, install the microphone enable
jumpers.

Each control button is connected to a different frequency band in the equalizer. Clicking in the left/right side
of the control buttons will make the value go up or down while clicking in the middle will open a dialog box.
As with the graph window, global variables are being connected to the slider control button.