STM32定时器输入捕获：从原理到实战，攻克蓝桥杯嵌入式竞赛高频考点-开发者社区

1. 项目概述：从零到一，理解嵌入式竞赛中的“时间脉搏”

在嵌入式开发，尤其是像蓝桥杯这类强调底层驱动与实时性的竞赛中，对时间的精确测量与控制是贯穿始终的核心技能。很多新手拿到题目，看到需要测量脉冲宽度、频率或者生成精确的PWM波时，往往会感到无从下手。这背后，往往都绕不开一个关键的外设：定时器的输入捕获功能。我参加过多届蓝桥杯嵌入式赛事的辅导，发现选手们在TIM（定时器）捕获应用上的失分点非常集中，要么是配置流程混乱，要么是对边界情况处理不当。这次，我们就以备战蓝桥杯嵌入式为场景，深挖STM32的TIM计时器捕获功能，不光是讲寄存器怎么配，更要讲清楚在竞赛高压环境下，如何写出稳定、高效且易于调试的捕获代码。无论你是第一次接触STM32定时器，还是已经用过但总感觉不踏实，这篇文章都将带你从原理到实战，完整走一遍输入捕获的“备战之旅”。

2. 核心需求与场景拆解：为什么捕获功能如此重要？

在蓝桥杯嵌入式赛题中，定时器捕获功能的应用场景非常具体且高频。理解这些场景，你才能明白为什么需要花大力气掌握它。

2.1 典型赛题场景分析

最常见的需求莫过于测量传感器输出的脉冲信号。例如，超声波测距模块（如HC-SR04）会返回一个与距离成正比的高电平脉冲宽度；某些编码器或转速传感器会输出频率与转速成正比的方波；甚至是一些自定义的通信协议，也可能利用脉冲宽度来编码数据。这些场景都要求MCU能够精确地测量一个未知脉冲的高电平持续时间（脉宽）或信号的周期（频率）。这就是输入捕获功能的用武之地：它能在输入信号的边沿（上升沿或下降沿）触发时，自动锁存当前定时器的计数值，为我们计算时间间隔提供了原始数据。

另一个隐含需求是系统的实时性与可靠性。竞赛环境下的电路可能受到干扰，信号未必完美。你的捕获程序能否在信号有毛刺时稳定工作？能否在长时间测量中避免计数值溢出？这些考量直接决定了作品功能的鲁棒性。此外，资源分配也很关键。STM32的定时器资源有限（如CT117E开发板常用的STM32G431，定时器功能强大但数量固定），你需要合理规划，让定时器同时服务于捕获、PWM输出、基本计时等多个任务。

2.2 从原理到模块：捕获功能的核心逻辑

输入捕获的本质，是利用定时器这个不断运行的“时钟”，为外部事件打上精确的时间戳。其核心硬件单元是捕获/比较寄存器（CCR）和捕获/比较通道。当配置为输入捕获模式后，对应的输入引脚（如TIMx_CHy）上的信号边沿，会通过输入滤波和边沿检测电路，产生一个触发信号。这个触发信号会做两件关键事：第一，它会让当前定时器计数器（CNT）的值，瞬间拷贝到对应的CCRy寄存器中“冻结”起来；第二，它可能会产生一个中断请求或者DMA请求，通知CPU“有事件发生，快来处理数据”。

对于测量脉宽，标准做法是使用同一个定时器通道，但分两次捕获。第一次配置为上升沿捕获，记录下时间戳T1；随后在中断服务程序中，立刻将捕获边沿改为下降沿，等待下一次触发，记录时间戳T2。那么，高电平脉宽 = (T2 - T1) * 定时器计数周期。如果T2 < T1（发生了计数器溢出），则需要在计算时加上定时器的溢出周期值（ARR+1）。测量频率则通常测量两个相邻上升沿之间的时间，即信号周期。

注意：在CubeMX等工具自动生成代码的今天，很多选手忽略了底层原理，直接套用模板。但在竞赛调试时，一旦出现问题（比如捕获值永远不变或跳动很大），如果不明白上述流程，排查将异常困难。你必须清楚从引脚信号到CCR寄存器数据的完整路径。

3. 硬件与软件环境准备

工欲善其事，必先利其器。蓝桥杯嵌入式竞赛有指定的开发平台，我们的配置必须围绕它展开。

3.1 硬件平台关键点

目前主流竞赛板是CT117E，核心MCU为STM32G431RBT6。关于定时器，你需要牢记以下几点：

定时器资源：STM32G431拥有高级定时器（TIM1, TIM8），通用定时器（TIM2, TIM3, TIM15, TIM16, TIM17），基本定时器（TIM6, TIM7）。输入捕获功能通常使用通用定时器。
引脚复用：不是所有引脚都能用作任意定时器的通道。必须查阅STM32G431的数据手册或CubeMX的引脚分配图，确认你计划使用的引脚（如PA0, PA1等）是否支持对应TIM的CHx功能。竞赛中，引脚连接通常在题目原理图中给出，务必核对。
时钟树：定时器的计数时钟来源于APB总线。STM32G431上电后默认使用HSI（16MHz）作为系统时钟。通过配置，可以将系统时钟提升到170MHz。定时器的实际计数频率 = 定时器时钟源 / (PSC + 1)。理解时钟树是配置出正确计时基准的前提。一个常见的错误是PSC和ARR值设置不当，导致要么测量精度不够，要么很快溢出。

3.2 软件工具与工程配置

软件层面，官方推荐使用STM32CubeMX进行初始化，配合Keil MDK或STM32CubeIDE进行开发。我们的讨论将以CubeMX生成代码框架为基础，但重点会放在手动添加和修改的关键代码上，因为CubeMX不会生成完整的应用逻辑。

首先，在CubeMX中为你的项目选择正确的MCU型号。在Pinout & Configuration标签页，你需要做如下关键配置：

在Timers类别下，找到你计划使用的定时器（例如TIM2）。
将某个通道（例如Channel 1）设置为Input Capture direct mode。
在参数配置中，设置Prescaler (PSC)和Counter Period (ARR)。这是计算时间的核心。例如，如果系统时钟为80MHz，我们希望定时器计数频率为1MHz（即每个计数代表1微秒），则PSC应设置为80-1=79。ARR一般设置为最大值65535（对于16位定时器），以获得最大的捕获范围。
配置IC Filter（输入滤波器）：在信号有噪声时，可以设置一个滤波值（如0x8）来稳定触发，但会增加延迟。竞赛环境若连线较短，通常可设为0（无滤波）。
开启捕获中断：在NVIC Settings中勾选对应的定时器中断（如TIM2 global interrupt）并设置合适的优先级。

生成代码后，CubeMX会帮你初始化GPIO和定时器外设，并生成中断服务函数框架（如TIM2_IRQHandler）。真正的战斗，从这里才刚刚开始。

4. 输入捕获功能深度配置与代码实现

生成代码只是搭好了舞台，演员怎么表演全靠我们写的代码。下面我们以一个具体的例子——测量PA0引脚（TIM2_CH1）上输入脉冲的高电平宽度——来详解实现步骤。

4.1 定时器参数计算与初始化代码解读

在tim.c文件中，你能找到CubeMX生成的定时器初始化函数MX_TIM2_Init。理解其中每一行配置的意义至关重要。

htim2.Instance = TIM2; htim2.Init.Prescaler = 79; // 预分频器，假设系统时钟80MHz，80/(79+1)=1MHz htim2.Init.CounterMode = TIM_COUNTERMODE_UP; // 向上计数模式 htim2.Init.Period = 65535; // 自动重装载值，16位最大值 htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; // 时钟分频，通常为1 htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE; // 竞赛中通常禁用预装载，使ARR修改立即生效 if (HAL_TIM_IC_Init(&htim2) != HAL_OK) // 初始化输入捕获 { Error_Handler(); }

接下来是通道配置，它在HAL_TIM_IC_ConfigChannel函数中被调用：

TIM_IC_InitTypeDef sConfigIC = {0}; sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING; // 初始化为上升沿捕获 sConfigIC.ICSelection = TIM_ICSELECTION_DIRECTTI; // 直接映射到TI1输入 sConfigIC.ICPrescaler = TIM_ICPSC_DIV1; // 输入捕获预分频，每个边沿都捕获 sConfigIC.ICFilter = 0; // 滤波器系数，根据信号质量调整 if (HAL_TIM_IC_ConfigChannel(&htim2, &sConfigIC, TIM_CHANNEL_1) != HAL_OK) { Error_Handler(); }

这段代码配置了通道1的捕获参数。这里ICSelection是一个关键点：TIM_ICSELECTION_DIRECTTI表示通道信号直接连接到对应的输入引脚。如果是交叉模式（如用TI2映射到CH1），则需要选择TIM_ICSELECTION_INDIRECTTI，这在某些特殊接线情况下会用到。

4.2 捕获状态机与中断服务程序编写

这是整个捕获逻辑的核心。我们需要定义一个状态机来管理捕获过程，并处理好中断。

首先，在合适的地方（如main.c的私有变量区）定义状态变量和捕获值变量：

// 捕获状态机 typedef enum { CAPTURE_IDLE, // 空闲，等待第一个上升沿 CAPTURE_RISING, // 已捕获上升沿，等待下降沿 CAPTURE_FALLING // 已捕获下降沿，完成一次测量 } CaptureState_t; volatile CaptureState_t g_capture_state = CAPTURE_IDLE; volatile uint32_t g_capture_rise_val = 0; volatile uint32_t g_capture_fall_val = 0; volatile uint32_t g_pulse_width_ticks = 0; // 脉宽，单位是定时器计数次数 volatile uint8_t g_capture_ready_flag = 0; // 测量完成标志

使用volatile关键字是因为这些变量会在中断服务程序中被修改，防止编译器进行不优化的读取。

然后，在main函数的初始化部分，启动定时器和捕获中断：

HAL_TIM_Base_Start(&htim2); // 必须启动定时器基础计数 HAL_TIM_IC_Start_IT(&htim2, TIM_CHANNEL_1); // 启动通道1的输入捕获并开启中断

接下来，编写中断服务函数TIM2_IRQHandler，它内部会调用HAL库的通用处理函数HAL_TIM_IRQHandler。我们需要重写对应的回调函数来添加自己的逻辑。在main.c中，找到或重写HAL_TIM_IC_CaptureCallback函数：

void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { // 确保中断来自TIM2的通道1 if (htim->Instance == TIM2 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { switch(g_capture_state) { case CAPTURE_IDLE: // 第一次捕获到上升沿 g_capture_rise_val = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 读取CCR1 g_capture_state = CAPTURE_RISING; // 关键操作：将捕获边沿改为下降沿 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); break; case CAPTURE_RISING: // 捕获到下降沿 g_capture_fall_val = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_state = CAPTURE_FALLING; // 计算脉宽（考虑溢出） if (g_capture_fall_val >= g_capture_rise_val) { g_pulse_width_ticks = g_capture_fall_val - g_capture_rise_val; } else { // 发生了一次定时器溢出（ARR=65535） g_pulse_width_ticks = (65535 - g_capture_rise_val) + g_capture_fall_val + 1; } g_capture_ready_flag = 1; // 设置完成标志 // 为下一次测量做准备：重置为上升沿捕获，并清除可能残留的中断标志 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); g_capture_state = CAPTURE_IDLE; // 重要：清除可能因切换边沿而产生的虚假中断标志 __HAL_TIM_CLEAR_IT(htim, TIM_IT_CC1); break; default: break; } } }

这段代码构成了一个完整的单次脉宽测量状态机。它的精妙之处在于，在一次测量完成后，自动将配置切换回初始状态，准备下一次测量，形成了循环。

4.3 主循环中的数据处理与应用

在main函数的while(1)循环中，我们轮询检查测量完成标志，并进行后续处理，例如将计数值转换为微秒并打印：

while (1) { if(g_capture_ready_flag) { g_capture_ready_flag = 0; // 清除标志 uint32_t pulse_width_us = g_pulse_width_ticks; // 因为之前配置了1MHz计数频率，1个tick=1us // 假设脉冲宽度在毫秒级，可以转换为毫秒 // uint32_t pulse_width_ms = pulse_width_us / 1000; printf("Pulse Width: %lu us\r\n", pulse_width_us); // 这里可以添加你的应用逻辑，比如根据脉宽计算距离等 // distance = (pulse_width_us * 0.034) / 2; // 超声波测距公式示例 } // 其他任务... }

使用printf输出到串口是竞赛中调试和显示结果的常用手段，需要事先初始化好串口。

5. 高频问题排查与性能优化实战

即使代码逻辑正确，在实际竞赛环境中还是会遇到各种问题。下面是我总结的几个典型坑点及其解决方案。

5.1 捕获值不更新或永远为0

这是新手最常遇到的问题，可能的原因和排查步骤是：

GPIO模式未正确配置：虽然CubeMX通常会自动配置，但请双击检查引脚是否被设置为Alternate Function模式，并且正确的定时器通道已映射到该引脚。有时引脚冲突（被其他功能占用）会导致此问题。
定时器未启动：确认HAL_TIM_Base_Start()和HAL_TIM_IC_Start_IT()都被成功调用。我习惯在调用后加一个简单的if判断，或者通过调试器查看定时器的CR1寄存器的CEN位是否为1。
中断未开启或优先级过低：在CubeMX的NVIC配置中确认中断已使能。如果程序中还有其他高优先级中断长时间执行，可能会阻塞捕获中断。确保捕获中断有合适的优先级。
信号问题：用示波器或逻辑分析仪查看引脚上是否有预期的信号。如果没有，检查传感器或信号源是否工作，连线是否正确。这是硬件排查的第一步。

5.2 测量结果跳动大、不准确

如果测量值在小范围内随机波动，可能是噪声引起。

增加输入滤波器：在CubeMX中增大ICFilter的值（如从0改为4或8）。这会要求信号边沿稳定若干个时钟周期后才被确认，能有效滤除毛刺，但会引入微小延迟。
检查定时器时钟基准：确认PSC和ARR的计算是否正确。如果定时器时钟频率不对，所有测量值都会按比例错误。可以通过一个简单的测试来验证：配置定时器在溢出时产生更新中断，在中断里翻转一个LED，通过LED闪烁的频率来反推定时器实际周期。
避免在中断服务函数中做复杂运算：我们的回调函数中进行了减法、判断和加法。对于16位定时器这没问题，但如果运算更复杂或中断过于频繁，可能影响实时性。确保中断服务函数执行时间尽可能短。

5.3 长时间测量与计数器溢出处理

我们的示例代码处理了一次溢出的情况（当fall_val < rise_val时）。但这只处理了一次溢出。如果脉冲宽度非常长，超过了定时器溢出周期（ARR+1）的很多倍，上述简单逻辑就会出错。

解决方案：使用定时器的更新中断（溢出中断）来扩展计数范围。

在CubeMX中使能TIM2的更新中断。
定义一个溢出计数变量volatile uint16_t g_tim_overflow_cnt = 0;。
在更新中断回调函数HAL_TIM_PeriodElapsedCallback中，对g_tim_overflow_cnt加1。

在计算脉宽时，公式变为：

uint32_t total_overflow = g_tim_overflow_cnt; // 假设测量期间溢出次数被记录 if (g_capture_fall_val >= g_capture_rise_val) { g_pulse_width_ticks = (total_overflow * (65535+1)) + (g_capture_fall_val - g_capture_rise_val); } else { // 最后一次捕获发生在一次新的溢出周期内 g_pulse_width_ticks = (total_overflow * (65535+1)) + (65535 - g_capture_rise_val) + g_capture_fall_val + 1; } // 计算完成后，记得重置g_tim_overflow_cnt以备下次测量

这里的关键是，需要在一次测量开始（捕获到第一个上升沿）时记录当前的溢出计数作为基准，在测量结束时再读取一次，两者相减得到测量期间发生的溢出次数。这需要更精细的状态管理。

5.4 资源冲突与多通道捕获

有时一个赛题需要同时测量两路信号。如果它们频率不高，可以用一个定时器的两个不同通道（如TIM2的CH1和CH2）分别捕获。每个通道有独立的CCR寄存器和中断标志。在中断回调中，通过判断htim->Channel是HAL_TIM_ACTIVE_CHANNEL_1还是_2来区分处理。注意，它们共享同一个定时器计数器CNT，因此时钟基准一致，便于比较。

如果定时器资源紧张，还可以考虑使用从模式下的复位触发模式。将一个通道配置为触发输入，另一个配置为捕获。这样，第一个通道的边沿可以复位计数器，第二个通道捕获的值直接就是两个边沿的时间差，简化了软件计算，但硬件连接有特定要求。

6. 竞赛实战技巧与代码鲁棒性提升

在分秒必争的竞赛现场，稳定可靠的代码比炫技更重要。下面分享几个提升代码质量的实战技巧。

6.1 使用DMA替代中断进行连续捕获

对于高频信号的测量（比如频率在几十kHz以上），频繁的中断会消耗大量CPU资源，甚至导致丢失边沿。此时，可以使用定时器的DMA功能，将捕获到的CCR值自动搬运到内存数组中。

配置方法：在CubeMX中，除了使能捕获，还在DMA设置里添加一条，将TIMx_CHx的CCR寄存器作为源地址，内存数组作为目标地址，传输宽度为半字（16位），模式为循环模式。这样，每次捕获事件都会触发DMA传输，CPU完全不用干预。你只需要定期去检查数组中是否有新数据，并计算差值即可。这大大降低了系统负载，提高了测量上限频率。

6.2 封装与模块化设计

将捕获相关的变量和函数封装到一个独立的.c/.h文件对中，例如pulse_capture.c。提供清晰的初始化接口PulseCapture_Init()、启动接口PulseCapture_Start()、获取结果的接口PulseCapture_GetWidth_us()。这样在主程序中，逻辑会非常清晰：

PulseCapture_Init(); // 初始化 PulseCapture_Start(); // 开始测量 while(1) { if(PulseCapture_IsReady()) { uint32_t width = PulseCapture_GetWidth_us(); // ... 处理数据 } }

模块化设计便于调试，也方便将功能复用到其他项目或赛题中。

6.3 加入超时与错误检测机制

在实际环境中，信号可能丢失。如果程序一直等待下降沿而信号始终不来，就会卡死。一个健壮的程序应该加入超时机制。

在状态变为CAPTURE_RISING（等待下降沿）时，启动一个基本的软件定时器（可以用SysTick或另一个硬件定时器）。
设定一个合理的超时时间（比如最大预期脉宽的1.5倍）。
在超时定时器的中断或主循环检查中，如果发现超时且状态仍为CAPTURE_RISING，则判定为信号丢失，重置捕获状态机到CAPTURE_IDLE，并可通过标志位上报一个错误。

6.4 调试与验证策略

在将代码用于最终作品前，必须进行充分验证。

信号模拟：使用开发板的另一个定时器输出一个已知频率和占空比的PWM波，连接到捕获引脚。用你的捕获程序去测量，看结果是否与设定值一致。这是最直接的闭环测试。
利用调试器：在Keil/IAR的调试模式下，可以实时查看CCR寄存器的值、状态变量、溢出计数等。在捕获回调函数中设置断点，可以单步观察状态机的流转。
打印日志：在关键节点（如进入中断、状态切换、完成计算）通过串口打印简短日志。虽然会增加时间开销，但在前期调试时非常有用。正式比赛前可以移除或条件编译掉这些日志。

掌握TIM输入捕获，就像是掌握了嵌入式系统感知“时间脉搏”的听诊器。它不仅仅是配置几个寄存器，更关乎对硬件工作流程的深刻理解、对异常情况的周全考虑，以及编写出既高效又健壮的代码能力。在蓝桥杯这样的赛场上，一个稳定可靠的捕获模块，往往是完成测距、测速、解码等高级任务的基础。希望这篇从原理到陷阱、从配置到优化的详细梳理，能帮你夯实这一关键技能，在备战之旅中走得更稳更远。