HAL库基础教程——串口

原创 已于 2025-10-11 21:28:41 修改 · 648 阅读 · 21 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#嵌入式硬件 #单片机

于 2025-10-11 21:27:42 首次发布

HAL库基础教程——串口

一.初步了解串口

1.串口传输信息原理

在这里插入图片描述

  在上图中我们发现了3个引脚：TX、RX、GND。TX是发送引脚，RX是接收引脚，GND是地线。在上图我们发现设备1的发送引脚和设备2的接收引脚相连接，设备1的接收引脚和设备2的发送引脚相连接。举例，若设备1向设备2发送一个0x80的数据，那么设备1则会通过tx引脚向设备2每隔一个时间发送一位数据，若1则高电平，0则低电平。设备2只需每隔相同时间读取rx引脚的高低电平，便能读取到对应的数据。
  在上面的的说明中，我们很明显能发现2个问题：

  1. 如何保证设备1和设备2对高低电平的定义一样。我们知道数字电路中对高低电平的定义是相对的，可能设备1对3v的定义为低电平，设备2对3v的定义为高电平。
  2. 如何保证设备1发送时间的间隔和设备2接收时间的间隔一样。
      对于第一个问题，我们给两个设备的GND相连，这样对低电平的定义就相同了。

      对于第二个问题，我们就要引出比特率的概念，比特率就是1s能发送的比特数。所以说我们两个设备的串口要能正常通信需要设置相同的比特率。

2.轮询模式输出和接收数据

首先我们先来看一个简单的输入什么输出什么的轮询数据代码

 uint8_t message[2] = {0};
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
		
    /* USER CODE BEGIN 3 */
	HAL_UART_Receive(&huart2,message,2,HAL_MAX_DELAY);
    HAL_UART_Transmit(&huart2,message,strlen((char*)message),100);
		
  }

在上面我们设计到了2个函数，下面是该两个函数的定义

/**
  * @brief  Receives an amount of data in blocking mode.
  * @note   When UART parity is not enabled (PCE = 0), and Word Length is configured to 9 bits (M1-M0 = 01),
  *         the received data is handled as a set of u16. In this case, Size must indicate the number
  *         of u16 available through pData.
  * @param  huart Pointer to a UART_HandleTypeDef structure that contains
  *               the configuration information for the specified UART module.
  * @param  pData Pointer to data buffer (u8 or u16 data elements).
  * @param  Size  Amount of data elements (u8 or u16) to be received.
  * @param  Timeout Timeout duration
  * @retval HAL status
  */
HAL_StatusTypeDef HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout);

/**
  * @brief  Sends an amount of data in blocking mode.
  * @note   When UART parity is not enabled (PCE = 0), and Word Length is configured to 9 bits (M1-M0 = 01),
  *         the sent data is handled as a set of u16. In this case, Size must indicate the number
  *         of u16 provided through pData.
  * @param  huart Pointer to a UART_HandleTypeDef structure that contains
  *               the configuration information for the specified UART module.
  * @param  pData Pointer to data buffer (u8 or u16 data elements).
  * @param  Size  Amount of data elements (u8 or u16) to be sent
  * @param  Timeout Timeout duration
  * @retval HAL status
  */
HAL_StatusTypeDef HAL_UART_Transmit(UART_HandleTypeDef *huart, const uint8_t *pData, uint16_t Size, uint32_t Timeout);

  上面2个函数的返回量我们目前不需要关注，我们关注一下他们的参数：

UART_HandleTypeDef *huart //串口句柄,我们可以理解成用哪个串口，这个变量就是该串口的地址
const uint8_t *pData //发送或接收的数据数组指针
uint16_t Size //发送或接收的数据多少
uint32_t Timeout //超时时间

二.进阶版中断处理串口

  在前面的轮询的方法来处理串口存在一个很严重的问题：cpu需要一直检测RX是否有数据，无法进行其他操作。这个在我们复杂的项目工程中是基本不被允许的。所以我们一般使用中断来处理串口数据的方式来解决上述问题。

1.中断处理串口数据的原理

1.1cpu轮询处理串口数据的原理

  首先我们先回到轮询处理串口数据的原理。
在这里插入图片描述

  如上图，串口发送的流程，具体cpu会一直检查发送数据寄存器中是否有数据，知道设备2读取数据后，发送数据寄存器才会被清空，cpu才会继续发送数据。
在这里插入图片描述

  接收则是想反，CPU会一直检测接收数据寄存器中是否有数据，如果有数据才会读取。

那么在轮询模式下cpu会被串口一直占用，无法进行其他操作，在工程当中这就给cpu增加了许多负担。于是我们引出了中断来处理串口数据。

1.2中断处理串口数据的原理

  在这里我们可以把中断看成一个闹钟。一般情况下设备2还未接收完数据时，即发送数据寄存器还有数据时，cpu可以专心的运行其他代码。
在这里插入图片描述

  然后如果一旦设备2接收完数据时，闹钟就响了(中断响应了)，那么这时候CPU暂停其他工作来讲输出填入到发送数据寄存器，然后就可以回到其他代码的运行当中了。
在这里插入图片描述

该方式完美的解决了CPU空运行的低效垃圾时间，大大提高了CPU的利用率。

2.中断处理串口数据代码

  首先我们先来配置HAL库
在这里插入图片描述

勾选配置NVIC即可
  在串口的中断处理函数当中(在stm32xx_it.c中)，会出现一个问题。
在这里插入图片描述

即可能产生中断请求的事件很多，但是中断处理函数只有一个，那么我们如何分辨时哪个请求呢。
在这里插入图片描述

HAL_UART_IRQHandler(&huart2);

在HAL库当中我们通过该函数来分辨到底时哪个中断请求，该函数的具体内部代码我们无需关注。我们只需知道该函数会根据中断请求来调用不同的函数即可。
为了方便我们写相关函数，HAL库对相关函数都是弱定义的，即我们可以自己写相关函数来覆盖默认的函数。

如果大家想查询可以在stm32(型号)_hal_uart.c中查询到相关函数，函数前加了_weak弱定义的修饰词。

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
	HAL_UART_Transmit_IT(&huart2,message,2);
}
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
	memset(message,0,strlen((char*)message));
  HAL_UART_Receive_IT(&huart2,message,2);
}

  上面代码就是简单的中断处理串口数据的代码，2个函数分别是接收完成和发送完成的回调函数，当接收到数据或者发送数据完成时，会自动调用该函数。

注意该回调函数是所有串口公用的，所以如果使用多串口要注意分辨是哪个串口调用的回调函数。

三.最终版DMA处理串口

  尽管中断处理串口的方式已经大大的解放了CPU，但是CPU还是需要在一些特定时候来放置或者提取部分数据。那有没有什么方法可以使得CPU完全不用参与串口数据的处理呢？答案就是DMA。

1.DMA处理串口数据的原理

  DMA全称Direct Memory Access，即直接内存访问。DMA可以使得外设直接访问内存，无需CPU的参与可以将数据从一个地方转移到另外一个地方。在使用DMA处理串口数据时，DMA代替了CPU的功能，负责在特定时间读取或写入数据。其余与中断处理串口数据的原理相同。

2.DMA处理串口数据代码

  首先我们先来配置HAL库
在这里插入图片描述

点击add后选择需要DMA的引脚即可。
  在这里我只开通了串口2接收引脚的DMA，下面是简单的接收发送DMA的代码。

uint8_t message[10] = {0};
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
	HAL_UART_Transmit_IT(&huart2,message,2);
}
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
	memset(message,0,strlen((char*)message));
  HAL_UART_Receive_DMA(&huart2,message,2);
}
/* USER CODE END 0 */

/**
  * @brief  The application entry point.
  * @retval int
  */
int main(void)
{

  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_DMA_Init();
  MX_USART2_UART_Init();
  /* USER CODE BEGIN 2 */
  HAL_UART_Receive_DMA(&huart2,message,2);
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

具体就是把_IT改成_DMA即可。因为DMA相当于取代了CPU的功能，具体是DMA转移了对应的数据(函数的最后一个数据)后，会申请中断告诉CPU我干完活了。然后CPU再运行中断函数。

DMA函数的参数意义和中断相同，在这里我不多赘述

3.利用DMA 串口发送或接收不定长数据

  虽然上面我们使用串口接收和发送数据，但是还是有一个问题:我们总是得要到接收到一定数据才能进入中断，即判定接收完成。但是再一些负责项目中，我们需要利用串口传输的信息的长度是不确定的，那么我们如何解决该问题呢？
  很简单，我们如果能能够知道什么时候串口不发生数据然后进入中断那么是不是就可以了。再HAL库中给我们配置了一个中断:串口空闲中断(Idle),该中断会在串口的RX引脚没有写入新数据到一定时间后进入中断，即我们认为接收完成时进入中断。
  下面时利用DMA接收不定长数据的代码。

uint8_t message[500] = {0};
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
	if(huart == &huart2)
	{
	  HAL_UART_Transmit_IT(&huart2,message,Size);
		__HAL_DMA_DISABLE_IT(&hdma_usart2_rx,DMA_IT_HT);
	}
}
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)
{
	if(huart == &huart2)
	{
	memset(message,0,strlen((char*)message));
  HAL_UARTEx_ReceiveToIdle_DMA(&huart2,message,sizeof(message));
	}
}
/* USER CODE END 0 */

/**
  * @brief  The application entry point.
  * @retval int
  */
int main(void)
{

  /* USER CODE BEGIN 1 */

  /* USER CODE END 1 */

  /* MCU Configuration--------------------------------------------------------*/

  /* Reset of all peripherals, Initializes the Flash interface and the Systick. */
  HAL_Init();

  /* USER CODE BEGIN Init */

  /* USER CODE END Init */

  /* Configure the system clock */
  SystemClock_Config();

  /* USER CODE BEGIN SysInit */

  /* USER CODE END SysInit */

  /* Initialize all configured peripherals */
  MX_GPIO_Init();
  MX_DMA_Init();
  MX_USART2_UART_Init();
  /* USER CODE BEGIN 2 */
  HAL_UARTEx_ReceiveToIdle_DMA(&huart2,message,sizeof(message));
	__HAL_DMA_DISABLE_IT(&hdma_usart2_rx,DMA_IT_HT);//关闭DMA传输过半中断
  /* USER CODE END 2 */

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */

    /* USER CODE BEGIN 3 */
  }
  /* USER CODE END 3 */
}

这里我们发上面的代码和先前的代码还是有很多不同。在这里我新使用了2个函数，下面是该函数的介绍

/**
  * @brief  Reception Event Callback (Rx event notification called after use of advanced reception service).
  * @param  huart UART handle
  * @param  Size  Number of data available in application reception buffer (indicates a position in
  *               reception buffer until which, data are available)
  * @retval None
  */
__weak void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size);

/**
  * @brief  Disable the specified DMA Channel interrupts.
  * @param  __HANDLE__: DMA handle
  * @param  __INTERRUPT__: specifies the DMA interrupt sources to be enabled or disabled.
  *          This parameter can be any combination of the following values:
  *            @arg DMA_IT_TC:  Transfer complete interrupt mask
  *            @arg DMA_IT_HT:  Half transfer complete interrupt mask
  *            @arg DMA_IT_TE:  Transfer error interrupt mask
  * @retval None
  */
#define __HAL_DMA_DISABLE_IT(__HANDLE__, __INTERRUPT__)  (CLEAR_BIT((__HANDLE__)->Instance->CCR , (__INTERRUPT__)))

/**
  * @brief  串口空闲中断函数
  * @param  huart 串口句柄
  * @param  Size  从串口忙碌到串口空闲接收到的数据
  * @retval None
  */
__weak void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size);

/**
  * @brief  关闭DMA通道中断
  * @param  __HANDLE__: DMA句柄
  * @param  __INTERRUPT__:中断类型：目前只需知道DMA_IT_HT是传输过半中断即可
  * @retval None
  */
#define __HAL_DMA_DISABLE_IT(__HANDLE__, __INTERRUPT__)  (CLEAR_BIT((__HANDLE__)->Instance->CCR , (__INTERRUPT__)))

在这里我们还使用了一个HAL_UARTEx_ReceiveToIdle_DMA函数，这个函数时DMA串口空闲中断启动的函数，这个函数有普通、中断、DMA三种类别。具体用法和前面的一样，具体要注意的就是这个函数的最后一个时最大接收数据。
  由于我们使用的串口空闲中断时HAL库编写的额外中断，所以在这里我们使用下面中断

__weak void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size);

该中断再串口空闲时会进入，Size为从串口忙碌到串口空闲接收到的数据。
  但是再DMA当中还存在一个DMA过半中断，就时再DMA传输到最大数据的一半时会进入中断，在有些时候有用，但是在大部分时候这个会造成困扰，所以在这里我们关闭了过半中断。即使用下面函数

#define __HAL_DMA_DISABLE_IT(__HANDLE__, __INTERRUPT__)  (CLEAR_BIT((__HANDLE__)->Instance->CCR , (__INTERRUPT__)))
HAL库(STM32CubeMX)——USART串口配置学习(中断接收/STM32G431RBT6)
贾saisai的博客
03-17 1万+
UART与USART介绍： USART(universal synchronous asynchronous receiver and transmitte): 通用同步异步收发器 USART是一个串行通信设备，可以灵活地与外部设备进行全双工数据交换。 UART(universal asynchronous receiver and transmitter): 通用异步收发器 异步串行通信口(UART)就是我们在嵌入式中常说的串口，它还是一种通用的数据通信议。 区别： USART是指单片机
STM32F103教程——UART串口通信
duotuoluan3934的博客
11-15 5283
串口通信是一种设备间常用的串行通信方式，串口按位（bit）发送和接收字节。尽管比特字节（byte）的串行通信慢，但是串口可以在使用一根线发送数据的同时用另一根线接收数据。串口通信协议是指规定了数据包的内容，内容包含了起始位、主体数据、校验位及停止位，双方需要约定一致的数据包格式才能正常收发数据的有关规范。在串口通信中，常用的协议包括RS-232、RS-422 和 RS-485 等。随着科技的发展，RS-232 在工业上还有广泛的使用，但是在商业技术上，已经慢慢的使用。
STM32串口通信的三种方式———HAL库实现
ctt15703065585的博客
09-22 9766
以上3种方式各有千秋，要根据具体开发要求来选择实现方式。对于阻塞在对实时性要求不高的开发中可以使用，反之对实时要求较高的可以用到中断，和DMA。
HAL库串口分析
qq_36314279的博客
06-05 1万+
stm32HAL库的三种串口发送和接收的方法。
HAL库串口
最新发布
cz_r555的博客
10-25 886
实现发送一个字符，一个数组，一串数字。
HAL库开发--串口
xuewenyu_的博客
06-15 2759
在嵌入式系统开发中，掌握串口通信是至关重要的一环。串口通信作为微控制器与外部设备或其他微控制器之间的主要通信方式，在各种嵌入式应用中起着重要作用。本文将介绍如何通过STM32CubeMX配置串口功能，并掌握串口发送、接收以及使用DMA进行数据传输的方法。同时，我们还将讨论如何配置printf函数，使其能够在串口上输出调试信息，以及如何处理串口接收中断。通过学习这些内容，读者将能够在嵌入式系统开发中更加灵活地应用串口通信功能。
基于HAL库的串口不定长数据输入
10-17
基于HAL库，芯片为STM32F746，利用DMA+空闲中断实现串口不定长数据的输入读取。
[野火EmbedFire]《STM32 HAL库开发实战指南——F103系列》—20211026.pdf
11-26
5. **后续章节**：虽然具体内容未提供，但根据通常的STM32 HAL库教程结构，接下来可能涵盖的内容包括：GPIO、定时器、串口通信、ADC、DMA、中断、RTOS集成等基础和进阶功能的使用方法，以及如何通过HAL库实现这些...
HAL库学习——串口中断
热门推荐
RealHero的博客
06-23 1万+
一、介绍 串口的传输方式包括：轮询、中断DMA，在此要介绍的是关于HAL库底层串口接收中断流程的讲解，包括串口错误的处理，中断回调函数以及错误中断回调函数的执行。 二、配置流程 首先使用STM32CubeMX配置串口参数和工作方式。如下图： 配置好基础参数波特率和数据长度，校验位，停止位后，选择NVIC Settings点击Enabled使能全局中断。 这样整个串口配置就完成了。 三、开启接收中断 ...
嵌入式|蓝桥杯STM32G431（HAL库开发）——CT117E学习笔记15：PWM输出
weixin_44800059的博客
03-30 2712
上节课讲解了PWM捕获，这节课讲解一下PWM的输出，也就是用STM32进行编程，让在特定的管脚上产生PWM信号，这个信号的占空比和频率是可调节的。我们知道开发板上有两个排针：这些排针上对应的是相应的管脚，其中PA1-7都是可以用作PWM输出的（当然也可以用作捕获），不同管脚对应TIM的不同通道，只需要在CubeMX中配置引脚就可以看到对应的通道了。上一节我们PWM捕获也用到TIM，这里我们PWM输出的时候就不要用相同的TIM。
嵌入式|蓝桥杯STM32G431（HAL库开发）——CT117E学习笔记06：按键输入
weixin_44800059的博客
03-07 1953
上一节我们讲了STM32G4的Systick定时器，并且考虑到程序调度重新设计了LED灯循环闪烁的程序，可以不占用资源的情况下实现延时功能。这一节我们讲一下GPIO输入模块———按键功能。一、GPIO输入在学习独立按键之前，我们必须先了解一下GPIO的输入模式，了解一下GPIO输入的内部框图是怎么构成的，只有了解了内部构成才能更清晰地认识到GPIO输入该怎么配置，在某种配置下有什么作用。​。
嵌入式|蓝桥杯STM32G431（HAL库开发）——CT117E学习笔记01：赛事介绍与硬件平台
weixin_44800059的博客
01-12 3332
蓝桥杯嵌入式是本人参加的第一次学科竞赛，之前没怎么学过嵌入式，算是零基础。因为课题组而选择了嵌入式的方向，以后还有很长的路要走，STM32单片机是我的嵌入式生涯第一站，决心要认真学好，在比赛中锻炼自己的单片机水平，有了这个基础以后进一步学习嵌入式才能走的更远。蓝桥杯嵌入式个人赛省赛：考试时间5小时，总分100，分客观题和主观题，客观题15条选择题，每题1分，主观题85分的程序设计题。
STM32简单串口通信（HAL）
wakeup_high的博客
10-28 895
RS-232是对电气特性以及物理特性的规定，只作用于数据的传输通路上，它并不内含对数据的处理方式。USB主机检测到USB转串口设备插入后，首先会对设备复位，然后开始USB枚举过程。USB虚拟串口的实现在系统上依赖于USB转串口驱动，一般由厂家直接提供，也可以使用操作系统自带的CDC类串口驱动等。驱动主要分为2个功能，其一注册USB设备驱动，完成对USB设备的控制与数据通讯，其二注册串口驱动，为串口应用层提供相应的实现方法。一个char型为8bit，起始位1bit，结束未1bit，故一个数据帧有10bit。
【HAL库】串口通信
m0_53488817的博客
08-23 6937
HAL库入门之串口通信学习经验分享
09:STM32-------USART串口通信+串口数据包
m0_74739916的博客
09-07 4151
USART（Universal Synchronous/Asynchronous Receiver/Transmitter）通用同步/异步收发器USART是STM32内部集成的硬件外设，可根据数据寄存器的一个字节数据自动生成数据帧时序，从TX引脚发送出去，也可自动接收RX引脚的数据帧时序，拼接为一个字节数据，存放在数据寄存器里自带波特率发生器，最高达4.5Mbits/s 可配置数据位长度（8/9）、停止位长（0.5/1/1.5/2）可选校验位（无校验/奇校验/偶校验）
HAL库学习05---串口通信（三种方式轮询、中断、DMA）
lulilulia的博客
03-05 4458
串口通信三种方式（轮询、中断、DMA）
【STM32】HAL库——串口通信(一)
Q大帅
05-09 7898
前期准备： STM32CubeMX Proteus 8 IDE Keil（MDK-ARM） Configure Virtual Serial Port Driver（虚拟串口） 虚拟串口部分 虚拟串口下载链接 点击Add pair 在Virtual ports 下生成COM1和COM2即成功 STM32CubeMX部分 1. 配置时钟 依旧是选择STM32F103C4系列芯片，配置时钟的同时会自动配置IO口引脚 将HCLK设置为最大频率72MHz 2. 配置USART 我们选择USAR
USART协议
喜欢打篮球的普通人
08-15 4942
一.串口通讯协议 对于通讯协议，我们也以分层的方式来理解，最基本的是把它分为物理层和协议层 物理层规定通讯系统中具有机械、电子功能部分的特性，确保原始数据在物理媒体的传输，eg：RS232、TTL高低电平 协议层主要规定通讯逻辑，统一收发双方的数据打包、解包标准，eg：串口数据包：起始位，数据位（8bit）、校验位、停止位 二.物理层 RS-232标准主要规定了信号的用途、通讯接口以及信...
硬石无刷电机HAL库开发基础资料分享
硬石无刷电机基础资料是一套针对STM32平台下无刷直流电机（BLDC）控制的系统性学习资源，涵盖了从硬件原理到软件开发的完整知识体系，尤其适用于希望深入掌握基于HAL库进行嵌入式电机控制开发的技术人员和电子爱好者...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值