ARM Eclipse Plug-in User Manual

0 (0)

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 ® or ™ are registered trademarks or trademarks of ARM Limited in the EU and 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.

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

ARM DUI 0330A

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

ARM DUI 0330A

iii

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

ARM DUI 0330A

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.

ARM DUI 0330A

Preface

About 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.

Intended audience

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.

Using this book

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.

ARM DUI 0330A

Preface

Chapter 7 Importing a CodeWarrior Project

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

Typographical conventions

The following typographical conventions are used in this book:

italic	Highlights important notes, introduces special terminology,
	denotes internal cross-references, and citations.
bold	Highlights interface elements, such as menu names. Denotes
	ARM processor signal names. Also used for terms in descriptive
	lists, where appropriate.
monospace	Denotes text that can be entered at the keyboard, such as
	commands, file and program names, and source code.
monospace	Denotes a permitted abbreviation for a command or option. The
	underlined text can be entered instead of the full command or
	option name.
monospace italic	Denotes arguments to commands and functions where the
	argument is to be replaced by a specific value.
monospace bold	Denotes language keywords when used outside example code.

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

•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.

ARM DUI 0330A

Preface

ARM DUI 0330A

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® targets. This book does 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 (http://www.eclipse.org). This chapter introduces the Eclipse Plug-in 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.

ARM DUI 0330A

1-1

Introduction

1.1About 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

ARM DUI 0330A

Introduction

1.2Getting started

Ensure that the following components are installed before beginning.

Eclipse platform

Download and install Eclipse v3.1 or later. See

http://www.eclipse.org/downloads.

JRE	Download and install the version of Java Runtime Environment (JRE)
	that works best on your platform. See http://www.java.com or
	http://www.eclipse.org/downloads.
CDT	The C and C++ Development Tool (CDT) is a plug-in that integrates the
	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.

Eclipse Plug-in for RVDS

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.

ARM DUI 0330A

1-3

Introduction

1.3Installing 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 Plug-in for RVDS. In the URL field enter http://www.arm.com/eclipse and click OK.

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 Yes 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.

1-4

ARM DUI 0330A

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.

ARM DUI 0330A

2-1

Creating an ARM Project

2.1Creating 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 .c files and .cpp files 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.

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).

2-2

ARM DUI 0330A

+ 36 hidden pages

ARM Eclipse Plug-in 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.2Getting started

Creating an ARM Project

2.1Creating a new ARM project