| <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 5. Sourcery G++ Debug Sprite</title><link rel="stylesheet" href="cs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"><meta name="description" content=" This chapter describes the use of the Sourcery G++ Debug Sprite for remote debugging. The Sprite is provided for debugging of the Linux kernel on the target board. This chapter includes information about the debugging devices and boards supported by the Sprite for ARM GNU/Linux."><link rel="home" href="index.html" title="Sourcery G++ Lite"><link rel="up" href="index.html" title="Sourcery G++ Lite"><link rel="prev" href="sec-remote-debugging.html" title="4.3. Running Applications from GDB"><link rel="next" href="sec-sprite-invocation.html" title="5.2. Invoking Sourcery G++ Debug Sprite"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 5. Sourcery G++ Debug Sprite</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-remote-debugging.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="sec-sprite-invocation.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="sprite"></a>Chapter 5. Sourcery G++ Debug Sprite</h2></div><div><div class="abstract"><p class="title"><b></b></p><p> |
| This chapter describes the use of the Sourcery G++ Debug Sprite |
| for remote debugging. |
| |
| <span> |
| The Sprite is provided for debugging of the Linux |
| kernel on the target board. |
| </span> |
| |
| This chapter includes information about the debugging devices and |
| boards supported by the Sprite for ARM GNU/Linux. |
| </p></div></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="sprite.html#sec-sprite-probe">5.1. Probing for Debug Devices</a></span></dt><dt><span class="section"><a href="sec-sprite-invocation.html">5.2. Invoking Sourcery G++ Debug Sprite</a></span></dt><dt><span class="section"><a href="sec-sprite-options.html">5.3. Sourcery G++ Debug Sprite Options</a></span></dt><dt><span class="section"><a href="debug-sprite-rdi-url.html">5.4. Remote Debug Interface Devices</a></span></dt><dt><span class="section"><a href="debug-sprite-flashpro-url.html">5.5. Actel FlashPro Devices</a></span></dt><dt><span class="section"><a href="ch05s06.html">5.6. Debugging a Remote Board</a></span></dt><dt><span class="section"><a href="sec-sprite-supported-boards.html">5.7. Supported Board Files</a></span></dt><dt><span class="section"><a href="sec-sprite-board-file.html">5.8. Board File Syntax</a></span></dt></dl></div><p>Sourcery G++ Lite contains the |
| Sourcery G++ Debug Sprite for ARM GNU/Linux. |
| This Sprite is provided to allow debugging of programs running on a |
| bare board. You can use the Sprite to |
| debug a program when there is no operating system on the board, or |
| for debugging the operating system itself. If the board is running an |
| operating system, and you wish to debug a program running on that |
| OS, you should use the facilities provided by the OS itself (for |
| instance, using <code class="command">gdbserver</code>). |
| </p><p> |
| The Sprite acts as an interface between GDB and external debug devices and |
| libraries. Refer to <a class="xref" href="sec-sprite-invocation.html" title="5.2. Invoking Sourcery G++ Debug Sprite">Section 5.2, “Invoking Sourcery G++ Debug Sprite”</a> for |
| information about the specific devices supported by this version of |
| Sourcery G++ Lite. |
| </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note for Linux users</h3><p> |
| The Debug Sprite provided with Sourcery G++ Lite allows remote debugging |
| of the Linux kernel running on the target. |
| For remote debugging of application programs, you should use |
| <code class="command">gdbserver</code> instead. |
| <span> |
| See <a class="xref" href="chap-target.html" title="Chapter 3. Sourcery G++ Lite for ARM GNU/Linux">Chapter 3, “Sourcery G++ Lite for ARM GNU/Linux”</a> for details about how to install |
| and run <code class="command">gdbserver</code> on the target. |
| </span> |
| </p></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p> |
| The Sourcery G++ Debug Sprite is not part of the GNU Debugger and is |
| not free or open-source software. |
| You may use the Sourcery G++ Debug Sprite only with the GNU Debugger. |
| You may not distribute the Sourcery G++ Debug Sprite to any third party. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec-sprite-probe"></a>5.1. Probing for Debug Devices</h2></div></div></div><p> |
| Before running the Sourcery G++ Debug Sprite for the first time, or when |
| attaching new debug devices to your host system, it is helpful to |
| verify that the Sourcery G++ Debug Sprite recognizes your debug |
| hardware. From the command line, invoke the Sprite with the |
| <code class="option">-i</code> option: |
| |
| </p><pre class="screen">> arm-none-linux-gnueabi-sprite -i</pre><p> |
| |
| This prints out a list of supported device types. For devices that |
| can be autodetected, it additionally probes for and prints out a |
| list of attached devices. For instance: |
| |
| </p><pre class="screen">CodeSourcery ARM Debug Sprite |
| (Sourcery G++ Lite 2011.03-41) |
| armusb: [speed=<n:0-7>] ARMUSB (Stellaris) device |
| armusb:///0B01000C - Stellaris Evaluation Board (0B01000C) |
| rdi: (rdi-library=<file>&rdi-config=<file>) RDI Device |
| rdi:/// - RDI Device</pre><p> |
| <span> |
| This shows that ARMUSB and RDI devices are supported. |
| The exact set of supported devices depends on your host system |
| and the version of Sourcery G++ you have installed; refer to |
| <a class="xref" href="sec-sprite-invocation.html" title="5.2. Invoking Sourcery G++ Debug Sprite">Section 5.2, “Invoking Sourcery G++ Debug Sprite”</a> for complete information. |
| </span> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| </p><p> |
| Note that it may take several seconds for the Debug Sprite to probe |
| for all types of supported devices. |
| </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sec-remote-debugging.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="sec-sprite-invocation.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4.3. Running Applications from GDB </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 5.2. Invoking Sourcery G++ Debug Sprite</td></tr></table></div></body></html> |
