1. 项目概述从“蓝桥杯嵌入式”到“输入捕获”的核心价值如果你正在准备蓝桥杯嵌入式组的比赛或者刚刚开始学习STM32这类微控制器那么“定时器的输入捕获”这个功能绝对是你绕不开、也必须啃下来的硬骨头。我当年备赛和后来带学生的时候发现很多朋友对GPIO、PWM输出掌握得还行但一到输入捕获测频率、测脉宽代码就写得磕磕绊绊要么抓不准边沿要么计算出的数值飘忽不定。其实输入捕获是嵌入式系统中一个非常经典且强大的“感知”工具它能让你的单片机精确地“听”到外部信号的节奏比如旋转编码器的转速、红外遥控的编码、超声波测距的回波时间甚至是电源管理中的占空比检测。在蓝桥杯的赛题里它更是高频考点从简单的按键消抖时间测量到复杂的电机转速闭环控制底层都离不开它。所以今天我们不聊空洞的理论就从一个嵌入式开发者的实战角度彻底拆解定时器的输入捕获功能。我会结合蓝桥杯常用的STM32G4或类似系列平台把配置流程、寄存器操作、中断逻辑以及那些容易踩坑的细节掰开揉碎了讲清楚。目标很简单让你看完之后不仅能独立写出稳定可靠的输入捕获代码更能理解每一个配置项背后的“为什么”下次在赛场上或者项目里遇到类似需求能心中有数手到擒来。2. 输入捕获功能的核心原理与设计思路在开始写代码之前我们必须先搞明白输入捕获到底在干什么。你可以把它想象成一个非常专注的“计时员”和“记录员”。2.1 定时器如何扮演“计时员”定时器的核心是一个计数器通常我们称之为CNTCounter Register。当你使能定时器后这个CNT就会根据你设定的时钟源比如内部系统时钟的几分频不断地向上或向下计数。每来一个时钟脉冲CNT就加1或减1。这个计数过程是连续、自主运行的为我们测量时间间隔提供了基准尺子。输入捕获功能要做的就是在这把尺子正在“走动”的时候在特定的瞬间拍下照片记录下此刻CNT的数值。2.2 “记录员”CCR寄存器的关键作用定时器通常有多个通道Channel每个通道都配备了一个专门的“记录员”——捕获/比较寄存器CCRCapture/Compare Register。当输入捕获功能被启用并且你指定的引脚上发生了你所期待的“事件”比如一个上升沿时硬件会自动做两件极其重要的事瞬间冻结将当前定时器计数器CNT的数值立即、原子性地复制到该通道对应的CCR寄存器中。这个操作由硬件完成速度极快不受软件中断延迟的影响保证了时间戳的精确性。发出通知同时硬件会置位一个标志位比如CCxIF Capture/Compare Interrupt Flag如果中断使能了就会触发一个捕获中断通知CPU“喂你要的边沿我抓到啦时间戳已经存到CCR里了快来处理”2.3 测量脉宽与频率的基本策略理解了“计时”和“记录”测量思路就清晰了测量高电平脉宽我们可以设置通道在上升沿和下降沿都触发捕获。第一个上升沿到来CCR1记录下时间T1并触发中断。在中断服务程序里我们清除标志并将捕获边沿改为下降沿。下降沿到来CCR1记录下时间T2再次触发中断。在中断里高电平脉宽 (T2 - T1) * 计数器计数周期。计算完成后再将捕获边沿改回上升沿等待下一个周期。测量信号频率有两种常见方法。测周法测量一个完整周期的时间。方法与测脉宽类似捕获连续两个上升沿的时间T1和T2周期 (T2 - T1) * 计数周期频率 1 / 周期。这种方法在低频时精度高。测频法利用定时器作为时基开启另一个定时器或主定时器的另一个通道产生一个精确的1秒闸门信号。在闸门时间内对输入信号的边沿进行计数。1秒内的脉冲数就是频率。这种方法适合高频信号。注意这里有一个至关重要的细节——计数器溢出。如果信号脉宽或周期很长可能T2到来时计数器CNT已经从最大值如65535溢出归零并重新计数了。此时简单的T2-T1会得到一个负数或错误值。因此在中断服务程序中我们必须同时检查并处理计数器的溢出更新事件Update Event通过一个溢出次数的变量来扩展计数值的有效范围。这是输入捕获稳定性的关键后文会详细展开。3. 基于STM32CubeMX与HAL库的配置实战理论通了我们上手配置。以STM32G431蓝桥杯嵌入式竞赛板常用芯片为例使用STM32CubeMX工具可以极大简化初始化过程但我们必须清楚它背后做了什么。3.1 时钟树与定时器时钟源配置精确计时的前提是稳定的时钟。在CubeMX的“Clock Configuration”标签页配置好系统时钟SYSCLK比如到170MHz。找到你要用的定时器例如TIM2。它的时钟源通常来自APB总线。确保APB定时器时钟APB Timer Clocks已被正确使能且频率符合预期。例如如果APB1预分频器不是1定时器时钟可能会是APB1时钟的2倍这点CubeMX会显示清楚但心里要有数。为什么关心这个定时器CNT的计数频率 定时器时钟源 / (PSC 1)。这个频率决定了你的时间测量分辨率。例如定时器时钟为170MHz预分频器PSC设为16999则计数频率为170MHz / 17000 10kHz即每计数一次代表0.1ms。分辨率与量程需要权衡PSC越小分辨率越高每次计数时间短但计数器溢出越快PSC越大量程越长但分辨率越低。3.2 定时器基本参数与输入捕获通道配置在“Pinout Configuration”标签页找到TIM2。基本参数Parameter Settings:Prescaler (PSC): 根据上述分析设置。例如设为16999得到10kHz计数频率。Counter Mode: 选择“Up”向上计数。Counter Period (ARR): 这是计数器的自动重装载值即CNT从0数到多少后溢出归零。设为最大值65535对于16位定时器以获得最大单次计数范围。也可以设小一点来获得固定周期的定时中断但用于输入捕获时通常设为最大以延迟溢出。auto-reload preload: 使能Enable。这可以确保只在更新事件发生时才将新值载入ARR防止在修改ARR时产生意外的中间状态。输入捕获通道配置:在TIM2的通道选择中例如Channel1选择“Input Capture direct mode”。ICPolarity: 选择初始捕获边沿如“Rising Edge”上升沿。ICSelection: 选择“Direct”表示信号直接连接到该通道。ICPrescaler: 捕获分频器。选择“No division”每个有效边沿都捕获。如果信号有毛刺可以考虑分频但比赛和一般应用通常不用。ICFilter: 输入滤波器。这是防抖和抗干扰的关键设置一个合适的值如0x8表示8个时钟周期滤波。它的原理是只有连续采样到N个相同的电平才认为电平有效变化。这能滤除高频噪声毛刺但对信号本身的边沿速度有要求信号频率不能太高。3.3 NVIC中断与代码生成开启中断在NVIC Settings中使能TIM2的全局中断Global interrupt和捕获/比较中断Capture/Compare interrupt。生成代码点击“Generate Code”CubeMX会为你生成初始化代码MX_TIM2_Init()。生成的代码分析// 在 stm32g4xx_hal_msp.c 中HAL_TIM_IC_MspInit 会被调用 void HAL_TIM_IC_MspInit(TIM_HandleTypeDef* htim_ic) { GPIO_InitTypeDef GPIO_InitStruct {0}; if(htim_ic-InstanceTIM2) { __HAL_RCC_TIM2_CLK_ENABLE(); __HAL_RCC_GPIOA_CLK_ENABLE(); /**TIM2 GPIO Configuration PA5 ------ TIM2_CH1 */ GPIO_InitStruct.Pin GPIO_PIN_5; GPIO_InitStruct.Mode GPIO_MODE_AF_PP; // 复用推挽输出 GPIO_InitStruct.Pull GPIO_NOPULL; // 外部信号驱动通常不启用上下拉 GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; GPIO_InitStruct.Alternate GPIO_AF1_TIM2; HAL_GPIO_Init(GPIOA, GPIO_InitStruct); HAL_NVIC_SetPriority(TIM2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(TIM2_IRQn); } }注意这里GPIO模式是GPIO_MODE_AF_PP复用推挽输出对于输入捕获这通常是错误的输入引脚应该配置为输入模式。这是一个CubeMX的已知小问题有时会发生。正确的配置应该是GPIO_MODE_INPUT或GPIO_MODE_AF_INPUT。你需要手动检查并更正GPIO_InitStruct.Mode为GPIO_MODE_INPUT或者根据数据手册选择正确的复用输入模式。4. 核心代码实现与状态机设计CubeMX生成了骨架血肉还得我们自己填。一个健壮的输入捕获程序离不开清晰的中断服务程序逻辑和状态管理。4.1 变量定义与状态枚举首先我们定义一些全局变量来记录状态和数据。// 输入捕获状态机 typedef enum { CAPTURE_IDLE 0, // 空闲等待第一个上升沿 CAPTURE_RISING, // 已捕获上升沿等待下降沿 CAPTURE_FALLING // 已捕获下降沿等待下一个上升沿完成一个脉宽测量 } CaptureState_t; volatile CaptureState_t g_capture_state CAPTURE_IDLE; volatile uint32_t g_capture_rising_val 0; // 上升沿时间戳 volatile uint32_t g_capture_falling_val 0; // 下降沿时间戳 volatile uint32_t g_pulse_width_ticks 0; // 计算出的脉宽滴答数 volatile uint32_t g_timer_overflow_count 0; // 定时器溢出次数使用volatile关键字至关重要因为这些变量会在中断服务程序中被修改编译器不应做优化。4.2 定时器溢出中断的处理溢出处理是保证长脉宽测量正确的基石。我们需要在定时器的更新中断Update Interrupt中计数。// 在 main.c 或专门的定时器中断文件里 void TIM2_IRQHandler(void) { HAL_TIM_IRQHandler(htim2); // 调用HAL库中断处理函数 } // HAL库的回调函数 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2) { g_timer_overflow_count; // 溢出次数加1 } }4.3 输入捕获中断服务程序与状态机这是最核心的部分。我们使用状态机来管理测量流程。void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { uint32_t current_capture; if (htim-Instance TIM2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { current_capture HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 读取CCR1 switch (g_capture_state) { case CAPTURE_IDLE: { // 第一次捕获到上升沿 g_capture_rising_val current_capture; g_timer_overflow_count 0; // 重置溢出计数 // 改变捕获极性为下降沿 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); g_capture_state CAPTURE_RISING; } break; case CAPTURE_RISING: { // 捕获到下降沿 g_capture_falling_val current_capture; // 计算脉宽考虑溢出 if (g_capture_falling_val g_capture_rising_val) { // 没有发生溢出或溢出发生在下降沿之后但被我们计数了 g_pulse_width_ticks (g_capture_falling_val - g_capture_rising_val) (g_timer_overflow_count * (htim-Instance-ARR 1)); } else { // 下降沿时计数器已溢出归零并重新计数 // 需要计算从上升沿到ARR再从0到下降沿的计数 g_pulse_width_ticks ((htim-Instance-ARR 1) - g_capture_rising_val) g_capture_falling_val (g_timer_overflow_count * (htim-Instance-ARR 1)); } // 改变捕获极性为上升沿准备下一次测量 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); g_capture_state CAPTURE_FALLING; // 或者 CAPTURE_IDLE取决于你是否想立即开始下一次 // 这里可以设置一个标志通知主循环脉宽数据已就绪 g_capture_complete_flag 1; } break; case CAPTURE_FALLING: { // 如果需要连续测量可以在这里处理下一个上升沿并重置状态到IDLE // 本例中我们在下降沿处理中已经完成了计算并准备下一轮所以这个状态可能用不到 // 或者可以用来做周期测量捕获连续两个上升沿 } break; } } }4.4 主函数中的初始化与启动最后在main()函数中启动一切。int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_TIM2_Init(); // CubeMX生成的初始化 // 手动修正GPIO模式如果需要 // 启动定时器基础计数不启动捕获 HAL_TIM_Base_Start_IT(htim2); // 启动定时器并开启更新中断 // 启动输入捕获并开启捕获中断 HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1); // 状态机初始状态 g_capture_state CAPTURE_IDLE; while (1) { if (g_capture_complete_flag) { g_capture_complete_flag 0; // 将 tick 数转换为时间微秒 // 假设 PSC16999, 时钟170MHz, 计数频率10kHz, 1 tick 0.1ms 100us uint32_t pulse_width_us g_pulse_width_ticks * 100; // 计算脉宽微秒 // 可以在这里通过串口打印、显示到LCD等 printf(Pulse Width: %lu us\r\n, pulse_width_us); } // 其他主循环任务 } }5. 调试技巧、常见问题与性能优化代码写完了能不能一次跑通往往取决于对细节的把握和调试手段。5.1 调试技巧逻辑分析仪与调试器软件仿真如果条件有限可以先用Keil或STM32CubeIDE的软件逻辑分析仪功能。将GPIO引脚和CCR寄存器值添加到Watch窗口模拟输入信号观察中断触发和变量变化。硬件调试GPIO翻转法在中断服务函数的入口和出口用HAL_GPIO_TogglePin()翻转一个空闲的GPIO引脚然后用示波器观察这个引脚。你可以看到中断的触发频率和持续时间判断中断是否正常进入、是否有丢失。变量实时查看在调试模式下将g_capture_rising_val、g_capture_falling_val、g_timer_overflow_count等变量添加到Live Watch实时监视窗口可以连续观察其变化。信号源使用函数信号发生器产生已知频率和占空比的方波作为被测信号。这是验证程序准确性的黄金标准。5.2 常见问题排查表现象可能原因排查步骤与解决方案完全无法进入捕获中断1. 定时器时钟未使能。2. GPIO模式配置错误应为输入。3. NVIC中断未使能或优先级配置有冲突。4. 输入信号电压不匹配需3.3V电平。1. 检查__HAL_RCC_TIMx_CLK_ENABLE()是否调用。2. 检查GPIO初始化代码Mode应为GPIO_MODE_INPUT或正确的AF_INPUT。3. 在CubeMX和代码中双重确认NVIC设置。4. 用万用表或示波器测量输入引脚电压。能进中断但测量值完全不对/跳动大1. 未处理计数器溢出。2. 输入信号有毛刺滤波器设置不当。3. 中断服务函数执行时间过长丢失边沿。4. 预分频器PSC或时钟源计算错误。1. 确保实现了溢出计数g_timer_overflow_count并在计算中使用。2. 增大ICFilter值如0xF或在硬件上对信号进行RC滤波。3. 优化中断服务函数只做最必要的操作记录时间、切换极性、设标志复杂计算放到主循环。4. 重新核对系统时钟和定时器时钟分频计算。测量值有固定偏差1. 中断响应延迟引入误差。2. 读取CCR值的时机问题。1. 对于极高频率信号中断延迟误差不可忽略。考虑使用DMA传输捕获值或使用定时器的“PWM输入模式”该模式能硬件自动完成周期和占空比测量。2. 确保在中断回调中第一时间读取CCR值。只能测量一次后续不触发1. 在中断中没有清除捕获标志位。2. 状态机逻辑错误未能正确切回初始状态。1. HAL库通常在HAL_TIM_IRQHandler中自动清除标志但需确认。可以手动检查__HAL_TIM_GET_FLAG()和__HAL_TIM_CLEAR_FLAG()。2. 单步调试状态机检查每个case分支是否按预期执行和跳转。5.3 高级优化与扩展思路使用DMA减轻CPU负担对于需要连续高速捕获大量数据的场景如音频采样可以配置定时器在捕获事件时自动将CCR值通过DMA传输到指定的内存数组。CPU只需在DMA传输完成一半或全部时处理数据块极大减少中断频率。PWM输入模式这是STM32定时器的一个特殊功能。它将两个通道通常TI1和TI2关联起来一个用于触发一个用于捕获硬件自动测量周期和占空比只需要一次读取操作非常高效准确。在CubeMX中可以直接选择“PWM Input Mode”。多通道同步捕获如果需要同时捕获多个相关信号的边沿例如三相电机的霍尔传感器可以使用定时器的从模式Slave Mode和触发源Trigger Source功能让一个通道的事件去复位或启动其他通道的计数器实现硬件级同步。提高测量上限与精度对于极低频率信号16位计数器即使分频也容易溢出。可以结合定时器的更新中断用软件扩展一个32位甚至64位的全局计数器。对于高精度需求在时钟源允许的情况下尽量减小PSC值以提高分辨率同时处理好溢出。6. 在蓝桥杯竞赛中的应用与备赛建议在蓝桥杯嵌入式赛场上输入捕获绝不会单独出现它总是作为子系统服务于一个更大的功能。典型赛题结合场景测量按键按下时长实现“短按”、“长按”、“超长按”的多功能按键。将按键GPIO连接到定时器输入捕获通道测量低电平按下持续时间。注意结合软件消抖滤波器或延时判断。旋转编码器测速编码器的A、B相信号可以接到两个定时器通道配置为双边沿捕获。通过判断两个通道捕获顺序和间隔不仅能得到转速频率还能辨别方向。这里状态机设计会更复杂一些。红外遥控解码NEC等红外协议由不同脉宽的引导码、数据0、数据1组成。使用输入捕获精确测量每个高/低电平的脉宽再根据协议规则解析出地址码、命令码。超声波测距超声波模块的Echo回波引脚是一个高电平脉冲其宽度与距离成正比。用输入捕获测量这个高电平脉宽再根据声速公式计算距离。这是非常经典的赛题。备赛实操建议模块化编程将输入捕获的初始化、启动、中断处理、数据读取封装成一个独立的.c/.h文件模块。比如icapture.c和icapture.h。提供清晰的接口函数如ICAP_Init()ICAP_GetPulseWidthUs()。这样在赛题中需要用到时可以直接移植快速集成。准备常用配置函数针对测脉宽、测频率测周法、PWM输入模式分别写好经过验证的配置函数和中断模板。比赛时根据题目要求稍作修改即可。进行边界测试用信号发生器测试你的代码输入极低频率如1Hz和较高频率接近定时器计数频率极限的信号看测量是否依然准确稳定。特别是测试脉宽接近或超过计数器全量程的情况。理解HAL库与寄存器虽然HAL库方便但比赛时间紧张有时直接操作寄存器效率更高。至少要理解关键寄存器TIMx_CR1, TIMx_CCMR1, TIMx_CCER, TIMx_DIER, TIMx_SR各位的含义。在初始化完成后如果需要快速切换捕获边沿直接写TIMx-CCER寄存器比调用HAL库函数更快。最后嵌入式开发尤其是竞赛七分在理解三分在调试。把输入捕获的原理、配置、中断处理和溢出补偿这个闭环真正吃透你在现场调试传感器、编码器这类需要精确计时的外设时就会从容很多。遇到问题按照“信号有没有进来查GPIO-中断有没有触发查NVIC和标志位-数据对不对查计算和溢出”这个顺序排查大部分问题都能快速定位。