stm32hal 定时器

### STM32 HAL 库中定时器的用法

#### 初始化外部低速晶振输入输出引脚
在 `STM32F1XX_hal.c` 文件中，通过 HAL 库初始化函数完成对外部低速晶振输入输出引脚的配置[^1]。

#### 配置定时器并启用中断
为了实现捕获功能，需在 STM32CubeMX 中配置定时器，并确保已开启定时器全局中断。随后可以在项目源码里定义如下形式的回调函数：

void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim)
{
  /* 用户自定义处理逻辑 */
}

此部分操作允许开发者针对特定事件编写响应代码，从而增强应用灵活性[^2]。

#### 基础定时器工作模式介绍
基础定时器支持两种基本运行方式——连续定时模式与单次定时模式。具体取决于 TIMx_CR1 寄存器内 OPM 位的状态：
- 当 OPM=0，则处于连续定时模式；此时每当 UEV（Update Event）发生时不会停止计数过程；
- 若设定 OPM=1 则进入单次定时模式；这意味着一旦遇到下一个 UEV 后将会终止当前计数值的增长[^3]。

#### 示例代码展示如何创建一个简单的延时程序
下面给出一段基于上述理论构建的基础定时器实例化流程以及简单延时功能实现的方法：

#include "stm32f1xx_hal.h"

// 定义全局变量用于存储定时器句柄
TIM_HandleTypeDef TimHandle;

int main(void){
  
  // 系统初始化省略...

  // 设置定时器参数
  __HAL_RCC_TIM2_CLK_ENABLE(); // 开启定时器时钟
  
  TimHandle.Instance = TIM2;
  TimHandle.Init.Prescaler         = 7999;      // 设定预分频系数
  TimHandle.Init.CounterMode       = TIM_COUNTERMODE_UP; // 计数方向向上
  TimHandle.Init.Period            = 999;        // 自动重装载值
  TimHandle.Init.ClockDivision     = TIM_CLOCKDIVISION_DIV1;
  TimHandle.Init.RepetitionCounter = 0;
  
  if(HAL_TIM_Base_Init(&TimHandle) != HAL_OK){ 
    Error_Handler();
  }
  
  // 开始计数前启动更新中断(仅适用于需要中断的情况)
  HAL_TIM_Base_Start_IT(&TimHandle);
  
  while (1){
    
    // 主循环体...
    
  }
}

// 更新事件中断服务例程
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim){
  static uint8_t count = 0;
  
  if(htim->Instance==TIM2){
    count++;
    if(count >= 5){
      // 执行某些动作后复位计数器
      count = 0;
      
      // 可在此处加入其他业务逻辑
      
    }
  }
}

这段代码展示了如何利用 HAL 库来管理 STM32 的硬件资源，特别是对于那些希望快速上手嵌入式开发的新手来说非常有帮助。