ZHCU861A March   2021  – August 2022 TM4C1230C3PM , TM4C1230D5PM , TM4C1230E6PM , TM4C1230H6PM , TM4C1231C3PM , TM4C1231D5PM , TM4C1231D5PZ , TM4C1231E6PM , TM4C1231E6PZ , TM4C1231H6PGE , TM4C1231H6PM , TM4C1231H6PZ , TM4C1232C3PM , TM4C1232D5PM , TM4C1232E6PM , TM4C1232H6PM , TM4C1233C3PM , TM4C1233D5PM , TM4C1233D5PZ , TM4C1233E6PM , TM4C1233E6PZ , TM4C1233H6PGE , TM4C1233H6PM , TM4C1233H6PZ , TM4C1236D5PM , TM4C1236E6PM , TM4C1236H6PM , TM4C1237D5PM , TM4C1237D5PZ , TM4C1237E6PM , TM4C1237E6PZ , TM4C1237H6PGE , TM4C1237H6PM , TM4C1237H6PZ , TM4C123AE6PM , TM4C123AH6PM , TM4C123BE6PM , TM4C123BE6PZ , TM4C123BH6PGE , TM4C123BH6PM , TM4C123BH6PZ , TM4C123FE6PM , TM4C123FH6PM , TM4C123GE6PM , TM4C123GE6PZ , TM4C123GH6PGE , TM4C123GH6PM , TM4C123GH6PZ , TM4C123GH6ZXR , TM4C1290NCPDT , TM4C1290NCZAD , TM4C1292NCPDT , TM4C1292NCZAD , TM4C1294KCPDT , TM4C1294NCPDT , TM4C1294NCZAD , TM4C1297NCZAD , TM4C1299KCZAD , TM4C1299NCZAD , TM4C129CNCPDT , TM4C129CNCZAD , TM4C129DNCPDT , TM4C129DNCZAD , TM4C129EKCPDT , TM4C129ENCPDT , TM4C129ENCZAD , TM4C129LNCZAD , TM4C129XKCZAD , TM4C129XNCZAD

 

  1.   请先阅读
    1.     关于本手册
    2.     术语表
    3.     德州仪器 (TI) 提供的相关文档
    4.     支持资源
    5.     商标
  2. 1TivaWare SDK 简介
    1. 1.1 TivaWare SDK 文件夹细目分类
  3. 2TivaWare 示例工程
    1. 2.1 TivaWare 开发板示例
    2. 2.2 TivaWare 外设示例
    3. 2.3 如何将示例工程导入 CCS
  4. 3在 Code Composer Studio 中将文件和库关联到 TivaWare 工程中
    1. 3.1 在 CCS 中链接文件
    2. 3.2 在 CCS 中链接库
  5. 4如何调试 TivaWare 库
    1. 4.1 如何引导 Code Composer Studio 找到源文件
    2. 4.2 如何重新构建 TivaWare 库
  6. 5如何将 TivaWare 添加到现有 CCS 工程中
    1. 5.1 路径变量
    2. 5.2 包含路径
    3. 5.3 预定义变量
    4. 5.4 库链接
  7. 6TivaWare 引导加载程序
    1. 6.1 在 Code Composer Studio 中修改要用于引导加载的 TivaWare 工程
    2. 6.2 如何使用 LM 闪存编程器引导加载
  8. 7软件最佳做法
    1. 7.1 栈/堆设置和栈溢出
    2. 7.2 中断服务例程
      1. 7.2.1 最佳做法
      2. 7.2.2 TivaWare 矢量表和 IntDefaultHandler
    3. 7.3 TivaWare 硬件头文件
    4. 7.4 ROM 和 MAP TivaWare 前缀
  9. 8TM4C 资源
  10. 9修订历史记录

1.1 TivaWare SDK 文件夹细目分类

本节简要介绍了 TivaWare SDK 中提供的内容，并提供了多个文件夹所关联的 TivaWare 文档。通过阅读这些文档，您可以进一步了解 SDK 中提供的内容。

在基础目录中，提供了 13 个文件夹和一些文件。图 2-1 中突出显示的 12 个文件夹中存储了所有相关的配套资料。基础目录中仅有的说明文件是 3 个 .txt 许可文件。基础目录中其余的文件以及 .metadata 文件夹是构建构件和 TI Resource Explorer 信息，无需理会。

boot_loader 文件夹包含执行 TivaWare 闪存引导加载程序所需的源代码。TivaWare™ 引导加载程序用户指南 (SW-TM4C-BOOTLDR-UG) 中介绍了引导加载程序功能的全部细节，包括 ROM 和闪存引导加载程序的区别。

docs 文件夹包含与 TivaWare 示例、库和实用程序相关的所有技术文档。其中还包含 TivaWare 官方版本说明，该说明重点介绍了每个版本的 SDK 中对 TivaWare 所做的更改（用于 C 系列的 TivaWare™ 版本说明 (SW-TM4C-RLN)）。

driverlib 文件夹包含 TivaWare 驱动程序库 (DriverLib) 源代码，用户可以借助它来利用经过 TI 验证的函数。借助 DriverLib 函数，所有程序员无需在寄存器级进行操作，即可轻松配置器件并控制外设。有关 DriverLib 源代码的全部细节，请参阅 TivaWare™ 外设驱动程序库用户指南 (SW-TM4C-DRL-UG)。

examples 文件夹包含 TivaWare 提供的所有示例工程。有关这些示例工程的详细信息，请参阅Chapter3。

inc 文件夹包含每个 TM4C 器件的器件头文件以及硬件头文件。器件头文件提供针对特定器件的所有寄存器、偏移和位字段的定义。通用硬件头文件是 .h 文件，该类文件以 'hw_' 前缀开头，包含针对所有寄存器偏移和位字段的定义。TivaWare 库利用通用硬件头文件，以确保所有库函数都与器件无关，但针对特定应用，通用硬件头文件可由特定器件头文件代替。

注意： 如果代码文件同时使用器件头文件和通用硬件头文件的 #include，将出现指示 #define 重叠的编译器错误。头文件中只能使用一个 #define。

grlib 文件夹包含 TivaWare 图形库源代码，该代码提供一套图形基元和小工具集，用于在各种 LCD 显示屏上创建图形用户界面。图形基元用于绘制定义的形状和图案。小工具用于绘制各种用户界面元素。此外，所有图形应用均需要显示驱动程序，在 TivaWare 示例文件夹中会提供应用级别的驱动程序。有关图形库源代码的全部细节，请参阅 TivaWare™ 图形库用户指南 (SW-TM4C-GRL-UG)。

GUID-20210104-CA0I-7JGX-5Q2T-N9HL4TVLKP5Q-low.jpg图 1-1 完整的 TivaWare SDK 安装目录

 

sensorlib 文件夹包含 TivaWare 传感器库源代码，该代码用于各种主要来自原始 BOOSTXL-SENSHUB BoosterPack 的受 TivaWare 支持的传感器。有关相关产品的全部细节，请参阅 TivaWare™ 传感器库用户指南 (SW-TM4C-SENSORLIB-UG)。

third_party 文件夹包含来自第三方的各种开源资源，可用于为 TivaWare 示例提供支持。这些资源包括有关 Exosite 云物联网演示（使用 EK-TM4C1294XL LaunchPad 的物联网演示应用报告）、通用 FAT 文件系统、FatFs、SD 卡、FreeRTOS 支持和各种以太网协议相关应用程序（包括 lwIP 1.4.1）的文件。

tools 文件夹包含在开发系统上而不是 TM4C 器件上运行的 TivaWare 主机工具。提供的这些工具有助于开发适用于 TM4C 应用的固件。有关相关工具的全部细节，请参阅工具用户指南 (SW-TM4C-TOOLS-UG)。

usblib 文件夹包含 TivaWare USB 库源代码，该代码向用户提供了适用于器件、主机和移动模式的基本 USB 功能。USB 库提供了器件枚举、端点管理和特定类模块的描述符。有关 USB 库源代码的全部细节，请参阅 TivaWare™ USB 库用户指南 (SW-TM4C-USBL-UG)。

utils 文件夹包含 TI 开发的各种实用程序，可帮助创建应用程序。这些实用程序与器件无关，有助于构建更高级的用户应用程序。有关这些实用程序的全部细节，请参阅实用程序库用户指南 (SW-TM4C-UTILS-UG)。

windows_drivers 文件夹包含所有 TivaWare USB 器件示例中都需要的已签名 Windows USB 设备驱动程序。