首页/资讯中心/详情

STM32定时器深度解析：从基础定时到PWM与输入捕获实战

STM32定时器深度解析：从基础定时到PWM与输入捕获实战
📅 发布时间：2026/7/29 3:54:59

1. 项目概述：为什么定时器是STM32的“心脏”？

如果你玩过一阵子STM32，肯定会发现一个现象：无论是点个灯、读个传感器，还是玩电机控制、通信协议，几乎都绕不开一个东西——定时器。它不像GPIO那样直观，也不像ADC那样结果明确，但却是整个系统节奏和精度的基石。你可以把定时器理解为单片机的“心脏”和“节拍器”，它默默地在后台计数，为我们提供精确的时间基准、产生规整的波形、测量外部信号的频率与脉宽。没有它，很多应用要么无法实现，要么精度惨不忍睹。

这次，我们就来彻底拆解STM32的定时器，聚焦于最核心、最常用的三个功能：基本定时、输出比较和输入捕获。我不会只停留在CubeMX配置的层面，而是结合HAL库编程，深入到寄存器操作的逻辑，告诉你每个参数设置背后的“为什么”，并分享那些在数据手册里找不到的调试经验和避坑指南。无论你是刚接触STM32的新手，还是想深化理解的中级开发者，这篇内容都能帮你把定时器这个模块“吃透”，让你在项目中能真正驾驭它，而不是仅仅让它“跑起来”。

2. 定时器核心架构与工作模式深度解析

在动手写代码之前，我们必须先理解STM32定时器的“五脏六腑”。STM32的定时器种类繁多，从基本定时器（TIM6, TIM7）、通用定时器（TIM2-TIM5, TIM9-TIM14）到高级定时器（TIM1, TIM8），功能由简到繁。但它们的核心架构是相通的，都围绕几个关键寄存器展开。

2.1 定时器的“时钟树”：精度之源

定时器的一切都始于时钟。STM32的定时器时钟源可以来自内部时钟（APB总线）、外部时钟、甚至其他定时器。这里最容易混淆的是APB预分频器对定时器时钟的影响。以常见的STM32F1系列为例，当APB1预分频系数不为1时（比如系统时钟72MHz，APB1预分频为2，得到36MHz），连接到APB1的定时器2-7的时钟会倍频x2，最终仍以72MHz运行。这个细节直接影响你计算分频系数和自动重载值。

注意：在CubeMX的Clock Configuration界面，一定要确认最终到达定时器的时钟频率（Timer clocks）。很多初学者在这里算错，导致定时周期和预期相差甚远。我的习惯是，在代码初始化后，通过读取__HAL_RCC_GET_TIMCLKPRESKALER()相关的宏或直接计算来双重验证时钟频率。

2.2 核心寄存器组：ARR, PSC, CCRx与CNT

理解这四个寄存器，就理解了定时器80%的工作：

  • PSC (预分频器寄存器)：决定定时器的“计数节奏”。如果时钟源是72MHz，PSC设置为7199，则计数器CNT每增加1，实际耗时是 (7199+1)/72MHz = 0.1ms。PSC的作用是将高速的系统时钟“降速”到我们需要的计数频率。
  • CNT (计数器寄存器)：定时器的核心，一个向上、向下或双向计数的寄存器。它的计数频率由时钟源和PSC共同决定。
  • ARR (自动重载寄存器)：决定了计数器的周期。在向上计数模式下，当CNT计数到ARR的值时，产生一个更新事件（溢出），CNT清零重新开始。定时器的周期T = (ARR+1) * (PSC+1) / Fclk。
  • CCRx (捕获/比较寄存器)：这是输出比较和输入捕获功能的灵魂。在输出比较模式下，你可以设置一个目标值（比如1000），当CNT计数到1000时，硬件会自动做出反应（如翻转引脚电平）。在输入捕获模式下，当特定边沿到来时，硬件会把此刻CNT的值“抓取”并存入CCRx，这样你就知道了事件发生的精确时刻。

2.3 关键工作模式：从计数到触发

除了简单的向上计数，定时器还有中央对齐（向上向下）计数、编码器模式等。对于基本定时和PWM生成，向上计数最常用。这里重点提一下更新事件(UEV)和触发/刹车输入。

  • 更新事件：当CNT溢出（或特定条件下）时产生，可以触发更新中断（TIMx_IRQn），也可以作为DMA请求源。这是实现周期性任务的基础。
  • 触发与刹车：高级定时器特有的功能，常用于电机控制等安全场合。刹车输入可以强制将输出置于安全状态（比如PWM输出低电平），防止硬件故障。

3. 基本定时功能：精准的“时间基石”实现

基本定时功能是所有复杂应用的地基，它的目标就是产生一个稳定、精确的时间基准，通常用于实现延时、系统心跳（如RTOS的SysTick）或触发周期性任务。

3.1 HAL库配置与初始化精讲

使用CubeMX配置一个1ms中断的基本定时器（以TIM2为例）：

  1. 在Pinout & Configuration界面，找到TIM2。
  2. 将Clock Source设置为Internal Clock。
  3. 在Parameter Settings选项卡中：
    • Prescaler (PSC - 16 bits value)：设置为71。假设主时钟72MHz，目标定时频率为1kHz（1ms），则分频后计数频率应为72MHz / (71+1) = 1MHz。
    • Counter Mode：Up。
    • Counter Period (AutoReload Register - 16 bits value)：设置为999。1MHz的计数频率下，计1000个数需要1ms，所以ARR = 1000 - 1 = 999。
    • auto-reload preload：建议使能（Enable）。这会让ARR的更新在下一个更新事件生效，防止在修改ARR时产生毛刺周期。
  4. 在NVIC Settings中使能TIM2 global interrupt。

生成的初始化代码核心是HAL_TIM_Base_Init()和HAL_TIM_Base_Start_IT()。但这里有个关键点：HAL_TIM_Base_Init()并不会自动计算并设置PSC和ARR，这些值来源于我们通过CubeMX设置并存储在htim2.Init这个结构体中的。所以，如果你想动态修改定时周期，不能只改ARR，必须用__HAL_TIM_SET_AUTORELOAD()和__HAL_TIM_SET_PRESCALER()这两个宏，并且要注意如果定时器正在运行，修改ARR可能需要先停止定时器，或者利用预装载功能。

3.2 中断服务程序与精准延时实现

定时器中断服务程序框架如下：

void TIM2_IRQHandler(void) { HAL_TIM_IRQHandler(&htim2); // HAL库中断统一处理函数 } // 在HAL_TIM_PeriodElapsedCallback中编写你的任务 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { // 每1ms执行一次的任务 static uint32_t counter = 0; counter++; if (counter >= 1000) { // 实现一个1秒的软定时 counter = 0; // 每秒执行一次的任务，例如翻转LED HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); } } }

基于这个精确的1ms中断，我们可以实现一个微秒级和毫秒级的阻塞延时函数，这比使用HAL_Delay（基于SysTick）更灵活，且可以独立于系统滴答。

// 假设TIM2配置为1MHz计数频率（每计一个数1us） void Delay_us(uint16_t us) { __HAL_TIM_SET_COUNTER(&htim2, 0); // 计数器清零 HAL_TIM_Base_Start(&htim2); // 启动定时器（不开启中断） while (__HAL_TIM_GET_COUNTER(&htim2) < us); // 等待 HAL_TIM_Base_Stop(&htim2); // 停止定时器 } void Delay_ms(uint16_t ms) { for (uint16_t i = 0; i < ms; i++) { Delay_us(1000); // 注意：此方法会占用CPU。对于长延时，建议用中断标志位。 } }

实操心得：在中断回调函数里执行的任务一定要短小精悍！切忌进行长时间阻塞的操作（如软件延时、等待某个慢速外设）。如果需要处理复杂任务，应该只在中断中设置标志位，然后在主循环中查询并处理。否则会导致其他中断响应延迟，甚至错过定时器中断，破坏时间基准。

4. 输出比较功能：驾驭波形生成的利器

输出比较（Output Compare）功能的核心思想是“比较然后行动”。你设定一个目标值（CCRx），硬件会持续将CNT与CCRx比较，一旦匹配，就自动改变对应输出通道（OCx）的电平状态。这是生成PWM、单脉冲、驱动步进电机等应用的核心。

4.1 PWM模式深度配置与参数计算

PWM（脉宽调制）是输出比较最典型的应用。在CubeMX中配置TIM3的通道1为PWM：

  1. 选择TIM3，通道1设置为PWM Generation CH1。
  2. 参数设置中，PSC和ARR共同决定PWM的频率。例如，要产生1kHz的PWM，时钟72MHz，PSC=71，则计数器频率为1MHz。ARR设置为999，则PWM周期 = (999+1) / 1MHz = 1ms，即1kHz。
  3. Pulse（脉冲宽度）即初始的CCR1值，它决定了占空比。占空比 = Pulse / (ARR+1)。例如Pulse设为500，则占空比为50%。
  4. CH Polarity（通道极性）决定了有效电平是高还是低。Low表示默认输出低，匹配时跳变到高；High则相反。

生成的代码会调用HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1)来启动PWM。动态调整占空比使用__HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, newPulseValue)。

这里有一个高级技巧：PWM的频率和分辨率（精细度）是矛盾的。频率越高（ARR越小），你能调节的占空比步进值就越粗糙。例如，ARR=999时，占空比最小调节量是0.1%；如果ARR=99，最小调节量就变成了1%。你需要根据实际应用（如LED调光需要高分辨率，电机驱动需要高频率）来权衡。

4.2 单脉冲与强制输出模式实战

除了PWM，输出比较还有两种非常实用的模式：

  • 单脉冲模式（OPM）：定时器在收到一个触发信号（可以是软件触发或其他定时器事件）后，产生一个宽度可编程的脉冲，然后自动停止。这在需要精确控制脉冲数量的场合非常有用，比如驱动舵机或发送特定数量的脉冲。 配置方法：在CubeMX中，将One Pulse Mode设置为Enable。在代码中，先设置好ARR（脉冲周期）和CCRx（脉冲宽度），然后通过HAL_TIM_OnePulse_Start(&htim, TIM_CHANNEL_x)启动，并通过HAL_TIM_GenerateEvent(&htim, TIM_EVENTSOURCE_UPDATE)来软件触发一次脉冲输出。

  • 强制输出模式：你可以通过软件强制让输出通道输出高电平或低电平，而不受CNT和CCRx比较结果的影响。这在紧急停止或初始化状态设置时很有用。 操作方法：使用__HAL_TIM_FORCED_OCxSET(&htim, TIM_CHANNEL_x)和__HAL_TIM_FORCED_OCxRESET(&htim, TIM_CHANNEL_x)宏。

注意事项：在动态修改CCR值改变PWM占空比时，如果希望改变平滑无毛刺，请确保定时器配置中开启了CHx preload（通道预装载）功能。这样，新的CCR值会在下一个更新事件时才生效，防止在计数的中间阶段修改导致当前周期波形异常。

5. 输入捕获功能：精准测量时间间隔的艺术

如果说输出比较是“主动创造”，那么输入捕获就是“被动感知”。它的目的是精确测量一个外部信号的高电平宽度、低电平宽度或周期（频率）。其原理是：当输入引脚上发生预设的边沿事件（如上升沿）时，硬件会瞬间将当前CNT的数值“捕获”到CCRx寄存器中。通过连续捕获两个边沿对应的CNT值，做差，再乘以计数周期，就能得到精确的时间间隔。

5.1 测量脉宽与频率的经典电路与配置

一个经典的输入捕获应用是测量一个方波的频率和占空比。这通常需要两个通道协作：一个捕获上升沿，一个捕获下降沿。

以TIM5的通道1和通道2为例，测量同一输入信号的脉宽：

  1. 硬件连接：将待测信号同时连接到TIM5_CH1和TIM5_CH2引脚（对于STM32，很多定时器的通道是复用到多个引脚上的，需查看数据手册的引脚复用表）。
  2. CubeMX配置：
    • TIM5通道1：Input Capture direct mode，IC Selection选择Direct，ICPolarity选择Rising Edge（捕获上升沿）。
    • TIM5通道2：Input Capture indirect mode，IC Selection选择Indirect（意味着它捕获的是同一个输入信号，但可以设置不同的边沿），ICPolarity选择Falling Edge（捕获下降沿）。
    • 设置合适的PSC，使计数器频率足够高，以获得高测量精度。例如，用10MHz的计数频率，分辨率就是0.1us。
    • 将ARR设置为最大值（如0xFFFF），因为我们要测量的是两个边沿之间的计数值，不希望中间产生溢出中断增加复杂度（对于长脉宽，需要处理溢出，见下文）。
  3. 编程逻辑：
    • 启动输入捕获中断：HAL_TIM_IC_Start_IT(&htim5, TIM_CHANNEL_1);和HAL_TIM_IC_Start_IT(&htim5, TIM_CHANNEL_2);。
    • 在中断回调HAL_TIM_IC_CaptureCallback中，根据通道判断是上升沿还是下降沿捕获。
    • 第一次上升沿捕获，记录ICValue1 = HAL_TIM_ReadCapturedValue(&htim5, TIM_CHANNEL_1);，并清除计数器__HAL_TIM_SET_COUNTER(&htim5, 0);。
    • 随后的下降沿捕获，记录ICValue2 = HAL_TIM_ReadCapturedValue(&htim5, TIM_CHANNEL_2);。高电平脉宽 =ICValue2 * (1/计数频率)。
    • 下一个上升沿捕获，记录ICValue1_new，则信号周期 =ICValue1_new * (1/计数频率)。占空比 = 高电平脉宽 / 周期。

5.2 处理溢出与高精度时间戳技巧

上面的简单方法有一个致命缺陷：如果信号的脉宽或周期超过了定时器从0到ARR计满的时间，就会发生计数器溢出（CNT从最大值翻转到0）。如果不处理，计算出的时间将是错误的。

解决方案是引入溢出计数器：

  1. 使能定时器的更新中断（溢出中断）。
  2. 在更新中断回调中，对一个全局变量（如tim5_overflows）进行递增。
  3. 在输入捕获中断中，读取捕获值的同时，也读取当前的溢出计数器值。
  4. 计算时间时：总时间 =(overflow_count * (ARR+1) + captured_value) * 计数周期。

这实际上构建了一个高精度的时间戳系统。对于需要极高精度和长时间测量的应用（如超声波测距、编码器累计位置），这是标准做法。

避坑指南：输入捕获对噪声非常敏感！一个毛刺可能导致错误的边沿触发。务必在硬件上做好滤波：一是在CubeMX中配置Input Filter（数字滤波器），它可以要求连续多个采样点状态一致才确认边沿，有效滤除窄毛刺；二是在PCB布局上，信号线远离噪声源，并可在引脚处添加一个小电容（如10-100pF）到地，进行硬件滤波。同时，中断服务程序要尽可能快，避免因处理中断太慢而错过后续的边沿。

6. 高级应用与联动：定时器的“组合拳”

单个定时器的功能已经很强，但STM32的定时器之间、定时器与其他外设之间还能联动，打出更精彩的“组合拳”。

6.1 主从定时器同步与编码器接口

  • 主从模式：可以让一个定时器（主）控制另一个定时器（从）的启动、停止、复位或时钟。例如，用TIM2作为主定时器，输出一个触发信号（TRGO）给作为从定时器的TIM3，这样就能让TIM3和TIM2精确同步启动。这在需要多个严格同步的PWM波时非常有用。 配置关键：在主定时器中设置Trigger Output为Update Event；在从定时器中设置Trigger Source为ITR0（具体ITRx号需查手册，对应主定时器的输出线），并将Slave Mode设置为Trigger Mode。

  • 编码器接口模式：这是测量电机转速和方向的绝佳功能。定时器可以配置为编码器模式，直接读取正交编码器的A、B两相脉冲，硬件自动判断方向并计数。 配置方法：在CubeMX中，将两个通道均设置为Encoder Mode。通常选择Encoder Mode TI1 and TI2。此时，CNT会根据A、B相的边沿自动增减。你只需要定期（比如用另一个定时器中断）读取CNT值，就能得到位置差，进而算出速度。HAL库提供了HAL_TIM_Encoder_Start()函数来启动。

6.2 与DMA、ADC的协同工作

定时器可以触发DMA和ADC，实现不占用CPU的自动化数据流。

  • 定时器触发DMA：例如，你想用DMA将内存中的一组波形数据源源不断地搬运到定时器的CCR寄存器，从而产生任意形状的PWM序列。可以配置定时器的更新事件或比较匹配事件作为DMA请求源。
  • 定时器触发ADC采样：在电机控制中，需要严格在PWM波形的特定点（如上桥臂打开的中点）进行电流采样，以消除开关噪声。这可以通过配置高级定时器（TIM1/TIM8）的触发输出（TRGO）来触发ADC的注入组转换，实现硬件级别的精准同步，采样时刻的抖动极低。

7. 调试技巧与常见问题排查实录

即使理解了原理，调试定时器时还是会遇到各种“妖魔鬼怪”。下面是我总结的一些常见问题及排查手段。

7.1 无输出/无中断的排查清单

  1. 时钟未使能：这是最常见的问题。除了在CubeMX中配置，确保在main.c的SystemClock_Config之后，调用了MX_TIMx_Init()，并且相关GPIO和定时器的外设时钟已使能（CubeMX生成的代码通常已包含）。
  2. GPIO复用模式错误：对于输出功能（PWM），GPIO必须配置为复用推挽输出（Alternate Function Push-Pull）。对于输入捕获，配置为浮空输入或上拉/下拉输入。检查MX_GPIO_Init函数中对相应引脚的配置。
  3. 中断未使能或优先级冲突：在CubeMX的NVIC Configuration中确认中断已勾选。检查中断优先级，确保没有更高优先级的中断长时间阻塞了你的定时器中断。
  4. 未启动定时器：你配置并初始化了定时器，但忘记调用启动函数。基本定时用HAL_TIM_Base_Start_IT()，PWM用HAL_TIM_PWM_Start()，输入捕获用HAL_TIM_IC_Start_IT()。
  5. ARR或PSC为0：如果ARR设置为0，在向上计数模式下，计数器会一直在0和0之间“溢出”，行为可能异常。PSC为0则表示不分频。

7.2 测量不准与波形畸变的根源分析

  1. 时钟源不准：检查系统时钟（HSE/HSI）配置是否正确，PLL倍频参数是否有误。使用示波器测量一个已知的定时器输出（如1Hz的LED闪烁）来反推实际定时频率。
  2. 中断服务程序过长：这会导致中断响应延迟，对于输入捕获，可能错过边沿；对于输出比较，可能影响下一个周期的精度。优化中断服务程序，只做最必要的标志位设置。
  3. 输入信号质量问题：用示波器观察输入捕获的信号，看是否有振铃、过冲或毛刺。添加硬件滤波（RC电路）和软件滤波（数字滤波器）。
  4. PWM负载过重：当PWM驱动大容性负载或直接驱动电机时，在电平跳变瞬间可能产生很大的瞬时电流，导致电源电压跌落，影响单片机本身工作，甚至导致复位。确保电源功率充足，并在电机驱动引脚增加缓冲电路（如栅极驱动器）。

7.3 HAL库超时处理与状态机实践

HAL库的函数很多都带有超时机制（Timeout参数）。例如HAL_TIM_Base_Start(&htim)。在简单的应用中，你可以直接使用HAL_MAX_DELAY。但在复杂的、实时性要求高的系统中，建议检查函数的返回值（HAL_StatusTypeDef），并实现自己的超时处理逻辑，避免因为某个外设异常导致整个程序卡死。

理解HAL库定时器驱动的状态机（htim->State）也很重要。例如，在尝试停止一个定时器前，检查它是否已经处于停止状态，可以避免不必要的操作。直接操作htim->Instance->CR1等寄存器来启停定时器虽然快，但可能会破坏HAL库内部的状态管理，导致后续HAL库函数调用出现不可预期行为。除非你很清楚自己在做什么，否则建议统一使用HAL库提供的Start/Stop函数族。

定时器是STM32中最灵活也最复杂的外设之一，从简单的延时到复杂的电机控制、数字电源，都离不开它。掌握它，没有捷径，就是多动手、多思考、多调试。从配置一个1秒闪烁的LED开始，到产生一组复杂的多路PWM，再到用输入捕获测量一个旋转编码器的速度，每一步都会加深你对这个“心脏”的理解。当你真正弄懂了ARR、PSC、CCR和CNT之间如何舞蹈，你就能让STM32精准地执行你的任何时间相关的指令了。