STM32定时器深度解析：从PWM生成到ADC触发与电机控制实战

1. 项目概述：为什么STM32的TIM定时器是嵌入式开发的“心脏”？

如果你刚开始接触STM32，可能会觉得定时器（TIM）只是众多外设中普通的一个，用来计个数、定个时。但当你真正深入项目，无论是驱动电机、生成PWM、测量频率，还是实现精准的延时，你会发现TIM几乎无处不在，它更像是整个系统运行的“节拍器”和“指挥家”。我刚开始做项目时，也曾在TIM的各种模式里绕晕，后来才明白，吃透TIM，是玩转STM32从入门到精通的必经之路。今天，我们就抛开枯燥的寄存器手册，以一个从业者的视角，把STM32的TIM定时器从里到外、从原理到实战彻底拆解清楚。无论你是想用PWM控制LED亮度、驱动舵机，还是想用输入捕获测量脉冲宽度，或者用定时器触发ADC实现同步采样，这篇文章都会给你一套清晰、可复现的“操作指南”和“避坑地图”。

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

2.1 定时器的“家族谱系”：通用、高级与基本定时器

STM32的TIM定时器不是单一模块，而是一个分工明确的家族。理解它们的区别，是正确选型的第一步。

通用定时器（TIM2, TIM3, TIM4, TIM5等）：这是你打交道最多的“多面手”。它们通常具备完整的定时、输入捕获、输出比较、PWM生成和编码器接口功能。例如，TIM2和TIM5是32位计数器，可以计更大的数，适合需要超长定时的场景；而TIM3、TIM4等是16位计数器。在项目里，如果你需要生成PWM控制电机速度（比如两轮差速小车），或者捕获传感器信号的脉冲宽度（比如超声波测距），通用定时器是你的首选。

高级定时器（TIM1, TIM8等）：这是家族里的“特种兵”，主要面向电机控制和数字电源等复杂应用。它在通用定时器的基础上，增加了互补输出、死区插入、刹车（Break）功能等。互补输出可以驱动H桥电路的上、下管，而死区插入是为了防止上下管同时导通导致短路，这对于驱动直流无刷电机（BLDC）或伺服电机至关重要。如果你在做FOC（磁场定向控制）电机驱动，那么用高级定时器来触发ADC采样（即foc 定时器触发adc采样），实现电流环的同步采样，是提升性能的关键。

基本定时器（TIM6, TIM7等）：功能最简单的“计时员”。它们只有最基础的定时功能，通常用于产生基础的时基，例如为DAC提供触发信号，或者作为其他软件的基准时钟。它们没有输入捕获/输出比较这些外设接口。

选型心得：不要一上来就扎进配置里。先问自己：我的核心需求是什么？仅仅是定时中断？选基本定时器。要测频率或生成PWM？选通用定时器。要做电机控制？必须考虑高级定时器。资源紧张时，一个定时器可以通过不同的通道实现多种功能（比如TIM2的CH1做输入捕获，CH2做PWM输出），合理规划能节省宝贵的硬件资源。

2.2 核心框图解读：计数器、预分频器与自动重载寄存器

定时器工作的核心，围绕着一个计数器展开。我们可以把它想象成一个向上或向下计数的“秒表”。但这个秒表的速度和量程是可以精细调节的，这就涉及到两个关键寄存器：预分频器（PSC）和自动重载寄存器（ARR）。

预分频器（PSC）：它决定了“秒表”每走一步的实际时间。定时器的时钟源（来自APB总线）频率通常很高（如72MHz）。PSC的作用就是对这时钟进行分频。如果PSC设置为71，那么计数器时钟频率 = 72MHz / (71+1) = 1MHz，即计数器每1微秒计数一次。PSC寄存器写入的是分频系数减一的值。

自动重载寄存器（ARR）：它决定了“秒表”的满量程。当计数器计数到ARR设定的值时，就会发生溢出，产生更新事件（UEV），计数器可以清零或重新加载，同时可以触发中断或DMA。ARR和PSC共同决定了定时周期。公式为：定时周期 = (ARR + 1) * (PSC + 1) / 定时器时钟频率。

例如，要实现一个1ms的定时中断，假设定时器时钟为72MHz，我们可以设PSC=71，ARR=999。计算：周期 = (999+1)(71+1)/72,000,000 = 100072/72,000,000 = 0.001秒 = 1ms。

计数模式：这是初学者容易混淆的地方。最常见的是向上计数模式：计数器从0开始，计到ARR，溢出，产生更新事件，然后回到0重新开始。还有向下计数、中央对齐（先向上再向下）模式。中央对齐模式常用于生成对称的PWM波。

2.3 关键工作模式：输出比较与输入捕获

这是TIM定时器发挥实际作用的两个核心模式。

输出比较（Output Compare）：定时器的核心功能之一。你可以设定一个比较值（存入CCR寄存器）。计数器不断运行，当计数器的值等于CCR的值时，定时器就会根据你设定的模式（如翻转、置高、置低）来操作对应的输出引脚。PWM生成就是输出比较模式的一个典型应用。在PWM模式下，ARR决定周期，CCR决定占空比。例如，ARR=999，CCR=300，则高电平时间为300个计数周期，占空比为30%。

输入捕获（Input Capture）：与输出比较相反，它是用来“测量”外部信号的。当指定的输入引脚上有边沿（上升沿或下降沿）跳变时，定时器会瞬间将当前计数器的值“捕获”并锁存到CCR寄存器中。通过连续捕获两个边沿（如一个上升沿和一个下降沿）的计数器值，相减后乘以计数周期，就能算出脉冲的宽度或周期。这就是测量频率、占空比或超声波回波时间的基本原理。很多朋友遇到的stm32定时器捕获测频率不准的问题，往往和计数器溢出处理、滤波设置有关。

3. 实战配置：从CubeMX到代码的完整流程

理论说再多，不如动手调一遍。这里我们以最常用的通用定时器TIM3生成1kHz PWM（通道1）为例，展示从图形化配置到代码编写的全流程。这里假设你已熟悉STM32CubeMX和Keil/IAR的基本使用。

3.1 使用STM32CubeMX进行可视化配置

1. 时钟树配置：首先确保你的系统时钟（HCLK）和定时器所属的APB总线时钟（APB1或APB2）已正确配置。例如，STM32F1系列，TIM2、3、4挂在APB1上，默认最高36MHz，但通过倍频可以到72MHz。在Clock Configuration标签页下确认。
2. 定时器参数配置：找到TIM3，将Clock Source设为Internal Clock。在Parameter Settings中：
   • Prescaler (PSC - 16 bits value)：设置为71。 (如果时钟72MHz， 72M/(71+1)=1MHz)
   • Counter Mode：选择Up（向上计数）。
   • Counter Period (AutoReload Register - 16 bits value)：设置为999。 (周期 = (999+1)/1MHz = 1ms， 频率1kHz)
   • auto-reload preload：建议使能（Enable）。这允许在运行时平滑更新ARR值，避免产生毛刺。
3. PWM输出配置：切换到Channel1，选择PWM Generation CH1。
   • 下方会多出PWM的配置项。通常保持默认的Pulse（即初始CCR值）为0，CH Polarity为High（高电平有效）即可。CH Polarity决定了有效电平是高还是低，根据你的驱动电路调整。
4. 生成工程：配置NVIC（如果需要中断）和GPIO（自动配置为复用推挽输出），然后生成代码。

避坑提示：很多新手在stm32cubemx 定时器配置pwm后，发现没有输出。请务必检查两点：一、是否在生成的main.c中的/* USER CODE BEGIN 2 */区域后，调用了HAL库的PWM启动函数，如HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);。二、检查生成的引脚配置是否正确，有时CubeMX不会自动使能引脚时钟，但HAL库一般会处理，最好手动确认一下。

3.2 关键HAL库函数与寄存器操作对比

HAL库极大简化了开发，但了解背后的寄存器操作能让你更从容地排查问题。

启动PWM输出（HAL库方式）：

// 在main函数初始化后调用 HAL_TIM_PWM_Start(&htim3, TIM_CHANNEL_1);

动态调整占空比（HAL库方式）：

// 修改CCR1寄存器的值来改变占空比，范围0-ARR __HAL_TIM_SET_COMPARE(&htim3, TIM_CHANNEL_1, 300); // 设置占空比为30% (ARR=999时) // 或者使用宏 TIM3->CCR1 = 300;

对应的寄存器直接操作（以TIM3通道1为例）：

// 1. 使能定时器时钟（CubeMX已做） // RCC->APB1ENR |= RCC_APB1ENR_TIM3EN; // 2. 配置ARR和PSC TIM3->ARR = 999; TIM3->PSC = 71; // 3. 配置通道1为PWM模式1 TIM3->CCMR1 &= ~TIM_CCMR1_OC1M; // 清零模式位 TIM3->CCMR1 |= TIM_CCMR1_OC1M_1 | TIM_CCMR1_OC1M_2; // PWM模式1 TIM3->CCMR1 |= TIM_CCMR1_OC1PE; // 使能预装载寄存器 // 4. 使能输出和自动重载预装载 TIM3->CCER |= TIM_CCER_CC1E; // 使能通道1输出 TIM3->CR1 |= TIM_CR1_ARPE; // 使能ARR预装载 // 5. 设置初始占空比 TIM3->CCR1 = 0; // 6. 启动计数器 TIM3->CR1 |= TIM_CR1_CEN;

通过对比可以看出，HAL库函数封装了这些底层操作。但在某些对时序要求极其苛刻的场合（如高频PWM），直接操作寄存器可能效率更高。

3.3 输入捕获配置实例：测量脉冲高电平宽度

假设我们用TIM2的通道1来测量一个按键按下产生的高脉冲宽度。

1. CubeMX配置：

   • 将TIM2 Channel1配置为Input Capture direct mode。
   • 在Parameter Settings中设置合适的PSC和ARR。ARR要足够大，确保在测量最大脉冲宽度内计数器不会溢出。例如，时钟72MHz，PSC=71（分频至1MHz），ARR=0xFFFF（65535），则最大可测量65.535ms的脉冲。
   • 在Input Capture Channel 1部分，选择触发边沿，例如Rising Edge（我们先捕获上升沿）。
   • 务必使能TIM2的全局中断（NVIC Settings）。

2. 代码编写：

// 全局变量记录状态和值 uint32_t capture_val1 = 0, capture_val2 = 0; uint32_t pulse_width_ticks = 0; uint8_t is_captured = 0; // 捕获状态标志 // 启动输入捕获 HAL_TIM_IC_Start_IT(&htim2, TIM_CHANNEL_1); // 在stm32f1xx_it.c中找到TIM2_IRQHandler，或使用HAL回调函数 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2) { if (is_captured == 0) { // 第一次捕获，上升沿 capture_val1 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); is_captured = 1; // 改变触发边沿为下降沿，准备捕获下降沿 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); } else if (is_captured == 1) { // 第二次捕获，下降沿 capture_val2 = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // 计算脉宽（计数器刻度） if (capture_val2 > capture_val1) { pulse_width_ticks = capture_val2 - capture_val1; } else { // 处理计数器溢出情况（本例ARR较大，未溢出，但通用写法应考虑） pulse_width_ticks = (0xFFFF - capture_val1) + capture_val2 + 1; } // 将脉宽转换为时间（微秒），因为分频后是1MHz，1tick=1us // uint32_t pulse_width_us = pulse_width_ticks; is_captured = 0; // 重置边沿为上升沿，准备下一次测量 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); // 这里可以处理测量结果，如打印或触发其他逻辑 } } }

这个例子展示了单次脉冲宽度的测量。对于连续测量频率，逻辑类似，但通常捕获两个连续的上升沿，计算时间差得到周期。

4. 高级应用与性能优化技巧

4.1 定时器触发ADC与DMA的协同工作

在需要高速、同步数据采集的应用中（如音频处理、电机相电流采样），让定时器自动触发ADC采样，并通过DMA搬运数据，是解放CPU、保证时序精度的黄金组合。这就是搜索热词中adc定时器触发和foc 定时器触发adc采样的应用场景。

配置要点：

1. 定时器配置：配置一个定时器（如TIM1的更新事件）作为触发源。将其输出模式设置为Update Event作为触发输出（TRGO）。
2. ADC配置：在ADC的配置中，选择触发源为Timer 1 Trigger Out event。设置采样通道、采样时间，并开启DMA连续传输模式。
3. DMA配置：将DMA配置为从ADC数据寄存器（如ADC1->DR）到内存数组的循环传输模式，数据宽度为半字（16位）。

这样，定时器会以固定的频率（例如20kHz）产生更新事件，这个事件会自动触发ADC启动一次转换，转换结果立即由DMA搬运到指定的内存数组中。CPU完全不用干预，只需要在DMA传输完成一半或全部的回调函数中处理这批数据即可。这种方式的采样间隔极其精确，不受中断响应延迟的影响。

4.2 PWM高级应用：死区插入与互补输出

在驱动直流无刷电机或全桥电路时，为了防止同一桥臂的上、下两个开关管同时导通（直通短路），必须在控制信号中加入一段同时为低电平的“死区时间”。高级定时器（TIM1/TIM8）硬件支持此功能。

配置思路（CubeMX）：

1. 选择TIM1，配置一个通道（如CH1）为PWM Generation CH1，其互补通道（CH1N）会自动关联。
2. 在Parameter Settings->Break and Dead-Time部分，使能Dead-Time，并设置死区时间。死区时间通常以定时器时钟周期为单位，需要根据你的开关管导通/关断时间来计算设置。
3. 在Configuration->GPIO Settings中，你会看到CH1和CH1N对应的引脚都被自动配置为复用输出。

硬件死区插入比软件延时更可靠、更精确，是电机驱动项目的必备知识。

4.3 编码器接口模式

TIM定时器的编码器接口模式，可以硬件解码正交编码器的信号（A相和B相），直接读出代表位置和方向的计数值，极大简化了电机位置反馈的编程。配置时，将定时器的通道1和通道2分别映射到编码器的A、B相输入引脚，并将定时器的工作模式设置为Encoder Mode。计数器会根据A、B相的边沿和相位关系自动加减计数，方向位也会自动更新。读取TIMx->CNT即可得到位置信息，结合定时器溢出中断，可以实现长距离的位置跟踪。

5. 常见问题排查与调试经验实录

即使配置看起来正确，实际调试中还是会遇到各种问题。下面是我和同事们踩过的一些“坑”及解决办法。

5.1 PWM无输出或波形异常

• 问题现象：引脚没有波形，或者波形频率、占空比不对。
• 排查步骤：
  1. 检查时钟：确认定时器所在APB总线的时钟是否已使能且频率正确。使用调试器查看RCC->APB1ENR或RCC->APB2ENR对应位。
  2. 检查引脚复用：确认GPIO是否被正确配置为复用功能（Alternate Function），并且是对应的定时器通道。检查GPIOx->AFR寄存器。
  3. 检查计数器是否启动：确认TIMx->CR1寄存器的CEN位是否为1。HAL库中是否调用了HAL_TIM_PWM_Start。
  4. 检查ARR和CCR值：用调试器查看TIMx->ARR和TIMx->CCRx的值是否符合预期。注意HAL库的__HAL_TIM_SET_COMPARE函数是立即生效还是需要更新事件后才生效（取决于预装载使能）。
  5. 检查输出使能：确认TIMx->CCER寄存器中对应通道的CCxE位是否置1。
  6. 示波器测量：最终一定要用示波器看实际波形，这是最直接的证据。

5.2 输入捕获值不准或跳变

• 问题现象：测量的脉冲宽度或频率值不稳定，偶尔有巨大误差。
• 排查步骤：
  1. 信号质量问题：首先用示波器观察被测信号是否有毛刺、振铃或边沿不陡。可以在定时器输入通道上配置输入滤波器（TIMx->CCMR1中的ICxF位）来抑制噪声。
  2. 计数器溢出未处理：这是常见错误。如果脉冲宽度可能超过ARR对应的最大时间，必须在中断中处理计数器溢出。通常设置一个溢出计数变量，在定时器更新中断（UEV）中加一，计算脉宽时加上溢出次数 * (ARR+1)。
  3. 中断优先级与延迟：如果系统中断频繁，输入捕获中断可能被延迟，导致捕获值有误差。可以适当提高定时器中断的优先级（NVIC配置）。
  4. 边沿检测错误：确保设置的捕获边沿（上升沿/下降沿）与实际信号一致。对于不规则信号，可以考虑使用双边沿捕获。

5.3 定时器中断不触发或频率不对

• 问题现象：预期的定时器更新中断（UEV）没有进入，或者进入的频率不对。
• 排查步骤：
  1. NVIC未使能：在CubeMX中检查是否勾选了对应定时器的全局中断，并生成了代码。检查NVIC->ISER寄存器。
  2. 中断服务函数/回调函数未实现：确保重写了TIMx_IRQHandler函数，并在其中调用了HAL_TIM_IRQHandler，或者实现了HAL_TIM_PeriodElapsedCallback回调函数。
  3. 更新中断未使能：检查TIMx->DIER寄存器的UIE位是否为1。HAL库的HAL_TIM_Base_Start_IT()函数会设置此位。
  4. 时钟或分频计算错误：重新核对定时器时钟源频率、PSC和ARR值的计算。一个快速验证的方法是，在中断回调函数里翻转一个GPIO引脚，用示波器测量其频率是否与预期相符。
  5. 自动重载预装载的影响：如果使能了ARR预装载（ARPE=1），那么修改ARR值后，需要等到下一次更新事件才会生效。如果你在中断里立即读取ARR，可能读到的是旧值。

5.4 关于“gd32单片机 timer 定时器 慢了一倍”的思考

这个问题在论坛上很典型。现象通常是，将代码从STM32移植到引脚兼容的GD32后，定时器定时时间变成了两倍。根本原因在于时钟树差异。虽然外设引脚兼容，但GD32和STM32的默认内部时钟（HSI）频率、APB分频策略可能不同。例如，某些STM32型号的APB时钟在不为1分频时，定时器时钟会是APB时钟的2倍（即有一个x2的机制），而GD32可能没有这个机制或者默认状态不同。

解决方案：

1. 仔细对比时钟配置：用调试器或读取时钟控制寄存器（RCC_CFGR等），仔细对比STM32和GD32在运行时的系统时钟（SYSCLK）、AHB、APB1、APB2的实际频率。
2. 检查定时器时钟源：确认定时器是挂在APB1还是APB2，以及该总线的时钟频率。
3. 重新计算PSC和ARR：根据实际测得的定时器输入时钟频率，重新计算预分频器和重载值。
4. 统一使用外部晶振：如果对时序要求苛刻，建议在硬件上使用相同频率的外部晶振，并在代码中明确配置相同的时钟树，这样可以最大程度减少因内部时钟差异带来的问题。

定时器是STM32学习的深水区，也是体现功力的地方。从基本的延时、PWM，到复杂的编码器接口、触发ADC、带死区的互补输出，每一步都需要对原理有清晰的认识，并结合实际调试来巩固。最好的学习方法就是找一个开发板，把本文提到的每个模式都亲手配置一遍，用示波器和逻辑分析仪观察现象，遇到问题就对照手册和寄存器排查。当你能够根据项目需求，熟练地选择和配置定时器，并解决其中遇到的各种古怪问题时，你对STM32的掌握就真正上了一个台阶。