STM32定时器深度解析：从PWM、输入捕获到编码器与高级应用实战-平芜编程栈

1. 项目概述：深入理解STM32定时器的核心价值

如果你正在玩STM32，或者任何一款微控制器，却还没把定时器玩明白，那感觉就像开着一辆跑车却只用一档在市区里转悠——动力和潜力完全被浪费了。定时器，这个看似简单的“计时”模块，实际上是STM32单片机里最强大、最灵活的外设之一，没有“之一”。它远不止是让你实现一个精准的delay_ms()函数那么简单。

从我这些年折腾各种STM32项目的经验来看，无论是让无刷电机精准地转动、让LED呼吸灯平滑地渐变、精确测量一个脉冲的宽度和频率，还是构建一个多任务的时间片调度系统，其底层核心都离不开定时器的巧妙运用。那些网络热词里提到的“PWM输出”、“输入捕获测频率”、“定时器触发ADC”，甚至是“控制伺服电机”，都是定时器在不同场景下的华丽变身。很多人觉得定时器配置复杂，寄存器一堆，其实一旦理解了它的设计哲学和工作模式，你就会发现它是一套极其优雅和高效的“时间操控工具包”。这篇文章，我就以一个老电工的视角，带你彻底拆解STM32的定时器，不搞虚的，直接上干货，让你看完就能用起来。

2. STM32定时器家族图谱与核心设计思路

刚接触STM32时，看到TIM1、TIM2、TIM3……一直到TIM14，可能头都大了。其实它们并非杂乱无章，而是有清晰的定位和分工。理解这张“家族图谱”，是正确选型和配置的第一步。

2.1 定时器分类与定位

STM32的定时器大致可以分为三大类，这种分类方式基于其功能和复杂度：

基本定时器（TIM6, TIM7）：这是定时器里的“基本功”。它们的功能非常纯粹：就是一个单纯的向上计数器，没有外部引脚，不能做输入捕获，也不能输出PWM。那它们能干嘛？两个核心用途：第一，提供精确的时基，比如为DAC（数模转换器）提供触发信号（热词中的“定时器触发ADC”是其兄弟功能）；第二，实现最基础的定时中断，用于不需要复杂时序的简单延时或周期任务。你可以把它想象成一个只有闹铃功能的简易闹钟。

通用定时器（TIM2, TIM3, TIM4, TIM5, TIM9~TIM14等，具体型号支持有差异）：这是STM32定时器家族的“主力军”和“多面手”。绝大多数日常应用场景，用的都是它们。一个通用定时器通常包含：

一个16位（或32位，如TIM2/TIM5）的自动重装载计数器，可以向上、向下或中央对齐计数。
多达4个独立的通道，每个通道都可以被灵活配置为输入捕获（测量脉冲宽度/频率）、输出比较（产生PWM、单脉冲等）或者PWM输入模式。
丰富的触发和同步机制，可以让多个定时器级联，或者用外部信号来启动、复位定时器。

热词中提到的“PWM输出”、“输入捕获测频率”、“控制步进电机”几乎全是通用定时器的舞台。它就像一个高级多功能手表，既有闹钟，又有秒表、计时器，还能测心率。

高级定时器（TIM1, TIM8, 在某些系列中还有TIM20等）：这是家族里的“旗舰”和“特种兵”。它在通用定时器的基础上，增加了用于电机控制和数字电源转换的“高级”功能，主要包括：

互补输出通道：可以输出带死区插入的互补PWM对，这是驱动三相无刷电机或全桥电路的核心，能有效防止上下桥臂直通短路。
刹车输入：在紧急情况下（如过流），可以通过一个外部引脚快速关闭所有PWM输出，保护系统。
更灵活的重复计数器和DMA请求。

如果你在做“FOC（磁场定向控制）”、“BLDC电机驱动”或者开关电源，那么高级定时器是你的不二之选。

2.2 定时器核心框图解读

光看分类不够，我们得看看它的“内脏”。虽然不同定时器结构有差异，但核心思想相通。理解下面几个关键部分，配置寄存器时就不会盲目：

时钟源：定时器要“走时”，得有“心跳”。这个心跳可以来自内部时钟（APB总线时钟），也可以来自外部时钟、其他定时器甚至外部引脚。通过配置预分频器（PSC），我们可以将高速的系统时钟（比如72MHz）分频到一个合适的计数频率（比如1MHz，即每微秒计数一次）。
计数器（CNT）：这是定时器的核心，一个根据时钟源节拍递增或递减的寄存器。它的计数模式（向上、向下、中央对齐）决定了PWM的对称性。
自动重装载寄存器（ARR）：这是计数器的“天花板”或“地板”。当计数器达到这个值（向上计数）或减到0（向下计数）时，会产生更新事件，并且计数器重新开始。ARR的值直接决定了定时器的溢出周期。PWM频率 = 定时器时钟频率 / ((ARR+1)*(PSC+1))，这个公式要刻在脑子里。
比较/捕获寄存器（CCRx）：这是实现“比较”和“捕获”功能的关键。在输出比较模式下，我们设置一个CCRx的值，当计数器CNT的值与CCRx匹配时，就会触发相应的动作（比如翻转输出引脚、产生中断）。这个CCRx的值与ARR的比值，就决定了PWM的占空比。在输入捕获模式下，当检测到特定边沿时，当前CNT的值会被“捕获”到CCRx中，通过计算两次捕获值的差值，就能得到脉冲宽度。
捕获/比较通道：这是连接外部世界的桥梁。每个通道对应一个GPIO引脚，可以配置为输入（捕获）或输出（比较/PWM）。

实操心得：刚开始用HAL库或标准库时，别被那些封装好的函数吓到。每次配置前，先在纸上画一下这个框图，问自己：我的时钟从哪里来？计数到多少溢出？我要在哪个值进行比较？想清楚这三个问题，配置代码就是填空。

3. 四大核心功能模式深度解析与实操

理解了架构，我们进入实战环节。我会用最典型的场景，带你走通定时器的四大核心功能。

3.1 基础定时中断：构建系统时间基石

这是最简单的应用，但也是很多复杂功能的基础。我们的目标是让定时器每隔固定时间（比如1ms）产生一次中断。

配置要点（以通用定时器TIM3，系统时钟72MHz为例）：

时钟使能：首先打开TIM3和对应GPIO（如果不用引脚则不需要）的时钟。
时基配置：这是核心计算。
- 目标：1ms中断一次，即定时器溢出频率为1000Hz。
- 定时器时钟：假设APB1总线时钟为72MHz，TIM3挂载在APB1上，因此时钟源为72MHz。
- 分频系数（PSC）：为了得到方便的计数值，我们先进行预分频。设PSC = 71。那么计数器时钟CK_CNT = 72MHz / (71+1) = 1MHz，即计数器每1微秒加1。
- 重装载值（ARR）：我们需要在1ms（1000微秒）时溢出。所以ARR = 1000 - 1 = 999。因为计数器从0开始计数，计到999时是第1000个数，产生更新事件。
- 公式验证：定时周期 = (ARR+1) * (PSC+1) / 定时器时钟频率 = 1000 * 72 / 72MHz = 0.001s = 1ms。完美。
中断使能：开启定时器更新中断（UIE）。
启动定时器：使能定时器。

代码片段（HAL库风格）:

TIM_HandleTypeDef htim3; void MX_TIM3_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig = {0}; TIM_MasterConfigTypeDef sMasterConfig = {0}; htim3.Instance = TIM3; htim3.Init.Prescaler = 71; // PSC = 71 htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.Period = 999; // ARR = 999 htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; // 推荐使能预装载 if (HAL_TIM_Base_Init(&htim3) != HAL_OK) { Error_Handler(); } // 配置时钟源（内部时钟） sClockSourceConfig.ClockSource = TIM_CLOCKSOURCE_INTERNAL; if (HAL_TIM_ConfigClockSource(&htim3, &sClockSourceConfig) != HAL_OK) { Error_Handler(); } // 使能更新中断 __HAL_TIM_ENABLE_IT(&htim3, TIM_IT_UPDATE); // 或者使用HAL库函数：HAL_TIM_Base_Start_IT(&htim3); // 在stm32f1xx_it.c中实现中断服务函数 // void TIM3_IRQHandler(void) { HAL_TIM_IRQHandler(&htim3); } // 然后重写回调函数：void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if(htim->Instance == TIM3){ /* 你的1ms任务 */ } } }

注意事项：AutoReloadPreload（自动重装载预装载）这个参数很重要。如果使能，你对ARR的修改会在下一次更新事件时才生效，这可以防止在修改ARR的瞬间产生错误的PWM输出或定时周期，对于运行中需要动态调整频率/占空比的场景至关重要。如果只是初始化后固定不变，则影响不大。

3.2 PWM输出：驱动世界的脉搏

PWM很可能是定时器最广泛的应用。无论是调光、调速还是发声，都离不开它。

配置要点（以TIM2的通道1输出PWM，频率1kHz，占空比50%为例）：

时基配置：与定时中断类似，先确定频率。目标频率1kHz。
- 假设时钟72MHz，设PSC = 71，则CK_CNT = 1MHz。
- 周期T = 1 / 1kHz = 1ms = 1000us。
- 因为计数器每1us计一个数，所以ARR = 1000 - 1 = 999。这个ARR决定了PWM的周期。
输出比较配置：
- 模式：设置为PWM模式1或2（区别在于有效电平的定义）。
- 脉冲（Pulse）：这个值就是比较寄存器CCR1的值。它决定了高电平的宽度。占空比 = Pulse / (ARR + 1)。对于50%占空比，Pulse = (ARR+1) * 50% = 500。
- 输出极性：决定默认输出是高电平有效还是低电平有效。
- 快速模式：通常关闭。如果开启，则在匹配时强制输出有效电平，用于快速响应，但会破坏正常的PWM波形，一般不用。
GPIO配置：将对应引脚（如PA0）复用为定时器输出功能（TIM2_CH1），并推挽输出。

代码关键点:

TIM_OC_InitTypeDef sConfigOC = {0}; // 时基配置同上，PSC=71, ARR=999 // ... sConfigOC.OCMode = TIM_OCMODE_PWM1; // PWM模式1 sConfigOC.Pulse = 500; // CCR1值，初始占空比50% sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH; // 高电平为有效电平 sConfigOC.OCFastMode = TIM_OCFAST_DISABLE; if (HAL_TIM_PWM_ConfigChannel(&htim2, &sConfigOC, TIM_CHANNEL_1) != HAL_OK) { Error_Handler(); } // 启动PWM输出 HAL_TIM_PWM_Start(&htim2, TIM_CHANNEL_1); // 动态修改占空比 __HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_1, 750); // 将占空比改为75%

避坑技巧：有时候你会发现PWM输出频率不对。请按以下顺序排查：第一，确认定时器的时钟源是否正确使能，并且APB总线时钟频率是你预期的值（用SystemCoreClock变量查看）。第二，检查PSC和ARR的计算公式。第三，特别注意：在有些系列（如STM32F1）中，如果APB的预分频系数不为1，定时器时钟可能会被倍频。例如APB1时钟是36MHz，但分频系数是2，那么定时器实际时钟是72MHz。HAL库的HAL_RCC_GetPCLK1Freq()函数会帮你处理好这个细节，但自己心里要有数。

3.3 输入捕获：精准测量时间间隔

这是“测量”功能的体现，用于测量脉冲宽度（高电平时间）或频率。

工作原理：以测量高电平宽度为例。将定时器通道配置为输入捕获模式，上升沿触发。当第一个上升沿到来时，当前计数器的值（CNT）会被瞬间锁存到捕获比较寄存器（CCRx）中，并可以产生中断。在中断里，我们清零计数器CNT，并将触发边沿改为下降沿。当下降沿到来时，CNT的值再次被捕获。此时CCRx中的值，就是上升沿到下降沿之间计数器走过的 ticks 数。根据计数器的时钟频率，就能算出高电平的精确时间。脉宽 = 捕获值 * (1 / 计数器时钟频率)。

配置要点（测量PA0引脚输入脉冲的高电平宽度）：

时基配置：计数器时钟频率越高，测量精度越高。例如设置PSC=0，ARR=0xFFFF（最大值），让计数器以系统时钟全速自由运行。
输入捕获配置：
- 通道配置为输入模式，映射到正确的TIx输入（例如TIM2_CH1对应TI1）。
- 触发边沿：先设置为上升沿。
- 输入分频器：通常设置为不分频（每次边沿都捕获）。
- 滤波器：根据输入信号噪声情况设置数字滤波器，可以避免毛刺误触发。
中断与流程：使能捕获中断。在中断服务程序中，根据是上升沿还是下降沿中断，进行读取捕获值、切换边沿、计算脉宽等操作。

伪代码流程:

volatile uint32_t capture_value1 = 0, capture_value2 = 0; volatile uint8_t is_captured = 0; volatile float pulse_width_us = 0; // 在中断回调函数中 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { if (is_captured == 0) { // 第一次捕获，上升沿 capture_value1 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); // 改为下降沿触发 is_captured = 1; } else if (is_captured == 1) { // 第二次捕获，下降沿 capture_value2 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 计算脉宽，考虑计数器溢出 if (capture_value2 >= capture_value1) { pulse_width_us = (capture_value2 - capture_value1) * (1.0 / 计数时钟频率_MHz); } else { // 发生了溢出，需要加上ARR最大值 pulse_width_us = (0xFFFF - capture_value1 + capture_value2 + 1) * (1.0 / 计数时钟频率_MHz); } // 重置，准备下一次测量 __HAL_TIM_SET_COUNTER(htim, 0); __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); is_captured = 0; } } }

注意事项：输入捕获测量高频信号时，要特别注意计数器溢出问题。如果脉冲宽度可能超过计数器从0到ARR满量程的时间，就必须在中断中处理溢出计数。一种更稳健的方法是开启定时器的更新（溢出）中断，用一个变量记录溢出次数，在捕获中断中结合溢出次数来计算总时间。

3.4 编码器接口模式：读取旋转位置与速度

这是定时器的一个“隐藏”高级功能，用于直接连接正交编码器，硬件自动计数，极大减轻CPU负担。

工作原理：将定时器的两个通道（通常是CH1和CH2）配置为编码器接口模式。编码器的A、B相信号分别接到这两个引脚。定时器硬件会根据A、B相的边沿和相对相位关系，自动控制计数器CNT向上或向下计数，其数值直接对应编码器的位置。计数频率可以是信号频率的2倍或4倍（取决于模式），实现倍频提高分辨率。

配置要点：

GPIO配置：将两个引脚配置为上拉输入模式，因为编码器通常是开集输出。
定时器配置：
- 时基部分，ARR通常设置为最大值（如65535），让计数器自由滚动。
- 编码器模式：选择TIM_ENCODERMODE_TI1（仅在TI1边沿计数）、TIM_ENCODERMODE_TI2或TIM_ENCODERMODE_TI12（在TI1和TI2的边沿都计数，4倍频）。
- 输入滤波：根据编码器信号质量适当设置。
读取与应用：启动定时器后，直接读取__HAL_TIM_GET_COUNTER(&htimx)即可得到位置信息。通过定时（比如用另一个定时器每10ms中断一次）读取位置差值，就可以计算出速度。

实操心得：编码器模式非常省心，但要注意两个问题。第一，机械抖动可能引起误计数，合理设置输入滤波器参数很关键。第二，计数器是16位的，会溢出回滚。在计算长距离绝对位置或速度时，需要在软件层面处理溢出。一个常见做法是使用定时器的更新中断，在CNT溢出时，用一个32位或64位的软件变量进行高位累加，从而合成一个扩展的绝对位置。

4. 高级应用与联动技巧

掌握了单一定时器的基本操作，就可以玩一些更花的组合技了，这也是STM32定时器强大之处的体现。

4.1 定时器级联与同步

有时候我们需要一个非常长的定时周期，但ARR寄存器是16位的，最大65535。即使把PSC调到最大，周期也有限。这时就可以用级联。例如，用TIM2作为主定时器，TIM3作为从定时器。

主从模式配置思路：

配置主定时器（TIM2），使其在更新事件（UEV）时，从TRGO输出一个触发信号。
配置从定时器（TIM3），将其触发源（TS）设置为来自ITR0（内部触发，具体连接关系查数据手册，TIM2的TRGO可能对应TIM3的ITR0）。
设置从定时器为“从模式：触发模式”（Slave Mode: Trigger Mode）。这样，每次主定时器溢出，就会触发从定时器计数一次。
最终，整个系统的定时周期 = 主定时器周期 × 从定时器周期。这就实现了用两个16位定时器模拟一个32位定时器。

4.2 定时器触发ADC采样

这是实现精准、等间隔数据采集的黄金组合。热词中“FOC 定时器触发ADC采样”就是这个应用的典型场景。在电机控制中，需要在PWM周期的特定时刻（如上桥臂打开的中点或下桥臂打开的中点）同步采样三相电流，以消除开关噪声的影响。

实现步骤：

配置一个高级或通用定时器（如TIM1）产生PWM。
配置该定时器，使其在某个特定事件（如更新事件、比较匹配事件）时，从TRGO输出一个触发信号。
配置ADC，将其外部触发源设置为来自该定时器的TRGO。
配置ADC为扫描模式、连续转换或非连续转换，并开启DMA。这样，每次PWM周期到达特定点时，硬件会自动触发ADC进行一次完整的采样序列，并通过DMA将数据搬运到内存，完全无需CPU干预，保证了采样的严格同步性和实时性。

4.3 输出比较模式的进阶应用

输出比较模式不止能产生PWM。通过灵活配置，可以实现：

单脉冲模式：在收到一个触发信号后，产生一个宽度可编程的单一脉冲。常用于驱动需要精确脉冲宽度的器件，如某些超声波模块的触发脚。
强制输出：通过软件强制输出高或低电平，用于紧急控制。
PWM输入模式：这实际上是输入捕获的一种特殊应用。它利用两个通道（通常是TI1和TI2）自动测量PWM信号的周期和占空比，只需要一次捕获就能得到两个值，非常高效。

5. 实战避坑与性能优化指南

理论懂了，代码写了，一上电还是有问题？这里分享一些我踩过的坑和优化经验。

5.1 常见问题排查清单

现象	可能原因	排查方法
定时器根本不工作	1. 时钟未使能。 2. 定时器未启动（`HAL_TIM_Base_Start()`）。 3. 主循环卡死，无法进入中断。	1. 检查`__HAL_RCC_TIMx_CLK_ENABLE()`是否调用。 2. 检查启动函数是否被正确执行。 3. 检查全局中断是否开启，是否有更高优先级中断阻塞。
中断频率不准	1. PSC和ARR计算错误。 2. 系统时钟（SYSCLK）配置非预期。 3. 中断服务函数执行时间过长，影响了下次中断。	1. 用逻辑分析仪或示波器测量实际输出，反推计算。 2. 确认`SystemCoreClock`变量值，检查时钟树配置（尤其是PLL倍频）。 3. 优化中断服务函数代码，只做标记，耗时任务放到主循环。
PWM无输出或波形异常	1. GPIO未正确复用为定时器功能。 2. 输出通道未使能（`HAL_TIM_PWM_Start()`）。 3. 引脚被其他外设占用或配置为输入。 4. PWM极性配置反了。	1. 使用`HAL_GPIO_Init()`并检查Alternate function参数。 2. 确认启动了正确的通道。 3. 检查CubeMX的引脚分配图，确认无冲突。 4. 用示波器观察，尝试切换`OCPolarity`。
输入捕获值跳动大	1. 信号有毛刺。 2. 未使用滤波器。 3. 中断处理太慢，丢失边沿。	1. 硬件上增加RC滤波，软件上配置输入滤波参数（TIMx_CCMRx中的ICxF位）。 2. 适当增加滤波器值，但注意会引入延迟。 3. 提高中断优先级，或考虑使用DMA传输捕获值（部分高级定时器支持）。
编码器计数方向反或丢步	1. A、B相引脚接反。 2. 编码器模式选择错误。 3. 机械振动导致信号抖动。	1. 交换A、B相接线。 2. 尝试不同的编码器模式（TI1, TI2, TI12）。 3. 增加编码器信号滤波（硬件RC或定时器数字滤波）。

5.2 性能与精度优化心得

时钟源选择：对于要求极高时间精度的应用（如通信波特率生成），可以考虑使用外部高速晶体（HSE）直接或经PLL后作为系统时钟源，其精度远高于内部RC振荡器（HSI）。
预分频与重装载值的权衡：ARR应尽量设置得大一些，PSC小一些。因为ARR是16位的，而PSC的精度损失是除法取整。例如，要产生1ms中断，用PSC=7199, ARR=9（72MHz/7200/10=1ms）和用PSC=71, ARR=999（72MHz/72/1000=1ms）在数学上等效。但后者的ARR值更大，当你需要微调周期时（比如改成1.001ms），后者通过微调ARR为1000，实现起来更容易且精度更高。
使用DMA减轻CPU负担：对于固定占空比的PWM，无需CPU参与。但对于需要频繁更新PWM占空比（如LED渐变、音频合成）或ADC连续采样传输的场景，一定要用DMA。将PWM的CCR值或ADC的数据缓冲区交给DMA管理，可以解放CPU，避免因中断处理延迟导致的波形失真或数据丢失。
中央对齐模式：在电机控制和某些电源应用中，使用中央对齐（向上向下计数）模式可以产生对称的PWM，能有效降低谐波分量。但要注意，在这种模式下，PWM频率的计算公式是Fpwm = Fck / (PSC * ARR)。
关闭调试器影响：在调试模式下，如果打了断点，定时器会停止计数吗？这取决于内核的调试支持。对于Cortex-M，可以在调试时冻结定时器。如果不想冻结，需要配置DBG模块的相关寄存器（如DBGMCU_APB1_FZ）。在做时间敏感测试时，最好脱离调试器直接运行。

定时器是STM32的灵魂外设，它的深度和灵活性超乎很多初学者的想象。从简单的延时到复杂的电机矢量控制，底层都活跃着它的身影。我的建议是，不要满足于调用库函数生成代码，多翻翻参考手册中定时器章节的框图，理解每个寄存器位的作用。当你真正弄懂了从时钟源到计数器，再到比较捕获的整条数据通路，你就能真正地“驾驭”时间，让单片机严格按照你的时序蓝图来运行。最开始可能会觉得寄存器繁杂，但一旦打通任督二脉，你会发现一切如此清晰，并且能轻松解决那些仅靠库函数无法处理的复杂、刁钻的时序问题。