TI C2000 eCAP模块：从高精度捕获到同步PWM生成的实战指南-平芜编程栈

1. 从硬件计时器到系统核心：eCAP模块的双重角色解析

在嵌入式开发，尤其是电机控制、数字电源和精密测量领域，时间就是一切。一个脉冲的宽度、两个边沿的间隔、多个信号之间的相位关系，这些毫秒乃至微秒级的时序信息，直接决定了系统的性能、效率与稳定性。早年做项目，为了测量一个高频PWM的占空比，要么得用CPU频繁中断去采样GPIO，大量消耗算力；要么得外挂专门的计时芯片，增加了成本和板子面积。直到后来用上了TI的C2000系列微控制器，其内置的增强型捕获（eCAP）模块，才真正让我体会到了“硬件加速”的爽快感——它就像一个专为时间而生的小型协处理器，能独立、精确地完成时间戳记录和波形生成，把CPU彻底解放出来。

简单来说，eCAP模块是一个高度集成的外设，它身兼两职：高精度捕获器和灵活PWM发生器。在捕获模式下，它能像高速录像机一样，记录下输入信号每个边沿发生的精确时刻（时间戳），无论是测量频率、周期还是占空比，都手到擒来。而在APWM模式下，它又摇身一变，成为一个可同步、可调相位的PWM信号源，特别适合需要多个严格同步的PWM通道的应用，比如三相逆变器或者交错式Boost电路。它的价值在于，将复杂的时序逻辑和计算固化在硬件中，实现了确定性极高的实时响应，这是纯软件方案难以企及的。

如果你正在开发需要精密时序控制的应用，比如无刷电机FOC控制、开关电源、超声波测距或者编码器信号处理，那么深入理解eCAP模块将是提升你系统设计水平的关键一步。它不仅仅是配置几个寄存器，更关乎如何将硬件特性与系统架构深度融合。接下来，我将结合手册原理和实际项目经验，为你层层拆解eCAP的工作机制、配置要点以及那些手册上不会写的避坑技巧。

2. eCAP模块架构深度拆解：不止是计时器

初次接触eCAP的数据手册，那一堆寄存器框图和控制位可能会让人望而生畏。但如果我们把它想象成一个功能明确的“时间处理单元”，其架构就清晰多了。它的核心是一个32位的自由运行计数器（TSCTR），这是所有功能的“心跳”。这个计数器由系统时钟驱动，不断累加，直到溢出后归零重新开始。围绕这个核心计数器，eCAP搭建了两套独立的处理流水线：一套用于捕获（Capture），一套用于比较并生成PWM（APWM）。

2.1 捕获模式的核心流水线：四级流水与工作模式

捕获模式的精髓在于其“四级顺序器”（Mod4 Sequencer）和四组对应的捕获寄存器（CAP1-CAP4）。你可以把它理解为一个有四层货架的自动化仓库。当外部输入引脚（ECAPx）上发生一个符合预设极性（上升沿或下降沿）的事件时，这个事件会进入流水线。

首先，当前32位计数器（TSCTR）的值会被瞬间“抓拍”下来。然后，这个被抓拍的时间戳值会被存放到当前激活的捕获寄存器中（比如第一次事件存到CAP1）。紧接着，顺序器状态加1（比如从0变为1），指向下一个捕获寄存器（CAP2），为下一次捕获做好准备。这个过程会连续进行四次，完成一个完整的循环（CAP1 -> CAP2 -> CAP3 -> CAP4），然后顺序器归零，重新从CAP1开始。这种设计的好处是，它可以连续、无丢失地捕获最多四个事件的时间戳，而无需CPU立即干预。

这里的关键控制位是ECCTL1寄存器中的CTRRSTx（x=1,2,3,4）。它决定了每次捕获事件发生后，那个核心的32位计数器TSCTR该如何行动，从而衍生出两种根本性的工作模式：

绝对时间戳模式（CTRRSTx = 0）：在此模式下，TSCTR像一个永不停止的跑表。每次捕获，只是读取这个跑表的当前时刻。要计算两个事件之间的时间间隔（比如周期），需要CPU用后一个时间戳减去前一个时间戳。例如，Period1 = CAP2 - CAP1。这种模式适合测量绝对时间点或当信号周期可能长于计数器溢出周期的情况。
差值（Delta）模式（CTRRSTx = 1）：这是更常用、也更高效的模式。每次捕获事件发生后，硬件在读取时间戳后，会自动将TSCTR复位为0。这意味着，每个捕获寄存器里存储的，直接就是上一个事件到当前事件所经过的时间差。例如，在连续上升沿触发下，CAP1里存的就是第一个周期长度，CAP2里存的就是第二个周期长度，依此类推。CPU读取的就是直接的周期值，省去了减法运算，减少了软件开销和潜在的错误。

注意：选择“差值模式”时，你必须确保信号的周期小于TSCTR从0计数到溢出（0xFFFFFFFF）的时间。否则，在下一个事件到来前计数器就溢出了，这会置位溢出标志（CTROVF），并且捕获到的时间值将是错误的（因为计数器归零了）。设计时需要根据系统时钟和信号最大周期来核算。

2.2 APWM模式的变身逻辑：从捕获到比较

当ECCTL2[CAP/APWM]位设置为1时，eCAP模块就进入了APWM模式。这时，它的内部逻辑会发生一次巧妙的“角色转换”：

引脚功能反转： ECAPx引脚从输入变为输出，直接输出PWM波形。
寄存器功能重映射：
- CAP1寄存器变成了周期活动寄存器（APRD），定义了PWM波的周期。
- CAP2寄存器变成了比较活动寄存器（ACMP），定义了输出电平翻转的时刻（对于主动高电平模式，即高电平的宽度）。
- CAP3和CAP4寄存器则分别成为上述两个活动寄存器的影子寄存器。这是实现PWM参数无毛刺更新的关键。
工作原理： 32位计数器TSCTR从0开始累加，并与CAP1（周期值）和CAP2（比较值）实时比较。
- 当TSCTR < CAP2时，输出有效电平（由APWMPOL位定义是高有效还是低有效）。
- 当TSCTR >= CAP2且TSCTR < CAP1时，输出无效电平。
- 当TSCTR等于CAP1（即CTR = PRD）时，在一个时钟周期内，TSCTR被复位为0，同时产生一个周期匹配事件。这个事件是同步和影子加载的关键触发器。

影子寄存器机制是工业级PWM控制的核心。它允许CPU在任何时候更新CAP3（影子周期寄存器）或CAP4（影子比较寄存器），但这个新值不会立即影响正在输出的PWM波形。只有当TSCTR下一次计数到周期值（CTR = PRD事件）时，影子寄存器的内容才会被安全地、同步地加载到活动寄存器（CAP1和CAP2）中。这确保了PWM周期和占空比的改变发生在波形的边界，完全避免了在脉冲中间切换可能产生的“毛刺”或“窄脉冲”，这对于电机和电源控制是性命攸关的。

2.3 同步与相位控制：多模块协同的基石

单个eCAP模块已经很强大了，但TI的设计远不止于此。多个eCAP模块（或与ePWM模块）之间可以通过同步链（Sync Chain）协同工作，这是实现复杂多通道系统的关键。

同步输入（SYNCI）与同步输出（SYNCO）：每个eCAP模块都有一个同步输入信号SYNCI和一个同步输出信号SYNCO。SYNCI可以来自外部引脚，也可以来自其他eCAP/ePWM模块的SYNCO。
相位控制寄存器（CTRPHS）：这是一个“相位偏移值”寄存器。当使能同步（SYNCI_EN=1）且发生同步事件（硬件SYNCI信号或软件强制同步SWSYNC）时，TSCTR不会简单地被复位为0，而是会被加载为CTRPHS寄存器中的值。这就实现了硬件级的精确相位偏移。
工作流程：假设我们有一个主模块（Master）和两个从模块（Slave1, Slave2）。我们将Master的SYNCO配置为在CTR=PRD（周期匹配）时产生同步脉冲，并连接到两个Slave的SYNCI。Slave使能同步输入，并设置各自的CTRPHS为不同的值（比如0， 1200， 2400）。当Master的计数器达到周期值并发出同步脉冲时，所有Slave的TSCTR会同时被加载为各自CTRPHS的值，然后开始计数。这样，三个模块的PWM波形就具有了精确的、固定的相位差。这在三相电机驱动或交错式电源中至关重要，可以有效地平滑电流纹波。

3. 从理论到实践：eCAP双模式配置与代码实现

理解了架构，我们来看如何动手配置。手册上的表格虽然全面，但直接套用往往不知其所以然。下面我将结合代码片段，解释每个关键配置背后的意图，并分享一些调试中积累的实用技巧。

3.1 捕获模式实战：测量PWM频率与占空比

假设我们需要测量一个输入PWM信号的频率和占空比，信号频率大约10kHz，系统时钟SYSCLK为100MHz。我们选择差值模式，并利用全部四个捕获寄存器，以连续捕获上升沿和下降沿。

第一步：模式与时钟配置

我们目标是测量周期和占空比，因此需要捕获上升沿和下降沿。差值模式能直接给出时间差，更高效。系统时钟100MHz，计数器每个计数代表10ns。对于10kHz信号（周期100us），计数器需要计数值为100us / 10ns = 10000，远小于32位计数器的最大值，差值模式完全安全。

// 首先，停止计数器以确保安全配置 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; // 停止TSCTR计数器 // 配置ECCTL1：事件极性、计数器复位模式、预分频 ECap1Regs.ECCTL1.bit.CAP1POL = EC_RISING; // 事件1：上升沿触发 ECap1Regs.ECCTL1.bit.CTRRST1 = EC_DELTA_MODE; // 事件1后复位计数器 ECap1Regs.ECCTL1.bit.CAP2POL = EC_FALLING; // 事件2：下降沿触发 ECap1Regs.ECCTL1.bit.CTRRST2 = EC_DELTA_MODE; // 事件2后复位计数器 ECap1Regs.ECCTL1.bit.CAP3POL = EC_RISING; // 事件3：上升沿触发 ECap1Regs.ECCTL1.bit.CTRRST3 = EC_DELTA_MODE; // 事件3后复位计数器 ECap1Regs.ECCTL1.bit.CAP4POL = EC_FALLING; // 事件4：下降沿触发 ECap1Regs.ECCTL1.bit.CTRRST4 = EC_DELTA_MODE; // 事件4后复位计数器 ECap1Regs.ECCTL1.bit.CAPLDEN = EC_ENABLE; // 使能捕获寄存器加载 ECap1Regs.ECCTL1.bit.PRESCALE = EC_DIV1; // 事件滤波器预分频设为1（直通） // 如果输入信号有毛刺，可以增大PRESCALE进行滤波，例如EC_DIV2（2分频）

第二步：运行控制与中断配置

我们希望连续测量，所以配置为连续模式。我们选择在第四个捕获事件（CEVT4）时触发中断，这样一次中断可以读取四个时间戳，计算出一个完整的周期和两个占空比信息。

// 配置ECCTL2：模式、运行控制、同步 ECap1Regs.ECCTL2.bit.CAP_APWM = EC_CAP_MODE; // 设置为捕获模式 ECap1Regs.ECCTL2.bit.CONT_ONESHT = EC_CONTINUOUS; // 连续捕获模式 ECap1Regs.ECCTL2.bit.SYNCO_SEL = EC_SYNCO_DIS; // 禁用同步输出（本例单模块） ECap1Regs.ECCTL2.bit.SYNCI_EN = EC_DISABLE; // 禁用同步输入 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN; // 启动TSCTR计数器！ // 配置中断：使能CEVT4中断 ECap1Regs.ECEINT.bit.CEVT4 = 1; // 使能捕获事件4中断 // 注意：也需要在PIE控制器中使能对应的eCAP中断线

第三步：中断服务程序（ISR）数据处理

在CEVT4中断中，我们读取四个捕获寄存器。由于工作在差值模式，CAP1和CAP3存储的是上升沿到下降沿的时间（高电平时间），CAP2和CAP4存储的是下降沿到上升沿的时间（低电平时间）。

__interrupt void ecap1_isr(void) { uint32_t high_time1, low_time1, high_time2, low_time2; uint32_t period1, period2; float duty_cycle1, duty_cycle2; // 读取捕获值。注意：在差值模式下，这些值直接就是时间间隔（单位：时钟周期数） high_time1 = ECap1Regs.CAP1; // 第一个高电平时间 low_time1 = ECap1Regs.CAP2; // 第一个低电平时间 high_time2 = ECap1Regs.CAP3; // 第二个高电平时间 low_time2 = ECap1Regs.CAP4; // 第二个低电平时间 // 计算周期和占空比 period1 = high_time1 + low_time1; // 第一个完整周期 period2 = high_time2 + low_time2; // 第二个完整周期 duty_cycle1 = (float)high_time1 / (float)period1 * 100.0f; // 第一个周期占空比 duty_cycle2 = (float)high_time2 / (float)period2 * 100.0f; // 第二个周期占空比 // 可以根据period1/2计算频率：Freq = SYSCLK / period // 关键！清除中断标志，否则会持续进入中断 ECap1Regs.ECCLR.bit.CEVT4 = 1; // 清除CEVT4标志 ECap1Regs.ECCLR.bit.INT = 1; // 清除全局中断标志 // 同时需要确认PIE中断应答寄存器 PieCtrlRegs.PIEACK.all = PIEACK_GROUP4; }

实操心得：在差值模式下，CAP1到CAP4的读数顺序与事件顺序严格对应。但在中断处理中，必须考虑“数据就绪”的时机。手册图示表明，在第四个事件（CEVT4）发生时，四个寄存器的值才全部更新为最新一轮的数据。因此，像上面这样在CEVT4中断中读取所有四个值是最稳妥的。如果试图在CEVT1中断里读取CAP1，此时CAP2/3/4可能还是上一轮的老数据，会导致计算错误。

3.2 APWM模式实战：生成带死区的互补PWM

在电机驱动和全桥电源中，我们经常需要生成一对互补的、带有死区（Deadband）的PWM信号，以防止上下桥臂直通。虽然ePWM模块是死区生成的专家，但用eCAP的APWM模式配合软件逻辑或外部逻辑芯片也能实现。这里我们演示如何用两个eCAP模块生成一对相位相反的PWM（假设死区由外部硬件或软件插入）。

目标：使用eCAP1和eCAP2生成两个频率为20kHz（周期=50us），占空比为30%，且互为反相的PWM。eCAP1为主模块，eCAP2为从模块，相位偏移180度。

第一步：主模块（eCAP1）配置

主模块配置为标准APWM模式，并使其在周期匹配时产生同步输出。

// 停止计数器 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; // 配置为APWM模式，主动高电平输出 ECap1Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; ECap1Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; // 比较值代表高电平时间 // 设置周期值。系统时钟100MHz，20kHz对应计数值 = 100MHz / 20kHz = 5000 ECap1Regs.CAP1 = 5000; // 写入活动周期寄存器APRD // 注意：在APWM模式下，写入CAP1也会同时写入其影子寄存器CAP3（APRD影子） // 设置初始比较值（占空比30%）。高电平时间 = 5000 * 0.3 = 1500 ECap1Regs.CAP2 = 1500; // 写入活动比较寄存器ACMP // 同样，写入CAP2也会同时写入其影子寄存器CAP4（ACMP影子） // 配置同步：禁止同步输入，同步输出选择CTR=PRD事件 ECap1Regs.ECCTL2.bit.SYNCI_EN = EC_DISABLE; ECap1Regs.ECCTL2.bit.SYNCO_SEL = EC_CTR_PRD; // 关键！主模块在周期点发出同步脉冲 // 启动计数器 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN;

第二步：从模块（eCAP2）配置

从模块需要与主模块同步，并设置180度相位偏移。180度偏移意味着从模块的计数器起始点比主模块晚半个周期。半个周期对应的计数值是 5000 / 2 = 2500。

// 停止计数器 ECap2Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; // 配置为APWM模式，主动高电平输出 ECap2Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; ECap2Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; // 设置相同的周期值 ECap2Regs.CAP1 = 5000; // 设置相同的比较值（占空比一致） ECap2Regs.CAP2 = 1500; // 配置相位偏移：这是实现反相的关键！ // 当同步事件发生时，TSCTR会被加载为CTRPHS的值。 // 要延迟180度，CTRPHS应设置为半个周期的值。 ECap2Regs.CTRPHS = 2500; // 相位偏移寄存器 // 配置同步：使能同步输入，同步源选择SYNCI（即来自主模块的SYNCO） ECap2Regs.ECCTL2.bit.SYNCI_EN = EC_ENABLE; // 使能同步加载CTRPHS ECap2Regs.ECCTL2.bit.SYNCO_SEL = EC_SYNCO_DIS; // 从模块可以禁用同步输出，或级联 // 启动计数器（注意：此时计数器可能不会立刻运行，等待同步信号） ECap2Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN;

第三步：运行时更新占空比

为了安全无毛刺地更新占空比，我们应该通过影子寄存器CAP4（ACMP影子）来更新。

// 假设需要在运行时将eCAP1的占空比从30%改为40% uint32_t new_cmp = 5000 * 0.4; // 新的比较值 = 2000 ECap1Regs.CAP4 = new_cmp; // 写入影子寄存器 // 硬件会在下一个CTR=PRD（周期结束）时，自动将CAP4的值加载到CAP2，完成平滑更新。 // 如果需要立即更新（不推荐在精密控制中使用，可能产生窄脉冲），可以直接写活动寄存器： // ECap1Regs.CAP2 = new_cmp; // 这会同时更新CAP2和CAP4（立即模式）

重要提示：相位控制寄存器CTRPHS的值是在同步事件发生时加载到TSCTR中的。因此，从模块的计数器起始点 =CTRPHS。要实现反相（180度偏移），CTRPHS应设为Period/2。若CTRPHS设为0，则主从模块完全同步启动。这个机制非常灵活，可以实现任意精确的相位差，对于多相交错并联电源减少输入输出纹波至关重要。

4. 高级应用与同步链构建：多相电机驱动实例

让我们看一个更复杂的、贴近真实应用的例子：控制一个三相永磁同步电机（PMSM）。这通常需要三个相位互差120度的PWM信号（通常由ePWM模块产生，但eCAP同样可以胜任）。此外，可能还需要一个独立的PWM用于刹车控制或风扇调速。我们使用四个eCAP模块来实现。

系统设计：

eCAP1：作为主时钟源，产生基础频率的同步信号。假设开关频率为10kHz。
eCAP2, eCAP3, eCAP4：作为三个相位桥臂的PWM发生器，分别偏移0°, 120°, 240°。
目标：所有PWM频率严格同步，相位关系精确固定。

配置步骤详解：

1. 主模块（eCAP1）配置：它的主要任务是产生一个稳定的周期信号，并在每个周期开始时发出同步脉冲。它自身也可以输出一个PWM（例如用于刹车控制），但这里我们更关注其同步功能。

// eCAP1 主模块配置 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; ECap1Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; ECap1Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; ECap1Regs.CAP1 = 10000; // 周期值，对应10kHz @ 100MHz SysClk ECap1Regs.CAP2 = 5000; // 初始占空比50% ECap1Regs.CTRPHS = 0; // 主模块自身相位为0 ECap1Regs.ECCTL2.bit.SYNCI_EN = EC_DISABLE; // 主模块不需要外部同步 ECap1Regs.ECCTL2.bit.SYNCO_SEL = EC_CTR_PRD; // 关键：在周期匹配点输出同步脉冲 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN;

2. 从模块（eCAP2, eCAP3, eCAP4）配置：这三个模块需要接收来自eCAP1的同步信号，并设置各自的相位偏移。一个完整的电角度周期（360°）对应一个PWM周期（10000个计数）。那么：

120° 相位偏移对应的计数值 = 10000 * (120 / 360) = 3333.33 ≈ 3333（取整）
240° 相位偏移对应的计数值 = 10000 * (240 / 360) = 6666.66 ≈ 6667（取整）

// eCAP2 配置 (U相， 偏移 0°) ECap2Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; ECap2Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; ECap2Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; ECap2Regs.CAP1 = 10000; // 周期与主模块相同 ECap2Regs.CAP2 = 5000; // 初始占空比 ECap2Regs.CTRPHS = 0; // 相位偏移0° ECap2Regs.ECCTL2.bit.SYNCI_EN = EC_ENABLE; // 使能同步输入 ECap2Regs.ECCTL2.bit.SYNCO_SEL = EC_SYNCI; // 同步输出选择为直通输入，便于级联（可选） ECap2Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN; // eCAP3 配置 (V相， 偏移 120°) ECap3Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; ECap3Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; ECap3Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; ECap3Regs.CAP1 = 10000; ECap3Regs.CAP2 = 5000; ECap3Regs.CTRPHS = 3333; // 相位偏移120° (10000 * 120/360) ECap3Regs.ECCTL2.bit.SYNCI_EN = EC_ENABLE; ECap3Regs.ECCTL2.bit.SYNCO_SEL = EC_SYNCO_DIS; // 本例中不需要eCAP3再输出同步 ECap3Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN; // eCAP4 配置 (W相， 偏移 240°) ECap4Regs.ECCTL2.bit.TSCTRSTOP = EC_FREEZE; ECap4Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; ECap4Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; ECap4Regs.CAP1 = 10000; ECap4Regs.CAP2 = 5000; ECap4Regs.CTRPHS = 6667; // 相位偏移240° (10000 * 240/360) ECap4Regs.ECCTL2.bit.SYNCI_EN = EC_ENABLE; ECap4Regs.ECCTL2.bit.SYNCO_SEL = EC_SYNCO_DIS; ECap4Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN;

硬件连接：需要确保eCAP1模块的SYNCO输出信号（通常映射到某个特定引脚或内部信号）连接到eCAP2、eCAP3、eCAP4的SYNCI输入源。这通常在芯片的输入多路复用器（Input XBAR）或直接内部连接中配置，具体需参考芯片数据手册的“信号连接”章节。

运行时控制：在电机控制算法中（如FOC），我们需要实时更新三个相位的占空比。为了保证三个PWM通道同时更新，避免相位错乱，应利用影子寄存器并在主模块的同步点进行批量更新。

// 在控制算法计算完新的三相占空比后（U, V, W） uint32_t new_cmp_u, new_cmp_v, new_cmp_w; // ... 计算 new_cmp_u, new_cmp_v, new_cmp_w ... // 更新影子寄存器。注意：eCAP2/3/4的ACMP影子寄存器是CAP4。 ECap2Regs.CAP4 = new_cmp_u; ECap3Regs.CAP4 = new_cmp_v; ECap4Regs.CAP4 = new_cmp_w; // 由于所有从模块的SYNCI都连接到主模块的SYNCO， // 当下一个主模块周期结束时（CTR=PRD），主模块发出同步脉冲。 // 这个脉冲会同时触发两件事： // 1. 所有从模块的TSCTR被加载为各自的CTRPHS值（实现相位偏移）。 // 2. 所有从模块的影子寄存器(CAP3/CAP4)值被加载到活动寄存器(CAP1/CAP2)。 // 因此，三个相位的PWM将在同一个同步脉冲下，同时更新占空比并保持精确相位关系。

这种基于硬件同步链和影子寄存器的设计，确保了多通道PWM更新的绝对同步性和无毛刺特性，是构建高可靠性电机驱动和数字电源系统的基石。

5. 调试陷阱与性能优化指南

即使理解了原理和配置，在实际调试中依然会遇到各种问题。下面是我在多个项目中总结的常见“坑点”和优化建议。

5.1 常见问题排查速查表

现象	可能原因	排查步骤与解决方案
捕获模式无中断产生	1. 输入引脚未正确映射。 2. 事件极性（CAPxPOL）设置错误。 3. 中断未使能（ECEINT）或PIE配置错误。 4. 输入信号频率过高或过低，超出滤波器范围或导致计数器溢出。	1. 检查GPIO复用配置，确保ECAPx引脚功能已启用。 2. 用示波器确认信号边沿，并核对`CAPxPOL`位。 3. 检查`ECEINT`寄存器、PIEIER和PIEACK寄存器。确保ISR已正确声明和挂接。 4. 估算信号周期和计数器溢出时间。对于慢信号，考虑使用预分频（PRESCALE）或检查是否因噪声产生误触发。
捕获值始终为0或不变	1. 计数器未启动（`TSCTRSTOP=0`）。 2. 捕获寄存器加载被禁止（`CAPLDEN=0`）。 3. 在APWM模式下误读了CAP寄存器（APWM模式下CAP1/2功能已变）。	1. 确认`ECCTL2.bit.TSCTRSTOP`已设置为`EC_RUN`。 2. 确认`ECCTL1.bit.CAPLDEN`已设置为1。 3. 检查`ECCTL2.bit.CAP_APWM`模式位，确认处于捕获模式。
APWM模式无输出	1. 引脚未配置为输出功能。 2. 模块仍处于捕获模式（`CAP/APWM=0`）。 3. 比较值（CAP2）大于或等于周期值（CAP1）。 4. 输出极性（APWMPOL）理解有误。	1. 检查GPIO配置，确保APWMx引脚已设置为外设输出功能。 2. 确认`ECCTL2.bit.CAP_APWM`已设置为`EC_APWM_MODE`。 3. 确保`CAP2`<`CAP1`才能产生有效脉冲。若`CAP2=0`，则输出常低（主动高）或常高（主动低）。 4. 用示波器观察，结合`APWMPOL`设置判断逻辑是否正确。
多模块间不同步	1. 同步信号（SYNCI/SYNCO）未正确连接或使能。 2. 主从模块的周期值（CAP1）设置不一致。 3. 从模块的`SYNCI_EN`未使能。 4. 主模块的`SYNCO_SEL`未正确设置为`EC_CTR_PRD`。	1. 查阅芯片手册，确认同步信号的内部路由（XBAR）配置正确。 2. 确保所有需要同步的模块`CAP1`值相同。 3. 检查从模块`ECCTL2.bit.SYNCI_EN`是否为1。 4. 检查主模块`ECCTL2.bit.SYNCO_SEL`是否设置为`EC_CTR_PRD`或`EC_SYNCIN`（若它也是从模块）。
相位偏移不准	1.`CTRPHS`值计算错误。 2. 同步事件发生在非预期时刻。 3. 在运行中修改了`CTRPHS`，但未触发新的同步事件。	1. 重新计算：`CTRPHS = (期望相位角 / 360°) * 周期值( CAP1 )`，并取整。 2. 确认主模块的同步输出条件（`SYNCO_SEL`）符合设计。 3.`CTRPHS`是影子寄存器，修改后需要一次同步事件（软件强制`SWSYNC`或硬件SYNCI）才能生效。
更新PWM参数产生毛刺	直接写入了活动寄存器（CAP1或CAP2）而非影子寄存器（CAP3或CAP4）。	严格遵守规则：初始化时写CAP1/CAP2（会同时初始化影子寄存器）。运行时只通过CAP3（更新周期）或CAP4（更新比较值）来修改参数，让硬件在`CTR=PRD`时自动加载。

5.2 性能优化与高级技巧

事件滤波器的妙用：ECCTL1[PRESCALE]不仅是一个简单的时钟分频器。它实际上是一个事件滤波器。当输入信号有噪声或振铃时，可能会产生多个错误的边沿检测。通过设置预分频（例如EC_DIV2），eCAP模块要求输入信号边沿稳定保持至少2个系统时钟周期才会被确认为有效事件，这能极大增强抗干扰能力。但要注意，这会轻微降低时间戳的分辨率。
单次模式（One-Shot）的应用场景：ECCTL2[CONT/ONESHT]设置为单次模式时，模块在捕获完指定数量的事件（由STOP_WRAP位决定，例如4个事件）后会自动停止并禁止后续捕获。这在需要精确捕获特定数量脉冲（如编码器索引信号）或触发特定序列后等待软件处理的场景非常有用，可以避免数据被新事件覆盖。
软件强制同步（SWSYNC）的调试价值：ECCTL2[SWSYNC]位写1可以产生一个软件同步脉冲。这在调试多模块系统时极其有用。你可以在代码中手动触发同步，然后用调试器观察各个模块的TSCTR是否被同时加载为各自的CTRPHS值，从而验证同步链路是否畅通。
利用中断状态寄存器快速定位问题：ECFLG寄存器记录了所有中断事件的状态。在调试时，不要只关注全局中断标志INT。定期检查CEVT1-4、CTROVF、CTR=PRD、CTR=CMP这些具体标志位，可以帮你快速定位是哪个环节出了问题。例如，如果CTROVF被置位，说明在差值模式下计数器溢出了，需要检查信号周期是否过长。
时钟与精度权衡： eCAP的计数器由系统时钟（SYSCLK）驱动。更高的系统时钟意味着更高的时间戳分辨率（例如100MHz下为10ns），但也意味着计数器溢出更快（约42.9秒）。在差值模式下，必须确保待测信号的最大周期小于溢出时间。对于超低频信号测量，可以考虑使用绝对时间戳模式，或者对输入信号进行预分频。
APWM模式下的“即时更新”陷阱：手册提到，在APWM模式下，直接写CAP1或CAP2会同时更新活动寄存器和影子寄存器，模拟“即时更新”模式。除非在初始化阶段，否则应避免这种操作。因为在PWM周期中间更新比较值，可能导致当前周期产生一个极窄的脉冲或毛刺，这在功率应用中可能是灾难性的。养成只通过CAP3/CAP4更新的习惯。