单片机与物联网 / 系统课时

通用定时器计数

通用定时器计数

通用定时器能把外设时钟转换成稳定的计数节拍,但配置时最容易在 APB 倍频、预分频加一和自动重装载加一处出错。本课将完成 TIM2 的 1 秒周期配置,并给出可在 STM32F103 HAL 工程中运行的完整代码。

学习目标

  • 能够从 APB 时钟推导通用定时器的实际输入时钟。
  • 能够根据目标周期计算 PSC 与 ARR。
  • 能够启动更新中断,并通过计数变量和 LED 验证周期。

时钟链与计数公式

通用定时器的计数链路可以概括为“定时器时钟 → 预分频器 → 计数器 → 自动重装载”。计数器向上计数时,会依次经历 0 到 ARR,因此一次完整周期包含 ARR + 1 个计数节拍,而不是 ARR 个。

在 STM32F1 中,若 APB 预分频系数为 1,定时器时钟等于对应的 PCLK;若 APB 预分频系数大于 1,定时器时钟通常等于 2 × PCLK。例如 PCLK1 = 36 MHz 且 APB1 分频为 2 时,TIM2 的输入时钟是 72 MHz。

计数频率与更新周期分别为:

fcnt=ftimPSC+1f_{cnt}=\frac{f_{tim}}{PSC+1}
Tupdate=(PSC+1)(ARR+1)ftimT_{update}=\frac{(PSC+1)(ARR+1)}{f_{tim}}

若目标是 1 秒更新一次,可选择 PSC = 7199,先把 72 MHz 分频到 10 kHz;再设置 ARR = 9999,让计数器累计 10000 个节拍,最终得到 1 Hz 更新事件。

通用定时器时钟与计数周期

以 STM32F103 的 TIM2 为例,PSC 与 ARR 均按 16 位范围使用,合法值为 0~65535。计算时不仅要满足周期,还要检查两个寄存器是否越界;若目标周期很长,可以降低计数频率,或在每次更新中断中再进行软件累加。

配置并运行 TIM2

下面示例假设开发板使用 8 MHz HSE,并将系统时钟配置为 72 MHz。TIM2 每 1 秒产生一次更新中断,回调函数递增 seconds,同时翻转 PC13。若开发板 LED 为低电平点亮,会表现为每秒切换一次亮灭状态。

将代码作为 STM32F103C8Tx HAL 工程中 Core/Src/main.c 的主体,并确保工程其他文件没有重复定义 TIM2_IRQHandler 与 HAL_TIM_Base_MspInit。

c
#include "stm32f1xx_hal.h"

TIM_HandleTypeDef htim2;
volatile uint32_t seconds = 0;

static void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_TIM2_Init(void);
void Error_Handler(void);

int main(void) {
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_TIM2_Init();

    /* 初始化可能产生更新标志,启动前先清除。 */
    __HAL_TIM_CLEAR_FLAG(&htim2, TIM_FLAG_UPDATE);
    if (HAL_TIM_Base_Start_IT(&htim2) != HAL_OK) {
        Error_Handler();
    }

    while (1) {
        __WFI();
    }
}

static void SystemClock_Config(void) {
    RCC_OscInitTypeDef oscillator = {0};
    RCC_ClkInitTypeDef clock = {0};

    oscillator.OscillatorType = RCC_OSCILLATORTYPE_HSE;
    oscillator.HSEState = RCC_HSE_ON;
    oscillator.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
    oscillator.PLL.PLLState = RCC_PLL_ON;
    oscillator.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    oscillator.PLL.PLLMUL = RCC_PLL_MUL9;
    if (HAL_RCC_OscConfig(&oscillator) != HAL_OK) {
        Error_Handler();
    }

    clock.ClockType = RCC_CLOCKTYPE_HCLK |
                      RCC_CLOCKTYPE_SYSCLK |
                      RCC_CLOCKTYPE_PCLK1 |
                      RCC_CLOCKTYPE_PCLK2;
    clock.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
    clock.AHBCLKDivider = RCC_SYSCLK_DIV1;
    clock.APB1CLKDivider = RCC_HCLK_DIV2;
    clock.APB2CLKDivider = RCC_HCLK_DIV1;
    if (HAL_RCC_ClockConfig(&clock, FLASH_LATENCY_2) != HAL_OK) {
        Error_Handler();
    }
}

static void MX_GPIO_Init(void) {
    GPIO_InitTypeDef gpio = {0};

    __HAL_RCC_GPIOC_CLK_ENABLE();
    HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET);

    gpio.Pin = GPIO_PIN_13;
    gpio.Mode = GPIO_MODE_OUTPUT_PP;
    gpio.Speed = GPIO_SPEED_FREQ_LOW;
    HAL_GPIO_Init(GPIOC, &gpio);
}

static void MX_TIM2_Init(void) {
    htim2.Instance = TIM2;
    htim2.Init.Prescaler = 7199;
    htim2.Init.CounterMode = TIM_COUNTERMODE_UP;
    htim2.Init.Period = 9999;
    htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
    htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE;

    if (HAL_TIM_Base_Init(&htim2) != HAL_OK) {
        Error_Handler();
    }
}

void HAL_TIM_Base_MspInit(TIM_HandleTypeDef *timer) {
    if (timer->Instance == TIM2) {
        __HAL_RCC_TIM2_CLK_ENABLE();
        HAL_NVIC_SetPriority(TIM2_IRQn, 1, 0);
        HAL_NVIC_EnableIRQ(TIM2_IRQn);
    }
}

void TIM2_IRQHandler(void) {
    HAL_TIM_IRQHandler(&htim2);
}

void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *timer) {
    if (timer->Instance == TIM2) {
        ++seconds;
        HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
    }
}

void Error_Handler(void) {
    __disable_irq();
    while (1) {
    }
}

预期结果

text
上电后 TIM2 每 1 秒产生一次更新中断。
seconds 的值依次变为 1、2、3、4……
PC13 电平每秒翻转一次,连接在该引脚上的低有效 LED 每秒切换亮灭状态。

调试时可在 HAL_TIM_PeriodElapsedCallback 处设置断点,并将 seconds 加入 Watch。两次进入回调的间隔应约为 1 秒。断点会暂停处理器,因此不适合用断点精确测量长期周期;需要精确验证时,可用示波器或逻辑分析仪测量 PC13 翻转波形。

常见错误与验证方法

第一类错误是直接把 PCLK1 当成 TIM2 时钟。只要 APB1 分频系数大于 1,就应检查芯片参考手册中的定时器倍频规则。在本例中,PCLK1 为 36 MHz,但 TIM2 的时钟是 72 MHz;若误用 36 MHz 计算,实际周期会变成预期值的一半。

第二类错误是忽略 PSC + 1 和 ARR + 1。寄存器写入 7199 代表除以 7200,写入 9999 代表累计 10000 个计数。可以把最终参数代回公式,确认结果严格等于目标周期,再写入工程。

第三类错误是在 ISR 中执行延时、格式化日志或复杂计算。更新中断只应完成清标志、计数和轻量状态更新。若中断频率提高,过长的 ISR 会阻塞其他中断,甚至造成新的更新事件在处理期间再次挂起。

若计数值完全不变化,应按“TIM2 时钟是否使能 → HAL_TIM_Base_Init 是否成功 → 更新中断是否使能 → NVIC 是否使能 → TIM2_IRQHandler 是否调用 HAL 处理函数”的顺序检查。该顺序能快速区分时钟、外设和中断链路问题。

本课总结

  • 定时器周期由实际 TIMxCLK、PSC + 1 和 ARR + 1 共同决定。
  • APB 分频大于 1 时,要特别检查定时器时钟是否为 2 × PCLK。
  • 配置完成后应同时验证寄存器计算、更新中断和外部引脚波形。

下一课预告

后续可以在基础计数之上继续学习输出比较、PWM 和输入捕获,让定时器不仅产生固定节拍,还能生成波形并测量外部信号。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

通用定时器计数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通