Title Page
Installation Guide
Version 21
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.
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
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
7.Uninstalling RISCWatch.................................................................................................29
Version 21 Contents
February 24, 2010 Page 3 of 39
Installation Guide
RISCWatch Debugger
Contents Version 21
Page 4 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger
List of Figures
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.
February 24, 2010 – Edited the book for consistency and conformance to IBM style.
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).
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.
Version 21 Introduction
February 24, 2010 Page 9 of 39
Installation Guide
RISCWatch Debugger
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
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)
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.
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.
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.
Version 21 Installing JTAG Ethernet Target Hardware (Models 13H6423 and 13H6424)
February 24, 2010 Page 13 of 39
Installation Guide
RISCWatch Debugger
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.
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
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.
Version 21 Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356)
February 24, 2010 Page 17 of 39
Installation Guide T
RISCWatch Debugger
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
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.
Version 21 Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356)
February 24, 2010 Page 19 of 39
Installation Guide T
RISCWatch Debugger
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.
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.
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.
Installing JTAG Ethernet Target Hardware (Models 41K7355 and 41K7356) Version 21
Page 22 of 39 February 24, 2010
Installation Guide
RISCWatch Debugger
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.
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.
/media/RISCWATCH/linux/install
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:
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
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.
6. Configuring RISCWatch
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.
B.1 General
The following list describes processor probe models 41K7355 and 41K7356 ratings:
• 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.
Note: The selected power supply must meet your country and local regulatory requirements. If you
have questions, contact your distributor.
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.
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.