1. 项目概述从“定时”与“计数”理解STM32的脉搏在嵌入式开发尤其是基于STM32这类微控制器的项目中“定时器”绝对是一个绕不开的核心外设。很多朋友初学时会觉得它神秘又复杂配置寄存器看得人眼花缭乱。但如果我们换个角度把它想象成微控制器内部的“多功能秒表”和“事件计数器”事情就清晰多了。这个“秒表”不仅能精准地告诉你时间过去了多久定时还能记录外部引脚上发生了多少次电平跳变计数。无论是让LED灯每隔一秒闪烁一次还是测量一个旋转编码器转了多少格亦或是产生特定频率的PWM波驱动电机其底层都离不开定时器的运作。今天我们就聚焦于STM32的标准外设库Standard Peripheral Library来彻底搞懂定时器的两大基础功能定时与计数。标准库虽然已不是ST主推的HAL/LL库但对于理解硬件原理、掌握寄存器操作以及维护存量项目来说其价值无可替代。它提供了一层清晰的封装让我们无需直接面对密密麻麻的寄存器位又能清晰地看到配置的脉络。通过本文你将不仅学会如何用标准库配置定时器实现精准定时和外部计数更能理解其背后的时钟树、计数模式、中断机制等核心概念从而举一反三应用到更复杂的场景中。2. 定时器整体架构与核心概念解析在动手写代码之前我们必须先给大脑“搭建框架”理解STM32定时器的“生态系统”。STM32的定时器种类繁多按功能可分为基本定时器TIM6, TIM7、通用定时器TIM2-TIM5, TIM9-TIM14等和高级定时器TIM1, TIM8。对于定时和计数我们最常用的是通用定时器。2.1 定时器的“心脏”时钟源定时器之所以能“计时”是因为它有一个不断跳动的“心脏”——时钟。这个时钟信号决定了计数器累加的速度。内部时钟CK_INT最常用的源来自APB总线时钟。这里有个关键点当APB预分频器系数不为1时定时器时钟会是APB时钟的2倍。例如系统时钟72MHzAPB1总线时钟36MHz二分频那么挂载在APB1下的定时器如TIM2-TIM4实际时钟是72MHz。这一点在计算定时时间时至关重要。外部时钟模式1来自定时器特定输入引脚TIx的外部信号用于计数功能。外部时钟模式2来自ETR引脚的外部信号。内部触发输入一个定时器可以被另一个定时器触发用于同步或级联。我们的定时功能通常使用内部时钟而计数功能则使用外部时钟模式。2.2 定时器的“骨架”时基单元这是定时器最核心的部分主要由三部分组成共同决定了定时器的“节奏”预分频器PSC, Prescaler这是一个16位的寄存器可以对输入时钟进行分频。如果时钟是72MHzPSC设置为7199则分频后的时钟频率为 72MHz / (71991) 10KHz。它的存在让我们能够处理非常宽的频率范围。计数器CNT这是一个16位或32位取决于定时器的寄存器在分频后的时钟驱动下每个脉冲加1或减1取决于计数模式。它是我们读取当前计数值的地方。自动重装载寄存器ARR, Auto-Reload Register这决定了计数器的周期。当计数器CNT的值达到ARR向上计数或减少到0向下计数时会产生一个更新事件UEV计数器重新开始同时可以触发中断或DMA。定时时间的计算公式向上计数模式是理解一切的基础定时时间 (ARR 1) * (PSC 1) / Tclk其中Tclk是定时器的输入时钟频率。例如Tclk72MHz要实现1秒定时我们可以设PSC7199ARR9999。计算(99991)*(71991)/72,000,000 1秒。2.3 标准库的“地图”关键结构体与函数标准库通过结构体和函数将这些硬件单元抽象出来。TIM_TimeBaseInitTypeDef时基初始化结构体。你需要填充的成员包括TIM_Prescaler预分频器值对应PSC。TIM_CounterMode计数模式如向上TIM_CounterMode_Up、向下。TIM_Period自动重装载值对应ARR。TIM_ClockDivision时钟分频与输入捕获滤波器相关通常设为TIM_CKD_DIV1。TIM_RepetitionCounter重复计数器高级定时器特有。TIM_TimeBaseInit()根据上述结构体初始化定时器时基单元。TIM_Cmd()使能或失能定时器。TIM_ITConfig()配置定时器中断源如更新中断TIM_IT_Update。TIM_GetCounter()/TIM_SetCounter()获取或设置当前计数值。理解这些我们就有了配置定时器的“工具箱”。3. 核心功能一精准定时与中断实现定时功能是定时器最经典的应用其核心思想是配置好时钟频率和计数周期让定时器在达到设定时间时通过中断通知CPU。3.1 定时器初始化配置详解我们以通用定时器TIM3为例实现一个500ms的定时中断。第一步开启时钟。定时器是外设必须先使能其时钟。RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE);第二步配置时基参数。这是最关键的一步。TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure; uint16_t PrescalerValue 0; uint16_t PeriodValue 0; // 假设系统时钟72MHzTIM3挂在APB1若APB1为36MHz则TIM3时钟为72MHz // 计算预分频值让计数器时钟为10KHz // CK_CNT 72MHz / (PSC 1) 10KHz PSC 7199 PrescalerValue (uint16_t)(72000000 / 10000) - 1; // 10000Hz 10KHz // 计算自动重装载值实现500ms中断 // 定时时间 (ARR 1) / CK_CNT 0.5s // ARR 1 0.5s * 10000Hz 5000 PeriodValue 5000 - 1; // 因为从0开始计数 TIM_TimeBaseInitStructure.TIM_Period PeriodValue; // 设置ARR值 TIM_TimeBaseInitStructure.TIM_Prescaler PrescalerValue; // 设置PSC值 TIM_TimeBaseInitStructure.TIM_ClockDivision TIM_CKD_DIV1; // 时钟分频与滤波相关 TIM_TimeBaseInitStructure.TIM_CounterMode TIM_CounterMode_Up; // 向上计数模式 TIM_TimeBaseInit(TIM3, TIM_TimeBaseInitStructure); // 初始化TIM3注意这里的计算是核心。一定要先明确Tclk的实际频率。TIM_Period和TIM_Prescaler都是16位寄存器最大值65535不能超出。对于长定时可能需要结合定时器溢出中断进行软件计数。第三步使能更新中断并设置NVIC。// 使能TIM3的更新中断 TIM_ITConfig(TIM3, TIM_IT_Update, ENABLE); // 配置NVIC嵌套向量中断控制器 NVIC_InitTypeDef NVIC_InitStructure; NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); // 先设置优先级分组 NVIC_InitStructure.NVIC_IRQChannel TIM3_IRQn; // TIM3中断通道 NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority 0; // 抢占优先级 NVIC_InitStructure.NVIC_IRQChannelSubPriority 1; // 子优先级 NVIC_InitStructure.NVIC_IRQChannelCmd ENABLE; NVIC_Init(NVIC_InitStructure);第四步使能定时器。TIM_Cmd(TIM3, ENABLE);3.2 中断服务函数编写要点中断服务函数ISR的名字是固定的可以在启动文件startup_stm32f10x_xx.s中找到。void TIM3_IRQHandler(void) { // 1. 首先检查是否是更新中断 if (TIM_GetITStatus(TIM3, TIM_IT_Update) ! RESET) { // 2. 这里是你的中断处理代码例如翻转一个LED灯 GPIO_WriteBit(GPIOB, GPIO_Pin_5, (BitAction)(1 - GPIO_ReadOutputDataBit(GPIOB, GPIO_Pin_5))); // 3. 非常重要清除中断标志位否则会连续进入中断 TIM_ClearITPendingBit(TIM3, TIM_IT_Update); } }实操心得中断服务函数要尽可能短小精悍只做最必要的操作如设置标志位。复杂的处理应放到主循环中根据标志位来执行。避免在中断中进行延时、打印等耗时操作。3.3 微秒级延时函数的实现除了中断定时器还可以用来实现高精度的阻塞式延时函数这比循环空指令精确得多。/** * brief 初始化一个基本定时器如TIM6用于微秒延时 */ void Delay_TIM_Init(void) { TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM6, ENABLE); // TIM6是基本定时器 // 配置为1MHz的计数频率即每个计数1us (假设时钟72MHz) TIM_TimeBaseInitStructure.TIM_Period 65535; // ARR最大值 TIM_TimeBaseInitStructure.TIM_Prescaler 72 - 1; // 72MHz / 72 1MHz TIM_TimeBaseInitStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInitStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM6, TIM_TimeBaseInitStructure); TIM_Cmd(TIM6, ENABLE); } /** * brief 微秒延时函数 * param us: 要延时的微秒数范围1~65535 */ void Delay_us(uint16_t us) { TIM_SetCounter(TIM6, 0); // 计数器清零 while (TIM_GetCounter(TIM6) us); // 等待计数值达到设定值 }这个函数的原理很简单让定时器以1MHz频率计数那么计数值就等于经过的微秒数。Delay_us(100)就会延时100微秒。注意这是阻塞延时在延时期间CPU无法执行其他任务。4. 核心功能二外部事件计数与捕获计数功能就是让定时器不再依赖内部时钟而是根据外部引脚上的信号边沿来递增计数器。这常用于测量频率、计数脉冲数量如旋转编码器、光电开关。4.1 外部时钟模式1配置我们以TIM2的通道1PA0引脚作为外部脉冲输入为例。第一步初始化GPIO。将对应引脚配置为浮空输入或上拉/下拉输入具体取决于外部信号。GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; // 浮空输入适用于外部有确定驱动 // GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; // 上拉输入适用于开漏输出型传感器 GPIO_Init(GPIOA, GPIO_InitStructure);第二步配置定时器时基结构体。此时定时器的时钟源将是外部信号所以内部预分频和周期ARR的设置意义不同。通常将ARR设置为最大值如0xFFFF让计数器自由计数直到溢出。TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); TIM_TimeBaseInitStructure.TIM_Period 0xFFFF; // 计数到65535溢出 TIM_TimeBaseInitStructure.TIM_Prescaler 0; // 不对输入信号分频1个边沿计1次数 TIM_TimeBaseInitStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInitStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_TimeBaseInitStructure);第三步配置输入通道为外部时钟模式。这是与定时模式最大的不同。TIM_ICInitTypeDef TIM_ICInitStructure; // 选择输入通道1对应TI1即PA0 TIM_ICInitStructure.TIM_Channel TIM_Channel_1; // 输入捕获触发信号选择TI1FP1即通道1的引脚 TIM_ICInitStructure.TIM_ICPolarity TIM_ICPolarity_Rising; // 上升沿触发计数 TIM_ICInitStructure.TIM_ICSelection TIM_ICSelection_DirectTI; // 直接映射到TI1 TIM_ICInitStructure.TIM_ICPrescaler TIM_ICPSC_DIV1; // 每个有效边沿都触发 TIM_ICInitStructure.TIM_ICFilter 0x0; // 不滤波 TIM_ICInit(TIM2, TIM_ICInitStructure);第四步配置定时器从模式为外部时钟模式1。TIM_ETRClockMode2Config(TIM2, TIM_ExtTRGPSC_OFF, TIM_ExtTRGPolarity_NonInverted, 0); // 更通用的配置是使用以下函数选择从模式触发源 TIM_SelectInputTrigger(TIM2, TIM_TS_TI1FP1); // 触发源选择为TI1的滤波后信号 TIM_SelectSlaveMode(TIM2, TIM_SlaveMode_External1); // 从模式设置为外部时钟模式1第五步使能定时器。TIM_Cmd(TIM2, ENABLE);配置完成后每当PA0引脚上出现一个上升沿TIM2的计数器CNT就会加1。你可以通过TIM_GetCounter(TIM2)随时读取当前的计数值。4.2 脉冲计数与频率测量实例基于上面的计数功能我们可以轻松实现脉冲计数。如果需要测量频率单位时间内的脉冲数可以结合定时器的定时功能。思路开启一个定时器如TIM3做1秒定时中断同时开启另一个定时器如TIM2做外部计数。在TIM3的1秒中断里读取TIM2的计数值这个值就是频率Hz然后将TIM2的计数器清零开始下一秒的计数。volatile uint32_t Frequency_Hz 0; // 在中断中更新的频率值 // TIM3 1秒中断服务函数 void TIM3_IRQHandler(void) { if (TIM_GetITStatus(TIM3, TIM_IT_Update) ! RESET) { Frequency_Hz TIM_GetCounter(TIM2); // 获取过去1秒的脉冲数 TIM_SetCounter(TIM2, 0); // 清零计数器重新开始计数 TIM_ClearITPendingBit(TIM3, TIM_IT_Update); } }在主循环中你可以随时读取Frequency_Hz这个变量来获取最新测量的频率。注意事项外部信号的频率不能超过定时器时钟的1/2Nyquist定理同时也要考虑GPIO的速度和输入滤波器的设置。对于高频信号需要减小定时器预分频PSC或使用更高级的输入捕获模式。4.3 输入捕获模式初探计数模式是记录“有多少个边沿”而输入捕获则是记录“某个边沿发生的时刻”。它更常用于测量脉冲宽度或周期。 其基本原理是当配置的输入通道上发生特定边沿如上升沿时定时器当前的计数值CNT会被瞬间锁存到对应的捕获/比较寄存器CCRx中并可以产生中断。通过记录连续两个边沿如上升沿和下降沿对应的捕获值相减即可得到高电平或低电平的持续时间。 标准库提供了TIM_ICInit()函数来配置输入捕获通道并需要编写对应的捕获中断服务函数来读取CCRx的值。这比单纯的计数模式更复杂但也更强大是测量PWM、编码器信号的基础。5. 进阶应用与模式剖析掌握了基本定时和计数后我们可以探索一些更深入的模式和应用这些能极大提升你对定时器掌控力。5.1 编码器接口模式硬件解码旋转编码器这是定时器一个极其强大的功能可以硬件直接读取正交编码器的信号A相和B相自动判断正反转并计数CPU无需干预。void Encoder_TIM_Init(void) { TIM_TimeBaseInitTypeDef TIM_TimeBaseInitStructure; TIM_ICInitTypeDef TIM_ICInitStructure; // ... 开启时钟初始化GPIOPA0, PA1 作为编码器A、B相 // 时基单元初始化ARR通常设为最大值 TIM_TimeBaseInitStructure.TIM_Period 65535; TIM_TimeBaseInitStructure.TIM_Prescaler 0; TIM_TimeBaseInitStructure.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInitStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_TimeBaseInitStructure); // 配置通道1为输入捕获用于编码器A相 TIM_ICInitStructure.TIM_Channel TIM_Channel_1; TIM_ICInitStructure.TIM_ICPolarity TIM_ICPolarity_Rising; // 具体极性取决于硬件和模式 TIM_ICInitStructure.TIM_ICSelection TIM_ICSelection_DirectTI; TIM_ICInitStructure.TIM_ICPrescaler TIM_ICPSC_DIV1; TIM_ICInitStructure.TIM_ICFilter 0x0; // 可根据需要添加滤波 TIM_ICInit(TIM2, TIM_ICInitStructure); // 配置通道2为输入捕获用于编码器B相 TIM_ICInitStructure.TIM_Channel TIM_Channel_2; TIM_ICInit(TIM2, TIM_ICInitStructure); // 关键步骤设置定时器为编码器接口模式 TIM_EncoderInterfaceConfig(TIM2, TIM_EncoderMode_TI12, TIM_ICPolarity_Rising, TIM_ICPolarity_Rising); // TIM_EncoderMode_TI12 表示在TI1和TI2的边沿都计数 TIM_Cmd(TIM2, ENABLE); }配置完成后旋转编码器TIM_GetCounter(TIM2)的值就会自动增减正转增加反转减少。你只需要定期读取这个值就能知道位置和速度。5.2 主从定时器级联实现超长定时或复杂时序单个16位定时器即使预分频到最大在72MHz下最长定时也就几十毫秒。要实现秒、分钟甚至更长的定时有几种方法软件计数法在定时器中断里对一个全局变量累加这是最简单的方法。定时器级联法将一个定时器从定时器的时钟源设置为另一个定时器主定时器的更新事件。这样从定时器计一次数相当于主定时器完成了一个完整周期。例如主定时器TIM2每10ms产生一次更新这个更新作为TIM3的时钟TIM3的ARR设为100那么TIM3的更新周期就是 10ms * 100 1秒。// 配置TIM2为主模式输出更新事件 TIM_SelectOutputTrigger(TIM2, TIM_TRGOSource_Update); // 配置TIM3为从模式时钟源为ITR0内部触发需要查表对应TIM2 TIM_SelectInputTrigger(TIM3, TIM_TS_ITR0); TIM_SelectSlaveMode(TIM3, TIM_SlaveMode_External1);这种方法能实现硬件级的长定时不占用CPU中断资源。5.3 输出比较与PWM生成虽然标题聚焦定时计数但定时器的输出比较功能不得不提因为它太常用了。通过配置输出比较模式可以产生精确的方波PWM用于控制LED亮度、电机速度、舵机角度等。 核心是自动比较CNT和CCRx的值当两者匹配时根据模式翻转输出引脚电平。标准库提供了TIM_OCxInit()系列函数x为通道号来配置。ARR值决定PWM频率CCRx值决定占空比。理解了这个你就掌握了无刷电机驱动、开关电源等应用的一半精髓。6. 调试技巧与常见问题排查实录在实际开发中定时器不工作或行为异常是家常便饭。下面是我踩过的一些坑和解决方法。6.1 定时器不启动或中断不触发这是最常见的问题排查顺序如下时钟未使能这是新手最容易忽略的。务必确认RCC_APBxPeriphClockCmd已经正确使能了对应定时器的时钟。NVIC配置错误中断通道号如TIM3_IRQn是否正确中断优先级分组NVIC_PriorityGroupConfig是否在配置具体中断前调用中断使能位NVIC_InitStructure.NVIC_IRQChannelCmd是否设为ENABLE中断标志未清除在中断服务函数里必须清除对应的中断挂起位TIM_ClearITPendingBit否则会连续进入中断导致程序卡死。ARR或PSC值为0如果ARR设为0计数器从0到0更新事件会连续发生。如果PSC设为0则表示1分频即不分频。寄存器配置顺序有些配置需要在定时器禁用TIM_Cmd(DISABLE)时进行比如修改ARR的预装载值使用TIM_ARRPreloadConfig功能时。最好遵循“时钟使能 - 基本参数初始化 - 高级功能配置 - NVIC配置 - 使能定时器”的顺序。6.2 定时时间不准如果发现定时时间比预期快或慢请按以下步骤检查系统时钟源确认你的代码中系统时钟SYSCLK配置正确吗是使用内部HSI8MHz还是外部HSE如8MHz晶振使用标准库的SystemInit()函数后默认会根据system_stm32f10x.c中的宏定义来配置。务必确认这个宏定义如#define HSE_VALUE 8000000与你板载晶振频率一致。APB预分频系数如前所述定时器时钟可能不等于APB总线时钟。使用RCC_GetClocksFreq函数可以获取各个时钟的实际频率帮助调试。计算错误重新检查定时时间 (ARR1)*(PSC1)/Tclk这个公式。ARR和PSC都是写入寄存器的值它们是从0开始计数的。中断响应延迟高优先级中断的打断可能导致你的定时中断响应有微秒级的延迟对于极高精度的应用需要考虑。6.3 外部计数不工作或计数错误当配置为外部计数模式时如果读到的CNT值始终为0或不变化GPIO模式错误确认GPIO已正确初始化为输入模式GPIO_Mode_IN_FLOATING,IPU,IPD。用示波器或逻辑分析仪检查引脚上是否有预期的脉冲信号。输入滤波与分频TIM_ICInitStructure.TIM_ICFilter设置过大可能会滤掉高频脉冲。TIM_ICPrescaler设置为TIM_ICPSC_DIV2则表示每2个事件才触发一次捕获/计数。从模式配置遗漏配置了输入通道后必须通过TIM_SelectSlaveMode将定时器设置为外部时钟模式TIM_SlaveMode_External1并正确选择触发源TIM_SelectInputTrigger。这是很多教程遗漏的关键一步。信号质量问题外部信号是否有毛刺边沿是否陡峭可以尝试在GPIO引脚增加一个小的对地电容如10-100pF滤波或者调整输入滤波参数。6.4 标准库函数版本兼容性问题不同版本的STM32标准库函数名或参数可能有细微差别。例如早期版本配置编码器模式可能用TIM_EncoderInterfaceConfig而有些版本参数顺序不同。最好的方法是查阅你所使用的固件库包中的stm32f10x_tim.h和对应的例程。当编译器报错“未定义的引用”时首先检查函数名是否拼写正确然后去头文件里确认该函数是否存在及其参数类型。我个人在项目中最深刻的体会是理解数据手册中的定时器框图远比死记硬背库函数调用重要。当你脑子里有了那张图知道信号从哪个引脚进来经过哪些开关和分频器最终如何影响CNT和产生中断那么无论遇到什么问题你都能有条理地分析和解决。定时器是STM32最精妙的外设之一花时间征服它你的嵌入式开发功力会上一个大台阶。