A61 STM32_HAL库函数 之 TIM扩展驱动 -- C -- 所有函数的介绍及使用

1 该驱动函数预览

序号	函数名	描述
1	HAL_TIMEx_HallSensor_Init()	初始化定时器霍尔传感器模式。
2	HAL_TIMEx_HallSensor_DeInit()	反初始化定时器霍尔传感器模式。
3	HAL_TIMEx_HallSensor_MspInit()	初始化定时器霍尔传感器模式相关的MCU外设引脚或资源。
4	HAL_TIMEx_HallSensor_MspDeInit()	反初始化定时器霍尔传感器模式相关的MCU外设引脚或资源。
5	HAL_TIMEx_HallSensor_Start()	启动定时器霍尔传感器模式。
6	HAL_TIMEx_HallSensor_Stop()	停止定时器霍尔传感器模式。
7	HAL_TIMEx_HallSensor_Start_IT()	启动定时器霍尔传感器模式中断。
8	HAL_TIMEx_HallSensor_Stop_IT()	停止定时器霍尔传感器模式中断。
9	HAL_TIMEx_HallSensor_Start_DMA()	启动定时器霍尔传感器模式DMA传输。
10	HAL_TIMEx_HallSensor_Stop_DMA()	停止定时器霍尔传感器模式DMA传输。
11	HAL_TIMEx_OCN_Start()	启动定时器OCN功能。
12	HAL_TIMEx_OCN_Stop()	停止定时器OCN功能。
13	HAL_TIMEx_OCN_Start_IT()	启动定时器OCN功能中断。
14	HAL_TIMEx_OCN_Stop_IT()	停止定时器OCN功能中断。
15	HAL_TIMEx_OCN_Start_DMA()	启动定时器OCN功能DMA传输。
16	HAL_TIMEx_OCN_Stop_DMA()	停止定时器OCN功能DMA传输。
17	HAL_TIMEx_PWMN_Start()	启动定时器PWMN功能。
18	HAL_TIMEx_PWMN_Stop()	停止定时器PWMN功能。
19	HAL_TIMEx_PWMN_Start_IT()	启动定时器PWMN功能中断。
20	HAL_TIMEx_PWMN_Stop_IT()	停止定时器PWMN功能中断。
21	HAL_TIMEx_PWMN_Start_DMA()	启动定时器PWMN功能DMA传输。
22	HAL_TIMEx_PWMN_Stop_DMA()	停止定时器PWMN功能DMA传输。
23	HAL_TIMEx_OnePulseN_Start()	启动定时器单脉冲N功能。
24	HAL_TIMEx_OnePulseN_Stop()	停止定时器单脉冲N功能。
25	HAL_TIMEx_OnePulseN_Start_IT()	启动定时器单脉冲N功能中断。
26	HAL_TIMEx_OnePulseN_Stop_IT()	停止定时器单脉冲N功能中断。
27	HAL_TIMEx_ConfigCommutationEvent()	配置定时器换相事件。
28	HAL_TIMEx_ConfigCommutationEvent_IT()	配置定时器换相事件并启用中断。
29	HAL_TIMEx_ConfigCommutationEvent_DMA()	配置定时器换相事件DMA传输。
30	HAL_TIMEx_ConfigBreakDeadTime()	配置定时器死区和断路器。
31	HAL_TIMEx_MasterConfigSynchronization()	配置定时器主模式同步。
32	HAL_TIMEx_CommutationCallback()	定时器换相回调函数。
33	HAL_TIMEx_BreakCallback()	定时器断路器回调函数。
34	TIMEx_DMACommutationCplt()	定时器换相DMA传输完成回调函数。
35	HAL_TIMEx_HallSensor_GetState()	获取定时器霍尔传感器模式状态。

1.24 HAL_TIMEx_OnePulseN_Stop

函数名	HAL_TIMEx_OnePulseN_Stop
函数原形	HAL_StatusTypeDef HAL_TIMEx_OnePulseN_Stop(TIM_HandleTypeDef *htim, uint32_t Channel)
功能描述	停止TIM通道的单脉冲模式
输入参数	htim：TIM句柄结构体指针
	Channel：通道编号
输出参数	无
返回值	HAL_StatusTypeDef：停止状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	HAL_TIMEx_OnePulseN_Stop(&htim, TIM_CHANNEL_1);
```

---

1.25 HAL_TIMEx_OnePulseN_Start_IT

函数名	HAL_TIMEx_OnePulseN_Start_IT
函数原形	HAL_StatusTypeDef HAL_TIMEx_OnePulseN_Start_IT(TIM_HandleTypeDef *htim, uint32_t Channel)
功能描述	以中断方式启动TIM通道的单脉冲模式
输入参数	htim：TIM句柄结构体指针
	Channel：通道编号
输出参数	无
返回值	HAL_StatusTypeDef：启动状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	HAL_TIMEx_OnePulseN_Start_IT(&htim, TIM_CHANNEL_1);
```

---

1.26 HAL_TIMEx_OnePulseN_Stop_IT

函数名	HAL_TIMEx_OnePulseN_Stop_IT
函数原形	HAL_StatusTypeDef HAL_TIMEx_OnePulseN_Stop_IT(TIM_HandleTypeDef *htim, uint32_t Channel)
功能描述	以中断方式停止TIM通道的单脉冲模式
输入参数	htim：TIM句柄结构体指针
	Channel：通道编号
输出参数	无
返回值	HAL_StatusTypeDef：停止状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	HAL_TIMEx_OnePulseN_Stop_IT(&htim, TIM_CHANNEL_1);
```

|

---

1.27 HAL_TIMEx_ConfigCommutationEvent

函数名	HAL_TIMEx_ConfigCommutationEvent
函数原形	HAL_StatusTypeDef HAL_TIMEx_ConfigCommutationEvent(TIM_HandleTypeDef *htim, uint32_t CommutationSource, uint32_t CommutationPolarity)
功能描述	配置TIM的换向事件
输入参数	htim：TIM句柄结构体指针
	CommutationSource：换向源
	CommutationPolarity：换向极性
输出参数	无
返回值	HAL_StatusTypeDef：配置状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	HAL_TIMEx_ConfigCommutationEvent(&htim, TIM_TS_ETRF);
```

---

1.28 HAL_TIMEx_ConfigCommutationEvent_IT

函数名	HAL_TIMEx_ConfigCommutationEvent_IT
函数原形	HAL_StatusTypeDef HAL_TIMEx_ConfigCommutationEvent_IT(TIM_HandleTypeDef *htim, uint32_t CommutationSource, uint32_t CommutationPolarity)
功能描述	配置TIM的换向事件，并以中断方式触发
输入参数	htim：TIM句柄结构体指针
	CommutationSource：换向源
	CommutationPolarity：换向极性
输出参数	无
返回值	HAL_StatusTypeDef：配置状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	HAL_TIMEx_ConfigCommutationEvent_IT(&htim, TIM_TS_ETRF);
```

---

1.29 HAL_TIMEx_ConfigCommutationEvent_DMA

函数名	HAL_TIMEx_ConfigCommutationEvent_DMA
函数原形	HAL_StatusTypeDef HAL_TIMEx_ConfigCommutationEvent_DMA(TIM_HandleTypeDef *htim, uint32_t CommutationSource, uint32_t CommutationPolarity)
功能描述	配置TIM的换向事件，并以DMA方式触发
输入参数	htim：TIM句柄结构体指针
	CommutationSource：换向源
	CommutationPolarity：换向极性
输出参数	无
返回值	HAL_StatusTypeDef：配置状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	HAL_TIMEx_ConfigCommutationEvent_DMA(&htim, TIM_TS_ETRF);
```

---

1.30 HAL_TIMEx_ConfigBreakDeadTime

函数名	HAL_TIMEx_ConfigBreakDeadTime
函数原形	HAL_StatusTypeDef HAL_TIMEx_ConfigBreakDeadTime(TIM_HandleTypeDef *htim, TIM_BreakDeadTimeConfigTypeDef *sBreakDeadTimeConfig)
功能描述	配置TIM的死区时间和断路器
输入参数	htim：TIM句柄结构体指针
	sBreakDeadTimeConfig：死区时间和断路器配置结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：配置状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	TIM_BreakDeadTimeConfigTypeDef sBreakDeadTimeConfig;
	HAL_TIMEx_ConfigBreakDeadTime(&htim, &sBreakDeadTimeConfig);
```

---

1.31 HAL_TIMEx_MasterConfigSynchronization

函数名	HAL_TIMEx_MasterConfigSynchronization
函数原形	HAL_StatusTypeDef HAL_TIMEx_MasterConfigSynchronization(TIM_HandleTypeDef *htim,TIM_MasterConfigTypeDef *sMasterConfig)

| 功能描述 | 配置TIM主从同步 |
| 输入参数 | htim：TIM句柄结构体指针 |
| | sMasterConfig：主从同步配置结构体指针 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：配置状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
| 案例 | c | | | TIM_HandleTypeDef htim; | | | TIM_MasterConfigTypeDef sMasterConfig; | | | HAL_TIMEx_MasterConfigSynchronization(&htim, &sMasterConfig); | | |

---

1.32 HAL_TIMEx_CommutationCallback

函数名	HAL_TIMEx_CommutationCallback
函数原形	void HAL_TIMEx_CommutationCallback(TIM_HandleTypeDef *htim)
功能描述	TIM换向事件的回调函数
输入参数	htim：TIM句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	无

---

1.33 HAL_TIMEx_BreakCallback

函数名	HAL_TIMEx_BreakCallback
函数原形	void HAL_TIMEx_BreakCallback(TIM_HandleTypeDef *htim)
功能描述	TIM断路器事件的回调函数
输入参数	htim：TIM句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	无

---

1.34 TIMEx_DMACommutationCplt

函数名	TIMEx_DMACommutationCplt
函数原形	void TIMEx_DMACommutationCplt(TIM_HandleTypeDef *htim)
功能描述	TIM换向事件的DMA传输完成回调函数
输入参数	htim：TIM句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	无

---

1.35 HAL_TIMEx_HallSensor_GetState

函数名	HAL_TIMEx_HallSensor_GetState
函数原形	uint32_t HAL_TIMEx_HallSensor_GetState(TIM_HandleTypeDef *htim)
功能描述	获取TIM外部霍尔传感器模式的状态
输入参数	htim：TIM句柄结构体指针
输出参数	无
返回值	uint32_t：外部霍尔传感器模式的状态
先决条件	无
被调用函数	无
案例	```c
	TIM_HandleTypeDef htim;
	uint32_t state = HAL_TIMEx_HallSensor_GetState(&htim);
```

---

该文档修改记录：

修改时间	修改说明
2024年4月30日	第一次发布，介绍了该博客驱动所有函数的介绍及使用

总结

以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。
创作不容，如果文档对您有帮助，记得给个赞。