简介一套基于TI TMS320F28335 DSP生成PWM波形的完整CCS工程代码面向电机控制、直流调速等应用场景适合正在学习DSP嵌入式开发或需要快速掌握PWM模块配置的工程师与学生。工程文件共152个压缩包约565KB包含C语言源码、头文件、汇编启动文件、链接脚本、CCS项目配置文件及编译日志与输出文件可清晰还原Code Composer Studio下从建工程到生成.out的完整开发过程。已有1939人学习下载。借助该工程读者能够理解DSP28335的EPwm模块初始化、周期与占空比设置、中断服务程序编写并可通过工程配置文件与编译日志梳理CCS的项目结构和链接配置为直流电机调速等实际应用打下基础。文件组织按DSP2833x标准库与用户代码分区存放便于对照学习是一份兼顾示例代码与环境配置的实用参考资料。 做电机驱动、数字电源、逆变器这类项目的人应该都绕不开“DSP28335产生PWM波代码”这个基础功。TMS320F28335的ePWM模块和STM32那种定时器输出PWM的玩法不一样它把时基、动作、死区、故障保护全部拆成了独立子模块配置好了是真顺手但刚上手的人十有八九会被一堆寄存器和位域绕晕尤其是死区、故障保护这些功能网上代码都是片段抄过来也不知道为什么这么配。这篇文章我打算把实际调PWM时沉淀下来的一套代码骨架、参数计算方法以及调试现场踩过的坑完完整整梳理一遍。不光是贴代码重点讲清楚每个寄存器为什么这么配频率和占空比怎么算死区时间怎么换算故障保护怎么接、怎么清标志。适合正在做28335开发、尤其是第一次碰ePWM的工程师参考也适合从STM32转过来、对TI C2000平台不太熟悉的同学。1. 方案选型与整体思路1.1 为什么用F28335的ePWM而不是普通单片机定时器很多人会问输出个PWM而已STM32的TIM也能干为什么非要用DSP28335这个问题的答案得从F28335在应用里的位置说起。这颗芯片的定位就是电机控制、数字电源、并网逆变器这类对PWM精度和实时性要求极高的场景它的ePWM模块是专门为电力电子设计的和通用MCU的定时器有本质区别。F28335一共有6组ePWM模块每组输出ePWMxA和ePWMxB两路互补信号每组内部有时基周期、比较值、动作限定、死区、斩波、故障保护、事件触发七个部分。这意味着什么呢用通用单片机做互补PWM加死区通常得在定时器中断里手动翻转IO还要用定时器做延时代码复杂不说死区时间还容易抖动。但用ePWM只要配置好动作限定和死区模块A/B两路波形由硬件自动生成CPU完全不用干预故障保护还能在硬件层面直接封锁输出CPU跑飞了都不影响安全保护。这就是工业级方案和玩具级方案的区别。对比一下更容易理解STM32定时器PWM输出通常需要中断配合改比较值死区要靠定时器或软件延时故障保护得外部中断加软件封锁F28335 ePWMA/B两路硬件自动互补死区时间精确到TBCLK周期TZ模块可以在硬件上强制输出高阻或固定电平所以如果你做的是400V直流母线、IGBT驱动这种项目别犹豫直接按本文这套思路来配置ePWM。1.2 ePWM模块的组成结构要写好PWM代码首先得在心里有一张ePWM模块的结构图。它内部大致是这样一条信号链时基TB产生计数时钟和周期比较器CC把计数器和CMPA/CMPB比较比较结果送到动作限定AQAQ根据提前设定好的规则决定ePWMxA/B拉高还是拉低输出信号经过死区DB处理后加上延时再经过斩波PC可选和故障保护TZ的限制最终从GPIO引脚输出。这个结构的精妙之处在于每一层都能独立配置理解信号流向就不会被寄存器绕晕。比如你看到AQCTLA寄存器就知道这是配置动作限定层的看到DBRED就知道这是死区层的上升沿延时。调PWM时先想清楚是“哪一层”出了问题排查效率会高很多。后面我就按这条信号链的顺序来讲代码。2. 开发环境准备与工程初始化2.1 CCS工程建立与仿真器连接写F28335代码IDE基本都用CCSCode Composer Studio版本4到12都行关键是仿真器驱动要装对。XDS100V2或者XDS110是现在常见的选择。新建工程时注意选择芯片型号TMS320F28335然后引入TI官方提供的DSP2833x系列头文件和库函数比如DSP2833x_Device.h、DSP2833x_Examples.h。这部分不多展开网上资料很多但有个细节我想提醒一句工程属性里的runtime support library要选对浮点支持用rts2800_fpu32.lib否则后续做浮点运算会有问题。2.2 时钟与外设时钟使能代码第一步永远是初始化系统时钟。F28335的外部晶振通常是30MHz经过PLL倍频到150MHz系统时钟SYSCLKOUT。CCS工程模板里的InitSysCtrl()函数已经帮我们做好了这件事但ePWM模块的外设时钟默认是关闭的必须手动打开SysCtrlRegs.PCLKCR0.bit.EPWM1ENCLK 1; SysCtrlRegs.PCLKCR0.bit.EPWM2ENCLK 1; SysCtrlRegs.PCLKCR0.bit.EPWM3ENCLK 1; SysCtrlRegs.PCLKCR0.bit.EPWM4ENCLK 1; SysCtrlRegs.PCLKCR0.bit.EPWM5ENCLK 1; SysCtrlRegs.PCLKCR0.bit.EPWM6ENCLK 1;这一步遗忘的话后面不管怎么配置寄存器引脚上都不会有任何波形而且芯片本身看起来一切正常特别坑。系统时钟和外设时钟的关系可以直接对照实例计算。TBCLK时钟源是SYSCLKOUT经过HSPCLKDIV和CLKDIV两个分频器得到。默认情况下HSPCLKDIV和CLKDIV都为/1所以TBCLK就是150MHz周期大约是6.67ns。2.3 GPIO引脚复用配置F28335的GPIO引脚默认是普通IO功能使用ePWM前必须把引脚复用为外设功能。GPIO0和GPIO1对应EPWM1A和EPWM1BGPIO2/GPIO3对应EPWM2A/EPWM2B以此类推。配置代码如下EALLOW; GpioCtrlRegs.GPAMUX1.bit.GPIO0 1; // GPIO0 - EPWM1A GpioCtrlRegs.GPAMUX1.bit.GPIO1 1; // GPIO1 - EPWM1B GpioCtrlRegs.GPAMUX1.bit.GPIO2 1; // GPIO2 - EPWM2A GpioCtrlRegs.GPAMUX1.bit.GPIO3 1; // GPIO3 - EPWM2B EDIS;这里有个记忆技巧GPAMUX1寄存器管GPIO0到GPIO15每两位对应一个引脚写01就启用第一组外设功能。dsp28335的ePWM输出恰恰都在第一组外设功能里所以统一把对应位写成1即可。3. 核心PWM代码实现与寄存器计算3.1 时基配置频率计算方法频率计算是PWM配置中最重要的部分也是很多人抄代码抄不明白的地方。ePWM的计数模式有三种递增、递减、递增递减。最常用的是递增模式尤其适用于电机控制和开关电源。频率公式为f_PWM TBCLK / (TBPRD 1)反过来就是TBPRD (TBCLK / f_PWM) - 1举个例子需求是10kHz的PWM频率TBCLK为150MHz时TBPRD 150000000 / 10000 - 1 15000 - 1 14999为什么周期寄存器要减1因为计数器从0开始计数包括0到14999共15000个计数点每个计数点耗时1/150MHz正好凑成10kHz。时基模块的配置代码EPwm1Regs.TBCTL.bit.PRDLD TB_IMMEDIATE; // 周期寄存器立即装载 EPwm1Regs.TBCTL.bit.CTRMODE TB_COUNT_UP; // 递增计数模式 EPwm1Regs.TBCTL.bit.HSPCLKDIV TB_DIV1; // 高速时钟分频 /1 EPwm1Regs.TBCTL.bit.CLKDIV TB_DIV1; // 低速时钟分频 /1 EPwm1Regs.TBPRD 14999; // 周期值决定10kHz EPwm1Regs.TBCTR 0x0000; // 计数器清零如果用的是递增递减模式频率公式会变成f_PWM TBCLK / (2 * TBPRD)因为一个周期内计数器要走上去再走下来同样的TPRD只能得到一半频率。很多人在网上抄到递增递减模式的代码设了和递增模式一样的TBPRD结果发现频率只有预期的一半就是这个原因。3.2 比较与动作限定占空比设置占空比由比较寄存器CMPA或CMPB控制。在递增计数模式下计数器从0涨到TBPRD当计数值等于CMPA时动作限定模块就会执行预设的操作。占空比公式为Duty CMPA / TBPRD假设要50%占空比CMPA 14999 * 0.5四舍五入就是7500。接下来在动作限定寄存器中配置计数器到0时输出高电平计数器等于CMPA时输出低电平这样从占空比定义看高电平占整个周期的50%。EPwm1Regs.CMPCTL.bit.SHDWAMODE CC_SHADOW; // CMPA使用影子寄存器 EPwm1Regs.CMPCTL.bit.SHDWBMODE CC_SHADOW; EPwm1Regs.CMPCTL.bit.LOADAMODE CC_CTR_ZERO; // 计数器为0时从影子装载 EPwm1Regs.CMPCTL.bit.LOADBMODE CC_CTR_ZERO; EPwm1Regs.CMPA.bit.CMPA 7500; // 50%占空比 EPwm1Regs.AQCTLA.bit.ZRO AQ_SET; // 计数到0时输出高 EPwm1Regs.AQCTLA.bit.CAU AQ_CLEAR; // 比较匹配时输出低这里要特别留意“影子寄存器”这个概念。CMPA默认是影子模式意味着程序里写入的CMPA值不会立刻生效要等到计数器归零时才加载到实际比较寄存器中。这样做的目的是防止在PWM周期中间改占空比导致波形毛刺。如果项目里需要动态调节占空比比如做电机调速改动CMPA值一般放在周期中断里做利用影子寄存器特性自动同步。主中断里改占空比的常规写法是__interrupt void epwm1_isr(void) { EPwm1Regs.CMPA.bit.CMPA (Uint16)(duty * 14999); EPwm1Regs.ETCLR.bit.INT 1; PieCtrlRegs.PIEACK.all PIEACK_GROUP3; }3.3 死区配置DBRED和DBFED的深入理解死区是电机驱动和电源变换器里必不可少的功能主要用来防止半桥上下管直通。热词里反复出现“28335配置的pwm死区db”、“dbfed和dbred”说明很多人卡在这一步。死区模块内部有两个寄存器DBRED上升沿延时和DBFED下降沿延时。上升沿延时指的是ePWMxA信号从无效变有效时的延迟时间下降沿延时是有效变无效的延迟时间。配置代码EPwm1Regs.DBCTL.bit.IN_MODE DBA_ALL; // 输入信号源为ePWMxA EPwm1Regs.DBCTL.bit.POLSEL DB_ACTV_HI; // 信号极性不翻转 EPwm1Regs.DBCTL.bit.OUT_MODE DB_FULL_ENABLE; // A/B两路都启用死区 EPwm1Regs.DBRED 149; // 上升沿延时 EPwm1Regs.DBFED 149; // 下降沿延时死区时间的换算公式为死区时间 (DBRED 1) / TBCLK也就是说当TBCLK为150MHz时如果DBRED写149则死区时间 (149 1) / 150MHz 1us。很多人踩坑的点就在这里想要1us死区直觉上会想150MHz时钟下1us就是150个计数周期但为什么寄存器写149而不是150因为死区发生器内部和TBPRD一样寄存器值对应的实际延时是“值1”个TBCLK周期。DBRED是0时死区仍然存在只是最小。这个细节不仔细看手册确实容易被忽略。另外死区的极性和模式选择也很关键。POLSEL DB_ACTV_HI表示输入信号不反相输出信号的高电平有效部分会被延时如果POLSEL设置成DB_ACTV_LOC波形看起来就会是反的。IN_MODE选择DBA_ALL表示A、B两路输出都由ePWMxA这一路信号经过死区处理得到这是互补输出最常用的模式可以保证A路和B路之间插入的死区时间是一致的。3.4 事件触发与中断周期中断的写法事件触发模块ET是ePWM和CPU之间的桥梁。常用的场景是每个PWM周期产生一次中断在中断里更新占空比或者读取ADC结果。配置方法如下EPwm1Regs.ETSEL.bit.INTEN 1; // 使能中断 EPwm1Regs.ETSEL.bit.INTSEL ET_CTR_ZERO; // 计数器为0时触发 EPwm1Regs.ETPS.bit.INTPRD ET_1ST; // 每发生一次事件就触发中断然后在主程序里注册中断向量EALLOW; PieVectTable.EPWM1_INT epwm1_isr; PieVectTable.EPWM1_TZINT epwm1_tz_isr; EDIS; IER | M_INT2 | M_INT3; // TZINT在PIE组2EPWM1INT在PIE组3 PieCtrlRegs.PIEIER2.bit.INTx1 1; PieCtrlRegs.PIEIER3.bit.INTx1 1;这里有个非常容易搞错的地方F28335的TZ故障中断在PIE组2而ePWM周期中断在PIE组3两者不是同一个中断组。配置IER时要同时打开M_INT2和M_INT3否则用得到故障保护功能的时候中断始终进不去还以为是引脚接线问题。4. 故障保护与高级功能配置4.1 Trip Zone故障保护机制故障保护TZ是DSP28335的PWM模块里我最喜欢的一个功能也是它比普通MCU定时器高级得多的地方。TZ模块的作用是当外部故障信号比如过流、过压、驱动器报错到来时硬件直接封锁PWM输出不需要软件干预响应时间在ns级别。故障源可以选择TZ1到TZ6引脚还可以选择数字比较器子模块产生的DCBEVT1/DCBEVT2信号。常用的配置是将TZ1引脚作为外部故障输入EALLOW; EPwm1Regs.TZSEL.bit.OSHT1 1; // TZ1作为一次性故障源 EPwm1Regs.TZCTL.bit.TZA TZ_FORCE_LO; // 故障时A路强制输出低 EPwm1Regs.TZCTL.bit.TZB TZ_FORCE_LO; // 故障时B路强制输出低 EDIS;TZCTL寄存器决定故障发生后的输出电平状态选项有强制高、强制低、高阻和不变。对于驱动IGBT的场景通常配置强制输出低或者高阻保证功率管截止。故障触发方式有两种OSHT一次性触发和CBC周期循环触发。区别在于OSHT一旦故障触发PWM输出保持封锁状态必须软件清除标志才能恢复CBC每个PWM周期尝试恢复一次如果故障信号还在继续封锁如果故障消失了自动恢复正常工作过流保护这种严重故障一般用OSHT锁死等人工处理过流瞬间的软保护、限流这种场景用CBC更合适。4.2 故障中断服务程序的正确写法故障触发后除了硬件封锁输出通常还需要通知CPU记录故障状态或者切断其他外设。故障中断服务函数有一个细节特别容易出错——清标志的顺序__interrupt void epwm1_tz_isr(void) { // 读取故障状态记录故障信息 Uint16 tzflg EPwm1Regs.TZFLG.all; EPwm1Regs.TZCLR.bit.OSHT 1; // 清除一次性触发标志 EPwm1Regs.TZCLR.bit.OST 1; // 清除OST状态位 EPwm1Regs.TZCLR.bit.INT 1; // 清除TZ中断标志 PieCtrlRegs.PIEACK.all PIEACK_GROUP2; }为什么OSHT标志和OST状态位都要清因为TZFLG寄存器里记录了多个状态位其中OSHT表示是否发生了OSHT故障OST表示当前是否处于OSHT封锁状态。如果你只清OSHT不清OST标志位可能在下一次中断时还存在导致中断反复进入。这个问题我实际调试时踩过故障明了半天也复不了位最后查手册才发现是两个位都要写1清除。还有一点如果是OSHT模式必须在清除标志之前先确保故障源已经解除否则清完标志后PWM可能立刻又被拉低。在代码里可以加一个故障源判断确认引脚电平恢复正常后再执行清除。5. 常见问题与调试技巧5.1 PWM波形不输出的排查清单这个问题的出现频率极高。整理成一份排查清单按顺序检查GPIO复用是否配置GPAMUX1是否设置成外设功能外设时钟是否使能PCLKCR0寄存器里EPWM1ENCLK是否为1TBCTL的CTRMODE是否处于正常计数模式有没有停在某个状态TBPRD周期值是否合理有没有设置成0导致计数器异常TZ模块是否被触发查看TZFLG寄存器有没有故障标志位动作限定AQCTL是否配置ZRO和CAU位没有设置就不会输出这里最容易忽略的是第5条。有时候明明所有配置都没问题但引脚上就是没有波形一查TZFLG发现OST位被置1了说明TZ引脚上进来过故障信号输出被锁住了。这种问题在开发板上经常发生因为开发板的TZ引脚可能被其他外设占用上电瞬间电平不确定。5.2 占空比和死区现象不对的解决思路占空比不对八成原因出在影子寄存器和动作限定上。改了CMPA但波形没变检查CMPCTL的SHDWAMODE和LOADAMODE。如果LOADAMODE设置为CC_CTR_ZEROCMPA值要到计数器过零才生效所以改完CMPA后至少要等一个完整的PWM周期。死区波形看起来不对劲重点检查DBCTL的IN_MODE和POLSEL。拿到示波器波形时先搞清楚哪一路是A哪一路是B然后对比上升沿和下降沿的时间关系。如果发现A路和B路的死区时间不对称大概率是IN_MODE选择错了输入源可能偶合了两路不同的信号。一个快速判断死区是否生效的办法把DBRED和DBFED都设为0观察A/B两路波形是否完全同步。同步说明输入源和极性设置正确然后再递增延时值观察死区窗口是否线性增大。5.3 Flash烧录后PWM不工作的特殊问题RAM调试一切正常烧进Flash之后PWM反而没输出了这个问题在F28335上很常见。原因是工程模板里默认的一些初始化函数被放在了RAM段从Flash启动时这些RAM段并没有被初始化导致系统时钟、外设时钟或者PLL配置不正确。解决办法有两个一个是工程中加上MemCopy功能把初始化函数从Flash拷贝到RAM中执行这也是TI官方推荐的方案。在main函数最开始调用memcpy相关的函数确保InitSysCtrl、InitPieCtrl等函数在RAM中运行。另一个更简单粗暴的做法是把InitFlash()放在主循环最开始执行经过它之后可以恢复系统正常的Flash等待状态。如果还是不行就检查PLL配置确认SYSCLKOUT确实跑到了150MHz。5.4 示波器无法稳定抓取PWM波形的建议最后补充一个调试经验。PWM波形的频率在kHz到MHz级别普通示波器都能看得见。但如果是抓死区窗口这种ns级细节建议把示波器的时间轴放大并开启余晖模式这样可以观察到多周期的叠加波形死区时间的变化趋势一目了然。还有一种情况示波器地线夹子没接好会引入大量噪声波形看起来毛刺特别多这时候仔细检查一下接地再下结论。6. 从常见应用场景看PWM扩展需求6.1 呼吸灯、LED调光与RGB驱动热词里出现了“用stm32f103zet6的tim3制作呼吸灯”、“pwm驱动led rgb灯”这类内容说明很多人学PWM是从驱动LED开始的。这类应用场景对频率和精度要求不高F28335完全可以做但确实有点大材小用。用ePWM做呼吸灯思路只是在周期中断里改变CMPA值让占空比从0慢慢增加到最大再慢慢减小到0。注意控制步进值一次变化太大肉眼看就是闪烁而不是呼吸效果。不过做LED色调混合要注意不同颜色LED的正向压降和电流等级不一样需要分别校准确认每种颜色对应的占空比区间否则混合出来的颜色会偏色。6.2 舵机控制的PWM脉宽舵机的标准控制信号是50Hz左右的PWM脉冲脉宽0.5ms到2.5ms对应舵机从0度到180度。用F28335驱舵机关键是算清楚CMPA的范围。假设PWM频率固定在50HzTBCLK为150MHzTBPRD 150000000 / 50 - 1 29999990.5ms脉宽对应的CMPA 0.0005 * 150000000 - 1 74999。 2.5ms对应的CMPA 374999。也就是注释里经常写的“角度和占空比的对应关系式”就是这串计算逻辑。不过实际项目中我用F28335驱舵机时一般先不从DSP直接做因为舵机控制周期比电机慢得多F28335定在这里有点浪费。但如果手头只有DSP开发板这套计算方法可以直接用。6.3 电机控制与电源变换器中的PWM要点真正发挥F28335全部实力的场景是电机控制和电源变换器。这类项目用到PWM时有几个基本配置方向值得展开首先是互补PWM和死区的配套使用。半桥、全桥、三相逆变器都需要互补PWM死区时间要根据功率管的手册决定IGBT一般设置几usMOSFET可以到几百ns。TBCLK为150MHz时1us死区对应DBRED1490.5us对应74这个直接带入前面讲的公式即可。然后是故障保护的完整闭环。驱动器有过流、过压、过热等故障信号一般建议把最严重的过流信号接到TZ1引脚配置成OSHT模式锁死输出。软件那边再接一个故障中断记录故障类型并点亮故障指示灯。最后是PWM和ADC的同步问题。数字电源里通常希望ADC采样点位于PWM周期的中心点避免采样到开关噪声。ePWM的事件触发模块可以产生ADC启动信号将SOC信号的触发源配置为周期匹配或CMPB匹配就可以把采样时刻精确地放在PWM周期的指定位置。写在最后我从第一次调F28335的PWM到真正把死区、故障保护全部跑通前前后后折腾了一个多星期。回头总结起来最核心的经验就是一句话不要死记寄存器数值先把TBCLK到TBPRD、CMPA到占空比、DBRED到死区时间的换算关系在纸上算清楚再去翻寄存器配代码。平时写PWM代码时我个人习惯是先用Excel把频率、占空比、死区时间对应的所有寄存器值算好然后照着填配置。这样既不容易出错也方便后期调节参数。调试PWM时一定要养成示波器抓波形的习惯A/B两路分开看有条件连负载一起看。很多问题光看代码是看不出来的示波器上一眼就能找到死区不对称、占空比跳变、故障保护没生效这些现象。最后再提一个很多人忽略的点F28335的PWM配置代码模块化程度很高强烈建议把ePWM初始化、占空比更新、死区设置、故障保护封装成独立的函数一个电机用一组ePWM模块比如ePWM1和ePWM2初始化函数分开写未来做多路电机控制、并联电源时复制一份改一改就能用不用每次都推倒重来。希望对正在调PWM的你有所帮助。本文还有配套的精品资源点击获取