1. 项目概述与ePWM核心价值

在数字电源、伺服驱动、不间断电源这些对实时性和精度要求极高的领域，脉冲宽度调制技术是当之无愧的“心脏”。它本质上是一种用数字信号控制模拟功率的桥梁——通过调节一个方波信号中高电平所占的时间比例，来等效一个连续的模拟量，从而精确控制电机转速、电源输出电压或逆变器的功率流。十年前，要实现一个复杂、多通道且同步精准的PWM系统，往往需要大量的软件计时器和中断服务程序，CPU负载高，时序抖动大，系统可靠性堪忧。

而德州仪器的C2000系列微控制器，其内置的增强型PWM模块彻底改变了这一局面。ePWM不是一个简单的定时器输出比较功能，而是一个高度专业化、模块化的“片上信号发生器”。它把PWM生成中涉及的所有关键环节——时间基准、比较匹配、动作输出、死区插入、故障保护、事件触发——都做成了独立的硬件子模块。这意味着，一旦配置完成，一个完整的、带死区互补、带故障刹车、能自动触发ADC采样的PWM通道，可以在零CPU干预的情况下自主运行，将CPU从繁重的定时任务中解放出来，去处理更高级别的控制算法。

我接触过不少从通用MCU转向C2000进行电机控制的工程师，最初常被其庞大的寄存器手册和复杂的子模块交互搞得一头雾水。本文的目的，就是帮你拨开这层迷雾。我们不只停留在“如何配置”，更要深入“为何这样配置”，从最底层的寄存器映射关系讲起，结合Driverlib库函数，并以时间基准这个最核心的子模块为例，手把手带你理解ePWM的设计哲学和实战配置要点。无论你是正在评估C2000，还是已经深陷调试泥潭，相信这篇基于TMS320F2807x等型号的深度解析，都能给你带来实实在在的启发。

2. 从寄存器到代码：理解ePWM的软件接口层

直接操作寄存器是掌握一个外设最根本的方式，它能让你对硬件有最精确的控制和最深的理解。但对于快速开发和维护而言，TI提供的Driverlib库函数是不可或缺的利器。它封装了繁琐的位操作，提供了更语义化的API。理解这两者之间的映射关系，是你从“新手”迈向“专家”的关键一步。

2.1 寄存器映射表：硬件世界的“地图”

你提供的资料片段中，Table 13-47是一个典型的“寄存器到库函数”映射表。虽然它属于SDFM模块，但ePWM的映射逻辑完全一致。这张表的价值在于，它明确告诉你，软件世界里的一个函数调用，最终影响了硬件世界里的哪个寄存器的哪些位。

以时间基准子模块为例，其核心寄存器是TBCTL。这个32位寄存器控制着计数模式、时钟分频、同步使能等几乎所有基础行为。如果你直接写寄存器，代码可能是这样的：

EPwm1Regs.TBCTL.bit.CTRMODE = 2; // 设置为增减计数模式 EPwm1Regs.TBCTL.bit.PHSEN = 1; // 使能相位加载 EPwm1Regs.TBCTL.bit.PRDLD = 0; // 影子寄存器立即加载模式

这种方式直截了当，但需要你熟记每个位域的名字和含义，代码可读性对后来者不太友好。

2.2 Driverlib库函数：语义化的“操作手册”

Driverlib库则提供了更上层的抽象。对于上述操作，对应的库函数调用是：

#include “driverlib/epwm.h” uint32_t epwmBase = EPWM1_BASE; // 设置时间基准计数器为增减计数模式 EPWM_setTimeBaseCounterMode(epwmBase, EPWM_COUNTER_MODE_UP_DOWN); // 使能相位寄存器加载 EPWM_enablePhaseShiftLoad(epwmBase); // 设置周期寄存器为立即加载模式（而非影子模式） EPWM_setPeriodLoadMode(epwmBase, EPWM_PERIOD_SHADOW_LOAD);

库函数的名称本身就说明了操作意图，大大提升了代码的可读性和可维护性。更重要的是，它隐藏了不同C2000型号之间可能存在的寄存器位域差异，提高了代码的可移植性。

2.3 映射关系的实战意义：调试与深度定制

那么，为什么我们仍需关心寄存器映射？原因有三：

1. 深度调试：当PWM输出行为异常时，仅靠库函数可能无法定位问题。你需要直接读取寄存器值，比如EPwm1Regs.TBCTL.all，来确认配置是否真的如你所想被写入硬件。有时软件配置顺序不当，可能导致中间状态被意外触发，直接查寄存器是最可靠的。
2. 理解时序：库函数是“原子操作”的集合，但多个库函数调用之间，硬件状态是如何变化的？例如，先设置周期TBPRD，再改变计数模式CTRMODE，和反过来操作，在计数器正在运行时，可能会产生不同的瞬时效果。理解寄存器，你才能理解这些细微时序。
3. 利用高级功能：ePWM Type 4的一些新特性，如全局加载、单次加载，其相关寄存器（如TBGLDCTL,TBHSRCTL）在早期的Driverlib版本中可能没有完全封装对应的函数，或者封装方式不符合你的特定需求。这时，直接操作寄存器是唯一的选择。

我的实操心得：在项目初期和调试阶段，我强烈建议以Driverlib为主进行快速原型开发。但在编写关键、对时序要求严苛的初始化序列时，不妨打开芯片的数据手册，对照寄存器描述，思考一下库函数背后的具体操作。甚至可以将关键配置用寄存器操作重写一遍，放在注释里，这能极大加深你对模块工作机理的理解，在遇到诡异问题时，这份理解就是你的“救命稻草”。

3. 时间基准子模块：ePWM的“心跳发生器”

如果说ePWM是一个交响乐团，那么时间基准子模块就是乐团的指挥，它决定了整个系统的节拍和步调。所有其他子模块——比较、动作、死区——都依据时间基准计数器TBCTR的节拍来工作。

3.1 核心组件与工作模式

时间基准模块的核心是一个16位的向上/向下计数器TBCTR，以及一个决定其计数范围的周期寄存器TBPRD。它的工作模式决定了PWM波形的根本形态：

• 递增模式：TBCTR从0开始，一直加到TBPRD，然后归零重启。这产生非对称PWM波形。例如，在TBCTR小于比较值CMPA时输出高电平，大于时输出低电平。这种模式简单，但每个PWM周期只有一个事件（计数器等于周期时），常用于简单的开关控制。
• 递减模式：TBCTR从TBPRD开始，一直减到0，然后重置为TBPRD。同样产生非对称PWM，但事件顺序相反。
• 递增-递减模式：TBCTR从0开始加到TBPRD，然后反向减回0，如此循环。这产生对称PWM波形。这是电机控制和全桥变换器中最常用的模式，因为它在周期中心对称，能有效减少谐波。在此模式下，一个PWM周期内会产生两个重要事件：CTR=PRD（峰值）和CTR=0（谷值），这为在波形的上升沿和下降沿进行不同的操作（如更新比较值、触发ADC）提供了可能。

配置示例：设置一个100kHz的对称PWM假设系统时钟SYSCLKOUT为100MHz，ePWM时钟分频EPWMCLKDIV默认为2，则EPWMCLK=50MHz。我们希望TBCLK为100MHz以获取更高分辨率，因此设置HSPCLKDIV和CLKDIV均为1（即不分频）。目标PWM频率为100kHz。 在递增-递减模式下，PWM周期Tpwm = (2 * TBPRD) / TBCLK。 因此，TBPRD = (TBCLK / (2 * Fpwm)) - 1 = (100e6 / (2 * 100e3)) - 1 = 500 - 1 = 499。

// 使用Driverlib配置 EPWM_setClockPrescaler(epwmBase, EPWM_CLOCK_DIVIDER_1, EPWM_HSCLOCK_DIVIDER_1); EPWM_setTimeBasePeriod(epwmBase, 499); EPWM_setTimeBaseCounterMode(epwmBase, EPWM_COUNTER_MODE_UP_DOWN); EPWM_setTimeBaseCounter(epwmBase, 0); // ��数器从0开始

3.2 同步链：让多个ePWM模块“齐步走”

在多相电机驱动或交错并联电源中，多个PWM通道之间必须有精确的相位关系。ePWM的同步机制完美解决了这个问题。每个ePWM模块都有一个同步输入EPWMxSYNCI和一个同步输出EPWMxSYNCO，它们可以像链条一样连接起来。

• 主从同步：通常，将第一个ePWM模块（如ePWM1）配置为“主”，它可以使用软件强制同步SWFSYNC或内部事件（如CTR=0）来产生同步脉冲。后续模块（ePWM2, ePWM3...）使能相位加载PHSEN，并将EPWMxSYNCI连接到前一个模块的EPWMxSYNCO。当同步脉冲到来时，从模块会将其相位寄存器TBPHS的值加载到计数器TBCTR中，从而实现相位对齐或偏移。
• 相位偏移控制：这是同步的精髓。通过为每个从模块设置不同的TBPHS值，可以实现精确的相位差。例如，在三相逆变器中，三个桥臂的PWM需要互差120度。如果主模块的TBPRD为600（对应360度），那么设置从模块1的TBPHS=200，从模块2的TBPHS=400，即可实现120度相位差。

配置示例：设置ePWM2滞后ePWM1 90度假设ePWM1为主，工作在增减模式，TBPRD=1000。

// 配置ePWM1为主，使用CTR=0事件产生同步输出 EPWM_setSyncOutPulseMode(EPWM1_BASE, EPWM_SYNC_OUT_PULSE_ON_COUNTER_ZERO); // 配置ePWM2为从，使能相位加载，并设置相位偏移为1/4周期 (1000/4=250) EPWM_setSyncInputPulseSource(EPWM2_BASE, EPWM_SYNC_IN_PULSE_SRC_EXTERNAL); EPWM_enablePhaseShiftLoad(EPWM2_BASE); EPWM_setPhaseShift(EPWM2_BASE, 250); // 设置相位寄存器值 // 注意：在增减模式下，实际的相位偏移计算需考虑方向。此处250意味着ePWM2的计数器从250开始计数。

关键细节：TBPHS是一个24位寄存器（高8位为HRPWM扩展），但TBCTR是16位。在设置相位时，要确保TBPHS的值在0到TBPRD之间（对于增减模式），否则同步加载时可能产生非预期的计数器跳变。

3.3 影子寄存器与加载机制：实现无毛刺更新

在PWM运行时动态更新周期或比较值，如果直接写入活跃寄存器，可能会在计数器正在比较的瞬间造成PWM输出毛刺。ePWM通过影子寄存器机制解决了这个问题。

以周期寄存器TBPRD为例，你实际写入的是它的影子寄存器。硬件会在一个安全的时刻（加载点），自动将影子寄存器的值复制到活跃寄存器中。对于时间基准模块，加载点可以是：

• CTR=0：计数器为零时（推荐用于增减模式）。
• CTR=PRD：计数器等于周期时。
• 立即加载（PRDLD=0），但一般不推荐在运行时使用。

配置示例：安全动态更新PWM频率

// 初始化时设置为在CTR=0时从影子寄存器加载 EPWM_setPeriodLoadMode(epwmBase, EPWM_PERIOD_SHADOW_LOAD); EPWM_setPeriodShadowLoadMode(epwmBase, EPWM_SHADOW_LOAD_MODE_COUNTER_ZERO); // 在运行中需要改变频率时，安全地更新影子寄存器 EPWM_setTimeBasePeriod(epwmBase, newPeriodValue); // 此函数写入的是影子寄存器 // 硬件会在下一个CTR=0时刻，自动将newPeriodValue加载到活跃寄存器，PWM频率平滑切换。

ePWM Type 4进一步增强了这一机制，引入了全局加载功能。你可以通过配置EPWMXLINK寄存器，将多个ePWM模块的TBPRD、CMPA等寄存器的影子加载事件绑定在一起。当主模块的加载事件发生时，所有被链接的模块会同时更新其活跃寄存器。这对于多相交错并联电源至关重要，它能确保各相参数同时切换，避免因更新不同步导致的电流不平衡。

4. 计数器比较子模块：PWM脉宽的“雕刻刀”

时间基准提供了均匀的时间刻度，而计数器比较子模块则是在这个刻度上做标记的“雕刻刀”，它决定了PWM脉冲的边沿时刻，也就是占空比。

4.1 比较寄存器与输出动作

每个ePWM通道通常有多个比较寄存器：CMPA,CMPB，在Type 4中还有CMPC和CMPD。CMPA和CMPB是最常用的，分别用于控制EPWMxA和EPWMxB输出的关键比较点。

但请注意，比较寄存器本身并不直接产生PWM边沿。它只负责在TBCTR等于其设定值时，产生一个“比较匹配”事件。这个事件被送到动作限定子模块，由AQ模块根据配置的规则（置高、置低、翻转）来最终改变输出引脚的状态。

工作流程：

1. 时间基准计数器TBCTR在每个TBCLK周期递增或递减。
2. 硬件持续将TBCTR与CMPA、CMPB等活跃比较寄存器的值进行比较。
3. 当匹配发生时，产生CTR=CMPA或CTR=CMPB事件信号。
4. 该事件信号被发送到动作限定子模块。
5. AQ模块根据预先配置的动作（例如，在CTR=CMPA且计数器递增时，将EPWMxA置低），改变输出控制信号。

4.2 对称与非对称PWM的占空比计算

占空比的计算方式与时间基准的工作模式密切相关：

• 递增-递减模式（对称PWM）：

  • 在这种模式下，一个完整的PWM周期包含上升段和下降段。
  • 通常，我们会在上升段和下降段设置相同的比较事件来生成对称的边沿。例如，设置CMPA，并在AQ中配置：当CTR=CMPA且计数器递增时，将输出置低；当CTR=CMPA且计数器递减时，将输出置高。这样就产生了一个以周期中心为对称点的PWM脉冲。
  • 占空比计算公式：Duty Cycle = (CMPA / TBPRD) * 100%。这里的CMPA值决定了脉冲宽度。CMPA为0时，占空比0%；CMPA等于TBPRD时，占空比100%。

• 递增模式（非对称PWM）：

  • 计数器从0到TBPRD线性增加。
  • 通常配置为：当CTR=CMPA时，将输出翻转（或从低变高，再从高变低）。
  • 占空比计算公式：Duty Cycle = (CMPA / TBPRD) * 100%。注意，此时CMPA决定的是第一个边沿（通常是上升沿）的位置，第二个边沿由计数器归零事件决定。

配置示例：在对称PWM模式下，设置50%占空比

uint16_t period = 1000; // TBPRD uint16_t cmpValue = period / 2; // CMPA = 500， 即50%占空比 EPWM_setTimeBasePeriod(epwmBase, period); EPWM_setCounterCompareValue(epwmBase, EPWM_COUNTER_COMPARE_A, cmpValue); // 配置动作限定：在递增过程中，当CTR=CMPA时，将EPWMxA置低；在递减过程中，当CTR=CMPA时，将EPWMxA置高。 EPWM_setActionQualifierAction(epwmBase, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA); EPWM_setActionQualifierAction(epwmBase, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA);

4.3 CMPC与CMPD的进阶应用

CMPC和CMPD是Type 4 ePWM的增强功能。它们不仅可以像CMPA/B一样用于生成额外的复杂PWM波形，更重要的是，它们的事件可以作为同步输出EPWMxSYNCO的源，或者用于触发ADC转换。

应用场景：在峰值电流控制模式中，你需要在电感电流的峰值点进行采样并关闭开关管。这个峰值点可能随时间变化。你可以将CMPC设置为这个动态计算的关断点。当TBCTR计数到CMPC时，不仅可以通过AQ模块产生关断动作，还可以通过事件触发子模块，用CTR=CMPC事件来触发ADC，对电流进行采样，实现精准的逐周期控制。

配置示例：使用CMPC事件触发ADC

// 假设已经配置好时间基准和CMPA // 动态计算并设置CMPC值（例如，基于电流环计算出的关断时间） EPWM_setCounterCompareValue(epwmBase, EPWM_COUNTER_COMPARE_C, dynamicCmpCValue); // 配置事件触发子模块，当CTR=CMPC事件发生时，触发EPWMxSOCA EPWM_setInterruptSource(epwmBase, EPWM_INT_TBCTR_U_CMPC); // 先选择事件源 EPWM_enableADCTrigger(epwmBase, EPWM_SOC_A); // 使能SOCA触发 EPWM_setADCTriggerSource(epwmBase, EPWM_SOC_A, EPWM_SOC_TBCTR_CMPC); // 将事件源关联到SOCA EPWM_setADCTriggerEventPrescale(epwmBase, EPWM_SOC_A, 1); // 每个事件都触发

通过这种方式，PWM的关断时刻和ADC采样时刻被硬件紧密耦合，消除了软件中断延迟带来的抖动，极大地提升了控制的实时性和精度。

5. 高级功能集成：死区、故障保护与数字比较

理解了时间基准和计数器比较这两个核心，ePWM的骨架就搭好了。但要投入实际工业应用，还必须集成死区生成、故障保护和数字比较这些“安全气囊”和“优化器”。

5.1 死区生成模块：防止桥臂直通的“卫士”

在全桥或半桥拓扑中，上下两个开关管不能同时导通，否则会造成电源短路（直通），烧毁器件。死区时间就是在控制信号中插入的一段上下管都关断的小延时。

ePWM的死区模块可以独立地对上升沿和下降沿进行延时：

• 上升沿延时：在原始信号从低到高跳变后，延迟一段时间再实际输出高电平。
• 下降沿延时：在原始信号从高到低跳变后，延迟一段时间再实际输出低电平。

通常，我们将EPWMxA作为原始信号，通过死区模块生成两路互补的输出：EPWMxA_DT（带死区的A）和EPWMxB_DT（带死区的B），分别驱动上管和下管。

配置示例：插入固定的死区时间假设TBCLK周期为10ns，需要插入100ns的死区时间。

uint16_t deadTimeCounts = 100 / 10; // 需要10个TBCLK周期 // 配置死区模块：对上升沿和下降沿都插入延时，并选择互补输出模式 EPWM_setDeadBandDelayMode(epwmBase, EPWM_DB_RED, EPWM_DB_MODE_DELAY_BOTH); EPWM_setDeadBandDelayMode(epwmBase, EPWM_DB_FED, EPWM_DB_MODE_DELAY_BOTH); EPWM_setDeadBandDelayPolarity(epwmBase, EPWM_DB_RED, EPWM_DB_POLARITY_ACTIVE_HIGH); // 根据驱动芯片极性调整 EPWM_setDeadBandDelay(epwmBase, deadTimeCounts, deadTimeCounts); // 设置RED和FED的延时值 EPWM_setDeadBandOutputPolarity(epwmBase, EPWM_DB_OUTPUT_A, EPWM_DB_POLARITY_ACTIVE_HIGH); EPWM_setDeadBandOutputPolarity(epwmBase, EPWM_DB_OUTPUT_B, EPWM_DB_POLARITY_ACTIVE_LOW_COMPL);

重要提示：死区时间的设置必须大于功率器件的开关延迟（开通延迟+关断延迟），并留有一定裕量。实际值需要通过示波器测量最终驱动波形来校准。

5.2 故障保护与Trip-Zone模块：系统的“紧急刹车”

当系统发生过流、过压、过热等故障时，必须能在微秒级甚至纳秒级内关闭PWM输出。ePWM的Trip-Zone模块提供了硬件级的快速保护。

• Trip输入源：TZ1~TZ3通常连接到外部比较器或故障检测电路的GPIO；TZ4连接eQEP错误信号；TZ5连接系统时钟失效信号；TZ6连接CPU仿真停止信号。
• 保护动作：可配置为强制输出高、强制输出低或高阻态。例如，在电机驱动中，通常配置为“强制低”，使所有开关管关断（刹车）。
• 保护模式：
  • 单次触发：故障发生后，PWM输出被锁存在保护状态，直到软件清除标志位。
  • 周期循环：故障在每个PWM周期都会被检测，如果故障消失，PWM自动恢复。适用于可恢复的瞬时过流。

配置示例：使能TZ1为周期循环故障保护

// 配置TZ1信号源（通常通过GPIO和Input X-BAR配置，此处略） // 配置Trip-Zone子模块 EPWM_enableTripZoneSignals(epwmBase, EPWM_TZ_SIGNAL_1); // 使能TZ1 EPWM_setTripZoneAction(epwmBase, EPWM_TZ_ACTION_EVENT_TZA, // 针对TZ1事件 EPWM_TZ_ACTION_LOW); // 动作：强制输出低 EPWM_setTripZoneCycleByCycleMode(epwmBase); // 设置为周期循环模式 // 如果需要，还可以使能Trip中断，以便在故障发生时通知CPU EPWM_enableTripZoneInterrupt(epwmBase);

5.3 数字比较模块：实现更智能的保护与触发

这是ePWM Type 4一个非常强大的功能。它允许你将外部数字信号（如比较器输出，通过TRIPINx输入）与内部PWM事件进行逻辑比较，产生新的事件。

核心功能：

1. 事件生成：当TRIPINx输入信号满足特定条件（如变高）时，产生DCAEVT/DCBEVT事件。
2. 滤波与消隐：可以对输入信号进行数字滤波以抗噪声，还可以设置消隐窗口，在PWM开关的瞬间忽略故障信号，避免误触发。
3. 事件路由：生成的数字比较事件，可以路由到：
   • 动作限定器：直接强制改变PWM输出状态（DCAEVT1.force），实现基于模拟信号的实时限流。
   • Trip-Zone：作为高级故障源。
   • 事件触发：用于触发ADC或中断。
   • 同步输出：作为同步其他ePWM模块的源。

应用场景：峰值电流模式控制这是数字比较模块的典型应用。电流信号通过比较器，当电流达到设定峰值时，比较器输出翻转。这个翻转信号连接到TRIPIN1。

• 在数字比较模块中，配置当TRIPIN1变高时，产生DCAEVT1.force事件。
• 在动作限定器中，配置该事件强制PWM输出低（关断开关管）。
• 同时，还可以用DCAEVT1事件来触发ADC，在关断时刻对电流进行采样。 这样，就实现了完全由硬件完成的、无软件延迟的逐周期峰值电流控制，动态响应极快。

配置思路：

// 1. 配置Input X-BAR和EPWM X-BAR，将比较器输出路由到ePWM的TRIPIN1。 // 2. 配置数字比较模块 EPWM_setDigitalCompareEventSource(epwmBase, EPWM_DC_MODULE_A, EPWM_DC_EVENT_1, EPWM_DC_EVENT_SOURCE_TRIPIN1); EPWM_setDigitalCompareEventCondition(epwmBase, EPWM_DC_MODULE_A, EPWM_DC_EVENT_1, EPWM_DC_EVENT_CONDITION_TRIPHI_HIGH); // 当TRIPIN1为高时触发 // 3. 配置动作限定器，响应数字比较事件 EPWM_setActionQualifierAction(epwmBase, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_DCAEVT1); // 4. （可选）配置事件触发，用DCAEVT1触发ADC EPWM_setADCTriggerSource(epwmBase, EPWM_SOC_A, EPWM_SOC_DCAEVT1);

通过数字比较模块，ePWM从简单的波形发生器，进化成了一个能够直接响应模拟反馈的智能功率控制核心。

6. 实战配置流程与常见问题排查

理论最终要服务于实践。下面我将一个完整的ePWM通道初始化流程拆解为步骤，并附上我踩过坑后总结的排查清单。

6.1 一个完整的ePWM初始化流程

以配置一个带死区互补输出、带故障保护、能触发ADC的对称PWM为例：

1. 时钟与引脚配置：

   // 1. 初始化系统时钟（通常由SysCtrl模块完成） // 2. 配置GPIO复用为ePWM功能 GPIO_setPinConfig(GPIO_0_EPWM1A); // 将GPIO0配置为EPWM1A GPIO_setPinConfig(GPIO_1_EPWM1B); // 将GPIO1配置为EPWM1B GPIO_setPadConfig(0, GPIO_PIN_TYPE_STD); // 设置推挽输出 GPIO_setMasterCore(0, GPIO_CORE_CPU1); // 指定CPU核心

2. 时间基准模块配置：

   EPWM_setClockPrescaler(EPWM1_BASE, EPWM_CLOCK_DIVIDER_1, EPWM_HSCLOCK_DIVIDER_1); EPWM_setTimeBasePeriod(EPWM1_BASE, 999); // 假设目标频率，计算得到的周期值 EPWM_setTimeBaseCounter(EPWM1_BASE, 0); EPWM_setTimeBaseCounterMode(EPWM1_BASE, EPWM_COUNTER_MODE_UP_DOWN); EPWM_setPhaseShift(EPWM1_BASE, 0); // 无相位偏移 EPWM_setSyncOutPulseMode(EPWM1_BASE, EPWM_SYNC_OUT_PULSE_DISABLED); // 本例中不作为同步源

3. 计数器比较模块配置：

   uint16_t dutyCycle = 300; // 初始占空比对应值 EPWM_setCounterCompareValue(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, dutyCycle); // 配置影子加载模式，在CTR=0时更新，确保无毛刺 EPWM_setCounterCompareShadowLoadMode(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, EPWM_COMP_LOAD_ON_CNTR_ZERO);

4. 动作限定模块配置：

   // 清除所有现有动作 EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_NO_CHANGE, EPWM_AQ_OUTPUT_ON_TIMEBASE_ZERO); // 设置对称PWM动作：递增到CMPA时拉低，递减到CMPA时拉高 EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA); EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA); // 对于互补输出B，可以配置为与A相反，或由死区模块生成

5. 死区模块配置：

   EPWM_setDeadBandDelayMode(EPWM1_BASE, EPWM_DB_RED, EPWM_DB_MODE_DELAY_BOTH); EPWM_setDeadBandDelayMode(EPWM1_BASE, EPWM_DB_FED, EPWM_DB_MODE_DELAY_BOTH); EPWM_setDeadBandDelay(EPWM1_BASE, 10, 10); // 设置死区时间计数 EPWM_setDeadBandOutputPolarity(EPWM1_BASE, EPWM_DB_OUTPUT_A, EPWM_DB_POLARITY_ACTIVE_HIGH); EPWM_setDeadBandOutputPolarity(EPWM1_BASE, EPWM_DB_OUTPUT_B, EPWM_DB_POLARITY_ACTIVE_LOW_COMPL); EPWM_enableDeadBand(EPWM1_BASE); // 最后使能死区模块！

6. 故障保护配置：

   EPWM_enableTripZoneSignals(EPWM1_BASE, EPWM_TZ_SIGNAL_1 | EPWM_TZ_SIGNAL_2); EPWM_setTripZoneAction(EPWM1_BASE, EPWM_TZ_ACTION_EVENT_TZA, EPWM_TZ_ACTION_LOW); EPWM_setTripZoneAction(EPWM1_BASE, EPWM_TZ_ACTION_EVENT_TZB, EPWM_TZ_ACTION_LOW); EPWM_setTripZoneCycleByCycleMode(EPWM1_BASE); // 或 EPWM_setTripZoneOneShotMode

7. 事件触发配置：

   // 配置在CTR=0时触发ADC采样（常用于对称PWM的中心对齐采样） EPWM_setInterruptSource(EPWM1_BASE, EPWM_INT_TBCTR_ZERO); EPWM_enableADCTrigger(EPWM1_BASE, EPWM_SOC_A); EPWM_setADCTriggerSource(EPWM1_BASE, EPWM_SOC_A, EPWM_SOC_TBCTR_ZERO); EPWM_setADCTriggerEventPrescale(EPWM1_BASE, EPWM_SOC_A, 1);

8. 使能PWM输出：

   // 在完成所有子模块配置后，最后使能PWM输出 EPWM_enableDigitalCompareEvent(EPWM1_BASE); // 如果用了数字比较 // 对于AQ模块，输出使能通常隐含在动作配置中。确保没有强制输出指令覆盖。 // 启动时间基准计数器 EPWM_startTimeBaseCounter(EPWM1_BASE);

6.2 常见问题排查速查表

以下是我在项目中遇到的一些典型问题及解决方法：

6.3 调试技巧与心得

1. 寄存器查看是王道：在CCS的寄存器视图中，直接查看EPwm1Regs的所有寄存器。对比你通过Driverlib函数期望设置的值和实际读出的值，这是发现配置错误最快的方法。
2. 分步使能：不要一次性配置所有功能。先只配置时间基准和动作限定器，用示波器看是否有基础PWM输出。然后再逐步加入死区、同步、触发等功能。每加一步，验证一步。
3. 善用强制输出：在调试初期，可以暂时禁用Trip-Zone，并使用AQ模块的软件强制功能EPWM_forceOutput()，手动控制输出高低，来验证GPIO和输出路径是否正常。
4. 理解影子寄存器：动态更新CMPA或TBPRD时，务必清楚你写的是影子寄存器。在调试时，可以临时改为立即加载模式EPWM_setPeriodLoadMode(epwmBase, EPWM_PERIOD_DIRECT_LOAD)来排除影子加载带来的疑惑，但产品代码中应换回影子加载以保证安全。
5. 关注跨模块连接：ePWM的许多高级功能（如数字比较、同步）依赖于Input X-BAR和EPWM X-BAR的正确配置。这部分配置独立于ePWM模块本身，很容易被遗漏。务必在系统初始化时，仔细检查这些交叉开关的映射关系。

最后，ePWM是一个功能极其丰富的模块，不可能通过一篇文章覆盖所有细节。最好的学习方式是在理解其模块化架构的基础上，针对你的具体应用（如电机FOC、LLC谐振变换器、PFC），深入研究相关的子模块，并动手实践。官方提供的C2000Ware库中有大量针对不同应用的示例工程，这些都是极好的学习起点。当你真正把一个ePWM通道调通，并看到它按照你的指令精确地控制功率器件时，那种对硬件的掌控感，正是嵌入式开发的乐趣所在。