Texas Instruments TMS320C5 Series User manual

TMS320C5x
Evaluation Module
Getting
Started Guide
1996 Digital Signal Processing Solutions

Printed in U.S.A., September 1996
2617559-9741 revision A SPRU126C

TMS320C5x Evaluation Module
Getting Started Guide
SPRU126C
September 1996
Printed on Recycled Paper

IMPORTANT NOTICE
Texas Instruments (TI) reserves the right to make changes to its products or to discontinue any
semiconductor product or service without notice, and advises its customers to obtain the latest
version of relevant information to verify, before placing orders, that the information being relied
on is current.
TIwarrantsperformanceofitssemiconductorproductsandrelatedsoftwaretothespecifications
applicableatthetimeofsaleinaccordancewithTI’sstandardwarranty.Testingandotherquality
control techniques are utilized to the extent TI deems necessary to support this warranty.
Specific testing of all parameters of each device is not necessarily performed, except those
mandated by government requirements.
Certain applications using semiconductor products may involve potential risks of death,
personal injury, or severe property or environmental damage (“Critical Applications”).
TI SEMICONDUCTOR PRODUCTS ARE NOT DESIGNED, INTENDED, AUTHORIZED, OR
WARRANTED TO BE SUITABLE FOR USE IN LIFE-SUPPORT APPLICATIONS, DEVICES
OR SYSTEMS OR OTHER CRITICAL APPLICATIONS.
Inclusion of TI products in such applications is understood to be fully at the risk of the customer.
UseofTIproducts in such applications requires the written approval ofanappropriateTI officer.
Questions concerning potential risk applications should be directed to TI through a local SC
sales office.
In order to minimize risks associated with the customer’s applications, adequate design and
operating safeguards should be provided by the customer to minimize inherent or procedural
hazards.
TI assumes no liability for applications assistance, customer product design, software
performance, or infringement of patents or services described herein. Nor does TI warrant or
representthatanylicense,eitherexpressorimplied,isgrantedunderanypatentright,copyright,
mask work right, or other intellectual property right of TI covering or relating to any combination,
machine, or process in which such semiconductor products or services might be or are used.
Copyright 1996, Texas Instruments Incorporated

v Chapter Title—Attribute Reference
WARNING
Thisequipmentisintendedforuseinalaboratorytestenvironmentonly.It generates, uses, and
can radiate radio frequency energy and has not been tested for compliance with the limits of
computing devices pursuant to subpart J of part 15 of FCC rules, which are designed to provide
reasonableprotectionagainstradiofrequencyinterference.Operationofthisequipmentinother
environments may cause interference with radio communications, in which case the user at his
own expense will be required to take whatever measures may be required to correct this
interference.
TRADEMARKS
Microsoft, MS-DOS, and Windows are registered trademarks of Microsoft Corporation.
PC and PC-DOS are trademarks of International Business Machines Corporation.
Pentium is a trademark of Intel Corporation.

vi

1
Installing the EVM and the Debugger
This book helps you install the TMS320C5x evaluation module (EVM) C
source debugger on a PC running MS-DOS t , PC-DOS t , or Windows t
Whenyoucompletetheinstallation,turn tothe
TMS320C5xCSourceDebug-
ger User’s Guide.
Topic Page
1 System Requirements 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 Preparing the EVM Board for Installation 4. . . . . . . . . . . . . . . . . . . . . . . . . .
3 Placing the EVM Board Into Your PC 6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4 Installing the Debugger Software 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5 Setting Up the Debugger Environment 8. . . . . . . . . . . . . . . . . . . . . . . . . . . .
6 Verifying the Installation 12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7 Using the Debugger With Windows 3.1 14. . . . . . . . . . . . . . . . . . . . . . . . . .

System Requirements
2
1 System Requirements
To install and use the ’C5x EVM and C source debugger, you need the items
listed in the following hardware and software checklists.
Hardware requirements
Host 32-bit x 86-based or Pentium t PC with a hard-disk system and
a CD-ROM drive.
Memory Minimumof640Kbytes;inaddition,ifyouarerunningunderWin-
dows 3.x, you will need at least 256K of extended memory.
Display Monochrome or color monitor (color recommended)
Slot One 16-bit slot
EVM board
power requirements Approximately 1.5 amperes @ 5 volts (15 watts)
Optional hardware Microsoft t -compatible mouse
EGA- or VGA-compatible graphics display card and a large (17”
or19”) monitor.The debugger has several options that allow you
tochangetheoverallsizeofthedebuggerdisplay.Tousealarger
screen size, you must invoke the debugger with an appropriate
option. For more information about options, see the invocation
section in the
TMS320C5x C Source Debugger User’s Guide.

System Requirements
3 Installing the EVM and the Debugger
Software requirements
Operating system MS-DOS or PC-DOS (version 3.0 or later)
Optional: Windows (version 3.0 or later)
Software tools TMS320 fixed-point family DSP (’C1x/’C2x/’C2xx/’C5x) assembler
and linker
Optional: TMS320C2x/’C2xx/’C5x C compiler
Required files
included with the
debugger package
evmrst.exe resets the EVM
Optional files
included with the
debugger package
evminit.cmd is a file that contains debugger commands that define
a ’C5x memory map. When you first start using the EVM, this
memory map should be sufficient for your needs. Later, you may
wanttodefine yourownmemorymap.For informationaboutsetting
up your own memory map, see the
TMS320C5x C Source Debug-
ger User’s Guide.
init.clr isageneral-purposescreenconfigurationfile.Ifthisfileisnot
present when you invoke the debugger, the debugger uses the de-
fault screen configuration.
The default configuration is for color monitors; an additional file,
mono.clr , can be used for monochrome monitors. When you first
starttousethedebugger,thedefaultscreenconfigurationshouldbe
sufficient for your needs. Later, you may want to define your own
custom configuration.
For information about these files and about setting up your own
screen configuration, see the TMS320C5x C Source Debugger
User’s Guide.

Preparing the EVM Board for Installation
4
2 Preparing the EVM Board for Installation
The EVM board has two switches that identify your system’s I/O address
space. Before you install the EVM board, you must be sure that the board’s
switchesare set to correctly identify the I/O space that the board can use. You
can change these switch settings to identify the I/O address space that the
EVM uses in your system.
Figure 1showswhere theseswitchesare ontheEVMboardand identifiesthe
switch numbers.
Figure 1. EVM Board I/O Switches
1 2
on
off
Default switch settings
’C5x
’C5x EVM
The switches are shipped in the default settings shown here and described in
Table 1.IfyouuseanI/Ospacethatdiffersfromthedefault,changetheswitch
settings. Table 1 shows you how to do this.
In most cases, you can leave the switch settings in the default position.
However, you must ensure that the EVM I/O address space does not conflict
withotherbussettings.Forexample,ifyouhave installedasoundcard inyour
system, you may not be able to use the default switch settings for the I/O
address space—the sound card might use this space.
See your PC technical reference manual and your other hardware-board
manuals to determine if there are any I/O space conflicts. If you find a conflict,
use one of the settings in Table 1
.

Preparing the EVM Board for Installation
5 Installing the EVM and the Debugger
Table 1. EVM Board Switch Settings
Switch #
Address Range 1 2
default 0x0240–0x025F on on
0x0280–0x029F on off
0x0320–0x033F off on
0x0340–0x035F off off
Some of the other installation steps require you to know which switch settings
youused.IfyouresettheI/Oswitches,notethemodifiedsettingshereforlater
reference.
Table 2. Your Switch Settings
Switch #
Address Range 1 2

Placing the EVM Board Into Your PC
6
3 Placing the EVM Board Into Your PC
After you have prepared the EVM board for installation, follow these steps to
place it into your PC.
Minimizing Personal Injury
To minimize the risk of personal injury,
always turn off the power
to your PC and unplug the power cord before installing the EVM
board.
Step 1: Turn off your PC’s power and unplug the power cord.
Step 2: Remove the cover of your PC.
Step 3: Remove the mounting bracket from an unused 16-bit slot.
Step 4: Carefully but firmly push the EVM board into a 16-bit slot (see
Figure 2).
Step 5: Return the mounting screw to the mounting bracket and tighten the
screw (see Figure 2).
Step 6: Replace the PC cover.
Step 7: Plug in the power cord for your PC and turn on the PC’s power.
Figure 2. Placing the EVM Board Into Your PC
mounting bracket
EVM board
16-bit slot
rear of computer
mounting screw

Installing the Debugger Software
7 Installing the EVM and the Debugger
4 Installing the Debugger Software
Thissection explains how to install the debugger software on ahard-disk sys-
tem for two different operating systems:
- DOS
- Windows 3.1
Installing the debugger on DOS systems
To install the debugger on a DOS system, follow these steps:
1) Insert the debugger CD-ROM into your CD-ROM drive.
2) Change to the CD-ROM drive (replace
d with the letter of your CD-ROM
drive):
d:
3) Enter the following command:
install
4) Follow the on-screen instructions.
Installing the debugger on Windows 3.1 systems
To install the debugger on a Windows 3.1 system, follow these steps:
5) Insert the debugger CD-ROM into your CD-ROM drive.
6) Start Windows 3.1.
7) From the File menu, select Run.
8) In the dialog box, enter the following command (replace
d with the letter
of your CD-ROM drive):
d:\setup.exe
9) Click on OK.
10) Follow the on-screen instructions.

Setting Up the Debugger Environment
8
5 Setting Up the Debugger Environment
You can define environment variables that set certain debugger parameters
younormally use.An environmentvariable isasystem symbolthat youdefine
and assign to a string. When you use environment variables, default values
are set, making each individual invocation of the debugger simpler because
these parameters are automatically specified.
The debugger uses environment variables for finding or obtaining certain
typesofinformation.Theinstallationprogrameithersetsupthefollowingenvi-
ronment variables or you can do it manually:
SET PATH=C:\c5xhll ; %PATH%
SET D_DIR=C:\c5xhll
SET D_SRC=C:\c5xhll
If you choose not to have the environment variables set up for you, you can
modify your autoexec.bat file to include the SET commands above.
The remainder of this section describes these environment variables and
other variables that you can define.
Identifying the directory that contains the executable files (PATH statement)
You must include the debugger directory in your PATH statement. This allows
you to specify the debugger executable without specifying the name of the
directory that contains the executable file.
- If you modify your autoexec.bat file to change the path information, add
the following to the end of the PATH statement:
;C:\c5xhll
- If you create your own batch file, use this format:
SET PATH=C:\c5xhll;%PATH%
Donotprecedetheequalsignwithaspace.Theadditionof;%PATH%en-
suresthatthisPATHstatementdoesnotundothePATHstatementsinany
other batch files (including the autoexec.bat file).
Identifying alternate directories for the debugger (D_DIR variable)
The debugger uses the D_DIR environment variable to name alternative
directories that contain auxiliary files (evmrst, evminit.cmd, etc.) that the
debugger needs. The command for assigning the environment variable is as
follows:
SET D_DIR=C:\c5xhll
Do not precede the equal sign with a space.

Setting Up the Debugger Environment
9 Installing the EVM and the Debugger
Identifying directories that contain source files (D_SRC variable)
Thedebugger uses the D_SRCenvironmentvariable to name directoriesthat
contain program source files The command for assigning the environment
variable is as follows:
SET D_SRC= pathname1; pathname 2 . . .
Do not precede the equal sign with a space. The pathnames are directories
thatcontainprogramsourcefiles.Youcanseparatepathnameswithasemico-
lon or with blanks.
Setting default debugger options (D_OPTIONS variable)
Youmightfind it usefultoset default debuggeroptions using theD_OPTIONS
environmentvariable.WhenyouuseD_OPTIONS,thedebuggerusestheop-
tionsorinput filenames that you specify every time you run the debugger.The
command for assigning the environment variable is as follows:
SET D_OPTIONS=[ object filename ] [ debugger options ]
Donotprecedethe equalsignwith aspace.This tellsthedebugger toloadthe
specified object file and use the specified options each time you invoke the
debugger. These are the options that you can identify with D_OPTIONS:
Option Brief Description
–b[b] Select the screen size
–i pathname Identify additional directories for source files
–min Select the minimal debugging mode
–p
port address Identify the port address (see Identifying the correct I/O
switches on page 10)
–profile Enter profiling environment
–s Load the symbol table only
–t
filename Identify a new initialization file
–v Load without the symbol table
Notethat you can override D_OPTIONS by invoking the debuggerwith the –x
option.
For more information about options, see the invocation instructions in the
TMS320C5x C Source Debugger User’s Guide .

Setting Up the Debugger Environment
10
Identifying the correct I/O switches
See your entries in Table 2 on page 5. If you did not modify the I/O switches,
skip this subsection.
Ifyou modified the I/O switch settings, you must use the debugger’s –p option
to identify the I/O space that the EVM is using. You can do this each time you
invoke the debugger, or you can specify this information by using the
D_OPTIONS environment variable. Table 3 lists the I/O switch settings and
the appropriate line that you can add to the autoexec.bat file.
Table 3. Identifying I/O Address Space
Switch #
Address Range 1 2Add This Line
0x0240–0x025F on on None needed. This is the default value.
0x0280–0x029F on off SET D_OPTIONS=–p 280
0x0320–0x033F off on SET D_OPTIONS=–p 320
0x0340–0x035F off off SET D_OPTIONS=–p 340
Note: I/O Address Space
1) The ’C5x EVM uses 96 bytes of the PC I/O space.
2) If you did not note the I/O switch settings, you may use a trial-and-error
approach to find the correct –p setting. If you use the wrong setting, you
will see this error message when you try to invoke the debugger:
CANNOT INITIALIZE THE EVM ! !
– Check I/O configuration

Setting Up the Debugger Environment
11 Installing the EVM and the Debugger
Running other host applications
If you plan to use the EVM for running other host applications (for example, a
modem), you must first load a valid object file into the EVM. To do this, invoke
the debugger and load the object file:
evm5x
filename
Once you have entered the debugging environment and the object file has
been loaded, exit the debugger:
quit
At the DOS prompt, reset the EVM by entering the evmrst command:
evmrst
Ifyou modified the I/O switch settings, you must use the debugger’s –p option
to identify the I/O space that the EVM is using. You can do this each time you
reset the EVM, or you can specify this information by using the D_OPTIONS
environment variable (the evmrst command reads your autoexec.bat or in-
itdb.batfile).YoucanoverrideD_OPTIONSbyenteringevmrstfollowedbythe
–x option.
Notes:
- Never reset the ’C5x EVM with evmrst unless you have first loaded a
valid object file to the EVM.
- If you plan to use the debugger with the EVM, you do not need to reset
the EVM with evmrst before invoking the debugger.

Verifying the Installation
12
6 Verifying the Installation
To ensure that you have correctly installed the EVM and debugger software,
enter this command at the system prompt:
evm5x c:\c5xhll\sample
You should see a display similar to this one:
DISASSEMBLY
MEMORYCOMMAND
>>>
TMS320C5x EVM
Loading sample.out
34 Symbols loaded
Done
ACC 0000005f
ACCB 01ff01ff
PREG 00000005
PC 20cf TOS 005d
AR0 08ab AR1 08ac
AR2 08a5 AR3 00a3
AR4 00a4 AR5 0807
AR6 08a4 AR7 00a7
ST0 2610 ST1 cdfc
PMST 0038 TIM 249d
IMR 01ff IFR 0008
DBMR 0000 BMAR 5555
INDX 08ab TRG0 0001
TRG1 ffe1 TRG2 fff1
SPCR 0800 TCR 0000
20cf bf08 c_int0: LAR AR0,#08a1h
20d1 bf09 LAR AR1,#00a1h
20d3 bf00 SPM 0
20d4 be47 SETC SXM
20d5 bf80 LACC #2143h
20d7 b801 ADD #1
20d8 e388 BCND 20dch,EQ
20da 7a89 CALL 20e0h,*,AR1
20dc 7a89 CALL main,*,AR1
20de 7a89 CALL abort,*,AR1
20e0 bf80 LACC #2143h
20e2 8bc00 LDP #0
20e3 a680 TBLR *
20e4 b801 ADD #1
20e5 028a LAR AR2,*,AR2
0000 0000 0000 0000 0000 01ff ff00 0008 0038
0008 0000 0000 20f1 20f3 0001 ffe1 fff1 0000
0010 08ab 08ac 08a5 00a3 0004 0807 08a4 00a7
0018 08ab 08ab 0000 0000 0000 0000 ff77 5555
0020 0000 0000 0000 0000 249d ffff 0000 0000
0028 ffff ffff 000f 0000 0000 0000 0000 0000
Load Break Watch Memory MoDe Run=F5 Step=F8 Next=F10Color
CPU
Analysis
- If you see a display similar to this one, you have correctly installed your
EVM and debugger.
- IfyouseeadisplayandthelinesofcodeshowADDinstructions,yourEVM
board may not be installed snugly. Check your board to determine if it is
correctly installed, and reenter the command above.
- If you see a display and the lines of code say Invalid address or the fields
in the MEMORY window are shown in red, the debugger may not be able
to find the evminit.cmd file. Check for the file in the directories specified
bythe D_SRCenvironment variableorensure thatthe fileisin thecurrent
directory. Reenter the command above.
- If you do not see a display, then your debugger or board may not be
installed properly. Go back through the installation instructions and be
sure that you have followed each step correctly; then reenter the com-
mand above.

Verifying the Installation
13 Installing the EVM and the Debugger
Installation error messages
While invoking the debugger, you may see the following message:
CANNOT INITIALIZE THE EVM ! !
– Check I/O configuration
One or several of the following conditions may be the cause:
- Is the EVM board installed snugly?
- Did you use the –p option? Is your port address set correctly?
J Ensurethe–poptionusedwiththeD_OPTIONSenvironmentvariable
matchestheI/Oaddressdefinedbyyourswitchsettings.Forinforma-
tion about the switch settings, see Section 2, Preparing the EVM
Board for Installation
, on page 4.
J Determineifyouhaveaconflictinaddressspacewithanotherbusset-
ting.Ifyouhaveaconflict,changetheswitchesonyourboardtooneof
the alternate settings. Modify the –p option of the D_OPTIONS envi-
ronment variable to reflect the change in your switch settings.
After you have checked the above, repeat the verification instructions (see
Section 6,
Verifying the Installation , on page 12).

Using the Debugger With Windows 3.1
14
7 Using the Debugger With Windows 3.1
Ifyou are using Windows 3.1, youcanfreely move or resize thedebuggerdis-
playon the screen. Iftheresized display is biggerthan the debugger requires,
the extra space is not used. If the resized display is smaller than required, the
display is clipped. Note that when the display is clipped, it cannot be scrolled.
Youshould runWindows3.1 ineither thestandard modeorthe 386enhanced
mode to get the best results.