A45 STM32_HAL库函数 之 SMARTCARD通用驱动 -- A -- 所有函数的介绍及使用

1 该驱动函数预览

序号	函数名	描述
1	HAL_SMARTCARD_Init()	初始化智能卡接口。
2	HAL_SMARTCARD_DeInit()	反初始化智能卡接口。
3	HAL_SMARTCARD_MspInit()	初始化智能卡接口相关的MCU外设引脚或资源。
4	HAL_SMARTCARD_MspDeInit()	反初始化智能卡接口相关的MCU外设引脚或资源。
5	HAL_SMARTCARD_ReInit()	重新初始化智能卡接口。
6	HAL_SMARTCARD_Transmit()	智能卡接口发送数据。
7	HAL_SMARTCARD_Receive()	智能卡接口接收数据。
8	HAL_SMARTCARD_Transmit_IT()	使用中断方式发送数据。
9	HAL_SMARTCARD_Receive_IT()	使用中断方式接收数据。
10	HAL_SMARTCARD_Transmit_DMA()	使用DMA方式发送数据。
11	HAL_SMARTCARD_Receive_DMA()	使用DMA方式接收数据。
12	HAL_SMARTCARD_Abort()	终止智能卡接口操作。
13	HAL_SMARTCARD_AbortTransmit()	终止发送操作。
14	HAL_SMARTCARD_AbortReceive()	终止接收操作。
15	HAL_SMARTCARD_Abort_IT()	终止智能卡接口操作并启用中断。
16	HAL_SMARTCARD_AbortTransmit_IT()	终止发送操作并启用中断。
17	HAL_SMARTCARD_AbortReceive_IT()	终止接收操作并启用中断。
18	HAL_SMARTCARD_IRQHandler()	智能卡接口中断处理程序。
19	HAL_SMARTCARD_TxCpltCallback()	发送完成回调函数。
20	HAL_SMARTCARD_RxCpltCallback()	接收完成回调函数。
21	HAL_SMARTCARD_ErrorCallback()	错误回调函数。
22	HAL_SMARTCARD_AbortCpltCallback()	终止完成回调函数。
23	HAL_SMARTCARD_AbortTransmitCpltCallback()	终止发送完成回调函数。
24	HAL_SMARTCARD_AbortReceiveCpltCallback()	终止接收完成回调函数。
25	HAL_SMARTCARD_GetState()	获取智能卡接口状态。
26	HAL_SMARTCARD_GetError()	获取智能卡接口错误状态。

以下是使用模板：

#include "stm32f4xx_hal.h"int main(void) {// HAL初始化HAL_Init();// 初始化智能卡接口HAL_SMARTCARD_Init();// 初始化智能卡接口相关的MCU外设引脚或资源HAL_SMARTCARD_MspInit();// 进行其他操作...// 智能卡接口发送数据HAL_SMARTCARD_Transmit();// 智能卡接口接收数据HAL_SMARTCARD_Receive();// 使用中断方式发送数据HAL_SMARTCARD_Transmit_IT();// 使用DMA方式发送数据HAL_SMARTCARD_Transmit_DMA();// 终止智能卡接口操作HAL_SMARTCARD_Abort();// 获取智能卡接口状态HAL_SMARTCARD_GetState();return 0;
}

1.1 HAL_SMARTCARD_Init

函数名	HAL_SMARTCARD_Init
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Init(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	初始化SMARTCARD外设
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.2 HAL_SMARTCARD_DeInit

函数名	HAL_SMARTCARD_DeInit
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_DeInit(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	复位SMARTCARD外设
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.3 HAL_SMARTCARD_MspInit

函数名	HAL_SMARTCARD_MspInit
函数原形	void HAL_SMARTCARD_MspInit(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	初始化SMARTCARD外设时钟、引脚等底层资源
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.4 HAL_SMARTCARD_MspDeInit

函数名	HAL_SMARTCARD_MspDeInit
函数原形	void HAL_SMARTCARD_MspDeInit(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	复位SMARTCARD外设时钟、引脚等底层资源
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.5 HAL_SMARTCARD_ReInit

函数名	HAL_SMARTCARD_ReInit
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_ReInit(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	重新初始化SMARTCARD外设
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.6 HAL_SMARTCARD_Transmit

函数名	HAL_SMARTCARD_Transmit
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Transmit(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述	通过SMARTCARD外设发送数据
输入参数 1	hsmartcard：SMARTCARD句柄结构体指针
输入参数 2	pData：待发送数据缓冲区指针
输入参数 3	Size：待发送数据大小
输入参数 4	Timeout：发送超时时间（毫秒）
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.7 HAL_SMARTCARD_Receive

函数名	HAL_SMARTCARD_Receive
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Receive(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述	通过SMARTCARD外设接收数据
输入参数 1	hsmartcard：SMARTCARD句柄结构体指针
输入参数 2	pData：接收数据缓冲区指针
输入参数 3	Size：期望接收数据大小
输入参数 4	Timeout：接收超时时间（毫秒）
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.8 HAL_SMARTCARD_Transmit_IT

函数名	HAL_SMARTCARD_Transmit_IT
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Transmit_IT(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size)
功能描述	通过SMARTCARD外设发送数据（中断模式）
输入参数 1	hsmartcard：SMARTCARD句柄结构体指针
输入参数 2	pData：待发送数据缓冲区指针

| 输入参数 3 | Size：待发送数据大小 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：函数执行状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |

---

1.9 HAL_SMARTCARD_Receive_IT

函数名	HAL_SMARTCARD_Receive_IT
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Receive_IT(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size)
功能描述	通过SMARTCARD外设接收数据（中断模式）
输入参数 1	hsmartcard：SMARTCARD句柄结构体指针
输入参数 2	pData：接收数据缓冲区指针
输入参数 3	Size：期望接收数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.10 HAL_SMARTCARD_Transmit_DMA

函数名	HAL_SMARTCARD_Transmit_DMA
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Transmit_DMA(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size)
功能描述	通过SMARTCARD外设发送数据（DMA模式）
输入参数 1	hsmartcard：SMARTCARD句柄结构体指针
输入参数 2	pData：待发送数据缓冲区指针
输入参数 3	Size：待发送数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.11 HAL_SMARTCARD_Receive_DMA

函数名	HAL_SMARTCARD_Receive_DMA
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Receive_DMA(SMARTCARD_HandleTypeDef *hsmartcard, uint8_t *pData, uint16_t Size)
功能描述	通过SMARTCARD外设接收数据（DMA模式）
输入参数 1	hsmartcard：SMARTCARD句柄结构体指针
输入参数 2	pData：接收数据缓冲区指针
输入参数 3	Size：期望接收数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.12 HAL_SMARTCARD_Abort

函数名	HAL_SMARTCARD_Abort
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_Abort(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	终止SMARTCARD外设操作
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.13 HAL_SMARTCARD_AbortTransmit

函数名	HAL_SMARTCARD_AbortTransmit
函数原形	HAL_StatusTypeDef HAL_SMARTCARD_AbortTransmit(SMARTCARD_HandleTypeDef *hsmartcard)
功能描述	终止SMARTCARD外设发送数据的操作
输入参数	hsmartcard：SMARTCARD句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

该文档修改记录：

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

总结

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