C2000 DSP ePWM模块实战：从基础配置到互补死区与动态更新

1. 先搞清楚ePWM到底在解决什么实际问题

如果你正在用TI的C2000系列DSP做电机控制、数字电源或者需要高精度时序的工业控制，那ePWM（增强型脉宽调制）模块就是你绕不开的核心。它解决的问题非常直接：如何精准地生成和控制一组或多组同步的PWM波形。这不仅仅是让一个引脚输出高低电平那么简单，而是涉及到频率、占空比、相位对齐、死区保护、故障快速关断等一系列复杂且实时的需求。

很多人一上来就照着例程配寄存器，结果波形出不来，或者电机一启动就炸管。问题的根源往往在于没理解ePWM各个子模块（时基、计数比较、动作限定、死区、事件触发等）是如何协同工作的。这个实验，就是带你从“能点灯”到“能干活”的关键一步。它最适合两类人：一是刚开始接触C2000 DSP的嵌入式软件工程师，二是之前只用过通用定时器产生PWM，现在需要用到更高级功能的开发者。

最值得你关注的，不是某个孤立的寄存器配置，而是整个信号链的配置顺序和关键参数之间的耦合关系。比如，改一下时基的周期，可能会影响你比较寄存器的有效值范围；调整死区时间，必须同时考虑功率器件的开关特性和控制频率。下面，我就以一个典型的“基础配置与占空比更新”场景，拆解整个流程和避坑点。

2. 实验前的核心概念与硬件连接自检

开始写代码之前，必须确保脑子里对几个核心概念和硬件现状是清楚的。这一步没做好，后面所有的调试都是徒劳。

2.1 必须厘清的四个关键概念

1. 时基（TB）模块：这是ePWM的心脏，决定PWM的“心跳”节奏。它包含一个计数器（TBCTR）、一个周期寄存器（TBPRD）和一个控制时钟分频的寄存器。计数器怎么数（增、减、增-减模式），数到多少归零（周期），决定了PWM的频率和计数模式。

2. 计数比较（CC）模块：这是控制占空比的“指挥官”。它包含两个比较寄存器CMPA和CMPB。当时基计数器的值等于比较寄存器的值时，就会产生事件，进而通过动作限定模块去控制输出引脚的电平翻转。CMPA/CMPB的值相对于TBPRD的比例，直接决定了占空比。

3. 动作限定（AQ）模块：它是“命令执行者”。当来自时基或比较模块的事件（比如计数器等于零、等于周期、等于CMPA）发生时，AQ模块决定对应的输出引脚（EPWMxA， EPWMxB）是置高、拉低还是翻转。PWM波形最终的形状，是由AQ模块的配置规则画出来的。

4. 死区（DB）模块：这是“安全卫士”，主要用于驱动半桥或全桥的上、下管。它会在AQ模块产生的原始信号基础上，插入一段两个管子都关断的时间，防止共通炸管。死区时间不是随便设的，必须大于功率器件（如MOSFET、IGBT）的关断延迟时间。

2.2 硬件连接与信号测量准备

在软件动工前，请先完成以下硬件检查：

• 目标板：确认你使用的C2000开发板或自制板，其ePWM输出引脚（如EPWM1A, EPWM1B）已正确引出，并且没有与其他功能复用冲突。
• 负载：如果是空载测试，接个LED或电阻到地即可观察。如果计划连接电机驱动器或功率电路，务必先断开功率部分，仅在信号级验证波形！
• 示波器/逻辑分析仪：这是必备工具。准备两个探头，一个通道看EPWMxA，另一个看EPWMxB（如果你用互补带死区模式）。提前设置好示波器的触发和时基，确保能稳定捕获到你的预期频率（例如10kHz）。
• 供电与接地：确保DSP核心和IO供电稳定，特别是模拟地与数字地的单点连接要可靠，避免噪声影响PWM精度。

3. 从零开始：一个ePWM通道的完整配置流程

我们以配置一个ePWM通道（例如EPWM1），产生一个频率10kHz、初始占空比50%的PWM波为例。这里假设使用TI的CCS（Code Composer Studio）和C2000的DriverLib库进行开发，这样代码更清晰。寄存器直接配置的思路是相通的。

3.1 第一步：时钟与引脚初始化

这是所有外设配置的前提。ePWM的时钟来源于系统时钟SYSCLKOUT经过分频。通常，我们会为ePWM模块分配一个独立的时钟分频，以平衡精度和功耗。

// 1. 使能ePWM1模块的时钟（假设使用DriverLib） SysCtl_enablePeripheral(SYSCTL_PERIPH_CLK_EPWM1); // 2. 配置ePWM1的时钟分频（TBCLK = SYSCLKOUT / (HSPCLKDIV * CLKDIV)） // 假设SYSCLKOUT = 100MHz， 我们希望TBCLK = 100MHz / (2*1) = 50MHz SysCtl_setClockDivider(SYSCTL_CLOCK_DIV_4); // 设置高速外设时钟分频HSPCLKDIV=2 // 注：具体的分频设置函数可能因型号而异，需查数据手册和库手册。 // 3. 配置GPIO引脚复用为ePWM1A输出功能 // 假设EPWM1A对应GPIO0 GPIO_setPinConfig(GPIO_0_EPWM1A); GPIO_setDirectionMode(0, GPIO_DIR_MODE_OUT); GPIO_setPadConfig(0, GPIO_PIN_TYPE_STD); // 推挽输出

3.2 第二步：配置时基（TB）模块

这是定义PWM频率和计数模式的核心。

// 初始化ePWM1时基模块结构体 EPWM_TimeBaseInitTypeDef tbConfig; tbConfig.clockDivider = EPWM_CLOCK_DIVIDER_1; // TBCLK进一步分频，这里为1 tbConfig.halfCycleShift = EPWM_HALF_CYCLE_SHIFT_DISABLE; tbConfig.syncOutSelect = EPWM_SYNC_OUT_PULSE_ON_COUNTER_ZERO; // 同步输出信号 tbConfig.phaseDirection = EPWM_PHASE_DIRECTION_UP; // 计数方向：递增 tbConfig.countMode = EPWM_COUNT_MODE_UP; // 计数模式：递增模式 // 计算周期值：PWM频率 = TBCLK / (TBPRD + 1) // TBCLK = 50MHz， 目标频率10kHz， 则 TBPRD = (50,000,000 / 10,000) - 1 = 4999 tbConfig.period = 4999; tbConfig.phase = 0; // 相位寄存器，用于多个ePWM同步，这里设为0 // 应用配置 EPWM_initTimeBase(EPWM1_BASE, &tbConfig);

关键点：countMode有三种：UP（增）、DOWN（减）、UP_DOWN（增-减）。在UP模式下，占空比 = CMPA / (TBPRD + 1)。在UP_DOWN模式下，一个周期会计数两次，实际波形频率会是TBCLK / (2 * TBPRD)，占空比计算方式也不同，需特别注意。

3.3 第三步：配置计数比较（CC）模块

这里设置初始占空比。我们使用CMPA。

// 初始化比较模块结构体 EPWM_CompareInitTypeDef ccConfig; // 在UP计数模式下，当TBCTR == CMPA时，会触发CTU=CAU事件。 // 设置初始占空比为50%， 则 CMPA = 0.5 * (TBPRD + 1) = 0.5 * 5000 = 2500 ccConfig.loadMode = EPWM_COMP_LOAD_ON_CNTR_ZERO; // 何时加载新值：计数器等于零时 ccConfig.compareValue = 2500; // CMPA初始值 // 同样可以配置CMPB，这里略过 ccConfig.compareValueB = 0; EPWM_initCompare(EPWM1_BASE, &ccConfig);

loadMode的选择很重要：LOAD_ON_CNTR_ZERO（零时加载）和LOAD_ON_CNTR_PRD（周期时加载）是常用模式。它决定了你更新CMPA寄存器后，新值何时生效。如果你希望占空比立即平滑变化，通常选择在计数器等于零时加载。

3.4 第四步：配置动作限定（AQ）模块

这是将事件转化为具体引脚动作的环节。我们希望在计数器等于零时，将EPWM1A置高；等于CMPA时，将EPWM1A拉低。

// 配置动作限定 // 事件1：时基计数器等于零 (TBCTR = 0) -> 将EPWM1A输出置高 EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_ZERO); // 事件2：时基计数器等于CMPA (TBCTR = CMPA) -> 将EPWM1A输出拉低 EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_COMPARE_A_UP); // 注意：在UP计数模式下，用`UP`事件

为什么用ON_COMPARE_A_UP？因为计数器是递增的，当它从小于CMPA的值增加到等于CMPA时，这个事件被捕获。如果是递减计数，则要使用ON_COMPARE_A_DOWN。

3.5 第五步：使能输出并启动

// 使能ePWM1A的输出 EPWM_enableOutput(EPWM1_BASE, EPWM_OUTPUT_A); // 如果需要，也可以配置影子寄存器加载模式、中断等，这里先略过。 // 最后，启动时基计数器（如果之前被停止） EPWM_startTimeBaseCounter(EPWM1_BASE);

至此，一个最简单的ePWM通道就应该配置完成了。编译下载后，用示波器测量GPIO0（EPWM1A），应该能看到一个10kHz、占空比50%的方波。

4. 动态更新占空比：时机与方式的选择

让PWM静态输出不是目的，动态调整占空比（比如实现呼吸灯、电机调速）才是关键。这里有几种常见方式，各有适用场景。

4.1 方式一：在主循环中直接更新（适用于低速、非实时控制）

这是最简单粗暴的方式，但风险也最大。

void main(void) { // ... 初始化代码 ... while(1) { // 读取某个ADC值或接收指令 newDuty = getNewDutyCycle(); newCmpValue = (uint16_t)(newDuty * (EPWM_getTimeBasePeriod(EPWM1_BASE) + 1)); // 直接写入CMPA的活跃寄存器 EPWM_setCounterCompareValue(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, newCmpValue); DELAY_US(1000); // 加个延时，避免更新过快 } }

问题：你无法精确控制更新发生在PWM周期的哪个时刻。如果在计数器正好等于旧CMPA值附近进行写入，可能导致当前周期输出一个极窄或极宽的脉冲，造成输出抖动，在电机控制中可能引起电流尖峰。

4.2 方式二：在计数器等于零（或周期）的事件中断中更新（最常用、最安全）

这是推荐的做法。通过配置时基模块，在TBCTR = 0（或TBCTR = PRD）时产生中断，在中断服务程序（ISR）中更新CMPA的影子寄存器。影子寄存器会在下一个周期开始时自动加载到活跃寄存器，从而实现周期边界同步更新，保证波形平滑。

// 初始化时开启零事件中断 EPWM_enableInterrupt(EPWM1_BASE); EPWM_setInterruptSource(EPWM1_BASE, EPWM_INT_TBCTR_ZERO); // 中断源：计数器等于零 EPWM_enableInterruptEvent(EPWM1_BASE, EPWM_INT_TBCTR_ZERO); EPWM_setInterruptEventCount(EPWM1_BASE, 1); // 每1个事件产生一次中断 // 在中断服务程序中更新占空比 __interrupt void epwm1_isr(void) { // 清除中断标志 EPWM_clearInterruptFlag(EPWM1_BASE, EPWM_INT_TBCTR_ZERO); newCmpValue = calculateNewCmpValue(); // 计算新值 // 写入CMPA的影子寄存器。由于配置了LOAD_ON_CNTR_ZERO，此值将在下一个周期生效。 EPWM_setCounterCompareShadowValue(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, newCmpValue); // 如果需要，可以在此处进行其他控制律计算 PieCtrlRegs.PIEACK.all = PIEACK_GROUP3; // 应答PIE中断，假设ePWM1在GROUP3 }

这是最稳健的方式。它确保了占空比的更新永远发生在两个完整周期之间，避免了“毛刺”。对于电机FOC控制、数字电源环路补偿等实时性要求高的场景，这是标准做法。

4.3 方式三：使用SOC/SFO机制（高级应用）

对于一些更复杂的场景，比如希望占空比在一个周期内按照特定轨迹变化（如空间矢量调制SVPWM的七段式或五段式），或者需要与ADC采样严格同步，可以使用影子寄存器一次性加载（SFO）或ADC启动转换（SOC）事件来触发更新。这需要更精细的配置，将CMPA的加载模式与特定事件绑定，超出了基础实验范围，但它是性能优化的关键。

5. 引入死区：配置互补PWM驱动半桥

单独一个PWM通道只能控制单向开关。驱动一个半桥（H-Bridge的一臂）需要一对互补的PWM信号（EPWMxA和EPWMxB），并且必须插入死区时间。

5.1 死区模块配置要点

假设我们已经配置好了EPWM1A作为上管信号源（由AQ模块产生原始信号EPWMA_raw），现在要通过死区模块生成最终的EPWM1A（上管）和EPWM1B（下管）。

// 1. 首先，确保AQ模块已经为EPWM1B输出配置了与EPWM1A相反的动作，或者直接让EPWM1B跟随EPWM1A的反相。 // 常用配置：让EPWM1B在AQ模块输出原始信号的反相。 EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_B, EPWM_AQ_OUTPUT_TOGGLE, // 或者使用 LOW/HIGH 组合 EPWM_AQ_OUTPUT_ON_TIMEBASE_ZERO); EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_B, EPWM_AQ_OUTPUT_TOGGLE, EPWM_AQ_OUTPUT_ON_COMPARE_A_UP); // 更简单的办法：设置输出B与输出A反相 EPWM_setDeadBandOutputPolarity(EPWM1_BASE, EPWM_DB_OUTPUT_A_FALLING_B_RISING, // 输出A不反相，输出B反相 EPWM_DB_OUTPUT_A_RISING_B_FALLING); // 2. 配置死区模块 EPWM_DeadBandInitTypeDef dbConfig; dbConfig.outputMode = EPWM_DB_OUTPUT_AH_BH; // 模式：对上升沿和下降沿都插入死区 dbConfig.polarity = EPWM_DB_POLARITY_ACTIVE_HIGH; // 极性 // 设置死区时间。死区时钟 = TBCLK / (prescaler) dbConfig.clockPrescaler = EPWM_DB_CLOCK_DIV_BY_1; // 死区时钟分频 // 计算死区周期值。死区时间 = DeadBand_Delay * (1/死区时钟频率) // 例如，TBCLK=50MHz， 目标死区时间1us， 则 Delay = 1us * 50MHz = 50 dbConfig.delayMode = EPWM_DB_DELAY_MODE_NORMAL; dbConfig.fallingEdgeDelay = 50; // 下降沿延迟（下管关断后，上管开启的延迟） dbConfig.risingEdgeDelay = 50; // 上升沿延迟（上管关断后，下管开启的延迟） EPWM_initDeadBand(EPWM1_BASE, &dbConfig); // 3. 使能EPWM1B输出 EPWM_enableOutput(EPWM1_BASE, EPWM_OUTPUT_B);

5.2 死区时间计算与测量验证

计算：务必根据你所用的MOSFET或IGBT的数据手册，找到Turn-off delay (td_off)和Fall time (tf)。死区时间必须大于最慢关断的那个器件的td_off + tf，并留有一定裕量（通常20%-50%）。例如，器件关断延迟100ns，下降时间50ns，则最小死区需150ns，实际可设置200ns-300ns。

验证：用双通道示波器同时测量EPWM1A和EPWM1B。将两个波形重叠，放大时间轴，你应该能看到：

• 当EPWM1A从高变低（上管关断指令）后，EPWM1B并没有立即变高（下管开启），而是延迟了设定的死区时间。
• 当EPWM1B从高变低（下管关断指令）后，EPWM1A也延迟了同样的时间才变高。
• 在死区时间内，两个信号都是低电平，确保上下管都关断。

6. 常见问题排查：当你的PWM没有输出或不对时

按照上面的步骤，大部分情况都能成功。如果失败，请按以下顺序排查：

1. 完全没有波形输出

   • 检查时钟：确认系统时钟SYSCLKOUT是否正常？ePWM模块时钟TBCLK是否使能？用示波器测一下其他已知频率的GPIO（比如翻转一个IO）来验证时钟。
   • 检查引脚复用：GPIO的MUX寄存器是否真的配置到了ePWM功能？很多开发板引脚功能复用，容易配错。
   • 检查输出使能：EPWM_enableOutput函数调用了吗？
   • 检查计数器：EPWM_startTimeBaseCounter调用了吗？计数器可能被停止了。
   • 检查动作限定：AQ模块是否配置了有效的“置高”动作？如果只配置了“拉低”和“翻转”，初始状态可能是低电平。

2. 有波形，但频率不对

   • 计算TBPRD：重新核对PWM频率 = TBCLK / (TBPRD + 1)这个公式。确认TBCLK的值（SYSCLKOUT / 分频）。
   • 检查计数模式：如果用了UP_DOWN模式，实际频率是公式计算值的一半。
   • 示波器测量：用示波器自动测量频率功能，与计算值对比。

3. 有波形，但占空比不对或不可调

   • 检查CMPA值范围：在UP模式下，CMPA必须介于0和TBPRD之间。如果CMPA >= (TBPRD+1)，占空比会一直是100%或0%。
   • 检查影子寄存器加载模式：如果你在中断中更新了CMPA的影子寄存器，但占空比没变，检查loadMode是否配置为LOAD_ON_CNTR_ZERO或LOAD_ON_CNTR_PRD。如果配置为LOAD_ON_CNTR_ZERO，却只在周期中断更新，则不会生效。
   • 检查写入的寄存器：是写入了活跃寄存器CMPA:ACTIVE还是影子寄存器CMPA:SHADOW？确保你的更新函数和目标一致。
   • 检查AQ事件：确认AQ模块绑定的是ON_COMPARE_A_UP事件（对于UP模式）。如果绑成了ON_COMPARE_A_DOWN，在UP模式下永远不会触发。

4. 互补带死区波形异常

   • 死区时间过长或过短：用示波器测量，确认死区时间是否符合设定。计算死区时钟和Delay值。
   • 上下管同时导通：如果看到死区区间内两个波形有重叠的高电平，说明死区未生效或极性配置错误。检查死区模块是否使能，输出模式outputMode和极性polarity配置是否正确。
   • EPWMxB无输出：检查死区模块的输入信号选择，是否正确地以EPWMA_raw作为源。检查EPWMxB的输出是否使能。

5. 中断无法进入

   • 全局中断使能：EINT; ERTM;语句加了吗？
   • PIE向量表：中断服务函数是否正确关联到了PIE向量表？
   • 中断标志：在ISR中是否清除了正确的中断标志位？是否进行了PIEACK应答？
   • 中断事件计数：EPWM_setInterruptEventCount是否设置得太大了？设置为1表示每个事件都产生中断。

调试时，善用CCS的寄存器观察窗口和图形化插件（如Grace），可以实时查看ePWM各寄存器的值，结合示波器波形，能快速定位问题所在。记住，先让最简单的单通道无死区PWM跑起来，再逐步增加死区、互补、中断等复杂功能，这样排查问题范围最小。