C2000 SysConfig 链接器命令工具
- ZHCAC25 January 2023 TMS320F2800132 , TMS320F2800133 , TMS320F2800135 , TMS320F2800137 , TMS320F2800152-Q1 , TMS320F2800153-Q1 , TMS320F2800154-Q1 , TMS320F2800155 , TMS320F2800155-Q1 , TMS320F2800156-Q1 , TMS320F2800157 , TMS320F2800157-Q1 , TMS320F280021 , TMS320F280021-Q1 , TMS320F280023 , TMS320F280023-Q1 , TMS320F280023C , TMS320F280025 , TMS320F280025-Q1 , TMS320F280025C , TMS320F280025C-Q1 , TMS320F280033 , TMS320F280034 , TMS320F280034-Q1 , TMS320F280036-Q1 , TMS320F280036C-Q1 , TMS320F280037 , TMS320F280037-Q1 , TMS320F280037C , TMS320F280037C-Q1 , TMS320F280038-Q1 , TMS320F280038C-Q1 , TMS320F280039 , TMS320F280039-Q1 , TMS320F280039C , TMS320F280039C-Q1 , TMS320F280040-Q1 , TMS320F280040C-Q1 , TMS320F280041 , TMS320F280041-Q1 , TMS320F280041C , TMS320F280041C-Q1 , TMS320F280045 , TMS320F280048-Q1 , TMS320F280048C-Q1 , TMS320F280049 , TMS320F280049-Q1 , TMS320F28374D , TMS320F28375D , TMS320F28376D , TMS320F28377D , TMS320F28377D-EP , TMS320F28377D-Q1 , TMS320F28378D , TMS320F28379D , TMS320F28379D-Q1 , TMS320F28384D , TMS320F28384D-Q1 , TMS320F28384S , TMS320F28384S-Q1 , TMS320F28386D , TMS320F28386D-Q1 , TMS320F28386S , TMS320F28386S-Q1 , TMS320F28388D , TMS320F28388S , TMS320F28P650DH , TMS320F28P650DK , TMS320F28P650SH , TMS320F28P650SK , TMS320F28P659DH-Q1 , TMS320F28P659DK-Q1 , TMS320F28P659SH-Q1

Full reading width

APPLICATION NOTE

C2000 SysConfig 链接器命令工具

本资源的原文使用英文撰写。为方便起见，TI 提供了译文；由于翻译过程中可能使用了自动化工具，TI 不保证译文的准确性。为确认准确性，请务必访问 ti.com 参考最新的英文版本（控制文档）。

摘要

链接器命令文件在嵌入式程序中起着重要作用，因为它们指定了将代码段和数据段分配到目标存储器中的位置。没有此文件，链接器不知道目标存储器配置以及如何正确分配这些段。对于 C2000™ 实时控制器，您必须通过查看器件特定数据表和技术参考手册来了解器件存储器。C2000Ware SDK 中提供示例 C2000 链接器命令文件，但对于任何给定应用，您可能必须修改 C2000Ware SDK 中可用的模板链接器命令文件才能满足您的应用需求。这要求您了解编写链接器命令文件时可用的语法和选项。C2000 链接器 CMD 工具通过提供直观的 GUI 和自动代码生成，简化了创建应用特定链接器命令文件的任务。

商标

C2000™ and Code Composer Studio™are TMs ofTI corporate name.

Other TMs

1 引言

链接器命令文件用于应用程序编译过程的链接阶段，在此阶段，链接器会组合目标文件并将片段分配到目标系统的已配置内存中。链接器命令文件是一个 ASCII 文件，它使用两个链接器指令 MEMORY 和 SECTIONS 将片段分配到内存的特定区域中。MEMORY 指令定义目标内存配置。SECTIONS 指令控制如何构建和分配片段。此外，链接器命令文件还可以包含输入文件名和链接器选项。

链接器命令文件入门页面介绍了链接器命令文件的基本信息，重点阐述了 MEMORY 和 SECTIONS 指令。

对于新用户而言，从头开始创建新的链接器命令文件会很困难，甚至编辑现有的链接器命令文件模板都不容易。用户必须了解链接器命令文件的结构及其特定器件的存储器结构。

C2000 链接器 CMD 工具通过提供以下特性，显著简化了新建链接器命令文件或编辑现有链接器命令文件的任务：

基于 GUI 的直观界面，展示了所有可用的自定义选项
执行错误检查以帮助您避免犯错
自动生成 CMD 文件
自动修改 Code Composer Studio™ 工程属性
自动生成用于初始化存储器段的附加 C 源文件和头文件
展示所选器件系列的可用存储器

使用 C2000 链接器 CMD 工具可以加快新用户和高级用户的软件开发速度。

2 C2000 链接器命令工具 – GUI 配置

C2000 链接器命令工具是一款基于 SysConfig 的产品，可无缝集成到 C2000 系统配置工具中。

更多有关 C2000 系统配置工具的信息，请访问：

视频系列：

C2000 SysConfig 的优势：

利用 SysConfig 并借助 C2000™ 实时 MCU 加速开发

应用报告 - C2000 SysConfig 分步使用指南：

C2000 SysConfig

软件入门指南：

https://software-dl.ti.com/C2000/docs/software_guide/c2000_sysconfig.html

开发人员必须针对他们的给定器件和封装启动 C2000 SysConfig 工具，才能使用 C2000 链接器 CMD 工具。C2000 SysConfig 将引导您完成在 Code Composer Studio 工程上下文以及 SysConfig 独立工具中启动 C2000 SysConfig 工具所需的步骤。

C2000 链接器命令工具如#FIG_UND_ZC1_1WB 所示。

图 2-1 链接器 CMD 工具 - GUI 概述

链接器 CMD 模块
影响添加到设计中的所有 CMD 模块实例的全局设置
设计中 CMD 模块的实例

添加 CMD 模块后，该工具会生成其他文件。

图 2-2 链接器 CMD 工具 - 生成的文件

请注意，您可以添加多个 CMD 模块。CMD 模块的所有不同实例均可保存在 syscfg 文件中。您可以决定哪个 CMD 模块处于活动状态，方法是在全局参数中选择该模块。

图 2-3 链接器 CMD 工具 - 全局参数

CMD 模块的每个实例都包含以下条目：

图 2-4 链接器 CMD 工具 - CMD 实例配置

默认配置：将实例配置为针对该器件提供的默认设置
存储器：按存储器类型分组，组合存储块以创建更大的存储器组
章节：根据用途分配器件存储器
CRC/校验和生成：为整个闪存生成 CRC/校验和

2.1 存储器组合

您可以将同一类型的不同存储块组合起来并为新存储块命名，如#FIG_VKR_K21_1WB 所示。

图 2-5 链接器 CMD 工具 - 存储器组合

该工具不允许组合不连续的器件存储器。

2.2 存储器段

这些段分成几组，具体取决于它们是属于 C28x、CLA 还是自定义的“用户定义”段。

图 2-6 链接器 CMD 工具 - 存储器段

每个段都分配了一个存储块。可用的选项包括器件存储块和组合存储块。

图 2-7 链接器 CMD 工具 - 加载存储器

如果器件有一个额外的 CLA 内核，则会显示 CLA 段供您配置。

可以根据需要添加和命名用户定义的段，以满足应用需求。

图 2-8 链接器 CMD 工具 - 用户定义的段

2.3 CLA 段

链接器 CMD 工具还支持具有 CLA 支持的器件上的 CLA 段。

图 2-9 链接器 CMD 工具 - CLA 段

3 C2000 链接器命令工具 – 代码生成

链接器 CMD 工具生成一系列文件：

device_cmd.cmd：这是主文件，其中包含基于 GUI 中所选选项的链接器命令文件条目。
device_cmd.c：该文件包含特定存储器段的初始化代码，这些段需要从与其加载地址不同的地址运行。
device_cmd.h：与 device_cmd.c 文件密切相关的头源文件。
device_cmd.opt：在 Code Composer Studio 工程的上下文中，OPT 文件中的条目是 CMD 工具所需的编译器选项。这些选项会自动附加到工程中。
device_cmd.cmd.genlibs：在 Code Composer Studio 工程的上下文中，GENLIBs 文件中的条目是 CMD 工具所需的链接器选项。如果链接器在工程属性中引用该文件，这些选项会自动附加到工程中。

3.1 device_cmd.cmd 文件

device_cmd.cmd 文件包含链接器 cmd 条目。

图 3-1 生成的文件 - CMD 文件

.cmd 文件的“存储器”部分中的条目包括存储器组合块。该文件显示存储器组合的大小和来源。

仅当特定段选择了有效的“加载存储器”条目时，才会显示 .cmd 文件的“段”部分中的条目。

图 3-2 生成的文件 - CMD 文件段

3.2 支持文件

附加的 device_cmd.c、device_cmd.h、device_cmd.opt 和 device_cmd.cmd.genlibs 是该工具生成的支持文件。

代码生成包括一款 LIVE DIFF 工具，该工具展示了 GUI 中的更改如何导致生成的代码发生变化。

如果您决定必须从不同的地址加载并运行段，则链接器 cmd 文件中生成的条目格式会自动更改。

图 3-3 生成的文件 - CMD File Diff

停用将复制表置于 BINIT 段中后，.c 和 .h 文件也会更新，并且系统会自动生成所需的初始化代码。

图 3-4 生成的文件 - 复制表

您需要在应用代码中调用 CMD_init 函数来初始化此类区段。C2000 器件的 device.c 包含一个 Device_init 函数，如果需要，可用来调用 CMD_init 函数。

图 3-5 生成的文件 - C 文件

device_cmd.opt 和 device_cmd.cmd.genlibs 自动设置 Code Composer Studio 工程属性。

OPT 文件为 CMDTOOL 和活动 CMD 模块实例名称创建预定义符号。

图 3-6 生成的文件 - OPT 文件

这些预定义符号用于应用 C 代码：device.c 和 device.h 文件。

device_cmd.cmd.genlibs 文件遵循类似的路径。

图 3-7 生成的文件 - Genlibs 文件

4 跨器件系列迁移

使用 C2000 SysConfig 工具的用户可以利用 SWITCH 按钮将其设计从一个器件系列迁移到另一个器件系列。

图 4-1 器件迁移 - SWITCH

迁移完成后，系统将标识 SysConfig 工具生成的所有修改后的文件。

图 4-2 器件迁移 - 文件已更改

每个文件还标识所生成代码中的更改。

图 4-3 器件迁移 - 文件更改

文件差异指示由于迁移而发生的所有更改。

5 总结

C2000 链接器 CMD 工具是一款直观的图形用户界面工具，可针对给定应用配置器件存储器。该工具可通过提供错误检查、自动工程设置、自动代码生成和器件系列迁移支持，显著简化用户的软件开发流程。

6 参考文献

视频系列：

C2000 SysConfig 的优势：

德州仪器 (TI)：利用 SysConfig 并借助 C2000™ 实时 MCU 加速开发

应用手册 - C2000 SysConfig 分步使用指南：

德州仪器 (TI)：C2000 SysConfig

软件入门指南：

重要声明和免责声明

TI 均以“原样”提供技术性及可靠性数据（包括数据表）、设计资源（包括参考设计）、应用或其他设计建议、网络工具、安全信息和其他资源，不保证其中不含任何瑕疵，且不做任何明示或暗示的担保，包括但不限于对适销性、适合某特定用途或不侵犯任何第三方知识产权的暗示担保。

所述资源可供专业开发人员应用TI 产品进行设计使用。您将对以下行为独自承担全部责任：(1) 针对您的应用选择合适的TI 产品；(2) 设计、验证并测试您的应用；(3) 确保您的应用满足相应标准以及任何其他安全、安保或其他要求。所述资源如有变更，恕不另行通知。TI 对您使用所述资源的授权仅限于开发资源所涉及TI 产品的相关应用。除此之外不得复制或展示所述资源，也不提供其它TI或任何第三方的知识产权授权许可。如因使用所述资源而产生任何索赔、赔偿、成本、损失及债务等，TI对此概不负责，并且您须赔偿由此对TI 及其代表造成的损害。

TI 所提供产品均受TI 的销售条款 (http://www.ti.com.cn/zh-cn/legal/termsofsale.html) 以及ti.com.cn上或随附TI产品提供的其他可适用条款的约束。TI提供所述资源并不扩展或以其他方式更改TI 针对TI 产品所发布的可适用的担保范围或担保免责声明。IMPORTANT NOTICE

邮寄地址：上海市浦东新区世纪大道 1568 号中建大厦 32 楼，邮政编码：200122