第一篇 新建DSP工程-基于TMS320F280049

0. 前言

---

很多人在学习DSP时都是直接拿官方例程来跑或是在已有的程序模板上进行开发，忽略了自己建立一个从零开始的完整工程的重要性。只有自己新建工程，才清楚一个工程需要包含哪些文件，才会去想每个文件所代表的含义。掌握新建工程的方法会对我们后续程序的开发、程序的调试以及更好的理解程序的运行机制有很大帮助。本篇就来讲述如何建立一个从零开始的完整工程。

---

1. 新建工程需要的工具

1.1 CCS集成开发环境

我们需要准备Code Composer Studio(CCS)软件，该软件是TI官网免费提供的集成开发环境(IDE)，TI公司每隔一段时间会对其进行版本更新，目前我个人使用的是CCS9.2版本。
CCS下载链接如下：
http://www.ti.com/ccstudio

1.2 C2000Ware

我们需要安装C2000Ware，这是TI官网针对C2000系列微控制器提供的一个有利的学习资料库，同时也为软件工程师提供了各种软件开发需要的资料，包括头文件，源文件，库文件及链接文件等等。
软件安装包及安装路径如下，安装路径可根据自己的需要随意选择：

C2000Ware安装包下载链接如下：
www.ti.com/tool/C2000WARE

2. 新建工程

2.1 新建一个工程存放文件夹

首先在桌面上建一个Template文件夹，便于我们工程后续的管理，当然你也可以根据自己的喜好随意更改文件夹名字及路径，我个人习惯放在桌面上。

2.2 新建工程的基本步骤

（1）打开CCS软件，在Project Explorer下方空白处右键，选择New->CCS Project，或者点击工具栏上方的Project->New CCS Project ，将会弹出New CCS Project对话框；

（2）选择DSP芯片型号，这一步根据自己所使用的芯片型号进行选择，我所使用的芯片型号是TMS320F280049，
（3）选择Connection类型，这一步根据自己所使用的仿真器进行选择，我所用的仿真器是100V3。
（4）为工程命名，命名只能使用字母，下划线和数字，中间不要含有空格（包含其它字符编译可能会出错），工程名字最好使用具有项目实际意义的英文缩写。
（5）选择工程路径：将Use default localtion前面的√去掉，选择我们刚刚所建立的Template文件夹作为工程存放的路径。
（6）选择带有主函数的工程模板。

（7）点击Tool-chain，选择输出形式为elf文件。

（8）点击finish即可生成工程，新生成的工程如图所示。

3. 从C2000Ware添加需要的文件

在开始添加文件之前，首先在Template文件夹下新建4个子文件夹：
（1）建立include子文件夹，用于存放头文件；
（2）建立source子文件夹，用于存放源文件；
（3）建立cmd子文件夹，用于存放cmd文件；
（4）建立library子文件夹，用于存放lib库文件。
建好的Template文件夹如下图。

3.1 添加源文件

（1）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\device_support\f28004x\headers\source中的.c文件复制到C:\Users\Administrator\Desktop\Template\source文件夹。

（2）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\device_support\f28004x\common\source下的源文件全部拷贝到C:\Users\Administrator\Desktop\Template\source文件下，复制完成后如图所示。


（3）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\driverlib\f28004x\driverlib下的源文件全部拷贝到C:\Users\Administrator\Desktop\Template\source文件下，复制完成后如图所示。


（4）将main.c文件剪切到source文件夹下

3.2 添加头文件

（1）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\device_support\f28004x\headers\include下的.h文件全部复制到C:\Users\Administrator\Desktop\Template\include文件夹下。

（2）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\device_support\f28004x\common\include下的头文件全部复制到C:\Users\Administrator\Desktop\Template\include路径下，复制完成后如图所示。


（3）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\driverlib\f28004x\driverlib下的头文件（.h）全部拷贝到C:\Users\Administrator\Desktop\Template\include文件下，复制完成后如图所示。

3.3 添加cmd文件

（1）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\device_support\f28004x\headers\cmd下的cmd文件复制到C:\Users\Administrator\Desktop\Template\cmd文件夹下。

（2）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\device_support\f28004x\common\cmd下的2个cmd文件复制到C:\Users\Administrator\Desktop\Template\cmd文件夹下，其它cmd我们暂且用不到，后续如果用到再根据需要进行添加，添加完成后如图所示。

3.4 添加inc和ccs文件夹

将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\driverlib\f28004x\driverlib下的inc和ccs文件夹直接复制到C:\Users\Administrator\Desktop\Template文件下，复制完成后如图所示。

3.5 添加lib文件

（1）打开ccs安装目录，将路径C:\ti\ccs920\ccs\tools\compiler\ti-cgt-c2000_18.12.3.LTS\lib中的rts2800_fpu32_eabi.lib文件复制到C:\Users\Administrator\Desktop\Template\library文件夹下

（2）将路径D:\TI\C2000\C2000Ware_DigitalPower_SDK_3_00_01_00\c2000ware\libraries\math\FPUfastRTS\c28\lib下的rts2800_fpu32_fast_supplement_eabi.lib文件复制到C:\Users\Administrator\Desktop\Template\library文件夹下

复制完成后如图所示。

所有步骤完成后，工程文件夹如图所示。

4. 文件链接过程

在上一节我们添加了各种工程需要的文件，但编译器并不能有机的将它们结合起来，还需要我们进行如下操作。

4.1 添加头文件路径

单击工程选中后，点击鼠标右键，选择Properties

弹出如下对话框，点击Build->C2000 Compiler->Inculde Options->Add图标

弹出如下对话框，Workspace代表相对路径，Browse代表绝对路径，选绝对路径当文件夹被复制到其它电脑会报错，选择相对路径，直接输入${PROJECT_ROOT}\include，此时当文件在被复制到其它位置时依然可以找到头文件。

添加完头文件如图所示。

4.2 添加数学计算库

（1）点击Build->C2000 Linker->File Search Path->Add图标（与添加头文件的图标一样），在对话框中输入${PROJECT_ROOT}/rts2800_fpu32_fast_supplement_eabi.lib，点击OK。

（2）同样步骤在对话框中输入${PROJECT_ROOT}/rts2800_fpu32_eabi.lib}，点击OK。

添加完成后如图所示。

4.3 选择cmd文件

选中不需要的cmd文件，点击鼠标右键，选择Exclude from Build。

完成后如图所示，不参与编译的图标变成了灰色。。

5. 编译

选中工程，点击如下编译图标。

编译完成会报两个警告。

将下面的两个文件删除或右键选择Exclude from Build，重新编译，程序将不会再报警告。

6. 总结

以上仅仅是建立了一个简单的工程，还存在很多问题，但由于时间关系本篇先写到这里，后续文章再对其进行补充，包括有些文件为什么要这么添加，每个文件所代表的含义等。