1. 功能库做外部时钟计数:遮挡一次CNT+1,什么时候Num才动
功能库在STM32标准外设库里的用法,最容易被低估的是定时器外部时钟这一路:它不靠内部定时走秒,而是把外部遮挡或脉冲接到定时器外部时钟通道,让CNT按事件加一,再由更新中断把CNT的进位累到Num。很多人第一次看屏幕,会以为CNT加一就是遮挡次数,实际CNT只是当前窗口,Num才是累计。某实验室做遮挡计数小工具时,OLED上同时摆出Num和CNT,就是为了把“事件有没有进来”和“累计有没有进位”分开看。这套做法适合课程作业、设备调试、低速脉冲计数,不适合拿来做高精度频率测量或强实时控制。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 功能库选型与外部时钟链路:预分频、边沿和CNT的关系
2.1 外部时钟不是内部定时:遮挡事件如何变成CNT+1
先把链路讲清楚:外部信号从定时器的外部时钟入口进来,经过边沿检测,决定上升沿算一次还是下降沿算一次;再经过预分频,决定每来多少个事件让CNT加一;CNT到重装值后产生更新事件,硬件把CNT重新装回初值,同时如果更新中断使能了,就进入TIM2_IRQHandler。这条链路上任何一项配错,屏幕上的现象都不是“传感器坏了”,而是计数节奏不对。
不设置预分频的前提下,遮挡一次,CNT加一,遮挡几次就加几。这个现象对应的是外部事件和CNT一一对应。一旦预分频被设成非1,遮挡三次可能CNT才加一,看起来像“灵敏度下降”,实际是功能库把外部事件分频了。CNT加到9后再来一个事件,CNT回到0,Num加一;这不是Num++把CNT清零,而是更新事件到了,硬件重装CNT,中断里只负责把Num累加。
为什么这类小工具优先用标准外设库,而不是一上来手写寄存器?因为Timer_Init、Timer_GetCounter、TIM_GetITStatus这些函数把初始化、读数、中断标志判断封装成了可读的调用,课程作业和调试工具最怕的是“寄存器位看漏了”,库函数至少让配置项有名字可核对。代价是抽象层多,Timer_Init内部漏配一项,主函数看起来完全正常,现象却会翻车。所以选型理由不是“库函数更高级”,而是这类低速计数场景更看重可读、可改、可交接。
2.2 Timer_Init配置核对表:材料没展开的内部,按这六项逐条对
主函数里只看到Timer_Init();,真正决定现象的是它内部的配置。下面这张表是我在板子上逐项对过的顺序,具体值以工程里的Timer_Init为准,不要照搬一个来路不明的初始化代码。
| 配置项 | 目的 | 对应现象 | 常见误设 |
|---|---|---|---|
| 外部时钟源选择 | 让定时器走外部事件,而不是内部时钟 | 遮挡后CNT才动 | 仍选内部时钟,CNT自己走 |
| 边沿极性 | 决定遮挡一次算一个边沿还是两个边沿 | 一次遮挡CNT+1或+2 | 设成双边沿,机械抖动被算两次 |
| 预分频 | 决定多少个外部事件让CNT+1 | 不设置时遮挡一次+1 | 设了分频,遮挡多次才+1 |
| 计数重装值 | 决定CNT在哪个窗口回零 | CNT到9后再来一个回0 | 重装值和预期窗口不一致 |
| 更新中断使能 | 让CNT进位时进中断累加Num | Num在CNT回零时加一 | 中断没开,Num永远不动 |
| 外部引脚/复用 | 让遮挡信号真的进到定时器 | 遮挡完全无反应 | 引脚没配成定时器外部时钟入口 |
这张表不用一次全改。我的习惯是先只让CNT动:外部时钟源、边沿、预分频、引脚复用先对;确认遮挡一次CNT加一之后,再开更新中断看Num。这样一旦现象不对,排查范围小。预分频参数怎么设?在不设置预分频的前提下,遮挡一次CNT+1,这是最直观的基准。要降低计数灵敏度,再把预分频往上加,每加一级,遮挡事件被分掉一部分,CNT的变化会变粗。边沿极性也一样:单边沿适合机械遮挡,双边沿会把一次遮挡的按下和回弹都算进去,除非你明确要测两个边沿。
2.3 为什么先跑通CNT再加Num:最小验证路径
我一般不让新手一上来就连中断。先跑通CNT,等于先确认“外部事件进得来”;再加Num,等于确认“进位中断进得去”。最小验证路径可以按下面走:
- 只初始化OLED和定时器,主循环只显示
Timer_GetCounter(),先不写中断函数。 - 上电不遮挡,确认CNT稳定在0,不会自己往上跑。
- 遮挡一次,确认CNT从0变1;再遮挡一次,确认变2。
- 连续遮挡到9,确认CNT显示9;再遮挡一次,确认CNT回0。此时Num还没加,屏幕上的Num保持0是正常的。
- 打开更新中断,补上
Num++,重复第4步,确认CNT回0时Num变1。 - 再遮挡一次,确认CNT从0变1、Num保持1,说明窗口计数和累计计数分开了。
这条路径的好处是把“CNT不动”和“Num不动”分开。CNT不动,查外部时钟源、边沿、引脚;CNT动但Num不动,查更新中断使能和中断函数;CNT和Num都动但节奏不对,查预分频和重装值。不要一上来就怀疑遮挡传感器,外部时钟功能库的配置项比传感器更容易被忽略。
3. 功能库初始化与主循环显示:Timer_Init、OLED_ShowNum怎么落代码
3.1 主函数骨架:先OLED_Init再Timer_Init
主函数不需要花活,初始化顺序和显示位置固定下来,后面排查才有基准。下面这段是工程里的主函数骨架,关键注释保留:
c复制#include "stm32f10x.h" // Device header
#include "Delay.h"
#include "OLED.h"
#include "Timer.h"
uint16_t Num;
int main(void)
{
OLED_Init(); // 先点亮屏幕,后面才能看到CNT和Num
Timer_Init(); // 定时器外部时钟和更新中断在这里配置
OLED_ShowString(1, 1, "Num:");
OLED_ShowString(2, 1, "CNT:");
while(1)
{
OLED_ShowNum(1, 5, Num, 5);
OLED_ShowNum(2, 5, Timer_GetCounter(), 5);
// 不设置预分频前提下,遮挡一次,CNT+1,遮挡几次就加几
// +9后,再+,NUM++,CNT==0
}
}
逻辑说明:OLED_Init放在前面,是为了让定时器开始计数后第一帧就能显示;Timer_Init负责外部时钟源、边沿、预分频、重装值和更新中断;while(1)里只做显示,不在主循环里手动清CNT。参数说明:Num是全局变量,默认初值为0;Timer_GetCounter()每次读当前CNT,主循环读它不会改变计数;OLED_ShowNum的最后一个参数5表示占5个字符位,uint16_t最大65535刚好5位,Num和CNT都用5位显示,窗口变化时不会因为位数跳动导致排版错位。
这里有一个容易忽略的点:Num在中断里改、在主循环里读,工程里如果只写uint16_t Num;,有些优化等级下主循环可能读不到最新值。常见做法是把它写成volatile uint16_t Num;,让编译器每次老实去读内存。这个改动不影响计数逻辑,但能避免“明明进了中断,屏幕上的Num偶尔不刷新”的玄学现象。
3.2 OLED_ShowNum参数:行、列、变量、显示长度
OLED_ShowNum在这段代码里出现了两次,参数含义可以拆开看:
| 调用 | 行 | 列 | 变量 | 长度 | 说明 |
|---|---|---|---|---|---|
OLED_ShowNum(1, 5, Num, 5) |
第1行 | 第5列 | Num | 5位 | Num:占前4列,数字从第5列开始 |
OLED_ShowNum(2, 5, Timer_GetCounter(), 5) |
第2行 | 第5列 | 当前CNT | 5位 | CNT:占前4列,数字同样从第5列开始 |
列从5开始不是随便定的:Num:和CNT:各占4个字符位,数字接在冒号后面,视觉上不会叠字。长度5对uint16_t够用,但如果以后把Num改成uint32_t,5位就不够,显示会被截断或覆盖,所以改数据类型时要把长度一起改。还有人把Timer_GetCounter()的返回值直接塞进显示函数,这个没问题,但不要在显示前手动CNT=0,CNT的清零应该由更新事件完成,手动清零会把窗口计数和中断进位的关系打乱。
提示:先确认CNT显示稳定,再去调Num的显示长度;显示层的问题不要拿到计数层去修。
3.3 上电验证顺序:不遮挡、单次遮挡、连续遮挡
上板验证我按三步走,每一步都有明确的期望值,避免“看起来能动就行”:
| 步骤 | 操作 | 期望CNT | 期望Num | 说明 |
|---|---|---|---|---|
| 1 | 上电,不遮挡 | 0 | 0 | 确认没有内部时钟误计数 |
| 2 | 遮挡一次,移开 | 1 | 0 | 确认外部事件进得来 |
| 3 | 再遮挡一次 | 2 | 0 | 确认每次遮挡只加一,没有双边沿 |
| 4 | 连续遮挡到9 | 9 | 0 | 确认窗口内计数正常 |
| 5 | 第10次遮挡 | 0 | 1 | 确认更新事件重装CNT并进中断 |
第2步如果CNT直接跳到2,先查边沿极性是不是双边沿,或者遮挡信号有没有抖动;第5步如果CNT回0但Num不动,查更新中断使能和TIM2_IRQHandler有没有真的挂上;如果CNT不回0而是一直往上加,查重装值是不是没配。这个顺序不依赖猜测,每一步只验证一个环节。
4. 功能库中断回调:TIM2_IRQHandler里Num++和CNT清零的边界
4.1 中断函数骨架:TIM2_IRQHandler只做标志判断和Num++
中断函数是功能库调用链的最后一段,写法要短。下面这段保留了标志判断和Num++,并补上更新中断标志清除:
c复制// 中断函数:当进入中断,自动执行该函数
void TIM2_IRQHandler(void)
{
if(TIM_GetITStatus(TIM2, TIM_IT_Update) == SET) // 获取更新中断标志位
{
Num++; // 只做累计,不在中断里刷OLED
TIM_ClearITPendingBit(TIM2, TIM_IT_Update); // 清更新中断标志,避免退出后再次进入
}
}
逻辑说明:进入中断后先判断是不是TIM2的更新中断,避免其他中断源误入;确认是更新中断才Num++;最后清更新中断标志,让这次中断结束。参数说明:TIM2是定时器编号,要和Timer_Init里初始化的定时器一致;TIM_IT_Update是更新中断源;SET表示标志位已置位。中断里不调用OLED显示函数,不在中断里做延时,也不在中断里手动改CNT。
上面这段里,Num++和清标志的顺序可以按工程习惯调整,但清标志不能漏。只判断标志、只Num++、不清标志,退出中断后标志还在,中断控制器可能马上再进来,现象就是遮挡一次Num跳好几次。这个坑在后面避坑章会展开,这里先记住:中断函数只做“确认事件、累计、清标志”三件事。
4.2 CNT==0不是Num++造成的:更新事件和重装值
屏幕现象是“+9后,再+,NUM++,CNT==0”。很多人看到CNT归零,第一反应是Num++顺手把CNT清了,其实中断函数里根本没有写CNT。CNT归零来自更新事件:CNT计到重装值后,硬件自动把CNT重新装回初值,同时置更新中断标志。中断里的Num++只是对这个更新事件做累计,不负责重装。
这也解释了两个边界。第一,CNT的窗口长度由Timer_Init里的重装值决定,现象里从0到9再回0,说明当前窗口是10个外部事件一循环;如果改重装值,屏幕上的回零阈值会变,但中断函数不用改。第二,Num是累计值,CNT是窗口值,调试时不要拿CNT当总次数。CNT回零不代表丢数,只代表窗口翻页;Num加一才是翻页被记下来了。
还有一个实际边界:Num是uint16_t,累计到65535后继续加会回绕。遮挡计数小工具一般不会跑到这个量级,但如果做长时间老化测试,要在主循环里加溢出提醒,或者把Num改成更大类型。改类型时记得同步改OLED_ShowNum的长度,否则显示层先出问题。
4.3 中断里不要刷OLED:主循环读、volatile和临界区
中断函数里刷OLED是常见的翻车点。OLED的一次刷新往往包含延时和多次总线操作,放在中断里会拉长中断执行时间,外部事件来得快时容易丢事件,屏幕刷新也会拖慢主循环。这段工程的做法是中断只Num++,主循环用OLED_ShowNum读Num和CNT,显示和计数解耦。
Num跨中断和主循环,建议加volatile。如果以后把Num改成32位,主循环读Num时可能读到“一半旧值一半新值”,这时才需要临界区保护;当前16位在STM32上读写一般是原子的,但加volatile仍然是必要的。CNT通过Timer_GetCounter()读,读的是定时器计数寄存器,不要在主循环里手动写CNT。主循环刷新频率也不用追求每一毫秒刷一次,OLED看得清就行,刷太快反而占用总线。
5. 功能库调用避坑与排查:预分频、中断标志、计数进位五条血泪记录
5.1 五条高频踩坑记录:现象、原因、解决
第一条:遮挡三次CNT才加一,以为遮挡传感器坏了。 现象是单次遮挡CNT不动,连续遮挡多次才跳一下。原因通常不是传感器,而是Timer_Init里预分频被设成了非1,外部事件被分频后才进CNT。解决是先回到“不设置预分频”的基准,确认遮挡一次CNT+1,再按需要逐级加预分频。调预分频时要记录当前值,不要一次跳太多级,否则现象从“太灵敏”直接变成“像没反应”。
第二条:遮挡一次Num跳好几次,屏幕上的累计值追不上手速。 现象是CNT只加一,Num却加了三五下。原因多半是更新中断标志没清,退出中断后标志还在,中断又进来。解决是在Num++后补TIM_ClearITPendingBit(TIM2, TIM_IT_Update);,并确认清的是更新中断标志。只清别的标志、或者把清标志写在判断外面,都可能让中断反复进入。这个坑在中断函数里最隐蔽,因为主函数和CNT显示都正常。
第三条:CNT到9后回0,以为丢了一次计数。 现象是连续遮挡到9,再遮挡一次,CNT变成0,Num只加一,看起来像“第10次没记”。原因CNT是窗口计数,更新事件到了硬件重装,0就是新窗口的起点,Num加一已经记下了这次翻页。解决是同时看Num和CNT,或者按“Num×窗口长度+CNT”理解总次数。不要把CNT回0当成故障,也不要在主循环里手动把CNT写成0来“修正”。
第四条:Num偶尔不刷新,重启又好了。 现象是中断确实进了,CNT也在动,但OLED上的Num偶尔停在旧值。原因之一是Num没有加volatile,编译器优化后主循环读的是缓存值;原因之二是显示刷新太慢,肉眼看到的是上一帧。解决是把Num声明成volatile uint16_t,主循环正常读;同时把OLED刷新放在主循环,不要放进中断。如果改完还不稳,再查中断优先级和主循环里有没有长时间延时。
第五条:一次遮挡CNT加2,机械结构稍微碰一下就多跳。 现象是单次遮挡CNT不是+1而是+2甚至+3。原因可能是边沿极性设成了双边沿,按下和回弹各算一次;也可能是遮挡信号本身有抖动,外部时钟把每个边沿都当事件。解决是先确认边沿极性为单边沿,再在硬件或软件上做消抖;定时器外部时钟通道如果有输入滤波配置,也可以按信号频率适当开滤波。不要用“多遮挡几次取平均”掩盖抖动,计数源头不稳,后面累计全歪。
5.2 排查顺序:先看CNT动不动,再看中断标志
现场排查我按下面顺序走,不跳步:
- 看OLED是否正常显示
Num:和CNT:,显示层坏了先修显示。 - 不遮挡看CNT是否稳定在0,自己往上跑就查外部时钟源是不是还选了内部时钟。
- 遮挡一次看CNT是否+1,不动就查引脚复用、边沿极性、外部时钟源。
- CNT动但一次+2,查双边沿和信号抖动。
- CNT节奏对但Num不动,查更新中断使能和
TIM2_IRQHandler是否挂上。 - Num跳多次,查更新中断标志有没有清。
- Num偶尔不刷新,查
volatile和主循环刷新。
这个顺序把“事件进不来”“事件进多了”“中断没进”“中断进多了”“显示没刷新”分开。不要一上来改预分频,预分频只影响CNT的节奏,不会让完全不动的外部时钟突然动起来;也不要一上来换传感器,外部时钟功能库的配置项比传感器更常出问题。
6. 功能库进阶验证:用CNT/NUM对照表确认遮挡计数没翻车
6.1 一张对照表把现象锁死
调通之后,我习惯用一张对照表做回归验证,每次改Timer_Init都重新走一遍:
| 操作 | 期望CNT | 期望Num | 判断 |
|---|---|---|---|
| 上电不遮挡 | 0 | 0 | 没有内部时钟误计数 |
| 遮挡1次 | 1 | 0 | 外部事件进得来 |
| 连续遮挡到9 | 9 | 0 | 窗口内计数正常 |
| 第10次遮挡 | 0 | 1 | 更新事件重装并累计 |
| 再遮挡1次 | 1 | 1 | 新窗口从0开始,Num保持 |
这张表的前提是当前重装值对应0到9的窗口。如果改了重装值,回零阈值要跟着改,但判断逻辑不变:CNT看窗口,Num看累计。对照表最大的价值是防止“屏幕能动就算成功”,尤其是改预分频或边沿之后,肉眼很容易把+2看成+1。
6.2 我每次上板前固定检查的三件事
上板前我只盯三件事:预分频是不是在基准状态、更新中断有没有使能、中断里有没有清标志。代码上最少留两行保险:
c复制volatile uint16_t Num; // 中断里改、主循环里读,别让编译器优化掉
TIM_ClearITPendingBit(TIM2, TIM_IT_Update); // Num++后清更新中断标志
逻辑说明:第一行保证主循环读得到中断里的最新累计值;第二行保证一次更新事件只进一次中断。参数说明:TIM2和TIM_IT_Update要和初始化、中断函数保持一致,改定时器编号时三处一起改。
从那以后我每次接外部时钟功能库,都先拿一张纸写清楚预分频、重装值、中断清标志三件事,再上板;CNT不动先查入口,Num不动先查中断,绝不先怀疑遮挡传感器。希望帮到你。
