1. 项目定位：为什么是28335，为什么用Simulink
1.1 TMS320F28335的核心定位
做电机控制和电力电子嵌入式开发的工程师，十有八九都绕不开TMS320F28335这颗芯片。作为C2000系列里非常经典的浮点DSP，它在150MHz的主频下集成了FPU浮点运算单元，内置12bit ADC和多路带死区控制的高分辨率PWM，还带eQEP正交编码接口、eCAP捕获模块、SCI/SPI/CAN等丰富外设。放到今天的视角看，它不算新，但工业界存量项目非常多，很多长期运行的电源、伺服、逆变器产品用的就是这颗芯片。选择它不是因为“最新”，而是因为它成熟、资料全、生态完善，尤其适合做对实时性要求高的闭环控制。
用28335做控制的传统路线是手写C，寄存器层面配置外设，算法代码全部自己维护。这套路当然没毛病，但当控制算法越来越复杂，比如在永磁同步电机上做FOC矢量控制，又要带弱磁、SVPWM、死区补偿、观测器，代码量一上来，手写C的维护成本就很高。于是越来越多团队转向“基于模型设计”的路线——在Matlab Simulink里搭好控制模型，仿真验证无误后，直接自动生成C代码部署到DSP上。这整套流程就是我们这个项目的核心。
1.2 Simulink与嵌入式模型的价值
Simulink做嵌入式模型，核心价值不在于“不用写代码”，而在于把算法开发和硬件解耦。控制算法的设计、调试、优化都可以在模型层面完成，仿真环境里可以任意改变工况、注入故障、观察变量，这些东西在真机上是很难做到的。你可以在模型里看到电机的电流波形、转速响应、占空比变化，把PI参数收敛到满意了，再生成代码去跑真机，剩下的就只是微调。
很多人会质疑自动生成代码的效率。我的实测体会是：对于28335这种芯片，Simulink配合Embedded Coder生成的代码质量已经很成熟，中断服务函数、外设寄存器初始化、PWM比较值更新这些事情都能可靠地完成。相比手写C，代码体积会大一些，运行效率稍低一点，但完全在28335的资源范围之内。而且在开发阶段省下的时间非常可观，尤其在算法结构频繁调整的时候，改模型比改C代码快得多。
1.3 典型应用场景
这个项目覆盖的场景很典型：电机驱动的电流环和速度环、三相并网逆变器、双向DC-DC变换器、数字电源等。凡是需要ADC采样反馈、PWM输出控制、中断实时处理的系统，都适合用这套方案。
举个例子，我做过的某PMSM电机驱动Demo，要求在20kHz的电流环频率下做FOC双闭环。如果手写C，光是把ADC采样、坐标变换、SVPWM、PI调节器这一整套串起来就要写上千行代码，还要自己在CCS里调试。用Simulink做嵌入式模型，整个算法用模块搭出来只需要一两天，仿真通过后生成代码直接下载到28335，再配合示波器对比波形，问题定位也直观得多。这篇文章就是把这套流程从环境搭建到实机调试完整拆开来讲。
2. 开发环境搭建与模型架构设计
2.1 工具链与版本匹配
做28335的Simulink嵌入式模型开发，工具链由四部分组成：Matlab/Simulink本体、Embedded Coder代码生成器、C2000处理器支持包、CCS集成开发环境。这四者的版本匹配非常关键，也最容易踩坑。
我的经验是：先用Matlab的Add-On Explorer安装“Embedded Coder Support Package for Texas Instruments C2000 Processors”，安装过程中它会自动检测电脑上的CCS版本。如果顺序装反了，支持包识别不到CCS的编译工具链，后面生成代码就无法完成自动编译下载。不同的Matlab版本对CCS版本的支持范围不同，建议安装前查一下官方支持矩阵。
遇到过识别不到CCS的情况，不用急着重装，可以手动设置环境变量指定CCS安装路径，再把支持包重新运行一遍配置向导，基本就能解决。另外，仿真器和目标板的驱动也要提前装好，常用的XDS100、XDS110驱动都要在CCS里验证连通。
2.2 模型分层与子系统规划
Simulink模型不是把整个系统堆在一张画布上，需要分层设计。我一般把模型分成三层：板级外设层、算法控制层、调度接口层。
板级外设层直接调用C2000支持包提供的模块，比如C28x ADC模块、ePWM模块、eQEP模块、SCI模块。算法控制层放坐标变换、PI调节器、SVPWM、滤波等纯数学运算，这一层不掺杂任何硬件信息，理论上拿到任何平台都能复用。调度接口层负责把外设触发的事件连接起来，比如ADC转换完成触发中断服务函数，中断里调用电流环算法函数。
这样分层的好处有两个：第一，算法层可以单独做仿真验证，用信号发生器模拟ADC输入，观察算法输出是否合理，不依赖任何硬件；第二，换芯片平台时，只需要重新设计外设层，算法层原样搬走就行。
2.3 求解器与数据类型关键技术
模型架构搭好了，还要注意求解器和数据类型这两件容易被忽视的事。
求解器要设置为Discrete离散、Fixed-step定步长。步长选择和实际控制周期匹配，比如控制频率10kHz，步长设1e-4秒。如果模型里有Function-Call Subsystem被中断触发，这个子系统由硬件事件驱动，采样时间继承自动设置。另外要注意，生成代码时Simulink会把定步长调度映射到时钟和中断上，所以求解器设置不只是仿真工具参数，而是直接关系到生成代码里任务调度方式。
数据类型上，28335的FPU是单精度浮点，但Simulink模型默认的数据类型往往是double，生成的代码里所有变量都是double类型。在C28x上double的运算效率远不如single，而且占用内存大得多。我的习惯是建立模型后立刻把控制算法层的数据类型强制为single，用Data Type Conversion模块或直接在设计之初就把模块输出类型指定为single。这一个小改动，代码执行时间和RAM占用都会有明显改善。
3. 核心外设模型搭建与参数计算
3.1 ADC采集模块
28335的ADC是12bit逐次逼近型，双排序器结构，最多16个输入通道。在Simulink里，ADC模块要配置采样时间、触发源、采样通道、转换结果格式。
ADC触发源是这里最核心的配置。在电机控制场景里，ADC采样必须和PWM周期同步，通常选ePWM模块的SOC（Start Of Conversion）信号触发。这样可以保证每次采样都发生在PWM周期的固定时刻，避免开关噪声影响采样精度。如果直接选连续采样模式，ADC会一直转换，反而占满CPU资源，采样时刻也飘忽不定，控制效果会很差。
采样窗口参数ACQPS和转换时间相关。计算公式是：总采样时间 = (ACQPS + 1) × SYSCLK周期。28335的SYSCLK是150MHz，周期约6.67ns，如果ACQPS配置为14，则采样窗口约100ns，加上内部转换时间约80ns，整个ADC模块的单次转换总时间在180ns左右。这个时间远小于PWM周期，注意别把采样窗口配太长，否则会出现转换没完成就进入中断的情况。
ADC校准是个容易被忽略的细节。28335的ADC有零点偏移和满量程增益误差，Simulink模型里可以加一个校准子系统：用ADC采样一个已知电压（比如内部参考电压），或者短路输入端采集零点值，然后把偏移值在模型里减掉。我在某项目中做过对比，校准前电流波形有约2%的直流偏置，校完后电流环静态误差明显下降。
3.2 ePWM模块与死区参数
28335有6个ePWM模块，每个模块输出两路互补PWM，带硬件死区生成。在Simulink里配置ePWM模块，需要设置时基、计数器模式、比较值、动作限定、死区、斩波等多项参数。
时基参数直接决定PWM频率。以产生20kHz PWM为例：系统时钟SYSCLKOUT为150MHz，设时基时钟分频CLKDIV为0、高速时钟分频HSPCLKDIV为0，则时基时钟TBCLK就是150MHz。周期寄存器值TBPRD计算公式为：
TBPRD = TBCLK / PWM频率 - 1 = 150MHz / 20kHz - 1 = 7499
这就是典型的定时器周期值，注意Simulink里这些参数是直接以寄存器值填写的，必须先自己做一遍换算。
死区时间的配置类似。假设桥臂需要500ns的死区时间，那么死区寄存器值 = 500ns × 150MHz = 75个时基时钟周期。死区值过小会导致桥臂直通短路，过大会增加输出谐波和调制死区，实际要按功率器件的关断延迟选。我见过一个新手把死区配成了5us，结果电机带载运行时噪声大、电流波形畸变得很厉害。
PWM比较值在算法模型中实时更新。在FOC里，SVPWM模块计算出的占空比要转成比较寄存器的值，Simulink的ePWM模块允许设置比较值的更新方式，通常选“当计数器为零时加载”，可以避免一个PWM周期内比较值变化导致输出混乱。
3.3 中断机制与任务调度
28335的中断系统对实时控制至关重要。在Simulink里，通常用C2000支持包的硬件中断配置模块配合Function-Call Subsystem来实现中断服务函数。
我的做法是：配置ePWM模块的SOC信号触发ADC转换，ADC转换完成产生EOC（End Of Conversion）信号，然后触发ADC中断。ADC中断对应的Function-Call Subsystem里放电流环算法：读ADC结果、坐标变换、PI调节、SVPWM、更新PWM比较值。这样从采样到输出占空比更新，全程在中断里完成，延迟是确定性的。
中断优先级也要注意。28335的PIE模块管理外设中断优先级，ADC中断通常分配在PIE1组，优先级较高。低速的任务比如转速环、通信处理，放在主循环或低频定时中断里。如果把速度环也塞进电流环中断，整个20kHz的ISR执行时间会变长，可能超过PWM周期，导致采样控制时序混乱。
3.4 通信与调试通道
实机调试阶段，最痛苦的是数据看不到。28335有SCI串口，Simulink模型里可以做一个简易的上位机通信子系统，把关键的变量打包通过SCIB发送到串口调试助手或自写的上位机，用曲线图观察。初期也可以用CCS的Graph工具直接在内存里看变量，但每次都要暂停处理器，不方便观察动态过程。
串口的波特率配置要注意分频计算。SCI模块时钟通常来自LSPCLK低速外设时钟，默认是SYSCLKOUT/4，即37.5MHz。如果要用115200波特率，需要配置BRR寄存器值，计算公式为：
BRR = LSPCLK / (波特率 × 8) - 1 = 37.5MHz / (115200 × 8) - 1，算下来约39.7，取整数40，实际波特率约114.1kbps，误差在1%以内，通信没问题。
我自己后来加了一种更省事的方式：用Simulink的External Mode功能在线调参。这个模式允许在模型运行中直接修改PI参数、给定值等，不用重新编译下载，调参效率很高。不过External Mode偶尔会占用额外资源，在代码紧张的场合需要评估。稳妥的做法还是把关键参数都做成可通过SCI修改的全局变量，这样即使不用External Mode也能在线调整。
4. 从模型到实机的完整实操流程
4.1 代码生成与CCS工程导入
模型验证通过后，下一步是生成代码。在Simulink的配置参数里，需要做几个关键设置：代码生成器选Embedded Coder，目标平台选TI C2000，代码生成方式可选“Generate code only”或“Build and execute with CCS”。
我的习惯是先选择生成代码，拿到生成的C源文件后手动建CCS工程。虽然支持包能自动创建CCS工程并触发编译下载，但在项目早期我倾向于手动建工程，这样能清楚地看到每个源文件，也方便加入自定义的外设初始化代码。后面流程稳定了再切换成自动构建。
代码生成完成后，CCS工程里会看到几个核心文件：控制算法的C源文件（比如control.c）、模型初始化函数（MdlInitializeSizes等）、外设驱动文件（C2000外设模块生成的init和config代码）、主循环文件（ert_main.c）。主循环文件里会看到模型初始化、后台循环处理的逻辑，结构是清晰的。
4.2 板级引脚分配与初始化
生成代码只是第一步，板级引脚的分配和初始化才是真正与硬件对接的部分。这一步必须在CCS工程里确认和修改。
28335的GPIO是复用的。需要核对每个外设模块对应的引脚有没有被复用功能占用。比如ePWM1A对应GPIO0，如果板子上这颗引脚被接到了别的器件，PWM波形是出不来的。在Simulink的外设配置模块里也要仔细核对引脚编号和实际原理图对应，我曾经就因为把PWM接到了错误的GPIO上，调试了一整天输出一直为零。
初始化顺序也值得注意。28335的Flash运行速度远慢于RAM，中断服务函数默认放在Flash里时延迟很大。Simulink生成的代码里，如果中断子系统包含实时要求高的算法，需要把相关的函数放到RAM中执行。在CCS工程里可以通过链接命令文件配置，把指定段分配到RAM里。这个优化在20kHz以上的中断频率下效果非常明显。
4.3 分步集成测试策略
完整模型一次性下载到板子上跑，出了问题是灾难性的，因为你不知道是模型逻辑错误、外设配置错误还是接线问题。我始终采用分步集成的方式，每一步确认无误后再走下一步。
第一步，只下载一个最小模型：GPIO输出一个方波，观察LED灯按预期频率闪烁。这步验证的是编译链、下载链路、最小模型能否在28335上运行。
第二步，加PWM模块，输出固定占空比的PWM，用示波器观察波形频率、死区时间是否符合预期。
第三步，加ADC采集，用一个电位器或者信号发生器给一个已知电压，通过串口把采样值回传上位机，确认ADC的数值和实际电压对应关系正确。
第四步，替换成开环控制：给定一个占空比，让电机或功率级转动，观察响应。
最后才上闭环：ADC反馈、算法、PWM输出全部连接，慢慢调PI参数。
每一步留下的都是可验证的中间节点。我在某项目中跳过第二步直接做闭环，结果电机一上电就剧烈抖动，查了很久才发现是PWM死区配置错误导致上下桥臂直通保护频繁触发。如果当时按流程先看PWM波形，问题会在五分钟内暴露。
5. 常见问题与调试经验实录
5.1 版本与编译类问题
这里把我在实际项目中遇到频率最高的问题整理成速查表，很多是支持包特有的坑，网上文档里不会写。
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 生成代码后CCS无法编译 | 支持包与CCS版本不匹配 | 检查支持包要求，重新配置CCS路径 |
| 编译报错找不到寄存器头文件 | F28335的头文件路径未包含 | 在CCS工程包含路径添加DSP2833x_common/include |
| 下载时报错连接不上目标板 | 仿真器驱动或boot模式问题 | 检查仿真器连接，确认目标板供电，按住复位键下载 |
| 程序跑飞进入非法中断 | 中断服务函数没有被正确链接 | 检查中断向量表，确认Function-Call Subsystem编号匹配 |
编译类问题最好解决，因为报错信息相对明确。真正难的是运行类问题。
5.2 外设与信号类问题
ADC读到的数值跳动很大，这是最常见的问题。对应的处理顺序是：先查接线是否有屏蔽，采样点和功率地是否分开；再查采样窗口ACQPS是否过短，导致采样电容充电不足；最后在模型里加一阶低通滤波，截止频率按实际信号频率选。
PWM输出频率对但占空比一直是0，这个比较迷惑人。我在某项目中遇到过，检查发现是PWM比较值写入的时机不对。Simulink里配置了比较值在计数器为零时加载，但算法更新比较值用的是直接写入方式，增量值没生效。后来改成通过更新影子寄存器的方式，问题解决。
中断不触发也遇到过。原因是在模型里同时配置了多个外设中断模块，但F28335的PIE中断分组有限，某个外设的中断源被占了资源，没法正常响应。换一个不受影响的中断源就好。
5.3 性能与稳定类问题
控制频率跑不满，ISR执行时间太长。排查方式是：在中断处理函数里加一个GPIO翻转，用示波器测量高电平持续时间，得到真实的ISR执行时间。如果超过了PWM周期的一半，就需要优化了。优化思路包括：把控制算法里的三角函数和除法换成查表法、把数据全部改成single、把频繁调用的函数放到RAM里、关掉不需要的中断。
电机运行一段时间后偶尔会失步或过流报警，这往往是看门狗超时或电源电压跌落导致的。28335有看门狗定时器，如果主循环长时间不喂狗，系统会复位。Simulink生成的主循环里喂狗逻辑有时因为后台任务耗时超时被饿死。我一般把喂狗放在ISR里，保证任何情况下都不会因为算法复杂度导致复位。
5.4 数据精度与存储类问题
生成代码后RAM占用过高，程序放不进28335的34K×16位SRAM。这个问题我在最初的项目里吃过亏。解决方法第一选择是检查数据类型，确保算法变量是single而不是double；第二是检查是否有大量数组、常量表占用了RAM，常量应该放到Flash里；第三是如果必须在RAM里运行关键中断函数，把非关键的函数留在Flash执行。
浮点数值精度问题也别忽视。28335的单精度浮点有效位数大约7位，做长时间的积分运算时，可能会因为舍入误差累积导致积分饱和。在Simulink模型里给PI调节器的积分项加抗饱和限幅，输出限幅和积分器限幅分开处理，这是从运动控制前辈那里学到的经验。
有一点值得多说一句。Simulink模型生成的代码初始化和主循环调度逻辑，默认情况下会在每次启动时把所有输入输出变量初始化一遍，某些外设寄存器也会被重新配置。这意味着如果模型之外写了自定义初始化代码，它的执行顺序和模型初始化顺序不一致时，会出现莫名其妙的覆盖问题。我后来养成了一个习惯：所有外设寄存器初始化尽量都放到Simulink模型里做，在CCS工程里只保留那些模型不覆盖的配置。
排查问题时，永远从最简单确定的部分开始验证。拿串口回传数据来说，如果上位机收不到数据，第一步不是查协议、查解析代码，而是先用一根杜邦线直接在前面板量一下TX引脚有没有波形。很多问题不是出在复杂环节，而是出在最基础的物理连接上。
最后再分享一个我个人的工作习惯：拿到任何一块新的28335板子，我不会急着把完整模型下载进去，而是先让Simulink生成一个只有PWM输出和LED翻转的最小模型跑通链路，确认编译工具链、下载通道、板级资源都没问题，再逐步添加ADC和算法。这套流程走得越稳，后面调试越省心。Simulink开发嵌入式模型，最大的优势是快速迭代，但再快的迭代也抵不过没有节奏的乱试。希望这篇分享能给正在做或准备做28335模型开发的同行一些参考。
