RealView Debugger User Guide

Chapter 1 RealView Debugger Features

1.1 Overview of RealView Debugger windows and views ............................................. 1-2
1.2 Target connection .................................................................................................. 1-23
1.3 Image and binary loading ...................................................................................... 1-26
1.4 TrustZone technology support ............................................................................... 1-28
1.5 Multiprocessor debugging ...................................................................................... 1-29
1.6 Execution control ................................................................................................... 1-31
1.7 Memory mapping ................................................................................................... 1-32
1.8 Execution context and scope ................................................................................. 1-34
1.9 Breakpoints in RealView Debugger ....................................................................... 1-36
1.10 Examining the target execution environment ......................................................... 1-38
1.11 Altering the target execution environment ............................................................. 1-40
1.12 Command scripts ................................................................................................... 1-42
1.13 Macros ................................................................................................................... 1-43
1.14 Log and journal files ............................................................................................... 1-44
1.15 Editing source files ................................................................................................. 1-45
1.16 Searching source files ........................................................................................... 1-46

Chapter 2 The RealView Debugger Environment

2.1 Starting RealView Debugger from the command line .............................................. 2-2
2.2 Starting RealView Debugger after installing other components .............................. 2-7
2.3 Setting user-defined environment variables ............................................................ 2-8
2.4 Redefining the RealView Debugger directories ....................................................... 2-9

Chapter 3 Target Connection

3.1 About target connection ........................................................................................... 3-2
3.2 About creating a Debug Configuration ..................................................................... 3-8
3.3 Changing the name of a Debug Configuration ...................................................... 3-18
3.4 Copying an existing Debug Configuration ............................................................. 3-19
3.5 Deleting a Debug Configuration ............................................................................. 3-20
3.6 Customizing a Debug Configuration ...................................................................... 3-21
3.7 Connecting to a target ........................................................................................... 3-28
3.8 Showing the trace components in the Connect to Target window ......................... 3-36
3.9 Viewing information about the target topology ....................................................... 3-37
3.10 Setting top of memory for the current debugging session ..................................... 3-39
3.11 Viewing connection details .................................................................................... 3-41
3.12 Connecting to a target on startup .......................................................................... 3-43
3.13 Connecting to a target using different modes ........................................................ 3-44
3.14 Connecting to multiple targets ............................................................................... 3-47
3.15 Connecting to all targets for a specific Debug Configuration ................................. 3-49
3.16 Changing the current target connection ................................................................. 3-51
3.17 Disconnecting from a target ................................................................................... 3-53
3.18 Disconnecting from a target using different modes ............................................... 3-55
3.19 Disconnecting from multiple targets ....................................................................... 3-57
3.20 Disconnecting from all targets for a specific Debug Configuration ........................ 3-59
3.21 Storing connections when exiting RealView Debugger ......................................... 3-60
3.22 Troubleshooting target connection problems ......................................................... 3-61

Chapter 4 Loading Images and binaries

4.1 About loading images and binaries .......................................................................... 4-2
4.2 Loading an executable image .................................................................................. 4-4
4.3 Viewing image details .............................................................................................. 4-9
4.4 Loading a binary .................................................................................................... 4-12
4.5 Loading multiple images to the same target .......................................................... 4-14
4.6 Loading symbols only for an image ....................................................................... 4-16
4.7 Replacing the currently loaded image ................................................................... 4-17
4.8 Loading an executable image on startup ............................................................... 4-18
4.9 Unloading an image ............................................................................................... 4-20
4.10 Deleting the process details for an unloaded image .............................................. 4-21
4.11 Reloading an image ............................................................................................... 4-22
4.12 Reloading a binary ................................................................................................. 4-23
4.13 Changing the format of the disassembly view ....................................................... 4-24
4.14 Interleaving source in the disassembly view .......................................................... 4-25
4.15 Opening source files for a loaded image ............................................................... 4-26
4.16 Saving and closing source files ............................................................................. 4-28
4.17 Hiding line numbers for opened source files .......................................................... 4-29
4.18 Adding source file search paths for a loaded image .............................................. 4-31
4.19 Autoconfiguring search rules for locating source files ........................................... 4-34

Chapter 5 Navigating the Source and Disassembly Views

5.1 About navigating the source and disassembly views .............................................. 5-2
5.2 Viewing the selected location in the opposite code view ......................................... 5-3
5.3 Locating the lowest address in memory of a module ............................................... 5-4
5.4 Locating the line of code using a symbol in the source view ................................... 5-6
5.5 Locating the address of a label in the disassembly view ......................................... 5-7
5.6 Locating the destination of a branch instruction ...................................................... 5-8
5.7 Locating a function ................................................................................................... 5-9
Chapter 6 Writing Binaries to Flash
6.1 About writing binaries to Flash ................................................................................. 6-2
6.2 Writing a binary to Flash .......................................................................................... 6-4
6.3 Writing to specific locations in Flash memory .......................................................... 6-6
6.4 Viewing information about the Flash memory .......................................................... 6-8

6.5 Operations available when writing to Flash ........................................................... 6-10

Chapter 7 Debugging Multiprocessor Applications

7.1 About debugging multiprocessor applications ......................................................... 7-2
7.2 Opening multiple Code windows ............................................................................. 7-8
7.3 Attaching a Code window to a connection ............................................................. 7-10
7.4 Unattaching a Code window from a connection .................................................... 7-11
7.5 Using DSTREAM or RealView ICE for multiprocessor debugging ........................ 7-12
7.6 Synchronizing multiple processors ........................................................................ 7-13
7.7 Setting up software cross-triggering ...................................................................... 7-17
7.8 Setting up hardware cross-triggering ..................................................................... 7-20
7.9 Configuring embedded cross-triggering ................................................................. 7-25
7.10 Configuring CoreSight embedded cross-triggering ................................................ 7-27
7.11 Sharing resources between multiple targets .......................................................... 7-28

Chapter 8 Executing Images

8.1 About image execution ............................................................................................ 8-2
8.2 Starting and stopping image execution .................................................................... 8-4
8.3 Running an image to a specific point ....................................................................... 8-7
8.4 Stepping by lines of source code ........................................................................... 8-12
8.5 Stepping by instructions ......................................................................................... 8-16
8.6 Stepping until a user-specified condition is met ..................................................... 8-20
8.7 Resetting your target processor ............................................................................. 8-22

Chapter 9 Mapping Target Memory

9.1 About mapping target memory ................................................................................ 9-2
9.2 Setting the default access type for unmapped memory regions .............................. 9-5
9.3 Enabling memory mapping ...................................................................................... 9-6
9.4 Viewing the memory map ........................................................................................ 9-8
9.5 Setting up a temporary memory map .................................................................... 9-12
9.6 Setting up a memory map ...................................................................................... 9-15
9.7 Creating a temporary memory map entry .............................................................. 9-18
9.8 Editing a memory map entry .................................................................................. 9-20
9.9 Updating the memory map .................................................................................... 9-22
9.10 Deleting memory map blocks ................................................................................ 9-23
9.11 Generating linker command files for non-ARM targets .......................................... 9-24

Chapter 10 Changing the Execution Context

10.1 About changing the execution context ................................................................... 10-2
10.2 Changing scope to the PC ..................................................................................... 10-5
10.3 Displaying the current execution context ............................................................... 10-6
10.4 Resetting the PC to the image entry point ............................................................. 10-7
10.5 Setting the PC to the address of an instruction or line of code .............................. 10-8
10.6 Setting the PC to a function ................................................................................... 10-9
10.7 Changing scope to the code pointed to by a Call Stack entry ............................. 10-12

Chapter 11 Setting Breakpoints

11.1 About setting breakpoints ...................................................................................... 11-3
11.2 Setting a simple breakpoint ................................................................................. 11-13
11.3 Setting an unconditional breakpoint with specific attributes ................................ 11-16
11.4 Clearing breakpoints ............................................................................................ 11-18
11.5 Restoring saved breakpoints for a loaded image ................................................ 11-20
11.6 Viewing breakpoint information ............................................................................ 11-21
11.7 Disabling a breakpoint ......................................................................................... 11-23
11.8 Enabling a breakpoint .......................................................................................... 11-24
11.9 Editing a breakpoint ............................................................................................. 11-26
11.10 Copying a breakpoint ........................................................................................... 11-29
11.11 Finding a breakpoint in the code view ................................................................. 11-31
11.12 Viewing the target hardware breakpoint support ................................................. 11-32

11.13 Setting breakpoints by dragging and dropping .................................................... 11-33
11.14 Setting breakpoints on lines of source code ........................................................ 11-35
11.15 Setting breakpoints on instructions ...................................................................... 11-38
11.16 Setting breakpoints on functions .......................................................................... 11-40
11.17 Setting breakpoints for memory accesses ........................................................... 11-47
11.18 Setting breakpoints for location-specific data values ........................................... 11-55
11.19 Setting breakpoints for location-independent data values ................................... 11-60
11.20 Forcing the size of a software breakpoint ............................................................ 11-63
11.21 Chaining hardware breakpoints ........................................................................... 11-64
11.22 Specifying processor exceptions (global breakpoints) ......................................... 11-66
11.23 Setting breakpoints on custom memory mapped registers .................................. 11-68
11.24 Setting breakpoints from the breakpoint history list ............................................. 11-71
11.25 Creating new breakpoint favorites ....................................................................... 11-73
11.26 Setting breakpoints from your Favorites List ....................................................... 11-75

Chapter 12 Controlling the Behavior of Breakpoints

12.1 About controlling the behavior of breakpoints ........................................................ 12-2
12.2 Updating windows and views when a breakpoint activates ................................... 12-4
12.3 Displaying user-defined messages when a breakpoint activates .......................... 12-7
12.4 Setting the execution behavior for a breakpoint .................................................... 12-9
12.5 Setting breakpoints that test for hardware input triggers ..................................... 12-10
12.6 Setting a breakpoint that activates after a number of passes .............................. 12-13
12.7 Resetting breakpoint pass counters .................................................................... 12-17
12.8 Setting a breakpoint that depends on the result of an expression ....................... 12-18
12.9 Setting a breakpoint that depends on the result of a macro ................................ 12-21
12.10 Setting a breakpoint on a specific instance of a C++ class ................................. 12-24
12.11 Example of breakpoint behavior .......................................................................... 12-27

Chapter 13 Examining the Target Execution Environment

13.1 About examining the target execution environment ............................................... 13-3
13.2 Finding a function in your code .............................................................................. 13-7
13.3 Displaying function information from the Symbols view ....................................... 13-10
13.4 Displaying the list of variables in an image .......................................................... 13-11
13.5 Viewing variables for the current context ............................................................. 13-14
13.6 Displaying information for a variable .................................................................... 13-19
13.7 Viewing C++ classes ........................................................................................... 13-22
13.8 Viewing registers ................................................................................................. 13-25
13.9 Viewing semihosting controls for DSTREAM or RealView ICE JTAG connections ........
13-35
13.10 Viewing semihosting controls for RVISS targets ................................................. 13-37
13.11 Viewing memory contents .................................................................................... 13-39
13.12 MMU page tables views ....................................................................................... 13-46
13.13 Managing the display of memory in the Memory view ......................................... 13-50
13.14 Viewing the Stack ................................................................................................ 13-58
13.15 Viewing the Call Stack ......................................................................................... 13-63
13.16 Setting watches ................................................................................................... 13-67
13.17 Viewing watches .................................................................................................. 13-70
13.18 Viewing statistics for RVISS targets .................................................................... 13-74
13.19 Viewing the RVISS map related statistics in RealView Debugger ....................... 13-81
13.20 Saving memory contents to a file ......................................................................... 13-83
13.21 Comparing target memory with the contents of a file .......................................... 13-85
13.22 Displaying information in a user-defined window ................................................. 13-87
13.23 Saving information to a user-defined file ............................................................. 13-90
13.24 Displaying a list of open user-defined windows and files ..................................... 13-93

Chapter 14 Altering the Target Execution Environment

14.1 About altering the target execution environment ................................................... 14-2
14.2 Changing the value of a register ............................................................................ 14-3
14.3 Changing memory contents ................................................................................. 14-12
14.4 Changing the data width on memory accesses ................................................... 14-18

14.5 Loading the contents of a file into memory .......................................................... 14-19
14.6 Changing the stack pointer .................................................................................. 14-21
14.7 Changing the value of a watch ............................................................................ 14-23
14.8 Communicating with a target over DCC .............................................................. 14-24

Chapter 15 Debugging with Command Scripts

15.1 About debugging with command scripts ................................................................ 15-2
15.2 Changing output buffering behavior ....................................................................... 15-4
15.3 Creating a log file for use as a command script ..................................................... 15-5
15.4 Creating log and journal files at start-up ................................................................ 15-6
15.5 Closing log and journal files ................................................................................... 15-7
15.6 Using macros in command scripts ......................................................................... 15-8
15.7 Running command scripts ..................................................................................... 15-9
15.8 Creating a script that writes information to a user-defined window ..................... 15-13
15.9 Creating a script that accesses a user-defined file .............................................. 15-14

Chapter 16 Using Macros for Debugging

16.1 About using macros for debugging ........................................................................ 16-2
16.2 Creating a macro ................................................................................................... 16-4
16.3 Loading user-defined macros ................................................................................ 16-9
16.4 Running a macro ................................................................................................. 16-12
16.5 Editing a macro .................................................................................................... 16-14
16.6 Copying a macro .................................................................................................. 16-16
16.7 Viewing a macro .................................................................................................. 16-17
16.8 Deleting a macro .................................................................................................. 16-18
16.9 Using macros in combination with other commands ........................................... 16-19
16.10 Stopping execution of a macro ............................................................................ 16-22

Chapter 17 Configuring Workspace Settings

17.1 About workspace settings ...................................................................................... 17-2
17.2 Initializing the workspace ....................................................................................... 17-3
17.3 Opening workspaces ............................................................................................. 17-4
17.4 Closing workspaces ............................................................................................... 17-6
17.5 Creating an empty workspace ............................................................................... 17-8
17.6 Saving workspaces ................................................................................................ 17-9
17.7 Viewing workspace settings ................................................................................. 17-11
17.8 Configuring workspace settings ........................................................................... 17-15

Appendix A Workspace Settings Reference

A.1 DEBUGGER ............................................................................................................ A-2
A.2 CODE ...................................................................................................................... A-6
A.3 ALL .......................................................................................................................... A-7
A.4 CONNECTION ....................................................................................................... A-14
A.5 WINDOW ............................................................................................................... A-15

Appendix B Configuration Files Reference

B.1 Overview .................................................................................................................. B-2
B.2 Files in the default settings directory ....................................................................... B-3
B.3 Files in the home directory ....................................................................................... B-5

Appendix C Moving from AXD to RealView Debugger

C.1 RealView Debugger configuration ........................................................................... C-2
C.2 RealView Debugger operations ............................................................................... C-5
C.3 Comparison of RealView Debugger and AXD commands ...................................... C-7
C.4 Converting legacy AXD scripts to RealView Debugger format .............................. C-11

Appendix D Moving from armsd to RealView Debugger

D.1 RealView Debugger configuration ........................................................................... D-2

D.2 Comparison of RealView Debugger and armsd commands .................................... D-3
D.3 Converting legacy armsd scripts to RealView Debugger format ............................. D-6

Appendix E RealView Debugger on Red Hat Linux

E.1 About this Appendix ................................................................................................. E-2
E.2 Getting more information ......................................................................................... E-3
E.3 Changes to target configuration details ................................................................... E-4
E.4 Changes to GUI and general user information ........................................................ E-5