1. 从“数数”到“掐表”输入捕获到底在干什么搞嵌入式开发尤其是玩STM32的定时器这个外设绝对是绕不开的核心。PWM输出、延时、计时这些基础功能大家都很熟了。但说到“输入捕获”很多刚上手的朋友可能会觉得有点抽象它到底有什么用简单来说你可以把它理解成一个极其精准的“掐表”工具。想象一下你面前有一个信号发生器它输出一个方波你想知道这个方波的频率是多少或者高电平持续了多长时间。用人眼和普通秒表去测误差太大而且对于微秒μs甚至纳秒ns级别的时间根本无能为力。STM32的定时器输入捕获功能就是为解决这类问题而生的。它能在外部信号的特定边沿比如上升沿或下降沿到来的瞬间像拍照一样“咔嚓”一下把当前定时器的计数值“捕获”并锁存到一个专用的寄存器里。你只需要读取两次捕获值做个减法再结合定时器的计数频率就能精确计算出两次边沿之间的时间间隔。这个功能的应用场景非常广泛。比如测量旋转编码器的转速通过测量脉冲周期、测量超声波测距模块回波的高电平时间、解码红外遥控器的NEC协议测量脉冲宽度、甚至实现一个高精度的频率计。它把时间测量这个事从软件轮询的“苦力活”变成了硬件自动完成的“精细活”不仅精度高还不占用CPU资源。今天我就结合自己这些年调STM32定时器的经验把输入捕获这个功能的里里外外、从配置到避坑给你掰开揉碎了讲清楚。2. 硬件架构与核心寄存器理解“捕获”的物理基础在写代码之前我们必须先搞清楚STM32定时器为了实现输入捕获在硬件上做了哪些设计。这就像开车前得知道油门、刹车、方向盘在哪一样。STM32的通用定时器如TIM2, TIM3, TIM4, TIM5和高级定时器TIM1, TIM8都支持输入捕获功能其核心硬件逻辑围绕几个关键部分展开。2.1 输入通道与捕获/比较寄存器每个定时器通常有4个独立的输入捕获通道CH1-CH4。每个通道都对应着一对“捕获/比较寄存器”比如TIMx_CCR1对应通道1。这个寄存器是“双向”的当通道配置为输出模式时它是比较寄存器用于产生PWM当配置为输入捕获模式时它就变成了捕获寄存器。关键点来了捕获是如何触发的每个输入通道的信号会先经过一个“输入滤波器和边沿检测器”。你可以配置滤波器来消除信号上的毛刺比如设置采样频率和事件次数配置边沿检测器来指定在信号的上升沿、下降沿还是双边沿触发捕获。当指定的边沿事件发生时硬件会立刻执行一个原子操作将当前定时器计数器TIMx_CNT的值复制到对应的捕获/比较寄存器TIMx_CCRx中。同时硬件会置位一个标志位TIMx_SR寄存器中的CCxIF位如果使能了中断或DMA还会产生相应的请求。这个过程完全由硬件完成速度极快精度只取决于定时器的时钟基准。2.2 定时器计数模式与溢出处理输入捕获的精度和量程直接依赖于定时器计数器TIMx_CNT的工作方式。最常用的模式是向上计数模式计数器从0开始每个时钟周期加1一直加到自动重装载值TIMx_ARR然后产生溢出事件并清零重新开始。这里就引出了输入捕获测量中的一个经典问题如何测量长于一次定时器溢出周期的时间例如定时器ARR设为65535时钟频率为1MHz那么一次溢出的周期是65.535ms。如果你要测一个100ms的脉冲宽度计数器肯定会溢出至少一次。解决方案是结合溢出中断。我们可以在使能捕获中断的同时也使能定时器的更新溢出中断。在更新中断服务函数里对一个全局的溢出计数器比如capture_overflow_count进行加1。这样当我们捕获到上升沿和下降沿时得到的就不仅仅是CCRx寄存器的值而是一个“扩展”的时间值总时间 溢出次数 * (ARR 1) 第二次捕获值 - 第一次捕获值。这里有个细节需要注意捕获值是在溢出前还是溢出后读取的如果第一次捕获发生在计数器为60000时然后计数器溢出归零又在1000时发生第二次捕获。单纯用1000 - 60000会得到一个负数在无符号数运算中会变成一个很大的正数结果显然是错的。因此我们的计算必须考虑溢出计数器的状态。通常的逻辑是在捕获中断里除了读取CCRx还要立刻读取当前的溢出计数器值共同组成一个完整的时间戳。2.3 输入通道与GPIO的映射关系这不是软件配置而是硬件设计。STM32的定时器输入通道对应的GPIO引脚是固定的你需要查阅芯片的数据手册Datasheet或引脚复用映射表Alternate Function Mapping来确定。例如TIM2的通道1可能对应PA0、PA5或PA15具体是哪个取决于你的芯片型号和封装。在CubeMX工具里这个选择是可视化的但理解其背后的硬件连接依然重要尤其是在排查“为什么捕获不到信号”这类问题时。3. HAL库驱动下的配置全流程与代码逐行解析理论懂了我们上手实战。这里我以STM32CubeIDE和HAL库为例因为这是目前最主流、最快捷的开发方式。我们目标是配置TIM2的通道1来测量一个PWM信号的高电平宽度即上升沿到下降沿的时间。3.1 使用CubeMX进行图形化配置启用定时器时钟在Pinout Configuration的System Core-RCC中根据你的板子配置好高速外部时钟HSE。配置定时器基础参数在Timers中找到TIM2。Clock Source选择Internal Clock。输入捕获是测量外部信号但定时器本身需要内部时钟来驱动计数器。Prescaler预分频器这是决定精度的关键。假设系统主频是72MHz我们希望定时器计数频率为1MHz即每个计数代表1μs。那么预分频值应设置为72MHz / 1MHz - 1 71。HAL库的公式是定时器时钟 系统时钟 / (PSC 1)。Counter Mode选择Up向上计数。Counter Period即ARR设置为最大值65535对于16位定时器。这样一次溢出周期是65.535ms在测量常见PWM信号如50Hz舵机信号时足够用。如果你需要测量更长时间就要结合溢出中断。auto-reload preload通常使能这可以避免在修改ARR时产生毛刺。配置输入捕获通道在TIM2的配置界面切换到Channel1选择Input Capture direct mode。ICPolarity选择Rising Edge我们先捕获上升沿。IC Selection选择Direct。这意味着通道1的信号直接连接到捕获单元。另一种Indirect模式是交叉连接用于特殊场景。IC Prescaler捕获分频器。选择No division每次边沿都捕获。你也可以选择每2次、4次、8次边沿捕获一次用于滤除噪声或测量低频信号。IC Filter输入滤波器。如果信号比较干净设为0不滤波。如果信号有毛刺可以适当增大例如设为4表示以fDTS频率采样4次结果一致才认为有效边沿。配置NVIC嵌套向量中断控制器在NVIC Settings中勾选TIM2 global interrupt。这样定时器溢出更新事件和捕获事件都会触发这个中断。我们需要在中断服务函数里区分它们。更精细的做法是在代码中单独使能捕获比较中断HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1)它会自动配置NVIC。生成代码点击Generate CodeCubeMX会帮你初始化时钟树、GPIO和定时器外设。3.2 关键代码编写与逻辑剖析CubeMX生成的代码搭建了框架但核心逻辑需要我们自己在main.c或单独的模块中实现。// 定义全局变量用于记录状态和时间 volatile uint32_t g_capture_start 0; // 上升沿捕获值 volatile uint32_t g_capture_end 0; // 下降沿捕获值 volatile uint32_t g_capture_overflow 0; // 溢出计数器 volatile uint8_t g_capture_done 0; // 测量完成标志 volatile uint8_t g_is_first_captured 0; // 是否已捕获到上升沿 // 定时器溢出中断回调函数在stm32xx_it.c中HAL库会调用此回调 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2) { g_capture_overflow; // 每次溢出计数器加1 } } // 输入捕获中断回调函数 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { if (g_is_first_captured 0) { // 第一次捕获即上升沿 // 记录上升沿时的“完整时间戳” g_capture_start HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_start (g_capture_overflow 16); // 假设16位定时器组合成扩展值 // 切换为下降沿捕获 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); g_is_first_captured 1; // 标记已捕获上升沿 } else { // 第二次捕获即下降沿 // 记录下降沿时的“完整时间戳” g_capture_end HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_end (g_capture_overflow 16); // 计算高电平脉宽 uint32_t pulse_width_ticks g_capture_end - g_capture_start; // 转换为时间单位微秒假设定时器时钟为1MHz float pulse_width_us (float)pulse_width_ticks; // 因为1 tick 1us // 这里可以将pulse_width_us用于后续处理或者通过串口打印 // 重置状态准备下一次测量 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); g_is_first_captured 0; g_capture_done 1; // 设置完成标志 // 注意这里没有清零g_capture_overflow因为它是一个持续累加的全局时间基准。 // 在长时间测量中只要两次捕获间隔内溢出次数不超过65535次计算就是正确的。 } } } // 主函数中的初始化与启动 int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_TIM2_Init(); // CubeMX生成的初始化函数 // 启动定时器基础计数溢出中断由此使能 HAL_TIM_Base_Start_IT(htim2); // 启动输入捕获中断并指定通道和初始边沿上升沿 HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1); while (1) { if (g_capture_done) { g_capture_done 0; // 处理测量结果例如通过串口打印 // printf(High Level Width: %.2f us\n, pulse_width_us); } // 其他主循环任务 } }代码逻辑深度解析时间戳的组合g_capture_start CCR1值 (g_capture_overflow 16)。这里做了一个简化假设定时器是16位的ARR65535所以一次溢出的“时间长度”是65536个计数。我们将溢出次数左移16位相当于乘以65536再与当前的CCR1值相加就得到了一个扩展的32位时间戳。这是处理溢出的核心思想。动态切换边沿极性这是测量脉宽的标准做法。在上升沿捕获回调中立刻将极性改为下降沿这样硬件就会在下一个下降沿再次触发中断。这种方法比使用两个独立的通道一个抓上升沿一个抓下降沿更节省资源且避免了两个通道间可能存在的微小偏移误差。HAL_TIM_ACTIVE_CHANNEL_1这是一个HAL库宏用于在共用中断服务函数时判断是哪个通道触发了中断。因为多个捕获通道可能共用同一个中断向量。中断服务函数要快进快出在HAL_TIM_IC_CaptureCallback中我们只做了读取寄存器、切换极性、设置标志位等最必要的操作。复杂的计算如单位转换和输出如串口打印应放到主循环中根据标志位来处理避免长时间占用中断影响系统实时性。4. 从测量到应用频率、占空比与高级测量模式掌握了基本脉宽测量我们就可以构建更复杂的应用。4.1 测量信号频率与占空比测量频率通常有两种方法测周法测量一个完整周期的时间即相邻两个同向边沿如上升沿到上升沿的时间T频率f 1 / T。这种方法在低频时精度高。实现上只需在上述脉宽测量代码中将第二次捕获的边沿也设为上升沿即可。测频法在固定闸门时间比如1秒内统计信号上升沿的次数N频率f N。这种方法在高频时精度高但需要另一个定时器来产生精确的闸门信号并在闸门时间内对捕获中断进行计数。测量占空比则需要三个时间点上升沿A下降沿B下一个上升沿C。高电平时间Th B - A周期T C - A占空比Duty (Th / T) * 100%这需要捕获三个边沿逻辑上稍微复杂一些但原理完全相同。你可以使用一个状态机g_capture_state来跟踪当前是第几次捕获并分别记录A、B、C三个时间戳。4.2 使用从模式实现硬件自动测量前面的方法依赖中断和软件计算在测量极高频率的信号时频繁的中断可能成为瓶颈。STM32定时器提供了一个更强大的功能从模式触发。我们可以配置定时器工作在“复位从模式”。将输入捕获通道如TIM2_CH1配置为触发源TRGI并设置为上升沿触发。当上升沿到来时定时器计数器TIMx_CNT会立刻被清零。同时我们启用另一个通道如TIM2_CH2在下降沿捕获。这样当下降沿到来时通道2捕获寄存器CCR2里存储的值直接就是高电平的脉宽计数值完全不需要软件干预和溢出计算配置要点主定时器TIMx的Slave Mode Controller选择Reset Mode。Trigger Source选择TI1FP1即通道1的滤波后信号。通道1配置为输入上升沿触发用于复位CNT。通道2配置为输入捕获下降沿触发用于捕获CNT值。这种方法将整个测量过程硬件化精度和实时性达到极致CPU只在测量完成后去读取一下CCR2寄存器即可。非常适合对实时性要求苛刻的应用。4.3 输入滤波与数字防抖在实际电路中机械开关或长线传输会引入毛刺。定时器的输入滤波器就是第一道硬件防线。前面提到的IC Filter参数其原理是定时器内部有一个以fDTS通常由定时器时钟分频而来频率运行的采样器它会连续采样输入信号N次N为滤波值只有当N次采样结果一致时才认为边沿有效。例如fDTS72MHzFilter4则只有当信号电平稳定至少4 * (1/72MHz) ≈ 55.6ns不变边沿才会被确认。这能有效滤除窄毛刺。注意滤波器会引入固定的延迟。这个延迟在计算绝对时间时需要被考虑虽然通常很小但在测量边沿之间的相对时间如脉宽时只要两个边沿使用相同的滤波器设置延迟就会相互抵消不影响结果。5. 实战调试与常见问题深度排坑理论完美代码写完一上电发现没数据或者数据跳得厉害别急这些都是必经之路。下面是我总结的几个高频问题点和排查思路。5.1 问题一完全捕获不到任何信号排查链路信号是否真的存在这是第一步也是最容易忽略的一步。用示波器或者逻辑分析仪直接测量你连接到STM32引脚上的信号。确认信号电压幅度是否是3.3V CMOS电平、频率是否在预期范围内、是否有明显的畸变。GPIO配置是否正确检查CubeMX或代码中该引脚是否确实配置为了对应定时器的“Alternate Function”模式而不是普通的输入/输出。检查上拉/下拉电阻配置如果外部信号是开漏输出MCU这边可能需要使能内部上拉。定时器时钟是否使能确认__HAL_RCC_TIMx_CLK_ENABLE()被调用CubeMX通常已处理。可以用调试器查看TIMx-CR1寄存器的值确认定时器已使能CEN位为1。中断是否使能检查HAL_TIM_IC_Start_IT()是否被成功调用。在调试器中查看TIMx-DIER寄存器确认CCxIE捕获中断使能和UIE更新中断使能位是否为1。同时检查NVIC确认TIMx_IRQn中断已启用。边沿极性是否设反如果你的信号是低电平有效却配置了上升沿捕获那肯定抓不到。用示波器看边沿方向与代码配置对比。5.2 问题二测量值不稳定跳动很大排查链路信号质量问题再次祭出示波器。观察信号边沿是否陡峭是否有振铃或过冲电源地上是否有噪声不干净的信号是精度杀手。可能需要在硬件上增加RC滤波或施密特触发器整形。定时器时钟源不稳定如果定时器使用的是内部RC振荡器HSI其精度和温漂可能较差。对于高精度测量务必使用外部晶振HSE作为系统时钟源并确保定时器时钟是从PLL稳定分频而来。中断干扰与延迟如果系统中有更高优先级的中断长时间执行可能会延迟输入捕获中断的响应。虽然捕获值由硬件锁存不会丢但中断处理函数中读取溢出计数器的时机可能滞后导致组合时间戳出错。确保捕获中断优先级足够高且中断服务函数执行时间极短。未考虑计数器溢出这是新手最容易栽跟头的地方。如果你的测量时间可能超过(ARR1)/定时器时钟频率就必须实现溢出计数逻辑。检查你的代码是否在更新中断中增加了溢出计数器并且在计算时间戳时是否正确组合了溢出计数和CCRx值。一个简单的验证方法故意输入一个周期很长的信号大于溢出周期看测量结果是否正确。滤波器和分频器设置不当过强的滤波器Filter值过大会扭曲信号的真实边沿位置尤其在信号频率较高时。捕获分频器IC Prescaler如果设成了每N次边沿捕获一次而你以为是每次边沿都捕获也会导致读数成倍数关系错误。5.3 问题三测量值存在固定偏差系统延迟从信号进入引脚到经过输入滤波器、边沿检测器最终触发捕获硬件本身有数个时钟周期的延迟。这个延迟在数据手册的“输入延迟”参数中会有说明通常是ns级别。在绝大多数应用中可以忽略但在纳秒级超精密测量中需要校准。软件开销从捕获发生到进入中断服务函数再到读取CCRx寄存器这中间有中断响应时间由芯片性能和中断优先级决定。这个延迟不影响CCRx寄存器本身的值因为硬件在边沿发生的瞬间就已经把CNT值锁存到CCRx了。软件延迟影响的是你读取溢出计数器的时机。因此务必在捕获中断中第一时间读取CCRx和溢出计数器将它们“绑定”为一个原子操作。一个实用的调试技巧使用定时器本身的PWM输出功能进行自检。用同一个定时器的另一个通道如TIM2_CH2输出一个已知频率和占空比的PWM信号然后将这个输出引脚通过杜邦线短接到输入捕获引脚TIM2_CH1。这样你就可以用输入捕获功能去测量自己产生的信号理论值和测量值应该完全吻合。这是验证整个输入捕获配置和代码逻辑最直接、最可靠的方法。最后关于资源选择对于简单的脉宽或频率测量通用定时器TIM2-TIM5绰绰有余。如果需要同时测量多路信号或者用到互补通道、死区插入等高级功能才会考虑高级定时器TIM1, TIM8。输入捕获功能本身并不复杂其核心在于对硬件自动化的理解和对边界条件尤其是溢出的严谨处理。希望这篇近万字的梳理能帮你把这个“精准掐表”的工具用得得心应手。
1. 从“数数”到“掐表”输入捕获到底在干什么搞嵌入式开发尤其是玩STM32的定时器这个外设绝对是绕不开的核心。PWM输出、延时、计时这些基础功能大家都很熟了。但说到“输入捕获”很多刚上手的朋友可能会觉得有点抽象它到底有什么用简单来说你可以把它理解成一个极其精准的“掐表”工具。想象一下你面前有一个信号发生器它输出一个方波你想知道这个方波的频率是多少或者高电平持续了多长时间。用人眼和普通秒表去测误差太大而且对于微秒μs甚至纳秒ns级别的时间根本无能为力。STM32的定时器输入捕获功能就是为解决这类问题而生的。它能在外部信号的特定边沿比如上升沿或下降沿到来的瞬间像拍照一样“咔嚓”一下把当前定时器的计数值“捕获”并锁存到一个专用的寄存器里。你只需要读取两次捕获值做个减法再结合定时器的计数频率就能精确计算出两次边沿之间的时间间隔。这个功能的应用场景非常广泛。比如测量旋转编码器的转速通过测量脉冲周期、测量超声波测距模块回波的高电平时间、解码红外遥控器的NEC协议测量脉冲宽度、甚至实现一个高精度的频率计。它把时间测量这个事从软件轮询的“苦力活”变成了硬件自动完成的“精细活”不仅精度高还不占用CPU资源。今天我就结合自己这些年调STM32定时器的经验把输入捕获这个功能的里里外外、从配置到避坑给你掰开揉碎了讲清楚。2. 硬件架构与核心寄存器理解“捕获”的物理基础在写代码之前我们必须先搞清楚STM32定时器为了实现输入捕获在硬件上做了哪些设计。这就像开车前得知道油门、刹车、方向盘在哪一样。STM32的通用定时器如TIM2, TIM3, TIM4, TIM5和高级定时器TIM1, TIM8都支持输入捕获功能其核心硬件逻辑围绕几个关键部分展开。2.1 输入通道与捕获/比较寄存器每个定时器通常有4个独立的输入捕获通道CH1-CH4。每个通道都对应着一对“捕获/比较寄存器”比如TIMx_CCR1对应通道1。这个寄存器是“双向”的当通道配置为输出模式时它是比较寄存器用于产生PWM当配置为输入捕获模式时它就变成了捕获寄存器。关键点来了捕获是如何触发的每个输入通道的信号会先经过一个“输入滤波器和边沿检测器”。你可以配置滤波器来消除信号上的毛刺比如设置采样频率和事件次数配置边沿检测器来指定在信号的上升沿、下降沿还是双边沿触发捕获。当指定的边沿事件发生时硬件会立刻执行一个原子操作将当前定时器计数器TIMx_CNT的值复制到对应的捕获/比较寄存器TIMx_CCRx中。同时硬件会置位一个标志位TIMx_SR寄存器中的CCxIF位如果使能了中断或DMA还会产生相应的请求。这个过程完全由硬件完成速度极快精度只取决于定时器的时钟基准。2.2 定时器计数模式与溢出处理输入捕获的精度和量程直接依赖于定时器计数器TIMx_CNT的工作方式。最常用的模式是向上计数模式计数器从0开始每个时钟周期加1一直加到自动重装载值TIMx_ARR然后产生溢出事件并清零重新开始。这里就引出了输入捕获测量中的一个经典问题如何测量长于一次定时器溢出周期的时间例如定时器ARR设为65535时钟频率为1MHz那么一次溢出的周期是65.535ms。如果你要测一个100ms的脉冲宽度计数器肯定会溢出至少一次。解决方案是结合溢出中断。我们可以在使能捕获中断的同时也使能定时器的更新溢出中断。在更新中断服务函数里对一个全局的溢出计数器比如capture_overflow_count进行加1。这样当我们捕获到上升沿和下降沿时得到的就不仅仅是CCRx寄存器的值而是一个“扩展”的时间值总时间 溢出次数 * (ARR 1) 第二次捕获值 - 第一次捕获值。这里有个细节需要注意捕获值是在溢出前还是溢出后读取的如果第一次捕获发生在计数器为60000时然后计数器溢出归零又在1000时发生第二次捕获。单纯用1000 - 60000会得到一个负数在无符号数运算中会变成一个很大的正数结果显然是错的。因此我们的计算必须考虑溢出计数器的状态。通常的逻辑是在捕获中断里除了读取CCRx还要立刻读取当前的溢出计数器值共同组成一个完整的时间戳。2.3 输入通道与GPIO的映射关系这不是软件配置而是硬件设计。STM32的定时器输入通道对应的GPIO引脚是固定的你需要查阅芯片的数据手册Datasheet或引脚复用映射表Alternate Function Mapping来确定。例如TIM2的通道1可能对应PA0、PA5或PA15具体是哪个取决于你的芯片型号和封装。在CubeMX工具里这个选择是可视化的但理解其背后的硬件连接依然重要尤其是在排查“为什么捕获不到信号”这类问题时。3. HAL库驱动下的配置全流程与代码逐行解析理论懂了我们上手实战。这里我以STM32CubeIDE和HAL库为例因为这是目前最主流、最快捷的开发方式。我们目标是配置TIM2的通道1来测量一个PWM信号的高电平宽度即上升沿到下降沿的时间。3.1 使用CubeMX进行图形化配置启用定时器时钟在Pinout Configuration的System Core-RCC中根据你的板子配置好高速外部时钟HSE。配置定时器基础参数在Timers中找到TIM2。Clock Source选择Internal Clock。输入捕获是测量外部信号但定时器本身需要内部时钟来驱动计数器。Prescaler预分频器这是决定精度的关键。假设系统主频是72MHz我们希望定时器计数频率为1MHz即每个计数代表1μs。那么预分频值应设置为72MHz / 1MHz - 1 71。HAL库的公式是定时器时钟 系统时钟 / (PSC 1)。Counter Mode选择Up向上计数。Counter Period即ARR设置为最大值65535对于16位定时器。这样一次溢出周期是65.535ms在测量常见PWM信号如50Hz舵机信号时足够用。如果你需要测量更长时间就要结合溢出中断。auto-reload preload通常使能这可以避免在修改ARR时产生毛刺。配置输入捕获通道在TIM2的配置界面切换到Channel1选择Input Capture direct mode。ICPolarity选择Rising Edge我们先捕获上升沿。IC Selection选择Direct。这意味着通道1的信号直接连接到捕获单元。另一种Indirect模式是交叉连接用于特殊场景。IC Prescaler捕获分频器。选择No division每次边沿都捕获。你也可以选择每2次、4次、8次边沿捕获一次用于滤除噪声或测量低频信号。IC Filter输入滤波器。如果信号比较干净设为0不滤波。如果信号有毛刺可以适当增大例如设为4表示以fDTS频率采样4次结果一致才认为有效边沿。配置NVIC嵌套向量中断控制器在NVIC Settings中勾选TIM2 global interrupt。这样定时器溢出更新事件和捕获事件都会触发这个中断。我们需要在中断服务函数里区分它们。更精细的做法是在代码中单独使能捕获比较中断HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1)它会自动配置NVIC。生成代码点击Generate CodeCubeMX会帮你初始化时钟树、GPIO和定时器外设。3.2 关键代码编写与逻辑剖析CubeMX生成的代码搭建了框架但核心逻辑需要我们自己在main.c或单独的模块中实现。// 定义全局变量用于记录状态和时间 volatile uint32_t g_capture_start 0; // 上升沿捕获值 volatile uint32_t g_capture_end 0; // 下降沿捕获值 volatile uint32_t g_capture_overflow 0; // 溢出计数器 volatile uint8_t g_capture_done 0; // 测量完成标志 volatile uint8_t g_is_first_captured 0; // 是否已捕获到上升沿 // 定时器溢出中断回调函数在stm32xx_it.c中HAL库会调用此回调 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2) { g_capture_overflow; // 每次溢出计数器加1 } } // 输入捕获中断回调函数 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { if (g_is_first_captured 0) { // 第一次捕获即上升沿 // 记录上升沿时的“完整时间戳” g_capture_start HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_start (g_capture_overflow 16); // 假设16位定时器组合成扩展值 // 切换为下降沿捕获 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); g_is_first_captured 1; // 标记已捕获上升沿 } else { // 第二次捕获即下降沿 // 记录下降沿时的“完整时间戳” g_capture_end HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); g_capture_end (g_capture_overflow 16); // 计算高电平脉宽 uint32_t pulse_width_ticks g_capture_end - g_capture_start; // 转换为时间单位微秒假设定时器时钟为1MHz float pulse_width_us (float)pulse_width_ticks; // 因为1 tick 1us // 这里可以将pulse_width_us用于后续处理或者通过串口打印 // 重置状态准备下一次测量 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); g_is_first_captured 0; g_capture_done 1; // 设置完成标志 // 注意这里没有清零g_capture_overflow因为它是一个持续累加的全局时间基准。 // 在长时间测量中只要两次捕获间隔内溢出次数不超过65535次计算就是正确的。 } } } // 主函数中的初始化与启动 int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_TIM2_Init(); // CubeMX生成的初始化函数 // 启动定时器基础计数溢出中断由此使能 HAL_TIM_Base_Start_IT(htim2); // 启动输入捕获中断并指定通道和初始边沿上升沿 HAL_TIM_IC_Start_IT(htim2, TIM_CHANNEL_1); while (1) { if (g_capture_done) { g_capture_done 0; // 处理测量结果例如通过串口打印 // printf(High Level Width: %.2f us\n, pulse_width_us); } // 其他主循环任务 } }代码逻辑深度解析时间戳的组合g_capture_start CCR1值 (g_capture_overflow 16)。这里做了一个简化假设定时器是16位的ARR65535所以一次溢出的“时间长度”是65536个计数。我们将溢出次数左移16位相当于乘以65536再与当前的CCR1值相加就得到了一个扩展的32位时间戳。这是处理溢出的核心思想。动态切换边沿极性这是测量脉宽的标准做法。在上升沿捕获回调中立刻将极性改为下降沿这样硬件就会在下一个下降沿再次触发中断。这种方法比使用两个独立的通道一个抓上升沿一个抓下降沿更节省资源且避免了两个通道间可能存在的微小偏移误差。HAL_TIM_ACTIVE_CHANNEL_1这是一个HAL库宏用于在共用中断服务函数时判断是哪个通道触发了中断。因为多个捕获通道可能共用同一个中断向量。中断服务函数要快进快出在HAL_TIM_IC_CaptureCallback中我们只做了读取寄存器、切换极性、设置标志位等最必要的操作。复杂的计算如单位转换和输出如串口打印应放到主循环中根据标志位来处理避免长时间占用中断影响系统实时性。4. 从测量到应用频率、占空比与高级测量模式掌握了基本脉宽测量我们就可以构建更复杂的应用。4.1 测量信号频率与占空比测量频率通常有两种方法测周法测量一个完整周期的时间即相邻两个同向边沿如上升沿到上升沿的时间T频率f 1 / T。这种方法在低频时精度高。实现上只需在上述脉宽测量代码中将第二次捕获的边沿也设为上升沿即可。测频法在固定闸门时间比如1秒内统计信号上升沿的次数N频率f N。这种方法在高频时精度高但需要另一个定时器来产生精确的闸门信号并在闸门时间内对捕获中断进行计数。测量占空比则需要三个时间点上升沿A下降沿B下一个上升沿C。高电平时间Th B - A周期T C - A占空比Duty (Th / T) * 100%这需要捕获三个边沿逻辑上稍微复杂一些但原理完全相同。你可以使用一个状态机g_capture_state来跟踪当前是第几次捕获并分别记录A、B、C三个时间戳。4.2 使用从模式实现硬件自动测量前面的方法依赖中断和软件计算在测量极高频率的信号时频繁的中断可能成为瓶颈。STM32定时器提供了一个更强大的功能从模式触发。我们可以配置定时器工作在“复位从模式”。将输入捕获通道如TIM2_CH1配置为触发源TRGI并设置为上升沿触发。当上升沿到来时定时器计数器TIMx_CNT会立刻被清零。同时我们启用另一个通道如TIM2_CH2在下降沿捕获。这样当下降沿到来时通道2捕获寄存器CCR2里存储的值直接就是高电平的脉宽计数值完全不需要软件干预和溢出计算配置要点主定时器TIMx的Slave Mode Controller选择Reset Mode。Trigger Source选择TI1FP1即通道1的滤波后信号。通道1配置为输入上升沿触发用于复位CNT。通道2配置为输入捕获下降沿触发用于捕获CNT值。这种方法将整个测量过程硬件化精度和实时性达到极致CPU只在测量完成后去读取一下CCR2寄存器即可。非常适合对实时性要求苛刻的应用。4.3 输入滤波与数字防抖在实际电路中机械开关或长线传输会引入毛刺。定时器的输入滤波器就是第一道硬件防线。前面提到的IC Filter参数其原理是定时器内部有一个以fDTS通常由定时器时钟分频而来频率运行的采样器它会连续采样输入信号N次N为滤波值只有当N次采样结果一致时才认为边沿有效。例如fDTS72MHzFilter4则只有当信号电平稳定至少4 * (1/72MHz) ≈ 55.6ns不变边沿才会被确认。这能有效滤除窄毛刺。注意滤波器会引入固定的延迟。这个延迟在计算绝对时间时需要被考虑虽然通常很小但在测量边沿之间的相对时间如脉宽时只要两个边沿使用相同的滤波器设置延迟就会相互抵消不影响结果。5. 实战调试与常见问题深度排坑理论完美代码写完一上电发现没数据或者数据跳得厉害别急这些都是必经之路。下面是我总结的几个高频问题点和排查思路。5.1 问题一完全捕获不到任何信号排查链路信号是否真的存在这是第一步也是最容易忽略的一步。用示波器或者逻辑分析仪直接测量你连接到STM32引脚上的信号。确认信号电压幅度是否是3.3V CMOS电平、频率是否在预期范围内、是否有明显的畸变。GPIO配置是否正确检查CubeMX或代码中该引脚是否确实配置为了对应定时器的“Alternate Function”模式而不是普通的输入/输出。检查上拉/下拉电阻配置如果外部信号是开漏输出MCU这边可能需要使能内部上拉。定时器时钟是否使能确认__HAL_RCC_TIMx_CLK_ENABLE()被调用CubeMX通常已处理。可以用调试器查看TIMx-CR1寄存器的值确认定时器已使能CEN位为1。中断是否使能检查HAL_TIM_IC_Start_IT()是否被成功调用。在调试器中查看TIMx-DIER寄存器确认CCxIE捕获中断使能和UIE更新中断使能位是否为1。同时检查NVIC确认TIMx_IRQn中断已启用。边沿极性是否设反如果你的信号是低电平有效却配置了上升沿捕获那肯定抓不到。用示波器看边沿方向与代码配置对比。5.2 问题二测量值不稳定跳动很大排查链路信号质量问题再次祭出示波器。观察信号边沿是否陡峭是否有振铃或过冲电源地上是否有噪声不干净的信号是精度杀手。可能需要在硬件上增加RC滤波或施密特触发器整形。定时器时钟源不稳定如果定时器使用的是内部RC振荡器HSI其精度和温漂可能较差。对于高精度测量务必使用外部晶振HSE作为系统时钟源并确保定时器时钟是从PLL稳定分频而来。中断干扰与延迟如果系统中有更高优先级的中断长时间执行可能会延迟输入捕获中断的响应。虽然捕获值由硬件锁存不会丢但中断处理函数中读取溢出计数器的时机可能滞后导致组合时间戳出错。确保捕获中断优先级足够高且中断服务函数执行时间极短。未考虑计数器溢出这是新手最容易栽跟头的地方。如果你的测量时间可能超过(ARR1)/定时器时钟频率就必须实现溢出计数逻辑。检查你的代码是否在更新中断中增加了溢出计数器并且在计算时间戳时是否正确组合了溢出计数和CCRx值。一个简单的验证方法故意输入一个周期很长的信号大于溢出周期看测量结果是否正确。滤波器和分频器设置不当过强的滤波器Filter值过大会扭曲信号的真实边沿位置尤其在信号频率较高时。捕获分频器IC Prescaler如果设成了每N次边沿捕获一次而你以为是每次边沿都捕获也会导致读数成倍数关系错误。5.3 问题三测量值存在固定偏差系统延迟从信号进入引脚到经过输入滤波器、边沿检测器最终触发捕获硬件本身有数个时钟周期的延迟。这个延迟在数据手册的“输入延迟”参数中会有说明通常是ns级别。在绝大多数应用中可以忽略但在纳秒级超精密测量中需要校准。软件开销从捕获发生到进入中断服务函数再到读取CCRx寄存器这中间有中断响应时间由芯片性能和中断优先级决定。这个延迟不影响CCRx寄存器本身的值因为硬件在边沿发生的瞬间就已经把CNT值锁存到CCRx了。软件延迟影响的是你读取溢出计数器的时机。因此务必在捕获中断中第一时间读取CCRx和溢出计数器将它们“绑定”为一个原子操作。一个实用的调试技巧使用定时器本身的PWM输出功能进行自检。用同一个定时器的另一个通道如TIM2_CH2输出一个已知频率和占空比的PWM信号然后将这个输出引脚通过杜邦线短接到输入捕获引脚TIM2_CH1。这样你就可以用输入捕获功能去测量自己产生的信号理论值和测量值应该完全吻合。这是验证整个输入捕获配置和代码逻辑最直接、最可靠的方法。最后关于资源选择对于简单的脉宽或频率测量通用定时器TIM2-TIM5绰绰有余。如果需要同时测量多路信号或者用到互补通道、死区插入等高级功能才会考虑高级定时器TIM1, TIM8。输入捕获功能本身并不复杂其核心在于对硬件自动化的理解和对边界条件尤其是溢出的严谨处理。希望这篇近万字的梳理能帮你把这个“精准掐表”的工具用得得心应手。
