深入解析TI C2000 eCAP模块：从捕获到APWM的实战指南

1. 从硬件计数器到应用场景：eCAP模块的核心价值

在嵌入式开发，尤其是电机控制、电源管理和精密测量领域，我们经常需要和两种基础但至关重要的硬件功能打交道：一是精确测量外部信号的时序，比如一个脉冲的宽度、两个边沿之间的间隔，或者一串PWM波的频率和占空比；二是精确地生成控制波形，比如驱动电机的PWM信号，或者管理开关电源的驱动脉冲。过去，我们可能需要一个专用的输入捕获单元和一个独立的PWM发生器，不仅占用更多硬件资源，两者之间的同步和协调也常常让人头疼。

德州仪器（TI）在其C2000系列等微控制器中集成的增强型捕获（eCAP）模块，就是为解决这类问题而生的“多面手”。它绝不是一个简单的计时器外设，而是一个将高精度时间测量（捕获模式）和灵活波形生成（APWM模式）深度融合的硬件引擎。其核心价值在于，它用一套硬件资源，通过软件配置，就能在“信号分析仪”和“信号发生器”两种角色间无缝切换，甚至能扮演“多路同步信号发生器”的指挥家角色。

我接触过不少项目，从需要捕捉无刷直流电机反电动势过零点的风机控制，到需要生成多路严格同步且相位可调的LLC谐振电源，eCAP模块都因其灵活性和精度成为了首选。它的工作核心围绕着一个32位的自由运行计数器（TSCTR）展开。在捕获模式下，这个计数器像一块永不停止的精密秒表，当外部引脚发生指定的边沿事件（如上升沿）时，硬件会自动将此刻的“秒表读数”（时间戳）锁存到对应的CAPx寄存器中，我们可以通过读取这些“快照”来反推信号的时间特性。而在APWM模式下，这个计数器则变成一个周期性的锯齿波或三角波发生器，通过比较器产生占空比可调的PWM波。

更巧妙的是，它的四组捕获/比较寄存器（CAP1-CAP4）和影子寄存器机制，为复杂应用铺平了道路。无论是连续捕获四个事件点来计算周期和占空比，还是在APWM模式下实现周期和比较值的双缓冲更新以消除毛刺，都体现了其设计的深思熟虑。对于刚接触它的朋友，可能会被其众多的寄存器位吓到，但一旦理解了其“事件驱动”和“双缓冲”这两个核心思想，就会发现它其实非常直观和强大。接下来，我们就拆开揉碎，看看这个模块到底怎么用。

2. 模块架构与核心寄存器深度解析

要驾驭eCAP模块，绝不能停留在调用库函数的层面，必须深入理解其寄存器配置。这就像开车，知道油门和刹车在哪是基础，但了解发动机和变速箱的工作原理，才能应对复杂路况。eCAP的寄存器集就是它的控制面板，每一个比特位都对应着硬件逻辑的一个开关或状态。

2.1 核心数据寄存器：TSCTR, CAP1-CAP4, CTRPHS

时间戳计数器（TSCTR）是整个模块的心跳。它是一个32位向上计数器，时钟源通常来自系统时钟SYSCLKOUT或其分频。在捕获模式下，它自由运行（或可在事件后复位），为每个捕获事件提供绝对的时间基准。在APWM模式下，它则在一个周期内从0计数到周期值（APRD），然后复位，周而复始，形成PWM的时基。

捕获寄存器（CAP1-CAP4）是模块的“记忆单元”。在捕获模式下，它们按顺序（由内部的4态顺序器Mod4控制）锁存事件发生时的TSCTR值。例如，配置为连续捕获上升沿，那么第一个上升沿到来时，TSCTR值存入CAP1；第二个存入CAP2，以此类推，到CAP4后回到CAP1，循环往复。这里的关键在于CTRRSTx位（在ECCTL1中），它决定了每次捕获后TSCTR是否复位。若不复位（CTRRSTx=0），我们得到的是绝对时间戳，需要后续软件做减法（如CAP2-CAP1）才能得到周期；若复位（CTRRSTx=1），我们得到的是差值时间戳，CAPx中直接就是相邻事件的时间间隔，省去了软件计算的开销。

在APWM模式下，CAP1和CAP2的角色发生了根本变化：它们分别作为活动周期寄存器（APRD）和活动比较寄存器（ACMP），直接与TSCTR比较以产生PWM边沿。而CAP3和CAP4则成为它们的影子寄存器。这种双缓冲机制是生成无毛刺PWM的关键：你可以在任何时候安全地更新CAP3/CAP4（影子寄存器），而硬件只会在一个PWM周期结束（TSCTR=PRD）的边界，自动将影子寄存器的值载入活动寄存器，从而确保PWM波形的连续和平滑，不会在周期中间出现畸变。

计数器相位控制寄存器（CTRPHS）是实现多模块同步的“相位调节器”。它存储一个相位偏移值。当模块使能同步输入（SYNCI_EN=1）并接收到同步信号（来自外部或其他eCAP模块）时，TSCTR会被强制加载CTRPHS的值，而非从0开始。这就允许你精确地设置多个eCAP模块输出PWM波之间的相位差，对于三相逆变器或交错并联电源这种需要固定相位关系的应用至关重要。

2.2 控制寄存器：ECCTL1与ECCTL2

ECCTL1寄存器主要管理捕获事件的细节。CAPxPOL位决定每个捕获事件由上升沿还是下降沿触发，这让你可以灵活测量正脉宽、负脉宽或整个周期。PRESCALE位提供了事件预分频器，可以对输入信号进行2至62的偶数分频，这对于过滤高频噪声或测量低频信号非常有用。FREE/SOFT位则控制仿真器暂停时计数器的行为，在调试实时性要求高的控制环路时需要注意。

ECCTL2寄存器是模式切换和全局控制的枢纽。CAP/APWM位是模式选择的总开关，写0进入捕获模式，写1进入APWM模式。APWMPOL位决定PWM输出极性（高有效或低有效）。SYNCI_EN和SYNCO_SEL位构成了强大的同步链：一个模块可以将其CTR=PRD事件作为同步输出（SYNCO），传递给下一个模块的同步输入（SYNCI），从而实现多个PWM通道的严格同步启动和相位对齐。CONT/ONESHT位选择连续捕获还是单次捕获模式，后者在捕获到指定数量的事件后自动停止，适用于非周期性的单次测量。

2.3 中断系统：ECEINT, ECFLG, ECCLR, ECFRC

eCAP提供了丰富的中断事件源：四个捕获事件（CEVT1-4）、计数器等于比较值（CTR=CMP）、计数器等于周期值（CTR=PRD）以及计数器溢出（CTROVF）。通过中断使能寄存器（ECEINT）可以灵活开启所需的中断。中断标志寄存器（ECFLG）会锁存发生的事件，而中断清除寄存器（ECCLR）用于软件清除标志位。中断强制寄存器（ECFRC）则允许软件模拟一个事件来触发中断，这在测试和调试时非常方便。

注意：配置eCAP中断的标准流程应遵循“先关后开，清除残影”的原则。正确的顺序是：1. 禁用全局中断；2. 停止TSCTR计数器；3. 禁用eCAP所有中断（ECEINT）；4. 配置所有eCAP控制寄存器；5. 清除ECFLG中所有可能误触发的标志位；6. 使能所需的eCAP中断；7. 启动TSCTR计数器；8. 最后使能全局中断。这一步至关重要，可以避免因寄存器配置过程中产生的中间状态引发不可预期的中断。

3. 捕获模式实战：从绝对时间戳到差值测量

理解了寄存器，我们进入实战。捕获模式是eCAP的看家本领，其核心目的是非侵入式地、高精度地测量外部数字信号的时序。根据CTRRST位的配置，可分为绝对时间戳和差值（Delta）时间戳两种基本模式，每种模式又可搭配边沿触发方式，衍生出多种应用场景。

3.1 绝对时间戳模式：测量周期与占空比

在这种模式下，TSCTR计数器自��运行，永不复位（或只在溢出时从0开始）。每次捕获事件发生时，只是将当前的TSCTR值“拍照”存入CAPx寄存器。要得到时间信息，必须在软件中做减法。

场景一：仅上升沿触发，测量信号频率。这是最简单的应用。假设我们只关心信号的周期（从而计算频率），可以将四个捕获事件都配置为上升沿触发（CAP1POL-CAP4POL = 0）。如图13-10所示，当连续四个上升沿到来，CAP1-4分别记录了t1, t2, t3, t4时刻的计数器值。在第四个事件（CEVT4）触发的中断服务程序（ISR）中，我们可以安全读取四个寄存器（因为此时四个值都已稳定），并通过连续相减得到三个周期值：Period1 = CAP2 - CAP1,Period2 = CAP3 - CAP2,Period3 = CAP4 - CAP3。这种方法的优点是能连续测量多个周期，适合频率监测。初始化配置可参考表13-1，核心是设置CTRRST1-4 = 0（绝对模式），CAPxPOL = 0（上升沿），并工作在连续模式（CONT/ONESHT=0）。

场景二：交替边沿触发，同时测量周期与占空比。若要测量PWM波的占空比，就需要同时捕获上升沿和下降沿。如图13-11所示，我们可以将CAP1和CAP3配置为上升沿触发，CAP2和CAP4配置为下降沿触发（CAP1POL=0, CAP2POL=1, CAP3POL=0, CAP4POL=1）。这样，CAP1和CAP2就构成了第一个脉冲的起点和终点，CAP2和CAP3构成了第一个脉冲的终点和第二个脉冲的起点，以此类推。 在CEVT4中断中，我们可以计算出第一个脉冲的参数：

• Period1 = CAP3 - CAP1（第一个脉冲起点到第二个脉冲起点）
• DutyOnTime1 = CAP2 - CAP1（第一个脉冲高电平时间）
• DutyOffTime1 = CAP3 - CAP2（第一个脉冲低电平时间） 占空比自然就是(DutyOnTime1 / Period1) * 100%。这种交替配置充分利用了四个寄存器，实现了高密度采样。初始化配置见表13-2。

3.2 差值时间戳模式：直接读取时间间隔

在差值模式下，CTRRSTx位被置1。这意味着每次完成捕获后，TSCTR会立即复位为0，然后重新开始计数。因此，CAPx寄存器中捕获到的值，直接就是本次事件与上一次事件之间的时间间隔（TSCTR从0开始计到事件发生时的值），无需软件再做减法。

场景三：上升沿触发，直接读取周期。如图13-12所示，配置为上升沿触发。第一个上升沿到来时，TSCTR值T1（从0开始计）存入CAP1，然后TSCTR复位。到第二个上升沿时，TSCTR已从0计数到T2，存入CAP2后再次复位。此时，CAP1中就是第一个周期（T1），CAP2中是第二个周期（T2），以此类推。我们可以在任何一个事件（如CEVT1）中断中读取CAP1，直接得到刚结束的那个周期长度。代码极其简洁：Period = ECAPxRegs.CAP1;。初始化见表13-3。

场景四：交替边沿触发，直接读取脉宽。这是测量占空比最高效的方式。如图13-13所示，配置CAP1为上升沿，CAP2为下降沿，CAP3为上升沿，CAP4为下降沿。在差值模式下，CAP1捕获到的是从前一个下降沿到当前上升沿的时间（低电平时间？这里需要仔细推敲：因为TSCTR每次捕获后复位，所以CAP1实际是上一个下降沿到当前上升沿的时间，即低电平时间？不，取决于第一个事件是什么）。实际上，为了逻辑清晰，通常我们关注一个完整周期内的“高电平时间”和“低电平时间”。假设信号起始为低电平，第一个事件是上升沿，则：

• CAP1 (上升沿触发): 值T1无意义（因为之前无事件，TSCTR从0计到第一个上升沿，这个时间不是信号特征）。
• CAP2 (下降沿触发): 值T2 = 第一个脉冲的高电平时间。
• CAP3 (上升沿触发): 值T3 = 第一个脉冲的低电平时间。
• CAP4 (下降沿触发): 值T4 = 第二个脉冲的高电平时间。 因此，第一个完整周期是Period1 = T2 + T3，占空比为(T2 / Period1) * 100%。在代码中（例13-4），需要小心处理寄存器的读取顺序和对应关系。初始化见表13-4。

实操心得：选择绝对模式还是差值模式？我的经验是，对于固定频率或频率变化缓慢的信号，差值模式更高效，因为硬件直接完成了减法，节省了CPU开销，且避免了32位减法可能产生的借位处理。但对于频率快速变化或需要记录绝对时间点的场景（如事件序列分析），绝对模式更合适，因为它保留了完整的时间线信息。另外，在差值模式下要特别注意计数器溢出问题，如果两个事件间隔过长，TSCTR可能在到达事件前就已从最大值翻转到0，这会置位CTROVF标志。虽然中断可以处理，但最好的方法是根据信号最大预期周期，合理设置TSCTR的时钟预分频，让它在溢出前有足够长的计数范围。

4. APWM模式实战：从单通道到多相系统

将CAP/APWM位设置为1，eCAP瞬间从一个测量工具变身为一个灵活的PWM发生器。APWM模式的核心是利用TSCTR作为时基，与CAP1（作为周期寄存器APRD）和CAP2（作为比较寄存器ACMP）进行比较，在APWMx引脚上产生波形。

4.1 单通道PWM生成

这是最基础的应用。如图13-14所示，我们需要配置周期值（写入CAP1）和比较值（写入CAP2）。TSCTR从0开始递增，当TSCTR < ACMP时，根据APWMPOL位，输出有效电平（例如高有效则为高电平）；当ACMP <= TSCTR < APRD时，输出无效电平；当TSCTR == APRD时，TSCTR复位为0，并开始下一个周期，同时产生CTR=PRD事件。

关键配置步骤：

1. 写入初始周期值到CAP1，初始比较值到CAP2。这里有一个非常重要的细节：在初始化时，对活动寄存器CAP1/CAP2的写操作，会自动将相同的值拷贝到其影子寄存器CAP3/CAP4中（模拟立即模式）。这确保了PWM立即以你设定的参数启动。
2. 设置ECCTL2寄存器：CAP/APWM = 1(APWM模式)，APWMPOL选择极性，SYNCO_SEL和SYNCI_EN根据同步需求设置，TSCTRSTOP = 1启动计数器。
3. 运行时更新占空比：若要改变PWM占空比，必须写入影子寄存器CAP4（即ACMP的影子寄存器）。硬件会在下一个CTR=PRD边界自动将其载入活动的CAP2寄存器，从而实现无毛刺的平滑更新。如果错误地直接写入CAP2，虽然也会立即生效（并同时写入CAP4），但这可能发生在周期中间，导致输出产生一个窄脉冲或短周期，破坏波形完整性。初始化代码参考例13-5。

4.2 多通道同步PWM生成

在许多应用中，我们需要多个PWM通道，并且它们之间必须保持严格的频率倍数关系或同步关系，以避免产生差拍噪声。eCAP的同步功能在此大显身手。

实现原理：选择一个eCAP模块作为主模块（Master），将其SYNCO_SEL设置为EC_CTR_PRD，这样每当它的TSCTR达到周期值（CTR=PRD）时，就会产生一个同步输出脉冲。其他作为从模块（Slave）的eCAP，将其SYNCI_EN使能，并将SYNCO_SEL设置为EC_SYNCI，这样它们就能接收主模块的同步信号。当从模块收到同步信号时，它的TSCTR会被强制加载其CTRPHS寄存器的值（通常为0以实现对齐），然后开始计数。这就保证了所有从模块的PWM周期都与主模块同时开始。

应用示例：如图13-15所示，需要生成4路PWM，频率分别为F1（主）、2F1、4F1、5*F1。我们设置主模块（ECAP1）的周期为20000（对应F1）。那么：

• ECAP2（Slave2）周期应设为10000（频率2*F1）。
• ECAP3（Slave3）周期应设为5000（频率4*F1）。
• ECAP4（Slave4）周期应设为4000（频率5*F1）。 所有从模块使能SYNCI_EN，并指向主模块的同步输出。��样，每当主模块周期结束，所有从模块的计数器都被同步复位，确保了所有通道的相位锁定，消除了异步可能带来的谐波问题。配置细节见表13-6至13-9，代码见例13-6。

4.3 带相位控制的多相PWM生成

在诸如三相逆变器或交错并联DC-DC变换器中，不仅需要同步，还需要各通道之间具有固定的相位差（例如三相120度差）。eCAP的相位控制寄存器CTRPHS正是为此而生。

实现原理：在同步的基础上，为每个从模块的CTRPHS寄存器设置不同的值。当从模块收到主模块的同步信号时，它的TSCTR不是从0开始，而是从CTRPHS值开始计数。因此，它的PWM输出波形相对于主模块就有了一个固定的相位偏移。

相位值计算：相位偏移量由CTRPHS寄存器的值决定。假设PWM周期值为Period，需要产生的相位差为Φ（角度），则CTRPHS的计算公式为：CTRPHS = (Φ / 360°) * Period。对于三相120度差：

• 主模块 ECAP1:CTRPHS = 0(参考0度)
• 从模块 ECAP2:CTRPHS = (120 / 360) * Period = Period / 3(滞后120度)
• 从模块 ECAP3:CTRPHS = (240 / 360) * Period = 2 * Period / 3(滞后240度)

图13-16和例13-7展示了一个三相交错DC-DC转换器的应用，三个模块的周期相同（1200），通过设置不同的CTRPHS值（0， 800， 400）实现了精确的120度相位间隔。这里CTRPHS值800对应 (800/1200)*360° = 240°， 400对应 (400/1200)*360° = 120°， 注意图中标注的Φ2=120°, Φ3=240°是相对于APWM1的相位，而CTRPHS是计数器起始值，所以CTRPHS(2)=800产生了240°相位（因为计数器起点晚），CTRPHS(3)=400产生了120°相位。这需要根据实际硬件比较逻辑（是TSCTR与CMP比较，还是CMP与TSCTR比较）来理解相位超前与滞后的关系，通常CTRPHS值越大，该通道的波形起始点越晚，相位越滞后。

避坑指南：在APWM模式下进行动态更新（如改变频率或占空比）时，务必遵循“影子寄存器更新”原则。对于周期更新，应写入CAP3；对于比较值更新，应写入CAP4。除非你明确需要立即生效且能接受可能产生的脉冲畸变，否则不要直接写CAP1/CAP2。另外，在配置多模块同步时，初始化顺序很重要。建议先配置所有从模块的SYNCI_EN和SYNCO_SEL，但先不要启动它们的计数器（TSCTRSTOP=0）。然后配置并启动主模块。最后，再启动从模块的计数器。这样可以避免在同步信号建立之前，从模块就开始自由运行，导致同步瞬间产生相位跳变。

5. 高级应用与调试技巧

掌握了基本模式后，我们可以探索一些更高级的用法和调试中常见的问题。

5.1 事件滤波与去抖

eCAP模块的输入捕获通道通常集成了一个数字滤波器（或预分频器），由ECCTL1.PRESCALE位控制。它不仅仅是一个简单的分频器，更是一个事件鉴别器。例如，设置PRESCALE = EC_DIV6，意味着输入信号需要连续6个系统时钟周期保持稳定（高或低），才会被确认为一个有效的边沿事件。这对于消除开关噪声、接触抖动等引起的毛刺非常有效。在测量机械编码器或按键等易抖动的信号时，合理设置预分频值是保证测量准确性的第一步。

5.2 单次（One-Shot）捕获模式

除了连续捕获，eCAP还支持单次捕获模式（CONT/ONESHT=1）。在此模式下，你需要通过STOP_WRAP位设定在捕获到第几个事件后停止（1到4）。一旦捕获到指定数量的事件，Mod4顺序器和捕获寄存器加载都会被冻结，直到你通过写RE-ARM位为1来重新武装模块。这个模式非常适用于捕获非周期性的突发脉冲串，或者你只关心信号前几个边沿的场景。例如，可以用来测量一个单脉冲的宽度（配置为上升沿和下降沿触发，STOP_WRAP=2），捕获完成后自动停止，不占用更多CPU中断资源。

5.3 仿真控制与调试

ECCTL1.FREE/SOFT位在代码调试时尤为重要。当你在仿真器中设置断点暂停CPU时，TSCTR计数器的行为由这两位决定：

• 00: 仿真暂停时，TSCTR立即停止。这便于观察暂停时刻的精确计数器值。
• 01: 仿真暂停时，TSCTR运行到0后停止。
• 1x: 仿真暂停时，TSCTR继续自由运行（Free Run）。 在调试与时间严格相关的PWM生成或捕获逻辑时，如果不想让断点影响时基，应将其设置为Free Run模式。否则，在断点处暂停时间过长，可能会导致PWM输出异常或捕获事件丢失。

5.4 常见问题排查实录

在实际项目中，eCAP模块配置不当会导致各种奇怪现象。下面是我总结的一些常见问题及排查思路：

调试时，善用中断强制寄存器（ECFRC）和仿真模式是快速定位问题的好方法。你可以通过软件强制一个捕获事件或PWM周期事件，来测试中断响应逻辑是否正确。同时，在仿真器中实时观察TSCTR、CAPx等关键寄存器的变化，结合波形图，是理解eCAP工作流程最直观的��式。

eCAP模块的灵活性使其成为TI C2000系列DSP在数字电源、电机驱动等领域的王牌外设之一。从精确的脉冲测量到复杂的多相PWM生成，其设计几乎考虑了工业应用中的所有常见需求。掌握它，意味着你手里多了一把解决实时控制难题的利器。希望这篇结合了手册原理与实战经验的解析，能帮助你更自信地将eCAP模块应用到下一个项目中去。