paper 136：ARM ADS集成开发环境的使用（新版）

[转载]：http://blog.csdn.net/yhmhappy2006/article/details/1673203

ARM ADS集成开发环境的使用

在这里，将介绍ARM开发软件ADS(ARM Developer Suite)。通过学习如何在CodeWarrior IDE集成开发环境下编写，编译一个工程的例子，使读者能够掌握在ADS软件平台下开发用户应用程序。本章还描述了如何使用AXD调试工程，使读者对于调试工程有个初步的理解，为进一步的使用和掌握调试工具起到抛砖引玉的作用。

本章主要内容有：

－ ADS软件组成介绍

－ 使用ADS创建工程

－ 用AXD进行代码调试

8.1    ADS集成开发环境组成介绍

ARM ADS全称为ARM Developer Suite。是ARM公司推出的新一代ARM集成开发工具。现在ADS的最新版本是1.2，它取代了早期的ADS1.1和ADS1.0。它除了可以安装在Windows NT4，Windows 2000，Windows 98和Windows 95操作系统下，还支持Windows XP和Windows Me操作系统。

ADS由命令行开发工具，ARM时实库，GUI开发环境(Code Warrior和AXD)，实用程序和支持软件组成。 有了这些部件，用户就可以为ARM系列的RISC处理器编写和调试自己的开发应用程序了。

下面就详细介绍一下ADS的各个组成部分。

8.1.1    命令行开发工具

这些工具完成将源代码编译，链接成可执行代码的功能。

ADS提供下面的命令行开发工具：

armcc

armcc是ARM C编译器。这个编译器通过了Plum Hall C Validation Suite为ANSI C的一致性测试。armcc用于将用ANSI C编写的程序编译成32位ARM指令代码。

因为armcc是我们最常用的编译器，所以对此作一个详细的介绍。

在命令控制台环境下，输入命令：

armcc –help

可以查看armcc的语法格式以及最常用的一些操作选项

armcc最基本的用法为：     armcc [options] file1 file2 ... filen

这里的option是编译器所需要的选项，fiel1,file2…filen是相关的文件名。

这里简单介绍一些最常用的操作选项。

-c：表示只进行编译不链接文件；

-C：(注意：这是大写的C)禁止预编译器将注释行移走；

-D<symbol>：定义预处理宏，相当于在源程序开头使用了宏定义语句#define symbol ，

这里symbol默认为1；

-E：仅仅是对C源代码进行预处理就停止；

-g<options>：指定是否在生成的目标文件中包含调试信息表；

-I<directory>：将directory所指的路径添加到#include的搜索路径列表中去； -J<directory>：      用directory所指的路径代替默认的对#include的搜索路径；

-o<file>：指定编译器最终生成的输出文件名。

-O0：不优化；

-O1：这是控制代码优化的编译选项，大写字母O后面跟的数字不同，表示的优化级别就不 同，-O1关闭了影响调试结果的优化功能；

-O2：该优化级别提供了最大的优化功能；

-S：对源程序进行预处理和编译，自动生成汇编文件而不是目标文件；

-U<symbol>：取消预处理宏名，相当于在源文件开头，使用语句#undef symbol;

-W<options>：关闭所有的或被选择的警告信息；

有关更详细的选项说明，读者可查看ADS软件的在线帮助文件。

armcpp

armcpp是ARM C++编译器。它将ISO C++ 或EC++ 编译成32位ARM指令代码。

tcc

tcc是Thumb C 编译器。该编译器通过了Plum Hall C Validation Suite为ANSI 一致性的测试。tcc将ANSI C源代码编译成16位的Thumb指令代码。

tcpp

tcpp是Thumb C++ 编译器。 它将ISO C++ 和EC++ 源码编译成16位Thumb指令代码。

armasm

armasm是ARM和Thumb的汇编器. 它对用ARM 汇编语言和Thumb 汇编语言写的源代码进行汇编。

armlink

armlink是ARM连接器。该命令既可以将编译得到的一个或多个目标文件和相关的一个或多个库文件进行链接，生成一个可执行文件，也可以将多个目标文件部分链接成一个目标文件，以供进一步的链接。ARM链接器生成的是ELF格式的可执行映像文件。

armsd

armsd是ARM 和Thumb的符号调试器。它能够进行源码级的程序调试。用户可以在用C或汇编语言写的代码中进行单步调试，设置断点，查看变量值和内存单元的内容。

8.1.1.1    armcc用法详解

下面为读者介绍上述的4种ARM C和C++编译器的命令通用语法。

compiler [PCS-options] [source-language] [search-paths] [preprocessor-options] [output-format] [target-options] [debug-options] [code-generation-options] [warning-options] [additional-checks] [error-options] [source]

用户可以通过命令行操作选项控制编译器的执行。所有的选项都是以符号”-”开始，有些选项后面还跟有参数。在大多数情况下，ARM C和 C++编译器允许在选项和参数之间存在空格。

命令行中各个选项出现顺序可以任意。

这里的compiler是指armcc，tcc， armcpp和 tcpp中的一个；

PCS-options：指定了要使用的过程调用标准；

source-language：指定了编译器可以接受的编写源程序的语言种类。对于C编译器默认的语 言是ANSI C，对于C++编译器默认是ISO标准C++；

search-paths：该选项指定了对包含的文件(包括源文件和头文件)的搜索路径；

preprocessor-options：该选项指定了预处理器的行为，其中包括预处理器的输出和宏定义等         特性；

output-format：该选项指定了编译器的输出格式，可以使用该项生成汇编语言输出列表文件 和目标文件；

target-options：该选项指定目标处理器或ARM体系结构；

debug-options：该选项指定调试信息表是否生成，和该调试信息表生成时的格式；

code-generation-options：该选项指定了例如优化，字节顺序和由编译器产生的数据对齐格式 等选项；

warning-options：该选项决定警告信息是否产生；

additional-checks：该选项指定了几个能用于源码的附加检查，例如检查数据流异常，检查    没有使用的声明等；

error-options：该选项可以关闭指定的可恢复的错误，或者将一些指定的错误降级为警告；

source：该选项提供了包含有C或C++源代码的一个或多个文件名，默认的，编译器在当前 路径寻找源文件和创建输出文件。如果源文件是用汇编语言编写的(也就是说该文件的             文件名是以.s作为扩展名)，汇编器将被调用来处理这些源文件。

如果操作系统对命令行的长度有限制，可以使用下面的操作，从文件中读取另外的命令行选项：

-via filename

该命令打开文件名为filename的文件，并从中读取命令行选项。用户可以对-via进行嵌套调用，亦即，在文件filename中又通过-via finlename2包含了另外一个文件。

在下面的例子中，从input.txt文件中读取指定的选项，作为armcpp的操作选项：

armcpp -via input.txt    source.c

以上是对编译器选项的一个简单概述。它们(包括后面还要介绍的其他一些命令工具)既可以在命令控制台环境下使用，同时由于它们被嵌入到了ADS的图形界面中，所以也可以在图形界面下使用。

8.1.1.2    armlink用法详解

在介绍armlink的使用方法之前，先介绍要涉及到的一些术语。

映像文件(image)：是指一个可执行文件，在执行的时候被加载到处理器中。一个映像文件有多个线程。它是ELF(Executable and linking format)格式的。

段(Section)：描述映像文件的代码或数据块。

RO：是Read-only的简写形式。

RW：是Read-write.的简写形式。

ZI：是Zero-initialized的简写形式。

输入段(input section)：它包含着代码，初始化数据或描述了在应用程序运行之前必须要初始化为0的一段内存。

输出段(output section)：它包含了一系列具有相同的RO，RW或ZI属性的输入段。

域(Regions)：在一个映像文件中，一个域包含了1至3个输出段。多个域组织在一起，就构成了最终的映像文件。

Read Only Position Independent(ROPI)：它是指一个段，在这个段中代码和只读数据的地址在运行时候可以改变。

Read Write Position Independent(RWPI)：它是指一个段，在该段中的可读/写的数据地址在运行期间可以改变。

加载时地址：是指映像文件位于存储器(在该映像文件没有运行时)中的地址。

运行时地址：是指映像文件在运行时的地址。

下面介绍一下armlink命令的语法

完整的连接器命令语法如下：

armlink [-help] [-vsn] [-partial] [-output file] [-elf] [-reloc][-ro-base address] [-ropi]

[-rw-base address] [-rwpi] [-split]

[-scatter file][-debug|-nodebug][-remove?RO/RW/ZI/DBG]|-noremove] [-entry location ]

[-keep section-id] [-first section-id] [-last section-id] [-libpath pathlist] [-scanlib|-noscanlib] [-locals|-nolocals] [-callgraph] [-info topics] [-map] [-symbols] [-symdefs file] [-edit file] [-xref] [-xreffrom object(section)] [-xrefto object(section)] [-errors file] [-list file] [-verbose]

[-unmangled |-mangled] [-match crossmangled][-via file] [-strict]

[-unresolved symbol][-MI|-LI|-BI] [input-file-list]

上面各选项的含义分别为：

-help

这个选项会列出在命令行中常用的一些选项操作。

-vsn

这个选项显示出所用的armlink的版本信息。

-partial

用这个选项创建的是部分链接的目标文件而不是可执行映像文件。

-output file

这个选项指定了输出文件名，该文件可能是部分链接的目标文件，也可能是可执行映像文件。如果输出文件名没有特别指定的话，armlink将使用下面的默认：

如果输出是一个可执行映像文件，则生成的输出文件名为__image.axf；

如果输出是一个部分链接的目标文件，在生成的文件名为__object.o；

如果没有指定输出文件的路径信息，则输出文件就在当前目录下生成。如果指定了路径信息，则所指定的路径成为输出文件的当前路径。

-elf

这个选项生成ELF格式的映像文件，这也是armlink所支持的唯一的一种输出格式，这是默认选项。

-reloc

这个选项生成可重定址的映像。

一个可重定址的映像具有动态的段，这个段中包含可重定址信息，利用这些信息可以在链接后，进行映像文件的重新定址；

-reloc，-rw-base 一起使用，但是如果没有-split选项，链接时会产生错误。

-ro-base address

这个选项将包含有RO(Read-Only属性)输出段的加载地址和运行地址设置为address，该地址必须是字对齐的，如果没有指定这个选项，则默认的RO基地址值为0x8000。

-ropi

这个选项使得包含有RO输出段的加载域和运行域是位置无关的。如果该选项没有使用，则相应的域被标记为绝对的。通常每一个只读属性的输入段必须是只读位置无关的。如果使用了这个选项，armlink将会进行以下操作：

检查各段之间的重定址是否有效；

确保任何由armlink自身生成的代码是只读位置无关的。

这里希望读者注意的是，ARM工具直到armlink完成了对输入段的处理后，才能够决定最终的生成映像是否为只读位置无关的。这就意味着 ，即使为编译器和汇编器指定了ROPI选项，armlink也可能会产生ROPI错误信息。

-rw-base address

这个选项设置包含RW(Read/Write属性)输出段的域的运行时地址，该地址必须是字对齐的。

如果这个选项和-split选项一起使用，将设置包含RW输出段的域的加载和运行时地址都设置在address处。

-rwpi

这个选项使得包含有RW和ZI(Zero Initialization，初始化为0)属性的输出段的加载和运行时域为位置无关的。如果该选项没有使用，相应域标记为绝对的。这个选项要求-rw-base选项后有值，如果-rw-base没有指定的话，默认其值为0，即相当于-rw-base 0。通常每一个可写的输入段必须是可读/ 可写的位置无关的。

如果使用了该选项，armlink会进行以下的操作：

检查可读/可写属性的运行域的输入段是否设置了位置无关属性；

检查在各段之间的重定址是否有效；

生成基于静态寄存器sb的条目，这些在RO和RW域被拷贝和初始化的时候会用到。

编译器并不会强制可写的数据一定要为位置无关的，这就是说，即使在为编译器和汇编器指定了RWPI选项，armlink也可能生成数据不是RWPI的信息。

-split

这个选项将包含RO和RW属性的输出段的加载域，分割成2个加载域。一个是包含RO输出段的加载域，默认的加载地址为0x8000，但是可以用-ro-base选项设置其他的地址值，另一个加载域包含RO属性的输出段，由-rw-base选项指定加载地址，如果没有使用-rw-base选项的话，默认使用的是-rw-base 0。

-scatter file

这个选项使用在file中包含的分组和定位信息来创建映像内存映射。

注意，如果使用了该选项的话，必须要重新实现堆栈初始化函数__user_initial_stackheap()。

-debug

这个选项使输出文件包含调试信息，调试信息包括，调试输入段，符号和字符串表。这是默认的选项。

-nodebug

这个选项使得在输出文件中不包含调试信息。生成的映像文件短小，但是不能进行源码级的调试。armlink对在输入的目标文件和库函数中发现的任何调试输入段都不予处理，当加载映像文件到调试器中的时候，也不包含符号和字符串信息表。这个选项仅仅是对装载到调试器的映像文件的大小有影响，但是对要下载到目标板上的二进制代码的大小没有任何影响。

如果用armlink进行部分链接生成目标文件而不是映像文件，则虽然在生成的目标文件中不含有调试输入段，但是会包含符号和字符串信息表。

这里特别请读者注意的是：

如果要在链接完成后使用fromELF工具的话，不可使用-nodebug选项，这是因为如果生成的映像文件中不包含调试信息的话，则有下面的影响：

fromELF不能将映像文件转换成其他格式的文件；

fromELF不能生成有意义的反汇编列表。

-remove (RO/RW/ZI/DBG)

使用这个选项会将在输入段未使用的段从映像文件中删除。如果输入段中含有映像文件入口点或者该输入段被一个使用的段所引用，则这样的输入段会当作已使用的段。

在使用这个选项时候要注意，不要删除异常处理函数。使用-keep选项来标识异常处理函数，或用ENTRY伪指令标明是入口点。

为了更精确的控制删除未使用的段，可以使用段属性限制符。可以使用以下的段属性限制符：

RO

删除所有未使用的RO属性的段；

RW

删除所有未使用的RW属性的段；

ZI

删除所有未使用的ZI属性的段；

DBG

删除所有未使用的DEBUG属性的段。

这些限制符出现的顺序是任意的，但是它们必须要有”( )”括住，多个限制符之间要用符号”/”进行间隔。ADS软件中默认选项是-remove (RO/RW/ZI/DBG)。

如果没有指定段属性限制符，则所有未使用的段都会被删除。因为-remove就等价于-remove(RO/RW/ZI/DBG)选项。

-noremove

这个选项保留映像文件中所有未被使用的段。

-entry location

这个选项指定映像文件中唯一的初始化入口点。一个映像文件可以包含多个入口点，使用这个命令定义的初始化入口点是存放在可执行文件的头部，以供加载程序加载时使用。当一个映像文件被装载时，ARM调试器使用这个入口点地址来初始化PC指针。初始化入口点必须满足下面的条件：

映像文件的入口点必须位于运行域内；

运行域必须是非覆盖的，并且必须是固定域(就是说，加载域和运行域的地址相同)。

在这里可以用以下的参数代替location参数：

1.    入口点地址：这是一个数值，例如-entry 0x0；

2.    符号：该选项指定映像文件的入口点为该符号所代表的地址处，比如：

-entry int_handler

表示程序入口点在符号int_handler所在处。

如果该符号有多处定义存在，armlink将产生出错信息。

offset+object(section)：该选项指定在某个目标文件的段的内部的某个偏移量处为映像文件的入口地址，例如：

-entry 8+startup(startupseg)

如果偏移量值为0，可以简写成object(section)，如果输入段只有一个，则可以简化为object。

-keep section-id

使用该选项，可以指定保留一个输入段，这样的话，即使该输入段没有在映像文件中使用，也不会被删除。参数section-id取下面一些格式：

1． symbol

该选项指定定义symbol的输入段不会在删除未使用的段时被删除。如果映像文件中有多处symbol定义存在，则所有包含symbol定义的输入段都不会被删除。例如：

-keep int_handler

则所有定义int_handler的符号的段都会保留，而不被删除。

为了保留所有含有以_handler结尾的符号的段，可以使用如下的选项：

-keep *_handler

2． object(section)

这个选项指定了在删除未使用段时，保留目标文件中的section段。输入段和目标名是不区分大小写的，例如，为了在目标文件vectors.o中保留vect段，使用：

-keep vectors.o(vect)

为了保留vectors.o中的所有以vec开头的段名，可以使用选项：

-keep vectors.o(vec*)

3． object

这个选项指定在删除未使用段时，保留该目标文件唯一的输入段。目标名是不区分大小写的，如果使用这个选项的时候，目标文件中所含的输入段不止一个的话，armlink会给出出错信息。比如，为了保留每一个以dsp开头的只含有唯一输入段的目标文件，可以使用如下的选项：

-keep dsp*.o

-first section-id

这个选项将被选择的输入段放在运行域的开始。通过该选项，将包含复位和中断向量地址的段放置在映像文件的开始，可以用下面的参数代替section-id:

1．symbol

选择定义symbol的段。禁止指定在多处定义的symbol，因为多个段不能同时放在映像文件的开始。

2．object(section)

从目标文件中选择段放在映像文件的开始位置。在目标文件和括号之间不允许存在空格，例如

-first init.o(init)

3．object

选择只有一个输入段的目标文件。如果这个目标文件包含多个输入段，armlink会产生错误信息。用这个选项的例子如下：

-first init.o

这里希望读者注意的是：

使用-first不能改变在域中按照RO段放在开始，接着放置RW段，最后放置ZI段的基本属性排放顺序。如果一个域含有RO段，则RW或ZI段就不能放在映像文件的开头。类似地，如果一个域有RO或RW段，则ZI段就不能放在文件开头。

两个不同的段不能放在同一个运行时域的开头，所以使用该选项的时候只允许将一个段放在映像文件的开头。

-last section-id

这个选项将所选择的输入段放在运行域的最后。例如，用这个选项能够强制性的将包含校验和的输入段放置在RW段的最后。使用下面的参数可以替换section-id。

1.    symbol

选择定义symbol的段放置在运行域的最后。不能指定一个有多处定义的symbol。使用该参数的例子如下：

-last checksum

2.    object(section)

从目标文件中选择section段。在目标文件和后面的括号间不能有空格，用该参数的例子为：

-last checksum.o(check)

3. object

选择只有一个输入段的目标，如果该目标文件中有多个输入段，armlink会给出出错信息。

和-first选项一样，需要读者注意的是;

使用-last选项不能改变在域中将RO段放在开始，接着放置RW段，最后放置ZI段的输出段基本的排放顺序。如果一个域含有ZI段，则RW段不能放在最后，如果一个域含有RW或ZI段，则RO段不能放在最后。

在同一个运行域中，两个不同的段不能同时放在域的最后位置。

-libpath pathlist

这个选项为ARM标准的C和C++库指定了搜索路径列表。

注意，这个选项不会影响对用户库的搜索路径。

这个选项覆盖了环境变量ARMLIB所指定的路径。参数pathlist是一个以逗号分开的多个路径列表，即为path1, path2,... pathn，这个路径列表只是用来搜索要用到的ARM库函数。默认的，对于包含ARM库函数的默认路径是由环境变量ARMLIB所指定的。

-scanlib

这个选项启动对默认库(标准ARM C和C++库)的扫描以解析引用的符号。这个选项是默认的设置。

-noscanlib

该选项禁止在链接时候扫描默认的库。

-locals

这个选项指导链接器在生成一个可执行映像文件的时候，将本地符号添加到输出符号信息表中。该选项是默认设置。

-nolocals

这个选项指导链接器在生成一个可执行映像文件的时候，不要将本地符号添加到输出符号信息表中。如果想减小输出符号表的大小，可以使用该选项。

-callgraph

该选项创建一个HTML格式的静态函数调用图。这个调用图给出了映像文件中所有函数的定义和引用信息。对于每一个函数它列出了：

1.    函数编译时候的处理器状态(ARM状态还是Thumb状态)；

2. 调用func函数的集合；

3. 被func调用的函数的集合；

4. 在映像文件中使用的func寻址的次数。

此外，调用图还标识了下面的函数：

1. 被interworking veneers所调用的函数；

2. 在映像文件外部定义的函数；

3. 允许未被定义的函数(以weak方式的引用)；

静态调用图还提供了堆栈使用信息，它显示出了：

1. 每个函数所使用的堆栈大小；

2. 在全部的函数调用中，所用到的最大堆栈大小。

-info topics

这个选项打印出关于指定种类的信息，这里的参数topics是指用逗号间隔的类型标识符列表。类型标识符列表可以是下面所列出的任意一个：

1.    sizes

为在映像文件中的每一个输入对象和库成员列出了代码和数据(这里的数据包括，RO数据，RW数据，ZI 数据和Debug 数据)的大小；

2.    totals

为输入对象文件和库，列出代码和数据(这里的数据包括，RO数据，RW数据，ZI 数据和Debug 数据) 总的大小；

3. veneers

给出由armlink生成的veneers的详细信息；

4. unused

列出由于使用-remove选项而从映像文件中被删除的所有未使用段。

注意：在信息类型标识符列表之间不能存在空格，比如可以输入

-info sizes,totals

但是不能是

-info sizes, totals(即在逗号和totals之间有空格是不允许的)

-map

这个选项创建映像文件的信息图。映像文件信息图包括映像文件中的每个加载域，运行域和输入段的大小和地址，这里的输入段还包括调试信息和链接器产生的输入段。

-symbols

这个选项列出了链接的时候使用的每一个局部和全局符号。该符号还包括链接生成的符号。

-symdefs file

这个选项创建一个包含来自输出映像文件的全局符号定义的符号定义文件。

默认的，所有的全局符号都写入到符号定义文件中。如果文件file已经存在，链接器将限制生成在已存在的symdefs文件中已列出的符号。

如果文件file没有指明路径信息，链接器将在输出映像文件的路径搜索文件。如果文件没有找到，就会在该目录下面创建文件。

在链接另一个映像文件的时候，可以将符号定义文件作为链接的输入文件。

-edit file

这个选项指定一个steering 类型的文件，该文件包含用于修改输出文件中的符号信息表的命令。可以在steering文件中指定具有以下功能的命令：

隐藏全局符号。使用该选项可以在目标文件中隐藏指定的全局符号。

重命名全局符号。使用这个选项可以解决符号命名冲突的现象。

-xref

该选项列出了在输入段间的所有交叉引用。

-xreffrom object(section)

这个选项列出了从目标文件中的输入段对其他输入段的交叉引用。如果想知道某个指定的输入段中的引用情况，就可以使用该选项。

-xrefto object(section)

该选项列出了从其他输入段到目标文件输入段的引用。

-errors file

使用该选项会将诊断信息从标准输出流重定向到文件file中。

-list file

该选项将-info，-map，-symbols，-xref，-xreffrom和 –xrefto这几个选项的输出重新定向到文件file中。

如果文件file没有指定路径信息，就会在输出路径创建该文件，该路径是输出映像文件所在的路径。

-verbose

这个选项将有关链接操作的细节打印出来，包括所包括的目标文件和要用到的库。

-unmangled

该选项指定链接器在由xref，-xreffrom，-xrefto，和-symbols所生成的诊断信息中显示出unmangled C++符号名。

如果使用了这个选项，链接器将unmangle C++符号名以源码的形式显示出来。这个选项是默认的。

-mangled

这个选项指定链接器显示由-xref，-xreffrom，-xrefto，和-symbols所产生的诊断信息中的mangled C++符号名。如果使用了该选项，链接器就不会unmangle C++符号名了。符号名是按照它们在目标符号表中显示的格式显示的。

-via file

该选项表示从文件file中读取输入文件名列表和链接器选项。

在armlink命令行可以输入多个-via选项，当然，-via选项也能够不含在一个via文件中。

-strict

这个选项告诉链接器报告可能导致错误而不是警告的条件。

-unresolved symbol

这个选项将未被解析的符号指向全局符号symbol。Symbol必须是已定义的全局符号，否则，symbol会当作一个未解析的符号，链接将以失败告终。这个选项在自上而下的开发中尤为有用，在这种情况下，通过将无法指向相应函数的引用指向一个伪函数的方法，可以测试一个部分实现的系统。

该选项不会显示任何警告信息。

input-file-list

这是一个以空格作为间隔符的目标或库的列表。

有一类特殊的目标文件，即symdef文件，也可以包含在文件列表中，为生成的映像文件提供全局的symbol值。

在输入文件列表中有两种使用库的方法。

1.    指定要从库中提取并作为目标文件添加到映像文件中的特定的成员。

2.    指定某库文件，链接器根据需要从其中提取成员。

armlink按照以下的顺序处理输入文件列表：

1.    无条件的添加目标文件

2.    使用匹配模式从库中选择成员加载到映像文件中去。例如使用下面的命令：

armlink main.o mylib(stdio.o) mylib(a*.o).

将会无条件的把mylib库中所有的以字母a开头的目标文件和stdio.o在链接的时候链接到生成的映像文件中去。

3.    添加为解析尚未解析的引用的库到库文件列表。

8.1.2    ARM运行时库

本小节为读者介绍一下ARM C/C++库方面的相关内容。

8.1.2.1    运行时库类型和建立选项

ADS提供以下的运行时库来支持被编译的C和C++代码：

ANSI C库函数：

这个C函数库是由以下几部分组成：

1． 在ISO C标准中定义的函数；

2． 在semihosted环境下(semihosting是针对ARM目标机的一种机制，它能够根据应用程序代码的输入/输出请求，与运行有调试功能的主机通讯。这种技术允许主机为通常没有输入和输出功能的目标硬件提供主机资源)用来实现C库函数的与目标相关的函数；

3． 被C和C++编译器所调用的支持函数。

ARM C 库提供了额外的一些部件支持C++，并为不同的结构体系和处理器编译代码。

C++库函数：

C++库函数包含由ISO C++库标准定义的函数。C++库依赖于相应的C库实现与特定目标相关的部分，在C++库的内部本身是不包含与目标相关的部分。这个库是由以下几部分组成的：

1． 版本为2.01.01的Rogue Wave Standard C++库；

2． C++编译器使用的支持函数；

3． Rogue Wave库所不支持的其他的C++函数。

正如上面所说，ANSI C库使用标准的ARM semihosted 环境提供例如，文件输入/输出的功能。Semihosting是由已定义的软件中断(Software Interrupt)操作来实现的。在大多数的情况下，semihosting SWI是被库函数内部的代码所触发，用于调试的代理程序处理SWI异常。调试代理程序为主机提供所需要的通信。Semihosted被ARMulator ，Angel和Multi-ICE所支持。用户可以使用在ADS软件中的ARM开发工具去开发用户应用程序，然后在ARMulator或在一个开发板上运行和调试该程序。

用户可以把C库中的与目标相关的函数作为自己应用程序中的一部分，重新进行代码的实现。这就为用户带来了极大的方便，用户可以根据自己的执行环境，适当的裁剪C库函数。

除此之外，用户还可以针对自己的应用程序的要求，对与目标无关的库函数进行适当的裁剪。

在C库中有很多函数是独立于其他函数的，并且与目标硬件没有任何依赖关系。对于这类函数，用户可以很容易地从汇编代码中使用它们。

在建立自己的用户应用程序的时候，用户必须指定一些最基本的操作选项。例如：

字节顺序，是大端模式(big endian:字数据的高字节存放在低地址，低字节存放在高地址)，还是小端模式(little endian:字数据的高字节存放在高地址，低字节存放在低地址)；

浮点支持：可能是FPA，VFP，软件浮点处理或不支持浮点运算；

堆栈限制：是否检查堆栈溢出；

位置无关(PID)：数据是从与位置无关的代码还是从与位置相关的代码中读/写，代码是位置无关的只读代码还是位置相关的的只读代码。

当用户对汇编程序，C程序或C++程序进行链接的时候，链接器会根据在建立时所指定的选项，选择适当的C或C++运行时库的类型。选项各种不同组合都有一个相应的ANSI C库类型。

8.1.2.2    库路径结构

库路径是在ADS软件安装路径的lib目录下的两个子目录。假设，ADS软件安装在e:/arm/adsv1_2目录，则在e:/arm/adsv1_2/lib目录下的两个子目录armlib和cpplib是ARM的库所在的路径。

armlib

这个子目录包含了ARM C 库，浮点代数运算库，数学库等各类库函数。与这些库相应的头文件在e:/arm/adsv1_2/include目录中。

cpplib

这个子目录包含了Rogue Wave C++库和C++支持函数库。Rogue Wave C++库和C++支持函数库合在一起被称为ARM C++库。与这些库相应的头文件安装在e:/arm/adsv1_2/include目录下。

环境变量ARMLIB必须被设置成指向库路径。另外一种指定ARM C和ARM C++库路径的方法是，在链接的时候使用操作选项-libpath directory(directory代表库所在的路径)，来指明要装载的库的路径。

无需对armlib和cpplib这两个库路径分开指明，链接器会自动从用户所指明的库路径中找出这两个子目录。

这里需要让读者特别注意的以下几点：

1. ARM C库函数是以二进制格式提供的；

2. ARM 库函数禁止修改。如果读者想对库函数创建新的实现的话，可以把这个新的函数编译成目标文件，然后在链接的时候把它包含进来。这样在链接的时候，使用的是新的函数实现而不是原来的库函数。

3. 通常情况下，为了创建依赖于目标的应用程序，在ANSI C库中只有很少的几个函数需要实现重建。

4. Rogue Wave Standard C++函数库的源代码不是免费发布的，可以从Rogue Wave Software Inc.，或ARM公司通过支付许可证费用来获得源文件。

8.1.3    GUI开发环境(Code Warrior和AXD)

8.1.3.1 CodeWarrior集成开发环境

CodeWarrior for ARM是一套完整的集成开发工具，充分发挥了ARM RISC 的优势, 使产品开发人员能够很好的应用尖端的片上系统技术. 该工具是专为基于ARM RISC的处理器而设计的, 它可加速并简化嵌入式开发过程中的每一个环节，使得开发人员只需通过一个集成软件开发环境就能研制出ARM产品，在整个开发周期中,开发人员无需离开CodeWarrior开发环境, 因此节省了在操做工具上花的时间,使得开发人员有更多的精力投入到代码编写上来，

CodeWarrior集成开发环境(IDE)为管理和开发项目提供了简单多样化的图形用户界面。用户可以使用ADS的CodeWarrior IDE为ARM和Thumb处理器开发用C，C++，或ARM汇编语言的程序代码。通过提供下面的功能，CodeWarrior IDE缩短了用户开发项目代码的周期。

1. 全面的项目管理功能；

2. 子函数的代码导航功能，使得用户迅速找到程序中的子函数。

可以在CodeWarrior IDE为ARM配置在8.1.1中介绍的各种命令工具，实现对工程代码的编译，汇编和链接。

在CodeWarrior IDE中所涉及到的target有两种不同的语义。

目标系统(Target system)

是特指代码要运行的环境，是基于ARM的硬件。比如，要为ARM开发板上编写要运行在它上面的程序，这个开发板就是目标系统。

生成目标(Build target)

是指用于生成特定的目标文件的选项设置(包括汇编选项，编译选项，链接选项以及链接后的处理选项)和所用的文件的集合。

CodeWarrior IDE 能够让用户将源代码文件，库文件还有其他相关的文件以及配置设置等放在一个工程中。每个工程可以创建和管理生成目标设置的多个配置。例如，要编译一个包含调试信息的生成目标和一个基于ARM7TDMI的硬件优化生成目标，生成目标可以在同一个工程中共享文件，同时使用各自的设置。

CodeWarrior IDE为用户提供下面的功能：

源代码编辑器，它集成在CodeWarrior IDE的浏览器中，能够根据语法格式，使用不同的颜色显示代码；

源代码浏览器，它保存了在源码中定义的所有符号，能够使用户在源码中快速方便的跳转；

查找和替换功能，用户可以在多个文件中，利用字符串通配符，进行字符串的搜索和替换；

文件比较功能，可以使用户比较路径中的不同文本文件的内容。

ADS的CodeWarrior IDE是基于Metrowerks CodeWarrior IDE 4.2版本的。它经过适当的裁剪以支持ADS工具链。

针对ARM的配置面板为用户提供了在CodeWarrior IDE集成环境下配置各种ARM开发工具的能力，这样用户可以不用在命令控制台下就能够使用在8.1.1和将在8.1.4中介绍的各种命令。

以ARM为目标平台的工程创建向导，可以使用户以此为基础，快速创建ARM和Thumb工程。

尽管大多数的ARM工具链已经集成在CodeWarrior IDE，但是仍有许多功能在该集成环境中没有实现，这些功能大多数是和调试相关的，因为ARM的调试器没有集成到CodeWarrior IDE中。

由于ARM调试器(AXD)没有集成在CodeWarrior IDE中，这就意味着，用户不能在CodeWarrior IDE中进行断点调试和查看变量。

对于熟悉CodeWarrior IDE的用户会发现，有许多的功能已经从CodeWarrior IDE For ARM中移走，比如快速应用程序开发模板等。

在CodeWarrior IDE For ARM中有很多的菜单或子菜单是不能使用的。下面介绍一下这些不能使用的选项。

1. View菜单下不能使用的菜单选项有：

Processes，Expressions，Global Variable，Breakpoints，Registers。

2.    Project菜单不能使用的菜单选项：

Precompile子菜单。因为ARM编译器不支持预编译的头文件。

3.    Debug菜单

该菜单中没有一个子菜单是可以使用的。

4.    Browser菜单中不能使用的菜单选项：

New Property，New Method和New Event Set。

5.    Help menu中不能用于ADS的菜单选项有：

CodeWarrior Help，Index，Search和Online Manuals。

有关CodeWarrior IDE中一些常用菜单的使用，将在后面的举例中具体说明的，在此，不在赘述。

8.1.3.2    ADS调试器

调试器本身是一个软件，用户通过这个软件使用debug agent可以对包含有调试信息的，正在运行的可执行代码进行比如变量的查看，断点的控制等调试操作。

ADS中包含有3个调试器：

AXD(ARM eXtended Debugger)：ARM扩展调试器；

armsd(ARM Symbolic Debugger)：ARM符号调试器；

与老版本兼容的Windows或Unix下的ARM调试工具，ADW/ADU(Application Debugger Windows/Unix)。

下面对在调试映像文件中所涉及到的一些术语做一个简单的介绍。

Debug target

在软件开发的最初阶段，可能还没有具体的硬件设备。如果要测试所开发的软件是否达到了预期的效果，这可以由软件仿真来完成。即使调试器和要测试的软件运行在同一台PC上，也可以把目标当作一个独立的硬件来看待。

当然，也可以搭建一个PCB板，这个板上可以包含一个或多个处理器，在这个板上可以运行和调试应用软件。

只有当通过硬件或者是软件仿真所得到的结果达到了预期的效果，才算是完成了应用程序的编写工作。

调试器能够发送以下指令：

1. 装载映像文件到目标内存；

2. 启动或停止程序的执行；

3. 显示内存，寄存器或变量的值；

4.    允许用户改变存储的变量值。

Debug agent

Debug agent执行调试器发出的命令动作，比如：设置断点，从存储器中读数据，把数据写到存储器等。

Debug agent既不是被调试的程序，也不是调试器。在ARM体系中，它有这几种方式：Multi-ICE(Multi-processor in-circuit emulator)，ARMulator和Angel。其中Multi-ICE是一个独立的产品，是ARM公司自己的JTAG在线仿真器，不是由ADS提供的。

AXD可以在Windows 和UNIX下，进行程序的调试。它为用C，C++，和汇编语言编写的源代码提供了一个全面的Windows 和UNIX 环境。

在后面的章节中，会结合具体实例为读者介绍如何使用AXD调试器。

8.1.4 实用程序

ADS提供以下的实用工具来配合前面介绍的命令行开发工具的使用

fromELF

这是ARM映像文件转换工具。该命令将ELF格式的文件作为输入文件，将该格式转换为各种输出格式的文件，包括plain binary(BIN格式映像文件), Motorola 32-bit S-record format(Motorola 32位S格式映像文件), Intel Hex 32 format(Intel 32位格式映像文件)，和 Verilog-like hex format(Verilog 16进制文件)。FromELF命令也能够为输入映像文件产生文本信息，例如代码和数据长度。

armar

ARM库函数生成器将一系列ELF格式的目标文件以库函数的形式集合在一起，用户可以把一个库传递给一个链接器以代替几个ELF文件。

Flash downloader

用于把二进制映像文件下载到ARM开发板上的Flash存储器的工具

8.1.5    支持的软件

ADS为用户提供下面的软件，使用户可以在软件仿真的环境下或者在基于ARM的硬件环境调试用户应用程序。

ARMulator

这是一个ARM指令集仿真器，集成在ARM的调试器AXD中，它提供对ARM处理器的指令集的仿真，为ARM和Thumb提供精确的模拟。用户可以在硬件尚未做好的情况下，开发程序代码。

8.2    使用ADS创建工程

本节通过一个具体实例，为读者介绍如何使用该集成开发环境，利用CodeWarrior提供的建立工程的模板建立自己的工程，并学会如何进行编译链接，生成包含调试信息的映像文件和可以直接烧写的Flash中的.bin格式的二进制可执行文件。

8.2.1    建立一个工程

工程将所有的源码文件组织在一起，并能够决定最终生成文件存放的路径，输出的格式等。

在CodeWarrior中新建一个工程的方法有两种，可以在工具栏中单击“New”按钮，也可以在“File”菜单中选择“New…”菜单。这样就会打开一个如图8.1所示的对话框。