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

常驻客栈2024-07-10 11:07

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

  • [1 该驱动函数预览](#1 该驱动函数预览)
      • [1.1 HAL_USART_Init](#1.1 HAL_USART_Init)
      • [1.2 HAL_USART_DeInit](#1.2 HAL_USART_DeInit)
      • [1.3 HAL_USART_MspInit](#1.3 HAL_USART_MspInit)
      • [1.4 HAL_USART_MspDeInit](#1.4 HAL_USART_MspDeInit)
      • [1.5 HAL_USART_Transmit](#1.5 HAL_USART_Transmit)
      • [1.6 HAL_USART_Receive](#1.6 HAL_USART_Receive)
      • [1.7 HAL_USART_TransmitReceive](#1.7 HAL_USART_TransmitReceive)
      • [1.8 HAL_USART_Transmit_IT](#1.8 HAL_USART_Transmit_IT)
      • [1.9 HAL_USART_Receive_IT](#1.9 HAL_USART_Receive_IT)
      • [1.10 HAL_USART_TransmitReceive_IT](#1.10 HAL_USART_TransmitReceive_IT)
      • [1.11 HAL_USART_Transmit_DMA](#1.11 HAL_USART_Transmit_DMA)
      • [1.12 HAL_USART_Receive_DMA](#1.12 HAL_USART_Receive_DMA)
      • [1.13 HAL_USART_TransmitReceive_DMA](#1.13 HAL_USART_TransmitReceive_DMA)
      • [1.14 HAL_USART_DMAPause](#1.14 HAL_USART_DMAPause)
  • 该文档修改记录：
  • 总结

1 该驱动函数预览

序号 函数名 描述
1 HAL_USART_Init() 初始化USART。
2 HAL_USART_DeInit() 反初始化USART。
3 HAL_USART_MspInit() 初始化USART的底层硬件资源。
4 HAL_USART_MspDeInit() 反初始化USART的底层硬件资源。
5 HAL_USART_Transmit() 发送USART数据。
6 HAL_USART_Receive() 接收USART数据。
7 HAL_USART_TransmitReceive() 发送并接收USART数据。
8 HAL_USART_Transmit_IT() 使用中断发送USART数据。
9 HAL_USART_Receive_IT() 使用中断接收USART数据。
10 HAL_USART_TransmitReceive_IT() 使用中断发送并接收USART数据。
11 HAL_USART_Transmit_DMA() 使用DMA发送USART数据。
12 HAL_USART_Receive_DMA() 使用DMA接收USART数据。
13 HAL_USART_TransmitReceive_DMA() 使用DMA发送并接收USART数据。
14 HAL_USART_DMAPause() 暂停USART的DMA传输。
15 HAL_USART_DMAResume() 恢复USART的DMA传输。
16 HAL_USART_DMAStop() 停止USART的DMA传输。
17 HAL_USART_Abort() 中止USART的传输。
18 HAL_USART_Abort_IT() 使用中断中止USART的传输。
19 HAL_USART_IRQHandler() USART中断处理函数。
20 HAL_USART_TxCpltCallback() USART发送完成回调函数。
21 HAL_USART_TxHalfCpltCallback() USART半发送完成回调函数。
22 HAL_USART_RxCpltCallback() USART接收完成回调函数。
23 HAL_USART_RxHalfCpltCallback() USART半接收完成回调函数。
24 HAL_USART_TxRxCpltCallback() USART发送接收完成回调函数。
25 HAL_USART_ErrorCallback() USART错误回调函数。
26 HAL_USART_AbortCpltCallback() USART中止完成回调函数。
27 HAL_USART_GetState() 获取USART状态。
28 HAL_USART_GetError() 获取USART错误状态。

1.1 HAL_USART_Init

函数名 HAL_USART_Init
函数原形 HAL_StatusTypeDef HAL_USART_Init(USART_HandleTypeDef *husart)
功能描述 初始化USART外设
输入参数 husart：USART句柄结构体指针
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
HAL_StatusTypeDef status = HAL_USART_Init(&husart);
```

1.2 HAL_USART_DeInit

函数名 HAL_USART_DeInit
函数原形 HAL_StatusTypeDef HAL_USART_DeInit(USART_HandleTypeDef *husart)
功能描述 复位USART外设
输入参数 husart：USART句柄结构体指针
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
HAL_StatusTypeDef status = HAL_USART_DeInit(&husart);
```

1.3 HAL_USART_MspInit

函数名 HAL_USART_MspInit
函数原形 void HAL_USART_MspInit(USART_HandleTypeDef *husart)
功能描述 初始化USART外设的GPIO和时钟
输入参数 husart：USART句柄结构体指针
输出参数 无
返回值 无
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
HAL_USART_MspInit(&husart);
```

1.4 HAL_USART_MspDeInit

函数名 HAL_USART_MspDeInit
函数原形 void HAL_USART_MspDeInit(USART_HandleTypeDef *husart)
功能描述 复位USART外设的GPIO和时钟
输入参数 husart：USART句柄结构体指针
输出参数 无
返回值 无
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
HAL_USART_MspDeInit(&husart);
```

1.5 HAL_USART_Transmit

函数名 HAL_USART_Transmit
函数原形 HAL_StatusTypeDef HAL_USART_Transmit(USART_HandleTypeDef *husart, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述 发送数据到USART外设
输入参数 husart：USART句柄结构体指针
pData：要发送的数据缓冲区指针
Size：要发送的数据大小
Timeout：发送超时时间（毫秒）
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t data[] = {0x01, 0x02, 0x03};
HAL_StatusTypeDef status = HAL_USART_Transmit(&husart, data, sizeof(data), 1000);
```

1.6 HAL_USART_Receive

函数名 HAL_USART_Receive
函数原形 HAL_StatusTypeDef HAL_USART_Receive(USART_HandleTypeDef *husart, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述 从USART外设接收数据
输入参数 husart：USART句柄结构体指

针 |

| | pData：接收数据的缓冲区指针 |

| | Size：要接收的数据大小 |

| | Timeout：接收超时时间（毫秒） |

| 输出参数 | 无 |

| 返回值 | HAL_StatusTypeDef：函数执行状态 |

| 先决条件 | 无 |

| 被调用函数 | 无 |

| 案例 | c | | | USART_HandleTypeDef husart; | | | uint8_t data[10]; | | | HAL_StatusTypeDef status = HAL_USART_Receive(&husart, data, sizeof(data), 1000); | | |

1.7 HAL_USART_TransmitReceive

函数名 HAL_USART_TransmitReceive
函数原形 HAL_StatusTypeDef HAL_USART_TransmitReceive(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout)
功能描述 发送和接收数据到USART外设
输入参数 husart：USART句柄结构体指针
pTxData：要发送的数据缓冲区指针
pRxData：接收数据的缓冲区指针
Size：要发送和接收的数据大小
Timeout：发送和接收超时时间（毫秒）
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t tx_data[] = {0x01, 0x02, 0x03};
uint8_t rx_data[3];
HAL_StatusTypeDef status = HAL_USART_TransmitReceive(&husart, tx_data, rx_data, sizeof(tx_data), 1000);
```

1.8 HAL_USART_Transmit_IT

函数名 HAL_USART_Transmit_IT
函数原形 HAL_StatusTypeDef HAL_USART_Transmit_IT(USART_HandleTypeDef *husart, uint8_t *pData, uint16_t Size)
功能描述 使用中断方式发送数据到USART外设
输入参数 husart：USART句柄结构体指针
pData：要发送的数据缓冲区指针
Size：要发送的数据大小
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t data[] = {0x01, 0x02, 0x03};
HAL_StatusTypeDef status = HAL_USART_Transmit_IT(&husart, data, sizeof(data));
```

1.9 HAL_USART_Receive_IT

函数名 HAL_USART_Receive_IT
函数原形 HAL_StatusTypeDef HAL_USART_Receive_IT(USART_HandleTypeDef *husart, uint8_t *pData, uint16_t Size)
功能描述 使用中断方式从USART外设接收数据
输入参数 husart：USART句柄结构体指针
pData：接收数据的缓冲区指针
Size：要接收的数据大小
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t data[10];
HAL_StatusTypeDef status = HAL_USART_Receive_IT(&husart, data, sizeof(data));
```

1.10 HAL_USART_TransmitReceive_IT

函数名 HAL_USART_TransmitReceive_IT
函数原形 HAL_StatusTypeDef HAL_USART_TransmitReceive_IT(USART_HandleTypeDef *husart, uint8_t *pTx

Data, uint8_t *pRxData, uint16_t Size) |

| 功能描述 | 使用中断方式发送和接收数据到USART外设 |

| 输入参数 | husart：USART句柄结构体指针 |

| | pTxData：要发送的数据缓冲区指针 |

| | pRxData：接收数据的缓冲区指针 |

| | Size：要发送和接收的数据大小 |

| 输出参数 | 无 |

| 返回值 | HAL_StatusTypeDef：函数执行状态 |

| 先决条件 | 无 |

| 被调用函数 | 无 |

| 案例 | c | | | USART_HandleTypeDef husart; | | | uint8_t tx_data[] = {0x01, 0x02, 0x03}; | | | uint8_t rx_data[3]; | | | HAL_StatusTypeDef status = HAL_USART_TransmitReceive_IT(&husart, tx_data, rx_data, sizeof(tx_data)); | | |

1.11 HAL_USART_Transmit_DMA

函数名 HAL_USART_Transmit_DMA
函数原形 HAL_StatusTypeDef HAL_USART_Transmit_DMA(USART_HandleTypeDef *husart, uint8_t *pData, uint16_t Size)
功能描述 使用DMA方式发送数据到USART外设
输入参数 husart：USART句柄结构体指针
pData：要发送的数据缓冲区指针
Size：要发送的数据大小
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t data[] = {0x01, 0x02, 0x03};
HAL_StatusTypeDef status = HAL_USART_Transmit_DMA(&husart, data, sizeof(data));
```

1.12 HAL_USART_Receive_DMA

函数名 HAL_USART_Receive_DMA
函数原形 HAL_StatusTypeDef HAL_USART_Receive_DMA(USART_HandleTypeDef *husart, uint8_t *pData, uint16_t Size)
功能描述 使用DMA方式从USART外设接收数据
输入参数 husart：USART句柄结构体指针
pData：接收数据的缓冲区指针
Size：要接收的数据大小
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t data[10];
HAL_StatusTypeDef status = HAL_USART_Receive_DMA(&husart, data, sizeof(data));
```

1.13 HAL_USART_TransmitReceive_DMA

函数名 HAL_USART_TransmitReceive_DMA
函数原形 HAL_StatusTypeDef HAL_USART_TransmitReceive_DMA(USART_HandleTypeDef *husart, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
功能描述 使用DMA方式发送和接收数据到USART外设
输入参数 husart：USART句柄结构体指针
pTxData：要发送的数据缓冲区指针
pRxData：接收数据的缓冲区指针
Size：要发送和接收的数据大小
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
uint8_t tx_data[] = {0x01, 0x02, 0x03};
uint8_t rx_data[3];
HAL_StatusTypeDef status

= HAL_USART_TransmitReceive_DMA(&husart, tx_data, rx_data, sizeof(tx_data)); |

| ``` |

1.14 HAL_USART_DMAPause

函数名 HAL_USART_DMAPause
函数原形 HAL_StatusTypeDef HAL_USART_DMAPause(USART_HandleTypeDef *husart)
功能描述 暂停USART外设的DMA传输
输入参数 husart：USART句柄结构体指针
输出参数 无
返回值 HAL_StatusTypeDef：函数执行状态
先决条件 无
被调用函数 无
案例 ```c
USART_HandleTypeDef husart;
HAL_StatusTypeDef status = HAL_USART_DMAPause(&husart);
```

该文档修改记录：

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

总结

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

相关推荐
模拟IC攻城狮40 分钟前
华为海思招聘-芯片与器件设计工程师-模拟芯片方向- 机试题-真题套题题目——共8套（每套四十题）
嵌入式硬件·华为·硬件架构·芯片
IT B业生1 小时前
51单片机教程（六）- LED流水灯
单片机·嵌入式硬件·51单片机
一枝小雨1 小时前
51单片机学习心得2(基于STC89C52)：串口通信（UART）
单片机·嵌入式硬件·51单片机
IT B业生2 小时前
51单片机教程（一）- 开发环境搭建
单片机·嵌入式硬件·51单片机
u0101526583 小时前
STM32F103C8T6学习笔记2--LED流水灯与蜂鸣器
笔记·stm32·学习
海绵波波1074 小时前
Webserver(4.8)UDP、广播、组播
单片机·网络协议·udp
好想有猫猫4 小时前
【51单片机】串口通信原理 + 使用
c语言·单片机·嵌入式硬件·51单片机·1024程序员节
云卓科技5 小时前
无人车之路径规划篇
人工智能·嵌入式硬件·算法·自动驾驶
stm 学习ing6 小时前
C语言 循环高级
c语言·开发语言·单片机·嵌入式硬件·算法·嵌入式实时数据库
w微信150135078126 小时前
小华一级 代理商 HC32F005C6PA-TSSOP20 HC32F005系列
c语言·arm开发·单片机·嵌入式硬件
热门推荐
01【HarmonyOS】HUAWEI DevEco Studio 下载地址汇总02(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明03组基轨迹建模 GBTM的介绍与实现（Stata 或 R）04【AIGC】重塑未来的科技巨轮05红米手机使用google play06【经验分享】Ubuntu22.04安装微信(linux官方版)07全面解析：构建基于深度学习的安全帽检测系统（UI界面+YOLO代码+数据集）08【Java】Ruoyi-Vue-Plus 整合 文件分片上传至 minio、阿里云、七牛云等OSS-【后端篇】09RAG 实践- Ollama+RagFlow 部署本地知识库10基于YOLOv10深度学习的CT扫描图像肾结石智能检测系统【python源码+Pyqt5界面+数据集+训练代码】深度学习实战、目标检测