1. 项目缘起从“数脉冲”到“测频率”的刚需最近在做一个电机转速监测的小项目核心需求是要实时、准确地测量一个方波信号的频率。这个信号可能来自光电编码器也可能来自霍尔传感器频率范围从几十赫兹到几千赫兹都有可能。一开始我琢磨着用外部中断配合软件计时来搞信号每来一个上升沿就进一次中断在中断里读取系统时间戳然后计算两次中断的时间差再换算成频率。听起来挺简单对吧但实测下来问题一大堆。首先中断响应本身就有延迟这个延迟在低速时影响不大但频率一高比如到了1kHz以上CPU大部分时间都在进出中断系统负载飙升其他任务根本没法跑。更头疼的是如果信号频率再高一些或者信号里夹杂了毛刺中断频繁触发计时误差会大到离谱测出来的频率数据跳得跟心电图似的完全没法用。这时候我才深刻体会到对于这种需要精确测量时间间隔的场景STM32内置的硬件定时器输入捕获功能才是真正的“专业对口”。输入捕获说白了就是让定时器这个“高精度秒表”去帮你“抓拍”信号跳变的瞬间并把当时的计时器值自动存起来。整个过程由硬件完成不占用CPU资源精度只取决于定时器的时钟源稳定又可靠。今天我就结合自己踩过的坑和调通的经验把手把手配置和使用STM32输入捕获功能的完整流程、核心原理和避坑要点给大家掰开揉碎了讲清楚。2. 核心原理拆解定时器如何“抓住”信号的瞬间在动手写代码之前我们必须先搞明白STM32的定时器到底是怎么实现输入捕获这个“抓拍”动作的。理解了这个后面配置寄存器或者用CubeMX图形化配置时你才知道每一个选项背后的意义出了问题也知道该往哪里查。2.1 定时器的基本“骨架”时基单元你可以把一个定时器想象成一个不断向上累加的计数器。这个计数器的“心跳”频率就是定时器的时钟源CK_PSC。这个时钟源可以来自内部系统时钟比如72MHz也可以来自外部。但72MHz计数太快了计数值瞬间就溢出了所以我们通常需要一个预分频器PSC来把高频时钟“降速”。例如预分频器设置为71那么计数器实际递增的频率就变成了 72MHz / (711) 1MHz也就是每微秒计数一次。计数器CNT会从0开始一直累加到我们设定的自动重装载值ARR然后产生一个更新事件并清零重新开始计数如此循环。这个“从0到ARR”的循环周期就是定时器的基础计时周期。ARR的值决定了定时器的“量程”。比如时钟1MHzARR设为9999那么一个完整的计数周期就是10毫秒10000个计数 * 1微秒。2.2 输入捕获通道的“抓拍”机制定时器通常有多个输入捕获通道每个通道都关联着一个特定的GPIO引脚。这个通道的核心部件是一个“捕获/比较寄存器”比如CCR1。它的工作流程是这样的信号输入与滤波外部信号通过GPIO引脚进入定时器。首先会经过一个数字滤波器它可以滤除信号中短于一定时间的毛刺防止误触发这对于工业环境中的抗干扰至关重要。边沿检测我们可以配置通道捕获的是信号的上升沿、下降沿还是双边沿。这个检测也是硬件完成的。触发与锁存当检测到设定的边沿事件时硬件会立刻做两件事将当前计数器CNT的值瞬间复制到对应的捕获/比较寄存器CCRx中。这个动作是硬件同步的精度极高。同时会置位一个“捕获标志位”比如CC1IF如果使能了捕获中断还会产生一个中断请求。读取与计算我们的程序在中断服务函数里或者通过轮询标志位读取CCRx寄存器中锁存的那个“时间戳”。通过计算连续两次捕获到的CCRx值之差再结合定时器的计数频率就能精确算出两个边沿之间的时间间隔周期其倒数就是频率。关键点这个“抓拍”和“锁存”动作是由硬件在纳秒级时间内完成的完全不受软件中断延迟的影响。这就是输入捕获相比纯软件计时在精度和可靠性上的根本优势。2.3 测量频率与占空比的策略测频率周期通常采用上升沿捕获。记录第一次上升沿的捕获值T1记录第二次上升沿的捕获值T2。如果这期间计数器没有溢出那么信号周期T (T2 - T1) * 计数周期。频率F 1 / T。如果T2 T1说明发生了计数器溢出那么实际周期T ((ARR T2) - T1) * 计数周期。在中断服务程序中我们需要处理这种溢出情况。测占空比需要捕获一个完整周期内的上升沿和下降沿。可以配置为双边沿捕获或者在两个通道上分别设置上升沿和下降沿捕获。假设上升沿值T_rise下降沿值T_fall高电平时间Th (T_fall - T_rise) * 计数周期占空比 Th / T。3. 实战配置以STM32F103的TIM2_CH1为例理论懂了我们来看怎么把它配出来。这里我以最经典的STM32F103C8T6为例使用通用定时器TIM2的通道1对应PA0引脚来捕获一个方波信号。我会同时介绍寄存器配置思路和STM32CubeMX的图形化配置方法因为理解寄存器能让你更懂底层而CubeMX能极大提升开发效率。3.1 硬件连接与CubeMX工程创建首先确保你的信号发生器或者传感器输出端连接到了MCU的PA0引脚。STM32的引脚有复用功能PA0除了是普通IO它的第二功能AF1就是TIM2_CH1。打开STM32CubeMX选择你的芯片型号。系统核心SYS在Debug里选择Serial Wire这样可以用ST-Link调试。时钟RCCHigh Speed Clock (HSE)选择Crystal/Ceramic Resonator使用外部8MHz晶振。时钟配置Clock Configuration这是关键一步。将HSE8MHz通过PLL倍频到72MHz作为系统时钟SYSCLK。APB1总线时钟预分频器设为2这样APB1时钟为36MHz。但注意如果APB1预分频系数不为1定时器时钟TIMxCLK会是APB1时钟的2倍。所以这里TIM2的时钟实际上是72MHz。这个细节CubeMX会自动计算并显示但你必须知道原理。GPIO配置点击PA0引脚选择TIM2_CH1功能。默认的上拉/下拉模式可以先不选取决于你的信号驱动能力如果信号是开漏输出可以配置上拉。定时器TIM2配置时钟源Clock Source选择Internal Clock。通道1Channel1选择Input Capture direct mode。参数设置Parameter Settings预分频器Prescaler输入71。这样定时器时钟 72MHz / (711) 1MHz计数一次代表1微秒。计数模式Counter ModeUp向上计数。自动重装载值Counter Period设为最大值65535因为TIM2是16位定时器。也可以根据你测量的最大周期来设比如想测最大100ms的周期可以设为100000-1因为1MHz时钟。内部时钟分频clock divisionNo Division。重复计数器Repetition Counter通用定时器无此功能忽略。自动重载预装载auto-reload preloadEnable。这个建议开启可以避免在更新时产生毛刺。输入捕获配置点击下方Input Capture Channel 1的配置。极性Polarity选择Rising Edge我们先测频率用上升沿。输入分频器IC Selection选择Direct。信号直接连接到捕获单元。滤波器Filter根据信号质量设置。如果信号干净选No Filter。如果有毛刺可以尝试2或4表示需要几个时钟周期的连续采样才确认有效边沿。这里先设为0无滤波。NVIC设置中断在NVIC Configuration标签页找到TIM2 global interrupt勾选Enabled。优先级可以保持默认。生成代码设置好工程路径和IDE如Keil MDK点击Generate Code。3.2 关键代码实现与解析CubeMX生成了初始化代码但我们还需要在用户代码区域添加逻辑。核心在于中断服务函数中的处理。首先在main.c的/* USER CODE BEGIN 2 */之后启动定时器和使能捕获中断/* 启动定时器TIM2的基础计数 */ HAL_TIM_Base_Start(htim2); /* 启动TIM2的输入捕获功能并开启捕获中断 */ HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1);接下来我们需要定义几个全局变量来辅助计算/* USER CODE BEGIN PV */ volatile uint32_t g_capture_count 0; // 捕获值 volatile uint32_t g_last_capture 0; // 上一次捕获值 volatile uint32_t g_period 0; // 计算出的周期微秒数 volatile uint8_t g_is_first_capture 1; // 是否是第一次捕获的标志 /* USER CODE END PV */最重要的部分是重写输入捕获中断的回调函数。这个函数会在每次捕获事件发生时被HAL库调用。我们在stm32f1xx_it.c中找到TIM2_IRQHandler但处理逻辑最好写在用户文件如main.c中重写的回调函数里/* USER CODE BEGIN 4 */ void HAL_TIM_IC_CaptureCallback(TIM_TypeDef *htim) { // 判断是否是TIM2的通道1产生了捕获中断 if (htim htim2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { // 读取本次捕获的值 g_capture_count HAL_TIM_ReadCapturedValue(htim2, TIM_CHANNEL_1); if (g_is_first_capture) // 第一次捕获 { g_last_capture g_capture_count; g_is_first_capture 0; // 清除第一次捕获标志 } else // 至少是第二次捕获 { /* 计算周期差值需要考虑计数器溢出的情况 */ if (g_capture_count g_last_capture) { // 正常情况没有溢出或只溢出一次且仍在同一个计数周期内 g_period g_capture_count - g_last_capture; } else { // 发生溢出差值需要加上计数器的模ARR1 // 对于16位定时器如果ARR是65535则模是65536 g_period (htim2.Instance-ARR 1) g_capture_count - g_last_capture; } // 更新上一次捕获值为下一次计算做准备 g_last_capture g_capture_count; // 这里g_period的单位是“定时器计数次数” // 实际时间微秒 g_period * (1 / 定时器计数频率) // 我们预分频后是1MHz所以g_period直接就是微秒数 // 频率Hz 1,000,000 / g_period } } } /* USER CODE END 4 */最后在主循环中你可以周期性地打印或使用g_period来计算频率/* USER CODE BEGIN WHILE */ while (1) { if (g_period ! 0) { uint32_t freq_hz 1000000 / g_period; // 计算频率 printf(Period: %lu us, Freq: %lu Hz\r\n, g_period, freq_hz); g_period 0; // 可选清空等待下一次计算 } HAL_Delay(500); // 每500ms打印一次 /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */4. 精度提升与边界情况处理上面的代码是一个基础框架能跑起来但在实际项目中要获得稳定可靠的数据还需要处理很多细节。4.1 计数器溢出的精确处理前面的代码简单处理了溢出但只处理了一次溢出。如果信号的周期非常长或者定时器计数频率很高ARR值设置得较小可能在两个捕获事件之间发生了多次溢出。上面的减法逻辑就会出错。更健壮的方法是引入一个溢出计数器。在定时器的**更新中断溢出中断**中对该计数器加1。在计算周期时将溢出次数也考虑进去。开启更新中断在CubeMX中除了使能全局中断还需要在TIM2参数配置的NVIC Settings里勾选Update interrupt。定义溢出计数变量volatile uint32_t g_tim2_overflow_count 0;重写更新中断回调void HAL_TIM_PeriodElapsedCallback(TIM_TypeDef *htim) { if (htim htim2) { g_tim2_overflow_count; } }修改捕获回调中的计算逻辑else // 至少是第二次捕获 { uint32_t overflow_count g_tim2_overflow_count; uint32_t period_ticks 0; // 暂时关闭更新中断防止在读取过程中溢出计数变化 __disable_irq(); if (g_capture_count g_last_capture) { period_ticks (overflow_count * (htim2.Instance-ARR 1)) (g_capture_count - g_last_capture); } else { // 注意当g_capture_count g_last_capture时说明在两次捕获间至少发生了一次溢出 // 但overflow_count记录的是从开始到现在的总溢出次数。 // 我们需要的是两次捕获之间的溢出次数。一个简单方法是 // 假设溢出发生在两次捕获之间那么计算出的周期需要加上一个ARR1 // 但更严谨的做法是记录每次捕获时的溢出计数。 // 这里采用简化但常用的方法 period_ticks (overflow_count * (htim2.Instance-ARR 1)) (g_capture_count (htim2.Instance-ARR 1) - g_last_capture); } g_last_capture g_capture_count; __enable_irq(); g_period period_ticks; // 单位是定时器计数 }注意上述简化方法在超高频率或复杂情况下可能仍有瑕疵。最严谨的方法是定义一个结构体同时记录捕获值capture和当时的溢出计数overflow_snapshot在捕获中断里读取并保存这两个值然后在主循环或更低优先级任务中进行周期计算。4.2 高频与低频信号的量程适配高频信号如果信号频率很高比如1MHz周期只有1微秒。为了测量更精确我们希望一个周期内能有更多的计数。这时应该提高定时器的计数频率。比如将预分频器PSC设小让定时器以系统时钟72MHz运行。这样1微秒内会计数72次分辨率大大提高。但要注意ARR要设置得足够大以避免频繁溢出增加处理复杂度。低频信号如果信号频率很低比如1Hz周期长达1秒。如果定时器以1MHz计数ARR最大65535最多只能计65.535毫秒会频繁溢出。这时有两个选择降低定时器计数频率增大PSC比如设为7199让定时器时钟变为10kHz72MHz/7200。这样ARR设为最大值65535时最大可测量周期为6.5535秒足以覆盖1Hz信号。但分辨率会下降为0.1毫秒。使用32位定时器或定时器级联一些STM32型号有32位通用定时器如L4系列的LPTIM或者可以将两个16位定时器级联成32位使用从而获得巨大的计数范围同时保持高计数频率和高分辨率。这是最理想的方案但硬件有限制。选择策略在项目初期就要根据待测信号的频率范围估算所需的计时精度和量程从而确定PSC和ARR的值。公式为最大可测周期 (ARR 1) * (PSC 1) / TIM_CLK。分辨率 (PSC 1) / TIM_CLK。4.3 数字滤波器的合理使用输入捕获通道前的数字滤波器不是摆设在噪声环境中是保证稳定的关键。它实际上是一个事件计数器只有当连续N个采样时钟都检测到相同的电平才认为边沿有效。这个N就是滤波值ICxF位。如何设置在CubeMX中Filter值就是N。N的取值范围和采样时钟频率有关。例如当Clock Division为No Division时采样时钟等于定时器输入时钟CK_INT。如果定时器时钟是1MHz那么一个采样周期就是1微秒。设置Filter4意味着信号边沿必须持续4微秒不变才会被确认。影响滤波器能有效滤除窄毛刺但也会引入额外的延迟。对于非常干净的信号可以不用滤波。对于有噪声的信号需要根据噪声的脉宽来选择合适的滤波值。设置过大可能会滤掉有效的快速边沿设置过小则可能无法滤除噪声。通常需要通过示波器观察信号质量来调试确定。5. 进阶应用测量脉冲宽度与占空比测量占空比需要同时捕获上升沿和下降沿。有两种常见的实现方式方法一单通道双边沿捕获将输入捕获通道配置为Rising and Falling Edge。在捕获中断中根据当前是上升沿还是下降沿中断分别记录时间戳。这种方法需要你在中断中判断触发的是哪种边沿通过读取TIMx_CCER寄存器的CCxP位或使用HAL库的HAL_TIM_ReadCapturedValue结合状态判断逻辑稍复杂但只占用一个定时器通道。方法二双通道分别捕获使用同一个定时器的两个输入通道如CH1和CH2连接到同一个GPIO引脚需要检查芯片手册是否支持。将CH1配置为上升沿捕获CH2配置为下降沿捕获。这样上升沿和下降沿会分别触发CH1和CH2的中断在各自的中断回调中读取捕获值。逻辑清晰但占用两个通道资源。这里以方法一单通道双边沿为例简述关键配置和代码思路CubeMX配置在TIM2的Channel1配置中Polarity选择Both Edges。代码逻辑volatile uint32_t g_rise_value 0; volatile uint32_t g_fall_value 0; volatile uint8_t g_edge_state 0; // 0:等待上升沿 1:已捕获上升沿等待下降沿 void HAL_TIM_IC_CaptureCallback(TIM_TypeDef *htim) { if (htim htim2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { uint32_t current_capture HAL_TIM_ReadCapturedValue(htim2, TIM_CHANNEL_1); // 判断当前是上升沿还是下降沿HAL库没有直接提供函数。 // 可以通过读取TIMx_CCER寄存器的CC1P位来判断或者用一个技巧 // 在中断里读取GPIO引脚的电平。如果是高电平说明刚发生的是上升沿低电平则是下降沿。 // 这里使用读取GPIO的方法需包含gpio.h if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) GPIO_PIN_SET) { // 上升沿 g_rise_value current_capture; g_edge_state 1; // 下一个应该是下降沿 } else { // 下降沿 g_fall_value current_capture; if (g_edge_state 1) { // 计算高电平脉宽 uint32_t pulse_width 0; // ... (处理溢出的脉宽计算) // 此时一个完整周期的高电平时间已知 // 还需要结合下一个上升沿的值才能计算周期和占空比 // 因此通常需要缓存连续两个上升沿的值和一个下降沿的值 } g_edge_state 0; // 下一个应该是上升沿 } } }实际项目中为了计算占空比你需要缓存一个周期内的三个时间点上升沿A下降沿B上升沿C。则高电平时间 B - A周期 C - A。占空比 (B - A) / (C - A)。这需要在状态机中更细致地管理这些时间戳和边缘状态。6. 调试技巧与常见问题排查即使配置看起来正确第一次做输入捕获也难免遇到问题。下面是一些实用的调试方法和常见坑点。问题一完全捕获不到信号中断不触发。检查清单GPIO复用功能确认引脚是否已正确配置为定时器通道的复用功能AF。在CubeMX中检查在代码中查看生成的MX_GPIO_Init函数。定时器时钟使能CubeMX通常会自动生成时钟使能代码但可以检查htim2.Instance-CR1寄存器的CEN位是否为1定时器已启动。输入捕获通道使能确认是否调用了HAL_TIM_IC_Start_IT。这个函数不仅启动了捕获还使能了通道和中断。中断优先级与使能检查NVIC中TIM2中断是否已使能优先级是否被更高优先级中断抢占导致无法响应。信号本身用示波器或逻辑分析仪检查PA0引脚上是否有预期的信号电压电平是否符合要求STM32通常是0-3.3V边沿极性检查是否配置了正确的边沿上升沿/下降沿。你的信号是上升沿有效吗问题二捕获值不稳定跳动很大。可能原因与对策信号噪声这是最常见的原因。示波器查看信号是否有毛刺。解决方法a) 在硬件上增加RC滤波电路b) 启用并调整定时器的输入滤波器Filter参数。中断处理时间过长如果中断服务函数里做了太多事情比如浮点计算、打印可能导致丢失下一次捕获中断。优化中断服务函数只做最必要的读写操作将复杂的计算如频率换算移到主循环中。计数器溢出处理不当如果测量低频信号且未正确处理多次溢出计算出的周期会出错。务必实现第4.1节提到的带溢出计数的完整处理逻辑。定时器时钟配置错误确认你理解的定时器实际计数频率和代码中使用的计算基准是否一致。用__HAL_TIM_GET_CLOCKSOURCE宏可以辅助检查。问题三测量结果有固定偏差。排查方向系统时钟精度如果使用内部RC振荡器HSI其精度可能只有±1%这会导致所有时间测量存在比例误差。对精度要求高的应用务必使用外部晶振HSE。预分频器理解错误记住预分频器PSC写入的值是分频系数-1。写入71实际分频是72。计算中的整数溢出在计算频率freq 1000000 / period时如果period很小高频1000000 * 周期计数可能会超过32位整数范围。可以考虑使用64位整数uint64_t进行中间运算或者先进行浮点计算。一个关键的调试手段利用调试器在IDE如Keil的调试模式下可以查看定时器相关寄存器TIM2-CNT, TIM2-CCR1, TIM2-SR等的实时值。在中断服务函数入口设置断点观察是否进入。观察全局变量g_capture_count,g_period的变化情况。输入捕获是STM32定时器里非常实用且经典的功能从简单的频率计到复杂的编码器接口、PWM输入都离不开它。把原理吃透把边界情况处理好你就能在需要精确计时的项目中游刃有余。我自己的经验是第一次调通后把相关的配置和计算逻辑封装成一个独立的.c/.h文件以后的项目里直接拿来用最多根据时钟改个宏定义能省下大量重复调试的时间。 STM32输入捕获原理与实战：精准测量频率与占空比
1. 项目缘起从“数脉冲”到“测频率”的刚需最近在做一个电机转速监测的小项目核心需求是要实时、准确地测量一个方波信号的频率。这个信号可能来自光电编码器也可能来自霍尔传感器频率范围从几十赫兹到几千赫兹都有可能。一开始我琢磨着用外部中断配合软件计时来搞信号每来一个上升沿就进一次中断在中断里读取系统时间戳然后计算两次中断的时间差再换算成频率。听起来挺简单对吧但实测下来问题一大堆。首先中断响应本身就有延迟这个延迟在低速时影响不大但频率一高比如到了1kHz以上CPU大部分时间都在进出中断系统负载飙升其他任务根本没法跑。更头疼的是如果信号频率再高一些或者信号里夹杂了毛刺中断频繁触发计时误差会大到离谱测出来的频率数据跳得跟心电图似的完全没法用。这时候我才深刻体会到对于这种需要精确测量时间间隔的场景STM32内置的硬件定时器输入捕获功能才是真正的“专业对口”。输入捕获说白了就是让定时器这个“高精度秒表”去帮你“抓拍”信号跳变的瞬间并把当时的计时器值自动存起来。整个过程由硬件完成不占用CPU资源精度只取决于定时器的时钟源稳定又可靠。今天我就结合自己踩过的坑和调通的经验把手把手配置和使用STM32输入捕获功能的完整流程、核心原理和避坑要点给大家掰开揉碎了讲清楚。2. 核心原理拆解定时器如何“抓住”信号的瞬间在动手写代码之前我们必须先搞明白STM32的定时器到底是怎么实现输入捕获这个“抓拍”动作的。理解了这个后面配置寄存器或者用CubeMX图形化配置时你才知道每一个选项背后的意义出了问题也知道该往哪里查。2.1 定时器的基本“骨架”时基单元你可以把一个定时器想象成一个不断向上累加的计数器。这个计数器的“心跳”频率就是定时器的时钟源CK_PSC。这个时钟源可以来自内部系统时钟比如72MHz也可以来自外部。但72MHz计数太快了计数值瞬间就溢出了所以我们通常需要一个预分频器PSC来把高频时钟“降速”。例如预分频器设置为71那么计数器实际递增的频率就变成了 72MHz / (711) 1MHz也就是每微秒计数一次。计数器CNT会从0开始一直累加到我们设定的自动重装载值ARR然后产生一个更新事件并清零重新开始计数如此循环。这个“从0到ARR”的循环周期就是定时器的基础计时周期。ARR的值决定了定时器的“量程”。比如时钟1MHzARR设为9999那么一个完整的计数周期就是10毫秒10000个计数 * 1微秒。2.2 输入捕获通道的“抓拍”机制定时器通常有多个输入捕获通道每个通道都关联着一个特定的GPIO引脚。这个通道的核心部件是一个“捕获/比较寄存器”比如CCR1。它的工作流程是这样的信号输入与滤波外部信号通过GPIO引脚进入定时器。首先会经过一个数字滤波器它可以滤除信号中短于一定时间的毛刺防止误触发这对于工业环境中的抗干扰至关重要。边沿检测我们可以配置通道捕获的是信号的上升沿、下降沿还是双边沿。这个检测也是硬件完成的。触发与锁存当检测到设定的边沿事件时硬件会立刻做两件事将当前计数器CNT的值瞬间复制到对应的捕获/比较寄存器CCRx中。这个动作是硬件同步的精度极高。同时会置位一个“捕获标志位”比如CC1IF如果使能了捕获中断还会产生一个中断请求。读取与计算我们的程序在中断服务函数里或者通过轮询标志位读取CCRx寄存器中锁存的那个“时间戳”。通过计算连续两次捕获到的CCRx值之差再结合定时器的计数频率就能精确算出两个边沿之间的时间间隔周期其倒数就是频率。关键点这个“抓拍”和“锁存”动作是由硬件在纳秒级时间内完成的完全不受软件中断延迟的影响。这就是输入捕获相比纯软件计时在精度和可靠性上的根本优势。2.3 测量频率与占空比的策略测频率周期通常采用上升沿捕获。记录第一次上升沿的捕获值T1记录第二次上升沿的捕获值T2。如果这期间计数器没有溢出那么信号周期T (T2 - T1) * 计数周期。频率F 1 / T。如果T2 T1说明发生了计数器溢出那么实际周期T ((ARR T2) - T1) * 计数周期。在中断服务程序中我们需要处理这种溢出情况。测占空比需要捕获一个完整周期内的上升沿和下降沿。可以配置为双边沿捕获或者在两个通道上分别设置上升沿和下降沿捕获。假设上升沿值T_rise下降沿值T_fall高电平时间Th (T_fall - T_rise) * 计数周期占空比 Th / T。3. 实战配置以STM32F103的TIM2_CH1为例理论懂了我们来看怎么把它配出来。这里我以最经典的STM32F103C8T6为例使用通用定时器TIM2的通道1对应PA0引脚来捕获一个方波信号。我会同时介绍寄存器配置思路和STM32CubeMX的图形化配置方法因为理解寄存器能让你更懂底层而CubeMX能极大提升开发效率。3.1 硬件连接与CubeMX工程创建首先确保你的信号发生器或者传感器输出端连接到了MCU的PA0引脚。STM32的引脚有复用功能PA0除了是普通IO它的第二功能AF1就是TIM2_CH1。打开STM32CubeMX选择你的芯片型号。系统核心SYS在Debug里选择Serial Wire这样可以用ST-Link调试。时钟RCCHigh Speed Clock (HSE)选择Crystal/Ceramic Resonator使用外部8MHz晶振。时钟配置Clock Configuration这是关键一步。将HSE8MHz通过PLL倍频到72MHz作为系统时钟SYSCLK。APB1总线时钟预分频器设为2这样APB1时钟为36MHz。但注意如果APB1预分频系数不为1定时器时钟TIMxCLK会是APB1时钟的2倍。所以这里TIM2的时钟实际上是72MHz。这个细节CubeMX会自动计算并显示但你必须知道原理。GPIO配置点击PA0引脚选择TIM2_CH1功能。默认的上拉/下拉模式可以先不选取决于你的信号驱动能力如果信号是开漏输出可以配置上拉。定时器TIM2配置时钟源Clock Source选择Internal Clock。通道1Channel1选择Input Capture direct mode。参数设置Parameter Settings预分频器Prescaler输入71。这样定时器时钟 72MHz / (711) 1MHz计数一次代表1微秒。计数模式Counter ModeUp向上计数。自动重装载值Counter Period设为最大值65535因为TIM2是16位定时器。也可以根据你测量的最大周期来设比如想测最大100ms的周期可以设为100000-1因为1MHz时钟。内部时钟分频clock divisionNo Division。重复计数器Repetition Counter通用定时器无此功能忽略。自动重载预装载auto-reload preloadEnable。这个建议开启可以避免在更新时产生毛刺。输入捕获配置点击下方Input Capture Channel 1的配置。极性Polarity选择Rising Edge我们先测频率用上升沿。输入分频器IC Selection选择Direct。信号直接连接到捕获单元。滤波器Filter根据信号质量设置。如果信号干净选No Filter。如果有毛刺可以尝试2或4表示需要几个时钟周期的连续采样才确认有效边沿。这里先设为0无滤波。NVIC设置中断在NVIC Configuration标签页找到TIM2 global interrupt勾选Enabled。优先级可以保持默认。生成代码设置好工程路径和IDE如Keil MDK点击Generate Code。3.2 关键代码实现与解析CubeMX生成了初始化代码但我们还需要在用户代码区域添加逻辑。核心在于中断服务函数中的处理。首先在main.c的/* USER CODE BEGIN 2 */之后启动定时器和使能捕获中断/* 启动定时器TIM2的基础计数 */ HAL_TIM_Base_Start(htim2); /* 启动TIM2的输入捕获功能并开启捕获中断 */ HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1);接下来我们需要定义几个全局变量来辅助计算/* USER CODE BEGIN PV */ volatile uint32_t g_capture_count 0; // 捕获值 volatile uint32_t g_last_capture 0; // 上一次捕获值 volatile uint32_t g_period 0; // 计算出的周期微秒数 volatile uint8_t g_is_first_capture 1; // 是否是第一次捕获的标志 /* USER CODE END PV */最重要的部分是重写输入捕获中断的回调函数。这个函数会在每次捕获事件发生时被HAL库调用。我们在stm32f1xx_it.c中找到TIM2_IRQHandler但处理逻辑最好写在用户文件如main.c中重写的回调函数里/* USER CODE BEGIN 4 */ void HAL_TIM_IC_CaptureCallback(TIM_TypeDef *htim) { // 判断是否是TIM2的通道1产生了捕获中断 if (htim htim2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { // 读取本次捕获的值 g_capture_count HAL_TIM_ReadCapturedValue(htim2, TIM_CHANNEL_1); if (g_is_first_capture) // 第一次捕获 { g_last_capture g_capture_count; g_is_first_capture 0; // 清除第一次捕获标志 } else // 至少是第二次捕获 { /* 计算周期差值需要考虑计数器溢出的情况 */ if (g_capture_count g_last_capture) { // 正常情况没有溢出或只溢出一次且仍在同一个计数周期内 g_period g_capture_count - g_last_capture; } else { // 发生溢出差值需要加上计数器的模ARR1 // 对于16位定时器如果ARR是65535则模是65536 g_period (htim2.Instance-ARR 1) g_capture_count - g_last_capture; } // 更新上一次捕获值为下一次计算做准备 g_last_capture g_capture_count; // 这里g_period的单位是“定时器计数次数” // 实际时间微秒 g_period * (1 / 定时器计数频率) // 我们预分频后是1MHz所以g_period直接就是微秒数 // 频率Hz 1,000,000 / g_period } } } /* USER CODE END 4 */最后在主循环中你可以周期性地打印或使用g_period来计算频率/* USER CODE BEGIN WHILE */ while (1) { if (g_period ! 0) { uint32_t freq_hz 1000000 / g_period; // 计算频率 printf(Period: %lu us, Freq: %lu Hz\r\n, g_period, freq_hz); g_period 0; // 可选清空等待下一次计算 } HAL_Delay(500); // 每500ms打印一次 /* USER CODE END WHILE */ /* USER CODE BEGIN 3 */ } /* USER CODE END 3 */4. 精度提升与边界情况处理上面的代码是一个基础框架能跑起来但在实际项目中要获得稳定可靠的数据还需要处理很多细节。4.1 计数器溢出的精确处理前面的代码简单处理了溢出但只处理了一次溢出。如果信号的周期非常长或者定时器计数频率很高ARR值设置得较小可能在两个捕获事件之间发生了多次溢出。上面的减法逻辑就会出错。更健壮的方法是引入一个溢出计数器。在定时器的**更新中断溢出中断**中对该计数器加1。在计算周期时将溢出次数也考虑进去。开启更新中断在CubeMX中除了使能全局中断还需要在TIM2参数配置的NVIC Settings里勾选Update interrupt。定义溢出计数变量volatile uint32_t g_tim2_overflow_count 0;重写更新中断回调void HAL_TIM_PeriodElapsedCallback(TIM_TypeDef *htim) { if (htim htim2) { g_tim2_overflow_count; } }修改捕获回调中的计算逻辑else // 至少是第二次捕获 { uint32_t overflow_count g_tim2_overflow_count; uint32_t period_ticks 0; // 暂时关闭更新中断防止在读取过程中溢出计数变化 __disable_irq(); if (g_capture_count g_last_capture) { period_ticks (overflow_count * (htim2.Instance-ARR 1)) (g_capture_count - g_last_capture); } else { // 注意当g_capture_count g_last_capture时说明在两次捕获间至少发生了一次溢出 // 但overflow_count记录的是从开始到现在的总溢出次数。 // 我们需要的是两次捕获之间的溢出次数。一个简单方法是 // 假设溢出发生在两次捕获之间那么计算出的周期需要加上一个ARR1 // 但更严谨的做法是记录每次捕获时的溢出计数。 // 这里采用简化但常用的方法 period_ticks (overflow_count * (htim2.Instance-ARR 1)) (g_capture_count (htim2.Instance-ARR 1) - g_last_capture); } g_last_capture g_capture_count; __enable_irq(); g_period period_ticks; // 单位是定时器计数 }注意上述简化方法在超高频率或复杂情况下可能仍有瑕疵。最严谨的方法是定义一个结构体同时记录捕获值capture和当时的溢出计数overflow_snapshot在捕获中断里读取并保存这两个值然后在主循环或更低优先级任务中进行周期计算。4.2 高频与低频信号的量程适配高频信号如果信号频率很高比如1MHz周期只有1微秒。为了测量更精确我们希望一个周期内能有更多的计数。这时应该提高定时器的计数频率。比如将预分频器PSC设小让定时器以系统时钟72MHz运行。这样1微秒内会计数72次分辨率大大提高。但要注意ARR要设置得足够大以避免频繁溢出增加处理复杂度。低频信号如果信号频率很低比如1Hz周期长达1秒。如果定时器以1MHz计数ARR最大65535最多只能计65.535毫秒会频繁溢出。这时有两个选择降低定时器计数频率增大PSC比如设为7199让定时器时钟变为10kHz72MHz/7200。这样ARR设为最大值65535时最大可测量周期为6.5535秒足以覆盖1Hz信号。但分辨率会下降为0.1毫秒。使用32位定时器或定时器级联一些STM32型号有32位通用定时器如L4系列的LPTIM或者可以将两个16位定时器级联成32位使用从而获得巨大的计数范围同时保持高计数频率和高分辨率。这是最理想的方案但硬件有限制。选择策略在项目初期就要根据待测信号的频率范围估算所需的计时精度和量程从而确定PSC和ARR的值。公式为最大可测周期 (ARR 1) * (PSC 1) / TIM_CLK。分辨率 (PSC 1) / TIM_CLK。4.3 数字滤波器的合理使用输入捕获通道前的数字滤波器不是摆设在噪声环境中是保证稳定的关键。它实际上是一个事件计数器只有当连续N个采样时钟都检测到相同的电平才认为边沿有效。这个N就是滤波值ICxF位。如何设置在CubeMX中Filter值就是N。N的取值范围和采样时钟频率有关。例如当Clock Division为No Division时采样时钟等于定时器输入时钟CK_INT。如果定时器时钟是1MHz那么一个采样周期就是1微秒。设置Filter4意味着信号边沿必须持续4微秒不变才会被确认。影响滤波器能有效滤除窄毛刺但也会引入额外的延迟。对于非常干净的信号可以不用滤波。对于有噪声的信号需要根据噪声的脉宽来选择合适的滤波值。设置过大可能会滤掉有效的快速边沿设置过小则可能无法滤除噪声。通常需要通过示波器观察信号质量来调试确定。5. 进阶应用测量脉冲宽度与占空比测量占空比需要同时捕获上升沿和下降沿。有两种常见的实现方式方法一单通道双边沿捕获将输入捕获通道配置为Rising and Falling Edge。在捕获中断中根据当前是上升沿还是下降沿中断分别记录时间戳。这种方法需要你在中断中判断触发的是哪种边沿通过读取TIMx_CCER寄存器的CCxP位或使用HAL库的HAL_TIM_ReadCapturedValue结合状态判断逻辑稍复杂但只占用一个定时器通道。方法二双通道分别捕获使用同一个定时器的两个输入通道如CH1和CH2连接到同一个GPIO引脚需要检查芯片手册是否支持。将CH1配置为上升沿捕获CH2配置为下降沿捕获。这样上升沿和下降沿会分别触发CH1和CH2的中断在各自的中断回调中读取捕获值。逻辑清晰但占用两个通道资源。这里以方法一单通道双边沿为例简述关键配置和代码思路CubeMX配置在TIM2的Channel1配置中Polarity选择Both Edges。代码逻辑volatile uint32_t g_rise_value 0; volatile uint32_t g_fall_value 0; volatile uint8_t g_edge_state 0; // 0:等待上升沿 1:已捕获上升沿等待下降沿 void HAL_TIM_IC_CaptureCallback(TIM_TypeDef *htim) { if (htim htim2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { uint32_t current_capture HAL_TIM_ReadCapturedValue(htim2, TIM_CHANNEL_1); // 判断当前是上升沿还是下降沿HAL库没有直接提供函数。 // 可以通过读取TIMx_CCER寄存器的CC1P位来判断或者用一个技巧 // 在中断里读取GPIO引脚的电平。如果是高电平说明刚发生的是上升沿低电平则是下降沿。 // 这里使用读取GPIO的方法需包含gpio.h if (HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0) GPIO_PIN_SET) { // 上升沿 g_rise_value current_capture; g_edge_state 1; // 下一个应该是下降沿 } else { // 下降沿 g_fall_value current_capture; if (g_edge_state 1) { // 计算高电平脉宽 uint32_t pulse_width 0; // ... (处理溢出的脉宽计算) // 此时一个完整周期的高电平时间已知 // 还需要结合下一个上升沿的值才能计算周期和占空比 // 因此通常需要缓存连续两个上升沿的值和一个下降沿的值 } g_edge_state 0; // 下一个应该是上升沿 } } }实际项目中为了计算占空比你需要缓存一个周期内的三个时间点上升沿A下降沿B上升沿C。则高电平时间 B - A周期 C - A。占空比 (B - A) / (C - A)。这需要在状态机中更细致地管理这些时间戳和边缘状态。6. 调试技巧与常见问题排查即使配置看起来正确第一次做输入捕获也难免遇到问题。下面是一些实用的调试方法和常见坑点。问题一完全捕获不到信号中断不触发。检查清单GPIO复用功能确认引脚是否已正确配置为定时器通道的复用功能AF。在CubeMX中检查在代码中查看生成的MX_GPIO_Init函数。定时器时钟使能CubeMX通常会自动生成时钟使能代码但可以检查htim2.Instance-CR1寄存器的CEN位是否为1定时器已启动。输入捕获通道使能确认是否调用了HAL_TIM_IC_Start_IT。这个函数不仅启动了捕获还使能了通道和中断。中断优先级与使能检查NVIC中TIM2中断是否已使能优先级是否被更高优先级中断抢占导致无法响应。信号本身用示波器或逻辑分析仪检查PA0引脚上是否有预期的信号电压电平是否符合要求STM32通常是0-3.3V边沿极性检查是否配置了正确的边沿上升沿/下降沿。你的信号是上升沿有效吗问题二捕获值不稳定跳动很大。可能原因与对策信号噪声这是最常见的原因。示波器查看信号是否有毛刺。解决方法a) 在硬件上增加RC滤波电路b) 启用并调整定时器的输入滤波器Filter参数。中断处理时间过长如果中断服务函数里做了太多事情比如浮点计算、打印可能导致丢失下一次捕获中断。优化中断服务函数只做最必要的读写操作将复杂的计算如频率换算移到主循环中。计数器溢出处理不当如果测量低频信号且未正确处理多次溢出计算出的周期会出错。务必实现第4.1节提到的带溢出计数的完整处理逻辑。定时器时钟配置错误确认你理解的定时器实际计数频率和代码中使用的计算基准是否一致。用__HAL_TIM_GET_CLOCKSOURCE宏可以辅助检查。问题三测量结果有固定偏差。排查方向系统时钟精度如果使用内部RC振荡器HSI其精度可能只有±1%这会导致所有时间测量存在比例误差。对精度要求高的应用务必使用外部晶振HSE。预分频器理解错误记住预分频器PSC写入的值是分频系数-1。写入71实际分频是72。计算中的整数溢出在计算频率freq 1000000 / period时如果period很小高频1000000 * 周期计数可能会超过32位整数范围。可以考虑使用64位整数uint64_t进行中间运算或者先进行浮点计算。一个关键的调试手段利用调试器在IDE如Keil的调试模式下可以查看定时器相关寄存器TIM2-CNT, TIM2-CCR1, TIM2-SR等的实时值。在中断服务函数入口设置断点观察是否进入。观察全局变量g_capture_count,g_period的变化情况。输入捕获是STM32定时器里非常实用且经典的功能从简单的频率计到复杂的编码器接口、PWM输入都离不开它。把原理吃透把边界情况处理好你就能在需要精确计时的项目中游刃有余。我自己的经验是第一次调通后把相关的配置和计算逻辑封装成一个独立的.c/.h文件以后的项目里直接拿来用最多根据时钟改个宏定义能省下大量重复调试的时间。