ARM Eclipse Plug-in User Manual

Eclipse Plug-in for RealView

Development Suite

Version 1.0

User Guide

ARM DUI 0330A

Eclipse Plug-in for RealView Development Suite

User Guide

Release Information

The following changes have been made to this book.

Change History

Date Issue Confidentiality Change

March 2006 A Non-Confidential First release for Eclipse Plug-in v1.0 for RVDS

Proprietary Notice

Words and logos marked with 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.

or ™ are registered trademarks or trademarks of ARM Limited in the EU and

This document is intended only to assist the reader in the use of the product. ARM Limited 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.

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.

Web Address

http://www.arm.com

Eclipse Plug-in for RealView Development Suite User Guide

Preface

About this book .............................................................................................. vi

Feedback ....................................................................................................... ix

Chapter 1 Introduction

1.1 About the Eclipse Plug-in for RVDS ............................................................ 1-2

1.2 Getting started ............................................................................................ 1-3

1.3 Installing the Eclipse Plug-in for RVDS ....................................................... 1-4

Chapter 2 Creating an ARM Project

2.1 Creating a new ARM project ....................................................................... 2-2

2.2 Adding files to the project ............................................................................ 2-4

2.3 Building the project ..................................................................................... 2-5

Chapter 3 ARM Project Types

3.1 About the ARM project types ...................................................................... 3-2

3.2 About the predefined configurations ........................................................... 3-4

Chapter 4 Configuring the Build Settings

4.1 Accessing configuration panels .................................................................. 4-2

Contents

4.2 Accessing configuration panels for a specific file ....................................... 4-4

4.3 Configuring the RealView tools .................................................................. 4-5

4.4 Using the ARM fromelf utility ...................................................................... 4-6

4.5 Restoring defaults ....................................................................................... 4-8

4.6 Accessing online help ................................................................................. 4-9

Chapter 5 Creating an ARM Thumb Interworking Image

5.1 Creating an ARM Thumb interworking project ............................................ 5-2

5.2 Importing files into the project ..................................................................... 5-3

5.3 Building the interworking image .................................................................. 5-4

Chapter 6 Working with RealView Debugger

6.1 Loading your executable image into RealView Debugger .......................... 6-2

6.2 Creating your debug configuration ............................................................. 6-3

6.3 Setting up your debug configuration ........................................................... 6-4

6.4 Launching RealView Debugger using your debug configuration ................ 6-7

Chapter 7 Importing a CodeWarrior Project

7.1 About the CodeWarrior importer ................................................................. 7-2

7.2 Importing a CodeWarrior project ................................................................ 7-3

Preface

This preface introduces the Eclipse Plug-in for RealView® Development Suite User Guide. It contains the following sections:

• About this book on page vi

• Feedback on page ix.

Preface

About this book

Intended audience

Using this book

This book provides user information on the Eclipse Plug-in for RealView Development Suite (RVDS). It describes how to use the Eclipse Integrated Development Environment

(IDE) to configure and build projects for ARM

targets. This book is not intended to

familiarize the user with all aspects of the Eclipse IDE.

This book is written for all developers who are using the Eclipse IDE to manage their ARM-targeted development projects under Microsoft Windows (2000, XP), Red Hat Linux or Sun Solaris (9, 10). It assumes that you are an experienced software developer, and that you are familiar with the ARM development tools. It does not assume that you are familiar with the Eclipse IDE.

This book is organized into the following chapters:

Chapter 1 Introduction

Read this chapter for an introduction to the Eclipse Plug-in for RealView Development Suite.

Chapter 2 Creating an ARM Project

Read this chapter for a tutorial on creating an ARM project.

Chapter 3 ARM Project Types

Read this chapter for information about using different kinds of ARM project types provided within the Eclipse IDE.

Chapter 4 Configuring the Build Settings

Read this chapter for information on how to configure the ARM RealView tools, to modify how your project is built.

Chapter 5 Creating an ARM Thumb Interworking Image

Read this chapter for a tutorial on creating an ARM Thumb

interworking

image.

Chapter 6 Working with RealView Debugger

Read this chapter for information on how to use the ARM RealView Debugger from Eclipse.

Chapter 7 Importing a CodeWarrior Project

Typographical conventions

The following typographical conventions are used in this book:

italic Highlights important notes, introduces special terminology,

bold Highlights interface elements, such as menu names. Denotes

Preface

Read this chapter for information on importing existing CodeWarrior projects into the Eclipse IDE.

denotes internal cross-references, and citations.

ARM processor signal names. Also used for terms in descriptive lists, where appropriate.

Feedback

ARM Limited welcomes feedback on both the Eclipse plug-in for RVDS, and its documentation.

Feedback on the Eclipse Plug-in for RealView Development Suite

If you have any problems with the Eclipse Plug-in for RVDS, please contact your supplier. To help them provide a rapid and useful response, please give:

• your name and company

• the serial number of the RVDS product

• details of the RVDS release you are using

• the version numbers of the Eclipse C/C++ Development Tools, and The Eclipse

Plug-in for RealView Development Suite (to obtain this, in Eclipse, select Help → About Eclipse Platform, and then click Plug-in Details)

• details of the platform you are running on, such as the hardware platform, operating system type and version

• a small standalone sample of code that reproduces the problem

Preface

• a clear explanation of what you expected to happen, and what actually happened

• the commands you used, including any command-line options

• sample output illustrating the problem

• the version string of the tools, including the version number and build numbers.

Feedback on this book

If you have any problems with this book, please send email to

errata@arm.com

giving:

• the document title

• the document number

• the page number(s) to which your comments apply

• a concise explanation of the problem.

General suggestions for additions and improvements are also welcome.

Preface

Chapter 1

Introduction

This book describes the Eclipse Plug-in for RealView® Development Suite (RVDS), and how you can use it within Eclipse to develop software for ARM not describe the Eclipse Integrated Development Environment (IDE). For a complete description on how to use the Eclipse IDE, refer to the documentation available on the Eclipse website ( for RVDS. It contains the following sections:

• About the Eclipse Plug-in for RVDS on page 1-2

• Getting started on page 1-3

• Installing the Eclipse Plug-in for RVDS on page 1-4.

http://www.eclipse.org

). This chapter introduces the Eclipse Plug-in

targets. This book does

Introduction

1.1 About the Eclipse Plug-in for RVDS

The Eclipse Plug-in for RVDS integrates the RealView development tools into the Eclipse IDE. It enables software developers to use the Eclipse IDE as a project manager to create, build, debug, and manage C and C++ projects for ARM targets. The plug-in provides ARM project types to simplify the creation of ARM projects, and provides comprehensive configuration panels to specify options for the ARM compiler, assembler, linker, debugger, and other tools.

1.2 Getting started

Ensure that the following components are installed before beginning.

Eclipse platform

JRE Download and install the version of Java Runtime Environment (JRE)

CDT The C and C++ Development Tool (CDT) is a plug-in that integrates the

Eclipse Plug-in for RVDS

Introduction

Download and install Eclipse v3.1 or later. See

http://www.eclipse.org/downloads

that works best on your platform. See

http://www.eclipse.org/downloads

http://www.java.com

C and C++ build environment into the Eclipse IDE. This must be installed because the RealView tools plug into the CDT. CDT v3.0 or higher is required. For installing CDT v3.0, use the update site

http://download.eclipse.org/tools/cdt/releases/eclipse3.1

, and follow the procedure described in Installing the Eclipse Plug-in for RVDS on page 1-4.

Use the Software Updates feature of Eclipse to install the Eclipse Plug-in for RVDS, from

http://www.arm.com/eclipse

. See Installing the Eclipse

Plug-in for RVDS on page 1-4.

GNU make GNU make v3.80 is required and can be obtained by installing MinGW

(see

http://www.mingw.org

) or Cygwin (see

http://www.cygwin.com

MinGW is recommended.

RVDS Install RealView Development Suite (RVDS) v3.0.

Introduction

1.3 Installing the Eclipse Plug-in for RVDS

You must use the Software Updates feature in Eclipse to install the Eclipse Plug-in for RVDS. The first time you use the Software Updates feature to install the Eclipse Plug-in for RVDS, you must create an update site to download the plug-in from:

1. Launch the Eclipse IDE.

2. Select Help → Software Updates → Find and Install...

3. From the Install/Update dialog, select Search for new features to install. Click Next.

4. You must create a new site to locate the plug-in. In the Install dialog box, click

New Remote Site...

5. In the New Update Site dialog box, enter any name, for example

RVDS

. In the URL field enter

http://www.arm.com/eclipse

and click OK.

Plug-in for

6. Eclipse automatically selects your newly created update site from the list of Sites to include in search. Click Finish.

7. In the Updates dialog box, select your plug-in for RVDS update site, and click Next.

8. Read the ARM license agreement and accept it. If you do not accept the license agreement, you cannot install the plug-in. Click Next, and then click Finish.

9. In the Verification dialog box, click Install All. Eclipse installs the Eclipse Plug-in for RVDS.

10. Eclipse requests your permission to restart. Click Ye s to restart Eclipse. The Eclipse Plug-in for RVDS has been installed.

To update the plug-in, in the future, follow the same steps as for installing the plug-in, without creating a new remote site. The same procedure can be used to install other plug-ins.

Note

You can enable automatic updates in the Preferences panel. To display the preferences panel, select Window → Preferences... from the Eclipse main menu.

Chapter 2

Creating an ARM Project

You can use Eclipse to create Managed Make projects for ARM® targets. Eclipse generates appropriate makefiles for your Managed Make projects. You can also create Standard Make projects, for which you must create your own makefile. For more information on creating a Standard Make project, see the C/C++ Development User Guide in Eclipse Help. This chapter describes how to create a new Managed Make ARM project in Eclipse. It contains the following sections:

• Creating a new ARM project on page 2-2

• Adding files to the project on page 2-4

• Building the project on page 2-5.

Creating an ARM Project

2.1 Creating a new ARM project

You can create ARM projects using any of the ARM project types. This section describes how to create a new Executable (ARM) project:

1. Launch the Eclipse IDE.

2. Select File → New → Project from the Eclipse main menu.

3. In the New Project window, expand the C folder.

4. Select the Managed Make C Project and click Next.

Note

For ARM projects, there is no difference between creating a Managed Make C

Project and a Managed Make C++ Project. You can have

within the same project.

5. Enter a name for the project.

6. Leave the Use Default option selected so that the project is created in the default directory shown. Alternatively, deselect the Use Default option and enter a directory for the contents of the new project.

files and

.cpp

files

7. By default, Eclipse selects a GNU project type. So click Next to select an ARM project type.

8. From the Project Type drop-down menu, select Executable (ARM) (Figure 2-1 on page 2-3).

+ 36 hidden pages

ARM Eclipse Plug-in User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Preface

About this book

Intended audience

Using this book

Further reading

Feedback

Feedback on the Eclipse Plug-in for RealView Development Suite

Feedback on this book

Introduction

1.1 About the Eclipse Plug-in for RVDS

1.2 Getting started

1.3 Installing the Eclipse Plug-in for RVDS

Creating an ARM Project

2.1 Creating a new ARM project