4. C2000开发环境与工程模板
在开始写第一行电机控制代码之前，先把工具链和工程骨架搭对，比后面调不通再回头排查要省事得多。C2000的开发环境不是单一软件，而是由几个层次分明的组件拼起来的：CCS是集成开发环境（编辑器、编译器、调试器、烧录器都在里面）；C2000Ware是TI官方的器件支持包，包含头文件、外设示例、driverlib库和文档；driverlib是C2000Ware里的一套外设驱动库，用函数调用替代直接写寄存器；SysConfig是图形化配置工具，把引脚、时钟、外设参数变成可视化配置并自动生成初始化代码；电机控制SDK（C2000 MotorControl SDK）则是在上述基础上封装好的电机控制算法与工程框架，包含FOC、电流环、速度环、位置环等模块。
理解它们的关系，可以用一个“从底层到应用”的层次来看：芯片硬件 → driverlib（寄存器级封装）→ SysConfig（配置生成）→ 电机控制SDK（算法与工程模板）→ 用户应用代码。CCS是承载这一切的容器，C2000Ware是提供底层素材的仓库。下面这张图展示了各组件在工程中的位置与数据流向。
下面按实际操作顺序，说明如何从零搭出一个可编译、可烧录、可调试的最小工程。
第一步：安装与版本匹配
先装CCS，建议选较新的稳定版本（如CCS 12.x或20.x），安装时勾选C2000器件支持。装完后在CCS内通过Help → Install New Software或直接下载安装包，安装C2000Ware和MotorControl SDK。这里有一个容易踩的坑：CCS、C2000Ware、MotorControl SDK三者的版本必须兼容。例如MotorControl SDK 4.x通常要求C2000Ware 4.x以上、CCS 10.x以上。版本不匹配时，导入的工程可能报“找不到头文件”或“driverlib版本冲突”。建议在TI官网查看SDK的Release Notes，确认依赖版本后再安装。
安装完成后，在CCS中通过Window → Preferences → Code Composer Studio → Build → Variables检查几个关键路径变量是否已自动设置：C2000WARE_ROOT、MOTORCONTROL_SDK_ROOT、CG_TOOL_ROOT。如果缺失，需要手动添加，否则工程编译时会找不到库文件。
第二步：导入最小工程模板
不要从空白工程开始，那样要手动配置链接命令文件（.cmd）、库路径、头文件路径，容易出错。推荐从C2000Ware或MotorControl SDK中导入一个最接近目标的最小例程，再逐步裁剪。
以F280049C为例，在CCS中点击Project → Import CCS Projects，浏览到C2000Ware安装目录下的device_support/f28004x/examples/，选择一个最简单的例程，比如gpio_ex1_setup或epwm_ex1_trip_zone。导入后先编译一次，确认工具链、库路径、芯片支持包都正常。这一步能跑通，说明环境基本没问题。
如果要做电机控制，更直接的方式是从MotorControl SDK导入一个FOC例程，例如boostxl_drv8305_f280049c或launchxl_f280049c对应的工程。这类工程已经包含：SysConfig配置文件（.syscfg）、driverlib库、电机控制算法模块、硬件抽象层、以及针对特定BoosterPack的引脚配置。导入后先不修改代码，直接编译烧录，观察电机是否能按默认参数转动。能转，说明硬件连接和底层配置正确，再在此基础上改参数、改算法。
第三步：理解工程目录结构
一个典型的C2000电机控制工程包含以下关键文件与目录：
- .syscfg文件：SysConfig图形化配置文件，双击可在CCS中打开图形界面，配置引脚、EPWM、ADC、时钟等。保存后自动生成
syscfg/目录下的C代码。 - main.c：主程序入口，包含初始化调用、主循环、中断服务函数。
- driverlib.lib或driverlib源文件：外设驱动库，工程属性中需正确设置库搜索路径。
- .cmd链接命令文件：定义存储器映射，把代码和数据分配到Flash或RAM。调试阶段常用RAM版本（
_ram.cmd），量产时切换到Flash版本（_flash.cmd）。 - include/：头文件目录，包含芯片寄存器定义、SDK模块头文件。
- source/或modules/：电机控制算法源文件，如FOC、PID、Clarke/Park变换等。
第四步：SysConfig配置要点
双击.syscfg文件进入图形界面。以配置EPWM1A/1B输出互补PWM为例：在左侧选择EPWM模块，使能EPWM1，设置时基周期（TBPRD）、计数模式（增减计数）、死区时间（DBRED/DBFED）、以及GPIO引脚映射。配置完成后，SysConfig会自动生成Board_init()和EPWM_init()等函数，在main.c中调用即可，不需要手写寄存器配置。
需要注意：SysConfig生成的引脚配置会与手动写的GPIO配置冲突。如果工程中既有SysConfig又有手写初始化，要确保两者不重复配置同一引脚，否则后配置的会覆盖先配置的。建议统一用SysConfig管理所有外设引脚。
第五步：编译、烧录与最小验证
编译前检查工程属性中的Include Options是否包含C2000Ware和SDK的头文件路径，File Search Path是否包含driverlib库路径。编译通过后，连接仿真器（如XDS110或XDS200），点击Debug进入调试模式，再点击Run。如果工程中有LED闪烁或PWM输出，可以用示波器观察对应引脚波形，确认EPWM频率和占空比与SysConfig设置一致。
一个实用的最小验证方法是：在main循环中翻转一个GPIO，用示波器测频率。例如系统时钟100MHz，循环中每次翻转间隔约100个时钟周期，则方波频率约为500kHz。实际频率会因编译优化和循环体指令数不同而有偏差，但能确认程序在运行、GPIO在翻转、时钟配置正确。
把上述步骤走通一遍，你就有了一个可编译、可烧录、可调试的最小工程骨架。后续的电机控制算法开发，都是在这个骨架上增加模块、调整参数、验证波形。环境搭对了，后面才不会被工具问题打断思路。