Texas Instruments CDT370 User manual

CDT370
Addendum to the TMS370 Family C Source Debugger
User's Guide
1993 Microprocessor Development Systems
Addendum

Printed in U.S.A., October 1993; reprinted July 1995
2656911–9761 revision B SPNU133

CDT370 Addendum
to the TMS370 Family
C Source Debugger
User's Guide
SPRU133
July 1995
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.
UseofTI products in such applicationsrequiresthe written approval of anappropriateTI 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 1995, Texas Instruments Incorporated

iii Read This First
Read This First
About This Manual
ThisbooktellsyouhowtoinstallandusetheCDT370(CompactDevelopment
Tool)andexplainsthesimilaritiesanddifferencesbetweenthedebuggerused
with the CDT370 and the debugger that is described in the
TMS370 Family C
Source Debugger User’s Guide
.
Information About Cautions
This book contains cautions.
This is an example of a caution statement.
A caution statement describes a situation that could potentially
damage your software or equipment.
The information in a caution is provided for your protection. Please read each
caution carefully.
FCC 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
testedfor compliancewiththe limits ofcomputingdevices pursuanttosubpart
Jofpart15ofFCC rules,whicharedesignedtoprovidereasonableprotection
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
iv
Trademarks
PC-DOS is a trademark of International Business Machines.
MS-DOS and Windows are trademarks of Microsoft Corporation.

Contents
v Contents
Contents
1 Introduction 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1 About the CDT370 Board 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.2 About the Target Cable Set 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 Getting Started 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.1 System Hardware Requirements 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 System Software Requirements 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.3 Unpacking The CDT370 Board 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.4 Add-On PC Connection 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.5 Serial RS-232 Connection 2-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.6 Software Installation 2-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.7 Using the Debugger With Microsoft Windows 2-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.8 Power-Up Procedure 2-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.9 Invoking the Debugger 2-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.10 Exiting the Debugger 2-21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 Trace 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1 Trace and Timing 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Trace Commands 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 Differences Between XDS/22 BTT and CDT370 Trace 3-7. . . . . . . . . . . . . . . . . . . . . . . . . . .
4 Programming 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1 Programming a Device (the P Command) 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2 Action Selection 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.3 Memory Type Selection 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.4 Validation Dialog Box 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.5 Messages 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5 Autotest 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6 Clock Source 6-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7 Defining a Memory Map 7-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1 Memory Mapping Introduction 7-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2 Memory Mapping 7-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3 Copying Data Within the On-Board RAM 7-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents
vi
8 Target Cables 8-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.1 Target Cables Description 8-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.2 Switches Description 8-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.3 Installing the Target Cable in the Emulator 8-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.4 Connecting the Target Cable to the Target System 8-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.5 How to Use the Target Cable 8-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9 CDT370 Repair Guide 9-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1 The Debugger Menu Doesn’t Display 9-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2 The CDT370 Does Not Function 9-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3 The Target System Doesn’t Respond 9-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10 Additional Notes 10-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Running Title—Attribute Reference
vii Contents
Figures
2–1. Configuration Switches 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2–2. DOS Command Setup for the Debugger 2-10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–1. Modify Address Dialog Box 4-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–2. Select Action Dialog Box 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–3. Select Memory Type Dialog Box 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4–4. Validation Dialog Box 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8–1. PLCC Target Cable Termination 8-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8–2. Switch Positions 8-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8–3. Connecting the Target Cable to the CDT370 Board 8-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Running Title—Attribute Reference
viii
Tables
2–1. On-Board Switches 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2–2. RS-232 Pin and Signal Assignments 2-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2–3. Summary of the Debugger Options 2-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2–4. Screen Size Options (for Use With the –b Option) 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2–5. Serial Port and Add-On Address Options 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3–1. Displayed Trace Samples 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8–1. Available Target Cables 8-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8–2. Switch Signals 8-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8–3. Connections for CDT370/Target Cables 8-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10–1. Predefined Constants for Use With Conditional Commands 10-1. . . . . . . . . . . . . . . . . . . . . . . .

Introduction
1-1 Introduction
Introduction
The CDT370 (Compact Development Tool) offers a low-cost but highly effi-
cient route to TMS370 family development. In addition, the CDT370 supports
programming of the new Field Programmable Microcontroller (FPM) family
members. Features such as a new interactive windowed CDT370 debugger,
real-timeemulation,andanintegratedEPROMandEEPROMprogrammerall
contribute to enhanced user productivity and, consequently, a shorter design
cycle.
The CDT370 is composed of:
- CDT370 emulator board
- Interactive windowed CDT370 C-source debugger
- Assembler and linker
- Complete support documentation
The CDT370 debugger is a screen-oriented, interactive program that aids in
the development of applications for TMS370 family microcontrollers. The de-
bugger is used with a hardware unit called an emulator, which provides real-
time, in-circuit emulation of the TMS370 microcontroller. The debugger runs
under the MS-DOS operating system on an IBM or compatible and connects
to the emulator through an add-on PC connection or RS-232 serial communi-
cations link.
Topic Page
1.1 About The CDT370 Board 1-2
1.2 About The Target Cable Set 1-3
Chapter 1

About the CDT370 Board
1-2
1.1 About the CDT370 Board
OncetheCDT370isunpacked,youcanbegincodedevelopmentimmediately.
Everything required to emulate or program TMS370 devices is provided. The
CDT370 supports the following devices:
- TMS370Cx1x
- TMS370Cx2x
- TMS370Cx4x
- TMS370Cx5x
Use the XDS22 Extended Development System to develop code for
TMS370Cx3x PACT devices.
TheCDT370emulatorhardwareisasingleboardthatcanbeconnectedintwo
different ways:
- The CDT370 board is designed to plug into the expansion chassis of any
IBM XT/AT or compatible
- The CDT370 can be connected to the PC through an RS-232 serial link
The CDT370 on-board hardware provides:
- Serial/parallel communication interface
- Real-time TMS370 emulation logic (up to 20 MHz)
- Real-time TMS370 data EEPROM emulation logic
- Real-time trace circular buffer (up to 2048 program steps)
- Real-time 24-bit cycle counter
- Integrated EPROM and EEPROM device programmer

About the Target Cable Set
1-3 Introduction
1.2 About the Target Cable Set
Each emulator can have a target cable with a connector on one end that has
the same pinout as the device being emulated. This connector plugs directly
intothesocketontheapplicationsystem(alsoreferredtoasthe
targetsystem )
circuit board that would normally hold the TMS370 device. This allows direct,
in-circuit emulation. Each target cable also has an easy-extract socket that
allows you to program the devices.
In the supported TMS370 family, there are five different packages:
- 28DIL
- 28LCC
- 40DIL
- 44LCC
- 68LCC
There are seven different target cables to support these packages because
the 40-pin DIL and the 44-pin LCC TMS370Cx2x devices have different pin-
outs than the 40-pin DIL and 44-pin LCC TMS370Cx4x devices. As a result,
the emulator target cables for the devices are different and not interchange-
able. The seven target cable sets are listed below along with the devices they
support:
- x1x devices in 28-pin DIL socket 28-pin DIL target cable. . . . . . . . . . . . .
- x1x devices in 28-pin LCC socket 28-pin LCC target cable. . . . . . . . . . .
- x2x devices in 40-pin DIL socket 40-pin DIL target cable. . . . . . . . . . . . .
- x2x devices in 44-pin LCC socket 44-pin LCC target cable. . . . . . . . . . .
- x4x devices in 40-pin DIL socket 40-pin DIL target cable. . . . . . . . . . . . .
- x4x devices in 44-pin LCC socket 44-pin LCC target cable. . . . . . . . . . .
- x5x devices in 68-pin LCC socket 68-pin LCC target cable. . . . . . . . . . .

1-4

Running Title—Attribute Reference
2-1 Chapter Title—Attribute Reference
Getting Started
This chapter includes the proper procedures to set up the CDT370.
The following topics are covered:
Topic Page
2.1 System Hardware Requirements 2-2
2.2 System Software Requirements 2-3
2.3 Unpacking the CDT370 Board 2-4
2.4 Add-On PC Connection 2-5
2.5 Serial RS-232 Connection 2-7
2.6 Software Installation 2-9
2.7 Using the Debugger With Microsoft Windows 2-15
2.8 Power-Up Procedure 2-17
2.9 Invoking the Debugger 2-18
2.10 Exiting the Debugger 2-21
Chapter 2

System Hardware Requirements
2-2
2.1 System Hardware Requirements
Host An IBM PC XT/AT or 100% compatible PC with a hard-disk system,
a serial port or a free full-length internal slot, and a 1.2-Mbyte 5-1/4”
floppy-disk drive.
Memory A minimum of 640K bytes of main memory is needed, but extended
(minimum256Kbytes)memoryisalsoneededwhenyourunthede-
bugger under Windows.
Display A monochrome screen can be used, but a color screen (EGA or
VGA) is recommended.
Cable AtargetcableisrequiredtoconnecttheCDT370boardtothetarget,
but it is not needed when the emulator runs in stand-alone mode.
Options A Microsoft-compatible mouse.
An EGA- or VGA-compatible graphics display card and a large
monitor.
The debugger has two options that allow you to change the overall
size of the debugger display.
To use a larger screen size, you must invoke the debugger with the
appropriate option. For more information about options, refer to
Section 2.9,
Invoking the Debugger .
Miscellaneous Blank, formatted disks.
Note: Firmware Version
Make sure you are using a CDT370 board with firmware version 3.0 or later.

System Software Requirements
2-3 Getting Started
2.2 System Software Requirements
Operating System MS-DOS or PC-DOS (version 3.0 or later)
Optional: Microsoft Windows (version 3.0 or later)
Software Tools TMS370 C compiler, assembler (version 5.06 or later), and linker.
If you have a program that you assembled with an earlier version of
the assembler, be sure to update it.
Optional Files †init.cmd is a file that contains debugger commands. The version of
this file that’s shipped with the debugger defines a ’370 memory
map.Ifthisfileisn’tpresentwhenyoufirstinvokethedebugger,then
allmemoryisinvalidatfirst.Whenyoufirststartusingthedebugger,
this memory map should be sufficient for your needs.
Later, you may want to define your own memory map. For informa-
tion about setting up your own memory map, refer to Section 7.2,
MemoryMapping and DefiningaMemoryMap ,inthe TMS370Fam-
ily C Source Debugger User’s Guide
.
Inaddition to init.cmd,thereare several other .cmdfilesin the maps
directory. These .cmd files define memory maps for standard ’370
devices.If youwantto emulate aspecificdevice, copy theappropri-
ate .cmd file into your init.cmd file.
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 file (.clr extension) is for color monitors;
another file (.mon extension) can be used with monochrome moni-
tors. Several of each type of screen configuration file are included
in your screens directory. When you first invoke the debugger, the
defaultscreenconfigurationshouldbesufficientforyourneeds.Lat-
er, you may want to define your own custom configuration.
For information about these files and about setting up your own
screenconfiguration, refer to
CustomizingtheDebugger Display ,in
the
TMS370 Family C Source Debugger User’s Guide .
Due to the 640K-byte memory limitation under DOS, it may not be
possible to load and/or debug large applications with the DOS ver-
sion of the debugger. The Windows version of the debugger will
make use of any extended memory available on the PC.
†Included as part of the debugger package, these files are available on the C-source debugger
product disk but have not been copied by the installation process.

Unpacking the CDT370 Board
2-4
2.3 Unpacking the CDT370 Board
BeforeyouunpacktheCDT370board,decideifyouwanttoplugtheboardinto
anexpansionslotinsideyourPCorconnectittoanRS-232cableoutsideyour
PC. Placing the board inside your computer’s case is preferable, but if you
have no empty slots or if the internal mount makes it awkward to access the
target system, the RS-232 link can be used.
Remove the CDT370 board from its antistatic protection sheath.
To avoid damage to the board, do not touch the board directly,
except at a static-free workstation.
Do not connect any electric motors or fluorescent lights to the
CDT370 power circuit. Noise and/or voltage spikes from these
devices could affect operation.
Do not plug the CDT board into a slot next to an Ethernet card. The
target cables are not shielded.

Add-On PC Connection
2-5 Getting Started
2.4 Add-On PC Connection
The CDT370 board can be plugged into any IBM PC XT/AT or compatible.
There are two different areas of jumpers on the board:
- CONF with two possible positions
- COM PORT with 4 possible positions
The shipping position is: Add-on PC link / Address 318h, IRQ4.
Figure 2–1.Configuration Switches
COM1 COM3
COM2 COM4
Add-On
RS232
Table 2–1.On-Board Switches
CONF COM Port Comments
ADD-ON
ADD-ON
ADD-ON
ADD-ON
RS-232
RS-232
COM1
COM2
COM3
COM4
X
X
Add-on PC link / 318h, IRQ4
Add-on PC link / 358h, IRQ2
Add-on PC link / 338h, IRQ3
Add-on PC link / 398h, IRQ7
RS-232 link / serial com port 1
RS-232 link / serial com port 2
Step 1: TheCONFjumpermustbesettotheADD-ONposition,andthecom
PORT jumper must be set to one of the four positions that are
referred to as COM1 through com 4.
Step 2: Switch off your IBM PC XT/AT or compatible and remove the cover.
Then, carefully plug the properly configured CDT370 board into an
empty slot.

Add-On PC Connection
2-6
Step 3: To use the CDT370 to perform in-circuit emulation on your target
deviceordeviceprogramming,plugthetargetcablededicatedtothe
TMS370familymemberyouareworkingwithintotheCDT370board
before closing the cover.
For target cable connection, refer to Chapter 8,
Target Connectors .
Step 4: Close the cover of your PC and turn the power on.