ARM RealView User Guide

RealView® Development Suite

3.1 版

Eclipse 插件用户指南

ARM DUI 0330BC

RealView Development Suite

Eclipse 插件用户指南

版本信息

本手册进行了以下更改。

更改历史记录

日期发行号保密性更改

2006 年 3 月

2007 年 3 月

非保密 RVDS v3.0 的 1.0 版

非保密 RVDS v3.1 的 2.0 版

所有权声明

除非本所有权声明在下面另有说明，否则带有

或 ™ 标记的词语和徽标是 ARM Limited 在欧洲和其

他国家/地区的注册商标或商标。此处提及的其他品牌和名称可能是其各自所有者的商标。

本文档描述的产品还将不断发展和完善。 ARM 将如实提供本文档所述产品的所有特性及其使用方法。但是，所有暗示或明示的担保，包括但不限于对特定用途适销性或适用性的担保，均不包括在内。

本文档的目的仅在于帮助读者使用产品。对于因使用本文档中的任何信息、文档信息出现任何错误或遗漏或者错误使用产品造成的任何损失或损害，ARM 公司概不负责。

使用 ARM 一词时，它表示“ARM 或其任何相应的子公司”。

保密状态

本文档的内容是非保密的。根据 ARM 与 ARM 将本文档交予的参与方的协议条款，使用、复制和公开本文档内容的权利可能会受到许可限制的制约。

产品状态

本文档的信息是开发的产品的最新信息。

网址

http://www.arm.com

ARM DUI 0330BC

RealView Development Suite 3.1 版 Eclipse 插件用户指南

前言

关于本手册 ..................................................................................................... vi

反馈 .............................................................................................................. viii

第 1 章简介

1.1 关于 RVDS Eclipse 插件 ............................................................................. 1-2

1.2 入门 ............................................................................................................. 1-4

1.3 安装 RVDS Eclipse 插件的软件更新 ........................................................... 1-5

第 2 章创建 ARM 工程

2.1 为 ARM 创建 RVDS 工程 ............................................................................ 2-2

2.2 向工程中添加新文件 .................................................................................... 2-9

2.3 生成工程 .................................................................................................... 2-11

第 3 章导入现有的 Eclipse 工程

3.1 选择并生成现有的 Eclipse 工程 .................................................................. 3-2

ARM DUI 0330BC

iii

第 4 章导入 CodeWarrior 工程

4.1 关于 CodeWarrior 导入程序 ........................................................................ 4-2

4.2 导入 CodeWarrior 工程 ............................................................................... 4-3

第 5 章 ARM 工程类型

5.1 关于 ARM 工程类型 .................................................................................... 5-2

5.2 关于预定义配置 .......................................................................................... 5-3

第 6 章配置生成设置

6.1 访问配置面板 .............................................................................................. 6-2

6.2 访问适用于特定文件的配置面板 ................................................................. 6-4

6.3 配置 RealView 工具 .................................................................................... 6-5

6.4 使用 ARM fromelf 实用程序 ........................................................................ 6-6

6.5 恢复缺省值 .................................................................................................. 6-8

6.6 访问在线帮助 .............................................................................................. 6-9

第 7 章使用 RealView Debugger

7.1 将可执行映像加载到 RealView Debugger 中 .............................................. 7-2

7.2 创建调试配置 .............................................................................................. 7-4

7.3 设置调试配置 .............................................................................................. 7-5

7.4 使用调试配置启动 RealView Debugger ...................................................... 7-8

ARM DUI 0330BC

前言

本前言介绍 RealView Development Suite Eclipse

• 第vi 页的

• 第viii 页的

关于本手册

反馈

插件用户指南

。它包含以下几节：

ARM DUI 0330BC

前言

关于本手册

适用对象

使用本手册

本手册为用户提供有关 RealView Development Suite (RVDS) Eclipse 插件的信息。书中介绍了如何使用 Eclipse

集成开发环境

(IDE) 为 ARM® 目标配置和生成工

程。本手册的目的不是让用户熟悉 Eclipse IDE 的所有方面。

本手册是专门为使用 Eclipse IDE 在 Microsoft Windows（2000和XP）或 Unix 下管理面向 ARM 的开发工程的所有开发人员而编写的。它假定您是一位有经验的软件开发人员，熟悉 ARM 开发工具。它并不要求您熟悉 Eclipse IDE。

本手册由以下章节组成：

第1章

简介

本章简要介绍 RealView Development Suite Eclipse 插件。

创建

ARM

工程

第2章

本章介绍如何创建 ARM 工程。

第3章

导入现有的

Eclipse

工程

本章介绍如何将现有的 Eclipse 工程导入到 Eclipse IDE 中。

导入

第4章

第5章 ARM

CodeWarrior

本章介绍如何将现有的 CodeWarrior

工程类型

工程

工程导入到 Eclipse IDE 中。

本章介绍如何使用 Eclipse IDE 中提供的各种 ARM 工程类型。

第6章

配置生成设置

本章介绍如何配置 ARM RealView 工具，以修改工程的生成方式。

使用

第7章

RealView Debugger

本章介绍如何在 Eclipse 中使用 RealView Debugger。

本手册假定 ARM 软件安装在缺省位置。例如，在 Windows 上，这可能为

:\Program Files\ARM

install_directory\Documentation\...

。引用路径名时，假定该位置为

。如果已将 ARM 软件安装在其他位置，则可

install_directory

卷

。例如，

能需要更改此路径。

ARM DUI 0330BC

印刷约定

前言

本手册使用了以下印刷约定：

斜体

突出显示重要说明，介绍专用术语，表示内部交叉引用和引

文。

粗体突出显示界面元素，如菜单名称。表示 ARM 处理器信号名

称。必要时还用于说明列表中的术语。

有关 RealView Development Suite Eclipse 插件的反馈

如果您对 RVDS Eclipse 插件有任何问题，请与供应商联系。为便于他们快速提供有用的回复，请提供：

• 您的姓名和公司名称。

• 您的 RVDS 产品的序列号和版本号。

(ARM DUI 0181)

(ARM DUI 0153)

词汇表》

(ARM DUI 0324)

）。

viii

• Eclipse C/C++ 开发工具和 RVDS Eclipse 插件的版本号。要获取此版本号，请在 Eclipse 中选择 Help → About Eclipse Platform，然后单击 Plug-in Details。

• 所有已安装组件的详细信息和版本号，如硬件平台、操作系统、GNU make 和 Java 运行时环境。

• 一小段能够重现问题的独立代码示例。

• 您期望发生和实际已经发生的情况的详细说明。

• 您使用的命令，包括所有命令行选项。

• 能说明问题的示例输出。

• 工具的版本字符串，包括版本号和内部版本号。

ARM DUI 0330BC

关于本手册的反馈

前言

如果您对本手册有任何问题，请发送电子邮件至

• 文档标题

• 文档编号

• 您有疑问的页码

• 问题的简要说明

我们还欢迎您对需要增加和改进之处提出建议。

errata@arm.com

，并提供：

ARM DUI 0330BC

前言

ARM DUI 0330BC

第 1 章简介

ARM DUI 0330BC

本手册介绍 RealView Development Suite (RVDS) Eclipse 插件，并说明如何在 Eclipse 中用此插件为 ARM

(IDE)。有关如何使用 Eclipse IDE 的完整说明，请参阅 Eclipse“Help”菜单中

境

的信息或 Eclipse 网站上的在线文档，网址是：

本章介绍 RVDS Eclipse 插件并包含以下内容：

• 第1-2 页的

• 第1-4 页的

• 第1-5 页的

关于入门安装

目标开发软件。本手册并不介绍 Eclipse

http://www.eclipse.org

RVDS Eclipse

插件

插件的软件更新

集成开发环

。

1-1

简介

1.1 关于 RVDS Eclipse 插件

RVDS E clip s e 插件可将 RealView 开发工具集成到 Eclipse IDE 中。利用此插件，软件开发人员可以使用 Eclipse IDE 作为工程管理器，以便为 ARM 目标创建、生成、调试和管理 C、C++ 和汇编语言工程。 Eclipse 插件提供了一系列 ARM 工程类型，可简化 ARM 工程的创建。此外，它还提供了全套配置面板，可用于指定 ARM 编译器、汇编程序、链接器、调试器及其他工具的选项。

1.1.1 使用限制

本节列出使用 Eclipse 时适用的特定限制和特点。

组织工程

工程源文件的建议结构是在工程文件下的子目录中创建它们。如果创建源文件时使用的目录结构高于工程目录，Eclipse 将创建该文件的绝对链接。

打开现有的 Eclipse 工程

您必须使用导入向导。有关详细信息，请参阅第3章

Eclipse

工程

。

导入现有的

CodeWarrior 子工程

不支持 CodeWarrior 子工程。您必须逐个导入每个工程。有关详细信息，请参阅第4章

CodeWarrior

工程

。

导入

工程间的相关性

不支持嵌套工程。每个工程都必须组织为单独的实体。通过引用驻留在工作区中的其他工程，可以设置工程间的相关性。通过在 Eclipse 主菜单中选择 Project → Properties → Project References，可以手动添加引用。

链接顺序使用 Eclipse 时，无法在同一工程内部指定目标文件的链接顺序。

一种解决方法是将目标文件拆分到不同的工程中，然后便可以指定工程的生成顺序。选择 Windows → Preferences... → General →

Workspace → Build Order。

恢复缺省值

恢复工程的缺省值将丢弃不属于工程类型的所有信息。这意味着，在 ARM New Project Wizard 中更改的任何设置都将丢失。

1-2

ARM DUI 0330BC

使用 Eclipse 目标配置启动 RealView Debugger

当使用具有现有 Eclipse 目标配置的工程在 Eclipse 中启动 RealView Debugger 时，可能会显示“RealView Debugger”对话框，如图1-1 所示。单击 No，以使用 Eclipse 中的目标连接属性。

简介

图1-1 “RealView Debugger”对话框

ARM DUI 0330BC

1-3

简介

1.2 入门

1.2.1 RVDS 安装

1.2.2 自定义安装

本节概述使用 Eclipse 所需的各种组件。

RVDS 从 CD 安装 RVDS v3.1 时，将为您安装所有必需的组件，包括

Eclipse。

如果您有 Eclipse 的自定义安装，则在使用 RVDS Eclipse 插件之前，应确保已安装下列组件。

Eclipse 从

http://www.eclipse.org

下载并安装 Eclipse v3.2 或更高版本。

RVDS Eclipse 插件

使用 Eclipse 的软件更新功能安装来自的 RVDS Ecli pse 插件。请参阅第1-5 页的

软件更新

。

http://www.arm.com/eclipse

安装

RVDS Eclipse

插件的

JRE 下载并安装最适合您的平台的 Java 运行时环境 (JRE) 版本。请参阅

http://www.java.com

或

http://www.eclipse.org

。

CDT C 和 C++ 开发工具 (CDT) 是一个可将 C 和 C++ 生成环境集成到

Eclipse IDE 中的插件。必须安装此插件，因为 RealView 工具将插入到 CDT 中。要求使用 CDT v3.1。请安装来自

http://www.eclipse.org

的最新版本的 CDT。

GNU make 要求使用 GNU make v3.80。请安装 MinGW（来自

http://www.mingw.org

）或 Cygwin（来自

http://www.cygwin.com

）。建

议安装 MinGW。

1-4

ARM DUI 0330BC

1.3 安装 RVDS Eclipse 插件的软件更新

注意

如果您是从 CD 安装的 RVDS v3.1，则所有必需的 Eclipse 组件均已安装。

要安装 RVDS Eclipse 插件的最新功能，必须使用 Eclipse 中的软件更新功能。首次使用软件更新功能时，必须创建要从中下载该插件的更新站点：

1. 启动 Eclipse IDE。

2. 选择 Help → Software Updates → Find and Install...。

3. 在 Install/Update 对话框中，选择 Search for new features to install。单击

Next。

4. 您必须创建一个新站点才能找到 Eclipse 插件。在 Install 对话框中，单击 New Remote Site...。

简介

5. 在 New Update Site 对话框中，输入任意名称，例如在URL字段中，输入

http://www.arm.com/eclipse

，然后单击 OK。

Eclipse 插件 for RVDS

。

6. Eclipse 会自动从 Sites to include in search 列表中选择新创建的更新站点。单击 Finish。

7. 在 Updates 对话框中，选择您的 RVDS Eclipse 插件更新站点，然后单击

Next。

8. 阅读 ARM 许可协议并接受它。如果您不接受该许可协议，则无法安装 Eclipse 插件。单击 Next，然后单击 Finish。

9. 在“ Verification”对话框中，单击 Install All。 Eclipse 随即将安装 RVDS Eclipse 插件。

10. Eclipse 会询问您是否要重新启动。单击 Ye s 重新启动 Eclipse。这样便安装

了最新版本的 RVDS Eclipse 插件。

要在以后更新 Eclipse 插件，请按照 Eclipse 插件的安装步骤操作，但不用创建新的远程站点。此过程还可以用于安装其他插件。

您可以在 Preferences 面板中启用自动更新。要显示“Preferences”面板，请在 Eclipse 主菜单中选择 Window → Preferences...。

ARM DUI 0330BC

1-5

简介

1-6

ARM DUI 0330BC

第 2 章创建 ARM 工程

可以使用 Eclipse 为 ARM 目标创建 RVDS 工程。 Eclipse 会为 RVDS 工程生成相应的 makefile。此外，您还可以创建托管生成和标准生成工程。有关详细信息，请参阅 Eclipse 帮助中的

本章介绍如何为 ARM 创建新的 RVD S 工程。它包含以下几节：

• 第2-2 页的

• 第2-9 页的

• 第2-11 页的

《

C/C++

为

ARM

创建

向工程中添加新文件

生成工程

开发用户指南》

RVDS

。

工程

ARM DUI 0330BC

2-1

创建

注意

ARM 工程

2.1 为 ARM 创建 RVDS 工程

您可以使用随 RVDS 提供的任何工程类型创建新的 ARM 工程。本节介绍如何创建新的可执行 (ARM) 工程：

1. 启动 Eclipse IDE。

2. 在 Eclipse 主菜单中，选择 File → New → RVDS Project for ARM（请参阅图2-1）。

2-2

图2-1 创建新的 ARM 工程

ARM 的 RVDS 工程集托管生成 C 工程与托管生成 C++ 工程的功能于一

身。同一个工程中可以同时存在

.c、.cpp

和 .s 文件。

3. 输入工程的名称，请参阅第2-3 页的图2-2。

ARM DUI 0330BC

+ 42 hidden pages

ARM RealView User Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

关于本手册

适用对象

使用本手册

更多参考出版物

有关 RealView Development Suite Eclipse 插件的反馈

关于本手册的反馈

1.1 关于 RVDS Eclipse 插件

1.1.1 使用限制

1.2 入门

1.2.1 RVDS 安装

1.2.2 自定义安装

1.3 安装 RVDS Eclipse 插件的软件更新

2.1 为 ARM 创建 RVDS 工程