首页/资讯中心/详情

TI C2000 eCAP模块深度解析：从捕获到PWM生成的实战指南

TI C2000 eCAP模块深度解析：从捕获到PWM生成的实战指南
📅 发布时间：2026/7/23 20:22:19

1. eCAP模块核心设计思路与工作模式解析

在嵌入式实时控制领域，无论是测量电机编码器的脉冲频率，还是生成驱动功率管的PWM信号，其底层都离不开一个精准且灵活的定时器单元。德州仪器（TI）C2000系列微控制器中的增强型捕获（eCAP）模块，正是为此类高要求场景而设计的瑞士军刀。它不是简单的计数器，而是一个集成了时间戳捕获、差值计算和PWM生成能力的多功能外设。很多工程师初次接触数据手册里密密麻麻的寄存器位描述时，容易感到无从下手，其实只要抓住其核心设计逻辑——“事件驱动的时间记录仪”——一切就会清晰起来。

你可以把eCAP模块想象成一个拥有四个记事本（CAP1-CAP4寄存器）的精密秒表。这个秒表（TSCTR计数器）一直在后台匀速走动。当你在外部引脚（ECAPx）上设置了一个“关注的事件”（比如信号的上升沿），这个事件一旦发生，就会触发两个动作：第一，秒表当前的精确时刻被瞬间抄写到当前活跃的记事本上；第二，管理记事本顺序的指针（MOD4计数器）会指向下一个空白记事本。通过灵活配置，你可以让秒表在每次记录后是否清零，从而直接得到两次事件之间的时间间隔，这就是“差值模式”（Delta Mode）的精髓，它省去了软件做减法的开销，对于高频信号测量至关重要。

eCAP主要工作在两种模式下：捕获模式（CAP）和辅助PWM模式（APWM）。在捕获模式下，它是个优秀的“观察者”，专注于记录外部世界的变化；而在APWM模式下，它则变身为一个“创造者”，利用其内部的比较器机制，稳定地输出PWM波形。模式的选择完全由ECCTL2寄存器中的CAP/APWM位决定，这是一个根本性的岔路口，决定了后续所有寄存器的配置意义。

注意：在开始配置任何eCAP模块之前，务必遵循TI手册中强调的“上电初始化黄金步骤”。这个步骤的核心思想是在模块静止且中断关闭的安全环境下进行配置，防止在配置过程中因计数器运行或意外中断导致寄存器处于不确定状态。具体顺序为：1) 关闭CPU全局中断；2) 停止eCAP计数器（TSCTRSTOP=0）；3) 禁用eCAP所有中断源；4) 配置所有控制寄存器；5) 清除可能存在的虚假中断标志；6) 使能所需eCAP中断；7) 启动计数器；8) 最后才打开CPU全局中断。这个习惯能避免很多难以复现的随机故障。

2. 关键寄存器深度配置与实战要点

理解了宏观框架，我们接下来就要深入到实现这些功能的“控制中枢”——寄存器。数据手册提供了所有信息，但如何将它们组合成有效的配置，才是工程师价值的体现。我们重点剖析几个最核心的寄存器。

2.1 ECCTL1：事件控制与滤波的基石

ECCTL1寄存器是定义“捕获什么”以及“如何捕获”的核心。其位域可以分为三大功能组：仿真控制、事件预分频、以及针对四个捕获事件的具体行为设置。

  • FREE/SOFT (位 15-14)：这对位用于仿真调试。当你在CCS中设置断点暂停CPU时，这个计数器是跟着立刻停止（FREE=0），还是完成当前计数周期再停止（SOFT=1），或是完全不受影响继续运行（FREE=1）。在大多数实际运行中，我们设置为11b（Run Free），确保即使调试时暂停CPU，定时器的时基也不受影响，这对于依赖精确时序的PWM生成尤其重要。
  • PRESCALE (位 13-9)：事件预分频器。这不是对内部时基时钟分频，而是对输入信号进行滤波。例如，设置PRESCALE = 4（除以8），意味着输入引脚上的一个边沿事件，需要被连续采样到8次，eCAP模块才认为这是一个“有效事件”并触发捕获。这能有效消除毛刺干扰。对于缓慢变化的信号（如机械开关），可以设置较高的分频；对于高速数字信号（如编码器输出），通常设置为0（旁路，不分频）。
  • CAPLDEN (位 8)：捕获加载使能。这是很容易被忽略但至关重要的位。必须将其置1，捕获事件发生时，时间戳才会被加载到CAP1-CAP4寄存器中。如果忘记使能，你会发现即使中断触发了，CAP寄存器里的值也永远是0或者旧值。
  • CTRRSTx 与 CAPxPOL (位 7-0)：这8位是每事件对的配置核心，每2位控制一个捕获事件（1-4）。
    • CAPxPOL：定义触发捕获的边沿。0 = 上升沿，1 = 下降沿。
    • CTRRSTx：定义计数器复位模式。0 = 绝对时间模式（捕获后计数器继续累加），1 = 差值模式（捕获后计数器复位归零）。

这里有一个关键技巧：CTRRSTx的配置决定了你测量的是“时刻”还是“间隔”。在绝对时间模式下，你需要用后一个CAP值减去前一个CAP值才能得到周期（例如Period = CAP2 - CAP1）。在差值模式下，CAP寄存器里存储的值本身就是从上一次复位到本次捕获的时间间隔，直接读取就是周期或脉宽，节省了CPU的减法操作，也避免了32位计数值回绕（overflow）带来的计算复杂性。

2.2 ECFLG、ECEINT与ECCLR：中断系统的协同作战

eCAP的中断管理由三个寄存器精密配合完成，理解它们的关系是写出稳定中断服务程序（ISR）的关键。

  • ECFLG (标志寄存器)：这是一个状态寄存器，只读。当某个事件（如CEVT1, CTR_PRD, CTROVF）发生时，硬件会自动将对应的标志位置1。它像是一个报警灯，亮起表示有事情发生。
  • ECEINT (中断使能寄存器)：这是一个控制寄存器，可读写。你可以通过它来选择哪些事件能“点亮报警灯”后，进一步“拉响警报”（产生CPU中断）。例如，如果你只关心第四个捕获事件，那么只需将CEVT4位置1，其他位保持为0。这样，即使CEVT1事件发生了，ECFLG.CEVT1会置位，但因为未使能中断，不会触发CPU中断。
  • ECCLR (标志清除寄存器)：这是一个只写寄存器，用于软件清除ECFLG中的标志位。在中断服务程序中，必须在处理完事件后，手动向ECCLR中对应的位写1来清除标志，否则退出中断后，该标志位依然为1，会立即再次触发中断，导致CPU陷入无限中断循环。

它们三者的工作流程如下：

  1. 硬件检测到事件（如捕获边沿） ->ECFLG.xxx置位。
  2. 如果ECEINT.xxx已使能，则向CPU发出中断请求。
  3. CPU跳转到ISR。
  4. ISR内，通过读取ECFLG或直接根据设计判断事件来源。
  5. 执行数据处理（如读取CAP寄存器）。
  6. 向ECCLR.xxx写1，清除ECFLG.xxx标志位。
  7. 退出ISR。

实操心得：在中断服务程序中，清除标志位ECCLR的操作应放在所有数据处理完成之后、退出中断之前。一个常见的错误是在ISR开头就清除标志，如果此时发生更高优先级中断或处理时间过长，可能会丢失紧接着发生的下一个事件。此外，ECFRC（强制中断寄存器）可用于软件测试，手动置位某个标志，模拟硬件事件，非常利于在不连接外部信号的情况下调试中断逻辑。

2.3 APWM模式下的关键寄存器重映射

当ECCTL2.CAP/APWM = 1，模块进入APWM模式。此时，部分寄存器的功能会发生根本性变化，千万不要再用捕获模式的思维去理解它们。

  • CAP1 & CAP2 寄存器角色转变：
    • CAP1寄存器变为周期寄存器 (APRD)：它定义了PWM波的周期值。TSCTR计数器从0向上计数，达到CAP1的值后归零，开始下一个周期。
    • CAP2寄存器变为比���寄存器 (ACMP)：它定义了PWM输出电平翻转的比较点。当TSCTR计数器的值小于CAP2时，输出一种电平（由极性位决定）；大于或等于CAP2时，输出相反电平。
  • ECCTL2.APWMPOL位：此位控制PWM输出极性。0表示高电平有效（Active High），即计数值小于ACMP时输出高电平；1表示低电平有效（Active Low）。这个配置会影响你计算占空比的方式。
  • ECFLG寄存器标志变化：在APWM模式下，CTR_PRD（计数器等于周期值）和CTR_CMP（计数器等于比较值）这两个标志变得有用，可以用于在周期点或比较点触发中断，实现更复杂的同步或保护逻辑。

3. 四大应用场景的配置流程与代码实现

理论最终要服务于实践。下面我们结合具体场景，从寄存器配置到代码片段，一步步拆解eCAP的典型用法。假设我们使用TI C2000 Piccolo系列MCU，并已正确初始化系统时钟和外设时钟。

3.1 场景一：绝对时间戳模式测量信号周期（仅上升沿）

这是最基础的捕获应用，用于测量一个未知数字信号的周期。我们让eCAP工作在连续捕获模式，在每个上升沿记录下TSCTR的绝对计数值。

配置思路：

  1. 模式选择：ECCTL2.CAP/APWM = 0，进入捕获模式。
  2. 事件定义：四个捕获事件均设置为上升沿触发，且不重置计数器（CTRRSTx=0）。这样CAP1-4将依次记录四个连续上升沿的绝对时间。
  3. 运行控制：设置为连续运行（CONT/ONESHT=0），Mod4计数器在4次捕获后自动归零并覆盖旧值。
  4. 中断策略：通常在第4次捕获事件（CEVT4）触发中断，此时四个CAP寄存器都已更新，可以一次性读出并计算三个完整的周期。

代码实现与分析：

// 初始化函数片段 void ECAP1_AbsoluteTime_Init(void) { // 步骤1: 安全配置前准备（遵循黄金步骤） EALLOW; // 解除寄存器保护 SysCtrlRegs.PCLKCR0.bit.ECAP1ENCLK = 1; // 使能eCAP1模块时钟 EDIS; DINT; // 禁用全局中断 ECap1Regs.ECCTL2.bit.TSCTRSTOP = 0; // 停止计数器 // 步骤2: 配置ECCTL1 - 定义捕获行为 ECap1Regs.ECCTL1.bit.CAP1POL = 0; // 事件1: 上升沿 ECap1Regs.ECCTL1.bit.CAP2POL = 0; // 事件2: 上升沿 ECap1Regs.ECCTL1.bit.CAP3POL = 0; // 事件3: 上升沿 ECap1Regs.ECCTL1.bit.CAP4POL = 0; // 事件4: 上升沿 ECap1Regs.ECCTL1.bit.CTRRST1 = 0; // 绝对时间模式 ECap1Regs.ECCTL1.bit.CTRRST2 = 0; ECap1Regs.ECCTL1.bit.CTRRST3 = 0; ECap1Regs.ECCTL1.bit.CTRRST4 = 0; ECap1Regs.ECCTL1.bit.PRESCALE = 0; // 预分频设为1（无滤波） ECap1Regs.ECCTL1.bit.CAPLDEN = 1; // **关键！** 使能捕获加载 // 步骤3: 配置ECCTL2 - 选择模式和运行方式 ECap1Regs.ECCTL2.bit.CAP_APWM = 0; // 捕获模式 ECap1Regs.ECCTL2.bit.CONT_ONESHT = 0; // 连续运行 ECap1Regs.ECCTL2.bit.SYNCI_EN = 0; // 禁用同步输入 ECap1Regs.ECCTL2.bit.SYNCO_SEL = 2; // 同步输出禁用 // 步骤4: 配置中断 ECap1Regs.ECEINT.bit.CEVT4 = 1; // 仅使能第4事件中断 ECap1Regs.ECCLR.all = 0xFFFF; // 清除所有可能存在的旧标志 // 步骤5: 启动计数器并连接中断 ECap1Regs.ECCTL2.bit.TSCTRSTOP = 1; // 启动TSCTR计数器 IER |= M_INT5; // 使能CPU级eCAP1中断（假设eCAP1对应INT5） EINT; // 使能全局中断 } // 中断服务程序 ISR __interrupt void ECAP1_ISR(void) { volatile unsigned long t1, t2, t3, t4, period1, period2, period3; // 判断中断源是否为CEVT4 if (ECap1Regs.ECFLG.bit.CEVT4 == 1) { // 读取四个时间戳 t1 = ECap1Regs.CAP1; t2 = ECap1Regs.CAP2; t3 = ECap1Regs.CAP3; t4 = ECap1Regs.CAP4; // 计算周期（注意32位减法，考虑回绕） period1 = t2 - t1; period2 = t3 - t2; period3 = t4 - t3; // 此处可以将period1/2/3用于频率计算或控制算法 // 例如：频率 = 系统时钟频率 / period1 // **必须清除中断标志！** ECap1Regs.ECCLR.bit.CEVT4 = 1; } // 清除PIE组应答位，必不可少 PieCtrlRegs.PIEACK.all = PIEACK_GROUP5; }

计算示例：假设系统时钟SYSCLKOUT为100MHz，TSCTR计数器也以此频率运行。如果测量得到的period1值为50000，则对应的信号周期T = 50000 * (1/100MHz) = 0.5ms，频率f = 1/T = 2kHz。

3.2 场景二：绝对时间戳模式测量PWM占空比（上升沿与下降沿交替）

要测量PWM信号的占空比，需要同时捕获上升沿和下降沿。我们配置eCAP交替响应两种边沿。

配置思路：

  1. 边沿交替：设置CAP1为上升沿，CAP2为下降沿，CAP3为上升沿，CAP4为下降沿，如此循环。
  2. 模式与中断：仍使用绝对时间模式，在CEVT4中断时，CAP1-4分别对应一个周期内的上升沿、下降沿、下一个上升沿、下一个下降沿的时间戳。
  3. 数据处理：通过(t2-t1)得到一个高电平时间，(t3-t1)得到一个完整周期，从而计算占空比。

关键配置代码片段：

// ECCTL1 配置部分 ECap1Regs.ECCTL1.bit.CAP1POL = 0; // 事件1: 上升沿 ECap1Regs.ECCTL1.bit.CAP2POL = 1; // 事件2: 下降沿 ECap1Regs.ECCTL1.bit.CAP3POL = 0; // 事件3: 上升沿 ECap1Regs.ECCTL1.bit.CAP4POL = 1; // 事件4: 下降沿 // CTRRSTx 全部设为0，绝对时间模式

中断服务程序中的计算：

t1 = ECap1Regs.CAP1; // 周期起始上升沿 t2 = ECap1Regs.CAP2; // 第一个下降沿 t3 = ECap1Regs.CAP3; // 下一个上升沿 t4 = ECap1Regs.CAP4; // 下一个下降沿 period = t3 - t1; // 一个完整周期 high_time = t2 - t1; // 高电平时间 duty_cycle = (float)high_time / (float)period * 100.0f; // 占空比百分比

注意事项：这种方法要求信号是稳定的PWM波。如果占空比变化，从t1到t4这组数据可能不严格属于同一个周期（例如t1和t2是一个周期，t3和t4是下一个周期）。对于动态变化的PWM，更可靠的方法是每次只使用t1和t2（一个边沿对）来计算当前脉宽，并利用连续捕获模式快速更新。

3.3 场景三：差值模式直接测量脉冲宽度

在差值模式下，计数器在每次捕获后自动清零，因此CAP寄存器中存储的值直接就是相邻两个事件之间的时间间隔。这非常适合测量固定频率信号的周期或固定占空比PWM的脉宽。

配置思路：

  1. 启用差值模式：将所有CTRRSTx位设置为1。
  2. 边沿设置：若只测周期，可全设为上升沿。若测高电平宽度，可设置CAP1为上升沿，CAP2为下降沿。
  3. 中断策略：由于每个CAP值本身就是一个完整的间隔，可以在任何一个事件（如CEVT1）触发中断并读取数据。例如，设置CAP1为上升沿，CAP2为下降沿，那么在CEVT2中断时读取CAP2，得到的就是高电平宽度。

配置与计算代码片段：

// ECCTL1 配置：差值模式，上升沿触发 ECap1Regs.ECCTL1.bit.CTRRST1 = 1; // 差值模式 ECap1Regs.ECCTL1.bit.CTRRST2 = 1; ECap1Regs.ECCTL1.bit.CTRRST3 = 1; ECap1Regs.ECCTL1.bit.CTRRST4 = 1; ECap1Regs.ECCTL1.bit.CAP1POL = 0; // 上升沿 // ... CAP2-4同样设为上升沿 // 中断服务程序中（例如CEVT1中断） pulse_width = ECap1Regs.CAP1; // CAP1中的值就是本次上升沿与上一次上升沿���间的时间差，即周期 // 无需做减法！

3.4 场景四：配置eCAP为APWM发生器

将eCAP用作一个简单的PWM发生器，是它另一项重要功能。在这个模式下，我们关心的是如何设置周期和占空比。

配置思路：

  1. 切换模式：将ECCTL2.CAP/APWM设为1。
  2. 配置极性：通过ECCTL2.APWMPOL选择PWM输出是高电平有效还是低电平有效。
  3. 写入周期与比较值：向CAP1（APRD）写入周期值，向CAP2（ACMP）写入比较值。在初始化时，需要直接写入这两个寄存器以激活影子寄存器。
  4. 运行控制：启动计数器，PWM波形即开始输出。

代码实现：

void ECAP1_APWM_Init(unsigned int period, unsigned int compare) { EALLOW; // 配置GPIO引脚为eCAP1功能（具体寄存器取决于型号，例如GPIO5） GpioCtrlRegs.GPAMUX2.bit.GPIO5 = 1; // 假设GPIO5是ECAP1功能 EDIS; DINT; ECap1Regs.ECCTL2.bit.TSCTRSTOP = 0; // 停止计数器 // 配置为APWM模式 ECap1Regs.ECCTL2.bit.CAP_APWM = 1; // APWM模式 ECap1Regs.ECCTL2.bit.APWMPOL = 0; // 高电平有效 ECap1Regs.ECCTL2.bit.SYNCI_EN = 0; // 不同步 ECap1Regs.ECCTL2.bit.SYNCO_SEL = 2; // 同步输出禁用 // **初始化时必须同时写入活动寄存器** ECap1Regs.CAP1 = period; // 设置PWM周期 ECap1Regs.CAP2 = compare; // 设置PWM比较值（决定占空比） ECap1Regs.CTRPHS = 0; // 相位寄存器清零 // 启动计数器 ECap1Regs.ECCTL2.bit.TSCTRSTOP = 1; EINT; } // 运行时动态修改占空比 void ECAP1_UpdateDutyCycle(unsigned int new_compare) { // 在APWM模式下，直接写入CAP2（影子寄存器）即可在下一个周期更新 ECap1Regs.CAP2 = new_compare; }

占空比计算：占空比 =(CAP2 / CAP1) * 100%。例如，CAP1=1000,CAP2=300，则占空比为30%。如果设置APWMPOL=1（低电平有效），则CAP2代表低电平时间，占空比计算为(1 - CAP2/CAP1) * 100%。

4. 调试常见问题与高级应用技巧

在实际项目中，配置eCAP时可能会遇到一些“坑”。这里分享一些排查经验和进阶用法。

4.1 常见问题速查与解决方案

问题现象可能原因排查步骤与解决方案
捕获不到任何数据，CAP寄存器始终为01.CAPLDEN位未使能。
2. 输入引脚GPIO复用功能未配置。
3. 输入信号电平不匹配（如3.3V MCU接收5V信号需电平转换）。
4. 预分频PRESCALE设置过大，信号被滤除。		1. 检查ECCTL1.CAPLDEN是否置1。
2. 检查对应GPIO的MUX寄存器是否配置为eCAP功能。
3. 用示波器检查引脚是否有信号，并确认电平。
4. 尝试将PRESCALE设为0（旁路）。
中断频繁触发，甚至陷入死循环中断标志ECFLG未在ISR中清除。在ISR末尾，确保向ECCLR寄存器的对应位写1。检查是否所有可能触发的中断源都已正确清除。
测量的周期或脉宽值不稳定、跳动大1. 输入信号有噪声毛刺。
2. 计数器时钟源不稳定或存在抖动。
3. 中断处理时间过长，丢失事件。		1. 增加PRESCALE值进行软件滤波。
2. 检查系统时钟源（如PLL）是否稳定。考虑使用eCAP的输入同步功能（SYNCI_EN）。
3. 优化ISR代码，只做必要的数据读取和标志清除，将复杂计算移至主循环。考虑使用DMA将CAP数据直接搬运到内存。
APWM模式无波形输出1. GPIO引脚未正确配置为输出功能。
2.CAP1（周期）寄存器值为0。
3. 计数器未启动（TSCTRSTOP=0）。		1. 确认GPIO配置为eCAP功能，且该引脚支持PWM输出。
2. 确保CAP1被写入一个大于0的有效值。
3. 检查ECCTL2.TSCTRSTOP是否为1。
在差值模式下，读取的CAP值异常大在两次捕获事件之间，TSCTR计数器发生了回绕（从0xFFFFFFFF到0x00000000），并且CTROVF事件未被处理。1. 检查输入信号频率是否过高，导致间隔时间超过计数器满量程时间。可以增加预分频或使用更高系统时钟。
2. 使能CTROVF中断，在中断中处理溢出情况，软件维护一个溢出计数器。

4.2 高级技巧与优化实践

  1. 利用Mod4计数器与循环缓冲：eCAP硬件自动管理CAP1-CAP4的循环写入。在连续捕获模式下，你可以配置只在CEVT4中断，然后在ISR中一次性读取四个寄存器。这相当于一个深度为4的硬件FIFO，降低了CPU中断频率，提高了数据吞吐效率。

  2. 同步与级联：对于多电机协同控制等需要多个PWM严格同步的场景，eCAP的同步输入/输出（SYNCI_EN和SYNCO_SEL）功能非常有用。可以将一个eCAP模块配置为主机，将其周期事件（CTR=PRD）通过SYNCO输出，连接到其他从机eCAP的SYNCI输入。这样，从机计数器可以在主机每个周期开始时同步复位，确保所有PWM同相位。

  3. 结合DMA减轻CPU负担：在高速连续捕获应用中（如高频信号分析），频繁的中断会消耗大量CPU资源。C2000的eCAP模块支持与DMA控制器联动。可以配置DMA，在特定的捕获事件（如CEVT4）发生时，自动将CAP1-CAP4四个寄存器的值搬运到指定的内存数组中。CPU只需在DMA完成一大块数据搬运后（通过DMA中断）进行批处理，极大提升了系统效率。

  4. APWM模式下的双边沿非对称波形：虽然标准APWM模式生成的是中心对齐或边沿对齐的PWM，但通过巧妙的中断和寄存器重载，可以实现更复杂的波形。例如，在CTR_CMP和CTR_PRD事件都触发中断，在中断中动态修改CAP2（ACMP）值，可以在一个周期内产生多次电平翻转，生成非对称或带有死区的复杂PWM，适用于某些特殊的电源拓扑控制。

  5. 时间戳的扩展与高分辨率：TSCTR是32位计数器，在100MHz时钟下，满量程约为42.9秒。对于更长时间的测量或需要更高分辨率的情况，可以结合CPU定时器或软件扩展。例如，使能CTROVF中断，在中断中递增一个软件扩展的64位高位计数器。最终的时间戳 =(overflow_count << 32) + TSCTR。这样可以实现几乎无限长度和更高精度的时间测量。