1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter�6.�Sourcery CodeBench 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 CodeBench Debug Sprite for remote debugging. The Sprite allows you to debug programs running on a bare board without an operating system. This chapter includes information about the debugging devices and boards supported by the Sprite for ARM EABI."><link rel="home" href="index.html" title="Sourcery CodeBench Lite"><link rel="up" href="index.html" title="Sourcery CodeBench Lite"><link rel="prev" href="sec-cs3-vector-tables.html" title="5.6.�Interrupt Vector Tables"><link rel="next" href="ch06s02.html" title="6.2.�Debug Sprite Example"></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�6.�Sourcery CodeBench Debug Sprite</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-cs3-vector-tables.html">Prev</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="ch06s02.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�6.�Sourcery CodeBench Debug Sprite</h2></div><div><div class="abstract"><p class="title"><b></b></p><p> 2 This chapter describes the use of the Sourcery CodeBench Debug Sprite 3 for remote debugging. 4 <span> 5 The Sprite allows you to debug programs running on a bare board 6 without an operating system. 7 </span> 8 9 10 This chapter includes information about the debugging devices and 11 boards supported by the Sprite for ARM EABI. 12 </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">6.1. Probing for Debug Devices</a></span></dt><dt><span class="section"><a href="ch06s02.html">6.2. Debug Sprite Example</a></span></dt><dt><span class="section"><a href="sec-sprite-invocation.html">6.3. Invoking Sourcery CodeBench Debug Sprite</a></span></dt><dt><span class="section"><a href="sec-sprite-options.html">6.4. Sourcery CodeBench Debug Sprite Options</a></span></dt><dt><span class="section"><a href="debug-sprite-rdi-url.html">6.5. Remote Debug Interface Devices</a></span></dt><dt><span class="section"><a href="debug-sprite-flashpro-url.html">6.6. Actel FlashPro Devices</a></span></dt><dt><span class="section"><a href="debug-sprite-altera-url.html">6.7. Altera Devices</a></span></dt><dt><span class="section"><a href="ch06s08.html">6.8. Debugging a Remote Board</a></span></dt><dt><span class="section"><a href="sec-sprite-supported-boards.html">6.9. Supported Board Files</a></span></dt><dt><span class="section"><a href="sec-sprite-board-file.html">6.10. Board File Syntax</a></span></dt></dl></div><p>Sourcery CodeBench Lite contains the 13 Sourcery CodeBench Debug Sprite for ARM EABI. 14 This Sprite is provided to allow debugging of programs running on a 15 bare board. You can use the Sprite to 16 debug a program when there is no operating system on the board, or 17 for debugging the operating system itself. If the board is running an 18 operating system, and you wish to debug a program running on that 19 OS, you should use the facilities provided by the OS itself (for 20 instance, using <code class="command">gdbserver</code>). 21 </p><p> 22 The Sprite acts as an interface between GDB and external debug devices and 23 libraries. Refer to <a class="xref" href="sec-sprite-invocation.html" title="6.3.�Invoking Sourcery CodeBench Debug Sprite">Section�6.3, “Invoking Sourcery CodeBench Debug Sprite”</a> for 24 information about the specific devices supported by this version of 25 Sourcery CodeBench Lite. 26 </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p> 27 The Sourcery CodeBench Debug Sprite is not part of the GNU Debugger and is 28 not free or open-source software. 29 You may use the Sourcery CodeBench Debug Sprite only with the GNU Debugger. 30 You may not distribute the Sourcery CodeBench Debug Sprite to any third party. 31 </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec-sprite-probe"></a>6.1.�Probing for Debug Devices</h2></div></div></div><p> 32 Before running the Sourcery CodeBench Debug Sprite for the first time, or when 33 attaching new debug devices to your host system, it is helpful to 34 verify that the Sourcery CodeBench Debug Sprite recognizes your debug 35 hardware. From the command line, invoke the Sprite with the 36 <code class="option">-i</code> option: 37 38 </p><pre class="screen">> arm-none-eabi-sprite -i</pre><p> 39 40 This prints out a list of supported device types. For devices that 41 can be autodetected, it additionally probes for and prints out a 42 list of attached devices. For instance: 43 44 </p><pre class="screen">Sourcery CodeBench Debug Sprite for ARM 45 (Sourcery CodeBench Lite 2011.09-69) 46armusb: [speed=<n:0-7>] Stellaris USB 47 armusb:///0B01000C - Stellaris Evaluation Board (0B01000C) 48rdi: (rdi-library=<file>&rdi-config=<file>) RDI Device 49 rdi:/// - RDI Device</pre><p> 50 <span> 51 This shows that Stellaris USB and RDI devices are supported. 52 The exact set of supported devices depends on your host system 53 and the version of Sourcery CodeBench you have installed; refer to 54 <a class="xref" href="sec-sprite-invocation.html" title="6.3.�Invoking Sourcery CodeBench Debug Sprite">Section�6.3, “Invoking Sourcery CodeBench Debug Sprite”</a> for complete information. 55 </span> 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 </p><p> 75 Note that it may take several seconds for the Debug Sprite to probe 76 for all types of supported devices. 77 </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sec-cs3-vector-tables.html">Prev</a>�</td><td width="20%" align="center">�</td><td width="40%" align="right">�<a accesskey="n" href="ch06s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.6.�Interrupt Vector Tables�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">�6.2.�Debug Sprite Example</td></tr></table></div></body></html> 78