STM32HAL定时器

### STM32 HAL 定时器使用教程及示例代码

#### 介绍
STM32 HAL 库提供了简化硬件抽象层接口的功能，使得开发者可以更方便地操作定时器。通过这些API函数，能够轻松配置并控制各种类型的定时器行为，包括但不限于输入捕获、输出比较以及PWM信号生成等功能[^1]。

#### 配置环境
为了能够在项目中使用HAL库来管理定时器，首先需要确保已经安装好必要的开发工具链，并且正确设置了工程文件以便支持所选型号的MCU芯片。通常情况下这涉及到下载官方提供的固件包并将其中包含的标准外设驱动程序集成到自己的应用程序里去[^2]。

#### 初始化定时器
下面是一个简单的例子展示了怎样初始化一个通用定时器(Timer)，这里假设选择了TIM2作为目标设备：

// 导入头文件
#include "stm32f4xx_hal.h"

// 创建全局变量用于保存定时器句柄
TIM_HandleTypeDef htim2;

void MX_TIM2_Init(void){
    __HAL_RCC_TIM2_CLK_ENABLE(); // 启用 TIM2 的时钟
    
    htim2.Instance = TIM2;
    
    // 设置自动重装载预分频值
    htim2.Init.Prescaler = 8000 - 1;  
    htim2.Init.CounterMode = TIM_COUNTERMODE_UP;
    htim2.Init.Period = 999;           // 自动重载值设置为999,即计数范围是从0至999
    htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
    htim2.Init.RepetitionCounter = 0;
    
    if (HAL_TIM_Base_Init(&htim2) != HAL_OK){
        Error_Handler();
    }
}

这段代码完成了对指定实例（这里是`TIM2`）的基础参数设定工作，比如选择向上计数模式(`TIM_COUNTERMODE_UP`)、定义周期长度等；最后调用了`HAL_TIM_Base_Init()`完成实际的初始化过程。

#### 输入捕获功能实现
当想要测量来自外部事件触发的时间间隔或者频率的时候就可以启用输入捕捉特性了。以下是具体做法的一个片段:

static void TIM_ConfigInputCapture(TIM_HandleTypeDef *htim,uint32_t Channel){
    TIM_SlaveConfigTypeDef sSlaveConfig = {0};
    TIM_IC_InitTypeDef sConfigIC = {0};

    /* Input Capture configuration */
    sConfigIC.ICPolarity = TIM_INPUTCHANNELPOLARITY_RISING;//上升沿触发
    sConfigIC.ICSelection = TIM_ICSELECTION_DIRECTTI;
    sConfigIC.ICPrescaler = TIM_ICPSC_DIV1;
    sConfigIC.ICFilter = 0;
    
    if(HAL_TIM_IC_ConfigChannel(htim,&sConfigIC,Channel)!= HAL_OK){
      Error_Handler();
    }

    /* Slave Mode Configuration */
    sSlaveConfig.SlaveMode = TIM_SLAVEMODE_RESET;
    sSlaveConfig.InputTrigger = TIM_TS_TI1FP1;
    if(HAL_TIM_SlaveConfigSynchro(htim,&sSlaveConfig)!= HAL_OK){
       Error_Handler();
     }   
}

int main(){
   ...
   MX_TIM2_Init();
   TIM_ConfigInputCapture(&htim2,TIM_CHANNEL_1);
   ...
}

上述C语言代码实现了针对特定通道（此案例中为`TIM_CHANNEL_1`）的输入捕获配置，指定了边沿检测方式和其他必要选项之后再将其应用到了选定的定时器上。