ARM 汇编语言工具用户指南 介绍了如何使用以下德州仪器 (TI) 代码生成目标文件工具：

• 汇编器
• 归档器
• 链接器
• 库信息归档器
• 绝对列表器
• 交叉引用列表器
• 反汇编器
• 目标文件显示实用程序
• 名称实用程序
• 符号去除实用程序
• 十六进制转换实用程序

本手册将帮助您了解如何使用德州仪器 (TI) 目标文件和专为 ARM® 32 位 器件设计的汇编语言工具。本手册包含四个部分：

• 介绍性信息，包括Chapter8至Chapter36，概述了目标文件和汇编语言开发工具。尤其是Chapter12，介绍了目标模块以及如何管理它们以为 ARM 应用加载和运行提供帮助。强烈建议开发人员在使用汇编器和链接器之前，先熟悉什么是目标模块以及如何使用它们。
• 汇编器说明，包括Chapter60至Chapter177，其中包含有关使用汇编器的详细信息。Chapter60和Chapter109介绍了如何调用汇编器，并讨论了源语句格式、有效常量和表达式、汇编器输出和汇编器指令。Chapter177重点介绍了宏语言。
• 链接器和其他目标文件工具说明，包括Chapter195至Chapter399，详细描述了与汇编器一同提供的可为创建可执行目标文件提供帮助的每个工具。Chapter195提供了有关使用归档器创建对象库的详细信息。Chapter206介绍了链接器的调用方法、链接器的运行方式以及链接器指令的使用方法。Chapter388对一些目标文件实用程序进行了简要概述，这些实用程序在检查目标文件内容方面，以及删除符号和调试信息以减小给定目标文件的大小方面均非常有用。Chapter399介绍了如何使用十六进制转换实用程序。
• 其他参考资料，包括AppendixA至AppendixD，提供包含 ARM C/C++ 编译器使用的符号调试指令在内的补充信息。它还提供了十六进制实用程序示例。此外还提供了 XML 链接信息文件的说明以及一个术语表。

本文档使用以下惯例：

• 程序列表、程序示例和交互式显示用 特殊字体 显示。交互式显示采用粗体形式的特殊字体来区分输入的命令与系统显示的项目（如提示符、命令输出、错误消息等）。

  C 代码示例如下所示：

       #include <stdio.h>
       main()
       {    printf("hello world\n");
       }

• 在语法描述中，指令、命令和伪操作为粗体，参数为斜体。语法中粗体显示的部分应按所示方式输入；语法中斜体显示的部分描述了应输入信息的类型。
• 方括号（[ 和 ]）用于标识可选参数。如果使用可选参数，需要在括号内指定信息。除非方括号是粗体，否则不要输入方括号本身。下面是一个具有可选参数的命令的示例：

  armcl [options] [filenames] [--run_linker [link_options] [object files]]

• 大括号（{ 和 }）表明必须选择大括号内的参数之一，不要输入大括号本身。 这是一个带有大括号的命令的示例，大括号并不包含在实际语法中，但表明您必须指定 --rom_model 或 --ram_model 选项：

  armcl --run_linker {--rom_model | --ram_model} filenames [--output_file=name.out]
  	--library= libraryname

• 在汇编器语法语句中，最左侧字符位置（列 1）被预留给标签或符号的第一个字符。如果标签或符号是可选的，则通常不会显示。如果标签或符号是必需参数，则从框的左边距开始显示，如下例所示。除了符号或标签外，任何指令、命令、指示或参数都不能从列 1 开始。

  symbol .usect "section name", size in bytes[, alignment]

• 有些指令的参数数量可变。例如，.byte 指令可以具有多个参数。此语法显示为 [, ..., parameter]。

  .byteparameter1[, ..., parametern]

• TMS470 和 TMS570 器件统称为 ARM。
• ARM 16 位指令集被称为 16-BIS。
• ARM 32 位指令集被称为 32-BIS。

• 本文档中使用的其他符号和缩写词包括：

有关 TI 代码生成工具的更多信息，请参阅以下资源：

• Code Composer Studio：文档概述
• 德州仪器 (TI) E2E 社区：软件工具论坛

以下书籍可以作为本用户指南的补充：

图 1-1 展示了 ARM 器件 的软件开发流程。阴影部分突出显示了最常用的开发路径；其他部分是可选的。其他部分是用于增强开发流程的外围功能。

图 1-1 ARM 器件 软件开发流程

以下列表描述了图 1-1 中显示的工具：

• C/C++ 编译器接受 C/C++ 源代码并生成 ARM 机器码目标模块。如需更多信息，请参阅 《ARM 优化 C/C++ 编译器用户指南》。安装时会包含 shell 程序、优化器和 interlist 实用程序：
  • shell 程序只需一步即可编译、汇编和链接源代码模块。
  • 优化器可修改代码，以提升 C/C++ 程序的效率。
  • interlist 实用程序可将 C/C++ 源语句插入到汇编语言输出中，以将由编译器生成的代码与源代码相关联。
• 汇编器将汇编语言源文件转换为机器语言目标模块。源文件可以包含指令、汇编器指令和宏指令。您可以使用汇编器指令控制汇编过程，包括源代码列表格式、数据对齐和段内容。请参阅Chapter60至Chapter177。有关汇编语言指令集的详细信息，请参阅 《TMS470R1x 用户指南》 。
• 链接器将目标文件组合为单个可执行目标模块。它会执行符号重定位并解析外部引用。链接器接受可重定位的目标模块（由汇编器创建）作为输入。它还接受通过之前运行链接器创建的归档器库成员和输出模块。链接器指令可组合目标文件段、将段或符号与地址绑定或绑定到存储器范围中，以及定义全局符号。请参阅Chapter206。
• 归档器可将一组文件收集到被称为库的单个存档文件中。归档器最常见的用途是将一组目标文件收集到一个目标库中。链接器在链接时会提取目标库成员，以解析外部引用。您也可以使用归档器将多个宏收集到一个宏库中。汇编器会搜索库并使用被源文件作为宏调用的成员。归档器允许通过删除、替换、提取或添加成员来修改库。请参阅节 7.1。
• 库信息归档器可用于创建多个目标文件库变体的索引库，如果库的多个变体有不同的可用选项，此功能很有用。您可以不必引用具体库，而是链接索引库，链接器将从索引库中选择最佳匹配项。如需有关使用归档器来管理库内容的更多信息，请参阅节 7.5。
• 可以使用库编译实用程序编译您自有的自定义运行时支持库。如需更多信息，请参阅 《ARM 优化 C/C++ 编译器用户指南》。
• 十六进制转换实用程序将目标文件转换为 TI-Tagged、ASCII-Hex、Intel、Motorola-S 或 Tektronix 目标格式。转换后的文件可下载到 EPROM 编程器。请参阅Chapter399。
• 绝对列表器使用链接的目标文件来创建 .abs 文件。这些文件经汇编后可生成目标代码绝对地址的列表。请参阅Chapter378。
• 交叉引用列表器使用目标文件生成交叉引用列表，展示符号、符号定义以及符号在链接的源文件中的引用。请参阅Chapter383。
• 此开发流程的主要产品是一个可在 ARM 器件上执行的可执行目标文件。可使用多种调试工具之一来改进和更正代码。 可用产品包括：
  • 指令精确和时钟精确的软件仿真器
  • XDS 仿真器

此外，还提供了以下实用程序来帮助检查或管理给定目标文件的内容：

• 目标文件显示实用程序以可读的或 XML 格式打印目标文件和目标库的内容。请参阅节 11.1。
• 反汇编器解码目标模块中的机器代码以显示其所表示的汇编指令。请参阅节 11.2。
• 名称实用程序打印目标文件或目标存档中定义或引用的目标和函数的符号名称列表。请参阅节 11.3。
• 符号去除实用程序从目标文件和目标库中删除符号表和调试信息。请参阅节 11.4。

由汇编器和链接器创建的目标文件符合 ELF（可执行连接格式）二进制格式规范，该格式由嵌入式应用二进制接口 (EABI) 使用。有关 EABI ABI 的信息，请参阅 ARM 优化 C/C++ 编译器用户指南 (SPNU151)。在 ARM 信息中心可找到完整的 ARM ABI 规范。

v15.6.0.STS 和更高版本的 TI 代码生成工具不支持 COFF 目标文件以及传统的 TIABI 和 TI ARM9 ABI 模式。如果希望生成 COFF 输出文件，请使用 5.2 版本的 ARM 代码生成工具，并参考 SPNU151J 文档。

由汇编器和链接器生成的 ELF 目标文件与 2003 年 12 月 17 日生成的 System V generic ABI（或 gABI） 快照相符。 此规范目前由 SCO 负责维护。