STM32F103定时器实战：从1ms中断到PWM与输入捕获

1. 这不是教科书，是我在产线调定时器踩出来的坑

STM32F103VET这个芯片，我前后在三类项目里用过：工业温控板、智能电表采集模块、还有给高校做的电机控制教学套件。它那颗72MHz的Cortex-M3内核，配上64KB Flash和20KB RAM，在2023年看不算新，但至今仍是国产工控板卡的主力型号——不是因为它多先进，而是因为它的定时器资源够用、驱动稳定、资料齐备、出错有迹可循。今天说的“基础开发”，真不是指“点亮LED”那种入门，而是指你拿到一块全新PCB，焊好芯片，上电后第一件事：让TIM2准时发出一个1ms中断，且连续运行72小时不丢一次。这才是真正能进产线的“基础”。

很多人一上来就翻《参考手册》第14章，盯着通用定时器框图发呆。其实根本不用——你只需要记住三件事：时钟源怎么来、计数器怎么走、中断怎么触发。其他全是这三件事的排列组合。比如热词里反复出现的“stm32cubemx 定时器配置pwm”，本质就是把“计数器怎么走”从向上计数换成中心对齐，再把“中断怎么触发”换成“比较匹配时翻转GPIO”。而“gd32单片机 timer 慢了一倍”，根源往往出在第一步：“时钟源怎么来”没搞清——GD32的APB1预分频默认是2，而STM32F103是1，同样配置下，GD32的TIM2时钟频率直接砍半。

我见过太多人卡在“定时器不进中断”上，折腾半天发现是NVIC优先级设成了0（最高），结果被SysTick抢了风头；也有人做“adc定时器触发”，结果ADC转换完数据还没读，下一次触发又来了，缓冲区直接溢出。这些都不是代码写错了，而是对定时器底层行为的理解偏差。所以这篇不讲寄存器位定义，只讲你手里的示波器探头该夹在哪、逻辑分析仪该抓哪条线、调试器断点该打在哪个函数入口——这才是真实世界里的“基础开发”。

2. 定时器资源布局与选型逻辑：别急着写代码，先画张资源地图

2.1 STM32F103VET的定时器家族谱系

VET封装有100个引脚，内部集成了8个独立定时器，但它们不是平等的。必须按功能层级拆开看：

• 高级控制定时器（TIM1/TIM8）：仅TIM1可用（TIM8在VET上未引出）。带死区生成、互补输出、刹车功能，专为FOC电机控制或三相逆变器设计。如果你只是做LED呼吸灯或测脉冲频率，用它纯属杀鸡用牛刀，还容易因高级功能未初始化导致异常。

• 通用定时器（TIM2/TIM3/TIM4/TIM5）：这是你日常打交道的主力。其中TIM2和TIM3是32位，TIM4和TIM5是16位。注意：TIM2挂载在APB1总线上，最大时钟72MHz；TIM5挂载在APB2上，最大时钟144MHz。但别急着选TIM5——APB2上还挤着USART1、SPI1、ADC1等高速外设，资源争抢更激烈。实际经验：90%的周期性任务（如1ms系统滴答、PWM调光、编码器计数）用TIM2完全够用，且干扰最小。

• 基本定时器（TIM6/TIM7）：纯计数器，无输入捕获/输出比较通道，只支持更新中断。它是SysTick的平替方案，但优势在于可自由配置重装载值（SysTick固定24位）。我常把它用作后台低频任务调度器，比如每500ms检查一次看门狗喂食状态，完全不占用主定时器资源。

• SysTick定时器：Cortex-M3内核自带，24位倒计数，专为RTOS滴答服务。但它有个致命缺陷：一旦进入低功耗模式（如STOP模式），SysTick会停摆。而TIMx只要配置成使用外部时钟（如LSI），就能在STOP模式下继续计数——这在电池供电设备里是保命功能。

提示：新手最容易犯的错误是“见定时器就用TIM2”。但TIM2的CH1通道（PA0）常被用作SWD调试接口的SWO引脚。如果你同时启用TIM2_CH1输出PWM和SWD调试，会发现程序烧录失败或调试断连。实测解决方案：要么改用TIM3_CH1（PB4），要么在CubeMX里把SWO功能禁用。

2.2 时钟树才是定时器的真正老板

所有定时器的节奏，最终都由RCC时钟树决定。F103的时钟路径看似复杂，其实抓住两个关键节点就行：

1. APB1预分频器（PCLK1）：HCLK（72MHz）经过APB1预分频后得到PCLK1。默认配置是不分频（PCLK1 = HCLK = 72MHz），但很多CubeMX模板会误设为2分频（PCLK1 = 36MHz），导致TIM2时钟减半。查证方法：在SystemCoreClockUpdate()后打印HAL_RCC_GetPCLK1Freq()，必须等于72000000。

2. 定时器时钟使能开关：每个TIMx都有独立的使能位。例如TIM2对应RCC->APB1ENR |= RCC_APB1ENR_TIM2EN;。CubeMX会自动生成，但手动写寄存器时极易遗漏。后果不是“没反应”，而是定时器寄存器读写全部返回0xFF——你往TIM2->ARR写0x9C40，读出来还是0xFFFF，这种诡异现象90%是时钟没开。

我遇到过最隐蔽的时钟问题：客户产线批量焊接后，10%的板子TIM2中断丢失。排查三天发现是PCB上晶振负载电容用了12pF（标准应为20pF），导致HSI精度漂移，RCC校准失败，APB1时钟实际只有68MHz。解决方案不是改代码，而是换电容——这提醒我们：定时器的稳定性，一半靠代码，一半靠硬件设计。

2.3 为什么“51定时器”思维在这里会翻车？

51单片机的定时器是“独占式”的：T0、T1各管各的，中断向量固定。而STM32的TIMx是“共享式”的：TIM2/TIM3共用同一个中断向量（TIM2_IRQn），TIM4/TIM5共用另一个（TIM4_IRQn）。这意味着：

• 如果你同时启用TIM2和TIM3的更新中断，它们会触发同一个中断服务函数（TIM2_IRQHandler）；
• 在ISR里必须先读取TIM2->SR和TIM3->SR的状态寄存器，判断是哪个定时器溢出；
• 更麻烦的是，如果TIM2的ISR执行时间超过TIM3的周期，TIM3的中断会被挂起，直到TIM2退出——这就是“中断嵌套丢失”的根源。

实操心得：除非必要，永远不要让两个定时器共用同一中断向量。我的做法是：TIM2专职系统滴答（1ms），TIM3专职PWM输出（10kHz），TIM4专职输入捕获（测频率）。这样每个ISR职责单一，代码可维护性高，且避免了状态寄存器轮询的CPU开销。

3. 从零构建TIM2 1ms中断：手撕寄存器版全流程

3.1 第一步：确认时钟源并使能

别信CubeMX生成的代码，自己动手验证才踏实。以下代码片段直接操作寄存器，省去HAL库的抽象层：

// 1. 确保HCLK=72MHz（假设已配置好PLL） // 2. 配置APB1预分频为1（即PCLK1=72MHz） RCC->CFGR &= ~RCC_CFGR_PPRE1; // 清除PPRE1[1:0]位 RCC->CFGR |= RCC_CFGR_PPRE1_DIV1; // 设置为不分频 // 3. 使能TIM2时钟 RCC->APB1ENR |= RCC_APB1ENR_TIM2EN; // 4. 等待时钟使能生效（必须！） while(!(RCC->APB1ENR & RCC_APB1ENR_TIM2EN));

注意：RCC->APB1ENR |= RCC_APB1ENR_TIM2EN;这行之后必须加while等待。我曾因省略这句，在某批ST官方开发板上出现TIM2寄存器写无效——原因是APB总线同步需要2个时钟周期，不等待就操作寄存器，值会丢失。

3.2 第二步：配置TIM2核心参数

TIM2是32位定时器，ARR（自动重装载值）最大0xFFFFFFFF。要实现1ms定时，需计算：

计数周期 = 1ms = 0.001s 定时器时钟频率 = PCLK1 = 72MHz = 72,000,000 Hz 所需计数值 = 72,000,000 × 0.001 = 72,000

但72,000超出了16位范围（65535），所以必须用预分频器（PSC）降频：

// 设置预分频器：72MHz / (7199 + 1) = 10kHz TIM2->PSC = 7199; // 注意：PSC是递增计数，值为N时分频系数为N+1 // 设置重装载值：10kHz / 1000Hz = 10 TIM2->ARR = 9; // ARR是递减计数，值为N时周期为N+1 // 清除计数器，防止初始值影响 TIM2->CNT = 0; // 使能更新中断 TIM2->DIER |= TIM_DIER_UIE; // 启动定时器 TIM2->CR1 |= TIM_CR1_CEN;

这里的关键细节：

• PSC=7199实现72MHz→10kHz分频，比直接设ARR=71999更稳妥（避免ARR溢出风险）；
• ARR=9对应10次计数，即10kHz时钟下的1ms周期；
• TIM2->CR1 |= TIM_CR1_CEN;必须最后执行，否则在配置过程中可能触发意外中断。

3.3 第三步：配置NVIC并编写ISR

STM32F103的NVIC有16级抢占优先级。TIM2_IRQn的编号是28（查RM0008 Table 66）。配置时必须注意：

// 设置TIM2中断优先级：抢占优先级1，响应优先级0 NVIC_SetPriority(TIM2_IRQn, NVIC_EncodePriority(1, 1, 0)); // 使能TIM2中断 NVIC_EnableIRQ(TIM2_IRQn); // 中断服务函数（必须命名为TIM2_IRQHandler） void TIM2_IRQHandler(void) { // 1. 先清除更新中断标志（关键！） if(TIM2->SR & TIM_SR_UIF) { TIM2->SR &= ~TIM_SR_UIF; // 手动清零UIF位 // 2. 执行你的1ms任务（如LED翻转） HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // 3. 注意：此处不能调用HAL_Delay()等阻塞函数！ // 因为中断上下文不允许调度器介入 } }

常见陷阱：很多教程教“__HAL_TIM_CLEAR_IT(&htim2, TIM_IT_UPDATE);”，但这依赖HAL库的句柄结构体。手撕寄存器时，必须用TIM2->SR &= ~TIM_SR_UIF;直接操作状态寄存器。漏掉这句会导致中断持续触发，CPU永远卡在ISR里。

3.4 第四步：用示波器验证波形

写完代码别急着庆祝，接上示波器验证才是硬道理：

• 探头夹在PA5（LED引脚），设置时基1ms/div；
• 正常波形应为严格的方波，高电平500us，低电平500us；
• 如果发现波形抖动（如周期在0.98ms~1.02ms间跳变），说明中断响应时间不稳定——可能是其他高优先级中断（如USB）抢占了TIM2；
• 如果波形完全消失，用逻辑分析仪抓TIM2->SR寄存器，确认UIF位是否真的被置位。

我实测过：在TIM2 ISR里加入__NOP()指令，每加一个NOP，波形高电平时间增加1个CPU周期（13.9ns）。这证明中断延迟完全可控，误差在纳秒级——这才是真正的“基础开发”该达到的精度。

4. PWM输出实战：用TIM3_CH2驱动RGB灯带

4.1 为什么选TIM3而不是TIM2？

TIM2的CH1（PA0）已被SWD占用，CH2（PA1）是普通IO，但RGB灯带需要3路独立PWM（红/绿/蓝）。TIM3有4个通道（CH1~CH4），且PB0/PB1/PB5分别对应CH2/CH3/CH4，引脚资源充裕。更重要的是：TIM3和TIM2的时钟源完全独立，不会因TIM2做系统滴答而影响PWM精度。

4.2 PWM模式选择与寄存器配置

STM32的PWM分两种模式：

• 模式1（OCM=010）：计数器向上计数，CNT < CCRx时输出有效电平；
• 模式2（OCM=110）：计数器向上计数，CNT > CCRx时输出有效电平。

RGB灯带通常要求“占空比越大越亮”，所以选模式1，且有效电平为高电平（极性=0）：

// 1. 使能TIM3时钟 RCC->APB1ENR |= RCC_APB1ENR_TIM3EN; // 2. 配置TIM3为10kHz PWM（同TIM2计算逻辑） TIM3->PSC = 7199; // 72MHz → 10kHz TIM3->ARR = 999; // 10kHz → 100Hz PWM（便于人眼观察） // 3. 配置CH2为PWM模式1 TIM3->CCMR1 |= TIM_CCMR1_OC2M_1 | TIM_CCMR1_OC2M_2; // OCM=110? 错！应为010 TIM3->CCMR1 &= ~TIM_CCMR1_OC2M_0; // 清除OC2M[0]，确保OCM=010 TIM3->CCER |= TIM_CCER_CC2E; // 使能CH2输出 // 4. 设置初始占空比（50%） TIM3->CCR2 = 500; // 5. 主输出使能（TIM3无BDTR寄存器，无需此步） TIM3->CR1 |= TIM_CR1_CEN;

关键纠错：网上大量教程把OCM=010写成TIM_CCMR1_OC2M_1 | TIM_CCMR1_OC2M_2，这是错误的！正确值是TIM_CCMR1_OC2M_1（即OC2M[2:0]=010）。多写一个_2会导致OCM=110，输出逻辑反转——灯带会变成“占空比越大越暗”，调试时极易误判为硬件故障。

4.3 GPIO复用配置与电气匹配

PB0作为TIM3_CH2输出，必须配置为复用推挽：

// 1. 使能GPIOB时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPBEN; // 2. 配置PB0为复用推挽（50MHz速度） GPIOB->CRH &= ~(GPIO_CRH_MODE0 | GPIO_CRH_CNF0); GPIOB->CRH |= GPIO_CRH_MODE0_0 | GPIO_CRH_MODE0_1; // MODE=11（50MHz） GPIOB->CRH |= GPIO_CRH_CNF0_1; // CNF=01（复用推挽） // 3. 开启AFIO时钟（必须！否则复用功能无效） RCC->APB2ENR |= RCC_APB2ENR_AFIOEN; AFIO->MAPR |= AFIO_MAPR_TIM3_REMAP_PARTIAL; // 部分重映射，CH2→PB0

电气注意：RGB灯带工作电流常达2A，STM32的IO口最大灌电流仅25mA。必须外接MOSFET驱动。我用IRF540N（Vgs=10V导通），栅极串10kΩ电阻防振荡，源极接地，漏极接LED负极——这样TIM3输出的3.3V PWM信号就能安全控制大电流。

4.4 动态调整占空比的技巧

直接改TIM3->CCR2会引发闪烁，因为ARR和CCRx不同步更新。正确做法是：

// 在主循环中调用此函数 void SetRGBBrightness(uint16_t red, uint16_t green, uint16_t blue) { // 使用影子寄存器：先写入CCRx，再通过UG位更新 TIM3->CCR2 = red; TIM3->CCR3 = green; TIM3->CCR4 = blue; // 手动触发更新事件，同步所有通道 TIM3->EGR |= TIM_EGR_UG; }

TIM3->EGR |= TIM_EGR_UG;这句是精髓。它强制所有CCR寄存器立即加载新值，避免红绿蓝三色不同步导致的色彩偏移——这是商业LED控制器的标配操作。

5. 输入捕获测频率：用TIM4_CH1解码红外遥控信号

5.1 为什么选TIM4？

TIM4有独立的输入捕获通道（CH1=PD12），且PD12不与其他外设冲突。更重要的是：TIM4支持从模式（Slave Mode），可将外部信号（如红外载波）作为定时器时钟源，彻底摆脱主时钟精度限制。

5.2 红外信号特征与捕获策略

NEC协议红外信号特点：

• 载波频率38kHz（周期26.3us）；
• 逻辑“0”：560us低电平 + 560us高电平；
• 逻辑“1”：560us低电平 + 1690us高电平；
• 帧头：9ms低电平 + 4.5ms高电平。

若用主时钟（72MHz）直接捕获，26.3us对应约1892个时钟周期，测量误差±1周期即±13.9ns，远超需求。但若将红外信号接入TIM4的TI1引脚，并配置为外部时钟模式1（ETR模式），则TIM4计数器直接以38kHz为基准，测量精度提升百倍。

5.3 从模式配置详解

// 1. 配置PD12为浮空输入（红外接收头输出为开漏） GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = GPIO_PIN_12; GPIO_InitStruct.Mode = GPIO_MODE_INPUT; GPIO_InitStruct.Pull = GPIO_NOPULL; HAL_GPIO_Init(GPIOD, &GPIO_InitStruct); // 2. 配置TIM4为外部时钟模式1（TI1FP1） TIM4->SMCR |= TIM_SMCR_SMS_2; // 从模式：外部时钟模式1 TIM4->SMCR |= TIM_SMCR_TS_TI1FP1; // 触发源：TI1FP1（PD12） // 3. 配置输入滤波器（抗红外干扰） TIM4->CCMR1 |= TIM_CCMR1_IC1F_0 | TIM_CCMR1_IC1F_1; // IC1F=11（fS/8，8个采样周期） // 4. 配置上升沿捕获 TIM4->CCER |= TIM_CCER_CC1E | TIM_CCER_CC1P; // CC1E=1, CC1P=1（上升沿） // 5. 开启更新中断（用于帧结束检测） TIM4->DIER |= TIM_DIER_UIE; TIM4->ARR = 0xFFFF; // 防止溢出中断干扰

核心原理：当红外信号接入PD12，TIM4的计数器不再受PCLK1驱动，而是以红外载波边沿为时钟。此时TIM4->CNT的值直接代表“从上次上升沿到本次上升沿的时间”，单位是38kHz周期（26.3us）。测得CNT=212，即212×26.3us≈5.58ms——这正是NEC协议的逻辑“1”高电平宽度。

5.4 捕获中断处理与去抖

volatile uint16_t capture_buffer[32]; volatile uint8_t capture_index = 0; void TIM4_IRQHandler(void) { if(TIM4->SR & TIM_SR_CC1IF) // 捕获中断 { // 读取捕获值（自动存入CCR1） uint16_t cap_val = TIM4->CCR1; // 清除捕获标志 TIM4->SR &= ~TIM_SR_CC1IF; // 存入缓冲区（环形队列） capture_buffer[capture_index++] = cap_val; if(capture_index >= 32) capture_index = 0; } if(TIM4->SR & TIM_SR_UIF) // 更新中断（帧超时） { TIM4->SR &= ~TIM_SR_UIF; // 处理完整帧：分析capture_buffer中连续32个值 ProcessIRFrame(); } }

实操心得：红外环境噪声极大，单次捕获不可靠。我采用“三次连续相同值判定为有效”的策略：若capture_buffer[i]、capture_buffer[i+1]、capture_buffer[i+2]均在560±50us范围内，则认定为逻辑“0”起始。这比单纯阈值判断鲁棒得多，实测在强日光下误码率<0.1%。

6. 常见问题与硬核排查指南

6.1 定时器不进中断的10种可能原因速查表

6.2 “stm32定时器捕获测频率”不准的根源分析

热词里高频出现的“测频率不准”，90%源于三个被忽视的细节：

1. 输入滤波器配置错误：TIMx->CCMRy |= TIM_CCMRy_ICyF设置不当。若ICyF=00（无滤波），高频噪声会触发虚假捕获；若ICyF=11（fS/8），则要求输入信号频率< fCK_INT/8。实测建议：对38kHz红外，设ICyF=01（fS/2）最平衡。

2. 捕获边沿选择失误：NEC协议用下降沿表示逻辑变化，但很多人配置为上升沿捕获。结果是测得的“高电平时间”实际是“低电平时间”。验证方法：用示波器对比PD12波形与TIMx->CCRy值，若数值与波形反相，立即改CCER的CCyP位。

3. ARR溢出干扰：当测量长周期信号（如1Hz方波），若ARR设为0xFFFF，72MHz下溢出周期≈596ms。若信号周期>596ms，TIMx会先触发更新中断，再触发捕获中断，导致时间戳错乱。解决方案：动态调整ARR——测短周期用小ARR，测长周期用大ARR，并在ISR中切换。

6.3 “hal库定时器”与“寄存器开发”的取舍建议

HAL库不是洪水猛兽，但要用对场景：

• 适合HAL的场景：快速原型验证、学生实验、功能简单且不涉及时序敏感的应用（如LED呼吸灯）。HAL的HAL_TIM_Base_Start_IT()封装了NVIC配置，省去底层细节。

• 必须手撕寄存器的场景：

  • 工业现场要求中断延迟<1μs（HAL的函数调用开销约0.5μs）；
  • 电池供电设备需精确控制功耗（HAL初始化会开启所有未用通道）；
  • 多定时器协同（如FOC中TIM1触发ADC，TIM8做死区）；
  • 客户要求代码体积<8KB（HAL库代码膨胀严重）。

我的经验：用HAL生成初始化框架，用寄存器写核心ISR。比如用CubeMX配置时钟和GPIO，然后手动写TIM2_IRQHandler——既享受图形化配置的便利，又保留底层控制权。

6.4 “滴答定时器”与“通用定时器”的终极选择指南

最后分享个小技巧：在TIM6中断里喂独立看门狗（IWDG），比用SysTick更可靠。因为IWDG时钟来自LSI（40kHz），不受主时钟故障影响。我设计的电表固件，TIM6每500ms执行IWDG_ReloadCounter()，即使主程序死锁，看门狗也能在1.2秒内复位系统——这才是工业级“基础开发”的底线。

我在产线调定时器的第七年，越来越确信：所谓“基础”，不是指代码行数少，而是指每一个寄存器位的设置都有明确意图，每一次中断触发都可预测，每一处时序偏差都能定位到物理层。当你能对着示波器波形，说出“这个毛刺是因为TIM3的ARR更新没同步”，你就真正掌握了STM32F103VET定时器的基础。