RealView ® ICEand RealView Trace User Guide

Version 1.5

Table of Contents

About this document
Intended audience
Typographical conventions
Timing diagram conventions
Further reading
Feedback on RealView ICE and RealViewTrace
Feedback on this document
1. Introduction
1.1. About RealView ICE and RealView Trace
1.2. Availability and compatibility
1.3. About GDB debugging with RealViewICE
1.3.1. GDB availability and compatibility
1.3.2. Supported debug host platforms
1.3.3. Recommended applications for debuggingwith GDB
1.4. Basic principles
1.4.1. Debug extensions to the ARM core
1.4.2. The EmbeddedICE logic
1.4.3. How the EmbeddedICE debug architecturediffers from a debug monitor
1.5. Introduction to the RealView ICE components
1.5.1. The RealView ICE run control unit
1.5.2. The RealView ICE firmware
1.5.3. The RealView ICE host software
2. Getting Started
2.1. System requirements
2.1.1. Host software requirements
2.1.2. Host hardware requirements
2.1.3. Target hardware requirements
2.2. Connecting the RealView ICE hardware
2.2.1. What you require
2.2.2. Connection instructions
2.2.3. Using nonstandard connectors
2.2.4. Hot plugging and unplugging the JTAGcable
2.3. Using RealView ICE and RealView Trace
3. Configuring RealView ICE Networking
3.1. Determining the correct network settings
3.1.1. Not using DHCP
3.1.2. Using DHCP
3.2. Starting and exiting the RealViewICE Config IP application
3.2.1. Starting the RealView ICE Config IPapplication
3.2.2. Exiting the RealView ICE Config IPapplication
3.3. Configuring the network settings
3.3.1. Configuring by scanning all run controlunits
3.3.2. Configuring using an Ethernet address
3.3.3. Configuring for connection with anEthernet cross-over cable
3.4. Restarting your RealView ICE run controlunit
4. Configuring a RealView ICE Connection
4.1. Changes to RealView Debugger
4.2. Using the RVConfig dialog box
4.2.1. Opening the RVConfig dialog box
4.2.2. Connecting to a RealView ICE unit
4.2.3. Configuring a scan chain
4.2.4. Configuring devices
4.2.5. Advanced configuration
4.2.6. Saving your changes
4.2.7. Disconnecting from a RealView ICEunit
4.3. Connecting RealView Debugger to atarget using RealView ICE
4.4. Using the Debug tab of the RealViewDebugger Register pane
5. Debugging with RealView ICE
5.1. Post-mortem debugging
5.2. Semihosting
5.2.1. Enabling semihosting
5.2.2. Adding an application SWI handlerwhen using RealView ICE
5.3. Breakpoints
5.3.1. Hardware Breakpoints
5.3.2. Software instruction breakpoints
5.3.3. Processor exceptions
5.3.4. Breakpoints and the program counter
5.3.5. Interaction with RealView Debugger
5.3.6. Problems setting breakpoints
5.4. Cached data
5.5. Debugging applications in ROM
5.5.1. Debugging from reset
5.5.2. Debugging systems with ROM at theexception vector
6. Using RealView Trace
6.1. About RealView Trace
6.1.1. The RealView Trace product
6.1.2. Front panel layout
6.1.3. Capture rates
6.1.4. Availability and compatibility
6.2. System requirements
6.2.1. Host software requirements
6.2.2. Host hardware requirements
6.2.3. Target hardware requirements
6.3. Installing RealView Trace
6.4. Connecting the RealView Trace hardware
6.4.1. What you require
6.4.2. Connection instructions
6.5. Configuring RealView Debugger
7. Managing the RealView ICE Software
7.1. Starting the RVI Update application
7.2. Connecting to a RealView ICE unit
7.2.1. Scanning for RealView ICE units
7.2.2. Identifying your RealView ICE unit
7.2.3. Viewing the installedcomponents
7.2.4. RVI Update tasks
7.2.5. Disconnecting from the RealView ICEunit
7.2.6. Exiting the RVI Update application
7.2.7. Troubleshooting RealView ICE connections
7.3. Viewing software version numbers
7.3.1. Version information dialog box components
7.3.2. Saving the version information toa file
7.4. Installing an update or patch
7.4.1. Procedure for installing an updateor patch
7.4.2. Troubleshooting firmware upgrade installations
7.5. Deleting a component
7.6. Restarting the RealView ICE run controlunit
8. Configuring RealView ICE for GDB
8.1. About using RealView ICE for debuggingwith GDB
8.1.1. Features supported when debuggingwith GDB
8.1.2. Features not supportedwhen debugging with GDB
8.1.3. RealView ICE TCP/IP ports used
8.1.4. Building for standalone target platforms
8.2. Methods of connecting from remoteGDB sessions
8.2.1. Summary of the connection methodsfor each debugging mode
8.2.2. Connections to a target without built-inGDB support (RVI-GDB)
8.2.3. Connections to a targetwith a GDB stub (Target-GDB)
8.2.4. Connections to a target GDB stub usingprocessed DCC mode (Target-GDB-Virtual Ethernet)
8.2.5. Connections to a target OS using gdbserver(GDBserver)
8.2.6. Connections to a target OS using NFS(GDB-NFS)
8.3. Preparing RealView ICE for remoteGDB connections
8.3.1. About connecting to targets throughRealView ICE
8.3.2. Multicore debugging
8.3.3. DCC modes
8.4. Loading and booting a complete system
8.4.1. Requirements for using the rviloadutility
8.4.2. rviload command syntax
8.4.3. Using the rviload utility froma Cygwin bash or Red Hat Linux shell
8.5. Multiprocessor debugging with GDBand RealView ICE
8.5.1. How connections to multiple processors areallocated
8.5.2. Considerations when debugging multiple targetswith GDB
9. System Design Guidelines
9.1. About the system design guidelines
9.2. System design
9.2.1. Using adaptive clocking to synchronizethe JTAG port
9.2.2. Reset signals
9.3. ASIC guidelines
9.3.1. ICs containing multiple devices
9.3.2. Boundary scan test vectors
9.4. PCB guidelines
9.4.1. PCB connections
9.4.2. Target interface logic levels
9.5. JTAG signal integrity and maximumcable lengths
9.6. Compatibility with EmbeddedICE interfacetarget connectors
9.6.1. Adaptor to connect a RealView ICErun control unit to 14-way connectors
A. JTAG Interface Connections
A.1. JTAG interface pinouts
A.2. JTAG interface signals
A.2.1. JTAG interface signal details
A.3. JTAG port timing characteristics
B. User I/O Connections
B.1. The RealView ICE User I/O connector
C. RealView Trace Interface Connections
C.1. RealView Trace front panel components
C.1.1. LEDs
C.1.2. Trigger input and output SMB connectors
C.1.3. RealView Trace probe connector
C.1.4. Logic input connector
C.2. Trace signals
C.2.1. Signal levels
C.2.2. Clock frequency
C.2.3. Data setup and hold
C.2.4. Switching thresholds
C.2.5. Hot plugging
D. Designing the Target Board for Tracing
D.1. Overview of high-speed design
D.1.1. Avoid stubs
D.1.2. Minimize signal skew (balancing PCB track lengths)
D.1.3. Minimize crosstalk
D.1.4. Use impedance matching and termination
D.2. Termination
D.2.1. Example
D.2.2. Termination options
D.2.3. Rules for series terminators
D.2.4. PCB track impedance
D.3. Probe dimensions and keep out areas
D.4. Signal requirements
D.4.1. Switching Thresholds
D.4.2. Hot plugging
D.5. Probe modeling
E. GDB and Command Monitor Error Codes
E.1. Errors without error codes
E.2. Error code format
E.2.1. Viewing errors in a GDB session
E.2.2. Viewing the severity and error numbers using the CommandMonitor
E.3. Error codes
E.3.1. Generic errors
E.3.2. Initialization errors
E.3.3. Configuration errors
E.3.4. Memory and register errors
E.3.5. Execution errors
E.3.6. Breakpoint errors
E.3.7. RealView ICE errors
F. ARM Architecture Device Specifications
F.1. ARM architecture device specifications
F.1.1. ARM device names
F.1.2. ARM device options

List of Figures

1. Key to timing diagram conventions
1.1. Ports for connecting to the hostcomputer
1.2. Ports for connecting to the targethardware
2.1. Connecting the RealView ICE hardware
3.1. The RealView ICE Config IP application
3.2. Error message when another programis browsing
3.3. Error message when no USB devicespresent
3.4. Error when other connections areactive
3.5. The identification LEDs
3.6. The Configure RealView ICE device dialogbox
3.7. The Configure new RealView ICE devicedialog box
4.1. RVConfig dialog box
4.2. The RVConfig dialog box showing availableunits
4.3. The Identification LEDs
4.4. Error message when another programis browsing
4.5. Error message when no USB devicespresent
4.6. Displaying the scan chain controls
4.7. Error shown when unpowered devicesare detected
4.8. Error shown when no devices are detected
4.9. Error shown when there is no communicationwith RealView ICE
4.10. The Add Device dialog box
4.11. The Device Properties dialog box
4.12. The scan chain JTAG Clock Speed controls
4.13. Displaying the device controls
4.14. Displaying the advanced controls
4.15. Recommended settings for an ARM Integratorboard
4.16. Displaying the connection controls
4.17. Warning when disconnecting with unsavedconfiguration changes
6.1. Trace system
6.2. The RealView Trace data capture unit
6.3. RealView Trace panel layout
6.4. Positioning of 16mm plastic spacers
6.5. Profile view of connected units
6.6. RealView ICE connector on probe
6.7. RealView Trace connections usingan Ethernet cable
6.8. Connection Properties window showLogic_Analyzer settings
7.1. RVI Update application
7.2. RVI Update application showing availableunits
7.3. The identification LEDs
7.4. RVI Update application showing installedcomponents
7.5. Error message when another programis browsing
7.6. Error message when no USB devicespresent
7.7. Error when other connections areactive
7.8. Version information
7.9. Selecting the component file to install
7.10. Confirming that you want to installthe component file
7.11. Error message
7.12. Progress during an installation
7.13. Progress when rebooting during aninstallation
7.14. Message showing a successful installation
7.15. Error when installing a patch touninstalled software
7.16. Message when installing a patch thathas no new components
7.17. Error before data has been writtento compact flash
7.18. Error during writing to compact flash
7.19. Tree showing the different versionsof a component
7.20. Warning that you cannot undo a deletion
8.1. RVI-GDB connections
8.2. Target-GDB connections
8.3. Target-GDB-Virtual Ethernet connections
8.4. GDBserver connections
8.5. GDB-NFS connections
9.1. Basic JTAG port synchronizer
9.2. Timing diagram for the Basic JTAGsynchronizer in Figure 9.1
9.3. JTAG port synchronizer for singlerising-edge D-type ASIC design rules
9.4. Timing diagram for the D-type JTAGsynchronizer in Figure 9.3
9.5. Example reset circuit logic
9.6. Example reset circuit using powersupply monitor ICs
9.7. TAP Controllers serially chainedwithin an ASIC
9.8. Typical PCB connections
9.9. Target interface logic levels
A.1. JTAG interface pinout
A.2. JTAG port timing diagram
B.1. User I/O pin connections
C.1. RealView Trace panel layout
C.2. Pin surface mount receptacles ontrace probe connector
C.3. Pin surface mount receptacles onlogic input connector
C.4. Clock waveforms
C.5. Data waveforms
D.1. Track impedance
D.2. Probe dimensions
D.3. Setup and hold

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarksowned by ARM Limited, except as otherwise stated below in this proprietarynotice. Other brands and names mentioned herein may be the trademarksof their respective owners.

Neither the whole nor any part of the information containedin, or the product described in, this document may be adapted orreproduced in any material form except with the prior written permissionof the copyright holder.

The product described in this document is subject to continuousdevelopments and improvements. All particulars of the product andits use contained in this document are given by ARM in good faith.However, all warranties implied or expressed, including but notlimited to implied warranties of merchantability, or fitness forpurpose, are excluded.

This document is intended only to assist the reader in theuse of the product. ARM Limited shall not be liable for any lossor damage arising from the use of any information in this document,or any error or omission in such information, or any incorrect useof the product.


This document is Non-Confidential. The right to use, copyand disclose this document may be subject to license restrictionsin accordance with the terms of the agreement entered into by ARMand the party that ARM delivered this document to.

Product Status

The information in this document is final, that is for a developedproduct.

Revision History
Revision A December2002 First release
Revision B January2004 Updated for RealView ICE v1.1
Revision C August2004 Updated for RealView ICE v1.2
Revision D May2005 Updated for RealView ICE v1.4
Revision E November2005 Updated for RealView ICE v1.5
Copyright © 2002-2005 ARM Limited. All rights reserved. ARM DUI 0155E