PPCBug Firmware Package User’s Manual Parts 1 & 2 PPCBUGA1/UM4 PPCBUGA2/UM4

PPCBug Overview

PPCBug is a powerful evaluation and debugging tool for systems built around the Motorola PowerPC microprocessors. PPCBug firmware consists of three parts:

1.Command-driven user-interactive software debugger. It is hereafter referred to as the debugger, which is described in this manual. Debugging commands are available for loading and executing user programs under complete operator control for system evaluation.

2.Command-driven diagnostic package for testing and troubleshooting the PowerPC board, which is hereafter called the diagnostics. Refer to the PPC1Bug Diagnostics

Manual.for information on the diagnostics and the diagnostics utilities and self-tests.

3.MPU, firmware, and hardware initialization routines, which are described in this manual.The PPCBug firmware is implemented on the following Motorola PowerPC-based products.

4.MVME230 xVME Processor Modules

5.MVME260 xSingle Board Computers

6.MVME3604 VME Processor Modules

7.MVME4604 VME Dual Processor Modules

8.MTX Embedded ATX Motherboards

9.MCP750 PowerPC Single Board Computers.They are collectively referred to in this manual as the PowerPC board or board.The debugger includes:

10.Commands for display and modification of memory

11.Breakpoint and tracing capabilities

12.Assembler and disassembler useful for patching programs Various PPCBug routines that handle I/O, data conversion, and string functions are available to user programs through the System Call handler.

Because PPCBug is command-driven, it performs its various operations in response to user commands entered at the keyboard. A PMCspan board added to any of these also interfaces with PPCBug

Set-up

Refer to the board installation and use manual for information on installing the hardware, configuring jumpers, and assigning the console monitor.

Start-up

At either power-up or system reset, PPCBug performs the MPU,hardware, and firmware initialization process (refer toMPU,Hardware, and Firmware Initializationon page 1-5). This process includes a checksum of the FLASH memory contents.The following types of messages are displayed on the firmware console during the initialization process:

Copyright Motorola Inc. 1988 - 1997, All Rights Reserved PPC1 Debugger/Diagnostics Release Version 3.x - xx/xx/xx/RMxx COLDStart Local Memory Found =04000000(&67108864)MPU Clock Speed =167Mhz BUS Clock Speed =67Mhz Reset Vector Location : ROM Bank B Mezzanine Configuration: Single-MPU

Current 60X-Bus Master : MPU0

Idle MPU(s) : NONE

System Memory: 64MB, ECC Enabled (ECC-Memory Detected)

L2 Cache: NONE PPC1-Bug>At this point, PPCBug is waiting for you to enter one of the commands described in Chapter 3 of this manual. PPCBug may alternatively be configured via the ENV command to run selftest and/or autoboot automatically during startup. If so,then PPCBug will instead behave as follows:The system pauses five seconds, during which you may terminate start-up, and exit to the diagnostics prompt, by pressing ESC or the Break key.

The system performs the self test diagnostics if you do not terminate system start-up. Upon successful completion of these tests, the system pauses another five seconds. You may terminate start-up, and exit to the diagnostics prompt, by pressing ESC or the Break key.

If you do not terminate system start-up, the system begins the boot routine that has been set up in the ENV command, either NVRAM Boot List Boot, Auto Boot, ROMboot, or Network Auto Boot.

If the self-tests fail, various error messages appear, and the diagnostics prompt appears.Refer to Chapter 3 for information on setting the ENV command parameters.

BM - Block of Memory Move Command Input

BM RANGE ADDR [;B|H|W]Options

Description

The BM command copies the contents of the memory addresses defined by RANGE to another place in memory, beginning at ADDR.

The option field is only allowed when RANGE is specified using a COUNT. In this case, the B, H, or W defines the size of the data that the COUNT is referring to. For example, a COUNT of 4 with an option of W would mean to move 4 words (or 16 bytes) to the new location. If an option field is specified without a COUNT in the RANGE, an error results.

The BM command is useful for patching assembly code in memory(refer to example 2).The default data size is word.

Examples

Example 1: For this example, assume that memory from 20000 to 2000F is clear.PPC1-Bug>MD 21000:10;H <Return>00021000 5448 4953 2049 5320 4120 5445 5354 2121 THIS IS A TEST!!00021010 0000 0000 0000 0000 0000 0000 0000 0000 ................

PPC1-Bug>