1. 为什么定时器是STM32入门的分水岭很多人学STM32GPIO点灯、按键扫描、串口打印这三板斧耍得挺溜一到定时器就卡壳。我见过太多人卡在这一步中断进不去、进了中断出不来、时间算不对、LED闪得跟抽风一样。其实定时器这东西说穿了就是一个会数数的硬件你给它一个时钟源它就开始数数到某个值就告诉你一声。就这么简单。但为什么大家觉得难因为CubeMX里定时器的参数页面一打开Prescaler、Counter Period、Clock Division、auto-reload preload、各种中断使能密密麻麻一堆选项不知道哪个该填什么。再加上HAL库的中断回调函数名字又长又绕HAL_TIM_PeriodElapsedCallback第一次见的人根本不知道这玩意儿该往哪儿放。这篇内容就是来解决这个问题的。我以STM32F103C8T6这块最经典的入门芯片为例用CubeMX从零配置一个定时器定时中断让LED按照精确的1秒周期闪烁。整个过程拆解成可复现的步骤每个参数为什么这么填、中断回调为什么这么写、时间怎么算出来的全部讲透。不管你是刚学完GPIO的新手还是被定时器折磨过想重新理一遍的老哥这篇都能让你把定时器定时中断这条链路彻底跑通。关键词就几个CubeMX、STM32、定时器、HAL库、定时中断。围绕这几个词我把配置逻辑、时钟树计算、代码结构、常见翻车点全部展开。看完你至少能做到三件事第一独立算出任意定时时间的Prescaler和Counter Period组合第二知道HAL库定时中断的完整调用链路第三遇到中断不触发或者频率不对的时候有一套排查思路。2. 定时器定时中断的硬件逻辑与CubeMX配置路径2.1 定时器到底在数什么从时钟源到更新事件STM32的通用定时器比如TIM2、TIM3、TIM4挂载在APB1总线上高级定时器TIM1、TIM8挂在APB2上。以TIM2为例它的时钟来源是APB1的倍频输出。这里有个很多人忽略的细节APB1的预分频系数如果不为1定时器时钟会自动倍频。比如系统时钟72MHzAPB1预分频设为2APB1总线时钟是36MHz但定时器时钟是72MHz。这个规则在参考手册的时钟树章节写得很清楚但CubeMX的时钟树界面会直接显示最终值你只要看那个数字就行。定时器的基本工作流程是这样的时钟信号进入定时器后先经过预分频器Prescaler把高频时钟降到一个合适的频率然后驱动计数器Counter开始计数。计数器从0往上数数到自动重装载寄存器Auto-Reload RegisterARR的值时产生一个更新事件Update Event同时计数器清零重新开始。如果你使能了更新中断这个更新事件就会触发中断CPU跳转到中断服务函数执行你的代码。用生活化的类比预分频器就像水龙头的阀门控制水流速度计数器就像一个水桶在接水ARR就是水桶的容量。水满了计数到ARR就溢出来一次更新事件然后桶清空重新接。你调节阀门Prescaler和换不同大小的桶ARR就能控制多久溢一次。2.2 CubeMX中TIM3的逐项配置与参数计算打开CubeMX选好芯片型号STM32F103C8T6之后在左侧外设列表里找到Timers展开后点击TIM3。中间的引脚图会显示TIM3的四个通道引脚但我们做定时中断不需要占用引脚所以不用管通道配置只配置NVIC和参数设置就行。在TIM3的配置面板里有几个关键项Clock Source选择Internal Clock意思是使用内部时钟源。这个必须选对如果选错了成External Clock Mode定时器就等着外部信号触发永远等不到。Prescaler填7199。这个数字怎么来的系统时钟72MHz预分频器实际分频系数是Prescaler1所以71991720072MHz除以7200等于10kHz。也就是说经过预分频后计数器每0.1毫秒加1。Counter Mode选Up向上计数。这是最常用的模式从0数到ARR。Counter Period填9999。这个就是ARR的值。计数器从0数到9999一共数10000次。每次0.1毫秒10000次就是1000毫秒也就是1秒。所以定时周期就是1秒。auto-reload preload建议使能。这个选项的作用是当你中途想改ARR的值时新值不会立即生效而是等当前计数周期结束后才生效。这样可以避免计数过程中改ARR导致时序错乱。对于固定周期的应用使能与否影响不大但养成使能的习惯没坏处。Trigger Event Selection保持默认的Reset就行这个跟定时中断没关系。配置完参数后切到NVIC Settings标签页找到TIM3 global interrupt勾选Enabled。这一步是使能定时器的更新中断不勾的话中断永远不会触发。注意很多人配置完参数忘了开NVIC中断然后烧录进去发现LED不闪查半天代码没问题最后发现是中断没使能。这个坑我踩过不止一次。2.3 时钟树确认别让默认值骗了你CubeMX的时钟树页面Clock Configuration一定要看一眼。默认情况下如果你选了外部晶振HSECubeMX会自动配置PLL把系统时钟拉到72MHz。但如果你用的是芯片内部的HSI系统时钟可能只有8MHz或者64MHz这时候你按72MHz算出来的定时参数就不对了。具体确认方法在时钟树页面找到APB1 Timer clocks这一栏看它显示的数字。如果是72MHz那上面的计算没问题。如果是36MHz那Prescaler和ARR都要重新算。比如36MHz时钟想要1秒定时可以Prescaler填3599分频后10kHzARR填9999结果一样。我一般习惯在时钟树页面截个图把各个总线的时钟频率记下来配定时器的时候直接对照省得来回切页面。3. 中断回调的代码结构与HAL库调用链路3.1 从main函数到回调函数完整调用链路拆解CubeMX生成代码后main函数里会自动调用MX_TIM3_Init()完成定时器初始化。但初始化完定时器还不会开始工作你需要在main函数里手动调用HAL_TIM_Base_Start_IT(htim3)来启动定时器并使能中断。这个函数的调用位置很关键。必须在所有初始化完成之后、进入主循环之前调用。我一般放在MX_GPIO_Init()之后while(1)之前。启动之后定时器开始计数每满一个周期触发一次更新中断。中断触发后CPU自动跳转到中断向量表里TIM3对应的入口执行TIM3_IRQHandler()。这个函数在stm32f1xx_it.c文件里CubeMX会自动生成。函数体里调用HAL_TIM_IRQHandler(htim3)这是HAL库的中断处理函数。HAL_TIM_IRQHandler()内部会判断中断类型如果是更新中断Update Interrupt就清除中断标志位然后调用HAL_TIM_PeriodElapsedCallback()。这个回调函数是一个弱函数weak function默认是空的需要你自己在代码里重写。完整链路是这样的TIM3计数溢出 → 硬件触发更新中断 → TIM3_IRQHandler() → HAL_TIM_IRQHandler(htim3) → 判断中断类型 → 清除标志位 → HAL_TIM_PeriodElapsedCallback(htim3) → 你写的业务代码理解这条链路非常重要因为后面排查问题时你需要知道中断卡在哪一环。3.2 回调函数写在哪里位置和写法都有讲究HAL_TIM_PeriodElapsedCallback()这个函数我建议写在main.c文件里放在main()函数后面、while(1)外面。不要写在stm32f1xx_it.c里虽然写那里也能跑但代码组织上不清晰后期维护麻烦。写法如下void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } }注意几个细节第一函数名必须和HAL库里的弱函数完全一致大小写都不能错。第二参数类型是TIM_HandleTypeDef *不是TIM_TypeDef *这两个容易搞混。第三一定要判断htim-Instance因为如果你同时用了多个定时器所有定时器的更新中断都会进这个回调不判断的话就乱套了。提示如果你只用一个定时器不判断Instance也能跑但这是坏习惯。我见过一个项目用了TIM2和TIM3两个定时器回调里没判断结果TIM2中断触发了TIM3的业务代码查了一下午才发现。3.3 中断优先级配置什么时候需要改什么时候不用管CubeMX的NVIC配置页面里TIM3 global interrupt默认的抢占优先级和响应优先级都是0。对于只有一个中断源的简单应用用默认值完全没问题。但如果你同时用了串口中断、外部中断、定时器中断就需要考虑优先级了。抢占优先级高的中断可以打断抢占优先级低的中断。比如串口接收中断需要快速响应可以把它的抢占优先级设高一点定时器中断只是闪个LED优先级低一点无所谓。STM32F103的NVIC支持4位优先级CubeMX里可以设置0到15。数值越小优先级越高。我一般的分配原则是通信类中断串口、SPI优先级最高设1或2定时器中断中等设3或4按键外部中断最低设5或6。这样保证通信不丢数据定时器也不会被按键抖动频繁打断。4. 定时时间计算的通用公式与参数速查4.1 从公式到直觉三步算出任意定时周期定时时间的计算公式定时周期 (Prescaler 1) × (Counter Period 1) / 定时器时钟频率反过来如果你想要一个特定的定时周期可以这样算第一步确定定时器时钟频率。STM32F103通常TIM2、TIM3、TIM4是72MHzTIM1、TIM8也是72MHz。第二步选定Prescaler。Prescaler决定了计数器的计数频率。我一般喜欢把计数频率定在1kHz到10kHz之间这样ARR的值不会太大也不会太小。比如72MHz时钟Prescaler填7199得到10kHz计数频率。第三步用计数频率乘以想要的定时时间得到ARR的值。比如想要1秒10kHz × 1s 10000ARR填9999因为从0开始数。想要0.5秒ARR填4999。想要2秒ARR填19999。想要10毫秒ARR填99。4.2 常用定时周期参数对照表定时周期定时器时钟Prescaler计数频率Counter Period实际周期1秒72MHz719910kHz99991.000s500毫秒72MHz719910kHz49990.500s100毫秒72MHz719910kHz9990.100s10毫秒72MHz719910kHz990.010s1毫秒72MHz719910kHz90.001s1秒36MHz359910kHz99991.000s1秒8MHz79910kHz99991.000s这张表可以直接抄作业。注意最后一列实际周期因为Prescaler和ARR都是整数有时候算出来不是刚好整数会有微小误差。比如你想要1秒但时钟是72MHzPrescaler填7199、ARR填9999实际周期是(71991)×(99991)/72000000 72000000/72000000 1.000秒刚好。但如果时钟是64MHzPrescaler填6399、ARR填9999实际周期是64000000/64000000 1.000秒也刚好。只要时钟频率能被整除就没有误差。4.3 当定时时间超过单次计数范围怎么办16位定时器的ARR最大是65535。如果你用10kHz计数频率最大定时时间是6.5535秒。想要更长的定时时间怎么办方法一降低计数频率。比如Prescaler填7199改成71999计数频率变成1kHzARR最大65535最大定时时间65.535秒。但这样定时精度就降到1毫秒了。方法二在中断里加一个软件计数器。比如定时器每100毫秒中断一次中断里countcount到10就是1秒。这样既能保证定时精度又能实现长时间定时。static uint8_t count 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { count; if (count 10) { count 0; HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } } }方法三用32位定时器。STM32F4、F7等系列有32位定时器ARR可以到4294967295但F103没有所以入门阶段还是用前两种方法。5. 中断不触发、频率不对的排查链路5.1 从现象反推LED完全不闪和闪得太快分别查什么LED完全不闪可能的原因按概率排序第一NVIC中断没使能。回CubeMX检查TIM3 global interrupt有没有勾上。这个是最常见的我估计占所有问题的四成以上。第二HAL_TIM_Base_Start_IT()没调用。CubeMX生成的代码只初始化定时器不会自动启动。你必须在main函数里手动调用这个函数。检查一下是不是漏了。第三回调函数名写错了。HAL_TIM_PeriodElapsedCallback注意是PeriodElapsed不是PeriodElapsedCallback的拼写错误也不是Period_Elapsed。HAL库的弱函数名是固定的写错了就不会被调用。第四GPIO初始化有问题。如果你用的是PC13接LED检查MX_GPIO_Init()里有没有把PC13配置成推挽输出。CubeMX里要在GPIO页面手动设置PC13为GPIO_Output。第五中断服务函数被删了或者改了。stm32f1xx_it.c里的TIM3_IRQHandler()是CubeMX生成的如果你不小心删了或者改了函数名中断就进不去。LED闪得太快可能的原因第一Prescaler或ARR算错了。比如想要1秒结果Prescaler填了719ARR填了999那就是0.1秒闪一次。重新按公式算一遍。第二时钟树配置和预期不符。比如你以为系统时钟是72MHz实际是8MHz那定时时间就差了9倍。去时钟树页面确认APB1 Timer clocks的值。第三中断里做了耗时操作。比如在回调里调用了HAL_Delay()这会导致中断响应变慢但不会让LED闪得更快。闪得太快一般是参数问题。5.2 用调试器和串口打印定位中断是否真的进了如果LED不闪但你不确定是中断没进还是GPIO有问题可以用调试器打断点。在HAL_TIM_PeriodElapsedCallback()函数第一行打个断点全速运行看能不能停在这里。能停说明中断进了问题在GPIO或者业务代码不能停说明中断链路有问题回去查NVIC和启动函数。没有调试器的话可以在回调里翻转另一个GPIO用示波器或者逻辑分析仪看波形。或者用串口打印在回调里发一个字符串口助手看有没有输出。但注意串口打印本身比较耗时如果定时周期很短比如1毫秒在中断里打印会导致中断处理时间过长影响下一次中断。我一般用GPIO翻转法在回调里翻转一个空闲引脚用示波器测频率。如果测出来是500Hz说明中断每2毫秒进一次对应定时周期2毫秒。这个方法最直接不需要打断点也不影响中断时序。5.3 中断标志位没清除导致的卡死现象有一种情况是LED闪了一下就不闪了或者程序跑飞了。这很可能是中断标志位没清除导致中断反复触发CPU一直卡在中断里出不来。HAL库的HAL_TIM_IRQHandler()内部会自动清除更新中断标志位正常情况下不需要你手动清。但如果你在回调函数里又触发了其他中断或者中断优先级配置有问题可能会导致标志位清除不及时。排查方法在TIM3_IRQHandler()里HAL_TIM_IRQHandler(htim3)之前加一句__HAL_TIM_CLEAR_IT(htim3, TIM_IT_UPDATE)手动清除标志位。如果加了这句问题就解决了说明是标志位清除的问题。不过更常见的情况是你在中断回调里调用了HAL_Delay()。HAL_Delay()依赖SysTick中断而SysTick的优先级默认比TIM3低。如果TIM3中断一直在触发SysTick中断就永远得不到执行HAL_Delay()就卡死了。所以记住一条铁律中断回调里绝对不要用HAL_Delay()。6. 从定时中断延伸出去的几个实用场景6.1 用定时中断做精准的软件延时替代HAL_DelayHAL_Delay()的精度受SysTick影响而且它是阻塞式的调用期间CPU什么都干不了。用定时中断可以做一个非阻塞的延时volatile uint32_t tick 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { tick; } } void delay_ms(uint32_t ms) { uint32_t start tick; while ((tick - start) ms); }这个delay_ms()不阻塞其他中断而且精度取决于定时器中断周期。如果定时器1毫秒中断一次delay_ms(100)就是等100个tick精度在1毫秒以内。6.2 定时中断驱动状态机按键消抖和LED呼吸灯按键消抖的经典做法是用定时中断每10毫秒扫描一次按键连续几次读到相同状态才确认。这样不需要在中断里延时也不会阻塞主循环。LED呼吸灯可以用定时中断配合PWM但PWM本身有硬件支持不需要中断。如果非要用中断做可以在中断里改变PWM的占空比每10毫秒调整一次实现渐变效果。6.3 多定时器协同一个做系统滴答一个做业务定时STM32F103有多个定时器可以一个做系统滴答比如TIM2每1毫秒中断一次维护系统tick另一个做业务定时比如TIM3每100毫秒中断一次扫描传感器。两个定时器中断优先级可以设成一样也可以设成系统滴答优先级高一点。注意如果两个定时器都用HAL_TIM_PeriodElapsedCallback()一定要在回调里判断htim-Instance否则会互相干扰。7. 我踩过的几个坑和总结的经验第一个坑CubeMX里改了定时器参数但忘记重新生成代码。CubeMX修改配置后必须点GENERATE CODE否则代码还是旧的。我有时候改完参数直接编译烧录发现没变化查半天才发现没生成。第二个坑在中断回调里调用了printf()。printf()底层是串口发送串口发送是阻塞的在中断里调用会导致中断处理时间过长。如果串口波特率是115200发一个字符大概87微秒发一行字符串就是几毫秒。定时器1毫秒中断一次的话中断还没处理完下一次又来了程序就卡死了。第三个坑Prescaler和ARR填反了。Prescaler是预分频ARR是计数上限。有人把7199填到ARR9999填到Prescaler结果定时时间完全不对。记住Prescaler一般填大数几千到几万ARR填相对小的数取决于定时周期。第四个坑用了HAL库的HAL_TIM_Base_Start()而不是HAL_TIM_Base_Start_IT()。前者只启动定时器不使能中断后者才使能中断。名字差一个_IT功能差很多。第五个坑时钟树里APB1预分频系数不为1时定时器时钟是APB1时钟的2倍。这个规则在F103上成立但不同系列可能不一样。最保险的方法就是看CubeMX时钟树页面显示的APB1 Timer clocks值以那个为准。最后分享一个我常用的调试技巧在CubeMX里配置一个空闲GPIO在定时器中断回调里翻转它。用示波器或者逻辑分析仪测这个GPIO的频率就能直观看到定时器中断的实际周期。这个方法比串口打印更可靠也不会影响中断时序。测出来的频率如果是500Hz说明中断周期是2毫秒如果是1kHz说明中断周期是1毫秒。跟你的预期对比就能快速判断参数配置对不对。定时器这东西入门的时候觉得复杂用熟了之后发现它是STM32里最灵活的外设之一。定时中断只是最基础的用法后面还有输入捕获、输出比较、PWM生成、编码器接口等等。把定时中断这条链路彻底搞明白后面的高级用法都是在这个基础上叠加功能。 
长河君 · 2026/10/29 1:13:21 · 阅读 1.2k STM32定时器中断实战：CubeMX配置与HAL库回调全解析
1. 为什么定时器是STM32入门的分水岭很多人学STM32GPIO点灯、按键扫描、串口打印这三板斧耍得挺溜一到定时器就卡壳。我见过太多人卡在这一步中断进不去、进了中断出不来、时间算不对、LED闪得跟抽风一样。其实定时器这东西说穿了就是一个会数数的硬件你给它一个时钟源它就开始数数到某个值就告诉你一声。就这么简单。但为什么大家觉得难因为CubeMX里定时器的参数页面一打开Prescaler、Counter Period、Clock Division、auto-reload preload、各种中断使能密密麻麻一堆选项不知道哪个该填什么。再加上HAL库的中断回调函数名字又长又绕HAL_TIM_PeriodElapsedCallback第一次见的人根本不知道这玩意儿该往哪儿放。这篇内容就是来解决这个问题的。我以STM32F103C8T6这块最经典的入门芯片为例用CubeMX从零配置一个定时器定时中断让LED按照精确的1秒周期闪烁。整个过程拆解成可复现的步骤每个参数为什么这么填、中断回调为什么这么写、时间怎么算出来的全部讲透。不管你是刚学完GPIO的新手还是被定时器折磨过想重新理一遍的老哥这篇都能让你把定时器定时中断这条链路彻底跑通。关键词就几个CubeMX、STM32、定时器、HAL库、定时中断。围绕这几个词我把配置逻辑、时钟树计算、代码结构、常见翻车点全部展开。看完你至少能做到三件事第一独立算出任意定时时间的Prescaler和Counter Period组合第二知道HAL库定时中断的完整调用链路第三遇到中断不触发或者频率不对的时候有一套排查思路。2. 定时器定时中断的硬件逻辑与CubeMX配置路径2.1 定时器到底在数什么从时钟源到更新事件STM32的通用定时器比如TIM2、TIM3、TIM4挂载在APB1总线上高级定时器TIM1、TIM8挂在APB2上。以TIM2为例它的时钟来源是APB1的倍频输出。这里有个很多人忽略的细节APB1的预分频系数如果不为1定时器时钟会自动倍频。比如系统时钟72MHzAPB1预分频设为2APB1总线时钟是36MHz但定时器时钟是72MHz。这个规则在参考手册的时钟树章节写得很清楚但CubeMX的时钟树界面会直接显示最终值你只要看那个数字就行。定时器的基本工作流程是这样的时钟信号进入定时器后先经过预分频器Prescaler把高频时钟降到一个合适的频率然后驱动计数器Counter开始计数。计数器从0往上数数到自动重装载寄存器Auto-Reload RegisterARR的值时产生一个更新事件Update Event同时计数器清零重新开始。如果你使能了更新中断这个更新事件就会触发中断CPU跳转到中断服务函数执行你的代码。用生活化的类比预分频器就像水龙头的阀门控制水流速度计数器就像一个水桶在接水ARR就是水桶的容量。水满了计数到ARR就溢出来一次更新事件然后桶清空重新接。你调节阀门Prescaler和换不同大小的桶ARR就能控制多久溢一次。2.2 CubeMX中TIM3的逐项配置与参数计算打开CubeMX选好芯片型号STM32F103C8T6之后在左侧外设列表里找到Timers展开后点击TIM3。中间的引脚图会显示TIM3的四个通道引脚但我们做定时中断不需要占用引脚所以不用管通道配置只配置NVIC和参数设置就行。在TIM3的配置面板里有几个关键项Clock Source选择Internal Clock意思是使用内部时钟源。这个必须选对如果选错了成External Clock Mode定时器就等着外部信号触发永远等不到。Prescaler填7199。这个数字怎么来的系统时钟72MHz预分频器实际分频系数是Prescaler1所以71991720072MHz除以7200等于10kHz。也就是说经过预分频后计数器每0.1毫秒加1。Counter Mode选Up向上计数。这是最常用的模式从0数到ARR。Counter Period填9999。这个就是ARR的值。计数器从0数到9999一共数10000次。每次0.1毫秒10000次就是1000毫秒也就是1秒。所以定时周期就是1秒。auto-reload preload建议使能。这个选项的作用是当你中途想改ARR的值时新值不会立即生效而是等当前计数周期结束后才生效。这样可以避免计数过程中改ARR导致时序错乱。对于固定周期的应用使能与否影响不大但养成使能的习惯没坏处。Trigger Event Selection保持默认的Reset就行这个跟定时中断没关系。配置完参数后切到NVIC Settings标签页找到TIM3 global interrupt勾选Enabled。这一步是使能定时器的更新中断不勾的话中断永远不会触发。注意很多人配置完参数忘了开NVIC中断然后烧录进去发现LED不闪查半天代码没问题最后发现是中断没使能。这个坑我踩过不止一次。2.3 时钟树确认别让默认值骗了你CubeMX的时钟树页面Clock Configuration一定要看一眼。默认情况下如果你选了外部晶振HSECubeMX会自动配置PLL把系统时钟拉到72MHz。但如果你用的是芯片内部的HSI系统时钟可能只有8MHz或者64MHz这时候你按72MHz算出来的定时参数就不对了。具体确认方法在时钟树页面找到APB1 Timer clocks这一栏看它显示的数字。如果是72MHz那上面的计算没问题。如果是36MHz那Prescaler和ARR都要重新算。比如36MHz时钟想要1秒定时可以Prescaler填3599分频后10kHzARR填9999结果一样。我一般习惯在时钟树页面截个图把各个总线的时钟频率记下来配定时器的时候直接对照省得来回切页面。3. 中断回调的代码结构与HAL库调用链路3.1 从main函数到回调函数完整调用链路拆解CubeMX生成代码后main函数里会自动调用MX_TIM3_Init()完成定时器初始化。但初始化完定时器还不会开始工作你需要在main函数里手动调用HAL_TIM_Base_Start_IT(htim3)来启动定时器并使能中断。这个函数的调用位置很关键。必须在所有初始化完成之后、进入主循环之前调用。我一般放在MX_GPIO_Init()之后while(1)之前。启动之后定时器开始计数每满一个周期触发一次更新中断。中断触发后CPU自动跳转到中断向量表里TIM3对应的入口执行TIM3_IRQHandler()。这个函数在stm32f1xx_it.c文件里CubeMX会自动生成。函数体里调用HAL_TIM_IRQHandler(htim3)这是HAL库的中断处理函数。HAL_TIM_IRQHandler()内部会判断中断类型如果是更新中断Update Interrupt就清除中断标志位然后调用HAL_TIM_PeriodElapsedCallback()。这个回调函数是一个弱函数weak function默认是空的需要你自己在代码里重写。完整链路是这样的TIM3计数溢出 → 硬件触发更新中断 → TIM3_IRQHandler() → HAL_TIM_IRQHandler(htim3) → 判断中断类型 → 清除标志位 → HAL_TIM_PeriodElapsedCallback(htim3) → 你写的业务代码理解这条链路非常重要因为后面排查问题时你需要知道中断卡在哪一环。3.2 回调函数写在哪里位置和写法都有讲究HAL_TIM_PeriodElapsedCallback()这个函数我建议写在main.c文件里放在main()函数后面、while(1)外面。不要写在stm32f1xx_it.c里虽然写那里也能跑但代码组织上不清晰后期维护麻烦。写法如下void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } }注意几个细节第一函数名必须和HAL库里的弱函数完全一致大小写都不能错。第二参数类型是TIM_HandleTypeDef *不是TIM_TypeDef *这两个容易搞混。第三一定要判断htim-Instance因为如果你同时用了多个定时器所有定时器的更新中断都会进这个回调不判断的话就乱套了。提示如果你只用一个定时器不判断Instance也能跑但这是坏习惯。我见过一个项目用了TIM2和TIM3两个定时器回调里没判断结果TIM2中断触发了TIM3的业务代码查了一下午才发现。3.3 中断优先级配置什么时候需要改什么时候不用管CubeMX的NVIC配置页面里TIM3 global interrupt默认的抢占优先级和响应优先级都是0。对于只有一个中断源的简单应用用默认值完全没问题。但如果你同时用了串口中断、外部中断、定时器中断就需要考虑优先级了。抢占优先级高的中断可以打断抢占优先级低的中断。比如串口接收中断需要快速响应可以把它的抢占优先级设高一点定时器中断只是闪个LED优先级低一点无所谓。STM32F103的NVIC支持4位优先级CubeMX里可以设置0到15。数值越小优先级越高。我一般的分配原则是通信类中断串口、SPI优先级最高设1或2定时器中断中等设3或4按键外部中断最低设5或6。这样保证通信不丢数据定时器也不会被按键抖动频繁打断。4. 定时时间计算的通用公式与参数速查4.1 从公式到直觉三步算出任意定时周期定时时间的计算公式定时周期 (Prescaler 1) × (Counter Period 1) / 定时器时钟频率反过来如果你想要一个特定的定时周期可以这样算第一步确定定时器时钟频率。STM32F103通常TIM2、TIM3、TIM4是72MHzTIM1、TIM8也是72MHz。第二步选定Prescaler。Prescaler决定了计数器的计数频率。我一般喜欢把计数频率定在1kHz到10kHz之间这样ARR的值不会太大也不会太小。比如72MHz时钟Prescaler填7199得到10kHz计数频率。第三步用计数频率乘以想要的定时时间得到ARR的值。比如想要1秒10kHz × 1s 10000ARR填9999因为从0开始数。想要0.5秒ARR填4999。想要2秒ARR填19999。想要10毫秒ARR填99。4.2 常用定时周期参数对照表定时周期定时器时钟Prescaler计数频率Counter Period实际周期1秒72MHz719910kHz99991.000s500毫秒72MHz719910kHz49990.500s100毫秒72MHz719910kHz9990.100s10毫秒72MHz719910kHz990.010s1毫秒72MHz719910kHz90.001s1秒36MHz359910kHz99991.000s1秒8MHz79910kHz99991.000s这张表可以直接抄作业。注意最后一列实际周期因为Prescaler和ARR都是整数有时候算出来不是刚好整数会有微小误差。比如你想要1秒但时钟是72MHzPrescaler填7199、ARR填9999实际周期是(71991)×(99991)/72000000 72000000/72000000 1.000秒刚好。但如果时钟是64MHzPrescaler填6399、ARR填9999实际周期是64000000/64000000 1.000秒也刚好。只要时钟频率能被整除就没有误差。4.3 当定时时间超过单次计数范围怎么办16位定时器的ARR最大是65535。如果你用10kHz计数频率最大定时时间是6.5535秒。想要更长的定时时间怎么办方法一降低计数频率。比如Prescaler填7199改成71999计数频率变成1kHzARR最大65535最大定时时间65.535秒。但这样定时精度就降到1毫秒了。方法二在中断里加一个软件计数器。比如定时器每100毫秒中断一次中断里countcount到10就是1秒。这样既能保证定时精度又能实现长时间定时。static uint8_t count 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { count; if (count 10) { count 0; HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } } }方法三用32位定时器。STM32F4、F7等系列有32位定时器ARR可以到4294967295但F103没有所以入门阶段还是用前两种方法。5. 中断不触发、频率不对的排查链路5.1 从现象反推LED完全不闪和闪得太快分别查什么LED完全不闪可能的原因按概率排序第一NVIC中断没使能。回CubeMX检查TIM3 global interrupt有没有勾上。这个是最常见的我估计占所有问题的四成以上。第二HAL_TIM_Base_Start_IT()没调用。CubeMX生成的代码只初始化定时器不会自动启动。你必须在main函数里手动调用这个函数。检查一下是不是漏了。第三回调函数名写错了。HAL_TIM_PeriodElapsedCallback注意是PeriodElapsed不是PeriodElapsedCallback的拼写错误也不是Period_Elapsed。HAL库的弱函数名是固定的写错了就不会被调用。第四GPIO初始化有问题。如果你用的是PC13接LED检查MX_GPIO_Init()里有没有把PC13配置成推挽输出。CubeMX里要在GPIO页面手动设置PC13为GPIO_Output。第五中断服务函数被删了或者改了。stm32f1xx_it.c里的TIM3_IRQHandler()是CubeMX生成的如果你不小心删了或者改了函数名中断就进不去。LED闪得太快可能的原因第一Prescaler或ARR算错了。比如想要1秒结果Prescaler填了719ARR填了999那就是0.1秒闪一次。重新按公式算一遍。第二时钟树配置和预期不符。比如你以为系统时钟是72MHz实际是8MHz那定时时间就差了9倍。去时钟树页面确认APB1 Timer clocks的值。第三中断里做了耗时操作。比如在回调里调用了HAL_Delay()这会导致中断响应变慢但不会让LED闪得更快。闪得太快一般是参数问题。5.2 用调试器和串口打印定位中断是否真的进了如果LED不闪但你不确定是中断没进还是GPIO有问题可以用调试器打断点。在HAL_TIM_PeriodElapsedCallback()函数第一行打个断点全速运行看能不能停在这里。能停说明中断进了问题在GPIO或者业务代码不能停说明中断链路有问题回去查NVIC和启动函数。没有调试器的话可以在回调里翻转另一个GPIO用示波器或者逻辑分析仪看波形。或者用串口打印在回调里发一个字符串口助手看有没有输出。但注意串口打印本身比较耗时如果定时周期很短比如1毫秒在中断里打印会导致中断处理时间过长影响下一次中断。我一般用GPIO翻转法在回调里翻转一个空闲引脚用示波器测频率。如果测出来是500Hz说明中断每2毫秒进一次对应定时周期2毫秒。这个方法最直接不需要打断点也不影响中断时序。5.3 中断标志位没清除导致的卡死现象有一种情况是LED闪了一下就不闪了或者程序跑飞了。这很可能是中断标志位没清除导致中断反复触发CPU一直卡在中断里出不来。HAL库的HAL_TIM_IRQHandler()内部会自动清除更新中断标志位正常情况下不需要你手动清。但如果你在回调函数里又触发了其他中断或者中断优先级配置有问题可能会导致标志位清除不及时。排查方法在TIM3_IRQHandler()里HAL_TIM_IRQHandler(htim3)之前加一句__HAL_TIM_CLEAR_IT(htim3, TIM_IT_UPDATE)手动清除标志位。如果加了这句问题就解决了说明是标志位清除的问题。不过更常见的情况是你在中断回调里调用了HAL_Delay()。HAL_Delay()依赖SysTick中断而SysTick的优先级默认比TIM3低。如果TIM3中断一直在触发SysTick中断就永远得不到执行HAL_Delay()就卡死了。所以记住一条铁律中断回调里绝对不要用HAL_Delay()。6. 从定时中断延伸出去的几个实用场景6.1 用定时中断做精准的软件延时替代HAL_DelayHAL_Delay()的精度受SysTick影响而且它是阻塞式的调用期间CPU什么都干不了。用定时中断可以做一个非阻塞的延时volatile uint32_t tick 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { tick; } } void delay_ms(uint32_t ms) { uint32_t start tick; while ((tick - start) ms); }这个delay_ms()不阻塞其他中断而且精度取决于定时器中断周期。如果定时器1毫秒中断一次delay_ms(100)就是等100个tick精度在1毫秒以内。6.2 定时中断驱动状态机按键消抖和LED呼吸灯按键消抖的经典做法是用定时中断每10毫秒扫描一次按键连续几次读到相同状态才确认。这样不需要在中断里延时也不会阻塞主循环。LED呼吸灯可以用定时中断配合PWM但PWM本身有硬件支持不需要中断。如果非要用中断做可以在中断里改变PWM的占空比每10毫秒调整一次实现渐变效果。6.3 多定时器协同一个做系统滴答一个做业务定时STM32F103有多个定时器可以一个做系统滴答比如TIM2每1毫秒中断一次维护系统tick另一个做业务定时比如TIM3每100毫秒中断一次扫描传感器。两个定时器中断优先级可以设成一样也可以设成系统滴答优先级高一点。注意如果两个定时器都用HAL_TIM_PeriodElapsedCallback()一定要在回调里判断htim-Instance否则会互相干扰。7. 我踩过的几个坑和总结的经验第一个坑CubeMX里改了定时器参数但忘记重新生成代码。CubeMX修改配置后必须点GENERATE CODE否则代码还是旧的。我有时候改完参数直接编译烧录发现没变化查半天才发现没生成。第二个坑在中断回调里调用了printf()。printf()底层是串口发送串口发送是阻塞的在中断里调用会导致中断处理时间过长。如果串口波特率是115200发一个字符大概87微秒发一行字符串就是几毫秒。定时器1毫秒中断一次的话中断还没处理完下一次又来了程序就卡死了。第三个坑Prescaler和ARR填反了。Prescaler是预分频ARR是计数上限。有人把7199填到ARR9999填到Prescaler结果定时时间完全不对。记住Prescaler一般填大数几千到几万ARR填相对小的数取决于定时周期。第四个坑用了HAL库的HAL_TIM_Base_Start()而不是HAL_TIM_Base_Start_IT()。前者只启动定时器不使能中断后者才使能中断。名字差一个_IT功能差很多。第五个坑时钟树里APB1预分频系数不为1时定时器时钟是APB1时钟的2倍。这个规则在F103上成立但不同系列可能不一样。最保险的方法就是看CubeMX时钟树页面显示的APB1 Timer clocks值以那个为准。最后分享一个我常用的调试技巧在CubeMX里配置一个空闲GPIO在定时器中断回调里翻转它。用示波器或者逻辑分析仪测这个GPIO的频率就能直观看到定时器中断的实际周期。这个方法比串口打印更可靠也不会影响中断时序。测出来的频率如果是500Hz说明中断周期是2毫秒如果是1kHz说明中断周期是1毫秒。跟你的预期对比就能快速判断参数配置对不对。定时器这东西入门的时候觉得复杂用熟了之后发现它是STM32里最灵活的外设之一。定时中断只是最基础的用法后面还有输入捕获、输出比较、PWM生成、编码器接口等等。把定时中断这条链路彻底搞明白后面的高级用法都是在这个基础上叠加功能。