STM32 UART串口配置与通信实战教程

技术文档

本文还有配套的精品资源，点击获取

简介：STM32微控制器广泛应用于嵌入式开发，其中UART是实现串行通信的关键接口。本教程针对初学者，详细介绍了UART的工作原理以及如何在STM32上配置UART。涵盖了波特率、数据位、停止位、奇偶校验和硬件流控制等关键参数的设置。还涉及了GPIO配置、中断处理和数据传输的实用方法，为实现STM32单片机的串口通信提供了完整的实践指导。 UART.rar_STM32串口配置

1. STM32串口配置基础

1.1 STM32的串口概述

STM32微控制器是一系列Cortex-M微处理器的家族成员，这些微处理器支持多种串行通信接口，其中最常用的是通用异步收发传输器（UART）。串口配置是将STM32与外部设备进行数据交换的基础，它允许开发者通过简单的电平转换实现数据的发送和接收。

1.2 串口配置的目的

在嵌入式开发中，串口配置的目的是为了建立STM32与外围设备（如计算机、调试器或其他微控制器）之间的可靠通信。通过对串口参数的设置，可以实现不同设备间的正确数据同步和错误检测。

1.3 开始串口配置

配置STM32的串口，通常涉及以下步骤：选择合适的引脚作为TX（发送）和RX（接收），配置相关GPIO（通用输入输出）引脚的模式；初始化串口相关参数（如波特率、数据位、停止位和校验位）；最后，通过HAL库函数实现数据的发送与接收。

以下是一个简单的代码示例，展示如何使用STM32 HAL库来初始化串口配置：

#include \"stm32f1xx_hal.h\" // 根据你的STM32系列选择合适的头文件UART_HandleTypeDef huart1; // 定义一个UART_HandleTypeDef类型的变量void SystemClock_Config(void);static void MX_GPIO_Init(void);static void MX_USART1_UART_Init(void);int main(void){ HAL_Init(); // 初始化HAL库 SystemClock_Config(); // 配置系统时钟 MX_GPIO_Init(); // 初始化GPIO MX_USART1_UART_Init(); // 初始化USART1串口 // 以下是发送数据的代码示例 char *msg = \"Hello, World!\"; HAL_UART_Transmit(&huart1, (uint8_t*)msg, strlen(msg), HAL_MAX_DELAY); while (1) { }}static void MX_USART1_UART_Init(void){ huart1.Instance = USART1; huart1.Init.BaudRate = 9600; huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE; huart1.Init.OverSampling = UART_OVERSAMPLING_16; if (HAL_UART_Init(&huart1) != HAL_OK) { // 初始化失败处理 }}

在上述代码中，我们首先包含了HAL库的头文件，并定义了一个 UART_HandleTypeDef 类型的变量用于管理串口。在 MX_USART1_UART_Init 函数中，我们设置了串口的基本参数，例如波特率、字长、停止位、奇偶校验位等。最后，在 main 函数中通过调用 HAL_UART_Transmit 函数发送了一段字符串。

上述示例为STM32串口配置的基础操作，后续章节将深入探讨各个配置参数的含义以及如何进行高级配置和故障排除。

2. UART工作原理与特性

2.1 UART的基本概念

2.1.1 UART的定义和作用

UART（Universal Asynchronous Receiver/Transmitter，通用异步收发传输器）是一种广泛应用于串行通信的硬件设备。在微控制器和计算机外设之间，以及在计算机与计算机之间进行数据交换时，UART能够将数据以串行方式发送和接收。它的核心作用是实现并行数据的串行传输，将字节形式的数据转换为串行位流，反之亦然。

UART通信不依赖于时钟同步，因此被称为异步通信。它的基本功能包括数据的发送、接收、帧同步以及可选的奇偶校验。由于UART使用两个单独的线路进行通信，一个用于发送（TX），另一个用于接收（RX），因此它也支持全双工通信。

2.1.2 UART通信协议的组成要素

UART通信协议的组成要素主要包括以下几个方面：

起始位 ：标志一个数据包的开始，通常是逻辑低电平。
数据位 ：传输的主体内容，长度可以是5到9位。标准配置是8位。
奇偶校验位 ：用于错误检测，可选，可以是偶校验或奇校验。
停止位 ：标志数据包的结束，通常是逻辑高电平，长度可以是1位、1.5位或2位。
空闲位 ：在停止位之后，线路通常保持为高电平状态，直到下一个起始位到来。

2.2 UART的通信参数

2.2.1 波特率的计算与设置

波特率是指每秒传输的符号数，对于UART来说，就是每秒传输的位数。例如，如果波特率设置为9600，那么每秒钟会传输9600位数据。

计算波特率通常考虑两个因素：系统时钟频率和预分频器的值。公式为：

[ \\text{波特率} = \\frac{\\text{系统时钟频率}}{(\\text{预分频器值} + 1) \\times 16 \\times (\\text{整数倍数值})} ]

例如，若系统时钟为72MHz，预分频器设置为71，整数倍数值为1，则波特率计算如下：

[ \\text{波特率} = \\frac{72 \\text{MHz}}{(71 + 1) \\times 16} = \\frac{72 \\times 10^6}{1152} = 62500 ]

实际上，由于寄存器的限制，整数倍数值通常设置为4或者更高值。

2.2.2 数据位、停止位和奇偶校验位的作用

数据位 定义了数据包中有效数据的大小，是通信中重要的组成部分。
停止位 标志了数据包的结束，并提供时间来让接收方准备接收下一个字节的数据。
奇偶校验位 用于检测数据传输过程中可能出现的错误。奇校验意味着在数据中包含一个额外的位，使得数据位中1的数量为奇数；偶校验则确保数据位中1的数量为偶数。

2.3 UART的特性分析

2.3.1 UART的异步通信特性

UART通信的异步特性意味着它不需要同步时钟信号来协调发送方和接收方。这减少了硬件的复杂性，并降低了通信成本。然而，为了确保通信的准确性，发送方和接收方需要事先约定波特率、数据位、停止位和奇偶校验位的设置。

2.3.2 多处理器通信和流控制功能

UART支持多处理器通信，允许一个UART设备与多个UART设备进行通信。这种情况下，通常使用地址位来区分不同的设备。

流控制功能可以帮助防止接收方缓冲区溢出，常见的流控制机制包括硬件流控制（如RTS/CTS）和软件流控制（如XON/XOFF）。硬件流控制使用额外的线来控制数据的发送，而软件流控制则在数据流中嵌入特定的字符来控制通信。

代码示例和分析

下面是一个简化的代码示例，展示如何在微控制器上设置UART波特率为9600，使用8位数据位，1位停止位，无奇偶校验位，并开启硬件流控制：

/* 假设使用的是HAL库函数 */UART_HandleTypeDef huart1;void SystemClock_Config(void) { /* 系统时钟配置 */}void UART_Init(void) { huart1.Instance = USART1; huart1.Init.BaudRate = 9600; huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_RTS_CTS; huart1.Init.OverSampling = UART_OVERSAMPLING_16; if (HAL_UART_Init(&huart1) != HAL_OK) { /* 初始化失败处理 */ }}int main(void) { HAL_Init(); SystemClock_Config(); UART_Init(); /* 代码主循环 */}

在上面的代码中， UART_Init 函数中设置了UART的参数。 BaudRate 设置为9600， WordLength 为8位数据位， StopBits 为1位停止位， Parity 为无奇偶校验位， Mode 为传输接收模式， HwFlowCtl 为硬件流控制， OverSampling 为16倍过采样。这些设置确保了UART可以按照预期的参数进行通信。

在初始化过程中， HAL_UART_Init 函数会对传入的 huart1 结构体成员进行检查，并调用底层库函数来配置相应的寄存器。如果初始化失败，通常会有错误处理机制来处理这种情况，如错误重试或者错误提示。

以上代码在初始化UART时，通过直接操作寄存器来设置参数。这是在硬件层面上，确保数据准确传输的关键步骤。在实际应用中，这些参数的设置要根据实际硬件和需求仔细调整，以确保最佳性能和兼容性。

3. UART_InitTypeDef结构体初始化

3.1 初始化结构体的组成

3.1.1 结构体成员的详细介绍

UART_InitTypeDef 是 STM32 HAL 库中用于配置 UART 硬件特性的一个结构体，它为开发者提供了一套标准的方法来设置 UART 相关的参数。结构体的成员变量通常包括波特率、数据位、停止位、奇偶校验等参数。

typedef struct{ uint32_t BaudRate; // 波特率设置 uint32_t WordLength; // 数据位长度 uint32_t StopBits; // 停止位设置 uint32_t Parity;  // 奇偶校验设置 uint32_t HardwareFlowControl; // 硬件流控制设置 uint32_t Mode; // 通信模式，接收或发送} UART_InitTypeDef;

BaudRate : 定义了串口通信的波特率。波特率是每秒传输的符号数，这是确定串口通信速率的主要参数。
WordLength : 表示数据帧中的数据位数，可以设置为 8 或 9 位。
StopBits : 定义了停止位的个数，可以是 1、1.5 或 2 个停止位。
Parity : 定义了奇偶校验位的使用，可以是无校验、偶校验、奇校验等。
HardwareFlowControl : 用于设置是否使用硬件流控制，如 RTS/CTS。
Mode : 设置是仅接收、仅发送，还是同时接收发送。

3.1.2 结构体与通信参数的对应关系

UART_InitTypeDef 结构体中的每一个成员都与 UART 通信中的一个特定参数直接相关，具体关系如下：

BaudRate 对应于 UART 的波特率参数，它影响着数据的传输速度。
WordLength 决定了数据帧的大小，从而影响数据的准确性与效率。
StopBits 用于确保接收方能够在正确的时间内识别数据帧的结束。
Parity 用于错误检测，能够提高数据传输的可靠性。
HardwareFlowControl 涉及流控制的配置，帮助协调双方的数据传输，避免缓冲区溢出。
Mode 为通信设置方向，根据实际需要进行选择。

3.2 初始化流程详解

3.2.1 初始化前的准备工作

在对 UART 进行初始化之前，需要做一系列准备工作，这些准备工作包括：

确定使用哪一个 UART 接口，并配置好相关的引脚复用。
根据系统要求，选择合适的波特率，并注意系统时钟设置以确保波特率准确。
根据数据传输的需求，设置数据位、停止位、奇偶校验等参数。
如果使用硬件流控制，需要初始化并配置相关的 RTS 和 CTS 引脚。

3.2.2 初始化过程中的注意事项

在初始化过程中，有几个方面需要特别注意：

要确保初始化代码与硬件平台的兼容性，例如，某些平台可能不支持 1.5 个停止位。
注意检查数据传输速率和系统时钟的限制，避免因超速或欠速导致的通信问题。
初始化配置应该在相关外设被使能之前完成。
在多处理器通信环境中，正确配置 ID 地址和是否响应地址位。

3.3 初始化实例分析

3.3.1 常见配置的代码示例

下面是一个简单的代码示例，展示了如何使用 UART_InitTypeDef 结构体来初始化一个 UART 接口：

UART_HandleTypeDef huart2;void MX_USART2_UART_Init(void){ huart2.Instance = USART2; huart2.Init.BaudRate = 9600; // 设置波特率为 9600 huart2.Init.WordLength = UART_WORDLENGTH_8B; // 设置数据位为 8 位 huart2.Init.StopBits = UART_STOPBITS_1; // 设置停止位为 1 huart2.Init.Parity = UART_PARITY_NONE; // 不使用奇偶校验位 huart2.Init.Mode = UART_MODE_TX_RX; // 设置为发送和接收模式 huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE; // 不使用硬件流控制 huart2.Init.OverSampling = UART_OVERSAMPLING_16; // 设置过采样值为 16 if (HAL_UART_Init(&huart2) != HAL_OK) { Error_Handler(); // 初始化错误处理 }}

3.3.2 配置过程中可能出现的问题及解决方案

在 UART 初始化配置中，可能会遇到一些问题，例如：

如果初始化失败，通常是因为配置参数与实际硬件不匹配或者初始化函数调用顺序错误。
波特率设置不准确可能导致数据接收不正确。要解决这个问题，需要仔细检查时钟设置并使用正确的波特率生成公式。
如果数据位、停止位或者奇偶校验设置错误，可能导致通信双方无法正确解析数据帧。检查双方设置是否一致，通常能够解决问题。
如果使用硬件流控制但又遇到通信中断，检查 RTS 和 CTS 线路是否正确连接和配置。
如果遇到初始化时序问题，确保初始化函数在正确的时序中被调用，例如，在外设初始化函数后调用。

通过遵循以上步骤和检查点，STM32 的 UART 初始化可以顺利完成，并确保通信的稳定性和效率。

4. 关键参数设置

4.1 波特率的设置与调试

4.1.1 波特率设置的理论依据

波特率是串行通信中衡量数据传输速率的一个重要参数，它指定了每秒传输的符号数（位数）。在STM32微控制器中，波特率的设置与MCU的时钟源、预分频器、倍频设置以及串口的分频器有关。正确的波特率设置可以保证数据的准确传输，而误差过大可能导致数据接收错误或通信失败。

通常情况下，计算波特率的公式为：

[ 波特率 = \\frac{MCU时钟频率}{(分频系数 * (2 - OVER8) * (PCLK_DIV + 1))} ]

其中， OVER8 是过采样模式， PCLK_DIV 是APB总线分频系数。MCU时钟频率和分频系数由系统时钟设置决定，因此在配置波特率前，必须先对MCU的时钟树进行适当的配置。

4.1.2 实际设置中的调试技巧

在实际应用中，波特率的调试需要注意以下几点：

确保系统时钟设置正确，时钟源和预分频器的配置将直接影响到可以设置的最大波特率。
使用调试器的实时监视功能，检查 USART->BRR 寄存器中的值，确保与理论计算值一致。
在高波特率通信时，应开启 USART_CR1_UESM 位，让硬件自动校准时钟误差，提高通信的准确性。
在调试阶段，使用较低的波特率进行测试，逐步提高波特率直到满足设计需求，这样可以更好地观察并定位通信问题。

4.2 数据位长度和停止位的配置

4.2.1 数据位长度的影响因素

数据位长度决定了在每个帧中传输的有效数据位数，常见的设置有7位或8位数据长度。数据位的选择对通信效率和可靠性都有影响。

7位数据长度通常用在某些旧的通信协议中，因为它的兼容性和效率较低，现在使用得较少。
8位数据长度是标准设置，适用于大多数现代串口通信，可以提供更高的数据传输效率和准确性。

数据位长度的选择应根据应用的需求和所遵守的通信协议来决定。

4.2.2 停止位的配置与选择

停止位用于指示一个数据帧的结束，常见的停止位长度有1位、1.5位和2位。通常，1位停止位即可满足大多数应用需求。

在1位停止位的配置下，每个数据帧后面跟随一个停止位。
在1.5位停止位的配置下，仅在8位数据模式下可用，适用于某些特定的通信协议。
在2位停止位的配置下，每个数据帧后面跟随两个停止位，增加了数据帧之间的间隔时间，有助于提高接收端的稳定性和可靠性。

在大多数标准通信中，推荐使用1位停止位配置。

4.3 奇偶校验与工作模式

4.3.1 奇偶校验位的作用和配置

奇偶校验是一种错误检测机制，用于检测数据在传输过程中是否出现错误。校验位可以配置为无校验、偶校验或奇校验。

无校验 ：不使用奇偶校验位，传输效率最高，但错误检测能力最弱。
偶校验 ：确保传输的数据中1的个数为偶数个，通过校验位可以检测到单个位的错误。
奇校验 ：确保传输的数据中1的个数为奇数个，同样用于单个位错误的检测。

在STM32的串口配置中，可以通过设置 USART_CR1_PCE 位来开启奇偶校验，并通过 USART_CR1_PS 位来选择偶校验或奇校验。

4.3.2 工作模式的选择与配置

STM32的USART提供4种工作模式：

模式1 ：8位数据位，无校验位，1或2位停止位。
模式2 ：9位数据位，偶校验位，1位停止位。
模式3 ：9位数据位，无校验位，1.5或2位停止位。
模式4 ：9位数据位，奇校验位，1位停止位。

选择合适的工作模式时，需考虑通信协议和硬件设备的要求。例如，如果要与一个特定的外部设备通信，需要根据该设备支持的工作模式来选择STM32的USART工作模式。

4.4 硬件流控制的实现

4.4.1 硬件流控制的概念和作用

硬件流控制（RTS/CTS）用于管理数据流，以防止数据丢失。接收端通过RTS（请求发送）信号告知发送端是否准备好接收数据，发送端通过CTS（清除发送）信号告知接收端是否允许发送数据。

当接收端的缓冲区快满时，它会将RTS信号置为高电平（不准备接收），发送端看到RTS高电平后将停止发送数据。同理，CTS信号用于控制发送端是否可以发送数据。

4.4.2 流控制参数的设置与调试

在STM32中使用硬件流控制时，需要设置相关参数：

配置USARTx_RTS与USARTx_CTS引脚为复用功能。
在 USART_CR3 寄存器中设置 RTSE 与 CTSE 位，以启用硬件流控制。
可以通过 USART_CR3_RTSE源泉 与 USART_CR3_CTSE源泉 来选择RTS与CTS信号的源泉。

在实际调试过程中，需要确保引脚连接正确，并检查信号电平是否与预期一致。此外，还需注意RTS与CTS信号的电平逻辑与所连接设备是否匹配。

graph LRA[启动硬件流控制] --> B[配置RTS/CTS引脚]B --> C[启用RTSE与CTSE位]C --> D[设置RTSE源泉与CTSE源泉]D --> E[检查RTS/CTS信号电平]E --> F[调试完成]

通过以上步骤，可以实现STM32的硬件流控制，从而保证数据传输的稳定性和可靠性。

5. HAL库中的中断处理与数据传输

在STM32的HAL库编程中，使用中断处理是实现高效串口通信的重要手段。同时，掌握数据的发送和接收方法对于构建稳定可靠的通信系统至关重要。本章节将详细介绍中断处理函数的使用、GPIO的配置与映射、以及数据发送与接收的方法，并对通信过程中可能遇到的问题提供排错技巧。

5.1 中断处理函数的使用

5.1.1 中断处理的基本原理

中断处理机制允许微控制器在不持续轮询的情况下响应外部事件。当中断事件发生时，例如接收到串口数据，微控制器暂停当前任务，跳转到相应的中断服务程序（ISR）执行，完成后返回之前的工作继续执行。在HAL库中，中断处理通常与回调函数（Callback）一起使用，回调函数在中断事件发生时被自动调用。

5.1.2 实现中断处理的代码结构

// 串口中断使能__HAL_UART_ENABLE_IT(&huart1, UART_IT_RXNE);// 中断服务程序结构void USART1_IRQHandler(void){ HAL_UART_IRQHandler(&huart1);}// 回调函数：接收到数据时的处理void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart){ if(huart->Instance == USART1) { // 此处添加接收到数据后的处理代码 }}

代码中，首先使能了USART1的接收中断。然后定义了中断服务程序 USART1_IRQHandler ，该函数调用了HAL库的 HAL_UART_IRQHandler 函数，该函数会处理各种UART事件。如果接收完成事件被触发，则会调用 HAL_UART_RxCpltCallback 回调函数。

5.2 GPIO配置与映射

5.2.1 GPIO的配置方法和步骤

串口通信需要配置正确的GPIO引脚作为串口的TX（发送）和RX（接收）引脚。以下是使用HAL库进行GPIO配置的步骤：

选择合适的GPIO引脚，并配置为复用功能（AF）模式。
设置GPIO引脚的模式为推挽输出（对于TX引脚）或输入（对于RX引脚）。
设置GPIO的速率和上拉/下拉电阻（根据需要）。

// 使能GPIO时钟__HAL_RCC_GPIOA_CLK_ENABLE();GPIO_InitTypeDef GPIO_InitStruct = {0};// 配置TX引脚（例如PA9）GPIO_InitStruct.Pin = GPIO_PIN_9;GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;GPIO_InitStruct.Pull = GPIO_NOPULL;GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;GPIO_InitStruct.Alternate = GPIO_AF7_USART1;HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);// 配置RX引脚（例如PA10）GPIO_InitStruct.Pin = GPIO_PIN_10;HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

5.2.2 引脚映射对串口通信的影响

正确的GPIO映射对串口通信至关重要。如果TX和RX引脚配置错误，那么数据将无法正确发送或接收。确保在初始化串口前，引脚映射与硬件连接相匹配。

5.3 数据发送与接收方法

5.3.1 HAL_UART_Transmit函数详解

HAL_UART_Transmit 函数用于发送数据。它可以同步或异步方式执行。

HAL_UART_Transmit(&huart1, (uint8_t*)data, size, timeout);

参数说明： - huart1 ：UART句柄。 - data ：指向要发送数据的指针。 - size ：要发送的字节数。 - timeout ：等待发送完成的时间。

此函数在等待数据发送完成时会阻塞程序的执行，直到超时或者数据发送完毕。

5.3.2 HAL_UART_Receive函数详解

HAL_UART_Receive 函数用于接收数据。它支持中断和DMA方式，可以异步执行。

HAL_UART_Receive(&huart1, (uint8_t*)data, size, timeout);

参数说明： - huart1 ：UART句柄。 - data ：指向存储接收到数据的缓冲区的指针。 - size ：要接收的字节数。 - timeout ：等待接收完成的时间。

此函数同样会在等待数据接收完成时阻塞程序，直到超时或数据接收完毕。

5.4 通信注意事项与排错

5.4.1 实际连接中的常见问题

在实际的串口通信过程中，常见的问题包括接线错误、通信参数设置不匹配、电气特性不兼容等。确保TX到RX、RX到TX的正确连接，并检查硬件的电气特性，如电压水平是否匹配。

5.4.2 数据传输过程中的故障排除

当遇到数据传输故障时，可以尝试以下步骤进行排错：

确认通信参数（如波特率、数据位、停止位和奇偶校验位）是否与对方设备一致。
使用串口调试助手测试设备是否能够单独工作。
检查电源和地线是否连接良好，防止干扰或供电不稳定。
使用逻辑分析仪或示波器检查TX和RX信号波形，确保信号的完整性。
在软件层面添加错误处理逻辑，如重试机制和错误码打印。

通过以上步骤可以较为系统地对STM32通过HAL库实现的串口通信进行故障排除。