ARM DS-5 Using the Debugger

Chapter 1 Conventions and feedback

Chapter 2 Getting started with the debugger

2.1 About the debugger ................................................................................................. 2-2
2.2 Debugger concepts .................................................................................................. 2-4
2.3 Launching the debugger from Eclipse ..................................................................... 2-6
2.4 Launching the debugger from the command-line console ....................................... 2-7
2.5 DS-5 Debug perspective keyboard shortcuts ........................................................ 2-10
2.6 DS-5 Debugger command-line console keyboard shortcuts ................................. 2-11
2.7 Standards compliance in the DS-5 Debugger ....................................................... 2-12

Chapter 3 Configuring and connecting to a target

3.1 Types of target connections ..................................................................................... 3-2
3.2 Configuring a connection to an RTSM model .......................................................... 3-3
3.3 Configuring a connection to a Linux target using gdbserver .................................... 3-5
3.4 Configuring a connection to a Linux Kernel ............................................................. 3-7
3.5 Configuring a connection to a bare-metal target ...................................................... 3-9
3.6 Configuring an Event Viewer connection to a bare-metal target ........................... 3-11
3.7 About the target configuration import utility ........................................................... 3-13
3.8 Adding a new platform ........................................................................................... 3-16
3.9 Adding a new configuration database to DS-5 ...................................................... 3-18
3.10 Exporting an existing launch configuration ............................................................ 3-20
3.11 Importing an existing launch configuration ............................................................ 3-22
3.12 Disconnecting from a target ................................................................................... 3-24

Chapter 4 Working with the target configuration editor

4.1 About the target configuration editor ........................................................................ 4-3
4.2 Target configuration editor - Overview tab ............................................................... 4-4
4.3 Target configuration editor - Memory tab ................................................................. 4-6
4.4 Target configuration editor - Peripherals tab ........................................................... 4-9
4.5 Target configuration editor - Registers tab ............................................................ 4-11
4.6 Target configuration editor - Group View tab ......................................................... 4-13
4.7 Target configuration editor - Enumerations tab ..................................................... 4-15
4.8 Target configuration editor - Configurations tab .................................................... 4-17
4.9 Scenario demonstrating how to create a new target configuration file .................. 4-19
4.10 Creating a memory map ........................................................................................ 4-21
4.11 Creating a peripheral ............................................................................................. 4-22
4.12 Creating a standalone register ............................................................................... 4-23
4.13 Creating a peripheral register ................................................................................ 4-24
4.14 Creating enumerations for use with a peripheral register ...................................... 4-25
4.15 Assigning enumerations to a peripheral register ................................................... 4-26
4.16 Creating remapping rules for a control register ..................................................... 4-27
4.17 Creating a memory region for remapping by a control register ............................. 4-28
4.18 Applying the map rules to the overlapping memory regions .................................. 4-29
4.19 Creating a power domain for a target .................................................................... 4-31
4.20 Creating a Group list .............................................................................................. 4-32
4.21 Importing an existing target configuration file ........................................................ 4-33
4.22 Exporting a target configuration file ....................................................................... 4-35

Chapter 5 Controlling execution

5.1 About loading an image on to the target .................................................................. 5-2
5.2 About loading debug information into the debugger ................................................ 5-4
5.3 About passing arguments to main() ......................................................................... 5-6
5.4 Running an image .................................................................................................... 5-7
5.5 About breakpoints and watchpoints ......................................................................... 5-8
5.6 Setting an execution breakpoint ............................................................................ 5-11
5.7 Setting a data watchpoint ...................................................................................... 5-13
5.8 Setting a tracepoint ................................................................................................ 5-15
5.9 Setting Streamline start and stop points ................................................................ 5-16
5.10 Setting a conditional breakpoint ............................................................................. 5-17
5.11 Setting a breakpoint on a specific thread ............................................................... 5-20
5.12 Pending breakpoints and watchpoints ................................................................... 5-22
5.13 Exporting DS-5 breakpoint settings to a file ........................................................... 5-24
5.14 Importing DS-5 breakpoint settings from a file ....................................................... 5-26
5.15 Stepping through an application ............................................................................ 5-28
5.16 Handling Unix signals ............................................................................................ 5-30
5.17 Handling processor exceptions .............................................................................. 5-32
5.18 Configuring the debugger path substitution rules .................................................. 5-34

Chapter 6 Examining the target

6.1 Examining the target execution environment ........................................................... 6-2
6.2 Examining the call stack .......................................................................................... 6-4
6.3 About trace support ................................................................................................. 6-6

Chapter 7 Debugging embedded systems

7.1 About endianness .................................................................................................... 7-2
7.2 About accessing AHB, APB, and AXI buses ........................................................... 7-3
7.3 About virtual and physical memory .......................................................................... 7-4
7.4 About debugging hypervisors .................................................................................. 7-5
7.5 About debugging big.LITTLE systems ..................................................................... 7-6
7.6 About debugging bare-metal symmetric multiprocessing systems .......................... 7-7
7.7 About debugging multi-threaded applications ........................................................ 7-10
7.8 About debugging shared libraries .......................................................................... 7-12
7.9 About debugging a Linux kernel ............................................................................ 7-15
7.10 About debugging Linux kernel modules ................................................................. 7-17
7.11 About debugging TrustZone enabled targets ........................................................ 7-19

Chapter 8 Controlling runtime messages

8.1 About semihosting and top of memory .................................................................... 8-2
8.2 Working with semihosting ........................................................................................ 8-4
8.3 Enabling automatic semihosting support in the debugger ....................................... 8-5
8.4 Controlling semihosting messages using the command-line console ..................... 8-6
8.5 Controlling the output of logging messages ............................................................. 8-7
8.6 About Log4j configuration files ................................................................................. 8-8
8.7 Customizing the output of logging messages from the debugger ............................ 8-9

Chapter 9 Debugging with scripts

9.1 Exporting DS-5 Debugger commands generated during a debug session .............. 9-2
9.2 Creating a DS-5 Debugger script ............................................................................. 9-3
9.3 About Jython scripts ................................................................................................ 9-4
9.4 Jython script concepts and interfaces ...................................................................... 9-6
9.5 Configuring a Jython project in Eclipse .................................................................... 9-8
9.6 Creating a Jython script ......................................................................................... 9-11
9.7 Running a script ..................................................................................................... 9-13
9.8 Creating a CMM-style script .................................................................................. 9-14

Chapter 10 Working with the Snapshot Viewer

10.1 About the Snapshot Viewer ................................................................................... 10-2
10.2 Creating a Snapshot Viewer initialization file ......................................................... 10-5
10.3 Connecting to the Snapshot Viewer ...................................................................... 10-8
10.4 Considerations when creating debugger scripts for the Snapshot Viewer ............ 10-9

Chapter 11 DS-5 Debug perspective and views

11.1 App Console view .................................................................................................. 11-3
11.2 ARM Asm Info view ............................................................................................... 11-5
11.3 ARM assembler editor ........................................................................................... 11-6
11.4 Breakpoints view .................................................................................................... 11-9
11.5 C/C++ editor ........................................................................................................ 11-13
11.6 Commands view .................................................................................................. 11-16
11.7 Debug Control view ............................................................................................. 11-19
11.8 Disassembly view ................................................................................................ 11-24
11.9 Events view .......................................................................................................... 11-28
11.10 Expressions view ................................................................................................. 11-29
11.11 Functions view ..................................................................................................... 11-32
11.12 History view ......................................................................................................... 11-35
11.13 Memory view ........................................................................................................ 11-37
11.14 Modules view ....................................................................................................... 11-41
11.15 Registers view ..................................................................................................... 11-44
11.16 Screen view ......................................................................................................... 11-47
11.17 Scripts view .......................................................................................................... 11-50
11.18 Target view .......................................................................................................... 11-52
11.19 Target Console view ............................................................................................ 11-54
11.20 Trace view ........................................................................................................... 11-55
11.21 Variables view ...................................................................................................... 11-59
11.22 Auto Refresh Properties dialog box ..................................................................... 11-62
11.23 Memory Exporter dialog box ................................................................................ 11-63
11.24 Memory Importer dialog box ................................................................................ 11-65
11.25 Fill Memory dialog box ......................................................................................... 11-67
11.26 Export trace report dialog box .............................................................................. 11-68
11.27 Breakpoint properties dialog box ......................................................................... 11-70
11.28 Watchpoint properties dialog box ........................................................................ 11-74
11.29 Tracepoint properties dialog box ......................................................................... 11-75
11.30 Manage Signals dialog box .................................................................................. 11-76
11.31 Event Viewer dialog box ...................................................................................... 11-78
11.32 Functions Filter dialog box ................................................................................... 11-79
11.33 Jython Script Parameters dialog box ................................................................... 11-80
11.34 Debug Configurations - Connection tab ............................................................... 11-81
11.35 Debug Configurations - Files tab ......................................................................... 11-85
11.36 Debug Configurations - Debugger tab ................................................................. 11-90
11.37 Debug Configurations - Arguments tab ............................................................... 11-94
11.38 Debug Configurations - Environment tab ............................................................. 11-97
11.39 Debug Configurations - Event Viewer tab .......................................................... 11-100
11.40 DTSL Configuration Editor dialog box ............................................................... 11-103
11.41 Configuration database panel ............................................................................ 11-106
11.42 About the Remote System Explorer .................................................................. 11-108
11.43 Remote Systems view ...................................................................................... 11-109
11.44 Remote System Details view ............................................................................. 11-110
11.45 Remote Scratchpad view ................................................................................... 11-111
11.46 Remote Systems terminal for SSH connections ................................................ 11-112
11.47 Target management terminal for serial and SSH connections .......................... 11-113
11.48 New Terminal Connection dialog box ................................................................ 11-114
11.49 DS-5 Debugger menu and toolbar icons ........................................................... 11-116

Chapter 12 Troubleshooting

12.1 ARM Linux problems and solutions ....................................................................... 12-2
12.2 Enabling internal logging from the debugger ......................................................... 12-3
12.3 Target connection problems and solutions ............................................................ 12-4