C2000 eQEP边沿捕获单元：实现高精度低速速度测量的硬件T法测速-开发者社区

1. 项目概述：为什么低速速度测量是个“技术活”？

在电机控制、机器人关节或者精密仪表的开发中，我们经常需要知道一个旋转或直线运动的物体“跑得有多快”。对于高速运动，方法很多，比如直接测量单位时间内的脉冲数（M法测速）。但当速度降下来，特别是接近零速或极低速时，问题就来了：你可能等了好几秒，才等到一个编码器脉冲，这期间速度是零吗？还是说它其实在非常缓慢地移动？传统的M法在这里完全失效，分辨率极差，而且CPU需要频繁中断去计数，效率低下。

这时候，eQEP（Enhanced Quadrature Encoder Pulse）外设中的边沿捕获单元（Edge Capture Unit）就派上了大用场。它的核心思路非常巧妙：既然低速时脉冲间隔很长，那我就不数脉冲了，我改去精确测量两个脉冲之间的时间。你动得越慢，脉冲间隔ΔT就越大，我测量到的这个时间值就越精确。然后，用一个已知的、固定的最小位置变化量X（比如，对应编码器的1/4个电气周期，也就是一个正交边沿），套用公式速度v = X / ΔT，就能算出瞬时速度。这种方法被称为T法测速，在低速区拥有极高的分辨率和精度。

TI的C2000系列DSP（如TMS320F2837xD）将这套逻辑硬件化了，这就是eQEP的边沿捕获单元。它把最耗时的“掐表”工作从CPU手里接了过来，CPU只需要在合适的时候去读取硬件“掐”好的时间结果就行，大大解放了算力，让系统能更专注于核心的控制算法。今天，我们就来彻底拆解这个单元，从原理、寄存器配置到实际代码实现，让你不仅能看懂手册，更能真正用起来。

2. 边沿捕获单元的核心原理与架构拆解

要理解边沿捕获单元，我们得先把它想象成一个高度自动化的“秒表”系统。这个系统不是随便掐表，而是严格地在编码器移动到某个特定“里程碑”（单位位置事件）时，自动记录时间戳。

2.1 核心概念定义

单位位置事件（Unit Position Event, UPEVNT）：这是整个测量的“发令枪”。它不是每一个编码器脉冲（QCLK）都触发，而是每累积N个QCLK边沿才产生一次。这个N由QCAPCTL[UPPS]位配置，可以是1, 2, 4, ..., 最高2048。为什么要这样？为了抗抖动和适应不同分辨率。一个10000线的编码器，每转会产生40000个QCLK。如果每个QCLK都触发捕获，在低速时数据会过于频繁且变化不大；通过设置UPPS，我们可以让“里程碑”之间的距离（X）变大，这样测出的ΔT也更大，速度计算更稳定。X = N × P，其中P是单个QCLK周期对应的位置增量。
捕获定时器（QCTMR）：这就是那块“秒表”。它由一个自由运行的16位计数器构成，时钟源是系统时钟SYSCLKOUT经过QCAPCTL[CCPS]预分频后的CAPCLK。CAPCLK的频率决定了这块“秒表”的计时精度。例如，SYSCLKOUT=200MHz，CCPS设置为/2，则CAPCLK=100MHz，计时分辨率就是10ns。
捕获周期寄存器（QCPRD）与锁存器（QCPRDLAT）：这是“秒表”的“读数寄存器”。当单位位置事件（UPEVNT）发生时，硬件会自动做两件事：1) 将当前QCTMR的值锁存到QCPRD寄存器；2) 将QCTMR清零，重新开始计时。同时，状态寄存器QEPSTS[UPEVNT]标志位会被置1，告诉CPU：“新的时间间隔数据准备好了，快来读！”而QCPRDLAT是一个影子寄存器，用于确保软件能读取到一个完整的、稳定的时间值，避免在硬件更新QCPRD的瞬间读到错误数据。

2.2 工作流程与数据流

让我们结合一个低速旋转的场景，梳理一下数据是如何流动的：

初始化：配置QCAPCTL寄存器，使能捕获单元（CEN=1），设置好UPPS（决定“里程碑”间隔）和CCPS（决定“秒表”走速）。配置QEPCTL寄存器，选择捕获锁存模式（QCLM位），例如选择在单位超时事件（Unit Timeout）时锁存。
运动开始：电机开始缓慢旋转，编码器产生正交脉冲（QA, QB）。
事件触发：eQEP解码电路将QA/QB转换为方向信号和计数脉冲QCLK。每产生N个QCLK（由UPPS决定），硬件内部生成一个单位位置事件（UPEVNT）。
时间捕获：在UPEVNT的上升沿，硬件自动执行“锁存-清零”操作：QCPRD = QCTMR，然后QCTMR = 0。此时，QCPRD中存储的值，就是从上一次UPEVNT到本次UPEVNT所经过的CAPCLK周期数。
数据就绪：QEPSTS[UPEVNT]标志位置1。如果使能了中断，可能会产生中断。
软件读取：在速度计算循环或中断服务程序中，软件首先检查QEPSTS[UPEVNT]是否为1。如果是，则从QCPRDLAT（或QCPRD，取决于锁存模式）中读取捕获的周期值delta_T_counts。
速度计算：将计数值转换为时间：ΔT = delta_T_counts * (1 / CAPCLK_freq)。然后，结合已知的单位位置变化量X（单位：米、弧度等，由机械系统和UPPS共同决定），计算速度：v = X / ΔT。
标志清除：软件向QEPSTS[UPEVNT]位写1，清除该标志，等待下一次位置事件。

这个过程完全由硬件自动完成，CPU的介入被降到最低，仅需在数据就绪时进行读取和计算，实现了高效、实时的低速速度测量。

2.3 两种锁存模式详解

边沿捕获单元提供了两种数据锁存触发方式，通过QEPCTL[QCLM]位选择，这是配置中的关键点：

模式0（QCLM=0）：CPU读取位置计数器时锁存
- 机制：当软件读取位置计数器寄存器QPOSCNT时，硬件会同步将当前的QCTMR和QCPRD值分别锁存到QCTMRLAT和QCPRDLAT中。
- 应用场景：适用于非周期性的、按需读取速度的场景。例如，在调试过程中，你想在某个特定时刻手动触发一次速度采样。或者，你的速度环控制周期不是固定的，而是由其他事件触发。
- 注意事项：这种模式下，速度计算与位置读取操作强耦合。如果你读取QPOSCNT很频繁，可能会锁存到不完整的计时周期（ΔT太小），导致速度计算波动大。需要精心设计读取策略。
模式1（QCLM=1）：单位超时事件时锁存
- 机制：eQEP还有一个独立的32位单位定时器（QUTMR），它以SYSCLKOUT为时钟，与一个可配置的周期寄存器（QUPRD）比较。当QUTMR == QUPRD时，发生单位超时事件（UTOUT）。在此事件发生时，硬件会同时锁存位置计数器QPOSCNT、捕获定时器QCTMR和捕获周期寄存器QCPRD的值到它们对应的LAT寄存器中。
- 应用场景：这是最常用、最推荐的模式，适用于固定控制周期的闭环控制（如FOC电机控制）。你可以将QUPRD设置为你的速度/电流环控制周期（例如，100us）。每个控制周期开始的中断里，你读取到的QPOSLAT和QCPRDLAT就是过去一个完整控制周期内积分的位置增量和所用的时间，直接用于计算本周期的平均速度。这样，速度计算与控制周期完美同步，数据整齐，算法实现干净。
- 优势：数据采集与控制系统时钟同步，避免了异步采样带来的抖动和相位延迟，是数字控制系统的理想选择。

3. 关键寄存器配置与参数计算实战

理解了原理，我们进入实战环节。配置边沿捕获单元，核心就是玩转几个寄存器。这里我们以最常用的“单位超时锁存模式”为例，展示一个完整的配置流程和参数计算过程。

3.1 寄存器配置步骤

假设我们有一个10000线（每转40000个QCLK）的增量式编码器，电机额定转速3000RPM，系统时钟SYSCLKOUT=200MHz，我们希望速度环控制频率为10kHz（周期100us）。

配置单位位置事件预分频（UPPS）：
- 目标：确定一个合适的“单位位置”X。太小则ΔT小，低速分辨率差；太大则速度更新率慢。
- 计算：电机最大机械角速度ω_max = 3000 RPM = 3000 * 2π / 60 ≈ 314.16 rad/s。
- 编码器最大电气频率f_elec_max = (3000/60) * 10000 * 4 = 2,000,000 Hz。每个QCLK周期T_qclk_min = 1 / 2e6 = 0.5us。
- 我们希望即使在最高速下，单位位置事件也不要过于频繁，以免给系统带来不必要的负担。假设我们设定在最高速时，UPEVNT的频率约为速度环频率的10倍（即每10个速度环周期有1个位置事件），即f_upevnt_max ≈ 100kHz。
- 那么，需要的预分频数N = f_elec_max / f_upevnt_max ≈ 2e6 / 1e5 = 20。
- 查看QCAPCTL[UPPS]的选项，最接近的可用值是16（/16）或32（/32）。选择UPPS = 4（对应/16）。此时，N=16，单位位置X = 16 * (1/40000) 转 = 0.0004 转，或X = 16 * (2π/40000) rad ≈ 0.00251 rad。
- 配置代码：
```
EQep1Regs.QCAPCTL.bit.UPPS = 4; // 单位位置事件 = QCLK/16
```
配置捕获定时器时钟预分频（CCPS）：
- 目标：设置CAPCLK频率，使得在最低可测速度下，QCTMR不会溢出（16位，最大65535），同时在最高速下仍有足够的分辨率。
- 计算最低可测速度v_min：假设我们想测量低至0.1 RPM的速度。ω_min = 0.1 * 2π / 60 ≈ 0.01047 rad/s。
- 在v_min下，移动一个单位位置X所需的时间ΔT_max = X / ω_min ≈ 0.00251 / 0.01047 ≈ 0.24秒。
- QCTMR在ΔT_max内的计数值不能超过65535。因此，CAPCLK的最大频率f_capclk_max = 65535 / ΔT_max ≈ 273 kHz。
- 但为了精度，我们希望CAPCLK尽可能高。SYSCLKOUT=200MHz。选择CCPS = 6（对应/64），则f_capclk = 200MHz / 64 = 3.125 MHz。
- 验证高速不溢出：在最高速ω_max下，ΔT_min = X / ω_max ≈ 0.00251 / 314.16 ≈ 8.0e-6 秒。对应的计数值counts = ΔT_min * f_capclk ≈ 8e-6 * 3.125e6 ≈ 25，远小于65535，安全。
- 配置代码：
```
EQep1Regs.QCAPCTL.bit.CCPS = 6; // CAPCLK = SYSCLKOUT/64 = 3.125MHz
```
配置单位定时器（用于周期锁存）：
- 目标：设置速度环的控制周期，例如100us (10kHz)。
- 计算：QUPRD = T_desired * f_sysclkout = 100e-6 * 200e6 = 20000。
- 配置代码：
```
EQep1Regs.QUPRD = 20000; // 单位定时器周期，对应100us EQep1Regs.QEPCTL.bit.UTE = 1; // 使能单位定时器 EQep1Regs.QEPCTL.bit.QCLM = 1; // 锁存模式：单位超时时锁存
```

使能捕获单元：

配置代码：

EQep1Regs.QCAPCTL.bit.CEN = 1; // 使能捕获单元

使能中断（可选）：
- 如果我们希望在单位超时事件（UTOUT）时进入中断读取数据，需要配置中断。
- 配置代码：
```
EQep1Regs.QEINT.bit.UTO = 1; // 使能单位超时中断 // 还需要配置PIE向量表，使能CPU级中断等（此处略）
```

3.2 速度计算代码示例

在单位超时中断服务程序（或主循环中查询QFLG.bit.UTO）中，进行速度计算：

interrupt void EQEP1_ISR(void) // 假设单位超时中断 { Uint32 delta_position_counts; float delta_position_rad; Uint16 delta_time_counts; float delta_time_sec; float speed_rad_per_sec; // 1. 读取锁存的位置增量 (ΔX) // 注意：在QCLM=1模式下，QPOSLAT锁存的是超时时刻的绝对位置。 // 需要连续记录两次的锁存值相减得到增量。 static Uint32 last_pos_lat = 0; Uint32 current_pos_lat = EQep1Regs.QPOSLAT; if(last_pos_lat != 0) { // 跳过第一次无效数据 delta_position_counts = current_pos_lat - last_pos_lat; // 注意处理计数器翻转 // 将计数值转换为实际位置（弧度） // 假设编码器10000线，4倍频，每转计数 = 10000 * 4 = 40000 delta_position_rad = (float)delta_position_counts * (2.0 * 3.1415926535 / 40000.0); } last_pos_lat = current_pos_lat; // 2. 读取锁存的捕获周期值 (ΔT) delta_time_counts = EQep1Regs.QCPRDLAT; // 读取锁存值 // 将计数值转换为时间（秒） // CAPCLK = SYSCLKOUT/64 = 200MHz/64 = 3.125MHz delta_time_sec = (float)delta_time_counts / 3125000.0; // 3. 计算速度 v = ΔX / ΔT if(delta_time_sec > 1e-6) { // 避免除零 speed_rad_per_sec = delta_position_rad / delta_time_sec; } else { speed_rad_per_sec = 0.0; // 速度过高或无效 } // 4. 清除中断标志 EQep1Regs.QCLR.bit.UTO = 1; // 写1清除UTO中断标志 EQep1Regs.QCLR.bit.INT = 1; // 清除全局中断标志 PieCtrlRegs.PIEACK.all = PIEACK_GROUP1; // 确认PIE组中断 // 5. 使用计算出的speed_rad_per_sec进行速度环控制... }

关键提示：上述代码中delta_position_counts的计算是简化版，实际中必须考虑32位位置计数器QPOSCNT的翻转（overflow/underflow）。正确的做法是使用有符号的64位或32位差值运算来处理翻转，例如：delta = (Int32)(current - last);，因为C语言中无符号数的减法在发生借位时会产生一个很大的正数，而不是负的增量。

4. 误差来源、限制条件与避坑指南

硬件虽好，但理解其限制才能避免踩坑。边沿捕获单元在两种情况下会给出无效数据（QCPRDLAT被设置为0xFFFF），并通过状态标志位告警：

4.1 捕获定时器溢出（QEPSTS[COEF]）

条件：在两个连续的单位位置事件之间，16位的捕获定时器QCTMR计数值超过了65535。
意味着什么：速度太慢了！ΔT太长，以至于用当前配置的CAPCLK频率无法测量。QCPRDLAT会被置为0xFFFF。
如何解决：
1. 降低CAPCLK频率：增大QCAPCTL[CCPS]的分频比，让“秒表”走得更慢，这样在相同的ΔT内计数值变小。代价是计时分辨率下降。
2. 减小单位位置X：减小QCAPCTL[UPPS]，让“里程碑”更密集，这样ΔT会变短。代价是可能会引入更多的编码器抖动噪声。
3. 软件处理：在速度计算前，一定要检查QEPSTS[COEF]标志。如果置位，说明速度低于当前配置的可测量范围，应将其视为“零速”或“超低速”，并尝试动态调整CCPS（需先禁用捕获单元）。

4.2 方向改变错误（QEPSTS[CDEF]）

条件：在两个连续的单位位置事件之间，电机的旋转方向发生了改变。
意味着什么：在测量时间窗口ΔT内，电机先正转后反转（或反之），净位移可能很小甚至为零，但过程时间被记录了。此时用ΔX/ΔT计算速度会得到错误结果。QCPRDLAT会被置为0xFFFF。
如何解决：
1. 检查机械和负载：方向频繁突变可能意味着系统存在振荡、刚性不足或控制参数不佳。
2. 优化控制算法：确保速度环或位置环的调节器参数合适，避免超调引起的反复震荡。
3. 软件容错：在��取速度前检查QEPSTS[CDEF]。如果置位，本次速度值应丢弃，可以沿用上一次的有效速度值或进行滤波处理。

4.3 动态修改预分频器的禁忌

手册中用一个CAUTION特别强调：QCAPCTL[UPPS]（单位位置事件预分频器）不能在运行时��态修改。比如，你不能在测量过程中将UPPS从/4切换到/8。这样做会导致未定义的行为，很可能使捕获单元工作紊乱。

正确做法：如果需要改变UPPS，必须先禁用捕获单元（QCAPCTL.bit.CEN = 0），修改UPPS值，然后重新使能（CEN = 1）。QCAPCTL[CCPS]（捕获定时器预分频器）的修改也有同样要求，必须在捕获单元禁用时进行。

4.4 实操心得与配置技巧

上电初始化顺序：建议按照“配置参数 -> 使能单元定时器（如果需要）-> 使能捕获单元”的顺序。确保所有配置在使能前完成。
中断与查询的选择：对于固定频率的控制系统（如10kHz FOC），强烈推荐使用单位超时中断（UTO）来同步数据采集和控制计算。对于非周期性或调试，可以使用查询QEPSTS[UPEVNT]标志的方式。
速度值的滤波：直接从硬件读取的ΔT计算出的速度是瞬时速度，在极低速时可能因为编码器本身的微小抖动或噪声而波动。在实际控制中，通常需要对计算出的速度进行低通滤波（如一阶滞后滤波），以得到平滑的速度反馈信号。
全速度范围测量：边沿捕获单元（T法）擅长低速，但在高速时，ΔT太小，测量精度下降。工业上常采用M/T法，即同时测量固定时间内的脉冲数（M法）和最后一个脉冲的周期（T法），高低速结合。eQEP模块本身主要提供T法支持，M法需要软件在单位定时器中断中读取位置差值来实现。可以结合两者，在高速区主要使用M法结果，在低速区平滑切换到T法结果。

5. 从寄存器描述到实际调试：问题排查实录

即使配置看起来正确，第一次调试也常常不顺利。下面是我在实际项目中遇到的几个典型问题及解决方法。

5.1 问题一：读到的QCPRDLAT永远是0或固定值

现象：使能了捕获单元，电机在转，但读取QCPRDLAT总是0，或者是一个不变的数值。
排查思路：
1. 检查时钟和预分频：确认SYSCLKOUT配置是否正确？QCAPCTL[CCPS]是否设置得过大，导致CAPCLK极慢？用示波器或通过其他定时器验证系统时钟。
2. 检查单位位置事件：QCAPCTL[UPPS]是否设置得过大？例如设成了/2048，对于低速电机，可能很久才产生一个事件。尝试调小UPPS，观察QEPSTS[UPEVNT]标志是否会频繁置位。
3. 检查锁存模式：你配置的锁存模式（QEPCTL[QCLM]）和你读取数据的时机匹配吗？如果设置了QCLM=1（单位超时锁存），但你却没有使能单位定时器（UTE=0）或者超时周期QUPRD设得极大，那么锁存事件永远不会发生。如果设置了QCLM=0（读位置锁存），但你从未在代码中读取QPOSCNT寄存器，锁存也不会发生。
4. 检查捕获单元使能：最基础的，QCAPCTL.bit.CEN设为1了吗？
解决：在我的一个案例中，问题出在QUPRD设置过大。我错误地将其设置为对应于1秒的值，而电机几秒才转一圈，导致单位超时事件先于单位位置事件发生，锁存到的QCPRD是两次超时之间（没有位置变化）的时间，所以值很大且固定。将QUPRD改为一个远小于位置事件间隔的值（如对应10ms）后，问题解决。

5.2 问题二：计算出的速度噪声大，尤其在低速时

现象：速度值跳动剧烈，特别是在极低速运行时，甚至出现速度符号频繁变化。
排查思路：
1. 编码器信号质量：这是首要怀疑对象。用示波器查看QA、QB信号是否干净？幅值是否足够？上升/下降沿是否有振铃？长线传输是否有干扰？添加RC滤波或使用带屏蔽的电缆。
2. UPPS设置过小：如果UPPS=1，意味着每个QCLK边沿都触发捕获。编码器的微小抖动（机械或电气）会被直接反映到ΔT测量中，导致速度波动。适当增大UPPS，例如设为4或8，相当于对位置信号进行了“硬件滤波”，用多个边沿的平均效果来产生一个位置事件，能显著平滑低速速度。
3. 软件滤波不足：硬件测量本身是瞬间值。即使信号完美，在接近零速时，由于量化误差（ΔT的计数值变化一个LSB），速度计算也会有跳变。必须在软件中对最终计算出的速度进行低通滤波。
4. 检查CDEF标志：速度符号跳动可能是方向改变错误。检查QEPSTS[CDEF]是否被置位。如果频繁置位，说明在测量周期内电机确实在震荡，需要调优控制器参数。
解决：针对一个桌面级小电机，我将UPPS从1调整为4，并在软件中增加了一阶低通滤波：speed_filtered = 0.95 * speed_filtered + 0.05 * speed_raw。速度波形立刻变得平滑可用。

5.3 问题三：高速时速度值突然跳变或归零

现象：电机在中高速运行正常，但超过某个速度点后，读取的速度值会错误地跳变到极大值、极小值或零。
排查思路：
1. 捕获定时器溢出：这是最可能的原因。检查QEPSTS[COEF]标志。高速时ΔT变小，如果CAPCLK频率不够高，QCTMR计数值可能小于1（实际上由于整数计数，可能为0或1），导致计算出的速度趋于无穷大或出现除零错误。更严重的是，如果速度过高，ΔT可能小于硬件的最小响应时间，导致捕获异常。
2. 计算溢出：速度计算v = X / ΔT中，如果ΔT非常小（高速），而X是定点数或整数，除法结果可能超出变量范围。确保使用浮点数或足够位宽的定点数运算。
3. 中断丢失：在极高速度下，单位位置事件或单位超时中断可能过于频繁，导致CPU无法及时响应，丢失数据。检查中断服务程序的执行时间是否过长。
解决：对于高速情况，T法本身就不适用了。此时应该切换到M法测速，即在固定的单位定时器周期内，读取位置计数器的差值ΔX，然后用v = ΔX / T计算速度（T是固定的，如100us）。eQEP的位置计数器QPOSCNT是32位的，非常适合做M法计数。实现上，只需使能单位定时器中断，在中断中读取QPOSLAT（或当前QPOSCNT）并与上一次值做差即可。可以设计一个速度计算函数，根据ΔT（来自QCPRDLAT）的大小自动在T法和M法之间加权切换或硬切换，实现全速度范围的无缝测量。