This chapter provides a conceptual overview of Palm OS Debugger. It describes:
- "What Is Palm OS Debugger?"
- "How Does Palm OS Debugger Compare to Palm Debugger?"
- "Prerequisites for Using Palm OS Debugger"
What Is Palm OS Debugger?
Palm OS Debugger is a full-function debug tool that you can use to debug your Palm OS® applications and shared libraries. Palm OS Debugger provides support for multiple symbolic file debugging.
Palm OS Debugger provides the following features:
- Full assembly, mixed, and source-level debugging for 68K applications, PACE Native Objects (PNO), and Palm OS Protein applications
- Support for shared library debugging
- Support for debugging with multiple symbolic files
- Fully customizable short cut keys
- Views for watching expressions, memory, processes, registers, and variables.
- Setting and viewing breakpoints
- Support for PRC and SYM 3.5 symbolic files
- Support for ELF/DWARF 1.1 and ELF/DWARF 2.0
How Does Palm OS Debugger Compare to Palm Debugger?
- Palm OS Debugger is a tool for debugging 68K applications, PACE Native Objects, and Palm OS Protein applications.
Debugging 68K-Based Applications: Palm OS Debugger supports connecting to the 68K debug nub of a 68K-based device and to the 68K debug nub built into the PACE component of an ARM-based device. Palm OS Debugger also connects to the 68K debug nub of Palm OS Emulator and Palm OS Simulator.
Debugging PACE Native Objects: Palm OS Debugger supports connecting to the ARM debug nub of an ARM-based device.
Palm OS Debugger is the tool that is described in this manual.
- Palm Debugger is used for debugging Palm OS 68K applications on both Mac OS and Windows 95/98/NT platforms. Palm Debugger supports 68K assembly debugging, not source level debugging.
Palm Debugger supports connecting with either the console or debugging nub of a 68K-based device or Palm OS Emulator. For information about Palm Debugger, see Palm OS Development Tools Guide.
Prerequisites for Using Palm OS Debugger
Palm OS Debugger requires the following hardware and software components.
Operating System Requirements
Palm OS Debugger runs on Windows 2000 and Windows XP.
Debug Targets
- You can use Palm OS Debugger to debug 68K-based Palm OS application code running on a 68K-based device, an ARM-based device, and Palm OS Emulator.
- You can use Palm OS Debugger to debug PACE Native Objects on an ARM-based device (a device running Palm OS Garnet or Palm OS Cobalt).
- You can use Palm OS Debugger to debug Palm OS Protein applications on a device running Palm OS Cobalt.
Palm OS Debugger connects with any of these debug targets over a serial or socket connection.
For detailed information, see Chapter 2, "Connecting Palm OS Debugger with a Target,".
Compiler Requirements
Palm OS Debugger can debug code that is compiled by the CodeWarrior for Palm OS tool suites, the ARM ADS 1.2 compiler, or any toolchain that can create PRC files with a supported symbolic format. Supported symbolic formats are ELF/DWARF 1.1, ELF/DWARF 2.0, and SYM 3.3.
In general, Palm OS Debugger supports any compiler that emits DWARF (Debugging With Attribute Record Format) debugging information Version 1.1 or above. However, because DWARF Version 1 and DWARF Version 2 are two different standards, Palm OS Debugger implements support for each in a separate plug-in. Only one of these plug-ins can be loaded at any given time. For best results while debugging, you should not combine code that uses different DWARF versions.