ARM® DS-5™ Using the Debugger

Version 5.5


List of Topics

Conventions and feedback
Getting started with the debugger
About the debugger
Debugger concepts
Launching the debugger from Eclipse
Launching the debugger from the command-line console
DS-5 Debug perspective keyboard shortcuts
DS-5 Debugger command-line console keyboard shortcuts
Configuring and connecting to a target
Types of target connections
Configuring a connection to an RTSM model
Configuring a connection to a Linux target using gdbserver
Configuring a connection to a Linux Kernel
Configuring a connection to a bare-metal target
Exporting an existing launch configuration
Importing an existing launch configuration
Disconnecting from a target
Controlling execution
About loading an image on to the target
About loading debug information into the debugger
Running an image
About breakpoints and watchpoints
Setting an execution breakpoint
Setting a data watchpoint
Setting a conditional breakpoint
Setting a breakpoint on a specific thread
Pending breakpoints and watchpoints
Exporting DS-5 breakpoint settings to a file
Importing DS-5 breakpoint settings from a file
Stepping through an application
Handling Unix signals
Handling processor exceptions
Configuring the debugger path substitution rules
Examining the target
Examining the target execution environment
Examining the call stack
About trace support
Debugging embedded systems
About debugging bare-metal symmetric multiprocessing systems
About debugging multi-threaded applications
About debugging shared libraries
About debugging a Linux kernel
About debugging Linux kernel modules
Debugging with command scripts
Creating a debugger script file
Running a debugger script file in Eclipse
Controlling runtime messages
About semihosting and top of memory
Working with semihosting
Enabling automatic semihosting support in the debugger
Controlling semihosting messages using the command-line console
Controlling the output of logging messages
About Log4j configuration files
Customizing the output of logging messages from the debugger
Reading and writing to flash memory
Registering a new flash algorithm
Writing an image to flash memory
Working with the Snapshot Viewer
Creating a Snapshot Viewer initialization file
About the Snapshot Viewer
Connecting to the Snapshot Viewer
Considerations when creating debugger scripts for the Snapshot Viewer
DS-5 Debug perspective and views
App Console view
ARM Asm Info view
ARM assembler editor
Breakpoints view
C/C++ editor
Commands view
Debug Control view
Disassembly view
Expressions view
History view
Memory view
Modules view
Registers view
Screen view
Scripts view
Target view
Trace view
Variables view
Export trace report dialog box
Breakpoint properties dialog box
Watchpoint properties dialog box
Manage Signals dialog box
Debug Configurations - Connection tab
Debug Configurations - Files tab
Debug Configurations - Debugger tab
Debug Configurations - Arguments tab
Debug Configurations - Environment tab
DS-5 Debugger menu and toolbar icons
Troubleshooting
ARM Linux problems and solutions
Enabling internal logging from the debugger
Target connection problems and solutions

List of Figures

1. Export launch configuration dialog box
2. Launch configuration selection panels
3. Import launch configuration dialog box
4. Launch configuration file selection panels
5. Load File dialog box
6. Load additional debug information dialog box
7. Setting an execution breakpoint
8. Setting a data watchpoint
9. Setting a conditional breakpoint
10. Setting a breakpoint on a specific thread
11. Export DS-5 breakpoint settings
12. Import DS-5 breakpoints
13. Debug Control view
14. Managing signal handler settings
15. Manage exception handler settings
16. Source Not Found warning
17. Path Substitution dialog box
18. Edit Substitute Path dialog box
19. Examine the target execution
20. Debug Control view
21. Threading call stacks in the Debug Control view
22. Adding individual shared library files
23. Modifying the shared library search paths
24. History view
25. Scripts view
26. Typical layout between top of memory, stack, and heap
27. Memory map showing flash regions
28. App Console view
29. ARM Asm Info view
30. ARM assembler editor
31. Breakpoints view
32. C/C++ editor
33. Show disassembly for selected source line
34. Commands view
35. Content Assist
36. Debug Control view
37. Disassembly view
38. Expressions view
39. History view
40. Memory view
41. Modules view showing shared libraries
42. Modules view showing operating system modules
43. Registers view
44. Screen view
45. Scripts view
46. Target view
47. Trace view with a scale of 1:1
48. Variables view
49. Export trace report dialog box
50. Breakpoint properties dialog box
51. Watchpoint properties dialog box
52. Managing signal handler settings
53. Manage exception handler settings
54. Connection configuration for a model using VFS
55. File system configuration for an application on a model
56. Debugger configuration to set starting point and search paths
57. Application arguments configuration
58. Setting up target environment variables
59. Environment configuration for a model

Proprietary Notice

Words and logos marked with ® or ™ are registered trademarks or trademarks of ARM in the EU and other countries, except as otherwise stated below in this proprietary notice. Other brands and names mentioned herein may be the trademarks of their respective owners.

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

The product described in this document is subject to continuous developments and improvements. All particulars of the product and its use contained in this document are given by ARM in good faith. However, all warranties implied or expressed, including but not limited to implied warranties of merchantability, or fitness for purpose, are excluded.

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

Where the term ARM is used it means "ARM or any of its subsidiaries as appropriate".

Confidentiality Status

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

Product Status

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

Revision History
Revision AJune 2010First release for DS-5
Revision BSeptember 2010Update for DS-5 version 5.2
Revision CNovember 2010Update for DS-5 version 5.3
Revision DJanuary 2011Update for DS-5 version 5.4
Revision E-March 2011Update for DS-5 version 5.5
Copyright © 2010, 2011 ARM. All rights reserved.ARM DUI 0446E
Non-ConfidentialID051311