1. 项目概述为什么定时器是STM32的“心脏”如果你玩过STM32或者任何一款单片机那你一定绕不开“定时器”这个东西。它不像GPIO点灯那么直观也不像串口通信那样能直接看到数据流动但它的重要性却如同整个系统的“心脏”和“节拍器”。我刚开始接触STM32时也觉得定时器寄存器又多又杂什么预分频、自动重载、计数模式看得人头大。但后来做的项目多了才发现从LED的呼吸灯效果、舵机的精准控制到电机测速、超声波测距甚至整个操作系统的任务调度背后都离不开定时器在默默工作。简单来说STM32的定时器就是一个可以按照你设定的节奏精准地“数数”的硬件模块。它完全独立于CPU运行你设定好一次“嘀嗒”的时间间隔它就能不知疲倦地、分毫不差地产生周期性的事件。这个特性让它成为了实现“时间管理”功能的基石。无论是需要每隔10毫秒采集一次传感器数据还是产生一个频率为1KHz的PWM波去控制电机转速亦或是测量一个外部脉冲的宽度你都可以交给定时器来完成。CPU因此被解放出来可以去处理更复杂的逻辑而不是浪费在枯燥的延时循环里。STM32的定时器家族非常庞大从基本定时器TIM6, TIM7通用定时器TIM2-TIM5, TIM9-TIM14到高级控制定时器TIM1, TIM8功能由简到繁。基本定时器只能干最简单的定时和触发DAC的活通用定时器则集成了输入捕获、输出比较、PWM生成等强大功能是我们最常打交道的高级定时器更进一步加入了互补输出、死区插入等高级控制功能专门用于电机控制和数字电源。理解定时器尤其是通用定时器的运作机制是玩转STM32嵌入式开发的关键一步。接下来我们就抛开枯燥的手册从实际应用的角度把这颗“心脏”的运作原理和实战用法彻底讲透。2. 定时器核心原理与工作模式深度拆解要驾驭定时器不能只停留在调用HAL库函数的层面必须理解其内部的运作机制。这就像开车知道踩油门能走是基础了解发动机和变速箱如何协同工作才能应对复杂路况。2.1 定时器的“时钟源”与“脉搏”设定定时器之所以能计时首先得有“心跳”。这个心跳就来源于时钟源。STM32定时器的时钟源可以来自内部系统时钟如APB1或APB2总线时钟也可以来自外部时钟模式。最常用的是内部时钟CK_INT也就是由系统主频分频后提供的时钟。假设我们的系统主频SYSCLK是72MHz定时器挂在APB1总线下APB1预分频器为2所以APB1时钟为36MHz。但这里有个关键点当APB1预分频系数不为1时定时器的时钟会是APB1时钟的2倍。所以此时定时器实际得到的时钟频率是72MHz。这个细节很多初学者会忽略直接拿APB1的36MHz去计算导致定时时间对不上。有了时钟源定时器就开始“数数”了。但72MHz的频率太高计数器瞬间就溢出了无法实现较长的定时。因此我们需要两个关键的“减速”装置预分频器PSC和自动重装载寄存器ARR。预分频器PSC它的作用是对输入时钟进行分频。它是一个16位的寄存器可以设置为0到65535之间的任何值。实际分频系数是PSC 1。例如设置PSC 7199那么分频系数就是7200。输入时钟72MHz经过分频后驱动计数器计数的时钟频率就变成了72MHz / 7200 10KHz。这意味着计数器每秒钟会计数10000次。计数器CNT这是一个16位或32位的向上/向下计数的寄存器它根据分频后的时钟频率递增或递减。自动重装载寄存器ARR这是定时周期的“目标值”。当计数器CNT计数到ARR的值时向上计数模式就会产生一个更新事件溢出并且计数器清零重新开始计数。ARR同样是一个16位或32位的寄存器。定时时间的计算公式定时时间 (ARR 1) * (PSC 1) / 定时器时钟频率举个例子我们要实现一个1秒的定时中断。定时器时钟为72MHz设置PSC 7199ARR 9999。 计算(99991) * (71991) / 72,000,000 10,000 * 7,200 / 72,000,000 1秒。 这里(PSC1)将时钟分频为10KHz即计数一次耗时0.1毫秒。(ARR1)设定需要计数10000次总时间就是1秒。注意在计算时ARR和PSC的“1”非常关键。因为它们是寄存器值0代表分频系数为1或计数目标为1。很多配置工具如STM32CubeMX会自动帮你做这个“1”的计算但手动编程时务必留意。2.2 四大工作模式与核心应用场景通用定时器之所以强大在于它支持多种工作模式以适应不同的应用场景。1. 定时器模式这是最基础的模式即上面描述的简单向上计数。计数器从0开始每个时钟脉冲加1直到达到ARR值产生更新事件中断或DMA请求然后清零重启。应用场景产生精确的周期性中断用于系统心跳、软件定时、数据采集周期等。2. 输出比较模式在此模式下定时器会持续将计数器CNT的值与一个或多个“比较寄存器”CCRx的值进行比较。当两者相等时根据配置对应的输出通道OCx的电平会发生翻转、置高、置低或保持。应用场景生成PWM波、驱动蜂鸣器、产生单脉冲等。这是控制类应用的核心。3. 输入捕获模式这个模式用于“测量”。当定时器的某个输入通道通常对应一个GPIO引脚上检测到特定的边沿上升沿或下降沿时硬件会立即将当前计数器CNT的值“捕获”并锁存到对应的捕获/比较寄存器CCRx中。通过记录两次捕获到的CNT值就能计算出两个边沿之间的时间间隔。应用场景测量脉冲宽度、频率解码红外遥控信号旋转编码器测速等。4. PWM输入模式这是输入捕获模式的一种特殊应用专门用于测量PWM信号的频率和占空比。它利用两个输入通道通常是TI1和TI2和定时器的从模式自动完成一个完整PWM周期的测量非常高效。应用场景精确测量舵机信号、读取RC接收机信号等。模式选择的心得选择哪种模式取决于你的目标是“产生”一个时间相关的信号还是“测量”一个外部信号的时间参数。产生信号用输出模式测量信号用输入模式。PWM输入模式虽然配置稍复杂但测量精度和可靠性远高于软件在输入捕获中断里计算在要求高的场合应优先考虑。2.3 关键概念预分频与重装载的联动与影子寄存器这里有一个高级但重要的概念影子寄存器。我们上面设置的PSC和ARR实际上都是“预装载寄存器”。定时器真正在运行时使用的是另一个不可见的“影子寄存器”。当我们修改PSC或ARR的值时新值并不会立即生效而是先写入预装载寄存器。只有当发生“更新事件”计数器溢出/下溢时预装载寄存器的值才会被转移到影子寄存器中从而真正生效。这个机制带来了巨大的好处确保定时周期的同步切换避免在计时中途产生毛刺或错误的周期。例如你想在程序运行时动态改变PWM的频率即改变ARR。如果没有影子寄存器你直接写入ARR计数器可能正数到一半新的ARR值立即生效导致当前周期突然被截断产生一个宽度异常的脉冲。有了影子寄存器你可以安全地在任何时间写入新的ARR值它会在下一个周期开始时才生效输出波形始终是完整的。配置技巧在HAL库中使用__HAL_TIM_SET_AUTORELOAD()或HAL_TIM_Base_Init()等函数设置ARR和PSC时库函数通常会处理预装载使能。在标准库或寄存器操作中需要注意TIMx-CR1寄存器中的ARPE自动重装载预装载使能位将其置1以启用影子寄存器功能这是生成稳定PWM波的关键。3. 实战配置从CubeMX到代码生成理解了原理我们动手配置一个具体的定时器应用。我将以使用STM32CubeMX配置通用定时器TIM3实现一个1秒的周期性中断和一个1KHz、占空比50%的PWM输出为例展示完整流程。3.1 硬件与软件环境准备硬件任意一款STM32F1系列核心板如STM32F103C8T6因其资源典型且资料丰富。软件STM32CubeMX v6.x, Keil MDK-ARM 或 STM32CubeIDE。目标TIM3的通道1PA6输出PWMTIM3本身产生1秒更新中断。3.2 STM32CubeMX图形化配置步骤打开CubeMX选择芯片型号。配置时钟树Clock Configuration这是确保定时器时钟准确的第一步。将HSE外部高速时钟设为晶振频率如8MHz选择PLL作为系统时钟源将系统时钟SYSCLK配置为72MHz。观察APB1 Timer Clocks确认其最终为72MHz如前文原理所述。配置定时器TIM3在Pinout视图下找到TIM3。将Channel1设置为PWM Generation CH1。这会自动将PA6引脚配置为复用输出。在左侧的Configuration标签页中点击TIM3进入参数设置。参数设置界面详解Prescaler (PSC - 16 bits value): 输入7199。这个值根据公式计算得来为了得到10KHz的计数器时钟PSC 72MHz / 10KHz - 1 7199。Counter Mode: 选择Up向上计数模式。Counter Period (AutoReload Register - 16 bits value): 输入9999。对于PWM这个值决定了PWM的频率。PWM频率 定时器时钟 / ((PSC1)*(ARR1)) 72MHz / (7200 * 10000) 1Hz。等等1Hz不对我们的目标是1KHz的PWM。这里出现了一个常见的混淆点。关键区分定时器的更新中断周期和PWM输出频率共用同一个ARR但意义不同。对于PWMARR决定了波形的周期。如果我们想要1KHz的PWM周期应为1ms。计数器时钟是10KHz计数一次0.1ms。那么ARR应设置为(1ms / 0.1ms) - 1 9。这样PWM频率10KHz / (91) 1KHz。因此我们将Counter Period (ARR)修改为9。内部时钟分频Clock Division: 保持为No Division。这个参数是数字滤波器用的与时钟频率无关通常不动。自动重载预装载AutoReload Preload: 务必选择Enable。这就是启用前面讲的影子寄存器保证PWM波形稳定。下方切换到PWM Generation Channel 1子标签页Pulse (16 bits value): 这是比较寄存器CCR1的值决定占空比。占空比 Pulse / (ARR 1)。我们要50%占空比ARR9所以Pulse 5。Fast Mode: 禁用。PWM模式选择PWM Mode 1。在此模式下当CNT CCR1时通道输出有效电平可设置CNT CCR1时输出无效电平。输出极性CH Polarity: 选择High。意味着有效电平为高电平。这样我们就会得到一个周期1ms高电平占0.5ms的PWM波。生成中断在NVIC Settings标签页中勾选TIM3 global interrupt使能中断。生成代码点击GENERATE CODE选择你的IDE。3.3 生成的代码分析与用户代码填充CubeMX生成了初始化代码但我们还需要添加应用逻辑。在main.c中CubeMX在/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间生成了外设初始化调用。我们需要启动PWM输出和定时器中断。/* USER CODE BEGIN 2 */ HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); // 启动TIM3的通道1输出PWM HAL_TIM_Base_Start_IT(htim3); // 以中断模式启动TIM3的定时器基础功能 /* USER CODE END 2 */接下来我们需要编写定时器更新中断的回调函数。这个函数不是直接写在中断服务程序里而是由HAL库框架调用。我们在stm32f1xx_it.c文件中找到TIM3_IRQHandler会发现它只调用了HAL_TIM_IRQHandler(htim3)。真正的处理逻辑在回调函数中。在main.c文件的开头或单独的源文件中我们需要重写这个回调函数/* USER CODE BEGIN 4 */ // 定时器周期更新中断回调函数 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) // 判断是哪个定时器产生的中断 { // 这里放置每1秒要执行的代码 // 例如翻转一个LED灯的状态指示系统在运行 HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); // 假设你定义了一个LED } } /* USER CODE END 4 */这里有一个非常重要的点我们之前计算的是PWM周期为1msARR9但定时器更新中断也是基于同一个ARR。这意味着这个中断不再是1秒一次而是1ms一次因为ARR被PWM占用了。实操心得一个定时器同时用于PWM输出和长周期定时中断通常不是好主意因为ARR被锁定了。更常见的做法是分开使用两个定时器一个专门用于高频PWM如TIM3另一个用于低频定时中断如基本定时器TIM6。使用一个定时器但利用其分频将PSC设得很大ARR设得很小让更新中断频率降低。但这样PWM频率也会变低可能不满足要求。在PWM定时器中断里软件计数在1ms的中断里做一个软件计数器累加到1000次再执行1秒的任务。这是资源紧张时的变通方法但会引入微小误差和CPU开销。为了演示清晰我们修改一下目标TIM3只用于产生1KHz PWM而用另一个定时器如TIM6产生1秒中断。在CubeMX中重新配置TIM6基本定时器时钟源为内部时钟PSC7199ARR9999并开启其全局中断。在代码中启动HAL_TIM_Base_Start_IT(htim6)并在回调函数中判断htim-Instance TIM6。4. 高级应用与常见问题排查掌握了基础配置我们可以探索更复杂的应用场景并看看那些容易让人“踩坑”的地方。4.1 输入捕获测量频率与脉宽测量频率是定时器的经典应用。我们以TIM2的通道1PA0测量一个方波信号为例。CubeMX配置将PA0TIM2_CH1配置为Input Capture direct mode。在TIM2参数页设置一个合适的PSC使得计数器时钟在信号频率范围内有足够的分辨率。例如若信号预计在1KHz-10KHz计数器时钟设为1MHzPSC71比较合适这样每个计数代表1微秒。在Input Capture Channel 1中设置触发边沿为Rising Edge先测上升沿。开启TIM2的全局中断。编程逻辑 在输入捕获中断中我们需要记录两次上升沿的计数器值差值即为一个周期的时间。volatile uint32_t capture_count 0; volatile uint32_t period_ticks 0; volatile uint32_t last_capture 0; void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { capture_count HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 读取当前捕获值 if (last_capture ! 0) { // 计算周期计数器时钟周期数 if (capture_count last_capture) { period_ticks capture_count - last_capture; } else { // 处理计数器溢出ARR1为模 period_ticks (htim-Instance-ARR 1) - last_capture capture_count; } // 计算实际频率频率 定时器时钟频率 / period_ticks // float frequency (float)SystemCoreClock / (htim-Instance-PSC 1) / period_ticks; } last_capture capture_count; } }注意上述代码是简化版实际中需要考虑计数器溢出的情况即一个信号周期内计数器从ARR回到了0。更稳健的方法是开启捕获溢出中断或者使用定时器的从模式复位功能。4.2 PWM模式详解与电机控制应用PWM模式1和模式2的区别在于输出电平极性。通常我们使用PWM模式1并设置有效电平为高。在电机控制中特别是使用半桥或全桥驱动时会用到互补输出和死区插入这是高级控制定时器TIM1/TIM8的功能。死区时间为了防止同一桥臂的上、下两个开关管同时导通造成短路需要在它们切换状态时插入一段两个管子都关闭的时间这就是死区时间。高级定时器硬件可以自动生成带死区的互补PWM极大地提高了系统的安全性和可靠性。配置要点在CubeMX中配置TIM1的某个通道为“PWM Generation CHx”时其互补通道会自动出现。在参数页的“Break and Dead-Time”部分可以设置死区时间。死区时间以定时器时钟周期为单位需要根据你使用的MOSFET或IGBT的开关特性来计算。4.3 常见问题与排查技巧实录问题定时器中断不执行或执行频率不对。检查1NVIC配置。确认在CubeMX中已使能该定时器的全局中断并且没有在代码中被其他优先级更高的中断屏蔽。检查2时钟树。这是最常见的问题根源。确认系统时钟、APB总线时钟配置正确并且定时器实际得到的时钟频率与你计算时假设的一致。使用SystemCoreClock变量或通过点灯粗略计时来验证。检查3ARR和PSC的值。牢记公式中的“1”。用逻辑分析仪或示波器测量一个GPIO翻转的中断是最直接的调试方法。检查4中断服务函数。确保你重写了正确的回调函数HAL_TIM_PeriodElapsedCallback并且判断了定时器实例。问题PWM输出没有波形或占空比不可调。检查1GPIO复用。确认引脚已正确配置为对应定时器通道的复用功能AF而不是普通的输入输出。检查2PWM启动函数。是否调用了HAL_TIM_PWM_Start()它有多个参数确保通道号正确。检查3影子寄存器。确认AutoReload Preload已使能。如果没有使能在运行时修改CCR或ARR可能导致输出异常。检查4输出极性。如果极性设为低有效而你的测量设备期待高电平脉冲就会看不到信号。尝试切换极性试试。检查5CCR寄存器值。确保你修改的是正确的CCR寄存器。使用__HAL_TIM_SET_COMPARE(htim, TIM_CHANNEL_x, value)宏来安全地修改占空比。问题输入捕获值跳动很大测量不准。检查1信号质量。首先用示波器观察被测信号看是否有毛刺或振铃。可以在输入引脚加一个小电容如10-100pF到地做简单滤波。检查2边沿选择。如果信号不是标准的方波上升沿或下降沿可能很缓慢导致捕获触发不稳定。尝试调整边沿检测或使用定时器的输入滤波功能在CubeMX的IC参数中配置。检查3中断处理延迟。输入捕获是硬件行为但读取值在中断服务程序中。如果中断被长时间关闭或优先级太低可能导致在下次捕获到来前还未处理完上一次造成数据丢失。优化中断服务程序只做最必要的操作如记录值复杂的计算放到主循环。检查4计数器溢出。对于低频信号如果ARR设置得太小可能在两个边沿之间计数器溢出多次。你需要开启更新中断来记录溢出次数。公式应为总周期 溢出次数 * (ARR1) 本次捕获值 - 上次捕获值。问题使用高级定时器TIM1/TIM8的互补PWM时没有输出。检查1刹车和死区使能。高级定时器的互补输出通常默认受刹车电路控制。检查BDTR寄存器在HAL库中通过TIMx-BDTR访问的MOE主输出使能位是否置1。在HAL库中启动PWM互补输出应使用HAL_TIMEx_PWMN_Start()和HAL_TIM_PWM_Start()分别启动互补通道和主通道或者使用HAL_TIMEx_PWMN_Start_IT()等。检查2死区时间设置过大。如果死区时间设置得接近或超过PWM的半个周期可能会导致有效的输出脉宽为零看起来就像没有输出。适当减小死区时间参数。调试终极技巧当你对定时器的行为不确定时使用一个GPIO引脚作为“逻辑分析仪探头”。在中断服务程序或关键回调函数的入口和出口处翻转这个引脚的电平然后用示波器或逻辑分析仪观察这个引脚的电平变化可以非常直观地看到中断是否触发、触发频率如何、中断服务程序执行了多长时间。这是排查定时器问题最有效、成本最低的方法之一。