企业官网建设流程全解析

1. eCAP模块：从精准捕获到灵活生成的瑞士军刀

在嵌入式系统，尤其是电力电子和电机控制这类对时序精度要求严苛的领域，我们常常面临两个看似矛盾的核心需求：一是需要像“高速摄像机”一样，精准捕捉外部事件的“瞬间”，比如电机霍尔传感器脉冲的上升沿何时到来，两个脉冲之间到底间隔了多少纳秒；二是需要像一个“精准的指挥家”，能稳定、可编程地输出控制波形，比如驱动MOSFET开关的PWM信号。传统上，这两个任务通常由独立的硬件模块承担——用定时器的输入捕获功能做测量，用另一个PWM模块做输出。但德州仪器（TI）在其C2000、AM系列等微控制器中集成的增强型捕获（eCAP）模块，巧妙地将这两者合二为一，成为了一款功能强大的“瑞士军刀”。

简单来说，eCAP模块的核心价值在于其双重人格：在捕获（Capture）模式下，它是一个高精度的事件计时器；在辅助PWM（APWM）模式下，它摇身一变，成为一个功能完整的单通道PWM发生器。这种设计理念极大地提高了硬件资源的利用率和系统设计的灵活性。想象一下，在一个数字电源项目中，你可以用同一个eCAP模块的捕获功能来监测输出电流的过零时刻，同时用它的APWM模式来生成驱动半桥的互补PWM波，两者之间还能通过内部事件紧密同步，这无疑简化了系统架构，并减少了软件协调的复杂度。

对于从事电机驱动、数字电源、逆变器或任何需要精密时序控制与测量的工程师而言，深入理解eCAP模块的工作机制，是解锁高级控制算法的关键一步。它不仅仅是数据手册里的一堆寄存器描述，更是实现系统高性能、高可靠性的底层基石。接下来，我将结合多年的实战经验，为你层层剥开eCAP的技术内核，从基础原理到高级应用模式，并分享那些在官方手册之外、只有踩过坑才能获得的配置心得和避坑指南。

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

要玩转eCAP，首先得把它当成一个完整的、精密的仪器来理解其内部架构。一个eCAP通道远不止一个计数器加一个输入引脚那么简单，它是一套为高精度时间测量和波形生成而优化的完整子系统。

2.1 模块的核心资源概览

每个独立的eCAP通道都配备了以下关键资源，这些资源共同构成了其强大功能的基础：

1. 灵活的输入前端：这是信号的“入口”。eCAP模块通过一个256:1的输入多路复用器（MUX）来选择捕获源。这个输入源可以是外部GPIO引脚（通过Input X-BAR配置引入），也可以是大量丰富的内部数字信号，例如其他ePWM模块的SOC（Start-of-Conversion）事件、比较器（CMPSS）的跳变输出、甚至ADC的触发事件。这种设计意味着你不仅可以捕获外部物理信号，还能捕获系统内部关键事件的精确时刻，用于复杂的交叉触发逻辑。

2. 32位时间基准计数器（TSCTR）：这是整个模块的“心脏”，是一个由系统时钟（例如200MHz）驱动的32位向上计数器。在200MHz下，其时间分辨率高达5纳秒（ns），为高精度时间戳提供了可能。这个计数器可以工作在自由运行模式（用于绝对时间戳），也可以在特定捕获事件发生时被复位（用于测量时间差）。

3. 四事件时间戳寄存器（CAP1-CAP4）：这是捕获数据的“存储器”。当预设的捕获事件（如信号边沿）发生时，当前TSCTR计数器的值会被“冻结”并存入这四个32位寄存器中的一个。你可以将其配置为单次捕获（捕获1到4个事件后停止）或连续捕获（循环覆盖，形成一个四深的环形缓冲区）。

4. 四级序列器（模4计数器）：这是捕获流程的“指挥家”。它是一个2位计数器（0->1->2->3->0...），与四个捕获事件（CEVT1-CEVT4）一一对应。它决定了下一个捕获事件将把时间戳存入哪个CAP寄存器（CAP1对应CEVT1，以此类推）。通过配置ECCTL2[STOP_WRAP]，你可以控制序列器在捕获指定数量事件后停止（单次模式），或是无限循环（连续模式）。

5. 独立的边沿极性选择：对于四个捕获事件，你可以独立配置其触发边沿是上升沿、下降沿，还是两者都忽略。这为测量脉冲宽度（需要一升一降两个边沿）或特定边沿间隔提供了极大灵活性。

6. 辅助PWM（APWM）发生器：这是模块的“另一面”。当不用于捕获时，CAP1和CAP2寄存器被重新定义为周期（APRD）和比较值（ACMP）寄存器，CAP3和CAP4则作为它们的影子寄存器。结合TSCTR计数器和两个数字比较器，eCAP就能生成占空比和频率均可编程的PWM波形。

7. 信号监控单元（Type 3 eCAP新增）：这是模块的“安全哨兵”。它可以实时监控输入信号的脉冲宽度、周期或边沿出现的时间窗口是否在预设的合理范围内（通过MUNIT_x_MIN和MUNIT_x_MAX寄存器设定）。一旦信号异常（如脉冲丢失、宽度超限），它能立即产生错误事件（ERROR_EVT），甚至可以联动触发ePWM的Trip-zone来关断功率输出，这对于功能安全（Functional Safety）应用至关重要。

8. 丰富的事件输出：模块可以基于捕获事件或APWM事件（周期匹配、比较匹配）产生中断（CAP_INT）、DMA请求（DMA_INT）以及ADC启动转换（SOC）事件。这意味着你可以在不占用CPU的情况下，通过DMA自动搬运捕获的时间戳数据，或者精准地同步ADC采样与PWM开关时刻。

实操心得：理解“影子寄存器”机制在APWM模式下，CAP3/CAP4作为CAP1/CAP2的影子寄存器，是实现PWM参数无毛刺更新的关键。在计数器运行期间，你直接更新的是影子寄存器（CAP3/CAP4）。只有当TSCTR计数器归零（一个PWM周期结束）时，影子寄存器的值才会被同步到活动寄存器（CAP1/CAP2）中，从而在新的周期立即生效。这种“双缓冲”机制确保了PWM波形的连续性和稳定性，避免了在周期中间更新参数可能导致的脉冲畸形或毛刺。初始化时有个小技巧：手册建议先写活动寄存器（CAP1/CAP2），这会自动拷贝到影子寄存器。之后在运行时，为了使用影子加载模式，你应该只更新影子寄存器（CAP3/CAP4）。

2.2 eCAP模块的类型演进

eCAP模块并非一成不变，其功能随着芯片迭代而增强。了解你手头芯片的eCAP类型（Type 0, 1, 2, 3），有助于充分利用其高级特性：

• Type 0：基础功能，包含32位计数器、4个捕获寄存器、连续/单次捕获、APWM模式。
• Type 1：增加了事件滤波器复位位（方便初始化和调试）、模4计数器状态位（可实时读取序列器状态）、专用的DMA触发源（eCAPxDMA），以及128:1输入多路复用器。
• Type 2：在Type 1基础上，为每个eCAP增加了独立的外部同步输入选择寄存器（ECAPxSYNCINSEL），同步灵活性更高。
• Type 3：这是目前功能最丰富的版本，也是本文重点讨论的。它在Type 2基础上，增加了两个独立的信号监控单元，将输入多路复用器从128路扩展到256路，并增加了在APWM模式下生成DMA事件以及在两种模式下都能生成ADC SOC事件的能力。

当你拿到一款新芯片，第一件事就是确认其eCAP模块的类型。这直接决定了你能实现多复杂的安全监控和系统集成功能。

3. 捕获模式深度剖析与实战配置

捕获模式是eCAP的看家本领，其目标就是回答一个问题：“某个事件发生的精确时刻是什么？” 下面我们拆解其工作流程和关键配置。

3.1 捕获信号链：从引脚到寄存器

一个外部信号要成功被捕获并转化为时间戳，需要经过一条精心设计的处理链：

1. 输入选择与调理：

   • 路径选择：通过配置ECCTL0[INPUTSEL]寄存器，从256个可能的信号源中选择一个作为ECAPxIN。这可以是某个GPIO，也可以是内部事件。
   • 抗干扰滤波：信号首先经过一个可编程的毛刺滤波器。你可以设置ECCTL0[QUALPRD]来指定需要连续多少个系统时钟周期的高/低电平才被认为是一个有效的边沿，从而滤除窄脉冲噪声。例如，在200MHz系统时钟下，设置QUALPRD=4，意味着宽度小于20ns的毛刺会被过滤掉。
   • 事件预分频：对于频率非常高的输入信号，eCAP可能来不及处理每个边沿。此时可以启用事件预分频器（ECCTL1[PRESCALE]）。你可以设置分频值N（2到62之间的偶数），这样每N个输入边沿才会产生一个有效的捕获事件给后续逻辑。这相当于对输入信号进行了“降采样”。

2. 边沿检测与序列控制：

   • 经过滤波和分频后的信号，进入边沿极性选择与限定器。你可以为四个捕获事件（CEVT1-CEVT4）分别独立配置触发边沿（上升沿、下降沿）。
   • 模4计数器作为序列器，决定当前哪个捕获事件是“活跃”的。当ECAPxIN信号出现一个符合当前活跃事件边沿设定的跳变时，就会产生一个捕获事件（如CEVT1）。

3. 时间戳锁存与计数器操作：

   • 捕获事件产生后，会生成一个加载（LD）脉冲。这个脉冲做两件事：
     • 锁存时间戳：将当前32位TSCTR计数器的值锁存到对应的CAPx寄存器中（例如，CEVT1对应CAP1）。
     • 可选计数器复位：如果配置了ECCTL1.CTRRSTx位（x对应1-4），TSCTR计数器会在锁存后立即复位为0。这个功能在测量连续事件之间的时间差（ΔT）时非常有用，因为每次捕获后计数器归零，下一次捕获的值就是直接的时间间隔。

4. 运行模式控制：

   • 连续模式（ECCTL2[CONT/ONESHT]=1）：模4计数器永不停止，在0-3之间循环。CAP1-CAP4构成一个环形缓冲区，新数据会覆盖旧数据。配合DMA，可以实现对高频信号的连续无丢失监控。
   • 单次模式（ECCTL2[CONT/ONESHT]=0）：你需要设置ECCTL2[STOP_WRAP]的值（1-4）。当捕获事件数达到设定值时，模4计数器停止，CAPLDEN位被自动清零，阻止后续捕获覆盖数据。此时，CAP1-CAP4中存储的就是一组完整的事件时间戳。需要软件执行“重载”（ECCTL2[REARM]=1）来开始下一次捕获序列。

3.2 关键配置步骤与代码示例（以测量PWM占空比为例）

假设我们需要测量一个外部PWM信号的频率和占空比。我们需要捕获一个周期内的上升沿和下降沿。

步骤1：初始化与引脚配置

// 假设使用 eCAP1， 输入信号来自 GPIO0 // 1. 使能 eCAP1 模块时钟 SysCtl_enableModule(SYSCTL_MODULE_ECAP1); // 2. 配置 GPIO0 为 eCAP1 输入功能 (具体函数取决于芯片SDK) GPIO_setPinConfig(GPIO_0_ECAP1_INPUT); GPIO_setDirectionMode(0, GPIO_DIR_MODE_IN); GPIO_setQualificationMode(0, GPIO_QUAL_SYNC); // 同步模式，抗噪但引入2周期延迟 // 3. 配置 eCAP 输入选择为 INPUTXBAR.OUT0 (假设GPIO0映射到此) ECAP_selectInputSource(ECAP1_BASE, ECAP_INPUT_INPUTXBAR_OUT0);

步骤2：捕获模式寄存器配置

// 停止并重置 eCAP 模块 ECAP_disableCapture(ECAP1_BASE); ECAP_initModule(ECAP1_BASE); // 配置捕获事件 ECAP_Config ecap1Cfg; // 使用绝对时间模式，计数器自由运行，不复位 ecap1Cfg.counterMode = ECAP_COUNTER_MODE_ABSOLUTE; // 配置四个捕获事件的边沿 // CEVT1: 上升沿 (用于测量周期) ecap1Cfg.capEvent1Config.eventPolarity = ECAP_EVENT_POLARITY_RISING; ecap1Cfg.capEvent1Config.enableCapture = true; ecap1Cfg.capEvent1Config.enableCounterReset = false; // 不复位，用差值算周期 // CEVT2: 下降沿 (用于测量高电平时间) ecap1Cfg.capEvent2Config.eventPolarity = ECAP_EVENT_POLARITY_FALLING; ecap1Cfg.capEvent2Config.enableCapture = true; ecap1Cfg.capEvent2Config.enableCounterReset = false; // CEVT3: 上升沿 (下一个周期的上升沿) ecap1Cfg.capEvent3Config.eventPolarity = ECAP_EVENT_POLARITY_RISING; ecap1Cfg.capEvent3Config.enableCapture = true; ecap1Cfg.capEvent3Config.enableCounterReset = false; // CEVT4: 禁用 ecap1Cfg.capEvent4Config.enableCapture = false; // 配置为连续捕获模式，捕获3个事件（上升、下降、上升）后自动重载 ecap1Cfg.oneShotMode = ECAP_ONE_SHOT_MODE_DISABLE; // 连续模式 ecap1Cfg.stopWrap = ECAP_STOP_WRAP_3_EVENTS; // 3个事件后，模4计数器归零，但继续捕获 // 配置事件预分频和毛刺滤波器（根据信号频率和噪声情况调整） ecap1Cfg.eventPrescaler = 0; // 不分频 ecap1Cfg.qualificationPeriod = 2; // 滤除小于2个SYSCLK周期的毛刺 // 应用配置 ECAP_setupCapture(ECAP1_BASE, &ecap1Cfg); // 使能捕获寄存器加载 ECAP_enableCaptureRegisterLoad(ECAP1_BASE); // 使能中断（可选，这里我们使能CEVT3中断，表示一个完整周期数据就绪） ECAP_enableInterrupt(ECAP1_BASE, ECAP_INT_CEVT3); ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_CEVT3); // 最后，启动捕获 ECAP_startCapture(ECAP1_BASE);

步骤3：中断服务程序中进行计算

__interrupt void ecap1ISR(void) { uint32_t cap1, cap2, cap3; float period_cycles, high_time_cycles, duty_cycle; float sysclk_freq = 200e6; // 200 MHz // 读取三个时间戳 cap1 = ECAP_getEventTimeStamp(ECAP1_BASE, ECAP_EVENT_1); // 第一个上升沿 cap2 = ECAP_getEventTimeStamp(ECAP1_BASE, ECAP_EVENT_2); // 下降沿 cap3 = ECAP_getEventTimeStamp(ECAP1_BASE, ECAP_EVENT_3); // 第二个上升沿 // 计算周期（计数器差值）和高电平时间 // 注意：由于是连续模式且计数器自由运行，需要处理32位计数器溢出。 // 这里假设在三个事件间隔内计数器未溢出，使用简单差值。 period_cycles = (float)(cap3 - cap1); high_time_cycles = (float)(cap2 - cap1); // 计算实际时间和占空比 float period_s = period_cycles / sysclk_freq; float freq_hz = 1.0 / period_s; duty_cycle = (high_time_cycles / period_cycles) * 100.0; // 可以在这里更新显示、进行控制决策等 // ... // 清除中断标志 ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_CEVT3); // 如果是单次模式，可能需要在此处重新武装（REARM） // ECAP_arm(ECAP1_BASE); }

注意事项：计数器溢出处理上面的示例代码为了简洁，假设在三个事件间隔内32位计数器没有溢出。在实际应用中，尤其是测量低频信号时，必须考虑溢出。一个稳健的方法是：在中断中读取计数器快照和事件时间戳，并维护一个全局的“溢出次数”计数器（在TSCTR计数器溢出中断中递增）。计算时间差时，公式应为：delta = (current_capture + overflow_count * 2^32) - previous_capture。另一种更简单的方法是启用捕获事件复位计数器功能（enableCounterReset = true），这样每个捕获值本身就是相对于上一个事件的时间间隔，无需处理溢出��但前提是你的测量逻辑允许计数器复位。

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

当你的应用不需要捕获功能，而是需要一个额外的、高精度的PWM输出通道时，eCAP的APWM模式就派上用场了。它尤其适合需要与捕获事件或其他��时器同步的PWM生成场景。

4.1 APWM模式工作原理

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

• TSCTR计数器：工作在递增计数模式，从0计数到周期值（CAP1/APRD），然后归零，循环往复。
• CAP1寄存器：变为活动周期寄存器（APRD），定义PWM波的周期。
• CAP2寄存器：变为活动比较寄存器（ACMP），定义PWM输出翻转的时刻，从而决定占空比。
• CAP3寄存器：变为周期影子寄存器。
• CAP4寄存器：变为比较值影子寄存器。
• 输出逻辑：根据APWMPOL位的设置（0为高有效，1为低有效），当TSCTR计数器的值小于ACMP时，输出一种电平；大于等于ACMP时，输出另一种电平。

关键机制：影子寄存器与加载方式这是APWM模式稳定输出的核心。对CAP1/CAP2（活动寄存器）的写操作会立即生效，并同时拷贝到CAP3/CAP4（影子寄存器）。而对CAP3/CAP4的写操作，其值不会立即影响输出，而是会在下一个TSCTR计数器归零（CTR=PRD）的时刻，被同步加载到CAP1/CAP2中。因此，标准的、无毛刺更新PWM参数的流程是：在运行时，只更新影子寄存器（CAP3/CAP4）。

4.2 APWM配置实战：生成一个可调占空比的PWM

假设我们需要用eCAP1生成一个频率为100kHz，初始占空比为50%的PWM波。

步骤1：计算寄存器值系统时钟SYSCLK = 200MHz。

• PWM周期T = 1 / 100kHz = 10 us。
• 一个时钟周期T_clk = 1 / 200MHz = 5 ns。
• 周期寄存器值APRD = T / T_clk = 10 us / 5 ns = 2000。
• 比较寄存器值（50%占空比）ACMP = APRD * 0.5 = 1000。

步骤2：APWM模式初始化配置

// 1. 使能模块时钟 SysCtl_enableModule(SYSCTL_MODULE_ECAP1); // 2. 停止并重置模块 ECAP_stopCounter(ECAP1_BASE); ECAP_initModule(ECAP1_BASE); // 3. 配置为APWM模式 ECAP_setAPWMMode(ECAP1_BASE, ECAP_APWM_ACTIVE_HIGH); // 高有效模式 // 4. 配置时间基准计数器：递增模式，禁止同步（作为主定时器） ECAP_setTimeBaseCounterMode(ECAP1_BASE, ECAP_COUNTER_MODE_UP); ECAP_disableSyncIn(ECAP1_BASE); // 本例中不同步 ECAP_setCounterCompareShadowLoadMode(ECAP1_BASE, ECAP_SHADOW_LOAD_MODE_COUNTER_ZERO); // 计数器归零时加载影子寄存器 // 5. 初始化活动寄存器（同时会拷贝到影子寄存器） ECAP_setCounterPeriod(ECAP1_BASE, 2000); // 写CAP1，设置周期 ECAP_setCounterCompare(ECAP1_BASE, 1000); // 写CAP2，设置比较值（占空比） // 6. 配置输出引脚（通过Output X-BAR将eCAP1输出连接到某个GPIO） // 假设将ECAP1_OUT映射到GPIO1 OutputXbar_setOutputMuxConfig(OUTPUTXBAR_PORT_GPIO1, OUTPUTXBAR_MUX_ECAP1_OUT); GPIO_setPadConfig(1, GPIO_PIN_TYPE_STD); // 推挽输出 GPIO_setDirectionMode(1, GPIO_DIR_MODE_OUT); // 7. 启动计数器 ECAP_startCounter(ECAP1_BASE);

此时，GPIO1上应该会出现一个100kHz、50%占空比的PWM波。

步骤3：运行时动态更新占空比为了无毛刺地更新占空比，我们应该更新影子寄存器CAP4（对应ACMP的影子）。

// 将占空比改为75% uint32_t new_cmp = 2000 * 0.75; // 1500 ECAP_setCounterCompareShadow(ECAP1_BASE, new_cmp); // 写CAP4 // 新的比较值将在当前PWM周期结束时（TSCTR从2000归零时）生效，输出波形平滑切换。

避坑指南：APWM输出的使能时机手册中有一个非常重要的提示：一旦eCAP被配置为APWM模式，其输出就会立即生效。这意味着，如果你在配置APWM参数（如周期、占空比）之前就通过Output X-BAR将eCAP输出连接到某个GPIO，那么在配置过程中，GPIO上可能会出现不可控的毛刺或错误电平。正确的顺序是：1) 完成eCAP模块的所有内部配置（模式、周期、占空比等）；2) 启动eCAP计数器；3)最后，才配置Output X-BAR，将eCAP的输出信号路由到目标GPIO。这样可以确保从连接的那一刻起，GPIO上就是稳定、正确的PWM波形。

4.3 高级同步应用：与ePWM模块协同工作

eCAP的APWM模式可以与其他ePWM模块同步，用于构建复杂的多相、交错式电源拓扑。例如，在一个两相交错并联的Buck电路中，你需要两个PWM通道，相位相差180度。

1. 主从设置：将ePWM1配置为主模块，产生同步输出（SYNCOUT）。将eCAP1（配置为APWM模式）设置为从模块，接收ePWM1的同步信号（SYNCIN）。
2. 相位偏移：在eCAP1中，设置ECAPxSYNCINSEL选择ePWM1的同步输出作为源。然后，通过ECCTL2中的相位寄存器（或相关同步控制位）设置一个相位偏移值。当eCAP1收到同步脉冲时，其TSCTR计数器不是从0开始，而是从设定的相位值开始计数。
3. 结果：ePWM1和eCAP1输出相同频率和占空比的PWM波，但eCAP1的输出相对于ePWM1有一个固定的相位延迟，从而实现交错控制，降低输入电流纹波。

配置同步时，务必仔细阅读芯片手册中关于同步脉冲极性、同步时刻（计数器为0时或为周期值时）的说明，这些细节决定了相位偏移的实际效果。

5. 信号监控单元：构建系统安全护城河

Type 3 eCAP引入的信号监控单元是其一大亮点，它从“被动测量”升级为“主动监控”，为系统增加了硬件级别的实时保护功能。

5.1 监控模式详解

信号监控单元主要有两种工作模式：

5.1.1 脉冲宽度与周期监控在此模式下，监控单元连续测量输入信号的脉冲宽度（高电平或低电平时间）或信号周期（上升沿到上升沿或下降沿到下降沿的时间）。你需要预先通过MUNIT_x_MIN和MUNIT_x_MAX寄存器设定一个合法的范围（[MIN, MAX]）。

• 工作原理：监控单元利用eCAP的捕获功能，在设定的两个边沿（如测量高电平时，配置为上升沿捕获和下降沿捕获）触发时，记录时间戳并计算差值。如果计算出的脉冲宽度小于MIN，则立即产生ERROR_EVT1事件；如果大于MAX，则产生ERROR_EVT2事件（具体行为受DISABLE_EARLY_MAX_ERR位控制）。
• 应用场景：在电机驱动中，监控霍尔传感器或编码器信号的脉冲宽度，如果出现异常变宽或变窄（可能意味着传感器故障或机械卡顿），可以立即触发保护。在数字电源中，监控主开关管的驱动信号，防止因控制逻辑错误产生过窄或过宽的脉冲，损坏开关管。

5.1.2 边沿窗口监控在此模式下，监控单元不测量宽度，而是期待一个特定的边沿（上升或下降）出现在一个预设的时间窗口[MIN, MAX]内。这个窗口通常是相对于一个同步事件（如ePWM的周期起点）来定义的。

• 工作原理：你需要将一个ePWM模块的某个事件（如CTR=0）作为同步源连接到eCAP的SYNCIN。监控单元在每次同步事件后开始计时，并期待目标边沿在MIN计数之后、MAX计数之前出现。如果边沿提前于MIN出现、晚于MAX出现，或者在整个窗口期内都没有出现，都会触发ERROR_EVT1或ERROR_EVT2。
• 应用场景：在LLC谐振变换器中，需要确保开关管在电流过零（ZCS）或电压过零（ZVS）附近开通/关断，以实现软开关。你可以用ePWM的开关事件作为同步起点，用eCAP监控谐振电流或电压的过零检测信号边沿。如果过零信号没有在预期的死区时间窗口内出现，说明软开关条件未满足，监控单元可以立即产生错误信号，联动ePWM的Trip-zone关闭输出，保护开关管免受硬开关应力。

5.2 信号监控配置示例与联动

以下是一个配置eCAP1监控单元进行脉冲宽度监控，并联动ePWM1的Trip-zone进行关断保护的简化流程：

1. 配置eCAP1为监控模式：

   // 启用信号监控单元1 ECAP_enableSignalMonitor(ECAP1_BASE, ECAP_MONITOR_UNIT_1); // 配置监控模式：监控高脉冲宽度 ECAP_setSignalMonitorMode(ECAP1_BASE, ECAP_MONITOR_UNIT_1, ECAP_MONITOR_MODE_PULSE_WIDTH_HIGH); // 设置预期脉冲宽度范围 (例如：期望高电平在 1000 到 3000 个时钟周期之间) // 假设系统时钟5ns，即5us到15us ECAP_setSignalMonitorMinLimit(ECAP1_BASE, ECAP_MONITOR_UNIT_1, 1000); ECAP_setSignalMonitorMaxLimit(ECAP1_BASE, ECAP_MONITOR_UNIT_1, 3000); // 配置错误事件行为：立即触发错误 ECAP_setSignalMonitorErrorConfig(ECAP1_BASE, ECAP_MONITOR_UNIT_1, ECAP_MONITOR_ERROR_EVT_IMMEDIATE); // 将监控错误事件输出到 TRIP_OUT ECAP_setSignalMonitorTripOutput(ECAP1_BASE, ECAP_MONITOR_UNIT_1, true);

2. 配置ePWM1的Trip-zone：

   // 配置ePWM1的Trip-zone输入源，选择来自eCAP1的TRIP_OUT // 这通常通过Trip-zone子模块的输入选择寄存器完成，具体取决于芯片 EPWM_selectTripZoneSignal(EPWM1_BASE, EPWM_TZ_SIGNAL_ECAP1_TRIPOUT); // 配置Trip-zone动作：当错误发生时，强制PWM输出高阻态或固定电平 EPWM_setTripZoneAction(EPWM1_BASE, EPWM_TZ_ACTION_EVENT_TZA, EPWM_TZ_ACTION_HIGH_Z); // A通道高阻 EPWM_setTripZoneAction(EPWM1_BASE, EPWM_TZ_ACTION_EVENT_TZB, EPWM_TZ_ACTION_HIGH_Z); // B通道高阻 EPWM_enableTripZoneSignals(EPWM1_BASE, EPWM_TZ_SIGNAL_1); // 使能Trip-zone信号1

3. 连接与使能：

   • 将需要监控的信号（例如电流检测比较器的输出）通过Input X-BAR路由到eCAP1的输入。
   • 通过芯片的交叉触发矩阵（如PWM X-BAR或类似机制），将eCAP1的TRIP_OUT信号连接到ePWM1的Trip-zone输入。

完成以上配置后，一旦被监控信号的脉冲宽度超出5us-15us的范围，eCAP1会立即拉高TRIP_OUT，ePWM1的Trip-zone检测到该信号，会在下一个时钟周期内将PWM输出强制置为高阻态，实现纳秒级的硬件保护，远比软件中断响应更快、更可靠。

6. 常见问题排查与实战经验汇编

即使理解了所有原理，在实际调试中依然会遇到各种问题。下面是我在多个项目中总结出的常见“坑点”和解决方案。

6.1 捕获模式常见问题

问题1：捕获不到任何事件，时间戳寄存器始终为0。

• 检查输入路径：确认GPIO已正确配置为eCAP输入功能，并且通过ECCTL0[INPUTSEL]选择了正确的输入源索引。使用示波器或逻辑分析仪确认信号确实到达了芯片引脚。
• 检查边沿极性：确认ECCTL1.CAPxPOL配置的边沿方向与实际信号跳变方向一致。
• 检查毛刺滤波和预分频：如果QUALPRD设置过大，可能会滤除正常的窄脉冲。如果PRESCALE设置过大，可能导致有效事件被“吞掉”。调试初期，建议先将两者设为0（禁用滤波，1分频）。
• 检查捕获使能：确认ECCTL2.CAPLDEN位已置1（使能捕获加载），并且模块已通过ECCTL2[REARM]武装（单次模式）或已启动（连续模式）。
• 检查信号宽度：手册注明，输入脉冲ECAPxIN的宽度必须至少为2个SYSCLK周期，否则可能被漏采。确保你的信号满足这个最低要求。

问题2：捕获到的时间戳值跳跃巨大或不连续。

• 计数器溢出处理：如果你在自由运行模式（不复位）下测量长时间间隔，必须处理32位计数器的溢出。参考前面提到的“溢出次数”计数器方法。
• 中断响应延迟：在连续捕获模式下，如果中断服务程序（ISR）处理时间过长，可能在读取CAPx寄存器之前，该寄存器已被新数据覆盖。解决方案：使用DMA将CAP寄存器数据自动搬运到内存中，或者使用单次模式确保数据不被覆盖；优化ISR代码，尽快读取数据。
• 同步问题：如果eCAP计数器被配置为与另一个模块同步（SYNCI_EN），同步事件可能会导致计数器被重置或加载一个相位值，从而影响时间戳的连续性。检查同步配置是否符合预期。

6.2 APWM模式常见问题

问题1：PWM输出频率或占空比与计算值不符。

• 周期值计算错误：记住，PWM周期T = (APRD + 1) * T_clk。如果你设置APRD=1999，则周期是2000个时钟周期。频率 = SYSCLK / (APRD + 1)。
• 占空比计算错误：对于高有效模式，输出在TSCTR < ACMP时为高。占空比D = ACMP / (APRD + 1)。当ACMP=0时，输出常低（0%占空比）；当ACMP >= APRD+1时，输出常高（100%占空比）。特别注意边界条件。
• 影子寄存器未生效：如果你在运行时通过写CAP3/CAP4更新参数，但输出没变化，请确认ECCTL2.SHADOW相关配置是否正确，以及你是否在计数器归零时加载影子寄存器。可以在计数器归零时产生中断，在中断中更新影子寄存器是最安全的做法。

问题2：PWM输出使能时出现毛刺。

• 输出使能顺序错误：这是最常见的原因。务必遵循“先配置eCAP参数并启动计数器，最后再使能输出通路（Output X-BAR）”的顺序。
• 初始化期间寄存器值不确定：在配置APWM模式前，先停止计数器（ECAP_stopCounter），并初始化所有相关寄存器为一个确定的状态（例如，将CAP1-CAP4都清零），然后再配置所需参数。

6.3 信号监控单元调试技巧

问题：监控单元频繁误报错误。

• MIN/MAX窗口设置不合理：考虑信号的抖动和噪声。适当放宽MIN和MAX的边界。可以通过先使用捕获模式测量一段时间内信号的实际参数范围，再据此设置监控阈值。
• 同步信号问题（边沿窗口监控）：确保同步信号（如ePWM的同步输出）稳定且与待监控信号有确定的时序关系。检查同步信号的极性、宽度是否符合eCAP同步输入的要求。
• 毛刺滤波器影响：如果启用了输入信号的毛刺滤波，它会引入固定的延迟（QUALPRD+1个周期）。在计算MIN/MAX窗口时，需要将这个延迟考虑进去并进行补偿。
• 监控单元未正确复位：在每次启动监控或修改配置后，确保通过MUNIT_CTL寄存器中的相关位对监控单元进行复位，使其从初始状态开始工作。

6.4 性能优化与高级用法

1. 利用DMA解放CPU：在需要连续高速捕获数据的应用（如高频采样），务必启用eCAP的DMA功能。配置DMA通道，将CAPx寄存器设置为源地址，内存数组为目标地址，并选择CEVTx作为DMA触发源。这样可以在无CPU干预的情况下，将海量时间戳数据搬运到内存中，供后续批量处理。
2. 精准触发ADC采样：在数字电源控制中，经常需要在PWM开关时刻的中点或谷底进行ADC采样。你可以在APWM模式下，配置当TSCTR等于某个比较值（CMP）或周期值（PRD）时，产生ECAP_SOC_EVT事件，并利用此事件直接触发ADC开始转换。这实现了硬件级别的精准同步，避免了软件延迟带来的采样误差。
3. 多eCAP模块协同：对于多相电机或复杂电源拓扑，可以使用多个eCAP模块。一个作为主时钟源，通过SYNCOUT同步其他eCAP模块，确保所有PWM或捕获通道具有严格同步的时间基准。

eCAP模块的深度和灵活性远超一篇博文所能涵盖，但其核心思想在于硬件化的精准时序处理。将时间测量、波形生成、安全监控这些耗时且要求严格的任务交给eCAP硬件，让CPU得以专注于更高层次的控制算法和系统管理，这是构建高性能、高可靠性嵌入式系统的关键。希望这篇结合了原理与实战的解析，能帮助你真正驾驭这颗强大的“瑞士军刀”，在你的下一个电机驱动或数字电源项目中游刃有余。