搞 STM32 定时器这么多年我见过最多人问的问题不是定时器不工作而是定时时间算出来和实际完全对不上。凡是做过 1ms 延时、PWM 调速、输入捕获、编码器测速的基本都在这三个词上栽过跟头PSC、ARR 和时钟源。今天就一次性把它们讲透顺便把最容易算错的三个地方连原因带解法全拆开。这篇内容比较适合以下人群刚接触 STM32 标准库或者 CubeMX 的初学者以及已经会点灯但调 PWM 频率怎么都调不准的进阶玩家。如果你曾经遇到过“我按公式算了 ARR出来的周期却慢了一倍”“改了 PSC 下次定时却不生效”“用示波器一看 PWM 频率总是差一半”这类问题那这篇文章就是给你写的。1. PSC 最容易算错的点分频值永远差“1”1.1 预分频器寄存器存的是“分频系数减 1”不是实际分频值先看一个我在群里被问烂的问题有人想得到 1MHz 的计数时钟也就是计数器每 1us 加一次定时器输入时钟是 72MHz他直接写了 PSC 72结果频率并不是 1MHz。问题就出在这儿。定时器的预分频器 PSC 是一个 16 位寄存器它描述的是“计数器时钟被分频多少倍”但寄存器里保存的数值是分频倍数减 1。实际分频倍数 PSC 寄存器值 1 计数器时钟 定时器输入时钟 / (PSC 1)所以想从 72MHz 得到 1MHz实际需要的分频倍数是 72 倍寄存器值应该填 71不是 72。你填了 72实际分频倍数是 73得到的是 72MHz / 73 986.3kHz周期不是 1us 而是 1.013us。单看一个周期误差也就 1.3%但如果用它做 1000 次的累计定时误差就放大到 13us。放到电机控制或者通信协议里这种误差足够让波形错乱了。这个“减 1”问题本质上是寄存器从 0 开始编号的典型坑。就像数组下标从 0 开始一样PSC 的 0 就代表“不分频”1 代表“2 分频”71 代表“72 分频”。你只有记住这个前提后面 ARR 的计算才不糊涂。1.2 PSC 值不仅决定定时长度还决定了分辨率PSC 的数值选择还有个容易被忽略的维度它决定了计数器的分辨率。举个例子。定时器时钟 72MHzPSC 寄存器值实际分频倍数计数时钟频率每个计数脉冲时长定时范围ARR 最大 655350172MHz13.9ns0.91ms71721MHz1us65.5ms7199720010kHz100us6.55s71999720001kHz1ms65.5s注意最后一行PSC 是 16 位寄存器最大值是 65535所以 PSC 71999 是可以的但 PSC 71999 代表实际 72000 分频。你要是忘了减 1 写成 72000寄存器直接溢出编译可能不报错但实际写入的是 72000 0xFFFF 6464分频就混乱了。这里推荐一个经验法则先确定你需要的分辨率再反推 PSC。比如你要做 1ms 的定时中断计数时钟用 1MHz每次计数代表 1us那 PSC 就填 71ARR 再按 1000 去算等一下ARR 这里也要减 1下一节细说。还有个我从实际调试里总结出来的习惯PSC 尽量让计数时钟是整数频率这样 ARR 计算和示波器验证都方便。比如 72MHz 的主频PSC 选 71 得到 1MHz选 7 得到 9MHz这个就不是整数了算起来不舒服如果你用的是 80MHz 主频PSC 可以选 79 得到 1MHz也可以选 159 得到 500kHz。总之让计数时钟变成 1/10/100/1000 这类好算的数能省你后面调试时大量口算时间。1.3 运行中修改 PSC 不生效因为影子寄存器在作怪这是另一个高频坑。程序跑着跑着你想动态改一下定时器的分频于是给 PSC 赋了个新值结果发现定时时间还是旧的。不是赋值没成功而是 PSC 寄存器默认是带影子寄存器的。所谓影子寄存器就是你在程序里写的值不会立刻进入工作区而是先放在预装载寄存器里等更新事件到来后才一次性装载到真正参与工作的影子寄存器。如果你没有正确触发更新事件预装载值就永远躺在那里不生效。解决方式很简单每次改完 PSC 或者 ARR手动产生一个更新事件TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; /* ... 初始化配置 ... */ // 修改分频值 TIM_TimeBaseStructure.TIM_Prescaler 71; TIM_TimeBaseInit(TIM3, TIM_TimeBaseStructure); // 强制产生更新事件让预装载值立即生效 TIM3-EGR | TIM_EGR_UG;有人会问为什么有些人初始化的时候没有主动置位 UG 也正常因为TIM_TimeBaseInit函数内部最后会做一次软件触发更新事件部分版本的标准库和 HAL 库实现不一样建议依赖外设复位/重新初始化流程别赌它自动触发。如果你在运行过程中只改了寄存器却不产生更新事件下一个周期就会继续用旧值表现出来就是“改了没反应”。2. ARR 最容易算错的点溢出值不等于定时周期2.1 ARR 目标计数个数 - 1这个坑比 PSC 更隐蔽如果说 PSC 的减 1 是明坑ARR 的减 1 就是暗坑。很多人记住了 PSC 要减 1到了 ARR 这里反而忘了。计数器的工作方式是从 0 开始向上计数一直数到 ARR然后产生更新事件并清零重新开始。所以一个完整的定时周期里计数器走过的数值个数是 ARR 1。定时时间的完整公式定时时间 (PSC 1) × (ARR 1) / 定时器输入时钟频率举个例子定时器输入时钟 72MHz我想做 1ms 定时中断。先把 PSC 设为 71实际分频 72得到计数时钟 1MHz1us 一次1ms 需要计数器走 1000 个脉冲ARR 1000 - 1 999不管你用标准库还是 CubeMX把这个逻辑吃透比背公式管用。CubeMX 里你填的 Counter Period 其实就是 ARR 寄存器值很多人习惯性地在 CubeMX 里面填 1000然后跑到示波器上一看周期是 1.001ms——其实只差了 1us但如果你做长延时或者多个定时器做同步误差就会累积。这里给一个速查表假设定时器时钟 72MHz、PSC 71计数时钟 1MHz目标定时时间ARR 值公式验证1us0(711)×(01)/72MHz 1us10us9(711)×(91)/72MHz 10us100us99(711)×(991)/72MHz 100us1ms999(711)×(9991)/72MHz 1ms10ms9999(711)×(99991)/72MHz 10ms注意第一行ARR 0 不代表定时器不工作而是计数器从 0 数到 0 就更新也就是每个计数脉冲产生一次更新事件频率等于计数时钟频率。这在某些特殊场景下有用但大部分人看到 ARR 0 会愣一下以为配置错了。2.2 PWM 频率里 ARR 和 CCR 的边界情况100% 占空比的坑PWM 模式是定时器另外一大应用而这里 ARR 的坑换了个马甲继续坑人。我们以向上计数、PWM 模式 1 为例。输出有效电平的条件是CNT CCRCNT 从 0 计到 ARR 再回到 0所以 PWM 周期 (ARR 1) × (PSC 1) / 时钟频率占空比 CCR / (ARR 1)。看到没占空比的分母是 ARR 1不是 ARR。这就带来一个经典问题想让 PWM 输出 100% 占空比CCR 应该写成多少理论上CCR ARR 就可以让 CNT 在整个计数周期内都满足CNT CCR输出恒为有效电平。但实际操作中很多人把 CCR 设成 ARR 后示波器上看到输出并不是持续高电平而是带一个很窄的低电平毛刺。原因在于计数器在到达 ARR 并产生更新事件的瞬间会清零紧接着的一小段逻辑判断时间里如果输出比较比较的是“CNT 与 CCR 的相对大小”而不是“CNT 是否小于 CCR”边界处就可能出现短暂无效电平。解决这个问题的稳妥做法是需要 100% 占空比时不要依赖 PWM 比较输出而是直接切换到强制输出模式或者把 CCR 配成大于 ARR 的值。比如 ARR 99需要 100% 占空比就写 CCR 100 甚至 CCR 101。但注意 CCR 也是 16 位寄存器不要写超出 65535 的值否则同样会回绕变成极低占空比。反过来0% 占空比也有类似问题。CCR 0 时CNT 从 0 开始CNT CCR只有当 CNT 0 且 CCR 0 时为假其余时间 CNT CCR输出无效电平。理论上能输出 0%但边界时刻同样可能产生一个极窄的毛刺。对控制类应用来说这种毛刺可能直接导致 MOS 管误导通所以强烈建议使用刹车或者强制输出模式处理极端占空比场景。2.3 预装载与影子寄存器在 ARR 上同样适用PSC 有影子寄存器ARR 同样有。默认情况下 ARR 的预装载功能可能是关闭的但如果你在 CubeMX 里勾选了 Auto-Reload Preload那么运行中修改 ARR 并不会立刻改变定时周期要等更新事件。我在实际项目里踩过一个这样的坑做无人机遥控信号解析需要在捕获到一次上升沿后动态调整下一个周期定时器的溢出值结果因为 ARR 预装载没关改完寄存器后总要等一个旧周期才生效导致信号解析老是慢一拍。这里给个建议如果你有“运行中改 ARR”的需求看清你的初始化配置。CubeMX 里 TIMx 的 Auto-Reload Preload 选项开了就是预装载模式关了是立即生效模式。标准库里则对应TIM_TimeBaseStructure.TIM_ClockDivision旁边那个TIM_RepetitionCounter和 ARR 预装载使能位。实际调试时不确定就先关掉预装载让 ARR 修改立即生效逻辑排查会简单很多。3. 时钟源最容易算错的点总线时钟不等于定时器时钟3.1 时钟树里暗藏“倍频”规则最容易阴沟翻船前两节计算时我一直说“定时器输入时钟”但这个值到底是多少很多人是从 CubeMX 的时钟树里直接看的一旦自己移植到标准库就开始乱套。STM32 的定时器时钟不总是等于它挂在的总线时钟。拿最常见的 STM32F103 来说系统时钟 SYSCLK 72MHzAHB 预分频为 1HCLK 72MHzAPB1 预分频为 2PCLK1 36MHzAPB2 预分频为 1PCLK2 72MHz。TIM2、TIM3、TIM4、TIM5、TIM6、TIM7 挂在 APB1 上它们的定时器时钟不是 36MHz而是72MHz。这是个容易让人懵的规则如果 APBx 预分频系数为 1则挂在该总线上的定时器时钟等于总线时钟如果 APBx 预分频系数大于 1则挂在该总线上的定时器时钟等于总线时钟的 2 倍。所以 STM32F103 里挂在 APB1 上的定时器时钟 36MHz × 2 72MHz挂在 APB2 上的 TIM1 和 TIM8因为 APB2 预分频为 1所以时钟 72MHz。总线总线预分频总线时钟定时器时钟倍率最终定时器时钟APB1 (F103)236MHz×272MHzAPB2 (F103)172MHz×172MHzAPB1 (F4 系列按默认配置)242MHz×284MHzAPB2 (F4 系列)184MHz×184MHz很多人在标准库工程里直接用SystemCoreClock / 1000之类的方式去给 ARR 赋值完全忽略了总线预分频倍频规则最后算出来的定时时间比实际快了或者慢了一倍。我遇到过最典型的案例是某个板子用了 8MHz 外部晶振PLL 倍频到 72MHz结果 APB1 预分频配置被某个初始化函数改成了 4导致 PCLK1 18MHz定时器时钟 36MHz与理论值 72MHz 差了一倍。那位朋友调了三天没找到原因最后用示波器测 TIM3 输出频率才发现基准就不对。排查这类问题有个笨但有效的方法先用 RCC 寄存器把时钟树的关键分频值都读出来打印或者调试器查看确认总线时钟与定时器时钟的实际关系再开始算 PSC 和 ARR。别上来就调定时器那样连变量都找不准。3.2 内部时钟、外部时钟模式与捕获应用的选择除了时钟树提供的内部时钟定时器还可以选择外部时钟作为计数源这又是一个容易模糊的领域。内部时钟来自时钟树适用于定时中断、PWM 输出等常规场景。外部时钟模式 1从 TIx 输入引脚或 ETR 引脚提供时钟常见于输入捕获测频率、编码器测速。外部时钟模式 2仅从 ETR 引脚提供时钟适合对精度要求较高的外部脉冲计数。我见过有人做频率测量直接在输入捕获中断里翻转 GPIO 看波形然后说频率不对。其实测频率最稳的用法不是开定时器内部时钟定时然后捕获外部信号而是把外部信号作为定时器的计数时钟定时器工作在外部时钟模式然后用另一个定时器或者内部计时设施去门控计数。这个思路改起来后频率测量精度立刻提升一个量级。外部时钟模式下PSC 和 ARR 的作用依然成立但输入时钟变成了外部信号。此时要注意外部信号经过触发滤波器和极性选择可以先配置上升沿/下降沿触发再配置数字滤波器。滤波器在快速信号下会造成额外延迟高频测量时要把滤波设成不滤波或者最短采样时间否则测出来的频率会偏低。3.3 低功耗定时器 LPTIM 和 RTC 的时钟源是另一套体系如果你用的是低功耗定时器 LPTIM 或者 RTC 做唤醒定时时钟源选择和通用定时器完全不是一个路子。LPTIM 可以用 LSI、LSE、HSE 甚至内部参考时钟RTC 一般用 LSE 或者 HSI 分频。这里最常见的坑是LSE 没起振RTC 或者 LPTIM 的时间就完全不对。有人拿着例子工程直接在内部 RC 振荡器下跑后来换了带外部 32.768kHz 晶振的板子程序里改了初始化结果还是不走时。排查了半天发现晶振两侧的负载电容没焊或者匹配电容值不对LSE 振幅太小导致起振失败。LSE 起振慢是出了名的有的人初始化后立刻读取 RTC 寄存器读到全零就以为芯片坏了。实际上 LSE 可能要花几百毫秒甚至更久才稳定稳妥的做法是启动 LSE 后轮询RCC_GetFlagStatus(RCC_FLAG_LSERDY)等它置位后再初始化 RTC。这个细节在很多基础教程里不会讲但实战中迟早会遇到。4. 完整实例把 1ms 中断和 10kHz PWM 一次性算对4.1 需求拆解与完整计算公式用一个实际项目例子把前面所有内容串起来我需要 TIM3 产生 1ms 周期中断同时用 TIM3 的 CH1 输出 10kHz 的 PWM占空比 50%。先拆需求两个功能共用一个定时器PSC 和 ARR 只能有一组所以需要先确定一套参数。定时器输入时钟STM32F103APB1 预分频为 2定时器时钟 72MHz。1ms 中断计数时钟选 1MHz即 PSC 71。那么 1ms 需要 1000 个计数脉冲ARR 999。10kHz PWM周期 100us在计数时钟 1MHz 下需要 100 个计数脉冲。但 ARR 只能有一个值不能同时是 999 和 99。所以同一个定时器里要满足 1ms 中断同时输出 10kHz PWM严格来说是做不到的除非用主从定时器配合或者两个定时器各管一路。我改成更符合实际项目场景的组合TIM3 做 1ms 定时中断TIM4 做 10kHz PWM 输出。两个定时器都挂在 APB1 上输入时钟都是 72MHz。TIM3 的配置参数值说明PSC71实际 72 分频计数时钟 1MHzARR999计数 1000 个脉冲中断周期 1ms中断使能更新中断每 1ms 进一次中断TIM4 的配置参数值说明PSC7实际 8 分频计数时钟 9MHzARR899计数 900 个脉冲PWM 周期 100usCCR1450占空比 50%验证一下 TIM4 的 PWM 频率9MHz / 900 10kHz占空比 450 / 900 50%。注意这里 CCR 占比的分母是 ARR 1 900不是 ARR 899所以 CCR 填 450 正好一半。PSC 之所以选 7 而不是 71是因为 72MHz / (711) 1MHz周期 100us 需要 100 个脉冲ARR 就得是 99但 10kHz 对应 100us如果 ARR 99也可以。两种都行但我更推荐 PSC 7、ARR 899 这种组合因为 CCR 调节步进更细占空比分辨率更高。这就是前面说的 PSC 选择会影响调节精度。4.2 标准库初始化代码实操TIM3 定时中断初始化void TIM3_Init(void) { TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; NVIC_InitTypeDef NVIC_InitStructure; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); TIM_TimeBaseStructure.TIM_Prescaler 71; // PSC 71实际 72 分频 TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseStructure.TIM_Period 999; // ARR 999计数 1000 个脉冲 TIM_TimeBaseStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInit(TIM3, TIM_TimeBaseStructure); TIM_ITConfig(TIM3, TIM_IT_Update, ENABLE); NVIC_InitStructure.NVIC_IRQChannel TIM3_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority 0; NVIC_InitStructure.NVIC_IRQChannelSubPriority 0; NVIC_InitStructure.NVIC_IRQChannelCmd ENABLE; NVIC_Init(NVIC_InitStructure); TIM_Cmd(TIM3, ENABLE); }中断服务函数里注意清标志void TIM3_IRQHandler(void) { if (TIM_GetITStatus(TIM3, TIM_IT_Update) ! RESET) { TIM_ClearITPendingBit(TIM3, TIM_IT_Update); // 你的 1ms 周期任务 } }如果你用 CubeMX参数就按上面的思路填Prescaler 填 71Counter Period 填 999Auto-Reload Preload 根据需要开关。有人会纠结 CubeMX 里填 PSC 71 还是 72实际上 CubeMX 填的就是 PSC 寄存器值所以是 71。TIM4 的 PWM 输出初始化void TIM4_PWM_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM4, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_6; // TIM4_CH1 映射到 PB6 GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); TIM_TimeBaseStructure.TIM_Prescaler 7; // PSC 7实际 8 分频 TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseStructure.TIM_Period 899; // ARR 899 TIM_TimeBaseStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInit(TIM4, TIM_TimeBaseStructure); TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse 450; // CCR1 450占空比 50% TIM_OCInitStructure.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM4, TIM_OCInitStructure); TIM_Cmd(TIM4, ENABLE); }4.3 用示波器和 GPIO 翻转法验证计算结果配好之后别急着接电机先用示波器验证。PWM 输出可以在 PB6 上直接测确认周期是 100us、频率是 10kHz、占空比是 50%。1ms 定时中断可以从 GPIO 翻转来验证。初始化时把一个 GPIO 设为推挽输出中断服务函数里翻转这个引脚示波器量引脚上的方波周期应该是 2ms高电平 1ms、低电平 1ms频率 500Hz。如果示波器上看到周期是 4ms也就是 2ms 定时间隔被翻倍了优先检查时钟树配置。最常见的两种情况APB1 预分频被设成 4或者外部晶振实际频率不是 8MHz 导致 SystemCoreClock 不是 72MHz。别一上来就怀疑 ARR 算错先用调试器看 RCC_CFGR 寄存器的值确认时钟树。如果测出来的周期是 999us 而不是 1000us说明 ARR 少算了 1中断间隔少了 1us。这种误差用示波器看可能不敏感但用频率计或者长时间统计就很明显。5. 定时器计算踩坑速查表场景/错误现象根本原因快速解决定时周期慢一倍总线时钟没算对或 APB1/APB2 倍频规则没考虑用调试器读时钟树确认实际定时器时钟定时周期差一点点PSC 或 ARR 忘记减 1用公式反推时间 (PSC1)×(ARR1)/时钟PWM 频率偏一半忘记 APB1 预分频为 2 时定时器时钟 ×2查 RCC 时钟配置确认定时器输入时钟PWM 100% 占空比输出有毛刺CCR ARR 在边界比较逻辑上不稳定强制输出模式或 CCR ARR运行中改 PSC/ARR 不生效影子寄存器/预装载功能开启关掉 ARR 预装载或改完产生更新事件外部脉冲计数不准触发滤波器配置不当或时钟源选择错误高频信号关滤波确认外部时钟模式配置LPTIM/RTC 唤醒时间不对LSE 未起振或负载电容问题轮询 LSERDY 标志检查晶振电路中断标志不清导致频繁进入忘记清更新中断标志中断服务函数里调用 TIM_ClearITPendingBit排查定时器问题我的顺口溜是“先时钟再分频后重载最后看输出”。时钟源没搞对后面 PSC 和 ARR 算得再精确也是白搭。写配置的时候手边建议摆一张 APB 分频和定时器时钟倍率的速查表或者直接把 CubeMX 的时钟树截图存手机里。我在实际项目里的习惯是每次新建工程第一件事先把 RCC 时钟配置完整地走一遍并顺手把 SystemCoreClock 打印出来确认和预期一致再写外设初始化。这一步虽然不起眼但能帮你把定时器相关的坑从源头铲掉一大半。最后分享一个小技巧是我调试定时器时一定会做的在初始化函数末尾加一个 500ms 级别的延时再去读定时器的计数器 CNT观察它是否按预期增长。如果 CNT 的增长速度和理论不匹配多半是时钟源或者分频的问题如果 CNT 正常但中断没进再查 NVIC 和中断标志。这个分步定位法比对着寄存器手册瞎猜效率高多了。