TI C2000 eHRPWM寄存器配置实战：从时基到死区的电机控制指南

1. 项目概述与核心价值

如果你正在使用TI的C2000系列微控制器做电机控制、数字电源或者任何需要精确PWM波形的应用，那么eHRPWM（增强型高分辨率脉宽调制器）模块绝对是你绕不开的核心。官方技术手册动辄数百页，寄存器描述密密麻麻，很多工程师拿到手的第一反应是“功能强大，但配置起来真头疼”。特别是那一堆缩写：TBPHS、TBPRD、CMPA、AQCTLA... 每个寄存器位都控制着波形生成的某个细节，配置错了，轻则波形不对，电机抖动，重则炸管烧板。

我花了大量时间，在多个电机驱动和逆变器项目上反复调试、踩坑，才把这些寄存器“驯服”。今天，我就抛开手册上那种冰冷的寄存器位描述，从一个实际使用者的角度，带你深入eHRPWM的寄存器世界。我们不止看每个位是干什么的，更要弄明白为什么要这么设计，以及在实际编程中，怎么配才能既安全又高效。你会发现，理解了时基（TB）、比较器（CMP）和动作限定器（AQ）这三个核心子模块的寄存器如何联动，你就能像指挥交响乐一样，精准地控制每一个脉冲的上升沿和下降沿。

2. eHRPWM寄存器全景与核心设计思路

在深入每个寄存器之前，我们必须先建立起一个顶层的认知框架。eHRPWM不是一个简单的“设定频率和占空比就完事”的模块，它是一个高度可配置、由多个协同工作的子模块组成的精密时序引擎。官方手册通常按子模块列出寄存器，但为了理解其设计哲学，我们可以从数据流和控制流两个维度来看。

数据流的核心是“比较-动作”链。时基计数器（TBCNT）像一根不停摆动的指针，它的摆动范围由周期寄存器（TBPRD）决定。两个比较寄存器（CMPA, CMPB）则像预设好的两个刻度。当指针扫过这些刻度时，就会触发“比较匹配”事件。这个事件本身并不直接改变输出引脚的电平，它只是一个内部的“通知”。这个通知被送到动作限定器（AQ），AQ根据你预先在AQCTLA和AQCTLB寄存器中设置好的“动作规则”（比如：遇到CMPA匹配且计数器在递增时，将EPWMxA置高），来最终驱动输出引脚。理解这一点至关重要：CMPA/CMPB只负责“何时”触发，AQ负责“做什么”。

控制流的核心是“安全与同步”。为什么要有影子寄存器？为什么要有强制动作和Trip-Zone？这都是为了应对实时控制中的两种需求：一是需要平滑、无毛刺地动态改变PWM参数（比如在电机控制中改变转速）；二是需要在纳秒级响应故障（比如过流、过温）并安全关断。影子寄存器（Shadow Register）解决了前一个问题，它允许你在任意时刻更新CMPA/B、TBPRD等参数，但硬件会等到一个安全的时刻（如计数器归零时）才将新值载入生效的“活动寄存器”，从而避免在PWM周期中间切换导致的脉冲宽度异常。Trip-Zone子模块的寄存器（TZSEL, TZCTL等）则解决了后一个问题，它提供了一条完全由硬件管理的、高优先级的故障处理路径，不受CPU软件延迟的影响。

基于这个框架，我们再来拆解各个寄存器组，你就会发现它们不再是孤立的比特位，而是一个有机整体中各司其职的齿轮。

2.1 时基子模块：PWM的心脏与节拍器

时基子模块是PWM波形生成的源头，它定义了波形的“时间坐标系”。你可以把它想象成一个音乐节拍器，决定了乐曲的速度（频率）和从哪里开始（相位）。

2.1.1 时基周期寄存器（TBPRD）：定义PWM的频率

这是最关键的寄存器之一，它直接决定了PWM波的频率。计算公式很简单，但里面有几个细节必须吃透：

PWM频率 = 时基时钟频率 / (TBPRD + 1) * 分频系数

这里的“+1”是因为计数器从0计数到TBPRD值。例如，时基时钟（TBCLK）为100MHz，TBPRD设置为999，采用递增计数模式，则PWM频率为 100MHz / (999 + 1) = 100kHz。

核心配置要点与避坑指南：

1. 影子模式 vs 立即模式：TBPRD通常必须工作在影子模式下（TBCTL[PRDLD]=0）。这是默认配置，也是安全配置。想象一下，你正在驱动一个全桥电路，如果在PWM周期中间突然改变周期值，会导致上下桥臂的导通时间计算混乱，极易引起直通短路。影子模式确保了新周期值只在计数器归零（TBCNT=0）的边界生效，保证了波形切换的平滑性。除非你在做某些特殊的、需要即时响应的调试，否则永远不要将TBPRD设为立即模式。

2. 数值范围与分辨率：TBPRD是16位寄存器，最大值为65535。这限制了最低PWM频率。同时，它也是占空比调节的分母。例如，TBPRD=1000，那么你的占空比分辨率就是0.1%。如果你想获得更高的占空比分辨率（比如用于更平滑的电机转矩控制），要么提高TBPRD（会降低频率），要么使用eHRPWM的高分辨率（HRPWM）扩展，后者通过微边沿定位技术，能将分辨率提升到皮秒级。

3. 与计数模式的关系：在递增-递减计数模式下，计数器会从0数到TBPRD，再从TBPRD数回0。此时，一个完整的PWM周期是2 * TBPRD个时钟周期。因此，频率计算公式变为PWM频率 = 时基时钟频率 / (2 * TBPRD)。很多新手在这里栽跟头，配置了递增-递减模式却用递增模式的公式算频率，结果出来的频率差了一倍。

2.1.2 时基计数器（TBCNT）与相位寄存器（TBPHS）：同步与对齐的艺术

TBCNT是那个实时计数的指针，我们通常不需要直接写它，而是通过配置TBPRD和同步事件来控制它。TBPHS则是实现多个eHRPWM模块同步的关键。

为什么需要同步？在多相电机驱动（如三相逆变器）或交错并联电源中，你需要多个PWM通道输出彼此之间具有固定相位差的波形。例如，三相桥臂的PWM需要互差120度。如果让各个模块自由运行，由于启动时间的微小差异，它们的相位关系会是随机的。TBPHS和同步信号（EPWMxSYNCI/EPWMxSYNCO）就是为了解决这个问题。

实操配置流程：

1. 确定主从模块：选择一个ePWM模块作为主模块（Master），将其时基同步输出（EPWMxSYNCO）使能。其他作为从模块（Slave）。
2. 配置从模块相位：在从模块中，使能相位加载（TBCTL[PHSEN] = 1）。计算你需要的相位偏移对应的TBPHS值。如果主模块的TBPRD为1000，需要60度相位差（占1/6周期），在递增计数模式下，TBPHS应设置为1000 / 6 ≈ 167。在递增-递减模式下，一个电气周期对应2 * TBPRD，因此60度对应(2 * 1000) / 6 ≈ 333。这里极易算错！
3. 连接同步链：将从模块的同步输入（EPWMxSYNCI）连接到主模块的同步输出。
4. 启动顺序：先启动所有从模块（但因其PHSEN使能，TBCNT会等待同步信号而不计数），最后启动主模块。主模块计数器第一次归零时，会发出同步脉冲，所有从模块在同一时刻将自己的TBCNT加载为TBPHS的值，从而实现精确的相位对齐。

重要经验：同步事件发生时，从模块的TBCNT是被直接加载为TBPHS值，而不是从0开始计数。这意味着如果你的TBPHS设置得很大（比如接近TBPRD），从模块的计数器可能一启动就立刻触发比较匹配事件，产生一个非常窄的脉冲。在配置同步时，务必考虑第一个周期的波形是否合理，必要时可以通过软件在同步后稍微调整第一个周期的CMPA值来避免异常脉冲。

2.2 计数器比较子模块：占���比的雕刻刀

比较子模块是定义占空比的核心。CMPA和CMPB这两个寄存器，就是用来在时基计数器这个“时间尺”上刻下两个标记点，分别控制一个PWM通道（通常EPWMxA和EPWMxB）的占空比。

2.2.1 比较寄存器（CMPA, CMPB）与影子模式

CMPA和CMPB的工作原理很直观：当TBCNT的值与CMPA的值相等时，产生CTR=CMPA事件；与CMPB相等时，产生CTR=CMPB事件。占空比的计算取决于计数模式：

• 递增模式：占空比 = CMPA / (TBPRD + 1)
• 递增-递减模式：占空比 = (2 * CMPA) / (2 * TBPRD) = CMPA / TBPRD （注意，此时一个周期内会有两次匹配，通常用于生成对称的中央对齐PWM波）。

CMPCTL寄存器的精妙之处：这个寄存器是安全、灵活更新占空比的枢纽。它控制着CMPA和CMPB的影子模式（SHDWAMODE/SHDWBMODE）和加载模式（LOADAMODE/LOADBMODE）。

• SHDWAMODE=0（影子模式，强烈推荐）：你写入CMPA的值，是先进入一个“影子寄存器”，硬件会在你指定的时刻（由LOADAMODE决定）将其复制到真正起作用的“活动寄存器”。这保证了占空比的变化只发生在PWM周期的边界（如计数器为0或达到周期值时），完全避免了在脉冲中间改变比较值可能导致的脉冲宽度畸变或毛刺。这对于电机和电源控制是生命线。
• LOADAMODE：决定影子寄存器何时生效。
  • 00：在TBCNT=0时加载。这是最常用的设置，确保每个PWM周期开始时采用新的占空比。
  • 01：在TBCNT=TBPRD时加载（适用于递增-递减模式）。
  • 10：在TBCNT=0或TBPRD时加载。提供了更多灵活性。
  • 11：冻结，不自动加载。需要软件强制加载，用于特殊场景。
• SHDWAFULL标志位：这是一个非常重要的状态位。当影子寄存器已满（即你已经写入了一个值但尚未被加载到活动寄存器）时，该位为1。如果你此时再次写入，新值会覆盖影子寄存器中旧的值，旧值将丢失。最佳实践是，在更新CMPA/B前，先检查SHDWAFULL位。如果为1，可以等待一个加载事件发生（标志位自动清零），或者根据你的应用决定是否覆盖。这能防止你无意中丢失一个重要的占空比指令。

2.2.2 高分辨率比较寄存器（CMPAHR）

对于需要极高精度占空比控制的应用（例如高性能数字电源的电压纹波优化），标准16位的CMPA可能不够。CMPAHR寄存器是HRPWM扩展的一部分，它与CMPA联动，形成一个32位的比较值（CMPAHR:CMPA），从而将时间分辨率提升到皮秒级。配置CMPAHR时，需要配合特定的HRPWM控制寄存器，并注意时钟校准。这是一个进阶话题，但记住一点：使用HRPWM时，CMPA通常用于控制“粗调”的边沿（微秒级），而CMPAHR用于控制“微调”的边沿偏移（皮秒级）。

2.3 动作限定器子模块：波形生成的导演

动作限定器（AQ）是eHRPWM中最能体现其“增强型”灵活性的部分。时基和比较器只说了“在某个时刻有事发生”，而AQ则决定了“这个时刻，每个输出引脚具体要做什么”。它就像导演，根据事件（CTR=CMPA, CTR=CMPB, CTR=PRD, CTR=ZRO）和计数器的方向（增/减），指挥EPWMxA和EPWMxB输出高电平、低电平或翻转。

2.3.1 动作控制寄存器（AQCTLA, AQCTLB）配置策略

每个寄存器控制一个输出引脚（AQCTLA控制EPWMxA，AQCTLB控制EPWMxB）。每个寄存器里为每个事件（ZRO, PRD, CAU, CAD, CBU, CBD）分配了2个比特位，用于定义动作：00-无操作，01-强制低，10-强制高，11-翻转。

如何生成一个标准的边沿对齐PWM波？假设我们使用EPWMxA输出，递增计数模式，希望高电平有效，占空比由CMPA控制。

1. 事件定义：我们希望PWM周期开始时（CTR=ZRO）输出变高，当计数器增加到等于CMPA时（CTR=CMPA，递增方向）输出变低。
2. 寄存器配置：
   • AQCTLA[ZRO] = 10(Set high)
   • AQCTLA[CAU] = 01(Clear low)
   • 其他事件（PRD, CAD, CBU, CBD）均设为00（无操作）。
3. 结果：每个周期从0开始，输出立即置高。计数器递增，当等于CMPA时，输出被拉低，并保持低电平直到周期结束（计数器回到0）。这样就产生了一个从周期开始处有一个上升沿，在CMPA处有一个下降沿的PWM波。

如何生成一个中央对齐（对称）PWM波？这在电机控制中非常常用，可以减少谐波。使用递增-递减计数模式。

1. 事件定义：我们希望波形以周期点为中心对称。通常配置为在递增过程中，当CTR=CMPA时输出置高；在递减过程中，当CTR=CMPA时输出置低。
2. 寄存器配置：
   • AQCTLA[CAU] = 10(Set high) // 递增匹配CMPA时置高
   • AQCTLA[CAD] = 01(Clear low) // 递减匹配CMPA时置低
   • ZRO和PRD事件通常设为无操作（00）。
3. 结果：输出波形是一个以周期点为中心对称的脉冲。占空比 = CMPA / TBPRD。

2.3.2 软件强制寄存器（AQSFRC, AQCSFRC）：调试与控制的利器

这两个寄存器允许软件直接干预输出，而不依赖于时基计数器事件。

• AQSFRC（一次性软件强制）：你可以通过写OTSFA位来在EPWMxA上立即产生一个“强制事件”，并根据ACTSFA位的配置执行动作（置高、置低、翻转）。这个事件是一次性的，非常适合用于注入测试脉冲或进行故障模拟。注意：OTSFA位在写入1并触发事件后会自动清零。
• AQCSFRC（连续软件强制）：这更强大，它可以持续地覆盖AQ模块的正常输出，将引脚强制拉高或拉低。这在以下场景非常有用：
  • 安全关断：在系统初始化完成前，确保所有功率管驱动引脚处于确定的安全状态（如全低）。
  • 故障处理：作为Trip-Zone硬件保护的软件补充，在检测到次级故障时，由软件强制输出安全状态。
  • 调试：手动控制输出，绕过复杂的PWM逻辑，直接测试功率级电路。

实操心得：在系统初始化代码中，我养成了一个习惯：在配置eHRPWM其他寄存器之前，先配置AQCSFRC，将CSFA和CSFB设为01（强制低）或10（强制高，根据你的硬件安全逻辑）。这能确保从芯片复位到PWM正确配置完成的这段时间里，功率输出是确定的、安全的。然后再在PWM启动前，将AQCSFRC恢复为00（强制禁用），将控制权交还给AQ模块。

2.4 死区生成与故障联防：实战中的安全屏障

前面的模块生成了理想的PWM逻辑波形，但在实际功率电路中，直接使用它们会带来风险。死区（Dead-Band）和故障保护（Trip-Zone）是eHRPWM内置的、至关重要的安全机制。

2.4.1 死区发生器寄存器（DBCTL, DBRED, DBFED）

在驱动H桥或半桥电路时，控制同一桥臂上下两个开关管的PWM信号必须是互补的，且中间必须插入一段死区时间，即两个信号都为低电平的短暂重叠区。这是为了防止上下管因开关速度差异而同时导通，造成致命的“直通”短路。

DBCTL寄存器配置解析：

• IN_MODE：选择哪个输入信号（EPWMxA或EPWMxB）作为上升沿和下降沿延迟的源。经典配置是00，即EPWMxA同时作为上升沿和下降沿延迟的源，EPWMxB输出���互补信号。
• POLSEL：极性选择。这是容易混淆的地方。它控制是否对延迟后的信号进行取反。
  • 00（Active High）：都不取反。如果输入EPWMxA是高有效脉冲，那么经过死区后，EPWMxA输出是上升沿延迟的原信号，EPWMxB输出是下降沿延迟的原信号。这通常不是我们想要的互补带死区信号。
  • 01（Active Low Complementary）：对EPWMxA取反。这是最常用的模式！它生成一对互补的、低电平有效的信号，并且自带死区。非常适合驱动常见的“高电平导通”的IGBT或MOSFET栅极驱动器（因为驱动器内部常带反相）。
  • 10（Active High Complementary）：对EPWMxB取反。生成一对互补的、高电平有效的信号带死区。
  • 11（Active Low）：都对取反。生成两个都是低有效的信号，不互补。
• OUT_MODE：输出模式。11是完全使能死区（默认）。00是旁路死区发生器，信号直通。

DBRED 和 DBFED寄存器：这两个10位寄存器分别设置上升沿延迟和下降沿延迟的时钟周期数。死区时间 = 延迟值 * TBCLK周期。例如，TBCLK=100MHz (10ns)，DBRED=50，则上升沿延迟为500ns。

配置示例：生成互补带死区信号目标：基于EPWMxA（来自AQ）生成一对互补信号EPWMxA_OUT和EPWMxB_OUT，高电平有效，死区时间500ns（TBCLK=10ns）。

1. AQ模块配置EPWMxA输出所需的PWM逻辑波形（如边沿对齐PWM），EPWMxB未使用或配置为固定值。
2. 死区模块配置：
   • DBCTL[IN_MODE] = 00（EPWMxA作为双延迟源）
   • DBCTL[POLSEL] = 10（对EPWMxB取反，生成高有效互补信号）
   • DBCTL[OUT_MODE] = 11（使能死区）
   • DBRED = 50（上升沿延迟500ns）
   • DBFED = 50（下降沿延迟500ns）
3. 最终输出：EPWMxA_OUT是原始EPWMxA信号，但其上升沿被延迟了500ns；EPWMxB_OUT是原始EPWMxA信号取反后，其上升沿（对应原信号的下降沿）也被延迟了500ns。这样就确保了在任何切换瞬间，两个输出都有至少500ns的共同低电平时间。

2.4.2 故障联防寄存器（TZSEL, TZCTL, TZFLG, TZCLR）

Trip-Zone是eHRPWM的硬件保护伞。当外部故障信号（如过流比较器输出、温度传感器）触发TZn引脚时，eHRPWM可以在几个时钟周期内无视软件状态，直接按照预设动作强制改变PWM输出，实现纳秒级响应。

• TZSEL（选择寄存器）：决定哪个TZn引脚触发哪种保护。
  • CBCn（Cycle-By-Cycle）：逐周期保护。故障发生时，立即动作，但仅持续当前PWM周期。如果下个周期开始时故障已消失，PWM自动恢复正常。适用于短暂的、可恢复的过流。
  • OSHTn（One-Shot）：一次性保护。故障发生时立即动作，并且锁存。即使故障信号消失，输出也将保持强制状态，直到软件通过TZCLR寄存器明确清除故障标志。适用于严重的、需要系统彻底关断并检查的故障（如短路）。
• TZCTL（控制寄存器）：定义当故障发生时，EPWMxA和EPWMxB输出应被强制为何种状态。通常设置为01（强制高）或10（强制低），具体取决于你的功率电路在安全状态下需要高电平关断还是低电平关断。绝对不能设为11（无操作），那将使保护失效。
• TZFLG（标志寄存器）：用于软件查询是哪种故障（CBC或OST）触发了保护。
• TZCLR（清除寄存器）：软件通过写此寄存器来清除TZFLG中的故障标志位，特别是清除OST锁存状态，以便在故障排除后能重新启动PWM。

实战配置流程：

1. 硬件连接：将过流比较器的输出连接到MCU的TZ1引脚。
2. 软件配置：
   • TZSEL[CBC1] = 1// 使能TZ1为逐周期保护源。
   • TZSEL[OSHT1] = 1// 使能TZ1为一次性保护源（通常二者选一，根据故障性质）。
   • TZCTL[TZA] = 10// 故障时，强制EPWMxA输出低电平（假设低电平关断功率管）。
   • TZCTL[TZB] = 10// 故障时，强制EPWMxB输出低电平。
3. 在中断服务程序（ISR）中：读取TZFLG寄存器判断故障类型，执行相应的故障处理程序（如记录日志、关闭其他外设），然后通过TZCLR写入相应值来清除标志位（对于OST故障必须清除才能恢复）。

3. 从零开始：一个完整的eHRPWM配置实例

理论说了这么多，我们来看一个完整的、可移植的配置代码片段，用于生成一对带死区的互补PWM信号，并启用逐周期过流保护。假设系统时钟SYSCLKOUT为200MHz，ePWM时钟预分频为2（即TBCLK=100MHz），目标PWM频率为20kHz，死区时间1us，采用递增-递减计数模式生成中央对齐PWM。

// 宏定义，提高可读性和可移植性 #define EPWM_TIMER_TBPRD (2500) // PWM周期值。频率 = TBCLK / (2*TBPRD) = 100MHz / (2*2500) = 20kHz #define EPWM_CMPA_VALUE (1250) // 比较值A，决定占空比。占空比 = CMPA / TBPRD = 1250/2500 = 50% #define EPWM_DEADBAND_RED (100) // 上升沿延迟时钟数。死区时间 = 100 * 10ns = 1us #define EPWM_DEADBAND_FED (100) // 下降沿延迟时钟数 void InitEPwm1(void) { // 1. 时基子模块配置 EPwm1Regs.TBCTL.bit.CTRMODE = TB_COUNT_UPDOWN; // 递增-递减计数模式 EPwm1Regs.TBCTL.bit.PHSEN = TB_DISABLE; // 禁用相位加载（作为主模块） EPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW; // TBPRD使用影子模式 EPwm1Regs.TBCTL.bit.SYNCOSEL = TB_SYNC_DISABLE; // 禁止同步输出，或设为TB_SYNC_OUT用于同步从模块 EPwm1Regs.TBCTL.bit.HSPCLKDIV = TB_DIV2; // 高速时钟预分频 /2 EPwm1Regs.TBCTL.bit.CLKDIV = TB_DIV1; // 时钟预分频 /1 // TBCLK = SYSCLKOUT / (HSPCLKDIV * CLKDIV) = 200MHz / (2*1) = 100MHz EPwm1Regs.TBPRD = EPWM_TIMER_TBPRD; // 设置PWM周期 EPwm1Regs.TBPHS.half.TBPHS = 0; // 相位寄存器清零 // 2. 计数器比较子模块配置 EPwm1Regs.CMPCTL.bit.SHDWAMODE = CC_SHADOW; // CMPA使用影子模式 EPwm1Regs.CMPCTL.bit.SHDWBMODE = CC_SHADOW; // CMPB使用影子模式 EPwm1Regs.CMPCTL.bit.LOADAMODE = CC_CTR_ZERO; // 在TBCNT=0时加载CMPA影子值 EPwm1Regs.CMPCTL.bit.LOADBMODE = CC_CTR_ZERO; // 在TBCNT=0时加载CMPB影子值 EPwm1Regs.CMPA.half.CMPA = EPWM_CMPA_VALUE; // 设置比较值A (占空比) // 3. 动作限定器子模块配置 - 生成中央对齐PWM // EPWMxA: 递增匹配CMPA时置高，递减匹配CMPA时置低 EPwm1Regs.AQCTLA.bit.CAU = AQ_SET; // CTR=CMPA, 递增 -> 置高 EPwm1Regs.AQCTLA.bit.CAD = AQ_CLEAR; // CTR=CMPA, 递减 -> 置低 // EPWMxB: 由死区模块生成互补信号，此处AQ可配置为无操作，或生成另一路独立PWM EPwm1Regs.AQCTLB.bit.CBU = AQ_SET; // 这里仅为示例，若B路独立，可类似配置 EPwm1Regs.AQCTLB.bit.CBD = AQ_CLEAR; // 4. 死区发生器子模块配置 EPwm1Regs.DBCTL.bit.IN_MODE = DBA_ALL; // EPWMxA作为两个延迟单元的源 EPwm1Regs.DBCTL.bit.POLSEL = DB_ACTV_HIC; // 高有效互补模式 (对EPWMxB取反) EPwm1Regs.DBCTL.bit.OUT_MODE = DB_FULL_ENABLE; // 完全使能死区 EPwm1Regs.DBRED = EPWM_DEADBAND_RED; // 上升沿延迟 EPwm1Regs.DBFED = EPWM_DEADBAND_FED; // 下降沿延迟 // 5. 故障联防子模块配置 EPwm1Regs.TZSEL.bit.CBC1 = 1; // 使能TZ1为逐周期(CBC)故障源 EPwm1Regs.TZSEL.bit.OSHT1 = 0; // 本例禁用一次性故障 EPwm1Regs.TZCTL.bit.TZA = TZ_FORCE_LO; // 故障时，强制EPWMxA为低 EPwm1Regs.TZCTL.bit.TZB = TZ_FORCE_LO; // 故障时，强制EPWMxB为低 // 注意：还需要配置GPIO复用将TZ1引脚功能使能，并连接外部故障信号。 // 6. 初始安全状态：通过连续软件强制，在PWM启动前确保输出为低 EPwm1Regs.AQCSFRC.bit.CSFA = AQCSF_FORCE_LO; // 强制EPWMxA持续低 EPwm1Regs.AQCSFRC.bit.CSFB = AQCSF_FORCE_LO; // 强制EPWMxB持续低 // 7. 使能PWM输出 (此操作通常在所有模块初始化完成后，最后一步执行) // EPwm1Regs.AQCSFRC.bit.CSFA = AQCSF_DISABLE; // 禁用软件强制，将控制权交还给AQ // EPwm1Regs.AQCSFRC.bit.CSFB = AQCSF_DISABLE; }

4. 高级技巧与常见问题排查

即使按照手册配置，在实际项目中你还是会遇到各种诡异的问题。下面分享一些踩坑后总结的经验和排查思路。

4.1 影子模式下的“写入丢失”问题

现象：你周期性地更新CMPA值以改变占空比，但偶尔会发现某个占空比指令没有生效，电机或电源出现一次抖动。

原因与排查：

1. 检查SHDWAFULL标志：这是最常见的原因。你在上一个影子值还未被加载（LOAD事件未发生）时，就写入了新的CMPA值，导致旧值被覆盖丢失。解决方案：在更新CMPA前，增加一个等待或检查。

   // 安全的CMPA更新函数 void SafeUpdate_CMPA(Uint16 newCmpaVal) { // 方法1：等待直到影子寄存器空闲（适用于实时性要求不极端高的场合） while(EPwm1Regs.CMPCTL.bit.SHDWAFULL == 1) { ; // 空等待，或插入一些短延时 } EPwm1Regs.CMPA.half.CMPA = newCmpaVal; // 方法2：基于事件的更新（更可靠）。在PWM周期中断（CTR=0或CTR=PRD）服务程序中更新CMPA。 // 因为中断发生时，影子寄存器必定刚被加载完，处于空闲状态。 }

2. 确认LOADAMODE配置：你配置为在CTR=0时加载，但你的软件更新节奏可能和PWM周期不同步。确保你的更新频率不高于PWM频率，且更新时间点离CTR=0时刻有足够余量。

4.2 无输出或输出恒定电平

现象：配置了一切，但用示波器测量EPWMx引脚，没有波形，或者是固定高/低电平。

系统性排查步骤：

1. 检查时钟和使能：确认系统时钟是否正确，ePWM模块的时钟是否使能（在PCLKCR0/1寄存器中）。没有时钟，计数器根本不会动。
2. 检查GPIO复用：这是新手最易忽略的一点！即使ePWM内部产生了信号，如果对应的GPIO引脚没有配置为ePWM功能，信号是送不到引脚上的。务必检查GPxMUX和GPxGMUX寄存器，将对应引脚配置为EPWM模式。
3. 检查AQCTL配置：如果AQCTLA和AQCTLB中所有事件都设置为“无操作（00）”，那么无论计数器怎么跑，输出都不会有动作。至少需要为一个输出配置一个SET和一个CLEAR事件。
4. 检查TZCTL和AQCSFRC：如果Trip-Zone被误触发，或者AQCSFRC的连续强制功能被使能且未禁用，它们会覆盖AQ的正常输出。检查TZFLG寄存器是否有故障标志，并确保在启动PWM前，AQCSFRC.CSFA/CSFB = 00。
5. 使用仿真器实时查看寄存器：连接仿真器，在调试模式下运行，实时观察TBCNT寄存器是否在循环计数，CMPA值是否合理，以及EPWMxA/B的输出动作标志（在某些IDE的寄存器视图中可以看到）。这是最直接的诊断方法。

4.3 死区时间不生效或异常

现象：测量互补的两路输出，发现没有死区，或者死区时间远大于/小于配置值。

排查：

1. 确认OUT_MODE：DBCTL[OUT_MODE]必须设置为11（完全使能）。如果设成了00，死区模块被旁路。
2. 理解POLSEL的影响：POLSEL配置错误会导致最终的输出极性完全相反。如果你期望的是“高有效互补”，但实际测量是“低有效互补”，检查POLSEL位。用示波器同时观察死区模块的输入（来自AQ的EPWMxA）和最终输出，理清信号路径。
3. 计算时钟：死区时间 =DBRED/DBFED值 * TBCLK周期。再次确认你的TBCLK频率计算是否正确（SYSCLKOUT / (HSPCLKDIV * CLKDIV)）。一个常见的错误是忽略了HSPCLKDIV。
4. 检查输入源IN_MODE：确保DBCTL[IN_MODE]与你AQ模块实际使用的输出源一致。如果你用AQCTLA生成波形，那么IN_MODE通常应选择EPWMxA作为源。

4.4 同步功能失效

现象：配置了主从同步，但从模块的波形相位没有对齐，或者根本没有启动。

排查：

1. 同步信号路径：主模块必须配置TBCTL[SYNCOSEL]输出同步脉冲（如TB_SYNC_OUT）。从模块的TBCTL[PHSEN]必须设为TB_ENABLE。检查是否有其他模块意外截断了同步链。
2. 启动顺序：务必先启动从模块（使能计数器），最后启动主模块。如果先启动主模块，主模块发出的第一个同步脉冲时，从模块可能还未准备好接收。
3. TBPHS值：确认从模块的TBPHS值计算正确，考虑是递增模式还是递增-递减模式。
4. 使用EPWMxSYNCI输入：有些工程师误以为同步是自动的，实际上你需要将主模块的EPWMxSYNCO输出信号（通常通过内部SOC信号路由）连接到从模块的EPWMxSYNCI输入。这可能需要配置输入限定器或直接使用内部连接。

深入理解并熟练配置eHRPWM的寄存器，是掌握TI C2000系列芯片进行高性能实时控制的关键一步。它不再是一个黑盒的“PWM发生器”，而是一个你可以精确操控的波形合成工具。从时基的同步，到比较值的影子更新，再到动作限定器的灵活导演，以及死区和故障保护的硬件保障，每一个环节都体现了对工业应用可靠性和灵活性的深度思考。希望这篇从寄存器出发的解析，能帮你建立起清晰的配置脉络，在下次面对电机啸叫、电源纹波过大或者波形不同步的问题时，能够快速定位到那个关键的寄存器位。