1. 把外部脉冲收进一个功能库:先分清 CNT 和 Num 各在动什么
把外设驱动整理成功能库,最先要想清楚的往往不是初始化代码,而是外部世界能看到什么。拿 STM32 的定时器外部时钟举例:最小系统板上 TIM2 的 ETR 引脚接一个红外对管,手一遮挡就送进一个脉冲,不设预分频的前提下 CNT 加一,加到 9 再遮挡一次,Num 进一、CNT 回零。第一次做这个实验的人,多半盯着 OLED 上两个数字发愣,分不清哪个是硬件计数器、哪个是软件变量,等换一块板子、换一个定时器,代码就拼不回去了。这篇笔记就把这类计数需求收进一个定时器功能库:头文件只对外暴露初始化和读计数,进位与清零关在库内部,主循环只管显示。读者最好是手里有 STM32 最小系统板、写过裸机 C 语言、但还没认真整理过驱动接口的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 功能库的骨架:Timer.h 暴露三个口子,Timer_Init 排好六步
一次性实验代码和功能库的区别,不在代码量,而在边界。实验代码里,主函数直接写寄存器、直接改全局变量、直接刷屏,谁都能改谁;功能库先划一条线:哪些东西外面能碰,哪些只能库自己碰。这条线划不清楚,后面无论换定时器还是换屏幕,都得整段重抄。
2.1 对外只留初始化、读计数、读进位三个口子
我一般把接口压到最小:Timer_Init() 负责把定时器配起来,Timer_GetCounter() 返回当前硬件计数值,进位总数用 Num 这个变量对外暴露,但只在 Timer.c 里自增,main.c 只读不写。这样主循环里出现的永远是 OLED_ShowNum(1, 5, Num, 5) 和 OLED_ShowNum(2, 5, Timer_GetCounter(), 5),一行寄存器操作都没有。
为什么不把 OLED 显示也塞进库里?因为一旦库里调了 OLED 驱动,这个库就只能长在有屏幕的板子上,换到没有屏幕的板子或者改成串口输出,就得回来拆函数。库要能被“没有屏幕的环境”复用,显示层必须留在外面。反过来,Num 的自增逻辑也不能放到主循环里,中断和主循环同时改一个变量,早晚出事。这条线怎么切,决定了这个功能库后面能不能直接拷进下一个工程。
还有一个细节:Num 声明成 uint16_t,在 Timer.c 里定义、在 Timer.h 里 extern,主函数只负责显示。这样编译时其他文件看不到它的写权限,靠编译期就挡住一部分误用。
2.2 配置顺序:GPIO → 外部触发 → 时基 → 中断 → NVIC → 启动
顺序不是形式主义。时钟没开就写外设寄存器,写进去也是无效配置,上电后现象是“代码明明跑了但 CNT 不动”,这种问题最难查,因为它不报错。下面这段是我这个库的实际初始化,用的是标准外设库头文件 stm32f10x.h:
c复制#include "Timer.h"
void Timer_Init(void)
{
/* 1. 先开时钟:TIM2 在 APB1,GPIOA 在 APB2,总线不同 */
RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE);
RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
/* 2. ETR 引脚 PA0 配成上拉输入,悬空时不至于乱计 */
GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_Init(GPIOA, &GPIO_InitStructure);
/* 3. 外部时钟模式 2:把 ETR 当作计数时钟源 */
TIM_ETRClockMode2Config(TIM2,
TIM_ExtTRGPSC_OFF, /* ETR 不分频 */
TIM_ExtTRGPolarity_NonInverted, /* 上升沿计数 */
0x00); /* 输入滤波关闭 */
/* 4. 时基:PSC=0 再不分频,ARR=9 即每 10 个脉冲一轮 */
TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure;
TIM_TimeBaseInitStructure.TIM_ClockDivision = TIM_CKD_DIV1;
TIM_TimeBaseInitStructure.TIM_CounterMode = TIM_CounterMode_Up;
TIM_TimeBaseInitStructure.TIM_Period = 9;
TIM_TimeBaseInitStructure.TIM_Prescaler = 0;
TIM_TimeBaseInitStructure.TIM_RepetitionCounter = 0;
TIM_TimeBaseInit(TIM2, &TIM_TimeBaseInitStructure);
/* 5. 打开更新中断,再把 NVIC 通道接上 */
TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE);
NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);
NVIC_InitTypeDef NVIC_InitStructure;
NVIC_InitStructure.NVIC_IRQChannel = TIM2_IRQn;
NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;
NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 2;
NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1;
NVIC_Init(&NVIC_InitStructure);
/* 6. 最后启动,前面所有配置从这一刻才生效 */
TIM_Cmd(TIM2, ENABLE);
}
第 3 步的 TIM_ETRClockMode2Config 是这套配置的关键,它把定时器的时钟源从内部 APB1 时钟切到 ETR 引脚,走的是外部时钟模式 2。第 6 步 TIM_Cmd 放在最后,是因为计数器一旦启动就会立刻开始响应引脚电平,先启动再配参数,中间那几个毫秒会白计几个数,看着像“上电就跳了几个”。第 5 步里 NVIC_PriorityGroupConfig 只应该在整个工程里调用一次,多个模块各调一次会互相覆盖分组,这个坑放在第 5 章细说。
2.3 PSC、ARR、ETR 预分频:三个“分频”别混成一个
初学者最容易在这三处翻车,因为它们名字里都带“分频”。实际是两级串联:ETR 脉冲先进外部触发预分频,再进时基预分频 PSC,最后落到计数器 CNT 和自动重装 ARR。
| 参数 | 落到的寄存器位 | 含义 | 本例取值 | 改了之后的直接后果 |
|---|---|---|---|---|
TIM_ExtTRGPSC_OFF |
ETP 预分频 | 对 ETR 原始脉冲先分频 | 1 分频 | 设成 DIV2,遮挡两次 CNT 才加一 |
TIM_ExtTRGPolarity_NonInverted |
ETP 极性 | 上升沿还是下降沿计数 | 上升沿 | 反相后在脉冲下降沿计数,遮挡动作看起来“慢一拍” |
滤波参数 0x00 |
ETF | 对 ETR 采样滤波 | 关闭 | 加大可滤掉触点毛刺,但会压低能接受的最高脉冲频率 |
TIM_Prescaler = 0 |
PSC | 对已选时钟再分频 | 不分频 | 设成 N,则每 N+1 个 ETR 脉冲 CNT 才加一 |
TIM_Period = 9 |
ARR | 自动重装值 | 10 个脉冲一轮 | 决定 Num 多久进一次位,也决定 CNT 从几回零 |
TIM_Period = 9 意味着 CNT 的取值是 0 到 9 共十个状态,第 10 个脉冲到来时产生更新事件、CNT 硬件自动回零、Num 加一。这和实验现象“加到 9 再遮挡一次,Num 进一、CNT 回零”完全对得上。反过来,如果 ARR 忘了改,还停在复位默认的大值,那 CNT 会一路涨到很大也不进位,现象是“屏上 Num 一动不动、CNT 一直在变”,很多人第一反应是中断没进,其实是阈值根本没设。
参数这一层想清楚之后,库的骨架就立住了:Timer.h 里三行声明,Timer.c 里一段初始化加一个中断函数,主循环只拿现成的数。至于这些数怎么读、什么时候读会读到 0,是下一章的事。
3. 中断与读取:TIM2_IRQHandler 里的进位,和 Timer_GetCounter 的时序
3.1 更新中断里只做三件事:判标志、清标志、Num 自增
中断服务函数越短越好,这里只该干三件事。判标志用 TIM_GetITStatus(TIM2, TIM_IT_Update),它读的是中断使能加标志的组合状态;清标志用 TIM_ClearITPendingBit。这两步顺序不能倒,也不能省。
c复制volatile uint16_t Num = 0;
void TIM2_IRQHandler(void)
{
if (TIM_GetITStatus(TIM2, TIM_IT_Update) == SET)
{
Num++; /* 软件侧的进位总数 */
TIM_ClearITPendingBit(TIM2, TIM_IT_Update); /* 不清,退出后会立刻重入 */
}
}
Num 前面那个 volatile 是我后来补的,理由很实在:它在中断里被改、在主循环里被读,编译器看不到这层关系,很可能把它优化进寄存器,屏上就永远是开机那个 0。这类问题不报错、不崩溃,纯靠盯着屏幕怀疑人生,属于典型的玄学故障。
还有个常见误解:以为中断里得手动写 TIM_SetCounter(TIM2, 0) 把 CNT 清零。实际上向上计数模式下,CNT 计到 ARR 后由硬件自动重装回 0,软件再清一次反而可能和刚进来的下一个脉冲打架,白白丢掉一个计数。中断里只加 Num、只清标志,就够了。
3.2 Timer_GetCounter 读到 0 不一定代表没脉冲
读计数的接口就一行,返回硬件 CNT:
c复制uint16_t Timer_GetCounter(void)
{
return TIM_GetCounter(TIM2);
}
因为 CNT 是 16 位寄存器,单次读取本身是原子的,不需要关中断保护。但“读到 0”有两种截然不同的含义:一种是这一轮刚进位完、CNT 被硬件清了;另一种是一个脉冲都还没来。光看 CNT 这一个数分不出来,这也是主循环里必须同时显示 Num 和 CNT 的原因——两个数放一起,才能判断当前处在进位后的瞬间还是启动初期。
再往深一层,Num 和 CNT 的读取不是原子的。主循环可能刚好在“CNT 已经到 9、更新事件还没进中断”这一瞬间读走两个值,屏上出现 Num=3, CNT=9;下一轮又变成 Num=4, CNT=0。这是正常的读数不同步,不是丢数、不是 bug,做功能库的时候要把这条写进注释,否则下一个用这个库的人一定会来问。
3.3 主循环只管显示,刷新节奏自己控
主函数拿到库的两个口子之后,剩下的事就是刷屏:
c复制int main(void)
{
OLED_Init();
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); /* 硬件当前计数值 */
}
}
OLED_ShowNum 的最后一个参数是显示位数,这里统一给 5 位。CNT 最多只到 9,用 5 位是浪费,但位数统一之后屏幕不会因为数值变宽而左右跳动,读数更稳。这段循环没有任何延时,屏幕刷新频率跟着 OLED 驱动走,实际用起来通常没问题;但如果你的屏有明显的整屏闪烁,那就在循环里加一个十几毫秒的延时,或者加一层“值没变就不刷”的判断,这属于显示层的调优,不该塞进定时器库。
到这里,这个功能库已经能跑通“遮挡一次 CNT 加一、满十进一”的完整链路。接下来要处理的是它最容易失效的部分:换硬件。
4. 功能库的移植检查:换定时器、换上限、换板子各改哪几行
4.1 换 TIM3 或 TIM4,ETR 引脚、重映射、时钟总线三处一起动
库写死 TIM2 之后,换定时器不是把字符串替换一下那么简单。ETR 引脚跟着定时器变,引脚可能要开重映射,时钟使能还分 APB1 和 APB2 两条总线。下面这张对照表是我自己移植时对着数据手册抄的,具体以所用型号的手册为准:
| 定时器 | ETR 常见引脚 | 是否需要重映射 | 时钟总线 |
|---|---|---|---|
| TIM2 | PA0 | 默认可用;重映射后为 PA15 | APB1 |
| TIM3 | PD2 | 一般需要开重映射 | APB1 |
| TIM4 | PE0 | 默认可用 | APB1 |
移植时要同步改的是四处:RCC_APB1PeriphClockCmd 里的定时器名、RCC_APB2PeriphClockCmd 里的端口名、GPIO_Init 里的引脚号、以及 TIM_ETRClockMode2Config 和后续所有 TIM2 参数。如果新引脚是重映射出来的,还要多一句 GPIO_PinRemapConfig,并且注意重映射寄存器带写保护,得先解保护再写。少任何一处,现象都是“初始化函数跑完了,可是遮挡没反应”。
4.2 上限从 9 改成别的数,ARR、乘数、显示位宽要一起改
TIM_Period 一改,整个库的语义都变。ARR 设成 99,则每 100 个脉冲进一次中断,Num 增长慢十倍;设成 0,则每个脉冲都进一次中断,中断频率跟着脉冲频率走,脉冲一密就容易被中断拖住。改这个值的时候,至少三处要同步:TIM_Period、任何按“10 个脉冲一轮”写死的换算代码、以及屏幕上位数的宽度。
我在库里的做法是把阈值提成一个宏:
c复制#define TIMER_ARR 9u
#define TIMER_CYCLE (TIMER_ARR + 1u) /* 一轮包含的脉冲数 */
TIM_TimeBaseInitStructure.TIM_Period = TIMER_ARR;
之后凡是要“一轮多少脉冲”的地方都用 TIMER_CYCLE,不要在代码里散落一堆魔法数字 10。库的可移植性,很大一部分就体现在这种地方。
4.3 命名和头文件依赖收一收,别让库拖着别的模块跑
一个能拷来拷去的功能库,头文件里只该出现 stm32f10x.h 这类底层依赖,不该出现 OLED.h、Delay.h。Delay 尤其容易混进来——有人为了在库里做去抖,顺手调了毫秒延时,结果这个库到了没有延时模块的工程里直接编译不过。去抖如果确实需要,放在调用方或者用定时器自身的滤波位解决,库里保持干净。
命名上也建议统一前缀,比如 Timer_Init、Timer_GetCounter、Timer_GetTotal,一眼能看出属于哪个模块。同一工程里如果还有别的定时器用途,就分成 Timer.c 和另一个 TimerX.c,不要在一个文件里塞两个定时器的初始化,否则将来改一个影响另一个。
移植这块说白了就是一张核对清单:引脚、重映射、总线、ARR、乘数、依赖。这六项过一遍,基本不会翻车。
5. 功能库避坑与排查:CNT 不涨、Num 乱跳、屏幕只亮一次
这一章的五条,都是我在这个库上真实撞过的现象。每条按“看到什么 → 为什么 → 怎么改”写,按顺序查能省不少时间。
5.1 CNT 一直是 0,遮挡再多次也没反应
现象:程序正常跑,OLED 上 Num 和 CNT 都是 0,手在红外对管前面来回晃,两个数纹丝不动,用万用表量引脚明明有电平变化。
原因:这一条九成出在引脚配置或时钟上。要么 ETR 引脚没配成输入模式,外部信号进不到定时器;要么 GPIO 或 TIM 的时钟使能漏了,寄存器写进去等于没写。还有一种情况是引脚选错,比如库是按 PA0 写的,板子上那颗对管实际接在别的脚上。
解决:先确认三件事——引脚号对不对、RCC_APB1PeriphClockCmd 和 RCC_APB2PeriphClockCmd 两行都在不在、GPIO_Mode 是不是输入模式。用上拉输入比浮空输入稳,悬空引脚电平漂移会被当成脉冲。如果换过引脚,还要查重映射有没有开。
5.2 Num 一次遮挡涨好几个,甚至疯涨
现象:明明只遮挡了一次,Num 一下加了 3、加 5,越到后面越离谱。
原因:最常见的是中断标志没清。更新中断的标志位如果留在那里,退出中断函数后处理器会认为事件还没处理完,立刻再进来一次,于是 Num 连续自增。第二种原因是输入信号本身有抖动,机械触点或者劣质光耦在通断瞬间会甩出好几个窄脉冲,而滤波位是关着的,全被计了进去。
解决:先补上 TIM_ClearITPendingBit,并且确认它写在 Num++ 之后、if 里面。如果清标志没问题还是涨得快,就把 TIM_ETRClockMode2Config 的滤波参数从 0x00 调大,让采样窗口滤掉窄毛刺;代价是能接受的最高脉冲频率会下降,遮挡动作特别快的时候可能漏计,这个取舍得按你的实际信号定。
5.3 Num 完全不动,CNT 一路往上跑
现象:CNT 正常增长,但越过 9、越过几十都不回零,Num 一次都不加。
原因:自动重装值没生效。要么 TIM_Period 忘了改,还停在复位默认的大值;要么 TIM_TimeBaseInit 调用时结构体里的成员没赋值,编译器给了个随机残值;要么更新中断压根没使能,或者 NVIC 通道没接上,硬件进位了但软件没收到通知。
解决:先看 TIM_Period 是不是 9,再看 TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE) 有没有漏,最后查 NVIC 那段有没有 NVIC_IRQChannelCmd = ENABLE。三层都齐了还不动,就在中断函数里放个变量自增、用调试器看它到底进没进中断,别靠猜。
5.4 屏幕上的 Num 永远是开机那个 0
现象:CNT 在正常跳,说明硬件计数没问题,但 Num 那一行始终显示 0,重启之后又正常一会儿。
原因:Num 少了 volatile。它在中断里被写、在主循环里被读,编译器没看到这层关联,直接把这个变量缓存进寄存器,主循环读到的永远是缓存值。
解决:声明处加 volatile。加完之后如果还不对,再查是不是两个文件里各定义了一份 Num——一个在 Timer.c 定义、一个在 main.c 又定义,链接器不会报错,但中断改的是这一份、显示读的是另一份,现象和没加 volatile 一模一样。
5.5 屏幕刷得厉害,或者显示偶尔卡住
现象:数值跳得快的时候整屏闪,或者某几次遮挡之后屏幕短暂不刷新。
原因:主循环里没有任何节流,OLED 全屏重写一遍的耗时比定时器进一次中断还长;如果中断优先级配得比显示驱动依赖的时序更靠前,中断频繁抢占也会拖慢刷屏。另外 NVIC_PriorityGroupConfig 如果在多个模块里各调一次,分组会被后调用的覆盖,优先级数值的含义随之改变,表现就是“有时候灵有时候不灵”。
解决:主循环加短延时,或者只在数值变化时才刷新;NVIC_PriorityGroupConfig 全工程只调一次,放在主函数开头统一设;定时器中断的抢占优先级给到中等,别给最高,让串口、显示这些对时序敏感的模块有活路。
6. 给这个库补上总计数:把 Num 和 CNT 拼起来,顺便看清它的边界
单个 Num 是 uint16_t,最多记到 65535 次进位;在 ARR=9 的配置下,一轮十个脉冲,也就是六十五万多个脉冲就回绕了。做长时间统计时,这个上限来得比想象中快,所以我在库里加了一个把两个数拼成总计数的接口:
c复制uint32_t Timer_GetTotal(void)
{
uint16_t num1, num2, cnt;
do {
num1 = Num; /* 先读进位 */
cnt = TIM_GetCounter(TIM2); /* 再读当前计数 */
num2 = Num; /* 回头再读一次进位 */
} while (num1 != num2 || cnt > TIMER_ARR); /* 进位瞬间就重读 */
return (uint32_t)num1 * TIMER_CYCLE + cnt;
}
思路很朴素:读 CNT 前后各读一次 Num,两次一样说明读的过程中没发生进位,可以放心拼;两次不一样说明正好撞上进位,那就重来一遍。cnt > TIMER_ARR 这一条是防御性的,正常不会发生,留着是为了将来改 ARR 时不用回来改判断。拼出来的总数是 32 位,配合 TIMER_CYCLE 宏,改上限的时候这段代码一行都不用动。
用的时候也得清楚它的适用范围。拿这个库去估脉冲频率是不合适的:ARR=9 意味着 CNT 每十个脉冲就回零一次,你在主循环里隔一秒读一次,读到的只是一个残数,算出来的频率没有意义。真要做频率测量,得把 ARR 放大到接近满量程,或者干脆改用输入捕获测周期——那已经是另一个库的职责了,这个库只承诺“把脉冲数准”,不承诺“测频率准”。把边界写在头文件注释里,比事后解释省事得多。
还有一个小的验证习惯:上电后先不接信号,看 CNT 是不是稳定停在 0,再接上对管慢慢遮挡,确认第十次遮挡时 Num 从 0 变 1、CNT 同时归零。这一步能同时验证引脚、阈值和中断三条链路,比直接上手猛晃半天高效。
从那以后我每次把这个库拷进新工程,都先按引脚、重映射、总线、ARR、乘数、依赖这张清单走一遍,再上电看那两个数字。踩过的坑大多不是原理不懂,而是少写了一行。希望帮到你。
