2.1. Building and debugging task overview

Table 2.1 is a high-level procedure showing the main tasks for building and debugging applications with the RVDS tools, and where to find the information.

The tasks referred to in the referenced documentation are not necessarily described in the order presented in Table 2.1. If you are using the RealView tools for the first time, it is suggested that you work through the tasks in the order described in the referenced documents. The sequence presented in Table 2.1 reflects the order in which the tasks might usually be performed.

Table 2.1. Main building and debugging tasks  

StepDescriptionReference
1

The steps to follow depend on whether or not the image you want to debug already exists:

  • To debug an existing image, such as dhrystone.axf from the RVDS examples, continue at step 9.

  • To debug an image that has not yet been built, and you want to use the RVDS tools to build the image, continue at step 2.

    Alternatively, use the build tools of your choice to build your image, then continue at step 9 to debug that image.

Using the example projects

2

Choose the RVDS application you want to use to manage and build your projects:

  • To use the ARM Workbench IDE, continue at step 4.

  • To build from your system command-line using the ARM Compiler toolchain, continue at step 3.

 
3

If you want to use the ARM Compiler toolchain directly, then create makefiles or command files for your platform that contain the required build commands.

Continue at step 9 to load and debug your image in RealView Debugger.

ARM® Compiler toolchain Introducing the ARM® Compiler toolchain

ARM® Compiler toolchain Developing Software for ARM® Processors

ARM® Compiler toolchain Building Linux Applications with ARM® Compiler toolchain and GNU Libraries

ARM® Compiler toolchain Using the Compiler

ARM® Compiler toolchain Compiler Reference

ARM® Compiler toolchain Using ARM® C and C++ Libraries and Floating-Point Support

ARM® Compiler toolchain ARM® C and C++ Libraries and Floating-Point Support Reference

ARM® Compiler toolchain Using the Assembler

ARM® Compiler toolchain Assembler Reference

ARM® Compiler toolchain Using the Linker

ARM® Compiler toolchain Linker Reference

ARM® Compiler toolchain Creating Static Software Libraries with armar

ARM® Compiler toolchain Using the fromelf Image Converter

ARM® Compiler toolchain Errors and Warnings Reference

4

Start the ARM Workbench IDE.

ARM® Workbench IDE User Guide

5

If an ARM Workbench IDE project already exists, continue at step 7. Otherwise, create an ARM Workbench IDE project for your application.

ARM® Workbench IDE User Guide
6

Set up the build configuration settings as required to build the image for your application. Continue at step 8.

ARM® Workbench IDE User Guide

7Open the existing ARM Workbench IDE project.

ARM® Workbench IDE User Guide

8

Build the image for the ARM Workbench IDE project.

ARM® Workbench IDE User Guide

9

Start RealView Debugger.

RealView® Debugger Essentials Guide
10Configure your debug target and connections as required.

RealView® Debugger User Guide

RealView® Debugger Target Configuration Guide

ARM DSTREAM and RVI Using the Debug Hardware Configuration Utilities

11Connect to your debug target.

RealView® Debugger Essentials Guide

RealView® Debugger User Guide

12Load the image ready for debugging.

RealView® Debugger Essentials Guide

RealView® Debugger User Guide

13Prepare any debugging facilities, such as breakpoints and tracepoints.

RealView® Debugger Essentials Guide

RealView® Debugger User Guide

RealView® Debugger Trace User Guide

RealView® Debugger RTOS Guide

14Run the image.

RealView® Debugger Essentials Guide

RealView® Debugger User Guide

15Perform the required debugging and monitoring tasks, such as stepping, and displaying contents of variables and memory. If using tracepoints, use the trace analysis facilities of RealView Debugger to analyze the trace output.

RealView® Debugger Essentials Guide

RealView® Debugger User Guide

RealView® Debugger Trace User Guide

RealView® Debugger RTOS Guide

16

What is the result of the debugging session?

  • If there are problems, continue at step 17.

  • If there are no problems, rebuild your image for final release.

ARM® Workbench IDE User Guide

ARM® Compiler toolchain Introducing the ARM® Compiler toolchain

17

Decide how to fix any problems in your source code:

  • use the ARM Workbench IDE

  • use another source editor of your choice.

ARM® Workbench IDE User Guide

18

When you have fixed the problem, then you must rebuild, reload, and debug the image:

  • if you are using the ARM Workbench IDE, then return to step 8

  • if you are using the ARM Compiler toolchain directly, then return to step 3.

 

Copyright © 2003-2011 ARM. All rights reserved.ARM DUI 0255M
Non-Confidential