Texas Instruments TMS320C3 Series User manual

TMS320C3x
Evaluation Module
Installation
Guide
1993 Microprocessor Development Systems

Printed in U.S.A., November 1993, reprinted April 1998
SDS SPRU120

TMS320C3x
Evaluation Module
Installation Guide
SPRU120
November 1993
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 of an appropriate TIofficer.
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 1997, Texas Instruments Incorporated

WARNING
Thisequipmentisintendedforuseinalaboratorytestenvironmentonly. It generates, uses, and
canradiateradiofrequencyenergyandhasnotbeentestedforcompliancewiththelimitsofcom-
putingdevicespursuant to subpart J of part 15 of FCC rules, which are designed to provide rea-
sonableprotectionagainstradiofrequencyinterference.Operationofthisequipmentinotheren-
vironmentsmaycauseinterferencewithradiocommunications,inwhichcasetheuserathisown
expensewillberequiredtotakewhatevermeasuresmayberequiredtocorrectthisinterference.
TRADEMARKS
MS-DOS and MS-Windows are registered trademarks of Microsoft Corp.
PC-DOS is a trademark of International Business Machines Corp.

Installing the Evaluation Module and the C Source Debugger
1
Installing the Evaluation Module
and the C Source Debugger
ThisguidehelpsyouinstalltheTMS320C3xevaluationmodule(EVM)andthe
C source debugger on a PC running MS-DOS or PC-DOS. You can also use
the debugger with MS-Windows. When you complete the installation, turn to
the
TMS320C3x C Source Debugger User’s Guide.
Topic Page
1. What You’ll Need 2
Hardware checklist 2
Software checklist 3
2. Step 1: Installing the EVM Board in Your PC 4
Preparing the EVM board for installation 4
Setting the EVM board into your PC 5
3. Step 2: Installing the Debugger Software 7
4. Step 3: Setting Up the Debugger Environment 7
Invoking the new or modified batch file 8
Modifying the PATH statement 8
Setting up the environment variables 9
Identifying the correct I/O switches 10
5. Step 4: Verifying the Installation 11
Installation error messages 12
6. Using the Debugger With MS-Windows 12

What You’ll Need
2
1. What You’ll Need
The following checklists detail items that are shipped with the ’C3x C source
debugger and EVM and additional items you’ll need to use these tools.
Hardware checklist
host An IBM PC/AT or 100% compatible ISA/EISA-based PC with a
hard-disk system and a 1.2-Mbyte floppy-disk drive
memory Minimum of 640K bytes; in addition, if you are running under
MS-Windows, you’ll need at least 256K bytes of extended memory.
display Monochrome or color (color recommended)
slot One 8- or 16-bit slot
EVM board
power requirements Approximately 1 ampere @ 5 volts (5 watts)
optional hardware A Microsoft-compatible mouse
AnEGA-orVGA-compatiblegraphicsdisplaycardandalargemon-
itor. The debugger has several options that allow you to change the
overall size of the debugger display. If you have an EGA- or
VGA-compatible graphics card, you can take advantage of some of
theselargerscreensizes.Theselargerscreensizesaremosteffec-
tive when used with a large (17” or 19”) monitor. (To use a larger
screen size, you must invoke the debugger with an appropriate op-
tion.Formoreinformationaboutoptions,refertotheinvocationsec-
tionin Chapter1,
Overviewof aCodeDevelopment and Debugging
System
, in the TMS320C3x C Source Debugger User’s Guide. )
miscellaneous
materials Blank, formatted disks
To minimize the risk of electric shock and fire hazard, be sure that
all major components that you interface with Texas Instruments
devices are limited in energy and certified by one or more of the
following agencies: UL, CSA, VDE, or TUV.

What You’ll Need
3 Installing the Evaluation Module and the C Source Debugger
Software checklist
operating system MS-DOS or PC-DOS (version 3.0 or later)
Optional: MS-Windows (version 3.0 or later)
software tools TMS320floating-pointfamilyDSP(’C3x/’C4x)assemblerandlinker
Optional: TMS320C3x/C4x C compiler
required files † evmrst.exe resets the EVM
optional files † init.cmd is a file that contains debugger commands. The version of
this file that’s shipped with the debugger defines a ’C3x memory
map. If this file isn’t present when you invoke the debugger, then all
memory is invalid at first. When you first start using the EVM, this
memory map should be sufficient for your needs. Later, you may
wanttodefineyourownmemory map.Forinformation aboutsetting
up your own memory map, refer to Chapter 5,
Defining a Memory
Map,
in the TMS320C3x C Source Debugger User’s Guide.
†
init.clr is a general-purpose screen configuration file. If this file isn’t
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
screenconfiguration,refer toChapter9,
CustomizingtheDebugger
Display,
in the TMS320C3x C Source Debugger User’s Guide .
†Included as part of the debugger package

Step 1: Installing the EVM Board in Your PC
4
2. Step 1: Installing the EVM Board in Your PC
This section contains the hardware installation information for the EVM.
Preparing the EVM board for installation
Before you install the EVM board, you must be sure that the board’sswitches
aresettocorrectlyidentifytheI/Ospacethattheboardcanuse.The’C3xEVM
board has four switches:
- Switches 1 and 2 identify your system’s I/O address space. You can
change these switch settings to identify the I/O address space that the
EVM uses in your system.
- Switches 3 and 4 are for manufacturing test.
Leave these switches in the
default positions.
Figure 1showswhere theseswitchesareonthe EVMboard andidentifiesthe
switch numbers.
Figure 1. EVM Board I/O Switches
123 4
on
off
’C3x EVM
default switch settings
Switches are shipped in the default settings shown here and described in
Table 1.IfyouuseanI/Ospacethatdiffersfromthedefault,changetheswitch
settings for switches 1 and 2. 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 ’C3x EVM I/O address space does not
conflict with other bus settings. For example, if you’ve installed a bus mouse
in your system, you may not be able to use the default switch settings for the
I/O address space—the mouse might use this space. Refer to your PC
technical reference manual and your other hardware-board manuals to see if
there are any I/O space conflicts. If you find a conflict, use one of the settings
in Table 1
.

default
Step 1: Installing the EVM Board in Your PC
5 Installing the Evaluation Module and the C Source Debugger
Table 1. EVM Board Switch Settings
Switch #
Address Range 1 2
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
Setting the EVM board into your PC
To minimize risk of personal injury, always turn off the power to all
computer-system components and unplug power cords.
After you’ve prepared the EVM board for installation, follow these steps.
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 8-bit or 16-bit slot.
Step 4: Install the EVM board in an 8-bit or 16-bit slot (see Figure 2).
Step 5: Tighten down the mounting bracket.
Step 6: Replace the PC cover.
Step 7: Plug in the power cord and turn on the PC’s power.

Step 1: Installing the EVM Board in Your PC
6
Figure 2. EVM Board Installation
mounting bracket
EVM board
16-bit slot
8-bit slot
rear of computer
—or—

Step 2: Installing the Debugger Software / Step 3: Setting Up the Debugger Environment
7 Installing the Evaluation Module and the C Source Debugger
3. Step 2: Installing the Debugger Software
This section explains the simple process of installing the debugger software
on a hard-disk system.
1) Make a backup copy of the DOS and/or MS-Windows debugger product
disk. (If necessary, refer to the DOS manual that came with your comput-
er.)
2) On your hard disk or system disk, create a directory named
c3xhll. This
directory will contain the ’C3x C source debugger software. To create this
directory, enter:
MD C:\C3XHLL
3) Inserteitherthe DOS or MS-Windows debugger product disk into drive A.
Copy the contents of the disk.
COPY A:\*.* C:\C3XHLL\*.* /V
Repeatthisstepfortheotherproductdiskifyouwanttobeabletorunboth
the DOS and MS-Windows versions of the debugger.
TheDOSversionofthedebuggerexecutableiscalledevm30.exe,andthe
MS-Windows version of the debugger executable is called evm30w.exe.
Throughout this document, the executable for the debugger is referred to
as simply evm30.
4. Step 3: Setting Up the Debugger Environment
To ensure that your debugger works correctly, you must:
- Modify the PATH statement to identify the c3xhll directory.
- Define environment variables so that the debugger can find the files it
needs.
- Identify any nondefault I/O space used by the EVM.
Not only must you do these things before you invoke the debugger for the first
time, you must do them any time you power up or reboot your PC.
You can accomplish these tasks by entering individual DOS commands, but
it’s simpler to put the commands in a batch file. You can edit your system’s
autoexec.bat file; in some cases, modifying the autoexec may interfere with
otherapplicationsrunningonyourPC.So,ifyouprefer,youcancreateasepa-
rate batch file that performs these tasks.

Step 3: Setting Up the Debugger Environment
8
Figure 3 (a) shows an example of an autoexec.bat file that contains the sug-
gested modifications (highlighted in bold type). Figure 3
(b) shows a sample
batchfilethatyoucouldcreateinsteadofeditingtheautoexec.batfile.(Forthe
purpose of discussion, assume that this sample file is named
initdb.bat .) The
subsections following the figure explain these modifications.
Figure 3. DOS-Command Setup for the Debugger
(a) Sample autoexec.bat file to use with the debugger and EVM
DATE
TIME
ECHO OFF
PATH=C:\DOS;C:\C3XTOOLS;C:\C3XHLL
SET D_DIR=C:\C3XHLL
SET D_SRC=;C:\C3XCODE
SET D_OPTIONS=–P 280
CLS
PATH statement
Environment
variables and
I/O space
(b) Sample initdb.bat file to use with the debugger and EVM
PATH=C:\C3XHLL;%PATH%
SET D_DIR=C:\C3XHLL
SET D_SRC=C:\C3XCODE
SET D_OPTIONS=–P 280
PATH statement
Environment
variables and
I/O space
Invoking the new or modified batch file
- If you modify the autoexec.bat file, be sure to invoke it before invoking the
debugger for the first time. To invoke this file, enter:
AUTOEXEC
- If you create an initdb.bat file, you must invoke it before invoking the
debuggerforthefirsttime.IfyouareusingMS-Windows,invokeinitdb.bat
before enteringMS-Windows.You’llneedtoinvokeinitdb.batanytimethat
you power-up or reboot your PC. To invoke this file, enter:
INITDB
Modifying the PATH statement
Define a path to the debugger directory. The general format for doing this is:
PATH=C:\C3XHLL
This allows you to invoke the debugger without specifying the name of the di-
rectory that contains the debugger executable file.

Step 3: Setting Up the Debugger Environment
9 Installing the Evaluation Module and the C Source Debugger
- If you are modifying an autoexec that already contains a PATH statement,
simplyinclude ;C:\c3xhll at the endofthe statement as shown in Figure 3
(a) .
- If you are creating an initdb.bat file, use a different format for the PATH
statement:
PATH=C:\C3XHLL;%PATH%
The addition of ;%path% ensures that this PATH statement won’t undo
PATH statements in any other batch files (including the autoexec.bat file).
Setting up the environment variables
An environment variable is a special system symbol that the debugger uses
for finding or obtaining certain types of information. The debugger uses three
environmentvariables,namedD_DIR,D_SRC,andD_OPTIONS.Thefollow-
ing tells you how to set up these environment variables. The format for doing
this is the same for both the autoexec.bat and initdb.bat files.
- Set up the D_DIR environment variable to identify the c3xhll directory:
SET D_DIR=C:\C3XHLL
(Be careful not to precede the equal sign with a space.)
This directory contains auxiliary files (evmrst, evminit.cmd, etc.) that the
debugger needs.
- Set up the D_SRC environment variable to identify any directories that
containprogramsourcefilesthatyou’llwanttolookatwhileyou’redebug-
ging code. The general format for doing this is:
SET D_SRC=
pathname
1
;pathname
2
...
For example, if your ’C3x programs were in a directory named c3xsrc on
drive C, the D_SRC setup would be:
SET D_SRC=C:\C3XSRC
- Youcanuseseveral optionswhenyouinvokethedebugger.Ifyou usethe
same options over and over, it’s convenient to specify them with
D_OPTIONS. The general format for doing this is:
SET D_OPTIONS= [
object filename ] [ debugger options ]
This tells the debugger to load the specified object file and use the speci-
fiedoptionseachtimeyouinvokethedebugger.Thesearetheoptionsthat
you can identify with D_OPTIONS:
–b –bb –i
pathname
–p port address – s –t filename
–profile –v

Step 3: Setting Up the Debugger Environment
10
NotethatyoucanoverrideD_OPTIONSbyinvokingthedebuggerwiththe
–x option.
For more information about options, refer to the invocation section in
Chapter 1,
Overview of a Code Development and Debugging System , in
the
TMS320C3x C Source Debugger User’s Guide.
Identifying the correct I/O switches
Refer to your entries in Table 2 (page 5). If you didn’t modify the I/O switches,
skip this step.
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 nondefault I/O switch
setting and the appropriate line that you can add to the autoexec.bat or
initdb.bat file.
Table 3. Identifying Nondefault I/O Address Space
switch # Add this line to the
Address Range 1 2 batch file
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
Notes:
1) The ’C3x EVM uses 96 bytes of the PC I/O space.
2) Ifyou didn’tnotethe I/O switchsettings, you mayuse a trial-and-errorap-
proachtofindthecorrect–psetting.If you usethe wrong setting,you’ll
see this error message when you try to invoke the debugger:
CANNOT INITIALIZE THE EVM ! !
– Check I/O configuration
3) Neverreset the’C3x EVMwithevmrst unlessyou havefirstloaded avalid
object file to the EVM.

Step 4: Verifying the Installation
11 Installing the Evaluation Module and the C Source Debugger
5. Step 4: Verifying the Installation
To ensure that you have correctly installed the EVM and debugger software,
enter this command at the system prompt:
evm30 c:\c3xhll\sample
You should see a display similar to this one:
DISASSEMBLY CPU
MEMORYCOMMAND
>>>
PC 00f00076
R0 00000003
R2 00000007
R4 00000000
R6 00000000
AR0 00001802
AR2 00000000
AR4 00000000
AR6 00000000
IR0 00000000
ST 00000000
RS 00000000
DP 00000000
IE 00000000
SP 00000755
R1 00000005
R3 00000000
R5 00000000
R7 00000000
AR1 00000000
AR3 00000000
AR5 00000000
AR7 00000000
IR1 00000000
RC 00000000
RE 00000000
BK 00000000
IF 00000000
f00075 00f000b2 ABSI 178,DP
f00076 087000f0 c_int00: LDI 240,DP
f00077 08340074 LDI @074H,SP
f00078 080b0014 LDI SP,AR3
f00079 087000f0 LDI 240,DP
f0007a 08280075 LDI @075H,AR0
f0007b 04e8ffff CMPI –1,AR0
f0007c 6a05000c BZ f00089
f0007d 08412001 LDI *AR0++(1),R1
f0007e 6a250008 BZD f00089
f0007f 08492001 LDI *AR0++(1),AR1
f00080 08402001 LDI *AR0++(1),R0
f00081 18610001 SUBI 1,R1
f00082 139b9991 RPTS R1
f00083 da002120 LDI *AR0++(1),R0 || STI
000000
000004
000008
00000c
000010
000014
0000004b
00000043
00000047
00000000
00000000
00000000
00000040
00000044
00000048
00000000
00000000
00000000
00000041
00000045
00000049
00000000
00000000
00000000
00000042
00000046
0000004a
00000000
00000000
00000000
TMS3203x Debugger
Copyright (c) 1989, 1993 Texas In
TMS320C3x
Loading sample.out
Done
Load Break Watch Memory MoDe Run=F5 Step=F8 Next=F10Color Pin
- If you see a display similar to this one, you have correctly installed your
EVM and debugger.
- If you see a display and the lines of code show ADD instructions or say
Invalid address , your EVM board may not be installed snugly. Check your
board to see if it is correctly installed, and re-enter the command above.
- Ifyoudon’tseeadisplay,thenyourdebuggerorboardmaynotbeinstalled
properly.Gobackthroughtheinstallationinstructionsandbesurethatyou
have followed each step correctly; then re-enter the command above.

Step 4: Verifying the Installation / Using the Debugger With MS-Windows
12
Installation error messages
While invoking the debugger, you may see the following message:
CANNOT INITIALIZE THE EVM ! !
– Check I/O configuration
To determine the problem, follow these actions:
- Check the EVM board to be sure it is installed snugly.
- Ensure that your port address is set correctly:
J Check to be sure the –p option used with the D_OPTIONS environ-
mentvariablematchestheI/Oaddressdefinedbyyourswitchsettings
(refer to
YourSwitch Settings , Table 2, and IdentifyingNondefaultI/O
Address Space
, Table 3).
J Check to see if you have a conflict in address space with another bus
setting. If you have a conflict, change the switches on your board to
one of the alternate settings in Table 1. Modify the –p option of the
D_OPTIONSenvironmentvariabletoreflectthechangeinyourswitch
settings.
6. Using the Debugger With MS-Windows
If you’re using MS-Windows, you can freely move or resize the debugger dis-
playon the screen. Iftheresized display is biggerthanthe 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 can’t be scrolled.
You may want to create an icon to make it easier to invoke the debugger from
within the MS-Windows environment. Refer to your MS-Windows manual for
details.
YoushouldrunMS-Windowsineitherthestandardmodeorthe386enhanced
mode to get the best results.

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 and complete.
TI warrants performance of its semiconductor products and related software to the specifications applicable at
the time of sale in accordance with TI’s standard warranty. Testing and other quality 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. Use of TI
products in such applications requires the written approval of an appropriate TI 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 represent that any license, either
express or implied, is granted under any patent right, 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 1998, Texas Instruments Incorporated