深入解析C28x DSP eCAP模块：精准捕获与PWM生成实战指南

1. 项目概述与核心价值

在电机控制、电源管理和各类需要精确时序测量的嵌入式系统中，如何高效、准确地测量一个脉冲信号的周期和占空比，或者反过来，如何生成一个高精度的PWM波形，往往是工程师面临的核心挑战。如果单纯依赖CPU软件轮询或通用定时器中断，不仅会消耗大量宝贵的CPU资源，在高速信号面前精度也难以保证。这时，一个专为“捕获”与“比较”而生的硬件外设就显得至关重要。今天，我们就来深入聊聊德州仪器C28x系列DSP中一个极具代表性的模块——增强型捕获模块，也就是大家常说的eCAP模块。

简单来说，eCAP模块就像一位不知疲倦、且拥有“瞬间记忆”能力的计时员。它的核心工作有两面：一面是“捕获”（Capture），能在外部引脚发生特定事件（比如信号上升沿或下降沿）的瞬间，咔嚓一下“拍下”内部高精度计时器（TSCTR）的当前值，这个值就是“时间戳”；另一面是“比较”（Compare），或者说“APWM模式”，它能根据你设定的周期和比较值，自动在引脚上输出一个精准的PWM波形。这种硬件级的“一专多能”，使得我们可以在几乎不打扰CPU的情况下，完成高精度的信号测量与生成，这对于实时性要求极高的电机控制、数字电源、逆变器等领域来说，价值不言而喻。无论你是正在评估C2000平台的新手，还是希望优化现有设计中信号处理逻辑的老手，理解eCAP的运作机制和配置细节，都能让你的系统设计如虎添翼。

2. eCAP模块核心架构与工作模式解析

要玩转eCAP，首先得理解它的“五脏六腑”。eCAP模块的核心硬件资源可以概括为“一个定时器，四个捕获寄存器，一套灵活的控制逻辑”。

2.1 核心硬件资源拆解

时间戳计数器（TSCTR）：这是一个32位的自由运行向上计数器，是整个模块的“心跳”和计时基准。它的时钟源通常来自系统时钟（SYSCLKOUT）经过一个可编程预分频器（PRESCALE）。你可以把它想象成一个永不停止的精密秒表。

4级事件排序器（Mod4 Counter）与捕获寄存器（CAP1-CAP4）：这是eCAP模块的精妙设计所在。模块有4个独立的32位捕获寄存器（CAP1, CAP2, CAP3, CAP4），它们与一个2位的模4计数器（Mod4 Counter，状态为0,1,2,3循环）紧密耦合。当外部引脚（CAPx）发生一个有效的捕获事件（由边沿极性选择决定）时，硬件会自动执行两个动作：1. 将当前TSCTR的值锁存到当前Mod4计数器指向的捕获寄存器中（例如，Mod4=0时锁存到CAP1）；2. 然后将Mod4计数器加1，指向下一个捕获寄存器，为下一次捕获做好准备。这个过程是硬件自动完成的，速度极快，且与CPU异步。

事件控制寄存器（ECCTL1/2）：这是模块的“大脑”，所有行为都由它配置。关键配置项包括：

• CAPxPOL：为每个捕获事件（1-4）独立配置触发边沿，是上升沿（EC_RISING）还是下降沿（EC_FALLING）。
• CTRRSTx：决定每次捕获事件发生后，TSCTR是继续自由运行（EC_ABS_MODE，绝对时间模式），还是复位清零（EC_DELTA_MODE，差值模式）。这是区分两种核心工作模式的关键。
• CAP_APWM：模式选择位，置0为捕获模式（CAP Mode），置1为APWM模式。
• CONT_ONESHT：选择连续捕获（EC_CONTINUOUS，Mod4计数器在3之后回到0，循环覆盖）还是单次捕获（EC_ONESHOT，捕获4个事件后停止）。

2.2 两种核心捕获模式：绝对时间与差值时间

输入信号的时间信息，eCAP提供了两种“记录方式”，理解它们的区别是应用的基础。

绝对时间戳模式（CTRRSTx = EC_ABS_MODE）：在此模式下，TSCTR像一个自由奔跑的马拉松计时器，永不复位。每次捕获事件发生时，只是将TSCTR的当前“绝对时间”值拍照保存到对应的CAPx寄存器。要计算两个事件之间的时间间隔（比如周期），需要软件在读取两个CAP寄存器的值后做减法。例如，Period = CAP2 - CAP1。这种模式的优势是时间基准连续，可以记录很长序列中每个事件的绝对发生时刻。但缺点是需要CPU进行减法运算，且当TSCTR计满回绕（从0xFFFFFFFF到0x00000000）时，软件处理减法需要特别小心溢出问题。

差值（Delta）时间模式（CTRRSTx = EC_DELTA_MODE）：在此模式下，TSCTR更像一个“单圈计时器”。每次有效的捕获事件发生后，硬件在将TSCTR当前值锁存到CAPx寄存器后，会立即将TSCTR复位为0，然后重新开始计数。因此，CAPx寄存器中直接保存的就是从上一次捕获事件到本次事件之间的时间间隔（差值）。例如，在连续上升沿触发下，CAP1中存储的就是第一个周期的时间长度，CAP2中就是第二个周期的时间长度，依此类推。这种模式的巨大优势是“开箱即用”，CPU读取的CAP值直接就是时间间隔，无需再做减法，简化了软件计算，也天然避免了计数器溢出带来的计算复杂度。它非常适合周期性的、连续的时间间隔测量。

模式选择心得：在实际项目中，如果你的目标是测量一个稳定PWM信号的周期和占空比，并且希望软件处理越简单越好，差值模式通常是首选。它直接输出“间隔时间”，代码直观，计算量小。而绝对时间模式更适合需要分析事件时间序列、或事件间隔可能长到需要关注计数器溢出的复杂场景，它提供了更原始的时间数据，但将处理复杂度转移给了软件。

3. 捕获模式实战：测量PWM周期与占空比

理论清晰后，我们进入实战环节。假设我们需要测量一个输入到CAP引脚的PWM信号，目标是得到其周期和占空比。我们将分别用绝对时间模式和差值时间模式来实现，并分析代码细节。

3.1 场景一：绝对时间戳模式下的PWM测量

我们的目标是测量一个未知PWM信号的周期和占空比。配置思路是：利用eCAP的4个捕获寄存器，交替捕获上升沿和下降沿的时间戳。

硬件连接与配置思路： 将待测PWM信号连接到DSP的eCAP模块输入引脚（例如CAP1）。我们需要配置CAP1捕获第一个上升沿，CAP2捕获紧随其后的下降沿，CAP3捕获下一个上升沿，CAP4捕获再下一个下降沿。这样，一个完整的“上升-下降-上升-下降”序列，恰好填满4个寄存器。

关键配置代码解析：

// 初始化阶段配置 eCAP1 模块 // 注意：以下寄存器位域操作基于TI的C28x头文件风格 ECap1Regs.ECCTL1.bit.CAP1POL = EC_RISING; // 事件1：上升沿触发 ECap1Regs.ECCTL1.bit.CAP2POL = EC_FALLING; // 事件2：下降沿触发 ECap1Regs.ECCTL1.bit.CAP3POL = EC_RISING; // 事件3：上升沿触发 ECap1Regs.ECCTL1.bit.CAP4POL = EC_FALLING; // 事件4：下降沿触发 // 所有事件均采用绝对时间戳模式 ECap1Regs.ECCTL1.bit.CTRRST1 = EC_ABS_MODE; ECap1Regs.ECCTL1.bit.CTRRST2 = EC_ABS_MODE; ECap1Regs.ECCTL1.bit.CTRRST3 = EC_ABS_MODE; ECap1Regs.ECCTL1.bit.CTRRST4 = EC_ABS_MODE; ECap1Regs.ECCTL1.bit.CAPLDEN = EC_ENABLE; // 使能捕获寄存器加载 ECap1Regs.ECCTL1.bit.PRESCALE = EC_DIV1; // 预分频设为1，TSCTR以系统时钟频率运行 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计数器

中断���务程序（ISR）中的数据处理： 我们通常将第4个捕获事件（CEVT4）配置为中断源。当CAP4寄存器被写入后，意味着一个完整的测量序列（上升、下降、上升、下降）已经完成，四个时间戳都已就绪。

// 在CEVT4中断服务程序中 uint32_t tRise1, tFall1, tRise2, tFall2; uint32_t period, highTime, dutyCycle; // 读取四个捕获寄存器中的绝对时间戳 tRise1 = ECap1Regs.CAP1; // 第一次上升沿时刻 tFall1 = ECap1Regs.CAP2; // 第一次下降沿时刻 tRise2 = ECap1Regs.CAP3; // 第二次上升沿时刻 tFall2 = ECap1Regs.CAP4; // 第二次下降沿时刻 // 计算第一个完整周期的参数 period = tRise2 - tRise1; // 周期 = 相邻上升沿的时间差 highTime = tFall1 - tRise1; // 高电平时间 = 上升沿到下降沿的时间差 // 计算占空比 (百分比)。注意：需根据TSCTR时钟频率转换为时间单位 dutyCycle = (highTime * 100) / period; // 也可以计算第二个周期 // period2 = tFall2 - tFall1; // 注意：这是下降沿到下降沿的周期，与上升沿周期在理想情况下相等

重要提示：处理计数器溢出：在绝对时间模式下，TSCTR是一个32位自由运行计数器，它会从0xFFFFFFFF溢出到0x00000000。上面的减法tRise2 - tRise1在C语言中直接计算时，如果tRise2因为溢出而小于tRise1，会得到一个巨大的错误数值。可靠的软件必须处理溢出。一种常见方法是使用uint32_t类型做减法，因为无符号整数的溢出定义是模运算，结果在数学上是正确的（前提是两次捕获的时间差小于2^32个计数周期）。更严谨的做法是检查CTROVF（计数器溢出）标志，并在计算时考虑溢出次数。对于大多数应用，只要保证在TSCTR溢出前完成一次完整的测量（即period远小于2^32个计数），直接使用无符号减法是最简单有效的。

3.2 场景二：差值时间模式下的PWM测量

差值模式让事情变得更简单。我们采用同样的边沿交替触发策略。

配置代码调整： 与绝对时间模式相比，唯一的区别在于CTRRSTx位的配置。

// 仅列出与绝对模式不同的配置行，其他配置相同 ECap1Regs.ECCTL1.bit.CTRRST1 = EC_DELTA_MODE; // 事件1后复位TSCTR ECap1Regs.ECCTL1.bit.CTRRST2 = EC_DELTA_MODE; // 事件2后复位TSCTR ECap1Regs.ECCTL1.bit.CTRRST3 = EC_DELTA_MODE; // 事件3后复位TSCTR ECap1Regs.ECCTL1.bit.CTRRST4 = EC_DELTA_MODE; // 事件4后复位TSCTR // ... 其余配置与3.1节相同

中断服务程序（ISR）中的数据处理： 此时，CAP寄存器中存储的已经是时间间隔，而非绝对时刻。读取和计算逻辑有显著变化。

// 在CEVT4中断服务程序中（也可用CEVT1，见下文分析） uint32_t highTime1, lowTime1, highTime2, period1, period2; // 读取捕获寄存器。注意：此时CAP1存储的是从“事件4”到“事件1”的时间差吗？不！ // 在差值模式下，CAP1存储的是事件1发生时，TSCTR的值（事件1前一次复位到事件1的时间）。 // 但事件1发生时TSCTR刚从何处复位？这取决于上一个周期的最后一个事件（事件4）。 // 更清晰的解读是：在一个连续的“上升(F1)-下降(F2)-上升(F3)-下降(F4)”序列中： // CAP1 (事件1，上升沿): 存储的是上一个下降沿(F4)到本上升沿(F1)的时间，即低电平时间(T_low)。 // CAP2 (事件2，下降沿): 存储的是本上升沿(F1)到本下降沿(F2)的时间，即高电平时间(T_high1)。 // CAP3 (事件3，上升沿): 存储的是本下降沿(F2)到下一个上升沿(F3)的时间，即低电平时间(T_low2)。 // CAP4 (事件4，下降沿): 存储的是上升沿(F3)到下降沿(F4)的时间，即高电平时间(T_high2)。 // 因此，为了计算第一个完整周期（F1到F3）： highTime1 = ECap1Regs.CAP2; // T_high1 lowTime1 = ECap1Regs.CAP3; // T_low2 (注意：CAP3对应的是F2到F3的时间，即第一个周期后的低电平时间) period1 = highTime1 + lowTime1; // 周期 = 高电平时间 + 低电平时间 dutyCycle1 = (highTime1 * 100) / period1; // 计算第二个周期（F2到F4）： highTime2 = ECap1Regs.CAP4; // T_high2 lowTime2 = ECap1Regs.CAP1; // T_low1 (注意：下一个循环中，CAP1会被覆盖为F4到F5的时间) // 但注意！在连续模式下，当CEVT4中断发生时，CAP1已经被新值覆盖（即F4到下一个F1的时间）。 // 因此，为了正确计算第二个周期，应该在CEVT1中断（或CEVT2）中读取数据，或者采用单次模式。 // 更安全的做法：在连续模式下，利用CEVT1中断，此时CAP1-CAP4正好包含一个完整周期的四个边沿间隔。 // 配置CEVT1为中断源，则在CEVT1 ISR中： // highTime = ECap1Regs.CAP2; // F1->F2 // lowTime = ECap1Regs.CAP3; // F2->F3 // period = highTime + lowTime; // F1->F3

模式与中断选择技巧：从上面的分析可以看出，在差值模式下，中断触发事件的选择与数据解读逻辑强相关。对于测量周期和占空比，一个更清晰、更常用的配置是：仅捕获上升沿（或仅下降沿），并利用差值模式。这样，每个CAP寄存器直接存储的就是一个完整的周期时间。占空比测量则需要同时捕获上升和下降沿。我个人的经验是，对于单纯的频率/周期测量，使用差值模式+单边沿触发+CEVT4中断，读取的CAP1-CAP4就是连续的四个周期值，简单直接。对于需要占空比的场景，使用绝对时间模式逻辑更清晰，或者使用差值模式但要非常小心地设计中断服务例程的数据读取顺序。

4. APWM模式：将eCAP变为PWM发生器

eCAP模块的另一面是APWM（增强型PWM）模式。在此模式下，它不再捕获外部信号，而是利用其内部的比较逻辑，在同一个引脚上输出PWM波形。这对于需要额外PWM通道，或者需要与捕获功能分时复用的场景非常有用。

4.1 APWM模式工作原理

在APWM模式下，eCAP模块的核心资源被重新定义：

• TSCTR：变为一个递增计数的PWM时基计数器。
• CAP1寄存器：变为周期寄存器（APRD）。当TSCTR的值等于CAP1时，TSCTR在下一个时钟复位为0，并开始新的周期。
• CAP2寄存器：变为比较寄存器（ACMP）。当TSCTR的值小于CAP2时，输出引脚为有效电平（由极性位APWMPOL决定）；当TSCTR的值大于等于CAP2时，输出引脚为无效电平。
• CAP3/CAP4寄存器：在此基本模式下未使用。

输出极性：通过ECCTL2.APWMPOL位控制。EC_ACTV_HI表示高电平有效（TSCTR<ACMP时输出高）；EC_ACTV_LO表示低电平有效（TSCTR<ACMP时输出低）。

4.2 APWM模式配置与动态更新示例

假设我们需要在APWMx引脚上输出一个频率固定、占空比可调的PWM波。

初始化配置：

// 初始化 eCAP1 为 APWM 模式 ECap1Regs.CAP1 = 0x1000; // 设置周期值 (APRD)。假设系统时钟为100MHz，则PWM频率 = 100MHz / 0x1000 ≈ 15.26kHz ECap1Regs.CTRPHS = 0x0; // 相位寄存器清零，通常不使用相位控制时设为0 ECap1Regs.ECCTL2.bit.CAP_APWM = EC_APWM_MODE; // 切换到APWM模式 ECap1Regs.ECCTL2.bit.APWMPOL = EC_ACTV_HI; // 设置为高电平有效 ECap1Regs.ECCTL2.bit.SYNCI_EN = EC_DISABLE; // 禁用同步输入 ECap1Regs.ECCTL2.bit.SYNCO_SEL = EC_SYNCO_DIS; // 禁用同步输出 ECap1Regs.ECCTL2.bit.TSCTRSTOP = EC_RUN; // 启动时基计数器TSCTR // 初始占空比设置 ECap1Regs.CAP2 = 0x0300; // 设置比较值 (ACMP)，占空比 = 0x0300 / 0x1000 = 18.75%

运行时动态更新占空比： 在电机控制或数字电源中，经常需要实时调整PWM占空比。eCAP的APWM模式通常采用“影子寄存器”机制来避免在PWM周���中间更新比较值导致毛刺。但请注意，在基本的APWM模式下，CAP2（ACMP）是直接作用的活跃寄存器。为了安全地更新，一个常见的做法是在PWM周期开始时（例如，在计数器归零的中断里）更新它。然而，C28x eCAP模块的APWM模式设计更简单，CAP2寄存器没有影子寄存器。直接写入会立即生效。

// 在某个中断或主循环中，需要改变占空比 // 方法1：直接写入（可能产生毛刺，但若在合适时机写入可接受） ECap1Regs.CAP2 = 0x0800; // 新的比较值，占空比变为 50% // 方法2：更安全的做法（如果支持）。但标准eCAP APWM模式不直接支持。 // 通常，更复杂的PWM生成会使用专用的ePWM模块，它具备完整的影子寄存器、死区控制等功能。 // eCAP的APWM模式更适合对更新时机要求不苛刻的辅助PWM通道。

APWM模式使用心得：eCAP的APWM模式是一个轻量级的PWM发生器。它的优势是配置简单，且能与捕获功能复用引脚。但其功能比专用的ePWM模块要弱，缺乏影子寄存器、死区生成、故障保护等高级功能。因此，我的建议是：将eCAP的APWM模式用于那些不需要与其他PWM严格同步、且对开关精度要求不高的辅助性控制信号输出，例如风扇调速、指示灯亮度调节等。对于主功率桥的驱动，强烈建议使用功能更强大的ePWM模块。

5. 高级应用与常见问题排查

掌握了基本模式后，我们探讨一些高级配置和实际开发中必然会踩到的“坑”。

5.1 预分频器（PRESCALE）的配置与计算

TSCTR的时钟频率直接决定了时间测量的分辨率。PRESCALE位可以对输入的系统时钟进行分频。

ECap1Regs.ECCTL1.bit.PRESCALE = EC_DIV2; // 2分频

• 分辨率计算：如果系统时钟SYSCLKOUT = 100 MHz，预分频设为EC_DIV1，则TSCTR每个计数代表10ns。如果测量到的时间差为N个计数，则实际时间T = N * 10 ns。
• 量程计算：32位TSCTR的最大计数值为2^32 - 1 = 4,294,967,295。在100MHz时钟下，最大可测量时间间隔（不发生溢出）约为42.95秒（4.295e9 * 10ns）。如果预分频加大，分辨率降低，但量程会等比例增加。
• 配置建议：根据待测信号的频率范围来选择合适的预分频。测量高频信号时，需要高分辨率（小分频甚至不分频）；测量低频或长周期信号时，需要更长的量程（大分频），但要确保分辨率仍能满足精度要求。

5.2 同步输入与输出（SYNCI & SYNCO）

eCAP模块支持与其他eCAP或ePWM模块同步，这在多模块协同工作的系统中非常重要。

• SYNCI（同步输入）：可以使能外部同步信号来复位本模块的TSCTR和Mod4计数器，实现多个eCAP模块的计时起点对齐。
• SYNCO（同步输出）：可以将本模块的内部事件（如CEVT1-4，或CTR=PRD）作为同步信号输出，用于同步其他模块。
• 典型应用：在多相电机控制中，可能需要多个eCAP模块同时开始捕获，或者让一个eCAP模块的捕获事件去触发另一个ePWM模块的动作。这时就需要配置同步链。

5.3 常见问题排查实录

在实际调试中，eCAP模块不出数据或者数据异常是常有的事。下面是我总结的一些排查步骤和要点：

问题1：捕获不到任何数据，CAP寄存器始终为0。

• 检查引脚复用：首先确认GPIO引脚是否已正确配置为eCAP功能。例如，对于CAP1，需要设置对应的GPxMUX寄存器位。
• 检查输入信号：用示波器确认信号是否确实到达了DSP引脚，电平是否符合要求（通常是3.3V CMOS电平）。
• 检查边沿极性配置：CAPxPOL是否设置正确？如果你配置为上升沿捕获，但输入信号是下降沿，当然抓不到。
• 检查TSCTR是否运行：确认ECCTL2.TSCTRSTOP位已设置为EC_RUN。
• 检查捕获使能：确认ECCTL1.CAPLDEN位已设置为EC_ENABLE。
• 检查Mod4计数器状态：通过读取ECCTL2.CAPLDEN和ECCTL2.MOD4CNT（如果寄存器支持）或通过中断标志，可以判断事件是否被识别。

问题2：捕获到的数据跳动很大，不准确。

• 检查信号质量：输入信号是否有毛刺？过长的引线可能引入噪声，导致多次误触发。考虑在硬件上增加RC滤波或在软件上启用输入限定器（Input Qualifier），但注意限定器会引入延迟。
• 检查时钟稳定性：系统时钟是否稳定？是否使用了PLL且已锁定？
• 检查中断响应时间：如果你在中断中读取数据，确保中断服务程序的执行时间足够短，不会错过后续的捕获事件。在高速信号下，可以考虑使用DMA将CAP寄存器的值直接搬运到内存中。

问题3：在绝对时间模式下，计算出的周期为负数或极大值。

• 这是典型的计数器溢出处理错误。如前所述，必须使用无符号整数进行减法运算，并确保测量间隔远小于TSCTR的溢出周期。如果需要处理溢出，可以启用CTROVF（计数器溢出）中断，并在一个全局变量中记录溢出次数。计算时间差时：delta = (current_stamp + overflow_count * (2^32)) - previous_stamp。

问题4：APWM模式没有输出或输出频率不对。

• 检查模式位：确认ECCTL2.CAP_APWM已设置为EC_APWM_MODE。
• 检查引脚方向：APWM模式需要引脚配置为输出。虽然切换到APWM模式后模块可能会自动控制方向，但最好在GPIO初始化时确认。
• 计算周期值：PWM频率 = TSCTR时钟频率 / (CAP1 + 1)。例如，TSCTR时钟为100MHz，要产生10kHz的PWM，CAP1应设置为(100e6 / 10e3) - 1 = 9999。
• 检查比较值范围：确保CAP2（比较值）小于等于CAP1（周期值）。如果CAP2 > CAP1，则占空比将为100%（高电平有效时）。

问题5：在连续捕获模式下，数据似乎“错位”了。

• 这是对Mod4计数器循环和中断触发点理解不透导致的。牢记：在连续模式下，4个捕获寄存器像一个环状缓冲区，新数据会不断覆盖旧数据。你的中断服务程序必须在正确的事件（CEVT1/2/3/4）触发时，读取正确的寄存器组合。画一个状态迁移图，明确每个事件发生后，哪个寄存器被更新，以及此时哪些寄存器里的数据是构成一个完整测量周期所必需的。对于差值模式测量占空比，如3.2节所述，选择CEVT1或CEVT3作为中断源，逻辑通常会更清晰。

通过系统地检查以上环节，大部分eCAP相关的问题都能得到定位和解决。最关键的是，要结合示波器观察实际信号，并结合读取模块的状态寄存器（如QEPSTS，在eCAP中部分状态位类似）来动态分析模块的工作状态。