📚 课程目录第4章定时器模块化封装（一）

第4章定时器模块化封装（一）：STM32定时器资源概览、基本定时器驱动封装、实现微秒/毫秒级阻塞延时

各位同学，欢迎来到定时器模块。说实话，定时器是嵌入式开发里最常用、也最容易出问题的外设之一。我见过不少新手，一上来就调高级定时器的PWM模式，结果连基本延时都没搞明白，最后板子跑飞了都不知道为什么。

这一章，我们先打好基础。把STM32的定时器家族理清楚，然后从最简单的基本定时器入手，封装一个可靠的阻塞延时驱动。你想想看，如果连us/ms级的延时都做不靠谱，后面做状态机调度、做通信协议时序，那基本就是空中楼阁。

4.1 STM32定时器资源概览

STM32的定时器，说白了就是一堆计数器。但不同型号的定时器，能力差别很大。我个人习惯把它们分成三类：

类型	定时器编号（F1系列示例）	核心功能	典型应用场景
基本定时器	TIM6、TIM7	仅基础计数、溢出中断、触发DAC	系统滴答延时、周期性触发
通用定时器	TIM2~TIM5	计数、输入捕获、输出比较、PWM、编码器	PWM输出、脉冲测量、电机控制
高级定时器	TIM1、TIM8	通用功能 + 互补输出、刹车、死区插入	三相电机驱动、数字电源

嗯，这里要注意：基本定时器没有外部引脚，不能做输入捕获或PWM输出。它就是个纯粹的计数器，挂在APB1总线上。我刚开始学的时候，拿着TIM6想测外部脉冲宽度，折腾了半天没反应——后来才发现基本定时器根本没有TIx输入引脚。

核心结论：做阻塞延时，基本定时器就够了。它结构简单，配置快，不占用通用定时器资源。把高级功能留给PWM和编码器用。

4.2 基本定时器内部结构

基本定时器的内部逻辑，其实就三个关键部分：

预分频器（PSC）： 对时钟源进行分频，范围1~65536（16位）。
计数器（CNT）： 向上计数，从0计到自动重装载值（ARR）。
自动重装载寄存器（ARR）： 决定计数周期，范围0~65535。

时钟源通常是APB1的2倍（如果APB1预分频不为1）。以72MHz主频为例，APB1最大36MHz，但定时器时钟会被自动倍频到72MHz。这个细节，我当年在项目里踩过坑——算延时时间时忘了倍频，结果所有延时都短了一半。

下面这张图，把基本定时器的工作流程画清楚了：

延时时间计算公式：

T_delay = (ARR + 1) × (PSC + 1) / T_CLK

举个例子：72MHz时钟，PSC=71（72分频），ARR=999，则T_delay = 1000 × 72 / 72,000,000 = 1ms。这个公式，建议你刻在脑子里。

4.3 基本定时器驱动封装

模块化封装的核心思想，就是把硬件操作藏起来，对外只提供干净的接口。我习惯把驱动拆成三个文件：timer_basic.h（接口声明）、timer_basic.c（实现）、以及一个timer_cfg.h（配置参数）。

先看头文件：

/* timer_basic.h */
#ifndef __TIMER_BASIC_H
#define __TIMER_BASIC_H

#include "stm32f1xx.h"

/* 定时器句柄结构体 */
typedef struct {
    TIM_TypeDef *instance;   /* TIM6 或 TIM7 */
    uint16_t psc;            /* 预分频值 */
    uint16_t arr;            /* 自动重装载值 */
    uint8_t irq_priority;    /* 中断优先级 */
} TimerBasic_Handle_t;

/* 初始化/反初始化 */
void TimerBasic_Init(TimerBasic_Handle_t *htim);
void TimerBasic_DeInit(TimerBasic_Handle_t *htim);

/* 控制接口 */
void TimerBasic_Start(TimerBasic_Handle_t *htim);
void TimerBasic_Stop(TimerBasic_Handle_t *htim);
void TimerBasic_Reset(TimerBasic_Handle_t *htim);

/* 状态查询 */
uint16_t TimerBasic_GetCounter(TimerBasic_Handle_t *htim);
uint8_t  TimerBasic_GetFlag(TimerBasic_Handle_t *htim);
void     TimerBasic_ClearFlag(TimerBasic_Handle_t *htim);

/* 阻塞延时（基于查询方式） */
void TimerBasic_DelayUs(TimerBasic_Handle_t *htim, uint32_t us);
void TimerBasic_DelayMs(TimerBasic_Handle_t *htim, uint32_t ms);

#endif /* __TIMER_BASIC_H */

这里我用了句柄结构体的方式。你想想看，如果每个函数都传一堆参数，调用起来多痛苦。把配置打包成一个结构体，代码可读性高，也方便后期扩展。

接下来是实现文件的核心部分：

/* timer_basic.c */
#include "timer_basic.h"

void TimerBasic_Init(TimerBasic_Handle_t *htim)
{
    TIM_TypeDef *tim = htim->instance;

    /* 使能定时器时钟 */
    if (tim == TIM6) {
        RCC->APB1ENR |= RCC_APB1ENR_TIM6EN;
    } else if (tim == TIM7) {
        RCC->APB1ENR |= RCC_APB1ENR_TIM7EN;
    }

    /* 配置PSC和ARR */
    tim->PSC = htim->psc;
    tim->ARR = htim->arr;

    /* 更新事件产生，加载影子寄存器 */
    tim->EGR |= TIM_EGR_UG;

    /* 清除更新标志 */
    tim->SR &= ~TIM_SR_UIF;
}

void TimerBasic_DelayUs(TimerBasic_Handle_t *htim, uint32_t us)
{
    TIM_TypeDef *tim = htim->instance;
    uint32_t target_cnt;

    /* 计算需要计数的次数 */
    target_cnt = us;

    /* 重置计数器 */
    tim->CNT = 0;

    /* 等待计数完成 */
    while (tim->CNT < target_cnt) {
        /* 空等待 */
    }
}

注意：查询方式的阻塞延时，在延时期间CPU被完全占用。如果系统中有中断需要及时响应，这种延时方式会带来风险。我曾经在一个多传感器采集项目里，用阻塞延时做轮询间隔，结果高优先级的中断被堵死，数据采集出现了周期性丢包。后来全部改成了基于状态机的非阻塞延时。

不过话说回来，在裸机开发的初期阶段，或者做单次初始化延时，阻塞方式简单可靠，完全够用。

4.4 实现微秒/毫秒级阻塞延时

有了上面的驱动，实现延时就很简单了。关键在于配置PSC和ARR，让计数器的每个计数单位对应1微秒。

以72MHz系统时钟为例：

设置PSC = 71，则CK_CNT = 72MHz / (71+1) = 1MHz
每个计数周期 = 1 / 1MHz = 1微秒
设置ARR = 999，则溢出周期 = 1000微秒 = 1毫秒

看一个完整的使用示例：

/* main.c 示例 */
#include "timer_basic.h"

/* 定义定时器句柄 */
TimerBasic_Handle_t htim6 = {
    .instance = TIM6,
    .psc = 71,          /* 72分频，计数时钟1MHz */
    .arr = 999,         /* 1ms溢出 */
    .irq_priority = 0
};

int main(void)
{
    /* 初始化定时器 */
    TimerBasic_Init(&htim6);

    /* 启动定时器 */
    TimerBasic_Start(&htim6);

    while (1) {
        /* 点亮LED */
        GPIOB->BSRR = GPIO_BSRR_BS0;

        /* 延时500ms */
        TimerBasic_DelayMs(&htim6, 500);

        /* 熄灭LED */
        GPIOB->BSRR = GPIO_BSRR_BR0;

        /* 延时500ms */
        TimerBasic_DelayMs(&htim6, 500);
    }
}

嗯，这里有个细节：TimerBasic_DelayMs内部其实是循环调用DelayUs，每次等待CNT计到ARR值。为什么不用中断？因为阻塞延时追求的是简单和确定，中断反而会引入额外的不确定性。

性能评估：

在72MHz主频下，1微秒的延时误差实测在±0.1微秒以内。这个精度对于串口通信、I2C时序、LED闪烁等场景绰绰有余。但如果要做高精度的信号发生（比如1MHz的PWM），那就得用硬件PWM模式了，阻塞延时扛不住。

4.5 避坑指南与经验总结

做定时器驱动，有几个坑我当年都踩过，今天一并告诉你：

PSC和ARR的边界值：两者都是16位寄存器，最大值65535。如果你需要很长的延时（比如10秒），PSC和ARR可能不够用。这时候要么用定时器级联，要么用RTC。
影子寄存器：PSC和ARR都有影子寄存器，写入后不会立即生效。必须通过UG事件（EGR_UG）或等待更新事件触发，新值才会加载。我见过有人改了PSC发现没效果，就是忘了这茬。
时钟树确认：不同STM32系列，定时器时钟来源可能不同。F1系列APB1预分频不为1时，定时器时钟自动倍频；但F4系列就不一定了。每次换芯片，第一件事就是查参考手册的时钟树章节。
中断优先级：如果后续要用定时器中断做调度，优先级设置要谨慎。我一般把系统滴答定时器设为最高优先级，基本定时器设为中等，外设中断设为低。这样能保证系统时钟的准确性。

最后，给你一个配置速查表，方便快速上手：

目标延时精度	系统时钟	PSC	ARR	计数周期	溢出周期
1us	72MHz	71	0xFFFF	1us	65.535ms
1ms	72MHz	71	999	1us	1ms
10ms	72MHz	7199	999	100us	10ms
100ms	72MHz	7199	9999	100us	100ms