1. 项目概述：从“捕获”到“生成”的硬件瑞士军刀

在嵌入式实时控制的世界里，时间就是一切。无论是精确测量电机编码器的脉冲间隔，还是生成驱动开关电源的PWM信号，核心需求都是对时间维度的精准掌控。传统上，我们可能会用通用定时器配合中断来测量脉冲宽度，或者用专用的PWM模块来生成波形。但有没有一种硬件，能像瑞士军刀一样，同时胜任“高精度测量”和“灵活生成”这两项看似矛盾的任务？德州仪器（TI）C2000系列微控制器中的增强型捕获模块，就是为回答这个问题而生的。

eCAP模块，全称Enhanced Capture Module，是TMS320F280015x这类高性能实时微控制器上的一个外设明珠。它绝不是一个简单的输入捕获接口，而是一个集成了32位时间戳计数器、4级深度捕获寄存器、灵活边沿触发逻辑，甚至能摇身一变成为PWM发生器的多功能硬件单元。它的设计哲学很明确：将最耗时、最要求确定性的时序处理任务从CPU肩上卸下来，交给专用硬件去完成，从而让CPU腾出手来处理更复杂的控制算法和系统管理。

想象一下，你要测量一个频率高达1MHz的PWM信号的占空比。如果用软件在中断里读取定时器值，光是中断响应和上下文切换的时间抖动就可能带来数百纳秒的误差，这对于精密控制来说是不可接受的。而eCAP模块可以在硬件层面，在信号边沿到来的那个精确时钟周期，自动将当前计数器的值“冻结”并存入FIFO，整个过程零CPU干预，精度直接取决于系统时钟。更进一步，当你需要生成一个互补、带死区、或者有特定相移的PWM信号时，eCAP模块可以切换到APWM模式，利用其内部的周期和比较寄存器，像一个小型的专用PWM发生器一样工作。

本文将深入TMS320F280015x的eCAP模块内部，不仅解读技术手册中的时序图和工作模式，更会结合我多年在电机控制和数字电源项目中的实际使用经验，拆解其从绝对/差值时间戳捕获到辅助PWM生成的全流程。我会重点分享如何根据不同的应用场景（如测频、测脉宽、生成同步波形）来选择和配置模式，并附上关键寄存器的配置心得与避坑指南。无论你是正在评估C2000芯片的架构师，还是正在调试传感器接口的工程师，相信这篇关于eCAP原理与实战的深度解析都能为你提供直接的参考。

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

要玩转eCAP，首先得理解它的“五脏六腑”。这个模块的设计非常精巧，其核心是一个自由运行的32位时间戳计数器（TSCTR）和一个4状态的模4计数器（Mod4 Counter）。它们俩的配合，构成了eCAP所有神奇功能的基石。

2.1 核心硬件引擎：TSCTR与Mod4计数器

时间戳计数器（TSCTR）是eCAP模块的心跳。它通常由系统时钟（SYSCLK）驱动，不断向上计数。这是一个32位的计数器，意味着在200MHz的系统时钟下，它的溢出周期长达约21.5秒（2^32 / 200e6），为超长周期的测量提供了可能。TSCTR是eCAP所有时序测量的绝对时间基准。

模4计数器（Mod4 Counter）则像是一个智能的“流水线调度员”。它是一个2位计数器，循环计数（0->1->2->3->0…）。它的核心作用是管理四个捕获寄存器（CAP1-CAP4）的轮转。每当一个有效的捕获事件（由输入引脚边沿触发）发生时，Mod4计数器就会步进一次，并决定当前时间戳该存入CAP1、CAP2、CAP3还是CAP4。这种设计形成了一个硬件FIFO，可以连续捕获最多4个事件的时间戳而无需CPU立即读取，极大地提高了系统的实时性和抗干扰能力。

2.2 两种根本模式：捕获模式 vs. APWM模式

eCAP模块有两种根本的工作模式，由ECCTL2.CAP_APWM位决定。这是理解其所有功能的第一步。

捕获模式（CAP Mode）：这是eCAP的“本职工作”。在此模式下，配置的GPIO引脚作为输入，模块的核心任务是监测该引脚上的信号边沿，并在边沿发生时，将此刻TSCTR的值捕获到相应的CAPx寄存器中。CPU可以稍后读取这些寄存器，计算出信号的周期、占空比等信息。根据TSCTR在捕获后的行为，捕获模式又细分为两种子模式：

• 绝对时间戳模式：TSCTR自由运行，永不复位。捕获到的是事件发生的绝对时间点。要计算时间间隔，需要软件做减法（例如，Period = CAP3 - CAP1）。
• 差值时间戳模式：TSCTR在每次捕获事件后自动复位。捕获寄存器中存储的直接是本次事件与上一次事件之间的时间差值（即周期或脉宽），CPU无需再做减法，简化了计算。

辅助PWM模式（APWM Mode）：这是eCAP的“副业”，但也极其强大。在此模式下，该GPIO引脚变为输出，eCAP模块利用CAP1/CAP2作为活动的周期/比较寄存器，CAP3/CAP4作为其影子寄存器，变身成一个完整的、可与其他PWM模块同步的PWM发生器。虽然它没有ePWM模块那样复杂的死区、故障保护和事件触发系统，但对于生成简单的、可同步的PWM信号，或者作为额外的PWM通道，它非常轻量且高效。

2.3 关键寄存器组概览

在深入时序之前，快速浏览一下控制eCAP的几组关键寄存器，这对后续的配置理解至关重要：

• 数据寄存器：TSCTR（计数器值）、CAP1-CAP4（捕获值或PWM周期/比较值）。
• 控制寄存器：
  • ECCTL1：控制每个捕获事件的边沿极性（上升沿/下降沿）、是否在事件后复位TSCTR（决定绝对/差值模式）、事件滤波预分频等。
  • ECCTL2：这是“模式切换开关”。它决定模块工作在捕获模式还是APWM模式（CAP_APWM位），控制连续/单次捕获（CONT_ONESHT），设置停止/回绕点（STOP_WRAP），以及配置同步功能。
• 中断寄存器：ECEINT（中断使能）、ECFLG（中断标志）、ECCLR（标志清除）、ECFRC（软件强制中断）。合理利用中断可以高效处理捕获数据或更新PWM参数。

理解了这些基础架构，我们就可以像看施工图一样，去解读官方手册中那些经典的时序图了。接下来，我们将进入最核心的部分，拆解四种经典的捕获操作序列，看看硬件是如何在无声中完成精密测量的。

3. 深度拆解：四种经典捕获时序与配置实战

TI的技术手册用几张经典的时序图清晰地展示了eCAP的四种典型工作方式。我们不仅要看懂这些图，更要理解其背后的配置逻辑和适用场景。这是将原理转化为代码的关键一步。

3.1 案例一：绝对时间戳与上升沿触发

这是最基础的捕获模式。如图15-13（注：此处指代输入内容中描述的图，下同）左侧部分所示，我们仅配置在输入信号的上升沿进行捕获。

工作原理：

1. TSCTR自由运行，永不复位。
2. 输入引脚（CAPx）上每出现一个上升沿，就产生一个捕获事件（CEVT1, CEVT2...）。
3. 每个事件触发时，硬件自动将当前的TSCTR值锁存到由Mod4计数器指向的CAP寄存器中（顺序为CAP1, CAP2, CAP3, CAP4，然后循环）。
4. Mod4计数器在每次捕获后递增。

你能得到什么：CAP1, CAP2, CAP3, CAP4中分别存储了t1, t2, t3, t4时刻的绝对计数值。如何计算：信号周期需要通过软件做减法。例如，第一个周期 Period1 = CAP3 - CAP1（即t3 - t1）。由于只捕获了上升沿，你无法直接得到占空比。

配置要点：

• ECCTL2.CAP_APWM = 0：设置为捕获模式。
• ECCTL2.CONT_ONESHT = 0：设置为连续模式（或1为单次模式）。
• ECCTL1.CAPxPOL = 0：将所有CAP1POL-CAP4POL设置为0，即仅上升沿触发。
• ECCTL1.CTRRSTx = 0：将所有CTRRST1-CTRRST4设置为0，表示TSCTR在捕获后不复位（绝对时间戳）。
• ECCTL2.STOP_WRAP = 3：在连续模式下，设置Mod4计数器在4次捕获后回绕（0->1->2->3->0）。

实操心得：这种模式适用于频率测量，特别是频率较低或变化缓慢的场景。你只需要捕获两个连续的上升沿，做一次减法，再根据系统时钟频率就能算出周期。它的优势是简单直观，但要注意32位计数器的溢出问题。如果你的信号周期很长，两次捕获间TSCTR可能溢出，软件计算时需要处理溢出情况，通常判断如果CAP[n] < CAP[n-1]，则周期 =CAP[n] + (0xFFFFFFFF - CAP[n-1])。

3.2 案例二：绝对时间戳与双沿触发

此模式在案例一的基础上进行了关键升级：同时捕获上升沿和下降沿。如图15-13整体所示，它交替响应上升沿和下降沿事件。

工作原理：

1. 配置CAP1和CAP3为上升沿触发（CAP1POL=0, CAP3POL=0），CAP2和CAP4为下降沿触发（CAP2POL=1, CAP4POL=1）。
2. 输入信号变化时，硬件按照预设的极性依次触发CEVT1（上升沿）、CEVT2（下降沿）、CEVT3（上升沿）、CEVT4（下降沿）...
3. 同样，TSCTR自由运行，捕获的是绝对时间戳。

你能得到什么：CAP1存第一个上升沿时间t1，CAP2存第一个下降沿时间t2，CAP3存第二个上升沿时间t3，CAP4存第二个下降沿时间t4，如此循环。如何计算：现在你拥有了一个完整脉冲的所有时间信息！ * 第一个脉冲的周期：Period1 = t3 - t1* 第一个脉冲的高电平时间（脉宽）：PulseWidth1 = t2 - t1* 第一个脉冲的占空比：DutyCycle1 = (t2 - t1) / (t3 - t1) * 100%

配置要点：

• 关键在ECCTL1的极性设置：CAP1POL=0,CAP2POL=1,CAP3POL=0,CAP4POL=1。
• 其他配置（模式、复位控制、停止回绕）与案例一相同。

注意事项：这是测量占空比和脉冲宽度的黄金模式。在调试电机驱动器的PWM信号或读取某些传感器的脉宽调制输出时，我几乎总是优先使用此模式。它一次性硬件捕获一个完整周期所需的全部数据，效率极高。但务必注意输入信号的最大频率。因为eCAP需要在一个周期内响应两个边沿事件，所以它能测量的最高信号频率，理论上是在你处理完4个捕获数据（两个完整脉冲）的时间内，信号不能超过4个边沿事件。你需要根据CPU读取和处理数据的速度来评估。

3.3 案例三：差值时间戳与上升沿触发

从案例三开始，我们进入“差值时间戳”模式。如图15-14所示，最大的变化在于TSCTR的行为。

工作原理：

1. 配置ECCTL1.CTRRST1 = 1（假设我们只用CEVT1）。这意味着在CEVT1（上升沿）事件发生时，硬件先执行捕获操作，然后将TSCTR复位为0。
2. TSCTR从0开始重新向上计数，直到下一个上升沿事件到来，再次捕获并复位。
3. 因此，捕获寄存器CAP1中存储的不再是绝对时间，而是上一个上升沿到当前上升沿的时间间隔，即信号的周期T1。

你能得到什么：CAP1中直接就是周期值T1，CAP2中是下一个周期T2，以此类推。软件无需做减法。如何计算：读取CAPx的值，乘以系统时钟周期，即得到真实的信号周期。Period = CAPx * (1 / SYSCLK)。

配置要点：

• ECCTL1.CTRRSTx = 1：将需要复位计数器的捕获事件对应位设为1。通常，如果我们只关心周期，只需在第一个事件（如CEVT1）后复位。
• ECCTL2.CONT_ONESHT和STOP_WRAP根据需求设置。例如，在连续模式下，设置STOP_WRAP=1，可以让Mod4计数器在每次捕获后（CEVT1）就回绕，始终使用CAP1寄存器，这样你总是从CAP1读取最新的周期值。

避坑指南：差值模式的巨大优势是简化了软件计算，尤其适合需要快速得到周期值的应用，如转速测量。但它有一个潜在风险：计数器溢出。手册中提到，如果TSCTR在下一个事件到来前就计满了（达到0xFFFFFFFF），CTROVF标志会被置位。这意味着输入信号频率过低或丢失。你的中断服务程序必须检查这个标志，否则可能会将溢出后的错误值当作周期读走。一个健壮的做法是：使能CTROVF中断，在中断里进行超时或信号丢失的错误处理。

3.4 案例四：差值时间戳与双沿触发

这是功能最强大的捕获模式，如图15-15所示。它结合了差值模式的便捷和双沿信息的完整。

工作原理：

1. 配置双沿触发：例如，CEVT1上升沿，CEVT2下降沿，CEVT3上升沿，CEVT4下降沿。
2. 关键配置：CTRRST1=1,CTRRST3=1。这意味着在奇数事件（如CEVT1, CEVT3）后复位TSCTR。
3. 时序分析：第一个上升沿（CEVT1）到来，TSCTR值T1（实际是0到t1的差值，但通常复位后第一个间隔无意义或需忽略）被捕获到CAP1，然后TSCTR复位。TSCTR从0开始计数，直到第一个下降沿（CEVT2）到来，将计数值T2捕获到CAP2，但此时TSCTR不复位，继续计数。直到第二个上升沿（CEVT3）到来，将计数值T3捕获到CAP3，然后TSCTR复位。

你能得到什么：CAP2中存储的是高电平时间T2，CAP3中存储的是整个周期（T2+T3）？这里需要仔细理解。实际上，在CEVT3时刻捕获的T3，是从CEVT2（下降沿）到CEVT3（上升沿）的时间，即低电平时间。因此： * 高电平时间（脉宽） = T2 （CAP2） * 低电平时间 = T3 （CAP3） * 信号周期 = T2 + T3 * 占空比 = T2 / (T2 + T3) * 100%

配置要点：

• 极性设置：CAP1POL=0,CAP2POL=1,CAP3POL=0,CAP4POL=1。
• 复位控制：CTRRST1=1,CTRRST2=0,CTRRST3=1,CTRRST4=0。确保在周期的开始点（如每个上升沿）复位计数器。
• 通常设置STOP_WRAP=3，让Mod4计数器在4个事件后回绕，这样CAP1-CAP4循环存储连续脉冲的时序数据。

经验之谈：这是我最推荐用于精密脉宽测量的模式。硬件直接为你测量出了高电平和低电平的时间，软件只需要做一次加法就能得到周期，做一次除法就能得到占空比，CPU开销极小。在调试一个伺服系统的编码器接口时，我用这种模式稳定测量了从几Hz到几百KHz的脉冲信号，精度完全取决于系统时钟，没有任何软件引入的抖动。配置时务必理清CTRRSTx的设置逻辑，它决定了哪个时间差被直接捕获。一个常见的错误是错误地复位TSCTR，导致捕获的时间差不是你想要的那一段。

4. 模式切换：将捕获器变为PWM发生器（APWM模式）

eCAP模块的妙处在于它的“双重人格”。通过配置ECCTL2.CAP_APWM = 1，它可以瞬间从一个高精度的信号分析仪，转变为一个可靠的PWM信号发生器，即APWM模式。

4.1 APWM模式基本原理

在APWM模式下，模块的内部逻辑发生了根本性变化：

• 引脚功能：CAPx/APWMx引脚从输入变为输出。
• 寄存器角色重映射：
  • CAP1&CAP2：变为活动寄存器，分别对应PWM的周期值（APRD）和比较值（ACMP）。
  • CAP3&CAP4：变为影子寄存��，分别对应周期影子寄存器（APRD shadow）和比较影子寄存器（ACMP shadow）。你可以安全地在任何时候向影子寄存器写入新值，硬件会在下一个PWM周期开始时自动将其加载到活动寄存器，实现无毛刺的PWM参数更新。
• 计数器行为：TSCTR现在作为一个递增计数器工作，从0开始计数，当TSCTR = CAP2(ACMP)时，输出电平根据APWMPOL位翻转；当TSCTR = CAP1(APRD)时，输出电平再次翻转并将TSCTR复位为0，开始下一个周期。这与标准的递增计数PWM原理完全一致。

图15-16清晰地展示了这个过程：TSCTR从0计数到ACMP（比较值），输出高电平；从ACMP计数到APRD（周期值），输出低电平；在APRD点，TSCTR复位，输出回到高电平，开始新周期。

4.2 单通道PWM生成配置

配置一个简单的单通道PWM输出是直观的：

1. 将对应GPIO引脚复用为eCAP输出功能。
2. 设置ECCTL2.CAP_APWM = 1，切换到APWM模式。
3. 配置ECCTL2.APWMPOL位决定输出极性（0为高有效，比较值代表高电平时间）。
4. 向CAP3（周期影子寄存器）写入所需的周期值。Period = (APRD + 1) * T_sysclk。
5. 向CAP4（比较影子寄存器）写入所需的比较值，决定占空比。Duty Cycle = (ACMP / APRD) * 100%。
6. 使能TSCTR计数（ECCTL2.TSCTRSTOP = 1）。

此时，引脚上就会输出指定频率和占空比的PWM波。你可以通过修改CAP3和CAP4来动态调整频率和占空比，修改会在下一个周期边界生效。

4.3 高级应用：多通道相位同步PWM

单个APWM通道的能力有限，但eCAP模块支持同步链，这使得生成多个具有固定相位差的PWM波形成为可能，对于多相电机驱动、交错式电源拓扑非常有用。

同步机制：

• 同步输入（SYNCI）：一个eCAP模块的TSCTR可以被外部同步信号（来自另一个eCAP的SYNCO、ePWM模块或软件触发）复位或加载相位值（CTRPHS寄存器）。这用于从模块。
• 同步输出（SYNCO）：每个eCAP模块可以产生自己的同步输出信号，可以来源于：
  • 软件强制（SWSYNC位）
  • 计数器等于周期事件（CTR=PRD，仅在APWM模式下有效）
  • 禁用
• 通过ECCTL2.SYNCI_EN使能同步输入，通过ECCTL2.SYNCO_SEL选择同步输出源。

配置相移PWM的步骤（以eCAP1为主，eCAP2滞后30%相位为例）：

1. 配置主模块（eCAP1）：
   • 设置为APWM模式，配置好频率（APRD）和占空比（ACMP）。
   • 设置SYNCO_SEL选择CTR=PRD作为同步输出源。这样，eCAP1在每个PWM周期开始时都会产生一个同步脉冲。
2. 配置从模块（eCAP2）：
   • 设置为APWM模式，配置相同的APRD和ACMP值（保证频率和占空比一致）。
   • 使能同步输入（SYNCI_EN = 1），并将同步源选择为eCAP1的SYNCO。
   • 计算所需的相位延迟对应的计数值：PhaseCount = APRD * (PhaseShift / 360)。例如，30%相位偏移，PhaseCount = APRD * 0.3。
   • 将PhaseCount写入eCAP2的CTRPHS（计数器相位偏移值寄存器）。
3. 工作原理：当eCAP1的TSCTR到达APRD并复位时，会产生一个SYNCO脉冲。这个脉冲触发eCAP2的同步输入，eCAP2的TSCTR不会复位为0，而是加载CTRPHS寄存器的值。因此，eCAP2的PWM周期将从PhaseCount开始，其输出波形在时间上就滞后于eCAP1一个相位差。

软件同步示例：输入材料中提到的ecap_ex3_apwm_phase_shift.c示例程序正是实现了这一功能。它通过宏定义设置频率、占空比和相位差，初始化两个eCAP模块，并利用同步机制产生相位差固定的双路PWM。在实际项目中，我常用这种方法为三相逆变器生成六路PWM，其中三路由ePWM模块产生，另外三路互补信号则由eCAP模块在APWM模式下生成，并通过同步确保所有通道的严格对齐。

5. 从寄存器到代码：eCAP模块驱动开发实战

理解了原理和模式，最终要落地到代码。TI提供了DriverLib库和示例，但理解寄存器级的操作能让你更灵活地应对复杂需求。下面，我将以差值时间戳双沿捕获模式和APWM模式生成带相移的PWM为例，拆解关键配置步骤和代码片段。

5.1 差值时间戳双沿捕获配置详解

假设我们需要用eCAP1测量一个外部PWM信号的频率和占空比，采用功能最全的差值时间戳双沿模式。

步骤1：GPIO引脚初始化首先，将对应的GPIO引脚（例如GPIO16）配置为eCAP输入功能。需要解除该引脚的GPIO功能，并将其映射到eCAP模块。

// 假设使用GPIO16作为eCAP1输入 GPIO_setPinConfig(GPIO_16_ECAP1); // 将引脚功能切换到ECAP1 GPIO_setDirectionMode(16, GPIO_DIR_MODE_IN); // 设置为输入（虽然复用后自动管理，但明确设置是好习惯）

步骤2：eCAP模块初始化与关键寄存器配置这是核心部分，需要仔细设置控制寄存器。

// 停止eCAP计数器，确保安全配置 ECAP_stopCounter(ECAP1_BASE); ECAP_disableInterrupt(ECAP1_BASE, ECAP_INT_ALL); // 关闭所有中断 // 1. 配置操作模式：捕获模式，连续运行，4事件回绕 ECAP_setCaptureMode(ECAP1_BASE, ECAP_CONTINUOUS_CAPTURE_MODE); // CONT_ONESHT=0 ECAP_setCaptureModeWrap(ECAP1_BASE, ECAP_EVENT4); // STOP_WRAP=3 (4 events) // 2. 配置事件极性：CAP1上升沿，CAP2下降沿，CAP3上升沿，CAP4下降沿 ECAP_setEventPolarity(ECAP1_BASE, ECAP_EVENT1, ECAP_EV_POL_RISING); // CAP1POL=0 ECAP_setEventPolarity(ECAP1_BASE, ECAP_EVENT2, ECAP_EV_POL_FALLING); // CAP2POL=1 ECAP_setEventPolarity(ECAP1_BASE, ECAP_EVENT3, ECAP_EV_POL_RISING); // CAP3POL=0 ECAP_setEventPolarity(ECAP1_BASE, ECAP_EVENT4, ECAP_EV_POL_FALLING); // CAP4POL=1 // 3. 配置计数器复位模式：在事件1和事件3（上升沿）后复位TSCTR // 这样，CAP2存高电平时间，CAP3存低电平时间 ECAP_enableCounterResetOnEvent(ECAP1_BASE, ECAP_EVENT1); // CTRRST1=1 ECAP_disableCounterResetOnEvent(ECAP1_BASE, ECAP_EVENT2);// CTRRST2=0 ECAP_enableCounterResetOnEvent(ECAP1_BASE, ECAP_EVENT3); // CTRRST3=1 ECAP_disableCounterResetOnEvent(ECAP1_BASE, ECAP_EVENT4);// CTRRST4=0 // 4. 使能捕获寄存器加载 ECAP_enableCaptureLoad(ECAP1_BASE); // CAPLDEN=1 // 5. 配置事件滤波器（可选，用于抗噪声） // 假设系统时钟200MHz，我们希望滤除宽度小于50ns的毛刺 // 预分频值 = 毛刺宽度 / 系统时钟周期 = 50ns / 5ns = 10个周期 // 查找手册，PRESCALE=5对应除以10 ECAP_setEventPrescale(ECAP1_BASE, 5); // 6. 清除可能存在的旧中断标志 ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_ALL); // 7. 使能中断（例如，在4个事件都捕获完成后产生中断） ECAP_enableInterrupt(ECAP1_BASE, ECAP_INT_CEVT4); // 使能CEVT4中断 // 8. 启动计数器 ECAP_startCounter(ECAP1_BASE);

步骤3：中断服务程序（ISR）数据处理当4个事件（一个完整周期：上升、下降、上升、下降）捕获完成后，进入中断。

__interrupt void ecap1ISR(void) { uint32_t high_time, low_time, period; float duty_cycle; // 读取捕获值。注意：在差值模式下，这些值直接就是时间差（计数值） high_time = ECAP_getEventTimeStamp(ECAP1_BASE, ECAP_EVENT2); // CAP2: 高电平时间 low_time = ECAP_getEventTimeStamp(ECAP1_BASE, ECAP_EVENT3); // CAP3: 低电平时间 // 计算周期和占空比 period = high_time + low_time; // 周期 = 高电平时间 + 低电平时间 if(period != 0) { duty_cycle = ((float)high_time / (float)period) * 100.0f; // 占空比百分比 } else { duty_cycle = 0.0f; // 避免除零错误 } // 将period和duty_cycle存入全局变量，供主循环使用 g_measured_period = period; g_measured_duty = duty_cycle; // 检查计数器溢出标志（重要！） if(ECAP_getInterruptStatus(ECAP1_BASE) & ECAP_INT_CTROVF) { // 处理信号丢失或频率过低的情况 handleSignalLoss(); ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_CTROVF); } // 清除已处理的中断标志 ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_CEVT4); // 中断应答 Interrupt_clearACKGroup(INTERRUPT_ACK_GROUP7); }

5.2 APWM模式与相移PWM生成代码实现

接下来，我们实现eCAP1和eCAP2输出同频同占空比，但eCAP2滞后eCAP1 90度（25%周期）相移的PWM。

步骤1：系统时钟与PWM参数计算假设系统时钟SYSCLK = 200MHz，我们需要生成一个10kHz的PWM，占空比50%。

#define PWM_FREQ_HZ 10000.0f #define SYS_CLK_HZ 200000000.0f #define PWM_DUTY 0.5f #define PHASE_SHIFT 0.25f // 90度相位差，即25%周期 uint32_t period_count = (uint32_t)(SYS_CLK_HZ / PWM_FREQ_HZ); // APRD uint32_t compare_count = (uint32_t)(period_count * PWM_DUTY); // ACMP uint32_t phase_count = (uint32_t)(period_count * PHASE_SHIFT); // CTRPHS for eCAP2

步骤2：主模块（eCAP1）配置

// 初始化GPIO为eCAP输出 (例如 GPIO5) GPIO_setPinConfig(GPIO_5_ECAP1); GPIO_setDirectionMode(5, GPIO_DIR_MODE_OUT); // 配置eCAP1为APWM模式 ECAP_stopCounter(ECAP1_BASE); ECAP_disableInterrupt(ECAP1_BASE, ECAP_INT_ALL); ECAP_setAPWMPolarity(ECAP1_BASE, ECAP_ACTIVE_HIGH); // APWMPOL=0，高有效 ECAP_setCounterCompareValue(ECAP1_BASE, compare_count); // 写入活动比较寄存器CAP2 ECAP_setCounterPeriodValue(ECAP1_BASE, period_count); // 写入活动周期寄存器CAP1 // 注意：DriverLib的set函数通常直接写入活动寄存器，影子寄存器会自动加载初始值。 // 配置同步输出：选择CTR=PRD作为同步源，这样每个周期开始都发出同步脉冲 ECAP_setSyncOutSignal(ECAP1_BASE, ECAP_SYNC_OUT_SEL_CTR_PRD); // 启动计数器 ECAP_startCounter(ECAP1_BASE);

步骤3：从模块（eCAP2）配置

// 初始化GPIO为eCAP输出 (例如 GPIO6) GPIO_setPinConfig(GPIO_6_ECAP2); GPIO_setDirectionMode(6, GPIO_DIR_MODE_OUT); // 配置eCAP2为APWM模式 ECAP_stopCounter(ECAP2_BASE); ECAP_disableInterrupt(ECAP2_BASE, ECAP_INT_ALL); ECAP_setAPWMPolarity(ECAP2_BASE, ECAP_ACTIVE_HIGH); ECAP_setCounterCompareValue(ECAP2_BASE, compare_count); ECAP_setCounterPeriodValue(ECAP2_BASE, period_count); // 关键：配置同步输入和相位偏移 ECAP_enableCounterResetOnSyncIn(ECAP2_BASE); // SYNCI_EN=1，使能同步输入 // 设置同步源为eCAP1的同步输出。这通常通过输入选择寄存器或全局同步模块配置。 // 假设使用SYNCIN信号，具体配置取决于芯片的同步网络。 // 例如，可能需要配置ECAPSYNCINSEL寄存器，或使用其他同步外设。 configureSyncNetwork(ECAP2_BASE, SYNC_SRC_ECAP1); // 伪代码，需查阅具体手册 // 设置相位偏移值 ECAP_setCounterPhaseValue(ECAP2_BASE, phase_count); // 写入CTRPHS寄存器 // 启动计数器。注意：eCAP2的计数器将等待eCAP1的同步信号才开始有效计数。 ECAP_startCounter(ECAP2_BASE);

关键点提示：在实际的TMS320F280015x芯片上，同步信号的路径可能需要通过ECAPSYNCINSEL寄存器或芯片特定的同步模块（如SYSCLK）来配置。你需要仔细查阅数据手册中关于“Synchronization”的章节，确定eCAP1的SYNCO输出具体连接到哪个同步总线，以及eCAP2如何选择这个总线作为其SYNCI输入。这是实现硬件同步最易出错的一步。

6. 常见问题、调试技巧与性能优化

即使理解了原理和配置，在实际项目中调试eCAP模块时，依然会遇到各种问题。下面分享一些我踩过的坑和总结的调试技巧。

6.1 典型问题排查清单

6.2 性能优化与高级技巧

1. 减少CPU开销：使用DMA配合eCAP在高速连续捕获场景（如解码高频编码器），频繁的中断会消耗大量CPU资源。此时，可以将eCAP模块配置为在捕获事件时触发DMA。DMA控制器能够自动将CAP1-CAP4寄存器的值搬运到指定的内存缓冲区中，完全不需要CPU介入。你只需要在缓冲区半满或全满时，产生一个DMA中断来处理一批数据，极大提升了系统效率。

2. 提高测量精度：注意时钟同步域TMS320F280015x的eCAP模块可能运行在高速时钟域（如HRPWM时钟）。在读取TSCTR或CAPx寄存器时，如果CPU时钟与eCAP时钟不同步，可能需要插入等待周期或使用特殊的读取序列。手册中关于“HR mode”的备注提示了这一点。在非HR模式下，通常没有问题，但在高精度应用中，建议查阅芯片勘误表和应用笔记，确认是否存在读取同步问题。

3. 抗噪声设计：合理使用事件滤波器输入信号可能带有毛刺。eCAP的事件滤波器是一个数字防抖电路，它要求信号边沿稳定持续N个同步时钟周期（N由PRESCALE决定）才被认定为有效事件。根据你的信号特性和系统时钟，计算一个合适的预分频值。例如，要滤除宽度小于20ns的毛刺，系统时钟5ns，则至少需要20ns / 5ns = 4个周期，选择PRESCALE为2（除以4）或3（除以6）。但注意，滤波器也会引入微小延迟，并限制了可测量的最高信号频率。

4. 灵活的事件控制：单次模式与重装CONT_ONESHT位设置为1时，eCAP工作于单次模式。在捕获完STOP_WRAP指定数量的事件后，Mod4计数器和捕获加载会停止。这对于捕获特定数量的脉冲（如只捕获一个完整周期）非常有用。之后，可以通过软件设置REARM位来重新启动捕获序列，实现受控的、确定性的数据采集。

5. APWM模式下的动态更新在APWM模式下，要动态改变PWM频率或占空比，必须写入影子寄存器CAP3（周期）和CAP4（比较）。硬件会在下一个PWM周期开始时，自动将影子寄存器的值加载到活动寄存器CAP1和CAP2，从而实现无毛刺、平滑的PWM参数更新。直接写入活动寄存器可能导致当前周期波形异常。

调试时，善用CCS的寄存器查看器和实时变量观察窗口，监控TSCTR、CAPx、ECFLG等关键寄存器的变化。结合示波器观察输入输出波形，能快速定位是配置问题、信号问题还是软件处理逻辑问题。eCAP模块一旦正确配置，其硬件工作的稳定性和精确性是软件无法比拟的，它能成为你实时控制系统中一个可靠且强大的“时序管家”。