7.4.1 常规定时器的句柄TIM_HandleTypeDef
常规定时器的HAL库通用句柄TIM_HandleTypeDef用于实现对定时器参数的配置,其常用功能有基本定时、输出比较、输入捕获等,对应的结构体用于完成对相应功能的初始化。
1.基本定时功能结构体TIM_HandleTypeDef
常规定时器中所有功能均用到TIM_HandleTypeDef结构体,其定义如下。

主要语句功能如下。
①Instance:定义TIM寄存器。
②Init:定义定时功能的基本操作,其定义如下。

③Channel:定时器的通道选择。
通道0:HAL_T IM_ACT IVE_CHANNEL_1。
通道1:HAL_T IM_ACT IVE_CHANNEL_2。
通道2:HAL_T IM_ACT IVE_CHANNEL_3。
通道3:HAL_T IM_ACT IVE_CHANNEL_4。
④hdma:定时器DMA相关的结构体。
⑤Lock:锁定对象。
2.输出比较功能结构体TIM_OC_InitTypeDef
输出比较功能结构体为TIM_OC_InitTypeDef,该结构体用于实现输出比较功能相关参数的初始化,其定义如下。

主要语句功能如下。
①OCMode:输出以下比较模式。(https://www.daowen.com)
TIM_OCMODE_TIMING。
TIM_OCMODE_ACTIVE。
IM_OCMODE_INACTIVE。
TIM_OCMODE_TOGGLE。
TIM_OCMODE_PWM1。
TIM_OCMODE_PWM2。
TIM_OCMODE_FORCED_ACTIVE。
TIM_OCMODE_FORCED_INACTIVE。
②OCPolarity:输出端极性,可以是TIM_OCPOLARITY_HIGH、TIM_OCPOLARITY_LOW。
③OCNPolarity:快速模式状态,可以是TIM_OCFAST_DISABLE、TIM_OCFAST_ENABLE。
④OCIdleState:空闲状态下输出比较引脚的状态,可以是TIM_OCIDLESTATE_SET、TIM_OCIDLESTATE_RESET。
3.输入捕获功能结构体TIM_IC_InitTypeDef
输入捕获功能结构体为TIM_IC_InitTypeDef,用于对输入捕获功能的相关参数进行初始化配置,定义如下。

主要语句功能如下。
①ICPolarity:输入捕获边沿检测,可以是TIM_ICPOLARITY_RISING(上升沿)、TIM_ICPOLARITY_FALLING(下降沿)、TIM_ICPOLARITY_BOTHEDGE(双边沿)。
②ICSelection:输入捕获连接选择,可以是TIM_ICSELECTION_DIRECTTI(1~4通道直接与芯片相连)、TIM_ICSELECTION_INDIRECTTI(不直接连)、TIM_ICSELECTION_TRC。
③ICPrescaler:输入捕获脉冲分频值,可以是TIM_ICPSC_DIV1(1分频)、TIM_ICPSC_DIV2(2分频)、TIM_ICPSC_DIV4(4分频)、TIM_ICPSC_DIV8(8分频)。
④ICFilter:输入捕获滤波值,可以是0x0~0xF。