STM32输入捕获功能详解：从原理到实战的频率测量指南

1. 项目概述：从“捕获”到“理解”

在嵌入式开发，尤其是基于STM32这类MCU的项目中，我们常常需要与外部世界进行精确的“对话”。比如，你想知道一个按键被按下了多久，一个脉冲信号的频率是多少，或者一个旋转编码器转动的速度有多快。这些场景的核心，都指向一个共同的需求：精确测量一个外部信号的某些时间特性。而STM32的定时器模块中，有一个专门为此而生的强大功能——输入捕获。

简单来说，输入捕获就像给定时器装上了一双敏锐的“眼睛”和一只精准的“秒表”。当外部引脚上发生一个你预先设定好的事件（比如电平从低变高，即上升沿）时，这双“眼睛”会立刻发现，并触发“秒表”在那一瞬间“咔嚓”一下，记录下当前的时间值。通过连续记录两次或多次这样的时间戳，我们就能计算出信号的周期、频率、占空比，或者一个脉冲的宽度。这个功能是构建许多高级应用的基础，从简单的频率计、PWM测量，到复杂的电机测速、超声波测距、红外遥控解码，都离不开它。

对于刚接触STM32的开发者，定时器可能是个庞然大物，而输入捕获更是其中看似复杂的一环。但别担心，它的核心逻辑非常直观。本文将带你从零开始，彻底拆解STM32的输入捕获功能。我不会只给你一堆寄存器名称和库函数调用，而是会结合我实际项目中的经验，讲清楚为什么要这么配置，如何一步步搭建起一个可靠的捕获系统，以及在实际调试中可能遇到哪些坑，又该如何解决。无论你是正在做毕业设计的学生，还是需要快速实现产品功能的工程师，这篇文章都能为你提供一份可直接“抄作业”的详细指南。

2. 输入捕获的核心原理与工作模式

要玩转输入捕获，必须先理解它的“游戏规则”。STM32的定时器单元非常灵活，输入捕获功能通常关联着定时器的输入通道和捕获/比较寄存器。

2.1 定时器：时间的度量衡

首先，你得有一个不停走动的“秒表”，这就是定时器的计数器（CNT）。它通常由内部时钟驱动，以一个固定的频率（比如72MHz经过预分频后）递增或递减。这个计数器的值，就是我们的“时间戳”来源。输入捕获的本质，就是在特定时刻“冻结”并保存这个CNT值。

2.2 捕获通道：事件的触发器

每个支持输入捕获的定时器都有多个通道（如TIMx_CH1, CH2...）。你需要将外部信号连接到某个GPIO引脚，并将该引脚配置为对应定时器的复用功能（Alternate Function）。当信号到来时，会经过一个输入滤波器和边沿检测器。

• 边沿选择：你可以配置捕获是在信号的上升沿、下降沿还是双边沿触发。这是最基础的设置，决定了你在信号的哪个“瞬间”进行记录。
• 输入滤波：这是一个非常实用但容易被忽略的功能。现实世界的信号往往不是理想的方波，可能存在毛刺。输入滤波器相当于一个数字防抖，只有当信号电平在连续多个采样周期内保持稳定，才认为是一个有效的边沿。这对于抗干扰至关重要。

2.3 捕获寄存器：时间的保险箱

当设定的边沿事件发生时，硬件会自动将当前计数器CNT的值，复制到对应的捕获/比较寄存器（CCRx）中。同时，会置位一个标志位（CCxIF），并可以产生中断或DMA请求。这样，你就能在中断服务程序或通过查询标志位的方式，安全地读取这个被“捕获”到的时间值。

这里有一个关键点：捕获操作是“复制”而非“转移”，所以CNT计数器会继续运行，不受影响。这允许我们进行连续捕获。

2.4 工作模式解析：从单次到高级

根据需求不同，输入捕获可以配置成几种工作模式：

1. 单次捕获：捕获一次事件后便停止。适用于测量单次脉冲宽度。
2. 连续捕获：每次事件都触发捕获，并更新CCRx寄存器。你需要及时读取数据，否则新数据会覆盖旧数据。这是最常用的模式。
3. PWM输入模式：这是STM32提供的一个“豪华套餐”模式。它专门用于测量PWM信号的频率和占空比，通常使用两个通道（如CH1和CH2）协同工作，一个捕获上升沿，一个捕获下降沿，硬件自动计算，极大地简化了软件逻辑。如果你的目标是测PWM，强烈建议优先考虑此模式。
4. 编码器接口模式：虽然不完全是标准的输入捕获，但它是基于捕获原理的高级应用，用于直接读取正交编码器的位置和速度，硬件自动处理A、B两相脉冲，软件只需读取计数器的值即可。

理解了这些原理，你就知道配置寄存器时每一个选项的意义，而不是盲目地复制代码。

3. 实战配置：从零搭建一个频率测量模块

理论说再多，不如动手做一遍。我们以STM32F103系列（通用定时器TIM2）为例，目标是测量输入到PA0引脚（TIM2_CH1）的方波信号的频率。我们将使用标准外设库（Standard Peripheral Library）进行配置，因为其寄存器操作封装清晰，易于理解原理。后续可以很容易地迁移到HAL库或LL库。

3.1 硬件连接与引脚配置

第一步永远是硬件。假设你的信号源（例如信号发生器）输出连接到STM32的PA0引脚。

// 1. 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); // 2. 配置GPIO为复用推挽输出模式（用于输入捕获） GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; // 上拉输入，防止悬空 // 注意：对于输入捕获，引脚应配置为浮空输入(IN_FLOATING)或带上/下拉。 // 但更常见的做法是配置为复用功能(AF)，由定时器内部管理。 // 实际上，标准库中更常用 GPIO_Mode_IN_FLOATING 或 GPIO_Mode_IPU/D。 // 我们这里使用上拉输入，确保引脚有确定状态。 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 3. 将PA0引脚复用映射到TIM2_CH1 GPIO_PinRemapConfig(GPIO_PartialRemap1_TIM2, ENABLE); // 根据具体型号和引脚定义，可能不需要重映射或使用其他重映射选项。 // 对于F103，PA0默认就是TIM2_CH1，所以这步通常可以省略。这里仅为展示流程。

注意：关于GPIO模式的选择，容易混淆。对于纯粹的输入捕获功能，引脚模式设置为GPIO_Mode_IN_FLOATING（浮空输入）、GPIO_Mode_IPU（上拉输入）或GPIO_Mode_IPD（下拉输入）都是可以的，具体取决于外部电路。如果外部信号驱动能力强，浮空即可；如果信号可能悬空，加上拉或下拉可以避免误触发。而“复用功能”模式（GPIO_Mode_AF_PP等）通常用于定时器的输出功能（如PWM输出）。这一点务必分清，我见过不少新手在这里配置错误导致无法捕获。

3.2 定时器基础参数配置

接下来配置定时器本身，重点是设定它的“心跳”频率。

TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; // 假设系统时钟为72MHz，APB1定时器时钟也是72MHz // 我们希望定时器计数一次代表1微秒，这样捕获的时间值直接就是微秒数，方便计算。 // 预分频系数 = 时钟频率 / 计数频率 - 1 // 计数频率 = 1MHz (1us) -> 预分频 = 72MHz / 1MHz - 1 = 71 TIM_TimeBaseStructure.TIM_Prescaler = 71; // 预分频值，决定计数器的计数频率 TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; // 向上计数模式 TIM_TimeBaseStructure.TIM_Period = 0xFFFF; // 自动重装载值，设为最大值65535 // 因为我们是测频率，通过两次捕获值差来算周期，只要周期小于计数器溢出时间即可。 // 周期最大值 = (ARR+1) * (PSC+1) / 时钟频率 = 65536 * 72 / 72MHz = 65.536 ms // 对应最小频率约为15.26 Hz。低于此频率的信号，需要考虑计数器溢出处理。 TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; // 时钟分频，与输入滤波相关，通常DIV1 TIM_TimeBaseStructure.TIM_RepetitionCounter = 0; // 高级定时器才有，通用定时器忽略 TIM_TimeBaseInit(TIM2, &TIM_TimeBaseStructure);

参数选择的考量：

• 预分频器（PSC）：它决定了定时器计数器（CNT）递增的速度。CNT频率 = 定时器时钟 / (PSC + 1)。设置PSC=71，将72MHz时钟分频为1MHz，即CNT每1微秒加1。这个分辨率（1us）对于测量音频范围乃至更高频率的信号通常足够了。如果你需要测量更宽的范围或更高精度，可以调整这个值。原则是：在保证不溢出的前提下，尽量提高分辨率（即降低PSC值）。
• 自动重装载值（ARR）：这是计数器的上限。当CNT计数到ARR时，会产生更新事件并清零（或根据模式重载）。在输入捕获中，我们通常将ARR设为最大值（如16位定时器是65535），以获取最大的测量范围，避免在测量一个周期内频繁溢出，简化计算。但要注意，这会影响PWM输入模式等高级功能的配置。

3.3 输入捕获通道配置

这是最核心的配置部分，告诉定时器如何“看”那个引脚。

TIM_ICInitTypeDef TIM_ICInitStructure; // 配置通道1为输入捕获模式 TIM_ICInitStructure.TIM_Channel = TIM_Channel_1; // 通道选择 TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; // 捕获边沿：上升沿 TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI; // 输入映射：直接映射到TI1 // TIM_ICSelection_DirectTI 表示信号直接连接到这个通道。 // 还有交叉映射(TIM_ICSelection_IndirectTI)，用于特殊连接。 TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; // 输入捕获预分频：每个边沿都捕获 // 这个分频是针对捕获事件的，例如设为DIV4，则每4个边沿才捕获一次。通常我们设为DIV1。 TIM_ICInitStructure.TIM_ICFilter = 0x0; // 输入滤波器系数：0表示不滤波 // 滤波器值范围0x0~0xF。值越大，需要信号稳定的采样次数越多，抗噪能力越强，但会引入延迟并可能错过高频信号。 // 对于干净的数字信号，设为0即可。对于有毛刺的环境（如电机霍尔传感器），需要根据信号特性调整，比如设为0x4或0x8。 TIM_ICInit(TIM2, &TIM_ICInitStructure);

关键点解析：

• 输入滤波器（ICFilter）：这是硬件抗干扰的第一道防线。它的原理是连续采样。例如，设置为0x4，意味着信号边沿需要被连续采样到4次（且电平一致）才被确认有效。这能滤除窄毛刺。调试时如果发现捕获值不稳定、乱跳，首先应该检查并适当增大这个值。但要注意，过大的滤波值会延迟捕获响应，并可能滤掉真正的高频成分。
• 捕获预分频器（ICPrescaler）：这个功能容易被忽略。它允许你每N个边沿才捕获一次。比如在测量一个已知分频后的信号，或者你想降低中断频率时很有用。对于普通的频率测量，我们通常设为DIV1。

3.4 中断与使能

配置完成后，我们需要开启捕获中断，并在中断中读取数据。

// 开启捕获/比较1中断 TIM_ITConfig(TIM2, TIM_IT_CC1, ENABLE); // 配置NVIC（嵌套向量中断控制器） NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel = TIM2_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; // 抢占优先级 NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; // 子优先级 NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure); // 最后，使能定时器 TIM_Cmd(TIM2, ENABLE);

4. 软件逻辑：中断服务程序与频率计算

硬件配置好后，灵魂在于软件处理逻辑。我们将在TIM2的中断服务程序中处理捕获事件。

4.1 中断服务程序框架

// 定义全局变量用于存储捕获值和状态 volatile uint32_t Capture_Val1 = 0, Capture_Val2 = 0; volatile uint32_t Period = 0; volatile uint8_t Capture_Flag = 0; // 捕获完成标志 volatile uint8_t Capture_Stage = 0; // 捕获阶段：0-等待第一个上升沿，1-已捕获第一个上升沿 void TIM2_IRQHandler(void) { if (TIM_GetITStatus(TIM2, TIM_IT_CC1) != RESET) // 检查是否是通道1的捕获中断 { TIM_ClearITPendingBit(TIM2, TIM_IT_CC1); // 清除中断标志位！非常重要！ if (Capture_Stage == 0) { // 第一次捕获（上升沿） Capture_Val1 = TIM_GetCapture1(TIM2); // 读取捕获寄存器CCR1的值 Capture_Stage = 1; // 可选：将触发边沿改为下降沿，以测量高电平脉宽 // TIM_OC1PolarityConfig(TIM2, TIM_ICPolarity_Falling); } else if (Capture_Stage == 1) { // 第二次捕获（下一个上升沿） Capture_Val2 = TIM_GetCapture1(TIM2); // 计算周期差值，需要考虑计数器溢出！ if (Capture_Val2 >= Capture_Val1) { Period = Capture_Val2 - Capture_Val1; } else { // 发生了溢出，差值 = (ARR - Val1) + Val2 + 1 // 因为我们ARR=0xFFFF，所以简化计算： Period = (0xFFFF - Capture_Val1) + Capture_Val2 + 1; // 更通用的写法：Period = (0x10000 - Capture_Val1) + Capture_Val2; } Capture_Flag = 1; // 设置标志，通知主循环周期已计算好 Capture_Stage = 0; // 重置阶段，准备下一次测量 // 如果之前改为了下降沿，这里需要改回上升沿 // TIM_OC1PolarityConfig(TIM2, TIM_ICPolarity_Rising); } } // 处理更新（溢出）中断，用于扩展测量范围 if (TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) { TIM_ClearITPendingBit(TIM2, TIM_IT_Update); // 可以在这里维护一个溢出计数器，用于计算长周期 // Overflow_Count++; } }

4.2 频率计算与主循环处理

在主函数或主循环中，我们等待捕获完成标志，然后计算频率。

int main(void) { // ... 系统初始化，上述配置 ... float frequency = 0.0f; while (1) { if (Capture_Flag) { Capture_Flag = 0; // 清除标志 // Period 单位是“定时器计数次数” // 定时器计数周期 T_cnt = (PSC+1) / 定时器时钟频率 // 本例中，PSC=71，时钟72MHz -> T_cnt = 72 / 72MHz = 1 us // 信号周期 T_signal = Period * T_cnt = Period (us) // 频率 f = 1 / T_signal = 1 / (Period * 1e-6) = 1e6 / Period (Hz) if (Period > 0) // 避免除零错误 { frequency = 1000000.0f / (float)Period; // 单位 Hz // 现在你可以通过串口打印 frequency，或者用LCD显示等。 printf("Period: %lu us, Frequency: %.2f Hz\r\n", Period, frequency); } } // ... 其他任务 ... } }

计算过程详解：

1. Period是两次上升沿之间，定时器计数器走过的“格子”数。
2. 每个“格子”的时间长度由预分频器决定：T_cnt = (TIM_Prescaler + 1) / TIMx_CLK。
3. 本例中，TIM_Prescaler=71,TIMx_CLK=72e6 Hz，所以T_cnt = 72 / 72e6 = 1e-6 s = 1 us。
4. 因此，信号周期T_signal = Period * 1 us。
5. 信号频率f = 1 / T_signal = 1e6 / Period Hz。

这个计算是理解输入捕获测量的核心。改变预分频器（PSC），这个公式就需要相应调整。

5. 高级话题与性能优化

基本的频率测量实现了，但在实际项目中，我们往往面临更复杂的需求和更严苛的环境。

5.1 处理计数器溢出：测量长周期信号

上面的例子假设信号的周期小于定时器从0计数到ARR（65535）的时间（即65.536ms）。如果要测量更低频率的信号，就必须处理计数器溢出。方法是在**更新中断（溢出中断）**中维护一个溢出计数器。

volatile uint32_t Overflow_Count = 0; volatile uint32_t Last_Capture_Val = 0; volatile uint32_t Total_Period_Ticks = 0; // 在TIM2_IRQHandler中，除了CC1中断，还要处理Update中断 if (TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) { TIM_ClearITPendingBit(TIM2, TIM_IT_Update); Overflow_Count++; // 溢出次数加1 } // 在捕获中断中，计算总计数时加入溢出部分 if (Capture_Stage == 1) { Capture_Val2 = TIM_GetCapture1(TIM2); uint32_t overflow_during_capture = Overflow_Count; // 记录当前的溢出次数 // 计算总滴答数 Total_Period_Ticks = (overflow_during_capture * (TIM2->ARR + 1)) + Capture_Val2 - Capture_Val1; // 更严谨的做法：需要考虑第一次捕获前可能已经发生的溢出，这需要更复杂的状态机。 // 一个简单可靠的方法是使用定时器的“捕获分频”功能或PWM输入模式，或者使用一个从定时器。 }

处理溢出是输入捕获中的一个难点，容易出错。一个更稳健的建议是：如果可能，尽量调整预分频器，让被测信号的周期远小于定时器的溢出周期，从而避免复杂的溢出处理逻辑。或者，对于极低频率的测量，可以考虑使用外部中断配合基本定时器来计数。

5.2 使用PWM输入模式简化测量

如果你需要同时测量PWM信号的频率和占空比，强烈推荐使用PWM输入模式。该模式硬件自动将两个通道（通常TI1映射到IC1和IC2）配置为上升沿和下降沿捕获，并自动将周期值存于一个寄存器，脉宽存于另一个寄存器，且能自动复位计数器，省去了软件处理边沿切换和溢出计算的麻烦。

// 配置PWM输入模式（以TIM2，通道1为例） TIM_ICInitTypeDef TIM_ICInitStructure; TIM_ICInitStructure.TIM_Channel = TIM_Channel_1; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI; TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; TIM_ICInitStructure.TIM_ICFilter = 0x0; TIM_ICInit(TIM2, &TIM_ICInitStructure); // 配置通道2为间接输入（从TI1输入） TIM_ICInitStructure.TIM_Channel = TIM_Channel_2; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Falling; // 捕获下降沿（脉宽结束） TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_IndirectTI; // 间接来自TI1 TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; TIM_ICInitStructure.TIM_ICFilter = 0x0; TIM_ICInit(TIM2, &TIM_ICInitStructure); // 设置PWM输入模式（本质是配置从模式控制器为复位模式，触发源为TI1） TIM_SelectInputTrigger(TIM2, TIM_TS_TI1FP1); // 选择TI1作为触发源 TIM_SelectSlaveMode(TIM2, TIM_SlaveMode_Reset); // 从模式：复位模式 TIM_SelectMasterSlaveMode(TIM2, TIM_MasterSlaveMode_Enable); // 开启通道1和通道2的捕获中断 TIM_ITConfig(TIM2, TIM_IT_CC1 | TIM_IT_CC2, ENABLE);

配置完成后，周期值（频率）会自动保存在CCR1寄存器（上升沿触发），高电平脉宽值（占空比计算用）会自动保存在CCR2寄存器（下降沿触发），且每次上升沿捕获后计数器CNT会被硬件自动清零。你只需要在中断中分别读取CCR1和CCR2即可，软件逻辑大大简化。

5.3 使用DMA传输捕获数据

在高频信号测量或需要极低CPU干预的场景下，频繁的中断可能成为瓶颈。此时，可以利用DMA（直接存储器访问）功能，在捕获事件发生时，自动将捕获寄存器（CCRx）的值搬运到内存数组中。

// 配置DMA（以TIM2_CH1的CCR1寄存器到内存为例） DMA_InitTypeDef DMA_InitStructure; // ... 配置DMA通道、外设地址（&TIM2->CCR1）、内存地址、数据长度、传输方向等 ... DMA_Cmd(DMA1_Channel5, ENABLE); // 假设TIM2_CH1对应DMA1通道5 // 配置TIM2的CC1 DMA请求 TIM_DMACmd(TIM2, TIM_DMA_CC1, ENABLE);

这样，每次捕获发生时，CCR1的值会自动存入你指定的数组，并可以触发DMA传输完成中断。你可以在DMA半满或全满中断中批量处理数据，极大地提高了效率，适合用于高速数据流采集或数字解调。

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

即使代码逻辑正确，在实际硬件调试中也可能遇到各种问题。以下是我在多年项目中总结的排查清单。

6.1 常见问题速查表

6.2 我的实操心得与避坑指南

1. 示波器是你的最佳搭档：在调试输入捕获时，一个示波器至关重要。用它来确认信号是否真的到达了MCU引脚，观察波形质量（有无过冲、毛刺），并测量实际频率，与你的代码计算结果进行对比。这是定位硬件问题最直接的方法。

2. 从最简单的情况开始：先用一个已知频率的、干净稳定的方波信号（比如用另一个定时器PWM输出产生的）进行测试。排除信号源的不确定性，确保你的软件逻辑正确。

3. 善用输入滤波器：TIM_ICFilter是硬件送给你的免费抗干扰礼物。对于来自电机、开关、长导线的信号，默认一定要加上滤波（比如设为0x4）。它的效果往往比软件滤波好得多，且不消耗CPU资源。

4. 中断服务程序要“短平快”：在捕获中断里，只做读取寄存器、设置标志、简单计数等操作。绝对避免使用printf、浮点运算、长时间循环等耗时操作。如果需要复杂计算或显示，通过标志位通知主循环来处理。

5. 理解“影子寄存器”：STM32很多定时器寄存器（如PSC、ARR）有影子寄存器。写入的值不会立即生效，要等到下次更新事件（UEV）。在频繁动态修改这些参数（比如动态调整预分频来适应不同频率范围）时，要注意这个延迟，或者使用TIM_GenerateEvent函数手动触发更新事件。

6. 关于HAL库的Callback：如果你使用HAL库，输入捕获中断处理在HAL_TIM_IC_CaptureCallback回调函数中。HAL库封装了大量底层操作，但有时会隐藏细节。务必在CubeMX中正确配置通道参数，并在回调函数中通过htim->Channel判断是哪个通道触发的中断。

输入捕获是STM32定时器家族中一个极具实用价值的功能。从理解其核心的“瞬间冻结时间”思想开始，到一步步配置寄存器、处理中断、计算参数，再到应对实际工程中的噪声、溢出、性能问题，这个过程是对嵌入式开发者硬件抽象能力和问题解决能力的绝佳锻炼。希望这份结合了原理与实战、充满了“踩坑”经验的指南，能帮助你顺利地将这个强大的功能应用到你的下一个项目中。当你看到屏幕上稳定显示着外部信号的频率时，那种对硬件精准控制的成就感，正是嵌入式开发的乐趣所在。如果在实践中遇到新的问题，不妨回头看看滤波器的设置、中断的优化，或者换个思路，试试PWM输入模式或DMA，总有一种方法能让你的系统稳定运行。