深入解析C2000 ePWM/eCAP：从寄存器到Driverlib函数映射与实战

1. 项目概述

在电机控制、数字电源、逆变器以及任何需要精确时序和信号处理的嵌入式实时控制系统中，德州仪器（TI）的C2000系列微控制器一直是工程师们的首选平台。其内置的增强型脉宽调制器（ePWM）和增强型捕获（eCAP）模块，为生成复杂PWM波形和精确测量外部事件时间戳提供了强大的硬件支持。然而，直接操作这些模块的寄存器是一项繁琐且容易出错的工作，涉及大量位域设置、内存地址映射和时序考量。

为了提升开发效率与代码质量，TI提供了C2000 Driverlib库，它将底层寄存器的复杂操作封装成一系列直观、易用的API函数。但对于许多从寄存器操作转向库函数开发的工程师，或者需要深入优化底层性能的开发者而言，心中常有一个疑问：我调用的这个Driverlib函数，到底修改了哪个寄存器的哪些位？其背后的硬件行为究竟是什么？这份“寄存器到Driverlib函数映射详解”正是为了弥合这一认知鸿沟而生。它不是一份简单的API列表，而是一张连接高级软件抽象与底层硬件实体的“地图”，旨在帮助开发者透彻理解每一个配置动作的硬件本质，从而在灵活性与便捷性之间找到最佳平衡，编写出既高效又可靠的嵌入式代码。

2. 核心设计思路与映射原理剖析

2.1 为何需要寄存器-函数映射？

在嵌入式开发中，我们通常面临两种编程范式：寄存器直接操作和库函数调用。寄存器操作提供了最高的灵活性和对硬件最直接的控制，但代码冗长、可读性差，且严重依赖芯片手册，容易因位域设置错误导致难以调试的问题。而Driverlib这类硬件抽象层（HAL）库，通过函数封装，提供了类型安全的参数、清晰的函数名和自动化的配置流程，大幅降低了开发门槛和出错概率。

映射关系的核心价值在于“知其然，亦知其所以然”。例如，当你调用EPWM_setTimeBasePeriod()时，你知道它设置了PWM的周期。但通过映射表，你能明确看到它实际上写入了TBPRD这个寄存器。更进一步，你可以去查阅TBPRD寄存器的描述，理解其位宽、影子加载机制、以及写入后何时生效等细节。这种深度理解在调试异常PWM输出、解决同步问题时至关重要。映射表充当了软件层与硬件层之间的翻译官和导航图。

2.2 TMS320F28002x ePWM/eCAP模块架构简述

在深入映射细节前，有必要对这两个模块有个宏观认识。ePWM模块远不止一个简单的计数器比较单元，它是一个高度可配置、包含多个子模块的完整系统。主要子模块包括：

  • 时间基准子模块 (TB)：负责产生时基计数器（TBCTR），管理周期、相位和同步。
  • 计数比较子模块 (CC)：将时基计数器与比较寄存器（CMPA, CMPB等）的值进行比较，产生初步的事件。
  • 动作限定子模块 (AQ)：根据TB和CC产生的事件，决定如何驱动输出引脚（置高、拉低、翻转）。
  • 死区子模块 (DB)：为互补的PWM对（如用于H桥的上、下管）插入可编程的死区时间，防止直通。
  • 错误联防子模块 (TZ)：响应外部故障信号，立即将PWM输出强制到安全状态。
  • 事件触发子模块 (ET)：在特定时间点（如计数器等于周期或比较值时）产生中断或ADC启动触发信号。

eCAP模块则是一个高精度的“数字示波器”或“频率计”。其核心是一个32位自由运行或可重置的时基计数器（TSCTR），以及多达4个32位捕获寄存器（CAP1-CAP4）。外部输入信号边沿可以触发将当前时基计数器的值“捕获”到这些寄存器中，从而精确测量信号的周期、占空比或事件间的时间间隔。它也可以配置为辅助PWM（APWM）发生器，在不需要捕获功能时提供一路额外的PWM输出。

Driverlib函数的设计正是围绕这些子模块的功能进行组织的，每个函数通常对应一个子模块内某个寄存器的特定配置项。

2.3 映射表的结构与解读方法

你提供的资料是TI技术参考手册（TRM）中的标准映射表。其结构通常为三列：寄存器（Register）、所在文件（File）、驱动库函数（Driverlib Function）。解读时需把握几个要点：

  1. 一对多关系：一个寄存器往往对应多个函数。这是因为一个控制寄存器（如TBCTL）包含多个独立的控制位域。例如，TBCTL寄存器控制着时基模块的几乎所有全局行为，因此映射到了EPWM_setClockPrescaler、EPWM_setCountModeAfterSync、EPWM_setEmulationMode等十多个函数，每个函数只操作其中特定的几位。

  2. 函数命名规律：Driverlib函数名具有高度的自描述性。通常遵循[模块前缀]_[动作][对象][属性]的格式。例如：

    • EPWM_setTimeBasePeriod: ePWM模块，设置（set），时基（TimeBase）的周期（Period）。
    • EPWM_disableDeadBandControlShadowLoadMode: ePWM模块，禁用（disable），死区控制（DeadBandControl）的影子加载模式（ShadowLoadMode）。
    • ECAP_enableInterrupt: eCAP模块，使能（enable），中断（Interrupt）。 通过函数名，即使不看映射表，也能大致猜出其功能。

  3. “-”与“See”的含义：表中某些寄存器项对应的“File”和“Driverlib Function”列为“-”，或写着“See AQCTLA”。这通常表示：

    • “-”：该寄存器在当前的Driverlib版本中没有提供独立的封装函数，可能需要通过直接寄存器访问或更底层的配置方式操作。例如，一些非常底层的配置或状态寄存器。
    • “See XXX”：该寄存器的功能与另一个已列出的寄存器（XXX）完全相同或高度相似，因此使用相同的函数集。例如，CMPB寄存器的操作函数与CMPA相同，都是EPWM_setCounterCompareValue和EPWM_getCounterCompareValue，只是函数调用时指定的参数（通道）不同。

3. ePWM模块关键寄存器与函数映射深度解析

3.1 时间基准子模块 (Time-Base, TB) 核心配置

时间基准是ePWM的“心脏”，它决定了PWM波形的根本频率和相位。相关寄存器主要集中在TBCTL、TBPRD、TBPHS和TBCTR。

  • TBCTL(Time-Base Control Register)：这是TB子模块的总控制寄存器。映射的函数几乎涵盖了所有关键配置：
    • EPWM_setClockPrescaler(TBCTL[3:2] HSPCLKDIV, TBCTL[1:0] CLKDIV)：设置时基时钟预分频器。这是计算PWM频率的第一步。例如，系统时钟SYSCLK=100MHz，若设置HSPCLKDIV=/2，CLKDIV=/1，则时基时钟TBCLK=50MHz。此配置直接影响计数器计数速度和最终PWM分辨率。
    • EPWM_setCountModeAfterSync(TBCTL[11:10] PHSDIR)：设置同步事件后计数器的方向。这在多模块同步时至关重要，可以确保所有PWM模块在同步后保持相同的计数方向，避免波形混乱。
    • EPWM_setPeriodLoadMode(TBCTL[6] PRDLD)：选择周期寄存器(TBPRD)的加载模式。0为影子加载（在CTR=0或CTR=PRD时更新），1为立即加载。强烈建议在需要动态调整周期且要求波形连续无毛刺的应用中，使用影子加载模式。
    • EPWM_setPhaseShift(TBPHS)：设置相位偏移寄存器。用于实现多个PWM通道之间的相位交错，例如在交错并联Boost PFC电路中，可以减小输入电流纹波。该函数直接写入TBPHS寄存器。

实操心得：相位同步的坑在配置主从同步的ePWM模块时，务必注意顺序。正确的流程是：1) 配置从模块的相位值(TBPHS)。2) 配置从模块的同步信号源(EPWM_setSyncInPulseSource)。3) 在主模块产生同步脉冲(EPWM_forceSyncPulse)。如果先同步再设相位，相位值可能无法在正确的周期生效，导致同步失败。

  • TBPRD(Time-Base Period Register)：PWM周期寄存器。函数EPWM_setTimeBasePeriod和EPWM_getTimeBasePeriod对其进行读写。周期值 = (TBCLK / PWM频率) - 1。例如，要产生20kHz的PWM，TBCLK=50MHz，则TBPRD = (50,000,000 / 20,000) - 1 = 2499。

  • TBCTR(Time-Base Counter Register)：时基计数器当前值寄存器。通常不直接写入，但函数EPWM_setTimeBaseCounter可用于在调试时强制设置计数器值，EPWM_getTimeBaseCounterValue用于读取当前计数值，在特定触发条件判断或调试时非常有用。

3.2 计数比较与动作限定子模块 (CC & AQ) 联动

CC子模块产生事件，AQ子模块决定输出动作。这是PWM波形形状的直接塑造者。

  • CMPA,CMPB,CMPC,CMPD(Counter Compare Registers)：比较寄存器。函数EPWM_setCounterCompareValue用于设置比较值。占空比 = (CMPx / (TBPRD + 1)) * 100%。例如，TBPRD=2499，要产生50%占空比，则CMPA = 1249。CMPC和CMPD通常用于高分辨率PWM(HRPWM)或更复杂的波形生成。

  • CMPCTL(Counter Compare Control Register)：控制比较值的加载方式。EPWM_setCounterCompareShadowLoadMode用于使能CMPA/CMPB的影子加载，并选择加载时机（CTR=0或CTR=PRD）。动态改变占空比时，必须使用影子加载以避免在计数器中间更新比较值而导致脉冲宽度异常。

  • AQCTLA,AQCTLB(Action Qualifier Control Registers)：动作限定控制寄存器。这是ePWM最灵活也最核心的部分之一。函数EPWM_setActionQualifierAction用于定义在特定事件（CTR=PRD, CTR=CMPA up, CTR=CMPA down等）发生时，输出引脚EPWMxA/EPWMxB执行什么动作（置高、拉低、翻转）。

    • 示例：实现一个递增计数模式下，在CTR=0时拉高，CTR=CMPA时拉低的简单PWM，需要配置：
      EPWM_setActionQualifierAction(myEPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_ZERO); EPWM_setActionQualifierAction(myEPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA);
      这实际上配置了AQCTLA寄存器的相应位域。

3.3 死区子模块 (Dead-Band, DB) 配置精要

死区时间是电机驱动和全桥/半桥电源中的安全卫士，防止上下管同时导通造成短路。

  • DBCTL(Dead-Band Control Register)：死区控制寄存器。映射的函数用于配置死区的工作模式。
    • EPWM_setDeadBandDelayMode(DBCTL[5:4] OUT_MODE)：设置输出模式。经典模式如“上升沿延迟”、“下降沿延迟”、“双边延迟”和“使能”。
    • EPWM_setRisingEdgeDelayCount和EPWM_setFallingEdgeDelayCount：分别设置上升沿和下降沿的延迟计数值。死区时间 = 延迟计数值 * TBCLK周期。例如，TBCLK周期20ns (50MHz)，需要500ns死区，则延迟值应设为25。
    • EPWM_setDeadBandOutputSwapMode(DBCTL[10] SELSAP, DBCTL[9] SELSB)：交换经过死区处理后的信号路径。这在配置互补PWM对时非常方便，无需在硬件上交叉走线。

注意事项：死区计算与极性死区模块的输入是AQ模块输出的原始信号（EPWMxA和EPWMxB）。务必根据你的功率拓扑（高侧有效还是低侧有效）和使用的驱动芯片逻辑，结合EPWM_setDeadBandDelayPolarity来正确配置延迟施加在哪个极性边上。一个常见的错误是死区配置对了，但因为极性设反，导致实际波形完全错误甚至炸管。

3.4 错误联防与事件触发子模块 (TZ & ET)

这两个子模块关乎系统的安全性与协同工作能力。

  • TZSEL,TZCTL(Trip-Zone Select and Control)：错误联防选择与控制寄存器。

    • EPWM_enableTripZoneSignals：使能特定的外部故障信号源（如GPIO、比较器）。
    • EPWM_setTripZoneAction：配置当故障发生时，PWM输出采取的动作（高阻、强制高、强制低）。这是实现硬件级保护的关键，响应速度远快于软件中断。

  • ETSEL,ETPS,ETFLG,ETCLR(Event-Trigger)：事件触发选择、预分频、标志和清除寄存器。

    • EPWM_setInterruptSource和EPWM_enableInterrupt：选择中断事件源（如CTR=PRD, CTR=CMPA）并使能中断。用于在特定时刻触发CPU中断，执行更新比较值、读取ADC采样等任务。
    • EPWM_setADCTriggerSource和EPWM_enableADCTrigger：选择ADC触发事件源并使能触发。这是实现“采样-计算-更新”闭环控制的关键，确保ADC在PWM波形的特定点（如周期中心或开关时刻）进行采样，数据同步性极好。
    • EPWM_setInterruptEventCount(ETPS[5:4] INTPRD)：设置中断事件发生的周期。例如，设置为EPWM_INT_TBCTR_U_CMPA且INTPRD=2，意味着每2次“CTR上数等于CMPA”事件才产生一次中断，用于降低CPU负载。

4. eCAP模块寄存器与函数映射及工作模式详解

eCAP模块可以看作一个“模式切换”的外设：捕获模式（Capture）和辅助PWM模式（APWM）。其寄存器功能也相应切换。

4.1 捕获模式核心配置

在捕获模式下，核心目标是精确记录外部事件发生的时刻。

  • ECCTL0(Capture Control Register 0)：输入选择与边沿极性控制。

    • 通过ECAP_setInputSignal()（映射到ECCTL0.INPUTSEL）可以选择多达128种输入源，包括GPIO、X-BAR信号、比较器输出等，提供了极大的灵活性。
    • ECAP_setCaptureEdge()（映射到ECCTL1.CAPxPOL）为四个捕获事件（CEVT1-4）分别设置触发边沿（上升沿、下降沿或双边沿）。例如，可以配置CEVT1在上升沿捕获，CEVT2在下降沿捕获，从而直接测量出一个脉冲的周期和占空比。

  • ECCTL1(Capture Control Register 1)：计数器控制与预分频。

    • ECAP_enableCaptureLoad()（映射到ECCTL1.CAPLDEN）：使能捕获寄存器加载。必须在开始捕获前使能。
    • ECAP_setPrescaler()（映射到ECCTL1.PRESCALE）：设置事件预分频。对于高频输入信号，可以每N个边沿才触发一次捕获，相当于数字滤波和降频。
    • ECAP_setCounterReset()（映射到ECCTL1.CTRRSTx）：设置计数器在哪个捕获事件后复位。这是实现“差值模式”（Delta Mode）的关键。例如，设置CTRRST2=1，则CAP1捕获的是第一个事件的绝对时间，CAP2捕获的是第一个事件到第二个事件之间的时间差（因为CAP1捕获后计数器复位了）。

  • ECCTL2(Capture Control Register 2)：工作模式与同步控制。

    • ECAP_setCaptureMode()（映射到ECCTL2.CONT_ONESHT）：选择连续模式或单次模式。连续模式下，CAP1-4作为环形缓冲区循环使用；单次模式下，捕获指定次数（由STOP_WRAP决定）后停止。
    • ECAP_setSyncOutMode()和ECAP_setSyncInMode()（映射到ECCTL2.SYNCOSEL和SYNCI_EN）：配置eCAP模块的同步输入输出，使其可以与其他eCAP或ePWM模块同步时基，用于多通道同步测量。
    • ECAP_arm()（映射到ECCTL2.REARM）：在单次模式下一次捕获序列完成后，调用此函数重新“武装”捕获单元，准备下一次捕获。

  • CAP1,CAP2,CAP3,CAP4：32位捕获值寄存器。通过ECAP_getCaptureEventTimeStamp()函数读取。读取顺序很重要。在连续���式下，软件需要跟踪模4计数器状态（可通过ECCTL2.MODCNTRSTS读取）或通过中断标志来判断哪个CAP寄存器刚被更新。

4.2 辅助PWM模式配置

当不需要捕获功能时，eCAP可以变身为一个完整的单通道PWM发生器（APWM）。

  • 模式切换：通过ECAP_setAPWMMode()（映射到ECCTL2.CAP_APWM）将模块切换到APWM模式。此时，CAP1/CAP2作为活动的周期/比较寄存器，CAP3/CAP4作为其影子寄存器。
  • PWM配置：其配置逻辑与ePWM的TB和CC子模块类似。
    • ECAP_setPeriod()和ECAP_setCompare()：设置周期和比较值，分别写入CAP1和CAP2（及其影子寄存器）。
    • ECAP_setCounterMode()：设置计数模式（递增、递减、增减计数）。
    • ECAP_setAPWMPolarity()：设置输出极性。
  • 影子加载：与ePWM类似，通过ECAP_setPeriodShadowLoadMode()和ECAP_setCompareShadowLoadMode()配置影子加载行为，确保PWM波形更新的平滑性。

4.3 高精度捕获与中断/DMA应用

  • 高分辨率捕获：部分eCAP模块支持高分辨率捕获（HRCAP），通过HRCAP_前缀的函数（如HRCAP_setHiResCaptureEdgeSelect）进行配置，可以实现亚系统时钟周期的捕获精度，用于极其精密的时间测量。
  • 中断与DMA：
    • 中断：通过ECAP_enableInterrupt()和ECAP_setInterruptSource()配置在特定捕获事件（如CEVT1）或计数器溢出时产生中断，在中断服务程序（ISR）中读取捕获值。
    • DMA：这是提升效率的关键。通过ECAP_setDMATriggerSource()（映射到ECCTL2.DMAEVTSEL）选择一个捕获事件作为DMA触发源。当捕获发生时，硬件自动触发DMA，将CAPx寄存器的值直接搬运到指定的内存数组中，无需CPU干预。这对于高速连续捕获（如编码器速度测量）至关重要，可以极大减轻CPU负担，避免丢失数据。

5. 从寄存器到代码：实战配置流程与避坑指南

理解了映射关系后，如何将其转化为稳定可靠的代码？下面以一个常见的三相电机驱动ePWM配置和转速测量eCAP配置为例，说明从寄存器思维到Driverlib实践的完整流程。

5.1 ePWM配置实例：生成带死区的互补PWM

假设我们需要为电机驱动的半桥配置ePWM1A和ePWM1B作为互补输出，中心对齐，带死区，并能在周期中点触发ADC采样。

// 1. 时基子模块配置 EPWM_setTimeBasePeriod(EPWM1_BASE, 999); // PWM周期 = (1000 * TBCLK周期)。假设目标频率10kHz，TBCLK=10MHz，则PRD=999。 EPWM_setPhaseShift(EPWM1_BASE, 0); // 相位偏移为0 EPWM_setTimeBaseCounter(EPWM1_BASE, 0); // 计数器从0开始 EPWM_setCountMode(EPWM1_BASE, EPWM_COUNTER_MODE_UP_DOWN); // 设置为中心对齐（增减计数）模式 EPWM_setClockPrescaler(EPWM1_BASE, EPWM_CLOCK_DIVIDER_1, EPWM_HSCLOCK_DIVIDER_1); // 假设SYSCLK直接作为TBCLK // 2. 计数比较子模块配置 EPWM_setCounterCompareValue(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, 300); // 设置CMPA，初始占空比约30% EPWM_setCounterCompareShadowLoadMode(EPWM1_BASE, EPWM_COUNTER_COMPARE_A, EPWM_COMP_LOAD_ON_CNTR_ZERO); // CMPA在CTR=0时从影子寄存器加载 // 3. 动作限定子模块配置 - 生成中心对齐的PWM // 对于EPWM1A（高侧逻辑，先高后低） EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_HIGH, // CTR=CMPA时（递增过程）拉高 EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA); EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_A, EPWM_AQ_OUTPUT_LOW, // CTR=CMPA时（递减过程）拉低 EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA); // 对于EPWM1B（低侧逻辑，与A互补，但需考虑死区） // 先配置为与A完全相反的动作（软件互补） EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_B, EPWM_AQ_OUTPUT_LOW, EPWM_AQ_OUTPUT_ON_TIMEBASE_UP_CMPA); EPWM_setActionQualifierAction(EPWM1_BASE, EPWM_AQ_OUTPUT_B, EPWM_AQ_OUTPUT_HIGH, EPWM_AQ_OUTPUT_ON_TIMEBASE_DOWN_CMPA); // 4. 死区子模块配置 - 插入硬件死区 EPWM_setDeadBandDelayMode(EPWM1_BASE, EPWM_DB_RED, EPWM_DB_FED, EPWM_DB_MODE_ENABLE); // 使能双边沿延迟模式 EPWM_setRisingEdgeDelay(EPWM1_BASE, 50); // 设置上升沿延迟计数，假设TBCLK=10MHz，则死区时间=5us EPWM_setFallingEdgeDelay(EPWM1_BASE, 50); // 设置下降沿延迟计数 // 关键：配置输出交换，让死区模块处理后的信号正确分配到引脚 EPWM_setDeadBandOutputSwapMode(EPWM1_BASE, EPWM_DB_OUTPUT_A, EPWM_DB_OUTPUT_SWAP_DISABLE); // A路不交换 EPWM_setDeadBandOutputSwapMode(EPWM1_BASE, EPWM_DB_OUTPUT_B, EPWM_DB_OUTPUT_SWAP_ENABLE); // B路交换，使其与A互补 // 5. 事件触发子模块配置 - 在周期中点（CTR=0）触发ADC EPWM_setInterruptSource(EPWM1_BASE, EPWM_INT_TBCTR_ZERO); // 选择CTR=0为中断源 EPWM_enableInterrupt(EPWM1_BASE); // 使能ePWM中断 EPWM_setADCTriggerSource(EPWM1_BASE, EPWM_SOC_A, EPWM_SOC_TBCTR_ZERO); // 选择CTR=0为ADC SOCA触发源 EPWM_enableADCTrigger(EPWM1_BASE, EPWM_SOC_A); // 使能ADC触发 // 6. 错误联防配置（可选但强烈推荐） EPWM_enableTripZoneSignals(EPWM1_BASE, EPWM_TZ_SIGNAL_1); // 使能TZ1引脚作为故障信号 EPWM_setTripZoneAction(EPWM1_BASE, EPWM_TZ_ACTION_EVENT_TZA, EPWM_TZ_ACTION_HIGH_Z); // TZ1事件发生时，输出高阻

5.2 eCAP配置实例：测量编码器脉冲周期

假设使用eCAP1测量来自光电编码器的脉冲周期，工作在连续捕获模式，捕获上升沿，并使用中断处理数据。

// 1. 引脚和输入配置 ECAP_setInputSignal(ECAP1_BASE, ECAP_INPUT_SIGNAL_SYNCI); // 假设编码器信号通过GPIO映射到INPUTXBAR1，再选择为eCAP输入 // 注意：实际需先配置GPIO和X-BAR，此处简化。INPUT_SIGNAL_SYNCI是一个示例，具体值需查表对应INPUTSEL。 // 2. 操作模式配置 ECAP_stopCounter(ECAP1_BASE); // 先停止计数器 ECAP_setCaptureMode(ECAP1_BASE, ECAP_CONTINUOUS_CAPTURE_MODE); // 连续捕获模式 ECAP_setAPWMMode(ECAP1_BASE, ECAP_APWM_MODE_DISABLE); // 确保处于捕获模式 // 3. 事件与边沿配置 ECAP_setCaptureEdge(ECAP1_BASE, // 为4个事件都配置为上升沿捕获，我们只关注CEVT1 ECAP_EVENT_1, ECAP_EDGE_RISING, ECAP_EVENT_2, ECAP_EDGE_RISING, ECAP_EVENT_3, ECAP_EDGE_RISING, ECAP_EVENT_4, ECAP_EDGE_RISING); ECAP_enableCaptureLoad(ECAP1_BASE); // 使能捕获加载 ECAP_setCounterReset(ECAP1_BASE, ECAP_EVENT_1); // 在每次CEVT1（上升沿）捕获后复位计数器，实现周期测量（差值模式） // 4. 中断配置 ECAP_setInterruptSource(ECAP1_BASE, ECAP_ISR_SOURCE_CAPTURE_EVENT_1); // 在CEVT1（每个上升沿）触发中断 ECAP_enableInterrupt(ECAP1_BASE); // 使能eCAP中断 ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_CAPTURE_EVENT_1); // 清除可能存在的旧中断标志 // 5. 启动捕获 ECAP_startCounter(ECAP1_BASE); // 启动时基计数器 ECAP_arm(ECAP1_BASE); // “武装”捕获单元，开始等待事件 // 6. 在中断服务程序（ISR）中 void ECAP1_ISR(void) { uint32_t captureValue; captureValue = ECAP_getCaptureEventTimeStamp(ECAP1_BASE, ECAP_EVENT_1); // 读取CAP1的值 // captureValue 就是相邻两个上升沿之间的计数值（时间差） // 周期时间 = captureValue * (1 / TBCLK频率) // ... 进行速度计算等处理 ... ECAP_clearInterrupt(ECAP1_BASE, ECAP_INT_CAPTURE_EVENT_1); // 必须清除中断标志！ ECAP_arm(ECAP1_BASE); // 在连续模式下，重新武装以继续捕获（单次模式不需要） }

5.3 常见问题与排查技巧实录

即使有了清晰的映射和示例，实际调试中仍会遇到各种问题。以下是一些常见坑点及排查思���：

  1. 问题：PWM没有输出或输出波形不对。

    • 检查时钟：确认系统时钟SYSCLK是否正确配置并送达外设。使用SysCtl_getClock()验证。
    • 检查时基：确认TBPRD值非零且合理。用EPWM_getTimeBaseCounterValue读取TBCTR，看它是否在0到TBPRD之间循环。
    • 检查动作限定：这是最容易出错的地方。确认EPWM_setActionQualifierAction的配置与你的计数模式（递增/递减/增减）匹配。增减模式下，UP_CMPA和DOWN_CMPA是两个独立事件。
    • 检查输出使能：确认对应的GPIO已正确复用为ePWM输出功能（配置GPxMUX寄存器），并且输出未被其他模块（如TZ）强制为高阻或固定电平。
    • 使用寄存器视图：在CCS的调试视图中，直接查看ePWM相关寄存器的值，与你的Driverlib函数调用预期结果对比。这是最直接的调试手段。

  2. 问题：死区时间不生效或效果相反。

    • 检查输入源：死区模块的输入是AQ模块的输出。确保AQ模块已正确配置并产生了预期的原始PWM信号。
    • 检查输出交换：EPWM_setDeadBandOutputSwapMode配置错误会导致死区加在了错误的通道上，甚至使输出同相。务必根据原理图确认哪个引脚需要交换。
    • 验证极性：用示波器同时观察死区模块前后的信号（如果芯片支持），或观察最终输出。确认上升沿延迟和下降沿延迟是否按预期工作。

  3. 问题：eCAP捕获值始终为0或不变。

    • 检查输入信号路径：GPIO -> 输入限定 -> INPUT X-BAR -> eCAP输入多路选择器 (ECCTL0.INPUTSEL)。每一步都需要正确配置。一个快速验证方法是：先将该GPIO配置为普通输入，在循环中读取其电平，看是否能随外部信号变化。
    • 检查边沿极性：确认ECAP_setCaptureEdge设置的边沿与你的信号实际边沿一致。
    • 检查计数器：确认ECAP_startCounter已被调用，计数器正在运行。可以尝试在中断中读取TSCTR的当前值（虽然不直接提供函数，但可通过寄存器地址访问）。
    • 检查中断/DMA：如果使用中断，确认中断向量表已注册，PIE和CPU级中断已使能。如果使用DMA，确认DMA通道已正确配置并启动。

  4. 问题：动态更新CMPA值导致PWM波形出现毛刺或跳动。

    • 确认影子加载：确保EPWM_setCounterCompareShadowLoadMode已使能，并且加载点（CTR=0或PRD）与你的计数模式匹配。在增减计数模式下，通常选择在CTR=PRD或CTR=0时加载，以确保在计数器“两头”的对称点更新，波形最平滑。
    • 检查写入时机：在影子加载模式下，新写的值只是进入了影子寄存器（CMPC），要等到下一个加载点才会生效。确保你的更新函数（如EPWM_setCounterCompareValue）不是在临近加载点的时候被调用，以避免临界条件。一个安全做法是在中断服务程序（由CTR=PRD触发）的开始立即更新比较值。

  5. 问题：多个ePWM模块之间无法同步。

    • 检查同步链：同步是单向的。明确哪个是主模块（产生SYNCOUT），哪个是从模块（接收SYNCIN）。主模块的EPWM_setSyncOutPulseSource和从模块的EPWM_setSyncInPulseSource必须正确配置。
    • 检查相位寄存器：从模块的TBPHS寄存器决定了同步后其计数器相对于主模块计数器的偏移。如果希望完全同步，应设为0。
    • 手动触发同步：在初始化所有模块后，通常需要调用一次主模块的EPWM_forceSyncPulse()来产生一个同步脉冲，让所有从模块的计数器对齐。确保在调用强制同步前，所有从模块的相位值已设置好。

6. 高级主题：HRPWM与数字比较模块浅析

对于TMS320F28002x，其ePWM模块还支持高分辨率PWM和数字比较等高级功能，这些也有对应的寄存器-函数映射。

  • 高分辨率PWM：通过微边沿定位器（MEP）技术，在普通的时基时钟边沿之间插入精细的时间调整，实现远超系统时钟频率限制的PWM分辨率。相关函数以HRPWM_为前缀，主要操作HRCNFG、HRMSTEP、TBPRDHR、CMPAHR等寄存器。例如，HRPWM_setMEPEdgeSelect用于选择MEP控制的边沿，HRPWM_setCounterCompareValue用于设置高精度的比较值（同时写入CMPA和CMPAHR）。

    • 注意：HRPWM功能依赖于特定的校准，TI提供了HRPWM_cal()函数，必须在初始化时调用，以获取并设置芯片特定的MEP缩放因子。

  • 数字比较模块：这是ePWM模块与外部数字信号（如来自比较器、GPIO）进行复杂交互的桥梁。通过DCTRIPSEL选择故障源，DCACTL配置比较逻辑和滤波，TZDCSEL和TZCTL将数字比较事件连接到错误联防动作。它允许基于复杂的逻辑条件（如信号A高且信号B低）来触发PWM保护，比简单的Trip-Zone输入更灵活。

    • 应用场景：实现逐周期电流限流。电流信号通过比较器转换为数字信号，连接到DCAH/DCAL。当数字比较器触发时，通过配置可以产生CBC（逐周期）故障，在下一个PWM周期立即关闭输出，实现纳秒级的快速保护。

掌握从寄存器到Driverlib函数的映射关系，绝非为了让你回去直接操作寄存器，而是为了构建一个坚实的底层认知框架。当Driverlib的API无法满足你极其特殊的配置需求时，你可以自信地直接操作寄存器；当遇到诡异的硬件行为时，你能透过函数调用，直指问题所在的寄存器位域；当阅读TI的示例代码或库源码时，你能一眼看穿其设计意图。这份映射表，就是你游刃有余地驾驭TMS320F28002x强大ePWM和eCAP模块的罗盘与解剖刀。