Sie sind auf Seite 1von 39

RISCWatch Debugger

Title Page

Installation Guide

Version 21

February 24, 2010


®
Copyright and Disclaimer

©Copyright International Business Machines Corporation 1997, 2010

Printed in the United States of America February 2010

IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp.,
registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other
companies. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at
www.ibm.com/legal/copytrade.shtml.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United
States, other countries, or both.

Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, and service names may be trademarks or service marks of others.

All information contained in this document is subject to change without notice. The products described in this
document are NOT intended for use in applications such as implantation, life support, or other hazardous uses where
malfunction could result in death, bodily injury, or catastrophic property damage. The information contained in this
document does not affect or change IBM product specifications or warranties. Nothing in this document shall operate
as an express or implied license or indemnity under the intellectual property rights of IBM or third parties. All
information contained in this document was obtained in specific environments, and is presented as an illustration. The
results obtained in other operating environments may vary.

THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED ON AN “AS IS” BASIS. In no event will IBM
be liable for damages arising directly or indirectly from any use of the information contained in this document.

IBM Systems and Technology Group


2070 Route 52, Bldg. 330
Hopewell Junction, NY 12533-6351

The IBM home page can be found at ibm.com®.


The IBM semiconductor solutions home page can be found at ibm.com/chips.

Version 21
February 24, 2010
Installation Guide
RISCWatch Debugger

Contents

List of Figures...................................................................................................................... 5

Revision Log........................................................................................................................ 7

1.Introduction.......................................................................................................................9
1.1JTAG Ethernet Target .............................................................................................................................. 9
1.2PIBS Targets............................................................................................................................................. 9

2.Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424)............11


2.1JTAG Ethernet Target Installation .......................................................................................................... 11
2.2Establishing a Network Connection with the RISCWatch Processor Probe.......................................... 13
2.3Setting the TCP/IP Parameters of the RISCWatch Processor Probe.................................................... 14
2.4PIBS Target Hardware Installation ......................................................................................................... 15

3.Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356) ...........17
3.1Processor Probe Model 41K7356 Installation ....................................................................................... 17
3.2Processor Probe Model 41K7355 Installation ....................................................................................... 19
3.3Establishing a Network Connection with the RISCWatch Processor Probe.......................................... 21
3.4Setting the TCP/IP Parameters of the RISCWatch Processor Probe.................................................... 21
3.5PIBS Target Hardware Install ................................................................................................................ 22

4.Installing RISCWatch on Windows............................................................................... 23


4.1Windows Software Installation ............................................................................................................... 23
4.2TCP/IP Package Setup .......................................................................................................................... 23

5.Installing RISCWatch on Linux .................................................................................... 25


5.1Linux Software Installation...................................................................................................................... 25

6.Configuring RISCWatch ................................................................................................ 27


6.1RISCWatch Environment Setup ............................................................................................................ 27
6.2Program Updates................................................................................................................................... 27

7.Uninstalling RISCWatch.................................................................................................29

Appendix A. Ethernet Crossover Cable.......................................................................... 31

Appendix B. Processor Probe 41K7355 and 41K7356 Equipment Ratings ................33


B.1 General.................................................................................................................................................. 33
B.2 Safety ................................................................................................................................................... 33
B.3 External Power Supply Specifications .................................................................................................. 34
B.4 Test Probe Specifications ..................................................................................................................... 34
B.5 Operating Conditions............................................................................................................................ 35

Version 21 Contents
February 24, 2010 Page 3 of 39
Installation Guide
RISCWatch Debugger

Appendix C. Processor Probe 41K7355 and 41K7356 Electronic


Emissions Statement ....................................................................................................... 37
C.1 Federal Communications Commission Statement ............................................................................... 37
C.2 Industry Canada Class A Emission Compliance Statement ................................................................ 37
C.3 Australia and New Zealand Class A Statement ................................................................................... 37
C.4 United Kingdom Telecommunications Safety Requirement ................................................................. 37
C.5 European Union EMC Directive Conformance Statement ................................................................... 37
C.6 Taiwan Electrical Emission Statement ................................................................................................. 38
C.7 Japanese Voluntary Control Council for Interference Statement ......................................................... 38
C.8 Korean Class A Electronic Emission Statement .................................................................................. 38

Appendix D. Product Recycling and Disposal ...............................................................39

Contents Version 21
Page 4 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

List of Figures

Figure 1-1. RISCWatch JTAG Ethernet Target................................................................................................... 9


Figure 1-2. PIBS Target..................................................................................................................................... 10
Figure 2-1. Embedded JTAG Adapter Assembly.............................................................................................. 11
Figure 2-2. Embedded JTAG Adapter with RISCTrace Assembly (No MICTOR)............................................. 12
Figure 2-3. Embedded JTAG Adapter with RISCTrace Assembly (MICTOR)..................................................12
Figure 3-1. Embedded JTAG Adapter Assembly.............................................................................................. 18
Figure 3-2. Embedded JTAG/Trace Adapter Assembly.................................................................................... 20
Figure A-1. Wiring in a 10BaseT Crossover Cable........................................................................................... 31
Figure C-1. Taiwan Electrical Emission Statement........................................................................................... 38
Figure C-2. Japanese Voluntary Control Council for Interference Statement................................................... 38
Figure C-3. Korean Class A Electronic Emission Statement............................................................................ 38

Version 21 List of Figures


February 24, 2010 Page 5 of 39
Installation Guide
RISCWatch Debugger

List of Figures Version 21


Page 6 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

Revision Log

Each release of this document supersedes all previously released versions. The revision log lists all signifi-
cant changes made to the document since its initial release.

Date Pages Description

February 24, 2010 – Edited the book for consistency and conformance to IBM style.

Version 21 Revision Log


February 24, 2010 Page 7 of 39
Installation Guide
RISCWatch Debugger

Revision Log Version 21


Page
D 8 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

1. Introduction
This document describes how to install and configure the IBM RISCWatch debugger hardware and software.
If you are a first-time RISCWatch user, you must first determine the target type you will use with the
RISCWatch debugger. The following sections describe the three possible target types RISCWatch supports.
When you determine the target type, you can proceed to the chapter that details the installation procedures
for the specific workstation (host) RISCWatch will be installed on.

Attention: Before beginning the hardware installation, you must read the enclosed IBM Safety Booklet
(SD21-0030-02).

1.1 JTAG Ethernet Target


The JTAG Ethernet target type requires hardware that is labeled RISCWatch Processor Probe. One end of
the RISCWatch processor probe connects to the host workstation using a standard Ethernet setup. The other
end of the processor probe connects to the JTAG connector resident on the target PowerPC board.
Figure 1-1. RISCWatch JTAG Ethernet Target

Setting the RISCWatch TARGET_TYPE environment variable to jtag_eth (for Processor Probes 13H6423
and 13H6424) or jtag_mgp (for Processor Probes 41K7355 and 41K7356) configures RISCWatch to
communicate with the processor probe. See the RISCWatch User’s Manual for additional information about
environment variables.
When using this target type, you can direct RISCWatch to freeze or stop the processor through execution of
specific commands or debug events. When the processor is stopped, you can access and alter all
architected resources of the processor (for example, registers) and peripherals connected to the PowerPC
processor or processor core. Use of this target type relies on internal processor resources provided in
supported IBM PowerPC processors. Debug of the system hardware and software is accomplished without
the requirement of any target control program software so that no additional code constraints are put on the
PowerPC application. In addition, by using a standard Ethernet connection, RISCWatch can run on any
PowerPC board (connected to a processor probe) defined on the network.
Four types of RISCWatch processor probes are available for ordering. Two probes provide an added feature
called RISCTrace (models 13H6424 and 41K7355). RISCTrace takes advantage of the real-time trace debug
logic available on some IBM 400® Series PowerPC processors. See the RISCWatch User’s Manual for more
information about RISCTrace.

1.2 PIBS Targets


RISCWatch can communicate with the target PowerPC processor over a standard TCP/IP Ethernet network.
Setting the RISCWatch TARGET_TYPE environment variable to sim configures RISCWatch to communicate
with IBM PIBS (PowerPC Initialization and Boot Software) code which is running on the target PowerPC
board. The sim target type uses the standard Ethernet connection available on most host workstations and
PCs.

Version 21 Introduction
February 24, 2010 Page 9 of 39
Installation Guide
RISCWatch Debugger

Figure 1-2. PIBS Target

See the appropriate IBM PowerPC Evaluation Kit documentation for details about setting up your target
board to run PIBS code. Note that the PIBS code provided in the evaluation kit can be ported to custom
board designs.
When using this target type, you can direct the PIBS code to load and control the execution of your
application. RISCWatch constantly communicates with the PIBS code on the target system (See Figure 1-2).
This means the target PowerPC processor is always running. After loading your program with RISCWatch,
debug events are set up to control the execution of your application. These debug events generate debug
exceptions, which interrupt normal application program flow so that the read-only memory (ROM) code
running on the target system can collect processor status and alter processor resources.
Use of this target type relies on the dedicated exception handler and command set API available in PIBS.
The PIBS target type is useful for debugging application software on a working target system. Hardware
debug is limited because the RISCWatch debugger is dependent upon successful execution of the PIBS
code on the target PowerPC system.

Introduction Version 21
Page 10 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

2. Installing JTAG Ethernet Target Hardware (Models 13H6423 and


13H6424)
This chapter assumes that the host machine is already network connected or at least equipped with an
Ethernet card.
Follow the hardware installation instructions for the RISCWatch target you plan to use. For example,
evaluation kit users can skip directly to Section 2.4 PIBS Target Hardware Installation on page 15.

2.1 JTAG Ethernet Target Installation


For JTAG Ethernet targets (models 13H6423 and 13H6424), perform the following steps:
1. Verify the following hardware is available:
• One RISCWatch processor probe.
• One RISCWatch processor probe ac/dc power adapter and power cord.
• One RISCWatch processor probe JTAG adapter assembly. See the descriptions in step 3.
• One 9-pin serial cable.
2. Remove the wrap adapter from the front of the processor probe, if one exists.
3. Determine which JTAG adapter assembly you have by examining Figure 2-1, Figure 2-2, and Figure
2-3 on page 12.
Figure 2-1. Embedded JTAG Adapter Assembly

Version 21 Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424)
February 24, 2010 Page 11 of 39
Installation Guide
RISCWatch Debugger

Figure 2-2. Embedded JTAG Adapter with RISCTrace Assembly (No MICTOR)

Figure 2-3. Embedded JTAG Adapter with RISCTrace Assembly (MICTOR)

Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424) Version 21
Page 12 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

4. If your JTAG adapter assembly looks like the one shown in Figure 2-1 on page 11, you have an
embedded JTAG adapter assembly. If not, proceed to step 5.

To assemble the adapter and cables, perform the following steps:


a. Attach the 12 in. 16-pin ribbon cable to the 16-pin connector on the front of the RISCWatch
processor probe.

Attention: Failure to use the nonkeyed side can damage the processor probe.
b. If your PowerPC board uses a matched impedance connector (MICTOR) type JTAG header, you
must purchase the Transition Board E5903-66504. Attach the transition board to the other end of
the 12 in. ribbon cable, and attach the transition board to the MICTOR on the PowerPC board.
Otherwise, connect the other end of the 12 in. ribbon cable to the 16-pin JTAG header on the
PowerPC board. Contact technical support for information about purchasing the transition board.
c. Proceed to step 6.
5. If the JTAG adapter assembly looks like the one shown in Figure 2-2 or Figure 2-3 on page 12, you
have an embedded JTAG adapter with RISCTrace assembly. Use Figure 2-2 if your board does not
have a MICTOR. Use Figure 2-3 if your board has a MICTOR. To assemble the adapter and cables,
perform the following steps:
a. Attach the 12 in. 60-pin ribbon cable to the 60-pin connector on the front of the RISCWatch
processor probe.
b. Attach the other end of the 12 in. 60-pin ribbon cable to the low voltage buffer board E5903-66503
or E5903-26503.
c. If your PowerPC board uses a MICTOR-type header for JTAG and trace, attach the buffer board to
your PowerPC board as shown in Figure 2-3. Otherwise, attach the buffer board to the Transition
Board E5903-66504. Attach the transition board to your PowerPC board using the 16-pin and
20-pin cables as shown in Figure 2-2.
6. Connect the processor probe ac/dc power adapter to the back of the processor probe.
7. Connect the power cord to the ac/dc power adapter and to a wall outlet.

Attention: Use only the supplied power cord.

Flip the on/off switch on the front of the probe to the on position. The power light on the front of the
RISCWatch processor probe is illuminated.
8. Proceed to Section 2.2.

2.2 Establishing a Network Connection with the RISCWatch Processor Probe


To establish a network connection with the RISCWatch processor probe, proceed as follows:
1. If your host machine is already network connected, procure a 10/100 Ethernet drop for the
RISCWatch processor probe and connect it to the back of the probe. Proceed to Section 2.3 on
page 14.
2. Otherwise, hook up Ethernet cables between your host and the processor probe according to the
network topology you want.
a. If the connection is to be used exclusively between the host and the processor probe (a point-to-
point connection), a crossover cable must be used to connect the two devices (see Figure A-1 on
page 31 for a diagram of the wiring for a crossover cable). Otherwise, you can use a 10/100
Ethernet hub/switch.
3. Proceed to Section 2.3.

Version 21 Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424)
February 24, 2010 Page 13 of 39
Installation Guide
RISCWatch Debugger

2.3 Setting the TCP/IP Parameters of the RISCWatch Processor Probe


The RISCWatch processor probe default TCP/IP address is 0.0.0.0. The default gateway address is 0.0.0.0.
To change these addresses to valid addresses on your network, a serial port connection must be made from
the host to the processor probe. Most PCs include two serial ports to support communications through
asynchronous data transfer. These ports are sometimes referred to as communication or COM ports. These
ports are usually accessed from the back of the system unit. This document refers to these serial ports as S1
and S2.
Consult your PC literature to determine how many serial ports are available on your unit and where they are
located.
To set up the TCP/IP parameters of the RISCWatch processor probe, proceed as follows:
1. Connect the 9-pin female connector of the supplied serial cable to S1 or S2 on the PC.
2. Connect the other end of the supplied cable to the connector labeled RS-232 on the processor
probe.
3. From the Windows® task bar, select Start > Run. Type hypertrm in the Open field, and click OK.

Note: HyperTerminal is used for the purpose of this example. Any terminal emulation software can
be used.
4. If a window displays, “You need to install a modem before you can make a connection. Would you
like to do this now?”, click No because you do not need a modem for a direct serial link.
5. Select the Hypertrm icon.
6. Type a name, for example, RW probe, and select an icon.
7. Select the following communications characteristics:
a. Connect using Direct to Com1 if using S1 or Com 2 if using S2
• Bits per second - 9600
• Data Bits 8 (default)
• Stop Bits - 1 (default)
• Parity - None (default)
• Flow Control - Hardware (default)
8. Click OK.
9. Press Enter. The processor probe responds with a status prompt consisting of a letter followed by
the greater-than symbol (>).
10. Type lan to display the current LAN settings.
11. Determine a valid TCP/IP address and gateway for the processor probe:
• If connecting to an existing network, obtain the TCP/IP address and gateway address from your
system administrator.
• If connecting to the processor probe through a point-to-point connection with your PC, a TCP/IP
address of 7.1.1.100 is suggested. The processor probe default gateway of 0.0.0.0 is sufficient.
12. Change the TCP/IP address by typing: lan -i TCP/IP address. For example, type lan -i
7.1.1.100.
13. Change the TCP/IP gateway by typing: lan -g TCP/IP address. For example, type, lan -g 0.0.0.0.

Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424) Version 21
Page 14 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

14. If necessary, change the processor probe port number. This step is only necessary if there is a
conflict using the probe default port number of 6470. Conflicts should only exist if a device other than
an IBM RISCWatch Processor Probe is using port number 6470. To change the port number, type,
lan -p “port number”. For example, type lan -p 6470.

Note: The port number must match the host port number entry in the Windows TCP/IP services file.
See Section 4.2 TCP/IP Package Setup on page 23 for information about where this is entered.
15. Select File, then Exit to exit the terminal session.
16. If requested to save changes to terminal settings, select No.
17. Cycle power on the processor probe for the changes to take effect. Power can be cycled using the
on/off switch on the front of the processor probe.

Note: As the probe boots, it sends ICMP address mask requests to the network. If a response is
received, the probe sets its subnet mask to that of the network. If multiple responses are received,
the probe sets its subnet mask to the first value it receives and issues a warning message over the
serial port. This is an error condition on the network and must be corrected. If no response is
received, the probe sets the subnet mask to one of the following defaults based on its TCP/IP
address:
• 255.0.0.0 for Class A addresses (1.x.x.x - 127.x.x.x)
• 255.255.0.0 for Class B addresses (128.x.x.x - 191.x.x.x)
• 255.255.255.0 for Class C addresses (192.x.x.x - 223.x.x.x)

The processor probe also supports a lan -s command to set the subnet mask. For example:
lan -s 255.255.255.0
18. When the addresses are made valid for your network, the telnet utility on your host and the lan
command on the RISCWatch processor probe can be used to change the addresses from then on.
19. Hardware installation for the JTAG Ethernet target is complete. Proceed to one of the following
sections to install the RISCWatch software for your particular operating system:
• Section 4. Installing RISCWatch on Windows on page 23.
• Section 5. Installing RISCWatch on Linux on page 25.

2.4 PIBS Target Hardware Installation


For PowerPC Initialization and Boot Software (PIBS) targets, a communications link must be established
between the host PC and the target board. See Section 2.2 Establishing a Network Connection with the
RISCWatch Processor Probe on page 13, substituting the PIBS target board where the processor probe is
mentioned.
See the appropriate Evaluation Kit or PIBS documentation for establishing TCP/IP parameters necessary for
your network.
This completes the JTAG Ethernet Target Hardware installation for Processor Probe models 13H6423 and
13H6424. Proceed to one of the following sections to install the RISCWatch software for your particular
operating system:
• Section 4. Installing RISCWatch on Windows on page 23.
• Section 5. Installing RISCWatch on Linux on page 25.

Version 21 Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424)
February 24, 2010 Page 15 of 39
Installation Guide
RISCWatch Debugger

Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424) Version 21
Page 16 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

3. Installing JTAG Ethernet Target Hardware (Models 41K7355 and


41K7356)
This chapter assumes that the host machine is already network connected or at least equipped with an
Ethernet card.
Follow the hardware installation instructions for the RISCWatch target you plan to use. For example,
PowerPC Initialization and Boot Software (PIBS) and evaluation kit users can skip directly to Section 3.5
PIBS Target Hardware Install on page 22.

3.1 Processor Probe Model 41K7356 Installation


To install processor probe model 41K7356 (nontrace), perform the following steps:
1. Verify the following hardware is available:
• RISCWatch processor probe model 41K7356
• RISCWatch processor probe JTAG 12 in. dual-ribbon cable
• RISCWatch processor probe JTAG active debug probe
• RISCWatch processor probe JTAG target adapter module (optional)
• 9-pin serial cable

Note: A power supply is not provided. See Appendix B. Processor Probe 41K7355 and 41K7356
Equipment Ratings on page 33 for a list of requirements needed to select a suitable power supply.
2. Connect one end of the 12 in. dual-ribbon cable to the probe box connector.

Note: The cable can be inserted only one way. Ensure that the ejector tabs lock fully onto the cable
connector.
3. Connect the other end of the 12 in. dual-ribbon cable to the active debug probe connector.

Note: The cable can be inserted only one way. Ensure that the ejector tabs lock fully onto the cable
connector.

Figure 3-1 on page 18 shows an example embedded JTAG adapter assembly.

Version 21 Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356)
February 24, 2010 Page 17 of 39
Installation Guide T
RISCWatch Debugger

Figure 3-1. Embedded JTAG Adapter Assembly

4. If your target uses a matched impedance connector (MICTOR) connector for the JTAG signals, plug
the active debug probe 16-pin connector into the target adapter module 16-pin socket.

Note: The connector is keyed so that it can only be inserted one way.
5. Plug the JTAG (16-pin) or MICTOR (38-pin) connector onto the target board. Ensure the connector is
correctly aligned.
6. Connect the appropriate ac/dc power adapter to the back of the processor probe and then plug the
adapter power cord into a wall outlet.
7. At this time, the processor probe front panel POWER LED should be illuminated red. Flip the on/off
switch on the back of the probe to the on position. The POWER LED should change to green.
8. Proceed to Section 3.3 Establishing a Network Connection with the RISCWatch Processor Probe on
page 21.

Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356) Version 21
Page 18 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

3.2 Processor Probe Model 41K7355 Installation


To install processor probe model 41K7355 (trace), perform the following steps:
1. Verify the following hardware is available:
• RISCWatch processor probe model 41K7355
• RISCWatch processor probe JTAG 12 in. dual-ribbon cables
• RISCWatch processor probe JTAG active trace probe
• RISCWatch processor probe 38-pin MICTOR connector cable
• RISCWatch processor probe 16-pin JTAG connector cable
• RISCWatch processor probe trace target adapter module (optional)
• 9-pin serial cable

Note: A power supply is not provided. See Appendix B. Processor Probe 41K7355 and 41K7356
Equipment Ratings on page 33 for a list of requirements needed to select a suitable power supply.
2. Connect one end of the 12 in. dual-ribbon cables to the probe box connectors.

Note: The cables can only be inserted one way. Ensure that the ejector tabs lock fully onto each
cable connector.
3. Connect the other end of the 12 in. dual-ribbon cables to the active trace probe connectors.

Note: The cables can only be inserted one way. Ensure that the ejector tabs lock fully onto each
cable connector.

Figure 3-1 on page 18 shows an example embedded JTAG/trace adapter assembly.

Version 21 Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356)
February 24, 2010 Page 19 of 39
Installation Guide T
RISCWatch Debugger

Figure 3-2. Embedded JTAG/Trace Adapter Assembly

Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356) Version 21
Page 20 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

4. If your target uses a MICTOR connector that contains all trace and JTAG signals, use the 38-pin
MICTOR cable to attach the MICTOR connector of the active trace probe to the MICTOR connector
on the board.
5. If your target uses a 20-pin connector for the trace signals and a 16-pin connector for the JTAG
signals, complete the following steps:
a. Attach one end of the 38-pin MICTOR cable to the MICTOR connector on the active trace probe.
b. Plug the provided adapter onto the other end of the 38-pin MICTOR cable, and then plug the
adapter 20-pin header into the board 20-pin trace connector.
c. Attach the 16-pin JTAG cable between the active trace probe and the board JTAG connector.

Attention: To use this processor probe without trace capability, use either the 16-pin JTAG cable or the
38-pin MICTOR cable to connect the active trace probe to the target board but not both at the same
time.
6. Connect the processor probe ac/dc power adapter to the back of the processor probe.
7. Connect a power cord (C13 size is available from most electronics suppliers) to the ac/dc power
adapter and to a wall outlet. At this time, the processor probe front panel POWER LED should be
illuminated red. Flip the on/off switch on the back of the probe to the on position. The POWER LED
changes to green.
8. Proceed to Section 3.3.

3.3 Establishing a Network Connection with the RISCWatch Processor Probe


To establish a network connection with the RISCWatch processor probe, proceed as follows:
1. If your host machine is already network connected, procure a 10/100/1000 Ethernet drop for the
RISCWatch processor probe and connect it to the back of the probe. Proceed to Section 3.4.
2. If your host machine is not already network connected, hook up Ethernet cables between your host
and the processor probe according to the network topology.

If the connection is to be used exclusively between the host and the processor probe (a point-to-
point connection), a crossover cable must be used to connect the two nodes (see Figure A-1 on
page 31 for a diagram of the wiring for a crossover cable). Otherwise, a 10/100/1000 Ethernet
hub/switch can be used.
3. Proceed to Section 3.4.

3.4 Setting the TCP/IP Parameters of the RISCWatch Processor Probe


The RISCWatch processor probe ships configured to use Ethernet and dynamic host configuration protocol
(DHCP). If a DHCP server responds to the probe request, the specified IP address is assigned to the probe
for Ethernet communications.
To find out this DHCP-assigned address or to change the probe to use a static IP address, a serial terminal
is required.
To set the TCP/IP parameters of the RISCWatch processor probe, proceed as follows:
1. Connect a serial cable between the 9-pin serial port on the back of the probe and a PC (using its
serial connector or to a USB port using a serial-to-USB adapter cable).

Version 21 Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356)
February 24, 2010 Page 21 of 39
Installation Guide T
RISCWatch Debugger

2. Start the serial terminal program (like HyperTerminal or TeraTerm) and set its communications
parameters to use the attached serial/USB port, as follows: 115 K, 8 data bits, 1 stop bit, no parity,
and no flow control.
3. Press the RESET button on the back panel of the probe and then watch for the current configuration
screen to appear.
4. If the DHCP-assigned address is all that is required, write down the address specified after:
Ethernet IP address. Quit the serial terminal program.
5. To assign a static IP address and subnet mask, press the Esc button to bring up the setup menu,
select the number that corresponds to Ethernet via Static IP, and follow the screen prompts.
This completes the JTAG Ethernet target hardware installation for processor probe model 41K7356. Proceed
to the appropriate chapter of this guide to install the RISCWatch software for your particular operating
system.

3.5 PIBS Target Hardware Install


For PIBS targets, a communications link must be established between the host PC and the target board. See
Section 3.3 Establishing a Network Connection with the RISCWatch Processor Probe on page 21,
substituting the PIBS target board where the processor probe is mentioned.
See the appropriate evaluation kit or PIBS documentation for establishing TCP/IP parameters necessary for
your network.
This completes the JTAG Ethernet target hardware installation for processor probe model 41K7356. Proceed
to one of the following sections to install the RISCWatch software for your particular operating system:
• Section 4. Installing RISCWatch on Windows on page 23.
• Section 5. Installing RISCWatch on Linux on page 25.

Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356) Version 21
Page 22 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

4. Installing RISCWatch on Windows

4.1 Windows Software Installation


For all RISCWatch target types, perform the following installation steps:
1. Verify the following items are available:
• IBM or compatible PC
Minimum required: 800 MHz processor with 256 MB of RAM and an Ethernet port.
• SVGA Display
Minimum required: SVGA 1024 × 768 or above
Supports: SVGA 1024 × 768, SVGA 1280 × 1024, SVGA 1600 × 1200
• Microsoft® Windows XP
• RISCWatch installation CD-ROM
• CD-ROM drive
2. Place the Installing RISCWatch on Windows installation CD-ROM in the proper drive. The
RISCWatch installation process starts.

If it does not, click Start from the Windows task bar, select Run and type D:\WIN\INSTALL (assuming
that your CD-ROM drive is the D drive), then press Enter.
3. When the Welcome window is displayed. Click Next to proceed.
4. When the Choose Destination Location window is displayed, click Browse if you want to change the
directory where the program files will be installed (default location is C:\Program Files\RISCWatch).
5. When the installation is completed, a RISCWatch program icon is created under the Start menu. The
RISCWatch README file is then displayed. View the entire file for the latest changes to the program
and its operation.

4.2 TCP/IP Package Setup


For JTAG Ethernet or PowerPC Initialization and Boot Software (PIBS) targets, configure the Windows
TCP/IP package if it is not already configured.
To set the host TCP/IP address for the Ethernet connection, proceed as follows:
1. On the desktop, click the My Computer icon.
2. Select Control Panel.
3. Select Network Connections.
4. Add the appropriate adapter network component for the Ethernet adapter being used (if not already
added).
5. Add a Protocol network component of Microsoft - TCP/IP (if not already added). Specify the IP
address (7.1.1.4 is recommended to maintain consistency with this document) and netmask
(255.255.240.0) to be used.
6. For the update to take effect, TCP/IP might need to be restarted. This might require a reboot of the
system, a restart of the TCP/IP package, or both.

Version 21 Installing RISCWatch on Windows


February 24, 2010 Page 23 of 39
Installation Guide
RISCWatch Debugger

7. Verify your network connection. From your host, type ping TCP/IP address. For example, type ping
7.1.1.100. If the ping does not complete successfully, verify that the installation steps have been
followed correctly or contact a system administrator.
This completes the installation of RISCWatch software. Proceed to Section 6.Configuring RISCWatch on
page 27 for the final step of the installation before starting the debugger.

Installing RISCWatch on Windows Version 21


Page 24 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

5. Installing RISCWatch on Linux

5.1 Linux Software Installation


For all RISCWatch target types, perform the following installation steps:
1. Verify the following items are available:
• Red Hat Enterprise Linux® 4
• X11R6 and Motif 2.2 or greater
• RISCWatch installation CD-ROM
• One CD-ROM drive
2. Choose an already existing directory or create a new directory. For example, type:
mkdir /usr/rwppc, which will contain the RISCWatch program and its associated files.
3. Issue the cd command to make it the present working directory. For example, type: cd /usr/rwppc.
4. Insert the RISCWatch installation CD into the CD-ROM drive and it should automatically be mounted
as an extension to the regular file system.
5. Issue the following command to start the installation process:

/media/RISCWATCH/linux/install

Proceed to click the installation buttons as necessary.

If you receive an error about a missing libMrm.so.3 or libXm.so.3 file, you must either edit an
environment variable or install Motif 2.2. To see which level of Motif is installed, issue the following
command:

rpm -qa | grep openmotif

If there are no results, or the result listed does not look like openmotif.2.2..., install Motif 2.2 by
performing the following steps:
a. Go to http://www.motifzone.net and locate the file openmotif-2.2.N-N.N.N.i386.rpm. The Ns are
not important as long as the numbers after openmotif are 2.2. This file can also be found at at
http://www.rpmfind.net.
b. Download this file and install it (as root) using the rpm command.
c. Issue the command: export LD_LIBRARY_PATH=/usr/X11R6/lib.
d. Motif 2.2 should now be installed and ready for use.
e. Go back to the first part of this step to reissue the install command.

If Motif 2.2 is installed, edit the environment variable LD_LIBRARY_PATH to include the path where
your system libMrm.so.3 and libXm.so.3 files reside.

When the installation is completed, the RISCWatch README file is displayed. View the entire file for
the latest changes to the program and its operation.
6. Add the following line to every user .bash_profile (or the equivalent command in the appropriate
shell profile) that will be running RISCWatch:

export UIDPATH=./%U:/usr/rwppc/%U

Version 21 Installing RISCWatch on Linux


February 24, 2010 Page 25 of 39
Installation Guide
RISCWatch Debugger

Notes:
• You must specify the %U at the end of each path in the UIDPATH line.
• Change the directory in the previous lines if you did not install RISCWatch in the /usr/rwppc
directory. If you want to use RISCWatch without logging off and logging on your machine again,
type the previous line at the command prompt to set this environment variable immediately.
7. It might be necessary to add the chosen directory to the PATH environment variable if it has not
already been added. Furthermore, it might be necessary to change ownership of this directory and
all of its files if many people will require access to the RISCWatch program.
This completes the installation of RISCWatch software. Proceed to Section 6. Configuring RISCWatch on
page 27 for the final step of installation before starting the debugger.

Installing RISCWatch on Linux Version 21


Page 26 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

6. Configuring RISCWatch

6.1 RISCWatch Environment Setup


You must edit the RISCWatch environment file rwppc.env to make the appropriate changes to various
RISCWatch environment variables. Proceed as follows:
1. Edit rwppc.env using a text editor.
2. Change the PROC variable to the processor you will be debugging. See the README file for a list of
valid processors for your release.
3. Change the TARGET_TYPE variable to the proper target type you will be using. Valid selections are
jtag_eth, jtag_mgp, or sim.
4. For jtag_eth or jtag_mgp targets, change the TARGET_NAME variable to the TCP/IP name or
address of the RISCWatch processor probe.
5. Edit any other environment variables as required. Environment variables are described in
Environment Resources in the RISCWatch Debugger User's Manual.
6. Users that have a working directory other than the install directory must have their own copy of the
rwppc.env file. Such users should backup their copy, make a fresh one from the install directory, and
then merge their changes between the backup and fresh copies.
This completes the RISCWatch configuration and it should now be ready to run.

6.2 Program Updates


To inquire about possible updates to this software package, contact PowerPC Technical Support (see the
Technical Support section of the README file).
Proceed to the Quick Start section of the RISCWatch Debugger User’s Manual.

Version 21 Configuring RISCWatch


February 24, 2010 Page 27 of 39
Installation Guide
RISCWatch Debugger

Configuring RISCWatch Version 21


Page 28 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

7. Uninstalling RISCWatch
To uninstall RISCWatch, perform the following steps:
1. Locate the directory where RISCWatch was installed and navigate to the Uninstall_RISCWatch
subdirectory.
2. Run the Uninstall RISCWatch program and respond to any prompts.

Note: This uninstalls all RISCWatch files that were originally installed. Any other files the user places in the
RISCWatch install folder are left intact.

Version 21 Uninstalling RISCWatch


February 24, 2010 Page 29 of 39
Installation Guide
RISCWatch Debugger

Uninstalling RISCWatch Version 21


Page 30 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

Appendix A. Ethernet Crossover Cable


Figure A-1 shows the connections and signal assignments in a crossover cable.
Figure A-1. Wiring in a 10BaseT Crossover Cable

Version 21 Ethernet Crossover Cable


February 24, 2010 Page 31 of 39
Installation Guide
RISCWatch Debugger

Ethernet Crossover Cable Version 21


Page 32 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

Appendix B. Processor Probe 41K7355 and 41K7356 Equipment Ratings

B.1 General
The following list describes processor probe models 41K7355 and 41K7356 ratings:
• Manufacture

Mentor Graphics Inc.


1001 Ridder Park Drive
San Jose, CA 95131
• Contract Manufacture

Propoint AB
Teknikgatan 18
S-434 37 Kungsbacka
Sweden
• Functional Description of Equipment

The product debugs and analyzes the functioning of external processors, memory, and the like on a
JTAG interface/cable. Using a serial, Ethernet port, or USB port, the product interfaces with a
computer, which has a GUI interface that facilitates the analysis.

B.2 Safety
To avoid a shock hazard, observe the following precautions:
• Do not connect or disconnect any cables or perform installation, maintenance, or reconfiguration of this
product during an electrical storm.
• The power cord must be connected to a properly wired and earthed receptacle.
• Any equipment to which this product will be attached must also be connected to properly wired
receptacles.
• When possible, use one hand to connect or disconnect signal cables to prevent a possible shock from
touching two surfaces with different electrical potentials.
• Electrical current from power, telephone, and communications cables can be hazardous. To avoid shock
hazard, use the following steps to connect and disconnect cables when installing, moving, or opening
the covers of this product or attached devices.
To connect, perform the following steps:
1. Turn all equipment off.
2. Attach all cables to the devices.
3. Attach the signal cables to the receptacles.
4. Attach the power cord to the outlet.
5. Turn the device on.

Version 21 Processor Probe 41K7355 and 41K7356 Equipment Ratings


February 24, 2010 Page 33 of 39
Installation Guide
RISCWatch Debugger

To disconnect, perform the following steps:


1. Turn all equipment off.
2. Remove the power cord from the outlet.
3. Remove the signal cables from the receptacles.
4. Remove all cables from the devices.

B.3 External Power Supply Specifications


The external power supply specifications follow:
• Type: NEC Class 2 switching power supply, desk type
• Input Characteristics
– Voltage: 100 - 240 Vac nominal
90 - 264 Vac maximum operating range
– Frequency: 50 to 60 Hz
– Current: 1.5 A
– AC Connector: IEC320/C14
• Output Characteristics:
– Output Voltage: 5 Vdc
– Current Rating: 4.0 A (overload protection of < 6.0 A)
– dc Connector: 5.5x × 2.1 × 9.5 mm (positive [+] center pin)
– dc cord: < 3 m (1 - 2 m ideally)
• Environmental Characteristics
• Operating Temperature: 0 - 40°C
• Storage Temperature: -20 - +85°C
• Mechanical Characteristics
• Dimensions: 132 × 58 × 30 mm
• Weight: 330 g

Note: The selected power supply must meet your country and local regulatory requirements. If you
have questions, contact your distributor.

B.4 Test Probe Specifications


The RISCWatch test probe specifications follow:
• Input Characteristics
• Voltage: 5 Vdc
• Current: 2 A
• Mechanical Characteristics
• Size: (L × W × H) is 8.7 in. × 6 .in × 2.6 in
• Weight: 825 g (probe only)

Processor Probe 41K7355 and 41K7356 Equipment Ratings Version 21


Page 34 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

B.5 Operating Conditions


The recommended operating conditions for the processor probe models 41K7355 and 41K7356 are as
follows:
• Indoor use only
• No exposure to liquid and moisture
• Operating temperature 5°C to 40°C
• Maximum relative humidity 80% for temperatures up to 31°C decreasing linearly to 50% relative humidity
at 40°C
• Dry environment
• Suitable for Pollution Degree 2 environment per IEC60664
• Overvoltage Category II from IEC60664 for input to external power supply.
• Altitude up to 2000 m

Version 21 Processor Probe 41K7355 and 41K7356 Equipment Ratings


February 24, 2010 Page 35 of 39
Installation Guide
RISCWatch Debugger

Processor Probe 41K7355 and 41K7356 Equipment Ratings Version 21


Page 36 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

Appendix C. Processor Probe 41K7355 and 41K7356 Electronic


Emissions Statement
The following statement applies to specified processor probe models. The statement for other products that
are intended for use with this product will appear in their accompanying manuals.

C.1 Federal Communications Commission Statement


Note: This equipment has been tested and found to comply with the limits for a Class A digital device,
pursuant to Part 15 of the Federal Communications Commission (FCC) Rules. These limits are designed to
provide reasonable protection against harmful interference when the equipment is operated in a commercial
environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed
and used in accordance with the instruction manual, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is likely to cause harmful interference, in
which case the user will be required to correct the interference at his own expense.
Properly shielded and grounded cables and connectors must be used in order to meet FCC emission limits.
IBM is not responsible for any radio or television interference caused by using other than recommended
cables and connectors or by unauthorized changes or modifications to this equipment. Unauthorized
changes or modifications could void the user’s authority to operate the equipment.
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1)
this device may not cause harmful interference, and (2) this device must accept any interference received,
including interference that may cause undesired operation.

C.2 Industry Canada Class A Emission Compliance Statement


This Class A digital apparatus complies with Canadian ICES-003. Avis de conformité à la réglementation
d’Industrie Canada Cet appareil numérique de la classe A est conforme à la norme NMB-003 du Canada.

C.3 Australia and New Zealand Class A Statement


Attention: This is a Class A product. In a domestic environment this product may cause radio interference in
which case the user may be required to take adequate measures.

C.4 United Kingdom Telecommunications Safety Requirement


Notice to Customers
This apparatus is approved under approval number NS/G/1234/J/100003 for indirect connection to public
telecommunication systems in the United Kingdom.

C.5 European Union EMC Directive Conformance Statement


This product is in conformity with the protection requirements of EU Council Directive 2004/108/EC on the
approximation of the laws of the Member States relating to electromagnetic compatibility. IBM cannot accept
responsibility for any failure to satisfy the protection requirements resulting from a nonrecommended
modification of the product, including the fitting of non-IBM option cards. This product has been tested and
found to comply with the limits for Class A Information Technology Equipment according to CISPR
22/European Standard EN 55022. The Limits for Class A equipment were derived for commercial and
industrial environments to provide reasonable protection against interference with licensed communication
equipment.

Version 21 Processor Probe 41K7355 and 41K7356 Electronic Emissions Statement


February 24, 2010 Page 37 of 39
Installation Guide
RISCWatch Debugger

Attention: This is a Class A product. In a domestic environment this product may cause radio interference in
which case the user may be required to take adequate measures.

C.6 Taiwan Electrical Emission Statement


Figure C-1. Taiwan Electrical Emission Statement

C.7 Japanese Voluntary Control Council for Interference Statement


Figure C-2. Japanese Voluntary Control Council for Interference Statement

This is a Class A product based on the standard of the Voluntary Control Council for Interference by
Information Technology Equipment (VCCI). If this equipment is used in a domestic environment, radio
interference may occur, in which case, the user may be required to take corrective actions.

C.8 Korean Class A Electronic Emission Statement


Figure C-3. Korean Class A Electronic Emission Statement

Processor Probe 41K7355 and 41K7356 Electronic Emissions Statement Version 21


Page 38 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger

Appendix D. Product Recycling and Disposal


See the Environmental Notices and User Guide document that is installed with the RISCWatch Debugger
software for information regarding recycling and disposal of processor probes.

Version 21 Product Recycling and Disposal


February 24, 2010 Page 39 of 39