STM32输入捕获原理与实战：精准测量频率与占空比-平芜编程栈

1. 项目缘起：从“数脉冲”到“测频率”的刚需

最近在做一个电机转速监测的小项目，核心需求是要实时、准确地测量一个方波信号的频率。这个信号可能来自光电编码器，也可能来自霍尔传感器，频率范围从几十赫兹到几千赫兹都有可能。一开始，我琢磨着用外部中断配合软件计时来搞：信号每来一个上升沿就进一次中断，在中断里读取系统时间戳，然后计算两次中断的时间差，再换算成频率。听起来挺简单对吧？但实测下来，问题一大堆。

首先，中断响应本身就有延迟，这个延迟在低速时影响不大，但频率一高，比如到了1kHz以上，CPU大部分时间都在进出中断，系统负载飙升，其他任务根本没法跑。更头疼的是，如果信号频率再高一些，或者信号里夹杂了毛刺，中断频繁触发，计时误差会大到离谱，测出来的频率数据跳得跟心电图似的，完全没法用。这时候我才深刻体会到，对于这种需要精确测量时间间隔的场景，STM32内置的硬件定时器输入捕获功能，才是真正的“专业对口”。

输入捕获，说白了就是让定时器这个“高精度秒表”去帮你“抓拍”信号跳变的瞬间，并把当时的计时器值自动存起来。整个过程由硬件完成，不占用CPU资源，精度只取决于定时器的时钟源，稳定又可靠。今天，我就结合自己踩过的坑和调通的经验，把手把手配置和使用STM32输入捕获功能的完整流程、核心原理和避坑要点，给大家掰开揉碎了讲清楚。

2. 核心原理拆解：定时器如何“抓住”信号的瞬间

在动手写代码之前，我们必须先搞明白STM32的定时器，到底是怎么实现输入捕获这个“抓拍”动作的。理解了这个，后面配置寄存器或者用CubeMX图形化配置时，你才知道每一个选项背后的意义，出了问题也知道该往哪里查。

2.1 定时器的基本“骨架”：时基单元

你可以把一个定时器想象成一个不断向上累加的计数器。这个计数器的“心跳”频率，就是定时器的时钟源（CK_PSC）。这个时钟源可以来自内部系统时钟（比如72MHz），也可以来自外部。但72MHz计数太快了，计数值瞬间就溢出了，所以我们通常需要一个预分频器（PSC）来把高频时钟“降速”。例如，预分频器设置为71，那么计数器实际递增的频率就变成了 72MHz / (71+1) = 1MHz，也就是每微秒计数一次。

计数器（CNT）会从0开始，一直累加到我们设定的自动重装载值（ARR），然后产生一个更新事件，并清零重新开始计数，如此循环。这个“从0到ARR”的循环周期，就是定时器的基础计时周期。ARR的值决定了定时器的“量程”。比如，时钟1MHz，ARR设为9999，那么一个完整的计数周期就是10毫秒（10000个计数 * 1微秒）。

2.2 输入捕获通道的“抓拍”机制

定时器通常有多个输入捕获通道，每个通道都关联着一个特定的GPIO引脚。这个通道的核心部件是一个“捕获/比较寄存器”（比如CCR1）。它的工作流程是这样的：

信号输入与滤波：外部信号通过GPIO引脚进入定时器。首先会经过一个数字滤波器，它可以滤除信号中短于一定时间的毛刺，防止误触发，这对于工业环境中的抗干扰至关重要。
边沿检测：我们可以配置通道捕获的是信号的上升沿、下降沿，还是双边沿。这个检测也是硬件完成的。
触发与锁存：当检测到设定的边沿事件时，硬件会立刻做两件事：
- 将当前计数器（CNT）的值，瞬间复制到对应的捕获/比较寄存器（CCRx）中。这个动作是硬件同步的，精度极高。
- 同时，会置位一个“捕获标志位”（比如CC1IF），如果使能了捕获中断，还会产生一个中断请求。
读取与计算：我们的程序在中断服务函数里，或者通过轮询标志位，读取CCRx寄存器中锁存的那个“时间戳”。通过计算连续两次捕获到的CCRx值之差，再结合定时器的计数频率，就能精确算出两个边沿之间的时间间隔（周期），其倒数就是频率。

关键点：这个“抓拍”和“锁存”动作是由硬件在纳秒级时间内完成的，完全不受软件中断延迟的影响。这就是输入捕获相比纯软件计时在精度和可靠性上的根本优势。

2.3 测量频率与占空比的策略

测频率（周期）：通常采用上升沿捕获。记录第一次上升沿的捕获值T1，记录第二次上升沿的捕获值T2。如果这期间计数器没有溢出，那么信号周期T = (T2 - T1) * 计数周期。频率F = 1 / T。如果T2 < T1，说明发生了计数器溢出，那么实际周期T = ((ARR + T2) - T1) * 计数周期。在中断服务程序中，我们需要处理这种溢出情况。
测占空比：需要捕获一个完整周期内的上升沿和下降沿。可以配置为双边沿捕获，或者在两个通道上分别设置上升沿和下降沿捕获。假设上升沿值T_rise，下降沿值T_fall，高电平时间Th = (T_fall - T_rise) * 计数周期，占空比 =Th / T。

3. 实战配置：以STM32F103的TIM2_CH1为例

理论懂了，我们来看怎么把它配出来。这里我以最经典的STM32F103C8T6为例，使用通用定时器TIM2的通道1（对应PA0引脚）来捕获一个方波信号。我会同时介绍寄存器配置思路和STM32CubeMX的图形化配置方法，因为理解寄存器能让你更懂底层，而CubeMX能极大提升开发效率。

3.1 硬件连接与CubeMX工程创建

首先，确保你的信号发生器或者传感器输出端，连接到了MCU的PA0引脚。STM32的引脚有复用功能，PA0除了是普通IO，它的第二功能（AF1）就是TIM2_CH1。

打开STM32CubeMX，选择你的芯片型号。

系统核心（SYS）：在Debug里选择Serial Wire，这样可以用ST-Link调试。
时钟（RCC）：High Speed Clock (HSE)选择Crystal/Ceramic Resonator，使用外部8MHz晶振。
时钟配置（Clock Configuration）：这是关键一步。将HSE（8MHz）通过PLL倍频到72MHz，作为系统时钟（SYSCLK）。APB1总线时钟预分频器设为2，这样APB1时钟为36MHz。但注意，如果APB1预分频系数不为1，定时器时钟（TIMxCLK）会是APB1时钟的2倍。所以这里TIM2的时钟实际上是72MHz。这个细节CubeMX会自动计算并显示，但你必须知道原理。
GPIO配置：点击PA0引脚，选择TIM2_CH1功能。默认的上拉/下拉模式可以先不选，取决于你的信号驱动能力，如果信号是开漏输出，可以配置上拉。
定时器TIM2配置：
- 时钟源（Clock Source）：选择Internal Clock。
- 通道1（Channel1）：选择Input Capture direct mode。
- 参数设置（Parameter Settings）：
  - 预分频器（Prescaler）：输入71。这样定时器时钟 = 72MHz / (71+1) = 1MHz，计数一次代表1微秒。
  - 计数模式（Counter Mode）：Up（向上计数）。
  - 自动重装载值（Counter Period）：设为最大值65535（因为TIM2是16位定时器）。也可以根据你测量的最大周期来设，比如想测最大100ms的周期，可以设为100000-1（因为1MHz时钟）。
  - 内部时钟分频（clock division）：No Division。
  - 重复计数器（Repetition Counter）：通用定时器无此功能，忽略。
  - 自动重载预装载（auto-reload preload）：Enable。这个建议开启，可以避免在更新时产生毛刺。
- 输入捕获配置：
  - 点击下方Input Capture Channel 1的配置。
  - 极性（Polarity）：选择Rising Edge（我们先测频率，用上升沿）。
  - 输入分频器（IC Selection）：选择Direct。信号直接连接到捕获单元。
  - 滤波器（Filter）：根据信号质量设置。如果信号干净，选No Filter。如果有毛刺，可以尝试2或4，表示需要几个时钟周期的连续采样才确认有效边沿。这里先设为0（无滤波）。
NVIC设置（中断）：在NVIC Configuration标签页，找到TIM2 global interrupt，勾选Enabled。优先级可以保持默认。
生成代码：设置好工程路径和IDE（如Keil MDK），点击Generate Code。

3.2 关键代码实现与解析

CubeMX生成了初始化代码，但我们还需要在用户代码区域添加逻辑。核心在于中断服务函数中的处理。

首先，在main.c的/* USER CODE BEGIN 2 */之后，启动定时器和使能捕获中断：

/* 启动定时器TIM2的基础计数 */ HAL_TIM_Base_Start(&htim2); /* 启动TIM2的输入捕获功能，并开启捕获中断 */ HAL_TIM_IC_Start_IT(&htim2, TIM_CHANNEL_1);

接下来，我们需要定义几个全局变量来辅助计算：

/* USER CODE BEGIN PV */ volatile uint32_t g_capture_count = 0; // 捕获值 volatile uint32_t g_last_capture = 0; // 上一次捕获值 volatile uint32_t g_period = 0; // 计算出的周期（微秒数） volatile uint8_t g_is_first_capture = 1; // 是否是第一次捕获的标志 /* USER CODE END PV */

最重要的部分是重写输入捕获中断的回调函数。这个函数会在每次捕获事件发生时被HAL库调用。我们在stm32f1xx_it.c中找到TIM2_IRQHandler，但处理逻辑最好写在用户文件（如main.c）中重写的回调函数里：

/* USER CODE BEGIN 4 */ void HAL_TIM_IC_CaptureCallback(TIM_TypeDef *htim) { // 判断是否是TIM2的通道1产生了捕获中断 if (htim == &htim2 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { // 读取本次捕获的值 g_capture_count = HAL_TIM_ReadCapturedValue(&htim2, TIM_CHANNEL_1); if (g_is_first_capture) // 第一次捕获 { g_last_capture = g_capture_count; g_is_first_capture = 0; // 清除第一次捕获标志 } else // 至少是第二次捕获 { /* 计算周期差值，需要考虑计数器溢出的情况 */ if (g_capture_count > g_last_capture) { // 正常情况，没有溢出或只溢出一次且仍在同一个计数周期内 g_period = g_capture_count - g_last_capture; } else { // 发生溢出，差值需要加上计数器的模（ARR+1） // 对于16位定时器，如果ARR是65535，则模是65536 g_period = (htim2.Instance->ARR + 1) + g_capture_count - g_last_capture; } // 更新上一次捕获值，为下一次计算做准备 g_last_capture = g_capture_count; // 这里g_period的单位是“定时器计数次数” // 实际时间（微秒）= g_period * (1 / 定时器计数频率) // 我们预分频后是1MHz，所以g_period直接就是微秒数 // 频率（Hz）= 1,000,000 / g_period } } } /* USER CODE END 4 */

最后，在主循环中，你可以周期性地打印或使用g_period来计算频率：

/* USER CODE BEGIN WHILE */ while (1) { if (g_period != 0) { uint32_t freq_hz = 1000000 / g_period; // 计算频率 printf("Period: %lu us, Freq: %lu Hz\r\n", g_period, freq_hz); g_period = 0; // 可选：清空，等待下一次计算 } HAL_Delay(500); // 每500ms打印一次 /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

4. 精度提升与边界情况处理

上面的代码是一个基础框架，能跑起来，但在实际项目中，要获得稳定可靠的数据，还需要处理很多细节。

4.1 计数器溢出的精确处理

前面的代码简单处理了溢出，但只处理了一次溢出。如果信号的周期非常长，或者定时器计数频率很高，ARR值设置得较小，可能在两个捕获事件之间发生了多次溢出。上面的减法逻辑就会出错。

更健壮的方法是引入一个溢出计数器。在定时器的**更新中断（溢出中断）**中对该计数器加1。在计算周期时，将溢出次数也考虑进去。

开启更新中断：在CubeMX中，除了使能全局中断，还需要在TIM2参数配置的NVIC Settings里勾选Update interrupt。

定义溢出计数变量：

volatile uint32_t g_tim2_overflow_count = 0;

重写更新中断回调：

void HAL_TIM_PeriodElapsedCallback(TIM_TypeDef *htim) { if (htim == &htim2) { g_tim2_overflow_count++; } }

修改捕获回调中的计算逻辑：

else // 至少是第二次捕获 { uint32_t overflow_count = g_tim2_overflow_count; uint32_t period_ticks = 0; // 暂时关闭更新中断，防止在读取过程中溢出计数变化 __disable_irq(); if (g_capture_count >= g_last_capture) { period_ticks = (overflow_count * (htim2.Instance->ARR + 1)) + (g_capture_count - g_last_capture); } else { // 注意：当g_capture_count < g_last_capture时，说明在两次捕获间至少发生了一次溢出 // 但overflow_count记录的是从开始到现在的总溢出次数。 // 我们需要的是两次捕获之间的溢出次数。一个简单方法是： // 假设溢出发生在两次捕获之间，那么计算出的周期需要加上一个ARR+1 // 但更严谨的做法是记录每次捕获时的溢出计数。 // 这里采用简化但常用的方法： period_ticks = (overflow_count * (htim2.Instance->ARR + 1)) + (g_capture_count + (htim2.Instance->ARR + 1) - g_last_capture); } g_last_capture = g_capture_count; __enable_irq(); g_period = period_ticks; // 单位是定时器计数 }

注意：上述简化方法在超高频率或复杂情况下可能仍有瑕疵。最严谨的方法是定义一个结构体，同时记录捕获值capture和当时的溢出计数overflow_snapshot，在捕获中断里读取并保存这两个值，然后在主循环或更低优先级任务中进行周期计算。

4.2 高频与低频信号的量程适配

高频信号：如果信号频率很高（比如1MHz），周期只有1微秒。为了测量更精确，我们希望一个周期内能有更多的计数。这时应该提高定时器的计数频率。比如，将预分频器PSC设小，让定时器以系统时钟72MHz运行。这样1微秒内会计数72次，分辨率大大提高。但要注意ARR要设置得足够大，以避免频繁溢出增加处理复杂度。
低频信号：如果信号频率很低（比如1Hz），周期长达1秒。如果定时器以1MHz计数，ARR最大65535，最多只能计65.535毫秒，会频繁溢出。这时有两个选择：
1. 降低定时器计数频率：增大PSC，比如设为7199，让定时器时钟变为10kHz（72MHz/7200）。这样ARR设为最大值65535时，最大可测量周期为6.5535秒，足以覆盖1Hz信号。但分辨率会下降为0.1毫秒。
2. 使用32位定时器或定时器级联：一些STM32型号有32位通用定时器（如L4系列的LPTIM），或者可以将两个16位定时器级联成32位使用，从而获得巨大的计数范围，同时保持高计数频率和高分辨率。这是最理想的方案，但硬件有限制。

选择策略：在项目初期，就要根据待测信号的频率范围，估算所需的计时精度和量程，从而确定PSC和ARR的值。公式为：最大可测周期 = (ARR + 1) * (PSC + 1) / TIM_CLK。分辨率 =(PSC + 1) / TIM_CLK。

4.3 数字滤波器的合理使用

输入捕获通道前的数字滤波器不是摆设，在噪声环境中是保证稳定的关键。它实际上是一个事件计数器：只有当连续N个采样时钟都检测到相同的电平，才认为边沿有效。这个N就是滤波值（ICxF位）。

如何设置：在CubeMX中，Filter值就是N。N的取值范围和采样时钟频率有关。例如，当Clock Division为No Division时，采样时钟等于定时器输入时钟（CK_INT）。如果定时器时钟是1MHz，那么一个采样周期就是1微秒。设置Filter=4，意味着信号边沿必须持续4微秒不变，才会被确认。
影响：滤波器能有效滤除窄毛刺，但也会引入额外的延迟。对于非常干净的信号，可以不用滤波。对于有噪声的信号，需要根据噪声的脉宽来选择合适的滤波值。设置过大，可能会滤掉有效的快速边沿；设置过小，则可能无法滤除噪声。通常需要通过示波器观察信号质量来调试确定。

5. 进阶应用：测量脉冲宽度与占空比

测量占空比需要同时捕获上升沿和下降沿。有两种常见的实现方式：

方法一：单通道双边沿捕获将输入捕获通道配置为Rising and Falling Edge。在捕获中断中，根据当前是上升沿还是下降沿中断，分别记录时间戳。这种方法需要你在中断中判断触发的是哪种边沿（通过读取TIMx_CCER寄存器的CCxP位或使用HAL库的HAL_TIM_ReadCapturedValue结合状态判断），逻辑稍复杂，但只占用一个定时器通道。

方法二：双通道分别捕获使用同一个定时器的两个输入通道（如CH1和CH2），连接到同一个GPIO引脚（需要检查芯片手册是否支持）。将CH1配置为上升沿捕获，CH2配置为下降沿捕获。这样，上升沿和下降沿会分别触发CH1和CH2的中断，在各自的中断回调中读取捕获值。逻辑清晰，但占用两个通道资源。

这里以方法一（单通道双边沿）为例，简述关键配置和代码思路：

CubeMX配置：在TIM2的Channel1配置中，Polarity选择Both Edges。

代码逻辑：

volatile uint32_t g_rise_value = 0; volatile uint32_t g_fall_value = 0; volatile uint8_t g_edge_state = 0; // 0:等待上升沿， 1:已捕获上升沿，等待下降沿 void HAL_TIM_IC_CaptureCallback(TIM_TypeDef *htim) { if (htim == &htim2 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { uint32_t current_capture = HAL_TIM_ReadCapturedValue(&htim2, TIM_CHANNEL_1); // 判断当前是上升沿还是下降沿？HAL库没有直接提供函数。 // 可以通过读取TIMx_CCER寄存器的CC1P位来判断，或者用一个技巧： // 在中断里读取GPIO引脚的电平。如果是高电平，说明刚发生的是上升沿；低电平则是下降沿。 // 这里使用读取GPIO的方法（需包含gpio.h） if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) == GPIO_PIN_SET) { // 上升沿 g_rise_value = current_capture; g_edge_state = 1; // 下一个应该是下降沿 } else { // 下降沿 g_fall_value = current_capture; if (g_edge_state == 1) { // 计算高电平脉宽 uint32_t pulse_width = 0; // ... (处理溢出的脉宽计算) // 此时，一个完整周期的高电平时间已知 // 还需要结合下一个上升沿的值才能计算周期和占空比 // 因此，通常需要缓存连续两个上升沿的值和一个下降沿的值 } g_edge_state = 0; // 下一个应该是上升沿 } } }

实际项目中，为了计算占空比，你需要缓存一个周期内的三个时间点：上升沿A，下降沿B，上升沿C。则高电平时间 = B - A，周期 = C - A。占空比 = (B - A) / (C - A)。这需要在状态机中更细致地管理这些时间戳和边缘状态。

6. 调试技巧与常见问题排查

即使配置看起来正确，第一次做输入捕获也难免遇到问题。下面是一些实用的调试方法和常见坑点。

问题一：完全捕获不到信号，中断不触发。

检查清单：
1. GPIO复用功能：确认引脚是否已正确配置为定时器通道的复用功能（AF）。在CubeMX中检查，在代码中查看生成的MX_GPIO_Init函数。
2. 定时器时钟使能：CubeMX通常会自动生成时钟使能代码，但可以检查htim2.Instance->CR1寄存器的CEN位是否为1（定时器已启动）。
3. 输入捕获通道使能：确认是否调用了HAL_TIM_IC_Start_IT。这个函数不仅启动了捕获，还使能了通道和中断。
4. 中断优先级与使能：检查NVIC中TIM2中断是否已使能，优先级是否被更高优先级中断抢占导致无法响应。
5. 信号本身：用示波器或逻辑分析仪检查PA0引脚上是否有预期的信号？电压电平是否符合要求（STM32通常是0-3.3V）？
6. 边沿极性：检查是否配置了正确的边沿（上升沿/下降沿）。你的信号是上升沿有效吗？

问题二：捕获值不稳定，跳动很大。

可能原因与对策：
1. 信号噪声：这是最常见的原因。示波器查看信号是否有毛刺。解决方法：a) 在硬件上增加RC滤波电路；b) 启用并调整定时器的输入滤波器（Filter参数）。
2. 中断处理时间过长：如果中断服务函数里做了太多事情（比如浮点计算、打印），可能导致丢失下一次捕获中断。优化中断服务函数，只做最必要的读写操作，将复杂的计算（如频率换算）移到主循环中。
3. 计数器溢出处理不当：如果测量低频信号且未正确处理多次溢出，计算出的周期会出错。务必实现第4.1节提到的带溢出计数的完整处理逻辑。
4. 定时器时钟配置错误：确认你理解的定时器实际计数频率和代码中使用的计算基准是否一致。用__HAL_TIM_GET_CLOCKSOURCE宏可以辅助检查。

问题三：测量结果有固定偏差。

排查方向：
1. 系统时钟精度：如果使用内部RC振荡器（HSI），其精度可能只有±1%，这会导致所有时间测量存在比例误差。对精度要求高的应用，务必使用外部晶振（HSE）。
2. 预分频器理解错误：记住，预分频器PSC写入的值是分频系数-1。写入71，实际分频是72。
3. 计算中的整数溢出：在计算频率freq = 1000000 / period时，如果period很小（高频），1000000 * 周期计数可能会超过32位整数范围。可以考虑使用64位整数（uint64_t）进行中间运算，或者先进行浮点计算。

一个关键的调试手段：利用调试器在IDE（如Keil）的调试模式下，可以：

查看定时器相关寄存器（TIM2->CNT, TIM2->CCR1, TIM2->SR等）的实时值。
在中断服务函数入口设置断点，观察是否进入。
观察全局变量（g_capture_count,g_period）的变化情况。

输入捕获是STM32定时器里非常实用且经典的功能，从简单的频率计到复杂的编码器接口、PWM输入，都离不开它。把原理吃透，把边界情况处理好，你就能在需要精确计时的项目中游刃有余。我自己的经验是，第一次调通后，把相关的配置和计算逻辑封装成一个独立的.c/.h文件，以后的项目里直接拿来用，最多根据时钟改个宏定义，能省下大量重复调试的时间。