ST ST7MDTU3-EMU2B User manual

ST7MDTU3-EMU2B
HDS2 Series Emulator
User Manual
Release 1.1
January 2002
Ref: DOC-ST7MDTU3-EMU2B

USE IN LIFE SUPPORT DEVICES OR SYSTEMS MUST BE EXPRESSLY AUTHORIZED.
STMicroelectronicsPRODUCTS ARE NOT AUTHORIZED FOR USE AS CRITICAL COMPONENTS IN
LIFE SUPPORT DEVICES OR SYSTEMS WITHOUT THE EXPRESS WRITTEN APPROVAL OF
STMicroelectronics. As used herein:
1. Life support devices or systems are those
which (a) are intended for surgical implant into
the body, or (b) support or sustain life, and whose
failure to perform, when properly used in
accordance with instructions for use provided
with the product, can be reasonably expected to
result in significant injury to the user.
2. A critical component is any component of a life
support device or system whose failure to
perform can reasonably be expected to cause the
failure of the life support device or system, or to
affect its safety or effectiveness.

Table of Contents
3/63
Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.1 Emulator Configuration ................................................................................. 6
1.2 Emulator Operation ....................................................................................... 6
1.3 Software and Documentation for the Emulator Kit ........................................7
1.4 About this manual.... ..................................................................................... 7
1.5 Related Documentation ................................................................................ 8
1.6 Getting Assistance ........................................................................................ 8
Chapter 2: Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1 Your System Requirements ..........................................................................9
2.2 Delivery Checklist ......................................................................................... 9
2.3 Installing the Hardware ............................................................................... 10
2.4 Debuggers Supporting the ST7 HDS2 Emulator Series .............................16
Chapter 3: STVD7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.1 Installing STVD7 ......................................................................................... 17
3.2 Launching STVD7 ....................................................................................... 18
3.3 About STVD7 debugging features ..............................................................19
3.4 Workspaces ................................................................................................ 20
3.5 Toolchains and application files ..................................................................21
3.6 Creating a workspace ................................................................................. 24
3.7 Opening an existing workspace ..................................................................26
3.8 Opening files directly for debugging (*.abs, *.s19, *.hex and *.elf ) ........... 29
3.9 Opening lone programmable files (*.s19 or *.hex) ......................................30
3.10 Changing your project settings ...................................................................31
3.11 Saving workspaces ..................................................................................... 33
3.12 Debug context and Build context ................................................................35
3.13 Configuring the MCU .................................................................................. 36
3.14 Start debugging! ......................................................................................... 41
Chapter 4: Emulator Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.1 Main Features of the ST7 HDS2 Emulator series .......................................43
4.2 Specific Features ........................................................................................ 43
4.3 Emulator Architecture ................................................................................. 43
4.4 Output Triggers ........................................................................................... 47
4.5 Analyser Probe Input Signals .....................................................................49
4.6 Front Panel LEDs ....................................................................................... 50

Table of Contents
4/63
4.7 On-Chip Peripherals ................................................................................... 50
4.8 Emulation Functional Limitations and Discrepancies ................................. 51
Appendix A: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
A.1 Identifying the Problem ............................................................................... 53
A.2 Changing the Parallel Port Setup on Your PC ............................................ 53
A.3 Running the Hardware Test ........................................................................54
Appendix B: Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Product Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Getting prepared before you call............................................................................... 59
Contact list................................................................................................................ 59
Software updates...................................................................................................... 60
Hardware spare parts ............................................................................................... 60
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65

ST7MDTU3-EMU2B Emulator User Manual 1 - Introduction
5/63
1 INTRODUCTION
Thanks for choosing ST7! This manual will help you get started with the
ST7MDTU3-EMU2B emulator kit.
The ST7MDTU3-EMU2B emulator allows you to control the execution of programs
that you have written for the ST7263BKX MCU and assists you in debugging your
application hardware as well as your software. The ST7MDTU3-EMU2B kit comes
with the debugger software package—ST7 Visual Debug—which contains all of the
necessary resources to help you design, develop and debug ST7 application
software running in a real environment.
Note: If you come across any terms or abbreviations you do not understand, you can check their
meaning in the Glossary on page 57.
Please refer to Section 4.8: Emulation Functional Limitations and Discrepancies on page 51
for a description of the limitations on the current release of this emulator kit.
The Emulator Package is made up of two main parts:
• The Hardware Development System (ST7 HDS2), which is the common
mainframe to all ST7 emulators.
• The ST7MDTU3-Active Probe, dedicated to the family, which constitutes the
physical link between the emulator and your application.
Note: When receiving the ST7MDTU3-EMU2B development tool, please refer to the Delivery
Checklist on page 9 to confirm that all of the contents of the package are present.
The emulator performs two main functions:
• It replaces the microcontroller in the application, by means of an emulation
probe that is plugged into the application in place of the emulated MCU.
• It controls the internal data bus of the emulated microcontroller, providing
arbitration and tracing capabilities on all accesses to any of the following
resources:
- ST7 HDS2 resources,
- ST7MDTU3-Active Probe resources,
- Application resources.
Therefore, you can have the emulator running your software in the application just
as the emulated MCU would do, and have extensive tracing and control
capabilities (i.e. keeping track of what the MCU does, and making it react in a
specific way upon defined conditions).
In this way, it is possible to fully emulate microcontroller resources.
1

1 - Introduction ST7MDTU3-EMU2B Emulator User Manual
6/63
1.1 Emulator Configuration
Figure 1 shows the configuration for the ST7MDTU3-EMU2B emulator kit. The
main ST7 HDS2 box is connected to your PC via the parallel port. Two flat
cables connect the ST7 HDS2 box to the ST7MDTU3-Active Probe. The ST7
Generic Probe is connected to the ST72F63-TEB, to which a device adapter
can optionally be fixed so that you can connect the emulator to your application
board.
Figure 1: ST7MDTU3-EMU2B General Configuration
1.2 Emulator Operation
A symbolic debugger, ST7 Visual Debug, (also referred to as STVD7), is
provided to control the emulator.
ST7 Visual Debug can be run on a PC under the Windows environment, and is
common to all ST7 devices. ST7 Visual Debug uses a window menu-driven
interface, and enables you to configure the emulator.
application board
application board power supply
emulatorpower
supply
parallel cable
ST7-Generic
Probe
connection to PC’s
parallel port
ST72F63-TEB
device
adapter

ST7MDTU3-EMU2B Emulator User Manual 1 - Introduction
7/63
Chapter 3: STVD7 on page 17, explains how to install ST7 Visual Debug on
your PC, and set up the emulator configuration so that you can begin your
debugging session.
Once assembled and linked, the application software is ready to be downloaded
into the ST7 emulator. The development station performs a real-time emulation
of the target device, thus allowing high performance testing and debugging of
both application hardware and software.
When the program is fully debugged, the ST7 EPROM programming board
(ref.: ST7MDTU3B-EPB — not provided with this emulator kit) can be used to
program the emulation device with the Motorola S Record format file produced
by the OBSEND formatter.
1.3 Software and Documentation for the Emulator Kit
The “MCU on CD” CD-ROM contains:
• ST7 Tools, comprising the following software:
- The source-level graphic debugger, ST7 Visual Debug, that operates
with ST7 HDS2 Emulators and ST7 Development Kits or as a
standalone ST7 simulator.
- The ST7 Assembly chain, composed of an assembler, linker, librarian
and formatter.
- The ST7 Windows Epromer to program your MCU target devices.
• Third-party C compiler and toolchain demos (Hiware and Cosmic).
• ST7 application notes (with sources), training slides and exercises, this
manual (in PDF version), and other useful reference materials.
• Datasheets for the ST7 MCU family.
1.4 About this manual....
Detailed instructions on how to install your emulator configuration is described
in
Chapter 2: Getting Started on page 9.
How to start debugging your application using your emulator and ST7 Visual
Debug is described in
Chapter 3: STVD7 on page 17.
The emulator kit’s hardware features are described in
Chapter 4: Emulator
Features
on page 43.

1 - Introduction ST7MDTU3-EMU2B Emulator User Manual
8/63
1.5 Related Documentation
To get all the essential information about your ST7 MCU and the software that
comes on the CD-ROM with the emulator kit, you will need to refer to these
documents (also contained on the CD-ROM):
• ST7-Family Data Sheets
•
ST7-Family 8-bit MCUs Product Overview (Ref. BKST7/2)
•
Software Tools for the ST7 Family (Ref. Doc-ST7ASMLK-SW)
• ST7-Family Programming Manual
1.6 Getting Assistance
For more information, application notes, FAQs and software updates on all the ST
microcontroller families, check out the CD-ROM or our website:
http://mcu.st.com
For assistance on all ST microcontroller subjects, or if you need help with using
your emulator, use the contact list provided in
Product Support on page 59. We’ll
be glad to help you!

ST7MDTU3-EMU2B Emulator User Manual 2 - Getting Started
9/63
2 GETTING STARTED
2.1 Your System Requirements
The ST7MDTU3-EMU2B Emulator (both hardware and software components) has
been designed to work with PCs meeting the following requirements:
• One of the following operating systems: Microsoft®Windows®95, 98 or NT®.
• Intel®Pentium (or compatible) processor with minimum speed of 100 MHz.
• Minimum RAM of 32 MB.
• 21 MB of free hard disk space to install all of the ST7 tools.
2.2 Delivery Checklist
The emulator kit (ref.: ST7MDTU3-EMU2B), is delivered with the following (refer to
Figure 2 ):
1One emulator box containing the ST7 HDS2 main board (ref.: MB176) and two
50-wire flat cables to connect the ST7 HDS2 main board to the generic
emulation probe.
2One emulator power supply.
3One parallel cable.
4Three EMC suppress ferrites.
5One logic probe cable.
6Two SMB to BNC cables.
7One generic emulation probe—the ST7 Generic Probe (ref.: DB467).
8An ST72F63-Target Emulation Board (TEB) (ref.: DB465).
9An SO34 socket adapter (ref.: DB354 & DB355).
10 One User Manual for the ST7 Family Software Development Tools (assembler,
linker, and formatter). (Not shown.)
11 This manual. (Not shown.)
2

2 - Getting Started ST7MDTU3-EMU2B Emulator User Manual
10/63
12 A CD-ROM containing ST7 information and software, including ST7 Visual
Debug and a Windows®Epromer. (Not shown.)
2.3 Installing the Hardware
The ST7 HDS2 emulator is connected through the parallel port to a PC
computer which runs the control software (ST7 Visual Debug) as explained
later. To connect your ST7 HDS2 emulator, you will have to follow these general
steps (explained in detail later):
1Connect the ST7 HDS2 emulator to your PC using the parallel cable
provided.
2Connect the two flat cables of your ST7 HDS2 emulator to the emulation
probe connectors.
3Connect the probe to the application board using a device adapter.
4Connect the power supply cable between the power supply block and the
power connector located on the rear panel of your ST7 HDS2 emulator.
5Power up the emulator and then connect your application power supply.
Figure 2: Main Components of ST7MDTU3-EMU2B Emulator Kit
(3)
(4)
(1)
(9)
(7)
(5)
(2)
(6)
(8)

ST7MDTU3-EMU2B Emulator User Manual 2 - Getting Started
11/63
A connection flow diagram is shown in Figure 3 . Each installation step is
described in detail in the following sections.
Step 1: Connecting the Emulator to your PC
1Shutdown and power-off the PC that is to be connected to the emulator.
2Connect one end of the parallel cable to the emulator’s rear panel 25-pin
SUB-D connector and the other end to one of the PC’s parallel ports (LPT1
to LPT2)—refer to
Figure 4 .
Note: Centronics (or PC-AT or SPP), ECP and EPP parallelport configurations are supported by
the emulator.
Figure 3: ST7MDTU3-EMU2B Connection Flow
ST72F63-TEB
1
2
3
4
5
Application Board Power Supply
ST7 HDS2 Emulator Casing
ST7 Generic Probe
Power Supply
Application Board
Parallel Cable
PC Parallel Port
SO34 Socket Adapter

2 - Getting Started ST7MDTU3-EMU2B Emulator User Manual
12/63
Be sure to use the parallel cable provided with the emulator—using a longer parallel cable
may cause emulator malfunctions.
Step 2: Connecting the Emulator to the Probe
1Ensure that the application and the emulator are powered-off.
2Plug the two 50-wire flat cables into the J1 and J2 connections on the probe, as
described below (refer also to
Figure 5 ):
Figure 4: Connecting the Emulator to the PC
ST7 HDS2 emulator
(ref.: MB176) ST7-Generic Probe (ref.: DB467)
Upper cable
Lower cable
J2
J1
Figure 5: Connecting the Emulator to the Generic Probe
2
1
SUBD25 connector
rear panel
to LPT1 or LPT2
Red Line
ST7 HDS2
Side View
50 pin male connectors
J1 J2
DB467

ST7MDTU3-EMU2B Emulator User Manual 2 - Getting Started
13/63
EMC-Compliant Probes: In order to work under an EMC-compliant environment,
you will have to clip two or three EMC-ferrites on the 50-wire flat cables linking the
probe to the emulator box. Place these ferrites as close to the emulator window as
possible. Three ferrites are provided in the package. See
Figure 6 for an illustration
of where to attach the ferrites.
Step 3: Connecting the Probe to your Application Board
Emulated devices of the ST7MDTU3 family are available in two packages.
Each package has its own connection procedure, found on the page cited in the
table below:
Note: You can use your emulator kit with ST7 Visual Debug without an application board—however
the emulation probes must be connected to the HDS2 emulator.
Figure 6: Making your Probes EMC-Compliant
Packages Page No.
SO34 14
SDIP32 15
ST7 HDS2
Emulator
Side View Ferrites
Flat Cables Side View
Probe +
Application Board

2 - Getting Started ST7MDTU3-EMU2B Emulator User Manual
14/63
If you are using the SO34 package, proceed as follows:
To connect the probe to its device adapter and then to your application, follow
these steps (see
Figure 7 ):
1Solder the SO34 device adapter (ref.: DB354 & DB355) to your application
board.
2Connect the joined generic probe (ref.: DB467) and ST72F63-TEB (ref.:
DB465) to the SO34 device adapter.
Figure 7: SO34 Package Connections
J2
J1
1
2
Application Board
ST7 Generic Probe
(ref.: DB467)
ST72F63 TEB (ref.: DB465)
SO34 device adapter
(ref.: DB354 & DB355)

ST7MDTU3-EMU2B Emulator User Manual 2 - Getting Started
15/63
If you are using the SDIP32 package, proceed as follows:
Solder the joined generic probe (ref.: DB467) and ST72F63-TEB (ref.: DB465) to
your application board (see
Figure 8 ).
Step 4: Connecting the emulator power supply
Warning: Make sure that both the ST7MDTU3-EMU2B and the application are OFF before making
any connections.
1Connect the external power supply provided with the emulator to the rear panel
of the mainframe using a 5-pin DIN connector.
2Plug the power supply into the mains using the supply cable provided.
Mains voltage specifications:
Step 5: Powering up
1Check the ST7 HDS2 operating voltage (110 V/220 V) indicated on the label on
the power supply. Contact your dealer if this voltage does not correspond to
your mains’ power supply.
Figure 8: SDIP32 Package Connections
AC voltage: 100 V to 240 V
Frequency: 50 to 60 Hz
J2
J1
Application Board
ST7 Generic Probe
(ref.: DB467)
ST72F63 TEB (ref.: DB465)

2 - Getting Started ST7MDTU3-EMU2B Emulator User Manual
16/63
2Power up the ST7 HDS2 emulator from the ON/OFF switch located on the rear
panel. The LED labelled
Power on the front panel should then light up.
3Power up your application.
2.4 Debuggers Supporting the ST7 HDS2 Emulator Series
ST7 Visual Debug (also known as STVD7) is the STMicroelectronics debugger
currently supporting the ST7 HDS2 emulator.
Third party debuggers supporting the ST7 HDS2 emulator include the following:
• ST7-Hiwave by HIWARE
• Zap by COSMIC
• Hitop by HITEX.
ST7 Visual Debug is free software. It is available on the CD-ROM delivered with
your emulator kit and on the STMicroelectronics website. The next chapter tells
you how to configure your emulator and start debugging with ST7 Visual Debug.

ST7MDTU3-EMU2B Emulator User Manual 3 - STVD7
17/63
3 STVD7
STVD7 is an integrated development environment that allows you to edit, debug
and rebuild your application all from within STVD7.
The following sections tell you:
•
Section 3.1 —how to install the STVD7 software,
•
Section 3.2 —how to launch STVD7,
•
Section 3.3 —a little about STVD7’s debugging features,
•
Section 3.4 —what a workspace is,
•
Section 3.5 —what toolchains and executable files are supported by STVD7,
•
Section 3.6 —how to create a STVD7 workspace,
•
Section 3.7 —how to open existing workspaces,
•
Section 3.8 —how to open binary files,
•
Section 3.10 —how to change your project settings,
•
Section 3.11 —how to save workspaces,
•
Section 3.12 —how to switch from the build context to the debug context,
•
Section 3.13 —how to configure the target MCU in order to debug more
accurately and efficiently.
3.1 Installing STVD7
Your emulator comes with the “MCU on CD” CD-ROM which contains a number of
ST7 software tools. These tools run under the Windows®95, 98, 2000, Millenium
and Windows®NT®operating systems.
Note: To install the software on “ MCU on CD ”, Windows
®
2000 and NT
®
users must have
administrator privileges.
To install and setup the ST7 software tools, follow these steps:
1Close all other open applications on your Windows desktop.
2Insert the “MCU on CD” into your CD-ROM drive. The CD-ROM’s autorun
feature will open up a welcome screen on your PC. If the autorun feature does
not work, use Windows®Explorer to browse to the CD-ROM’ s root folder, and
double-click on Welcome.exe.
3Select
Install Your Development Tools from the list of options. A new screen
will appear listing the different families of STMicroelectronics MCUs.
4Use your mouse to place the cursor over the
ST7 Tools option. Choose
ST Tools , then ST7 Toolchain from the lists that appear.
3

3 - STVD7 ST7MDTU3-EMU2B Emulator User Manual
18/63
5The install wizard will be launched. Follow the instructions that appear on the
screen.
You can choose to install the complete toolchain (i.e. the appropriate version of
STVD7, STVP7 and the Assembler-Linker) for each type of development tool
(development kit, HDS2 or EMU3 emulators or simulator), or perform a
customized installation.
If you choose a customized installation, you can choose to install any or all of
the STVD7 versions, and/or the Windows Epromer/STVP7 and/or the
Assembler-Linker. As a minimum, in order to emulate your application with
your emulator, you must install STVD7 for HDS2.
If you also install the ST7 Assembly Toolchain, you will be able to use the ST7
Assembly Toolchain as part of STVD7’s integrated development environment.
The installation is now complete. You will be prompted to reboot your computer.
You should do so before launching STVD7.
3.2 Launching STVD7
1From your Windows desktop, select
Start>Programs>ST7 Tool
Chain>Development Tools>STVD7
HDS2 emulator.
2The first time you open a version of STVD7 you will be prompted to enter the
toolchain paths to be used by STVD7’s integrated development environment.
Figure 9: Toolchain Path dialog box

ST7MDTU3-EMU2B Emulator User Manual 3 - STVD7
19/63
Enter the paths for the toolchains that you use (i.e. any or all of the Hiware,
Cosmic or ST7 ASM toolchains) and click
OK . (The default paths for each
toolchain are shown below.)
3If you choose
Cancel, you will be prompted again to enter the toolchain paths
the next time you launch STVD7.
Note: You may modify the toolchain path at any time from within STVD7—simply select
Project>Toolchain Paths from the main menu to access the dialog box above.
3.3 About STVD7 debugging features
A number of advanced features are included in the STVD7 software:
•Data Breakpoints on the occurrence of a memory access via a read operation
or a write operation, or both.
•Instruction Breakpoints on the occurrence of an opcode fetch.
•ALogical Analyser that allows you to control either the recording of the trace
buffer, or a break in the execution of the application using a series of specific
conditions (events).
•ATrace window to view the contents of the trace buffer, which permanently
records in real time on 32-bits:
- Address and data bus information.
- Flag status and 4 external signal values.
You can record up to 1024 executed cycles. Using trace filtering, you can filter
out only those cycles you wish to record in the trace buffer. You can equally
control which of the recorded cycles are displayed in the Trace window using
line filtering. Addresses, data, control/status bits and 4 user signals are
displayed using mnemonic and user symbols.
• Internal synchronization signals can be output to either of two Trigger Outlets
on the front panel of the emulator (OUT1 or OUT2). This feature enables you to
count events using an external equipment, when optimizing software for
example, or to synchronize an oscilloscope when debugging hardware.
•Hardware Events can be used to control the sending of signals to the trigger
outputs.
• You can choose the output that you wish the signal to be sent to (i.e. either
OUT1 or OUT2).
•AHardware Test function that allows you to perform a number of hardware
tests on the Development Board, at your choosing. Refer to
Running the

3 - STVD7 ST7MDTU3-EMU2B Emulator User Manual
20/63
Hardware Test for more information.
• A powerful online help facility can be invoked at any time to give additional
information about the commands, the processor or the emulator kit.
3.4 Workspaces
STVD7 organizes project development and debugging into workspaces.
Workspaces allow you to store application and project settings and save them, so
that each time you wish to work on the project, you will find all of the settings
exactly as you left them.
Creating a workspace is the first thing that you need to do when using STVD7 for
the first time or when starting any new project. You must have an open workspace
to work with STVD7. How to create a new workspace is described in detail in
Section 3.6 . Sample workspaces for each supported toolchain are provided so that
you can familiarize yourself with STVD7 (for a listing of sample workspaces, see
Table 1 ).
Each workspace is comprised of three information sets: the project settings, the
visual environment and debugging information.
• The project settings consists of the information necessary for a successful
build of an application (commands to run, makefile file etc....). Your
workspace’s project settings include the definition of your application toolchain
(see
Section 3.5 ).
• The debugging information includes information on breakpoints, memory
mapping, advanced breakpoints programs, trace etc..
• The visual environment consists of the open windows elements, along with
their current layout, customized toolbars and menus. The visual environment is
composed of two environments, one in the Build context and one in the
Debug context (see
Section 3.12 ).
The above workspace information is stored in three types of files: a workspace file
(*.wsp) and two auxiliary files (*.wed and *.wdb).
Both project settings and debugging information is stored in the same workspace
file (*.wsp). In addition, to allow you to use the same workspace file for any STVD7
version (such as the STVD7 Simulator version, STVD7 for HDS2 Emulator, STVD7
for DVP, and/or STVD7 for EMU3 Emulator), the project settings and debug
information (such as the toolchain used, MCU emulated, memory mapping, etc.)
are kept separately in the same *.wsp file for each STVD7 version.This allows you
to use the same workspace file to debug the same application for two different
MCUs or MCU configurations on different STVD7 versions.