首页/资讯中心/详情

深入解析eCAP模块：从高精度捕获到安全监控的嵌入式实战

深入解析eCAP模块：从高精度捕获到安全监控的嵌入式实战
📅 发布时间：2026/7/26 15:09:57

1. 从事件捕获到PWM生成：eCAP模块的深度解析与应用实战

在嵌入式系统，尤其是数字电源和电机控制这类对时序精度要求严苛的领域，我们常常需要做两件看似相反却又紧密相关的事：一是“感知”外部世界的变化，精确记录某个信号边沿到来的瞬间；二是“控制”外部世界，输出精准的脉冲波形去驱动开关管或电机。传统上，这通常需要两个独立的硬件模块：一个捕获单元和一个PWM发生器。但德州仪器（TI）在其C2000系列以及像AM261x这样的高性能处理器中，将这两者巧妙地融合在了一起，这就是增强型捕获（eCAP）模块。

我最初接触eCAP是在一个无刷直流电机（BLDC）的测速与换相项目中。我需要用霍尔传感器捕获转子位置，同时还要用PWM控制电机转速。如果分开使用捕获模块和PWM模块，不仅占用更多硬件资源，两者之间的同步也是个麻烦事。eCAP模块的出现，让我可以用同一个硬件资源，在电机启动阶段用于捕获霍尔信号计算转速，在稳定运行后切换为PWM模式驱动电机，实现了硬件资源的动态复用，设计变得异常优雅。

简单来说，eCAP模块是一个“能文能武”的多面手。在捕获模式下，它是一个高精度的“秒表”，能以外部信号边沿为触发，记录下此刻内部高精度计数器的值，从而计算出信号的周期、占空比或事件间隔，精度可达5纳秒（在200MHz系统时钟下）。在APWM（辅助PWM）模式下，它摇身一变，成为一个独立的、32位分辨率的PWM发生器，可以输出占空比和频率极其精准的波形。更厉害的是，其内置的信号监控单元，能像一名尽职的“哨兵”，实时检查输入信号的脉冲宽度或周期是否在预设的安全范围内，一旦异常立即报警，这对于功能安全要求高的电源和驱动系统至关重要。

本文将带你深入AM261x的eCAP模块内部，不仅拆解其工作原理，更会结合我实际调试中的经验，分享从基础配置到高级应用（如信号监控）的实战代码与避坑指南。无论你是正在评估该模块的架构师，还是苦于调试的工程师，相信都能从中找到需要的干货。

2. eCAP模块架构与核心资源拆解

理解eCAP，首先要把它看成一个完整的、可复用的“通道”。在AM261x中，有多达8个这样的独立通道。每个通道都拥有以下核心资源，构成了其强大功能的基石：

2.1 核心资源全景图

一个eCAP通道的硬件架构，可以想象成一个高度可配置的信号处理流水线。外部信号从左边流入，经过一系列处理，最终可能产生中断、触发DMA，或者在APWM模式下从右边输出。其核心资源包括：

  1. 灵活的输入前端（256:1输入多路复用器）：这是eCAP模块强大灵活性的起点。它不是一个简单的GPIO输入，而是一个可以从256个内部信号源中选择其一的超级开关。这些信号源包括：

    • 所有ePWM模块的SOC（Start-Of-Conversion）信号：这使得eCAP可以精确捕获其他PWM模块产生的特定事件时刻，实现模块间硬同步。
    • 比较器（CMPSS）的输出：常用于峰值电流控制，eCAP可以捕获电流超过阈值的精确时刻。
    • 输入交叉开关（INPUTXBAR）的输出：可以将任意GPIO配置的信号引入eCAP。
    • ADC的触发事件：甚至可以直接捕获ADC转换完成的事件。 通过配置ECCTL0.INPUTSEL寄存器，你可以将eCAP通道连接到这256个源中的任何一个。这意味着，eCAP不仅可以捕获外部引脚信号，还能捕获芯片内部各种复杂事件的时刻，为系统级调试和联动控制提供了极大便利。

  2. 32位时间基准计数器（TSCTR）：这是整个模块的“心脏”，是一个由系统时钟（SYSCLK）驱动的32位向上计数器。在捕获模式下，它的值就是“当前时间”；在APWM模式下，它用于生成PWM的时基。其计数频率直接决定了时间分辨率，在200MHz时钟下，每个计数周期是5ns，为高精度测量奠定了基础。

  3. 四事件时间戳寄存器（CAP1-CAP4）：这是捕获模式下的“记忆单元”。当预设的事件（如信号边沿）发生时，当前TSCTR的值会被“冻结”并存入这四个32位寄存器中的一个。你可以配置捕获1到4个连续事件的时间戳。在APWM模式下，CAP1和CAP2被重新定义为活动周期寄存器（APRD）和活动比较寄存器（ACMP），而CAP3和CAP4则成为它们的影子寄存器，用于实现PWM参数的无毛刺更新。

  4. 四级序列器（模4计数器）与边沿极性选择：这是一个智能的“调度员”。它是一个2位计数器（0->1->2->3->0...），由捕获事件驱动。你可以为CAP1-CAP4这四个捕获事件独立选择是捕获上升沿还是下降沿。序列器按顺序工作：第一个配置的事件触发CAP1捕获，第二个触发CAP2，依此类推。这允许你进行复杂的测量，例如，用CAP1捕获上升沿，CAP2捕获随后的下降沿，从而直接得到一个脉冲的高电平宽度。

  5. 连续/单次（One-Shot）控制逻辑：这是捕获过程的“控制器”。你可以选择让模块在捕获1到4个事件后自动停止（单次模式），非常适合单次触发测量；或者让它在四个寄存器中循环覆盖写入（连续模式），构成一个四深度环形缓冲区，用于持续监控信号。

  6. 信号监控单元（MUNIT）：这是Type 3 eCAP新增的“安全卫士”。它能够持续监测输入信号的脉冲宽度（高电平或低电平）和周期（上升沿到上升沿或下降沿到下降沿），并判断其是否在用户预设的[MIN, MAX]范围内。一旦超出范围，立即产生错误事件，可以连接到系统的错误联动逻辑，实现硬件级的快速保护。

  7. 丰富的触发与同步输出：模块可以产生中断（CAP_INT）和DMA请求（DMA_INT），方便CPU处理数据或由DMA自动搬运捕获的时间戳。它还能产生ADC启动转换（SOC_EVT）信号，以及在APWM模式下产生DMA事件。同步输入（SYNC_IN）和输出（SYNC_OUT）则允许多个eCAP模块之间，或eCAP与ePWM模块之间进行时间基准同步。

2.2 Type 3 eCAP的关键增强特性

AM261x的eCAP属于Type 3，相较于早期版本，有几个关键增强点，直接影响我们的应用设计：

  • 信号监控单元：如前所述，这是实现高可靠性系统的关键硬件支持。
  • 输入选择从128路扩展到256路：提供了更丰富的内部信号连接可能性。
  • APWM模式下的DMA事件生成：在PWM输出模式下也能触发DMA，拓展了应用场景。
  • 独立的同步输入选择寄存器（ECAPxSYNCINSEL）：每个eCAP通道都可以独立选择自己的同步源，同步策略更加灵活。

3. 捕获模式深度配置与实战应用

捕获模式是eCAP的“本职工作”，其核心目标是精确记录事件发生的时刻。下面我们以一个具体的例子——测量一个方波信号的周期和占空比——来详解配置流程和注意事项。

3.1 应用场景与配置思路

假设我们需要测量一个来自GPIO、频率约10kHz的方波信号。我们计划用CAP1捕获上升沿，CAP2捕获随后的下降沿，CAP3捕获下一个上升沿。这样，通过计算CAP2 - CAP1得到高电平时间，计算CAP3 - CAP1得到整个信号周期。

配置步骤分解：

  1. GPIO与输入路径配置：

    • 将对应的GPIO引脚配置为eCAP输入功能。
    • 通过INPUTXBAR，将该GPIO连接到一个内部信号线，例如INPUTXBAR.OUT1。
    • 在eCAP模块中，设置ECCTL0.INPUTSEL = 203（对应INPUTXBAR.OUT1，参见数据手册表7-190）。

    注意：GPIO输入通常有数字滤波器（输入限定）。为了绝对精度，可以将其设置为异步模式，但这可能引入噪声。如果信号有毛刺，使用同步模式（例如6个采样周期滤波）可以提高抗扰度，但会引入±2个SYSCLK周期的固定延迟。在计算时间差时，如果两个边沿使用相同的滤波设置，这个延迟会在做差时被抵消，但绝对时间戳会有偏移。

  2. 事件预分频器（Prescaler）与毛刺滤波器（Glitch Filter）配置：

    • 对于10kHz信号（周期100us），200MHz时钟下一个周期有20000个时钟周期，远未达到计数器溢出风险，因此预分频器可以旁路（ECCTL1.PRESCALE = 0）。
    • 如果信号环境嘈杂，可以启用毛刺滤波器。例如，设置ECCTL0.QUALPRD = 5，表示只有持续超过5个SYSCLK周期的脉冲才被认为是有效边沿。这能滤除窄毛刺，但同样会引入固定延迟。

  3. 工作模式与边沿极性配置：

    • 我们计划捕获3个事件后停止，因此设置为单次（One-Shot）模式：ECCTL2.CONT/ONESHT = 0(One-Shot)。
    • 设置停止值（Stop Wrap）为2（因为我们要捕获第0，1，2个事件，到第3个事件时停止？这里需要理解：模4计数器从0开始，捕获事件使其递增。STOP_WRAP设置为2，意味着当计数器等于2时，再发生一个捕获事件（使计数器变为3）后，模块会停止。所以为了捕获CAP1, CAP2, CAP3，我们需要STOP_WRAP = 3？不，更准确的理解是：STOP_WRAP定义了在哪个事件后停止。如果设为n，则会在第n+1个事件后停止。想捕获3个事件，应设STOP_WRAP = 2。捕获事件序列：CEVT1 -> CAP1 (CTR=0), CEVT2 -> CAP2 (CTR=1), CEVT3 -> CAP3 (CTR=2)，此时CTR等于STOP_WRAP(2)，模块在本次加载后停止。所以配置ECCTL2.STOP_WRAP = 2。
    • 配置边沿极性：我们希望CAP1=上升沿，CAP2=下降沿，CAP3=上升沿。
      • ECCTL1.CAP1POL = 0(Rising edge)
      • ECCTL1.CAP2POL = 1(Falling edge)
      • ECCTL1.CAP3POL = 0(Rising edge)
      • ECCTL1.CAP4POL无关，可忽略。
    • 使能CAP1, CAP2, CAP3的捕获加载：ECCTL1.CAPLDEN = 1。CAP4可以禁用。

  4. 计数器模式配置：

    • 为了测量时间差，我们希望每次捕获后，计数器不清零，这样CAP1, CAP2, CAP3存储的是事件的绝对时间戳。设置ECCTL1.CTRRST1 = 0,CTRRST2 = 0,CTRRST3 = 0（不在事件后复位计数器）。
    • 计数器相位控制通常不需要，ECCTL2.SYNCI_EN = 0（禁用同步输入）。

  5. 中断与启动：

    • 我们可以在第三个事件（CEVT3）时触发中断，通知CPU读取数据。设置ECCTL2.CEVT3FRC = 0(由硬件事件触发),ECCTL2.CEVT3SEL = CEVT3。
    • 使能eCAP模块中断。
    • 最后，武装（Arm）模块：ECCTL2.REARM = 1。这个操作会清零模4计数器，并使能捕获寄存器加载。模块开始等待第一个边沿。

3.2 实操代码示例与关键寄存器分析

以下是一个基于TI Driverlib库函数的简化配置示例（概念性代码）：

#include "driverlib.h" void configureECAPForPulseMeasurement(uint32_t base) { // 1. 使能eCAP模块时钟（假设已配置） // 2. 配置GPIO和INPUTXBAR（此处省略，需根据具体板卡连接） // 3. 停止并初始化eCAP模块 ECAP_disableCapture(base); ECAP_setCaptureMode(base, ECAP_CONTINUOUS_CAPTURE_MODE); // 先设为连续模式配置 ECAP_setStopWrap(base, ECAP_STOP_WRAP_CAPTURE_EVENT3); // 在第三个事件后停止 (CAP3) ECAP_setCaptureMode(base, ECAP_ONE_SHOT_CAPTURE_MODE); // 设为单次模式 // 4. 配置输入信号源 (假设通过INPUTXBAR.OUT1连接) ECAP_selectInputSignal(base, 203); // INPUTSEL = 203 // 5. 配置事件预分频和毛刺滤波（旁路） ECAP_setEventPrescaler(base, 1); // 1 = 旁路 ECAP_setEventFilterCount(base, 0); // 禁用毛刺滤波器 // 6. 配置边沿极性 ECAP_setEventPolarity(base, ECAP_EVENT1, ECAP_EVENT_POLARITY_RISING); ECAP_setEventPolarity(base, ECAP_EVENT2, ECAP_EVENT_POLARITY_FALLING); ECAP_setEventPolarity(base, ECAP_EVENT3, ECAP_EVENT_POLARITY_RISING); ECAP_disableCaptureEvent(base, ECAP_EVENT4); // 禁用第四个事件 // 7. 配置计数器行为（绝对模式，不复位） ECAP_enableCounterResetOnEvent(base, ECAP_EVENT1, false); ECAP_enableCounterResetOnEvent(base, ECAP_EVENT2, false); ECAP_enableCounterResetOnEvent(base, ECAP_EVENT3, false); // 8. 使能捕获寄存器加载 ECAP_enableCapture(base); // 9. 配置中断（在第三个事件触发） ECAP_clearInterrupt(base, ECAP_INT_EVENT3); ECAP_enableInterrupt(base, ECAP_INT_EVENT3); ECAP_setInterruptSource(base, ECAP_INT_EVENT3); // 10. 武装模块，开始捕获 ECAP_arm(base); } // 中断服务例程 void ECAP_ISR(void) { uint32_t base = ECAP1_BASE; // 假设是ECAP1 uint32_t status = ECAP_getInterruptStatus(base); if (status & ECAP_INT_EVENT3) { // 读取三个时间戳 uint32_t cap1 = ECAP_getCaptureEventTimeStamp(base, ECAP_EVENT1); uint32_t cap2 = ECAP_getCaptureEventTimeStamp(base, ECAP_EVENT2); uint32_t cap3 = ECAP_getCaptureEventTimeStamp(base, ECAP_EVENT3); // 计算高电平时间和周期（单位：时钟周期数） uint32_t high_time_ticks = cap2 - cap1; // 注意处理计数器溢出，但32位计数器在100us内不会溢出 uint32_t period_ticks = cap3 - cap1; // 转换为时间（假设200MHz时钟，5ns每周期） float high_time_us = (high_time_ticks * 5.0f) / 1000.0f; float period_us = (period_ticks * 5.0f) / 1000.0f; float duty_cycle = (float)high_time_ticks / (float)period_ticks * 100.0f; // 处理数据... // ... // 清除中断标志，并重新武装以进行下一次测量（如果需要连续测量，应切回连续模式） ECAP_clearInterrupt(base, ECAP_INT_EVENT3); ECAP_arm(base); // 重新武装，准备下一次单次捕获 } }

3.3 捕获模式下的高级功能：DMA与ADC触发

在需要高频、连续捕获的应用中（如高频信号分析），让CPU频繁进入中断读取数据会成为瓶颈。Type 1及以上的eCAP模块支持DMA触发。

  • DMA触发：你可以配置任何一个捕获事件（CEVT1-4）作为DMA触发源（ECCTL2.DMAEVTSEL）。当该事件发生时，eCAP模块会自动向DMA控制器发出请求。你可以将DMA配置为从CAP1-CAP4寄存器（具体哪个由软件指定地址）自动将时间戳数据搬运到指定的内存缓冲区中。这样，CPU只需在缓冲区半满或全满时处理一批数据，极大降低了中断频率和CPU负载。

  • ADC SOC事件：Type 3 eCAP新增的功能。你可以在捕获模式下，选择任何一个捕获事件来触发ADC开始转换（ECCCTL0.SOCEVTSEL）。这在需要严格同步数据采集和外部事件的系统中非常有用。例如，你可以用eCAP捕获一个传感器的脉冲边沿，并立即触发ADC对该传感器的模拟输出进行采样，确保采样的时刻与事件严格对齐。

4. APWM模式：将捕获器变为精准PWM发生器

当你的应用不需要捕获功能时，eCAP模块可以无缝切换为一个全功能的、32位分辨率的PWM发生器，即APWM模式。这对于需要额外PWM通道，或者需要与捕获功能分时复用同一硬件的场景非常经济。

4.1 APWM模式工作原理

在APWM模式下，eCAP的内部资源被重新映射：

  • TSCTR计数器：工作在递增模式，从0计数到周期值（PERIOD），然后归零，循环往复。这就是PWM的时基。
  • CAP1寄存器：变为活动周期寄存器（APRD），定义PWM的周期。
  • CAP2寄存器：变为活动比较寄存器（ACMP），定义PWM输出翻转的时刻，从而决定占空比。
  • CAP3和CAP4寄存器：分别变为APRD和ACMP的影子寄存器。这是实现PWM参数无毛刺（Glitch-free）更新的关键。

APWM的输出逻辑很简单：当TSCTR < ACMP时，输出有效电平（高有效或低有效）；当TSCTR >= ACMP时，输出无效电平。当TSCTR达到APRD并归零时，开始一个新的周期。

4.2 影子寄存器机制与无毛刺更新

在电机控制或数字电源中，我们经常需要在运行中改变PWM的占空比或频率。如果直接写入正在使用的活动寄存器（ACMP或APRD），可能会在计数器正在与该值比较的瞬间发生写入，导致当前周期输出产生一个异常的窄脉冲或宽脉冲，即“毛刺”。影子寄存器机制就是为了解决这个问题。

工作流程如下：

  1. 初始化时，直接写入CAP1（APRD）和CAP2（ACMP）来设置初始周期和比较值。注意：此时写入CAP1/CAP2，值会同时拷贝到其影子寄存器CAP3/CAP4。
  2. 在运行中需要更新参数时，只写入影子寄存器CAP3（新周期值）或CAP4（新比较值）。
  3. 硬件会在一个安全的时刻——通常是当前PWM周期结束（TSCTR = APRD）时——自动将影子寄存器的值加载到活动寄存器中。这个加载动作由ECCTL2.SHDWAMODE和ECCTL2.SHDWBMODE位控制，可以配置为立即加载或周期加载。

配置示例：生成一个频率1kHz，占空比50%的PWM（假设系统时钟200MHz）

void configureECAPasAPWM(uint32_t base) { // 1. 确保eCAP模块被禁用 ECAP_disableCapture(base); // 2. 切换到APWM模式 ECAP_setAPWMMode(base, ECAP_APWM_ACTIVE_HIGH); // 高有效模式 // 3. 配置时基计数器模式（递增模式，这是APWM默认且唯一模式） // 通常APWM模式下，计数器模式是固定的，无需额外设置。 // 4. 计算并设置PWM周期和比较值 // 系统时钟频率：200MHz = 200,000,000 Hz // 期望PWM频率：1kHz = 1,000 Hz // 周期计数值 = 系统时钟频率 / PWM频率 = 200,000,000 / 1,000 = 200,000 // 占空比50%，则比较值 = 周期值 * 占空比 = 200,000 * 0.5 = 100,000 uint32_t period = 200000; uint32_t cmp = 100000; // 5. 初始化：写入活动寄存器（同时会拷贝到影子寄存器） ECAP_setAPWMPeriod(base, period); // 写CAP1 ECAP_setAPWMCompare(base, cmp); // 写CAP2 // 6. 配置影子加载模式：在周期点加载（推荐，避免毛刺） ECAP_setShadowLoadMode(base, ECAP_SHADOW_LOAD_MODE_PERIOD); // 7. 使能APWM输出（注意：配置OUTPUTXBAR，将eCAP输出连接到具体引脚） // 这一步强烈建议在所有寄存器配置完成后进行，避免输出引脚出现配置过程中的毛刺。 // configureOutputXBarForECAP(base); // 伪代码，需根据具体芯片手册配置 // 8. 启动计数器 ECAP_startCounter(base); } // 运行时动态更新占空比到75% void updateAPWMDutyCycle(uint32_t base, uint32_t period, float duty) { uint32_t new_cmp = (uint32_t)(period * duty); // 写入影子寄存器CAP4（ACMP的影子） HWREG(base + ECAP_O_CAP4) = new_cmp; // 直接操作寄存器，或使用库函数 // 硬件会在下一个PWM周期开始时，自动将CAP4的值加载到CAP2(ACMP) }

关键注意事项：

  1. 输出使能时机：数据手册特别强调，在APWM模式下，一旦配置生效，输出就会开始。因此，务必在完成所有内部配置（周期、比较值、极性等）之后，再通过OUTPUTXBAR将内部eCAP输出信号连接到具体的GPIO引脚。否则，在配置过程中输出端可能会出现不可控的脉冲。
  2. 影子更新时机：确保在一个PWM周期内完成对影子寄存器的写入。如果你在周期中途写入，而这个写入操作跨越了周期边界，可能会导致加载了错误的值。一种稳健的做法是在PWM周期中断（如果使能了）中更新影子寄存器。
  3. 极性理解：APWMPOL位控制有效电平。0为高有效（CMP值内输出高）；1为低有效（CMP值内输出低）。特别注意边界情况：当CMP=0时，高有效模式输出恒低（0%占空比），低有效模式输出恒高（0%占空比）。当CMP >= PERIOD时，高有效模式输出恒高（100%占空比），低有效模式输出恒低（100%占空比）。

5. 信号监控单元：硬件级的守护者

信号监控单元（MUNIT）是Type 3 eCAP的王牌功能之一，它实现了硬件级的信号完整性检查，无需CPU干预，响应速度极快，非常适合功能安全（Functional Safety）应用。

5.1 脉冲宽度与周期监控

工作原理：MUNIT利用eCAP的捕获功能，连续测量输入信号的脉冲宽度（高电平或低电平持续时间）或信号周期。你需要预先设置一个允许的最小值（MIN）和最大值（MAX）（单位是TSCTR的时钟周期数）。MUNIT会在每次测量后，自动将结果与[MIN, MAX]范围比较。

  • 如果测量值 < MIN：触发MUNIT_ERROR_EVT1。
  • 如果测量值 > MAX：触发MUNIT_ERROR_EVT2。

这些错误事件可以连接到芯片的Error Signaling Module或其他安全逻辑，直接触发保护动作（如关闭PWM输出），实现纳秒级的故障响应。

配置要点：

  1. 计数器模式：必须设置为绝对模式（ECCTL1.CTRRSTx = 0），即计数器自由运行，不在捕获事件后复位。因为我们需要测量的是连续事件之间的绝对时间差。
  2. 捕获模式：推荐使用连续模式，以实现持续监控。
  3. 捕获边沿：根据你要监控的内容配置：
    • 高脉冲宽度：CAP1配置为上升沿，CAP2配置为下降沿。
    • 低脉冲宽度：CAP1配置为下降沿，CAP2配置为上升沿。
    • 周期（上升沿到上升沿）：CAP1和CAP2均配置为上升沿。
    • 周期（下降沿到下降沿）：CAP1和CAP2均配置为下降沿。
  4. MIN/MAX寄存器设置：根据系统允许的信号范围，计算出对应的TSCTR计数值并写入MUNIT_MIN和MUNIT_MAX寄存器。例如，要求PWM高电平时间在4.5us到5.5us之间，系统时钟5ns，则MIN = 4500ns / 5ns = 900，MAX = 5500ns / 5ns = 1100。
  5. 错误处理：使能MUNIT错误事件，并将其映射到相应的错误输出或中断。

5.2 边沿监控

工作原理：边沿监控用于检查预期的边沿是否在一个指定的时间窗口内出现。它需要与一个同步信号（通常来自一个ePWM模块的同步输出）配合使用。你设置一个时间窗口[MIN, MAX]，MUNIT期望在同步事件之后，目标边沿出现在这个窗口内。

  • 如果边沿在窗口[MIN, MAX]之外出现：触发MUNIT_ERROR_EVT1。
  • 如果在两个同步事件之间，预期的边沿根本没有出现：触发MUNIT_ERROR_EVT2。

应用场景：例如，在电机驱动中，你用ePWM生成驱动波形，并用eCAP监控来自电流采样的过流信号边沿。你期望过流信号在PWM周期内的某个安全窗口之后才可能出现（即电流需要时间上升）。如果过流信号过早出现（< MIN）或始终未出现（在两个PWM同步点之间），都意味着异常。

配置要点：

  1. 同步源：必须使能eCAP计数器同步（ECCTL2.SYNCI_EN = 1），并配置ECAPxSYNCINSEL选择一个ePWM模块的同步输出作为同步源。
  2. 计数器模式：同样需要绝对模式。
  3. MIN/MAX窗口：这个窗口是相对于同步事件的时间。窗口不能跨越同步边界。例如，如果PWM周期是1000个计数，你的MIN/MAX必须都在0-999之间。
  4. 相位偏移：如果ePWM或eCAP计数器有非零的相位偏移（Phase Offset），或者你使能了毛刺滤波器，MIN/MAX值在软件中需要进行相应的补偿，因为硬件监控的是原始的计数器值。

5.3 信号监控实战技巧与避坑指南

  • 精度与延迟权衡：毛刺滤波器（Glitch Filter）和输入同步器（Input Qualifier）会引入固定的延迟。在计算MIN/MAX的预期值时，必须考虑这个延迟。例如，如果使能了6个周期的输入同步，那么实际信号边沿被“看到”的时间晚了6个时钟周期。你设置的MIN/MAX阈值也应该相应地增加6。一个常见的错误是忽略了这一点，导致监控窗口错位。
  • “DISABLE_EARLY_MAX_ERR”位：在脉冲宽度监控中，如果脉冲宽度超过MAX，第二个边沿可能会迟到甚至永远不来。MUNIT_CTL.DISABLE_EARLY_MAX_ERR位决定了何时报告MAX错误。设为0：一旦脉冲宽度超过MAX，立即报错（即使第二个边沿还没来）。设为1：等到第二个边沿到达后，再判断并报错。在安全关键应用中，通常选择0，以实现最快故障响应。
  • 与全局加载选通（GLDSTRB）联动：MUNIT的MIN/MAX寄存器也支持影子寄存器。你可以配置在ePWM的全局加载选通信号到来时，才将影子寄存器的值加载到活动寄存器。这样，你可以安全地在任何时候更新监控阈值，而不会干扰正在进行的监控。
  • 调试建议：在初始调试阶段，先将MIN/MAX范围设得非常宽，确保监控功能本身不会误触发。然后逐步收窄范围。同时，充分利用eCAP的中断和状态标志，在错误发生时，不仅触发硬件保护，也让CPU进入中断记录错误时的计数器值、捕获寄存器值等上下文信息，便于事后分析。

6. 同步策略与多模块协作

在复杂的系统中，多个eCAP模块之间，或者eCAP与ePWM模块之间，往往需要精确的时间同步，以保证测量的相关性和控制的一致性。

6.1 eCAP内部同步

每个eCAP模块都有一个SYNCIN输入和一个SYNCOUT输出。你可以将一个eCAP模块的SYNCOUT连接到另一个eCAP模块的SYNCIN，实现级联同步。当主eCAP的计数器达到周期值（或通过软件强制同步）时，会产生一个同步脉冲，从eCAP模块在收到这个脉冲后，可以将其计数器复位为指定的相位值（通过ECCTL2.SYNCO_SEL和ECCTL2.SYNCI_EN配置）。

典型应用：需要多个eCAP通道在同一绝对时间基准下开始捕获，或者需要它们的APWM输出具有固定的相位差。

6.2 eCAP与ePWM同步

这是更常见的场景。ePWM模块通常作为系统的主时钟源，用于生成功率级的驱动波形。eCAP模块可以同步到某个ePWM模块，用于：

  • 信号监控：如前所述，边沿监控需要ePWM的同步信号来定义时间窗口的起点。
  • 时间对齐的捕获：在电源控制中，你可能希望在ePWM的每个周期起始点，eCAP也开始一个新的捕获序列，确保捕获的数据与PWM周期对齐。
  • APWM模式同步：让多个APWM输出的eCAP通道与主ePWM同步，实现多相交错并联等拓扑。

配置方法是通过ECAPxSYNCINSEL寄存器，选择某个ePWM模块的同步输出（如EPWMxSYNCO）作为本eCAP的同步源。

6.3 软件强制同步

除了硬件同步，还可以通过写ECCTL2.SWSYNC位产生一个软件同步脉冲。这在系统初始化阶段，需要将所有定时器对齐到同一个起始点时非常有用。

同步配置的黄金法则：在启用同步功能（SYNCI_EN=1）之前，务必先配置好同步源（SYNCINSEL）和同步行为（如计数器复位值）。否则，可能会接收到不可预知的同步信号，导致计数器被意外复位。

7. 常见问题排查与调试心得

在实际项目中调试eCAP模块，可能会遇到各种“诡异”的问题。以下是我总结的一些常见故障点和排查思路：

问题1：捕获不到任何事件，中断永不触发。

  • 检查输入路径：这是最常见的问题。确认GPIO已正确复用为eCAP功能，INPUTXBAR配置正确，ECCTL0.INPUTSEL选择了正确的输入源索引。用一个简单的GPIO翻转程序，先确保信号能到达芯片引脚。
  • 检查边沿极性：确认CAPxPOL设置与你输入信号的实际情况匹配。用示波器观察输入信号。
  • 检查毛刺滤波器和预分频器：如果信号频率很低但设置了很大的预分频，或者信号边沿有抖动但滤波器设置过严，可能导致有效边沿被过滤掉。尝试旁路它们（Prescale=1, Qualprd=0）进行测试。
  • 检查模块使能与武装：确认ECCTL2.REARM位已置1。在单次模式下，每次捕获序列完成后都需要重新武装。
  • 检查中断使能与标志：确认已使能eCAP模块级中断和具体的事件中断（CEVTxSEL）。在ISR中读取中断状态寄存器，看是哪个标志位被置起。

问题2：捕获的时间戳值不正确或跳动很大。

  • 时钟源确认：确认eCAP的时钟（SYSCLK）是否稳定，频率是否符合预期。
  • 输入信号质量：用示波器检查输入信号是否有过冲、振铃或毛刺。这些可能导致多次误触发。调整硬件RC滤波或启用eCAP的毛刺滤波器。
  • 计数器溢出：在测量长时间间隔时，确保32位计数器没有溢出。如果可能溢出，需要在中断中处理溢出计数。
  • 同步干扰：如果使能了同步输入，检查是否有意外的同步信号复位了计数器。

问题3：APWM模式输出波形频率或占空比不对。

  • 周期与比较值计算：双检查计算公式。PWM频率 = SYSCLK / (PERIOD + 1)。占空比 =(CMP + 1) / (PERIOD + 1)（对于非100%占空比）。很多错误源于对“+1”的忽略。
  • 影子寄存器模式：确认你更新的是影子寄存器（CAP3/CAP4）而不是活动寄存器（CAP1/CAP2），除非你希望立即更新。检查SHDWAMODE/SHDWBMODE配置是否符合预期。
  • 输出极性：确认APWMPOL设置是否符合你的电路逻辑（高有效驱动还是低有效驱动）。
  • 输出使能顺序：再次强调，先配置好所有eCAP内部参数，最后再通过OUTPUTXBAR接通输出路径。

问题4：信号监控单元误报警或不报警。

  • MIN/MAX值计算错误：务必考虑输入同步和毛刺滤波器带来的延迟，将其计入MIN/MAX值。单位是TSCTR时钟周期，不是纳秒。
  • 计数器模式错误：脉冲宽度/周期监控必须使用绝对模式（不复位）。边沿监控必须使能同步。
  • 时间窗口跨同步边界：边沿监控的[MIN, MAX]窗口必须在两个同步事件之间，不能跨越。
  • DISABLE_EARLY_MAX_ERR设置：根据你的应用需求理解该位的含义。如果你需要检测“脉冲丢失”（第二个边沿一直不来），就不能设置此位为1。

调试心得：

  1. 循序渐进：先用最简单的配置让模块跑起来（例如，仅捕获上升沿，不用滤波，不用分频），生成最基础的PWM。然后再逐步添加复杂功能，如影子加载、同步、信号监控。
  2. 善用寄存器查看工具：在调试器（如Code Composer Studio）中实时观察TSCTR、CAP1-4、ECFLG等关键寄存器的值变化，这是理解模块行为最直接的方式。
  3. 利用强制（Force）功能：eCAP允许软件强制产生捕获事件（CEVTxFRC）或同步事件（SWSYNC）。这在调试序列器逻辑和同步功能时非常有用。
  4. 结合示波器：对于APWM输出和输入捕获信号，示波器是必不可少的。用它来验证实际波形与软件配置是否一致，测量时间参数，观察毛刺。

eCAP模块是一个功能极其丰富的瑞士军刀，从高精度测量到安全监控，再到灵活的PWM生成，它都能胜任。深入理解其架构和工作模式，能让你在嵌入式系统，特别是数字电源和电机控制的设计中，游刃有余，构建出既精准又可靠的解决方案。希望这篇结合了手册原理与实战经验的解析，能成为你手中一把好用的钥匙。