1. 项目概述：为什么我们需要捕获边沿信号？

在嵌入式开发，尤其是基于STM32这类MCU的项目里，我们经常需要测量外部信号的频率、脉宽，或者精确地记录某个事件发生的时刻。比如，你想知道一个旋转编码器转得多快，一个超声波传感器返回的回波脉冲有多宽，或者一个按键被按下的确切时长。这时候，仅仅靠GPIO读取电平是远远不够的，因为它无法提供精确的时间信息。定时器的输入捕获功能，就是为了解决这类“计时”问题而生的核心外设。

简单来说，输入捕获就像给MCU配了一块高精度的秒表和一个反应极快的记录员。当指定的引脚（捕获通道）上发生你预设的事件（比如电平从低变高，即上升沿）时，这个“记录员”会瞬间按下秒表的“暂停键”，并把当前的计时器计数值（也就是时间戳）锁存到一个专用的寄存器里。这样，你就能精确地知道这个边沿事件是在计时器启动后的哪个时刻发生的。通过连续捕获一个脉冲的上升沿和下降沿的时间戳，两者相减，就能得到这个脉冲的精确宽度。这就是标题中“使用定时器捕获上升/下降沿”所要实现的核心功能。

对于STM32开发者而言，STM32CubeMX/HAL库极大地简化了外设的初始化流程，但同时也隐藏了不少底层细节。很多新手在配置和使用输入捕获时，常常卡在如何正确配置定时器模式、如何理解捕获/比较通道、以及如何编写稳定可靠的中断服务程序这些问题上。本文将基于STM32Cube生态，深入拆解定时器输入捕获的配置要点、工作原理和实战代码，并分享我在多个工控和测量项目中积累的调试经验和避坑指南。

2. 定时器输入捕获的核心原理与模式选择

要玩转输入捕获，首先得理解STM32定时器的基本架构。一个通用定时器（如TIM2, TIM3, TIM4）通常包含一个16位或32位的自动重载计数器（CNT）、一个预分频器（PSC）和一个自动重载寄存器（ARR）。输入捕获功能依赖于定时器的捕获/比较通道，每个通道都关联着一个捕获/比较寄存器（CCR）和输入滤波、边沿检测等数字电路。

2.1 输入捕获的工作流程

其工作流程可以概括为以下几步：

1. 信号输入：外部信号通过GPIO引脚接入到定时器的特定通道（如TIMx_CH1）。
2. 边沿检测：通道配置为输入模式，并设置要捕获的边沿类型（上升沿、下降沿或双边沿）。
3. 事件触发：当检测到设定的边沿事件时，硬件会立即产生一个捕获事件。
4. 值锁存：在捕获事件发生的瞬间，当前计数器CNT的值被硬件自动复制到对应的捕获/比较寄存器CCRx中。这个过程是原子操作，不受软件中断延迟影响，保证了时间戳的精确性。
5. 中断/DMA请求：可以配置在捕获事件发生时产生中断或DMA请求，通知CPU来读取CCRx中的值并进行处理。

2.2 关键模式解析：PWM输入模式与普通输入捕获模式

在CubeMX中配置输入捕获时，你会遇到两个容易混淆的模式：PWM Input Mode和Input Capture direct mode。理解它们的区别至关重要。

• 普通输入捕获模式 (Input Capture direct mode)：这是最基础、最灵活的模式。你需要手动为每个通道分别配置边沿极性。例如，你可以将通道1配置为上升沿捕获，用于测量周期；再将通道2配置为下降沿捕获，与通道1配合测量脉宽。或者，你也可以将同一个通道配置为双边沿捕获（在HAL库中通常通过切换极性或使用特定函数实现），来测量单个脉冲的宽度。这种模式需要更多的软件干预，但控制粒度更细。
• PWM输入模式 (PWM Input Mode)：这是一种“一键配置”的高级模式，专门用于测量PWM信号的频率和占空比。它硬件上固定使用两个通道（例如TI1同时映射到CH1和CH2）。其中一个通道（如CH1）被自动配置为上升沿捕获，用于测量周期；另一个通道（如CH2）被自动配置为下降沿捕获，用于测量高电平脉宽。硬件会自动将两次捕获的值存入不同的CCR寄存器，并可以仅产生一个中断（通常来自通道1或通道2）。它的优点是全硬件自动处理两次捕获的关联性，软件逻辑简单；缺点是占用了两个捕获通道，且模式固定，不够灵活。

选择建议：如果你只需要测量频率或周期，或者明确要测量一个PWM信号的频率和占空比，PWM输入模式是最方便的选择。如果你需要更灵活的控制，例如捕获非周期性的单次脉冲、测量任意两个边沿之间的时间间隔，或者资源紧张只能用一个通道，那么务必选择普通的输入捕获模式，并通过软件逻辑来处理双边沿捕获。

2.3 定时器时基计算：精度与量程的权衡

捕获到的时间戳是一个计数值，要转换成真实时间（微秒、毫秒），必须清楚定时器的计数频率。公式如下：定时器计数频率 = 定时器时钟源频率 / (PSC + 1)计数周期 = 1 / 定时器计数频率最大可测量时间 = (ARR + 1) * 计数周期

例如，APB1总线时钟为72MHz，TIM2挂载在其上。设置PSC=71，ARR=65535。

• 计数频率 = 72MHz / (71+1) = 1MHz，即每个计数代表1微秒。
• 计数周期 = 1微秒。
• 最大可测量时长 = (65535+1) * 1us = 65.536 ms。

如果你要测量一个50Hz的PWM信号（周期20ms），这个配置是足够的。但如果要测量1Hz的信号（周期1秒），ARR就需要设置得更大，或者降低计数频率（增大PSC）。这里有一个经典陷阱：为了追求高精度（计数频率高），设置了很小的PSC，导致ARR很快溢出，在测量长周期信号时，如果软件没有处理计数器溢出，计算结果会完全错误。我的经验是：先确定你要测量的最大信号周期，然后根据此时基公式反推PSC和ARR，在精度和量程之间取得平衡。通常，让ARR溢出周期略大于待测最大周期，并开启定时器更新中断来处理溢出计数，是测量长周期信号的可靠方法。

3. 基于STM32CubeMX的输入捕获配置详解

我们以STM32F103C8T6的TIM3通道1（PA6引脚）为例，配置为上升沿和下降沿捕获，测量脉冲宽度。

3.1 CubeMX图形化配置步骤

1. 引脚与定时器使能：在Pinout & Configuration标签页，找到TIM3。将Channel1设置为Input Capture direct mode。对应的GPIO引脚（PA6）会自动配置为复用模式。
2. 参数配置：切换到Configuration标签页，点击TIM3进行参数设置。
   • 时基单元 (Parameter Settings):
     • Prescaler (PSC - 16 bits value): 根据计算设置。例如填71，得到1MHz计数频率。
     • Counter Mode:Up（向上计数）。
     • Counter Period (AutoReload Register - 16 bits value): 设置为最大值65535，或根据量程计算的值。
     • auto-reload preload: 建议Enable，确保ARR的更新在下次更新事件时生效，避免中间状态。
   • 输入捕获通道配置 (Channel1):
     • Polarity Selection: 初始设置为Rising Edge（上升沿）。注意：在HAL库中，我们可以在运行时动态改变极性来实现双边沿捕获。
     • IC Selection:Direct（直接模式）。对于PWM输入模式，这里会是Indirect等选项。
     • IC Filter: 滤波值。如果输入信号有毛刺，可以设置一个滤波值（如0x8）来稳定信号，但会引入微小延迟。对于干净的数字信号，设为0。
     • IC Prescaler: 分频器。选择No division，每个有效边沿都捕获。
3. 中断/DMA使能：在NVIC Settings或DMA Settings中，使能TIM3 global interrupt和TIM3 capture compare interrupt。

3.2 生成代码与关键函数解析

生成代码后，在tim.c中可以看到HAL库已经帮我们完成了定时器的初始化。我们需要在用户代码中关注以下几个核心HAL函数：

• HAL_TIM_IC_Start_IT(&htim3, TIM_CHANNEL_1): 启动指定定时器通道的输入捕获，并使能捕获/比较中断。这是启动捕获的入口。
• HAL_TIM_IC_Stop_IT(&htim3, TIM_CHANNEL_1): 停止捕获和中断。
• __HAL_TIM_GET_COUNTER(&htim3): 获取当前计数器的值。用于在中断外查询。
• __HAL_TIM_SET_CAPTUREPOLARITY(&htim3, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING):动态设置捕获极性。这是实现单通道双边沿捕获的关键。可以在中断服务函数中，在捕获到上升沿后，立即将极性切换为下降沿，等待下一次捕获。

3.3 单通道双边沿捕获的软件实现逻辑

这是本文的重点和难点。很多教程只讲PWM输入模式，但单通道双边沿捕获在实际中更常用，资源占用少。其软件状态机逻辑如下：

1. 初始化：配置定时器为上升沿捕获，启动捕获中断。定义两个变量：capture_val_rising和capture_val_falling，以及一个状态标志capture_state = 0。
2. 第一次中断（上升沿）：
   • 在中断回调函数HAL_TIM_IC_CaptureCallback中，首先判断是哪个通道的中断。
   • 如果capture_state == 0，表示等待第一个上升沿。此时，读取CCR1的值存入capture_val_rising。
   • 关键操作：立即调用__HAL_TIM_SET_CAPTUREPOLARITY，将通道极性改为下降沿TIM_INPUTCHANNELPOLARITY_FALLING。
   • 将capture_state置为1，表示正在等待下降沿。
3. 第二次中断（下降沿）：
   • 此时capture_state == 1。读取CCR1的值存入capture_val_falling。
   • 计算脉宽：pulse_width = capture_val_falling - capture_val_rising。注意处理计数器溢出的情况（见下文）。
   • 关键操作：再次调用__HAL_TIM_SET_CAPTUREPOLARITY，将通道极性改回上升沿。
   • 将capture_state置为0，为下一个脉冲的测量做好准备。
   • 此时，一个完整脉冲的宽度已经计算出来，可以用于后续处理（如打印、控制等）。

注意：在中断回调函数中，切换极性一定要迅速，且最好在读取CCR值之后立即进行。因为从边沿触发到中断响应有延迟，如果切换太慢，可能会错过紧接着的相反边沿，特别是对于很窄的脉冲。

4. 中断服务程序编写与脉宽计算实战

下面给出一个完整的、带有溢出处理的单通道双边沿捕获示例代码。我们假设定时器时钟为1MHz（1us/计数），ARR=65535。

// 在用户变量区定义 uint32_t capture_rising = 0; uint32_t capture_falling = 0; uint32_t pulse_width_us = 0; volatile uint8_t capture_state = 0; // 0:等上升沿，1:等下升沿 volatile uint32_t overflow_count = 0; // 定时器溢出次数 // 在main.c的合适位置（如定时器初始化后）启动捕获 HAL_TIM_Base_Start_IT(&htim3); // 启动定时器并开启更新（溢出）中断，用于计数溢出 HAL_TIM_IC_Start_IT(&htim3, TIM_CHANNEL_1); // 启动输入捕获中断 // 定时器更新（溢出）中断回调函数 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM3) { overflow_count++; // 每次溢出，溢出计数器加1 } } // 输入捕获中断回调函数 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM3 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { switch(capture_state) { case 0: // 捕获到上升沿 capture_rising = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 记录溢出次数，并清空本地溢出计数（或作为基准） // 这里简化处理，实际需结合overflow_count计算绝对时间戳 __HAL_TIM_SET_CAPTUREPOLARITY(&htim3, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); capture_state = 1; break; case 1: // 捕获到下降沿 capture_falling = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 计算脉宽，考虑溢出 // 假设overflow_count在上升沿和下降沿之间没有变化（短脉冲） // 长脉冲需要更复杂的溢出追踪逻辑 if (capture_falling >= capture_rising) { pulse_width_us = capture_falling - capture_rising; } else { // 下降沿计数值小于上升沿，说明中间发生了计数器溢出（从ARR回到0） // 此时脉宽 = (ARR - capture_rising + 1) + capture_falling pulse_width_us = (__HAL_TIM_GET_AUTORELOAD(&htim3) - capture_rising + 1) + capture_falling; // 如果开启了溢出中断并计数，还需要加上 overflow_count * (ARR+1) } // 计算得到的是计数值，乘以计数周期才是时间。这里1MHz时钟，1计数值=1us。 // pulse_width_time = pulse_width_us * 1us; // 切换回上升沿捕获，准备下一次测量 __HAL_TIM_SET_CAPTUREPOLARITY(&htim3, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); capture_state = 0; // 在这里可以使用pulse_width_us，例如通过串口打印 // printf("Pulse Width: %lu us\n", pulse_width_us); break; } } }

这段代码的精髓在于对计数器溢出的处理。当脉冲宽度可能超过定时器ARR设置的最大计数值时，计数器会从0重新开始。如果只简单用下降沿值减上升沿值，在发生溢出后结果会是负数（实际是很大的正数）。上面的代码通过判断capture_falling和capture_rising的大小关系，处理了一次溢出的情况。对于更长的、可能发生多次溢出的脉冲，就需要借助overflow_count这个全局变量来记录溢出的次数，计算绝对时间戳：绝对时间戳 = overflow_count * (ARR + 1) + CCR值。在上升沿和下降沿分别记录下当时的绝对时间戳，两者相减即得脉宽。

5. 高频信号捕获、滤波与抗干扰实践

当被测信号频率很高或环境噪声较大时，简单的配置可能无法稳定工作。

5.1 输入滤波器的使用

在CubeMX的通道配置中，IC Filter选项就是数字滤波器。它是一个事件计数器，只有当连续N个采样点都满足边沿条件时，才认为是一个有效的边沿事件。N的值由IC Filter的数值决定（对应特定的采样时钟数和事件数）。增大滤波值可以有效抑制高频毛刺，但会带来两个副作用：一是增加了输入延迟，二是可能滤掉真正的高频窄脉冲。我的经验法则是：滤波时间常数应设为最小需要识别的脉冲宽度的1/3到1/5以下。例如，要测量1us的脉冲，滤波时间最好小于200ns。对于72MHz定时器时钟，8分频后为9MHz，一个采样周期约111ns，滤波值设为2（即连续2个采样）带来的延迟约222ns，尚可接受。

5.2 捕获分频器 (IC Prescaler)

这个参数容易被忽略。它可以设置为每N个事件才捕获一次。例如，设置为“每2个事件”，那么每两个上升沿才会触发一次捕获。这主要用于测量频率，可以降低CPU中断频率。但在测量脉宽时，绝对不能使用分频，否则会丢失边沿事件，导致测量完全错误。务必保持为No division。

5.3 高频信号测量的限制

定时器输入捕获的最高频率受限于多个因素：

1. 定时器时钟频率：这是理论上的最高采样频率。
2. 输入滤波器：滤波器会限制最高有效信号频率。
3. 中断响应与处理时间：如果每个边沿都进中断，且中断服务程序执行时间过长，在高频下会导致CPU负载过高甚至丢失中断。对于高频周期信号，更推荐使用PWM输入模式或编码器模式，让硬件自动测量，或者使用DMA将CCR值循环传输到内存，再由主程序批量处理，彻底解放CPU。

5.4 硬件连接注意事项

• 信号完整性：对于边沿敏感的测量，确保信号线远离噪声源（如电机、电源线）。可以使用双绞线或屏蔽线。
• 电平匹配：确保输入信号的电压电平在MCU GPIO的容限范围内（通常是0-3.3V）。对于5V信号，必须使用电平转换电路或分压电阻。
• 上拉/下拉电阻：如果信号源是开漏输出，或者需要确定空闲状态，应在GPIO引脚配置内部或外部上拉/下拉电阻。在CubeMX的GPIO配置中即可设置。

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

即使配置正确，调试阶段也可能遇到各种奇怪的问题。下面是我总结的常见问题清单和排查手段。

一个高级调试技巧：使用GPIO模拟“软件逻辑分析仪”。在中断服务函数的开始和结束位置，分别控制一个空闲的GPIO引脚置高和置低。

// 在中断回调开始 HAL_GPIO_WritePin(DEBUG_PIN_GPIO_Port, DEBUG_PIN_Pin, GPIO_PIN_SET); // ... 中断处理逻辑 ... HAL_GPIO_WritePin(DEBUG_PIN_GPIO_Port, DEBUG_PIN_Pin, GPIO_PIN_RESET);

然后用示波器同时观察这个调试引脚和你的输入信号。你可以清晰地看到从边沿触发到中断服务结束的延迟时间，这对于优化代码和判断是否错过边沿至关重要。

最后，关于资源选择，对于简单的边沿计数或低频测量，基本定时器加外部中断也能做，但输入捕获的优势在于其硬件级的精确计时。对于电机控制、高频脉冲计数等复杂场景，高级定时器（TIM1, TIM8）的互补通道和刹车功能可能会派上用场。掌握输入捕获，是玩转STM32定时器家族的重要一步，它为你打开了一扇精确测量和控制时间事件的大门。