简介：STM32F407定时器输入捕获脉冲计数工程资源，面向嵌入式开发者和需要测量转速、频率等信号的工程人员，适用于电机测速、流量计脉冲累计等场景。资源从定时器结构入手，讲解预分频器、计数器、捕获/比较通道的用法，并给出基于HAL库的完整实现步骤：选择定时器、初始化、配置输入滤波器、设置捕获边沿、使能中断以及编写回调函数。压缩包共689个文件、约6.84MB，包含C源文件与H头文件、uvproj/uvopt工程文件，以及hex、map、axf等编译输出、PDF说明和预处理脚本，便于直接查看工程结构或重新编译验证。已有4122人学习，适合正在学习STM32定时器捕获功能、需要快速搭建脉冲计数应用的开发者。 最近做项目遇到一个需求：统计流量计输出的脉冲个数，用来换算累积流量。STM32F407作为主控，脉冲计数这个功能说简单很简单，说深了也能挖出不少门道。一开始我打算用外部中断在回调里++，后来一算脉冲频率和中断开销，果断回头用定时器硬件计数。这篇就把整个方案选型、定时器外部时钟模式的原理、CubeMX配置和代码实现完整梳理一遍，顺便把调试时踩过的几个坑也一并列出来，给要搞外部脉冲计数的朋友做个参考。
1. 项目背景与方案选型
1.1 适用场景：不只是流量计，脉冲计数无处不在
外部脉冲计数在工业、仪器仪表、电机控制里非常常见。我这次接的传感器是涡街流量计，输出的是方波脉冲，频率范围从几赫兹到几千赫兹，频率越高代表流量越大。除了流量计，光电编码器测转速、霍尔传感器测电机位置、光电开关统计产线上经过的工件数量，本质上都是"数脉冲"。只要传感器把物理量转成了开关信号或者方波，MCU要做的第一件事就是把这些脉冲可靠地数下来。
STM32F407常用在需要一定算力、但又不至于上Linux这么复杂的场景，它本身有14个定时器（含高级定时器），每个定时器基本都支持外部时钟输入，这为脉冲计数提供了很好的硬件基础。换句话说，用这款芯片做计数，没有理由把手动变量计数当作主力方案。
1.2 三种计数方案横向对比
我在做这个项目前，把常见的脉冲计数方案和适用条件整理了一下：
| 方案 | 原理 | 最大频率 | CPU负担 | 适用场景 |
|---|---|---|---|---|
| 外部中断+变量计数 | GPIO下降沿/上升沿触发中断，中断服务程序里 count++ | 受限于中断响应时间，通常<10kHz 才稳 | 高，频繁进出中断 | 低频按键、极慢脉冲、临时验证 |
| 定时器输入捕获 | 定时器通道捕获边沿，读取CNT值计算周期 | 较高，适合测频率/周期 | 低，但需要软件处理捕获事件 | 测量脉冲频率、占空比、周期 |
| 定时器外部时钟模式 | ETR引脚或通道信号直接作为定时器时钟源，硬件自动计数 | 高，理论可达几十MHz | 极低，CPU零负担 | 精确脉冲累加、高频计数 |
我做流量累计计数，要的是"一个脉冲都不丢"的累积值，外部时钟模式是最合适的。输入捕获更适合测频率，不用每次捕获都算一次差值。外部中断方案在脉冲频率超过一定值后，中断嵌套或者主循环关中断都会导致丢数，除非用状态机加DMA去榨干中断极限，否则工程上不建议把它用于生产环境。
1.3 为什么首选定时器外部时钟模式
定时器外部时钟模式的核心思想是：外部脉冲不是"通知CPU"，而是直接作为计数器时钟引脚上的有效沿。计数器在硬件层面被脉冲驱动递增，整个过程CPU完全不需要参与。这有两个好处：一是CPU可以专心做其他事情，比如跑显示刷新、处理通信；二是在脉冲频率很高时不会因为中断响应不及时而丢脉冲。
从设计角度看，这种做法把"数数"这件事从软件移到了硬件，符合嵌入式开发里"能用外设完成的不用软件"的原则。尤其对STM32F407这种外设丰富的芯片来说，定时器本身就是为了这类任务设计的，放着现成的硬件能力不用，反而用CPU轮询或者中断去数，不仅效率低，精度也打折扣。
2. STM32F407定时器外部时钟原理
2.1 外部时钟模式1与模式2的差异
STM32F4的定时器外部时钟输入有两条路径。外部时钟模式1（External Clock Mode 1）是把外部信号（通常来自某个通道输入或者ETR引脚）通过触发选择（TS位）引入从模式控制器，再由从模式计数器产生时钟。外部时钟模式2（External Clock Mode 2）更直接：ETR引脚信号经过配置后直接送给计数器作为时钟，不经过从模式的复杂分发。
我这次用的是外部时钟模式2，因为ETR到计数器的路径最短，配置也最直观。模式1往往要同时搭配编码器模式或者特殊的从模式功能，如果只做单纯的高速脉冲计数，模式2完全够了。
2.2 ETR信号通路上的几个环节
ETR引脚进来的信号，不是直接接到计数器时钟端的。中间依次经过极性选择、分频器和数字滤波器。如下图（简化描述）：外部脉冲先进输入滤波器，然后经过预分频器（无分频/2分频/4分频/8分频），再经过极性选择（上升沿或下降沿有效），最后才成为计数器的时钟。每个环节都可以独立配置，这带来很大的灵活性。
数字滤波器值得多说两句。STM32F407的定时器在SMCR寄存器里有ETF字段，可以配置对输入信号进行采样滤波。原理是用一个较高频率的采样时钟去反复采样输入信号，只有连续N次都采到同一电平，才认为电平发生了跳变，从而把毛刺滤掉。这个功能对工业现场的传感器信号非常有用——现场经常有电磁干扰或者线缆耦合产生的尖峰，不加滤波的话，一个毛刺就多计一个数，累积误差很可观的。
2.3 滤波参数和分频参数怎么算
滤波参数直接影响最大可靠计数频率。比如我配置ETF=0b1101时，采样时钟是fDTS/32，连续5次采样结果一致才判定跳变。定时器时钟设为84MHz时，fDTS/32约2.6MHz，5次采样大约需要1.9微秒，意味着脉宽小于1.9微秒的窄脉冲会被滤掉。我得先确认传感器的最大脉冲频率和占空比，再决定滤波深度。比如最高10kHz的脉冲，周期100微秒，脉宽怎么也有几十微秒，用这个滤波参数绰绰有余。
分频器则是把ETR输入先分频再送给计数器。如果传感器输出频率实在太高，计数器的最高时钟又受限，可以通过分频来降低计数时钟频率，代价就是每个计数代表多个外部脉冲。我在这个项目里用不到分频，保持1分频。
还有一个很多人忽略的重点：STM32F407的APB1定时器时钟不一定等于APB1总线时钟。系统初始化默认AHB=168MHz，APB1=42MHz，但APB1预分频器为4时，定时器时钟自动翻倍为84MHz。查代码时要注意确认PCLK1和Fpclk1的区别，否则算出的定时器时间基准可能错一半。
3. 硬件连接与CubeMX配置
3.1 引脚选择与信号调理电路
STM32F407上可作ETR的引脚有好几个：TIM1的PA12、TIM2的PA0/PA5、TIM3的PD2、TIM4的PE0、TIM8的PA0等。我用的是TIM2，ETR引脚是PA0。选这个还有一个原因：TIM2是32位定时器，如果不做溢出扩展，计数器可以直接计到4字边界，省去溢出处理的麻烦。不过为了演示通用的做法，我在下面还是按16位模式配合溢出累加来讲，实际项目我也确实用了溢出累加来实现32位计数。
传感器输出是5V的TTL脉冲，MCU引脚是3.3V耐压，所以不能直接怼到PA0上。我用了最简单的电阻分压：10k串联加5.1k对地分压，把5V变成约3.3V。如果信号源和MCU之间距离比较长，或者现场干扰大，更推荐用光耦隔离加施密特触发器整形。光电开关和流量计这类工业传感器输出通常已经集成了OC门输出，需要在外部加上拉。
3.2 CubeMX里定时器时钟源配置
在STM32CubeMX中配置很简单。选好芯片型号和引脚后，左侧Categories里找到Timers下的TIM2，把Clock Source从Disable改成ETR2 Clock Mode。这个时候PA0引脚自动变成复用功能，复用号是AF1。
左侧配置界面会多出几个参数：
- ETR Pre-scaler：选择
No Division，保持1分频 - ETR Polarity：选择
Rising Edge，因为我只需要上升沿计数 - ETR Filter：我配置为
0x0D，取值根据上节滤波计算 - Counter Period（ARR）：填65535，使用16位自动重装载
- Prescaler（PSC）：填0，外部时钟本身就带频率，不需要再分频
还要在NVIC设置里使能TIM2全局中断。虽然计数过程不需要CPU参与，但16位计数器溢出时需要一个中断把溢出的次数记下来。CubeMX自动生成的时钟树不用改，只要确认定时器时钟确实是84MHz。
3.3 关键参数计算与验证
以10kHz最大脉冲输入、占空比50%为例，脉宽是50微秒。如果滤波器用0x0D，需要的有效脉冲宽度约1.9微秒，远小于50微秒，可以正确识别。计满65536个脉冲需要约6.5秒，更新中断频率约0.15Hz，对CPU来说微不足道。如果输入频率降到1Hz，溢出中断变成每18小时一次，就更不用担心了。
如果传感器是机械触点输出，比如继电器触点、按钮，那滤波深度建议加大，甚至可以在硬件上加一个RC低通，比如1k电阻和100nF电容，截止频率约1.6kHz，可以吸收大部分触点抖动。这个时候滤波参数反而要宽松一点，以免把正常脉冲滤掉。
4. 代码实现与实战解析
4.1 基于HAL库的初始化流程
CubeMX生成工程后，核心初始化代码大概是这样：
TIM_ClockConfigTypeDef sClockSourceConfig = {0}; TIM_MasterConfigTypeDef sMasterConfig = {0}; htim2.Instance = TIM2; htim2.Init.Prescaler = 0; htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 0xFFFF; htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE; HAL_TIM_Base_Init(&htim2); sClockSourceConfig.ClockSource = TIM_CLOCKSOURCE_ETRMODE2; sClockSourceConfig.ClockPolarity = TIM_CLOCKPOLARITY_RISING; sClockSourceConfig.ClockPrescaler = TIM_CLOCKPRESCALER_DIV1; sClockSourceConfig.ClockFilter = 0x0D; HAL_TIM_ConfigClockSource(&htim2, &sClockSourceConfig); sMasterConfig.MasterOutputTrigger = TIM_TRGO_RESET; sMasterConfig.MasterSlaveMode = TIM_MASTERSLAVEMODE_DISABLE; HAL_TIMEx_MasterConfigSynchronization(&htim2, &sMasterConfig);这里最关键的调用是HAL_TIM_ConfigClockSource，它会往TIM2的SMCR寄存器写入ECE=1，同时把滤波、极性和分频配置一并写入。执行完这一步，TIM2的计数器就已经可以被外部脉冲驱动了。sMasterConfig这部分是定时器的主模式配置，不搞同步触发就保持默认即可。
4.2 计数器启动与16位溢出扩展
启动定时器用：
HAL_TIM_Base_Start_IT(&htim2);_IT后缀表示启动的同时开启更新中断。这个更新中断来通知"16位计数器溢出了一次"，也就是数满65536个脉冲。我在工程里定义了一个全局变量：
static volatile uint32_t overflow_cnt = 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { overflow_cnt++; } }读取当前总计数时，要把溢出次数和计数器当前值合并成一个32位数：
uint32_t get_pulse_count(void) { uint32_t cnt; __disable_irq(); cnt = overflow_cnt * 65536u + __HAL_TIM_GET_COUNTER(&htim2); __enable_irq(); return cnt; }读取之前临时关一下中断，主要为了防止在读写两个字的时候恰好溢出中断进来，造成高低16位对不上。实际运行中这个关中断时间只有几百纳秒，脉冲计数几乎不会受影响。
4.3 超过32位的长周期计数方案
如果项目需要连续运行几个月，一个32位变量可能还不够。比如10kHz连续计数，每天约8.6亿次，32位无符号整数最多约4.29亿次，不到半天就溢出了。这个时候需要把overflow_cnt再扩展成64位，读取时依然延续中断里累加、主函数里合并的思路。64位能表达的脉冲数量足够用到设备报废。
还有一种更"懒"的做法：直接利用TIM2的32位模式，也就是把ARR设为0xFFFFFFFF，计数器一次循环就是42亿多，除非高频几十kHz跑几天，否则一辈子都溢出不了一次。但缺点是ARR变大后更新中断几乎不会触发，无法自动记录更大的量程，适合只在自己程序里短期读取的场景。
4.4 准确的清零与定时读取
流量累计需要定时读取并换算成累计量。比如每秒读一次：
uint32_t last_cnt = 0; void interval_read(void) { uint32_t now_cnt = get_pulse_count(); uint32_t diff = now_cnt - last_cnt; // 两个无符号整数相减照样得到差值，哪怕发生了回绕 last_cnt = now_cnt; // diff 除以固定时间窗口，就是这1秒内的平均脉冲频率 }这里用无符号数相减，巧妙地规避了回绕问题：不管now_cnt是否比last_cnt小，只要两次读取间隔不超过计数器最大量程，相减得到的差值就是正确的增量。我一开始没意识到这点，还在想办法处理回绕，后来想明白无符号回绕特性后，代码直接简化为一行。
如果需要清零，直接重新初始化定时器就行：
__HAL_TIM_SET_COUNTER(&htim2, 0); overflow_cnt = 0;不过要注意，清零和读取都要暂时关中断，避免竞争。
5. 常见问题与调试心得
5.1 计数结果漂移，先怀疑信号完整性
我调试过程中遇到最典型的问题：用手头信号发生器给脉冲，计数基本准确；一接现场的传感器，计数就开始时不时跳变，多次测试结果不一致。排查到最后，发现是传感器的OC门输出上拉电阻太大，线与电缆电容形成RC延迟，导致边沿很缓，接近MCU输入阈值区时被噪声反复触发。
这类问题有固定的排查顺序：先用示波器看ETR引脚的波形，确认上升沿是否干净、幅度是否接近3.3V、有没有振铃；再用万用表确认静态电平；最后才是调整滤波参数。顺序很重要，不要一上来就调滤波，波形本身有问题，滤波只能拖延问题。
5.2 高频脉冲丢失的排查思路
如果确认波形没问题，但高频率时计数偏少，那就要看滤波参数是不是太重了。滤波器本质是有限带宽的低通，滤掉毛刺的同时也限制了最高可识别频率。比如我上面算的0x0D约1.9微秒响应，对10kHz没问题，但对200kHz的脉冲（脉宽2.5微秒）就有些勉强了。可以把滤波改小一档，或者干脆旁路滤波器，让信号直通。
另外检查一下APB1定时器时钟是否真的是84MHz。有次我把系统时钟从168MHz改到了120MHz，APB1变化后定时器时钟也跟着变，但滤波参数对应的绝对时间变了，计数在高频区就开始出错。这种问题不仔细查很难发现，因为低速时一切正常。
5.3 外部中断方案和硬件计数的取舍
有朋友问我：脉冲频率不高时，外部中断+count++不是更省事吗？确实，频率很低、CPU负载又很轻的场景下，这样做代码最直观。但要注意，外部中断方案有一个隐患：主程序中如果长时间关中断（比如Flash写入操作），脉冲就会在不经意间丢掉。硬件计数则完全没有这个问题，脉冲沿直接作用于定时器硬件，关中断期间计数照常进行。
我给自己定了一个简单原则：只要脉冲来源是真实世界的传感器，不管频率高低，一律用定时器外部时钟模式。这样做的额外好处是，后续如果频率需求提升，软件无需大改。
5.4 简化调试的几个小技巧
调试过程中我做了几个辅助功能，大大提升了效率。一是用DAC输出当前计数值的低8位，在示波器上能看到计数作阶梯波，直观判断是否在递增。二是把溢出中断嵌套一个秒脉冲中断，每秒把计数差值发送到串口，在电脑上就能隔空观察计数连续性。三是故意接入一个已知频率信号，比如从系统时钟分频出来的1kHz，验证整个链路的准确性。
这些小技巧并不复杂，但能把"计数到底准不准"这个问题从感觉变成数据，调试效率提高不少。
最后分享一个实际操作里的体会：外部脉冲计数这种功能，难度不在配置那几行代码，而在对信号通路和定时器内部机制的理解。搞懂了ETR滤波、时钟分频和计数器更新中断之间的关系，后面不管做流量累计、电机测速还是产线计数，都是同一套思路的迁移。如果只把注意力放在"能数出来就行"，等现场出现干扰或者温度漂移导致计数异常时，再去排查就晚了。做嵌入式很多时候就是这样，硬件原理越扎实，调试越轻松。
本文还有配套的精品资源，点击获取
