M68MMDS0508

Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... MMDS0508OM/D MMDS M O D U L A R D E V E L O P M E N T S Y S T E M f o r 6 8 H C 0 5 a n d 6 8 H C 0 8 M I C R O C O N T R O L L E R S O P E R A T I O N S M A N U A L For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. MMDS0508 Motorola Modular Development System Operations Manual MMDS0508OM/D MOTOROLA 3 For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. Motorola reserves the right to make changes without further notice to any products herein to improve reliability, function, or design. Motorola does not assume any liability arising out of the application or use of any product or circuit described herein; neither does it convey any license under its patent rights nor the rights of others. Motorola products are not designed, intended, or authorized for use as components in systems intended for surgical implant into the body, or other application in which the failure of the Motorola product could create a situation where personal injury or death may occur. Should Buyer purchase or use Motorola products for any such unintended or unauthorized application, Buyer shall indemnify and hold Motorola and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs, damages, and expenses, and reasonable attorney fees arising out of, directly or indirectly, any claim of personal injury or death associated with such unintended or unauthorized use, even if such claim alleges that Motorola was negligent regarding the design or manufacture of the part. Motorola and the Motorola logo are registered trademarks of Motorola Inc. Motorola Inc. is an Equal Opportunity/Affirmative Action Employer MS-DOS is a registered trademark of Microsoft Corporation. IBM is a registered trademark of IBM Corporation. MMEVS05 software is  P & E Microcomputer Systems, Inc.*, 1995; All Rights Reserved. Portions of the software are  Borland International, 1987. Portions of the software are  TurboPower Software, 1988. _______ * P & E Microcomputer Systems, Inc. P.O. Box 2044 Woburn, MA 01888-2044 (617) 353-9206 MMDS0508OM/D 4 MOTOROLA For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc. Revision History Revision History Freescale Semiconductor, Inc... This table summarizes differences between this revision and the previous revision of this emulation module user’s manual. Previous Revision None Current Revision Original release Date 08/96 MMDS0508OM/D MOTOROLA 5 For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Revision History MMDS0508OM/D 6 MOTOROLA For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc. Table of Contents General Description Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Freescale Semiconductor, Inc... About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 System Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 System Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Host Computer Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Acronyms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 Installation Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 Configuring the Platform Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 Factory Test Header (J1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 Port Voltage Control Headers (J2–J4) . . . . . . . . . . . . . . . . . . . . . .24 Installing the EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Removing the EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Making System Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Host Computer Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Bus State Analyzer Connection . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Target Cable Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Power Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Reset Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 Serial Connector and Cable Information . . . . . . . . . . . . . . . . . . . . . . .28 Serial RS232 Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 Logic Cables and Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Power Supply Fuse Replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 MMDS0508OM/D MOTOROLA Table of Contents For More Information On This Product, Go to: www.freescale.com 7 Freescale Semiconductor, Inc. Table of Contents Loading and Initialization Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 Software Distribution Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36 Installing MMDS Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36 Personality Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 Using MMDS Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 Running MMDS05 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 Running MMDS08 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39 Freescale Semiconductor, Inc... MMDS Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 User Screens Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42 Main Window Screens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42 Status Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45 CPU Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Source/Code F2 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Code F2 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Source Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48 Variables F8 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49 Memory F3 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 Debug F10 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 Pop-Up Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51 Stack Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52 Set Memory Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53 Baud Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54 Emulator Clock Frequency Window . . . . . . . . . . . . . . . . . . . . . . . .54 Other Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55 Mouse Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56 Changing Screen Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58 Operation Fundamentals Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60 System Initialization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60 Setting Communications Baud Rate . . . . . . . . . . . . . . . . . . . . . . . .61 Standard Memory Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61 MMDS0508OM/D 8 Table of Contents For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Table of Contents Freescale Semiconductor, Inc... Custom Memory Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62 Initializing the Clock Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Loading User Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Initializing Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Initializing Assembly Language . . . . . . . . . . . . . . . . . . . . . . . . .64 Initializing Memory Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65 System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66 Script Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66 Information Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67 Log File Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68 Debug Screen Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69 Exit the Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70 Debug Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Setting CPU Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Memory Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Reset Control of the Emulation System . . . . . . . . . . . . . . . . . . . . .72 Using Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72 Tracing Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 Execution Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 Bus State Analyzer Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Configuring the Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Capturing Analyzer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Viewing Analyzer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Bus State Analysis Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78 Operating the Bus Analyzer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79 Defining Events (Terms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79 Selecting the Trigger Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84 Selecting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86 Collecting Bus Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87 Viewing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88 Searching the Trace Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95 Using the Time-Tag Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96 MMDS0508OM/D MOTOROLA Table of Contents For More Information On This Product, Go to: www.freescale.com 9 Freescale Semiconductor, Inc. Table of Contents Command-Line Commands Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102 Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102 Command Explanations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103 Freescale Semiconductor, Inc... S-Record Information Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 S-Record Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200 S-Record Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201 S-Record Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202 S-Record Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202 Index Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205 MMDS0508OM/D 10 Table of Contents For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. General Description Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 System Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 System Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Host Computer Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Acronyms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 Introduction The M68MMDS05/08 Motorola Modular Development System (MMDS) is a tool for developing embedded systems based on an MC68HC05 or MC68HC08 microcontroller unit (MCU). The MMDS is a modular emulation system that, when connected to a user’s target system, gives the user interactive control of a microcontroller application. The RAPID software provides an integrated development environment and includes an editor, assembler, and a user interface to the MMDS system. The environment allows for source-level debugging and simplifies writing and debugging code for an embedded MCU system. These features significantly reduce development time. A complete MMDS system contains the station module (M68MMDS0508), an emulation module (EM), and a target cable assembly. An EM completes MMDS functionality for a particular MCU or MCU family. To accommodate emulation of the numerous MCUs available, the MMDS uses a variety of different EMs. Refer to Motorola’s MMDS0508OM/D MOTOROLA General Description For More Information On This Product, Go to: www.freescale.com 11 Freescale Semiconductor, Inc. General Description Development Tool Selector Guide, order number SG173/D, for a complete list of available emulator modules and the appropriate user's manual for EM installation instructions. For connection to a target system, a separately purchased target cable with the appropriate target head also is needed. Freescale Semiconductor, Inc... To use the MMDS, an IBM (or compatible) host computer is needed. A 9-pin RS-232 serial cable also is provided with the MMDS. About this Manual This manual covers MMDS software, hardware, and reference information as follows: • Installation on page 19 explains M68MMDS0508 hardware. • Loading and Initialization on page 35 explains how to load and initialize the MMDS system software. • User Screens on page 41 explains the window screens, as well as how to use a mouse. • Operation Fundamentals on page 59 describes command usages. • Bus State Analysis on page 77 details the built-in state analyzer features. • Command-Line Commands on page 99 explains MMDS command syntax. • S-Record Information on page 199 gives reference information about Motorola S-records. MMDS0508OM/D 12 General Description For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. General Description System Features System Features Freescale Semiconductor, Inc... The MMDS is a full-featured development system that provides in-circuit emulation. Its features include: • Real-time, non-intrusive, in-circuit emulation • Real-time bus state analysis • MC68HC11K1 system controller for fast command transfer • Meets ECC92 European electromagnetic compatibility standards • Four complex data breakpoints; a data breakpoint can be qualified by an address, an address range, data, or externally connected logic clips. • 32 variables or real-time variables, plus a 32-byte block of real-time memory, mappable anywhere within a 1 Kbyte window over the 64-K HC05/HC08 memory map. • 64 Kbytes of emulation memory to accommodate the largest available ROM size of current HC05/HC08 MCUs. • 64 hardware instruction breakpoints over the 64-K memory map • A DOS personality file for each EM. Each personality file provides a memory-map definition. • 64K bytes of emulation memory, to accommodate the largest available ROM size of current HC05/HC8 MCUs. • Latch-up resistant design (47-Ω series resistor on I/O connections to the target system) to make power-up sequencing unimportant. • Built-in bus state analyzer: – 8K x 64 real-time trace buffer – Four hardware triggers for controlling real-time bus analysis and to provide breakpoints – Nine triggering modes – Display of real-time trace data as raw data, disassembled instructions, raw data and disassembled instructions, or assembly-language source code – As many as 8190 pre- or post-trigger points MMDS0508OM/D MOTOROLA General Description For More Information On This Product, Go to: www.freescale.com 13 Freescale Semiconductor, Inc. General Description Freescale Semiconductor, Inc... – Trace buffer can be filled while single-stepping through user software – 16-bit time tag, or an optional 24-bit time tag that sacrifices eight logic clips – Eight software selections for the time tag clock source, permitting wide time variance between analyzer events – 16 general-purpose logic clips, five of which can be used to trigger the bus state analyzer sequencer • Four software-selectable internally generated oscillator clock sources • Built-in power supply with 85 to 264 VAC input • Command and response logging to disk files • SCRIPT command for automatic execution of a sequence of MMDS commands • Assembly-language source-level debugging • RS-232 operation speeds as high as 57600 baud • On-screen, context-sensitive help via pop-up menus and windows • CHIPINFO command for memory-map, vectors, register, and pin-out information pertaining to the device being emulated • Emulation that allows multiple types of reset: – RESET command resets target – RESETGO command resets target and begins execution – WAIT4RESET command resets target via target hardware assertion of the RESET signal • Mouse or keyboard control of host software • Status line that displays such information as emulator state, communications port, and communications rate • Compact size: 15.38 inches (390.6 mm) deep, 10.19 inches (258.83 mm) wide, and 2.75 inches (69.85 mm) high. The station module weighs 6.0 pounds (2.72 kg). MMDS0508OM/D 14 General Description For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. General Description System Components Connections, configuration, and other related information is explained in the installation section of this document. For similar information with regard to EMs, see the corresponding EM user's manual. System Components Freescale Semiconductor, Inc... The following items are included with the MMDS: • Station module: the MMDS enclosure, containing the platform board and the internal power supply. The sliding panel in the enclosure top lets you insert an EM easily. • 9-pin RS-232 serial cable: The cable that connects the station module to the host computer RS-232 port. • Serial adapter: DB9M to DB25F RS-232 adapter for connecting to a 25-pin serial port on a host system. • System software: RAPID integrated development environment featuring editor, assembler, and assembly source level debugger (3.5-inch diskettes) • RAPID documentation: A RAPID Integrated Development Environment User’s Manual • MMDS documentation: An MMDS0508 Operations Manual (MMDS0508OM/D – this manual). • Software Release Guide: Documentation on the current release of system software. • Two logic clip cable assemblies: twisted-pair cables that connect the station module to your target system, a test fixture, a clock, an oscillator, or any other circuitry useful for evaluation or analysis. One end of each cable assembly has a molded connector, which fits into pod A or pod B of the station module. Leads at the other end of each cable terminate in female probe tips. Ball clips come with the cables. MMDS0508OM/D MOTOROLA General Description For More Information On This Product, Go to: www.freescale.com 15 Freescale Semiconductor, Inc. General Description Freescale Semiconductor, Inc... Separately purchased Motorola personality products include: • An emulation module (EM): One of many printed circuit boards that complete MMDS functionality for one or more particular MCUs. The two DIN connectors on the bottom of the EM fit into connectors on the top of the MMDS0508 platform board for power and signal connections. The EM also has a connector for the target cable. EMs are purchased separately from the platform board and are shipped with a user’s manual containing information specific to the module. • Optional target cable: A separately purchased target cable that is part of a cable assembly, used to connect the target system to the MMDS system • Optional target head adapter: A separately purchased target head adapter that is part of a cable assembly, used to connect the target system to the MMDS system User supplied components include: • Host computer: For further information refer to Host Computer Requirements Host Computer Requirements The host computer for the MMDS must be hardware and software compatible with IBM AT or PS/2 computers. The host computer must run DOS 5.0 or later versions. The host software requires approximately 512 Kbytes. An asynchronous communications port, configured as COM1, COM2, COM3, or COM4, is required for communications between the MMDS and the host computer. MMDS0508OM/D 16 General Description For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. General Description Acronyms Freescale Semiconductor, Inc... For improved product performance, additional system enhancements can be added. These are: 80386- or 80486-based systems, a hard disk drive, and a high-resolution color monitor with either an EGA or VGA graphics adapter card. The MMDS system software also supports a Microsoft, Logitech, or IBM mouse. Other mice may be compatible, but Motorola does not guarantee their satisfactory performance with MMDS software. Acronyms Table 1 provides definitions for the acronyms used throughout this manual. Table 1. Acronym Definitions Term Description M68MMDS0508 The station module where common hardware for all M68HC05 and M68HC08 emulation resides. EM An emulation module that connects to the platform board to customize the MMDS for a particular MCU or family of MCUs. RAPID An integrated development environment that includes an editor and allows applications such as assemblers and debuggers to be blended into a single environment. MMDS Motorola Modular Evaluation System. A generic term that describes a two-board evaluation system consisting of the platform board, one of many emulation modules, and system software (RAPID integrated development environment, CASM assembler and MMDS debugger). CASM Cross assembler that assembles M68HC05 (CASM05) or M68HC08 (CASM08) code. MMDS0508OM/D MOTOROLA General Description For More Information On This Product, Go to: www.freescale.com 17 Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... General Description MMDS0508OM/D 18 General Description For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 Configuring the Platform Board . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 Factory Test Header (J1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 Port Voltage Control Headers (J2–J4) . . . . . . . . . . . . . . . . . . . . . .24 Installing the EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Removing the EM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25 Making System Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Host Computer Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Bus State Analyzer Connection . . . . . . . . . . . . . . . . . . . . . . . . . . .26 Target Cable Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Power Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Reset Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 Serial Connector and Cable Information . . . . . . . . . . . . . . . . . . . . . . .28 Serial RS232 Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 Logic Cables and Connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Power Supply Fuse Replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 19 Freescale Semiconductor, Inc. Installation Introduction Freescale Semiconductor, Inc... Complete MMDS installation consists of configuring the platform board, configuring and installing the appropriate emulation module (EM), and making system cable connections. Consult the system components section on page 9 for a list of all the system parts, including a separately purchased EM. Note that EM configuration is specific to a particular EM; follow the guidance of the specific EM user's manual. Follow the guidance given in this section to complete the MMDS installation. Figure 1 shows the right side of the MMDS station module, with the access panel open. The recessed reset switch and power LED are on the front of the station module. The logic cable A and B connectors (pod A and pod B) are on the right (as you face the station module). When using the logic clip cables, always attach the black clip to ground. Figure 2 shows the left side of the station module, with the access panel closed. The power cord socket, the power switch, and the 9-pin RS-232 serial connector are on the left as you face the station module. The circular +5 V out connector, also on the left side of the station module, is reserved for future features. A spacer covers the final enclosure cutout, for a future conenctor.) NOTE: This manual uses the words left and right as you face the front of the station module. Follow the guidance of this chapter to complete the installation of your MMDS. MMDS0508OM/D 20 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Installation Introduction Pod A Pod B Connector Recessed Hardware Reset Switch Power LED Figure 1. M68MMDS0508 Station Module (Right Side) MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 21 Freescale Semiconductor, Inc. Installation Freescale Semiconductor, Inc... Panel Power Cord Socket Power Switch 9-Pin Serial Connector +5V Out Figure 2. M68MMDS0508 Station Module (Left Side) Configuring the Platform Board The MMDS platform board has four jumper headers, all located near the front of the platform board. Jumper header J1 is for factory test. Depending on the design of each emulation module, jumper headers J2, J3, and J4 may control the voltage levels for ports A through D. NOTE: The factory configures the platform board correctly for virtually all users before shipping the MMDS. These platform board jumpers should not be reconfigured unless instructed to do so by an emulation module (EM) user’s manual. MMDS0508OM/D 22 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Configuring the Platform Board Factory Test Header (J1) This diagram shows the factory configuration of jumper header J1. The fabricated jumper between pins 1 and 2 is correct for MMDS operation. 1 2 3 J1 RUN BOOT Freescale Semiconductor, Inc... FABRICATED JUMPER The alternate jumper position has significance only for factory personnel. MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 23 Freescale Semiconductor, Inc. Installation Port Voltage Control Headers (J2–J4) Jumper headers J2 through J4, located near the right front corner of the platform board, set the voltage levels for ports A through D. The following diagram shows the factory configuration. The fabricated jumpers between pins 1 and 2 of these headers set the +5-volt level for all ports. This is the correct configuration for MMDS operation, unless the EM user's manual says that the EM is a low-voltage board. Freescale Semiconductor, Inc... 1 2 3 J2 PORT A J3 PORT B J4 PORT C/D +5 VPRU FABRICATED JUMPERS If the EM can operate at low voltage, any of the ports can be operated at the low-voltage level. To do so, reposition the fabricated jumper of the corresponding header to pins 2 and 3. Jumper header J2 controls the voltage level of port A, jumper header J3 controls the voltage level of port B, and jumper header J4 controls the voltage level of port C or D, whichever pertains to the EM. MMDS0508OM/D 24 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Installing the EM Installing the EM Freescale Semiconductor, Inc... Perform these steps to install an EM in an MMDS enclosure: NOTE: • Ensure that station module power is off. • Remove the panel from the station module top by first turning each of the two 1/4-turn speed fasteners to the released position. • Install the EM on the platform board: Carefully fit the female 96-pin connectors (located on the bottom of the EM) onto the corresponding male DIN connectors on the top of the platform board. Snap the EM onto the plastic standoffs and make sure that the DIN connectors are joined together firmly. • Connect the target cable, if appropriate. • Reaffix the panel to the station module top. Many EM boards may have 64-pin female DIN connectors. If so, these will mate with the male DIN connectors on the platform board. The keyed plastic on the connector will ensure proper alignment. Removing the EM Complete these steps to remove an EM from an MMDS enclosure: • Ensure station module power is off. • Remove the panel from the station module top by first turning each of the two 1/4-turn speed fasteners to the released position • Disconnect the target cable from the EM target connector. • Unsnap all nylon spacers from the edges of the EM. Then carefully lift the EM straight up, separating it from the platform board. • Reaffix the panel to the station module top. MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 25 Freescale Semiconductor, Inc. Installation Making System Connections Freescale Semiconductor, Inc... The specific application determines the number of MMDS connections required. At the very least, the platform board and EM must be connected to the host computer and to a power supply. Cable connections are explained in the sections that follow. Host Computer Connection Use the 9-pin serial cable to connect a host computer’s 9-pin serial port to the MMDS 9-pin serial cable connector. Note which computer serial port is used. If the COM1 port (the default) is not used, the port number must be specified in the MMDS software start-up command. If the serial port is a 25-pin connector, use the provided 9- to 25-pin adapter between the host serial port and the cable. If the development system is operated in the RAPID environment, RAPID must be configured to communicate through the proper serial port. Bus State Analyzer Connection If your work session includes bus state analysis, you may need the logic clip cable assemblies. The two logic clip connectors, referred to as pods A and B, allow external events to be captured in the analyzer. External clock signals for the emulator and for the analyzer also can be input through logic clip connections. The pod A and pod B connectors are located on the right side of the station module. Pod A is nearest the station module power supply. These pod connections correspond to the cable A and cable B selections available in the bus state analyzer configuration window. Table 2 on page 31 gives pinout information for both logic clip connections. If you need only one logic cable assembly, connect it to either pod A or pod B. Orient the cable connector so that its pin 1 connects to pin 1 of the pod. The keyed plastic ensures proper orientation. Connect the other end of the logic cable assembly to an external target point. Optionally, MMDS0508OM/D 26 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Making System Connections connect the probe tips to the ball clips that come with the cable assembly, then connect the ball clips to appropriate external test points. Freescale Semiconductor, Inc... NOTE: The white probe of pod A is the external clock input for the emulator and the white probe of pod B is the external clock input for the analyzer. Always connect the black (ground) probe tip to an appropriate ground point of the target system before making logic clip connections to target points. If you need the second logic cable assembly, connect it in the same way to the remaining pod connector of the station module. Make target-system connections as for the first cable. Target Cable Connection If the MMDS will interface with a user’s target system, the target system should be connected to the EM board through a target cable assembly. A cable assembly consists of a target head and a target cable. The target connector will be on the right side of the EM module. Connect one end of the target cable to the EM target connector and the other end of the target cable to the user’s target system before power-up. See the specific EM user's manual for specific information on the target head adapter and the appropriate target cable. Make sure that the target head adapter and target cable mate correctly. Consult the EM manual for proper connection. Connecting the target cable any other way can damage the system. NOTE: Power Connection When connecting a target cable, press only on the rigid plastic connectors at either end of the cable. Pressing on the flexible part of the cable can damage the cable. The final MMDS connection is line power. The MMDS power switch is the rocker switch on the left side of the station module. Set the power switch to OFF. Insert the female end of the power cord into the power cord socket. Then plug the other end of the cord into a line-power outlet and set the power switch to ON. The green LED on the front of the station module lights to confirm system power. MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 27 Freescale Semiconductor, Inc. Installation This completes cable connections. Refer to Loading and Initialization on page 35 for information on communicating with the MMDS. Make sure the power to the MMDS is turned off when installing the EM or removing the EM from the station module. Sudden power surges can damage MMDS circuits. Freescale Semiconductor, Inc... Reset Switch RS-232 handshake signals control MMDS resets. A reset initializes the control board from its start-up point. If the host serial port does not implement handshaking, reset the MMDS manually. Press gently to trip the switch. Serial Connector and Cable Information This section contains pin identification and signal names for connectors common to all MMDS systems. For pinout information for a particular EM connector, refer to the corresponding EM user's manual. Serial RS232 Connector This diagram shows pin numbering for the 9-pin female serial connector of the platform board. Table 1 lists the signals transmitted on the 9-lead serial connection. 5 1 9 6 MMDS0508OM/D 28 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Serial Connector and Cable Information Freescale Semiconductor, Inc... Table 1. Serial Connector and Cable Pin Assignments Connector Pin Mnemonic Signal 1 DCD 2 RX RECEIVE DATA — Serial data output line 3 TX TRANSMIT DATA — Serial data input line 4 DTR DATA TERMINAL READY — Input signal that indicates on-line/in-line/active status 5 GND GROUND 6 DSR DATA SET READY — Output signal that indicates on-line/in-line service/active status 7 RTS REQUEST TO SEND — Input signal that requests permission to transfer data 8 CTS CLEAR TO SEND — Output signal that indicates a ready-to-transfer data status DATA CARRIER DETECT — Output signal that indicates detection of an acceptable carrier signal MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 29 Freescale Semiconductor, Inc. Installation Logic Cables and Connectors The diagram below shows the pin numbering for both pod A and pod B logic cable connectors of the station module. Table 2 details the pinout designations where an LCx assignment gives each logic clip connection a name. The logic clips are used to capture data in the bus state analyzer. (Pin 9 of both pods provides connection to an external ground.) In addition, the pod connectors are used as external clock inputs for the emulator clock and bus state analyzer timetag. The table also provides color code information for each pod. Freescale Semiconductor, Inc... The external clock inputs are through pin 17 of each pod. Pod A pin 17 is the external clock input for the emulator. To use this source, make the desired clock connection to the white probe tip and use the OSC command to select an external source. Pod B pin 17 is the external timetag input for the bus state analyzer. To use this source, make the desired clock connection to the white probe tip and use the TIMETAG command to select an external time tag source for the analyzer. 19 1 • • • • • • • • • • • • • • • • • • • • 20 2 MMDS0508OM/D 30 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Serial Connector and Cable Information Freescale Semiconductor, Inc... Table 2. Pod and Logic Cable Pin Assignments Pod Pin Pod A Signal Pod B Signal Probe Color 1 LC0 LC8 Brown (BRN) 2 GND GND 3 LC1 LC9 4 GND GND 5 LC2 LC10 6 GND GND 7 LC3 LC11 8 GND GND 9 LC4 LC12 10 GND GND 11 LC5 LC13 12 GND GND 13 LC6 LC14 14 GND GND 15 LC7 LC15 16 GND GND 17 EXT_OSC TT_OSC 18 GND GND 19 GND GND 20 GND GND Red (RED) Orange (ORG) Yellow (YEL) Green (GRN) Blue (BLU) Purple (PUR) Gray (GRY) White Black MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 31 Freescale Semiconductor, Inc. Installation Power Supply Fuse Replacement Freescale Semiconductor, Inc... The station module power switch/connector assembly contains a standard 1/4 x 1 1/4 inch, 1.6-ampere, 250-volt ceramic, time-delay fuse. Figure 3 shows this assembly with its door open (for fuse replacement). Power Cord Socket Fuse Door Power Switch Fuse Tab Figure 3. Power Switch/Connector Assembly MMDS0508OM/D 32 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Installation Power Supply Fuse Replacement Freescale Semiconductor, Inc... To replace the fuse, perform these steps: • Press the power switch OFF and disconnect the power cord. • Insert a small screwdriver at the tab on the right edge of the switch/connector assembly. (Figure 3 shows where to insert the screwdriver.) Gently pry open the assembly door, which swings open to the left. • Remove the fuse holder from the switch/connector assembly. Remove the fuse from the holder. • Insert the replacement fuse into the holder. Then re-install the holder in the switch/connector assembly. Make sure that the fuse holder arrow points down. Close the assembly door. • Reconnect the power cord. This completes fuse replacement. MMDS0508OM/D MOTOROLA Installation For More Information On This Product, Go to: www.freescale.com 33 Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Installation MMDS0508OM/D 34 Installation For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Loading and Initialization Contents Freescale Semiconductor, Inc... Software Distribution Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36 Installing MMDS Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36 Personality Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 Using MMDS Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 Running MMDS05 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38 Running MMDS08 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39 MMDS Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 MMDS0508OM/D MOTOROLA Loading and Initialization For More Information On This Product, Go to: www.freescale.com 35 Freescale Semiconductor, Inc. Loading and Initialization Software Distribution Format Freescale Semiconductor, Inc... MMDS software is distributed on 3.5-inch high-density diskettes. The install process places the RAPID environment files and the MMDS software files in the directory designated during the install process. Table 3 describes the system files required to control the MMDS system, where x denotes a version number. Refer to the Software Release Guide for information on other files loaded. Table 3. MMDS Software Files File Name MMDS05.EXE Description MMDS05 host software MMDS05X.EXE MMDS05 host software for running in a DOS window under Windows MMDS05Vx.HLP HELP command windows for the MMDS05 commands MMDS08.EXE MMDS08 host software MMDS08X.EXE MMDS08 host software for running in a DOS window under Windows MMDS08Vx.HLP HELP command windows for the MMDS08 commands Installing MMDS Software The install process will place MMDS and all supporting files on a hard drive. To install the MMDS files, insert the distribution diskettes into an active drive. Make the installation drive active by typing the drive letter followed by a colon (:) and press . Type INSTALL and press . Follow the directions as prompted by the install software. Refer to the Software Release Guide for further information on the installation process. MMDS0508OM/D 36 Loading and Initialization For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Loading and Initialization Personality Files Personality Files Various designs of MCUs require different configurations of the MMDS system. The appropriate setup for each MCU is specified in a unique personality file. Freescale Semiconductor, Inc... NOTE: These files are shipped with separately purchased EMs. Personality files are usually installed in the directory from which the MMDS software is executed. These personality files have a standard extension of.MEM. If a personality file is not located in the working directory, the software displays a search window used to find the correct file. To determine the personality files used by a particular EM module, refer to the appropriate EM user’s manual. More than one personality file can be installed; the MMDS operating software automatically loads the default personality file that corresponds to the currently connected EM module. As discussed in the following paragraph, other personality files can be loaded via the LOADMEM command or through use of the –M option. Using MMDS Software The correct executable file to run is dependent on which type EM is installed on the MMDS platform board. If an HC05 EM is installed, the MMDS05.EXE file should be run. If an HC08 EM is installed, the MMDS08.EXE file should be run. The following paragraphs discuss the proper syntax for running the HC05 and HC08 software. Alternatively, the MMDS can be called from within the RAPID environment. Running the MMDS05 or MMDS08 from RAPID may require running RINSTALL, RAPID’s configuration set-up program, to set up the directory path, serial port, etc., as described in the RAPID user’s manual. NOTE: If you plan to use the MMDS software in a DOS window under Windows, use the MMDS05X.EXE or MMDS08X.EXE files. MMDS0508OM/D MOTOROLA Loading and Initialization For More Information On This Product, Go to: www.freescale.com 37 Freescale Semiconductor, Inc. Loading and Initialization Running MMDS05 To call the debugger executable directly from the DOS prompt, type this command: C:\MMDS05>MMDS05 Note these five options for the startup command: 1. If the MMDS05 is connected to COM2, COM3, or COM4, add the corresponding integer to the command: C:\MMDS05>MMDS05 2 Freescale Semiconductor, Inc... 2. If the computer has a monochrome monitor, add BW to the command: C:\MMDS05>MMDS05 BW 3. To specify a personality file to be loaded automatically (instead of the default), add the –M option, followed by the filename (Do not put a space between the M and the filename). If the specified personality file has a .MEM extension, the .MEM extension may be omitted from the filename: C:\MMDS05>MMDS05 –M 4. To specify an S-record file (and any map file with the same name) to be loaded automatically, add the filename option. If the specified S-record file has a .S19 extension, the .S19 extension may be omitted from the filename: C:\MMDS05>MMDS05 5. To specify a default baud rate of 9600, add the –B option: C:\MMDS05>MMDS05 –B NOTE: Multiple options in the start-up command should be separated by a space. MMDS0508OM/D 38 Loading and Initialization For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Loading and Initialization Using MMDS Software Running MMDS08 To call the debugger executable directly from the DOS prompt, type this command: C:\MMDS08>MMDS08 Note these five options for the startup command: 1. If the MMDS08 is connected to COM2, COM3, or COM4, add the corresponding integer to the command: C:\MMDS08>MMDS08 2 Freescale Semiconductor, Inc... 2. If the computer has a monochrome monitor, add BW to the command: C:\MMDS08>MMDS08 BW 3. To specify a personality file to be loaded automatically (instead of the default), add the –M option, followed by the filename. (Do not put a space between the M and the filename.) If the specified personality file has a .MEM extension, the .MEM extension may be omitted from the filename: C:\MMDS08>MMDS08 –M 4. To specify an S-record file (and any map file with the same name) to be loaded automatically, add the filename option. If the specified S-record file has a .S19 extension, the .S19 extension may be omitted from the filename: C:\MMDS08>MMDS08 5. To specify a default baud rate of 9600, add the –B option: C:\MMDS08>MMDS08 –B NOTE: Multiple options in the start-up command should be separated by a space. MMDS0508OM/D MOTOROLA Loading and Initialization For More Information On This Product, Go to: www.freescale.com 39 Freescale Semiconductor, Inc. Loading and Initialization MMDS Communication The host program establishes communications with the MMDS system and displays the appropriate debug screen as shown in the section on user screens. If the host program fails to establish communications, an error screen appears and the system operation is returned to DOS. The information in the error screen helps determine why the software does not run. Freescale Semiconductor, Inc... For best performance of the system, communications between the host and the station module should be at the maximum available baud rate. At power-up, the host software automatically sets the maximum baud for the system. Reduce the baud rate if a communication error message appears. Refer to Running MMDS05 and Running MMDS08 on the preceding pages to set the start-up baud rate at 9600. If communication errors persist, turn off the disk cache (SMARTDRV.EXE) on the computer. Enter commands in response to the MMDS command prompt (>). When the emulation and debugging session has been completed, terminate the session by entering the EXIT or QUIT command. MMDS0508OM/D 40 Loading and Initialization For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42 Main Window Screens. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42 Status Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45 CPU Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Source/Code F2 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Code F2 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Source Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48 Variables F8 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49 Memory F3 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 Debug F10 Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50 Pop-Up Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51 Stack Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52 Set Memory Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53 Baud Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54 Emulator Clock Frequency Window . . . . . . . . . . . . . . . . . . . . . . . .54 Other Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55 Mouse Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56 Changing Screen Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58 MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 41 Freescale Semiconductor, Inc. User Screens Introduction Freescale Semiconductor, Inc... The user interface screen to the MMDS development system consists of a status area, five static main windows and several pop-up windows. The screen displays the code, data and status information required for the user to control the emulation environment. This section provides a description of the screen functionality, including mouse operation. The screens associated with the bus state analyzer will be covered in the Bus State Analysis section. Main Window Screens Figure 4 and Figure 5 show the debug screen for the MMDS05 and the MMDS08 versions of the software, respectively. The screen is identical for both versions of the software except for the CPU window. The screen consists of a status area and five static windows which display source or object code, variables, the command line and the contents of the CPU registers or memory. To carry out actions associated with a window of the debug screen, select the window. To select a window, press the numbered function key included in the window title. For instance, press the F2 key to select the source/code F2 window, press the F8 key to select the variables F8 window, and so forth. To return to the debug command line, press F10. Note that several operations can also be mouse controlled. Refer to Mouse Operation on page 56 for detailed information on mouse usage. Table 4 lists the key commands available in any of the main windows. MMDS0508OM/D 42 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA MOTOROLA Xreg B9 SP FF CCR 111HIN.C br pc resetin 0080 0088 0090 0098 go DEBUG F10 User Screens For More Information On This Product, Go to: www.freescale.com 53 47 04 50 31 2F 20 54 stop ;clears ↑ Figure 4. MMDS05 Debug Screen ↓ ↑ ↓ gotil step info zoom MEMORY F3 3D 44 43 48 41 52 S1=DCHAR ↑ 43 48 41 52 47 45 G/CHARGE 20 20 53 32 3D 4F. S2=0 49 4F 4E 53 20 20 PTIONS ↓ rslt+4 clrbgn 0,x #flag #$40 tcr SOURCE: init.asm F1:Help F2:Code F3:Mem F4:BSA_data F5:BSA_setup F8:vars F9:rpt F10:Debug Inst brkpt/Illegal Address delete A+B+C+D Inst brkpt/Illegal Address >BR 0029 >g >idle > Armed idle lda sta ldx clra clrbgn sta incx -B> cpx bne begin ↓ logfile COM1:57600 VARIABLES F8 RSLT $0000 !0 ↑ CLKTIME $30 %00110000 CURVAL $00 %00000000 DISLINE1 S1=DCHAR Acc 00 PC 0029 CPU Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. User Screens Main Window Screens MMDS0508OM/D 43 44 Hreg 00 SP 00F3 Xreg F1 CCR .11.IN. begin go #flag ldx clra sta incx cpx bne stop ;clears ↑ User Screens For More Information On This Product, Go to: www.freescale.com Figure 5. MMDS08 Debug Screen F9:rpt F10:Debug ↓ ↑ ↓ gotil step info zoom MEMORY F3 3D 44 43 48 41 52 S1=DCHAR ↑ 43 48 41 52 47 45 G/CHARGE 20 20 53 32 3D 4F. S2=0 49 4F 4E 53 20 20 PTIONS ↓ rslt+4 clrbgn 0,x #$40 tcr lda sta SOURCE: init.asm 0050 53 31 0058 47 2F ↓ logfile delete COM1:57600 0060 04 20 Armed A+B+C+D targetpwr 0068 50 54 idle Inst brkpt/Illegal Address DEBUG F10 >BR 00A7 >g >idle Inst brkpt/Illegal Address > F1:Help F2:Code F3:Mem F4:BSA_data F5:BSA_setup F8:vars br pc resetin VARIABLES F8 RSLT $0000 !0 ↑ -B>clrbgn CLKTIME $30 %00110000 CURVAL $E7 %11100111 DISLINE1 S1=DCHAR Acc FE PC 00A8 CPU Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. Main Window Screens MMDS0508OM/D MOTOROLA Freescale Semiconductor, Inc. User Screens Main Window Screens Table 4. Key Functionality of Debug Screen Windows F1 Activate the HELP pop-up window F2 Activate the Code F2 window (if object code is displayed) F3 Activate the Memory F3 window F4 View the bus state analyzer data screen F5 View the bus state analyzer setup screen F8 Activate the Variables F8 window F9 Repeat the preceding command F10 or Returns to debug F10 window Scrolls the window down one line, same as clicking on the ↓ symbol at window edge ↑ Scrolls the window up one line, same as clicking on the ↑ symbol at window edge Page Down Page Up Status Area Description ↑ Freescale Semiconductor, Inc... Key Scrolls the window down one page Scrolls the window up one page Alt-X Terminates host session Alt-S Writes screen contents to log file Home Scrolls the window to the home line Delete a highlighted variable in the Variables F8 window The status area, located at the left center of the debug screen, displays several items of status information. Table 5 explains the indicators that may appear in this area. MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 45 Freescale Semiconductor, Inc. User Screens Freescale Semiconductor, Inc... Table 5. Status Area Indicators Indicator, Position Status, Meaning Bus analyzer state, left screen edge, below variables F8 window Armed — bus analyzer is armed and waiting for a trigger Disarmed — bus analyzer is disarmed Bus analyzer sequence mode, below variables F8 window Continuous all — continuous trace, all cycles Continuous events — continuous trace, events only Counted all — counted trace, all cycles Counted events — counted trace, events only A+B+C+D — trigger on event A, B, C, or D A+B>C+D — trigger on event A or B, then C or D A>B>C!D — trigger on events A, B, and C, in order, unless event D occurs A>B>C>D — trigger on events A, B, C, and D, in order Nth A+B+C+D — trigger on Nth event A, B, C, or D MCU state, left screen Idle, Running, Stopped, Wait, or In Reset followed by edge above debug F10 the reason for a status change window RESETIN signal state, below source/code F2 window Resetting — Target system can reset emulating MCU (blank) — Target system cannot reset emulating MCU RESETOUT signal state, between variables F8 and memory F3 windows Resetout — RESET command resets emulating MCU and the target system (blank) — RESET command resets only the emulating MCU Logging state, between Logfile — Logging in progress variables F8 and (blank) — Logging not in progress memory F3 windows Target system power, between variables F8 and memory F3 windows Target pwr — Target system power is on (blank) — Target system power is not detected Communications port COMX:BBBBB — The host software is communicating and rate, above debug with the MMDS through port X, at BBBBB baud F10 window Special status Inst brkpt/Illegal Address — A breakpoint or illegal message, to the right address has been encountered and execution has of the MCU state status halted area, above debug F10 Write protect — An attempt was made to write to window memory designated as ROM or is unused memory space. Program counter will be at the next instruction that would have been executed had the error not occurred. MMDS0508OM/D 46 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Main Window Screens CPU Window Freescale Semiconductor, Inc... NOTE: The CPU window is located at the upper left of the debug screen. This window displays the contents of the accumulator (A register), the index register (X register), the program counter (PC), the stack pointer (SP), and the condition code register (CCR). When a new value for any of these registers is entered, the new value appears in the window. For MMDS08 users an additional register, the H register (upper byte of the index register), is shown as well as the V bit in the CCR. The CCR bit designators are located at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is interrupt mask, N is negative, Z is zero, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Note that this window cannot be selected and cannot be used to change values. Instead, this window shows changes made via other windows or changes that occur due to running code. Source/Code F2 Window The window located in the upper right corner of the screen has two operating modes. The functionality of the window is different for each of the operating modes. Under certain conditions explained below, you may toggle between the operating modes. One mode (Code F2) displays the object code from a .S19 file loaded into the MMDS system. The other mode (Source) displays the source code from a .MAP file loaded into the MMDS system at the same time as the object code. More detail and a description of the differences in the operating modes are discussed below. Code F2 Window On entering MMDS software, the window defaults to object code, the window title is CODE F2, and window contents are a disassembled representation of MCU memory. In this object code display, the disassembled instructions change when corresponding bytes of memory change. To scroll through this window, press the F2 key (to select the window), then use the arrow keys, since the mouse does not function with this window. MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 47 Freescale Semiconductor, Inc. User Screens Source Window When a .MAP file exists in the same directory as the .S19 file, the MMDS software loads both files at the same time and the source code generated from the .MAP file is available for use in the debug process. The contents of this window change to source code (and the title changes to SOURCE:filename.asm) if: 1. A .MAP file has been loaded and 2. The program counter (PC) points to a memory area covered by the .MAP file. Freescale Semiconductor, Inc... Once a .MAP file has been loaded and the PC points to an area of user code, the SOURCE command can be used to toggle between source code and object code. If a mouse is installed, the symbols that appear at the bottom of the source window can be selected. Use the mouse or arrow keys to scroll through the information in the window. There are several Alt-commands associated with the source window. The list of Alt-commands appears at the bottom of the debug screen when the key is pushed. Table 6 lists the key commands available in this window when a source code is displayed. NOTE: The F2 function key does not activate this window in the source code operating mode. The Source window and the Debug F10 window will both be active at the same time. Use the mouse or arrow keys to select/scroll the information in the Source window. MMDS0508OM/D 48 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Main Window Screens Table 6. Source Window Key Commands Freescale Semiconductor, Inc... Name Variables F8 Window NOTE: Key Description Breakpoint Alt-B Sets or removes a breakpoint at highlighted line Exit Alt-X Terminates debug session Find Alt-F Finds the first occurrence of the specified string in the source file Find Next Alt-L Finds the next occurrence of the specified string in the source file GoTil Alt-G Executes code from the current PC address to the highlighted line List Modules Alt-M Lists available source code modules PC Alt-P Sets the program counter (PC) to the address on the highlighted line Zoom Alt-Z Toggles the size of the source window between normal and enlarged The variables F8 window, located at the left side of the debug screen, is initially blank. The window shows as many as 11 variables, specified via the RTVAR or VAR command. Press the F8 function key to select this window so that the arrow keys can highlight existing variables. If more than 11 variables have been declared, use the arrow keys and the page up/down keys to display all variables. To delete a previously set variable, highlight the variable and press the delete key. The delete operation can be performed via the mouse by selecting the variable and clicking on the word DELETE at the bottom of the window. It is possible to specify as many as 32 variables via the VAR and RTVAR commands. The variables appear with their current values in hexadecimal, binary, decimal, or ASCII format. Refer to the section entitled Command-Line Commands for more information about the RTVAR and VAR commands. MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 49 Freescale Semiconductor, Inc. User Screens Freescale Semiconductor, Inc... Memory F3 Window The memory F3 window, located at the right side of the debug screen, displays the contents of 32 memory locations. The value stored at a specific location is displayed in both hexadecimal and ASCII format. In the ASCII area to the right in the window, control and other non-printing characters appear as periods (.). As the contents of these locations are modified, the new values appear in this window. Use the scroll bar to the right of the window to display other areas of memory. To select this window, press the F3 function key. The scroll bar disappears; use the arrow keys and the page up/down keys to display lower or higher address ranges. If real-time memory has been declared, the 32-byte block beginning at the declared location will be displayed while code is executing. If real-time memory has not been declared, dashes replace the values when code is executing. Updated values reappear when execution stops. Refer to the section entitled Command-Line Commands for more information about the RTMEM command. Debug F10 Window The debug F10 window, located at the bottom of the debug screen, is the default active window. This window contains the command line, identified by the command prompt (>). Enter (type) a command at the prompt. To process the command, press (that is, press the ENTER, RETURN, or carriage-return key). The software displays any additional prompts, messages, or data that pertain to the command. If the command is not entered correctly or is not valid, the software displays an appropriate error message. Refer to the section entitled Command-Line Commandsf or a list and explanation of the of the available commands. After command execution, the software again displays the command prompt. As a new line appears in the debug F10 window, preceding lines scroll upward. The window displays as many as four lines. When any other window is selected, the cursor disappears from the debug F10 window. To return to the debug F10 window, press the F10 function key. MMDS0508OM/D 50 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Pop-Up Windows The MMDS maintains a command buffer of commands entered on the command line. The mouse can be used to select the ↓ and ↑ arrow symbols to sequence forwards or backwards through the command buffer. Press the key to then repeat the command. To repeat the last command executed at any time, press the F9 key. Pop-Up Windows Freescale Semiconductor, Inc... In addition to the five main windows, several temporary pop-up windows such as the bus state analyzer windows, the stack window, the set memory window, the baud window, and the emulator clock frequency window may appear during MMDS operation. Table 7 lists the key commands for these subordinate windows. Table 7. Window Key Commands Key Description ↑ Moves cursor up one line ↑ ↑ Moves cursor down one line Moves cursor left ↑ Moves cursor right Home End Moves cursor to top line of window Moves cursor to bottom line of window Page Down Scrolls down one page (HELP only) Page Up Scrolls up one page (HELP only) F6 Saves memory map to file (SETMEM only) and applies memory map to the MMDS F7 Applies memory map to emulator and returns to debug screen (SETMEM only) Applies selection to emulator and returns to debug screen, except SETMEM For HELP, displays window for selected item For COLORS, accepts the existing color selection For STACK, returns to the debug screen Returns to debug screen without applying selection to emulator For COLORS, returns to the debug screen without accepting any more colors For STACK, returns to the debug screen MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 51 Freescale Semiconductor, Inc. User Screens Stack Window Freescale Semiconductor, Inc... NOTE: The temporary stack window appears near the center of the debug screen when the STACK command is entered. As Figure 6 shows, this window displays the contents of the SP register at the top of the window. The 12 bytes at the top of the stack are displayed to the left. The interpretation of the stack shown to right in the window is valid only if the last push to the stack was caused by an interrupt. Press the key to remove the stack window and return to the debug window. The interrupt stack data to the right side of the window is an interpretation of the top five bytes on the stack. If the last push to the stack was due to a BSR or JSR instruction, five bytes were not pushed to the stack and the interrupt stack information is invalid. STACK Stack Pointer = 00F8 Raw Bytes: .... . .... . .... . .... . 00FF 7D 00FE 01 00FD 44 00FC 02 00FB 10 00FA FF 00F9 E5 SP> 00F8 07 Interrupt Stack: ...HINZC CCR > 11100101 A > FF X > 10 ret > 0244 Figure 6. Stack Window MMDS0508OM/D 52 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Pop-Up Windows Set Memory Window The temporary set memory window (Figure 7) appears near the center of the debug screen. Enter the set memory (SETMEM) command to customize the memory map. The SETMEM command allows mapping over memory defined as RAM, ROM, or undefined. However, mapping over internal resources such as option RAM, I/O, or EEPROM is not allowed. Freescale Semiconductor, Inc... Custom Map RAM0 0080 00FF RAM1 XXXX XXXX RAM2 XXXX XXXX RAM3 XXXX XXXX ROM0 ROM1 ROM2 ROM3 0020 0100 1FF0 XXXX Vector 004F 08FF 1FFF XXXX 1FFE F6:SAVE F7:EXECUTE :CANCEL Figure 7. Set Memory Window MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 53 Freescale Semiconductor, Inc. User Screens Freescale Semiconductor, Inc... Baud Window The temporary baud window (Figure 8) appears near the center of the debug screen when the baud (BAUD) command is entered. The BAUD command sets the baud rate for communications between the system controller and the host computer. This window shows the available baud rates. BAUD 2400 4800 9600 19200 38400 57600 Figure 8. Baud Window Emulator Clock Frequency Window Depending on the EM board used, the MMDS platform board can supply the oscillator clock for the MCU’s OSC1 input. This clock source can be an internally generated source or an external source input through the white logic clip of pod A. Note that the EM being used will require a specific jumper configuration in order to use the platform board clock source. Refer to the EM user's manual for the availability of this feature. For the MMDS05, five clock frequencies are available. The four internally generated clock frequencies are: 8 MHz, 4 MHz, 2 MHz, and 1 MHz, and an external clock source. Entering emulator clock (OSC) command without the designated frequency brings up the temporary MMDS emulator clock frequency window near the center of the debug screen. Use the up/down arrow keys to select the emulator MCU's clock frequency and press to complete the selection. The default emulator clock rate is 2 MHz as shown in Figure 9. EM OSC 8 Mhz. 4 Mhz. 2 Mhz. 1 Mhz. External Figure 9. MMDS05 Emulator Clock Frequency Window MMDS0508OM/D 54 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Pop-Up Windows For the MMDS08, six clock frequencies are available. The five internally generated clock frequencies are available: 16 MHz, 8 MHz, 4 MHz, 2 MHz, and 1 MHz and an external clock source. The default emulator clock rate is 4 MHz as shown in Figure 10. Freescale Semiconductor, Inc... Before changnig the clock rate, make sure that the emulation MCU supports the desired frequency and the appropriate jumpers are set correctly. EM OSC 16 Mhz. 8 Mhz. 4 Mhz. 2 Mhz. 1 Mhz. External Figure 10. MMDS08 Emulator Clock Frequency Window Other Windows In addition to the screen windows described in this section, several other transient dialog windows will be encountered. Those windows encountered while using the bus state analyzer will be discussed in the Bus State Analysis section. Many are for file search selections in which the directory paths can be scanned for a desired file. Other windows will appear when using help commands. To select an item from a menu or file list, move the highlight cursor using the ↑ and ↓ keys to the desired item and press . To close a window without selecting an item, press the key. MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 55 Freescale Semiconductor, Inc. User Screens Mouse Operation MMDS software supports a Microsoft, Logitech, or IBM mouse. Install the mouse according to the manufacturer's instructions, using the accompanying mouse driver software. Mice made by other manufacturers may be compatible, but Motorola does not guarantee their performance with the MMDS system. Freescale Semiconductor, Inc... Some MMDS operations can be accomplished by using an installed mouse to select a desired function. Note that the select symbols are only visible if a mouse is installed. The mouse can be used to scroll through the source window, variables F8, memory F3, the bus state analyzer data F4, and debug F10 windows. “Clicking on” an item means positioning the mouse cursor on the item, then quickly pressing and releasing the left mouse button. The mouse operations are: • General – Scroll through a window — Click on the ↑ and ↓ symbols to right edge of the selected window. • Variable F8 Window – Highlight items in the source and variables F8 windows — Move mouse over desired item and click. – Delete the highlighted variable in the variables F8 window — Click on the word DELETE at the bottom of the window. – Pressing the right button of the mouse to duplicate the functionality of the key. MMDS0508OM/D 56 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. User Screens Mouse Operation Freescale Semiconductor, Inc... • Source Window – Set the PC to the address of the instruction on a highlighted line — Click on PC at the bottom of the source window. – Set or clear a breakpoint at the highlighted instruction in the source window — Click on BR at the bottom of the source window. – Begin executing instructions starting at the PC address — Click on GO at the bottom of the source window. – Stop executing instructions — Click on STOP at the bottom of the source window. – Execute instructions beginning with the instruction at the address in the PC and stopping at the highlighted instruction in the source F2 window — Click on GOTIL at the bottom of the source window. – Execute the instruction at the address in the PC — Click on STEP at the bottom of the source window. – Display the source file line number of the highlighted line of the source F2 window, along with its address, disassembled contents, and the name of the file — Click on INFO at the bottom of the source window. – Toggle the size of the source window between normal and enlarged — click on ZOOM at the bottom of the source window. MMDS0508OM/D MOTOROLA User Screens For More Information On This Product, Go to: www.freescale.com 57 Freescale Semiconductor, Inc. User Screens Changing Screen Colors To change screen colors, enter the COLORS command from the debug screen; the colors window appears. This window includes a list of screen elements and a matrix of foreground/background color combinations. Each color combination has a 2-digit hexadecimal number. Freescale Semiconductor, Inc... A prompt asks for the color of the first screen element. To accept the current color, press . To change the color, enter the number of the choice, then press . A new prompt asks for the color of the next element. Select the color for each element in the same way. The command ends when a color has been selected for the last screen element or when ESC is pressed. In the color matrix, rows correspond to background colors and columns correspond to foreground colors. This means that color choices from the same row result in differently colored letters and numbers against the same background color. Making the background of highlights and help screens a different color sets these elements off from the main screen. The software stores color selections in file COLORS.05 or COLORS.08. When MMDS is executed again, the software applies the newly selected colors. Use the color selection file with another system to retain the selected colors. NOTE: Delete the COLORS file from the MMDS subdirectory to return to the default colors. MMDS0508OM/D 58 User Screens For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60 System Initialization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60 Setting Communications Baud Rate . . . . . . . . . . . . . . . . . . . . . . . .61 Standard Memory Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61 Custom Memory Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62 Initializing the Clock Speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Loading User Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Initializing Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Initializing Assembly Language . . . . . . . . . . . . . . . . . . . . . . . . .64 Initializing Memory Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65 System Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66 Script Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66 Information Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67 Log File Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68 Debug Screen Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69 Exit the Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70 Debug Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Setting CPU Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Memory Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71 Reset Control of the Emulation System . . . . . . . . . . . . . . . . . . . . .72 Using Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72 Tracing Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 Execution Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73 Bus State Analyzer Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Configuring the Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Capturing Analyzer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 Viewing Analyzer Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74 MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 59 Freescale Semiconductor, Inc. Operation Fundamentals Introduction An emulation system gives the user the tools needed to develop an embedded MCU application in the most efficient way possible. This section describes the basic operation of the MMDS. Detail of specific commands is available in Command-Line Commands. Freescale Semiconductor, Inc... Operation of the MMDS may be divided into four main areas: • System Initialization • System Information • Debug Operation • Bus State Analyzer Operation A start-up script file, described in Script Commands on page 66, can be set up to perform a set of commands automatically each time the MMDS software is run. This start-up file must have the name STARTUP.05 or STARTUP.08. System Initialization Initializing the MMDS system includes: • Initializing the communications baud rate • Setting the memory map • Initializing the clock speed • Loading user software and a symbol table • Initializing memory Each part of initialization and use of the appropriate commands is discussed here. MMDS0508OM/D 60 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals System Initialization Freescale Semiconductor, Inc... Setting Communications Baud Rate For best system performance, communications between the host and the station module should be at the maximum available baud rate. At power-up, the MMDS system automatically negotiates the maximum baud for the system. All data transfers between the host computer and the station module are at the specified baud rate; maximum performance is at the highest rate the computer supports. Use the BAUDCHK command to determine and set that rate. However, if the software displays communications error messages, reduce the baud rate. Use the BAUD command to change the baud rate. The possible rates are 2400, 4800, 19200, 38400, and 57600 baud. If the BAUD command is entered with no rate value, the baud window appears over the debug screen. To select a rate from this window, use the arrow keys to highlight the rate, then press or double click the mouse when the cursor is on the desired baud rate. Standard Memory Mapping Various MCU designs require different memory map configurations of the MMDS system. The appropriate memory map is specified in a personality file for each MCU that the EM supports. These files are shipped with the separately purchased EMs. Refer to the appropriate EM user’s manual to determine the personality files used by a particular EM module. Personality files are usually installed in the directory from which the MMDS software is executed. If a personality file is not located in that directory, the software displays a search window used to find the correct file. The MMDS operating software automatically loads the default personality file that corresponds to the EM module currently connected. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 61 Freescale Semiconductor, Inc. Operation Fundamentals Custom Memory Mapping Freescale Semiconductor, Inc... NOTE: For creating custom memory configurations, use the customize memory map (SETMEM) command. When this command is entered, the set memory window appears over the debug screen. Via this window, as many as four blocks of RAM and four blocks of ROM can be defined. (ROM is write-protected; attempting to write to ROM stops program execution.) The SETMEM command can be used to expand the normal RAM and ROM ranges temporarily during debugging. Be sure to restore the original size and configuration of the MCU memory before final debugging. Otherwise, the code could fail to fit or run in an MCU’s memory space. For each memory block, specify the address range and memory type. To write the map to a file, press the F6 function key, then enter a filename in response to the prompt. To prevent loss of system files, a custom filename should not duplicate any files shipped with an EM module. Press the F7 key to apply the map to memory without saving the map to a file for future use. To cancel the command, press . Use the load personality file (LOADMEM) command to load a stored custom map during future emulation sessions. Note that the LOADMEM command can be part of the start-up script file, so that loading the custom map becomes an automatic part of MMDS start-up (.MEM files also can be loaded at start-up by using the –M option with the MMDS executable.) The LOADMEM command also can be used to restore the standard memory mapping. Refer to the appropriate EM user’s manual to determine the default personality files used by a particular EM module. MMDS0508OM/D 62 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals System Initialization Freescale Semiconductor, Inc... Initializing the Clock Speed The MMDS platform board can supply an oscillator clock source for the MCU’s OSC1 input. Clock control is available via the OSC command. Note that many EMs require a specific jumper configuration so that this clock source can be used. Refer to the specific EM user's manual for EM clock source information. For the MMDS05, five clock frequencies are available: four internally generated clock frequencies, 8 MHz, 4 MHz, 2 MHz, and 1 MHz and an external clock source. The external clock source should be supplied via the white logic clip of pod A. Entering the emulator clock (OSC) command without the designated frequency brings up the temporary MMDS emulator clock frequency window near the center of the debug screen. For the MMDS08, six clock frequencies are available: five internally generated clock frequencies, 16 MHz, 8 MHz, 4 MHz, 2 MHz, and 1 MHz, and an external clock source. Loading User Software Software for the target system must be available on the host computer in S-record format. Use the LOAD command to load an S-record file into the emulator and the accompanying map (symbol) file into the host computer. The assembler shipped with the MMDS (CASM) has the ability to generate a current map each time an assembly program is assembled. The specific S-record to load can be specified on the command line by typing the S-record filename after the LOAD command. If the file has the extension.S19, then the extension can be omitted. Alternatively, if no filename is specified, then a search window appears, displaying the files with a.S19 extension in the current directory. Initializing Memory During a debugging session, specific memory locations should contain known values. The required values are stored in memory as numeric values or as instructions assembled individually. The commands that store and manipulate the contents of memory are described in the following paragraphs. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 63 Freescale Semiconductor, Inc. Operation Fundamentals Freescale Semiconductor, Inc... Initializing Assembly Language The assemble instructions (ASM) command is important for making minor alterations to object code. This command displays the specified address and its contents followed by a prompt. Enter a valid instruction and press . The command assembles the code, stores the code in memory at the indicated address, and displays the instruction. The command then updates its location counter and displays the updated address and a prompt for the next instruction. The ASM command continues to assemble code one line at a time until a period (.) is entered. NOTE: Changes made to code via the ASM command cannot be saved to an S-record file or to a source code file. This command should be used only to create and modify code to be run during the current debug session. NOTE: If the source/code F2 window shows source code and the ASM command is used to modify the code, the source/code F2 window continues to show unmodified source code. Enter the CLEARMAP command to delete the source code display. To incorporate modifications into source code, reassemble the code and download again. The disassemble instructions (DASM) command complements the ASM command. The DASM command allows memory contents to be disassembled, displaying the assembly instructions that correspond to the values in the specified memory address range. Each DASM command disassembles three instructions and displays the addresses, the opcodes, and the operands where appropriate. When the DASM command is entered with two addresses, it disassembles instructions beginning at the first address and ending with the instruction at the second address. If the range includes three or more instructions, only the last three disassembled instructions are displayed in the debug F10 window. The entire block is written to a log file when one is open. MMDS0508OM/D 64 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals System Initialization Initializing Memory Data The block fill (BF) command allows placement of numeric values in a block of memory addresses. This command defines a block of memory, then places a byte or word pattern throughout the range. The memory modify (MM) command lets the user interactively examine and modify contents of memory locations. If any data arguments are entered with this command, the system stores the values beginning at the specified address. Freescale Semiconductor, Inc... When only an address is supplied, the command displays the contents of the address followed by a prompt. Enter the value and press . The command displays the next address and its contents. The command continues to store the values entered until a period (.) is entered. Both the BF and MM writes to memory are verified; a "write did not verify" message is displayed if the write could not be verified. Note that this message may be acceptable in some situations, such as writing to registers that have write-only bits. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 65 Freescale Semiconductor, Inc. Operation Fundamentals System Commands Freescale Semiconductor, Inc... System commands for the MMDS perform these functions: • Executing commands contained in script files • Obtaining information about the emulator and the host system • Capturing and saving data displayed on the screen in a log file • Controlling the format of the debug screen • Leaving the MMDS environment temporarily or permanently The following paragraphs cover usage of the system commands. Script Commands The execute script file (SCRIPT) command reads commands from a script file and passes them to the command interpreter for execution. Entering the one SCRIPT command has the same effect as entering the sequence of commands contained in the script file individually. Using script files saves time and promotes accuracy. A script file is a text file of MMDS commands and is appropriate for any sequence of commands that is used often. A special script file, given the filename STARTUP.05 or STARTUP.08, executes automatically each time the MMDS software is loaded. Sometimes a script file must contain a pause between commands. The pause (WAIT) command causes the command interpreter to wait before processing subsequent commands. As part of the WAIT command, the wait time can be entered in seconds. If a time value for the WAIT command is not entered, the command interpreter pauses for five seconds. NOTE: All values entered on the MMDS command line are hexadecimal. The input value 10, for example, is the decimal value 16. The BELL command will sound the computer bell the specified number of times. This is useful to let the user know script command execution has reached a certain point. MMDS0508OM/D 66 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals System Commands The REM command adds a display comment to a script file. When the script file is executed, the system displays this comment. NOTE: Freescale Semiconductor, Inc... Information Commands All other MMDS commands can be contained in the script file. The EVAL command performs mathematical operations on two numerical arguments. It displays the value of the result in hexadecimal, decimal, octal, and binary formats denoted by the suffixes H, T, O, and Q. If the value is equivalent to an ASCII character, the ASCII character also is displayed. This command supports addition (+), subtraction (–), multiplication (*) and division (/). The REG command displays the contents of the CPU registers in the debug F10 window. The command also will display the instruction pointed to by the current program counter value. The temporary stack window appears near the center of the debug screen when the STACK command is entered. This window displays the contents of the SP register at the top of the window. The 12 bytes at the top of the stack are displayed to the left. The interpretation of the stack shown to right in the window is valid only if the last push to the stack was caused by an interrupt. NOTE: The interrupt stack data to the right side of the window is an interpretation of the top five bytes on the stack. If the last push to the stack was due to a BSR or JSR instruction, five bytes were not pushed to the stack and the interrupt stack information is invalid. For information about a highlighted line in the source/code F2 window (filename, line number, address, and so forth) use the INFO command. To display the value of a symbol defined in a map (symbol) file, use the WHEREIS command. The display version (VER or VERSION) command displays the version number of the host software and the personality file. The system information (SYSINFO) command shows the amount of host computer memory remaining. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 67 Freescale Semiconductor, Inc. Operation Fundamentals The display memory map (SHOWMEM) command displays the RAM and ROM range of the current map. Freescale Semiconductor, Inc... The display help information (HELP) command displays a dialog window from which to access the MMDS help system. Note that the help system is context sensitive: Highlight an element of a screen, then press the F1 help key for corresponding help information. The chip help information (CHIPINFO) command gives access to register and user vector locations, MCU memory-map, and pin-out information specific to the part being emulated. Note that this help information is only available on certain parts. A message is displayed if no help is available. Note that the help system is context sensitive: Highlight an element of a screen, then press the for corresponding help information. The view file (VF) command allows for text file viewing within a pop-up screen. Log File Commands The MMDS can maintain a log file that will capture events displayed on the debug screen. Entries in the log include: • Commands entered on the command line • Commands read from a script file • Responses to commands • Error messages • Notifications of changes in status, such as breakpoints and WAIT or STOP instructions. • Pictures of the main screen • Pictures of the bus state analyzer data screen With the log file (LF) command, a file can be opened to receive information being logged. If the specified file already exists, the system allows appendage of the current log information to that file, or replacement of file contents with the current log information. While the log file remains open, the log information is written to the file. Enter another LF command to terminate logging to the file. MMDS0508OM/D 68 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals System Commands NOTE: The LF command does not automatically append a filename extension to log files. Motorola recommends that the extension .log for log files be used. Freescale Semiconductor, Inc... The save screen (SNAPSHOT) command will save the debug screen to an opened log file. The first and last 20 records of analyzer data can be logged by first using the upload trace buffer (GETBSA) command to upload the analyzer data. The go to trace buffer start (HOMEBSA) command followed by a log bus state analyzer (SCREENBSA) command will save the opening records in the bus state analyzer data to an open log file. The go to trace buffer end (ENDBSA) command followed by a log bus state analyzer (SCREENBSA) command will save the ending records in the bus state analyzer data to an open log file. Debug Screen Control The source window display (SOURCE) command toggles between source code and disassembled code in the source/code F2 window located at the upper right of the debug screen. On entering MMDS software, the window defaults to disassembled code, the window title is CODE F2, and window contents are a disassembled representation of MCU memory. In this object code display, the disassembled instructions change when corresponding bytes of memory change. Source code will be displayed if an S-record file and its corresponding map file are loaded and the PC points to a memory area covered by the map file. Once a .MAP file has been loaded and the PC points to an area of user code, the SOURCE command can be used to toggle between source code and object code. If a mouse is installed, the symbols that appear at the bottom of the window can be selected. Use the mouse or arrow keys to scroll through the information in the window. Note that the F2 key does not pertain to this window if it shows source code. NOTE: When memory data that was generated from a source file is altered, the modified code appears in the code window but not the source file window. Use the CLEARMAP command to delete the source file from the source code display. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 69 Freescale Semiconductor, Inc. Operation Fundamentals Freescale Semiconductor, Inc... The resize source window (ZOOM) command toggles the size of the source window between normal and enlarged. The enlarged window can be helpful by allowing improved visibility of comments in the source file. The enlarged window will remove the CPU registers window from the debug screen. The registers will be re-displayed by typing the ZOOM command again. The set screen colors (COLORS) command can be used to alter the default screen colors displayed in the various windows of the emulation environment. To return to the default colors, delete the filename COLORS.05 or COLORS.08 in the MMDS working directory. Exit the Environment The debug environment can be exited either temporarily or permanently. To shell to DOS temporarily, use the SHELL command. Type EXIT at the DOS prompt to return to the MMDS environment. To exit the current debug session permanently, execute the EXIT or QUIT command. The emulation system also can be exited by pressing the Alt-X keys. MMDS0508OM/D 70 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals Debug Commands Debug Commands Freescale Semiconductor, Inc... The MMDS commands that apply to the debugging phase of system development are described in this section. Setting CPU Registers The contents of the CPU registers and the condition code register are displayed in the CPU window. These registers – A, H (MMDS08 only), X, PC, SP, and CCR – contain the environment for execution of an instruction and, after the instruction has been executed, the results. Any of these registers, except SP, can be modified by entering the corresponding register designator command and an appropriate value. The commands that affect the CPU registers are A, ACC, X, XREG, PC, CCR, H, I, N, Z, and C. Additional commands to support the M68HC08 MCU are HX, HREG, and V. When is pressed, the register display shows the new value. Refer to Command-Line Commands for examples on how to modify CPU register values. Memory Display Memory contents are displayed in the memory F3 window. When code execution is stopped, 32 consecutive bytes of memory are displayed in both hexadecimal and ASCII format. The memory display (MD) command specifies the beginning location of the 32 bytes displayed. The window can be scrolled via the mouse or by selecting the window (F3) and using page up/down keys to view other memory ranges. A special use of the memory F3 window is for displaying real-time memory during code execution. The display real-time memory (RTMEM) command specifies the beginning location of a 32-byte clock to display and periodically update during code execution. The display real-time variable (RTVAR) command and display variable (VAR) command display the specified address and its contents in the variables F8 window. Real-time variables are periodically updated during code execution while normal variables are only displayed when code execution is stopped. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 71 Freescale Semiconductor, Inc. Operation Fundamentals As many as 32 variables can be declared in the variables F8 window. The window shows 11 variables at a time. If a map file has been loaded, symbols (labels) from the source code can be used as arguments. Freescale Semiconductor, Inc... The variables can be displayed in byte, word, or string format. A byte display is hexadecimal and binary, while a word display is hexadecimal and decimal, and a string display is ASCII. For an ASCII string, the number of characters displayed can be specified. Control and other non-printing characters appear as periods (.). Reset Control of the Emulation System The RESET command resets the emulation MCU and sets the PC to the contents of the reset vector. User code is not executed during this command. The RESETGO command carries out the same actions as the RESET command, then starts code execution from the PC-value address. The RESETIN command allows the reset signal to enter into the emulation system through the target cable; this signal must be enabled for correct operation of the WAIT4RESET command. The RESETOUT command allows the RESET command to send a reset signal out the target cable. Using Breakpoints The set instruction breakpoint (BR) command sets a breakpoint at a specific address or at each address of a range. Breakpoint addresses must be instruction fetch (opcode) addresses. A maximum of 64 breakpoints can be set. If the BR command is entered without any address, the command displays all active breakpoints. To clear breakpoints, use the clear breakpoints (NOBR) command. An instruction breakpoint occurs when the MCU accesses an instruction at a specified address or an address within a specified address range. When execution arrives at a breakpoint address, emulation stops just before execution of the instruction at that address and the software displays this message: idle Inst brkpt/Illegal Address MMDS0508OM/D 72 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals Debug Commands A properly defined breakpoint permits analysis of the contents of registers and memory locations and the states of various signals at designated addresses in the program. NOTE: Freescale Semiconductor, Inc... Tracing Instructions The idle status also occurs if the system attempts to execute code at an address not defined as a valid memory address. The step (ST, STEP, and T are identical) commands will execute a specified number of instructions beginning at the current PC value. The STEPFOR command begins instruction execution at the current PC value, continuing until a key is pressed or until execution arrives at a breakpoint. The STEPTIL command executes instructions from the current PC value to a specified address. NOTE: Do not use any step command (ST, STEP, STEPFOR, STEPTIL, or T) if the PC points to internal RAM (such as option RAM) or EEPROM or if the code branches into internal RAM or EEPROM. The step commands are not real-time. They execute one instruction at a time, then return control to the monitor. Do not rely on timer values. Execution Instructions The go (G or GO) command starts emulation at the address in the PC or at an address entered with the command. Execution continues until it encounters a breakpoint, until the bus analyzer (optionally) stops it, or until the STOP command is entered. If a second address is entered with the G or GO command, execution stops at the second address. The GOTIL command starts emulation at the location in the PC and stops at the address entered with the command. The STOP command stops the emulator. The RESETGO command resets the MCU, fetches the reset vector address, and begins code execution at that address. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 73 Freescale Semiconductor, Inc. Operation Fundamentals Bus State Analyzer Commands Freescale Semiconductor, Inc... The bus state analysis (BSA) feature of the MMDS allows for analyzing the operation of the MCU being emulated. The address, data, freerunning timer value, and select test points can be captured and analyzed using this powerful feature. This section introduces the analyzer commands, with a more detailed view of analyzer usage given in Bus State Analysis. Configuring the Analyzer The BSA is configured initially by pressing F5 to enter the BSA setup screen. Various trigger points and trigger modes can be configured in the setup screen. The trigger configurations can be saved and used during future debug sessions using the load bus state analyzer setup (LOADTRIGGERS) command. The timetag clock source (TIMETAG) command configures the resolution of the free-running timer value captured in the analyzer. The set multiplexer (SXB) command controls the option to either increase the bandwidth of the free-running timer counter or enable capturing additional target test points through pod B. Capturing Analyzer Data Once the analyzer is set up to a desired trigger configuration, the arm bus state analyzer (ARM) command enables the analyzer to begin capturing bus cycles in the trace buffers. The analyzer can be configured to disarm after the analyzer has found the trigger and subsequently filled its trace buffer. Alternatively, the disarm bus state analyzer (DARM) command deactivates the analyzer bus cycle captured from the command line. Viewing Analyzer Data The captured BSA data is stored initially in trace buffer memory on the MMDS platform board. The data is uploaded to the host computer and viewed on screen by pressing the F4 function key. Alternatively, the upload trace buffer (GETBSA) command will upload the analyzer data without displaying it to the screen. The set BSA timetag mode (BSATT) MMDS0508OM/D 74 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Operation Fundamentals Bus State Analyzer Commands command will specify the format for displaying timetag data in the analyzer data screen. The set BSA display mode (BSAMODE) command will specify the format for displaying records in the analyzer data screen. Subsequently, pressing the F4 key will display the data to the screen without requiring another data upload. Freescale Semiconductor, Inc... The analyzer can be set up to detect up to four trigger events, referred to as event A, event B, event C and event D. If a captured record is one of the four trigger events, the event will be displayed in the BSA data screen. To quickly see where an event A first occurred in a set of captured analyzer data, use the go to next A event (NEXTA) command to display the bus analyzer data of the first A event. Executing the command again will find and display the next event occurrence. If no more events exist, the last captured cycle is displayed. Identical commands for events B, C, and D are also available. The go to next event (NEXTE) command searches for and displays the next occurrence of any of the four possible events. The print trigger (SHOWTRIGGER) command finds the first occurrence of a trigger event in the bus state analyzer data. The first and last 20 records of analyzer data can be saved to an open log file by first using the upload trace buffer (GETBSA) command to upload the analyzer data. The go to trace buffer start (HOMEBSA) command followed by a log bus state analyzer (SCREENBSA) command will save the opening records in the bus state analyzer data to an open log file. The go to trace buffer end (ENDBSA) command followed by a log bus state analyzer (SCREENBSA) command will save the ending records in the bus state analyzer data to an open log file. The display trace buffer (SHOWBSA) command will dump ranges of analyzer data to the debug window. MMDS0508OM/D MOTOROLA Operation Fundamentals For More Information On This Product, Go to: www.freescale.com 75 Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Operation Fundamentals MMDS0508OM/D 76 Operation Fundamentals For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78 Operating the Bus Analyzer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79 Defining Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79 Selecting the Trigger Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84 Selecting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86 Collecting Bus Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87 Viewing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88 Searching the Trace Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95 Using the Time-Tag Clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96 MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 77 Freescale Semiconductor, Inc. Bus State Analysis Introduction The MMDS bus state analyzer (BSA) shows the logical state of the target MCU bus. Next to emulation of a target-system MCU, this is the most important capability of a development tool: it enables you to determine what is occurring in a system without actually disturbing the system. Freescale Semiconductor, Inc... At the end of each MCU clock cycle, the BSA takes a snapshot of the logical states of the target MCU bus. Then the analyzer stores the snapshots in the trace buffer, according to its mode. (This action is known as storing cycles.) The trace buffer can hold as many as 8191 cycles. (Note that the analyzer is a bus state analyzer: It does not show signal hold or setup times.) As part of analyzer initialization, you define certain patterns of logical states as events (or terms). Then you select the analyzer mode: continuous, counted, or any of five sequential modes. This determines which cycles the analyzer stores. Data collection (cycle storage) begins when you arm the analyzer and start program execution. Data collection continues until execution stops, through a specified number of events, or through a defined sequence of events. The bus state analyzer provides several ways to view collected data: raw data, disassembled instructions, mixed raw data and disassembled instructions, or source code. MMDS0508OM/D 78 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer Operating the Bus Analyzer To operate the bus state analyzer, you must define events (or terms), select the bus state analyzer mode, specify any options, collect data, then view the data. The following paragraphs explain these actions. Freescale Semiconductor, Inc... Defining Events An event, is a 32-bit value, named A, B, C, or D. You define an event by entering values in one of the term lines of the bus state analyzer setup screen (see Figure 11). To bring up this screen, press the F5 function key from the debug screen. Table 8 lists event-definition values and their meanings; Table 9 lists key commands for the setup screen. When the setup screen first appears, the cursor is at the Trm en (term enable) field of the event A line. Using the arrow keys or mouse, move the cursor to the space between the Trm en brackets for the desired term. Press the space bar (or point to the space with the cursor and click the left mouse button) to put an X in this space. Then move the cursor to other fields to enter values that define the rest of the event. For control signal and logic clip fields, type 0, 1, or X (don't care). For the address and data, use either the hexadecimal field or the binary field, Type a hexadecimal digit or X in the hexadecimal field spaces; type a 0, 1, or X in the binary field spaces. NOTE: Only five of the pod A logic clips are used in event definition. Other logic clips can be captured only in the logic analyzer data. When you have defined your terms, press the F7 key to apply the definitions. If you want to save the definitions to a file, press F6 (then enter a filename in response to the prompt) before you press F7. NOTE: If you use the backspace or delete key while in a field, you must completely refill the field with 0, 1, or X or the software will not allow you to leave the field. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 79 Freescale Semiconductor, Inc. Figure 11. Bus State Analyzer Setup Screen Freescale Semiconductor, Inc... Operating the Bus Analyzer MMDS0508OM/D 80 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer Table 8. Event Definition Values Field Trm en – Term enable Freescale Semiconductor, Inc... Brk en – Breakpoint enable Values X Blank X Meaning Enable the term Disable the term Blank Make the term a data breakpoint (hardware breakpoint) (1) Do not make the term a breakpoint RNG – Range X Blank Makes the event the end of a range Range does not apply to the event ! – Negation X Blank Complements the term Does not complement the term R/W – Read/Write 0 1 X MCU write cycle MCU read cycle Either read or write cycle D/I – Data/Instruction 0 1 X Instruction fetch Data Don't care Pod A Clips: GRN (Green), YEL (Yellow), ORG (Orange), RED (Red), BRN (Brown) Address Hex Address Binary Data Hex Data Binary 0 1 X Logic level 0 Logic level 1 Don't care 0–F, X Hexadecimal address value (X is don't care) 0, 1, X Binary address value (X is don't care) 0–F, X Hexadecimal data value (X is don't care) 0, 1, X Binary data value (X is don't care) (1) You may have to disarm the BSA before you can see data in the BSA data screen. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 81 Freescale Semiconductor, Inc. Bus State Analysis Table 9. Setup Screen Key Commands Name Description Move Down ↓ Moves cursor down to lower line. Move Up ↑ Moves cursor up to higher line. Move Left ← Moves cursor to selection to the left. Move Right → Moves cursor to selection to the right. Next Item Freescale Semiconductor, Inc... Key Preceding Item Tab Shift-Tab Moves cursor to next item Moves cursor to preceding item HELP F1 Displays Help window. LOAD F5 Loads a trigger file (.SET). SAVE F6 Writes definitions to a trigger file (.SET). EXECUTE F7 Applies definitions to bus analyzer and returns to Debug screen. CLEAR F8 Clears definitions. CANCEL ESC Cancels definitions and returns to Debug screen. MMDS0508OM/D 82 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer Part of event definition can be defining ranges from one term to another. To establish a range, you put an X in the range field of a term-definition line of the setup screen. But note that the event A line does not have a range field. This is because event A can only start a range. Freescale Semiconductor, Inc... To configure any of the four range patterns: A to B: Put an X in the event B range field. B to C: Put an X in the event C range field. C to D: Put an X in the event D range field. A to B and C to D: Put Xs in the range fields of events B and D. Also note that you need not define all four terms. When you have defined all appropriate terms, you are ready to select the bus state analyzer trigger mode per Selecting the Trigger Mode. Remember that the MMDS stores event definitions as 32-bit values. The R/W bit is the most significant bit (MSB); the D0 bit is the least significant bit (LSB). A range is between two such 32-bit values, not between values of address fields. In range mode, the BSA triggers every time the input falls between the range starting term (the first 32-bit value) and the range ending term (the second 32-bit value). MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 83 Freescale Semiconductor, Inc. Bus State Analysis Selecting the Trigger Mode To select a mode, put an X in one of the nine mode fields in the bottom half of the bus state analyzer setup screen. Table 10 explains the modes. Table 10. Analyzer Modes Freescale Semiconductor, Inc... Mode Description Continuous: all cycles When you enter the ARM and GO commands, the trace buffer begins storing data from first cycle. This continues until execution arrives at a breakpoint, or until you enter the DARM or STOP command. Continuous: events only When you enter the ARM and GO commands, the trace buffer begins storing data when data matches an event definition. This continues until execution arrives at a breakpoint, or until you enter the DARM or STOP command. Counted: all cycles When you enter the ARM and GO commands, the trace buffer begins storing data from the specified number from first cycle. (A breakpoint can stop storage before the analyzer stores the specified number of cycles, as can the DARM or STOP command.) Counted: events only When you enter the ARM and GO commands, the trace buffer begins storing data that match an event definition for the specified number of cycles. (A breakpoint can stop storage before the analyzer stores the specified number of cycles, as can the DARM or STOP command.) A+B+C+D When you enter the ARM and GO commands, the trace buffer begins storing data from the first cycle run. This continues through the occurrence of event A, B, C, or D (whichever is enabled); data storage ends after the specified number of post-trigger cycles. A+B→C+D When you enter the ARM and GO commands, the trace buffer begins storing data from the first cycle. This continues through the occurrence of two events: A or B, followed by C or D. Data storage ends after the specified number of post-trigger cycles. If you select this mode, you must enable event A, event B, or both. You must enable event C, event D, or both. Otherwise, the bus state analyzer never can be triggered. MMDS0508OM/D 84 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer Table 10. Analyzer Modes (Continued) Freescale Semiconductor, Inc... Mode Description A→B→C!D When you enter the ARM and GO commands, the trace buffer begins storing data from all cycles. This continues through the occurrence of three events, A, B, and C, in order, if event D does not occur. (If D occurs, the sequencer starts again looking for event A.) Data storage ends after the specified number of post-triggert cycles. If you select this mode, you must enable events A, B, and C. Otherwise, the bus state analyzer never can be triggered. If you disable event D, you convert this mode to a simple, three-event sequence. A→B→C→D When you enter the ARM and GO commands, the trace buffer begins storing data from all cycles. This continues through the occurrence of four events, A, B, C, and D, in order. Data storage ends after the specified number of post trigger cycles. If you select this mode, youmust enable all four events A, B, C, then D. Otherwiser, the bus state analyzer never can be triggered. Nth event: A+B+C+D When you enter the ARM and GO commands, the trace buffer begins storing data from N occurrences of cycles that match the definitions of events A, B, C, or D (whichever are enabled). Then the bus state analyzer captures the next 4096 cycles. By selecting the terminal post trigger count, the user can control the number of cycles that is stored. This can be used to speed uploading of the BSA data if only a small portion of data is needed. Note that the terminal count or post trigger cycles are valid only for counted or sequential modes. For a counted mode, this field specifies the number of cycles to be stored. For a sequential mode, this field specifies the number of cycles to be stored after the trigger sequence occurs. An X in the stop-emulator field stops program execution when bus state analyzer recording is done. After selecting the mode, you can begin collecting data by pressing the F7 (execute) key. This returns you to the debug screen. Selecting Options explains how to continue from this point. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 85 Freescale Semiconductor, Inc. Bus State Analysis Freescale Semiconductor, Inc... Other function keys in the setup screen allow for clearing of the setup screen as well as storing and using setup files. To cancel the entire bus state analyzer setup, press . To clear the setup screen, making it ready to redefine events and reselect a mode, press the F8 key. To save this bus state analyzer setup to a file, press the F6 key: a subordinate window prompts for a filename. To load a bus state analyzer setup already saved to a file, press the F5 key: a subordinate window prompts for the filename. Entering the filename fills in the setup-screen values; press the F7 key to return to the debug screen. (An alternative way to load a saved setup is to enter the LOADTRIGGERS command from the debug screen. This method bypasses the setup screen.) Selecting Options An optional part of analyzer setup is specifying the frequency and source of the time tag clock. This clock provides a time reference value in each frame of the trace buffer. (Using the Time-Tag Clock gives more information about the time tag clock.) Enter the time tag clock source (TIMETAG) command; this command brings up the small time-tag window in the center of the debug screen. This window gives you these choices (16 Mhz is the default): 16 Mhz Selects the 16 MHz oscillator. 8 Mhz Selects the 8 MHz oscillator. 4 Mhz Selects the 4 MHz oscillator. 2 Mhz Selects the 2 MHz oscillator. 1 Mhz Selects the 1 MHz oscillator. External Selects the external clock Programmable Selects the programmable clock. Emulator Selects the emulator clock, the bus clock of the emulating MCU. If you select External, connect the TT_OSC clip (white) of the pod B cable to the external clock source. (The pod B connector is the closest to the front of the station module. MMDS0508OM/D 86 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer If you select Programmable, you must enter a frequency in the range of 50 Hz to 50 kHz, as the pop-up window requests. The MMDS will provide a frequency close to the desired frequency and display it to the screen. For example, entering 1000 will result in a timetag frequency of 1024 Hz. Freescale Semiconductor, Inc... If you select Emulator, the system uses the MCU’s bus clock. In effect, this stores the number of bus cycles. Another setup option is specifying whether to store high-order time tag bits (increasing the time tag from 16 to 24 bits) or data from the pod B logic clips. To do so, enter the set multiplexer (SXB) command with the appropriate tags or clips parameter value. (The default is clips.) Collecting Bus Data To begin data collection, enter the ARM command, which arms the bus state analyzer. The BSA status changes to Armed. The bus state analyzer mode appears on the status line. Next, enter the GO command, which starts program execution. The MCU status changes to Running. If you are in a sequential mode, you may be able to follow the occurrence of events from the highlighting changes. (Such highlighting changes may be too fast to be helpful.) Data collection continues through the specified number of counted events or post-trigger cycles, or until code execution stops. NOTE: The GO command is not the only program-execution command that works with the bus state analyzer. Alternative commands are: G, GOTIL, STEP, STEPFOR, STEPTIL, and T. If you enter either trace command (STEP or T) without a parameter value when the bus state analyzer is armed, the analyzer trace window appears over the debug screen. This temporary window shows the cycles of the instruction just traced. To manually halt data collection, enter the DARM or STOP command. Entering the DARM command disarms the analyzer; the analyzer state changes to Disarmed. (The DARM command does not stop emulation.) Entering the STOP command stops data collection and emulation. When data collection stops, you are ready to look at the data, per Viewing Data. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 87 Freescale Semiconductor, Inc. Bus State Analysis Viewing Data Freescale Semiconductor, Inc... NOTE: To view bus analyzer data, press the F4 function key from the debug screen; this key brings up the bus state analyzer data screen (Figure 12). The word loading flashes in the upper right corner of the screen as the software loads trace-buffer contents into the host computer. The data is not fully visible until loading is done (loading stops flashing), although cycles immediately preceding and following the trigger cycle become valid early during loading. Be sure to use the highest possible baud rate. If you use a lower baud rate, it can take several minutes to load trace-buffer data into the host computer. The data screen displays trace buffer contents as raw bus cycles, as disassembled instructions, as mixed instructions and raw bus cycles, or as source code. In the mixed display, the associated raw bus cycles follow each disassembled instruction. Press the F4 key repeatedly to change the display from one form to another. Table 11 explains other key commands for the data screen. If the data capture mode was sequential, the data screen includes a trigger indicator ( ). This screen indicator separates the pre-trigger and post-trigger cycles. The F1 and F2 keys mark cycles and , respectively. The bus state analyzer uses these marked cycles in time-tag difference calculations and logging. The software displays the time tag difference, ∆c, in the lower right corner of the screen. (An R, by the ∆c value, indicates a rollover of the time tag value between the occurrence of cycles and .) If a log file is open, you can save bus state analyzer data to the log file. The system logs the information in the selected view mode. While logging is under way, the SHOWTRIGGER, NEXTA, NEXTB, NEXTC, NEXTD, and NEXTE commands log trace buffer cycles. To copy the current data screen to the log file, use the Alt-S key command. Use the Alt-P key command to log from the cycle to the cycle. MMDS0508OM/D 88 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Bus State Analysis Operating the Bus Analyzer . Figure 12. Bus State Analyzer Data Screen Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 89 Freescale Semiconductor, Inc. Bus State Analysis Table 11. Data Screen Key Commands Name Description Scroll Down ↓ Scrolls cursor down to next line. Scroll Up ↑ Scrolls cursor up to preceding line. Page down Page up Home Freescale Semiconductor, Inc... Key Page Down Page Up Home Scrolls down to next page. Scrolls up to preceding page. Scrolls to first frame. End End Scrolls to highest-numbered frame. Next A Alt-A Scrolls to next term A frame. Next B Alt-B Scrolls to next term B frame. Next C Alt-C Scrolls to next term C frame. Next D Alt-D Scrolls to next term D frame. Next E Alt-E Scrolls to next frame that contains any term. "1" F1 Marks highlighted frame as cursor 1. "2" F2 Marks highlighted frame as cursor 2. Go to cursor 1 Alt-F1 Scrolls to cursor 1. Go to cursor 2 Alt-F2 Scrolls to cursor 2. Go to trigger Alt T Scrolls to trigger frame. Find F3 Defines a search pattern and scrolls to frame that matches pattern. Disp F4 Changes display mode to next in sequence: Raw, Instructions, Mixed, Source. data F7 Toggles display in Data column between hexadecimal and binary. tt F8 Changes time tag mode to next in sequence: absolute, relative, none, cycles. Log cursor 1 - cursor 2 Alt-P Writes frames from cursor 1 through cursor 2 to log file. Alt-S Writes the frames displayed on the screen to log file. Return ESC Return to Debug screen. Display source name Alt-N Display the source name: line number Log screen MMDS0508OM/D 90 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer Figure 12 shows the data screen as it displays raw bus cycles. Figure 13 shows this screen's display of instructions, Figure 14 shows a mixed instructions and raw bus cycle display, and Figure 15 shows this screen's display of source code. (Repeatedly press the F4 key to cycle through display modes.) Freescale Semiconductor, Inc... NOTE: The instruction display includes only the frames that contain instruction fetch cycles; the instructions are displayed in disassembled form. A frame is one line of BSA data, valid at the end of a bus cycle. Frames are numbered sequentially from the first bus cycle. For a source code display (Figure 15), the source file must be in the directory with the object file. The source code display shows information similar to the instructions display, but it also displays the comments from the source code file. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 91 Freescale Semiconductor, Inc. Figure 13. Instructions Display Freescale Semiconductor, Inc... Operating the Bus Analyzer MMDS0508OM/D 92 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Bus State Analysis Operating the Bus Analyzer Figure 14. Mixed Raw Cycles and Instructions Delay Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 93 Freescale Semiconductor, Inc. Figure 15. Source Code Display Freescale Semiconductor, Inc... Operating the Bus Analyzer MMDS0508OM/D 94 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer Freescale Semiconductor, Inc... Searching the Trace Buffer The bus state analyzer includes a search utility, enabling you to search the trace buffer for a frame that contains a specific bit configuration. To start this utility, press the F3 key from the data screen. This brings up the find pattern window (Figure 16). Define a search pattern by filling in fields of this window; initially, all fields have X (don't care) values. Find searches from the point of the cursor to the end of the buffer. Use the arrow keys to move between fields. Table 12 lists the key commands for the find pattern window. The frame field is decimal. To scroll directly to a specific frame, enter the frame number in this field. If this is a don't care entry, put a string of four Xs in this field. Figure 16. Find Pattern Window Table 12. Find Pattern Window Key Commands Name Key Description Move Left ← Moves cursor one character to the left. Move Right → Moves cursor one character to the right. Next Field Tab Preceding Field Shift-Tab Moves cursor to next field. Moves cursor to preceding field. Find F7 Scrolls to next frame that matches the selected pattern and returns to BSA data window. Clear F8 Clears the selected pattern. Cancel ESC Returns to BSA data window without scrolling. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 95 Freescale Semiconductor, Inc. Bus State Analysis Freescale Semiconductor, Inc... The address and data fields are hexadecimal. In these fields, you can specify a range by using the Xs for the less-significant digits. For example, 03XX in the Address field searches for addresses in the range of 0300--03FF. You can specify an X in any digit position to cause that digit to be ignored in the search. The R/W and D/I fields and the two pod fields are binary. Enter 0 or 1 for each bit to be used in the search, and Xs for the bits to be ignored. Setting the R/W bit searches for read bus cycles; clearing this bit searches for write bus cycles. Setting the D/I bit searches for data bus cycles; clearing this bit searches for instruction fetch bus cycles. You can search for bus cycles in which one or more terms are true by entering A, B, C, or D in the term field. When you have defined the search pattern completely, press F7 to start the search. The search begins at the current (highlighted) frame, and proceeds toward the highest-numbered frame in the trace buffer. (To clear the fields of the screen, press the F8 key.) Using the Time-Tag Clock There are four time-tag display modes: absolute, relative, cycles, and none. An absolute display mode shows the time reference from the first bus cycle. A relative display mode shows the time between bus cycles. A cycle display mode shows the cycle reference from the first bus cycle. None blanks the timetag display. You can cycle through these display modes using the F8 key while the BSA data screen is open. The data screen displays the time tag as a number of seconds when you use the 1 MHz, 2 MHz, 4 MHz, 8 MHz, or 16 MHz clock. To time the execution of a portion of the code, use either the raw bus cycle mode or the mixed mode of the display, with the absolute time-tag format. Select the beginning cycle, and press the F1 key to mark it . Select the ending cycle, and press the F2 key to mark it . The software calculates the time between the two frames, then displays the difference ( ∆c ) in the lower right corner of the data screen. (An R, by the ∆c value, indicates a rollover of the time tag value between the occurrence of cycles and .) MMDS0508OM/D 96 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Bus State Analysis Operating the Bus Analyzer For example, if the beginning time tag is 3.26778887E03 and the ending time tag is 3.2677928E03, the difference is 0.00000400 seconds, or 4 µs. If the time tag is represented in clock periods, the procedure is the same, but the ∆c value is the number of time-tag clock cycles. Multiply the result by the time-tag clock period to obtain the elapsed time between the beginning and ending cycles. Freescale Semiconductor, Inc... For example, if the beginning time-tag value is 219, and the ending time-tag value is 234, the difference is 15 time-tag cycles. At a time-tag clock frequency of 4 MHz, the time-tag clock period is 0.25 µs, and the elapsed time is 3.75 µs. Had the same time-tag values been obtained with a time-tag clock frequency of 500 kHz (a clock period of 2 µs), the elapsed time would be 30 µs. MMDS0508OM/D MOTOROLA Bus State Analysis For More Information On This Product, Go to: www.freescale.com 97 Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Bus State Analysis MMDS0508OM/D 98 Bus State Analysis For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102 Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102 Command Explanations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103 A — Set Accumulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 ACC — Set Accumulator. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107 ARM — Arm Bus State Analyzer . . . . . . . . . . . . . . . . . . . . . . . . .108 ASM — Assemble Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . .109 BAUD — Set Communications Baud Rate . . . . . . . . . . . . . . . . . .110 BAUDCHK — Baud Rate Check. . . . . . . . . . . . . . . . . . . . . . . . . .111 BELL — Sound Bell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112 BF — Block Fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113 BR — Set Instruction Breakpoint . . . . . . . . . . . . . . . . . . . . . . . . .114 BSAMODE — BSA Display Mode. . . . . . . . . . . . . . . . . . . . . . . . .115 BSATT — BSA Timetag Mode . . . . . . . . . . . . . . . . . . . . . . . . . . .116 C — Set/Clear C Bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117 CCR — Set Condition Code Register . . . . . . . . . . . . . . . . . . . . . .118 CHIPINFO — Chip Help Information. . . . . . . . . . . . . . . . . . . . . . .119 CLEARMAP — Remove Symbols. . . . . . . . . . . . . . . . . . . . . . . . .120 COLORS — Set Screen Colors . . . . . . . . . . . . . . . . . . . . . . . . . .121 DARM — Disarm Bus State Analyzer . . . . . . . . . . . . . . . . . . . . . .122 DASM — Disassemble Instructions . . . . . . . . . . . . . . . . . . . . . . .123 ENDBSA — Go to Trace Buffer End. . . . . . . . . . . . . . . . . . . . . . .124 EVAL — Evaluate Argument. . . . . . . . . . . . . . . . . . . . . . . . . . . . .125 EXIT — Terminate Host Session . . . . . . . . . . . . . . . . . . . . . . . . .126 G — Begin Program Execution . . . . . . . . . . . . . . . . . . . . . . . . . . .127 GETBSA — Upload Trace Buffer . . . . . . . . . . . . . . . . . . . . . . . . .128 GO — Begin Program Execution . . . . . . . . . . . . . . . . . . . . . . . . .129 GOTIL — Execute Program until Address . . . . . . . . . . . . . . . . . .130 H — Set/Clear H Bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131 MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 99 Freescale Semiconductor, Inc. Command-Line Commands Freescale Semiconductor, Inc... HELP — Display Help Information . . . . . . . . . . . . . . . . . . . . . . . .132 HOMEBSA — Go to Trace Buffer Start . . . . . . . . . . . . . . . . . . . .133 HREG — Set H Register. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134 HX — Set H:X Index Register . . . . . . . . . . . . . . . . . . . . . . . . . . . .135 I — Set/Clear I Bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136 INFO — Display Line Information . . . . . . . . . . . . . . . . . . . . . . . . .137 LF — Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 LOAD — Load S19 File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139 LOADMAP — Load Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . .140 LOADMEM — Load Personality File. . . . . . . . . . . . . . . . . . . . . . .141 LOADTRIGGERS — Load Bus State Analyzer Setup . . . . . . . . .142 MD — Memory Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 MM — Memory Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 MM — Memory Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145 N — Set/Clear N Bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146 NEXTA — Go to Next A Event . . . . . . . . . . . . . . . . . . . . . . . . . . .147 NEXTB — Go to Next B Event . . . . . . . . . . . . . . . . . . . . . . . . . . .148 NEXTC — Go to Next C Event . . . . . . . . . . . . . . . . . . . . . . . . . . .149 NEXTD — Go to Next D Event . . . . . . . . . . . . . . . . . . . . . . . . . . .150 NEXTE — Go to Next Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 NOBR — Clear Breakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152 OSC — Select Emulator Clock Frequency . . . . . . . . . . . . . . . . . .153 PC — Set Program Counter . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154 QUIT — Terminate Host Session . . . . . . . . . . . . . . . . . . . . . . . . .155 REG — Display Registers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156 REM — Add Comment to Script File. . . . . . . . . . . . . . . . . . . . . . .157 RESET — Reset Emulation MCU . . . . . . . . . . . . . . . . . . . . . . . . .158 RESETGO — Reset and Restart MCU. . . . . . . . . . . . . . . . . . . . .159 RESETIN — Reset Input Enable . . . . . . . . . . . . . . . . . . . . . . . . .160 RESETOUT — Reset Output Enable . . . . . . . . . . . . . . . . . . . . . .161 RTMEM — Set Real-Time Memory Block. . . . . . . . . . . . . . . . . . .162 RTVAR — Display Real-Time Variable . . . . . . . . . . . . . . . . . . . . .163 RTVAR — Display Real-Time Variable . . . . . . . . . . . . . . . . . . . . .164 SCREENBSA — Log Bus State Analyzer Screen . . . . . . . . . . . .165 SCRIPT — Execute Script File . . . . . . . . . . . . . . . . . . . . . . . . . . .166 SETMEM — Customize Memory Map . . . . . . . . . . . . . . . . . . . . .167 SETMEM — Customize Memory Map . . . . . . . . . . . . . . . . . . . . .168 SHELL — Access DOS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169 MMDS0508OM/D 100 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Contents Freescale Semiconductor, Inc... SHOWBSA — Display Trace Buffer . . . . . . . . . . . . . . . . . . . . . . .170 SHOWMEM — Display Memory Map . . . . . . . . . . . . . . . . . . . . . .171 SHOWTRIGGER — Print Trigger . . . . . . . . . . . . . . . . . . . . . . . . .172 SNAPSHOT — Save Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . .173 SOURCE — Source Window Display . . . . . . . . . . . . . . . . . . . . . .174 ST — Single Step (Trace) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175 STACK — Display Stack. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176 STEP — Single Step (Trace) . . . . . . . . . . . . . . . . . . . . . . . . . . . .177 STEPFOR — Step Forever. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178 STEPTIL — Single Step to Address . . . . . . . . . . . . . . . . . . . . . . .179 STOP — Stop Program Execution . . . . . . . . . . . . . . . . . . . . . . . .180 SXB — Set Multiplexer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181 SYSINFO — System Information . . . . . . . . . . . . . . . . . . . . . . . . .182 T — Single Step (Trace) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183 TIMETAG — Time Tag Clock Source . . . . . . . . . . . . . . . . . . . . . .184 V — Set/Clear V Bit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186 VAR — Display Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187 VAR — Display Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188 VER — Display Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189 VERSION — Display Version . . . . . . . . . . . . . . . . . . . . . . . . . . . .190 VF — View File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191 WAIT — Pause between Commands . . . . . . . . . . . . . . . . . . . . . .192 WAIT4RESET — Wait for Target Reset . . . . . . . . . . . . . . . . . . . .193 WHEREIS — Display Symbol Value. . . . . . . . . . . . . . . . . . . . . . .194 X — Set X Index Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195 XREG — Set X Index Register . . . . . . . . . . . . . . . . . . . . . . . . . . .196 Z — Set/Clear Z Bit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197 ZOOM — Resize Source Window. . . . . . . . . . . . . . . . . . . . . . . . .198 MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 101 Freescale Semiconductor, Inc. Command-Line Commands Introduction Freescale Semiconductor, Inc... Keyboard entry is the primary means of MMDS control. Individual commands are entered at the command-line prompt in the debug F10 window. The commands are used to initialize emulation memory, display and store data, debug user code, and control flow of code execution. This section explains the rules for command syntax and arguments, then gives individual explanations for each command. Some of these commands can be executed via mouse control. For detail on using the mouse, see the section titled Mouse Operation on page 56. Command Syntax A command-line command is a line of ASCII text that is entered via the computer keyboard. Press to terminate each line, activating the command. The typical command syntax is: > []. . . Where: > The command prompt. The system displays this prompt in the debug F10 window when ready for another command. A command name in upper- or lower-case letters. Refer to Table 14 for command choices. One or more arguments. Table 13 explains the many kinds of possible arguments. In command syntax descriptions, brackets ( [] ) enclose optional items, a vertical line (|) means or, and an ellipsis (. . .) means the preceding item can be repeated. Except where otherwise noted, numerical values in examples are hexadecimal. MMDS0508OM/D 102 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations Table 13. Argument Types Freescale Semiconductor, Inc... Argument Type Syntax Indicators Explanation Numeric , , Hexadecimal values, unless otherwise noted. Leading zeros can be omitted. For decimal values, use the prefix ! or the suffix T. For binary values, use the prefix % or the suffix Q. Example: 54 = !100 = 100T = %1100100 = 1100100Q Address Four or fewer hexadecimal digits (leading zeros can be omitted). If an address is decimal or binary, use a prefix or suffix per the explanation of numeric arguments. Range A range of addresses or numbers. Specify the low value, then the high value, separated by a space. Leading zeros can be omitted. Symbol , Symbols of ASCII characters, usually symbols from source code Filename The name of a file in DOS format; eight or fewer ASCII characters. An optional extension (three or fewer characters) can be included after a period. If the file is not in the current directory, precede the file name with a complete path. Frequency Decimal values that specify clock speeds Commands Items from the command set may be used as an argument for the HELP command. Operator + (add); – (subtract); * (multiply); or / (divide) Source The source for possible clock sources used in the MMDS Type Specifies byte, word, or string data operations Text The text entered will be displayed when command is executed. Termination The terminator controls command flow in the memory modify command. Command Explanations Table 14 lists the command-line commands. Individual explanations of each of these commands follow the table. Note that the command parser of the MMDS host software is not case sensitive. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 103 Freescale Semiconductor, Inc. Command-Line Commands Table 14. Command Sumary Freescale Semiconductor, Inc... Mnemonic Table 14. Command Sumary (Continued) Description Mnemonic Description A Set accumulator HX* Set HX index register ACC Set accumulator I Set/Clear I Bit ARM Arm Bus State Analyzer INFO Display Line Information ASM Assemble Instruction LF Log File BAUD Set Communications Baud Rate LOAD Load S19 File BAUDCHK Baud Rate Check LOADMAP Load Symbols BELL Sound Bell LOADMEM Load Personality File BF Block Fill LOADTRIGGERS Load Bus State Analyzer Setup BR Set Instruction Breakpoint MD Memory Display BSAMODE Sets BSA Display Mode MM Memory Modify BSATT Sets BSA Timetag Mode N Set/Clear N Bit C Set/Clear C Bit NEXTA Go to Next A Event CCR Set Condition Code Register NEXTB Go to Next B Event CHIPINFO Chip Help Information NEXTC Go to Next C Event CLEARMAP Remove Symbols NEXTD Go to Next D Event COLORS Set Screen Colors NEXTE Go to Next Event DARM Disarm Bus State Analyzer NOBR Clear Breakpoints DASM Disassemble Instructions OSC Select Emulator Clock Frequency ENDBSA Go to Trace Buffer End PC Set Program Counter EVAL Evaluate Argument QUIT Terminate Host Session EXIT Terminate Host Session REG Display Registers G Begin Program Execution REM Add Comment to Script File GETBSA Upload Trace Buffer RESET Reset Emulation MCU GO Begin Program Execution RESETGO Reset and Restart MCU GOTIL Execute Program until Address RESETIN Reset Input Enable H Set/Clear H Bit RESETOUT Reset Output Enable HELP Display Help Information RTMEM Set Real-Time Memory Block HOMEBSA Go to Trace Buffer Start RTVAR Display Real-Time Variable HREG* Set H Register * MMDS08 Only MMDS0508OM/D 104 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations Table 14. Command Sumary (Continued) Freescale Semiconductor, Inc... Mnemonic Table 14. Command Sumary (Continued) Description Mnemonic Description SCREENBSA Log Bus State Analyzer Screen SYSINFO System Information SCRIPT Execute Script File T Single Step (Trace) SETMEM Customize Memory Map TIMETAG Timetag Clock Source SHELL Access DOS V* Set/Clear V Bit SHOWBSA Logs and Displays Bus State Analyzer VAR Display Variable VER Display Version SHOWMEM Display Memory Map VERSION Display Version SHOWTRIGGER Print Trigger VF View a File SNAPSHOT Save Screen WAIT Pause between Commands SOURCE Source Window Display WAIT4RESET Wait for Target Reset ST Single Step (Trace) WHEREIS Display Symbol Value STACK Display Stack X Set X Index Register STEP Single Step (Trace) XREG Set X Index Register STEPFOR Step Forever Z Set/Clear Z Bit STEPTIL Single Step to Address ZOOM Resize Source Window STOP Stop Program Execution SXB Set Multiplexer * MMDS08 Only MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 105 Freescale Semiconductor, Inc. Command-Line Commands A A Set Accumulator The A command sets the accumulator to a specified value. (The A and ACC commands are identical.) Syntax: A Freescale Semiconductor, Inc... Where: The value to be loaded into the accumulator. Example: >A 10 Set the accumulator to 10. MMDS0508OM/D 106 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations ACC Set Accumulator ACC The ACC command sets the accumulator to a specified value. The ACC and A commands are identical. Syntax: ACC Freescale Semiconductor, Inc... Where: The value to be loaded into the accumulator Example: >ACC 20 Set the accumulator to 20. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 107 Freescale Semiconductor, Inc. Command-Line Commands ARM Arm Bus State Analyzer ARM The ARM command arms the bus state analyzer. When armed, the analyzer records bus cycles while the emulator is executing user code. Arming the analyzer clears the current contents of the analyzer trace buffer. The word armed appears in the status area of the debug screen. Syntax: Freescale Semiconductor, Inc... ARM Example: >ARM cycles. Arm the bus state analyzer for user code bus MMDS0508OM/D 108 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations ASM Assemble Instructions ASM The ASM command assembles M68HC05 Family or M68HC08 Family instruction mnemonics and places the resulting machine code into memory at a specified address. Freescale Semiconductor, Inc... The command displays the specified address, its contents, and a prompt for an instruction. As each instruction is entered, the command assembles the instruction, stores and displays the resulting machine code, and displays the contents of the next memory location with a prompt for another instruction. To terminate the command, enter a period (.). Syntax: ASM [] Where: An address at which the assembler places the first machine code generated. If is not specified, the system checks the address used by the previous ASM command, then uses the following address for this ASM command. Examples: The first example shows the ASM command with an address argument: >asm 100 01009D NOP>CLRA 01004F CLRA 01019D NOP>. The second example shows the ASM command with no argument: >ASM 01019D NOP>STA 0A 0101B70ASTA0A 01039D NOP>. NOTE: Changes made to code via this command cannot be saved to an S-record file or to a source code file. This command should be used only to create and modify code to be run during the current debug session. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 109 Freescale Semiconductor, Inc. Command-Line Commands BAUD Set Communications Baud Rate BAUD Freescale Semiconductor, Inc... The BAUD command changes the baud rate for communications between the system controller and the host computer. For best performance of the system, communications should be at the maximum available baud rate. Reduce this rate if the software displays communications error messages. Entering this command without a rate argument calls up the baud rate window. A baud rate can be selected via this window. NOTE: At power-up, MMDS software automatically sets the maximum baud rate for the system. If the baud rate is reduced but communication errors persist, turn off the disk cache (for instance, SMARTDRV.EXE). Syntax: BAUD [] Where: One of these decimal baud-rate values: 2400 4800 9600 19,200 38,400 57,600 Example: >BAUD 9600. NOTE: 9600 Change the communications baud rate to To specify a default baud rate of 9600, add the –B option when first running the MMDS command. MMDS0508OM/D 110 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations BAUDCHK Baud Rate Check BAUDCHK The BAUDCHK command sets the communication rate between the host software and the MMDS system. The command first checks communication at the maximum possible rate of 57600 baud and successively lowers the rate until communication with the MMDS is established. Freescale Semiconductor, Inc... Syntax: BAUDCHK Example: >BAUDCHK 57600 baud communicates well The command displays a message indicating the maximum available baud rate. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 111 Freescale Semiconductor, Inc. Command-Line Commands BELL Sound Bell BELL The BELL command sounds the computer bell the specified hexadecimal number of times. The bell sounds once if an argument is not entered. To turn off the bell as it is sounding, press any key. Syntax: BELL [] Freescale Semiconductor, Inc... Where: The hexadecimal number of times to sound the bell Examples: >BELL Sound the bell once. >BELL C Sound the bell 12 (decimal) times. >BELL 12 Sound the bell 18 (decimal) times. MMDS0508OM/D 112 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations BF BF Block Fill The BF command fills a block of memory with a specified byte or word. If the system cannot verify a write to one of the designated memory locations, it will stop command execution and report an error condition. Syntax: BF[.] Freescale Semiconductor, Inc... Where: Size of : B is an 8-bit value (the default) W is a 16-bit value A block (range) of memory defined by beginning and ending addresses. A value to be stored in a byte or word of the specified block. If is specified to be a byte value, then is an 8-bit value. If is specified to be a word value, then is a 16-bit value and is stored in each word of the block. Examples: >BF 200 20F FF Store FF hexadecimal in bytes at addresses 200 to 20F. >BF.W 100 11F 4143 Store 4143 in words at addresses 100 to 11F. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 113 Freescale Semiconductor, Inc. Command-Line Commands BR BR Set Instruction Breakpoint The BR command sets an instruction breakpoint at a specified address or range of addresses. If a map file has been loaded, symbols (or labels) from the source code can be used as arguments. The maximum number of all instruction breakpoints is 64. For a list of all active breakpoints, enter this command without any parameter value. Freescale Semiconductor, Inc... A breakpoint occurs only on an address that contains an opcode (that is, an instruction fetch address). Although this command sets breakpoints at each address of a range, breakpoints occur only at the opcode addresses within the range. The system displays an error message if the address is within the range defined by a previous BR command or if the range of a new BR command overlaps the range of an existing BR command. An error message also appears if setting a 65th breakpoint is attempted. Syntax: BR [||] Where: The address for a breakpoint The range of addresses for breakpoints; a beginning address and an ending address, separated by a space. The label of an instruction in source code. Examples: >BR 100 Set a breakpoint at address 100. >BR 130 13F Set 16 breakpoints at addresses 130 through 13F. >BR START Set a breakpoint at address label START in code. >BR 1000 103F Set 64 breakpoints at addresses 1000 through 103F. Note that trying to set additional breakpoints, without clearing some of these breakpoints, would bring up the error message: Too many breakpoints MMDS0508OM/D 114 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations BSAMODE BSA Display Mode BSAMODE The BSAMODE command sets the bus state analyzer display mode to raw, instruction, mixed, or source. This command is equivalent to the BSA data screen F4 key. Syntax: Freescale Semiconductor, Inc... Display BSA Where: One of the following decimal values: 1 Raw 2 Instruction 3 Mixed Raw and Instruction 4 Source Example: >C 0 Clear the C bit of the CCR. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 115 Freescale Semiconductor, Inc. Command-Line Commands BSATT BSA Timetag Mode BSATT This command sets the bus state analyzer timetag mode to absolute, relative, none, or cycles. This command is equivalent to the BSA data screen F8 key. Syntax: Freescale Semiconductor, Inc... BSA TT Where: One of the following decimal values: 1 Absolute 2 Relative 3 None 4 Cycles Example: >C 0 Clear the C bit of the CCR. MMDS0508OM/D 116 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations C Set/Clear C Bit C The C command sets the C bit of the condition code register (CCR) to the specified value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are located at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: C 0|1 Where: 0 Clears the C bit 1 Sets the C bit Example: >C 0 Clear the C bit of the CCR. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 117 Freescale Semiconductor, Inc. Command-Line Commands CCR Set Condition Code Register CCR The CCR command sets the condition code register (CCR) to the specified hexadecimal value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are located at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: CCR Where: The new hexadecimal value for the CCR Example: >CCR E4 Set the CCR to E4 (N bit set, others clear). MMDS0508OM/D 118 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations CHIPINFO Chip Help Information CHIPINFO The CHIPINFO command accesses register, memory-map, vector, and pin-out information about the emulation MCU. Entering this command brings up the topics window as shown in Figure 17. Select a topic to bring up a subordinate window. (To select a topic, click on it; alternatively, highlight the topic, then press .) Freescale Semiconductor, Inc... The subordinate windows and their contents are: • REGISTERS  Register addresses of the MCU being emulated. Selecting an address opens another subordinate window that displays each bit of the register. • MEMORY MAP  The memory map for the MCU being emulated. • VECTORS  The vectors for the MCU being emulated. • PIN OUT  The pin outs for the MCU being emulated. Topics REGISTERS MEMORY MAP VECTORS PIN OUT Figure 17. Topics Window Syntax: CHIPINFO Example: >CHIPINFO Access emulation MCU information. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 119 Freescale Semiconductor, Inc. Command-Line Commands CLEARMAP Remove Symbols CLEARMAP The CLEARMAP command removes the symbol definitions in the host computer. If a map file is loaded, symbols (or labels) from the source code can be used as arguments for many other commands. Syntax: CLEARMAP Freescale Semiconductor, Inc... Example: >CLEARMAP Clear symbols and their address definitions. MMDS0508OM/D 120 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations COLORS Set Screen Colors COLORS The COLORS command sets the screen colors. Entering this command brings up the colors window. This window includes a list of screen elements and a matrix of foreground/background color combinations; each color combination has a 2-digit hexadecimal number. Freescale Semiconductor, Inc... A prompt asks for the color of the first screen element. To accept the current color, press . To change the color, enter the number of the choice, then press . A new prompt asks for the color of the next element. Select the color for each element in the same way. The command ends when a color for the last screen element is selected or when ESC is pressed. In the color matrix, rows correspond to background colors and columns correspond to foreground colors. This means that color choices from the same row result in differently colored letters and numbers against the same background color. Making the background of highlights and help screens a different color sets these elements off from the main screen. The software stores color selections in file COLORS.05 or COLORS.08; when MMDS is executed again, the software applies the newly selected colors. NOTE: Delete the COLORS.05 or COLORS.08 file from the MMDS subdirectory to return to the default colors. Syntax: COLORS MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 121 Freescale Semiconductor, Inc. Command-Line Commands DARM Disarm Bus State Analyzer DARM The DARM command disarms the bus state analyzer. When disarmed, the analyzer does not record bus cycles. The word Disarmed appears in the status area of the debug screen. (If the bus state analyzer is already disarmed, this command does nothing.) Syntax: Freescale Semiconductor, Inc... DARM Example: >DARM Disarm the bus state analyzer. MMDS0508OM/D 122 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations DASM Disassemble Instructions DASM The DASM command disassembles three or more machine instructions, displaying the addresses and the contents as disassembled instructions. Disassembly begins at the specified address. The valid address range is $0000 to $FFFF. Syntax: Freescale Semiconductor, Inc... DASM [] Where: The starting address for disassembly. must be an instruction opcode. If only an value is entered, the system disassembles three instructions. The ending address for disassembly. If an value is entered, disassembly begins at and continues through . The screen scrolls upward as addresses and their contents are displayed, leaving the last instructions in the range displayed in the window. Example: Disassemble and display three instructions beginning at address 100: >DASM 100 0100 A6E8 0102 B702 0104 4F NOTE: LDA #0E8 STA 0002 CLRA For a range larger than three commands, log files can be used to store DASM responses to a file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 123 Freescale Semiconductor, Inc. Command-Line Commands ENDBSA Go to Trace Buffer End ENDBSA The ENDBSA command sets the trace buffer pointer to the last record of trace data. This command requires an open log file and loaded uploaded trace buffer data. Subsequent execution of the SCREENBSA command logs the last 20 records of analyzer data to the open log file. Syntax: Freescale Semiconductor, Inc... ENDBSA Example: >LF Open a log file. >GETBSA Upload captured analyzer. >ENDBSA Position trace buffer pointer to last record. >SCREENBSA Log first 20 records to open log file. MMDS0508OM/D 124 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations EVAL Evaluate Argument EVAL Freescale Semiconductor, Inc... The EVAL command performs mathematical operations on two numerical arguments. It displays the value of the result in hexadecimal, decimal, octal, and binary formats denoted by the suffixes H, T, O, and Q. (Note that octal numbers are not valid as operand values. Operand values are 15 bits or less.) If the value is equivalent to an ASCII character, the ASCII character is also displayed. This command supports addition (+), subtraction (–), multiplication (*) and division (/). Syntax: EVAL Where: A number to be evaluated or the first operand of a simple expression to be evaluated The arithmetic operator (+, –, *, or /) of a simple expression to be evaluated The second operand of a simple expression to be evaluated Example: Evaluate the sum of hexadecimal numbers 45 and 32 then display the result in four bases and as an ASCII character: >EVAL 45 + 32 0077H 119T 000157O 0000000001110111Q “w” NOTE: The host will not inform of an operation that resulted in an overflow. Also, the result of a division operation will be the quotient. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 125 Freescale Semiconductor, Inc. Command-Line Commands EXIT Terminate Host Session EXIT The EXIT command terminates the host session and returns to DOS. The EXIT and QUIT commands are identical. Another way to end a host session is to enter the ALT-X keyboard combination. Syntax: EXIT Freescale Semiconductor, Inc... Example: >EXIT Return to DOS. MMDS0508OM/D 126 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations G Begin Program Execution G The G command starts execution of code in the emulator at the current address or at a specified address. If one address is entered, it is the starting address. If two addresses are entered, execution begins at the first and stops at the second. If a map file has been loaded, symbols (or labels) from the source code can be used as arguments. The G and GO commands are identical. Freescale Semiconductor, Inc... If no address or only one address is specified, execution continues until a STOP command is entered, a breakpoint occurs, or an error occurs. Syntax: G [|] [|] Where: Execution starting address. If an value is entered, the system loads the value into the program counter (PC), then starts execution at the address in the PC. If an value is not entered, execution begins at the address already in the PC. Execution stop address. The value must be an instruction fetch address; if it is not, code execution continues as if the command had no value. NOTE: The label of an instruction in source code. Be careful about using the G, GO, or GOTIL commands if the code branches into internal RAM (for instance, option RAM) or EEPROM. An execution stop address is invalid for internal locations. Examples: >G >G 145 >G START code. >G 200 271 Begin code execution at the current PC value. Begin code execution at address 145. Begin code execution at label START in source Begin code execution at address 200. End code execution just before the instruction at address 271. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 127 Freescale Semiconductor, Inc. Command-Line Commands GETBSA Upload Trace Buffer GETBSA The GETBSA command uploads the contents of the bus state analyzer trace buffer to the host computer. This is convenient when using a script file in conjunction with the bus state analyzer. Alternatively, the trace buffer data can be retrieved and displayed using the F4 function key. Syntax: Freescale Semiconductor, Inc... GETBSA Example: >GETBSA computer. Upload trace buffer contents to the host MMDS0508OM/D 128 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations GO Begin Program Execution GO The GO command starts execution of code in the emulator at the current address or at a specified address. If one address is entered, it is the starting address. If two addresses are entered, execution begins at the first and stops at the second. If a map file has been loaded, symbols (or labels) from the source code can be used as arguments. The GO and G commands are identical. Freescale Semiconductor, Inc... If no address or only one address is specified, execution continues until a STOP command is entered, a breakpoint occurs, or an error occurs. Syntax: GO [|] [|] Where: Execution starting address. If an value is entered, the system loads the value into the program counter (PC), then starts execution at the address in the PC. If an value is not entered, execution begins at the address already in the PC. Execution stop address. The value must be an instruction fetch address; if it is not, code execution continues as if the command had no value. NOTE: The label of an instruction in source code. Be careful about using the G, GO, or GOTIL commands if the code branches into internal RAM (for instance, option RAM) or EEPROM. An execution stop address is invalid for internal locations. Examples: >GO Begin code execution at the current PC value. >GO 145 Begin code execution at address 145. >GO START Begin code execution at label START in source code. >GO 200 271Begin code execution at address 200. End code execution just before the instruction at address 271. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 129 Freescale Semiconductor, Inc. Command-Line Commands GOTIL Execute Program until Address GOTIL The GOTIL command executes the program in the emulator, beginning at the address in the program counter (PC). Execution continues until the program counter contains the specified address during an opcode fetch cycle. If a map file has been loaded, symbols (or labels) from the source code can be used as arguments. Freescale Semiconductor, Inc... Syntax: GOTIL | Where: NOTE: Execution stop address. The value must be an instruction fetch address; if it is not, code execution continues as if the command had no value. The label of an instruction in source code. Be careful about using the G, GO, or GOTIL commands if the code branches into internal RAM (for instance, option RAM) or EEPROM. An execution stop address is invalid for internal locations. Example: >GOTIL 0FF0 Execute the program in the emulator up to address 0FF0. MMDS0508OM/D 130 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations H Set/Clear H Bit H The H command sets the H bit of the condition code register (CCR) to the specified value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: H 0|1 Where: 0 Clears the H bit 1 Sets the H bit Example: >H 1 Set the H bit of the CCR. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 131 Freescale Semiconductor, Inc. Command-Line Commands HELP Display Help Information HELP The HELP command displays a list of help topics such as commands and function keys. Freescale Semiconductor, Inc... If commands are selected, the software displays an alphabetic index of the command set from which a command can be selected. To select help for a command, highlight the command using the page up/down keys and the arrow keys, then press . The command description screen shows the command name and its syntax and describes the command. When appropriate, the description includes examples and clarifying notes. Selecting key commands brings up a list of screens in which function-key assignments differ. Select a screen to see its function-key assignments. Use the arrow keys to scroll within the page; use the page up and page down keys to see other pages. To exit the HELP data base and return to the previous screen, press the ESC key. Syntax: HELP [] Where: Name of a command for which a description is needed Examples: >HELP Display the HELP screens. >HELP ASM Display the description of the ASM command. Related key command: Pressing pulls up the main help window. MMDS0508OM/D 132 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations HOMEBSA Go to Trace Buffer Start HOMEBSA The HOMEBSA command sets the trace buffer pointer to the first record of trace data. This command requires an open log file and loaded uploaded trace buffer data. Subsequent execution of the SCREENBSA command logs the first 20 records of analyzer data to the open log file. Syntax: Freescale Semiconductor, Inc... HOMEBSA Example: >LF Open a log file. >GETBSA Upload captured analyzer. >HOMEBSA Position trace buffer pointer to first record. >SCREENBSA Log first 20 records to open log file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 133 Freescale Semiconductor, Inc. Command-Line Commands HREG Set H Register NOTE: HREG This command is for the MMDS08 only. The HREG command sets the upper byte of the index register to the specified value. Syntax: Freescale Semiconductor, Inc... HREG Where: The new value for the H register Example: >HREG F0 Set the H register value to F0. MMDS0508OM/D 134 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations HX Set H:X Index Register NOTE: HX This command is for the MMDS08 only. The HX command sets both bytes of the concatenated index register (H:X) to the specified value. Syntax: Freescale Semiconductor, Inc... HX Where: The new value for the H:X register Example: >HX 0400 Set the H:X index register to $400. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 135 Freescale Semiconductor, Inc. Command-Line Commands I Set/Clear I Bit I The I command sets the I bit in the condition code register (CCR) to the specified value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: I 0|1 Where: 0 Clears the I bit 1 Sets the I bit Example: >I 1 Set the I bit of the CCR. MMDS0508OM/D 136 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations INFO INFO Display Line Information The INFO command displays information about the highlighted line in the source window. This information includes the name of the file being displayed in the window, the line number, address, corresponding object code, and the disassembled instruction. Syntax: Freescale Semiconductor, Inc... INFO Example: >INFO Filename Address Disassembly : : : 05TESTCO.ASM $0100 0100 99 Line number : !117 SEC If a map file is loaded and the highlighted instruction has a label, the label will be displayed in the disassembly line in place of the address. Example: >INFO Filename Address Disassembly : : : 05TESTCO.ASM $0100 START 99 Line number : !117 SEC MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 137 Freescale Semiconductor, Inc. Command-Line Commands LF LF Log File The LF command starts or stops logging of commands and responses to an external file. If logging is not enabled, enter this command to start logging. While logging remains in effect, any line that is appended to the command log window also is written to the log file. Logging continues until another LF command is entered; this second command disables logging and closes the log file. Freescale Semiconductor, Inc... If the specified file does not already exist, this command creates the file. If the specified file does exist already, the command prompts for overwrite or append: File exists, Rewrite or Append? [R]: If (accept the default) is pressed, or R and , the log entries overwrite the data in the existing file. If A and are pressed, the system appends log entries to the file. Syntax: LF Where: The DOS filename of the log file; the command interpreter does not assume a filename extension. Examples: >LF log file Start logging. Write to file log file (in the current directory) all lines added to the command log window. >LF If logging is enabled: Disable logging and close the log file. MMDS0508OM/D 138 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations LOAD Load S19 File LOAD The LOAD command loads a file in .S19 format (and any map file with the same name) into the emulator. If no argument is supplied, the command pops up a file select window. Syntax: LOAD [] Freescale Semiconductor, Inc... Where: The name of the S-record file to be loaded. An extension of .S19 is the default and can be omitted. The extension must be specified for files with other extensions. A path name followed by the asterisk (*) wildcard character can be entered. In that case, the command displays a window that lists the files in the specified directory that have the .S19 extension. Examples: >LOAD PROG1.S19 Load file PROG1.S19 and its map file into the emulator at the load addresses in the file. >LOAD PROG2 Load file PROG2.S19 and its map file into the emulator at the load addresses in the file. >LOAD A:* Display the names of the .S19 files on the diskette in drive A: for user selection of a file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 139 Freescale Semiconductor, Inc. Command-Line Commands LOADMAP LOADMAP Load Symbols The LOADMAP command loads a map file that contains symbol information from source code. If no argument is supplied, the command pops up a file select window. Syntax: LOADMAP [] Freescale Semiconductor, Inc... Where: The name of the map file to be loaded. An extension of .MAP is the default and can be omitted. The extension must be specified for files with other extensions. A pathname followed by the asterisk (*) wildcard character can be entered. In that case, the command displays a window that lists the files in the specified directory that have the .MAP extension. Examples: >LOADMAP PROG1.MAP Load map file PROG1.MAP into the host computer. >LOADMAP PROG2 Load map file PROG2.MAP into the host computer. >LOADMAP A:* Display the names of the .MAP files on the diskette in drive A:, for user selection of a file. MMDS0508OM/D 140 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations LOADMEM LOADMEM Load Personality File Personality files are used to customize the emulation memory map for a specific microcontroller device. A personality file to be loaded could have been shipped with an emulation module (EM) or could have been created by pressing the F6 key in the SETMEM window. Freescale Semiconductor, Inc... The LOADMEM command loads the memory map for the emulator with the map information from the specified file. Syntax: LOADMEM [] Where: The name of the memory-mapping file to be loaded. An extension of .MEM is the default and can be omitted. If a pathname followed by the asterisk (*) wildcard character is entered, the command displays a window that lists the files in the specified directory that have the .MEM extension. If a .MEM file is selected that is not appropriate for the current EM installed, an error will be generated. Examples: >LOADMEM 000P4V01.MEM Make 000P4V01.MEM the current memory-mapping file. >LOADMEM 003FEV01.MEM Make 003FEV01.MEM the current memory-mapping file. >LOADMEM A:* Display the names of the .MEM files on the diskette in drive A:, for user selection of a file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 141 Freescale Semiconductor, Inc. Command-Line Commands LOADTRIGGERS Load Bus State Analyzer Setup LOADTRIGGERS The LOADTRIGGERS command loads the bus state analyzer setup information from the specified file. To write such a file, use the bus state analyzer setup screen to define the triggers, then press the F6 key. Syntax: Freescale Semiconductor, Inc... LOADTRIGGERS [] where: The name of the setup file to be loaded. An extension of .SET is the default and can be omitted. The extension must be specified for files with other extensions. You can enter a pathname followed by the asterisk (*) wildcard character. In that case, the command displays a window that lists the files in the specified directory that have the .SET extension. Examples: >LOADTRIGGERS BSA.SET Make BSA.SET the current BSA setup file. >LOADTRIGGERS BSA8 Make BSA8.SET the current BSA setup file. >LOADTRIGGERS A:* Display the names of the .SET files on the diskette in drive A:, for user selection of a file. MMDS0508OM/D 142 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations MD Memory Display MD The MD command displays (in the memory F3 window) the contents of 32 emulation memory locations. The specified address is the first of the 32 locations. If a log file is open, this command also writes the first 16 values to the log file. Syntax: Freescale Semiconductor, Inc... MD Where: The starting memory address for display in the memory window Example: >MD 1000 Display the contents of 32 bytes of memory beginning at address 1000. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 143 Freescale Semiconductor, Inc. Command-Line Commands MM MM Memory Modify The MM command lets the user interactively examine and modify contents of memory locations. Writes to memory are verified and a "write did not verify" is displayed if the write could not be verified. Note that this message may be acceptable in some situations, such as writing to registers that have write-only bits. Freescale Semiconductor, Inc... If any data arguments are entered with this command, the system stores the values, beginning at the specified address. This command does not alter the contents of CPU registers such as the program counter (PC). Syntax: MM [] [] Where: The address of a memory location to be modified The value(s) to be stored at the location. If more than one data byte is supplied, the two data bytes are stored in consecutive memory locations starting at the address argument. If is not supplied, the command flow will display the current contents of the specified address and an entry prompt for data. The syntax for entry at the MM data prompt is: [][] MMDS0508OM/D 144 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations MM Memory Modify MM Freescale Semiconductor, Inc... Where: The value to be stored at the argument. The command terminator character controls the next step in the command flow. The four choices are: a. If no is supplied, address flow will sequence forward. b. If the equal (=) character is entered, flow will stay at the current address. c. If the carat (^) character is entered, flow will sequence backward to the previous address. d. If the period (.) character is entered, flow will terminate and return to the command line prompt. Examples: The first example does not have a value in the command line, permitting entry of new values for consecutive addresses. Entering a period instead of a new value stops the command: >MM 1000 1000 = 0F >05 1001 = 10 >. The second example includes a value, so the command modifies only one memory location: >MM 100 00 MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 145 Freescale Semiconductor, Inc. Command-Line Commands N Set/Clear N Bit N The N command sets the N bit of the condition code register (CCR) to the specified value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: N 0|1 Where: 0 Clears the N bit 1 Sets the N bit Example: >N 1 Set the N bit of the CCR. MMDS0508OM/D 146 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations NEXTA Go to Next A Event NEXTA The NEXTA command displays the next occurrence of an A event in the debug window. If a log file is open, this command also writes that frame to the log file. If the NEXTA event cannot be found, the last captured event in the trace buffer is displayed. Syntax: Freescale Semiconductor, Inc... NEXTA Example: >NEXTA Scroll the bus state analyzer display to the next A event. Related Key Command: Alt-A while in the bus state analyzer data window. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 147 Freescale Semiconductor, Inc. Command-Line Commands NEXTB Go to Next B Event NEXTB The NEXTB command displays the next occurrence of a B event in the debug window. If a log file is open, this command also writes that frame to the log file. If the NEXTB event cannot be found, the last captured event in the trace buffer is displayed. Syntax: Freescale Semiconductor, Inc... NEXTB Example: >NEXTB Scroll the bus state analyzer display to the next B event. Related Key Command: Alt-B while in the bus state analyzer data window. MMDS0508OM/D 148 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations NEXTC Go to Next C Event NEXTC The NEXTC command displays the next occurrence of a C event in the debug window. If a log file is open, this command also writes that frame to the log file. If the NEXTC event cannot be found, the last captured event in the trace buffer is displayed. Syntax: Freescale Semiconductor, Inc... NEXTC Example: >NEXTC Scroll the bus state analyzer display to the next C event. Related Key Command: Alt-C while in the bus state analyzer data window. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 149 Freescale Semiconductor, Inc. Command-Line Commands NEXTD Go to Next D Event NEXTD The NEXTD command displays the next occurrence of a D event in the debug window. If a log file is open, this command also writes that frame to the log file. If the NEXTD event cannot be found, the last captured event in the trace buffer is displayed. Syntax: Freescale Semiconductor, Inc... NEXTD Example: >NEXTD Scroll the bus state analyzer display to the next D event. Related Key Command: Alt-D while in the bus state analyzer data window. MMDS0508OM/D 150 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations NEXTE Go to Next Event NEXTE The NEXTE command positions the bus state analyzer display at the next occurrence of any event. The data record is displayed in the debug window. If a log file is open, this command also writes that frame to the log file. If another event is not found, the last captured event in the trace buffer is displayed. Freescale Semiconductor, Inc... Syntax: NEXTE Example: >NEXTE event. Scroll the bus state analyzer display to the next Related Key Command: Alt-E while in the bus state analyzer data window. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 151 Freescale Semiconductor, Inc. Command-Line Commands NOBR Clear Breakpoints NOBR Freescale Semiconductor, Inc... The NOBR command clears one instruction breakpoint, all instruction breakpoints, or all instruction breakpoints within an address range. If a map file has been loaded, symbols (or labels) from the source code can be used as arguments. If this command has only one argument, it clears the breakpoint at that address. If this command has no argument, it clears all current breakpoints. If this command has two address values, it clears all instruction breakpoints in the range the addresses define. Syntax: NOBR [||] Where: The address of a single breakpoint to be removed The range of addresses from which all breakpoints should be removed The label of an instruction in source code. Examples: >NOBR Clear all current instruction breakpoints. >NOBR 120 Clear the instruction breakpoint at address 120. >NOBR 120 140 Clear all instruction breakpoints in the address range 120 to 140. >NOBR START Clear a previously set breakpoint at address label START in source code. MMDS0508OM/D 152 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations OSC Select Emulator Clock Frequency OSC The MMDS platform board can supply an oscillator clock source for the MCU’s OSC1 input. Freescale Semiconductor, Inc... For the MMDS05, five clock frequencies are available. The four internally generated clock frequencies are available: 8 MHz, 4 MHz, 2 MHz, and 1 MHz and an external clock source. Entering emulator clock (OSC) command without the designated frequency brings up the temporary MMDS emulator clock frequency window near the center of the debug screen. Use the up/down arrow keys to select the emulator MCU's clock frequency and press to complete the selection. The default emulator clock rate is 2 MHz. For the MMDS08, six clock frequencies are available. The five internally generated clock frequencies are available: 16 MHz, 8 MHz, 4 MHz, 2 MHz, and 1 MHz and an external clock source. The default emulator clock rate is 4 MHz. Entering this command without the argument brings up the EM oscillator window. An oscillator frequency can be selected via this window. NOTE: Many EMs require a specific jumper configuration in order to use this clock source. Refer to the EM user's manual for EM clock source information. Syntax: OSC [ | ] Where: 8, 4, 2, or 1 External Examples: >OSC 4 Use the 4-MHz internal emulator clock. >OSC EX Use the external emulator clock. >OSC Bring up the emulator clock window. The current oscillator setting will be highlighted. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 153 Freescale Semiconductor, Inc. Command-Line Commands PC PC Set Program Counter The PC command sets the program counter (PC) to the specified address. Syntax: PC Freescale Semiconductor, Inc... Where: The new address value for the PC Example: PC 0500 Set the PC to 0500. MMDS0508OM/D 154 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations QUIT Terminate Host Session QUIT The QUIT command terminates the host session and returns to DOS. The QUIT and EXIT commands are identical. Another way to end a host session is to enter the ALT-X keyboard combination. Syntax: QUIT Freescale Semiconductor, Inc... Example: >QUIT Return to DOS. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 155 Freescale Semiconductor, Inc. Command-Line Commands REG Display Registers REG The REG command displays the contents of the CPU registers in the debug F10 window. The command also will display the instruction pointed to by the current program counter value. Syntax: REG Freescale Semiconductor, Inc... Example: >REG PC:1196 A:00 X:90 SP:FF CCR:FA [BRCLR 1,0003,119C] MMDS0508OM/D 156 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations REM Add Comment to Script File REM The REM command adds a display comment to a script file. When the script file is executed, the system displays this comment. Syntax: REM Freescale Semiconductor, Inc... Where: The display comment. Example: >REM Program executing Display program executing only during script file execution. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 157 Freescale Semiconductor, Inc. Command-Line Commands RESET Reset Emulation MCU RESET The RESET command resets the emulation MCU and sets the program counter to the contents of the reset vector. This command does not start execution of user code. To reset and execute user code, use the RESETGO or WAIT4RESET command. Syntax: Freescale Semiconductor, Inc... RESET Example: >RESET Reset the MCU. MMDS0508OM/D 158 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations RESETGO Reset and Restart MCU RESETGO The RESETGO command resets the emulation MCU, sets the program counter (PC) to the contents of the reset vector, then starts execution from that address. Syntax: RESETGO Freescale Semiconductor, Inc... Example: >RESETGO Reset the MCU and go. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 159 Freescale Semiconductor, Inc. Command-Line Commands RESETIN Reset Input Enable RESETIN The RESETIN command makes it possible for the target system to reset the emulating MCU. Freescale Semiconductor, Inc... Entering this command toggles the MMDS state with regard to a reset signal from the target system. If this state is enabled, a reset signal from the target system resets the emulating MCU. If this state is disabled, a reset signal from the target system cannot reset the emulating MCU. The word Resetin appears in the debug screen status area to show the enabled state. The state must be enabled for proper operation of the WAIT4RESET command. NOTE: Certain EMs include a hardware jumper that governs target resets. Such a jumper must be configured correctly to use the RESETIN command. Consult the EM user's manual for additional information. Syntax: RESETIN Example: >RESETIN Toggle the MMDS RESETIN state. MMDS0508OM/D 160 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations RESETOUT Reset Output Enable RESETOUT The RESETOUT command makes it possible for the MMDS RESET command to reset the target system. Freescale Semiconductor, Inc... Entering this command toggles the MMDS state with regard to resetting the target system. If this state is enabled, entering the RESET command resets both the emulating MCU and the target system. The word Resetout appears in the debug screen status area to show the enabled state. If this state is disabled, entering the RESET command resets only the emulating MCU. The RESETOUT command also pertains to resets done via the RESETGO command. NOTE: Certain EMs include a hardware jumper that governs target resets. Such a jumper must be configured correctly to use the RESETOUT command. Consult your EM user's manual for additional information. Syntax: RESETOUT Example: >RESETOUT Toggle the MMDS RESETOUT state. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 161 Freescale Semiconductor, Inc. Command-Line Commands RTMEM Set Real-Time Memory Block RTMEM Freescale Semiconductor, Inc... The RTMEM command enables real-time-memory, starting at a specified address. The real-time memory consists of 32 bytes of dual-ported memory that is assigned to any valid memory address by this command. While the emulator is running, the system displays enabled real-time memory in the real-time memory window (this window replaces the memory F3 window). The display updates as the memory contents change. Entering the RTMEM command without an argument disables real-time memory, restoring previous memory map attributes. Real-time memory consists of memory enabled by the RTMEM command, plus real-time variables created via the RTVAR command. All this real-time memory must fit within a 1-Kbyte block. If an RTMEM command would result in real-time memory that would not fit within the 1-Kbyte block (due to established real-time variables), the system will not accept the RTMEM command. If any of the real-time memory overlays MCU I/O or EEPROM addresses, it is available only for monitoring emulation MCU writes. (You should not try to modify such locations.) You can monitor and modify real-time memory locations that do not overlay MCU I/O or EEPROM addresses. Syntax: RTMEM [ | ]] where: The beginning address of the real-time-memory. A symbol loaded from a .MAP file Example: >RTMEM 0200 Set the address of the real-time-memory to 0200 through 021F. MMDS0508OM/D 162 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations RTVAR Display Real-Time Variable RTVAR The RTVAR command displays the specified address and its contents in the variables F8 window as a real-time variable. If a MAP file is loaded, symbols from the source code can be used as arguments. Freescale Semiconductor, Inc... As many as 32 variables can be declared in the variables F8 window. The window shows 11 at a time. Using the RTVAR command establishes a real-time variable. The variable value will periodically be updated in the variables F8 window during emulation. You can also enter a new value for a real-time variable during emulation. The argument enables display of variables in byte, word, or string format. A byte display is hexadecimal and binary, a word display is hexadecimal and decimal, and a string display is ASCII. For an ASCII string, the optional argument specifies the number of characters; the default is the maximum 11 characters. Control and other non-printing characters appear as periods (.). Syntax: RTVAR[.] | [] Where: The variable type to display: B (byte, the default), W (word), or S (string) The address of the memory variable The number of characters to be displayed. Used only with the string type. If is omitted, 11 ASCII characters will be visible in the window, beginning at the argument location. A symbol loaded from a .MAP file MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 163 Freescale Semiconductor, Inc. Command-Line Commands RTVAR Display Real-Time Variable RTVAR Examples: >RTVAR 100 Display (in hexadecimal and binary) the byte at address 100 >RTVAR.B 110 Display (in hexadecimal and binary) the byte at Freescale Semiconductor, Inc... address 110 >RTVAR.W 102 Display (in hexadecimal and decimal) the word at address 102 >RTVAR.S 200 5Display the 5-character ASCII string starting at address 200 (The RTVAR command also establishes variables for display in the variables F8 window, but such variables are not real-time. The 32-variable maximum applies to variables established by both the RTVAR and VAR commands.) Real-time memory consists of memory enabled by the RTMEM command, plus real-time variables created via the RTVAR command. All this real-time memory must fit within a 1-Kbyte block. If an RTVAR command would create a real-time variable that would not fit within the 1-Kbyte block (due to established real-time variables or memory enabled by the RTMEM command), the system will not accept the RTVAR command. If any of the real-time memory overlays MCU I/O or EEPROM addresses, it is available only for monitoring emulation MCU writes. (You should not try to modify such locations.) You can monitor and modify real-time memory locations that do not overlay MCU I/O or EEPROM addresses. MMDS0508OM/D 164 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations SCREENBSA Log Bus State Analyzer Screen SCREENBSA The SCREENBSA command copies the current bus state analyzer display to an open log file. Syntax: Freescale Semiconductor, Inc... SCREENBSA Example: >SCREENBSA Copy the bus state analyzer display to the log file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 165 Freescale Semiconductor, Inc. Command-Line Commands SCRIPT Execute Script File SCRIPT The SCRIPT command executes a script file, which contains a sequence of emulator commands. Executing the script file has the same effect as executing the individual commands one after another. This makes a script file convenient for any sequence of commands that is needed often, such as unit test or initialization command sequences. Freescale Semiconductor, Inc... The REM and WAIT commands are useful primarily within script files. The REM command allows a comment to be displayed while the script file executes. The WAIT command establishes a delay between the execution of commands of the script file. NOTE: A script file can contain the SCRIPT command. Script files can be nested as many as 15 levels deep. If the script file has the filename STARTUP.05, the script file will be executed each time the MMDS is started. Syntax: SCRIPT Where: The name of the script file to be executed. An extension of .SCR is the default and can be omitted. The extension must be specified for files with other extensions. A path name followed by the asterisk (*) wildcard character can be entered. In that case, the command displays a window that lists the script files in the specified directory that have the .SCR extension. A file can be selected from the list. Examples: >SCRIPT INIT.SCR Execute commands in file INIT.SCR. >SCRIPT * Display all .SCR files, then execute the selected file. >SCRIPT A:* Display all .SCR files in drive A, then execute the selected file. >SCRIPT B:*.xyz Display all drive B files that have the extension .xyz then execute the selected file. MMDS0508OM/D 166 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations SETMEM SETMEM Customize Memory Map The SETMEM command allows customizing of the memory map. Entering this command brings up the custom map window as shown in Figure 18. The current RAM and ROM configuration will be shown in the window. To modify the map, enter the desired address ranges. Freescale Semiconductor, Inc... To write the modified map to a file for future use, press Save (F6), then enter the filename at the prompt. The system saves the new .MEM file under the specified name. If a file by the specified name already exists, a notice is made with the option to overwrite. The emulator can load this file using the LOADMEM instruction at a future time. Pressing Execute (F7) will use the newly defined memory map for the current debug session only. Custom Map RAM0 0080 00FF RAM1 XXXX XXXX RAM2 XXXX XXXX RAM3 XXXX XXXX ROM0 ROM1 ROM2 ROM3 0020 0100 1FF0 XXXX Vector 004F 08FF 1FFF XXXX 1FFE F6:SAVE F7:EXECUTE :CANCEL Figure 18. Custom Map Window MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 167 Freescale Semiconductor, Inc. Command-Line Commands SETMEM Customize Memory Map SETMEM The SETMEM command allows mapping over undefined memory or memory defined as RAM or ROM. Do not map over such internal resources as option RAM, I/O, or EEPROM. The SETMEM command automatically maps around internal resources. Freescale Semiconductor, Inc... NOTE: The SETMEM command can be used to expand the normal RAM and ROM ranges temporarily during debugging. Be sure to restore the original size and configuration of the MCU memory before final debugging. Otherwise, the code could fail to fit or run in an MCU’s memory space. The SETMEM and SHOWMEM commands only show MMDS resources. That is memory that is resident on the control board during emulation. Use the CHIPINFO command memory map feature to view internal I/O, option RAM, and EEPROM locations. Syntax: SETMEM MMDS0508OM/D 168 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations SHELL Access DOS SHELL The SHELL command allows access to DOS in the host computer. To return to MMDS from DOS, enter EXIT at the DOS prompt. MMDS continues to run during the shell to DOS. This could mean that the memory for other software is insufficient. Syntax: Freescale Semiconductor, Inc... SHELL Example: >SHELL Access the DOS shell. To return to the emulator session, type EXIT at the DOS prompt. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 169 Freescale Semiconductor, Inc. Command-Line Commands SHOWBSA Display Trace Buffer SHOWBSA This command copies a specified range of the current BSA display to the debug window and an open log file. Syntax: SHOWBSA Freescale Semiconductor, Inc... Where: The range of BSA frames a beginning frame and an ending frame separated by a space. MMDS0508OM/D 170 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations SHOWMEM Display Memory Map SHOWMEM The SHOWMEM command displays only the MMDS resources. That is memory that is resident on the control board during emulation. Use the CHIPINFO command memory map feature to view internal I/O, option RAM, and EEPROM locations. Syntax: Freescale Semiconductor, Inc... SHOWMEM Example: >SHOWMEM Display current memory map blocks. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 171 Freescale Semiconductor, Inc. Command-Line Commands SHOWTRIGGER Print Trigger SHOWTRIGGER The SHOWTRIGGER command displays the trigger frame of the bus state analyzer buffer. If a log file is open, this command also writes the trigger frame to the log file. Syntax: SHOWTRIGGER Freescale Semiconductor, Inc... Example: >SHOWTRIGGER Display the bus state analyzer trigger frame. MMDS0508OM/D 172 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations SNAPSHOT Save Screen SNAPSHOT The SNAPSHOT command saves a copy of the main screen to the open log file. A log file must be open or this command has no effect. NOTE: The main screen includes certain extended ASCII characters. When subsequently viewing a screen snapshot, a standard ASCII editor will display a few characters that do not match the original screen. Freescale Semiconductor, Inc... Syntax: SNAPSHOT Example: >SNAPSHOT Capture screen, save to a log file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 173 Freescale Semiconductor, Inc. Command-Line Commands SOURCE Source Window Display SOURCE Freescale Semiconductor, Inc... The SOURCE command toggles between source code and disassembled code in the source/code F2 window, located at the upper right of the debug screen. On entering MMDS software, the window defaults to disassembled code, the window title is CODE F2, and window contents are a disassembled representation of MCU memory. In this object code display, the disassembled instructions change when corresponding bytes of memory change. To scroll through this window, press the F2 key (to select the window), then use the arrow keys. The contents of the source/code F2 window change to source code when the SOURCE command is executed if: 1. A map file has been loaded (a map file is loaded with the S-record LOAD command) and 2. The program counter (PC) points to a memory area covered by the map file. Once a .MAP file has been loaded and the PC points to an area of user code, the SOURCE command can be used to toggle between source code and object code. If a mouse is installed, the symbols that appear at the bottom of the window can be selected. Use the mouse or arrow keys to scroll through the information in the window. Note that the F2 key does not pertain to this window if it shows source code. Table 6 lists the key commands available in this window when a source code is displayed. NOTE: When memory data that was generated from a source file is altered, the modified code appears in the code window but not the source file window. Use the CLEARMAP command to clear the source file from the host system. Syntax: SOURCE Example: >SOURCE window. Toggle the display in the source/code F2 MMDS0508OM/D 174 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations ST Single Step (Trace) ST The ST command executes a specified hexadecimal number of instructions, beginning at the current program counter (PC) address value. If a number is not specified, this command executes one instruction. The ST, STEP, and T commands are identical. Syntax: Freescale Semiconductor, Inc... ST [] Where: The hexadecimal number of instructions to be executed. Hexadecimal $7FF is the maximum value. NOTE: Do not use any step command (ST, STEP, STEPFOR, STEPTIL, or T) if the PC points to internal RAM or EEPROM or if the code branches into internal RAM or EEPROM. The step commands are not real-time. They execute one instruction at a time, then return control to the monitor. Do not rely on timer values. Examples: >ST Execute the instruction at the current PC address value. >ST 2 Execute two instructions, starting at the current PC address value. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 175 Freescale Semiconductor, Inc. Command-Line Commands STACK STACK Display Stack Freescale Semiconductor, Inc... The temporary stack window appears near the center of the debug screen when the STACK command is entered. As Figure 19 shows, this window displays the contents of the SP register at the top of the window. The 12 bytes at the top of the stack are displayed to the left. The interpretation of the stack shown to the right in the window is valid only if the last push to the stack was caused by an interrupt. Press the ESC key to remove the stack window and return to the debug window. Syntax: STACK Example: >STACK NOTE: Display the current configuration of the stack. The interrupt stack data to the right side of the window is an interpretation of the top five bytes on the stack. If the last push to the stack was due to a BSR or JSR instruction, five bytes were not pushed to the stack and the interrupt stack information is invalid. STACK Stack Pointer = 00F8 Raw Bytes: .... .. .... .. .... .. .... .. 00FF 7D 00FE 01 00FD 44 00FC 02 00FB 10 00FA FF 00F9 E5 SP> 00F8 07 Interrupt Stack: ...HINZC CCR > 11100101 A > FF X > 10 ret > 0244 Figure 19. Stack Window MMDS0508OM/D 176 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations STEP Single Step (Trace) STEP The STEP command executes a specified hexadecimal number of instructions, beginning at the current program counter (PC) address value. If a number is not specified, this command executes one instruction. The STEP, ST, and T commands are identical. Syntax: Freescale Semiconductor, Inc... STEP [] Where: NOTE: The hexadecimal number of instructions to be executed. Hexadecimal $7FF is the maximum value. Do not use any step command (ST, STEP, STEPFOR, STEPTIL, or T) if the PC points to internal RAM or EEPROM or if the code branches into internal RAM or EEPROM. The step commands are not real-time. They execute one instruction at a time, then return control to the monitor. Do not rely on timer values. Examples: >STEP Execute the instruction at the current PC address value. >STEP 2 Execute two instructions, starting at the current PC address value. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 177 Freescale Semiconductor, Inc. Command-Line Commands STEPFOR Step Forever STEPFOR The STEPFOR command begins continuous instruction execution, beginning at the current program counter (PC) address value. Execution stops when a key is pressed. Syntax: STEPFOR Freescale Semiconductor, Inc... NOTE: Do not use any step command (ST, STEP, STEPFOR, STEPTIL, or T) if the PC points to internal RAM (for instance, option RAM) or EEPROM or if the code branches into internal RAM or EEPROM. The step commands are not real-time. They execute one instruction at a time, then return control to the monitor. Do not rely on timer values. Example: >STEPFOR Execute instructions continuously until the user presses a key. MMDS0508OM/D 178 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations STEPTIL Single Step to Address STEPTIL The STEPTIL command continuously executes instructions from the current program counter (PC) address value until the PC reaches the specified address. Syntax: STEPTIL Freescale Semiconductor, Inc... Where: NOTE: The address at which instruction execution stops; this location must be an instruction address. Do not use any step command (ST, STEP, STEPFOR, STEPTIL, or T) if the PC points to internal RAM or EEPROM or if the code branches into internal RAM or EEPROM. The step commands are not real-time. They execute one instruction at a time, then return control to the monitor. Do not rely on timer values. Example: >STEPTIL 0400 Execute instructions continuously until the PC value is 0400 during an opcode fetch cycle. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 179 Freescale Semiconductor, Inc. Command-Line Commands STOP Stop Program Execution STOP The STOP command stops user program execution and updates the debug screens with current data. Syntax: STOP Freescale Semiconductor, Inc... Example: >STOP screen. Stop program execution and update the debug MMDS0508OM/D 180 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations SXB Set Multiplexer SXB The SXB command sets the analyzer to capture either a 16-bit timetag counter and the eight pod B logic clips or a 24-bit timetag counter. The default is to use the 16-bit timetag and pod B. NOTE: When using the logic clip cables, always attach the black clip to ground. Syntax: Freescale Semiconductor, Inc... SXB CLIPS|TAGS Where: CLIPS Directs the analyzer to capture the pod B logic clips with 16-bit timetag counter. TAGS Directs the analyzer to capture a 24-bit timetag counter. Example: >SXB TAGS Select extended time tag bits. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 181 Freescale Semiconductor, Inc. Command-Line Commands SYSINFO System Information SYSINFO The SYSINFO command calls to DOS for the amount of memory available, then displays this information in the debug F10 window. Syntax: SYSINFO Freescale Semiconductor, Inc... Example: >SYSINFO Show system information. Total memory available: 187488 Largest free block: 187488 MMDS0508OM/D 182 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations T Single Step (Trace) T The T command executes a specified hexadecimal number of instructions beginning at the current program counter (PC) address value. If a number is not specified, this command executes one instruction. The T, ST, and STEP commands are identical. Syntax: Freescale Semiconductor, Inc... T [] Where: NOTE: The hexadecimal number of instructions to be executed. Hexadecimal $7FF is the maximum value. Do not use any step command (ST, STEP, STEPFOR, STEPTIL, or T) if the PC points to internal RAM (for instance, option RAM) or EEPROM or if the code branches into internal RAM or EEPROM. The step commands are not real-time. They execute one instruction at a time, then return control to the monitor. Do not rely on timer values. Examples: >T Execute the instruction at the current PC address value. >T 4 Execute four instructions beginning at the current PC address value. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 183 Freescale Semiconductor, Inc. Command-Line Commands TIMETAG Time Tag Clock Source TIMETAG The TIMETAG command selects the source and frequency for the analyzer time tag clock. Entering this command with no parameter values brings up the time tag window, from which you can select a frequency or a source. If you select a frequency, the system uses an internal source of the frequency chosen. If you select a source, the system prompts for an appropriate frequency value. Freescale Semiconductor, Inc... If you select the external source, connect logic clip TT_OSC (white) of the pod B cable to the external clock source. (The pod B connector is the closest to the front of the station module.) NOTE: When using the logic clip cables, always attach the black clip to ground. Syntax: TIMETAG [[] []] Where: The source for the analyzer timetag clock. The clock can be provided from one of four sources: 1. Internal (MMDS platform board), programmable, external or emulation module. With no source specified, the internal source is understood. To specify other possible clock sources, use the following: 2. EM Use the bus clock of the MCU being emulated 3. PR Use a programmable clock in the range of 50 to 50,000 Hz 4. EX Use an external clock provided through the TT_OSC logic clip (white) of pod B MMDS0508OM/D 184 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations TIMETAG Time Tag Clock Source Freescale Semiconductor, Inc... TIMETAG The frequency for the timetag clock. When specifying the internal source, the value is in MHz with 1, 2, 4, 8, and 16 as the possible options. The programmable timetag source requires an integer value between 50 and 50,000 Hz. When an external source or the MCU bus clock are used for the timetag clock, the value entered is only used for timing calculations displayed in the analyzer data screen. Examples: >TIMETAG >TIMETAG 8 Display the time tag window (for user selection of a frequency or source). Select the 8-MHz time tag frequency. >TIMETAG PR 120 Select a 120-Hz programmable source. >TIMETAG EX 32768 Select the external source and notify host that frequency is 32.768 kHz. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 185 Freescale Semiconductor, Inc. Command-Line Commands V Set/Clear V Bit NOTE: V This command is for the MMDS08 only. The V command sets the V bit in the condition code register (CCR) to the specified value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are at the lower right of the CPU window. The CCR pattern is V11HINZC (V is overflow, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: V 0|1 Where: 0 Clears the V bit 1 Sets the V bit Example: >V 0 Clears the V bit in the CCR. MMDS0508OM/D 186 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations VAR Display Variable VAR The VAR command displays the specified address and its contents in the variables F8 window. If a map file has been loaded, symbols and labels from the source code can be used as arguments. Freescale Semiconductor, Inc... As many as 32 variables can be declared in the variables F8 window. The window shows 11 at a time. Using the VAR command establishes such a variable. (The RTVAR command also establishes variables for display in the variables F8 window, but such variables are not real-time. The 32-variable maximum applies to variables established by both the RTVAR and VAR commands.) The argument enables display of variables in byte, word, or string format. A byte display is hexadecimal and binary, a word display is hexadecimal and decimal, and a string display is ASCII. For an ASCII string, the optional argument specifies the number of characters; the default is the maximum 11 characters. Control and other non-printing characters appear as periods (.). Syntax: VAR[.] | [] Where: The variable type to display: B (byte, the default), W (word), or S (string) The address of the memory variable The number of characters to be displayed. Used only with the string type. If is omitted, 11 ASCII characters will be visible in the window, beginning at the argument location. A symbol loaded from a .MAP file MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 187 Freescale Semiconductor, Inc. Command-Line Commands VAR Display Variable VAR Examples: >VAR 100 Display (in hexadecimal and binary) the byte at address 100 >VAR.B 110 Display (in hexadecimal and binary) the byte at address 110 >VAR.W 102 Display (in hexadecimal and decimal) the word at Freescale Semiconductor, Inc... address 102 >VAR.S 200 5Display the 5-character ASCII string starting at address 200 MMDS0508OM/D 188 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations VER Display Version VER The VER command displays the version of the host software and of the current personality (.MEM) file. The abbreviated VER is equivalent to the VERSION command. Syntax: VER Freescale Semiconductor, Inc... Example: >VER Display the version numbers of the host software and the currently loaded personality file. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 189 Freescale Semiconductor, Inc. Command-Line Commands VERSION Display Version VERSION The VERSION command displays the version of the host software and of the current personality (.MEM) file. The abbreviated VER form of this command also can be used. Syntax: VERSION Freescale Semiconductor, Inc... Example: >VERSION Display the version numbers of the host software and the currently loaded personality file. MMDS0508OM/D 190 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations VF View File VF The VF command allows the user to view any file. If no argument is supplied, the command pops up a file select window. Syntax: VF [] Freescale Semiconductor, Inc... Where: Any text file Examples: NOTE: >VF test, log Displays test.log in view file screen >VF *.asm Displays the names of the .asm files The view file buffer size is determined by the total memory available (see SYSINFO command), if the selected file exceeds memory resources. The entire file will not be viewed. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 191 Freescale Semiconductor, Inc. Command-Line Commands WAIT Pause between Commands WAIT The WAIT command causes the command interpreter to pause for a specified hexadecimal number of seconds. (The default is five.) This command is useful primarily in script files. Syntax: WAIT [] Freescale Semiconductor, Inc... Where: The hexadecimal number of seconds to pause. Example: >WAIT A Pause the command interpreter for 10 seconds. MMDS0508OM/D 192 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations WAIT4RESET Wait for Target Reset WAIT4RESET The WAIT4RESET command puts the emulation MCU into the reset state until the target system provides a reset signal. Freescale Semiconductor, Inc... For this command to function properly, enable the state of the MMDS with a reset signal from the target system. (See the explanation of the RESETIN command.) To restore the emulator to the IDLE state, enter the RESET command. Syntax: WAIT4RESET Example: >WAIT4RESET Wait for reset. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 193 Freescale Semiconductor, Inc. Command-Line Commands WHEREIS Display Symbol Value WHEREIS The WHEREIS command displays a symbol or address. If the argument is a symbol, this command displays the symbol's address. If the argument is an address, this command displays the corresponding symbol, if one is assigned. If the symbol is the same as a hexadecimal address, the command shows the hexadecimal address, not the address of the symbol. Freescale Semiconductor, Inc... Syntax: WHEREIS | Where: A symbol listed in the symbol table An address for which a symbol is desired Examples: >WHEREIS START Display the symbol START and its value. >WHEREIS 0100 Display the value 0100 and its symbol, if any. MMDS0508OM/D 194 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations X Set X Index Register X The X command sets the index register (X) to the specified value. The X command is identical to the XREG command. Syntax: X Freescale Semiconductor, Inc... Where: The new value for the X register Example: >X 05 Set the index register value to 05. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 195 Freescale Semiconductor, Inc. Command-Line Commands XREG Set X Index Register XREG The XREG command sets the index register (X) to the specified value. The XREG command is identical to the X command. Syntax: XREG Freescale Semiconductor, Inc... Where: The new value for the X register Example: >XREG F0 Set the index register value to F0. MMDS0508OM/D 196 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Command-Line Commands Command Explanations Z Set/Clear Z Bit Z The Z command sets the Z bit in the condition code register (CCR) to the specified value. Freescale Semiconductor, Inc... NOTE: The CCR bit designators are at the lower right of the CPU window. The CCR pattern is V11HINZC (V is two’s complement overflow for M68HC08 MCU only and is 1 for M68HC05 MCU, H is half-carry, I is IRQ interrupt mask, N is negative, Z is zero, V is overflow, and C is carry). A letter in these designators means that the corresponding bit of the CCR is set; a period means that the corresponding bit is clear. Syntax: Z 0|1 Where: 0 Clears the Z bit 1 Sets the Z bit Example: >Z 0 Clears the Z bit in the CCR. MMDS0508OM/D MOTOROLA Command-Line Commands For More Information On This Product, Go to: www.freescale.com 197 Freescale Semiconductor, Inc. Command-Line Commands ZOOM Resize Source Window ZOOM The ZOOM command toggles the size of the source window between normal and enlarged. Another way to resize the source window is to enter the ALT-Z keyboard combination. Syntax: ZOOM Freescale Semiconductor, Inc... Example: >ZOOM Resize the source window. MMDS0508OM/D 198 Command-Line Commands For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. S-Record Information Contents Freescale Semiconductor, Inc... Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 S-Record Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200 S-Record Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201 S-Record Creation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202 S-Record Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202 Introduction The Motorola S-record format was devised for the purpose of encoding programs or data files in a printable format for transportation between computer systems. This transportation process can therefore be monitored and the S-records can be easily edited. MMDS0508OM/D MOTOROLA S-Record Information For More Information On This Product, Go to: www.freescale.com 199 Freescale Semiconductor, Inc. S-Record Information S-Record Content When observed, S-records are essentially character strings made of several fields which identify the record type, record length, memory address, code/data, and checksum. Each byte of binary data is encoded as a two-character hexadecimal number: the first character representing the high-order four bits and the second the low-order four bits of the byte. Freescale Semiconductor, Inc... Five field which comprise an S-record are shown below: TYPE RECORD LENGTH ADDRESS CODE/DATA CHECKSUM where the fields are composed as shown in Table 15. Table 15. S-Record Field Description Field Printable Character s Contents Type 2 S-record type — S0, S1, etc. Record Length 2 Character pair count in the record, excluding the type and record length. Address 4, 6, or 8 2-, 3-, or 4-byte address at which the data field is to be loaded into memory. 0–2n From 0 to n bytes of executable code, memory loadable data, or descriptive information. For compatibility with teletypewriter, some programs may limit the number of bytes to as few as 28 (56 printable characters in the S-record). 2 Least significant byte of the one’s complement of the sum of the values represented by the pairs of characters making up the record length, address, and the code/data fields. Code/Data Checksum Each record may be terminated with a CR/LF/NULL. Additionally, an S-record may have an initial field to accommodate other data such as line numbers generated by some time-sharing system. Accuracy of transmission is ensured by the record length (byte count) and checksum fields. MMDS0508OM/D 200 S-Record Information For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. S-Record Information S-Record Types S-Record Types Freescale Semiconductor, Inc... Eight types of S-records have been defined to accommodate the several needs of the encoding, transportation, and decoding functions. The various Motorola upload, download, and other record transportation control programs, as well as cross assemblers, linkers, and other file-creating or debugging programs, utilize only those S-records which serve the purpose of the program. For specific information on which S-records are supported by a particular program, the user manual for that program must be consulted. NOTE: The MMDS supports only the S0, S1, and S9 record types. All data before the first S1 record is ignored. Thereafter, all records must be S1 type until the S9 record, which terminates data transfer. An S-record format may contain the following record types: S0 Header record for each block of S-records. The code/data field may contain any descriptive information identifying the following block of S-records. The address field is normally zeroes. S1 Code/data record and the two-byte address at which the code/data is to reside. S2–S8 Not applicable to MMDS. S9 Termination record for a block of S1 records. Address field may optionally contain the two-byte address of the instruction to which control is to be passed. If not specified, the first interplant specification encountered in the input will be used. There is no code/data field. Only one termination record is used for each block of s-records. Normally, only one header record is used, although it is possible for multiple header records to occur. MMDS0508OM/D MOTOROLA S-Record Information For More Information On This Product, Go to: www.freescale.com 201 Freescale Semiconductor, Inc. S-Record Information S-Record Creation S-record format programs may be produced by dump utilities, debuggers, cross assemblers, or cross linkers. Several programs are available for downloading a file in S-record format from a host system to an 8-bit or 16-bit microprocessor-based system. Freescale Semiconductor, Inc... S-Record Example Shown here is a typical S-record format, as printed or displayed: S00600004844521B S1130000285F245F2212226A000424290008237C2A S11300100002000800082529001853812341001813 S113002041E900084E42234300182342000824A952 S107003000144ED492 S9030000FC The above format consists of an S0 header record, four S1 code/data records, and an S9 termination record. The S0 header record is described in Table 16. Table 16. S0 Record Description Field S-Record Entry Description Type S0 S-record type S0, indicating a header record. Record Length 06 Hexadecimal 06 (decimal 6), indicating six character pairs (or ASCII bytes) follow. Address 0000 Four-character two-byte address field, zeroes. Code/Data 48 44 52 Descriptive information identifies the following S1 records: ASCII H, D, and R — "HDR" Checksum 18 Checksum of S0 record. MMDS0508OM/D 202 S-Record Information For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. S-Record Information S-Record Example The first S1 record is explained in Table 17. Table 17. S1 Record Description Freescale Semiconductor, Inc... Field S-Record Entry Description Type S1 S-record type S1, indicating a code/data record to be loaded/verified at a two-byte address. Record Length 13 Hexadecimal 13 (decimal 19), indicating 19 character pairs, representing 19 bytes of binary data, follow. Address 0000 Four-character two-byte address field; hexadecimal address 0000, indicates location where the following data is to be loaded. Code/ Data Checksu m Opcode 285F 245F 2212 226A 000424 2900 08237 2A Instruction BHCC$0161 BCC$0163 BHI$0118 BHI$0172 BRSET0, $04, $012F BHCS$010D BRSET4, $23, $018C Checksum of the first S1 record. The 16 character pairs shown in the code/data field of Table 17 are the ASCII bytes of the actual program. The second and third S1 code/data records each also contain $13 (19) character pairs and are ended with checksum 13 and 52, respectively. The fourth S1 code/data record contains 07 character pairs and has a checksum of 92. MMDS0508OM/D MOTOROLA S-Record Information For More Information On This Product, Go to: www.freescale.com 203 Freescale Semiconductor, Inc. S-Record Information The S9 termination record is explained in Table 18. Table 18. S9 Record Description S-Record Entry Freescale Semiconductor, Inc... Field Description Type S9 S-record type S9, indicating a termination record. Record Length 03 Hexadecimal 03, indicating three character pairs (three bytes) follow. Address 0000 Four-character two-byte address field, zeroes. Code/Data There is no code/data in a S9 record. Checksum FC Checksum of S9 record. Each printable ASCII character in an S-record is encoded in binary. Table 19 gives an example of encoding for the S1 record. The binary data is transmitted during a download of an S-record from a host system to a 8- or 16-bit microprocessor-based system. Table 19. Example of S-Record Encoding TYPE S 5 LENGTH 1 3 3 1 1 3 ADDRESS 3 1 3 0 3 3 0 0 3 CODE/DATA 0 0 3 0 0 3 2 0 3 8 2 3 CHECKSUM 5 8 3 ... F 5 4 6 0101 0011 0011 0001 0011 0001 0011 0011 0011 0000 0011 0000 0011 0000 0011 0000 0011 0010 0011 1000 0011 0101 0100 0110 ... ... 2 3 A 2 4 1 0011 0010 0100 0001 MMDS0508OM/D 204 S-Record Information For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Index Freescale Semiconductor, Inc... A A, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 ACC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Arguments, Command-Line Commands . . . . . . . . . . . . . . . . . . 103 ARM, . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 ASM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 B BAUD . . . . . . . . . . . . . . . . . . . . . . . . . 61, 110 Baud Rate . . . . . . . . . . . . . . . . . . . . . . . . . 61 BAUDCHK . . . . . . . . . . . . . . . . . . . . . 61, 111 BELL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112 BF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 BR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 BSAMODE . . . . . . . . . . . . . . . . . . . . . . . . 115 BSATT . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Bus State Analyzer . . . . . . . . . . . . . . . . . . . 77 Collecting Bus Data . . . . . . . . . . . . . . . 87 Defining Events . . . . . . . . . . . . . . . . . . . 79 Searching the Trace Buffer . . . . . . . . . . 95 Selecting Options . . . . . . . . . . . . . . . . . 86 Selecting the Trigger Mode . . . . . . . . . . 84 Using the Time-Tag Clock . . . . . . . . . . 96 Viewing Data . . . . . . . . . . . . . . . . . . . . . 88 C C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Cables, Connecting Host Computer . . . . . . . . . . . . . . . . . . . 26 Power . . . . . . . . . . . . . . . . . . . . . . . . . .27 Target . . . . . . . . . . . . . . . . . . . . . . . . . .27 CCR . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118 CHIPINFO . . . . . . . . . . . . . . . . . . . . . . . .119 CLEARMAP . . . . . . . . . . . . . . . . . . . . . . .120 COLORS . . . . . . . . . . . . . . . . . . . . . . . . .121 Colors, Changing Screen . . . . . . .58, 70, 121 Command Lines A . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 ACC . . . . . . . . . . . . . . . . . . . . . . . . . . .107 ARM . . . . . . . . . . . . . . . . . . . . . . . . . .108 ASM . . . . . . . . . . . . . . . . . . . . . . .64, 109 BAUD . . . . . . . . . . . . . . . . . . .54, 61, 110 BAUDCHK . . . . . . . . . . . . . . . . . . .61, 111 BELL . . . . . . . . . . . . . . . . . . . . . . .66, 112 BF . . . . . . . . . . . . . . . . . . . . . . . . .65, 113 BR . . . . . . . . . . . . . . . . . . . . . .57, 72, 114 BSAMODE . . . . . . . . . . . . . . . . . . . . .115 BSATT . . . . . . . . . . . . . . . . . . . . . . . . .116 C . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117 CCR . . . . . . . . . . . . . . . . . . . . . . . . . .118 CHIPINFO . . . . . . . . . . . . . . . . . . .68, 119 CLEARMAP . . . . . . . . . . . . . . . . . . . .120 COLORS . . . . . . . . . . . . . . . . .58, 70, 121 Commands . . . . . . . . . . . . . . . . . . . . .102 DARM . . . . . . . . . . . . . . . . . . . . . . . . .122 DASM . . . . . . . . . . . . . . . . . . . . . .64, 123 ENDBSA . . . . . . . . . . . . . . . . . . . . . . .124 EVAL . . . . . . . . . . . . . . . . . . . . . . .67, 125 EXIT . . . . . . . . . . . . . . . . . . .70, 125, 126 G . . . . . . . . . . . . . . . . . . . . . . . . . .73, 127 GETBSA . . . . . . . . . . . . . . . . . . . . . . .128 MMDS0508OM/D MOTOROLA Index For More Information On This Product, Go to: www.freescale.com 205 Freescale Semiconductor, Inc. Index Freescale Semiconductor, Inc... GO . . . . . . . . . . . . . . . . . . . . . 57, 73, 129 GOTIL . . . . . . . . . . . . . . . . . . . 57, 73, 130 H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 HELP . . . . . . . . . . . . . . . . . . . . . . . 68, 132 HOMEBSA . . . . . . . . . . . . . . . . . . . . . 133 HREG . . . . . . . . . . . . . . . . . . . . . . . . . 134 HX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 INFO . . . . . . . . . . . . . . . . . . . . 57, 67, 137 LF . . . . . . . . . . . . . . . . . . . . . . . . . 68, 138 LOAD . . . . . . . . . . . . . . . . . . . . . . . . . 139 LOADMAP . . . . . . . . . . . . . . . . . . . . . 140 LOADMEM . . . . . . . . . . . . . . . . . . 62, 141 LOADTRIGGERS . . . . . . . . . . . . . . . . 142 MD . . . . . . . . . . . . . . . . . . . . . . . . 71, 143 MM . . . . . . . . . . . . . . . . . . . . 65, 144, 145 N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 NEXTA . . . . . . . . . . . . . . . . . . . . . . . . 147 NEXTB . . . . . . . . . . . . . . . . . . . . . . . . 148 NEXTC . . . . . . . . . . . . . . . . . . . . . . . . 149 NEXTD . . . . . . . . . . . . . . . . . . . . . . . . 150 NEXTE . . . . . . . . . . . . . . . . . . . . . . . . 151 NOBR . . . . . . . . . . . . . . . . . . . . . . 72, 152 OSC . . . . . . . . . . . . . . . . . . . . . . . 63, 153 PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 QUIT . . . . . . . . . . . . . . . . . . . . . . . 70, 155 REG . . . . . . . . . . . . . . . . . . . . . . . . . . 156 REM . . . . . . . . . . . . . . . . . . . . . . . 67, 157 RESET . . . . . . . . . . . . . . . . . . . . . 72, 158 RESETGO . . . . . . . . . . . . . . . 72, 73, 159 RESETIN . . . . . . . . . . . . . . . . . . . 72, 160 RESETOUT . . . . . . . . . . . . . . . . . 72, 161 RTMEM . . . . . . . . . . . . . . . . . . . . . . . . 162 RTVAR . . . . . . . . . . . . . . . . . . . . . . . . 163 SCREENBSA . . . . . . . . . . . . . . . . . . . 165 SCRIPT . . . . . . . . . . . . . . . . . . . . . 66, 166 SETMEM . . . . . . . . . . . . . 53, 62, 167, 168 SHELL . . . . . . . . . . . . . . . . . . . . . . 70, 169 SHOWBSA . . . . . . . . . . . . . . . . . . . . . 170 SHOWMEM . . . . . . . . . . . . . . . . . 68, 171 SHOWTRIGGER . . . . . . . . . . . . . . . . 172 SNAPSHOT . . . . . . . . . . . . . . . . . 69, 173 SOURCE . . . . . . . . . . . . . . . . . 48, 69, 174 ST . . . . . . . . . . . . . . . . . . . . . . . . . 73, 175 STACK . . . . . . . . . . . . . . . . . . . . . 52, 176 STEP . . . . . . . . . . . . . . . . . . . . 57, 73, 177 STEPFOR . . . . . . . . . . . . . . . . . . . 73, 178 STEPTIL . . . . . . . . . . . . . . . . . . . . 73, 179 STOP . . . . . . . . . . . . . . . . . . . . . . 57, 180 Summary (Table) . . . . . . . . . . . . . . . . 103 SXB . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . 102 SYSINFO . . . . . . . . . . . . . . . . . . . 67, 182 T . . . . . . . . . . . . . . . . . . . . . . . . . . 73, 183 TIMETAG . . . . . . . . . . . . . . . . . . . . . . 184 V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186 VAR . . . . . . . . . . . . . . . . . . . . . . . . 49, 188 VER . . . . . . . . . . . . . . . . . . . . . . . . 67, 189 VERSION . . . . . . . . . . . . . . . . . . . 67, 190 VF . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191 WAIT . . . . . . . . . . . . . . . . . . . . . . . 66, 192 WAIT4RESET . . . . . . . . . . . . . . . . 72, 193 WHEREIS . . . . . . . . . . . . . . . . . . . 67, 194 X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195 XREG . . . . . . . . . . . . . . . . . . . . . . . . . 196 Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 ZOOM . . . . . . . . . . . . . . . . . . . 57, 70, 198 Command Types BSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Debug . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Initialization . . . . . . . . . . . . . . . . . . . . . . 60 System . . . . . . . . . . . . . . . . . . . . . . . . . 66 Command Types, Bus State Analyzer . . . . 77 Connector, Cable Pin Assignments . . . . . . . . . . . . . . . . . . 28 Signal Descriptions . . . . . . . . . . . . . . . . 28 MMDS0508OM/D 206 Index For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Index CPU Registers Setting . . . . . . . . . . . . . . . . . . . . . . . . . . 71 D DARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 DASM . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Reset Switch . . . . . . . . . . . . . . . . . . . . .28 Signal Descriptions, Connector . . . . . . .28 HELP . . . . . . . . . . . . . . . . . . . . . . . . . . . .132 HOMEBSA . . . . . . . . . . . . . . . . . . . . . . . .133 Host Computer Requirements . . . . . . . . . . . . . . . . . . . .16 HREG . . . . . . . . . . . . . . . . . . . . . . . . . . . .134 HX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135 Freescale Semiconductor, Inc... E I EM Installing . . . . . . . . . . . . . . . . . . . . . . . . 25 Removing . . . . . . . . . . . . . . . . . . . . . . . 25 ENDBSA . . . . . . . . . . . . . . . . . . . . . . . . . . 124 EVAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 EXIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 F I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136 INFO . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137 Initialization and Loading . . . . . . . . . . . . . .35 Clock Speed . . . . . . . . . . . . . . . . . . . . .63 Memory . . . . . . . . . . . . . . . . . . . . . . . . .63 Initialization Commands . . . . . . . . . . . . . . .60 Introduction . . . . . . . . . . . . . . . . . . . . . . . . .11 Fuse Replacement . . . . . . . . . . . . . . . . . . . 32 J G G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 GETBSA . . . . . . . . . . . . . . . . . . . . . . . . . . 128 GO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 GOTIL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130 H H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131 Hardware Installation Configuring the Platform Board . . . . . . . 22 Connecting Cables . . . . . . . . . . . . . . . . 26 Fuse Replacement . . . . . . . . . . . . . . . . 32 Installing the EM . . . . . . . . . . . . . . . . . . 25 Introduction . . . . . . . . . . . . . . . . . . . . . . 20 Pin Assignments, Connector . . . . . . . . . 28 Removing the EM . . . . . . . . . . . . . . . . . 25 Jumper Headers Factory Test (J1) . . . . . . . . . . . . . . . . . .23 Port Voltage Control (J2–J4) . . . . . . . . .24 K Key Commands Debug Screen Windows . . . . . . . . . . . .45 Main Windows . . . . . . . . . . . . . . . . . . . .42 Pop-Up Windows . . . . . . . . . . . . . . . . .51 Source/Code F2 Window . . . . . . . . . . .49 L LF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 LOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . .139 Loading and Initialization . . . . . . . . . . . . . .35 LOADMAP . . . . . . . . . . . . . . . . . . . . . . . .140 MMDS0508OM/D MOTOROLA Index For More Information On This Product, Go to: www.freescale.com 207 Freescale Semiconductor, Inc. Index LOADMEM . . . . . . . . . . . . . . . . . . . . . . . . 141 LOADTRIGGERS . . . . . . . . . . . . . . . . . . . 142 Freescale Semiconductor, Inc... M MMDS0508 . . . . . . . . . . . . . . . . . . . . . . . . 22 Manual Organization . . . . . . . . . . . . . . . . . . . . . 12 MD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Memory Mapping . . . . . . . . . . . . . . . . . . . . . 61, 62 MM . . . . . . . . . . . . . . . . . . . . . . . . . . 144, 145 MMDS Introduction . . . . . . . . . . . . . . . . . . . . . . 11 MMDS05 Debug Screen . . . . . . . . . . . . . . . . . 42, 43 Running . . . . . . . . . . . . . . . . . . . . . . . . . 38 MMDS08 Debug Screen . . . . . . . . . . . . . . . . . 42, 44 HREG . . . . . . . . . . . . . . . . . . . . . . . . . 134 HX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Introduction . . . . . . . . . . . . . . . . . . . . . . 11 Running . . . . . . . . . . . . . . . . . . . . . . . . . 39 Mouse Operation . . . . . . . . . . . . . . . . . . . . 56 N N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 NEXTA . . . . . . . . . . . . . . . . . . . . . . . . . . . 147 NEXTB . . . . . . . . . . . . . . . . . . . . . . . . . . . 148 NEXTC . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 NEXTD . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 NEXTE . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 NOBR . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152 O OSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153 P PC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154 Pin Assignments, Connector . . . . . . . . . . . 28 Platform Board, Configuration . . . . . . . . . . 22 Pod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Port Voltage Control Jumper Headers (J2–J4) . . . . . . . . . 24 Q QUIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155 R REG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156 REM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157 RESET . . . . . . . . . . . . . . . . . . . . . . . . . . . 158 RESETGO . . . . . . . . . . . . . . . . . . . . . . . . 159 RESETIN . . . . . . . . . . . . . . . . . . . . . . . . . 160 RESETOUT . . . . . . . . . . . . . . . . . . . . . . . 161 RTMEM . . . . . . . . . . . . . . . . . . . . . . . . . . 162 RTVAR . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 S SCREENBSA . . . . . . . . . . . . . . . . . . . . . . 165 Screens Baud Window . . . . . . . . . . . . . . . . . . . . 54 CPU Window . . . . . . . . . . . . . . . . . . . . . 47 Debug F10 Window . . . . . . . . . . . . . . . 50 Emulator Clock Frequency Window . . . 54 Emulator Clock Frequency Window MMDS05 . . . . . . . 54, 153 Emulator Clock Frequency Window MMDS08 . . . . . . . 55, 153 Introduction . . . . . . . . . . . . . . . . . . . . . . 42 Memory F3 Window . . . . . . . . . . . . . . . 50 MMDS05 Debug Screen . . . . . . . . . . . . 43 MMDS0508OM/D 208 Index For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Index MMDS08 Debug Screen . . . . . . . . . . . . 44 Set Memory Window . . . . . . . . . . . . . . . 53 Source/Code F2 Window . . . . . . . . . . . 47 Stack Window . . . . . . . . . . . . . . . . . . . . 52 Status Area . . . . . . . . . . . . . . . . . . . . . . 45 User . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Variables F8 Window . . . . . . . . . . . . . . 49 SCRIPT . . . . . . . . . . . . . . . . . . . . . . . . . . 166 Script Files STARTUP.05 . . . . . . . . . . . . . . . . . 60, 66 STARTUP.08 . . . . . . . . . . . . . . . . . 60, 66 Serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 SETMEM . . . . . . . . . . . . . . . . . . . . . 167, 168 SHELL . . . . . . . . . . . . . . . . . . . . . . . . . . . 169 SHOWBSA . . . . . . . . . . . . . . . . . . . . . . . . 170 SHOWMEM . . . . . . . . . . . . . . . . . . . . . . . 171 SHOWTRIGGER . . . . . . . . . . . . . . . . . . . 172 SNAPSHOT . . . . . . . . . . . . . . . . . . . . . . . 173 Software Distribution Format . . . . . . . . . . . . . . . . 36 Installation . . . . . . . . . . . . . . . . . . . . . . . 36 Personality Files . . . . . . . . . . . . . . . . . . 37 Target, Loading . . . . . . . . . . . . . . . . . . . 63 Using . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 SOURCE . . . . . . . . . . . . . . . . . . . . . . . . . 174 ST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 STACK . . . . . . . . . . . . . . . . . . . . . . . . . . . 176 STARTUP.05 (Script File) . . . . . . . . . . 60, 66 STARTUP.08 (Script File) . . . . . . . . . . 60, 66 STEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177 STEPFOR . . . . . . . . . . . . . . . . . . . . . . . . 178 STEPTIL . . . . . . . . . . . . . . . . . . . . . . . . . . 179 STOP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180 SXB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181 SYSINFO . . . . . . . . . . . . . . . . . . . . . . . . .182 System Commands . . . . . . . . . . . . . . . . . . . . . .66 Components . . . . . . . . . . . . . . . . . . . . .15 Connections . . . . . . . . . . . . . . . . . . . . .26 T T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183 TIMETAG. . . . . . . . . . . . . . . . . . . . . . . . . .184 V V . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186 VAR . . . . . . . . . . . . . . . . . . . . . . . . .187, 188 VER . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189 VERSION . . . . . . . . . . . . . . . . . . . . . . . . .190 VF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191 W WAIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192 WAIT4RESET . . . . . . . . . . . . . . . . . . . . . .193 WHEREIS . . . . . . . . . . . . . . . . . . . . . . . . .194 Windows Operation . . . . . . . . . . . . . . . . . .37 X X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195 XREG . . . . . . . . . . . . . . . . . . . .134, 135, 196 Z Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197 ZOOM . . . . . . . . . . . . . . . . . . . . . . . . . . . .198 MMDS0508OM/D MOTOROLA Index For More Information On This Product, Go to: www.freescale.com 209 Freescale Semiconductor, Inc. Freescale Semiconductor, Inc... Index MMDS0508OM/D 210 Index For More Information On This Product, Go to: www.freescale.com MOTOROLA Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. For More Information On This Product, Go to: www.freescale.com Freescale Semiconductor, Inc... Freescale Semiconductor, Inc. Motorola reserves the right to make changes without further notice to any products herein. Motorola makes no warranty, representation or guarantee regarding the suitability of its products for any particular purpose, nor does Motorola assume any liability arising out of the application or use of any product or circuit, and specifically disclaims any and all liability, including without limitation consequential or incidental damages. "Typical" parameters which may be provided in Motorola data sheets and/or specifications can and do vary in different applications and actual performance may vary over time. All operating parameters, including "Typicals" must be validated for each customer application by customer's technical experts. Motorola does not convey any license under its patent rights nor the rights of others. Motorola products are not designed, intended, or authorized for use as components in systems intended for surgical implant into the body, or other applications intended to support or sustain life, or for any other application in which the failure of the Motorola product could create a situation where personal injury or death may occur. Should Buyer purchase or use Motorola products for any such unintended or unauthorized application, Buyer shall indemnify and hold Motorola and its officers, employees, subsidiaries, affiliates, and distributors harmless against all claims, costs, damages, and expenses, and reasonable attorney fees arising out of, directly or indirectly, any claim of personal injury or death associated with such unintended or unauthorized use, even if such claim alleges that Motorola was negligent regarding the design or manufacture of the part. Motorola and are registered trademarks of Motorola, Inc. Motorola, Inc. is an Equal Opportunity/Affirmative Action Employer. How to reach us: USA/EUROPE/Locations Not Listed: Motorola Literature Distribution; P.O. Box 20912; Phoenix, Arizona 85036.1-800-441-2447 or 602-303-5454 MFAX: RMFAX0@email.sps.mot.com – TOUCHTONE 602-244-6609 INTERNET: http://Design-NET.com JAPAN: Nippon Motorola Ltd.; Tatsumi-SPD-JLDC, 6F Seibu-Butsuryu-Center, 3-14-2 Tatsumi Koto-Ku, Tokyo 135, Japan. 03-81-3521-8315 ASIA/PACIFIC: Motorola Semiconductors H.K. Ltd.; 8B Tai Ping Industrial Park, 51 Ting Kok Road, Tai Po, N.T., Hong Kong. 852-26629298 For More Information On This Product, Go to: www.freescale.com MMDS0508OM/D