TMS320F280049系列文章之第二章 工程搭建实战：从零配置到路径设置的避坑指南
1. 工程准备与环境搭建
第一次接触TMS320F280049开发的朋友，可能会被复杂的工程配置劝退。别担心，跟着我的步骤走，保证你能顺利搭建第一个工程。我用的环境是CCS10.3.1和C2000Ware_4_01，这也是目前比较稳定的组合。
先说说准备工作。建议在D盘根目录下新建一个工作区文件夹，比如我的是D:\CCS10.3.1\Workspace。这个路径要记住，后面会频繁用到。千万别用中文路径，这是很多新手容易犯的错误。我之前就踩过这个坑，编译时各种莫名其妙的错误，最后发现是路径里有中文。
接下来打开CCS，选择File->New->CCS Project。这里有个关键点：Output format要选eabi(ELF)。老版本的COFF格式现在已经不太用了，选错这个后面会遇到一堆兼容性问题。工程名字随便起，我习惯用Template，方便以后复用。
2. 工程目录结构与文件复制
工程创建好后，我们需要规划好目录结构。在工程文件夹下新建几个子文件夹：
- source：存放所有.c源文件
- include：存放.h头文件
- cmd：存放链接脚本
- library：存放库文件
这个结构看起来简单，但实际操作时很容易搞混。我第一次做的时候就把头文件和源文件混在一起，结果编译时找不到头文件。建议严格按照这个结构来，后面维护会轻松很多。
复制文件是最容易出错的一步。需要从C2000Ware中复制以下几类文件：
- device_support下的common和headers文件夹中的源文件
- driverlib文件夹中的驱动库文件
- math库中的FPU快速运行库
- 编译器自带的运行时库
具体操作时，我建议先列个清单，把要复制的文件路径都写下来，复制一个勾一个。这样不容易漏掉关键文件。记得复制完成后要检查文件数量是否一致，我就遇到过复制中途出错，结果少了几十个文件的情况。
3. 关键路径配置实战
路径配置是工程搭建中最关键也最容易出错的部分。这里要配置三种路径：
- 头文件包含路径
- 库文件搜索路径
- 链接脚本路径
在CCS中，右键工程选择Properties，找到Build->C2000 Compiler->Include Options。这里要添加两个绝对路径：include文件夹和H_driverlib文件夹的完整路径。注意一定要用绝对路径，相对路径在工程移动后会失效。
然后是库文件配置，在Linker->File Search Path中添加library文件夹的路径。最后在General->Linker command file中选择cmd文件夹下的链接脚本。我一般先用RAM版本的脚本调试，等程序稳定后再换成Flash版本。
4. 常见编译错误解决
即使严格按照步骤操作，第一次编译往往还是会遇到各种错误。最常见的就是符号重定义错误，比如：
error #10056: symbol "XXX" redefined这种错误通常是因为同一个符号在多个文件中定义了。解决方法很简单，找到重复定义的文件，在工程中右键选择Exclude from Build排除掉即可。
另一个常见问题是delay函数报错。这是因为从旧工程复制过来的usdelay.asm文件格式不兼容。需要修改文件开头的定义，把下划线去掉。具体修改方法可以参考我之前的代码示例。
警告信息一般可以忽略，比如变量定义但未使用的警告。但如果警告太多，建议还是处理一下，保持代码整洁。
5. 工程验证与优化
编译通过后，建议做几个简单测试验证工程是否配置正确。比如写个简单的GPIO闪烁程序，或者用串口打印一些信息。这样可以确保所有基础功能都正常工作。
工程优化方面，我建议：
- 定期清理工程，删除不需要的文件
- 使用版本控制工具管理工程
- 做好文档记录，特别是路径配置信息
- 建立模板工程，避免每次都要从头配置
记住，一个好的工程结构能节省大量调试时间。我现在的做法是维护一个基础模板工程，所有新项目都基于这个模板创建，省去了重复配置的麻烦。