STM32CubeMX实战：5分钟搞定定时器输入捕获测频率（附完整代码）-育师

STM32CubeMX实战：5分钟搞定定时器输入捕获测频率（附完整代码）

最近在做一个智能小车的项目，需要实时监测电机编码器的输出频率来计算转速。一开始我琢磨着用外部中断加软件计数，结果发现高频信号下CPU直接被中断打满，主程序都跑不动了。后来转向STM32的硬件定时器输入捕获功能，才发现这才是“专业的事交给专业的硬件”的典范。但翻看手册，一堆寄存器配置让人头大，直到用上STM32CubeMX这个图形化神器，整个过程变得异常清晰。今天我就把自己从踩坑到顺畅使用的完整流程梳理出来，尤其针对频率测量这个刚需场景，让你也能在5分钟内搭建起一个稳定可靠的测量框架。

这篇文章面向的是已经熟悉STM32基本开发环境（如Keil或STM32CubeIDE），但对硬件定时器高级功能感到陌生的朋友。无论是做无人机飞控、逆变器电源，还是简单的传感器信号采集，只要涉及到对数字脉冲信号的周期或频率进行测量，输入捕获都是你必须掌握的技能。我会完全基于STM32CubeMX进行配置，并提供可直接粘贴使用的完整代码，重点解释几个关键参数背后的物理意义和配置误区，确保你不仅“配得出来”，更能“懂得为什么”。

1. 理解核心：硬件定时器如何“捕获”一个脉冲

很多教程一上来就讲操作步骤，但如果不明白定时器在底层做了什么，一旦信号异常或者需求变化，调试起来就会非常被动。STM32的通用定时器（如TIM2, TIM3, TIM4等）内部有一个时基单元，它就像一个精准的秒表，在不停地自主运行。

这个“秒表”的计数频率由内部时钟经过预分频器决定。例如，系统主频是72MHz，预分频系数设为71，那么计数器的计数频率就是72MHz / (71+1) = 1MHz，即每微秒计数一次。计数器从0开始累加，到达自动重装载值后归零，重新开始，如此循环。

输入捕获单元的妙处在于，它在这个“秒表”旁边安了一个触发器。当指定的外部引脚（比如TIM2的通道1对应的PA0引脚）上发生你预设的边沿事件（比如上升沿）时，触发器会瞬间“咔嚓”一下，把当前“秒表”的数值（即计数器的值）复制到一个专用的捕获/比较寄存器里锁存起来，并且可以产生一个中断通知CPU。

注意：这个“复制-锁存”的动作是由硬件同步完成的，速度极快，精度只取决于计数器的时钟频率，与软件中断的响应延迟无关。这是实现高精度测量的基础。

测量频率的本质，就是测量信号的周期。我们只需要连续捕获两个相邻的上升沿（或下降沿）对应的计数器值，它们的差值乘以计数器的计数周期，就是一个信号周期的准确时间。

关键参数关系速查表：

参数	含义	计算公式	影响
定时器时钟 (TIM_CLK)	定时器模块的输入时钟频率	由系统时钟分频得到	决定了计数器的最大计数频率
预分频系数 (PSC)	对TIM_CLK进行分频	实际写入PSC寄存器的值	设定计数器的计数频率：`CNT_CLK = TIM_CLK / (PSC + 1)`
自动重装载值 (ARR)	计数器的计数上限	实际写入ARR寄存器的值	决定了计数器的计数范围和溢出周期
捕获值 (CCRx)	边沿触发时锁存的计数器值	硬件自动写入	两次捕获值之差`(CCRx2 - CCRx1)`即为间隔计数值
最终周期/频率	待测信号的物理时间/频率	`周期 = (计数值差值) * (1 / CNT_CLK)` `频率 = 1 / 周期`	测量的直接结果

假设我们配置CNT_CLK = 1MHz，捕获到两个上升沿的CCR值差为5000，那么信号周期就是5000 * (1/1,000,000) = 0.005秒，频率即为200Hz。如果差值超过了ARR值，说明在两次捕获之间计数器发生了溢出，我们需要在中断服务程序中记录溢出次数，将这部分时间补偿进去。

2. CubeMX工程配置：图形化点选的艺术

打开STM32CubeMX，创建一个新工程，选择你的芯片型号。我们以最常用的STM32F103C8T6和定时器TIM2的通道1（对应PA0引脚）为例。

2.1 时钟树配置：为定时器提供动力源

在Clock Configuration标签页，确保系统时钟（HCLK）被正确配置到最高性能（例如72MHz）。找到定时器2的时钟源（APB1 Timer Clocks），它会由APB1总线时钟提供。如果APB1预分频系数不为1，定时器时钟会自动倍频。对于F1系列，当APB1分频为2时，定时器时钟是APB1时钟的2倍。这里我们简单起见，将APB1预分频设为1，使其时钟也为72MHz。这样，TIM2的时钟源TIM_CLK就是72MHz。

2.2 定时器模式与参数配置：设定“秒表”规格

转到Pinout & Configuration标签页，在左侧分类中找到Timers->TIM2。

时钟源：保持为Internal Clock。
通道功能：点击Channel 1，在下拉菜单中选择Input Capture direct mode。此时，右侧的引脚图中PA0会自动被标记为TIM2_CH1。
参数配置：切换到Parameter Settings子标签。
- 预分频器 (Prescaler)：这是我们调节“秒表”精度的关键。输入71。根据公式，计数频率CNT_CLK = 72MHz / (71+1) = 1MHz。这意味着计数器每1微秒加1。
- 计数模式 (Counter Mode)：选择Up（向上计数）。
- 自动重装载值 (Counter Period)：输入65535（即0xFFFF，16位定时器的最大值）。这个值决定了计数器在溢出前能计多少个数。对于频率测量，只要信号周期对应的计数值不超过ARR，我们就不需要处理溢出。设置成最大值可以测量更低的频率。
- 触发输出 (Trigger Output)：保持Disabled。
- 输入捕获配置：下方会出现Input Capture Channel 1的配置栏。
  - 极性 (Polarity)：选择Rising Edge（上升沿）。即我们希望在PA0引脚出现上升沿时触发捕获。
  - 选择输入 (IC Selection)：保持Direct。表示通道1直接映射到TI1输入。
  - 分频器 (IC Prescaler)：选择No division。每个边沿都捕获。
  - 滤波器 (IC Filter)：默认为0。对于干净的数字信号可以保持为0。如果信号有毛刺，可以适当增加滤波值，硬件会以采样频率对输入进行数字滤波。

2.3 开启中断：让CPU知道“抓到了”

配置好定时器后，必须开启中断，否则捕获发生后我们无法知晓。在NVIC Settings子标签页，找到TIM2 global interrupt，勾选Enabled。优先级可以暂时保持默认。

2.4 生成代码：框架一键生成

在Project Manager标签页设置好你的工程名、路径、IDE（如MDK-ARM V5）后，点击右上角的GENERATE CODE。CubeMX会生成完整的初始化代码，包括GPIO、定时器、NVIC等所有配置。

3. 代码编写：中断服务程序与主程序逻辑

CubeMX生成了框架，但实现频率测量的核心逻辑需要我们自己在指定的用户代码区添加。整个逻辑围绕中断服务函数展开。

3.1 定义全局变量与状态机

在main.c文件开头附近的/* USER CODE BEGIN PV */区域，定义我们需要的变量。

/* USER CODE BEGIN PV */ // 用于频率测量的全局变量 volatile uint32_t g_capture_first_value = 0; // 第一次捕获的值 volatile uint32_t g_capture_second_value = 0; // 第二次捕获的值 volatile uint8_t g_capture_flag = 0; // 捕获完成标志，0:等待第一次捕获，1:已捕获第一次等待第二次，2:两次捕获完成 volatile float g_signal_frequency_hz = 0.0; // 计算得到的频率值 /* USER CODE END PV */

这里使用volatile关键字至关重要，因为它告诉编译器这些变量可能被中断服务程序意外修改，禁止对其进行优化，确保每次访问都从内存中读取最新值。

3.2 重写输入捕获中断回调函数

HAL库采用回调函数机制。当输入捕获事件发生时，会自动调用HAL_TIM_IC_CaptureCallback函数。我们需要在main.c中重写它。可以在/* USER CODE BEGIN 4 */区域添加。

/* USER CODE BEGIN 4 */ /** * @brief 输入捕获中断回调函数 * @param htim: 定时器句柄指针 * @retval None */ void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { // 判断是否是TIM2的通道1发生了捕获事件 if (htim->Instance == TIM2 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { switch(g_capture_flag) { case 0: // 等待第一个上升沿 // 读取第一次捕获值 g_capture_first_value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_flag = 1; // 更新状态，等待下一个上升沿 // 注意：这里不需要清除捕获标志，HAL库在调用此回调前已处理 break; case 1: // 已捕获第一个上升沿，等待第二个上升沿 // 读取第二次捕获值 g_capture_second_value = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_flag = 2; // 标记两次捕获完成，主循环可以计算频率了 break; default: break; } } } /* USER CODE END 4 */

这个函数构成了一个简单的两状态状态机。第一次进入时记录时间点T1，第二次进入时记录时间点T2。T2 - T1就是计数器走过的计数值，对应一个信号周期。

3.3 主函数初始化与主循环逻辑

在main函数中，我们需要启动定时器的输入捕获中断，并在主循环中检查标志位并计算频率。

在/* USER CODE BEGIN 2 */区域启动定时器：

/* USER CODE BEGIN 2 */ // 启动TIM2的通道1输入捕获功能，并开启中断 if (HAL_TIM_IC_Start_IT(&htim2, TIM_CHANNEL_1) != HAL_OK) { // 错误处理，可以点亮一个错误指示灯 Error_Handler(); } printf("TIM2 Input Capture Started.\r\n"); /* USER CODE END 2 */

在while(1)主循环中处理计算：

/* USER CODE BEGIN WHILE */ while (1) { // 检查是否完成了两次捕获 if (g_capture_flag == 2) { uint32_t capture_diff = 0; // 计算计数值差值，考虑计数器溢出（本例中ARR=65535，若两次捕获差值正常不会溢出） if (g_capture_second_value >= g_capture_first_value) { capture_diff = g_capture_second_value - g_capture_first_value; } else { // 发生了计数器溢出（ARR较小的情况），差值需要加上ARR最大值 capture_diff = (0xFFFF - g_capture_first_value) + g_capture_second_value + 1; } // 计算实际频率 // 计数器时钟CNT_CLK = 1MHz， 周期 = 计数值 * (1/CNT_CLK) 秒 // 频率 = 1 / 周期 = CNT_CLK / 计数值 if (capture_diff > 0) // 避免除零错误 { g_signal_frequency_hz = 1000000.0 / (float)capture_diff; // CNT_CLK=1,000,000 Hz printf("Capture Diff: %lu, Frequency: %.2f Hz\r\n", capture_diff, g_signal_frequency_hz); } // 重置标志，准备进行下一次测量 g_capture_flag = 0; g_capture_first_value = 0; g_capture_second_value = 0; } // 这里可以添加其他任务，例如LED闪烁指示系统运行 HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(100); /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */

提示：printf函数需要你已配置并初始化了串口（如USART1）。如果未配置，可以暂时用点灯的方式指示测量完成，或者通过调试器查看变量值。

4. 进阶优化与常见问题排查

上面的代码已经能工作了，但在实际项目中，我们还需要考虑更多细节。

4.1 处理高频信号与计数器溢出

当信号频率很高时，两个上升沿之间的计数值capture_diff可能很小，测量精度会下降。此时应该减小预分频系数PSC，提高CNT_CLK。例如，设置PSC=0，则CNT_CLK=72MHz，分辨率可达~13.9纳秒。

反之，测量低频信号时，capture_diff可能超过ARR（65535），导致计数器在两次捕获间发生溢出。我们的简单状态机没有记录溢出次数，会导致计算错误。改进方法是开启定时器的更新（溢出）中断，并在其中维护一个溢出计数器。

改进步骤：

在CubeMX中，TIM2的NVIC Settings里再勾选TIM2 update interrupt。
在/* USER CODE BEGIN PV */定义volatile uint16_t g_tim2_overflow_cnt = 0;。

重写更新中断回调函数：

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { g_tim2_overflow_cnt++; } }

在HAL_TIM_IC_CaptureCallback中，当g_capture_flag为0时，重置g_tim2_overflow_cnt = 0;。
在主循环计算时，频率公式变为：频率 = CNT_CLK / (capture_diff + g_tim2_overflow_cnt * (ARR + 1))。

4.2 滤波与噪声处理

如果你的信号线较长或环境噪声大，可能会捕获到错误的边沿。CubeMX中的输入滤波器就是为此而生。它基于内部采样时钟对输入信号进行数字滤波，只有连续N次采样电平一致，才认为电平有效。例如，设置IC Filter为0x6，表示需要连续6个事件（采样）一致才通过。这能有效滤除窄毛刺，但也会引入微小的延迟。对于大多数数字信号，设置为0x3或0x4是一个不错的起点。

4.3 测量脉宽与占空比

输入捕获同样可以测量脉冲宽度（高电平时间）。思路是：先设置为上升沿捕获，捕获后立即将极性切换为下降沿捕获，并记录下降沿的时刻。两次时刻之差即为高电平时间。结合之前测量的周期，就能算出占空比。这需要在中断回调函数里动态改变捕获极性，可以使用__HAL_TIM_SET_CAPTUREPOLARITY()宏来实现。

// 在回调函数中示例 if (当前是上升沿捕获) { // 记录上升沿时间 // 切换为下降沿捕获 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); } else if (当前是下降沿捕获) { // 记录下降沿时间，计算高电平宽度 // 切换回上升沿捕获，准备下一个周期 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); }

4.4 性能考量与替代方案

对于极高频率的信号（接近CNT_CLK的一半），输入捕获可能力不从心。此时可以考虑使用定时器的编码器接口模式，专门用于正交编码器计数，或者使用外部高速计数器芯片。另外，如果同时需要测量多个通道的频率，要评估中断频率对系统整体性能的影响。有时，使用DMA将捕获值直接搬运到内存，再由主程序批量处理，是更高效的方式。

我在第一次用这个功能测量电机转速时，没注意信号线上的上拉电阻，导致输入引脚悬空时受到干扰，测出的频率乱跳。后来加上一个10k的上拉电阻到3.3V，问题立刻消失。所以，硬件上的一个小细节，往往比调试半天代码更有用。