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
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
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