企业官网建设流程全解析

1. 项目概述与eCAP模块的核心价值

在嵌入式系统开发，尤其是工业控制、电机驱动和精密测量领域，我们常常需要和“时间”这个看不见摸不着的东西较劲。比如，你想知道一个旋转编码器输出的脉冲频率到底是多少，或者一个PWM信号的占空比具体是百分之几，甚至需要精确测量两个外部事件之间的时间间隔。这些任务听起来简单，但要做到高精度、低CPU开销，却需要硬件模块的强力支持。今天要聊的，就是德州仪器（TI）C2000系列微控制器里一个堪称“时间捕手”的利器——增强型捕获模块，也就是eCAP。

eCAP模块的设计初衷，就是为了把工程师从繁琐的软件计时和中断处理中解放出来。它不是一个简单的输入捕获，而是一个集成了32位高精度计数器、四组时间戳寄存器、灵活事件序列器以及完整中断系统的独立子系统。更妙的是，当你不拿它来“抓”信号的时候，它还能摇身一变，成为一个独立的、32位精度的PWM发生器（APWM模式）。这种“一专多能”的特性，在引脚资源紧张的微控制器世界里，无疑大大提升了外设的利用率和系统设计的灵活性。无论是测量电机的转速，解码传感器的脉宽信号，还是生成一个高分辨率的PWM波，eCAP都能胜任。接下来，我们就从它的硬件架构开始，一层层剥开这颗“洋葱”，看看它是如何实现从精准捕获到灵活PWM生成的全过程。

2. eCAP模块架构深度解析

要玩转eCAP，光知道寄存器地址是远远不够的，必须理解其内部的数据流和控制逻辑。整个模块可以看作一个精密的“时间流水线”，外部信号从引脚进入，经过一系列处理，最终变成我们需要的计数值或波形。

2.1 核心资源与数据通路

一个完整的eCAP通道，其核心资源构成了一个清晰的处理链条。首先是专用输入捕获引脚（ECAPx），这是信号的起点。信号进来后，首先经过一个可编程的事件预分频器，它可以将输入信号频率进行2到62（偶数倍）的分频，这对于处理高频信号、防止计数器溢出至关重要。分频后的信号，进入边沿极性选择和限定器。这里有四组独立的极性选择器（对应CAP1POL到CAP4POL），可以分别为四次捕获事件独立配置是检测上升沿还是下降沿。这个设计非常巧妙，使得单次捕获序列就能同时获取周期和占空比信息。

经过极性选择的边沿事件，由4状态序列器（模4计数器）进行调度。这个序列器是eCAP逻辑的核心协调者，它确保每个边沿事件（CEVT1到CEVT4）按顺序触发对应的捕获动作。序列器的工作模式（连续或单次）由CONT/ONESHT位控制。在连续模式下，序列器会循环运行（0->1->2->3->0），捕获寄存器CAP1到CAP4构成一个环形缓冲区，新数据会覆盖旧数据。在单次模式下，你可以通过STOP_WRAP位设置序列器在捕获1到4个事件后停止，从而冻结CAP1-CAP4寄存器中的数据，等待CPU读取。

当序列器判定某个事件有效时，它会生成一个加载信号（LD1-LD4），将当前32位时间基准计数器（TSCTR）的值锁存到对应的32位时间戳寄存器（CAP1-CAP4）中。这个TSCTR计数器由系统时钟驱动，是全部时间测量的基石。这里有一个关键选项：CTRRSTx位。如果将其配置为差值模式（Delta Mode），那么在每次捕获时间戳后，TSCTR会自动复位为零；如果配置为绝对模式（Absolute Mode），则TSCTR继续自由运行。差值模式的好处是，捕获寄存器里的值直接就是相邻两个事件的时间间隔，CPU无需做减法计算，减少了软件开销和误差。

注意：CAP1到CAP4这4个寄存器在捕获模式和APWM模式下的角色完全不同。在捕获模式下，它们就是纯粹的时间戳存储单元。在APWM模式下，CAP1和CAP2分别作为周期（APRD）和比较（ACMP）的活动寄存器，而CAP3和CAP4则作为它们的影子寄存器，用于实现PWM参数的无毛刺更新。这种硬件级的双缓冲机制，是生成稳定PWM波形的关键。

2.2 中断系统的协同机制

eCAP拥有一个灵活且完整的中断系统，这是实现高效、实时处理的关键。它支持多达7个中断事件源：四次捕获事件（CEVT1-CEVT4）、计数器溢出（CTROVF）、以及APWM模式下的周期匹配（CTR=PRD）和比较匹配（CTR=CMP）事件。

理解中断流程，需要厘清几个关键寄存器的作用。中断原始状态寄存器（ECFLG）就像一个“事件传感器”，只要硬件条件满足（比如发生了CEVT1），对应的标志位就会被置1，无论该中断是否被使能。而中断使能寄存器（ECEINT）则像是一个“开关”，控制哪些事件可以产生中断脉冲。只有当ECFLG中的某个事件标志位为1，并且在ECEINT中该事件被使能，同时全局中断标志位（ECFLG.INT）为0时，模块才会向CPU的PIE控制器发出一个中断脉冲。

这里有个容易混淆的点：中断清除寄存器（ECCLR）和中断强制寄存器（ECFRC）。ECCLR用于在中断服务程序（ISR）中清除已处理的事件标志位和全局INT标志，为下一次中断做好准备。而ECFRC则允许软件主动“模拟”一个硬件事件，强制置位对应的标志位并可能产生中断，这在模块调试和测试时非常有用。

实操心得：在编写eCAP中断服务程序时，一个良好的习惯是，一进入ISR就先读取ECFLG的值并保存到局部变量，然后再用ECCLR清除你计划处理的事件标志。这样做可以避免在ISR执行过程中，新发生的事件改变ECFLG状态而导致逻辑错误。清除操作一般是向ECCLR的对应位写1。

2.3 APWM模式：从捕获器到信号发生器

当ECCTL2寄存器的CAP/APWM位设置为1时，eCAP模块就从输入捕获模式切换到了辅助PWM输出模式。此时，内部逻辑发生根本性变化：32位计数器TSCTR工作在递增模式，CAP1作为周期寄存器（APRD），CAP2作为比较寄存器（ACMP），CAP3和CAP4则作为它们的影子寄存器。

APWM模式的核心是比较逻辑。TSCTR从0开始，每个系统时钟加1，它会同时与CAP1（周期值）和CAP2（比较值）进行比较。当TSCTR等于CAP2时，产生比较匹配事件；当TSCTR等于CAP1时，产生周期匹配事件，同时TSCTR复位为0，开始下一个PWM周期。输出引脚的电平由这两个事件和APWMPOL（输出极性）位共同决定。

影子寄存器机制是APWM模式稳定运行的保障。在初始化时，你必须直接写入活动寄存器CAP1和CAP2来设置初始周期和比较值，此时硬件会自动将相同的值拷贝到影子寄存器CAP3和CAP4。在运行过程中，若要更新PWM参数（比如改变占空比），你应该写入影子寄存器CAP3（新周期值）或CAP4（新比较值）。写入后，新值不会立即生效，而是会在下一个PWM周期开始时（TSCTR与CAP1匹配，即周期匹配点），由硬件自动从影子寄存器加载到活动寄存器。这种机制确保了PWM参数在周期边界同步更新，完全避免了在周期中间更新可能导致的脉冲宽度异常或毛刺。

避坑指南：很多新手在APWM模式下无法输出波形，常忽略两个关键点。第一，初始化时必须先配置为APWM模式，再给CAP1和CAP2赋值，顺序反了可能导致模式切换时寄存器功能错乱。第二，输出引脚需要通过GPIO多路复用器正确映射到eCAP模块的APWMx功能，并配置为输出模式。光配置模块内部，不配置GPIO，信号是走不到引脚上的。

3. eCAP工作模式详解���配置实战

理解了架构，我们进入实战环节。eCAP的威力在于其工作模式的多样性。我们主要围绕两种核心模式展开：捕获模式和APWM模式，而捕获模式又细分为绝对时间戳和差值时间戳两种子模式。

3.1 绝对时间戳捕获模式

在这种模式下，32位TSCTR计数器自由运行，永不复位（除非软件强制或同步事件）。每当检测到设定的边沿事件，TSCTR的当前值就被“快照”并存入对应的CAP寄存器。因此，CAP寄存器中存储的是从某个起始点（通常是计数器启动或上次溢出后）到事件发生时刻的绝对时间。

应用场景：适合测量非周期性事件或事件间隔较长、不太可能发生计数器溢出的情况。例如，测量一个手动按钮按下的时间间隔，或者一个转速很慢的编码器脉冲。

配置要点：

1. 设置边沿极性：通过ECCTL1寄存器的CAPxPOL位，为CAP1-CAP4分别选择上升沿或下降沿触发。如果只想测周期，四个事件可以都设为上升沿；如果想同时测占空比，则需要交替设置为上升沿和下降沿（如：CAP1POL=上升，CAP2POL=下降，CAP3POL=上升，CAP4POL=下降）。
2. 配置计数器复位模式：将ECCTL1中的CTRRST1-CTRRST4全部设置为EC_ABS_MODE（通常值为0），表示捕获事件后计数器不复位。
3. 选择工作模式：在ECCTL2寄存器中，设置CAP/APWM = EC_CAP_MODE，CONT/ONESHT根据需求选择连续或单次模式。
4. 使能捕获加载：确保ECCTL1.CAPLDEN位被置1，否则时间戳无法加载到CAP寄存器。
5. 配置中断：在ECEINT寄存器中使能你关心的事件中断，例如使能CEVT4，这样在第四次捕获完成后触发中断，此时CAP1-CAP4中都已存有有效数据，CPU可以一次性全部读出。

数据处理：在中断服务程序中，读取CAP1-CAP4的值，假设为T1, T2, T3, T4。那么：

• 周期1 = T2 - T1
• 周期2 = T3 - T2
• 周期3 = T4 - T3
• 占空比（如果用了双边沿） = (T2 - T1) / (T3 - T1) * 100%

潜在问题与解决：最大的风险是32位计数器溢出。TSCTR从0x00000000计数到0xFFFFFFFF，然后回到0x00000000。如果在两次捕获事件之间发生了溢出，简单的T2-T1计算就会得到错误的结果（因为发生了无符号整数的回绕）。解决方案有两种：一是确保测量时间间隔远小于计数器溢出时间（溢出时间 = 2^32 / 系统时钟频率）；二是使能CTROVF（计数器溢出）中断，在软件中维护一个全局的高位计数器，每次溢出中断将其加1，这样时间戳就扩展成了64位（高位计数器 << 32 | TSCTR）。

3.2 差值时间戳捕获模式

这是eCAP模块最具特色的功能。在此模式下，每次捕获事件发生后，TSCTR计数器会在将当前值存入CAP寄存器后，立即自动复位为0。因此，CAP寄存器中存储的不再是绝对时间，而是上一次捕获事件到本次捕获事件之间所经过的时钟周期数。

应用场景：这是测量周期性信号（如方波、脉冲串）周期和占空比的理想模式。因为它直接给出了时间间隔，CPU无需做减法运算，减少了软件开销和潜在误差。非常适合电机测速、频率测量等应用。

配置要点：

1. 设置边沿极性：与绝对模式类似，根据测量需求配置。
2. 配置计数器复位模式：这是关键！必须将ECCTL1中的CTRRST1-CTRRST4全部设置为EC_DELTA_MODE（通常值为1）。
3. 其他配置：工作模式、捕获使能、中断配置等与绝对模式类似。

数据处理：此时，数据解读变得极其简单。假设配置为上升沿触发，那么：

• CAP1 = 第1个脉冲的周期
• CAP2 = 第2个脉冲的周期
• CAP3 = 第3个脉冲的周期
• CAP4 = 第4个脉冲的周期 如果配置为交替的上升沿和下降沿触发（例如：上升、下降、上升、下降），那么：
• CAP1 = 第1个脉冲的高电平时间
• CAP2 = 第1个脉冲的低电平时间
• CAP3 = 第2个脉冲的高电平时间
• CAP4 = 第2个脉冲的低电平时间 此时，周期 = 高电平时间 + 低电平时间。

核心优势：差值模式不仅省去了软件减法运算，更重要的是，它避免了在高速测量时，因读取CAP寄存器的瞬间TSCTR仍在运行而可能引入的“读数误差”。因为捕获动作和计数器复位是硬件原子操作，瞬间完成，软件读到的永远是一个稳定的、已经“定格”的时间间隔值。

3.3 APWM模式配置与波形生成

将eCAP配置为PWM发生器，是对其资源的创造性复用。配置流程比捕获模式更直接，但有几个细节必须注意。

初始化步骤：

1. 引脚配置：首先，通过GPIO多路复用控制器，将目标引脚的功能选择设置为eCAP模块的APWM输出功能，并将该引脚方向配置为输出。
2. 模块模式设置：将ECCTL2寄存器的CAP/APWM位设置为EC_APWM_MODE。
3. 设置PWM参数：
   • 写入周期值：直接向CAP1寄存器写入所需的PWM周期值（以系统时钟周期数为单位）。注意：此时写入CAP1，该值会同时自动拷贝到影子寄存器CAP3。
   • 写入比较值：直接向CAP2寄存器写入所需的PWM比较值（即高电平时间，对于主动高极性）。该值同样会自动拷贝到影子寄存器CAP4。
   • 计算示例：假设系统时钟SYSCLK = 100MHz，需要生成一个频率为10kHz，占空比为30%的PWM。
     • 周期值 = SYSCLK / PWM频率 = 100,000,000 / 10,000 = 10,000。写入CAP1 = 10000 - 1 = 9999（因为计数器从0开始）。
     • 比较值 = 周期值 * 占空比 = 9999 * 0.3 ≈ 2999.7，取整为3000。写入CAP2 = 3000。
4. 配置输出极性：通过ECCTL2寄存器的APWMPOL位选择是主动高（高电平有效）还是主动低（低电平有效）。
5. 启动计数器：将ECCTL2寄存器的TSCTRSTOP位设置为EC_RUN，启动32位计数器TSCTR。

运行时更新PWM参数：若要改变占空比或频率，绝不能直接写入活动寄存器CAP1或CAP2，这会导致当前周期波形紊乱。正确做法是：

• 更新占空比：将新的比较值写入影子寄存器CAP4。硬件会在下一个PWM周期开始时，自动将其加载到CAP2生效。
• 更新频率（周期）：将新的周期值写入影子寄存器CAP3。同样，它会在下一个周期开始时加载到CAP1生效。
• 同时更新周期和比较值：这是一个需要特别注意的情况。如果你先写CAP3（新周期），再写CAP4（新比较值），而这两个写操作之间发生了周期匹配，那么CAP3的新值会立刻加载到CAP1，但CAP4的新值可能还没来得及加载。这会导致新周期开始后，比较值仍是旧的，产生一个非预期的脉冲。安全的做法是，先计算好新比例下的新比较值，然后先写CAP4（新比较值），再写CAP3（新周期）。或者，使用一个影子缓冲变量，在同一个中断服务例程中原子化地更新CAP3和CAP4。

4. 关键寄存器详解与编程模型

理解了原理和模式，最终都要落到对寄存器的操作上。eCAP的寄存器不算多，但每个位域都至关重要。这里我们重点剖析几个最核心的控制和状态寄存器，建立清晰的编程模型。

4.1 控制寄存器ECCTL1与ECCTL2

这两个寄存器是eCAP模块的“大脑”。

ECCTL1（捕获控制寄存器1）：

• CAPxPOL (bits 3:0, 7:4, 11:8, 15:12)：这四组位分别控制四次捕获事件的边沿极性。0代表上升沿，1代表下降沿。这是实现双边沿测量的基础。
• CTRRSTx (bits 19:16, 23:20, 27:24, 31:28)：这四组位控制每次捕获事件后，32位计数器TSCTR是否复位。0为不复位（���对模式），1为复位（差值模式）。务必注意：在APWM模式下，这些位无效，因为TSCTR的复位由周期匹配事件控制。
• CAPLDEN (bit 8)：捕获加载使能。必须置1，时间戳才能加载到CAP1-CAP4寄存器。在单次模式下，当序列器达到停止值时，硬件会自动清除此位以冻结数据。
• PRESCALE (bits 13:9)：事件预分频因子。输入信号可以除以2到62之间的偶数。设置为0表示旁路（不分频）。对于频率非常高的输入信号，必须使用预分频，否则TSCTR可能来不及计数。

ECCTL2（捕获控制寄存器2）：

• CAP/APWM (bit 9)：模式选择核心位。0为捕获模式，1为APWM模式。模式切换前，最好先停止计数器（TSCTRSTOP=0）。
• CONT/ONESHT (bit 8)：连续/单次控制。0为连续模式，环形缓冲；1为单次模式，捕获指定次数后停止。
• STOP_WRAP (bits 7:6)：单次模式下的停止值。00=捕获1次后停止，01=2次，10=3次，11=4次。
• RE-ARM (bit 5)：单次模式下的重装使能。软件向此位写1，会清零模4序列器，并重新使能CAPLDEN（如果之前被自动禁用），为下一次单次捕获序列做准备。
• TSCTRSTOP (bit 4)：计数器停止控制。0=停止TSCTR，1=运行TSCTR。
• SYNCI_EN (bit 3)：同步输入使能。使能后，外部同步信号可以复位TSCTR为相位寄存器（CTRPHS）的值，用于多模块同步。
• SYNCO_SEL (bits 2:1)：同步输出选择。决定本模块产生什么信号作为同步输出，可供其他模块使用。可选同步输入、计数器等于周期、或者禁用。
• APWMPOL (bit 10)：APWM模式下的输出极性。0=主动高（比较匹配时输出变高，周期匹配时变低），1=主动低（逻辑相反）。

4.2 中断相关寄存器组

中断管理涉及四个寄存器，它们协同工作的逻辑需要彻底理解。

中断标志寄存器（ECFLG）：

• 这是一个状态寄存器，只读（除INT位可写1清除）。每一位对应一个具体的事件（CEVT1, CEVT2, CEVT3, CEVT4, CTR=PRD, CTR=CMP, CTROVF）。
• 只要硬件检测到对应事件发生，无论中断是否使能，该位都会被置1。
• INT位是全局中断标志。当任何一个已使能的中断事件发生且INT位为0时，模块会向PIE发出中断脉冲，同时硬件将INT位置1。INT位为1会屏蔽后续所有中断脉冲，直到软件将其清除。

中断使能寄存器（ECEINT）：

• 这是一个控制寄存器。向某位写1，使能对应事件的中断；写0则禁止。
• 只有ECFLG中某事件标志位为1，并且在ECEINT中该事件被使能，同时ECFLG.INT位为0，才会触发中断脉冲。

中断清除寄存器（ECCLR）：

• 这是一个只写寄存器，读操作无意义。
• 在中断服务程序中，软件向ECCLR的某个事件位写1，会清除ECFLG中对应的标志位。
• 向INT位写1，会清除ECFLG中的全局INT标志位。标准的中断服务程序流程是：先清除具体事件标志位，再清除全局INT标志位。

中断强制寄存器（ECFRC）：

• 这是一个只写寄存器，用于测试。
• 向某位写1，会强制置位ECFLG中对应的标志位。如果该事件在ECEINT中被使能，且INT位为0，则会触发一个中断。这可以用于模拟硬件事件，测试中断服务程序。

4.3 时间戳/影子寄存器CAP1-CAP4

这是数据存储的核心。在C代码中，它们通常被定义为联合体（union）或结构体（struct）中的成员，方便以不同位宽访问。

• 在捕获模式下，它们是只读的，存储捕获到的时间戳。
• 在APWM模式下：
  • CAP1：PWM周期活动寄存器（APRD_ACTIVE）。写入时，值同时拷贝到CAP3（APRD_SHADOW）。
  • CAP2：PWM比较活动寄存器（ACMP_ACTIVE）。写入时，值同时拷贝到CAP4（ACMP_SHADOW）。
  • CAP3：PWM周期影子寄存器（APRD_SHADOW）。运行时更新周期值应写到这里。
  • CAP4：PWM比较影子寄存器（ACMP_SHADOW）。运行时更新比较值应写到这里。

编程模型总结：

1. 初始化阶段：配置GPIO引脚复用 -> 停止计数器（TSCTRSTOP=0） -> 配置ECCTL1/ECCTL2选择模式和参数 -> 若为APWM模式，写入CAP1/CAP2初始化PWM参数 -> 配置中断使能ECEINT -> 启动计数器（TSCTRSTOP=1）-> 若为单次捕获模式，执行重装（RE-ARM=1）。
2. 中断服务例程：保存上下文 -> 读取ECFLG判断事件源 -> 处理数据（读取CAP寄存器或更新影子寄存器）-> 向ECCLR写1清除已处理的事件标志位 -> 向ECCLR.INT写1清除全局中断标志 -> 恢复上下文并返回。
3. 运行时控制：在APWM模式下，通过写CAP3/CAP4影子寄存器来更新PWM参数。在单次捕获模式下，通过写RE-ARM位启动新一轮捕获。

5. 典型应用场景与代码实现剖析

理论最终要服务于实践。我们结合两个最典型的应用场景——电机转速测量和PWM信号生成，来看一下具体的代码实现思路和注意事项。

5.1 场景一：基于差值模式的电机转速测量

假设我们需要测量一个霍尔传感器输出的脉冲频率（从而计算电机转速），传感器输出一个占空比50%的方波，频率范围在1Hz到10kHz之间。我们使用eCAP1模块，工作在连续捕获、差值模式、仅上升沿触发。

硬件连接：霍尔传感器信号线连接到MCU的ECAP1引脚。

软件配置思路：

1. 初始化GPIO：将ECAP1引脚配置为eCAP功能输入。
2. 配置eCAP模块：
   • 选择捕获模式（CAP/APWM = 0）。
   • 选择连续模式（CONT/ONESHT = 0）。
   • 设置四个事件均为上升沿触发（CAP1POL-CAP4POL = 0）。
   • 设置四个事件均为差值模式（CTRRST1-CTRRST4 = 1）。
   • 使能捕获加载（CAPLDEN = 1）。
   • 根据最大输入频率（10kHz）和系统时钟（假设100MHz）计算，计数器在最短周期（0.1ms）内会计数100MHz * 0.1ms = 10,000次，远小于2^32，无需预分频（PRESCALE = 0）。
   • 使能CEVT4中断，这样每捕获4个脉冲（即得到3个完整的周期数据）产生一次中断，平衡了实时性和CPU负载。
   • 启动计数器（TSCTRSTOP = 1）。

中断服务程序（ISR）伪代码：

interrupt void ecap1_isr(void) { volatile Uint32 flags = ECap1Regs.ECFLG.all; // 读取中断标志 if (flags & EC_CEVT4_BIT) { // 判断是否为第4次捕获事件 // 读取时间戳差值，它们直接就是周期（单位：系统时钟周期数） period1 = ECap1Regs.CAP2; // 第1个完整周期 period2 = ECap1Regs.CAP3; // 第2个完整周期 period3 = ECap1Regs.CAP4; // 第3个完整周期 // 注意：CAP1存储的是上一次中断到本次中断第1个事件的时间，这里我们更关心连续的周期，所以从CAP2开始读。 // 计算平均周期，可进一步转换为频率和转速 avg_period_ticks = (period1 + period2 + period3) / 3; frequency_hz = SYSTEM_CLOCK_HZ / avg_period_ticks; rpm = (frequency_hz * 60) / POLE_PAIRS; // 假设POLE_PAIRS为电机极对数 // 清除中断标志 ECap1Regs.ECCLR.bit.CEVT4 = 1; } // 清除全局中断标志，允许新的中断进入 ECap1Regs.ECCLR.bit.INT = 1; // 如果需要，清除PIE中断应答位 PieCtrlRegs.PIEACK.all = PIEACK_GROUP4; }

关键细节：为什么在连续差值模式下，读取CAP2、CAP3、CAP4来计算周期？因为序列器是循环的。假设脉冲序列为P1, P2, P3, P4, P5...。当捕获到P4的上升沿（CEVT4）触发中断时，CAP1存的是P3到P4的时间，CAP2存的是P2到P3的时间，CAP3存的是P1到P2的时间，CAP4存的是P4到“未来P5”的时间（但P5还没发生，所以这个值无意义或是一个旧值）。因此，最近三个有效周期是CAP2、CAP3和CAP4（在本次中断时，CAP4其实是上一个中断周期存储的P1-P2时间？这里需要厘清）。更稳妥的做法是：在CEVT4中断中，读取CAP1、CAP2、CAP3，它们分别对应着刚刚完成的三个间隔T3-P4, T2-P3, T1-P2。对于均匀周期信号，这三个值都应近似相等。这种理解上的细微差别，正是容易出错的地方。最好的办法是通过仿真或实际测量，打印出CAP1-CAP4的值序列，来确认其对应关系。

5.2 场景二：APWM模式生成带死区互补的PWM（思路扩展）

eCAP本身是单通道PWM发生器。但要驱动全桥电路等需要互补PWM且带死区的应用，单个eCAP不够。通常的做法是使用一个eCAP模块生成主PWM（例如上管信号），然后利用另一个定时器模块（如ePWM）与其同步，并通过ePWM模块强大的死区生成子模块来产生互补的、带死区的下管信号。

配置思路：

1. 配置eCAP2为APWM模式，生成主PWM信号（假设频率20kHz，占空比40%）。计算并写入CAP1（周期）和CAP2（比较值）。
2. 配置一个ePWM模块（如ePWM1）：
   • 将其时基计数器（TBCTR）的时钟源和频率设置得与eCAP2的TSCTR一致。
   • 设置ePWM1的同步输入信号为来自eCAP2的同步输出（SYNCO）。在eCAP2中，配置SYNCO_SEL为CTR=PRD，这样每当eCAP2的计数器达到周期值时，就会产生一个同步脉冲输出。
   • 在ePWM1中，使能同步输入（TBCTL[PHSEN]=1），并设置相位寄存器（TBPHS）为0。这样，ePWM1的时基计数器会在每个eCAP2周期开始时被同步复位，两者严格同频同相。
3. 配置ePWM1的死区模块：根据所驱动的功率器件（如MOSFET或IGBT）的开关特性，设置合适的上升沿延迟和下降沿延迟，生成互补的PWM对（EPWM1A和EPWM1B）。
4. 连接：eCAP2的APWM输出直接作为上管驱动信号；ePWM1A和EPWM1B经过死区生成后，作为下管的互补驱动信号。

这样，我们就用eCAP2作为“主时钟”，ePWM1作为“从时钟”，结合ePWM的死区功能，实现了带死区的互补PWM生成。这种架构充分利用了不同外设的特长。

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

在实际项目中，使用eCAP可能会遇到一些棘手的情况。这里分享一些从调试中积累的经验和排查方法。

6.1 精度与溢出处理

问题：测量极低频率信号时，32位计数器可能溢出多次，导致绝对时间戳计算错误。解决方案：

• 使能溢出中断：在ECEINT中使能CTROVF中断。
• 维护软件扩展计数器：在CTROVF中断服务程序中，将一个32位或64位的软件全局变量（如g_tsctr_overflow_count）加1。
• 组合时间戳：当读取CAP寄存器时，将软件计数器与硬件TSCTR组合成一个64位的时间戳：full_timestamp = ((Uint64)g_tsctr_overflow_count << 32) | (Uint64)ECapxRegs.TSCTR。注意，读取操作本身需要时间，为了确保原子性，最好在中断禁用的情况下，连续读取溢出计数器和TSCTR两次，如果两次读取的溢出计数器相同，则数据有效；如果不同，说明发生了溢出，需要重新读取。

问题：输入信号频率过高，导致两次捕获之间TSCTR的计数值超过其最大值。解决方案：

• 使用预分频器：这是首选方案。例如，系统时钟100MHz，输入信号10MHz。如果不分频，最短周期内TSCTR会计数10次，远小于2^32，没问题。但如果输入信号是50MHz，最短周期内只计数2次，分辨率太低。此时需要权衡。如果信号是100MHz，周期内只计数1次，无法测量。实际上，eCAP的预分频器（2-62偶数分频）正是为此而生。将50MHz信号进行2分频，变成25MHz，每个分频后周期内计数器计数值为4，提高了分辨率。但分频会降低时间戳的绝对精度（分辨率从10ns降到了20ns）。
• 使用差值模式：差值模式在每次捕获后复位计数器，从根本上避免了长时间间隔的溢出问题，特别适合周期性信号。

6.2 同步与多模块协作

问题：多个eCAP模块需要同时启动或保持确定的相位关系，例如多路同步数据采集。解决方案：使用eCAP的同步输入（SYNCI）和同步输出（SYNCO）功能。

• 主从设置：将一个eCAP模块配置为主模块，将其SYNCO_SEL设置为CTR=PRD（在APWM模式）或使用软件强制同步（SWSYNC位）。将其他eCAP模块配置为从模块，使能SYNCI_EN，并将其相位寄存器CTRPHS设置为期望的偏移值。
• 同步过程：当主模块产生同步脉冲（如计数器归零）时，所有使能了同步输入的从模块，会将其TSCTR计数器加载为各自CTRPHS的值。这样就实现了多个计数器在特定时刻对齐到预设的相位。

注意：同步操作是一个瞬间动作。在捕获模式下，如果正在进行捕获序列，同步信号复位计数器可能会干扰测量。通常建议在测量开始前完成同步，或者在测量间隙进行同步。

6.3 调试与问题排查清单

当eCAP模块不按预期工作时，可以按照以下清单逐步排查：

1. 时钟与引脚：

   • [ ] 确认系统时钟是否正确配置并供给eCAP模块？
   • [ ] 确认GPIO引脚是否已正确复用为eCAP功能？输入方向是否正确（捕获模式）？输出方向是否正确（APWM模式）？
   • [ ] 用示波器或逻辑分析仪检查信号是否确实到达了MCU引脚？

2. 基本配置：

   • [ ]ECCTL2.TSCTRSTOP位是否已设置为1（运行）？
   • [ ] 在捕获模式下，ECCTL1.CAPLDEN位是否已使能？
   • [ ] 在APWM模式下，ECCTL2.CAP/APWM位是否设置为1？
   • [ ] 计数器TSCTR的值在增加吗？可以通过调试器实时查看TSCTR寄存器。

3. 事件与中断：

   • [ ] 边沿极性CAPxPOL设置是否正确？
   • [ ] 中断是否已使能？检查ECEINT寄存器。
   • [ ] 中断标志ECFLG是否被置位？如果标志位置位但没进中断，检查PIE和CPU级的中断使能，以及中断向量表是否正确配置。
   • [ ] 在中断服务程序中，是否清除了相应的事件标志位和全局INT标志位？

4. APWM模式特有：

   • [ ] PWM周期值CAP1是否大于比较值CAP2？（否则可能无输出或常高/常低）。
   • [ ] 输出极性APWMPOL是否符合预期？
   • [ ] 更新PWM参数时，是否写入的是影子寄存器（CAP3/CAP4）而非活动寄存器？

5. 软件逻辑：

   • [ ] 在单次捕获模式下，一次序列完成后，是否执行了重装（RE-ARM）操作来启动下一次捕获？
   • [ ] 是否存在寄存器访问冲突？例如，在APWM模式下，一个后台任务写影子寄存器的同时，中断服务程序也在写，这可能产生竞态条件。考虑使用临界保护或标志位通信。

从精准捕获外部事件的瞬间，到稳定生成复杂的PWM波形，eCAP模块展现了一个优秀硬件外设应有的素质：专注、高效、灵活。它把最耗时的计时和比较工作从CPU肩上卸下，通过精密的硬件状态机自动完成。无论是测量旋转编码器的细微抖动，还是生成驱动电机所需的精准脉宽，eCAP都能提供可靠的硬件保障。掌握它，不仅仅是记住几个寄存器位域，更是要理解其内部“事件流”的思想——如何通过配置，让硬件自动完成你想要的测量或控制序列。在实际项目中，我习惯在初始化完成后，先用最简单的绝对时间、上升沿、连续捕获模式去验证硬件通路和中断响应是否正常，然后再逐步叠加更复杂的功能，如差值模式、双边沿触发、APWM输出等。这种由简入繁的调试方法，能帮你快速定位问题是出在基础配置、硬件连接还是更上层的应用逻辑上。最后，别忘了善用芯片的数据手册和技术参考指南，那里面藏着比任何博文都更权威的细节。