总结摘要
使用 driverlib 库在 Code Composer Studio 建立 DSP28377D 的 EABI 项目。首先建立项目文件。其次，配置头文件和库文件的链接路径。再次，修改项目配置将代码分别烧录到 FLASH 和 RAM。最后，给出一个标准的main函数示例。
前言
从新版本（Code Composer Studio Theia 20.0.0）开始，官方不再建议新建项目，而是从空示例项目文件新建导入。新版本新建项目时，也是从空示例项目中进行选择。当选择 driverlib 进行开发时，空示例项目所在的路径如下（需要根据C2000Ware安装路径进行修改）：
1
| E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\driverlib\f2837xd\examples\cpu1\empty_projects
|
新版本创建项目的流程就是导入示例项目，然后根据需求进行自定义修改。下面是导入示例项目的步骤：
导入项目后，如果项目文件夹不在工作区文件夹中，CCS会自动将导入的项目拷贝到工作区文件夹中。
建立 EABI 项目
考虑可能存在定制化项目模板的需求，这里记录一下建立新项目的具体流程，以备后续参考。
注意
如果新版本的芯片存在示例空项目，建议在示例项目的基础上进行定制化。
新建项目文件
首先，点击菜单栏的 Project 菜单，选择 New CCs Project 功能，操作步骤和弹出的新出项目对话框如下图所示。
- 芯片选择：新建项目时首先选择芯片系列，然后选择具体的芯片。也可以直接选择具体的芯片，但是选项太多了。
- 调试器选择：在新建项目时，可以先不选择具体的调试设备，之后通过新建 Target Configuration File 进行设置。
- 设置项目名称：项目名称的要求与C语言变量名要求一致，但是可以以数字开头，如果项目名非法时，对话框上方会进行提示。建议将项目名称设置和具体项目要求一致。
- 选择编译器：编译器直接选择最新版本即可。
- 项目类型和工具链配置：因为是要烧录到芯片中的项目，所以输出类型选择可执行文件（Executable），输出文件格式选择eabi(ELF)，EABI 为为最新的文件格式，为 ti 推荐的文件格式。链接文件和运行库文件之后配置。
- 选择项目模板：直接选择空项目模板带有 main.c 文件。
- 建立项目：配置完成后，点击 Finish 建立项目。
新建项目完成后，新建的项目将显示在项目浏览器（Project Explorer）中，如果 Project Explorer 未打开，可以点击菜单栏中的 View 菜单，选择 Project Explorer。
拷贝头文件和库文件
为了顺利编译项目，需要配置 driverlib 相关的头文件和库文件。
在 Project Explorer 窗口中选中当前创建的项目，然后点击鼠标右键，依次选择 Show In -> System Explorer，在打开的文件夹中双击项目名称对应的文件夹，进入项目文件夹并新建 C2000Ware 文件夹。
进入C2000Ware文件夹，将 2837xd 的 driverlib 文件夹中的所有文件拷贝到到 C2000Ware 文件夹内（根据具体芯片和 C2000Ware 包安装路径进行修改）。
1
| E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\driverlib\f2837xd\driverlib
|
在 C2000Ware 文件夹中新建 device 文件夹，将下面的文件拷贝到device 文件夹内。
1
2
3
4
| E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\device_support\f2837xd\common\include\device.h
E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\device_support\f2837xd\common\include\driverlib.h
E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\device_support\f2837xd\common\source\device.c
E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\device_support\f2837xd\common\source\F2837xD_CodeStartBranch.asm
|
在 C2000Ware 文件夹中新建 cmd 文件夹，将下面的文件拷贝到cmd 文件夹内。
1
2
| E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\device_support\f2837xd\common\cmd\2837xD_FLASH_lnk_cpu1.cmd
E:\CodeComposerStudio\C2000Ware\C2000Ware_5_04_00_00\device_support\f2837xd\common\cmd\2837xD_RAM_lnk_cpu1.cmd
|
在 C2000Ware 文件夹中新建 libs 文件夹，将 C2000 芯片的 lib 文件拷贝到 libs 文件夹中。lib 文件只有编译器的版本有关，在新建项目时选择的编译器版本为 TI v22.6.1.LTS。
1
| E:\CodeComposerStudio\CCS12.7\ccs\tools\compiler\ti-cgt-c2000_22.6.1.LTS\lib\rts2800_fpu32_eabi.lib
|
将无关文件排除编译
排除源代码文件
回到 CCS 软件中，在 Project Explorer 中选择新建的项目文件依次打开 C2000Ware -> driverlib，选中所有的源文件(.c 文件)后点击鼠标右键选中 Exclude from Build 选项。如果不采用 TI 编译好的 driverlib 库文件就跳过这一步。
排除无关库文件
项目编译时采用 Release 配置编译的 driverlib 库文件，将 Debug 配置编译的库文件禁用（后续项目不使用可直接删除）。在 Project Explorer 中选择新建的项目文件依次打开 C2000Ware -> driverlib -> ccs 文件夹，选择 Debug 文件夹，点击鼠标右键选中 Exclude from Build 选项。
只有选择 COFF文件格式时才会采用 C2000Ware -> driverlib -> ccs -> Release 文件夹中的 driverlib_coff.lib 文件。打开资源管理器，直接删除driverlib_coff.lib 文件。
添加头文件和库文件引用
在 Project Explorer 中选中新建的项目，在项目名称上单击鼠标右键选择 Properties 选项打开项目属性对话框（Alt + Enter）。
添加头文件引用
在打开的项目属性对话框中依次选择 CCS Build -> C2000 Compiler -> Include Options 选项，在 Add dir to #include search path (–include_path -I) 中点击添加头文件引用按钮。
在打开的 Add directory path 对话框中点击 Workspace... 按钮，依次选择 新建的项目 -> C2000Ware -> device 文件夹，然后点击 Ok 按钮，将 device 文件夹添加到头文件搜索路径。
按照相同的方式，将 C2000Ware/driverlib 和 C2000Ware/driverlib/inc 文件夹添加到头文件搜索路径中。
添加库文件引用
TI 的 cl2000 编译器在进行链接时，会自动链接项目目录中的所有 lib 文件，因此不需要将库文件添加到库文件搜索路径（只有库文件不在项目目录中时才配置 File Search Path）。
链接时，应将库文件放在最后的位置， cl2000 链接器会在库文件中查找未定义的符号定义。编译时的链接命令如下：
1
| "E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/bin/cl2000" -v28 -ml -mt --cla_support=cla1 --float_support=fpu32 --tmu_support=tmu0 --vcu_support=vcu2 --advice:performance=all --define=CPU1 --define=_FLASH -g --diag_warning=225 --diag_wrap=off --display_error_number --abi=eabi -z -m"EmptyProject.map" --stack_size=0x200 --warn_sections --disable_auto_rts --diag_wrap=off --display_error_number --issue_remarks --xml_link_info="EmptyProject_linkInfo.xml" --rom_model -o "EmptyProject.out" "./main.obj" "./C2000Ware/device/F2837xD_CodeStartBranch.obj" "./C2000Ware/device/device.obj" "../C2000Ware/cmd/2837xD_FLASH_lnk_cpu1.cmd" "../C2000Ware/driverlib/ccs/Release/driverlib.lib" "../C2000Ware/driverlib/ccs/Release/driverlib_eabi.lib" "../C2000Ware/libs/rts2800_fpu32_eabi.lib"
|
在使用 CCS 进行编译链接时，库文件不总是出现在最后的位置上，可添加 --priority 的链接器选项，按照库文件的优先级顺序查找符号定义。
当项目中存在多个库文件时，库文件的链接优先级配置路径为 CCS Build -> Link Order。
将 driverlib_eabi.lib 添加到链接优先级后，需要删除 driverlib.lib 文件（或者勾选 Exclude from Build 选项）来消除编译警告。
设置烧录的 CPU
28377D 有两个 CPU，一个 CPU 对应一个独立的项目，因此需要为项目指定烧录到那个 CPU 中。如果不指定 CPU 直接进行项目编译将提示下面的错误。
1
| #35 #error directive: "You must define CPU1 or CPU2 in your project properties. Otherwise, the offsets in your header files will be inaccurate."
|
打开项目属性对话框，依次选择 CCS Build -> C2000 Compiler-> Predefined Symbols 选项，在 Pre-define NAME (--define, -D) 中点击添加预定义宏按钮，添加宏 CPU1，如果要烧录到 CPU2 则添加宏 CPU2。
添加 FLASH 和 RAM 烧录配置
cmp 文件用于配置代码和数据的存放位置、加载位置和运行位置。 为了实现一个项目可以同时烧录到 FLASH 和 RAM 中，需要建立两个配置文件，并在配置文件中设置对应的 cmd 文件。在新建项目时 CCS 会自动建立 Debug 和 Release 这两个配置文件，并激活 Debug 配置。上面已经在 Debug 配置中设置了头文件和库文件，为了简化流程，直接用 Debug 配置烧录到 RAM。
首先在 Project Explorer 确定当前激活的配置为 Debug ，然后在 2837xDFLASH_Ink_cpu1.cmd 文件中点击鼠标右键选中 Exclude from Build 。
打开项目属性对话框，选择 CCS General 选项，点击 Manage Configurations... 按钮，将 Debug 配置重命名为 CPU_RAM 。
在项目配置对话框中选择 Release 配置，删除 Release 配置，点击 New ... 按钮新建 CPU_FLASH 配置，并点击 Set Active按钮激活 CPU_FLASH 配置。回到 Project Explorer 中确定当前激活的配置为 CPU_FLASH 。在 2837xDFLASH_Ink_cpu1.cmd 文件中点击鼠标右键取消选中 Exclude from Build ，在 2837xD_RAM_Ink_cpu1.cmd 文件中点击鼠标右键选中 Exclude from Build 。
在预定义宏对话框中添加 _FLASH 宏，保证 FLASH 相关代码能够正确执行。预定义宏对话框的路径为 CCS Build -> C2000 Compiler-> Predefined Symbols 。添加后 _FLASH 宏后的结果如下图所示：
重要
将代码烧录到 FLASH 时，激活 CPU_FLASH 配置；将代码烧录到 RAM 时，激活 CPU_RAM 配置。然后编译项目进行烧录即可。
确定编译和链接选项
在进行项目烧录时，还需要打开项目属性对话框确定编译选项和链接选项，以保证程序正确编译。编译选项的路径为 CCS Build -> C2000 Compiler ，链接选项的路径为 CCS Build -> C2000 Linker 。
CPU_RAM 配置中的编译选项如下：
1
| -v28 -ml -mt --cla_support=cla1 --float_support=fpu32 --tmu_support=tmu0 --vcu_support=vcu2 -Ooff --include_path="D:/Codes/DSP28377D/EmptyProject" --include_path="D:/Codes/DSP28377D/EmptyProject/C2000Ware/device" --include_path="D:/Codes/DSP28377D/EmptyProject/C2000Ware/driverlib" --include_path="D:/Codes/DSP28377D/EmptyProject/C2000Ware/driverlib/inc" --include_path="E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/include" --define=CPU1 --diag_suppress=10063 --diag_warning=225 --diag_wrap=off --display_error_number --abi=eabi
|
CPU_RAM 配置中的链接选项如下：
1
| -v28 -ml -mt --cla_support=cla1 --float_support=fpu32 --tmu_support=tmu0 --vcu_support=vcu2 -Ooff --define=CPU1 --diag_suppress=10063 --diag_warning=225 --diag_wrap=off --display_error_number --abi=eabi -z -m"EmptyProject.map" --stack_size=0x200 --warn_sections -i"E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/lib" -i"E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/include" --priority --disable_auto_rts --diag_wrap=off --display_error_number --xml_link_info="EmptyProject_linkInfo.xml" --rom_model
|
CPU_FLASH 配置中的编译选项如下：
1
| -v28 -ml -mt --cla_support=cla1 --float_support=fpu32 --tmu_support=tmu0 --vcu_support=vcu2 --include_path="D:/Codes/DSP28377D/EmptyProject" --include_path="D:/Codes/DSP28377D/EmptyProject/C2000Ware/device" --include_path="D:/Codes/DSP28377D/EmptyProject/C2000Ware/driverlib" --include_path="D:/Codes/DSP28377D/EmptyProject/C2000Ware/driverlib/inc" --include_path="E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/include" --define=CPU1 -g --diag_warning=225 --diag_wrap=off --display_error_number --abi=eabi
|
CPU_FLASH 配置中的链接选项如下：
1
| -v28 -ml -mt --cla_support=cla1 --float_support=fpu32 --tmu_support=tmu0 --vcu_support=vcu2 -Ooff --define=CPU1 --diag_suppress=10063 --diag_warning=225 --diag_wrap=off --display_error_number --abi=eabi -z -m"EmptyProject.map" --stack_size=0x200 --warn_sections -i"E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/lib" -i"E:/CodeComposerStudio/CCS12.7/ccs/tools/compiler/ti-cgt-c2000_22.6.1.LTS/include" --priority --disable_auto_rts --diag_wrap=off --display_error_number --xml_link_info="EmptyProject_linkInfo.xml" --rom_model
|
对于每个选项的详细信息可参考
TMS320C28x 优化 C/C++ 编译器v22.6.0.LTS (Rev. Z)
。
标准的 main 函数示例
参考官方的示例程序，设计出一个标准的 main 函数示例模板如下：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
| //
// Included Files
//
#include "driverlib.h"
#include "device.h"
void main()
{
//
// Initialize device clock and peripherals
//
Device_init();
//
// Disable pin locks and enable internal pullups.
//
Device_initGPIO();
//
// Initialize PIE and clear PIE registers. Disables CPU interrupts.
//
Interrupt_initModule();
//
// Initialize the PIE vector table with pointers to the shell Interrupt
// Service Routines (ISR).
//
Interrupt_initVectorTable();
//
// Interrupts that are used in this example are re-mapped to ISR functions
// found within this file.
//
Interrupt_register(INT_ADCA1, &adcA1ISR);
//
// Initialize all the Device Peripherals
//
InitPeripherals();
//
// Enable ADC interrupt
//
Interrupt_enable(INT_ADCA1);
//
// Enable Global Interrupt (INTM) and realtime interrupt (DBGM)
//
EINT;
ERTM;
//
// User specific code
//
}
//
// End of File
//
|
