在嵌入式开发里“测量一个信号的频率”看起来是个入门级需求但真正动手做的时候很多人才发现事情没那么简单用 GPIO 中断读引脚翻转高频信号一来 CPU 就被中断打爆用阻塞延时数脉冲主程序什么都干不了即使选用了定时器输入捕获也容易在极性配置、溢出处理、误差计算上栽跟头。这篇文章的主角是 STM32C5A3R 这颗芯片主题就是围绕它的定时器输入捕获功能讲清楚如何配置并实现频率测量。相比外部中断方案定时器输入捕获的核心优势在于硬件级的时间戳记录不占用 CPU 指令周期特别适合测量 PWM 信号频率、占空比、脉冲间隔等场景。读完这篇文章你能得到三条明确结论第一输入捕获的底层原理是什么为什么它比 GPIO 中断更适合测频第二用 STM32CubeMX 加 HAL 库如何一步步配置定时器第三测频法、测周法、多周期平均法分别适合什么场景误差从哪里来怎么把误差压下去。如果你正在做电机转速检测、气象风速仪、红外遥控解码、流量计脉冲计数或者任何需要测量外部方波信号频率的项目这篇文章值得收藏备用。1. 这篇文章真正要解决的问题先说清楚一个容易被忽视的事实测频率不是“数脉冲”这么简单。你当然可以写一个while循环用 GPIO 不断读取引脚电平检测到上升沿就给计数器加一然后每秒输出一次计数值。这种做法在信号频率很低、CPU 没有其他任务的时候勉强能用。但一旦频率上升到几十 kHz或者系统同时要处理显示、通信、控制算法问题就会集中爆发CPU 被频繁中断淹没主循环调度出现明显卡顿引脚抖动、毛刺信号导致误计数计数的起止时刻没有硬件对齐测量结果跳变严重无法同时获得频率和占空比信息。定时器输入捕获要解决的问题正是把“记录边沿到来时刻”这件事从 CPU 手里接管过来。定时器硬件会在输入引脚检测到指定边沿的瞬间把当前计数器的值锁存到捕获寄存器里并触发一次中断或 DMA 请求。CPU 只需要在中断里读取两次捕获值做一个减法就能得到信号的周期进而换算成频率。这里真正的关键点是CPU 只需要处理“事件发生之后”的数学计算不需要参与“事件发生瞬间”的响应。即便系统正在执行其他高优先级任务定时器依然会忠实地记录下每一个边沿的时间戳。这就是硬件定时器方案比 GPIO 中断方案稳定得多的根本原因。所以这篇文章要解决的核心问题包括问题说明输入捕获怎么配置定时器时钟、通道极性、预分频、自动重载值的设置逻辑频率公式怎么推导捕获值差值与信号周期之间的关系误差怎么控制预分频、计数频率、溢出处理的取舍不同频率段怎么选方案低频用什么方法高频用什么方法调试不好使怎么办引脚没波形、捕获值不动、频率跳变等典型问题的排查路径2. 定时器输入捕获的核心概念与适用场景2.1 输入捕获是什么输入捕获Input Capture是定时器的一种工作模式。定时器内部有一个自由运行的计数器它会按照设定的时钟频率不断累加。当输入引脚上出现目标边沿时定时器硬件会把当前计数器的值“快照”到捕获寄存器中。用过示波器的读者可以这样理解示波器在触发信号满足条件时会记录下当前波形的位置。定时器输入捕获做的事情类似只不过它记录的不是模拟波形而是计数器的数值。以测量一个方波信号的周期为例配置定时器输入捕获通道检测上升沿第一次捕获到上升沿时计数器值被存入捕获寄存器第二次捕获到上升沿时计数器值再次被存入捕获寄存器两次捕获值之差就是一个完整周期内计数器走过的步数周期 计数器步数 × 计数器时钟周期频率 1 / 周期。用公式表达就是Freq TimerClock / (CaptureValue_N - CaptureValue_N-1)如果定时器时钟是 1 MHz两次捕获值相差 1000那么信号周期就是 1000 微秒频率就是 1 kHz。2.2 三个易混淆的概念测频法、测周法、多周期平均很多新手看到“输入捕获”就直接开干结果发现不同频率范围测出来的结果千差万别。这里要先建立方法论测频法在固定时间窗口内例如 1 秒统计输入引脚上的脉冲个数。脉冲个数除以时间就是频率。适用于频率较高的信号因为窗口内脉冲数越多量化误差占比越小。测周法通过输入捕获测量单个周期的时间长度再取倒数得到频率。适用于频率较低的信号因为低频信号周期本来就长计时本身就足够精确。多周期平均法连续捕获 N 个上升沿用“总时间 / N”得到平均周期。这种方法兼顾了高频和低频场景通过增加采样周期数来平滑抖动误差是工程实践中最推荐的做法。三者的关系可以用一个例子说明要测量一个 50 Hz 的交流信号频率。如果测频法开 1 秒窗口只能数到约 50 个脉冲误差 1 个脉冲就带来 2% 的偏差如果用测周法直接测周期计时器频率够高时精度远优于测频法。反过来要测量 10 MHz 的信号用测周法测单周期计数器一个周期可能就走几十个步数误差极大此时测频法更合适。2.3 适用场景输入捕获适合测量以下类型的信号PWM 方波信号的频率和占空比编码器输出的脉冲频率红外遥控接收头解调后的脉冲宽度流量计、水表、电表的脉冲输出电机转速传感器输出的频率信号超声波测距模块的回波脉冲宽度。不适合用输入捕获的场景包括需要连续记录大量波形细节应该用 ADC 或逻辑分析仪信号频率超过定时器计数能力此时应使用外部硬件分频器或专用频率计边沿抖动严重、需要软件滤波的场合仍可用输入捕获但必须配合输入滤波配置。3. 环境准备与前置条件3.1 硬件环境开发板基于 STM32C5A3R 芯片的开发板。STM32C5 系列是 ST 推出的新一代主流 MCUCortex-M33 内核外设资源丰富。本文描述的是定时器输入捕获通用配置思路同一套代码逻辑也适用于 STM32G4、STM32F3、STM32L4 等系列。信号源能输出可调频率方波信号的设备。如果没有信号发生器可以使用另一块开发板的 PWM 输出或者用单片机的 PWM 模块自产信号把 PWM 引脚通过杜邦线连接到输入捕获引脚。杜邦线若干。需要注意实际开发中不同芯片的定时器映射引脚不同请以芯片数据手册中的 AFIO 映射表为准。本文示例选择定时器的一个通道引脚读者替换为自己的板卡对应引脚即可。3.2 软件环境STM32CubeMX用于图形化配置时钟树、定时器和 GPIO。版本请以实际安装为准本文重点演示通用配置思路。STM32CubeIDE 或其他支持 HAL 库的编译环境。STM32C5 系列固件包HAL 库。版本请以实际项目为准本文演示的是 HAL 库通用 API。如果读者之前只用过标准外设库建议先熟悉两个基本概念HAL 库的句柄结构体每个外设都有一个xxx_HandleTypeDef类型的句柄例如定时器是TIM_HandleTypeDef。句柄中包含了外设实例、初始化参数、状态等所有信息。CubeMX 生成代码的目录结构CubeMX 会根据芯片型号生成main.c、tim.c、gpio.c等文件。用户初始化代码放在USER CODE BEGIN和USER CODE END注释块之间CubeMX 重新生成代码时不会覆盖这些区域。4. STM32CubeMX 配置步骤4.1 创建工程并选择芯片打开 STM32CubeMX点击 “New Project”在芯片搜索框中输入 STM32C5A3R 系列对应型号。选择后进入主界面。4.2 配置时钟树在System Core RCC中根据开发板实际使用的晶振类型选择 HSE 时钟源。如果不确定可以先选择内部时钟或使用默认配置。在Clock Configuration标签页中确认系统时钟主频符合实际芯片规格。时钟树配置直接影响定时器时钟频率后续计算分频系数时会用到建议这一部分单独截图保存方便回头核算。4.3 配置定时器为输入捕获模式这里以定时器的一个通道为例。操作路径为Timers TIMx Slave Mode保持 Disable 即可。在Mode一栏将Channelx设置为Input Capture mode。配置界面上有几个关键参数需要理解参数含义推荐值Prescaler预分频值实际分频系数为 Prescaler 1根据目标计数频率计算Counter Mode计数方向UpCounter Period自动重载值计数到该值后清零或溢出0xFFFF 或更大Internal Clock Division时钟分频一般用于定时器内部逻辑No DivisionAuto-Reload Preload自动重载预装载使更新事件同步生效EnablePolarity捕获极性上升沿或下降沿Rising EdgeIC Selection捕获通道选择单通道配置时保持默认即可Direct TIPrescaler (IC)输入捕获信号分频可配置 1/2/4/8 分频1即不分频Input Filter输入滤波可滤除毛刺按需配置需要特别注意的是Prescaler和Counter Period的关系。输入捕获测量的精度取决于计数频率计数频率越高捕获寄存器的值分辨率越好但计数器也更容易溢出。如果计数器溢出两次捕获值之差就会出现严重错误。因此实际项目中通常根据被测信号频率来调整定时器时钟分频确保计数器不会在信号周期内溢出。4.4 配置 NVIC 中断在NVIC Settings标签页中使能定时器的全局中断例如TIMx global interrupt。这是捕获回调函数能够被正常调用的前提。如果后续使用 DMA 方式捕获多个周期则需要配置对应的 DMA 请求并注意 DMA 通道的优先级设置。4.5 生成代码点击GENERATE CODE选择目标 IDESTM32CubeIDE 或其他生成工程。5. 完整示例代码实现5.1 简单单周期捕获测频这是最基础的输入捕获代码适用于频率不太高、对精度要求不高的场景。核心思路是维护一个捕获值缓冲区在捕获中断回调中完成频率计算。文件路径Core/Src/main.c在用户代码区添加变量/* USER CODE BEGIN PV */ volatile uint16_t g_capture_value 0; volatile uint16_t g_capture_period 0; volatile uint8_t g_capture_flag 0; /* USER CODE END PV */在main()函数中启动定时器输入捕获中断/* USER CODE BEGIN 2 */ HAL_TIM_IC_Start_IT(htimx, TIM_CHANNEL_x); /* USER CODE END 2 */其中htimx替换为实际定时器句柄例如htim2TIM_CHANNEL_x替换为实际使用的通道例如TIM_CHANNEL_1。在main.c文件末尾或单独文件中实现捕获回调函数/* USER CODE BEGIN 4 */ void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIMx) { if (g_capture_flag 0) { g_capture_value HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_x); g_capture_flag 1; } else if (g_capture_flag 1) { uint16_t current_value HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_x); if (current_value g_capture_value) { g_capture_period current_value - g_capture_value; } else { g_capture_period (0xFFFF - g_capture_value) current_value 1; } g_capture_flag 2; } } } /* USER CODE END 4 */这段代码的逻辑是第一次捕获到上升沿时保存捕获值第二次捕获到上升沿时计算两个值之差作为周期。如果第二次捕获值小于第一次说明计数器发生了溢出回绕需要按 16 位计数范围折算。主循环中轮询g_capture_flag 2时即可计算频率/* USER CODE BEGIN WHILE */ while (1) { if (g_capture_flag 2) { uint32_t timer_clock HAL_RCC_GetPCLK1Freq() * 2; // 注意定时器时钟来源 uint32_t prescaler 1; // 替换为实际配置的预分频值 1 uint32_t freq timer_clock / prescaler / g_capture_period; printf(Frequency: %lu Hz\r\n, freq); g_capture_flag 0; } } /* USER CODE END WHILE */这里需要注意定时器时钟频率未必等于HAL_RCC_GetPCLK1Freq()。如果定时器挂载在 APB1 或 APB2 上且系统时钟分频系数不为 1定时器时钟通常是对应 APB 时钟的 2 倍。更稳妥的做法是直接查看 CubeMX 时钟树中的Timerx Clock数值。5.2 多周期平均测频工程推荐单周期测量的缺点是抗干扰能力差只要某个边沿受噪声影响偏移一点结果就会跳变。工程上更推荐连续捕获 N 个上升沿用总时间计算平均周期。先在全局区定义/* USER CODE BEGIN PV */ #define CAPTURE_COUNT 10 volatile uint16_t g_capture_buffer[CAPTURE_COUNT]; volatile uint8_t g_capture_index 0; volatile uint8_t g_capture_done 0; /* USER CODE END PV */使用 DMA 方式采集多个周期需要先配置 DMA。CubeMX 中在定时器的 DMA Settings 中添加TIM_CHx对应的 DMA Request方向为 Peripheral To Memory数据宽度为 Half Word。代码中启动 DMA 捕获/* USER CODE BEGIN 2 */ HAL_TIM_IC_Start_DMA(htimx, TIM_CHANNEL_x, (uint32_t *)g_capture_buffer, CAPTURE_COUNT); /* USER CODE END 2 */注意HAL_TIM_IC_Start_DMA的缓冲区参数类型是uint32_t *即使实际数据宽度是 16 位函数签名也要求使用 32 位指针。这个细节在部分 HAL 库版本中容易引发类型告警但不影响运行。DMA 传输完成回调中标记测量完成void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIMx) { g_capture_done 1; } }主循环中处理数据if (g_capture_done) { uint32_t total_period 0; for (uint8_t i 1; i CAPTURE_COUNT; i) { if (g_capture_buffer[i] g_capture_buffer[i - 1]) { total_period g_capture_buffer[i] - g_capture_buffer[i - 1]; } else { total_period (0xFFFF - g_capture_buffer[i - 1]) g_capture_buffer[i] 1; } } uint32_t average_period total_period / (CAPTURE_COUNT - 1); // 然后根据定时器时钟计算频率 g_capture_done 0; }多周期平均法的好处是即使个别边沿存在抖动平均值也能把误差摊薄。实际使用时CAPTURE_COUNT可根据信号频率和响应速度调整。低频信号可以取小一点高频信号可以取大一点。5.3 双通道同时测量频率和占空比如果不仅要测频率还要测占空比可以用两个通道配合一个通道捕获上升沿另一个通道捕获下降沿。或者使用同一个通道的上升沿与下降沿交替捕获。这里仅提供思路核心逻辑是上升沿捕获值记为T1紧接着的下降沿捕获值记为T2下一个上升沿捕获值记为T3。周期 T3 - T1高电平时间 T2 - T1占空比 (T2 - T1) / (T3 - T1)。实现方式的差异在于需要在前一次捕获完成后动态切换捕获极性。HAL 库中可以通过__HAL_TIM_SET_CAPTUREPOLARITY宏实现。这个相对复杂后续可以单独展开本文将焦点放在频率测量上。6. 运行结果与效果验证6.1 验证步骤完成代码编写后编译下载到开发板。验证过程按以下步骤进行用信号发生器输出一个已知频率的方波例如 1 kHz、3.3 V 电平将信号输出引脚连接到开发板的定时器捕获引脚打开串口助手波特率与代码中 printf 重定向配置一致例如 115200观察串口输出的频率数值是否接近 1000 Hz改变信号发生器频率例如 10 kHz、100 kHz观察测量结果。如果没有信号发生器可以用另一块开发板输出 PWM。在另一块板上配置一个定时器输出固定频率 PWM连接两个板卡的引脚即可。6.2 预期结果正常情况下串口输出频率值应该围绕设定值有微小波动。波动范围取决于输入信号质量、定时器时钟精度和测量方法单周期测量在信号稳定时误差通常在 ±1 到 ±3 个计数步长多周期平均法可以有效降低随机抖动显示结果更稳定如果输入信号本身带毛刺需要开启定时器输入滤波功能或使用施密特触发器整形电路。6.3 如何判断代码是否正常工作最重要的判断依据不是串口输出数字看起来对不对而是捕获回调是否被正确触发。建议在调试初期在回调函数入口加一个 GPIO 翻转语句用示波器或逻辑分析仪观察翻转频率。如果翻转频率约为输入信号频率的一半说明捕获事件正常触发。如果串口输出始终为 0 或数值乱跳优先检查以下三个位置定时器是否真正启动了捕获HAL_TIM_IC_Start_IT是否被调用中断服务函数是否映射正确HAL 库的中断回调名字不能写错输入引脚是否配置为复用功能CubeMX 生成代码时通常会自动处理但手工改 GPIO 时会漏掉。7. 常见问题与排查思路问题现象可能原因排查方式解决方案捕获中断从不触发通道未启动或引脚映射错误检查 CubeMX 引脚配置和 GPIO 复用功能在回调中加 GPIO 翻转进行硬件验证确保调用HAL_TIM_IC_Start_IT核对 AFIO 映射表频率输出比实际值大很多预分频或定时器时钟计算错误打印定时器实际时钟频率核对 CubeMX 时钟树正确计算 PCLK 与定时器时钟的关系频率输出跳变严重信号有毛刺或计数器溢出用示波器观察输入波形打印捕获值原始数据开启输入滤波增大 Counter Period改用多周期平均法低频信号测不准计数器溢出导致回绕处理错误检查捕获值差值是否为负数或突变增大预分频处理 16 位回绕场景高频信号测不准计数频率不够用示波器对比实际波形频率提高定时器时钟频率改用测频法测量时主程序卡顿中断过于频繁检查输入信号频率是否过高或捕获中断处理太耗时改用 DMA 方式中断回调中只做标记主循环中计算使用 DMA 时数据全为 0DMA 未正确启动或缓冲区大小不匹配检查 DMA 配置和数据宽度确认数据宽度为 Half Word缓冲区类型正确这些问题的共性规律是先确认硬件事件有没有发生再检查软件计算逻辑是否正确。很多初学者一上来就怀疑公式和代码实际上问题出在引脚配置或中断没触发。8. 最佳实践与工程建议8.1 合理选择测量方法根据被测信号频率范围选方法是一个基本判断信号频率范围推荐方案说明1 Hz ~ 1 kHz测周法 / 多周期平均低频信号周期长时间测量精度高1 kHz ~ 1 MHz多周期平均兼顾精度和响应速度1 MHz 以上测频法 / DMA 连续采样单周期计数步数少需要窗口计数实际项目中最忌“无论什么信号都用同一个配置”。建议在代码中预留配置项方便根据被测对象切换。8.2 输入滤波与硬件整形输入捕获的准确性高度依赖输入信号质量。如果被测信号来自机械触点、编码器输出或长导线传输边沿可能存在抖动甚至毛刺。此时有两个选择硬件上在被测信号与 MCU 引脚之间加 RC 滤波或施密特触发器缓冲电路软件上使用定时器输入捕获的滤波功能。输入滤波的本质是利用定时器时钟对输入信号进行多次采样只有连续多次采样到同一电平才认为边沿有效滤波判定基于配置的 Interval 值。不要试图在捕获中断回调里做软件消抖。中断回调必须短小精悍复杂过滤逻辑会拖垮系统实时性。8.3 溢出处理的统一封装16 位计数器从 0 计数到 65535 后会回绕。在单周期测量中可能遇到第一次捕获值接近 65535、第二次捕获值接近 0 的情况。此时必须处理回绕。推荐的做法不是每次都判断大小而是使用一个 32 位扩展计数器在定时器更新中断溢出中断中为一个全局变量加一。真正计算时把两个捕获值连同溢出次数一起换算成 32 位时间戳。虽然代码量稍大但逻辑清晰几乎不会算错。volatile uint32_t g_timer_overflow_cnt 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIMx) { g_timer_overflow_cnt; } }使用 32 位扩展时间戳后捕获值差值计算就无需再关心回绕。8.4 中断服务函数的最小化原则很多输入捕获测量项目最终败在现场不是原理不对而是中断服务函数写得过长。一旦中断处理时间超过输入信号的周期下一次捕获事件已经被硬件确认但 CPU 还没来得及处理就会出现计数丢失。建议在中断回调中只做两件事保存捕获值到缓冲区置位一个标志变量。所有计算、滤波、显示、通信操作都放在主循环中完成。如果数据量确实很大再考虑 DMA 方式。8.5 测试环境的安全操作提醒连接信号源和开发板时务必确认信号电平不超过 MCU 的 IO 容忍范围。对于 3.3 V 供电的 MCU输入信号不应超过 3.6 V具体以数据手册为准。使用外部信号源时先在线缆连接完成、双方共地之后再上电避免热插拔导致引脚损伤。涉及批量测量或产线测试时建议加入超时判断逻辑如果一段时间内没有捕获到边沿自动报告“无信号”并复位状态机而不是让程序卡在等待标志位的地方。9. 总结与后续学习方向这篇文章围绕 STM32C5A3R 的定时器输入捕获把频率测量这条链路从头到尾拆了一遍。核心可以归纳为几句话输入捕获是硬件级的时间戳记录机制比 GPIO 中断更适合测频测频法、测周法、多周期平均法的适用场景不同选择比实现更影响精度CubeMX 配置时预分频和自动重载值决定了计数分辨率和溢出边界这是最重要的一组取舍中断回调要短计算在主循环做DMA 是高频率场景的升级路线排查问题时先确认硬件事件是否发生再检查软件计算逻辑。下一步值得继续深入的方向有三个一是双通道捕获实现频率和占空比同时测量这在电机控制、开关电源调试中非常常见二是把输入捕获与 DMA 结合利用循环缓冲区连续采集多组周期数据提升抗干扰能力三是将这套代码移植到其他系列芯片理解不同型号的定时器时钟树差异。如果你正在做基于 STM32C5A3R 的项目建议先把单周期捕获跑通再用多周期平均法替换最后根据实际信号特征调整滤波和分频参数。这一整套流程验证之后频率测量这个功能基本就是一劳永逸了。