在本节中，将使用 examples/peripherals/adc 下的 single_ended 外设示例作为参考。

按照 Topic Link Label3.2中的步骤，将 EK-TM4C123GXL LaunchPad 的 project0 用作起始 TivaWare 工程。将工程名重命名为“single_ended”，以便后续能够重新导入 project0。将源代码复制到 project0.c 文件并尝试编译工程后，会出现图 4-1 中所示的构建错误。

 

如果在使用函数调用时没有在工程中添加合适的 .c 源文件，通常会出现“未解析的符号”错误。如果工程使用除了所提供的 TivaWare 库（DriverLib 或 UsbLib）以外的文件，通常会出现该错误。如果使用 #include 从 TivaWare 库目录中添加了头文件，那么应进行检查以确保已将相应的 .lib 文件添加到工程中。如果已添加，则无需执行进一步操作。Topic Link Label4.2将介绍在工程中缺失 .lib 文件的情况下如何添加该文件。

在本例中，以下两个 UART 相关函数导致了这个问题：UARTprintf 和 UARTStdioConfig。由于本示例用于现有 TivaWare 示例工程，了解缺少哪个文件的最快捷方式是向上滚动到代码工程顶部的 #include 语句。执行此操作后，可以找到与 UART 相关的以下行：

#include "driverlib/uart.h"
#include "utils/uartstdio.h"

如前文所述，由于 .lib 文件已经包含 driverlib 文件，接下来要检查是否缺少 uartstdio.c 文件。仔细查看工程中的文件列表后，发现工程中不包含 uartstdio.c 文件（图 4-2）。通过搜索 TivaWare 安装 utils 目录中 uartstdio.c 文件的内容，可以发现该文件中也有缺少的函数。

 

在识别出文件之后，需要通过以下步骤将文件链接到 CCS 工程。

1. 转至 CCS 工程，右键点击工程名称以打开工程的选项菜单（图 4-3）。
2. 点击“Add Files”。
   图 3-3 CCS 工程的“Add Files”选项
3. 此时将出现文件浏览器，如前文所示，需要从 utils 目录中添加 uartstdio.c 文件。导航到该目录并选择该文件。
   提示： 按下 CTRL 键并点击每个必须链接的文件，以选择多个文件。
4. 添加文件时，CCS 将询问是复制还是链接文件。选择“Link to files”选项（图 4-4）。如果从 TivaWare SDK 中添加另一个文件，建议将“Create Link locations relative to:”路径更改为“SW_ROOT”。SW_ROOT 是计算机上基础 TivaWare SDK 目录的 TivaWare 定义路径。
   图 3-4 针对其他 TivaWare 文件的建议链接位置路径

 

现在，uartstdio.c 文件应显示在工程的文件列表中（图 4-5），现在将能够成功地重新构建工程！

 

检查是否已正确完成该过程的另一个方法是转至 CCS 工程属性，导航到“Resource”→“Linked Resources”页面，然后选择“Linked Resources”选项卡。在此选项卡下，找到所列的“Variable Relative Location”，如图 4-6 所示。