企业官网建设流程全解析

1. 项目概述：从eCAP到HRCAP的精度跃迁

在电机控制、数字电源或者任何需要精确测量时间间隔的嵌入式实时控制项目中，我们常常会遇到一个核心挑战：如何以尽可能高的精度，捕获一个外部脉冲的上升沿或下降沿发生的“确切时刻”。对于TMS320F28002x这类C2000系列微控制器，增强型捕获（eCAP）模块是解决这个问题的标准答案。但标准eCAP的精度受限于系统时钟（SYSCLK）的分辨率，当我们需要测量纳秒级的时间差，或者信号频率极高时，标准模式就显得力不从心了。

这时，高分辨率捕获（HRCAP）模块的价值就凸显出来了。它并不是一个独立于eCAP的全新外设，而是对现有eCAP模块的“增强补丁包”。你可以把它理解为一个为eCAP装上的“高倍显微镜”，让原本基于SYSCLK计数的“粗刻度尺”，变成了基于更高频率、异步时钟（HRCLK）的“游标卡尺”。我最初接触HRCAP是为了一个无刷直流电机的瞬时转速测量项目，标准eCAP在电机高速运行时，一个计数周期对应的时间跨度太大，导致转速计算波动剧烈。启用HRCAP后，测量分辨率提升了一个数量级，控制环路稳定性得到了质的改善。

本文将以TMS320F28002x为平台，深入剖析eCAP/HRCAP模块，特别是其同步输入选择机制（ECAPSYNCINSEL寄存器）和实现高精度捕获的核心原理。我不会仅仅罗列寄存器字段，而是结合我实际调试中的踩坑经验，告诉你每个配置项背后的设计意图、如何避开常见的陷阱，以及如何将DriverLib库函数与底层寄存器操作对应起来，构建稳定可靠的高精度测量系统。无论你是正在评估HRCAP用于电容触摸检测，还是需要它来提升你的控制环路性能，这篇文章都能提供从理论到实践的完整路径。

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

在深入HRCAP之前，我们必须先夯实eCAP的基础。eCAP模块的本质是一个带有多级缓冲的精密数字秒表。它的核心是一个32位的时间基准计数器（TSCTR），这个计数器由SYSCLK驱动，不断向上计数。当外部引脚（例如GPIO2）上发生你预设的事件（比如上升沿）时，eCAP模块会瞬间“冻结”当前TSCTR的值，并将其存入一个捕获寄存器（CAP1, CAP2, CAP3, CAP4）中。通过计算连续两次捕获值的差值，你就能得到两个事件之间的精确时间间隔（以SYSCLK周期数为单位）。

2.1 eCAP的四种核心工作模式

eCAP模块非常灵活，主要通过ECCTL2寄存器的CAP/APWM位来切换两大模式，而捕获模式内部又有细分：

2.1.1 捕获模式（Capture Mode）这是最经典的模式，用于测量外部事件。它又分为两种子模式：

• 单次捕获模式（One-Shot）：配置好后，模块会连续捕获最多4个事件（对应CAP1-CAP4），然后停止并等待你处理。这就像给秒表设置了4个“分段计时”点，录满后暂停。适用于你需要捕获特定数量脉冲宽度的场景，比如测量一个已知周期数波形的占空比。
• 连续捕获模式（Continuous）：捕获寄存器CAP1-CAP4构成一个4级深度的环形缓冲区。当第4个事件捕获到CAP4后，下一个事件会自动覆盖CAP1，如此循环。这就像秒表在循环记录最近4次的时间点，适合持续监控信号，你只需要定期读取最新的捕获值即可。

2.1.2 APWM模式（APWM Mode）这是一个容易被忽略但极其有用的模式。在此模式下，eCAP模块摇身一变，成为一个单通道的PWM发生器。CAP1和CAP2寄存器分别被用作周期值（APRD）和比较值（ACMP），可以产生一个独立的PWM信号。这个功能常用于需要生成一个与主ePWM模块同步或异步的辅助PWM，例如在电源电路中生成一个互补的驱动信号，或者作为故障保护信号的输出。

2.1.3 绝对时间与差分时间模式在捕获模式下，还有一个关键选择：时间戳是绝对的还是差分的。

• 绝对时间模式：每次捕获的都是TSCTR计数器的绝对计数值。计算脉宽需要软件做减法（例如，脉宽 = CAP2 - CAP1）。
• 差分时间模式：这是eCAP的硬件加速功能。通过配置ECCTL1[CTRRSTx]位，你可以让特定的事件（如CAP1事件）触发TSCTR计数器复位。这样，CAP2捕获到的就是相对于CAP1事件的时间差，直接就是脉宽值。这减少了软件计算量，但使用时需特别注意，下文会详细展开。

2.2 同步输入选择（ECAPSYNCINSEL）的实战意义

现在我们来聚焦输入材料中提到的ECAPSYNCINSEL寄存器。这个寄存器的存在，揭示了eCAP模块在复杂系统中的“团队协作”能力。它的核心功能是选择SYNCIN信号的来源。

SYNCIN信号是什么？你可以把它理解为eCAP模块的“起跑线”发令枪。当eCAP模块配置为需要外部同步时（通过ECCTL2[SYNCI_EN]使能），这个SYNCIN脉冲可以触发两个关键动作：

1. 时间基准计数器（TSCTR）同步：让多个eCAP模块的TSCTR从同一个起点开始计数，实现多个捕获通道间的严格时间对齐。
2. 相位寄存器（CTRPHS）加载：将CTRPHS寄存器中的值加载到TSCTR中，实现预设相位偏移的同步启动。

ECAPSYNCINSEL[SEL]字段的配置选项解读：

• 0h：禁用同步输入。eCAP模块独立运行。
• 1h - 7h：选择EPWMxSYNCOUT作为同步源。这是最常用的同步方式。例如，在电机控制中，你可以让eCAP模块与某个ePWM模块同步，这样捕获的脉冲时间就是相对于PWM载波周期的精确位置，非常适合测量电流采样窗口或位置传感器信号与驱动波形的关系。
• 11h - 13h：选择另一个ECAPxSYNCOUT作为同步源。可以实现eCAP模块之间的级联同步。
• 18h - 19h：选择INPUTXBAROUT5/6作为同步源。输入交叉开关（Input X-BAR）是一个灵活的路由网络，可以将几乎任何外部引脚或内部事件（如ADC转换完成）路由过来。这为系统级同步提供了无限可能。

实操心得：同步的时机配置同步时，一个常见的坑是同步事件发生时，eCAP模块还未准备就绪（例如计数器未使能）。可靠的做法是：先配置好eCAP的所有参数并使能计数器，最后再配置并触发同步源（如ePWM的同步输出）。确保同步脉冲到来时，eCAP已经“在起跑线上就位”。

3. HRCAP高分辨率捕获机制深度剖析

当标准eCAP的SYSCLK分辨率无法满足需求时，HRCAP登场了。它的设计非常巧妙：复用eCAP的捕获流程和寄存器，但在信号路径上插入了一个高精度的“插值器”。

3.1 HRCAP的核心创新：双时钟域与硬件校准

标准eCAP的瓶颈在于，其捕获时刻的“对齐”是到SYSCLK边沿的。如果事件发生在两个SYSCLK脉冲之间，你无法知晓其确切位置。HRCAP的解决方案是引入一个频率更高、但与SYSCLK不同步的时钟——HRCLK。

3.1.1 工作原理（生活化类比）想象一下，你和朋友用两块秒表（一块普通秒表A，一块高速摄影机B）记录短跑运动员撞线的瞬间。

• 标准eCAP：只使用秒表A（SYSCLK）。你只能在秒表A的整秒刻度（如1.0s， 2.0s）记录，如果运动员在1.23秒撞线，你只能记录为1秒或2秒，误差很大。
• HRCAP：同时使用秒表A和高速摄影机B（HRCLK）。摄影机B的帧率极高（比如每秒1000帧）。当运动员撞线时，系统不仅记录秒表A的整秒数（例如第1秒），还会记录摄影机B在这一秒内拍到的第几帧（例如第230帧）。通过一个校准系数（知道摄影���B的“帧速率”相对于秒表A“秒速”的实际比例），你就能计算出精确到毫秒甚至更细的撞线时间：1秒 + 230帧 * (1秒/1000帧) = 1.230秒。

在HRCAP中：

• HRSYSCLKCAP寄存器就是“秒表A记录的整秒数”。
• HRCLKCAP寄存器就是“摄影机B在该秒内记录的帧数”。
• 校准的过程，就是动态测量“摄影机B的帧速率（HRCLK）”与“标准秒速（SYSCLK）”之间的精确比例关系（即ScaleFactor）。

3.2 HRCAP寄存器组详解与驱动函数映射

输入材料提供了完整的HRCAP寄存器列表。我们结合DriverLib函数来理解它们，这比直接操作寄存器更高效、更安全。

3.2.1 控制与状态寄存器（HRCTL）这是HRCAP的“总开关”。

• HRCLKE (Bit 1)：HRCLK使能位。必须在使能HRCAP模块前打开此时钟，并等待至少1μs使其稳定。对应函数：HRCAP_enableHighResolutionClock()。
• HRE (Bit 0)：高分辨率模式使能位。这是激活HRCAP增强功能的终极开关。对应函数：HRCAP_enableHighResolution()。
• CALIBSTART (Bit 3)：写1启动一次校准周期。通常由HRCAP_startCalibration()函数设置。
• CALIBCONT (Bit 5)：连续校准模式。对于需要长期高精度测量的应用（如电容触摸），建议使能，让校准在后台持续运行。

3.2.2 校准周期寄存器（HRCALPRD）此寄存器决定每次校准持续多长时间（以SYSCLK周期数为单位）。它匹配的是HRSYSCLKCTR计数器。设置越大，校准采样时间越长，理论上得到的ScaleFactor越准确，但校准间隔也越长。需要根据系统实时性要求和精度需求折中。通过HRCAP_setCalibrationPeriod()函数配置。

3.2.3 校准计数器与捕获寄存器（HRSYSCLKCTR, HRCLKCTR, HRSYSCLKCAP, HRCLKCAP）这是校准逻辑的核心。

• HRSYSCLKCTR和HRCLKCTR：两个自由运行的计数器，分别由SYSCLK和HRCLK驱动。校准开始时从0计数。
• HRSYSCLKCAP和HRCLKCAP：当HRSYSCLKCTR计数到HRCALPRD设定的值时，硬件会自动将两个计数器的当前值捕获到这两个寄存器中，然后计数器清零，并触发校准完成中断（CALIBDONE）。
• 关键函数：HRCAP_getCalibrationClockPeriod()。这个函数返回的并非周期，而是一个结构体，包含了HRSYSCLKCAP和HRCLKCAP的捕获值。你需要用这两个值来计算比例因子。

3.2.4 中断相关寄存器（HRINTEN, HRFLG, HRCLR, HRFRC）管理校准过程的中断。

• HRINTEN：中断使能寄存器。通常使能CALIBDONE（校准完成）中断即可。
• HRFLG：中断标志寄存器。读取CALIBDONE标志判断校准是否完成。
• HRCLR：中断清除寄存器。在中断服务程序中写1清除对应标志。
• HRFRC：中断强制寄存器。主要用于调试，可以软件强制触发中断。

3.3 比例因子（ScaleFactor）的计算与应用

这是HRCAP精度提升的数学核心。比例因子定义了HRCLK周期与SYSCLK周期的关系。

计算公式（来自技术手册）：ScaleFactor = HRSYSCLKCAP / HRCLKCAP

这个公式的物理意义是：平均每个HRCLK周期对应多少个SYSCLK周期。由于HRCLK频率通常远高于SYSCLK，所以ScaleFactor是一个小于1的小数。

如何将原始捕获值转换为真实时间（纳秒）？技术手册给出了公式，但DriverLib提供了更便捷的函数：

1. 获取原始捕获值：像普通eCAP一样，从CAPx寄存器读取值，这个值现在是HRCLK的周期数。使用ECAP_getEventTimeStamp()。
2. 获取比例因子：在校准完成中断中，调用HRCAP_getScaleFactor()，该函数内部会读取HRSYSCLKCAP和HRCLKCAP并完成除法计算。
3. 转换为时间：调用HRCAP_getEventTimeStampNanoseconds(rawCount, scaleFactor, sysClkFreq)。这个函数封装了手册中的换算公式：时间(ns) = (rawCount * scaleFactor * 128 / sysClkFreq) * 10^9。其中128是HRCAP硬件的一个固定缩放因子。

注意事项：比例因子的动态性HRCLK的频率受芯片温度和供电电压影响会漂移。因此，ScaleFactor不是常数！这就是为什么需要周期性校准。对于连续运行的高精度应用，务必使能连续校准模式（CALIBCONT=1），并在每次校准完成中断中更新使用的ScaleFactor。对于单次或短时测量，可以在测量前进行一次校准并使用该结果。

4. eCAP/HRCAP完整配置流程与代码实战

理解了原理，我们来看如何从零开始配置一个eCAP/HRCAP通道。我将以“测量GPIO2输入脉冲的高电平宽度”为例，展示从eCAP基础模式到HRCAP高精度模式的完整代码流程。

4.1 eCAP基础模式配置步骤

首先，我们配置eCAP3工作在连续捕获模式，捕获GPIO2的上升沿和下降沿。

#include "driverlib.h" #include "device.h" // 全局变量存储捕获值 volatile uint32_t cap1Val = 0, cap2Val = 0; volatile float pulseWidthNs = 0.0; // 脉宽（纳秒） void initECAP3(void) { // 步骤1：使能eCAP3模块时钟 SysCtl_enablePeripheral(SYSCTL_PERIPH_CLK_ECAP3); // 步骤2：配置GPIO2为eCAP3输入功能 // 假设GPIO2对应eCAP3的输入引脚，具体映射需查数据手册 GPIO_setPinConfig(GPIO_2_ECAP3); GPIO_setQualificationMode(2, GPIO_QUAL_SYNC); // 可选：设置输入同步，滤除毛刺 // 步骤3：初始化eCAP模块为默认状态（寄存器复位） ECAP_reset(ECAP3_BASE); // 步骤4：配置捕获事件 // 选择输入源：通常为ECAPx引脚 ECAP_selectECAPInput(ECAP3_BASE, ECAP_INPUT_INPUTXBAR); // 设置事件1为上升沿捕获，事件2为下降沿捕获 ECAP_setEventPolarity(ECAP3_BASE, ECAP_EVENT_1, ECAP_EV_POL_RISING); ECAP_setEventPolarity(ECAP3_BASE, ECAP_EVENT_2, ECAP_EV_POL_FALLING); // 设置事件分频器：每个事件都捕获（不分频） ECAP_setEventPrescaler(ECAP3_BASE, ECAP_EVENT_1, 1); ECAP_setEventPrescaler(ECAP3_BASE, ECAP_EVENT_2, 1); // 使能事件1和事件2触发时间戳捕获 ECAP_enableTimeStampCapture(ECAP3_BASE, ECAP_EVENT_1); ECAP_enableTimeStampCapture(ECAP3_BASE, ECAP_EVENT_2); // 配置为连续捕获模式，4级缓冲 ECAP_setCaptureMode(ECAP3_BASE, ECAP_CONTINUOUS_CAPTURE, ECAP_EVENT_1); ECAP_setCaptureMode(ECAP3_BASE, ECAP_CONTINUOUS_CAPTURE, ECAP_EVENT_2); // 使能计数器在事件1（上升沿）复位，这样CAP2直接就是高电平脉宽（差分模式） ECAP_enableCounterResetOnEvent(ECAP3_BASE, ECAP_EVENT_1); // 注意：如果使用绝对模式，则禁用此功能，脉宽需软件计算 CAP2 - CAP1 // 步骤5：配置中断（可选，用于通知CPU读取数据） ECAP_enableInterrupt(ECAP3_BASE, ECAP_INT_CAPTURE_EVENT_2); // 下降沿捕获完成中断 ECAP_clearInterrupt(ECAP3_BASE, ECAP_INT_CAPTURE_EVENT_2); Interrupt_register(INT_ECAP3, &ecap3ISR); Interrupt_enable(INT_ECAP3); // 步骤6：使能计数器并开始捕获 ECAP_startCounter(ECAP3_BASE); } // eCAP3中断服务程序 __interrupt void ecap3ISR(void) { // 读取捕获值 cap1Val = ECAP_getEventTimeStamp(ECAP3_BASE, ECAP_EVENT_1); // 上升沿时间戳 cap2Val = ECAP_getEventTimeStamp(ECAP3_BASE, ECAP_EVENT_2); // 下降沿时间戳（即脉宽，因为计数器在上升沿复位了） // 计算脉宽（假设SYSCLK = 100MHz，周期10ns） pulseWidthNs = (float)cap2Val * 10.0; // 单位：纳秒 // 清除中断标志 ECAP_clearInterrupt(ECAP3_BASE, ECAP_INT_CAPTURE_EVENT_2); // 在连续模式下，需要重新“武装”捕获寄存器以便继续捕获 ECAP_reArm(ECAP3_BASE); // 确认中断已处理 Interrupt_clearACKGroup(INTERRUPT_ACK_GROUP7); }

4.2 升级至HRCAP高精度模式配置步骤

在基础eCAP配置之上，我们添加HRCAP的初始化和校准流程。

#include "hrcap.h" // 确保包含HRCAP驱动头文件 volatile float scaleFactor = 0.0; // 动态更新的比例因子 volatile bool isCalibrationDone = false; void initHRCAP3(void) { // 前提：已经完成上述eCAP3的基础配置（但不一定启动计数器） // HRCAP专属初始化序列（严格按照顺序！） // 步骤1：使能HRCLK时钟 HRCAP_enableHighResolutionClock(HRCAP3_BASE); // 关键：必须等待至少1us，让HRCLK稳定。使用Device_delay()或空循环。 DEVICE_DELAY_US(2); // 建议稍大于1us // 步骤2：使能高分辨率模式 HRCAP_enableHighResolution(HRCAP3_BASE); DEVICE_DELAY_US(2); // 再次等待稳定 // 步骤3：配置校准周期。例如，设置校准持续 0xFFFFF 个SYSCLK周期。 // 校准时间 = HRCALPRD / SYSCLK频率。例如 0xFFFFF / 100MHz ≈ 10.5ms HRCAP_setCalibrationPeriod(HRCAP3_BASE, 0xFFFFF); // 步骤4：配置为连续校准模式（后台自动重复校准） HRCAP_setCalibrationMode(HRCAP3_BASE, HRCAP_CALIB_CONTINUOUS); // 步骤5：使能校准完成中断 HRCAP_enableCalibrationInterrupt(HRCAP3_BASE, HRCAP_INT_CALIB_DONE); HRCAP_clearCalibrationFlags(HRCAP3_BASE, HRCAP_INT_CALIB_DONE); Interrupt_register(INT_HRCAP3_CAL, &hrcap3CalISR); // HRCAP校准有独立中断向量 Interrupt_enable(INT_HRCAP3_CAL); // 步骤6：启动首次校准 HRCAP_startCalibration(HRCAP3_BASE); // 步骤7：现在可以启动eCAP计数器，开始高精度捕获 ECAP_startCounter(ECAP3_BASE); } // HRCAP校准中断服务程序 __interrupt void hrcap3CalISR(void) { uint32_t status = HRCAP_getCalibrationFlags(HRCAP3_BASE); if (status & HRCAP_INT_CALIB_DONE) { // 校准完成，获取新的比例因子 scaleFactor = HRCAP_getScaleFactor(HRCAP3_BASE); isCalibrationDone = true; // 通知主循环或任务 // 如果需要，也可以读取原始的SYSCLK和HRCLK计数值 // HRCAP_CalibrationClockPeriod_t calVal; // calVal = HRCAP_getCalibrationClockPeriod(HRCAP3_BASE); // uint32_t sysClkCount = calVal.sysClkCount; // uint32_t hrClkCount = calVal.hrClkCount; } if (status & HRCAP_INT_CALIB_PERIOD_CHECK) { // 校准周期检查状态（计数器溢出），通常意味着HRCALPRD设置过大 // 应缩短校准周期或检查系统时钟 } // 清除中断标志 HRCAP_clearCalibrationFlags(HRCAP3_BASE, status); Interrupt_clearACKGroup(INTERRUPT_ACK_GROUP7); // 根据实际中断组确认 } // 在主循环或捕获中断中，使用比例因子计算高精度时间 void processHighResCapture(void) { if (isCalibrationDone) { uint32_t rawCount = ECAP_getEventTimeStamp(ECAP3_BASE, ECAP_EVENT_2); // 使用DriverLib函数直接转换为纳秒 pulseWidthNs = HRCAP_getEventTimeStampNanoseconds(rawCount, scaleFactor, DEVICE_SYSCLK_FREQ); // 或者手动计算（与上述函数等效）： // float sysClkPeriodNs = 1.0e9 / DEVICE_SYSCLK_FREQ; // 系统时钟周期(ns) // pulseWidthNs = (float)rawCount * scaleFactor * 128.0 * sysClkPeriodNs; } }

5. 同步输入（ECAPSYNCINSEL）高级应用与系统集成

现在，我们将同步功能融入上述高精度测量场景，构建一个更复杂的系统示例：使用ePWM1的同步输出（SYNCOUT）来同步eCAP3的计数器，测量PWM开关周期内某个特定事件的发生时间。这在测量电机相电流相对于PWM占空比的位置时非常有用。

5.1 系统同步配置步骤

目标是：每当ePWM1的时基计数器（TBCTR）为零时（即每个PWM周期开始），产生一个同步脉冲给eCAP3，让eCAP3的TSCTR计数器从零开始计数或加载一个相位值。

void initEPWM1ForSync(void) { // 初始化ePWM1... EPWM_setTimeBasePeriod(EPWM1_BASE, 1000); // 设置PWM周期 EPWM_setPhaseShift(EPWM1_BASE, 0); EPWM_setTimeBaseCounter(EPWM1_BASE, 0); // 配置ePWM1的同步输出源 // 选择当时基计数器为零时，产生同步输出脉冲 EPWM_setSyncOutPulseMode(EPWM1_BASE, EPWM_SYNC_OUT_PULSE_ON_COUNTER_ZERO); // 使能ePWM1的同步输出 EPWM_enableSyncOut(EPWM1_BASE); } void initECAP3WithSync(void) { // 先完成eCAP3的基础和HRCAP初始化（如前所述） initECAP3(); // 假设此函数已包含GPIO、事件等配置 initHRCAP3(); // 使能高分辨率模式 // 关键步骤：配置同步输入源为EPWM1SYNCOUT // 对应ECAPSYNCINSEL寄存器的SEL字段设置为 1h ECAP_setSyncInPulseSource(ECAP3_BASE, ECAP_SYNC_IN_PULSE_SRC_EPWM1SYNCOUT); // 配置eCAP3的同步行为 // 使能同步输入 ECAP_enableSyncIn(ECAP3_BASE); // 设置同步事件的动作：让同步脉冲复位TSCTR计数器（从0开始计数） ECAP_setSyncOutMode(ECAP3_BASE, ECAP_SYNC_OUT_SYNC_IN); // 此函数名易误解，实际是配置同步输入行为 // 更精确的控制可能需要直接配置ECCTL2寄存器的SYNCI_EN和CTRFILTRESET等位 // 例如，设置同步时加载相位寄存器值： // ECAP_setPhaseShiftCount(ECAP3_BASE, 500); // 设置相位值为500 // 然后配置同步时加载相位值，而非简单复位 // 启动ePWM1计数器，它将开始产生同步脉冲 EPWM_startTimeBaseCounter(EPWM1_BASE); // 最后，启动eCAP3计数器。它将等待第一个同步脉冲到来后开始计数。 ECAP_startCounter(ECAP3_BASE); }

经过此配置，eCAP3的TSCTR计数器将与ePWM1的周期严格对齐。此时，eCAP3捕获到的事件时间戳（CAPx值），直接代表了该事件在当前PWM周期内的偏移位置（以HRCLK周期数计）。通过换算成时间，你可以精确知道事件发生在PWM周期开始后的多少纳秒。

5.2 使用输入交叉开关（INPUT X-BAR）的灵活同步

ECAPSYNCINSEL寄存器还支持从INPUTXBAROUT5或6选择同步源。这打开了更灵活的同步可能性。例如，你可以将一个外部数字编码器的索引信号（Index）或一个ADC的转换启动信号（SOC）通过输入交叉开关路由过来，作为eCAP的同步源。

void initSyncFromInputXbar(void) { // 假设将GPIO10上的外部信号路由到INPUTXBAROUT5 GPIO_setPinConfig(GPIO_10_GPIO10); // 先配置为GPIO输入 InputXbar_setInput(INPUTXBAR_BASE, INPUTXBAR_INPUT10, 10); // 将GPIO10映射到内部输入10 InputXbar_setOutputMux(INPUTXBAR_BASE, INPUTXBAR_OUTPUT5, INPUTXBAR_INPUT10); // 将内部输入10输出到OUT5 // 配置eCAP3使用INPUTXBAROUT5作为同步源 // 对应ECAPSYNCINSEL寄存器的SEL字段设置为 18h ECAP_setSyncInPulseSource(ECAP3_BASE, ECAP_SYNC_IN_PULSE_SRC_INPUTXBAR_OUT5); // 使能eCAP3同步输入 ECAP_enableSyncIn(ECAP3_BASE); // ... 其他eCAP配置 }

这种配置允许eCAP模块与系统中几乎任何事件同步，极大地增强了系统级时序协调能力。

6. 常见问题排查与实战避坑指南

在实际项目中使用eCAP/HRCAP，尤其是HRCAP，会遇到一些教科书上不会提及的问题。以下是我从多个项目中总结出的典型问题与解决方案。

6.1 HRCAP测量结果跳动大或不准确

这是启用HRCAP后最常见的问题。

• 问题现象：即使输入信号稳定，换算出的时间值也在几十纳秒甚至更大范围内跳动。
• 排查步骤与解决：
  1. 检查HRCLK使能与稳定时间：确保在调用HRCAP_enableHighResolutionClock()后，有足够的延迟（DEVICE_DELAY_US(2)是安全的）。时间不足会导致HRCLK未稳定工作。
  2. 确认SYSCLK频��：HRCAP要求SYSCLK > 100MHz。使用DEVICE_SYSCLK_FREQ宏确认你的系统时钟配置正确。
  3. 检查电源噪声：HRCLK对1.2V核心电压（VDD）的噪声非常敏感。确保电源电路设计良好，去耦电容靠近芯片引脚。在软件上，避免在HRCAP测量期间频繁开关其他外设时钟或进行大量内存操作，这些都可能引入电源噪声。
  4. 校准周期（HRCALPRD）是否合适？周期太短，校准采样不足，ScaleFactor噪声大；周期太长，ScaleFactor更新慢，无法跟踪HRCLK漂移。建议从0xFFFFF（约10ms @100MHz）开始测试，根据测量稳定性和系统实时性要求调整。
  5. 是否使用了连续校准？对于需要长时间稳定测量的应用，务必使能HRCAP_setCalibrationMode(..., HRCAP_CALIB_CONTINUOUS)，并确保校准中断能正常执行，实时更新scaleFactor。
  6. 测量模式选择：绝对时间模式是HRCAP的推荐模式。如果使用差分模式（计数器复位），务必注意技术手册的警告：实际捕获值需要减去触发复位那个事件的“分数值”。这个计算复杂且易错，在HRCAP模式下更推荐使用绝对时间模式，在软件中做减法。

6.2 无法进入捕获中断或校准中断

• 问题现象：配置了中断，但中断服务程序从未被调用。
• 排查步骤：
  1. 中断向量表与注册：确认在Interrupt_register()中使用了正确的中断号。eCAP捕获中断和HRCAP校准中断是两个不同的中断向量（如INT_ECAP3和INT_HRCAP3_CAL）。
  2. 中断使能层级：检查三层使能是否全部打开：
     • 外设级：ECAP_enableInterrupt()/HRCAP_enableCalibrationInterrupt()。
     • PIE级：Interrupt_enable()。
     • CPU级：EINT;（全局中断使能）。
  3. 中断标志清除：在中断服务程序开始时，是否先清除了外设中断标志（ECAP_clearInterrupt/HRCAP_clearCalibrationFlags）？顺序很重要，应先读数据，再清标志。
  4. 中断ACK：在中断服务程序退出前，是否清除了正确的PIE组应答（Interrupt_clearACKGroup()）？eCAP3通常属于GROUP7。

6.3 同步功能不起作用

• 问题现象：配置了同步源，但eCAP计数器似乎没有按照预期被复位或加载相位。
• 排查步骤：
  1. 同步源是否有输出：首先确认你的同步源（如ePWM1）确实产生了同步脉冲。可以通过配置该同步源到一个GPIO输出观察波形，或者检查其同步输出标志位。
  2. ECAPSYNCINSEL配置：确认ECAP_setSyncInPulseSource函数参数正确，与硬件连接一致。
  3. 同步使能：确认调用了ECAP_enableSyncIn(ECAP3_BASE)。
  4. 时序问题：确保在eCAP计数器启动（ECAP_startCounter）之前，同步源已经开始工作。否则，第一个同步脉冲可能被错过。更稳健的做法是，先启动eCAP计数器（它会在当前值计数），然后使能同步源，当同步脉冲到来时，计数器会立即被复位或加载相位。
  5. 直接寄存器调试：在调试器中，直接查看ECAPSYNCINSEL寄存器的值，确认SEL字段已被正确写入。

6.4 HRCAP校准中断过于频繁或从不发生

• 问题现象：校准中断疯狂触发，或者一直不触发。
• 排查步骤：
  1. HRCALPRD值过小：如果设置的值太小，校准会很快完成，导致中断频率过高。增大此值。
  2. 计数器溢出：如果HRSYSCLKCTR或HRCLKCTR在达到HRCALPRD之前就溢出了（超过32位最大值），会触发CALPRDCHKSTS标志，并可能产生中断。这通常意味着HRCALPRD设置得过大，超出了校准计数器的最大计数时间。需要减小HRCALPRD。
  3. 中断标志未清除：如果校准完成中断标志CALIBDONE没有被及时清除，后续的中断可能无法产生。确保在中断服务程序中调用HRCAP_clearCalibrationFlags。
  4. 检查HRCAP_isCalibrationBusy()：在启动校准后，可以调用此函数查询校准状态，确认校准是否真的启动了。

6.5 性能与资源权衡建议

• CPU开销：HRCAP的连续校准和中断处理会带来一定的CPU开销。对于极高频率的捕获事件（如MHz级别），CPU可能来不及处理每次捕获中断。此时，应使用DMA将捕获寄存器（CAPx）的数据直接搬运到内存，或者使用单次捕获模式（One-Shot）配合深度缓冲，让CPU批量处理。
• eCAP与HRCAP模式切换：一旦使能HRCAP（HRE=1），事件滤波器和输入限定器将失效，因为HRCAP工作在异步时钟域。如果你的应用需要抗抖动滤波，必须在使能HRCAP前，在GPIO模块或输入交叉开关级别配置好输入同步。
• 精度与系统负载的平衡：HRCAP的精度在系统负载轻、电源干净时最高。在电机驱动等大功率应用中，开关噪声可能影响精度。可以考虑在关键的测量窗口（如电流采样期间）暂时关闭PWM驱动或其他噪声源，进行“安静”测量。

通过以上详细的原理剖析、代码示例和问题排查指南，你应该能够驾驭TMS320F28002x的eCAP和HRCAP模块，将它们强大的同步与高精度捕获能力应用到你的实时控制系统中。记住，理解每个寄存器位和函数调用背后的硬件行为，是稳定发挥其性能的关键。