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
T exas 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.
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 . T esting 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 1996, Texas Instruments Incorporated
WARNING
This equipment is intended for use in a laboratory test environment only . 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
reasonable protection against radio frequency interference. Operation of this equipment in other
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.
Chapter Title—Attribute Reference
v
vi
Installing the EVM and the Debugger
This book helps you install the TMS320C5x evaluation module (EVM) C
source debugger on a PC running MS-DOSt, PC-DOSt, or Windows
When you complete the installation, turn to the
ger User’s Guide.
TMS320C5x C Source Debug-
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. . . . . . . . . . . . . . . . . . . . . . . . . .
t
1
System Requirements
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 Pentiumt PC with a hard-disk system and
Memory Minimum of 640K bytes; in addition, if you are running under Win-
Display Monochrome or color monitor (color recommended)
Slot One 16-bit slot
a CD-ROM drive.
dows 3.x, you will need at least 256K of extended memory.
EVM board
Approximately 1.5 amperes @ 5 volts (15 watts)
power requirements
Optional hardware Microsoftt-compatible mouse
EGA- or VGA-compatible graphics display card and a large (17”
or 19”) monitor. The debugger has several options that allow you
to change the overall size of the debugger display . T o use a larger
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.
2
Software requirements
Operating system MS-DOS or PC-DOS (version 3.0 or later)
Software tools TMS320 fixed-point family DSP (’C1x/’C2x/’C2xx/’C5x) assembler
Required files
included with the
debugger package
Optional files
included with the
debugger package
System Requirements
Optional: Windows (version 3.0 or later)
and linker
Optional: TMS320C2x/’C2xx/’C5x C compiler
evmrst.exe
evminit.cmd
resets the EVM
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
want to define your own memory map. For information about setting
up your own memory map, see the
TMS320C5x C Source Debug-
ger User’s Guide.
init.clr
is a general-purpose screen configuration file. If this file is not
present when you invoke the debugger, the debugger uses the default screen configuration.
The default configuration is for color monitors; an additional file,
mono.clr
, can be used for monochrome monitors. When you first
start to use the debugger, the default screen configuration should be
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.
Installing the EVM and the Debugger
3
Preparing the EVM Board for Installation
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
switches are set to correctly identify the I/O space that the board can use. Y ou
can change these switch settings to identify the I/O address space that the
EVM uses in your system.
Figure 1 shows where these switches are on the EVM board and identifies the
switch numbers.
Figure 1. EVM Board I/O Switches
’C5x EVM
’C5x
on
Default switch settings
off
1 2
The switches are shipped in the default settings shown here and described in
T able 1. If you use an I/O space that dif fers from the default, change the switch
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
with other bus settings. For example, if you have installed a sound card in your
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
4
.
Table 1. EVM Board Switch Settings
default 0x0240–0x025F on on
Some of the other installation steps require you to know which switch settings
you used. If you reset the I/O switches, note the modified settings here for later
reference.
Table 2. Your Switch Settings
Address Range 1 2
Preparing the EVM Board for Installation
Switch #
Address Range 1 2
0x0280–0x029F on off
0x0320–0x033F off on
0x0340–0x035F off off
Switch #
Installing the EVM and the Debugger
5
Placing the EVM Board Into Your PC
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,
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 screw
mounting bracket
rear of computer
always
turn off the power
6
EVM board
16-bit slot
4 Installing the Debugger Software
This section explains how to install the debugger software on a hard-disk system 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.
Installing the Debugger Software
2) Change to the CD-ROM drive (replace
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
of your CD-ROM drive):
d:\setup.exe
9) Click on OK.
d
with the letter of your CD-ROM
d
with the letter
10) Follow the on-screen instructions.
Installing the EVM and the Debugger
7
Setting Up the Debugger Environment
5 Setting Up the Debugger Environment
You can define
environment variables
that set certain debugger parameters
you normally use. An environment variable is a system symbol that you define
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
types of information. The installation program either sets up the following environment 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)
Y ou must include the debugger directory in your P ATH 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 P ATH=C:\c5xhll;%P ATH%
Do not precede the equal sign with a space. The addition of ;%P ATH% ensures that this P ATH statement does not undo the P A TH statements in any
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.
8
Setting Up the Debugger Environment
Identifying directories that contain source files (D_SRC variable)
The debugger uses the D_SRC environment variable to name directories that
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
that contain program source files. Y ou can separate pathnames with a semicolon or with blanks.
Setting default debugger options (D_OPTIONS variable)
Y ou might find it useful to set default debugger options using the D_OPTIONS
environment variable. When you use D_OPTIONS, the debugger uses the options or input filenames that you specify every time you run the debugger. The
command for assigning the environment variable is as follows:
SET D_OPTIONS=[
Do not precede the equal sign with a space. This tells the debugger to load the
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
object filename
Identify additional directories for source files
] [
debugger options
pathnames
]
are directories
–min Select the minimal debugging mode
–p
port address
–profile Enter profiling environment
–s Load the symbol table only
–t
filename
–v
Identify the port address (see
switches
Identify a new initialization file
Load without the symbol table
on page 10)
Identifying the correct I/O
Note that you can override D_OPTIONS by invoking the debugger with the –x
option.
For more information about options, see the invocation instructions in the
TMS320C5x C Source Debugger User’s Guide
Installing the EVM and the Debugger
.
9
Setting Up the Debugger Environment
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.
If you 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. Y ou 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
Address Range 1 2 Add This Line
Switch #
0x0240–0x025F
0x0280–0x029F on off SET D_OPTIONS=–p 280
0x0320–0x033F off on SET D_OPTIONS=–p 320
0x0340–0x035F
on on None needed. This is the default value.
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
10
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. T o do this, invoke
the debugger and load the object file:
Setting Up the Debugger Environment
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
If you 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. Y ou 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 initdb.bat file). Y ou can override D_OPTIONS by entering evmrst followed by the
–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.
Installing the EVM and the Debugger
11
Verifying the Installation
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:
Load Break Watch Memory MoDe Run=F5 Step=F8 Next=F10Color
DISASSEMBLY
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
MEMORYCOMMAND
TMS320C5x EVM
Loading sample.out
34 Symbols loaded
Done
>>>
-
If you see a display similar to this one, you have correctly installed your
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
Analysis
CPU
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
EVM and debugger.
-
If you see a display and the lines of code show ADD instructions, your EVM
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
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
by the D_SRC environment variable or ensure that the file is in the current
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 command above.
12
Invalid address
or the fields
Installation error messages
While invoking the debugger, you may see the following message:
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
J
Verifying the Installation
CANNOT INITIALIZE THE EVM ! !
– Check I/O configuration
Ensure the –p option used with the D_OPTIONS environment variable
matches the I/O address defined by your switch settings. For information about the switch settings, see Section 2,
Board for Installation
, on page 4.
Preparing the EVM
Determine 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. Modify the –p option of the D_OPTIONS environment 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).
Installing the EVM and the Debugger
13
Using the Debugger With Windows 3.1
7 Using the Debugger With Windows 3.1
If you are using Windows 3.1, you can freely move or resize the debugger display on the screen. If the resized display is bigger than 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.
Y ou should run Windows 3.1 in either the standard mode or the 386 enhanced
mode to get the best results.
14
Loading...